vome-core 0.1.14 → 0.1.16

package/typings/routing/crud.ts

@@ -0,0 +1,162 @@
+import type { ClassToken } from '../ioc/metadata'
+
+/** 快速 CRUD 接口名（含回收站） */
+export type CrudApi =
+  | 'add'
+  | 'delete'
+  | 'update'
+  | 'info'
+  | 'list'
+  | 'page'
+  | 'restore'
+
+/**
+ * 字段引用（fieldEq / fieldLike / fieldArray / keyWordLikeFields）。
+ * - 裸名 `status` → `a.status`，请求参数名 = `status`
+ * - `b.providerId` → 参数名 = `providerId`
+ * - `e.id as roleId` → 筛 `e.id`，参数名 = `roleId`（短名冲突用 as，不用 requestParam）
+ */
+export type QueryFieldRef =
+  | string
+  | {
+      /** 如 `status` / `b.providerId` / `e.id as roleId` */
+      column: string
+      /** 筛选项展示名；缺省用实体 columnComments / EPS comment */
+      label?: string
+      /** 业务字典 type.key；筛选项用其拉 options */
+      dict?: string
+      /** 有 dict 时默认 true（下拉多选）；false 为单选 */
+      multiple?: boolean
+      /** true：后端仍按本字段筛选，admin 不自动构建筛控件 */
+      none?: boolean
+    }
+
+/** 区间筛选精度 / 数字类型（告诉 admin 用什么控件） */
+export type FieldRangeType =
+  | 'int'
+  | 'float'
+  | 'year'
+  | 'month'
+  | 'day'
+  | 'hour'
+  | 'minute'
+  | 'second'
+
+/** 价格 / 时间等区间；min/max 为请求体参数名 */
+export type QueryFieldRange = {
+  column: string
+  min: string
+  max: string
+  type: FieldRangeType
+  /** 覆盖实体注释，用于搜索 label / placeholder 前缀 */
+  label?: string
+  /** true：后端支持区间，admin 不自动出控件 */
+  none?: boolean
+}
+
+/** join 类型 */
+export type QueryJoinType = 'join' | 'leftJoin' | 'innerJoin'
+
+/**
+ * Join 配置（Drizzle pgTable）。
+ * - 主表固定别名 `a`
+ * - 联表必须显式：`entity` + `alias` + `type` + `condition`
+ */
+export type QueryJoin = {
+  /** Drizzle pgTable */
+  entity: unknown
+  /** 联表别名，如 b / c / f；不可为 a */
+  alias: string
+  type: QueryJoinType
+  /** 等值条件，如 `a.skinId = b.id` */
+  condition: string
+}
+
+/** where / extend 上下文 */
+export type QueryOpCtx = {
+  body: Record<string, unknown>
+  request: Request
+}
+
+/** where 返回：单条 SQL，或列表（undefined/false/null 自动丢弃） */
+export type QueryWhereResult =
+  | unknown
+  | Array<unknown | undefined | false | null>
+
+export type QueryWhereFn = (
+  ctx: QueryOpCtx,
+) => QueryWhereResult | Promise<QueryWhereResult>
+
+/** extend 可改的查询句柄 */
+export type QueryExtendQb = {
+  andWhere: (condition: unknown) => void
+  orderBy: (...orders: unknown[]) => void
+}
+
+export type QueryExtendFn = (
+  qb: QueryExtendQb,
+  ctx: QueryOpCtx,
+) => void | Promise<void>
+
+/** page / list 查询配置 */
+export type QueryOp = {
+  keyWordLikeFields?: string[]
+  fieldEq?: QueryFieldRef[]
+  fieldLike?: QueryFieldRef[]
+  /** PG 数组列包含查询（body 单值或数组）；admin 筛选用输入框 */
+  fieldArray?: QueryFieldRef[]
+  /** 数字 / 时间区间（与 fieldEq 等并存，勿再在 where 里拆参） */
+  fieldRange?: QueryFieldRange[]
+  addOrderBy?: Record<string, 'asc' | 'desc'>
+  /**
+   * 声明式投影（有 join 时建议显式配置）。
+   * - `a.*`：主表全部列，结果键 = 驼峰字段名
+   * - `b.userName`：结果键 = `userName`（无需 as）
+   * - `e.name as roleName`：结果键 = `roleName`
+   */
+  select?: string[]
+  join?: QueryJoin[]
+  where?: QueryWhereFn
+  extend?: QueryExtendFn
+}
+
+export type InsertParamFn = (ctx: {
+  body?: unknown
+  request?: Request
+}) => Record<string, unknown> | Promise<Record<string, unknown>>
+
+/** 写操作前钩子（add / update / delete / restore） */
+export type CrudBeforeFn = (ctx: {
+  body: Record<string, unknown>
+  request: Request
+  api: string
+}) => void | Promise<void>
+
+/** 控制器 / 路由中间件（Elysia onBeforeHandle） */
+export type RouteMiddleware = (
+  ctx: Record<string, unknown>,
+) => unknown | Promise<unknown>
+
+/**
+ * @Controller 快速 CRUD 选项（Drizzle 适配）
+ */
+export type ControllerCrudOptions = {
+  api?: CrudApi[]
+  /** Drizzle pgTable，宿主挂载 Repository */
+  entity?: unknown
+  /** 业务 Service 类（须 @Provide，建议 extends BaseService） */
+  service?: ClassToken
+  /** 把 Service 方法挂成 POST /methodName */
+  serviceApis?: string[]
+  /** 写操作前改 body（add/update/delete/restore） */
+  before?: CrudBeforeFn
+  pageQueryOp?: QueryOp
+  listQueryOp?: QueryOp
+  insertParam?: InsertParamFn
+  infoIgnoreProperty?: string[]
+  /**
+   * 导入 upsert 唯一键（字段名数组）。
+   * 未配置时自动取实体 uniqueIndex / unique 约束。
+   */
+  importUniqueKeys?: string[]
+}

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'