@robot-admin/layout 2.3.1 → 3.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (18) hide show
  1. package/CHANGELOG.md +144 -0
  2. package/LICENSE +21 -0
  3. package/README.md +124 -59
  4. package/dist/core/index.cjs +310 -0
  5. package/dist/core/index.cjs.map +1 -0
  6. package/dist/core/index.d.cts +121 -0
  7. package/dist/core/index.d.ts +121 -0
  8. package/dist/core/index.js +273 -0
  9. package/dist/core/index.js.map +1 -0
  10. package/dist/index.cjs +3 -3
  11. package/dist/index.cjs.map +1 -1
  12. package/dist/index.css +1 -1
  13. package/dist/index.d.cts +1750 -0
  14. package/dist/index.d.ts +803 -109
  15. package/dist/index.js +1191 -882
  16. package/dist/index.js.map +1 -1
  17. package/package.json +39 -15
  18. package/src/styles/settings.scss +6 -0
package/dist/index.d.ts CHANGED
@@ -8,25 +8,34 @@ import { InjectionKey } from 'vue';
8
8
  import { MaybeRefOrGetter } from 'vue';
9
9
  import { PublicProps } from 'vue';
10
10
  import { Ref } from 'vue';
11
+ import { RouteLocationNormalizedLoaded } from 'vue-router';
12
+ import { Store } from 'pinia';
11
13
  import { StoreDefinition } from 'pinia';
12
- import { ThemeMode } from '@robot-admin/theme';
13
14
  import { VNode } from 'vue';
15
+ import { WritableComputedRef } from 'vue';
14
16
 
15
17
  declare const __VLS_component: DefineComponent< {}, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, HTMLDivElement>;
16
18
 
17
- declare const __VLS_component_2: DefineComponent<__VLS_Props_8, {
19
+ declare const __VLS_component_2: DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
20
+ "update:show": (value: boolean) => any;
21
+ }, string, PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
22
+ "onUpdate:show"?: ((value: boolean) => any) | undefined;
23
+ }>, {
24
+ width: number;
25
+ maxImportBytes: number;
26
+ }, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
27
+
28
+ declare const __VLS_component_3: DefineComponent<__VLS_Props_9, {
18
29
  collapsed: ComputedRef<boolean>;
19
30
  toggleCollapse: () => void;
20
31
  }, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
21
32
  "update:collapsed": (value: boolean) => any;
22
- }, string, PublicProps, Readonly<__VLS_Props_8> & Readonly<{
33
+ }, string, PublicProps, Readonly<__VLS_Props_9> & Readonly<{
23
34
  "onUpdate:collapsed"?: ((value: boolean) => any) | undefined;
24
35
  }>, {
25
36
  collapsed: boolean;
26
37
  }, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
27
38
 
28
- declare const __VLS_component_3: DefineComponent< {}, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, HTMLDivElement>;
29
-
30
39
  declare const __VLS_component_4: DefineComponent< {}, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, HTMLDivElement>;
31
40
 
32
41
  declare const __VLS_component_5: DefineComponent< {}, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, HTMLDivElement>;
@@ -35,7 +44,20 @@ declare const __VLS_component_6: DefineComponent< {}, {}, {}, {}, {}, Compone
35
44
 
36
45
  declare const __VLS_component_7: DefineComponent< {}, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, HTMLDivElement>;
37
46
 
47
+ declare const __VLS_component_8: DefineComponent< {}, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, HTMLDivElement>;
48
+
38
49
  declare type __VLS_Props = {
50
+ /** 抽屉宽度，保持 2.x 默认值 */
51
+ width?: number;
52
+ /** 显式设置 Store；优先级高于 setupLayout 注入和默认 Store */
53
+ store?: SettingsStoreInstance;
54
+ /** 由宿主实现的缓存清理、页面刷新等高副作用操作 */
55
+ actions?: SettingsDrawerActions;
56
+ /** 导入文件最大字节数，默认 1 MiB */
57
+ maxImportBytes?: number;
58
+ };
59
+
60
+ declare type __VLS_Props_2 = {
39
61
  /** 是否显示品牌名称 */
40
62
  showName?: boolean;
41
63
  /** 是否显示分隔线 */
@@ -48,14 +70,14 @@ declare type __VLS_Props = {
48
70
  variant?: "vertical" | "horizontal";
49
71
  };
50
72
 
51
- declare type __VLS_Props_2 = {
73
+ declare type __VLS_Props_3 = {
52
74
  /** 菜单数据 */
53
75
  menus: MenuOptions[];
54
76
  /** 当前激活的菜单路径 */
55
77
  active?: string;
56
78
  };
57
79
 
58
- declare type __VLS_Props_3 = {
80
+ declare type __VLS_Props_4 = {
59
81
  /** 是否显示 */
60
82
  show: boolean;
61
83
  /** 当前悬浮的一级菜单项（包含 children） */
@@ -64,7 +86,7 @@ declare type __VLS_Props_3 = {
64
86
  isActive?: (path: string | undefined) => boolean;
65
87
  };
66
88
 
67
- declare type __VLS_Props_4 = {
89
+ declare type __VLS_Props_5 = {
68
90
  /** 二级菜单列表 */
69
91
  menus: MenuOptions[];
70
92
  /** 当前一级菜单项（显示标题和图标） */
@@ -73,30 +95,30 @@ declare type __VLS_Props_4 = {
73
95
  isActive?: (path: string | undefined) => boolean;
74
96
  };
75
97
 
76
- declare type __VLS_Props_5 = {
98
+ declare type __VLS_Props_6 = {
77
99
  /** 菜单数据 */
78
100
  menus: MenuOptions[];
79
101
  /** 是否显示 */
80
102
  show: boolean;
81
103
  };
82
104
 
83
- declare type __VLS_Props_6 = {
105
+ declare type __VLS_Props_7 = {
84
106
  show?: boolean;
85
107
  };
86
108
 
87
- declare type __VLS_Props_7 = {
109
+ declare type __VLS_Props_8 = {
88
110
  /** 菜单数据 */
89
111
  data: MenuOptions[];
90
112
  };
91
113
 
92
- declare type __VLS_Props_8 = {
114
+ declare type __VLS_Props_9 = {
93
115
  /** 控制侧边栏折叠状态 (支持 v-model:collapsed) */
94
116
  collapsed?: boolean;
95
117
  };
96
118
 
97
119
  declare type __VLS_PublicProps = {
98
120
  "show"?: boolean;
99
- };
121
+ } & __VLS_Props;
100
122
 
101
123
  declare function __VLS_template(): {
102
124
  attrs: Partial<{}>;
@@ -138,6 +160,665 @@ declare function __VLS_template(): {
138
160
  };
139
161
 
140
162
  declare function __VLS_template_2(): {
163
+ attrs: Partial<{}>;
164
+ slots: {
165
+ 'appearance-prepend'?(_: {
166
+ settings: Store<string, Pick<{
167
+ themeMode: Ref<ThemeMode, ThemeMode>;
168
+ primaryColor: Ref<string, string>;
169
+ borderRadius: Ref<BorderRadiusSize, BorderRadiusSize>;
170
+ transitionType: Ref<TransitionType, TransitionType>;
171
+ enableTransition: Ref<boolean, boolean>;
172
+ layoutMode: Ref<LayoutMode, LayoutMode>;
173
+ menuExpandMode: Ref<MenuExpandMode, MenuExpandMode>;
174
+ collapsed: Ref<boolean, boolean>;
175
+ fixedHeader: Ref<boolean, boolean>;
176
+ showBreadcrumb: Ref<boolean, boolean>;
177
+ showBreadcrumbIcon: Ref<boolean, boolean>;
178
+ showTagsView: Ref<boolean, boolean>;
179
+ tagsViewHeight: Ref<number, number>;
180
+ tagsViewStyle: Ref<TagsViewStyle, TagsViewStyle>;
181
+ showFooter: Ref<boolean, boolean>;
182
+ sidebarWidth: Ref<number, number>;
183
+ sidebarCollapsedWidth: Ref<number, number>;
184
+ headerHeight: Ref<number, number>;
185
+ enableHotkeys: Ref<boolean, boolean>;
186
+ version: Ref<string, string>;
187
+ borderRadiusValue: ComputedRef<"4px" | "6px" | "8px">;
188
+ transitionName: ComputedRef<"" | "fade-transform" | "fade-slide" | "fade-zoom">;
189
+ shouldEnableTransition: ComputedRef<boolean>;
190
+ settingsState: ComputedRef<SettingsState>;
191
+ syncCSSVariables: () => void;
192
+ applyPreset: (preset: ThemePreset) => Promise<void>;
193
+ resetSettings: () => void;
194
+ updateThemeMode: (mode: ThemeMode) => Promise<void>;
195
+ toggleCollapse: () => void;
196
+ }, "themeMode" | "layoutMode" | "primaryColor" | "borderRadius" | "transitionType" | "enableTransition" | "menuExpandMode" | "collapsed" | "fixedHeader" | "showBreadcrumb" | "showBreadcrumbIcon" | "showTagsView" | "tagsViewHeight" | "tagsViewStyle" | "showFooter" | "sidebarWidth" | "sidebarCollapsedWidth" | "headerHeight" | "enableHotkeys" | "version">, Pick<{
197
+ themeMode: Ref<ThemeMode, ThemeMode>;
198
+ primaryColor: Ref<string, string>;
199
+ borderRadius: Ref<BorderRadiusSize, BorderRadiusSize>;
200
+ transitionType: Ref<TransitionType, TransitionType>;
201
+ enableTransition: Ref<boolean, boolean>;
202
+ layoutMode: Ref<LayoutMode, LayoutMode>;
203
+ menuExpandMode: Ref<MenuExpandMode, MenuExpandMode>;
204
+ collapsed: Ref<boolean, boolean>;
205
+ fixedHeader: Ref<boolean, boolean>;
206
+ showBreadcrumb: Ref<boolean, boolean>;
207
+ showBreadcrumbIcon: Ref<boolean, boolean>;
208
+ showTagsView: Ref<boolean, boolean>;
209
+ tagsViewHeight: Ref<number, number>;
210
+ tagsViewStyle: Ref<TagsViewStyle, TagsViewStyle>;
211
+ showFooter: Ref<boolean, boolean>;
212
+ sidebarWidth: Ref<number, number>;
213
+ sidebarCollapsedWidth: Ref<number, number>;
214
+ headerHeight: Ref<number, number>;
215
+ enableHotkeys: Ref<boolean, boolean>;
216
+ version: Ref<string, string>;
217
+ borderRadiusValue: ComputedRef<"4px" | "6px" | "8px">;
218
+ transitionName: ComputedRef<"" | "fade-transform" | "fade-slide" | "fade-zoom">;
219
+ shouldEnableTransition: ComputedRef<boolean>;
220
+ settingsState: ComputedRef<SettingsState>;
221
+ syncCSSVariables: () => void;
222
+ applyPreset: (preset: ThemePreset) => Promise<void>;
223
+ resetSettings: () => void;
224
+ updateThemeMode: (mode: ThemeMode) => Promise<void>;
225
+ toggleCollapse: () => void;
226
+ }, "borderRadiusValue" | "transitionName" | "shouldEnableTransition" | "settingsState">, Pick<{
227
+ themeMode: Ref<ThemeMode, ThemeMode>;
228
+ primaryColor: Ref<string, string>;
229
+ borderRadius: Ref<BorderRadiusSize, BorderRadiusSize>;
230
+ transitionType: Ref<TransitionType, TransitionType>;
231
+ enableTransition: Ref<boolean, boolean>;
232
+ layoutMode: Ref<LayoutMode, LayoutMode>;
233
+ menuExpandMode: Ref<MenuExpandMode, MenuExpandMode>;
234
+ collapsed: Ref<boolean, boolean>;
235
+ fixedHeader: Ref<boolean, boolean>;
236
+ showBreadcrumb: Ref<boolean, boolean>;
237
+ showBreadcrumbIcon: Ref<boolean, boolean>;
238
+ showTagsView: Ref<boolean, boolean>;
239
+ tagsViewHeight: Ref<number, number>;
240
+ tagsViewStyle: Ref<TagsViewStyle, TagsViewStyle>;
241
+ showFooter: Ref<boolean, boolean>;
242
+ sidebarWidth: Ref<number, number>;
243
+ sidebarCollapsedWidth: Ref<number, number>;
244
+ headerHeight: Ref<number, number>;
245
+ enableHotkeys: Ref<boolean, boolean>;
246
+ version: Ref<string, string>;
247
+ borderRadiusValue: ComputedRef<"4px" | "6px" | "8px">;
248
+ transitionName: ComputedRef<"" | "fade-transform" | "fade-slide" | "fade-zoom">;
249
+ shouldEnableTransition: ComputedRef<boolean>;
250
+ settingsState: ComputedRef<SettingsState>;
251
+ syncCSSVariables: () => void;
252
+ applyPreset: (preset: ThemePreset) => Promise<void>;
253
+ resetSettings: () => void;
254
+ updateThemeMode: (mode: ThemeMode) => Promise<void>;
255
+ toggleCollapse: () => void;
256
+ }, "syncCSSVariables" | "applyPreset" | "resetSettings" | "updateThemeMode" | "toggleCollapse">>;
257
+ }): any;
258
+ 'appearance-append'?(_: {
259
+ settings: Store<string, Pick<{
260
+ themeMode: Ref<ThemeMode, ThemeMode>;
261
+ primaryColor: Ref<string, string>;
262
+ borderRadius: Ref<BorderRadiusSize, BorderRadiusSize>;
263
+ transitionType: Ref<TransitionType, TransitionType>;
264
+ enableTransition: Ref<boolean, boolean>;
265
+ layoutMode: Ref<LayoutMode, LayoutMode>;
266
+ menuExpandMode: Ref<MenuExpandMode, MenuExpandMode>;
267
+ collapsed: Ref<boolean, boolean>;
268
+ fixedHeader: Ref<boolean, boolean>;
269
+ showBreadcrumb: Ref<boolean, boolean>;
270
+ showBreadcrumbIcon: Ref<boolean, boolean>;
271
+ showTagsView: Ref<boolean, boolean>;
272
+ tagsViewHeight: Ref<number, number>;
273
+ tagsViewStyle: Ref<TagsViewStyle, TagsViewStyle>;
274
+ showFooter: Ref<boolean, boolean>;
275
+ sidebarWidth: Ref<number, number>;
276
+ sidebarCollapsedWidth: Ref<number, number>;
277
+ headerHeight: Ref<number, number>;
278
+ enableHotkeys: Ref<boolean, boolean>;
279
+ version: Ref<string, string>;
280
+ borderRadiusValue: ComputedRef<"4px" | "6px" | "8px">;
281
+ transitionName: ComputedRef<"" | "fade-transform" | "fade-slide" | "fade-zoom">;
282
+ shouldEnableTransition: ComputedRef<boolean>;
283
+ settingsState: ComputedRef<SettingsState>;
284
+ syncCSSVariables: () => void;
285
+ applyPreset: (preset: ThemePreset) => Promise<void>;
286
+ resetSettings: () => void;
287
+ updateThemeMode: (mode: ThemeMode) => Promise<void>;
288
+ toggleCollapse: () => void;
289
+ }, "themeMode" | "layoutMode" | "primaryColor" | "borderRadius" | "transitionType" | "enableTransition" | "menuExpandMode" | "collapsed" | "fixedHeader" | "showBreadcrumb" | "showBreadcrumbIcon" | "showTagsView" | "tagsViewHeight" | "tagsViewStyle" | "showFooter" | "sidebarWidth" | "sidebarCollapsedWidth" | "headerHeight" | "enableHotkeys" | "version">, Pick<{
290
+ themeMode: Ref<ThemeMode, ThemeMode>;
291
+ primaryColor: Ref<string, string>;
292
+ borderRadius: Ref<BorderRadiusSize, BorderRadiusSize>;
293
+ transitionType: Ref<TransitionType, TransitionType>;
294
+ enableTransition: Ref<boolean, boolean>;
295
+ layoutMode: Ref<LayoutMode, LayoutMode>;
296
+ menuExpandMode: Ref<MenuExpandMode, MenuExpandMode>;
297
+ collapsed: Ref<boolean, boolean>;
298
+ fixedHeader: Ref<boolean, boolean>;
299
+ showBreadcrumb: Ref<boolean, boolean>;
300
+ showBreadcrumbIcon: Ref<boolean, boolean>;
301
+ showTagsView: Ref<boolean, boolean>;
302
+ tagsViewHeight: Ref<number, number>;
303
+ tagsViewStyle: Ref<TagsViewStyle, TagsViewStyle>;
304
+ showFooter: Ref<boolean, boolean>;
305
+ sidebarWidth: Ref<number, number>;
306
+ sidebarCollapsedWidth: Ref<number, number>;
307
+ headerHeight: Ref<number, number>;
308
+ enableHotkeys: Ref<boolean, boolean>;
309
+ version: Ref<string, string>;
310
+ borderRadiusValue: ComputedRef<"4px" | "6px" | "8px">;
311
+ transitionName: ComputedRef<"" | "fade-transform" | "fade-slide" | "fade-zoom">;
312
+ shouldEnableTransition: ComputedRef<boolean>;
313
+ settingsState: ComputedRef<SettingsState>;
314
+ syncCSSVariables: () => void;
315
+ applyPreset: (preset: ThemePreset) => Promise<void>;
316
+ resetSettings: () => void;
317
+ updateThemeMode: (mode: ThemeMode) => Promise<void>;
318
+ toggleCollapse: () => void;
319
+ }, "borderRadiusValue" | "transitionName" | "shouldEnableTransition" | "settingsState">, Pick<{
320
+ themeMode: Ref<ThemeMode, ThemeMode>;
321
+ primaryColor: Ref<string, string>;
322
+ borderRadius: Ref<BorderRadiusSize, BorderRadiusSize>;
323
+ transitionType: Ref<TransitionType, TransitionType>;
324
+ enableTransition: Ref<boolean, boolean>;
325
+ layoutMode: Ref<LayoutMode, LayoutMode>;
326
+ menuExpandMode: Ref<MenuExpandMode, MenuExpandMode>;
327
+ collapsed: Ref<boolean, boolean>;
328
+ fixedHeader: Ref<boolean, boolean>;
329
+ showBreadcrumb: Ref<boolean, boolean>;
330
+ showBreadcrumbIcon: Ref<boolean, boolean>;
331
+ showTagsView: Ref<boolean, boolean>;
332
+ tagsViewHeight: Ref<number, number>;
333
+ tagsViewStyle: Ref<TagsViewStyle, TagsViewStyle>;
334
+ showFooter: Ref<boolean, boolean>;
335
+ sidebarWidth: Ref<number, number>;
336
+ sidebarCollapsedWidth: Ref<number, number>;
337
+ headerHeight: Ref<number, number>;
338
+ enableHotkeys: Ref<boolean, boolean>;
339
+ version: Ref<string, string>;
340
+ borderRadiusValue: ComputedRef<"4px" | "6px" | "8px">;
341
+ transitionName: ComputedRef<"" | "fade-transform" | "fade-slide" | "fade-zoom">;
342
+ shouldEnableTransition: ComputedRef<boolean>;
343
+ settingsState: ComputedRef<SettingsState>;
344
+ syncCSSVariables: () => void;
345
+ applyPreset: (preset: ThemePreset) => Promise<void>;
346
+ resetSettings: () => void;
347
+ updateThemeMode: (mode: ThemeMode) => Promise<void>;
348
+ toggleCollapse: () => void;
349
+ }, "syncCSSVariables" | "applyPreset" | "resetSettings" | "updateThemeMode" | "toggleCollapse">>;
350
+ }): any;
351
+ 'layout-prepend'?(_: {
352
+ settings: Store<string, Pick<{
353
+ themeMode: Ref<ThemeMode, ThemeMode>;
354
+ primaryColor: Ref<string, string>;
355
+ borderRadius: Ref<BorderRadiusSize, BorderRadiusSize>;
356
+ transitionType: Ref<TransitionType, TransitionType>;
357
+ enableTransition: Ref<boolean, boolean>;
358
+ layoutMode: Ref<LayoutMode, LayoutMode>;
359
+ menuExpandMode: Ref<MenuExpandMode, MenuExpandMode>;
360
+ collapsed: Ref<boolean, boolean>;
361
+ fixedHeader: Ref<boolean, boolean>;
362
+ showBreadcrumb: Ref<boolean, boolean>;
363
+ showBreadcrumbIcon: Ref<boolean, boolean>;
364
+ showTagsView: Ref<boolean, boolean>;
365
+ tagsViewHeight: Ref<number, number>;
366
+ tagsViewStyle: Ref<TagsViewStyle, TagsViewStyle>;
367
+ showFooter: Ref<boolean, boolean>;
368
+ sidebarWidth: Ref<number, number>;
369
+ sidebarCollapsedWidth: Ref<number, number>;
370
+ headerHeight: Ref<number, number>;
371
+ enableHotkeys: Ref<boolean, boolean>;
372
+ version: Ref<string, string>;
373
+ borderRadiusValue: ComputedRef<"4px" | "6px" | "8px">;
374
+ transitionName: ComputedRef<"" | "fade-transform" | "fade-slide" | "fade-zoom">;
375
+ shouldEnableTransition: ComputedRef<boolean>;
376
+ settingsState: ComputedRef<SettingsState>;
377
+ syncCSSVariables: () => void;
378
+ applyPreset: (preset: ThemePreset) => Promise<void>;
379
+ resetSettings: () => void;
380
+ updateThemeMode: (mode: ThemeMode) => Promise<void>;
381
+ toggleCollapse: () => void;
382
+ }, "themeMode" | "layoutMode" | "primaryColor" | "borderRadius" | "transitionType" | "enableTransition" | "menuExpandMode" | "collapsed" | "fixedHeader" | "showBreadcrumb" | "showBreadcrumbIcon" | "showTagsView" | "tagsViewHeight" | "tagsViewStyle" | "showFooter" | "sidebarWidth" | "sidebarCollapsedWidth" | "headerHeight" | "enableHotkeys" | "version">, Pick<{
383
+ themeMode: Ref<ThemeMode, ThemeMode>;
384
+ primaryColor: Ref<string, string>;
385
+ borderRadius: Ref<BorderRadiusSize, BorderRadiusSize>;
386
+ transitionType: Ref<TransitionType, TransitionType>;
387
+ enableTransition: Ref<boolean, boolean>;
388
+ layoutMode: Ref<LayoutMode, LayoutMode>;
389
+ menuExpandMode: Ref<MenuExpandMode, MenuExpandMode>;
390
+ collapsed: Ref<boolean, boolean>;
391
+ fixedHeader: Ref<boolean, boolean>;
392
+ showBreadcrumb: Ref<boolean, boolean>;
393
+ showBreadcrumbIcon: Ref<boolean, boolean>;
394
+ showTagsView: Ref<boolean, boolean>;
395
+ tagsViewHeight: Ref<number, number>;
396
+ tagsViewStyle: Ref<TagsViewStyle, TagsViewStyle>;
397
+ showFooter: Ref<boolean, boolean>;
398
+ sidebarWidth: Ref<number, number>;
399
+ sidebarCollapsedWidth: Ref<number, number>;
400
+ headerHeight: Ref<number, number>;
401
+ enableHotkeys: Ref<boolean, boolean>;
402
+ version: Ref<string, string>;
403
+ borderRadiusValue: ComputedRef<"4px" | "6px" | "8px">;
404
+ transitionName: ComputedRef<"" | "fade-transform" | "fade-slide" | "fade-zoom">;
405
+ shouldEnableTransition: ComputedRef<boolean>;
406
+ settingsState: ComputedRef<SettingsState>;
407
+ syncCSSVariables: () => void;
408
+ applyPreset: (preset: ThemePreset) => Promise<void>;
409
+ resetSettings: () => void;
410
+ updateThemeMode: (mode: ThemeMode) => Promise<void>;
411
+ toggleCollapse: () => void;
412
+ }, "borderRadiusValue" | "transitionName" | "shouldEnableTransition" | "settingsState">, Pick<{
413
+ themeMode: Ref<ThemeMode, ThemeMode>;
414
+ primaryColor: Ref<string, string>;
415
+ borderRadius: Ref<BorderRadiusSize, BorderRadiusSize>;
416
+ transitionType: Ref<TransitionType, TransitionType>;
417
+ enableTransition: Ref<boolean, boolean>;
418
+ layoutMode: Ref<LayoutMode, LayoutMode>;
419
+ menuExpandMode: Ref<MenuExpandMode, MenuExpandMode>;
420
+ collapsed: Ref<boolean, boolean>;
421
+ fixedHeader: Ref<boolean, boolean>;
422
+ showBreadcrumb: Ref<boolean, boolean>;
423
+ showBreadcrumbIcon: Ref<boolean, boolean>;
424
+ showTagsView: Ref<boolean, boolean>;
425
+ tagsViewHeight: Ref<number, number>;
426
+ tagsViewStyle: Ref<TagsViewStyle, TagsViewStyle>;
427
+ showFooter: Ref<boolean, boolean>;
428
+ sidebarWidth: Ref<number, number>;
429
+ sidebarCollapsedWidth: Ref<number, number>;
430
+ headerHeight: Ref<number, number>;
431
+ enableHotkeys: Ref<boolean, boolean>;
432
+ version: Ref<string, string>;
433
+ borderRadiusValue: ComputedRef<"4px" | "6px" | "8px">;
434
+ transitionName: ComputedRef<"" | "fade-transform" | "fade-slide" | "fade-zoom">;
435
+ shouldEnableTransition: ComputedRef<boolean>;
436
+ settingsState: ComputedRef<SettingsState>;
437
+ syncCSSVariables: () => void;
438
+ applyPreset: (preset: ThemePreset) => Promise<void>;
439
+ resetSettings: () => void;
440
+ updateThemeMode: (mode: ThemeMode) => Promise<void>;
441
+ toggleCollapse: () => void;
442
+ }, "syncCSSVariables" | "applyPreset" | "resetSettings" | "updateThemeMode" | "toggleCollapse">>;
443
+ }): any;
444
+ 'layout-after-mode'?(_: {
445
+ settings: Store<string, Pick<{
446
+ themeMode: Ref<ThemeMode, ThemeMode>;
447
+ primaryColor: Ref<string, string>;
448
+ borderRadius: Ref<BorderRadiusSize, BorderRadiusSize>;
449
+ transitionType: Ref<TransitionType, TransitionType>;
450
+ enableTransition: Ref<boolean, boolean>;
451
+ layoutMode: Ref<LayoutMode, LayoutMode>;
452
+ menuExpandMode: Ref<MenuExpandMode, MenuExpandMode>;
453
+ collapsed: Ref<boolean, boolean>;
454
+ fixedHeader: Ref<boolean, boolean>;
455
+ showBreadcrumb: Ref<boolean, boolean>;
456
+ showBreadcrumbIcon: Ref<boolean, boolean>;
457
+ showTagsView: Ref<boolean, boolean>;
458
+ tagsViewHeight: Ref<number, number>;
459
+ tagsViewStyle: Ref<TagsViewStyle, TagsViewStyle>;
460
+ showFooter: Ref<boolean, boolean>;
461
+ sidebarWidth: Ref<number, number>;
462
+ sidebarCollapsedWidth: Ref<number, number>;
463
+ headerHeight: Ref<number, number>;
464
+ enableHotkeys: Ref<boolean, boolean>;
465
+ version: Ref<string, string>;
466
+ borderRadiusValue: ComputedRef<"4px" | "6px" | "8px">;
467
+ transitionName: ComputedRef<"" | "fade-transform" | "fade-slide" | "fade-zoom">;
468
+ shouldEnableTransition: ComputedRef<boolean>;
469
+ settingsState: ComputedRef<SettingsState>;
470
+ syncCSSVariables: () => void;
471
+ applyPreset: (preset: ThemePreset) => Promise<void>;
472
+ resetSettings: () => void;
473
+ updateThemeMode: (mode: ThemeMode) => Promise<void>;
474
+ toggleCollapse: () => void;
475
+ }, "themeMode" | "layoutMode" | "primaryColor" | "borderRadius" | "transitionType" | "enableTransition" | "menuExpandMode" | "collapsed" | "fixedHeader" | "showBreadcrumb" | "showBreadcrumbIcon" | "showTagsView" | "tagsViewHeight" | "tagsViewStyle" | "showFooter" | "sidebarWidth" | "sidebarCollapsedWidth" | "headerHeight" | "enableHotkeys" | "version">, Pick<{
476
+ themeMode: Ref<ThemeMode, ThemeMode>;
477
+ primaryColor: Ref<string, string>;
478
+ borderRadius: Ref<BorderRadiusSize, BorderRadiusSize>;
479
+ transitionType: Ref<TransitionType, TransitionType>;
480
+ enableTransition: Ref<boolean, boolean>;
481
+ layoutMode: Ref<LayoutMode, LayoutMode>;
482
+ menuExpandMode: Ref<MenuExpandMode, MenuExpandMode>;
483
+ collapsed: Ref<boolean, boolean>;
484
+ fixedHeader: Ref<boolean, boolean>;
485
+ showBreadcrumb: Ref<boolean, boolean>;
486
+ showBreadcrumbIcon: Ref<boolean, boolean>;
487
+ showTagsView: Ref<boolean, boolean>;
488
+ tagsViewHeight: Ref<number, number>;
489
+ tagsViewStyle: Ref<TagsViewStyle, TagsViewStyle>;
490
+ showFooter: Ref<boolean, boolean>;
491
+ sidebarWidth: Ref<number, number>;
492
+ sidebarCollapsedWidth: Ref<number, number>;
493
+ headerHeight: Ref<number, number>;
494
+ enableHotkeys: Ref<boolean, boolean>;
495
+ version: Ref<string, string>;
496
+ borderRadiusValue: ComputedRef<"4px" | "6px" | "8px">;
497
+ transitionName: ComputedRef<"" | "fade-transform" | "fade-slide" | "fade-zoom">;
498
+ shouldEnableTransition: ComputedRef<boolean>;
499
+ settingsState: ComputedRef<SettingsState>;
500
+ syncCSSVariables: () => void;
501
+ applyPreset: (preset: ThemePreset) => Promise<void>;
502
+ resetSettings: () => void;
503
+ updateThemeMode: (mode: ThemeMode) => Promise<void>;
504
+ toggleCollapse: () => void;
505
+ }, "borderRadiusValue" | "transitionName" | "shouldEnableTransition" | "settingsState">, Pick<{
506
+ themeMode: Ref<ThemeMode, ThemeMode>;
507
+ primaryColor: Ref<string, string>;
508
+ borderRadius: Ref<BorderRadiusSize, BorderRadiusSize>;
509
+ transitionType: Ref<TransitionType, TransitionType>;
510
+ enableTransition: Ref<boolean, boolean>;
511
+ layoutMode: Ref<LayoutMode, LayoutMode>;
512
+ menuExpandMode: Ref<MenuExpandMode, MenuExpandMode>;
513
+ collapsed: Ref<boolean, boolean>;
514
+ fixedHeader: Ref<boolean, boolean>;
515
+ showBreadcrumb: Ref<boolean, boolean>;
516
+ showBreadcrumbIcon: Ref<boolean, boolean>;
517
+ showTagsView: Ref<boolean, boolean>;
518
+ tagsViewHeight: Ref<number, number>;
519
+ tagsViewStyle: Ref<TagsViewStyle, TagsViewStyle>;
520
+ showFooter: Ref<boolean, boolean>;
521
+ sidebarWidth: Ref<number, number>;
522
+ sidebarCollapsedWidth: Ref<number, number>;
523
+ headerHeight: Ref<number, number>;
524
+ enableHotkeys: Ref<boolean, boolean>;
525
+ version: Ref<string, string>;
526
+ borderRadiusValue: ComputedRef<"4px" | "6px" | "8px">;
527
+ transitionName: ComputedRef<"" | "fade-transform" | "fade-slide" | "fade-zoom">;
528
+ shouldEnableTransition: ComputedRef<boolean>;
529
+ settingsState: ComputedRef<SettingsState>;
530
+ syncCSSVariables: () => void;
531
+ applyPreset: (preset: ThemePreset) => Promise<void>;
532
+ resetSettings: () => void;
533
+ updateThemeMode: (mode: ThemeMode) => Promise<void>;
534
+ toggleCollapse: () => void;
535
+ }, "syncCSSVariables" | "applyPreset" | "resetSettings" | "updateThemeMode" | "toggleCollapse">>;
536
+ }): any;
537
+ 'layout-append'?(_: {
538
+ settings: Store<string, Pick<{
539
+ themeMode: Ref<ThemeMode, ThemeMode>;
540
+ primaryColor: Ref<string, string>;
541
+ borderRadius: Ref<BorderRadiusSize, BorderRadiusSize>;
542
+ transitionType: Ref<TransitionType, TransitionType>;
543
+ enableTransition: Ref<boolean, boolean>;
544
+ layoutMode: Ref<LayoutMode, LayoutMode>;
545
+ menuExpandMode: Ref<MenuExpandMode, MenuExpandMode>;
546
+ collapsed: Ref<boolean, boolean>;
547
+ fixedHeader: Ref<boolean, boolean>;
548
+ showBreadcrumb: Ref<boolean, boolean>;
549
+ showBreadcrumbIcon: Ref<boolean, boolean>;
550
+ showTagsView: Ref<boolean, boolean>;
551
+ tagsViewHeight: Ref<number, number>;
552
+ tagsViewStyle: Ref<TagsViewStyle, TagsViewStyle>;
553
+ showFooter: Ref<boolean, boolean>;
554
+ sidebarWidth: Ref<number, number>;
555
+ sidebarCollapsedWidth: Ref<number, number>;
556
+ headerHeight: Ref<number, number>;
557
+ enableHotkeys: Ref<boolean, boolean>;
558
+ version: Ref<string, string>;
559
+ borderRadiusValue: ComputedRef<"4px" | "6px" | "8px">;
560
+ transitionName: ComputedRef<"" | "fade-transform" | "fade-slide" | "fade-zoom">;
561
+ shouldEnableTransition: ComputedRef<boolean>;
562
+ settingsState: ComputedRef<SettingsState>;
563
+ syncCSSVariables: () => void;
564
+ applyPreset: (preset: ThemePreset) => Promise<void>;
565
+ resetSettings: () => void;
566
+ updateThemeMode: (mode: ThemeMode) => Promise<void>;
567
+ toggleCollapse: () => void;
568
+ }, "themeMode" | "layoutMode" | "primaryColor" | "borderRadius" | "transitionType" | "enableTransition" | "menuExpandMode" | "collapsed" | "fixedHeader" | "showBreadcrumb" | "showBreadcrumbIcon" | "showTagsView" | "tagsViewHeight" | "tagsViewStyle" | "showFooter" | "sidebarWidth" | "sidebarCollapsedWidth" | "headerHeight" | "enableHotkeys" | "version">, Pick<{
569
+ themeMode: Ref<ThemeMode, ThemeMode>;
570
+ primaryColor: Ref<string, string>;
571
+ borderRadius: Ref<BorderRadiusSize, BorderRadiusSize>;
572
+ transitionType: Ref<TransitionType, TransitionType>;
573
+ enableTransition: Ref<boolean, boolean>;
574
+ layoutMode: Ref<LayoutMode, LayoutMode>;
575
+ menuExpandMode: Ref<MenuExpandMode, MenuExpandMode>;
576
+ collapsed: Ref<boolean, boolean>;
577
+ fixedHeader: Ref<boolean, boolean>;
578
+ showBreadcrumb: Ref<boolean, boolean>;
579
+ showBreadcrumbIcon: Ref<boolean, boolean>;
580
+ showTagsView: Ref<boolean, boolean>;
581
+ tagsViewHeight: Ref<number, number>;
582
+ tagsViewStyle: Ref<TagsViewStyle, TagsViewStyle>;
583
+ showFooter: Ref<boolean, boolean>;
584
+ sidebarWidth: Ref<number, number>;
585
+ sidebarCollapsedWidth: Ref<number, number>;
586
+ headerHeight: Ref<number, number>;
587
+ enableHotkeys: Ref<boolean, boolean>;
588
+ version: Ref<string, string>;
589
+ borderRadiusValue: ComputedRef<"4px" | "6px" | "8px">;
590
+ transitionName: ComputedRef<"" | "fade-transform" | "fade-slide" | "fade-zoom">;
591
+ shouldEnableTransition: ComputedRef<boolean>;
592
+ settingsState: ComputedRef<SettingsState>;
593
+ syncCSSVariables: () => void;
594
+ applyPreset: (preset: ThemePreset) => Promise<void>;
595
+ resetSettings: () => void;
596
+ updateThemeMode: (mode: ThemeMode) => Promise<void>;
597
+ toggleCollapse: () => void;
598
+ }, "borderRadiusValue" | "transitionName" | "shouldEnableTransition" | "settingsState">, Pick<{
599
+ themeMode: Ref<ThemeMode, ThemeMode>;
600
+ primaryColor: Ref<string, string>;
601
+ borderRadius: Ref<BorderRadiusSize, BorderRadiusSize>;
602
+ transitionType: Ref<TransitionType, TransitionType>;
603
+ enableTransition: Ref<boolean, boolean>;
604
+ layoutMode: Ref<LayoutMode, LayoutMode>;
605
+ menuExpandMode: Ref<MenuExpandMode, MenuExpandMode>;
606
+ collapsed: Ref<boolean, boolean>;
607
+ fixedHeader: Ref<boolean, boolean>;
608
+ showBreadcrumb: Ref<boolean, boolean>;
609
+ showBreadcrumbIcon: Ref<boolean, boolean>;
610
+ showTagsView: Ref<boolean, boolean>;
611
+ tagsViewHeight: Ref<number, number>;
612
+ tagsViewStyle: Ref<TagsViewStyle, TagsViewStyle>;
613
+ showFooter: Ref<boolean, boolean>;
614
+ sidebarWidth: Ref<number, number>;
615
+ sidebarCollapsedWidth: Ref<number, number>;
616
+ headerHeight: Ref<number, number>;
617
+ enableHotkeys: Ref<boolean, boolean>;
618
+ version: Ref<string, string>;
619
+ borderRadiusValue: ComputedRef<"4px" | "6px" | "8px">;
620
+ transitionName: ComputedRef<"" | "fade-transform" | "fade-slide" | "fade-zoom">;
621
+ shouldEnableTransition: ComputedRef<boolean>;
622
+ settingsState: ComputedRef<SettingsState>;
623
+ syncCSSVariables: () => void;
624
+ applyPreset: (preset: ThemePreset) => Promise<void>;
625
+ resetSettings: () => void;
626
+ updateThemeMode: (mode: ThemeMode) => Promise<void>;
627
+ toggleCollapse: () => void;
628
+ }, "syncCSSVariables" | "applyPreset" | "resetSettings" | "updateThemeMode" | "toggleCollapse">>;
629
+ }): any;
630
+ 'features-prepend'?(_: {
631
+ settings: Store<string, Pick<{
632
+ themeMode: Ref<ThemeMode, ThemeMode>;
633
+ primaryColor: Ref<string, string>;
634
+ borderRadius: Ref<BorderRadiusSize, BorderRadiusSize>;
635
+ transitionType: Ref<TransitionType, TransitionType>;
636
+ enableTransition: Ref<boolean, boolean>;
637
+ layoutMode: Ref<LayoutMode, LayoutMode>;
638
+ menuExpandMode: Ref<MenuExpandMode, MenuExpandMode>;
639
+ collapsed: Ref<boolean, boolean>;
640
+ fixedHeader: Ref<boolean, boolean>;
641
+ showBreadcrumb: Ref<boolean, boolean>;
642
+ showBreadcrumbIcon: Ref<boolean, boolean>;
643
+ showTagsView: Ref<boolean, boolean>;
644
+ tagsViewHeight: Ref<number, number>;
645
+ tagsViewStyle: Ref<TagsViewStyle, TagsViewStyle>;
646
+ showFooter: Ref<boolean, boolean>;
647
+ sidebarWidth: Ref<number, number>;
648
+ sidebarCollapsedWidth: Ref<number, number>;
649
+ headerHeight: Ref<number, number>;
650
+ enableHotkeys: Ref<boolean, boolean>;
651
+ version: Ref<string, string>;
652
+ borderRadiusValue: ComputedRef<"4px" | "6px" | "8px">;
653
+ transitionName: ComputedRef<"" | "fade-transform" | "fade-slide" | "fade-zoom">;
654
+ shouldEnableTransition: ComputedRef<boolean>;
655
+ settingsState: ComputedRef<SettingsState>;
656
+ syncCSSVariables: () => void;
657
+ applyPreset: (preset: ThemePreset) => Promise<void>;
658
+ resetSettings: () => void;
659
+ updateThemeMode: (mode: ThemeMode) => Promise<void>;
660
+ toggleCollapse: () => void;
661
+ }, "themeMode" | "layoutMode" | "primaryColor" | "borderRadius" | "transitionType" | "enableTransition" | "menuExpandMode" | "collapsed" | "fixedHeader" | "showBreadcrumb" | "showBreadcrumbIcon" | "showTagsView" | "tagsViewHeight" | "tagsViewStyle" | "showFooter" | "sidebarWidth" | "sidebarCollapsedWidth" | "headerHeight" | "enableHotkeys" | "version">, Pick<{
662
+ themeMode: Ref<ThemeMode, ThemeMode>;
663
+ primaryColor: Ref<string, string>;
664
+ borderRadius: Ref<BorderRadiusSize, BorderRadiusSize>;
665
+ transitionType: Ref<TransitionType, TransitionType>;
666
+ enableTransition: Ref<boolean, boolean>;
667
+ layoutMode: Ref<LayoutMode, LayoutMode>;
668
+ menuExpandMode: Ref<MenuExpandMode, MenuExpandMode>;
669
+ collapsed: Ref<boolean, boolean>;
670
+ fixedHeader: Ref<boolean, boolean>;
671
+ showBreadcrumb: Ref<boolean, boolean>;
672
+ showBreadcrumbIcon: Ref<boolean, boolean>;
673
+ showTagsView: Ref<boolean, boolean>;
674
+ tagsViewHeight: Ref<number, number>;
675
+ tagsViewStyle: Ref<TagsViewStyle, TagsViewStyle>;
676
+ showFooter: Ref<boolean, boolean>;
677
+ sidebarWidth: Ref<number, number>;
678
+ sidebarCollapsedWidth: Ref<number, number>;
679
+ headerHeight: Ref<number, number>;
680
+ enableHotkeys: Ref<boolean, boolean>;
681
+ version: Ref<string, string>;
682
+ borderRadiusValue: ComputedRef<"4px" | "6px" | "8px">;
683
+ transitionName: ComputedRef<"" | "fade-transform" | "fade-slide" | "fade-zoom">;
684
+ shouldEnableTransition: ComputedRef<boolean>;
685
+ settingsState: ComputedRef<SettingsState>;
686
+ syncCSSVariables: () => void;
687
+ applyPreset: (preset: ThemePreset) => Promise<void>;
688
+ resetSettings: () => void;
689
+ updateThemeMode: (mode: ThemeMode) => Promise<void>;
690
+ toggleCollapse: () => void;
691
+ }, "borderRadiusValue" | "transitionName" | "shouldEnableTransition" | "settingsState">, Pick<{
692
+ themeMode: Ref<ThemeMode, ThemeMode>;
693
+ primaryColor: Ref<string, string>;
694
+ borderRadius: Ref<BorderRadiusSize, BorderRadiusSize>;
695
+ transitionType: Ref<TransitionType, TransitionType>;
696
+ enableTransition: Ref<boolean, boolean>;
697
+ layoutMode: Ref<LayoutMode, LayoutMode>;
698
+ menuExpandMode: Ref<MenuExpandMode, MenuExpandMode>;
699
+ collapsed: Ref<boolean, boolean>;
700
+ fixedHeader: Ref<boolean, boolean>;
701
+ showBreadcrumb: Ref<boolean, boolean>;
702
+ showBreadcrumbIcon: Ref<boolean, boolean>;
703
+ showTagsView: Ref<boolean, boolean>;
704
+ tagsViewHeight: Ref<number, number>;
705
+ tagsViewStyle: Ref<TagsViewStyle, TagsViewStyle>;
706
+ showFooter: Ref<boolean, boolean>;
707
+ sidebarWidth: Ref<number, number>;
708
+ sidebarCollapsedWidth: Ref<number, number>;
709
+ headerHeight: Ref<number, number>;
710
+ enableHotkeys: Ref<boolean, boolean>;
711
+ version: Ref<string, string>;
712
+ borderRadiusValue: ComputedRef<"4px" | "6px" | "8px">;
713
+ transitionName: ComputedRef<"" | "fade-transform" | "fade-slide" | "fade-zoom">;
714
+ shouldEnableTransition: ComputedRef<boolean>;
715
+ settingsState: ComputedRef<SettingsState>;
716
+ syncCSSVariables: () => void;
717
+ applyPreset: (preset: ThemePreset) => Promise<void>;
718
+ resetSettings: () => void;
719
+ updateThemeMode: (mode: ThemeMode) => Promise<void>;
720
+ toggleCollapse: () => void;
721
+ }, "syncCSSVariables" | "applyPreset" | "resetSettings" | "updateThemeMode" | "toggleCollapse">>;
722
+ }): any;
723
+ 'features-append'?(_: {
724
+ settings: Store<string, Pick<{
725
+ themeMode: Ref<ThemeMode, ThemeMode>;
726
+ primaryColor: Ref<string, string>;
727
+ borderRadius: Ref<BorderRadiusSize, BorderRadiusSize>;
728
+ transitionType: Ref<TransitionType, TransitionType>;
729
+ enableTransition: Ref<boolean, boolean>;
730
+ layoutMode: Ref<LayoutMode, LayoutMode>;
731
+ menuExpandMode: Ref<MenuExpandMode, MenuExpandMode>;
732
+ collapsed: Ref<boolean, boolean>;
733
+ fixedHeader: Ref<boolean, boolean>;
734
+ showBreadcrumb: Ref<boolean, boolean>;
735
+ showBreadcrumbIcon: Ref<boolean, boolean>;
736
+ showTagsView: Ref<boolean, boolean>;
737
+ tagsViewHeight: Ref<number, number>;
738
+ tagsViewStyle: Ref<TagsViewStyle, TagsViewStyle>;
739
+ showFooter: Ref<boolean, boolean>;
740
+ sidebarWidth: Ref<number, number>;
741
+ sidebarCollapsedWidth: Ref<number, number>;
742
+ headerHeight: Ref<number, number>;
743
+ enableHotkeys: Ref<boolean, boolean>;
744
+ version: Ref<string, string>;
745
+ borderRadiusValue: ComputedRef<"4px" | "6px" | "8px">;
746
+ transitionName: ComputedRef<"" | "fade-transform" | "fade-slide" | "fade-zoom">;
747
+ shouldEnableTransition: ComputedRef<boolean>;
748
+ settingsState: ComputedRef<SettingsState>;
749
+ syncCSSVariables: () => void;
750
+ applyPreset: (preset: ThemePreset) => Promise<void>;
751
+ resetSettings: () => void;
752
+ updateThemeMode: (mode: ThemeMode) => Promise<void>;
753
+ toggleCollapse: () => void;
754
+ }, "themeMode" | "layoutMode" | "primaryColor" | "borderRadius" | "transitionType" | "enableTransition" | "menuExpandMode" | "collapsed" | "fixedHeader" | "showBreadcrumb" | "showBreadcrumbIcon" | "showTagsView" | "tagsViewHeight" | "tagsViewStyle" | "showFooter" | "sidebarWidth" | "sidebarCollapsedWidth" | "headerHeight" | "enableHotkeys" | "version">, Pick<{
755
+ themeMode: Ref<ThemeMode, ThemeMode>;
756
+ primaryColor: Ref<string, string>;
757
+ borderRadius: Ref<BorderRadiusSize, BorderRadiusSize>;
758
+ transitionType: Ref<TransitionType, TransitionType>;
759
+ enableTransition: Ref<boolean, boolean>;
760
+ layoutMode: Ref<LayoutMode, LayoutMode>;
761
+ menuExpandMode: Ref<MenuExpandMode, MenuExpandMode>;
762
+ collapsed: Ref<boolean, boolean>;
763
+ fixedHeader: Ref<boolean, boolean>;
764
+ showBreadcrumb: Ref<boolean, boolean>;
765
+ showBreadcrumbIcon: Ref<boolean, boolean>;
766
+ showTagsView: Ref<boolean, boolean>;
767
+ tagsViewHeight: Ref<number, number>;
768
+ tagsViewStyle: Ref<TagsViewStyle, TagsViewStyle>;
769
+ showFooter: Ref<boolean, boolean>;
770
+ sidebarWidth: Ref<number, number>;
771
+ sidebarCollapsedWidth: Ref<number, number>;
772
+ headerHeight: Ref<number, number>;
773
+ enableHotkeys: Ref<boolean, boolean>;
774
+ version: Ref<string, string>;
775
+ borderRadiusValue: ComputedRef<"4px" | "6px" | "8px">;
776
+ transitionName: ComputedRef<"" | "fade-transform" | "fade-slide" | "fade-zoom">;
777
+ shouldEnableTransition: ComputedRef<boolean>;
778
+ settingsState: ComputedRef<SettingsState>;
779
+ syncCSSVariables: () => void;
780
+ applyPreset: (preset: ThemePreset) => Promise<void>;
781
+ resetSettings: () => void;
782
+ updateThemeMode: (mode: ThemeMode) => Promise<void>;
783
+ toggleCollapse: () => void;
784
+ }, "borderRadiusValue" | "transitionName" | "shouldEnableTransition" | "settingsState">, Pick<{
785
+ themeMode: Ref<ThemeMode, ThemeMode>;
786
+ primaryColor: Ref<string, string>;
787
+ borderRadius: Ref<BorderRadiusSize, BorderRadiusSize>;
788
+ transitionType: Ref<TransitionType, TransitionType>;
789
+ enableTransition: Ref<boolean, boolean>;
790
+ layoutMode: Ref<LayoutMode, LayoutMode>;
791
+ menuExpandMode: Ref<MenuExpandMode, MenuExpandMode>;
792
+ collapsed: Ref<boolean, boolean>;
793
+ fixedHeader: Ref<boolean, boolean>;
794
+ showBreadcrumb: Ref<boolean, boolean>;
795
+ showBreadcrumbIcon: Ref<boolean, boolean>;
796
+ showTagsView: Ref<boolean, boolean>;
797
+ tagsViewHeight: Ref<number, number>;
798
+ tagsViewStyle: Ref<TagsViewStyle, TagsViewStyle>;
799
+ showFooter: Ref<boolean, boolean>;
800
+ sidebarWidth: Ref<number, number>;
801
+ sidebarCollapsedWidth: Ref<number, number>;
802
+ headerHeight: Ref<number, number>;
803
+ enableHotkeys: Ref<boolean, boolean>;
804
+ version: Ref<string, string>;
805
+ borderRadiusValue: ComputedRef<"4px" | "6px" | "8px">;
806
+ transitionName: ComputedRef<"" | "fade-transform" | "fade-slide" | "fade-zoom">;
807
+ shouldEnableTransition: ComputedRef<boolean>;
808
+ settingsState: ComputedRef<SettingsState>;
809
+ syncCSSVariables: () => void;
810
+ applyPreset: (preset: ThemePreset) => Promise<void>;
811
+ resetSettings: () => void;
812
+ updateThemeMode: (mode: ThemeMode) => Promise<void>;
813
+ toggleCollapse: () => void;
814
+ }, "syncCSSVariables" | "applyPreset" | "resetSettings" | "updateThemeMode" | "toggleCollapse">>;
815
+ }): any;
816
+ };
817
+ refs: {};
818
+ rootEl: any;
819
+ };
820
+
821
+ declare function __VLS_template_3(): {
141
822
  attrs: Partial<{}>;
142
823
  slots: {
143
824
  logo?(_: {}): any;
@@ -151,7 +832,7 @@ declare function __VLS_template_2(): {
151
832
  rootEl: any;
152
833
  };
153
834
 
154
- declare function __VLS_template_3(): {
835
+ declare function __VLS_template_4(): {
155
836
  attrs: Partial<{}>;
156
837
  slots: {
157
838
  logo?(_: {}): any;
@@ -164,7 +845,7 @@ declare function __VLS_template_3(): {
164
845
  rootEl: HTMLDivElement;
165
846
  };
166
847
 
167
- declare function __VLS_template_4(): {
848
+ declare function __VLS_template_5(): {
168
849
  attrs: Partial<{}>;
169
850
  slots: {
170
851
  logo?(_: {}): any;
@@ -175,7 +856,7 @@ declare function __VLS_template_4(): {
175
856
  rootEl: HTMLDivElement;
176
857
  };
177
858
 
178
- declare function __VLS_template_5(): {
859
+ declare function __VLS_template_6(): {
179
860
  attrs: Partial<{}>;
180
861
  slots: {
181
862
  logo?(_: {}): any;
@@ -189,7 +870,7 @@ declare function __VLS_template_5(): {
189
870
  rootEl: HTMLDivElement;
190
871
  };
191
872
 
192
- declare function __VLS_template_6(): {
873
+ declare function __VLS_template_7(): {
193
874
  attrs: Partial<{}>;
194
875
  slots: {
195
876
  logo?(_: {}): any;
@@ -202,7 +883,7 @@ declare function __VLS_template_6(): {
202
883
  rootEl: HTMLDivElement;
203
884
  };
204
885
 
205
- declare function __VLS_template_7(): {
886
+ declare function __VLS_template_8(): {
206
887
  attrs: Partial<{}>;
207
888
  slots: {
208
889
  'menu-trigger'?(_: {}): any;
@@ -230,6 +911,8 @@ declare type __VLS_TemplateResult_6 = ReturnType<typeof __VLS_template_6>;
230
911
 
231
912
  declare type __VLS_TemplateResult_7 = ReturnType<typeof __VLS_template_7>;
232
913
 
914
+ declare type __VLS_TemplateResult_8 = ReturnType<typeof __VLS_template_8>;
915
+
233
916
  declare type __VLS_WithTemplateSlots<T, S> = T & {
234
917
  new (): {
235
918
  $slots: S;
@@ -272,10 +955,15 @@ declare type __VLS_WithTemplateSlots_7<T, S> = T & {
272
955
  };
273
956
  };
274
957
 
958
+ declare type __VLS_WithTemplateSlots_8<T, S> = T & {
959
+ new (): {
960
+ $slots: S;
961
+ };
962
+ };
963
+
275
964
  /**
276
- * 调整颜色亮度
277
- * @param color - 十六进制颜色值
278
- * @param amount - 调整量，正数变亮，负数变暗
965
+ * 调整颜色亮度。
966
+ * @returns 调整后的 #rrggbb；输入非法时原样返回。
279
967
  */
280
968
  export declare function adjustColor(color: string, amount: number): string;
281
969
 
@@ -285,12 +973,10 @@ export declare const BORDER_RADIUS_MAP: {
285
973
  readonly large: "8px";
286
974
  };
287
975
 
288
- /**
289
- * 圆角大小
290
- */
976
+ /** 圆角大小。 */
291
977
  export declare type BorderRadiusSize = "small" | "medium" | "large";
292
978
 
293
- export declare const BrandLogo: DefineComponent<__VLS_Props, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
979
+ export declare const BrandLogo: DefineComponent<__VLS_Props_2, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_2> & Readonly<{}>, {
294
980
  collapsed: boolean;
295
981
  size: number;
296
982
  showName: boolean;
@@ -307,7 +993,7 @@ export declare const COLOR_SWATCHES: string[];
307
993
  * 创建设置管理 Store
308
994
  * @param options - 配置选项
309
995
  */
310
- export declare function createSettingsStore(options?: SettingsStoreOptions): StoreDefinition<"settings", Pick<{
996
+ export declare function createSettingsStore(options?: SettingsStoreOptions): StoreDefinition<string, Pick<{
311
997
  themeMode: Ref<ThemeMode, ThemeMode>;
312
998
  primaryColor: Ref<string, string>;
313
999
  borderRadius: Ref<BorderRadiusSize, BorderRadiusSize>;
@@ -399,27 +1085,27 @@ updateThemeMode: (mode: ThemeMode) => Promise<void>;
399
1085
  toggleCollapse: () => void;
400
1086
  }, "syncCSSVariables" | "applyPreset" | "resetSettings" | "updateThemeMode" | "toggleCollapse">>;
401
1087
 
402
- declare const _default: __VLS_WithTemplateSlots_2<typeof __VLS_component_2, __VLS_TemplateResult_2["slots"]>;
1088
+ declare const _default: __VLS_WithTemplateSlots_3<typeof __VLS_component_3, __VLS_TemplateResult_3["slots"]>;
403
1089
  export { _default as C_SideLayout }
404
1090
  export { _default as SideLayout }
405
1091
 
406
- declare const _default_2: __VLS_WithTemplateSlots_3<typeof __VLS_component_3, __VLS_TemplateResult_3["slots"]>;
1092
+ declare const _default_2: __VLS_WithTemplateSlots_4<typeof __VLS_component_4, __VLS_TemplateResult_4["slots"]>;
407
1093
  export { _default_2 as C_TopLayout }
408
1094
  export { _default_2 as TopLayout }
409
1095
 
410
- declare const _default_3: __VLS_WithTemplateSlots_4<typeof __VLS_component_4, __VLS_TemplateResult_4["slots"]>;
1096
+ declare const _default_3: __VLS_WithTemplateSlots_5<typeof __VLS_component_5, __VLS_TemplateResult_5["slots"]>;
411
1097
  export { _default_3 as C_MixLayout }
412
1098
  export { _default_3 as MixLayout }
413
1099
 
414
- declare const _default_4: __VLS_WithTemplateSlots_5<typeof __VLS_component_5, __VLS_TemplateResult_5["slots"]>;
1100
+ declare const _default_4: __VLS_WithTemplateSlots_6<typeof __VLS_component_6, __VLS_TemplateResult_6["slots"]>;
415
1101
  export { _default_4 as C_MixTopLayout }
416
1102
  export { _default_4 as MixTopLayout }
417
1103
 
418
- declare const _default_5: __VLS_WithTemplateSlots_6<typeof __VLS_component_6, __VLS_TemplateResult_6["slots"]>;
1104
+ declare const _default_5: __VLS_WithTemplateSlots_7<typeof __VLS_component_7, __VLS_TemplateResult_7["slots"]>;
419
1105
  export { _default_5 as C_ReverseHorizontalMixLayout }
420
1106
  export { _default_5 as ReverseHorizontalMixLayout }
421
1107
 
422
- declare const _default_6: __VLS_WithTemplateSlots_7<typeof __VLS_component_7, __VLS_TemplateResult_7["slots"]>;
1108
+ declare const _default_6: __VLS_WithTemplateSlots_8<typeof __VLS_component_8, __VLS_TemplateResult_8["slots"]>;
423
1109
  export { _default_6 as C_CardLayout }
424
1110
  export { _default_6 as CardLayout }
425
1111
 
@@ -449,17 +1135,17 @@ export declare interface DrawerHandlers {
449
1135
  hide: () => void;
450
1136
  }
451
1137
 
452
- export declare const DrawerMenu: DefineComponent<__VLS_Props_5, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_5> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
1138
+ export declare const DrawerMenu: DefineComponent<__VLS_Props_6, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_6> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
453
1139
 
454
- export declare const FloatingMenu: DefineComponent<__VLS_Props_3, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
1140
+ export declare const FloatingMenu: DefineComponent<__VLS_Props_4, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
455
1141
  click: (item: MenuOptions) => any;
456
- }, string, PublicProps, Readonly<__VLS_Props_3> & Readonly<{
1142
+ }, string, PublicProps, Readonly<__VLS_Props_4> & Readonly<{
457
1143
  onClick?: ((item: MenuOptions) => any) | undefined;
458
1144
  }>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
459
1145
 
460
- export declare const IconMenu: DefineComponent<__VLS_Props_2, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
1146
+ export declare const IconMenu: DefineComponent<__VLS_Props_3, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
461
1147
  click: (item: MenuOptions) => any;
462
- }, string, PublicProps, Readonly<__VLS_Props_2> & Readonly<{
1148
+ }, string, PublicProps, Readonly<__VLS_Props_3> & Readonly<{
463
1149
  onClick?: ((item: MenuOptions) => any) | undefined;
464
1150
  }>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
465
1151
 
@@ -470,6 +1156,9 @@ export declare const LAYOUT_CONTEXT_KEY: InjectionKey<LayoutContext>;
470
1156
 
471
1157
  export declare const LAYOUT_MODES: LayoutInfo[];
472
1158
 
1159
+ /** 当前布局使用的设置 Store，支持自定义 Store id 与多实例。 */
1160
+ export declare const LAYOUT_SETTINGS_KEY: InjectionKey<SettingsStoreInstance>;
1161
+
473
1162
  /**
474
1163
  * 品牌配置
475
1164
  */
@@ -490,19 +1179,13 @@ export declare interface LayoutBrandConfig {
490
1179
  copyright?: string;
491
1180
  }
492
1181
 
493
- /**
494
- * @robot-admin/layout
495
- *
496
- * 统一的 KeepAlive 缓存管理
497
- * 从主项目提取的通用 composable，零业务依赖
498
- */
499
1182
  /** KeepAlive 缓存选项 */
500
1183
  export declare interface LayoutCacheOptions {
501
1184
  /** 最大缓存数量，默认 20 */
502
1185
  maxCacheCount?: number;
503
- /** 是否在开发模式下输出日志，默认 true */
1186
+ /** 是否输出缓存调试日志，默认 false */
504
1187
  enableDevLog?: boolean;
505
- /** 是否暴露调试方法到 window，默认 true */
1188
+ /** 是否暴露调试方法到 window，默认 false */
506
1189
  exposeToWindow?: boolean;
507
1190
  }
508
1191
 
@@ -517,6 +1200,8 @@ export declare interface LayoutContext {
517
1200
  isDark: ComputedRef<boolean>;
518
1201
  /** 当前布局模式 */
519
1202
  layoutMode: ComputedRef<LayoutMode>;
1203
+ /** 侧边栏折叠状态；提供后由容器和宿主头部共享同一数据源 */
1204
+ collapsed?: WritableComputedRef<boolean>;
520
1205
  /** 菜单展开方式 */
521
1206
  menuExpandMode?: ComputedRef<MenuExpandMode>;
522
1207
  /** 侧边栏宽度 (px) */
@@ -550,9 +1235,7 @@ export declare interface LayoutContext {
550
1235
  iconComponent?: Component;
551
1236
  }
552
1237
 
553
- /**
554
- * 布局模式信息
555
- */
1238
+ /** 布局模式展示信息。 */
556
1239
  export declare interface LayoutInfo {
557
1240
  mode: LayoutMode;
558
1241
  label: string;
@@ -560,14 +1243,33 @@ export declare interface LayoutInfo {
560
1243
  icon: string;
561
1244
  }
562
1245
 
563
- /**
564
- * 布局模式
565
- */
1246
+ /** 内置布局模式。 */
566
1247
  export declare type LayoutMode = "side" | "top" | "mix" | "mix-top" | "reverse-horizontal-mix" | "card-layout";
567
1248
 
568
- /**
569
- * 菜单展开方式
570
- */
1249
+ /** 经校验后可原子应用的布局配置。 */
1250
+ export declare interface LayoutSettingsConfig extends LayoutVisualEffects {
1251
+ schemaVersion?: number;
1252
+ settings?: Partial<SettingsState>;
1253
+ }
1254
+
1255
+ export declare interface LayoutVisualEffects {
1256
+ gray?: boolean;
1257
+ colorWeak?: boolean;
1258
+ watermark?: {
1259
+ enabled: boolean;
1260
+ text: string;
1261
+ };
1262
+ }
1263
+
1264
+ export declare const MENU_COLLAPSE_KEY: InjectionKey<MenuCollapseHandlers>;
1265
+
1266
+ /** 侧边栏折叠控制器。 */
1267
+ export declare interface MenuCollapseHandlers {
1268
+ isCollapsed: ComputedRef<boolean>;
1269
+ handleCollapsedChange: (collapsed: boolean) => void;
1270
+ }
1271
+
1272
+ /** 菜单展开方式。 */
571
1273
  export declare type MenuExpandMode = "inline" | "panel";
572
1274
 
573
1275
  /**
@@ -642,82 +1344,77 @@ export declare interface MenuTag {
642
1344
  };
643
1345
  }
644
1346
 
645
- export declare const MenuTrigger: DefineComponent<__VLS_Props_6, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_6> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
1347
+ export declare const MenuTrigger: DefineComponent<__VLS_Props_7, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_7> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, HTMLDivElement>;
646
1348
 
647
1349
  export declare const PRESET_COLORS: PresetColor[];
648
1350
 
649
- /**
650
- * 预设颜色
651
- */
1351
+ /** 预设颜色。 */
652
1352
  export declare interface PresetColor {
653
1353
  name: string;
654
1354
  value: string;
655
1355
  }
656
1356
 
657
- export declare const ResponsiveMenu: DefineComponent<__VLS_Props_7, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_7> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {
1357
+ /** 在组件 setup 中提供布局上下文，避免消费方直接操作 InjectionKey。 */
1358
+ export declare function provideLayoutContext(context: LayoutContext): LayoutContext;
1359
+
1360
+ export declare const ResponsiveMenu: DefineComponent<__VLS_Props_8, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props_8> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {
658
1361
  containerRef: HTMLDivElement;
659
- visibleRef: HTMLDivElement;
660
1362
  }, HTMLDivElement>;
661
1363
 
662
- export declare const SettingsDrawer: DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
663
- "update:show": (value: boolean) => any;
664
- }, string, PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
665
- "onUpdate:show"?: ((value: boolean) => any) | undefined;
666
- }>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
1364
+ /**
1365
+ * 一次性校验完整导入文件。此函数不修改任何响应式状态或浏览器 API，
1366
+ * 消费方可以在成功返回后再原子应用结果。
1367
+ */
1368
+ export declare function sanitizeLayoutSettingsConfig(input: unknown): LayoutSettingsConfig;
667
1369
 
668
1370
  /**
669
- * 设置状态接口
1371
+ * 校验来自配置文件等不可信来源的设置。
1372
+ * 未知键为向前兼容而忽略；已知键的非法值会让整次导入失败。
670
1373
  */
1374
+ export declare function sanitizeSettingsPatch(input: unknown): Partial<SettingsState>;
1375
+
1376
+ /** 当前导入导出配置格式版本。 */
1377
+ export declare const SETTINGS_CONFIG_SCHEMA_VERSION: 1;
1378
+
1379
+ export declare const SettingsDrawer: __VLS_WithTemplateSlots_2<typeof __VLS_component_2, __VLS_TemplateResult_2["slots"]>;
1380
+
1381
+ /** 由宿主应用实现的高副作用操作。 */
1382
+ export declare interface SettingsDrawerActions {
1383
+ clearCache?: () => void | Promise<void>;
1384
+ reloadPage?: () => void;
1385
+ }
1386
+
1387
+ /** UI 无关的布局设置协议。 */
671
1388
  export declare interface SettingsState {
672
- /** 主题模式：浅色/深色/自动 */
673
1389
  themeMode: ThemeMode;
674
- /** 主题色 */
675
1390
  primaryColor: string;
676
- /** 圆角大小 */
677
1391
  borderRadius: BorderRadiusSize;
678
- /** 页面动画 */
679
1392
  transitionType: TransitionType;
680
- /** 启用页面动画 */
681
1393
  enableTransition: boolean;
682
- /** 布局模式：左侧/顶部/混合 */
683
1394
  layoutMode: LayoutMode;
684
- /** 菜单展开方式：传统内联/右侧面板 */
685
1395
  menuExpandMode: MenuExpandMode;
686
- /** 侧边栏是否折叠 */
687
1396
  collapsed: boolean;
688
- /** 固定头部 */
689
1397
  fixedHeader: boolean;
690
- /** 显示面包屑 */
691
1398
  showBreadcrumb: boolean;
692
- /** 显示面包屑图标 */
693
1399
  showBreadcrumbIcon: boolean;
694
- /** 显示标签页 */
695
1400
  showTagsView: boolean;
696
- /** 标签页高度 */
697
1401
  tagsViewHeight: number;
698
- /** 标签页风格 */
699
1402
  tagsViewStyle: TagsViewStyle;
700
- /** 显示页脚 */
701
1403
  showFooter: boolean;
702
- /** 侧边栏宽度 */
703
1404
  sidebarWidth: number;
704
- /** 侧边栏折叠宽度 */
705
1405
  sidebarCollapsedWidth: number;
706
- /** 头部高度 */
707
1406
  headerHeight: number;
708
- /** 启用快捷键 */
709
1407
  enableHotkeys: boolean;
710
- /** 配置版本（用于迁移） */
711
1408
  version: string;
712
1409
  }
713
1410
 
714
- /**
715
- * Settings Store 选项
716
- */
1411
+ /** 默认设置 Store 实例类型，供组件注入或显式传入。 */
1412
+ export declare type SettingsStoreInstance = ReturnType<typeof useSettingsStore>;
1413
+
1414
+ /** Settings Store 初始化选项。 */
717
1415
  export declare interface SettingsStoreOptions {
718
- /** 默认配置 */
1416
+ id?: string;
719
1417
  defaults?: Partial<SettingsState>;
720
- /** 主题模式变化回调（用于同步到 theme store） */
721
1418
  onThemeModeChange?: (mode: ThemeMode) => void | Promise<void>;
722
1419
  }
723
1420
 
@@ -735,7 +1432,7 @@ export declare interface SettingsStoreOptions {
735
1432
  * })
736
1433
  * ```
737
1434
  */
738
- export declare function setupLayout(_app: App, options?: SettingsStoreOptions): StoreDefinition<"settings", Pick<{
1435
+ export declare function setupLayout(app: App, options?: SettingsStoreOptions): StoreDefinition<string, Pick<{
739
1436
  themeMode: Ref<ThemeMode, ThemeMode>;
740
1437
  primaryColor: Ref<string, string>;
741
1438
  borderRadius: Ref<BorderRadiusSize, BorderRadiusSize>;
@@ -827,32 +1524,31 @@ updateThemeMode: (mode: ThemeMode) => Promise<void>;
827
1524
  toggleCollapse: () => void;
828
1525
  }, "syncCSSVariables" | "applyPreset" | "resetSettings" | "updateThemeMode" | "toggleCollapse">>;
829
1526
 
830
- export declare const SideMenu: DefineComponent<__VLS_Props_4, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
1527
+ /** KeepAlive 仅接受具名组件，并由路由 meta.keepAlive 明确开启。 */
1528
+ export declare function shouldCacheRoute(route: Pick<RouteLocationNormalizedLoaded, "name" | "meta">): route is Pick<RouteLocationNormalizedLoaded, "name" | "meta"> & {
1529
+ name: string;
1530
+ };
1531
+
1532
+ export declare const SideMenu: DefineComponent<__VLS_Props_5, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
831
1533
  click: (item: MenuOptions) => any;
832
- }, string, PublicProps, Readonly<__VLS_Props_4> & Readonly<{
1534
+ }, string, PublicProps, Readonly<__VLS_Props_5> & Readonly<{
833
1535
  onClick?: ((item: MenuOptions) => any) | undefined;
834
1536
  }>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
835
1537
 
836
- /**
837
- * 标签页风格
838
- */
1538
+ /** 标签页风格。 */
839
1539
  export declare type TagsViewStyle = "default" | "card" | "smart";
840
1540
 
841
1541
  export declare const THEME_PRESETS: ThemePreset[];
842
1542
 
843
- /**
844
- * 主题预设方案接口
845
- */
1543
+ /** 与具体主题实现无关的标准主题模式。 */
1544
+ export declare type ThemeMode = "light" | "dark" | "system";
1545
+
1546
+ /** 主题预设方案。 */
846
1547
  export declare interface ThemePreset {
847
- /** 方案名称 */
848
1548
  name: string;
849
- /** 方案描述 */
850
1549
  description?: string;
851
- /** 方案图标（emoji 或图标名） */
852
1550
  icon: string;
853
- /** 主题色 */
854
1551
  primaryColor: string;
855
- /** 其他配置（可选） */
856
1552
  settings?: Partial<Omit<SettingsState, "themeMode" | "layoutMode" | "primaryColor">>;
857
1553
  }
858
1554
 
@@ -863,9 +1559,7 @@ export declare const TRANSITION_MAP: {
863
1559
  readonly none: "";
864
1560
  };
865
1561
 
866
- /**
867
- * 页面动画类型
868
- */
1562
+ /** 页面动画类型。 */
869
1563
  export declare type TransitionType = "fade" | "slide" | "zoom" | "none";
870
1564
 
871
1565
  /**
@@ -961,7 +1655,7 @@ export declare interface UseMenuSplitReturn {
961
1655
  /**
962
1656
  * 默认的设置 Store（使用默认配置）
963
1657
  */
964
- export declare const useSettingsStore: StoreDefinition<"settings", Pick<{
1658
+ export declare const useSettingsStore: StoreDefinition<string, Pick<{
965
1659
  themeMode: Ref<ThemeMode, ThemeMode>;
966
1660
  primaryColor: Ref<string, string>;
967
1661
  borderRadius: Ref<BorderRadiusSize, BorderRadiusSize>;