@das-fed/upf-utils 6.4.0-dev.246 → 6.4.0-dev.248

package/theme/index.d.ts

@@ -1,7 +1,13 @@
 import { BUILTIN_PRESET_THEME_NAMES, PRESET_THEMES, BuiltinPresetThemeConfig, BuiltinPresetThemeName } from './presets';
+import { mixHexColor, toRgbaColor } from './color';
 
+export { mixHexColor, normalizeHexColor, resolvePrimaryBgColor, toRgbaColor } from './color';
 export type ThemeVariables = Record<string, string>;
 type ThemeVariableSource = Record<string, string | undefined>;
+export interface ThemeBridgeVariableResolveOptions {
+    themeName?: string;
+    basePresetName?: string;
+}
 export interface ThemeConfig {
     name?: string;
     basePresetName?: 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。 */
@@ -34,9 +44,11 @@ export interface DefaultThemeStyleOptions extends ApplyThemeVariablesOptions {
 export interface ThemeBridgeResolveContext<TVariables extends object = ThemeVariables> {
     variables: TVariables;
     result: Record<string, string>;
+    themeName?: string;
+    basePresetName?: string;
 }
 export interface ThemeBridgeVariableItem<TVariables extends object = ThemeVariables> {
-    target: string;
+    target: string | readonly string[];
     from?: keyof TVariables | string;
     value?: string;
     resolve?: (context: ThemeBridgeResolveContext<TVariables> & {
@@ -53,6 +65,8 @@ export interface ApplyThemeVariablesOptions {
     includeElementAndDasUiBridges?: boolean;
     /** 写入 data-theme 的主题名。 */
     themeName?: string;
+    /** 当前主题基础预设名，用于自定义主题继承预设差异化 token。 */
+    basePresetName?: string;
     /** 写入 data-skin 的皮肤名；传 null 时移除。 */
     skinName?: string | null;
 }
@@ -72,18 +86,20 @@ export type HostThemeRootSyncOptions = SubAppThemeSyncOptions;
 export interface RuntimeThemeVariableBuildOptions {
     /** 是否写入 Element Plus 与 das-ui/das 历史兼容变量；默认 true。 */
     includeElementAndDasUiBridges?: boolean;
+    /** 当前主题名，用于按预设差异化桥接局部组件 token。 */
+    themeName?: string;
+    /** 当前主题基础预设名，自定义主题可通过该字段继承预设差异。 */
+    basePresetName?: string;
 }
-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 resolveThemeBridgeVariables: <TVariables extends object = ThemeVariables>(variables: TVariables, items: readonly ThemeBridgeVariableItem<TVariables>[], options?: ThemeBridgeVariableResolveOptions) => 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 toLegacyThemeVariables: (variables: object, options?: ThemeBridgeVariableResolveOptions) => any;
+export declare const toElementThemeVariables: (variables: object, options?: ThemeBridgeVariableResolveOptions) => any;
+export declare const toDasUiColorOverrides: (variables: object, options?: ThemeBridgeVariableResolveOptions) => any;
+export declare const toUpfComponentThemeVariables: (variables: object, options?: ThemeBridgeVariableResolveOptions) => 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;