@done-coding/admin-core 0.10.0 → 0.10.1-alpha.0

package/types/store/app.d.ts

@@ -1,3 +1,4 @@
+import { CSSProperties } from 'vue';
 import { AdminBridge } from '../bridge';
 /**
  * createAppStore 工厂依赖（#A 期，与 createUserStore deps 收敛单字段 `{ bridge }` 范式对齐）。
@@ -51,39 +52,19 @@ export declare function createAppStore<UserInfo = unknown, LoginParams = unknown
         readonly focusRing?: string | undefined;
         readonly surface?: string | undefined;
     }>;
-    extractLevel1ToHeader: import('vue').Ref<boolean, boolean>;
     showHeader: import('vue').ComputedRef<boolean>;
     showFooter: import('vue').ComputedRef<boolean>;
     showSidebar: import('vue').ComputedRef<boolean>;
+    showAside: import('vue').ComputedRef<boolean>;
     showBreadcrumb: import('vue').ComputedRef<boolean>;
     keepAlive: import('vue').ComputedRef<boolean | undefined>;
-    headerStyle: import('vue').ComputedRef<{
-        height: string;
-        backgroundColor: string;
-        color: string;
-    }>;
-    footerStyle: import('vue').ComputedRef<{
-        height: string;
-        backgroundColor: string;
-    }>;
-    sidebarStyle: import('vue').ComputedRef<{
-        width: string;
-        paddingTop: string;
-        backgroundColor: string;
-        color: string;
-    }>;
-    bodyStyle: import('vue').ComputedRef<{
-        paddingLeft: string;
-        paddingTop: string;
-        paddingRight: string;
-        paddingBottom: string;
-        backgroundColor: string;
-    }>;
+    headerStyle: import('vue').ComputedRef<CSSProperties>;
+    footerStyle: import('vue').ComputedRef<CSSProperties>;
+    sidebarStyle: import('vue').ComputedRef<CSSProperties>;
+    asideStyle: import('vue').ComputedRef<CSSProperties>;
+    bodyStyle: import('vue').ComputedRef<CSSProperties>;
     bodyShimPadding: import('vue').ComputedRef<number>;
-    bodyShimStyle: import('vue').ComputedRef<{
-        minHeight: string;
-        padding: string;
-    }>;
+    bodyShimStyle: import('vue').ComputedRef<CSSProperties>;
     viewportPadding: import('vue').ComputedRef<{
         top: string;
         right: string;
@@ -94,7 +75,7 @@ export declare function createAppStore<UserInfo = unknown, LoginParams = unknown
     changeSidebarCollapseStatus: (status: boolean) => void;
     changeSidebarHasMenusStatus: (status: boolean) => void;
     changeIsDarkTheme: (status: boolean) => void;
-}, "extractLevel1ToHeader">, Pick<{
+}, never>, Pick<{
     name: import('vue').ComputedRef<string>;
     isDarkTheme: import('vue').ComputedRef<boolean>;
     theme: import('vue').ComputedRef<{
@@ -116,39 +97,19 @@ export declare function createAppStore<UserInfo = unknown, LoginParams = unknown
         readonly focusRing?: string | undefined;
         readonly surface?: string | undefined;
     }>;
-    extractLevel1ToHeader: import('vue').Ref<boolean, boolean>;
     showHeader: import('vue').ComputedRef<boolean>;
     showFooter: import('vue').ComputedRef<boolean>;
     showSidebar: import('vue').ComputedRef<boolean>;
+    showAside: import('vue').ComputedRef<boolean>;
     showBreadcrumb: import('vue').ComputedRef<boolean>;
     keepAlive: import('vue').ComputedRef<boolean | undefined>;
-    headerStyle: import('vue').ComputedRef<{
-        height: string;
-        backgroundColor: string;
-        color: string;
-    }>;
-    footerStyle: import('vue').ComputedRef<{
-        height: string;
-        backgroundColor: string;
-    }>;
-    sidebarStyle: import('vue').ComputedRef<{
-        width: string;
-        paddingTop: string;
-        backgroundColor: string;
-        color: string;
-    }>;
-    bodyStyle: import('vue').ComputedRef<{
-        paddingLeft: string;
-        paddingTop: string;
-        paddingRight: string;
-        paddingBottom: string;
-        backgroundColor: string;
-    }>;
+    headerStyle: import('vue').ComputedRef<CSSProperties>;
+    footerStyle: import('vue').ComputedRef<CSSProperties>;
+    sidebarStyle: import('vue').ComputedRef<CSSProperties>;
+    asideStyle: import('vue').ComputedRef<CSSProperties>;
+    bodyStyle: import('vue').ComputedRef<CSSProperties>;
     bodyShimPadding: import('vue').ComputedRef<number>;
-    bodyShimStyle: import('vue').ComputedRef<{
-        minHeight: string;
-        padding: string;
-    }>;
+    bodyShimStyle: import('vue').ComputedRef<CSSProperties>;
     viewportPadding: import('vue').ComputedRef<{
         top: string;
         right: string;
@@ -159,7 +120,7 @@ export declare function createAppStore<UserInfo = unknown, LoginParams = unknown
     changeSidebarCollapseStatus: (status: boolean) => void;
     changeSidebarHasMenusStatus: (status: boolean) => void;
     changeIsDarkTheme: (status: boolean) => void;
-}, "name" | "theme" | "showHeader" | "keepAlive" | "bodyShimPadding" | "isDarkTheme" | "showFooter" | "showSidebar" | "showBreadcrumb" | "headerStyle" | "footerStyle" | "sidebarStyle" | "bodyStyle" | "bodyShimStyle" | "viewportPadding" | "sidebarIsCollapse">, Pick<{
+}, "name" | "theme" | "showHeader" | "keepAlive" | "bodyShimPadding" | "isDarkTheme" | "showFooter" | "showSidebar" | "showAside" | "showBreadcrumb" | "headerStyle" | "footerStyle" | "sidebarStyle" | "asideStyle" | "bodyStyle" | "bodyShimStyle" | "viewportPadding" | "sidebarIsCollapse">, Pick<{
     name: import('vue').ComputedRef<string>;
     isDarkTheme: import('vue').ComputedRef<boolean>;
     theme: import('vue').ComputedRef<{
@@ -181,39 +142,19 @@ export declare function createAppStore<UserInfo = unknown, LoginParams = unknown
         readonly focusRing?: string | undefined;
         readonly surface?: string | undefined;
     }>;
-    extractLevel1ToHeader: import('vue').Ref<boolean, boolean>;
     showHeader: import('vue').ComputedRef<boolean>;
     showFooter: import('vue').ComputedRef<boolean>;
     showSidebar: import('vue').ComputedRef<boolean>;
+    showAside: import('vue').ComputedRef<boolean>;
     showBreadcrumb: import('vue').ComputedRef<boolean>;
     keepAlive: import('vue').ComputedRef<boolean | undefined>;
-    headerStyle: import('vue').ComputedRef<{
-        height: string;
-        backgroundColor: string;
-        color: string;
-    }>;
-    footerStyle: import('vue').ComputedRef<{
-        height: string;
-        backgroundColor: string;
-    }>;
-    sidebarStyle: import('vue').ComputedRef<{
-        width: string;
-        paddingTop: string;
-        backgroundColor: string;
-        color: string;
-    }>;
-    bodyStyle: import('vue').ComputedRef<{
-        paddingLeft: string;
-        paddingTop: string;
-        paddingRight: string;
-        paddingBottom: string;
-        backgroundColor: string;
-    }>;
+    headerStyle: import('vue').ComputedRef<CSSProperties>;
+    footerStyle: import('vue').ComputedRef<CSSProperties>;
+    sidebarStyle: import('vue').ComputedRef<CSSProperties>;
+    asideStyle: import('vue').ComputedRef<CSSProperties>;
+    bodyStyle: import('vue').ComputedRef<CSSProperties>;
     bodyShimPadding: import('vue').ComputedRef<number>;
-    bodyShimStyle: import('vue').ComputedRef<{
-        minHeight: string;
-        padding: string;
-    }>;
+    bodyShimStyle: import('vue').ComputedRef<CSSProperties>;
     viewportPadding: import('vue').ComputedRef<{
         top: string;
         right: string;

package/types/types/route.d.ts

@@ -32,6 +32,8 @@ export interface AppRouteMeta {
     layout?: Partial<{
         header: boolean;
         sidebar: boolean;
+        /** 右侧 aside 补充区显隐（additive；默认 false，仅自定义 shell 渲染） */
+        aside: boolean;
         footer: boolean;
         breadcrumb: boolean;
         bodyShimPadding: number;

package/es/bridge/theme.mjs

@@ -1,65 +0,0 @@
-import { ref as f, readonly as d } from "vue";
-const o = "default", E = "默认", b = "admin-core-theme", I = (t) => ({
-  light: { ...t.light },
-  dark: { ...t.dark }
-}), A = (t, c) => {
-  const r = t.getItem(c);
-  if (!r) return null;
-  try {
-    const s = JSON.parse(r);
-    return s && typeof s == "object" ? s : null;
-  } catch {
-    return null;
-  }
-};
-function _(t) {
-  const c = t.storageKey ?? b, r = /* @__PURE__ */ new Map(), s = f(o), u = f(!1), g = f([]), n = f({});
-  let i = o;
-  const a = A(t.storage, c);
-  a && (typeof a.themeStyle == "string" && a.themeStyle && (i = a.themeStyle), typeof a.themeIsDark == "boolean" && (u.value = a.themeIsDark));
-  const h = () => {
-    t.storage.setItem(
-      c,
-      JSON.stringify({
-        themeStyle: s.value,
-        themeIsDark: u.value
-      })
-    );
-  }, v = () => {
-    g.value = Array.from(r.keys());
-  }, m = (e) => {
-    t.update("APP_THEME_CONFIG", { light: e.light, dark: e.dark });
-  }, y = (e) => {
-    const l = r.get(e);
-    if (!l) {
-      const k = r.get(o);
-      if (!k) return;
-      m(k), s.value = o, h();
-      return;
-    }
-    m(l), s.value = e, h();
-  }, S = (e) => {
-    u.value = !!e, h();
-  }, p = (e, l) => {
-    r.set(e, I(l.config)), n.value = { ...n.value, [e]: l.label ?? e }, v(), e === i && s.value !== i && y(e);
-  }, L = (e) => {
-    if (e === o || !r.delete(e)) return;
-    const l = { ...n.value };
-    delete l[e], n.value = l, v(), s.value === e && y(o);
-  }, D = (e) => n.value[e] ?? e;
-  return p(o, { config: t.initConfig, label: E }), {
-    theme: {
-      add: p,
-      remove: L,
-      setStyle: y,
-      setDark: S,
-      list: d(g),
-      labelOf: D
-    },
-    themeStyle: d(s),
-    themeIsDark: d(u)
-  };
-}
-export {
-  _ as createBridgeThemeHook
-};

package/types/bridge/theme.d.ts

@@ -1,85 +0,0 @@
-import { DeepReadonly, Ref } from 'vue';
-import { AppThemeConfig, StorageLike } from './index';
-/**
- * 风格切换真相源在 bridge——core 之于主题 ＝ core 之于 userInfo：core 是
- * 「无知容器 + 切换能力暴露者」，不持有 dark 真相、不关心主题内容，谁实现谁注册
- * （core 默认一对 / 插件扩展 core 均不关心）。
- *
- * 本模块从 `bridge/index.ts` 按耦合度拆出（core CLAUDE.md 规则：bridge 可独立能力
- * [MUST NOT] 都耦合进 index.ts）。维护风格 map（name → 快照 config）＋ 顶层响应式
- * `themeStyle` / `themeIsDark`，对外 `theme.{add,remove,setStyle,setDark,list}`。
- * setStyle 复用注入的 `update("APP_THEME_CONFIG", {light,dark})` 把当前风格 config
- * 灌进 bridge 响应式 APP_THEME_CONFIG（故 init 后响应式 APP_THEME_CONFIG 随切换变，
- * 不再恒等于初始值）；用注入的 `storage` 持久化 `{themeStyle,themeIsDark}` 并 init 恢复。
- */
-/**
- * 主题注册项（`bridge.theme.add` 第 2 参）——core 侧主题「preset」结构。
- *
- * core 不依赖 plugin，故自定义此最小注册形；plugin-theme 的 `AdminThemePreset`
- * （含 id/label/description/config）是其结构超集，可整坨直接透传：
- * `bridge.theme.add(preset.id, preset)`（多出的 id/description 作 excess 字段被忽略）。
- */
-export interface AdminThemeEntry {
-    /**
-     * 风格色值（light/dark 两套 `AppThemeColor`）。
-     *
-     * 内部做浅快照（`{light:{...},dark:{...}}`）——与调用方对象解耦，且与 bridge
-     * 响应式 APP_THEME_CONFIG 的 proxy target 解耦（避免切走后反写注册值）。
-     */
-    config: AppThemeConfig;
-    /** 展示名（供 `AppTheme.vue` 下拉显示，如中文「柔光悬浮」）；缺省回退注册 name 自身。 */
-    label?: string;
-}
-/** 主题模块对外能力。 */
-export interface AdminThemeModule {
-    /**
-     * 注册/覆盖一个风格（插件 install 经 `bridge.theme.add` 调；同名覆盖）。
-     *
-     * 第 2 参收 {@link AdminThemeEntry}（`{config,label?}`）；config 内部浅快照解耦。
-     * 若新注册 name 命中持久化恢复的目标风格（init 时尚未注册），自动 `setStyle(name)`。
-     */
-    add: (name: string, preset: AdminThemeEntry) => void;
-    /** 注销一个风格（`'default'` 不可注销；注销当前风格则回退 `'default'`）。 */
-    remove: (name: string) => void;
-    /** 切换风格（未注册回退 `'default'`）：同步 APP_THEME_CONFIG ＋ 持久化。 */
-    setStyle: (name: string) => void;
-    /** 切换暗色：写 `themeIsDark` ＋ 持久化。 */
-    setDark: (isDark: boolean) => void;
-    /** 响应式风格名列表（只读，供 `AppTheme.vue` 下拉；`length>1` 才显示选择）。 */
-    list: DeepReadonly<Ref<string[]>>;
-    /** 取风格展示名（`add` 注册的 label；缺省回退 name 自身）。 */
-    labelOf: (name: string) => string;
-}
-/** 主题 hook 对外契约：模块 ＋ 两个顶层响应式只读真相源。 */
-export interface BridgeThemeHook {
-    /** 主题模块（add/remove/setStyle/setDark/list） */
-    theme: AdminThemeModule;
-    /** 当前风格名（响应式只读；切换真相源，appStore / AppTheme.vue 读此） */
-    themeStyle: DeepReadonly<Ref<string>>;
-    /** 是否暗色（响应式只读；切换真相源，appStore.isDarkTheme 读此、挂值 composable toggle .dark 读此） */
-    themeIsDark: DeepReadonly<Ref<boolean>>;
-}
-/** `createBridgeThemeHook` 入参。 */
-export interface BridgeThemeInit {
-    /** init 默认风格 config（= bridge init 传入的 APP_THEME_CONFIG）；core 自动 add 为 `'default'` */
-    initConfig: AppThemeConfig;
-    /**
-     * 注入的 config 更新器（= configHook.update 收窄到 APP_THEME_CONFIG）。
-     *
-     * setStyle 经此把当前风格 config 灌进 bridge 响应式 APP_THEME_CONFIG（一级浅合并
-     * 整体替换 light/dark）。复用既有 update 通道，[MUST NOT] 另持一份主题响应式。
-     */
-    update: (key: "APP_THEME_CONFIG", partial: Partial<AppThemeConfig>) => void;
-    /** 注入的命名空间 storage（= bridge.getStorage()）；持久化 `{themeStyle,themeIsDark}` */
-    storage: StorageLike;
-    /** 持久化 key（命名空间已由 storage 加前缀）；缺省 `"admin-core-theme"` */
-    storageKey?: string;
-}
-/**
- * bridge 主题 hook 工厂。
- *
- * 每次 `createAdminBridge` 调用各自闭包内构造一份（零模块级单例，守实例隔离）。
- * init：自动 `add('default', initConfig)`；读持久化恢复 `themeIsDark` 即时生效、
- * `themeStyle` 走「desiredStyle 命中再 apply」时序（插件后注册风格亦能恢复）。
- */
-export declare function createBridgeThemeHook(init: BridgeThemeInit): BridgeThemeHook;