vome-core 0.3.69 → 0.3.70

package/typings/admin/comm/eps.ts

@@ -1,86 +1,88 @@
-/** 前端 EPS 类型 */
-export type EpsApiItem = {
-  method: string
-  path: string
-  summary: string
-  prefix: string
-  ignoreToken: boolean
-  ignorePerms: boolean
-  perms: string[]
-}
-
-export type EpsColumn = {
-  propertyName: string
-  /** drizzle dataType：string / number / boolean / date */
-  type: string
-  /** drizzle columnType：PgVarchar / PgText / PgInteger / PgNumeric … */
-  columnType?: string
-  sqlType?: string
-  length?: string
-  precision?: number
-  scale?: number
-  comment?: string
-  nullable?: boolean
-  hasDefault?: boolean
-  dict?: string | string[]
-  /** 物理表名，供 field.{table}.{prop} */
-  table?: string
-  source?: string
-}
-
-export type EpsEntity = {
-  module: string
-  side: string
-  prefix: string
-  /** 关联实体/表名（可选）；中间列展示用 info.type.name 或 prefix 末段 */
-  name?: string
-  info?: {
-    type: {
-      /** 控制器路径末段，对应文件名（如 dict-info） */
-      name: string
-      description: string
-    }
-  }
-  api: EpsApiItem[]
-  columns: EpsColumn[]
-  pageColumns: EpsColumn[]
-  pageQueryOp?: {
-    keyWordLikeFields?: unknown[]
-    fieldEq?: unknown[]
-    fieldLike?: unknown[]
-    fieldArray?: unknown[]
-    fieldRange?: unknown[]
-    ignoreFields?: string[]
-  }
-  /** Controller api 含 dataI18n：本实体参与业务数据翻译 */
-  dataI18n?: boolean
-  /** direct 字段名（语言 Tab 列）；来自 Controller dataI18nFields / 推断 */
-  dataI18nFields?: string[]
-  dataI18nTables?: string[]
-}
-
-export type EpsModuleMap = Record<string, EpsEntity[]>
-
-/** EPS 开放接口完整载荷 */
-export type EpsDictFlatRow = {
-  id: number
-  name: string
-  typeId: number
-  parentId?: number | null
-  orderNum?: number
-  value?: unknown
-}
-
-export type EpsPayload = {
-  /** 服务端 vome.eps；写入打包 eps.json，生产仅 true 时前端可再请求 */
-  eps?: boolean
-  modules: EpsModuleMap
-  dict: Record<string, EpsDictFlatRow[]>
-}
-
-/** 菜单「自动添加权限」行 */
-export type AutoPermRow = {
-  enabled: boolean
-  name: string
-  perm: string
-}
+/** 前端 EPS 类型 */
+export type EpsApiItem = {
+  method: string
+  path: string
+  summary: string
+  prefix: string
+  ignoreToken: boolean
+  ignorePerms: boolean
+  perms: string[]
+}
+
+export type EpsColumn = {
+  propertyName: string
+  /** drizzle dataType：string / number / boolean / date */
+  type: string
+  /** drizzle columnType：PgVarchar / PgText / PgInteger / PgNumeric … */
+  columnType?: string
+  sqlType?: string
+  length?: string
+  precision?: number
+  scale?: number
+  comment?: string
+  nullable?: boolean
+  hasDefault?: boolean
+  dict?: string | string[]
+  /** 物理表名，供 field.{table}.{prop} */
+  table?: string
+  source?: string
+}
+
+export type EpsEntity = {
+  module: string
+  side: string
+  /** app 通道：shared | store | front */
+  channel?: string
+  prefix: string
+  /** 关联实体/表名（可选）；中间列展示用 info.type.name 或 prefix 末段 */
+  name?: string
+  info?: {
+    type: {
+      /** 控制器路径末段，对应文件名（如 dict-info） */
+      name: string
+      description: string
+    }
+  }
+  api: EpsApiItem[]
+  columns: EpsColumn[]
+  pageColumns: EpsColumn[]
+  pageQueryOp?: {
+    keyWordLikeFields?: unknown[]
+    fieldEq?: unknown[]
+    fieldLike?: unknown[]
+    fieldArray?: unknown[]
+    fieldRange?: unknown[]
+    ignoreFields?: string[]
+  }
+  /** Controller api 含 dataI18n：本实体参与业务数据翻译 */
+  dataI18n?: boolean
+  /** direct 字段名（语言 Tab 列）；来自 Controller dataI18nFields / 推断 */
+  dataI18nFields?: string[]
+  dataI18nTables?: string[]
+}
+
+export type EpsModuleMap = Record<string, EpsEntity[]>
+
+/** EPS 开放接口完整载荷 */
+export type EpsDictFlatRow = {
+  id: number
+  name: string
+  typeId: number
+  parentId?: number | null
+  orderNum?: number
+  value?: unknown
+}
+
+export type EpsPayload = {
+  /** 服务端 vome.eps；写入打包 eps.json，生产仅 true 时前端可再请求 */
+  eps?: boolean
+  modules: EpsModuleMap
+  dict: Record<string, EpsDictFlatRow[]>
+}
+
+/** 菜单「自动添加权限」行 */
+export type AutoPermRow = {
+  enabled: boolean
+  name: string
+  perm: string
+}

package/typings/admin/comm/request.ts

@@ -1,16 +1,16 @@
-export type ApiResult<T> = {
-  code: number
-  message: string
-  data: T
-}
-
-export type RequestOptions = Omit<RequestInit, 'body'> & {
-  /** JSON 对象或字符串；各端 request 实现自行序列化 */
-  body?: unknown
-  /** 失败时是否 toast，默认 true */
-  toast?: boolean
-  /** 跳过自动 refresh */
-  skipRefresh?: boolean
-  /** 请求超时 ms，默认 5000；AI sync 默认 360000，stream 传 0 不掐断 */
-  timeoutMs?: number
-}
+export type ApiResult<T> = {
+  code: number
+  message: string
+  data: T
+}
+
+export type RequestOptions = Omit<RequestInit, 'body'> & {
+  /** JSON 对象或字符串；各端 request 实现自行序列化 */
+  body?: unknown
+  /** 失败时是否 toast，默认 true */
+  toast?: boolean
+  /** 跳过自动 refresh */
+  skipRefresh?: boolean
+  /** 请求超时 ms，默认 5000；AI sync 默认 360000，stream 传 0 不掐断 */
+  timeoutMs?: number
+}

package/typings/admin/comm/service.ts

@@ -1,43 +1,43 @@
-/** 链式 service 叶子节点 */
-export type ServiceRequestOptions = {
-  url?: string
-  method?: string
-  data?: unknown
-  params?: Record<string, unknown>
-  /** 透传 HTTP 超时；默认由 request 客户端处理（5s） */
-  timeoutMs?: number
-}
-
-export type ServiceLeaf = {
-  namespace: string
-  permission: Record<string, string>
-  _permission: Record<string, boolean>
-  request: (options?: ServiceRequestOptions) => Promise<unknown>
-  page?: (
-    data?: Record<string, unknown>,
-    options?: Pick<ServiceRequestOptions, 'timeoutMs'>,
-  ) => Promise<{
-    list: Record<string, unknown>[]
-    pagination: { page: number; size: number; total: number }
-  }>
-  list?: (
-    data?: Record<string, unknown>,
-    options?: Pick<ServiceRequestOptions, 'timeoutMs'>,
-  ) => Promise<Record<string, unknown>[]>
-  info?: (data: { id: number | string }) => Promise<Record<string, unknown>>
-  add?: (data: Record<string, unknown>) => Promise<unknown>
-  update?: (data: Record<string, unknown>) => Promise<unknown>
-  delete?: (data: {
-    ids: Array<number | string>
-    force?: boolean
-  }) => Promise<unknown>
-  restore?: (data: { ids: Array<number | string> }) => Promise<unknown>
-  [method: string]: unknown
-}
-
-/** 嵌套树：service.base.user（动态键，运行时由 EPS 填充） */
-export type ServiceTree = {
-  request: (options?: ServiceRequestOptions) => Promise<unknown>
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  [key: string]: any
-}
+/** 链式 service 叶子节点 */
+export type ServiceRequestOptions = {
+  url?: string
+  method?: string
+  data?: unknown
+  params?: Record<string, unknown>
+  /** 透传 HTTP 超时；默认由 request 客户端处理（5s） */
+  timeoutMs?: number
+}
+
+export type ServiceLeaf = {
+  namespace: string
+  permission: Record<string, string>
+  _permission: Record<string, boolean>
+  request: (options?: ServiceRequestOptions) => Promise<unknown>
+  page?: (
+    data?: Record<string, unknown>,
+    options?: Pick<ServiceRequestOptions, 'timeoutMs'>,
+  ) => Promise<{
+    list: Record<string, unknown>[]
+    pagination: { page: number; size: number; total: number }
+  }>
+  list?: (
+    data?: Record<string, unknown>,
+    options?: Pick<ServiceRequestOptions, 'timeoutMs'>,
+  ) => Promise<Record<string, unknown>[]>
+  info?: (data: { id: number | string }) => Promise<Record<string, unknown>>
+  add?: (data: Record<string, unknown>) => Promise<unknown>
+  update?: (data: Record<string, unknown>) => Promise<unknown>
+  delete?: (data: {
+    ids: Array<number | string>
+    force?: boolean
+  }) => Promise<unknown>
+  restore?: (data: { ids: Array<number | string> }) => Promise<unknown>
+  [method: string]: unknown
+}
+
+/** 嵌套树：service.base.user（动态键，运行时由 EPS 填充） */
+export type ServiceTree = {
+  request: (options?: ServiceRequestOptions) => Promise<unknown>
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  [key: string]: any
+}

package/typings/admin/comm/upload.ts

@@ -1,39 +1,39 @@
-export type UploadFileType =
-  | 'image'
-  | 'video'
-  | 'audio'
-  | 'word'
-  | 'excel'
-  | 'ppt'
-  | 'pdf'
-  | 'rar'
-  | 'file'
-
-export type UploadRule = {
-  name: string
-  type: UploadFileType
-  color: string
-  exts: string[]
-}
-
-export type UploadItem = {
-  uid: string
-  name: string
-  url: string
-  preload?: string
-  type: UploadFileType
-  size?: number
-  progress: number
-  error?: string
-}
-
-export type UploadOptions = {
-  prefixPath?: string
-  onProgress?: (progress: number) => void
-}
-
-export type UploadResult = {
-  url: string
-  key?: string
-  fileId?: string
-}
+export type UploadFileType =
+  | 'image'
+  | 'video'
+  | 'audio'
+  | 'word'
+  | 'excel'
+  | 'ppt'
+  | 'pdf'
+  | 'rar'
+  | 'file'
+
+export type UploadRule = {
+  name: string
+  type: UploadFileType
+  color: string
+  exts: string[]
+}
+
+export type UploadItem = {
+  uid: string
+  name: string
+  url: string
+  preload?: string
+  type: UploadFileType
+  size?: number
+  progress: number
+  error?: string
+}
+
+export type UploadOptions = {
+  prefixPath?: string
+  onProgress?: (progress: number) => void
+}
+
+export type UploadResult = {
+  url: string
+  key?: string
+  fileId?: string
+}

package/typings/admin/theme.ts

@@ -1,10 +1,10 @@
-export type ThemeTokens = Record<string, string>
-
-export type ThemeDefinition = {
-  id: string
-  label: string
-  /** 是否挂 dark class */
-  dark?: boolean
-  /** 可选：覆盖 CSS 变量 */
-  tokens?: ThemeTokens
-}
+export type ThemeTokens = Record<string, string>
+
+export type ThemeDefinition = {
+  id: string
+  label: string
+  /** 是否挂 dark class */
+  dark?: boolean
+  /** 可选：覆盖 CSS 变量 */
+  tokens?: ThemeTokens
+}

package/typings/admin/vome/browser.ts

@@ -1,11 +1,11 @@
-export type BrowserScreen = 'xs' | 'sm' | 'md' | 'xl' | 'full'
-
-export type BrowserInfo = {
-  height: number
-  width: number
-  type: string
-  /** 断点：xs <768 / sm <992 / md <1200 / xl <1920 / full */
-  screen: BrowserScreen
-  /** 迷你布局：侧栏收起或移动端 */
-  isMini: boolean
-}
+export type BrowserScreen = 'xs' | 'sm' | 'md' | 'xl' | 'full'
+
+export type BrowserInfo = {
+  height: number
+  width: number
+  type: string
+  /** 断点：xs <768 / sm <992 / md <1200 / xl <1920 / full */
+  screen: BrowserScreen
+  /** 迷你布局：侧栏收起或移动端 */
+  isMini: boolean
+}

package/typings/admin/vome/module.ts

@@ -1,13 +1,13 @@
-import type { Component } from 'vue'
-
-/** 视图异步加载器 */
-export type ViewLoader = () => Promise<{ default: Component }>
-
-/** 视图路径树（菜单 viewPath 选择） */
-export type ViewsTreeNode = {
-  label: string
-  /** 完整 viewPath（叶子）或路径前缀（目录） */
-  value: string
-  isLeaf?: boolean
-  children?: ViewsTreeNode[]
-}
+import type { Component } from 'vue'
+
+/** 视图异步加载器 */
+export type ViewLoader = () => Promise<{ default: Component }>
+
+/** 视图路径树（菜单 viewPath 选择） */
+export type ViewsTreeNode = {
+  label: string
+  /** 完整 viewPath（叶子）或路径前缀（目录） */
+  value: string
+  isLeaf?: boolean
+  children?: ViewsTreeNode[]
+}

package/typings/admin/vome/tags.ts

@@ -1,9 +1,9 @@
-export type TagItem = {
-  path: string
-  fullPath: string
-  title: string
-  name?: string | symbol | null
-  /** 页面 defineOptions name，用于 KeepAlive */
-  componentName?: string
-  keepAlive?: boolean
-}
+export type TagItem = {
+  path: string
+  fullPath: string
+  title: string
+  name?: string | symbol | null
+  /** 页面 defineOptions name，用于 KeepAlive */
+  componentName?: string
+  keepAlive?: boolean
+}

package/typings/comm/crud.ts

@@ -1,83 +1,83 @@
-import type { SQL } from 'drizzle-orm'
-import type { PageQuery } from './page'
-
-/** save：有 id 则更新；insert：只插入 */
-export type CrudUpsertMode = 'save' | 'insert'
-
-/**
- * modifyBefore / modifyAfter 的操作名。
- * 内置：add | update | delete | restore | list | info | page；
- * 自定义方法可传任意字符串（如 settle）。
- */
-export type CrudModifyType =
-  | 'add'
-  | 'update'
-  | 'delete'
-  | 'restore'
-  | 'list'
-  | 'info'
-  | 'page'
-  | (string & {})
-
-/** add() 可选覆盖 */
-export type CrudWriteOptions = {
-  upsert?: CrudUpsertMode
-  /** 覆盖全局 softDelete；开启且表有 deleteTime 时 add 走 upsert */
-  softDelete?: boolean
-  /** softDelete→upsert 时覆盖表 unique（如 Excel `importUniqueKeys`） */
-  uniqueKeys?: string[]
-}
-
-/** 查询回收站范围 */
-export type CrudTrashQueryOptions = {
-  withTrashed?: boolean
-  onlyTrashed?: boolean
-  softDelete?: boolean
-}
-
-/** 删除选项 */
-export type CrudDeleteOptions = {
-  force?: boolean
-  softDelete?: boolean
-}
-
-/** vome.crud 运行时配置 */
-export type CrudConfig = {
-  upsert?: CrudUpsertMode
-  softDelete?: boolean
-}
-
-/** add 写入体（单条或批量；语义对齐当前 unknown，便于覆写签名） */
-export type CrudAddData = unknown
-
-/** update 第一参：SQL where / 单行对象 / 批量行 */
-export type CrudUpdateWhere =
-  | SQL
-  | Record<string, unknown>
-  | Record<string, unknown>[]
-
-/** update 第二参：SQL 条件下的 patch */
-export type CrudUpdatePatch = unknown
-
-/** id 或 id 列表 */
-export type CrudIdOrIds = number | string | Array<number | string>
-
-/** delete / restore 条件 */
-export type CrudDeleteWhere = SQL | CrudIdOrIds
-
-/** list where */
-export type CrudListWhere = SQL | undefined
-
-/** list 选项 */
-export type CrudListOptions = CrudTrashQueryOptions & {
-  orderBy?: SQL[]
-}
-
-/** info：主键或 where */
-export type CrudInfoWhere = number | string | SQL
-
-/** page 查询 */
-export type CrudPageQuery = PageQuery & {
-  where?: SQL
-  orderBy?: SQL[]
-} & CrudTrashQueryOptions
+import type { SQL } from 'drizzle-orm'
+import type { PageQuery } from './page'
+
+/** save：有 id 则更新；insert：只插入 */
+export type CrudUpsertMode = 'save' | 'insert'
+
+/**
+ * modifyBefore / modifyAfter 的操作名。
+ * 内置：add | update | delete | restore | list | info | page；
+ * 自定义方法可传任意字符串（如 settle）。
+ */
+export type CrudModifyType =
+  | 'add'
+  | 'update'
+  | 'delete'
+  | 'restore'
+  | 'list'
+  | 'info'
+  | 'page'
+  | (string & {})
+
+/** add() 可选覆盖 */
+export type CrudWriteOptions = {
+  upsert?: CrudUpsertMode
+  /** 覆盖全局 softDelete；开启且表有 deleteTime 时 add 走 upsert */
+  softDelete?: boolean
+  /** softDelete→upsert 时覆盖表 unique（如 Excel `importUniqueKeys`） */
+  uniqueKeys?: string[]
+}
+
+/** 查询回收站范围 */
+export type CrudTrashQueryOptions = {
+  withTrashed?: boolean
+  onlyTrashed?: boolean
+  softDelete?: boolean
+}
+
+/** 删除选项 */
+export type CrudDeleteOptions = {
+  force?: boolean
+  softDelete?: boolean
+}
+
+/** vome.crud 运行时配置 */
+export type CrudConfig = {
+  upsert?: CrudUpsertMode
+  softDelete?: boolean
+}
+
+/** add 写入体（单条或批量；语义对齐当前 unknown，便于覆写签名） */
+export type CrudAddData = unknown
+
+/** update 第一参：SQL where / 单行对象 / 批量行 */
+export type CrudUpdateWhere =
+  | SQL
+  | Record<string, unknown>
+  | Record<string, unknown>[]
+
+/** update 第二参：SQL 条件下的 patch */
+export type CrudUpdatePatch = unknown
+
+/** id 或 id 列表 */
+export type CrudIdOrIds = number | string | Array<number | string>
+
+/** delete / restore 条件 */
+export type CrudDeleteWhere = SQL | CrudIdOrIds
+
+/** list where */
+export type CrudListWhere = SQL | undefined
+
+/** list 选项 */
+export type CrudListOptions = CrudTrashQueryOptions & {
+  orderBy?: SQL[]
+}
+
+/** info：主键或 where */
+export type CrudInfoWhere = number | string | SQL
+
+/** page 查询 */
+export type CrudPageQuery = PageQuery & {
+  where?: SQL
+  orderBy?: SQL[]
+} & CrudTrashQueryOptions

package/typings/comm/page.ts

@@ -1,18 +1,18 @@
-/** 分页参数 */
-export type PageQuery = {
-  /** 页码，从 1 开始，默认 1 */
-  page?: number
-  /** 每页条数，默认 20 */
-  size?: number
-}
-
-export type PagePagination = {
-  page: number
-  size: number
-  total: number
-}
-
-export type PageResult<T = unknown> = {
-  list: T[]
-  pagination: PagePagination
-}
+/** 分页参数 */
+export type PageQuery = {
+  /** 页码，从 1 开始，默认 1 */
+  page?: number
+  /** 每页条数，默认 20 */
+  size?: number
+}
+
+export type PagePagination = {
+  page: number
+  size: number
+  total: number
+}
+
+export type PageResult<T = unknown> = {
+  list: T[]
+  pagination: PagePagination
+}