@das-fed/upf-utils 6.4.0-hot.13 → 6.4.0-hot.14

package/theme/index.d.ts

@@ -1,6 +1,12 @@
 import { BUILTIN_PRESET_THEME_NAMES, PRESET_THEMES, BuiltinPresetThemeConfig, BuiltinPresetThemeName } from './presets';
+import { RuntimeThemeVariableBuildOptions } from './bridge';
+import { ThemeVariables } from './source-variables';
 
-export type ThemeVariables = Record<string, string>;
+export { mixHexColor, normalizeHexColor, resolvePrimaryBgColor, toRgbaColor } from './color';
+export { DAS_UI_THEME_BRIDGE_ITEMS, ELEMENT_THEME_BRIDGE_ITEMS, LEGACY_THEME_BRIDGE_ITEMS, UPF_COMPONENT_THEME_BRIDGE_ITEMS, buildRuntimeThemeVariables, resolveThemeBridgeVariables, toDasUiColorOverrides, toElementThemeVariables, toLegacyThemeVariables, toUpfComponentThemeVariables, } from './bridge';
+export { PRESET_THEME_VARIABLES, THEME_SOURCE_VARIABLE_CATEGORIES, THEME_SOURCE_VARIABLE_HINTS, THEME_SOURCE_VARIABLE_LABELS, THEME_SOURCE_VARIABLE_META, THEME_SOURCE_VARIABLE_NAMES, THEME_SOURCE_VARIABLE_RELATIONS, getThemeSourceVariableCategories, getThemeSourceVariableHints, getThemeSourceVariableLabels, getThemeSourceVariableNames, getThemeSourceVariableRelations, normalizeThemeSourceVariables, } from './source-variables';
+export type { RuntimeThemeVariableBuildOptions, ThemeBridgeResolveContext, ThemeBridgeVariableItem, ThemeBridgeVariableResolveOptions, } from './bridge';
+export type { BuiltinPresetThemeName, PartialThemeVariables, ThemeMode, ThemeSourceVariableMeta, ThemeSourceVariableName, ThemeVariableCategory, ThemeVariableCategoryGroupKey, ThemeVariables, } from './source-variables';
 type ThemeVariableSource = Record<string, string | undefined>;
 export interface ThemeConfig {
     name?: string;
@@ -24,6 +30,10 @@ export interface ThemeBridgeAPI<TThemeName extends string = string, TVariables e
 export interface DefaultThemeStyleOptions extends ApplyThemeVariablesOptions {
     /** 默认注入的预设主题名称。 */
     presetName?: BuiltinPresetThemeName | string;
+    /** 未显式指定 presetName 时，是否读取本地主题缓存；默认 false。 */
+    useStoredTheme?: boolean;
+    /** 本地主题缓存 key；用于独立运行兜底时对齐主应用已保存主题。 */
+    storageKey?: string;
     /** 默认主题 style 标签 id；用于手动注入时避免重复插入。 */
     styleId?: string;
     /** 已存在运行时主题变量时是否强制覆盖；默认 false。 */
@@ -31,19 +41,6 @@ export interface DefaultThemeStyleOptions extends ApplyThemeVariablesOptions {
     /** 是否写入 data-theme/data-skin；默认 true，mframe 自动兜底可关闭避免误标记。 */
     setThemeAttributes?: boolean;
 }
-export interface ThemeBridgeResolveContext<TVariables extends object = ThemeVariables> {
-    variables: TVariables;
-    result: Record<string, string>;
-}
-export interface ThemeBridgeVariableItem<TVariables extends object = ThemeVariables> {
-    target: string;
-    from?: keyof TVariables | string;
-    value?: string;
-    resolve?: (context: ThemeBridgeResolveContext<TVariables> & {
-        mixHexColor: typeof mixHexColor;
-        toRgbaColor: typeof toRgbaColor;
-    }) => string;
-}
 export interface ApplyThemeVariablesOptions {
     /** 写入目标节点；默认当前文档 html。 */
     root?: HTMLElement | null;
@@ -53,6 +50,8 @@ export interface ApplyThemeVariablesOptions {
     includeElementAndDasUiBridges?: boolean;
     /** 写入 data-theme 的主题名。 */
     themeName?: string;
+    /** 当前主题基础预设名，用于自定义主题继承预设差异化 token。 */
+    basePresetName?: string;
     /** 写入 data-skin 的皮肤名；传 null 时移除。 */
     skinName?: string | null;
 }
@@ -69,22 +68,6 @@ export interface SubAppThemeSyncOptions extends ThemePullOptions {
     onThemeChange?: (event: ThemeChangeEvent) => void;
 }
 export type HostThemeRootSyncOptions = SubAppThemeSyncOptions;
-export interface RuntimeThemeVariableBuildOptions {
-    /** 是否写入 Element Plus 与 das-ui/das 历史兼容变量；默认 true。 */
-    includeElementAndDasUiBridges?: boolean;
-}
-export declare const mixHexColor: (foreground: string, background: string, foregroundWeight: number, fallback: string) => string;
-export declare const toRgbaColor: (color: string, alpha: number, fallback: string) => string;
-export declare const resolveThemeBridgeVariables: <TVariables extends object = ThemeVariables>(variables: TVariables, items: readonly ThemeBridgeVariableItem<TVariables>[]) => any;
-export declare const LEGACY_THEME_BRIDGE_ITEMS: ThemeBridgeVariableItem[];
-export declare const ELEMENT_THEME_BRIDGE_ITEMS: ThemeBridgeVariableItem[];
-export declare const DAS_UI_THEME_BRIDGE_ITEMS: ThemeBridgeVariableItem[];
-export declare const UPF_COMPONENT_THEME_BRIDGE_ITEMS: ThemeBridgeVariableItem[];
-export declare const toLegacyThemeVariables: (variables: object) => any;
-export declare const toElementThemeVariables: (variables: object) => any;
-export declare const toDasUiColorOverrides: (variables: object) => any;
-export declare const toUpfComponentThemeVariables: (variables: object) => any;
-export declare const buildRuntimeThemeVariables: (variables: object, options?: RuntimeThemeVariableBuildOptions) => Record<string, string>;
 export { BUILTIN_PRESET_THEME_NAMES, PRESET_THEMES };
 export declare const getPresetTheme: (themeName: string) => any;
 export declare const getAllPresetThemes: () => any;
@@ -97,10 +80,10 @@ export declare const getHostThemeSnapshotFromWindowName: (debug?: boolean) => Th
 export declare const applyThemeVariablesToDocument: (variables: object, options?: ApplyThemeVariablesOptions) => any;
 export declare const applyThemeEventToDocument: (event: ThemeChangeEvent, options?: ApplyThemeVariablesOptions) => any;
 export declare const getThemeAPI: (debug?: boolean) => ThemeBridgeAPI | null;
-export declare const getCurrentTheme: (options?: ThemePullOptions) => ThemeChangeEvent<string, Record<string, string>>;
+export declare const getCurrentTheme: (options?: ThemePullOptions) => ThemeChangeEvent<string, Record<import('./source-variables').ThemeSourceVariableName, string>>;
 export declare const getThemeVariables: (options?: ThemePullOptions) => any;
 export declare const changeTheme: (themeName: string, debug?: boolean) => boolean;
-export declare const syncThemeFromHost: (options?: ThemePullOptions) => ThemeChangeEvent<string, Record<string, string>>;
+export declare const syncThemeFromHost: (options?: ThemePullOptions) => ThemeChangeEvent<string, Record<import('./source-variables').ThemeSourceVariableName, string>>;
 export declare const syncHostThemeRoot: (options?: ThemePullOptions) => ThemeChangeEvent | null;
 export declare const initSubAppThemeSync: (options?: SubAppThemeSyncOptions) => () => void;
 export declare const initHostThemeRootSync: (options?: HostThemeRootSyncOptions) => () => void;