frontendgen

type CrudOperation string

type CrudPaths struct {
	List   *ParsedOperation
	Get    *ParsedOperation
	Create *ParsedOperation
	Update *ParsedOperation
	Delete *ParsedOperation
}

type FieldEntriesOptions struct {
	// SkipFields 要跳过的字段名列表（默认 ["id"]）
	SkipFields []string
	// WithPlaceholder 生成 Placeholder 条目
	WithPlaceholder bool
	// WithRequired 生成 Required 校验提示条目
	WithRequired bool
	// SkipRequiredFields Required 跳过的字段名（默认 ["sortOrder","description","remark"]）
	SkipRequiredFields []string
}

type Framework string

type GeneratedFile struct {
	// Path 文件相对路径（相对前端项目 src 目录）
	Path string `json:"path"`
	// Content 文件内容
	Content string `json:"content"`
	// Description 文件描述
	Description string `json:"description"`
	// ServiceName 所属服务 tag 名
	ServiceName string `json:"serviceName"`
	// Type 文件类型（composable/hooks/page/drawer/router/locale）
	Type string `json:"type"`
}

type MethodEntry struct {
	Method string // 小写 http 方法名
	Tags   []string
	// Description 操作描述
	Description string
	// OperationID operationId
	OperationID string
}

type OpenApiTag struct {
	Name        string
	Description string
}

type Options struct {
	// Spec 已解析的 OpenAPI 规格（必填）
	Spec *Spec
	// Framework 目标框架（必填）
	Framework Framework
	// Tags 要生成的服务 tag 名列表；空 = 全部服务（按文档序）
	Tags []string
	// ServiceName 生成代码的服务名（默认 admin，用于 generated 导入路径）
	ServiceName string
	// ModulePathMap 文件名 -> 模块路径（如 role -> permission/role）
	ModulePathMap map[string]string
	// GenerateTypes 要生成的文件类型；空 = 全部类型
	// vue 框架: composable/page/drawer/router/locale；react: hooks/page/drawer/router/locale
	GenerateTypes []string
	// RouterModules 路由模块分组配置；为空且 AutoRouterModules 为 true 时自动检测
	RouterModules []RouterModuleConfig
	// AutoRouterModules RouterModules 为空时按 basePath 自动检测分组
	AutoRouterModules bool
}

type OrderedMap struct {
	// contains filtered or unexported fields
}

type ParsedField struct {
	Name        string   `json:"name"`
	TsType      string   `json:"tsType"`
	Description string   `json:"description"`
	IsEnum      bool     `json:"isEnum"`
	EnumValues  []string `json:"enumValues"`
	Format      string   `json:"format"`
	IsArray     bool     `json:"isArray"`
	IsBoolean   bool     `json:"isBoolean"`
	IsDate      bool     `json:"isDate"`
	IsInteger   bool     `json:"isInteger"`
}

type ParsedOperation struct {
	Type        CrudOperation `json:"type"`
	Method      string        `json:"method"`
	Path        string        `json:"path"`
	Description string        `json:"description"`
	OperationID string        `json:"operationId"`
}

type ParsedService struct {
	// TagName 服务标签名（如 RoleService）
	TagName string `json:"tagName"`
	// Description 服务描述
	Description string `json:"description"`
	// KebabName kebab-case 服务路径名（如 role）
	KebabName string `json:"kebabName"`
	// CamelName camelCase 服务名（如 role）
	CamelName string `json:"camelName"`
	// PascalName PascalCase 服务名（如 Role）
	PascalName string `json:"pascalName"`
	// ModelName 服务主模型名（如 Role）
	ModelName string `json:"modelName"`
	// ModelCamelName camelCase 模型名（如 role）
	ModelCamelName string `json:"modelCamelName"`
	// ClientGetterName ApiClient 上的 Service Client getter 名（如 roleService）
	ClientGetterName string `json:"clientGetterName"`
	// TypePrefix 生成代码中的类型前缀（如 permissionservicev1）
	TypePrefix string `json:"typePrefix"`
	// BasePath API 路径前缀（如 /admin/v1/roles）
	BasePath string `json:"basePath"`
	// Operations 该服务支持的操作（按文档序）
	Operations []ParsedOperation `json:"operations"`
	// Fields 主模型字段（按 schema 属性文档序）
	Fields []ParsedField `json:"fields"`
}

type PathEntry struct {
	Path    string
	Methods []*MethodEntry
}

type Property struct {
	Name        string
	Type        string
	Format      string
	Description string
	Enum        []string
	// ItemsType 数组元素类型（type: array 时）
	ItemsType string
}

type RouterModuleConfig struct {
	// ModuleKey 模块标识（如 permission, system）
	ModuleKey string `json:"moduleKey"`
	// ModuleDisplayName 模块中文名
	ModuleDisplayName string `json:"moduleDisplayName"`
	// ModuleIcon 模块图标
	ModuleIcon string `json:"moduleIcon,omitempty"`
	// ModuleOrder 模块排序（0 = 框架默认值）
	ModuleOrder int `json:"moduleOrder,omitempty"`
	// Authority 权限标识列表
	Authority []string `json:"authority,omitempty"`
	// ServiceTags 该模块包含的服务 tag 名列表
	ServiceTags []string `json:"serviceTags"`
}

type Schema struct {
	Properties []*Property
}

type Spec struct {
	Tags    []OpenApiTag
	Paths   []*PathEntry
	Schemas map[string]*Schema
}

type WriteResult struct {
	// Path 写入的绝对/相对路径（outDir + 文件相对路径）
	Path string `json:"path"`
	// Action created / overwritten / merged / merged-new
	Action string `json:"action"`
	// Bytes 写入字节数
	Bytes int `json:"bytes"`
}