@das-fed/upf-utils 6.4.0-dev.247 → 6.4.0-dev.249

package/esm-map.json

@@ -89,6 +89,19 @@
   "toDasUiColorOverrides": "/theme/index",
   "toUpfComponentThemeVariables": "/theme/index",
   "buildRuntimeThemeVariables": "/theme/index",
+  "PRESET_THEME_VARIABLES": "/theme/index",
+  "THEME_SOURCE_VARIABLE_CATEGORIES": "/theme/index",
+  "THEME_SOURCE_VARIABLE_HINTS": "/theme/index",
+  "THEME_SOURCE_VARIABLE_LABELS": "/theme/index",
+  "THEME_SOURCE_VARIABLE_META": "/theme/index",
+  "THEME_SOURCE_VARIABLE_NAMES": "/theme/index",
+  "THEME_SOURCE_VARIABLE_RELATIONS": "/theme/index",
+  "getThemeSourceVariableCategories": "/theme/index",
+  "getThemeSourceVariableHints": "/theme/index",
+  "getThemeSourceVariableLabels": "/theme/index",
+  "getThemeSourceVariableNames": "/theme/index",
+  "getThemeSourceVariableRelations": "/theme/index",
+  "normalizeThemeSourceVariables": "/theme/index",
   "BUILTIN_PRESET_THEME_NAMES": "/theme/index",
   "PRESET_THEMES": "/theme/index",
   "getPresetTheme": "/theme/index",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@das-fed/upf-utils",
-  "version": "6.4.0-dev.247",
+  "version": "6.4.0-dev.249",
   "description": "",
   "type": "module",
   "main": "./index.js",
@@ -22,8 +22,8 @@
   },
   "devDependencies": {
     "@babel/preset-env": "7.26.0",
-    "@das-fed/upf-cli": "6.4.0-dev.247",
-    "@das-fed/upf-web": "6.4.0-dev.247",
+    "@das-fed/upf-cli": "6.4.0-dev.249",
+    "@das-fed/upf-web": "6.4.0-dev.249",
     "@rollup/plugin-babel": "6.0.4",
     "@types/js-cookie": "^3.0.6",
     "@types/lodash-es": "^4.17.12",

package/theme/bridge.d.ts

@@ -0,0 +1,42 @@
+import { mixHexColor, toRgbaColor } from './color';
+import { ThemeVariables } from './source-variables';
+
+export type { ThemeVariables } from './source-variables';
+export interface ThemeBridgeVariableResolveOptions {
+    themeName?: string;
+    basePresetName?: string;
+}
+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 | readonly string[];
+    from?: keyof TVariables | string;
+    value?: string;
+    resolve?: (context: ThemeBridgeResolveContext<TVariables> & {
+        mixHexColor: typeof mixHexColor;
+        toRgbaColor: typeof toRgbaColor;
+    }) => string;
+}
+export interface RuntimeThemeVariableBuildOptions {
+    /** 是否写入 Element Plus 与 das-ui/das 历史兼容变量；默认 true。 */
+    includeElementAndDasUiBridges?: boolean;
+    /** 当前主题名，用于按预设差异化桥接局部组件 token。 */
+    themeName?: string;
+    /** 当前主题基础预设名，自定义主题可通过该字段继承预设差异。 */
+    basePresetName?: string;
+}
+export declare const normalizeRuntimeThemeSourceVariables: (variables: object) => 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, 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>;

package/theme/es5.d.ts

@@ -1,13 +1,13 @@
 import { BUILTIN_PRESET_THEME_NAMES, PRESET_THEMES, BuiltinPresetThemeConfig, BuiltinPresetThemeName } from './presets';
-import { mixHexColor, toRgbaColor } from './color';
+import { RuntimeThemeVariableBuildOptions } from './bridge';
+import { ThemeVariables } from './source-variables';
 
 export { mixHexColor, normalizeHexColor, resolvePrimaryBgColor, toRgbaColor } from './color';
-export type ThemeVariables = Record<string, string>;
+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 ThemeBridgeVariableResolveOptions {
-    themeName?: string;
-    basePresetName?: string;
-}
 export interface ThemeConfig {
     name?: string;
     basePresetName?: string;
@@ -30,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。 */
@@ -37,21 +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>;
-    themeName?: string;
-    basePresetName?: string;
-}
-export interface ThemeBridgeVariableItem<TVariables extends object = ThemeVariables> {
-    target: string | readonly 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;
@@ -79,24 +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;
-    /** 当前主题名，用于按预设差异化桥接局部组件 token。 */
-    themeName?: string;
-    /** 当前主题基础预设名，自定义主题可通过该字段继承预设差异。 */
-    basePresetName?: string;
-}
-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, 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;
 export declare const getAllPresetThemes: () => any;
@@ -109,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;