vome-core 0.1.15 → 0.1.16

package/typings/routing/eps.ts

@@ -0,0 +1,72 @@
+import type { QueryFieldRange, QueryFieldRef } from './crud'
+import type { ControllerSide } from './meta'
+
+/** EPS：单条 API */
+export type EpsApiItem = {
+  method: string
+  path: string
+  summary: string
+  dts: Record<string, unknown>
+  tag: string
+  prefix: string
+  ignoreToken: boolean
+  /** 强化：登录但免权限码 */
+  ignorePerms: boolean
+  /** 强化：推导/显式权限码 */
+  perms: string[]
+}
+
+/** EPS：字段列 */
+export type EpsColumn = {
+  propertyName: string
+  type: string
+  length?: string
+  comment?: string
+  nullable?: boolean
+  defaultValue?: unknown
+  source?: string
+  dict?: string | string[]
+  /** 物理表名（i18n_pack），供 field.{table}.{prop} 翻译 */
+  table?: string
+}
+
+/** EPS：单个控制器/实体描述 */
+export type EpsEntity = {
+  module: string
+  /** 强化：admin | app */
+  side: ControllerSide
+  prefix: string
+  name?: string
+  info: { type: { name: string; description: string } }
+  api: EpsApiItem[]
+  columns: EpsColumn[]
+  pageQueryOp: {
+    keyWordLikeFields: string[]
+    fieldEq: Array<string | QueryFieldRef>
+    fieldLike: Array<string | QueryFieldRef>
+    fieldArray: Array<string | QueryFieldRef>
+    fieldRange: QueryFieldRange[]
+  }
+  pageColumns: EpsColumn[]
+}
+
+/** EPS：按模块分组 */
+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
+  /** 字典类型 key → 扁平条目（前端组树后当本地缓存） */
+  dict: Record<string, EpsDictFlatRow[]>
+}

package/typings/routing/meta.ts

@@ -0,0 +1,63 @@
+import type { ControllerCrudOptions, RouteMiddleware } from './crud'
+
+export type ControllerSide = 'admin' | 'app'
+
+/** @Controller() 装饰器选项 */
+export type ControllerOptions = {
+  /** 路由前缀，如 `/auth`；也可用字符串参数简写 */
+  prefix?: string
+  side?: ControllerSide
+  module?: string
+  /** EPS / OpenAPI 描述 */
+  description?: string
+  /** 控制器级中间件 */
+  middleware?: RouteMiddleware | RouteMiddleware[]
+} & ControllerCrudOptions
+
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH'
+
+export type RouteParamSource = 'body' | 'query' | 'params'
+
+/** handler 参数装饰器元数据（@Body / @Query / @Param） */
+export type RouteParamMeta = {
+  index: number
+  source: RouteParamSource
+  schema?: unknown
+}
+
+/** 路由元数据 */
+export type ControllerRouteMeta = {
+  method: HttpMethod
+  path: string
+  handler: string
+  body?: unknown
+  query?: unknown
+  routeParams?: unknown
+  params?: RouteParamMeta[]
+  public?: boolean
+  summary?: string
+  /** 单路由中间件 */
+  middleware?: RouteMiddleware[]
+  /** 权限码（任一即可）；未设且非 IgnorePerms 时由路由自动推导 */
+  perms?: string[]
+  /** 跳过权限码校验（仍可要求登录） */
+  ignorePerms?: boolean
+  /** 框架自动 CRUD 路由 */
+  autoCrud?: boolean
+}
+
+/** 控制器元数据 */
+export type ControllerMeta = {
+  token: new (...args: unknown[]) => unknown
+  module: string
+  side: ControllerSide
+  prefix: string
+  /** OpenAPI / EPS 描述 */
+  description?: string
+  file?: string
+  routes: ControllerRouteMeta[]
+  /** 控制器级中间件（该 plugin 下全部路由） */
+  middleware?: RouteMiddleware[]
+  /** 快速 CRUD 配置 */
+  crud?: ControllerCrudOptions
+}

package/typings/routing/register.ts

@@ -0,0 +1,21 @@
+import type { AnyElysia } from 'elysia'
+import type { ControllerMeta } from './meta'
+
+export type CrudRouteOptionsInput = {
+  public?: boolean
+  /** CRUD / serviceApi 名，用于自动权限码 */
+  action?: string
+  /** OpenAPI 备注（侧栏：`action 备注`） */
+  summary?: string
+}
+
+/** 宿主挂载快速 CRUD 路由（Drizzle / BaseService） */
+export type CrudRegistrar = (
+  plugin: AnyElysia,
+  meta: ControllerMeta,
+  ctx: {
+    controller: object
+    /** 给自动路由挂 adminAuth + 权限码 */
+    routeOptions: (opts?: boolean | CrudRouteOptionsInput) => Record<string, unknown> | undefined
+  },
+) => AnyElysia

package/typings/routing/scan-context.ts

@@ -0,0 +1,7 @@
+import type { ControllerSide } from './meta'
+
+export type ControllerScanContext = {
+  module: string
+  side: ControllerSide
+  file: string
+}

package/dist/ai.d.ts

@@ -1 +0,0 @@
-export * from './src/ai/index'

package/dist/src/admin/config/plugin-dev.d.ts

@@ -1,52 +0,0 @@
-/** docsUrl → 官网后端 origin（主机前加 service.） */
-export declare function serviceUrlFromDocs(docsUrl: string): string;
-/** 席位 API 根（occupy / heartbeat / release） */
-export declare function seatApiBaseFromDocs(docsUrl: string): string;
-/** 联网安装签发 license */
-export declare function licenseIssueUrlFromDocs(docsUrl: string): string;
-export declare const pluginDev: {
-    readonly docsUrl: "https://vomekj.com";
-    /** 官网后端（由 docsUrl 派生） */
-    readonly serviceUrl: string;
-    readonly uploadUrl: "https://vomekj.com/plugins/upload";
-    /** 组织镜像：clone / 浏览优先 Gitee */
-    readonly mirrors: {
-        readonly prefer: "gitee";
-        readonly giteeOrg: "https://gitee.com/vomekj";
-        readonly githubOrg: "https://github.com/vomekj";
-    };
-    readonly scaffolds: {
-        readonly full: {
-            readonly key: "full";
-            readonly title: "前端 + 后端";
-            readonly desc: "完整业务模块脚手架（.vome：含 server 与 web），本地开发打包后发布。";
-            readonly repo: "vome-plugin-full";
-            readonly repoUrl: string;
-            readonly githubRepoUrl: string;
-            readonly downloadUrl: string;
-            readonly githubDownloadUrl: string;
-        };
-        readonly backend: {
-            readonly key: "backend";
-            readonly title: "纯后端";
-            readonly desc: "钩子 / 服务端插件脚手架（.vome：仅 server），适合上传、短信、支付等能力扩展。";
-            readonly repo: "vome-plugin-service";
-            readonly repoUrl: string;
-            readonly githubRepoUrl: string;
-            readonly downloadUrl: string;
-            readonly githubDownloadUrl: string;
-        };
-        readonly frontend: {
-            readonly key: "frontend";
-            readonly title: "纯前端";
-            readonly desc: "后台微应用脚手架（.vome：含 web/），以 wujie 挂载独立前端页面。";
-            readonly repo: "vome-plugin-front";
-            readonly repoUrl: string;
-            readonly githubRepoUrl: string;
-            readonly downloadUrl: string;
-            readonly githubDownloadUrl: string;
-        };
-    };
-};
-export type PluginDevConfig = typeof pluginDev;
-export type PluginScaffoldKey = keyof typeof pluginDev.scaffolds;

package/dist/src/agent/index.d.ts

@@ -1,3 +0,0 @@
-export * from './types';
-export * from './constants';
-export * from './protocol';

package/dist/src/config/index.d.ts

@@ -1,10 +0,0 @@
-/**
- * vome-core/config — 轻量配置引导（不触发 VomeConfig 加载）
- *
- * 宿主须在 import `vome-core/server` 之前：
- *   import { provideHostConfig, merge, getEnv } from 'vome-core/config'
- *   provideHostConfig(merge(defaultConfig, envConfig))
- */
-export { provideHostConfig, hasHostConfig } from '../core/config';
-export { merge } from '../comm/merge';
-export { getEnv } from '../comm/env';

package/dist/src/index.d.ts

@@ -1,12 +0,0 @@
-/**
- * @vome-core — 同构入口（前后端共用类型与纯工具）
- *
- * 服务端框架：`@vome-core/server`
- * 管理端框架：`@vome-core/admin`
- */
-export { merge, deepTree, flattenTree, RES_CODE } from './shared';
-export { flattenLocale, unflattenLocale, hashLocaleJson, extractJsonObject, } from './shared';
-export type { Loose, PageQuery, PagePagination, PageResult, ResCode, ApiSuccess, ApiFail, ApiResult, } from './shared';
-export * from './agent';
-/** 与 package.json version 同步 */
-export declare const version: string;

package/dist/src/server/index.d.ts

@@ -1,17 +0,0 @@
-/**
- * vome-core/server — Bun + Elysia 服务端框架入口
- *
- * 导入时初始化 `VomeConfig`（优先宿主 `provideHostConfig`；dev 可回退读盘）。
- * 宿主须先 `import './config/provide'`，再 `import 'reflect-metadata'` / `./lib/host`。
- * 开启 `experimentalDecorators` + `emitDecoratorMetadata`。
- */
-export { App, appendInjectMeta, BaseController, Body, CommException, Context, Controller, Delete, Eps, isEpsEnabled, Get, getEnv, Inject, Ioc, isCommException, listControllers, clearControllers, isPublicHttpRoute, listProviders, Logger, Param, Patch, Post, Provide, Public, Perms, IgnorePerms, Put, Query, RES_CODE, scanFiles, ScopeEnum, Use, vome, VomeConfig, registerHost, getHostBindings, DbStore, baseColumns, BASE_COLUMN_COMMENTS, entitySchemas, columnComments, getColumnComments, listColumnCommentTables, syncColumnCommentsToPg, Repository, getRepository, InjectRepository, BaseService, q, attachCrudRoutes, isTenantEnabled, noTenant, normalizeHost, resolveTenantScope, tableHasDepartmentId, resolveDataScope, applyDataScopeWhere, applyRowScopes, noDataScope, BasePlugin, loadPluginClass, loadPluginClassFromPath, loadModuleHandlers, loadModuleHandlersFromPath, readPluginScript, resolvePluginServerPath, pDataPath, pPluginPath, pModulesPath, pModulePath, pLicensesPath, pLicensePath, ModuleRegistry, microApps, createModuleGateway, defineAuthMacro, DEFAULT_MARKET_PUBLIC_KEY_B64, newMarketId, newInstallNonce, stableStringify, resolveMarketPublicKey, resolveMarketPrivateKey, ed25519Sign, ed25519Verify, generateMarketKeyPair, pricingFromPrice, buildMarketSigPayload, signMarketSigPayload, verifyMarketSigPayload, issueLicenseFile, parseLicenseFile, verifyLicenseFile, hashZipEntries, readZipManifest, readMarketSig, sealVomeBuffer, verifySealedVome, MARKET_LIC_ENTRY, readZipMarketLicense, attachMarketLicense, assertModuleInstallAllowed, assertModuleDirAllowed, peekMarketPackage, installModuleFromZip, uninstallModuleFiles, isSeatEnforced, isMarketSigEnforced, DEFAULT_SEAT_API_BASE, DEFAULT_LICENSE_ISSUE_URL, fetchOfficialSignedLicense, deriveHostIdentity, getHostIdentity, MARKET_SEAT_DEFAULTS, ensureSiteId, syncModuleSeat, syncAllModuleSeats, getModuleSeatStatus, listModuleSeatStatuses, isModuleSeatBlocked, assertModuleSeatActive, formatSeatDisplay, startMarketSeatHeartbeat, stopMarketSeatHeartbeat, bootstrapInstalledModules, } from '../core';
-export type { HostIdentity, HostBindings, HostLifecycle, HostSocket, HostMiddleware } from '../core';
-export { setControllerScanContext, parseModuleFromPath, } from '../routing/context';
-export { buildExcelBuffer, buildImportTemplateBuffer, parseExcelBuffer, excelFilename, excelResponseHeaders, IMPORT_SKIP_FIELDS, isImportSkipField, } from '../shared/excel';
-export type { ExcelColumn, ExcelFormatCell } from '../shared/excel';
-export { flattenLocale, unflattenLocale, hashLocaleJson, extractJsonObject, } from '../shared/locale-json';
-export * from '../ai';
-export type { ApiFail, ApiResult, ApiSuccess, ClassToken, ContextData, ControllerCrudOptions, ControllerMeta, ControllerRouteMeta, ControllerSide, CrudApi, CrudBeforeFn, CrudRegistrar, CrudUpsertMode, CrudModifyType, CrudWriteOptions, CrudTrashQueryOptions, CrudDeleteOptions, PageQuery, PagePagination, PageResult, PluginManifest, PluginInfo, PluginPayload, PluginCheckResult, ModuleRouteDef, ModuleMenuDef, ModuleManifest, ModuleHandlerCtx, ModuleHandler, ModuleInstalled, MarketPricing, MarketSigPayload, MarketLicensePayload, MarketLicenseFile, InstallGateKind, InstallGateResult, AssertModuleInstallOptions, InstallModuleOptions, InstallModuleResult, MarketSeatStatus, MarketSeatTicketPayload, MarketSeatTicket, EpsApiItem, EpsColumn, EpsEntity, EpsModuleMap, HttpMethod, InjectionToken, InjectMeta, InsertParamFn, ProvideOptions, QueryExtendFn, QueryExtendQb, QueryFieldRef, QueryJoin, QueryJoinType, QueryOp, QueryOpCtx, QueryWhereFn, QueryWhereResult, ResCode, RouteMiddleware, RouteParamMeta, RouteParamSource, ScanOptions, } from '../core';
-/** 与 package.json version 同步 */
-export declare const version: string;

package/dist/src/shared/excel.d.ts

@@ -1,23 +0,0 @@
-export type ExcelColumn = {
-    prop: string;
-    label: string;
-};
-export type ExcelFormatCell = (prop: string, row: Record<string, unknown>) => string;
-/** 导入模板排除的自动字段（实体公共列） */
-export declare const IMPORT_SKIP_FIELDS: readonly ["id", "createTime", "updateTime", "deletedAt", "tenantId"];
-export declare function isImportSkipField(name: string): boolean;
-/** 二维表 → xlsx 二进制 */
-export declare function buildExcelBuffer(columns: ExcelColumn[], rows: Record<string, unknown>[], formatCell?: ExcelFormatCell): Uint8Array;
-/** 仅表头的导入模板 */
-export declare function buildImportTemplateBuffer(columns: ExcelColumn[]): Uint8Array;
-/**
- * 解析 xlsx：首行表头 → 行对象。
- * 表头可为字段名或中文 label（通过 columns 反查 prop）。
- */
-export declare function parseExcelBuffer(data: ArrayBuffer | Uint8Array, columns?: ExcelColumn[]): Record<string, unknown>[];
-export declare function excelFilename(name: string): string;
-/** Service 下载响应头 */
-export declare function excelResponseHeaders(filename: string): {
-    'Content-Type': string;
-    'Content-Disposition': string;
-};

package/dist/src/shared/tree.d.ts

@@ -1,18 +0,0 @@
-/** 扁平列表 → 树（parentId） */
-export declare function deepTree<T extends {
-    id?: number | string;
-    parentId?: number | string | null;
-    children?: T[];
-    orderNum?: number;
-}>(list: T[], sort?: 'asc' | 'desc'): T[];
-/** 树 → 扁平（带 depth / hasChildren），按 expanded 展开 */
-export declare function flattenTree<T extends {
-    id: number | string;
-    children?: T[];
-}>(nodes: T[], expanded: Set<string | number>, depth?: number, out?: Array<T & {
-    depth: number;
-    hasChildren: boolean;
-}>): Array<T & {
-    depth: number;
-    hasChildren: boolean;
-}>;

package/src/shared/excel.d.ts

@@ -1,23 +0,0 @@
-export type ExcelColumn = {
-    prop: string;
-    label: string;
-};
-export type ExcelFormatCell = (prop: string, row: Record<string, unknown>) => string;
-/** 导入模板排除的自动字段（实体公共列） */
-export declare const IMPORT_SKIP_FIELDS: readonly ["id", "createTime", "updateTime", "deletedAt", "tenantId"];
-export declare function isImportSkipField(name: string): boolean;
-/** 二维表 → xlsx 二进制 */
-export declare function buildExcelBuffer(columns: ExcelColumn[], rows: Record<string, unknown>[], formatCell?: ExcelFormatCell): Uint8Array;
-/** 仅表头的导入模板 */
-export declare function buildImportTemplateBuffer(columns: ExcelColumn[]): Uint8Array;
-/**
- * 解析 xlsx：首行表头 → 行对象。
- * 表头可为字段名或中文 label（通过 columns 反查 prop）。
- */
-export declare function parseExcelBuffer(data: ArrayBuffer | Uint8Array, columns?: ExcelColumn[]): Record<string, unknown>[];
-export declare function excelFilename(name: string): string;
-/** Service 下载响应头 */
-export declare function excelResponseHeaders(filename: string): {
-    'Content-Type': string;
-    'Content-Disposition': string;
-};

package/src/shared/excel.ts

@@ -1,123 +0,0 @@
-import * as XLSX from 'xlsx'
-
-export type ExcelColumn = {
-  prop: string
-  label: string
-}
-
-export type ExcelFormatCell = (
-  prop: string,
-  row: Record<string, unknown>,
-) => string
-
-/** 导入模板排除的自动字段（实体公共列） */
-export const IMPORT_SKIP_FIELDS = [
-  'id',
-  'createTime',
-  'updateTime',
-  'deletedAt',
-  'tenantId',
-] as const
-
-export function isImportSkipField(name: string) {
-  return (IMPORT_SKIP_FIELDS as readonly string[]).includes(name)
-}
-
-/** 二维表 → xlsx 二进制 */
-export function buildExcelBuffer(
-  columns: ExcelColumn[],
-  rows: Record<string, unknown>[],
-  formatCell?: ExcelFormatCell,
-): Uint8Array {
-  const headers = columns.map((c) => c.label || c.prop)
-  const body = rows.map((row) =>
-    columns.map((col) => {
-      if (formatCell) return formatCell(col.prop, row)
-      const val = row[col.prop]
-      if (val == null) return ''
-      return String(val)
-    }),
-  )
-  const sheet = XLSX.utils.aoa_to_sheet([headers, ...body])
-  const book = XLSX.utils.book_new()
-  XLSX.utils.book_append_sheet(book, sheet, 'Sheet1')
-  return XLSX.write(book, { bookType: 'xlsx', type: 'array' }) as Uint8Array
-}
-
-/** 仅表头的导入模板 */
-export function buildImportTemplateBuffer(columns: ExcelColumn[]): Uint8Array {
-  return buildExcelBuffer(columns, [])
-}
-
-/**
- * 解析 xlsx：首行表头 → 行对象。
- * 表头可为字段名或中文 label（通过 columns 反查 prop）。
- */
-export function parseExcelBuffer(
-  data: ArrayBuffer | Uint8Array,
-  columns?: ExcelColumn[],
-): Record<string, unknown>[] {
-  const book = XLSX.read(data, { type: 'array', cellDates: true })
-  const name = book.SheetNames[0]
-  if (!name) return []
-  const sheet = book.Sheets[name]
-  if (!sheet) return []
-  const aoa = XLSX.utils.sheet_to_json(sheet, {
-    header: 1,
-    defval: '',
-    raw: false,
-  }) as unknown[][]
-  if (!aoa.length) return []
-
-  const headerRow = (aoa[0] || []).map((h) => String(h ?? '').trim())
-  const labelToProp = new Map<string, string>()
-  if (columns?.length) {
-    for (const c of columns) {
-      labelToProp.set(c.label.trim(), c.prop)
-      labelToProp.set(c.prop, c.prop)
-    }
-  }
-
-  const props = headerRow.map((h) => {
-    if (!h) return ''
-    return labelToProp.get(h) || h
-  })
-
-  const rows: Record<string, unknown>[] = []
-  for (let i = 1; i < aoa.length; i++) {
-    const line = aoa[i] || []
-    const row: Record<string, unknown> = {}
-    let empty = true
-    for (let c = 0; c < props.length; c++) {
-      const prop = props[c]
-      if (!prop) continue
-      let val: unknown = line[c]
-      if (val == null || val === '') {
-        row[prop] = val == null ? null : ''
-        continue
-      }
-      empty = false
-      if (typeof val === 'string') {
-        row[prop] = val.trim()
-      } else {
-        row[prop] = val
-      }
-    }
-    if (!empty) rows.push(row)
-  }
-  return rows
-}
-
-export function excelFilename(name: string) {
-  return name.endsWith('.xlsx') ? name : `${name}.xlsx`
-}
-
-/** Service 下载响应头 */
-export function excelResponseHeaders(filename: string) {
-  const file = excelFilename(filename)
-  return {
-    'Content-Type':
-      'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
-    'Content-Disposition': `attachment; filename*=UTF-8''${encodeURIComponent(file)}`,
-  }
-}

package/src/shared/index.ts

@@ -1,30 +0,0 @@
-/**
- * 同构共享：前后端均可引用（无 Bun / Elysia / Vue 依赖）
- */
-export { merge } from '../comm/merge'
-export { deepTree, flattenTree } from './tree'
-export type { Loose } from '../../typings/common'
-export type { PageQuery, PagePagination, PageResult } from '../../typings/comm/page'
-export {
-  RES_CODE,
-  type ResCode,
-  type ApiSuccess,
-  type ApiFail,
-  type ApiResult,
-} from '../routing/base'
-export {
-  buildExcelBuffer,
-  buildImportTemplateBuffer,
-  parseExcelBuffer,
-  excelFilename,
-  excelResponseHeaders,
-  IMPORT_SKIP_FIELDS,
-  isImportSkipField,
-} from './excel'
-export type { ExcelColumn, ExcelFormatCell } from './excel'
-export {
-  flattenLocale,
-  unflattenLocale,
-  hashLocaleJson,
-  extractJsonObject,
-} from './locale-json'

package/src/shared/locale-json.ts

@@ -1,79 +0,0 @@
-import { createHash } from 'node:crypto'
-
-/** 嵌套对象 → 点分扁平 key */
-export function flattenLocale(
-  input: Record<string, unknown>,
-  prefix = '',
-): Record<string, string> {
-  const out: Record<string, string> = {}
-  for (const [k, v] of Object.entries(input)) {
-    const key = prefix ? `${prefix}.${k}` : k
-    if (v != null && typeof v === 'object' && !Array.isArray(v)) {
-      Object.assign(out, flattenLocale(v as Record<string, unknown>, key))
-    } else if (typeof v === 'string') {
-      out[key] = v
-    } else if (v != null) {
-      out[key] = String(v)
-    }
-  }
-  return out
-}
-
-/** 点分扁平 → 嵌套对象 */
-export function unflattenLocale(
-  flat: Record<string, string>,
-): Record<string, unknown> {
-  const root: Record<string, unknown> = {}
-  for (const [path, value] of Object.entries(flat)) {
-    const parts = path.split('.').filter(Boolean)
-    if (!parts.length) continue
-    let cur: Record<string, unknown> = root
-    for (let i = 0; i < parts.length - 1; i++) {
-      const p = parts[i]!
-      const next = cur[p]
-      if (!next || typeof next !== 'object' || Array.isArray(next)) {
-        cur[p] = {}
-      }
-      cur = cur[p] as Record<string, unknown>
-    }
-    cur[parts[parts.length - 1]!] = value
-  }
-  return root
-}
-
-export function hashLocaleJson(obj: Record<string, unknown>): string {
-  const flat = flattenLocale(obj)
-  const keys = Object.keys(flat).sort()
-  const payload = keys.map((k) => `${k}=${flat[k]}`).join('\n')
-  return createHash('sha256').update(payload).digest('hex').slice(0, 32)
-}
-
-/** 从模型回复中尽量抠出 JSON 对象 */
-export function extractJsonObject(text: string): Record<string, unknown> {
-  const raw = String(text || '').trim()
-  if (!raw) throw new Error('AI 返回空内容')
-  try {
-    const parsed = JSON.parse(raw) as unknown
-    if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
-      return parsed as Record<string, unknown>
-    }
-  } catch {
-    /* try fence / substring */
-  }
-  const fence = raw.match(/```(?:json)?\s*([\s\S]*?)```/i)
-  if (fence?.[1]) {
-    const parsed = JSON.parse(fence[1].trim()) as unknown
-    if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
-      return parsed as Record<string, unknown>
-    }
-  }
-  const start = raw.indexOf('{')
-  const end = raw.lastIndexOf('}')
-  if (start >= 0 && end > start) {
-    const parsed = JSON.parse(raw.slice(start, end + 1)) as unknown
-    if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
-      return parsed as Record<string, unknown>
-    }
-  }
-  throw new Error('AI 返回无法解析为 JSON 对象')
-}

package/src/shared/tree.d.ts

@@ -1,18 +0,0 @@
-/** 扁平列表 → 树（parentId） */
-export declare function deepTree<T extends {
-    id?: number | string;
-    parentId?: number | string | null;
-    children?: T[];
-    orderNum?: number;
-}>(list: T[], sort?: 'asc' | 'desc'): T[];
-/** 树 → 扁平（带 depth / hasChildren），按 expanded 展开 */
-export declare function flattenTree<T extends {
-    id: number | string;
-    children?: T[];
-}>(nodes: T[], expanded: Set<string | number>, depth?: number, out?: Array<T & {
-    depth: number;
-    hasChildren: boolean;
-}>): Array<T & {
-    depth: number;
-    hasChildren: boolean;
-}>;

package/src/shared/tree.ts

@@ -1,50 +0,0 @@
-/** 扁平列表 → 树（parentId） */
-export function deepTree<
-  T extends {
-    id?: number | string
-    parentId?: number | string | null
-    children?: T[]
-    orderNum?: number
-  },
->(list: T[], sort: 'asc' | 'desc' = 'asc'): T[] {
-  const map = new Map<string | number, T>()
-  for (const row of list) {
-    if (row.id == null) continue
-    map.set(row.id, { ...row, children: [] })
-  }
-  const roots: T[] = []
-  for (const node of map.values()) {
-    const pid = node.parentId
-    if (pid != null && pid !== '' && map.has(pid as string | number)) {
-      map.get(pid as string | number)!.children!.push(node)
-    } else {
-      roots.push(node)
-    }
-  }
-  const sortRec = (arr: T[]) => {
-    arr.sort((a, b) => {
-      const ao = a.orderNum ?? 0
-      const bo = b.orderNum ?? 0
-      const d = sort === 'desc' ? bo - ao : ao - bo
-      return d || Number(a.id) - Number(b.id)
-    })
-    for (const n of arr) if (n.children?.length) sortRec(n.children)
-  }
-  sortRec(roots)
-  return roots
-}
-
-/** 树 → 扁平（带 depth / hasChildren），按 expanded 展开 */
-export function flattenTree<T extends { id: number | string; children?: T[] }>(
-  nodes: T[],
-  expanded: Set<string | number>,
-  depth = 0,
-  out: Array<T & { depth: number; hasChildren: boolean }> = [],
-): Array<T & { depth: number; hasChildren: boolean }> {
-  for (const n of nodes) {
-    const kids = n.children || []
-    out.push({ ...n, depth, hasChildren: kids.length > 0 })
-    if (kids.length && expanded.has(n.id)) flattenTree(kids, expanded, depth + 1, out)
-  }
-  return out
-}