vome-core 0.0.1

package/typings/admin/base/permission.ts

@@ -0,0 +1,19 @@
+/** 菜单节点 */
+export type MenuTreeNode = {
+  id: number
+  parentId: number | null
+  name: string
+  router: string | null
+  perms: string | null
+  type: number
+  icon: string | null
+  orderNum: number
+  viewPath: string | null
+  remoteName: string | null
+  remoteEntry: string | null
+  remoteModule: string | null
+  appKey: string | null
+  keepAlive: boolean
+  isShow: boolean
+  children?: MenuTreeNode[]
+}

package/typings/admin/comm/cascader.ts

@@ -0,0 +1,7 @@
+/** 级联选择节点（vm-group-cascader） */
+export type GroupCascaderNode = {
+  label: string
+  value: string
+  isLeaf?: boolean
+  children?: GroupCascaderNode[]
+}

package/typings/admin/comm/check-tree.ts

@@ -0,0 +1,7 @@
+/** 勾选树节点（vm-check-tree） */
+export type CheckTreeNode = {
+  id: number | string
+  label: string
+  meta?: string
+  children?: CheckTreeNode[]
+}

package/typings/admin/comm/crud.ts

@@ -0,0 +1,294 @@
+import type { Component, InjectionKey, MaybeRefOrGetter, Ref } from 'vue'
+
+/** 标准 CRUD service */
+export type CrudService = {
+  namespace?: string
+  page?: (data: Record<string, unknown>) => Promise<{
+    list: Record<string, unknown>[]
+    pagination: { page: number; size: number; total: number }
+  }>
+  list?: (data?: Record<string, unknown>) => 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>
+  /** 权限码字符串 map */
+  permission?: Partial<CrudPermission> | Record<string, string>
+  /** 当前用户是否具备对应权限 */
+  _permission?: Partial<CrudPermission> & Record<string, boolean>
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  request?: (options?: any) => Promise<unknown>
+  [key: string]: unknown
+}
+
+export type CrudPermission = {
+  page: boolean
+  list: boolean
+  info: boolean
+  add: boolean
+  delete: boolean
+  update: boolean
+}
+
+export type CrudDict = {
+  primaryId: string
+  api: {
+    list: string
+    add: string
+    update: string
+    delete: string
+    info: string
+    page: string
+  }
+  pagination: { page: string; size: string }
+  search: { keyWord: string; query: string }
+  sort: { order: string; prop: string }
+  label: Record<string, string>
+}
+
+export type CrudFormComponent = {
+  name?: string | Component
+  props?: Record<string, unknown>
+}
+
+export type CrudSearchItem = {
+  prop: string
+  label: string
+  type?: 'input' | 'select' | 'date' | 'daterange' | 'number-range'
+  placeholder?: string
+  options?: Array<{ label: string; value: string | number | boolean }>
+  /** 业务字典 type.key；有则拉 options */
+  dict?: string
+  /** 下拉多选 */
+  multiple?: boolean
+  /** 区间：提交时拆成 min/max 请求参数 */
+  range?: {
+    min: string
+    max: string
+    rangeType: 'int' | 'float' | 'year' | 'month' | 'day' | 'hour' | 'minute' | 'second'
+  }
+  /** component.name 走 registry */
+  component?: CrudFormComponent
+}
+
+export type CrudOpButton =
+  | 'edit'
+  | 'delete'
+  | 'info'
+  | {
+      label: string
+      hidden?: boolean
+      variant?: 'softPrimary' | 'softDestructive' | 'softSuccess' | 'ghost' | 'outline'
+      onClick: (row: Record<string, unknown>) => void
+    }
+
+export type CrudColumn = {
+  prop?: string
+  label?: string
+  /** selection | index | op | expand */
+  type?: 'selection' | 'index' | 'op' | 'expand'
+  width?: string | number
+  minWidth?: string | number
+  align?: 'left' | 'center' | 'right'
+  hidden?: boolean
+  /** true / custom 可点排序；asc|desc 表示默认方向 */
+  sortable?: boolean | 'custom' | 'asc' | 'desc' | 'ascending' | 'descending'
+  slot?: string
+  formatter?: (row: Record<string, unknown>, value: unknown) => string
+  /** op 列：edit/delete/info 或自定义按钮对象 */
+  buttons?: CrudOpButton[] | ((row: Record<string, unknown>) => CrudOpButton[])
+  /** 单元格组件：name 为注册名或直接组件 */
+  component?: {
+    name?: string | Component
+    props?: Record<string, unknown>
+  }
+  /** dict.get / dict.options（支持 ComputedRef） */
+  dict?: MaybeRefOrGetter<
+    Array<{ label: string; value: string | number; type?: string; color?: string }>
+  >
+  children?: CrudColumn[]
+}
+
+export type CrudFormItem = {
+  prop: string
+  label: string
+  type?: 'input' | 'textarea' | 'select' | 'switch' | 'radio'
+  required?: boolean
+  placeholder?: string
+  /** 控件禁用 */
+  disabled?: boolean
+  /** 扁平或树；options: dict.get('x') */
+  options?: MaybeRefOrGetter<
+    Array<{
+      label: string
+      value: string | number | boolean
+      children?: Array<{
+        label: string
+        value: string | number | boolean
+        children?: unknown[]
+      }>
+    }>
+  >
+  /** 按桌面 24 栅格配置（全宽 24）；移动端自动映射到 12 列 */
+  span?: number
+  hidden?: boolean | ((form: Record<string, unknown>) => boolean)
+  /** 用 component 描述控件 */
+  component?: CrudFormComponent
+  value?: unknown
+  rules?: unknown
+}
+
+export type CrudTrashMode = 'default' | 'onlyTrashed' | 'withTrashed'
+
+export type CrudRefreshHelpers = {
+  next: (params: Record<string, unknown>) => Promise<unknown>
+  done: () => void
+  render: (
+    list: Record<string, unknown>[] | { list: Record<string, unknown>[]; pagination?: unknown },
+    pagination?: { page?: number; size?: number; total?: number },
+  ) => void
+}
+
+export type CrudDeleteHelpers = {
+  next: (params?: Record<string, unknown>) => Promise<unknown>
+}
+
+export type CrudOptions = {
+  /** service.base.user 或字符串路径 */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  service: CrudService | string | any
+  dict?: Partial<CrudDict>
+  permission?: Partial<CrudPermission>
+  onRefresh?: (
+    params: Record<string, unknown>,
+    helpers: CrudRefreshHelpers,
+  ) => void | Promise<void>
+  onDelete?: (
+    selection: Record<string, unknown>[],
+    helpers: CrudDeleteHelpers,
+  ) => void | Promise<void>
+}
+
+export type CrudUpsertOptions = {
+  items?: CrudFormItem[]
+  props?: Record<string, unknown>
+  dialog?: {
+    title?: string
+    /** 显式 false 强制隐藏确定；未设时仍按 info 模式自动隐藏 */
+    confirm?: boolean
+  }
+  sync?: boolean
+  onOpen?: (data: Record<string, unknown>) => void
+  onOpened?: (data: Record<string, unknown>) => void
+  onClose?: (action: 'close' | 'submit', done: () => void) => void
+  onInfo?: (
+    data: Record<string, unknown>,
+    helpers: {
+      next: (data?: Record<string, unknown>) => Promise<Record<string, unknown>>
+      done: (data: Record<string, unknown>) => void
+      close: () => void
+    },
+  ) => void | Promise<void>
+  onSubmit?: (
+    data: Record<string, unknown>,
+    helpers: {
+      next: (data?: Record<string, unknown>) => Promise<unknown>
+      done: () => void
+      close: () => void
+    },
+  ) => void | Promise<void | unknown>
+}
+
+export type CrudTableOptions = {
+  columns?: CrudColumn[]
+  autoHeight?: boolean
+  border?: boolean
+  contextMenu?: boolean | string[]
+  rowKey?: string
+  /** 树表：list 含 children 时缩进展开 */
+  tree?: boolean
+  treeLazy?: boolean
+  /** 默认排序；请求键由 dict.sort 决定 */
+  defaultSort?: {
+    prop: string
+    order: 'asc' | 'desc' | 'ascending' | 'descending'
+  }
+  /** 排序变化时是否 refresh，默认 true */
+  sortRefresh?: boolean
+  plugins?: unknown[]
+}
+
+export type CrudSearchOptions = {
+  items?: CrudSearchItem[]
+}
+
+export type CrudContext = {
+  service: CrudService
+  loading: Ref<boolean>
+  list: Ref<Record<string, unknown>[]>
+  selection: Ref<Record<string, unknown>[]>
+  pagination: Ref<{ page: number; size: number; total: number }>
+  params: Ref<Record<string, unknown>>
+  trashMode: Ref<CrudTrashMode>
+  permission: Ref<CrudPermission>
+  dict: CrudDict
+  refresh: (extra?: Record<string, unknown>) => Promise<unknown>
+  setParams: (p: Record<string, unknown>, doRefresh?: boolean) => void
+  resetParams: () => void
+  setSelection: (rows: Record<string, unknown>[]) => void
+  getPermission: (key?: keyof CrudPermission) => boolean | CrudPermission
+  getParams: () => Record<string, unknown>
+  rowAdd: (defaults?: Record<string, unknown>) => void
+  rowAppend: (data?: Record<string, unknown>) => void
+  rowEdit: (row: Record<string, unknown>) => Promise<void>
+  rowInfo: (row: Record<string, unknown>) => Promise<void>
+  rowClose: () => void
+  /** 打开 upsert，不校验 add 权限 */
+  openUpsert: (
+    form?: Record<string, unknown>,
+    mode?: 'add' | 'update' | 'info',
+  ) => void
+  rowDelete: (rows?: Record<string, unknown>[], force?: boolean) => Promise<void>
+  rowRestore: (rows?: Record<string, unknown>[]) => Promise<void>
+  upsertVisible: Ref<boolean>
+  upsertMode: Ref<'add' | 'update' | 'info'>
+  upsertForm: Ref<Record<string, unknown>>
+  upsertSubmit: () => Promise<void>
+  upsertClose: () => void
+  patchUpsertForm: (patch: Record<string, unknown>) => void
+  getUpsertForm: () => Record<string, unknown>
+  /** vm-search 注册；vm-toolbar 搜索/重置读取 */
+  searchActions: import('vue').ShallowRef<{
+    search: () => void
+    reset: () => void
+  } | null>
+  /** vm-search 是否有筛选项；无配置时不显示 toolbar 搜索/重置 */
+  hasSearchFilters: Ref<boolean>
+}
+
+/** 表格右键菜单项 */
+export type CtxMenuItem = {
+  key: string
+  label: string
+  disabled?: boolean
+}
+
+/** 树形下拉选项 */
+export type TreeSelectOption = {
+  label?: string
+  value?: string | number | boolean
+  children?: TreeSelectOption[]
+  [key: string]: unknown
+}
+
+/** CRUD Table 插件标记 */
+export type TablePlugin = {
+  __plugin: string
+  [key: string]: unknown
+}
+
+export type { InjectionKey, Ref }

package/typings/admin/comm/eps.ts

@@ -0,0 +1,52 @@
+/** 前端 EPS 类型 */
+export type EpsApiItem = {
+  method: string
+  path: string
+  summary: string
+  prefix: string
+  ignoreToken: boolean
+  ignorePerms: boolean
+  perms: string[]
+}
+
+export type EpsColumn = {
+  propertyName: string
+  type: string
+  comment?: string
+  nullable?: boolean
+  dict?: string | 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[]
+  }
+}
+
+export type EpsModuleMap = Record<string, EpsEntity[]>
+
+/** 菜单「自动添加权限」行 */
+export type AutoPermRow = {
+  enabled: boolean
+  name: string
+  perm: string
+}

package/typings/admin/comm/request.ts

@@ -0,0 +1,12 @@
+export type ApiResult<T> = {
+  code: number
+  message: string
+  data: T
+}
+
+export type RequestOptions = RequestInit & {
+  /** 失败时是否 toast，默认 true */
+  toast?: boolean
+  /** 跳过自动 refresh */
+  skipRefresh?: boolean
+}

package/typings/admin/comm/service.ts

@@ -0,0 +1,35 @@
+/** 链式 service 叶子节点 */
+export type ServiceRequestOptions = {
+  url?: string
+  method?: string
+  data?: unknown
+  params?: Record<string, unknown>
+}
+
+export type ServiceLeaf = {
+  namespace: string
+  permission: Record<string, string>
+  _permission: Record<string, boolean>
+  request: (options?: ServiceRequestOptions) => Promise<unknown>
+  page?: (data?: Record<string, unknown>) => Promise<{
+    list: Record<string, unknown>[]
+    pagination: { page: number; size: number; total: number }
+  }>
+  list?: (data?: Record<string, unknown>) => 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

@@ -0,0 +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
+}

package/typings/admin/host.d.ts

@@ -0,0 +1,61 @@
+/**
+ * 宿主注入点类型（Vite alias `#vome-host` → admin/src）
+ * 包内不直接依赖宿主路径，由宿主 vite/tsconfig 解析。
+ */
+declare module '#vome-host/config' {
+  export const config: {
+    app: {
+      name: string
+      menu: { isGroup: boolean }
+      router: { mode: 'history' | 'hash' }
+    }
+    ignore: {
+      toast: string[]
+      token: string[]
+    }
+    test: { eps: boolean }
+    host: string
+    baseUrl: string
+    [key: string]: unknown
+  }
+  export const isDev: boolean
+}
+
+declare module '#vome-host/pages/home/index.vue' {
+  import type { DefineComponent } from 'vue'
+  const c: DefineComponent
+  export default c
+}
+
+declare module '#vome-host/pages/layout/index.vue' {
+  import type { DefineComponent } from 'vue'
+  const c: DefineComponent
+  export default c
+}
+
+declare module '#vome-host/pages/login/index.vue' {
+  import type { DefineComponent } from 'vue'
+  const c: DefineComponent
+  export default c
+}
+
+declare module '#vome-host/pages/missing/index.vue' {
+  import type { DefineComponent } from 'vue'
+  const c: DefineComponent
+  export default c
+}
+
+declare module '#vome-host/pages/micro/index.vue' {
+  import type { DefineComponent } from 'vue'
+  const c: DefineComponent
+  export default c
+}
+
+declare module '#vome-host/components/ui/dialog' {
+  import type { DefineComponent } from 'vue'
+  export const Dialog: DefineComponent
+  export const DialogContent: DefineComponent
+  export const DialogFooter: DefineComponent
+  export const DialogHeader: DefineComponent
+  export const DialogTitle: DefineComponent
+}

package/typings/admin/vome/browser.ts

@@ -0,0 +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
+}

package/typings/admin/vome/module.ts

@@ -0,0 +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[]
+}

package/typings/admin/vome/tags.ts

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