smart-admin-web 10.23.0 → 10.24.0

package/dist/createSmartAdmin.d.ts

@@ -51,6 +51,8 @@ export interface SmartAdminOptions extends SmartAdminPlugin {
         filterSerializer?: FilterSerializer;
         /** 所有数据列默认可拖拽列宽。内核默认 true;设 false 全局关掉,单列用列上的 `resizable` 覆盖。 */
         resizable?: boolean;
+        /** 值为 null / undefined 时单元格显示的占位。不传沿用库内置的 `—`;传 `''` 就是留空。 */
+        emptyText?: string;
     };
 }
 export interface SmartAdminApp {

package/dist/createSmartAdmin.js

@@ -1,40 +1,40 @@
-import { createApp as L, computed as z } from "vue";
-import { createPinia as E } from "pinia";
-import T from "pinia-plugin-persistedstate";
-import { SMART_TABLE_DEFAULTS as x, createSmartTableDefaults as w, zhCNLabels as R, defaultLabels as y } from "smart-naive-table";
-import A from "./App.vue.js";
-import { router as n } from "./router/index.js";
-import { registerLocales as _, i18n as a } from "./locales/index.js";
-import { registerMenuTitles as S } from "./locales/menuTitle.js";
-import { KERNEL_MENU_TITLES as N } from "./locales/kernelMenuTitles.js";
-import { registerViews as B } from "./router/viewRegistry.js";
-import { vAuth as C } from "./directives/auth.js";
-import { setupIcons as D } from "./lib/icons.js";
-import { reloadOnChunkError as v, reloadOnce as P } from "./lib/chunkReload.js";
+import { createApp as x, computed as L } from "vue";
+import { createPinia as z } from "pinia";
+import E from "pinia-plugin-persistedstate";
+import { SMART_TABLE_DEFAULTS as y, createSmartTableDefaults as w, zhCNLabels as R, defaultLabels as A } from "smart-naive-table";
+import _ from "./App.vue.js";
+import { router as l } from "./router/index.js";
+import { registerLocales as N, i18n as a } from "./locales/index.js";
+import { registerMenuTitles as v } from "./locales/menuTitle.js";
+import { KERNEL_MENU_TITLES as B } from "./locales/kernelMenuTitles.js";
+import { registerViews as C } from "./router/viewRegistry.js";
+import { vAuth as D } from "./directives/auth.js";
+import { setupIcons as P } from "./lib/icons.js";
+import { reloadOnChunkError as h, reloadOnce as M } from "./lib/chunkReload.js";
 import { runtime as o } from "./lib/runtime.js";
-import { useSite as M } from "./composables/useSite.js";
-import { flatFilterSerializer as O } from "./utils/tableFilter.js";
-import { trimTrailingSlashes as j } from "./utils/url.js";
-function te(r = {}) {
-  var c, d, u, p, b, g;
-  o.apiBase = j(r.apiBase ?? ""), r.version && (o.version = r.version), o.dev = !!r.dev, o.brand = r.brand ?? {}, (c = r.brand) != null && c.title && (M().site.title = r.brand.title), S(N);
-  const l = [...r.plugins ?? [], r], m = {}, f = [];
-  for (const e of l) {
-    e.views && B(e.views), e.locales && _(e.locales), e.menuTitles && S(e.menuTitles), e.icons && Object.assign(m, e.icons), e.iconSets && f.push(...e.iconSets);
-    for (const t of e.routes ?? []) n.addRoute(t);
+import { useSite as O } from "./composables/useSite.js";
+import { flatFilterSerializer as j } from "./utils/tableFilter.js";
+import { trimTrailingSlashes as F } from "./utils/url.js";
+function re(r = {}) {
+  var c, d, u, p, b, g, S;
+  o.apiBase = F(r.apiBase ?? ""), r.version && (o.version = r.version), o.dev = !!r.dev, o.brand = r.brand ?? {}, (c = r.brand) != null && c.title && (O().site.title = r.brand.title), v(B);
+  const n = [...r.plugins ?? [], r], m = {}, f = [];
+  for (const e of n) {
+    e.views && C(e.views), e.locales && N(e.locales), e.menuTitles && v(e.menuTitles), e.icons && Object.assign(m, e.icons), e.iconSets && f.push(...e.iconSets);
+    for (const t of e.routes ?? []) l.addRoute(t);
   }
-  D(m, f), window.addEventListener("unhandledrejection", (e) => {
-    v(e.reason) && e.preventDefault();
+  P(m, f), window.addEventListener("unhandledrejection", (e) => {
+    h(e.reason) && e.preventDefault();
   }), window.addEventListener("vite:preloadError", (e) => {
-    P() && e.preventDefault();
+    M() && e.preventDefault();
   });
-  const s = E();
-  s.use(T);
-  const i = L(A);
-  i.use(s), i.use(n), i.use(a), i.directive("auth", C), i.config.errorHandler = (e, t, h) => {
-    v(e) || console.error("[SmartAdmin] 未捕获异常", h, e);
+  const s = z();
+  s.use(E);
+  const i = x(_);
+  i.use(s), i.use(l), i.use(a), i.directive("auth", D), i.config.errorHandler = (e, t, T) => {
+    h(e) || console.error("[SmartAdmin] 未捕获异常", T, e);
   }, i.provide(
-    x,
+    y,
     w({
       // 表格工具栏密度默认使用紧凑档;已有 storage-key 的用户选择仍按本地缓存优先。
       density: ((d = r.table) == null ? void 0 : d.density) ?? "compact",
@@ -43,20 +43,22 @@ function te(r = {}) {
       // 列宽拖拽全站统一开:表头右缘拖动改宽,宽度跟着 storage-key 记忆。库内置默认是 false;
       // 某列不想让拖(操作列、序号列)在列上写 resizable: false,列上的值永远优先于这里。
       resizable: ((u = r.table) == null ? void 0 : u.resizable) ?? !0,
+      // 空值占位:undefined 不会覆盖库内置的 '—',所以不传时对现有应用零影响。
+      emptyText: (p = r.table) == null ? void 0 : p.emptyText,
       // 当前行(activeRowKey)高亮:指向选中态令牌(强调色淡底,跟强调色与明暗走),不用库默认的主色 9%。
       // 库用 background-image 叠色、不覆盖行底色,所以半透明的令牌值也不会让固定列透底。
       activeRowBg: "var(--sel-bg)",
       // 可选条数不手写,交给 smart-naive-table 3.0 按 fillHeight 选档:没开 [100,500,1000],开了 [100,1000,10000]。
       // 上限是后端 SmartAdmin:Api:MaxPageSize,默认 10000;应用把它调小的话,要用 table.pageSizes
       // 把这里的档位也压下去,否则用户选到超限档会被后端回 48001。undefined 不会覆盖内置档位。
-      pageSizes: (p = r.table) == null ? void 0 : p.pageSizes,
+      pageSizes: (b = r.table) == null ? void 0 : b.pageSizes,
       // 条件构造器的过滤态 → 后端扁平参数(见 utils/tableFilter.ts);有日期区间或改名需求的页面传自己的 :filter-serializer
-      filterSerializer: ((b = r.table) == null ? void 0 : b.filterSerializer) ?? O,
-      labels: z(() => {
+      filterSerializer: ((g = r.table) == null ? void 0 : g.filterSerializer) ?? j,
+      labels: L(() => {
         const e = a.global.locale.value, t = a.global.t;
         return {
           // 底子用 3.0 自带的整套文案(含条件构造器、批量栏等新键),再叠上项目 i18n 里已有的几个键。
-          ...e.startsWith("zh") ? R : y,
+          ...e.startsWith("zh") ? R : A,
           search: t("common.search"),
           reset: t("common.reset"),
           refresh: t("table.refresh"),
@@ -74,16 +76,16 @@ function te(r = {}) {
       })
     })
   );
-  for (const e of l) (g = e.install) == null || g.call(e, i);
+  for (const e of n) (S = e.install) == null || S.call(e, i);
   return {
     app: i,
-    router: n,
+    router: l,
     pinia: s,
     i18n: a,
     mount: (e) => (i.mount(e), i)
   };
 }
 export {
-  te as createSmartAdmin
+  re as createSmartAdmin
 };
 //# sourceMappingURL=createSmartAdmin.js.map

package/dist/createSmartAdmin.js.map

@@ -1 +1 @@
-{"version":3,"file":"createSmartAdmin.js","sources":["../src/createSmartAdmin.ts"],"sourcesContent":["import { computed, createApp, type App } from 'vue'\nimport { createPinia, type Pinia } from 'pinia'\nimport piniaPluginPersistedstate from 'pinia-plugin-persistedstate'\nimport type { RouteRecordRaw } from 'vue-router'\nimport {\n  SMART_TABLE_DEFAULTS,\n  createSmartTableDefaults,\n  defaultLabels,\n  zhCNLabels,\n  type FilterSerializer,\n} from 'smart-naive-table'\nimport type { IconifyJSON } from 'smart-naive-icon'\nimport AppRoot from '#/App.vue'\nimport { router } from '#/router'\nimport { i18n, registerLocales, type ExtModule } from '#/locales'\nimport { registerMenuTitles } from '#/locales/menuTitle'\nimport { KERNEL_MENU_TITLES } from '#/locales/kernelMenuTitles'\nimport { registerViews, type ViewLoader } from '#/router/viewRegistry'\nimport { vAuth } from '#/directives/auth'\nimport { setupIcons } from '#/lib/icons'\nimport { reloadOnChunkError, reloadOnce } from '#/lib/chunkReload'\nimport { runtime, type BrandOptions } from '#/lib/runtime'\nimport { useSite } from '#/composables/useSite'\nimport { flatFilterSerializer } from '#/utils/tableFilter'\nimport { trimTrailingSlashes } from '#/utils/url'\n\n/**\n * 一个插件(或应用自身)能往内核里注册的东西。页面、语言包、图标这类文件集合由消费方在自己的代码里\n * 写 import.meta.glob、把结果交进来 —— 内核是预编译的包,自己扫不到消费方的文件。\n */\nexport interface SmartAdminPlugin {\n  /** 页面表:`import.meta.glob('./views/**\\/*.vue')`。键取 `/views/` 之后去掉 .vue(如 system/user/index),同名覆盖先注册者。 */\n  views?: Record<string, ViewLoader>\n  /** 语言包:`import.meta.glob('./locales/ext/*\\/*.ts', { eager: true })`,键尾形如 `<locale>/<命名空间>.ts`,按命名空间深合并。 */\n  locales?: Record<string, ExtModule>\n  /** 布局壳之外的顶级静态路由(整屏看板、独立打印页等)。 */\n  routes?: RouteRecordRaw[]\n  /** 菜单标题 → i18n key(存量库菜单标题是中文时用):键以 / 开头按路由 path 登记,其余按标题原文登记。内核种子标题已自带。 */\n  menuTitles?: Record<string, string>\n  /** 本地 SVG 图标:`import.meta.glob('./assets/svg/*.svg', { query: '?raw', import: 'default', eager: true })`。 */\n  icons?: Record<string, string>\n  /** 离线图标子集:`smart-admin-icons` 从自己的 src 生成的 JSON(模板里是 npm run gen:icons),启动时同步注册。 */\n  iconSets?: IconifyJSON[]\n  /** 需要 app 实例的注册动作(registerHeaderTool / registerMenuBadge / 自己的 app.use 等),在 mount 前调用。 */\n  install?: (app: App) => void\n}\n\nexport interface SmartAdminOptions extends SmartAdminPlugin {\n  /** 插件按顺序注册,后者覆盖前者;应用自身(本对象的 views/locales 等)最后注册,优先级最高。 */\n  plugins?: SmartAdminPlugin[]\n  /** API 根地址;默认空串 = 同源。跨源时后端还要配 SmartAdmin:Api:Cors:AllowedOrigins。 */\n  apiBase?: string\n  /** 登录页页脚展示的版本号;默认内核版本。 */\n  version?: string\n  /** 开发态(登录页预填超管账号、设置抽屉「复制配置」);消费方传 import.meta.env.DEV。 */\n  dev?: boolean\n  /** 品牌默认值:sys.site.* 配置有值时以配置为准,为空时用这里。 */\n  brand?: BrandOptions\n  /**\n   * SmartTable 全局默认。\n   * `filterSerializer`:条件构造器 / 表头过滤的过滤态 → 请求参数。内核默认用 `flatFilterSerializer`\n   * (只翻后端真正支持的那一小撮条件,摊平成扁平参数,见 utils/tableFilter.ts)。\n   * 应用的后端已经实现了 3.0 默认的 `filters` 协议(`[{ field, logic, conditions }]`)时,传 `defaultFilterSerializer`\n   * (从 smart-naive-table 导入)即可保持原样;自定义形状就传自己的函数。\n   */\n  table?: {\n    density?: 'comfortable' | 'compact'\n    pageSizes?: number[]\n    filterSerializer?: FilterSerializer\n    /** 所有数据列默认可拖拽列宽。内核默认 true;设 false 全局关掉,单列用列上的 `resizable` 覆盖。 */\n    resizable?: boolean\n  }\n}\n\nexport interface SmartAdminApp {\n  app: App\n  router: typeof router\n  pinia: Pinia\n  i18n: typeof i18n\n  /** 挂载到选择器或元素;返回 Vue app 实例。 */\n  mount: (target: string | Element) => App\n}\n\n/**\n * 组装内核应用:写入运行期配置 → 并入插件与应用的页面/文案/路由/图标 → 建 pinia/router/i18n → 返回可挂载的 app。\n * 按 内核内置 < 插件(按数组顺序)< 应用自身 的顺序注册,同 key 后者覆盖前者。结果与后端相同(应用压过内核),\n * 机制相反:后端 TryAdd 是消费方先注册者胜。\n */\nexport function createSmartAdmin(options: SmartAdminOptions = {}): SmartAdminApp {\n  // apiBase 写入即生效:各处客户端在下一次调用时按新地址重建(见 api/client.ts 的 followApiBase)\n  runtime.apiBase = trimTrailingSlashes(options.apiBase ?? '')\n  if (options.version) runtime.version = options.version\n  runtime.dev = !!options.dev\n  runtime.brand = options.brand ?? {}\n  if (options.brand?.title) useSite().site.title = options.brand.title\n\n  // 内核种子菜单 / 应用标题的译名表垫在最底层:库里存的是中文标题,不登记的话侧栏在英文下仍是中文。\n  registerMenuTitles(KERNEL_MENU_TITLES)\n  const layers: SmartAdminPlugin[] = [...(options.plugins ?? []), options]\n  const icons: Record<string, string> = {}\n  const iconSets: IconifyJSON[] = []\n  for (const layer of layers) {\n    if (layer.views) registerViews(layer.views)\n    if (layer.locales) registerLocales(layer.locales)\n    if (layer.menuTitles) registerMenuTitles(layer.menuTitles)\n    if (layer.icons) Object.assign(icons, layer.icons)\n    if (layer.iconSets) iconSets.push(...layer.iconSets)\n    for (const route of layer.routes ?? []) router.addRoute(route)\n  }\n  setupIcons(icons, iconSets) // 注册离线图标集(ph 子集同步入库)+ 本地 SVG,不预热整集\n\n  // 全局兜底:没有这两个监听的话,未捕获异常和发版后旧 chunk 404 都是白屏,控制台之外不留痕迹。\n  // 渲染期异常由内容区的 ErrorBoundary 收口,这里管它够不着的两类:游离的 Promise 拒绝与预加载失败。\n  window.addEventListener('unhandledrejection', e => {\n    if (reloadOnChunkError(e.reason)) e.preventDefault()\n  })\n  // Vite 预加载新 chunk 失败时派发;能走到这个事件就一定是 chunk 问题,不必再判文案。\n  window.addEventListener('vite:preloadError', e => {\n    if (reloadOnce()) e.preventDefault()\n  })\n\n  const pinia = createPinia()\n  pinia.use(piniaPluginPersistedstate)\n\n  const app = createApp(AppRoot)\n  app.use(pinia) // 必须在 router 之前:守卫用到 store\n  // 深浅色默认 themeScheme:'auto' → 首访自动跟随系统,用户手选 light/dark 后固定(见 stores/app.ts)。\n  app.use(router)\n  app.use(i18n)\n  app.directive('auth', vAuth)\n  app.config.errorHandler = (err, _instance, info) => {\n    if (reloadOnChunkError(err)) return\n    console.error('[SmartAdmin] 未捕获异常', info, err)\n  }\n\n  // SmartTable 全局默认:labels 一次注入,各页面不用手传 :labels(切语言即时生效)。\n  // 只能在这里注入一次:Vue 的 inject 取最近的 provide、不合并 —— 在 App.vue 或任何祖先组件里\n  // 再 provide 一次 SMART_TABLE_DEFAULTS,会把这里的 labels/density 整份挡掉。要加默认值就往下面这个对象里加。\n  app.provide(\n    SMART_TABLE_DEFAULTS,\n    createSmartTableDefaults({\n      // 表格工具栏密度默认使用紧凑档;已有 storage-key 的用户选择仍按本地缓存优先。\n      density: options.table?.density ?? 'compact',\n      // 初始每页条数。它在可注入的 defaults 里(smart-naive-table 3.0 及以上),页面不用各写 :default-page-size。\n      defaultPageSize: 100,\n      // 列宽拖拽全站统一开:表头右缘拖动改宽,宽度跟着 storage-key 记忆。库内置默认是 false;\n      // 某列不想让拖(操作列、序号列)在列上写 resizable: false,列上的值永远优先于这里。\n      resizable: options.table?.resizable ?? true,\n      // 当前行(activeRowKey)高亮:指向选中态令牌(强调色淡底,跟强调色与明暗走),不用库默认的主色 9%。\n      // 库用 background-image 叠色、不覆盖行底色,所以半透明的令牌值也不会让固定列透底。\n      activeRowBg: 'var(--sel-bg)',\n      // 可选条数不手写,交给 smart-naive-table 3.0 按 fillHeight 选档:没开 [100,500,1000],开了 [100,1000,10000]。\n      // 上限是后端 SmartAdmin:Api:MaxPageSize,默认 10000;应用把它调小的话,要用 table.pageSizes\n      // 把这里的档位也压下去,否则用户选到超限档会被后端回 48001。undefined 不会覆盖内置档位。\n      pageSizes: options.table?.pageSizes,\n      // 条件构造器的过滤态 → 后端扁平参数(见 utils/tableFilter.ts);有日期区间或改名需求的页面传自己的 :filter-serializer\n      filterSerializer: options.table?.filterSerializer ?? flatFilterSerializer,\n      labels: computed(() => {\n        const locale = i18n.global.locale.value // 触发 locale 依赖收集\n        const t = i18n.global.t\n        return {\n          // 底子用 3.0 自带的整套文案(含条件构造器、批量栏等新键),再叠上项目 i18n 里已有的几个键。\n          ...(locale.startsWith('zh') ? zhCNLabels : defaultLabels),\n          search: t('common.search'),\n          reset: t('common.reset'),\n          refresh: t('table.refresh'),\n          density: t('app.density'),\n          densityComfortable: t('app.comfortable'),\n          densityCompact: t('app.compact'),\n          columnSettings: t('table.columnSettings'),\n          columnSettingsReset: t('table.columnSettingsReset'),\n          fixedLeft: t('table.fixedLeft'),\n          fixedRight: t('table.fixedRight'),\n          fixedNone: t('table.fixedNone'),\n          expand: t('table.expand'),\n          collapse: t('table.collapse'),\n        }\n      }),\n    }),\n  )\n\n  for (const layer of layers) layer.install?.(app)\n\n  return {\n    app,\n    router,\n    pinia,\n    i18n,\n    mount: target => {\n      app.mount(target)\n      return app\n    },\n  }\n}\n"],"names":["createSmartAdmin","options","runtime","trimTrailingSlashes","_a","useSite","registerMenuTitles","KERNEL_MENU_TITLES","layers","icons","iconSets","layer","registerViews","registerLocales","route","router","setupIcons","reloadOnChunkError","reloadOnce","pinia","createPinia","piniaPluginPersistedstate","app","createApp","AppRoot","i18n","vAuth","err","_instance","info","SMART_TABLE_DEFAULTS","createSmartTableDefaults","_b","_c","_d","_e","flatFilterSerializer","computed","locale","zhCNLabels","defaultLabels","_f","target"],"mappings":"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"}
+{"version":3,"file":"createSmartAdmin.js","sources":["../src/createSmartAdmin.ts"],"sourcesContent":["import { computed, createApp, type App } from 'vue'\nimport { createPinia, type Pinia } from 'pinia'\nimport piniaPluginPersistedstate from 'pinia-plugin-persistedstate'\nimport type { RouteRecordRaw } from 'vue-router'\nimport {\n  SMART_TABLE_DEFAULTS,\n  createSmartTableDefaults,\n  defaultLabels,\n  zhCNLabels,\n  type FilterSerializer,\n} from 'smart-naive-table'\nimport type { IconifyJSON } from 'smart-naive-icon'\nimport AppRoot from '#/App.vue'\nimport { router } from '#/router'\nimport { i18n, registerLocales, type ExtModule } from '#/locales'\nimport { registerMenuTitles } from '#/locales/menuTitle'\nimport { KERNEL_MENU_TITLES } from '#/locales/kernelMenuTitles'\nimport { registerViews, type ViewLoader } from '#/router/viewRegistry'\nimport { vAuth } from '#/directives/auth'\nimport { setupIcons } from '#/lib/icons'\nimport { reloadOnChunkError, reloadOnce } from '#/lib/chunkReload'\nimport { runtime, type BrandOptions } from '#/lib/runtime'\nimport { useSite } from '#/composables/useSite'\nimport { flatFilterSerializer } from '#/utils/tableFilter'\nimport { trimTrailingSlashes } from '#/utils/url'\n\n/**\n * 一个插件(或应用自身)能往内核里注册的东西。页面、语言包、图标这类文件集合由消费方在自己的代码里\n * 写 import.meta.glob、把结果交进来 —— 内核是预编译的包,自己扫不到消费方的文件。\n */\nexport interface SmartAdminPlugin {\n  /** 页面表:`import.meta.glob('./views/**\\/*.vue')`。键取 `/views/` 之后去掉 .vue(如 system/user/index),同名覆盖先注册者。 */\n  views?: Record<string, ViewLoader>\n  /** 语言包:`import.meta.glob('./locales/ext/*\\/*.ts', { eager: true })`,键尾形如 `<locale>/<命名空间>.ts`,按命名空间深合并。 */\n  locales?: Record<string, ExtModule>\n  /** 布局壳之外的顶级静态路由(整屏看板、独立打印页等)。 */\n  routes?: RouteRecordRaw[]\n  /** 菜单标题 → i18n key(存量库菜单标题是中文时用):键以 / 开头按路由 path 登记,其余按标题原文登记。内核种子标题已自带。 */\n  menuTitles?: Record<string, string>\n  /** 本地 SVG 图标:`import.meta.glob('./assets/svg/*.svg', { query: '?raw', import: 'default', eager: true })`。 */\n  icons?: Record<string, string>\n  /** 离线图标子集:`smart-admin-icons` 从自己的 src 生成的 JSON(模板里是 npm run gen:icons),启动时同步注册。 */\n  iconSets?: IconifyJSON[]\n  /** 需要 app 实例的注册动作(registerHeaderTool / registerMenuBadge / 自己的 app.use 等),在 mount 前调用。 */\n  install?: (app: App) => void\n}\n\nexport interface SmartAdminOptions extends SmartAdminPlugin {\n  /** 插件按顺序注册,后者覆盖前者;应用自身(本对象的 views/locales 等)最后注册,优先级最高。 */\n  plugins?: SmartAdminPlugin[]\n  /** API 根地址;默认空串 = 同源。跨源时后端还要配 SmartAdmin:Api:Cors:AllowedOrigins。 */\n  apiBase?: string\n  /** 登录页页脚展示的版本号;默认内核版本。 */\n  version?: string\n  /** 开发态(登录页预填超管账号、设置抽屉「复制配置」);消费方传 import.meta.env.DEV。 */\n  dev?: boolean\n  /** 品牌默认值:sys.site.* 配置有值时以配置为准,为空时用这里。 */\n  brand?: BrandOptions\n  /**\n   * SmartTable 全局默认。\n   * `filterSerializer`:条件构造器 / 表头过滤的过滤态 → 请求参数。内核默认用 `flatFilterSerializer`\n   * (只翻后端真正支持的那一小撮条件,摊平成扁平参数,见 utils/tableFilter.ts)。\n   * 应用的后端已经实现了 3.0 默认的 `filters` 协议(`[{ field, logic, conditions }]`)时,传 `defaultFilterSerializer`\n   * (从 smart-naive-table 导入)即可保持原样;自定义形状就传自己的函数。\n   */\n  table?: {\n    density?: 'comfortable' | 'compact'\n    pageSizes?: number[]\n    filterSerializer?: FilterSerializer\n    /** 所有数据列默认可拖拽列宽。内核默认 true;设 false 全局关掉,单列用列上的 `resizable` 覆盖。 */\n    resizable?: boolean\n    /** 值为 null / undefined 时单元格显示的占位。不传沿用库内置的 `—`;传 `''` 就是留空。 */\n    emptyText?: string\n  }\n}\n\nexport interface SmartAdminApp {\n  app: App\n  router: typeof router\n  pinia: Pinia\n  i18n: typeof i18n\n  /** 挂载到选择器或元素;返回 Vue app 实例。 */\n  mount: (target: string | Element) => App\n}\n\n/**\n * 组装内核应用:写入运行期配置 → 并入插件与应用的页面/文案/路由/图标 → 建 pinia/router/i18n → 返回可挂载的 app。\n * 按 内核内置 < 插件(按数组顺序)< 应用自身 的顺序注册,同 key 后者覆盖前者。结果与后端相同(应用压过内核),\n * 机制相反:后端 TryAdd 是消费方先注册者胜。\n */\nexport function createSmartAdmin(options: SmartAdminOptions = {}): SmartAdminApp {\n  // apiBase 写入即生效:各处客户端在下一次调用时按新地址重建(见 api/client.ts 的 followApiBase)\n  runtime.apiBase = trimTrailingSlashes(options.apiBase ?? '')\n  if (options.version) runtime.version = options.version\n  runtime.dev = !!options.dev\n  runtime.brand = options.brand ?? {}\n  if (options.brand?.title) useSite().site.title = options.brand.title\n\n  // 内核种子菜单 / 应用标题的译名表垫在最底层:库里存的是中文标题,不登记的话侧栏在英文下仍是中文。\n  registerMenuTitles(KERNEL_MENU_TITLES)\n  const layers: SmartAdminPlugin[] = [...(options.plugins ?? []), options]\n  const icons: Record<string, string> = {}\n  const iconSets: IconifyJSON[] = []\n  for (const layer of layers) {\n    if (layer.views) registerViews(layer.views)\n    if (layer.locales) registerLocales(layer.locales)\n    if (layer.menuTitles) registerMenuTitles(layer.menuTitles)\n    if (layer.icons) Object.assign(icons, layer.icons)\n    if (layer.iconSets) iconSets.push(...layer.iconSets)\n    for (const route of layer.routes ?? []) router.addRoute(route)\n  }\n  setupIcons(icons, iconSets) // 注册离线图标集(ph 子集同步入库)+ 本地 SVG,不预热整集\n\n  // 全局兜底:没有这两个监听的话,未捕获异常和发版后旧 chunk 404 都是白屏,控制台之外不留痕迹。\n  // 渲染期异常由内容区的 ErrorBoundary 收口,这里管它够不着的两类:游离的 Promise 拒绝与预加载失败。\n  window.addEventListener('unhandledrejection', e => {\n    if (reloadOnChunkError(e.reason)) e.preventDefault()\n  })\n  // Vite 预加载新 chunk 失败时派发;能走到这个事件就一定是 chunk 问题,不必再判文案。\n  window.addEventListener('vite:preloadError', e => {\n    if (reloadOnce()) e.preventDefault()\n  })\n\n  const pinia = createPinia()\n  pinia.use(piniaPluginPersistedstate)\n\n  const app = createApp(AppRoot)\n  app.use(pinia) // 必须在 router 之前:守卫用到 store\n  // 深浅色默认 themeScheme:'auto' → 首访自动跟随系统,用户手选 light/dark 后固定(见 stores/app.ts)。\n  app.use(router)\n  app.use(i18n)\n  app.directive('auth', vAuth)\n  app.config.errorHandler = (err, _instance, info) => {\n    if (reloadOnChunkError(err)) return\n    console.error('[SmartAdmin] 未捕获异常', info, err)\n  }\n\n  // SmartTable 全局默认:labels 一次注入,各页面不用手传 :labels(切语言即时生效)。\n  // 只能在这里注入一次:Vue 的 inject 取最近的 provide、不合并 —— 在 App.vue 或任何祖先组件里\n  // 再 provide 一次 SMART_TABLE_DEFAULTS,会把这里的 labels/density 整份挡掉。要加默认值就往下面这个对象里加。\n  app.provide(\n    SMART_TABLE_DEFAULTS,\n    createSmartTableDefaults({\n      // 表格工具栏密度默认使用紧凑档;已有 storage-key 的用户选择仍按本地缓存优先。\n      density: options.table?.density ?? 'compact',\n      // 初始每页条数。它在可注入的 defaults 里(smart-naive-table 3.0 及以上),页面不用各写 :default-page-size。\n      defaultPageSize: 100,\n      // 列宽拖拽全站统一开:表头右缘拖动改宽,宽度跟着 storage-key 记忆。库内置默认是 false;\n      // 某列不想让拖(操作列、序号列)在列上写 resizable: false,列上的值永远优先于这里。\n      resizable: options.table?.resizable ?? true,\n      // 空值占位:undefined 不会覆盖库内置的 '—',所以不传时对现有应用零影响。\n      emptyText: options.table?.emptyText,\n      // 当前行(activeRowKey)高亮:指向选中态令牌(强调色淡底,跟强调色与明暗走),不用库默认的主色 9%。\n      // 库用 background-image 叠色、不覆盖行底色,所以半透明的令牌值也不会让固定列透底。\n      activeRowBg: 'var(--sel-bg)',\n      // 可选条数不手写,交给 smart-naive-table 3.0 按 fillHeight 选档:没开 [100,500,1000],开了 [100,1000,10000]。\n      // 上限是后端 SmartAdmin:Api:MaxPageSize,默认 10000;应用把它调小的话,要用 table.pageSizes\n      // 把这里的档位也压下去,否则用户选到超限档会被后端回 48001。undefined 不会覆盖内置档位。\n      pageSizes: options.table?.pageSizes,\n      // 条件构造器的过滤态 → 后端扁平参数(见 utils/tableFilter.ts);有日期区间或改名需求的页面传自己的 :filter-serializer\n      filterSerializer: options.table?.filterSerializer ?? flatFilterSerializer,\n      labels: computed(() => {\n        const locale = i18n.global.locale.value // 触发 locale 依赖收集\n        const t = i18n.global.t\n        return {\n          // 底子用 3.0 自带的整套文案(含条件构造器、批量栏等新键),再叠上项目 i18n 里已有的几个键。\n          ...(locale.startsWith('zh') ? zhCNLabels : defaultLabels),\n          search: t('common.search'),\n          reset: t('common.reset'),\n          refresh: t('table.refresh'),\n          density: t('app.density'),\n          densityComfortable: t('app.comfortable'),\n          densityCompact: t('app.compact'),\n          columnSettings: t('table.columnSettings'),\n          columnSettingsReset: t('table.columnSettingsReset'),\n          fixedLeft: t('table.fixedLeft'),\n          fixedRight: t('table.fixedRight'),\n          fixedNone: t('table.fixedNone'),\n          expand: t('table.expand'),\n          collapse: t('table.collapse'),\n        }\n      }),\n    }),\n  )\n\n  for (const layer of layers) layer.install?.(app)\n\n  return {\n    app,\n    router,\n    pinia,\n    i18n,\n    mount: target => {\n      app.mount(target)\n      return app\n    },\n  }\n}\n"],"names":["createSmartAdmin","options","runtime","trimTrailingSlashes","_a","useSite","registerMenuTitles","KERNEL_MENU_TITLES","layers","icons","iconSets","layer","registerViews","registerLocales","route","router","setupIcons","reloadOnChunkError","reloadOnce","pinia","createPinia","piniaPluginPersistedstate","app","createApp","AppRoot","i18n","vAuth","err","_instance","info","SMART_TABLE_DEFAULTS","createSmartTableDefaults","_b","_c","_d","_e","_f","flatFilterSerializer","computed","locale","zhCNLabels","defaultLabels","_g","target"],"mappings":";;;;;;;;;;;;;;;;;AA0FO,SAASA,GAAiBC,IAA6B,IAAmB;;AAE/E,EAAAC,EAAQ,UAAUC,EAAoBF,EAAQ,WAAW,EAAE,GACvDA,EAAQ,YAASC,EAAQ,UAAUD,EAAQ,UAC/CC,EAAQ,MAAM,CAAC,CAACD,EAAQ,KACxBC,EAAQ,QAAQD,EAAQ,SAAS,CAAA,IAC7BG,IAAAH,EAAQ,UAAR,QAAAG,EAAe,UAAOC,EAAA,EAAU,KAAK,QAAQJ,EAAQ,MAAM,QAG/DK,EAAmBC,CAAkB;AACrC,QAAMC,IAA6B,CAAC,GAAIP,EAAQ,WAAW,CAAA,GAAKA,CAAO,GACjEQ,IAAgC,CAAA,GAChCC,IAA0B,CAAA;AAChC,aAAWC,KAASH,GAAQ;AAC1B,IAAIG,EAAM,SAAOC,EAAcD,EAAM,KAAK,GACtCA,EAAM,WAASE,EAAgBF,EAAM,OAAO,GAC5CA,EAAM,cAAYL,EAAmBK,EAAM,UAAU,GACrDA,EAAM,SAAO,OAAO,OAAOF,GAAOE,EAAM,KAAK,GAC7CA,EAAM,YAAUD,EAAS,KAAK,GAAGC,EAAM,QAAQ;AACnD,eAAWG,KAASH,EAAM,UAAU,CAAA,EAAI,CAAAI,EAAO,SAASD,CAAK;AAAA,EAC/D;AACA,EAAAE,EAAWP,GAAOC,CAAQ,GAI1B,OAAO,iBAAiB,sBAAsB,CAAA,MAAK;AACjD,IAAIO,EAAmB,EAAE,MAAM,OAAK,eAAA;AAAA,EACtC,CAAC,GAED,OAAO,iBAAiB,qBAAqB,CAAA,MAAK;AAChD,IAAIC,EAAA,KAAc,EAAE,eAAA;AAAA,EACtB,CAAC;AAED,QAAMC,IAAQC,EAAA;AACd,EAAAD,EAAM,IAAIE,CAAyB;AAEnC,QAAMC,IAAMC,EAAUC,CAAO;AAC7B,EAAAF,EAAI,IAAIH,CAAK,GAEbG,EAAI,IAAIP,CAAM,GACdO,EAAI,IAAIG,CAAI,GACZH,EAAI,UAAU,QAAQI,CAAK,GAC3BJ,EAAI,OAAO,eAAe,CAACK,GAAKC,GAAWC,MAAS;AAClD,IAAIZ,EAAmBU,CAAG,KAC1B,QAAQ,MAAM,sBAAsBE,GAAMF,CAAG;AAAA,EAC/C,GAKAL,EAAI;AAAA,IACFQ;AAAA,IACAC,EAAyB;AAAA;AAAA,MAEvB,WAASC,IAAA/B,EAAQ,UAAR,gBAAA+B,EAAe,YAAW;AAAA;AAAA,MAEnC,iBAAiB;AAAA;AAAA;AAAA,MAGjB,aAAWC,IAAAhC,EAAQ,UAAR,gBAAAgC,EAAe,cAAa;AAAA;AAAA,MAEvC,YAAWC,IAAAjC,EAAQ,UAAR,gBAAAiC,EAAe;AAAA;AAAA;AAAA,MAG1B,aAAa;AAAA;AAAA;AAAA;AAAA,MAIb,YAAWC,IAAAlC,EAAQ,UAAR,gBAAAkC,EAAe;AAAA;AAAA,MAE1B,oBAAkBC,IAAAnC,EAAQ,UAAR,gBAAAmC,EAAe,qBAAoBC;AAAA,MACrD,QAAQC,EAAS,MAAM;AACrB,cAAMC,IAASd,EAAK,OAAO,OAAO,OAC5B,IAAIA,EAAK,OAAO;AACtB,eAAO;AAAA;AAAA,UAEL,GAAIc,EAAO,WAAW,IAAI,IAAIC,IAAaC;AAAA,UAC3C,QAAQ,EAAE,eAAe;AAAA,UACzB,OAAO,EAAE,cAAc;AAAA,UACvB,SAAS,EAAE,eAAe;AAAA,UAC1B,SAAS,EAAE,aAAa;AAAA,UACxB,oBAAoB,EAAE,iBAAiB;AAAA,UACvC,gBAAgB,EAAE,aAAa;AAAA,UAC/B,gBAAgB,EAAE,sBAAsB;AAAA,UACxC,qBAAqB,EAAE,2BAA2B;AAAA,UAClD,WAAW,EAAE,iBAAiB;AAAA,UAC9B,YAAY,EAAE,kBAAkB;AAAA,UAChC,WAAW,EAAE,iBAAiB;AAAA,UAC9B,QAAQ,EAAE,cAAc;AAAA,UACxB,UAAU,EAAE,gBAAgB;AAAA,QAAA;AAAA,MAEhC,CAAC;AAAA,IAAA,CACF;AAAA,EAAA;AAGH,aAAW9B,KAASH,EAAQ,EAAAkC,IAAA/B,EAAM,YAAN,QAAA+B,EAAA,KAAA/B,GAAgBW;AAE5C,SAAO;AAAA,IACL,KAAAA;AAAA,IACA,QAAAP;AAAA,IACA,OAAAI;AAAA,IACA,MAAAM;AAAA,IACA,OAAO,CAAAkB,OACLrB,EAAI,MAAMqB,CAAM,GACTrB;AAAA,EACT;AAEJ;"}

package/dist/lib/runtime.js

@@ -2,7 +2,7 @@ const e = {
   /** API 根地址;空串 = 同源(dev 由 Vite 代理,生产由反代或后端托管 dist) */
   apiBase: "",
   /** 登录页页脚展示的版本号;默认内核版本,消费方可覆盖为应用版本 */
-  version: "10.23.0",
+  version: "10.24.0",
   /** 开发态:登录页预填超管账号、设置抽屉显示「复制配置」 */
   dev: !1,
   brand: {}