@fangxinyan/lumina 0.6.18 → 0.7.0

package/dist/Progress.cjs

@@ -1,10 +1,12 @@
 'use strict';
 
-var chunkX7XP6GEI_cjs = require('./chunk-X7XP6GEI.cjs');
+var chunkYAYSXZZZ_cjs = require('./chunk-YAYSXZZZ.cjs');
+require('./chunk-NRJXZPZR.cjs');
+require('./chunk-EE5KXDRK.cjs');
 
 
 
 Object.defineProperty(exports, "Progress", {
   enumerable: true,
-  get: function () { return chunkX7XP6GEI_cjs.Progress; }
+  get: function () { return chunkYAYSXZZZ_cjs.Progress; }
 });

package/dist/Progress.d.cts

@@ -1,6 +1,7 @@
 import * as React from 'react';
+import { f as ComponentThemeProps } from './componentThemeTypes-Jt4B5aU8.cjs';
 
-interface ProgressProps extends React.HTMLAttributes<HTMLDivElement> {
+interface ProgressProps extends React.HTMLAttributes<HTMLDivElement>, ComponentThemeProps {
     /** 0–100 */
     value: number;
     max?: number;
@@ -10,9 +11,10 @@ interface ProgressProps extends React.HTMLAttributes<HTMLDivElement> {
     /** Custom fill color. Overrides `tone`. */
     color?: string;
     size?: "sm" | "md" | "lg";
+    /** 不确定进度；隐藏具体数值并显示循环动画。 */
+    indeterminate?: boolean;
     className?: string;
 }
-/** `Progress` — horizontal progress bar with neumorphic track. */
 declare const Progress: React.ForwardRefExoticComponent<ProgressProps & React.RefAttributes<HTMLDivElement>>;
 
 export { Progress, type ProgressProps };

package/dist/Progress.d.ts

@@ -1,6 +1,7 @@
 import * as React from 'react';
+import { f as ComponentThemeProps } from './componentThemeTypes-Jt4B5aU8.js';
 
-interface ProgressProps extends React.HTMLAttributes<HTMLDivElement> {
+interface ProgressProps extends React.HTMLAttributes<HTMLDivElement>, ComponentThemeProps {
     /** 0–100 */
     value: number;
     max?: number;
@@ -10,9 +11,10 @@ interface ProgressProps extends React.HTMLAttributes<HTMLDivElement> {
     /** Custom fill color. Overrides `tone`. */
     color?: string;
     size?: "sm" | "md" | "lg";
+    /** 不确定进度；隐藏具体数值并显示循环动画。 */
+    indeterminate?: boolean;
     className?: string;
 }
-/** `Progress` — horizontal progress bar with neumorphic track. */
 declare const Progress: React.ForwardRefExoticComponent<ProgressProps & React.RefAttributes<HTMLDivElement>>;
 
 export { Progress, type ProgressProps };

package/dist/Progress.js

@@ -1 +1,3 @@
-export { Progress } from './chunk-KMPFESEV.js';
+export { Progress } from './chunk-HQFKXTX6.js';
+import './chunk-DRDDQCDD.js';
+import './chunk-ULTDRMGN.js';

package/dist/{Radio-IQKASYDF.css → Radio-RL7232MZ.css}

@@ -6,25 +6,33 @@
   cursor: pointer;
   user-select: none;
   font-size: 13px;
-  color: var(--fg);
+  color: var(--lmn-radio-fg, var(--fg));
 }
 .radio.disabled { opacity: 0.5; cursor: not-allowed; }
+.radio-native {
+  position: absolute;
+  width: 1px;
+  height: 1px;
+  opacity: 0;
+  pointer-events: none;
+}
+.radio:focus-within .radio-dot { outline: 2px solid var(--lmn-radio-accent, var(--accent)); outline-offset: 2px; }
 
 .radio-dot {
   width: 20px; height: 20px;
   border: none;
   padding: 0;
   border-radius: 999px;
-  background: var(--bg);
-  box-shadow: var(--neu-shadow-inset);
+  background: var(--lmn-radio-bg, var(--bg));
+  box-shadow: var(--lmn-radio-neu-shadow-inset, var(--neu-shadow-inset));
   cursor: inherit;
   position: relative;
   flex-shrink: 0;
   transition: all var(--dur) var(--ease);
 }
 .radio.checked .radio-dot {
-  background: var(--accent);
-  box-shadow: var(--neu-shadow-control), 0 2px 8px var(--accent-glow);
+  background: var(--lmn-radio-accent, var(--accent));
+  box-shadow: var(--lmn-radio-neu-shadow-control, var(--neu-shadow-control)), 0 2px 8px var(--lmn-radio-accent-glow, var(--accent-glow));
 }
 .radio.checked .radio-dot::after {
   content: "";
@@ -33,7 +41,7 @@
   transform: translate(-50%, -50%);
   width: 8px; height: 8px;
   border-radius: 999px;
-  background: var(--bg);
+  background: var(--lmn-radio-bg, var(--bg));
 }
 
 .radio-group { display: flex; gap: 14px; }
@@ -45,8 +53,8 @@
   display: inline-flex;
   padding: 4px;
   border-radius: var(--r-md);
-  background: var(--bg);
-  box-shadow: var(--neu-shadow-inset);
+  background: var(--lmn-radio-bg, var(--bg));
+  box-shadow: var(--lmn-radio-neu-shadow-inset, var(--neu-shadow-inset));
   gap: 2px;
   flex-wrap: nowrap;
 }
@@ -57,15 +65,15 @@
   height: 32px;
   padding: 6px 14px;
   border-radius: calc(var(--r-md) - 4px);
-  color: var(--fg-muted);
+  color: var(--lmn-radio-fg-muted, var(--fg-muted));
   font-size: 12px;
   gap: 6px;
   transition: all var(--dur-fast) var(--ease);
 }
 
-.radio-group.segmented .radio:hover { color: var(--fg); }
+.radio-group.segmented .radio:hover { color: var(--lmn-radio-fg, var(--fg)); }
 .radio-group.segmented .radio.checked {
-  color: var(--accent-ink);
+  color: var(--lmn-radio-accent-ink, var(--accent-ink));
   font-weight: 600;
 }
 .radio-group.segmented .radio-dot { display: none; }
@@ -80,8 +88,8 @@
   bottom: 4px;
   left: 0;
   border-radius: calc(var(--r-md) - 4px);
-  background: var(--bg);
-  box-shadow: var(--neu-shadow-control);
+  background: var(--lmn-radio-bg, var(--bg));
+  box-shadow: var(--lmn-radio-neu-shadow-control, var(--neu-shadow-control));
   pointer-events: none;
   transition:
     transform var(--dur-slow) var(--ease),

package/dist/Radio.cjs

@@ -1,14 +1,16 @@
 'use strict';
 
-var chunkPSQ3HNZP_cjs = require('./chunk-PSQ3HNZP.cjs');
+var chunkE66PSVBU_cjs = require('./chunk-E66PSVBU.cjs');
+require('./chunk-NRJXZPZR.cjs');
+require('./chunk-EE5KXDRK.cjs');
 
 
 
 Object.defineProperty(exports, "Radio", {
   enumerable: true,
-  get: function () { return chunkPSQ3HNZP_cjs.Radio; }
+  get: function () { return chunkE66PSVBU_cjs.Radio; }
 });
 Object.defineProperty(exports, "RadioGroup", {
   enumerable: true,
-  get: function () { return chunkPSQ3HNZP_cjs.RadioGroup; }
+  get: function () { return chunkE66PSVBU_cjs.RadioGroup; }
 });

package/dist/Radio.d.cts

@@ -1,6 +1,7 @@
 import * as React from 'react';
+import { f as ComponentThemeProps } from './componentThemeTypes-Jt4B5aU8.cjs';
 
-interface RadioProps extends Omit<React.LabelHTMLAttributes<HTMLLabelElement>, "onChange" | "children" | "id"> {
+interface RadioProps extends Omit<React.LabelHTMLAttributes<HTMLLabelElement>, "onChange" | "children" | "id">, ComponentThemeProps {
     checked?: boolean;
     defaultChecked?: boolean;
     onChange?: (checked: boolean) => void;
@@ -8,28 +9,40 @@ interface RadioProps extends Omit<React.LabelHTMLAttributes<HTMLLabelElement>, "
     label?: React.ReactNode;
     className?: string;
     id?: string;
+    /** 原生单选分组名；同一文档中同名非受控 Radio 会保持互斥。 */
+    name?: string;
+    /** 提交原生表单时使用的字段值。 */
+    value?: string | number;
+    /** 是否要求该单选分组至少选中一项。 */
+    required?: boolean;
+    /** 关联的原生 form 元素 id。 */
+    form?: string;
 }
-declare const RadioRoot: React.ForwardRefExoticComponent<RadioProps & React.RefAttributes<HTMLLabelElement>>;
+declare const ThemedRadio: React.ForwardRefExoticComponent<RadioProps & React.RefAttributes<HTMLLabelElement>>;
 interface RadioOption<T extends string | number = string> {
     value: T;
     label: React.ReactNode;
     disabled?: boolean;
 }
-interface RadioGroupProps<T extends string | number = string> extends Omit<React.HTMLAttributes<HTMLDivElement>, "onChange" | "defaultValue"> {
+interface RadioGroupProps<T extends string | number = string> extends Omit<React.HTMLAttributes<HTMLDivElement>, "onChange" | "defaultValue">, ComponentThemeProps {
     options: RadioOption<T>[];
     value?: T;
     defaultValue?: T;
     onChange?: (value: T) => void;
+    /** 原生单选分组名；省略时自动生成稳定名称。 */
     name?: string;
+    /** 是否要求该组选中一项。 */
+    required?: boolean;
+    /** 关联的原生 form 元素 id。 */
+    form?: string;
     direction?: "vertical" | "horizontal";
     variant?: "default" | "segmented";
     size?: "sm" | "md" | "lg";
     className?: string;
 }
 type RadioGroupComponent = <T extends string | number = string>(props: RadioGroupProps<T> & React.RefAttributes<HTMLDivElement>) => React.ReactElement | null;
-/** `RadioGroup` — mutually exclusive options. */
 declare const RadioGroup: RadioGroupComponent;
-declare const Radio: typeof RadioRoot & {
+declare const Radio: typeof ThemedRadio & {
     Group: typeof RadioGroup;
 };
 

package/dist/Radio.d.ts

@@ -1,6 +1,7 @@
 import * as React from 'react';
+import { f as ComponentThemeProps } from './componentThemeTypes-Jt4B5aU8.js';
 
-interface RadioProps extends Omit<React.LabelHTMLAttributes<HTMLLabelElement>, "onChange" | "children" | "id"> {
+interface RadioProps extends Omit<React.LabelHTMLAttributes<HTMLLabelElement>, "onChange" | "children" | "id">, ComponentThemeProps {
     checked?: boolean;
     defaultChecked?: boolean;
     onChange?: (checked: boolean) => void;
@@ -8,28 +9,40 @@ interface RadioProps extends Omit<React.LabelHTMLAttributes<HTMLLabelElement>, "
     label?: React.ReactNode;
     className?: string;
     id?: string;
+    /** 原生单选分组名；同一文档中同名非受控 Radio 会保持互斥。 */
+    name?: string;
+    /** 提交原生表单时使用的字段值。 */
+    value?: string | number;
+    /** 是否要求该单选分组至少选中一项。 */
+    required?: boolean;
+    /** 关联的原生 form 元素 id。 */
+    form?: string;
 }
-declare const RadioRoot: React.ForwardRefExoticComponent<RadioProps & React.RefAttributes<HTMLLabelElement>>;
+declare const ThemedRadio: React.ForwardRefExoticComponent<RadioProps & React.RefAttributes<HTMLLabelElement>>;
 interface RadioOption<T extends string | number = string> {
     value: T;
     label: React.ReactNode;
     disabled?: boolean;
 }
-interface RadioGroupProps<T extends string | number = string> extends Omit<React.HTMLAttributes<HTMLDivElement>, "onChange" | "defaultValue"> {
+interface RadioGroupProps<T extends string | number = string> extends Omit<React.HTMLAttributes<HTMLDivElement>, "onChange" | "defaultValue">, ComponentThemeProps {
     options: RadioOption<T>[];
     value?: T;
     defaultValue?: T;
     onChange?: (value: T) => void;
+    /** 原生单选分组名；省略时自动生成稳定名称。 */
     name?: string;
+    /** 是否要求该组选中一项。 */
+    required?: boolean;
+    /** 关联的原生 form 元素 id。 */
+    form?: string;
     direction?: "vertical" | "horizontal";
     variant?: "default" | "segmented";
     size?: "sm" | "md" | "lg";
     className?: string;
 }
 type RadioGroupComponent = <T extends string | number = string>(props: RadioGroupProps<T> & React.RefAttributes<HTMLDivElement>) => React.ReactElement | null;
-/** `RadioGroup` — mutually exclusive options. */
 declare const RadioGroup: RadioGroupComponent;
-declare const Radio: typeof RadioRoot & {
+declare const Radio: typeof ThemedRadio & {
     Group: typeof RadioGroup;
 };
 

package/dist/Radio.js

@@ -1 +1,3 @@
-export { Radio, RadioGroup } from './chunk-KYV75JPQ.js';
+export { Radio, RadioGroup } from './chunk-QDY56GGO.js';
+import './chunk-DRDDQCDD.js';
+import './chunk-ULTDRMGN.js';

package/dist/{Select-YZ2NUJSX.css → Select-TU37MAHZ.css}

@@ -13,14 +13,14 @@
   padding: 0 36px 0 var(--ctrl-pad-x);
   border: none;
   border-radius: var(--r-md);
-  background: var(--bg);
-  box-shadow: var(--neu-shadow-control);
+  background: var(--lmn-select-bg, var(--bg));
+  box-shadow: var(--lmn-select-neu-shadow-control, var(--neu-shadow-control));
   display: inline-flex;
   align-items: center;
   gap: 8px;
   font-size: var(--fs-md);
   font-family: inherit;
-  color: var(--fg);
+  color: var(--lmn-select-fg, var(--fg));
   cursor: pointer;
   transition: all var(--dur-fast) var(--ease);
   position: relative;
@@ -64,25 +64,25 @@
   height: 18px;
 }
 .select.invalid .select-trigger {
-  box-shadow: var(--neu-shadow-control), 0 0 0 2px color-mix(in oklch, var(--danger) 30%, transparent);
+  box-shadow: var(--lmn-select-neu-shadow-control, var(--neu-shadow-control)), 0 0 0 2px color-mix(in oklch, var(--lmn-select-danger, var(--danger)) 30%, transparent);
 }
 .select.invalid.open .select-trigger {
-  box-shadow: var(--neu-shadow-inset), 0 0 0 2px color-mix(in oklch, var(--danger) 30%, transparent);
+  box-shadow: var(--lmn-select-neu-shadow-inset, var(--neu-shadow-inset)), 0 0 0 2px color-mix(in oklch, var(--lmn-select-danger, var(--danger)) 30%, transparent);
 }
 .select.sm .select-trigger { height: var(--ctrl-h-sm); padding: 0 32px 0 var(--ctrl-pad-x-sm); font-size: var(--fs-sm); border-radius: var(--r-sm); }
 .select.lg .select-trigger { height: var(--field-h-lg); padding: 0 36px 0 var(--ctrl-pad-x); font-size: var(--fs-lg); border-radius: var(--r-lg); }
-.select-trigger:hover { color: var(--accent-ink); }
-.select.open .select-trigger { box-shadow: var(--neu-shadow-inset); color: var(--accent-ink); }
-.select-trigger .placeholder { color: var(--fg-subtle); }
+.select-trigger:hover { color: var(--lmn-select-accent-ink, var(--accent-ink)); }
+.select.open .select-trigger { box-shadow: var(--lmn-select-neu-shadow-inset, var(--neu-shadow-inset)); color: var(--lmn-select-accent-ink, var(--accent-ink)); }
+.select-trigger .placeholder { color: var(--lmn-select-fg-subtle, var(--fg-subtle)); }
 .select-caret {
   position: absolute;
   right: 12px; top: 50%;
   transform: translateY(-50%);
-  color: var(--fg-subtle);
+  color: var(--lmn-select-fg-subtle, var(--fg-subtle));
   transition: transform var(--dur) var(--ease);
   flex-shrink: 0;
 }
-.select.open .select-caret { transform: translateY(-50%) rotate(180deg); color: var(--accent); }
+.select.open .select-caret { transform: translateY(-50%) rotate(180deg); color: var(--lmn-select-accent, var(--accent)); }
 
 /* Multi-select trigger: variable height, tags inside, vertically centered */
 .select.multi .select-trigger {
@@ -120,26 +120,29 @@
   width: 20px;
   height: 20px;
   border-radius: 999px;
-  background: var(--bg);
-  box-shadow: var(--neu-shadow-control);
+  background: var(--lmn-select-bg, var(--bg));
+  border: none;
+  padding: 0;
+  font: inherit;
+  box-shadow: var(--lmn-select-neu-shadow-control, var(--neu-shadow-control));
   display: inline-grid;
   place-items: center;
   cursor: pointer;
-  color: var(--fg-subtle);
+  color: var(--lmn-select-fg-subtle, var(--fg-subtle));
   opacity: 0;
   transition: all var(--dur-fast) var(--ease);
   z-index: 1;
 }
 .select:hover .select-clear { opacity: 1; }
-.select-clear:hover { color: var(--accent-ink); box-shadow: var(--neu-shadow-inset); }
+.select-clear:hover { color: var(--lmn-select-accent-ink, var(--accent-ink)); box-shadow: var(--lmn-select-neu-shadow-inset, var(--neu-shadow-inset)); }
 
 /* Multi-select menu: leading checkbox per item */
 .menu-check {
   width: 16px;
   height: 16px;
   border-radius: 5px;
-  background: var(--bg);
-  box-shadow: var(--neu-shadow-inset);
+  background: var(--lmn-select-bg, var(--bg));
+  box-shadow: var(--lmn-select-neu-shadow-inset, var(--neu-shadow-inset));
   display: inline-grid;
   place-items: center;
   flex-shrink: 0;
@@ -147,8 +150,8 @@
   transition: all var(--dur-fast) var(--ease);
 }
 .menu-check.on {
-  background: var(--accent);
-  box-shadow: var(--neu-shadow-control), 0 1px 4px var(--accent-glow);
+  background: var(--lmn-select-accent, var(--accent));
+  box-shadow: var(--lmn-select-neu-shadow-control, var(--neu-shadow-control)), 0 1px 4px var(--lmn-select-accent-glow, var(--accent-glow));
 }
 
 /* Menu search — flush with menu, single subtle separator (no nested frame) */
@@ -156,7 +159,7 @@
   display: block;
   padding: 4px 2px 8px;
   margin: -2px -2px 4px;
-  border-bottom: 1px solid var(--divider);
+  border-bottom: 1px solid var(--lmn-select-divider, var(--divider));
 }
 .menu-search .input-wrap { width: 100%; }
 
@@ -169,28 +172,39 @@
   gap: 10px;
   padding: 26px 12px;
   font-size: var(--fs-sm);
-  color: var(--fg-muted);
+  color: var(--lmn-select-fg-muted, var(--fg-muted));
 }
 .menu-state .menu-state-ico {
   width: 40px;
   height: 40px;
   border-radius: var(--r-md);
-  background: var(--bg);
-  box-shadow: var(--neu-shadow-inset);
+  background: var(--lmn-select-bg, var(--bg));
+  box-shadow: var(--lmn-select-neu-shadow-inset, var(--neu-shadow-inset));
   display: grid;
   place-items: center;
-  color: var(--fg-subtle);
+  color: var(--lmn-select-fg-subtle, var(--fg-subtle));
 }
 .menu-state .menu-state-ico .spinner {
   width: 16px;
   height: 16px;
   display: inline-block;
   border-radius: 999px;
-  border: 2px solid var(--accent);
-  border-color: var(--accent);
+  border: 2px solid var(--lmn-select-accent, var(--accent));
+  border-color: var(--lmn-select-accent, var(--accent));
   border-right-color: transparent;
   animation: spin 0.8s linear infinite;
 }
+.select-value-custom {
+  overflow: hidden;
+}
+.select-value-custom > * {
+  min-width: 0;
+  max-width: 100%;
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .menu-state .menu-state-ico .spinner { animation: none; }
+}
 
 /* Option body — supports description line under label */
 .menu-item-body {
@@ -201,6 +215,11 @@
   min-width: 0;
   text-align: left;
 }
+.menu-item-custom {
+  flex: 1;
+  min-width: 0;
+  text-align: left;
+}
 .menu-item-label {
   white-space: nowrap;
   overflow: hidden;
@@ -208,18 +227,18 @@
 }
 .menu-item-desc {
   font-size: var(--fs-xs);
-  color: var(--fg-subtle);
+  color: var(--lmn-select-fg-subtle, var(--fg-subtle));
   white-space: nowrap;
   overflow: hidden;
   text-overflow: ellipsis;
 }
-.menu-item.active .menu-item-desc { color: color-mix(in oklch, var(--accent-ink) 70%, var(--fg-subtle)); }
+.menu-item.active .menu-item-desc { color: color-mix(in oklch, var(--lmn-select-accent-ink, var(--accent-ink)) 70%, var(--lmn-select-fg-subtle, var(--fg-subtle))); }
 
 /* Keyboard / hover highlight — soft raised pill */
 .menu-item.highlight:not([disabled]) {
-  background: var(--bg);
-  box-shadow: var(--neu-shadow-control);
-  color: var(--accent-ink);
+  background: var(--lmn-select-bg, var(--bg));
+  box-shadow: var(--lmn-select-neu-shadow-control, var(--neu-shadow-control));
+  color: var(--lmn-select-accent-ink, var(--accent-ink));
 }
 .menu-item[disabled] {
   opacity: 0.45;
@@ -227,14 +246,19 @@
 }
 
 .menu {
-  background: var(--bg);
+  background: var(--lmn-select-bg, var(--bg));
   border-radius: var(--r-md);
-  box-shadow: var(--neu-shadow-float);
+  box-shadow: var(--lmn-select-neu-shadow-float, var(--neu-shadow-float));
   padding: 6px;
   min-width: 180px;
+  max-width: calc(100vw - 16px);
   z-index: 1000;
   animation: menuIn var(--dur) var(--ease);
-  max-height: 260px;
+  overflow: hidden;
+}
+.menu-options {
+  display: flex;
+  flex-direction: column;
   overflow-y: auto;
 }
 .menu-item {
@@ -242,7 +266,7 @@
   border-radius: var(--r-sm);
   font-size: var(--fs-md);
   cursor: pointer;
-  color: var(--fg);
+  color: var(--lmn-select-fg, var(--fg));
   display: flex;
   align-items: center;
   gap: 10px;
@@ -253,17 +277,17 @@
   width: 100%;
   text-align: left;
 }
-.menu-item:hover { background: var(--bg); box-shadow: var(--neu-shadow-subtle); color: var(--accent-ink); }
-.menu-item.active { color: var(--accent-ink); font-weight: 500; }
-.menu-item .tick { margin-left: auto; color: var(--accent); opacity: 0; }
+.menu-item:hover { background: var(--lmn-select-bg, var(--bg)); box-shadow: var(--lmn-select-neu-shadow-subtle, var(--neu-shadow-subtle)); color: var(--lmn-select-accent-ink, var(--accent-ink)); }
+.menu-item.active { color: var(--lmn-select-accent-ink, var(--accent-ink)); font-weight: 500; }
+.menu-item .tick { margin-left: auto; color: var(--lmn-select-accent, var(--accent)); opacity: 0; }
 .menu-item.active .tick { opacity: 1; }
-.menu-item.danger { color: var(--danger); }
-.menu-separator { height: 1px; background: var(--divider); margin: 6px 4px; }
+.menu-item.danger { color: var(--lmn-select-danger, var(--danger)); }
+.menu-separator { height: 1px; background: var(--lmn-select-divider, var(--divider)); margin: 6px 4px; }
 .menu-group-label {
   font-size: 10px;
   font-weight: 600;
   text-transform: uppercase;
   letter-spacing: 0.08em;
-  color: var(--fg-subtle);
+  color: var(--lmn-select-fg-subtle, var(--fg-subtle));
   padding: 8px 12px 4px;
 }

package/dist/Select.cjs

@@ -1,15 +1,18 @@
 'use strict';
 
-var chunkUW57F3UO_cjs = require('./chunk-UW57F3UO.cjs');
-require('./chunk-5ERD3W24.cjs');
-require('./chunk-YB3IWIOJ.cjs');
-require('./chunk-VS3I5OKA.cjs');
-require('./chunk-RZEFKXL3.cjs');
-require('./chunk-QMX67CVT.cjs');
+var chunkD7YSY5RZ_cjs = require('./chunk-D7YSY5RZ.cjs');
+require('./chunk-GFKWSDD6.cjs');
+require('./chunk-FJB3243S.cjs');
+require('./chunk-STQDKMS5.cjs');
+require('./chunk-HYHBCHFM.cjs');
+require('./chunk-HSDMJUB6.cjs');
+require('./chunk-2AUXUZ3Z.cjs');
+require('./chunk-NRJXZPZR.cjs');
+require('./chunk-EE5KXDRK.cjs');
 
 
 
 Object.defineProperty(exports, "Select", {
   enumerable: true,
-  get: function () { return chunkUW57F3UO_cjs.Select; }
+  get: function () { return chunkD7YSY5RZ_cjs.Select; }
 });

package/dist/Select.d.cts

@@ -1,5 +1,6 @@
 import * as React from 'react';
 import { IconSlot } from './Icon.cjs';
+import { f as ComponentThemeProps } from './componentThemeTypes-Jt4B5aU8.cjs';
 import 'react/jsx-runtime';
 
 interface SelectOption<T extends string | number = string> {
@@ -7,6 +8,8 @@ interface SelectOption<T extends string | number = string> {
     label: React.ReactNode;
     /** Searchable text — used by default filter when `label` isn't a string. */
     text?: string;
+    /** 复杂标签或 optionRender 使用的独立可访问名称。 */
+    ariaLabel?: string;
     /** Secondary line shown beneath the label. */
     description?: React.ReactNode;
     /** Leading icon. Accepts a built-in icon name or custom React node. */
@@ -20,13 +23,24 @@ interface SelectOptionGroup<T extends string | number = string> {
 }
 type SelectItem<T extends string | number = string> = SelectOption<T> | SelectOptionGroup<T>;
 type SelectFilterOption<T extends string | number = string> = boolean | ((input: string, option: SelectOption<T>) => boolean);
+/** 自定义选项内容渲染时可用的状态。 */
+interface SelectOptionRenderInfo {
+    index: number;
+    selected: boolean;
+    active: boolean;
+}
+/** 自定义已选内容渲染时可用的状态。 */
+interface SelectSelectedRenderInfo<T extends string | number = string> {
+    value: T;
+    multiple: boolean;
+}
 type SelectSingleChangeHandler<T extends string | number = string> = {
     bivarianceHack(value: any): void;
 }["bivarianceHack"];
 type SelectMultiChangeHandler<T extends string | number = string> = {
     bivarianceHack(value: T[]): void;
 }["bivarianceHack"];
-interface BaseSelectProps<T extends string | number = string> extends Omit<React.HTMLAttributes<HTMLDivElement>, "onChange" | "defaultValue"> {
+interface BaseSelectProps<T extends string | number = string> extends Omit<React.HTMLAttributes<HTMLDivElement>, "onChange" | "defaultValue">, ComponentThemeProps {
     /** Flat or mixed (groups + options) item list. */
     options: SelectItem<T>[];
     placeholder?: string;
@@ -52,6 +66,14 @@ interface BaseSelectProps<T extends string | number = string> extends Omit<React
     loading?: boolean;
     /** Custom empty content when no options match. */
     emptyContent?: React.ReactNode;
+    /** 自定义菜单内的完整选项内容；选择标记仍由 Select 负责。 */
+    optionRender?: (option: SelectOption<T>, info: SelectOptionRenderInfo) => React.ReactNode;
+    /** 自定义触发器中的紧凑已选内容，避免复用复杂的 option 内容。 */
+    selectedRender?: (option: SelectOption<T>, info: SelectSelectedRenderInfo<T>) => React.ReactNode;
+    /** 菜单选项滚动区域的最大高度。 */
+    listHeight?: number;
+    /** Portal 菜单的额外内联样式，可覆盖宽度或高度。 */
+    popupStyle?: React.CSSProperties;
     /** Controlled open state. */
     open?: boolean;
     defaultOpen?: boolean;
@@ -87,7 +109,6 @@ type SelectComponent = {
     <T extends string | number = string>(props: SingleSelectProps<T> & React.RefAttributes<HTMLDivElement>): React.ReactElement;
     <T extends string | number = string>(props: MultiSelectProps<T> & React.RefAttributes<HTMLDivElement>): React.ReactElement;
 };
-/** `Select` — neumorphic dropdown. Set `multiple` for tag-style multi-select. */
 declare const Select: SelectComponent;
 
-export { type MultiSelectProps, Select, type SelectFilterOption, type SelectItem, type SelectMultiChangeHandler, type SelectOption, type SelectOptionGroup, type SelectProps, type SelectSingleChangeHandler, type SingleSelectProps };
+export { type MultiSelectProps, Select, type SelectFilterOption, type SelectItem, type SelectMultiChangeHandler, type SelectOption, type SelectOptionGroup, type SelectOptionRenderInfo, type SelectProps, type SelectSelectedRenderInfo, type SelectSingleChangeHandler, type SingleSelectProps };