@fangxinyan/lumina 0.6.18 → 0.8.0

package/dist/Splitter.d.ts

@@ -1,7 +1,8 @@
 import * as React from 'react';
+import { f as ComponentThemeProps } from './componentThemeTypes-Jt4B5aU8.js';
 
 type SplitterDirection = "horizontal" | "vertical";
-interface SplitterProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "children" | "onResize"> {
+interface SplitterProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "children" | "onResize">, ComponentThemeProps {
     /**
      * Layout direction.
      * - `"horizontal"` (default) — children placed left/right, handle is a vertical bar.
@@ -27,18 +28,23 @@ interface SplitterProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "chil
     className?: string;
     /** Extra className on the drag handle. */
     handleClassName?: string;
+    /** 原生属性透传到拖拽手柄，可用于设置 aria-label。 */
+    handleProps?: Omit<React.HTMLAttributes<HTMLDivElement>, "onPointerDown">;
+    /** 第一个面板的附加类名。 */
+    firstPaneClassName?: string;
+    /** 第一个面板的内联样式，优先级高于内部分栏尺寸样式。 */
+    firstPaneStyle?: React.CSSProperties;
+    /** 第二个面板的附加类名。 */
+    secondPaneClassName?: string;
+    /** 第二个面板的内联样式。 */
+    secondPaneStyle?: React.CSSProperties;
+    /** 自定义分隔手柄内容；传入 null 可隐藏默认握柄。 */
+    handle?: React.ReactNode;
+    /** 第二个面板保留的最小尺寸。默认 24px。 */
+    secondMin?: number;
+    /** 可选持久化键；仅保存一个数值尺寸。 */
+    storageKey?: string;
 }
-/**
- * `Splitter` — draggable split between two panels. Keyboard-accessible.
- *
- * @example
- * ```tsx
- * <Splitter defaultSize={240} min={160} max={400}>
- *   <Sidebar ... />
- *   <main>...</main>
- * </Splitter>
- * ```
- */
 declare const Splitter: React.ForwardRefExoticComponent<SplitterProps & React.RefAttributes<HTMLDivElement>>;
 
 export { Splitter, type SplitterDirection, type SplitterProps };

package/dist/Splitter.js

@@ -1 +1,3 @@
-export { Splitter } from './chunk-IZHH6CVY.js';
+export { Splitter } from './chunk-J5UEQ3ZQ.js';
+import './chunk-DRDDQCDD.js';
+import './chunk-ULTDRMGN.js';

package/dist/{StatusBar-FJKEEPXU.css → StatusBar-TCGR3LXP.css}

@@ -5,9 +5,9 @@
   position: relative;
   height: 26px;
   padding: 0 10px;
-  background: var(--bg);
-  border-top: 1px solid var(--divider);
-  color: var(--fg-muted);
+  background: var(--lmn-status-bar-bg, var(--bg));
+  border-top: 1px solid var(--lmn-status-bar-divider, var(--divider));
+  color: var(--lmn-status-bar-fg-muted, var(--fg-muted));
   font-size: 11.5px;
   user-select: none;
   flex-shrink: 0;
@@ -42,13 +42,27 @@
   white-space: nowrap;
 }
 .statusbar-item.clickable { cursor: pointer; }
-.statusbar-item.clickable:hover { background: var(--bg-sunken); color: var(--fg); }
+.statusbar-item.clickable:hover { background: var(--lmn-status-bar-bg-sunken, var(--bg-sunken)); color: var(--lmn-status-bar-fg, var(--fg)); }
 
-.statusbar-item.tone-muted   { color: var(--fg-subtle); }
-.statusbar-item.tone-accent  { color: var(--accent-ink); }
-.statusbar-item.tone-success { color: var(--success); }
-.statusbar-item.tone-warning { color: var(--warning); }
-.statusbar-item.tone-danger  { color: var(--danger); }
+.statusbar-item.tone-muted   { color: var(--lmn-status-bar-fg-subtle, var(--fg-subtle)); }
+.statusbar-item.tone-accent  { color: var(--lmn-status-bar-accent-ink, var(--accent-ink)); }
+.statusbar-item.tone-success { color: var(--lmn-status-bar-success, var(--success)); }
+.statusbar-item.tone-warning { color: var(--lmn-status-bar-warning, var(--warning)); }
+.statusbar-item.tone-danger  { color: var(--lmn-status-bar-danger, var(--danger)); }
 
 .statusbar-item-icon { display: inline-flex; flex-shrink: 0; }
 .statusbar-item-label { overflow: hidden; text-overflow: ellipsis; }
+
+@media (max-width: 640px) {
+  .statusbar-section.center {
+    position: static;
+    min-width: 0;
+    margin-inline: auto;
+    transform: none;
+  }
+  .statusbar-section.left,
+  .statusbar-section.right {
+    max-width: 38%;
+    overflow: hidden;
+  }
+}

package/dist/StatusBar.cjs

@@ -1,14 +1,16 @@
 'use strict';
 
-var chunkPOU3W5J3_cjs = require('./chunk-POU3W5J3.cjs');
+var chunkU5YYOOLC_cjs = require('./chunk-U5YYOOLC.cjs');
+require('./chunk-NRJXZPZR.cjs');
+require('./chunk-EE5KXDRK.cjs');
 
 
 
 Object.defineProperty(exports, "StatusBar", {
   enumerable: true,
-  get: function () { return chunkPOU3W5J3_cjs.StatusBar; }
+  get: function () { return chunkU5YYOOLC_cjs.StatusBar; }
 });
 Object.defineProperty(exports, "StatusBarItem", {
   enumerable: true,
-  get: function () { return chunkPOU3W5J3_cjs.StatusBarItem; }
+  get: function () { return chunkU5YYOOLC_cjs.StatusBarItem; }
 });

package/dist/StatusBar.d.cts

@@ -1,6 +1,7 @@
 import * as React from 'react';
+import { f as ComponentThemeProps } from './componentThemeTypes-Jt4B5aU8.cjs';
 
-interface StatusBarItemProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "children"> {
+interface StatusBarItemProps extends Omit<React.HTMLAttributes<HTMLElement>, "children">, ComponentThemeProps {
     /** Optional leading node (usually an `<Icon />`). */
     icon?: React.ReactNode;
     /** Visual tone — shifts color only. */
@@ -9,9 +10,8 @@ interface StatusBarItemProps extends Omit<React.HTMLAttributes<HTMLDivElement>,
     onClick?: (e: React.MouseEvent<HTMLDivElement | HTMLButtonElement>) => void;
     children?: React.ReactNode;
 }
-/** `StatusBar.Item` — one inline slot. Put icon + text inside. */
 declare const StatusBarItem: React.ForwardRefExoticComponent<StatusBarItemProps & React.RefAttributes<HTMLElement>>;
-interface StatusBarProps extends React.HTMLAttributes<HTMLDivElement> {
+interface StatusBarProps extends React.HTMLAttributes<HTMLDivElement>, ComponentThemeProps {
     /** Left-aligned slot. */
     left?: React.ReactNode;
     /** Center slot — absolutely positioned, stays centered regardless of side widths. */
@@ -20,20 +20,8 @@ interface StatusBarProps extends React.HTMLAttributes<HTMLDivElement> {
     right?: React.ReactNode;
     children?: React.ReactNode;
 }
-/**
- * `StatusBar` — thin bottom bar for app state (branch, line/col, sync, etc.).
- * Pair with `TitleBar` to bracket the window chrome.
- *
- * @example
- * ```tsx
- * <StatusBar
- *   left={<StatusBar.Item icon={<Icon name="check" size={12} />} tone="success">Ready</StatusBar.Item>}
- *   right={<StatusBar.Item tone="muted">UTF-8</StatusBar.Item>}
- * />
- * ```
- */
-declare const StatusBarBase: React.ForwardRefExoticComponent<StatusBarProps & React.RefAttributes<HTMLDivElement>>;
-declare const StatusBar: typeof StatusBarBase & {
+declare const ThemedStatusBar: React.ForwardRefExoticComponent<StatusBarProps & React.RefAttributes<HTMLDivElement>>;
+declare const StatusBar: typeof ThemedStatusBar & {
     Item: typeof StatusBarItem;
 };
 

package/dist/StatusBar.d.ts

@@ -1,6 +1,7 @@
 import * as React from 'react';
+import { f as ComponentThemeProps } from './componentThemeTypes-Jt4B5aU8.js';
 
-interface StatusBarItemProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "children"> {
+interface StatusBarItemProps extends Omit<React.HTMLAttributes<HTMLElement>, "children">, ComponentThemeProps {
     /** Optional leading node (usually an `<Icon />`). */
     icon?: React.ReactNode;
     /** Visual tone — shifts color only. */
@@ -9,9 +10,8 @@ interface StatusBarItemProps extends Omit<React.HTMLAttributes<HTMLDivElement>,
     onClick?: (e: React.MouseEvent<HTMLDivElement | HTMLButtonElement>) => void;
     children?: React.ReactNode;
 }
-/** `StatusBar.Item` — one inline slot. Put icon + text inside. */
 declare const StatusBarItem: React.ForwardRefExoticComponent<StatusBarItemProps & React.RefAttributes<HTMLElement>>;
-interface StatusBarProps extends React.HTMLAttributes<HTMLDivElement> {
+interface StatusBarProps extends React.HTMLAttributes<HTMLDivElement>, ComponentThemeProps {
     /** Left-aligned slot. */
     left?: React.ReactNode;
     /** Center slot — absolutely positioned, stays centered regardless of side widths. */
@@ -20,20 +20,8 @@ interface StatusBarProps extends React.HTMLAttributes<HTMLDivElement> {
     right?: React.ReactNode;
     children?: React.ReactNode;
 }
-/**
- * `StatusBar` — thin bottom bar for app state (branch, line/col, sync, etc.).
- * Pair with `TitleBar` to bracket the window chrome.
- *
- * @example
- * ```tsx
- * <StatusBar
- *   left={<StatusBar.Item icon={<Icon name="check" size={12} />} tone="success">Ready</StatusBar.Item>}
- *   right={<StatusBar.Item tone="muted">UTF-8</StatusBar.Item>}
- * />
- * ```
- */
-declare const StatusBarBase: React.ForwardRefExoticComponent<StatusBarProps & React.RefAttributes<HTMLDivElement>>;
-declare const StatusBar: typeof StatusBarBase & {
+declare const ThemedStatusBar: React.ForwardRefExoticComponent<StatusBarProps & React.RefAttributes<HTMLDivElement>>;
+declare const StatusBar: typeof ThemedStatusBar & {
     Item: typeof StatusBarItem;
 };
 

package/dist/StatusBar.js

@@ -1 +1,3 @@
-export { StatusBar, StatusBarItem } from './chunk-TYLDISRK.js';
+export { StatusBar, StatusBarItem } from './chunk-YKHIIC7M.js';
+import './chunk-DRDDQCDD.js';
+import './chunk-ULTDRMGN.js';

package/dist/{Surface-UDDN3DGL.css → Surface-CTN775GD.css}

@@ -3,23 +3,23 @@
   position: relative;
   box-sizing: border-box;
   min-width: 0;
-  color: var(--fg);
-  background: var(--bg);
+  color: var(--lmn-surface-fg, var(--fg));
+  background: var(--lmn-surface-bg, var(--bg));
   border-radius: var(--r-lg);
 }
 
-.surface.tone-raised { background: var(--bg-raised); }
-.surface.tone-sunken { background: var(--bg-sunken); }
+.surface.tone-raised { background: var(--lmn-surface-bg-raised, var(--bg-raised)); }
+.surface.tone-sunken { background: var(--lmn-surface-bg-sunken, var(--bg-sunken)); }
 .surface.tone-accent {
-  color: var(--accent-ink);
-  background: var(--accent-soft);
+  color: var(--lmn-surface-accent-ink, var(--accent-ink));
+  background: var(--lmn-surface-accent-soft, var(--accent-soft));
 }
 
 .surface.plain { box-shadow: none; }
-.surface.raised { box-shadow: var(--neu-shadow-panel); }
-.surface.sunken { box-shadow: var(--neu-shadow-inset-strong); }
-.surface.floating { box-shadow: var(--neu-shadow-float); }
-.surface.bordered { border: 1px solid var(--border); }
+.surface.raised { box-shadow: var(--lmn-surface-neu-shadow-panel, var(--neu-shadow-panel)); }
+.surface.sunken { box-shadow: var(--lmn-surface-neu-shadow-inset-strong, var(--neu-shadow-inset-strong)); }
+.surface.floating { box-shadow: var(--lmn-surface-neu-shadow-float, var(--neu-shadow-float)); }
+.surface.bordered { border: 1px solid var(--lmn-surface-border, var(--border)); }
 
 .surface.pad-none { padding: 0; }
 .surface.pad-sm { padding: var(--gap-3); }

package/dist/Surface.cjs

@@ -1,16 +1,17 @@
 'use strict';
 
-var chunk7QXP6DXC_cjs = require('./chunk-7QXP6DXC.cjs');
-require('./chunk-6EOSMK34.cjs');
-require('./chunk-PKNRTFNE.cjs');
+var chunkLG62MPMU_cjs = require('./chunk-LG62MPMU.cjs');
+require('./chunk-G5LCOBOT.cjs');
+require('./chunk-NRJXZPZR.cjs');
+require('./chunk-EE5KXDRK.cjs');
 
 
 
 Object.defineProperty(exports, "SURFACE_THEME_PRESETS", {
   enumerable: true,
-  get: function () { return chunk7QXP6DXC_cjs.SURFACE_THEME_PRESETS; }
+  get: function () { return chunkLG62MPMU_cjs.SURFACE_THEME_PRESETS; }
 });
 Object.defineProperty(exports, "Surface", {
   enumerable: true,
-  get: function () { return chunk7QXP6DXC_cjs.Surface; }
+  get: function () { return chunkLG62MPMU_cjs.Surface; }
 });

package/dist/Surface.d.cts

@@ -1,5 +1,6 @@
 import * as React from 'react';
-import { ThemePreset, ThemeMode, ThemeBaseMode, AccentKey, CustomAccentInput, DensityMode, FontConfig, ThemeTokens, ThemePresets } from './Theme.cjs';
+import { f as ThemePreset, e as ThemeMode, b as DensityMode, c as FontConfig, g as ThemePresets } from './Theme-uQq2B0Yk.cjs';
+import { T as ThemeBaseMode, A as AccentKey, h as CustomAccentInput, l as ThemeTokens, i as ThemeColorOverrides, e as ComponentThemeOverrides, C as ComponentTheme } from './componentThemeTypes-Jt4B5aU8.cjs';
 
 type SurfacePreset = "inherit" | "mist" | "porcelain" | "graphite" | "ember";
 type SurfaceTone = "base" | "raised" | "sunken" | "accent";
@@ -31,6 +32,8 @@ interface SurfaceProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "color
     colorScheme?: ThemeBaseMode;
     /** Local accent palette or preset key. */
     accent?: AccentKey | CustomAccentInput;
+    /** 从基色生成一套完整的局部拟态色板。 */
+    baseColor?: string;
     /** Local density. */
     density?: DensityMode;
     /** Local shadow strength, 1..10. */
@@ -41,6 +44,12 @@ interface SurfaceProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "color
     font?: FontConfig;
     /** Local token overrides. */
     tokens?: ThemeTokens;
+    /** 对局部派生色板进行精确覆盖。 */
+    colors?: ThemeColorOverrides;
+    /** 对 Surface 后代中的指定组件类型应用覆盖。 */
+    components?: ComponentThemeOverrides;
+    /** Surface 局部主题简写，始终作为 subtree 主题使用。 */
+    theme?: ComponentTheme;
     /** Local custom mode registry. */
     themes?: ThemePresets;
     children?: React.ReactNode;

package/dist/Surface.d.ts

@@ -1,5 +1,6 @@
 import * as React from 'react';
-import { ThemePreset, ThemeMode, ThemeBaseMode, AccentKey, CustomAccentInput, DensityMode, FontConfig, ThemeTokens, ThemePresets } from './Theme.js';
+import { f as ThemePreset, e as ThemeMode, b as DensityMode, c as FontConfig, g as ThemePresets } from './Theme-CLedeJ_C.js';
+import { T as ThemeBaseMode, A as AccentKey, h as CustomAccentInput, l as ThemeTokens, i as ThemeColorOverrides, e as ComponentThemeOverrides, C as ComponentTheme } from './componentThemeTypes-Jt4B5aU8.js';
 
 type SurfacePreset = "inherit" | "mist" | "porcelain" | "graphite" | "ember";
 type SurfaceTone = "base" | "raised" | "sunken" | "accent";
@@ -31,6 +32,8 @@ interface SurfaceProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "color
     colorScheme?: ThemeBaseMode;
     /** Local accent palette or preset key. */
     accent?: AccentKey | CustomAccentInput;
+    /** 从基色生成一套完整的局部拟态色板。 */
+    baseColor?: string;
     /** Local density. */
     density?: DensityMode;
     /** Local shadow strength, 1..10. */
@@ -41,6 +44,12 @@ interface SurfaceProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "color
     font?: FontConfig;
     /** Local token overrides. */
     tokens?: ThemeTokens;
+    /** 对局部派生色板进行精确覆盖。 */
+    colors?: ThemeColorOverrides;
+    /** 对 Surface 后代中的指定组件类型应用覆盖。 */
+    components?: ComponentThemeOverrides;
+    /** Surface 局部主题简写，始终作为 subtree 主题使用。 */
+    theme?: ComponentTheme;
     /** Local custom mode registry. */
     themes?: ThemePresets;
     children?: React.ReactNode;

package/dist/Surface.js

@@ -1,3 +1,4 @@
-export { SURFACE_THEME_PRESETS, Surface } from './chunk-JFL2WMJZ.js';
-import './chunk-6SPMHY54.js';
-import './chunk-GNV6W4BN.js';
+export { SURFACE_THEME_PRESETS, Surface } from './chunk-DU2DSERH.js';
+import './chunk-TSL3F2K3.js';
+import './chunk-DRDDQCDD.js';
+import './chunk-ULTDRMGN.js';

package/dist/{Switch-COAQIOMH.css → Switch-TATU3LPB.css}

@@ -6,11 +6,19 @@
   align-items: center;
   gap: 10px;
   font-size: 13px;
-  color: var(--fg);
+  color: var(--lmn-switch-fg, var(--fg));
   cursor: pointer;
   user-select: none;
 }
 .switch.disabled { opacity: 0.5; cursor: not-allowed; }
+.switch-native {
+  position: absolute;
+  width: 1px;
+  height: 1px;
+  opacity: 0;
+  pointer-events: none;
+}
+.switch:focus-within .switch-track { outline: 2px solid var(--lmn-switch-accent, var(--accent)); outline-offset: 2px; }
 .switch-track {
   position: relative;
   width: var(--w);
@@ -18,8 +26,8 @@
   border: none;
   padding: 0;
   border-radius: 999px;
-  background: var(--bg);
-  box-shadow: var(--neu-shadow-inset);
+  background: var(--lmn-switch-bg, var(--bg));
+  box-shadow: var(--lmn-switch-neu-shadow-inset, var(--neu-shadow-inset));
   cursor: inherit;
   flex-shrink: 0;
   transition: all var(--dur) var(--ease);
@@ -38,15 +46,15 @@
   width: calc(var(--h) - 6px);
   height: calc(var(--h) - 6px);
   border-radius: 999px;
-  background: var(--bg-raised);
-  box-shadow: var(--neu-shadow-control);
+  background: var(--lmn-switch-bg-raised, var(--bg-raised));
+  box-shadow: var(--lmn-switch-neu-shadow-control, var(--neu-shadow-control));
   transition: all var(--dur) var(--ease);
   z-index: 1;
 }
 .switch.on .switch-thumb {
   transform: translateX(calc(var(--w) - var(--h)));
-  background: var(--accent);
-  box-shadow: 0 2px 8px var(--accent-glow), 0 0 0 1px color-mix(in oklch, var(--accent) 40%, transparent);
+  background: var(--lmn-switch-accent, var(--accent));
+  box-shadow: 0 2px 8px var(--lmn-switch-accent-glow, var(--accent-glow)), 0 0 0 1px color-mix(in oklch, var(--lmn-switch-accent, var(--accent)) 40%, transparent);
 }
 
 /* Inline content (checkedChildren / unCheckedChildren) */
@@ -85,7 +93,7 @@
 .switch-inner-off {
   right: 8px;
   left: calc(var(--h) - 2px);
-  color: var(--fg-muted);
+  color: var(--lmn-switch-fg-muted, var(--fg-muted));
   opacity: 1;
   transform: translateX(0);
 }

package/dist/Switch.cjs

@@ -1,10 +1,12 @@
 'use strict';
 
-var chunkMYW7LNB2_cjs = require('./chunk-MYW7LNB2.cjs');
+var chunkWROF2PVG_cjs = require('./chunk-WROF2PVG.cjs');
+require('./chunk-NRJXZPZR.cjs');
+require('./chunk-EE5KXDRK.cjs');
 
 
 
 Object.defineProperty(exports, "Switch", {
   enumerable: true,
-  get: function () { return chunkMYW7LNB2_cjs.Switch; }
+  get: function () { return chunkWROF2PVG_cjs.Switch; }
 });

package/dist/Switch.d.cts

@@ -1,6 +1,7 @@
 import * as React from 'react';
+import { f as ComponentThemeProps } from './componentThemeTypes-Jt4B5aU8.cjs';
 
-interface SwitchProps extends Omit<React.LabelHTMLAttributes<HTMLLabelElement>, "onChange" | "children" | "id"> {
+interface SwitchProps extends Omit<React.LabelHTMLAttributes<HTMLLabelElement>, "onChange" | "children" | "id">, ComponentThemeProps {
     checked?: boolean;
     defaultChecked?: boolean;
     onChange?: (checked: boolean) => void;
@@ -13,10 +14,15 @@ interface SwitchProps extends Omit<React.LabelHTMLAttributes<HTMLLabelElement>,
     unCheckedChildren?: React.ReactNode;
     className?: string;
     id?: string;
+    /** 提交原生表单时使用的字段名。 */
+    name?: string;
+    /** 开启时提交给原生表单的字段值，默认为 `"on"`。 */
+    value?: string;
+    /** 是否要求开关必须开启。 */
+    required?: boolean;
+    /** 关联的原生 form 元素 id。 */
+    form?: string;
 }
-/**
- * `Switch` — on/off toggle. Controlled or uncontrolled.
- */
 declare const Switch: React.ForwardRefExoticComponent<SwitchProps & React.RefAttributes<HTMLLabelElement>>;
 
 export { Switch, type SwitchProps };

package/dist/Switch.d.ts

@@ -1,6 +1,7 @@
 import * as React from 'react';
+import { f as ComponentThemeProps } from './componentThemeTypes-Jt4B5aU8.js';
 
-interface SwitchProps extends Omit<React.LabelHTMLAttributes<HTMLLabelElement>, "onChange" | "children" | "id"> {
+interface SwitchProps extends Omit<React.LabelHTMLAttributes<HTMLLabelElement>, "onChange" | "children" | "id">, ComponentThemeProps {
     checked?: boolean;
     defaultChecked?: boolean;
     onChange?: (checked: boolean) => void;
@@ -13,10 +14,15 @@ interface SwitchProps extends Omit<React.LabelHTMLAttributes<HTMLLabelElement>,
     unCheckedChildren?: React.ReactNode;
     className?: string;
     id?: string;
+    /** 提交原生表单时使用的字段名。 */
+    name?: string;
+    /** 开启时提交给原生表单的字段值，默认为 `"on"`。 */
+    value?: string;
+    /** 是否要求开关必须开启。 */
+    required?: boolean;
+    /** 关联的原生 form 元素 id。 */
+    form?: string;
 }
-/**
- * `Switch` — on/off toggle. Controlled or uncontrolled.
- */
 declare const Switch: React.ForwardRefExoticComponent<SwitchProps & React.RefAttributes<HTMLLabelElement>>;
 
 export { Switch, type SwitchProps };

package/dist/Switch.js

@@ -1 +1,3 @@
-export { Switch } from './chunk-PU7VXDAS.js';
+export { Switch } from './chunk-LEDESWNL.js';
+import './chunk-DRDDQCDD.js';
+import './chunk-ULTDRMGN.js';