@fangxinyan/lumina 0.6.18 → 0.8.0

package/dist/{Tabs-X5U5PCPV.css → Tabs-FB2AMBWL.css}

@@ -1,13 +1,21 @@
 /* ============ Tabs ============ */
 .tabs { display: flex; flex-direction: column; gap: var(--gap-3); }
+.tabs.fill {
+  flex: 1 1 auto;
+  width: 100%;
+  height: 100%;
+  min-width: 0;
+  min-height: 0;
+}
 .tabs-nav {
   display: inline-flex;
   padding: 5px;
   border-radius: var(--r-md);
-  background: var(--bg);
-  box-shadow: var(--neu-shadow-inset);
+  background: var(--lmn-tabs-bg, var(--bg));
+  box-shadow: var(--lmn-tabs-neu-shadow-inset, var(--neu-shadow-inset));
   gap: 2px;
   align-self: flex-start;
+  flex-shrink: 0;
 }
 .tabs-nav .tab {
   padding: 8px 16px;
@@ -17,18 +25,18 @@
   font-size: 12px;
   font-weight: 500;
   font-family: inherit;
-  color: var(--fg-muted);
+  color: var(--lmn-tabs-fg-muted, var(--fg-muted));
   cursor: pointer;
   display: inline-flex;
   align-items: center;
   gap: 6px;
   transition: all var(--dur-fast) var(--ease);
 }
-.tabs-nav .tab:hover { color: var(--fg); }
+.tabs-nav .tab:hover { color: var(--lmn-tabs-fg, var(--fg)); }
 .tabs-nav .tab.active {
-  color: var(--accent-ink);
-  background: var(--bg);
-  box-shadow: var(--neu-shadow-control);
+  color: var(--lmn-tabs-accent-ink, var(--accent-ink));
+  background: var(--lmn-tabs-bg, var(--bg));
+  box-shadow: var(--lmn-tabs-neu-shadow-control, var(--neu-shadow-control));
   font-weight: 600;
 }
 .tabs-nav .tab[disabled] { opacity: 0.4; cursor: not-allowed; }
@@ -39,7 +47,7 @@
   background: transparent;
   box-shadow: none;
   border-radius: 0;
-  border-bottom: 1px solid var(--divider);
+  border-bottom: 1px solid var(--lmn-tabs-divider, var(--divider));
   align-self: stretch;
 }
 .tabs.line .tabs-nav .tab,
@@ -54,8 +62,8 @@
 .tabs.line .tabs-nav .tab.active::after,
 .tabs.underline .tabs-nav .tab.active::after {
   content: ""; position: absolute; left: 0; right: 0; bottom: -1px; height: 2px;
-  background: var(--accent); border-radius: 999px;
-  box-shadow: 0 0 8px var(--accent-glow);
+  background: var(--lmn-tabs-accent, var(--accent)); border-radius: 999px;
+  box-shadow: 0 0 8px var(--lmn-tabs-accent-glow, var(--accent-glow));
 }
 
 /* Centered nav — works for pill / segmented (self-align) and line (flex-center) */
@@ -66,3 +74,9 @@
 .tabs.centered.underline .tabs-nav .tab { margin-right: 11px; margin-left: 11px; }
 
 .tabs-content { padding: var(--gap-2) 0; }
+.tabs.fill .tabs-content {
+  flex: 1 1 auto;
+  min-width: 0;
+  min-height: 0;
+  overflow: auto;
+}

package/dist/Tabs.cjs

@@ -1,10 +1,12 @@
 'use strict';
 
-var chunk5A6KSYWA_cjs = require('./chunk-5A6KSYWA.cjs');
+var chunkRR7KWH26_cjs = require('./chunk-RR7KWH26.cjs');
+require('./chunk-NRJXZPZR.cjs');
+require('./chunk-EE5KXDRK.cjs');
 
 
 
 Object.defineProperty(exports, "Tabs", {
   enumerable: true,
-  get: function () { return chunk5A6KSYWA_cjs.Tabs; }
+  get: function () { return chunkRR7KWH26_cjs.Tabs; }
 });

package/dist/Tabs.d.cts

@@ -1,4 +1,5 @@
 import * as React from 'react';
+import { f as ComponentThemeProps } from './componentThemeTypes-Jt4B5aU8.cjs';
 
 interface TabItem {
     key: string;
@@ -6,7 +7,7 @@ interface TabItem {
     disabled?: boolean;
     content?: React.ReactNode;
 }
-interface TabsProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onChange"> {
+interface TabsProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onChange">, ComponentThemeProps {
     items: TabItem[];
     activeKey?: string;
     defaultActiveKey?: string;
@@ -14,9 +15,14 @@ interface TabsProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onChange
     variant?: "line" | "pill" | "segmented";
     /** Center-align the tab bar horizontally. */
     centered?: boolean;
+    /** 标签条容器的附加类名。 */
+    tabBarClassName?: string;
+    /** 正文容器的附加类名。 */
+    contentClassName?: string;
+    /** 占满父容器，并让正文区域独立滚动。 */
+    fill?: boolean;
     className?: string;
 }
-/** `Tabs` — switchable sections. */
 declare const Tabs: React.ForwardRefExoticComponent<TabsProps & React.RefAttributes<HTMLDivElement>>;
 
 export { type TabItem, Tabs, type TabsProps };

package/dist/Tabs.d.ts

@@ -1,4 +1,5 @@
 import * as React from 'react';
+import { f as ComponentThemeProps } from './componentThemeTypes-Jt4B5aU8.js';
 
 interface TabItem {
     key: string;
@@ -6,7 +7,7 @@ interface TabItem {
     disabled?: boolean;
     content?: React.ReactNode;
 }
-interface TabsProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onChange"> {
+interface TabsProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onChange">, ComponentThemeProps {
     items: TabItem[];
     activeKey?: string;
     defaultActiveKey?: string;
@@ -14,9 +15,14 @@ interface TabsProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onChange
     variant?: "line" | "pill" | "segmented";
     /** Center-align the tab bar horizontally. */
     centered?: boolean;
+    /** 标签条容器的附加类名。 */
+    tabBarClassName?: string;
+    /** 正文容器的附加类名。 */
+    contentClassName?: string;
+    /** 占满父容器，并让正文区域独立滚动。 */
+    fill?: boolean;
     className?: string;
 }
-/** `Tabs` — switchable sections. */
 declare const Tabs: React.ForwardRefExoticComponent<TabsProps & React.RefAttributes<HTMLDivElement>>;
 
 export { type TabItem, Tabs, type TabsProps };

package/dist/Tabs.js

@@ -1 +1,3 @@
-export { Tabs } from './chunk-ZTCRD2FL.js';
+export { Tabs } from './chunk-IJDM2U3B.js';
+import './chunk-DRDDQCDD.js';
+import './chunk-ULTDRMGN.js';

package/dist/Tag-5GIZLRAH.css

@@ -0,0 +1,42 @@
+/* ============ Tag ============ */
+.tag {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  height: 24px;
+  padding: 0 10px;
+  border-radius: var(--r-pill);
+  font-size: 11px;
+  font-weight: 500;
+  background: var(--lmn-tag-bg, var(--bg));
+  box-shadow: var(--lmn-tag-neu-shadow-subtle, var(--neu-shadow-subtle));
+  color: var(--lmn-tag-fg-muted, var(--fg-muted));
+}
+.tag.accent  { color: var(--lmn-tag-accent-ink, var(--accent-ink)); }
+.tag.info    { color: var(--lmn-tag-info, var(--info)); }
+.tag.success { color: var(--lmn-tag-success, var(--success)); }
+.tag.warning { color: var(--lmn-tag-warning, var(--warning)); }
+.tag.danger  { color: var(--lmn-tag-danger, var(--danger)); }
+.tag.solid          { background: var(--lmn-tag-accent, var(--accent)); color: var(--lmn-tag-bg, var(--bg)); box-shadow: 0 2px 6px var(--lmn-tag-accent-glow, var(--accent-glow)); }
+.tag.solid.info     { background: var(--lmn-tag-info, var(--info));    color: var(--lmn-tag-bg, var(--bg)); box-shadow: 0 2px 6px color-mix(in oklch, var(--lmn-tag-info, var(--info)) 35%, transparent); }
+.tag.solid.success  { background: var(--lmn-tag-success, var(--success)); color: var(--lmn-tag-bg, var(--bg)); box-shadow: 0 2px 6px color-mix(in oklch, var(--lmn-tag-success, var(--success)) 35%, transparent); }
+.tag.solid.warning  { background: var(--lmn-tag-warning, var(--warning)); color: var(--lmn-tag-bg, var(--bg)); box-shadow: 0 2px 6px color-mix(in oklch, var(--lmn-tag-warning, var(--warning)) 35%, transparent); }
+.tag.solid.danger   { background: var(--lmn-tag-danger, var(--danger));  color: var(--lmn-tag-bg, var(--bg)); box-shadow: 0 2px 6px color-mix(in oklch, var(--lmn-tag-danger, var(--danger)) 35%, transparent); }
+.tag.borderless { background: transparent; box-shadow: none; }
+.tag .dot { width: 6px; height: 6px; border-radius: 999px; background: currentColor; }
+.tag .tag-ico {
+  color: currentColor;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  line-height: 0;
+  flex-shrink: 0;
+}
+.tag .tag-ico img {
+  display: block;
+  width: 1em;
+  height: 1em;
+  object-fit: contain;
+}
+.tag .x { cursor: pointer; color: var(--lmn-tag-fg-subtle, var(--fg-subtle)); margin-left: 2px; display: inline-flex; }
+.tag .x:hover { color: var(--lmn-tag-fg, var(--fg)); }

package/dist/Tag.cjs

@@ -1,11 +1,13 @@
 'use strict';
 
-var chunk5ERD3W24_cjs = require('./chunk-5ERD3W24.cjs');
-require('./chunk-QMX67CVT.cjs');
+var chunkGFKWSDD6_cjs = require('./chunk-GFKWSDD6.cjs');
+require('./chunk-2AUXUZ3Z.cjs');
+require('./chunk-NRJXZPZR.cjs');
+require('./chunk-EE5KXDRK.cjs');
 
 
 
 Object.defineProperty(exports, "Tag", {
   enumerable: true,
-  get: function () { return chunk5ERD3W24_cjs.Tag; }
+  get: function () { return chunkGFKWSDD6_cjs.Tag; }
 });

package/dist/Tag.d.cts

@@ -1,9 +1,10 @@
 import * as React from 'react';
 import { IconSlot } from './Icon.cjs';
+import { f as ComponentThemeProps } from './componentThemeTypes-Jt4B5aU8.cjs';
 import 'react/jsx-runtime';
 
 type TagTone = "neutral" | "accent" | "info" | "success" | "warning" | "danger";
-interface TagProps extends React.HTMLAttributes<HTMLSpanElement> {
+interface TagProps extends React.HTMLAttributes<HTMLSpanElement>, ComponentThemeProps {
     tone?: TagTone;
     solid?: boolean;
     /** Render a leading colored dot. */
@@ -17,7 +18,6 @@ interface TagProps extends React.HTMLAttributes<HTMLSpanElement> {
     bordered?: boolean;
     children?: React.ReactNode;
 }
-/** `Tag` — small label/pill. */
 declare const Tag: React.ForwardRefExoticComponent<TagProps & React.RefAttributes<HTMLSpanElement>>;
 
 export { Tag, type TagProps, type TagTone };

package/dist/Tag.d.ts

@@ -1,9 +1,10 @@
 import * as React from 'react';
 import { IconSlot } from './Icon.js';
+import { f as ComponentThemeProps } from './componentThemeTypes-Jt4B5aU8.js';
 import 'react/jsx-runtime';
 
 type TagTone = "neutral" | "accent" | "info" | "success" | "warning" | "danger";
-interface TagProps extends React.HTMLAttributes<HTMLSpanElement> {
+interface TagProps extends React.HTMLAttributes<HTMLSpanElement>, ComponentThemeProps {
     tone?: TagTone;
     solid?: boolean;
     /** Render a leading colored dot. */
@@ -17,7 +18,6 @@ interface TagProps extends React.HTMLAttributes<HTMLSpanElement> {
     bordered?: boolean;
     children?: React.ReactNode;
 }
-/** `Tag` — small label/pill. */
 declare const Tag: React.ForwardRefExoticComponent<TagProps & React.RefAttributes<HTMLSpanElement>>;
 
 export { Tag, type TagProps, type TagTone };

package/dist/Tag.js

@@ -1,2 +1,4 @@
-export { Tag } from './chunk-6K5YI4ZE.js';
-import './chunk-FDZG27IG.js';
+export { Tag } from './chunk-62VV5COT.js';
+import './chunk-LQMOYVQF.js';
+import './chunk-DRDDQCDD.js';
+import './chunk-ULTDRMGN.js';

package/dist/{Textarea-YHWKHIFE.css → Textarea-ZGHBZNLX.css}

@@ -7,7 +7,7 @@
 }
 .textarea-count {
   font-size: 11px;
-  color: var(--fg-subtle);
+  color: var(--lmn-textarea-fg-subtle, var(--fg-subtle));
   font-variant-numeric: tabular-nums;
   text-align: right;
 }
@@ -23,14 +23,14 @@
   width: 18px;
   height: 18px;
   border-radius: 999px;
-  color: var(--fg-subtle);
+  color: var(--lmn-textarea-fg-subtle, var(--fg-subtle));
   background: transparent;
   cursor: pointer;
   transition: color var(--dur-fast) var(--ease), background var(--dur-fast) var(--ease);
 }
 .textarea-wrap .textarea-clear:hover {
-  color: var(--fg);
-  background: var(--bg-sunken);
+  color: var(--lmn-textarea-fg, var(--fg));
+  background: var(--lmn-textarea-bg-sunken, var(--bg-sunken));
 }
 
 .textarea {
@@ -39,9 +39,9 @@
   padding: 12px 14px;
   border: none;
   border-radius: var(--r-md);
-  background: var(--bg);
-  box-shadow: var(--neu-shadow-inset);
-  color: var(--fg);
+  background: var(--lmn-textarea-bg, var(--bg));
+  box-shadow: var(--lmn-textarea-neu-shadow-inset, var(--neu-shadow-inset));
+  color: var(--lmn-textarea-fg, var(--fg));
   font-size: 13px;
   font-family: inherit;
   line-height: 1.55;
@@ -49,6 +49,6 @@
   outline: none;
   transition: box-shadow var(--dur) var(--ease);
 }
-.textarea:focus { box-shadow: var(--neu-shadow-inset), 0 0 0 2px var(--accent-glow); }
-.textarea.invalid { box-shadow: var(--neu-shadow-inset), 0 0 0 2px color-mix(in oklch, var(--danger) 30%, transparent); }
-.textarea::placeholder { color: var(--fg-subtle); }
+.textarea:focus { box-shadow: var(--lmn-textarea-neu-shadow-inset, var(--neu-shadow-inset)), 0 0 0 2px var(--lmn-textarea-accent-glow, var(--accent-glow)); }
+.textarea.invalid { box-shadow: var(--lmn-textarea-neu-shadow-inset, var(--neu-shadow-inset)), 0 0 0 2px color-mix(in oklch, var(--lmn-textarea-danger, var(--danger)) 30%, transparent); }
+.textarea::placeholder { color: var(--lmn-textarea-fg-subtle, var(--fg-subtle)); }

package/dist/Textarea.cjs

@@ -1,15 +1,17 @@
 'use strict';
 
-var chunkRZEFKXL3_cjs = require('./chunk-RZEFKXL3.cjs');
-require('./chunk-QMX67CVT.cjs');
+var chunkHYHBCHFM_cjs = require('./chunk-HYHBCHFM.cjs');
+require('./chunk-2AUXUZ3Z.cjs');
+require('./chunk-NRJXZPZR.cjs');
+require('./chunk-EE5KXDRK.cjs');
 
 
 
 Object.defineProperty(exports, "TextArea", {
   enumerable: true,
-  get: function () { return chunkRZEFKXL3_cjs.TextArea; }
+  get: function () { return chunkHYHBCHFM_cjs.TextArea; }
 });
 Object.defineProperty(exports, "Textarea", {
   enumerable: true,
-  get: function () { return chunkRZEFKXL3_cjs.Textarea; }
+  get: function () { return chunkHYHBCHFM_cjs.Textarea; }
 });

package/dist/Textarea.d.cts

@@ -1,6 +1,7 @@
 import * as React from 'react';
+import { f as ComponentThemeProps } from './componentThemeTypes-Jt4B5aU8.cjs';
 
-interface TextareaProps extends Omit<React.TextareaHTMLAttributes<HTMLTextAreaElement>, "onChange" | "value" | "defaultValue"> {
+interface TextareaProps extends Omit<React.TextareaHTMLAttributes<HTMLTextAreaElement>, "onChange" | "value" | "defaultValue">, ComponentThemeProps {
     value?: string;
     defaultValue?: string;
     /** Native textarea change event. */
@@ -16,9 +17,6 @@ interface TextareaProps extends Omit<React.TextareaHTMLAttributes<HTMLTextAreaEl
     showCount?: boolean;
     className?: string;
 }
-/**
- * `Textarea` — multi-line text input with a neumorphic groove.
- */
 declare const Textarea: React.ForwardRefExoticComponent<TextareaProps & React.RefAttributes<HTMLTextAreaElement>>;
 declare const TextArea: React.ForwardRefExoticComponent<TextareaProps & React.RefAttributes<HTMLTextAreaElement>>;
 

package/dist/Textarea.d.ts

@@ -1,6 +1,7 @@
 import * as React from 'react';
+import { f as ComponentThemeProps } from './componentThemeTypes-Jt4B5aU8.js';
 
-interface TextareaProps extends Omit<React.TextareaHTMLAttributes<HTMLTextAreaElement>, "onChange" | "value" | "defaultValue"> {
+interface TextareaProps extends Omit<React.TextareaHTMLAttributes<HTMLTextAreaElement>, "onChange" | "value" | "defaultValue">, ComponentThemeProps {
     value?: string;
     defaultValue?: string;
     /** Native textarea change event. */
@@ -16,9 +17,6 @@ interface TextareaProps extends Omit<React.TextareaHTMLAttributes<HTMLTextAreaEl
     showCount?: boolean;
     className?: string;
 }
-/**
- * `Textarea` — multi-line text input with a neumorphic groove.
- */
 declare const Textarea: React.ForwardRefExoticComponent<TextareaProps & React.RefAttributes<HTMLTextAreaElement>>;
 declare const TextArea: React.ForwardRefExoticComponent<TextareaProps & React.RefAttributes<HTMLTextAreaElement>>;
 

package/dist/Textarea.js

@@ -1,2 +1,4 @@
-export { TextArea, Textarea } from './chunk-S7IHWY24.js';
-import './chunk-FDZG27IG.js';
+export { TextArea, Textarea } from './chunk-3F424R5P.js';
+import './chunk-LQMOYVQF.js';
+import './chunk-DRDDQCDD.js';
+import './chunk-ULTDRMGN.js';

package/dist/Theme-CLedeJ_C.d.ts

@@ -0,0 +1,193 @@
+import * as React from 'react';
+import { T as ThemeBaseMode, R as ResolvedThemeColors, A as AccentKey, a as AccentPalette, h as CustomAccentInput, i as ThemeColorOverrides, l as ThemeTokens, e as ComponentThemeOverrides, k as ThemeSurfacePalette } from './componentThemeTypes-Jt4B5aU8.js';
+
+/** 子树和 Portal 之间传递的完整视觉主题快照。 */
+interface VisualThemeSnapshot {
+    colorScheme: ThemeBaseMode;
+    intensity: number;
+    colors: ResolvedThemeColors;
+}
+
+type BuiltInThemeMode = ThemeBaseMode | "system";
+type ThemeMode = BuiltInThemeMode | (string & {});
+type ResolvedThemeMode = ThemeBaseMode | (string & {});
+type DensityMode = "compact" | "comfortable" | "spacious";
+type FontKey = "system" | "sf" | "serif" | "mono";
+/** Font config — either a preset key, a single sans string, or a granular object. */
+type FontConfig = FontKey | string | {
+    sans?: string;
+    display?: string;
+    mono?: string;
+};
+/** Named custom theme mode. `base` keeps dark/light specific component rules. */
+interface ThemePreset {
+    /** Optional display name used by ThemePanel or other theme pickers. */
+    label?: string;
+    /** Optional helper text used by ThemePanel or other theme pickers. */
+    description?: string;
+    base?: ThemeBaseMode;
+    /** 可选表面基色；存在时生成完整拟态色板。 */
+    baseColor?: string;
+    accent?: AccentKey | CustomAccentInput;
+    density?: DensityMode;
+    intensity?: number;
+    radius?: number;
+    font?: FontConfig;
+    /** 对派生色板进行最终精确覆盖。 */
+    colors?: ThemeColorOverrides;
+    tokens?: ThemeTokens;
+    /** React 组件树中按公开组件名称应用的覆盖。 */
+    components?: ComponentThemeOverrides;
+}
+type ThemePresets = Record<string, ThemePreset>;
+interface ThemeConfig {
+    mode?: ThemeMode;
+    /** Base light/dark color scheme used by custom modes. */
+    colorScheme?: ThemeBaseMode;
+    /** 生成完整表面色板的基色。 */
+    baseColor?: string;
+    accent?: AccentKey | CustomAccentInput;
+    density?: DensityMode;
+    /** Shadow strength. ThemePanel exposes 0..20, mapping to `--d` (0.4..2.8). */
+    intensity?: number;
+    /** Base radius in px — generates the full `--r-*` scale. */
+    radius?: number;
+    font?: FontConfig;
+    /** 对派生色板进行最终精确覆盖。 */
+    colors?: ThemeColorOverrides;
+    tokens?: ThemeTokens;
+    /** React 组件树消费的按组件名称覆盖；applyTheme 会忽略该字段。 */
+    components?: ComponentThemeOverrides;
+    /** Custom named modes addressable through `mode` / `setMode`. */
+    themes?: ThemePresets;
+}
+/** ThemeProvider 在普通主题配置上增加 React 组件类型覆盖。 */
+interface ThemeProviderConfig extends ThemeConfig {
+}
+interface ThemeValue {
+    /** Requested mode ("system" is preserved here). */
+    mode: ThemeMode;
+    /** Resolved concrete mode ("system" → "light" | "dark"; custom modes keep their name). */
+    resolvedMode: ResolvedThemeMode;
+    /** The light/dark base currently used for component-specific selectors. */
+    colorScheme: ThemeBaseMode;
+    /** 当前显式基色；未设置时为空。 */
+    baseColor?: string;
+    /** Accent key or "custom" if a palette was supplied. */
+    accent: AccentKey | "custom";
+    /** Resolved palette currently in effect. */
+    accentPalette: AccentPalette;
+    density: DensityMode;
+    intensity: number;
+    radius: number;
+    font: FontConfig;
+    colors: ThemeColorOverrides;
+    tokens: ThemeTokens;
+    themes: ThemePresets;
+    components: ComponentThemeOverrides;
+    activeTheme: ThemePreset | null;
+    setMode: (m: ThemeMode) => void;
+    toggleMode: () => void;
+    setBaseColor: (color?: string) => void;
+    setAccent: (a: AccentKey | CustomAccentInput) => void;
+    setDensity: (d: DensityMode) => void;
+    setIntensity: (n: number) => void;
+    setRadius: (n: number) => void;
+    setFont: (f: FontConfig) => void;
+    setColors: (colors: ThemeColorOverrides) => void;
+    setTokens: (t: ThemeTokens) => void;
+    setThemes: (t: ThemePresets) => void;
+    setComponents: (components: ComponentThemeOverrides) => void;
+    /** Shallow-merge a partial config. */
+    update: (cfg: Partial<ThemeProviderConfig>) => void;
+    /** Reset to the initial props. */
+    reset: () => void;
+}
+/** Built-in accent palettes (light-mode values). */
+declare const ACCENT_PRESETS: Record<AccentKey, AccentPalette>;
+/** Dark-mode overrides — ink/soft shift, and glow alpha is halved so the outer
+ *  button bloom doesn't read as a bright ring on dark surfaces. */
+declare const ACCENT_PRESETS_DARK: Record<AccentKey, Pick<AccentPalette, "ink" | "soft" | "glow">>;
+/** Built-in font family stacks. */
+declare const FONT_STACKS: Record<FontKey, string>;
+/** Resolve "system" mode against `prefers-color-scheme`; custom modes keep their name. */
+declare function resolveThemeMode(mode: ThemeMode): ResolvedThemeMode;
+declare function resolveThemeColorScheme(mode: ThemeMode, themes?: ThemePresets, fallback?: ThemeBaseMode): ThemeBaseMode;
+/** Fill missing slots of a custom accent via color-mix. */
+declare function normalizeAccentInput(input: AccentKey | CustomAccentInput, colorScheme: ThemeBaseMode): {
+    key: AccentKey | "custom";
+    palette: AccentPalette;
+};
+/** Lumina 当前浅色与深色主题的基础颜色，保持未启用多色主题时视觉不变。 */
+declare const DEFAULT_THEME_COLORS: Record<ThemeBaseMode, ResolvedThemeColors>;
+/**
+ * 从基色生成差异明显的拟态表面色板。
+ *
+ * @example
+ * ```ts
+ * const palette = deriveThemeColors("#ffe8df", { colorScheme: "light" });
+ * ```
+ */
+declare function deriveThemeColors(baseColor: string, options?: {
+    colorScheme?: ThemeBaseMode;
+    accent?: AccentKey | CustomAccentInput;
+}): ThemeSurfacePalette;
+/** 从主题配置解析完整颜色，供 ThemeProvider、组件作用域和 Portal 共用。 */
+declare function resolveThemeColors(config: Pick<ThemeConfig, "baseColor" | "accent" | "colors" | "tokens">, colorScheme: ThemeBaseMode, inherited?: ResolvedThemeColors): ResolvedThemeColors;
+/** 把完整颜色表转换为可直接合并到 React style 的 CSS 变量。 */
+declare function themeColorsToStyle(colors: ResolvedThemeColors, prefix?: string): React.CSSProperties;
+/** 把 camelCase token 名转换为 CSS 自定义属性使用的 kebab-case。 */
+declare function themeTokenToKebabCase(value: string): string;
+/** 根据完整主题快照生成全局或组件前缀 CSS 变量。 */
+declare function visualThemeToStyle(snapshot: VisualThemeSnapshot, prefix?: string): React.CSSProperties;
+/** 把组件短 token 映射到当前组件前缀；完整变量名作为高级逃生口原样保留。 */
+declare function componentTokensToStyle(tokens: ThemeTokens | undefined, prefix: string): React.CSSProperties;
+/** 把主题输入与继承快照解析为组件和 Portal 共用的完整视觉快照。 */
+declare function resolveVisualThemeSnapshot(config: Pick<ThemeConfig, "baseColor" | "colorScheme" | "accent" | "intensity" | "colors" | "tokens">, inherited?: VisualThemeSnapshot): VisualThemeSnapshot;
+/** Imperative theme application — writes CSS vars / data-attrs on a target. */
+declare function applyTheme(target: HTMLElement, config: ThemeConfig): void;
+/** Read/write access to the nearest `<ThemeProvider>`. */
+declare function useTheme(): ThemeValue;
+/** Read theme value without throwing — returns `null` outside of a provider. */
+declare function useThemeOptional(): ThemeValue | null;
+interface ThemeProviderProps extends ThemeProviderConfig {
+    children?: React.ReactNode;
+    /** 是否启用当前 Provider；关闭时保持 Context 拓扑但完整继承外层主题。 */
+    enabled?: boolean;
+    /**
+     * Where to apply the theme.
+     * - `"root"` (default): on `<html>` — affects the whole document.
+     * - `"scope"`: on a local wrapper element — scoped to descendants.
+     */
+    target?: "root" | "scope";
+    /** Tag for scope mode. Default `"div"`. */
+    as?: keyof JSX.IntrinsicElements;
+    /** scope 模式直接把主题应用到唯一子元素，避免增加额外 DOM 包装。 */
+    asChild?: boolean;
+    className?: string;
+    style?: React.CSSProperties;
+    /** 使用带版本号的结构持久化主题，并同步同源窗口。 */
+    storageKey?: string;
+    /** Called whenever the resolved theme value changes. */
+    onChange?: (value: ThemeValue) => void;
+}
+/**
+ * `<ThemeProvider>` — manage theme state and apply CSS variables.
+ *
+ * @example
+ * ```tsx
+ * <ThemeProvider mode="system" accent="violet" storageKey="app:theme">
+ *   <App />
+ * </ThemeProvider>
+ * ```
+ *
+ * @example Custom accent
+ * ```tsx
+ * <ThemeProvider accent={{ accent: "oklch(70% 0.2 180)" }} />
+ * // or just
+ * <ThemeProvider accent="oklch(70% 0.2 180)" />
+ * ```
+ */
+declare const ThemeProvider: React.FC<ThemeProviderProps>;
+
+export { ACCENT_PRESETS as A, type BuiltInThemeMode as B, DEFAULT_THEME_COLORS as D, FONT_STACKS as F, type ResolvedThemeMode as R, type ThemeConfig as T, ACCENT_PRESETS_DARK as a, type DensityMode as b, type FontConfig as c, type FontKey as d, type ThemeMode as e, type ThemePreset as f, type ThemePresets as g, ThemeProvider as h, type ThemeProviderConfig as i, type ThemeProviderProps as j, type ThemeValue as k, applyTheme as l, componentTokensToStyle as m, deriveThemeColors as n, normalizeAccentInput as o, resolveThemeColors as p, resolveThemeMode as q, resolveThemeColorScheme as r, resolveVisualThemeSnapshot as s, themeColorsToStyle as t, themeTokenToKebabCase as u, useTheme as v, useThemeOptional as w, visualThemeToStyle as x };