@robot-admin/layout 3.0.0 → 3.1.0

package/dist/index.d.cts

@@ -1,9 +1,15 @@
+import { AllowedComponentProps } from 'vue';
 import { App } from 'vue';
 import { Component } from 'vue';
+import { ComponentCustomProps } from 'vue';
+import { ComponentOptionsBase } from 'vue';
 import { ComponentOptionsMixin } from 'vue';
 import { ComponentProvideOptions } from 'vue';
 import { ComputedRef } from 'vue';
+import { CreateComponentPublicInstanceWithMixins } from 'vue';
 import { DefineComponent } from 'vue';
+import { GlobalComponents } from 'vue';
+import { GlobalDirectives } from 'vue';
 import { InjectionKey } from 'vue';
 import { MaybeRefOrGetter } from 'vue';
 import { PublicProps } from 'vue';
@@ -12,6 +18,7 @@ import { RouteLocationNormalizedLoaded } from 'vue-router';
 import { Store } from 'pinia';
 import { StoreDefinition } from 'pinia';
 import { VNode } from 'vue';
+import { VNodeProps } from 'vue';
 import { WritableComputedRef } from 'vue';
 
 declare const __VLS_component: DefineComponent<    {}, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, HTMLDivElement>;
@@ -47,7 +54,7 @@ declare const __VLS_component_7: DefineComponent<    {}, {}, {}, {}, {}, Compone
 declare const __VLS_component_8: DefineComponent<    {}, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, HTMLDivElement>;
 
 declare type __VLS_Props = {
-    /** 抽屉宽度，保持 2.x 默认值 */
+    /** 抽屉宽度，默认 380px */
     width?: number;
     /** 显式设置 Store；优先级高于 setupLayout 注入和默认 Store */
     store?: SettingsStoreInstance;
@@ -984,11 +991,204 @@ showDivider: boolean;
 variant: "vertical" | "horizontal";
 }, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
 
+/** @deprecated 请使用 CardLayout；该别名计划在 4.0 移除。 */
+export declare const C_CardLayout: {
+    new (...args: any[]): CreateComponentPublicInstanceWithMixins<Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, PublicProps, {}, true, {}, {}, GlobalComponents, GlobalDirectives, string, {}, HTMLDivElement, ComponentProvideOptions, {
+    P: {};
+    B: {};
+    D: {};
+    C: {};
+    M: {};
+    Defaults: {};
+    }, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, {}>;
+    __isFragment?: never;
+    __isTeleport?: never;
+    __isSuspense?: never;
+} & ComponentOptionsBase<Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, {}, {}, string, {}, GlobalComponents, GlobalDirectives, string, ComponentProvideOptions> & VNodeProps & AllowedComponentProps & ComponentCustomProps & (new () => {
+    $slots: {
+        'menu-trigger'?(_: {}): any;
+        logo?(_: {}): any;
+        'header-extra'?(_: {}): any;
+        'tags-view'?(_: {}): any;
+        'drawer-menu'?(_: {}): any;
+        footer?(_: {}): any;
+    };
+});
+
 export declare const C_LayoutContainer: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
 
+/** @deprecated 请使用 MixLayout；该别名计划在 4.0 移除。 */
+export declare const C_MixLayout: {
+    new (...args: any[]): CreateComponentPublicInstanceWithMixins<Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, PublicProps, {}, true, {}, {}, GlobalComponents, GlobalDirectives, string, {}, HTMLDivElement, ComponentProvideOptions, {
+    P: {};
+    B: {};
+    D: {};
+    C: {};
+    M: {};
+    Defaults: {};
+    }, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, {}>;
+    __isFragment?: never;
+    __isTeleport?: never;
+    __isSuspense?: never;
+} & ComponentOptionsBase<Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, {}, {}, string, {}, GlobalComponents, GlobalDirectives, string, ComponentProvideOptions> & VNodeProps & AllowedComponentProps & ComponentCustomProps & (new () => {
+    $slots: {
+        logo?(_: {}): any;
+        header?(_: {}): any;
+        footer?(_: {}): any;
+    };
+});
+
+/** @deprecated 请使用 MixTopLayout；该别名计划在 4.0 移除。 */
+export declare const C_MixTopLayout: {
+    new (...args: any[]): CreateComponentPublicInstanceWithMixins<Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, PublicProps, {}, true, {}, {}, GlobalComponents, GlobalDirectives, string, {}, HTMLDivElement, ComponentProvideOptions, {
+    P: {};
+    B: {};
+    D: {};
+    C: {};
+    M: {};
+    Defaults: {};
+    }, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, {}>;
+    __isFragment?: never;
+    __isTeleport?: never;
+    __isSuspense?: never;
+} & ComponentOptionsBase<Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, {}, {}, string, {}, GlobalComponents, GlobalDirectives, string, ComponentProvideOptions> & VNodeProps & AllowedComponentProps & ComponentCustomProps & (new () => {
+    $slots: {
+        logo?(_: {}): any;
+        brand?(_: {}): any;
+        'top-menu'?(_: {}): any;
+        'header-extra'?(_: {}): any;
+        'tags-view'?(_: {}): any;
+        footer?(_: {}): any;
+    };
+});
+
+/** @deprecated 请使用 ReverseHorizontalMixLayout；该别名计划在 4.0 移除。 */
+export declare const C_ReverseHorizontalMixLayout: {
+    new (...args: any[]): CreateComponentPublicInstanceWithMixins<Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, PublicProps, {}, true, {}, {}, GlobalComponents, GlobalDirectives, string, {}, HTMLDivElement, ComponentProvideOptions, {
+    P: {};
+    B: {};
+    D: {};
+    C: {};
+    M: {};
+    Defaults: {};
+    }, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, {}>;
+    __isFragment?: never;
+    __isTeleport?: never;
+    __isSuspense?: never;
+} & ComponentOptionsBase<Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, {}, {}, string, {}, GlobalComponents, GlobalDirectives, string, ComponentProvideOptions> & VNodeProps & AllowedComponentProps & ComponentCustomProps & (new () => {
+    $slots: {
+        logo?(_: {}): any;
+        'top-menu'?(_: {}): any;
+        'header-extra'?(_: {}): any;
+        'tags-view'?(_: {}): any;
+        footer?(_: {}): any;
+    };
+});
+
+/** @deprecated 请使用 SideLayout；该别名计划在 4.0 移除。 */
+export declare const C_SideLayout: {
+    new (...args: any[]): CreateComponentPublicInstanceWithMixins<Readonly<{
+    collapsed?: boolean;
+    }> & Readonly<{
+    "onUpdate:collapsed"?: ((value: boolean) => any) | undefined;
+    }>, {
+    collapsed: ComputedRef<boolean>;
+    toggleCollapse: () => void;
+    }, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    "update:collapsed": (value: boolean) => any;
+    }, PublicProps, {
+    collapsed: boolean;
+    }, false, {}, {}, GlobalComponents, GlobalDirectives, string, {}, any, ComponentProvideOptions, {
+    P: {};
+    B: {};
+    D: {};
+    C: {};
+    M: {};
+    Defaults: {};
+    }, Readonly<{
+    collapsed?: boolean;
+    }> & Readonly<{
+    "onUpdate:collapsed"?: ((value: boolean) => any) | undefined;
+    }>, {
+    collapsed: ComputedRef<boolean>;
+    toggleCollapse: () => void;
+    }, {}, {}, {}, {
+    collapsed: boolean;
+    }>;
+    __isFragment?: never;
+    __isTeleport?: never;
+    __isSuspense?: never;
+} & ComponentOptionsBase<Readonly<{
+collapsed?: boolean;
+}> & Readonly<{
+"onUpdate:collapsed"?: ((value: boolean) => any) | undefined;
+}>, {
+collapsed: ComputedRef<boolean>;
+toggleCollapse: () => void;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+"update:collapsed": (value: boolean) => any;
+}, string, {
+collapsed: boolean;
+}, {}, string, {}, GlobalComponents, GlobalDirectives, string, ComponentProvideOptions> & VNodeProps & AllowedComponentProps & ComponentCustomProps & (new () => {
+    $slots: {
+        logo?(_: {}): any;
+        menu?(_: {
+            collapsed: boolean;
+        }): any;
+        header?(_: {}): any;
+        footer?(_: {}): any;
+    };
+});
+
+/** @deprecated 请使用 TopLayout；该别名计划在 4.0 移除。 */
+export declare const C_TopLayout: {
+    new (...args: any[]): CreateComponentPublicInstanceWithMixins<Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, PublicProps, {}, true, {}, {}, GlobalComponents, GlobalDirectives, string, {}, HTMLDivElement, ComponentProvideOptions, {
+    P: {};
+    B: {};
+    D: {};
+    C: {};
+    M: {};
+    Defaults: {};
+    }, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, {}>;
+    __isFragment?: never;
+    __isTeleport?: never;
+    __isSuspense?: never;
+} & ComponentOptionsBase<Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, {}, {}, string, {}, GlobalComponents, GlobalDirectives, string, ComponentProvideOptions> & VNodeProps & AllowedComponentProps & ComponentCustomProps & (new () => {
+    $slots: {
+        logo?(_: {}): any;
+        menu?(_: {}): any;
+        'header-extra'?(_: {}): any;
+        'tags-view'?(_: {}): any;
+        footer?(_: {}): any;
+    };
+});
+
+export declare const CardLayout: __VLS_WithTemplateSlots_8<typeof __VLS_component_8, __VLS_TemplateResult_8["slots"]>;
+
 /** Color swatches for color picker */
 export declare const COLOR_SWATCHES: string[];
 
+/**
+ * 将最小宿主输入转换为完整 LayoutContext。
+ *
+ * 保留底层 LayoutContext 作为高级扩展协议，同时避免普通接入重复桥接 Store 字段。
+ */
+export declare function createLayoutContext(options: CreateLayoutContextOptions): LayoutContext;
+
+/** 创建标准布局上下文所需的最小宿主适配。 */
+export declare interface CreateLayoutContextOptions {
+    /** 布局设置 Store，可使用默认 Store 或 createSettingsStore() 创建的实例。 */
+    settings: SettingsStoreInstance;
+    /** 宿主菜单；支持普通值、Ref、ComputedRef 或 getter。 */
+    menus: MaybeRefOrGetter<MenuOptions[]>;
+    /** 宿主暗色状态；支持普通值、Ref、ComputedRef 或 getter。 */
+    isDark: MaybeRefOrGetter<boolean>;
+    /** 品牌信息，未提供的字段使用包内安全默认值。 */
+    brand?: LayoutBrandConfig;
+    /** 布局内部用于渲染菜单图标的宿主组件。 */
+    iconComponent?: Component;
+}
+
 /**
  * 创建设置管理 Store
  * @param options - 配置选项
@@ -1085,30 +1285,6 @@ updateThemeMode: (mode: ThemeMode) => Promise<void>;
 toggleCollapse: () => void;
 }, "syncCSSVariables" | "applyPreset" | "resetSettings" | "updateThemeMode" | "toggleCollapse">>;
 
-declare const _default: __VLS_WithTemplateSlots_3<typeof __VLS_component_3, __VLS_TemplateResult_3["slots"]>;
-export { _default as C_SideLayout }
-export { _default as SideLayout }
-
-declare const _default_2: __VLS_WithTemplateSlots_4<typeof __VLS_component_4, __VLS_TemplateResult_4["slots"]>;
-export { _default_2 as C_TopLayout }
-export { _default_2 as TopLayout }
-
-declare const _default_3: __VLS_WithTemplateSlots_5<typeof __VLS_component_5, __VLS_TemplateResult_5["slots"]>;
-export { _default_3 as C_MixLayout }
-export { _default_3 as MixLayout }
-
-declare const _default_4: __VLS_WithTemplateSlots_6<typeof __VLS_component_6, __VLS_TemplateResult_6["slots"]>;
-export { _default_4 as C_MixTopLayout }
-export { _default_4 as MixTopLayout }
-
-declare const _default_5: __VLS_WithTemplateSlots_7<typeof __VLS_component_7, __VLS_TemplateResult_7["slots"]>;
-export { _default_5 as C_ReverseHorizontalMixLayout }
-export { _default_5 as ReverseHorizontalMixLayout }
-
-declare const _default_6: __VLS_WithTemplateSlots_8<typeof __VLS_component_8, __VLS_TemplateResult_8["slots"]>;
-export { _default_6 as C_CardLayout }
-export { _default_6 as CardLayout }
-
 /**
  * 默认品牌配置
  */
@@ -1346,6 +1522,10 @@ export declare interface MenuTag {
 
 export declare const MenuTrigger: DefineComponent<__VLS_Props_7, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_7> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
 
+export declare const MixLayout: __VLS_WithTemplateSlots_5<typeof __VLS_component_5, __VLS_TemplateResult_5["slots"]>;
+
+export declare const MixTopLayout: __VLS_WithTemplateSlots_6<typeof __VLS_component_6, __VLS_TemplateResult_6["slots"]>;
+
 export declare const PRESET_COLORS: PresetColor[];
 
 /** 预设颜色。 */
@@ -1354,6 +1534,9 @@ export declare interface PresetColor {
     value: string;
 }
 
+/** 在组件 setup 中创建并提供标准布局上下文。 */
+export declare function provideLayout(options: CreateLayoutContextOptions): LayoutContext;
+
 /** 在组件 setup 中提供布局上下文，避免消费方直接操作 InjectionKey。 */
 export declare function provideLayoutContext(context: LayoutContext): LayoutContext;
 
@@ -1361,6 +1544,8 @@ export declare const ResponsiveMenu: DefineComponent<__VLS_Props_8, {}, {}, {},
 containerRef: HTMLDivElement;
 }, HTMLDivElement>;
 
+export declare const ReverseHorizontalMixLayout: __VLS_WithTemplateSlots_7<typeof __VLS_component_7, __VLS_TemplateResult_7["slots"]>;
+
 /**
  * 一次性校验完整导入文件。此函数不修改任何响应式状态或浏览器 API，
  * 消费方可以在成功返回后再原子应用结果。
@@ -1529,6 +1714,8 @@ export declare function shouldCacheRoute(route: Pick<RouteLocationNormalizedLoad
     name: string;
 };
 
+export declare const SideLayout: __VLS_WithTemplateSlots_3<typeof __VLS_component_3, __VLS_TemplateResult_3["slots"]>;
+
 export declare const SideMenu: DefineComponent<__VLS_Props_5, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
 click: (item: MenuOptions) => any;
 }, string, PublicProps, Readonly<__VLS_Props_5> & Readonly<{
@@ -1552,6 +1739,8 @@ export declare interface ThemePreset {
     settings?: Partial<Omit<SettingsState, "themeMode" | "layoutMode" | "primaryColor">>;
 }
 
+export declare const TopLayout: __VLS_WithTemplateSlots_4<typeof __VLS_component_4, __VLS_TemplateResult_4["slots"]>;
+
 export declare const TRANSITION_MAP: {
     readonly fade: "fade-transform";
     readonly slide: "fade-slide";

package/dist/index.d.ts

@@ -1,9 +1,15 @@
+import { AllowedComponentProps } from 'vue';
 import { App } from 'vue';
 import { Component } from 'vue';
+import { ComponentCustomProps } from 'vue';
+import { ComponentOptionsBase } from 'vue';
 import { ComponentOptionsMixin } from 'vue';
 import { ComponentProvideOptions } from 'vue';
 import { ComputedRef } from 'vue';
+import { CreateComponentPublicInstanceWithMixins } from 'vue';
 import { DefineComponent } from 'vue';
+import { GlobalComponents } from 'vue';
+import { GlobalDirectives } from 'vue';
 import { InjectionKey } from 'vue';
 import { MaybeRefOrGetter } from 'vue';
 import { PublicProps } from 'vue';
@@ -12,6 +18,7 @@ import { RouteLocationNormalizedLoaded } from 'vue-router';
 import { Store } from 'pinia';
 import { StoreDefinition } from 'pinia';
 import { VNode } from 'vue';
+import { VNodeProps } from 'vue';
 import { WritableComputedRef } from 'vue';
 
 declare const __VLS_component: DefineComponent<    {}, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, HTMLDivElement>;
@@ -47,7 +54,7 @@ declare const __VLS_component_7: DefineComponent<    {}, {}, {}, {}, {}, Compone
 declare const __VLS_component_8: DefineComponent<    {}, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, HTMLDivElement>;
 
 declare type __VLS_Props = {
-    /** 抽屉宽度，保持 2.x 默认值 */
+    /** 抽屉宽度，默认 380px */
     width?: number;
     /** 显式设置 Store；优先级高于 setupLayout 注入和默认 Store */
     store?: SettingsStoreInstance;
@@ -984,11 +991,204 @@ showDivider: boolean;
 variant: "vertical" | "horizontal";
 }, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
 
+/** @deprecated 请使用 CardLayout；该别名计划在 4.0 移除。 */
+export declare const C_CardLayout: {
+    new (...args: any[]): CreateComponentPublicInstanceWithMixins<Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, PublicProps, {}, true, {}, {}, GlobalComponents, GlobalDirectives, string, {}, HTMLDivElement, ComponentProvideOptions, {
+    P: {};
+    B: {};
+    D: {};
+    C: {};
+    M: {};
+    Defaults: {};
+    }, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, {}>;
+    __isFragment?: never;
+    __isTeleport?: never;
+    __isSuspense?: never;
+} & ComponentOptionsBase<Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, {}, {}, string, {}, GlobalComponents, GlobalDirectives, string, ComponentProvideOptions> & VNodeProps & AllowedComponentProps & ComponentCustomProps & (new () => {
+    $slots: {
+        'menu-trigger'?(_: {}): any;
+        logo?(_: {}): any;
+        'header-extra'?(_: {}): any;
+        'tags-view'?(_: {}): any;
+        'drawer-menu'?(_: {}): any;
+        footer?(_: {}): any;
+    };
+});
+
 export declare const C_LayoutContainer: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
 
+/** @deprecated 请使用 MixLayout；该别名计划在 4.0 移除。 */
+export declare const C_MixLayout: {
+    new (...args: any[]): CreateComponentPublicInstanceWithMixins<Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, PublicProps, {}, true, {}, {}, GlobalComponents, GlobalDirectives, string, {}, HTMLDivElement, ComponentProvideOptions, {
+    P: {};
+    B: {};
+    D: {};
+    C: {};
+    M: {};
+    Defaults: {};
+    }, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, {}>;
+    __isFragment?: never;
+    __isTeleport?: never;
+    __isSuspense?: never;
+} & ComponentOptionsBase<Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, {}, {}, string, {}, GlobalComponents, GlobalDirectives, string, ComponentProvideOptions> & VNodeProps & AllowedComponentProps & ComponentCustomProps & (new () => {
+    $slots: {
+        logo?(_: {}): any;
+        header?(_: {}): any;
+        footer?(_: {}): any;
+    };
+});
+
+/** @deprecated 请使用 MixTopLayout；该别名计划在 4.0 移除。 */
+export declare const C_MixTopLayout: {
+    new (...args: any[]): CreateComponentPublicInstanceWithMixins<Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, PublicProps, {}, true, {}, {}, GlobalComponents, GlobalDirectives, string, {}, HTMLDivElement, ComponentProvideOptions, {
+    P: {};
+    B: {};
+    D: {};
+    C: {};
+    M: {};
+    Defaults: {};
+    }, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, {}>;
+    __isFragment?: never;
+    __isTeleport?: never;
+    __isSuspense?: never;
+} & ComponentOptionsBase<Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, {}, {}, string, {}, GlobalComponents, GlobalDirectives, string, ComponentProvideOptions> & VNodeProps & AllowedComponentProps & ComponentCustomProps & (new () => {
+    $slots: {
+        logo?(_: {}): any;
+        brand?(_: {}): any;
+        'top-menu'?(_: {}): any;
+        'header-extra'?(_: {}): any;
+        'tags-view'?(_: {}): any;
+        footer?(_: {}): any;
+    };
+});
+
+/** @deprecated 请使用 ReverseHorizontalMixLayout；该别名计划在 4.0 移除。 */
+export declare const C_ReverseHorizontalMixLayout: {
+    new (...args: any[]): CreateComponentPublicInstanceWithMixins<Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, PublicProps, {}, true, {}, {}, GlobalComponents, GlobalDirectives, string, {}, HTMLDivElement, ComponentProvideOptions, {
+    P: {};
+    B: {};
+    D: {};
+    C: {};
+    M: {};
+    Defaults: {};
+    }, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, {}>;
+    __isFragment?: never;
+    __isTeleport?: never;
+    __isSuspense?: never;
+} & ComponentOptionsBase<Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, {}, {}, string, {}, GlobalComponents, GlobalDirectives, string, ComponentProvideOptions> & VNodeProps & AllowedComponentProps & ComponentCustomProps & (new () => {
+    $slots: {
+        logo?(_: {}): any;
+        'top-menu'?(_: {}): any;
+        'header-extra'?(_: {}): any;
+        'tags-view'?(_: {}): any;
+        footer?(_: {}): any;
+    };
+});
+
+/** @deprecated 请使用 SideLayout；该别名计划在 4.0 移除。 */
+export declare const C_SideLayout: {
+    new (...args: any[]): CreateComponentPublicInstanceWithMixins<Readonly<{
+    collapsed?: boolean;
+    }> & Readonly<{
+    "onUpdate:collapsed"?: ((value: boolean) => any) | undefined;
+    }>, {
+    collapsed: ComputedRef<boolean>;
+    toggleCollapse: () => void;
+    }, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    "update:collapsed": (value: boolean) => any;
+    }, PublicProps, {
+    collapsed: boolean;
+    }, false, {}, {}, GlobalComponents, GlobalDirectives, string, {}, any, ComponentProvideOptions, {
+    P: {};
+    B: {};
+    D: {};
+    C: {};
+    M: {};
+    Defaults: {};
+    }, Readonly<{
+    collapsed?: boolean;
+    }> & Readonly<{
+    "onUpdate:collapsed"?: ((value: boolean) => any) | undefined;
+    }>, {
+    collapsed: ComputedRef<boolean>;
+    toggleCollapse: () => void;
+    }, {}, {}, {}, {
+    collapsed: boolean;
+    }>;
+    __isFragment?: never;
+    __isTeleport?: never;
+    __isSuspense?: never;
+} & ComponentOptionsBase<Readonly<{
+collapsed?: boolean;
+}> & Readonly<{
+"onUpdate:collapsed"?: ((value: boolean) => any) | undefined;
+}>, {
+collapsed: ComputedRef<boolean>;
+toggleCollapse: () => void;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+"update:collapsed": (value: boolean) => any;
+}, string, {
+collapsed: boolean;
+}, {}, string, {}, GlobalComponents, GlobalDirectives, string, ComponentProvideOptions> & VNodeProps & AllowedComponentProps & ComponentCustomProps & (new () => {
+    $slots: {
+        logo?(_: {}): any;
+        menu?(_: {
+            collapsed: boolean;
+        }): any;
+        header?(_: {}): any;
+        footer?(_: {}): any;
+    };
+});
+
+/** @deprecated 请使用 TopLayout；该别名计划在 4.0 移除。 */
+export declare const C_TopLayout: {
+    new (...args: any[]): CreateComponentPublicInstanceWithMixins<Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, PublicProps, {}, true, {}, {}, GlobalComponents, GlobalDirectives, string, {}, HTMLDivElement, ComponentProvideOptions, {
+    P: {};
+    B: {};
+    D: {};
+    C: {};
+    M: {};
+    Defaults: {};
+    }, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, {}>;
+    __isFragment?: never;
+    __isTeleport?: never;
+    __isSuspense?: never;
+} & ComponentOptionsBase<Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, {}, {}, string, {}, GlobalComponents, GlobalDirectives, string, ComponentProvideOptions> & VNodeProps & AllowedComponentProps & ComponentCustomProps & (new () => {
+    $slots: {
+        logo?(_: {}): any;
+        menu?(_: {}): any;
+        'header-extra'?(_: {}): any;
+        'tags-view'?(_: {}): any;
+        footer?(_: {}): any;
+    };
+});
+
+export declare const CardLayout: __VLS_WithTemplateSlots_8<typeof __VLS_component_8, __VLS_TemplateResult_8["slots"]>;
+
 /** Color swatches for color picker */
 export declare const COLOR_SWATCHES: string[];
 
+/**
+ * 将最小宿主输入转换为完整 LayoutContext。
+ *
+ * 保留底层 LayoutContext 作为高级扩展协议，同时避免普通接入重复桥接 Store 字段。
+ */
+export declare function createLayoutContext(options: CreateLayoutContextOptions): LayoutContext;
+
+/** 创建标准布局上下文所需的最小宿主适配。 */
+export declare interface CreateLayoutContextOptions {
+    /** 布局设置 Store，可使用默认 Store 或 createSettingsStore() 创建的实例。 */
+    settings: SettingsStoreInstance;
+    /** 宿主菜单；支持普通值、Ref、ComputedRef 或 getter。 */
+    menus: MaybeRefOrGetter<MenuOptions[]>;
+    /** 宿主暗色状态；支持普通值、Ref、ComputedRef 或 getter。 */
+    isDark: MaybeRefOrGetter<boolean>;
+    /** 品牌信息，未提供的字段使用包内安全默认值。 */
+    brand?: LayoutBrandConfig;
+    /** 布局内部用于渲染菜单图标的宿主组件。 */
+    iconComponent?: Component;
+}
+
 /**
  * 创建设置管理 Store
  * @param options - 配置选项
@@ -1085,30 +1285,6 @@ updateThemeMode: (mode: ThemeMode) => Promise<void>;
 toggleCollapse: () => void;
 }, "syncCSSVariables" | "applyPreset" | "resetSettings" | "updateThemeMode" | "toggleCollapse">>;
 
-declare const _default: __VLS_WithTemplateSlots_3<typeof __VLS_component_3, __VLS_TemplateResult_3["slots"]>;
-export { _default as C_SideLayout }
-export { _default as SideLayout }
-
-declare const _default_2: __VLS_WithTemplateSlots_4<typeof __VLS_component_4, __VLS_TemplateResult_4["slots"]>;
-export { _default_2 as C_TopLayout }
-export { _default_2 as TopLayout }
-
-declare const _default_3: __VLS_WithTemplateSlots_5<typeof __VLS_component_5, __VLS_TemplateResult_5["slots"]>;
-export { _default_3 as C_MixLayout }
-export { _default_3 as MixLayout }
-
-declare const _default_4: __VLS_WithTemplateSlots_6<typeof __VLS_component_6, __VLS_TemplateResult_6["slots"]>;
-export { _default_4 as C_MixTopLayout }
-export { _default_4 as MixTopLayout }
-
-declare const _default_5: __VLS_WithTemplateSlots_7<typeof __VLS_component_7, __VLS_TemplateResult_7["slots"]>;
-export { _default_5 as C_ReverseHorizontalMixLayout }
-export { _default_5 as ReverseHorizontalMixLayout }
-
-declare const _default_6: __VLS_WithTemplateSlots_8<typeof __VLS_component_8, __VLS_TemplateResult_8["slots"]>;
-export { _default_6 as C_CardLayout }
-export { _default_6 as CardLayout }
-
 /**
  * 默认品牌配置
  */
@@ -1346,6 +1522,10 @@ export declare interface MenuTag {
 
 export declare const MenuTrigger: DefineComponent<__VLS_Props_7, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_7> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
 
+export declare const MixLayout: __VLS_WithTemplateSlots_5<typeof __VLS_component_5, __VLS_TemplateResult_5["slots"]>;
+
+export declare const MixTopLayout: __VLS_WithTemplateSlots_6<typeof __VLS_component_6, __VLS_TemplateResult_6["slots"]>;
+
 export declare const PRESET_COLORS: PresetColor[];
 
 /** 预设颜色。 */
@@ -1354,6 +1534,9 @@ export declare interface PresetColor {
     value: string;
 }
 
+/** 在组件 setup 中创建并提供标准布局上下文。 */
+export declare function provideLayout(options: CreateLayoutContextOptions): LayoutContext;
+
 /** 在组件 setup 中提供布局上下文，避免消费方直接操作 InjectionKey。 */
 export declare function provideLayoutContext(context: LayoutContext): LayoutContext;
 
@@ -1361,6 +1544,8 @@ export declare const ResponsiveMenu: DefineComponent<__VLS_Props_8, {}, {}, {},
 containerRef: HTMLDivElement;
 }, HTMLDivElement>;
 
+export declare const ReverseHorizontalMixLayout: __VLS_WithTemplateSlots_7<typeof __VLS_component_7, __VLS_TemplateResult_7["slots"]>;
+
 /**
  * 一次性校验完整导入文件。此函数不修改任何响应式状态或浏览器 API，
  * 消费方可以在成功返回后再原子应用结果。
@@ -1529,6 +1714,8 @@ export declare function shouldCacheRoute(route: Pick<RouteLocationNormalizedLoad
     name: string;
 };
 
+export declare const SideLayout: __VLS_WithTemplateSlots_3<typeof __VLS_component_3, __VLS_TemplateResult_3["slots"]>;
+
 export declare const SideMenu: DefineComponent<__VLS_Props_5, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
 click: (item: MenuOptions) => any;
 }, string, PublicProps, Readonly<__VLS_Props_5> & Readonly<{
@@ -1552,6 +1739,8 @@ export declare interface ThemePreset {
     settings?: Partial<Omit<SettingsState, "themeMode" | "layoutMode" | "primaryColor">>;
 }
 
+export declare const TopLayout: __VLS_WithTemplateSlots_4<typeof __VLS_component_4, __VLS_TemplateResult_4["slots"]>;
+
 export declare const TRANSITION_MAP: {
     readonly fade: "fade-transform";
     readonly slide: "fade-slide";