@fangxinyan/lumina 0.9.0 → 0.9.2

package/dist/index.cjs

@@ -3,8 +3,8 @@
 var chunkRXITGNPX_cjs = require('./chunk-RXITGNPX.cjs');
 var chunkXHKSUKKL_cjs = require('./chunk-XHKSUKKL.cjs');
 var chunk3D5RJA7R_cjs = require('./chunk-3D5RJA7R.cjs');
-var chunkHMN65CDW_cjs = require('./chunk-HMN65CDW.cjs');
-var chunk7KA5D37Z_cjs = require('./chunk-7KA5D37Z.cjs');
+var chunkIDEE7PP5_cjs = require('./chunk-IDEE7PP5.cjs');
+var chunkMJYMPK5K_cjs = require('./chunk-MJYMPK5K.cjs');
 var chunkAEY76EAH_cjs = require('./chunk-AEY76EAH.cjs');
 require('./chunk-HYJSMFZA.cjs');
 var chunkAQN3PD24_cjs = require('./chunk-AQN3PD24.cjs');
@@ -19,9 +19,9 @@ var chunkUQF7E32V_cjs = require('./chunk-UQF7E32V.cjs');
 var chunk6WEXRX7K_cjs = require('./chunk-6WEXRX7K.cjs');
 var chunkZ6AG7O4B_cjs = require('./chunk-Z6AG7O4B.cjs');
 var chunkTPFY5SKB_cjs = require('./chunk-TPFY5SKB.cjs');
-var chunkI2YL5XE4_cjs = require('./chunk-I2YL5XE4.cjs');
-var chunkVTN6YLRJ_cjs = require('./chunk-VTN6YLRJ.cjs');
-var chunkK3KHQ77L_cjs = require('./chunk-K3KHQ77L.cjs');
+var chunkSOAGRYM3_cjs = require('./chunk-SOAGRYM3.cjs');
+var chunkQZ2AAQBX_cjs = require('./chunk-QZ2AAQBX.cjs');
+var chunkCDT2QCBL_cjs = require('./chunk-CDT2QCBL.cjs');
 var chunkVNP5WB6M_cjs = require('./chunk-VNP5WB6M.cjs');
 var chunk3J7HOTD6_cjs = require('./chunk-3J7HOTD6.cjs');
 var chunkPYCAGTO7_cjs = require('./chunk-PYCAGTO7.cjs');
@@ -58,7 +58,7 @@ require('./chunk-V6BLBIY6.cjs');
 var chunkI4GJZLJU_cjs = require('./chunk-I4GJZLJU.cjs');
 
 // src/index.ts
-var VERSION = "0.9.0";
+var VERSION = "0.9.2";
 
 Object.defineProperty(exports, "Timeline", {
   enumerable: true,
@@ -90,11 +90,11 @@ Object.defineProperty(exports, "Typography", {
 });
 Object.defineProperty(exports, "TablePro", {
   enumerable: true,
-  get: function () { return chunkHMN65CDW_cjs.TablePro; }
+  get: function () { return chunkIDEE7PP5_cjs.TablePro; }
 });
 Object.defineProperty(exports, "Table", {
   enumerable: true,
-  get: function () { return chunk7KA5D37Z_cjs.Table; }
+  get: function () { return chunkMJYMPK5K_cjs.Table; }
 });
 Object.defineProperty(exports, "Tabs", {
   enumerable: true,
@@ -186,15 +186,15 @@ Object.defineProperty(exports, "toast", {
 });
 Object.defineProperty(exports, "Modal", {
   enumerable: true,
-  get: function () { return chunkI2YL5XE4_cjs.Modal; }
+  get: function () { return chunkSOAGRYM3_cjs.Modal; }
 });
 Object.defineProperty(exports, "Pagination", {
   enumerable: true,
-  get: function () { return chunkVTN6YLRJ_cjs.Pagination; }
+  get: function () { return chunkQZ2AAQBX_cjs.Pagination; }
 });
 Object.defineProperty(exports, "Select", {
   enumerable: true,
-  get: function () { return chunkK3KHQ77L_cjs.Select; }
+  get: function () { return chunkCDT2QCBL_cjs.Select; }
 });
 Object.defineProperty(exports, "Tag", {
   enumerable: true,

package/dist/index.d.cts

@@ -45,8 +45,8 @@ export { Cascader, CascaderOption, CascaderOptionRenderInfo, CascaderProps, Casc
 export { BaseTypographyProps, CopyableConfig, EditableConfig, EllipsisConfig, Link, LinkProps, Paragraph, ParagraphProps, Text, TextProps, Title, TitleLevel, TitleProps, Typography, TypographyProps, TypographyType } from './Typography.cjs';
 export { ColorPicker, ColorPickerProps, ColorPickerTriggerElement } from './ColorPicker.cjs';
 export { Drawer, DrawerBodyInset, DrawerProps } from './Drawer.cjs';
-export { A as AccentKey, a as AccentPalette, C as ComponentTheme, b as ComponentThemeName, c as ComponentThemeOptions, d as ComponentThemeOverride, e as ComponentThemeOverrides, f as ComponentThemeProps, g as ComponentThemeScope, h as CustomAccentInput, R as ResolvedThemeColors, T as ThemeBaseMode, i as ThemeColorOverrides, j as ThemeSemanticColors, k as ThemeSurfacePalette, l as ThemeTokens } from './componentThemeTypes-Jt4B5aU8.cjs';
-export { A as ACCENT_PRESETS, a as ACCENT_PRESETS_DARK, B as BuiltInThemeMode, D as DEFAULT_THEME_COLORS, b as DensityMode, F as FONT_STACKS, c as FontConfig, d as FontKey, R as ResolvedThemeMode, T as ThemeConfig, e as ThemeMode, f as ThemePreset, g as ThemePresets, h as ThemeProvider, i as ThemeProviderConfig, j as ThemeProviderProps, k as ThemeValue, l as applyTheme, m as componentTokensToStyle, n as deriveThemeColors, o as normalizeAccentInput, r as resolveThemeColorScheme, p as resolveThemeColors, q as resolveThemeMode, s as resolveVisualThemeSnapshot, t as themeColorsToStyle, u as themeTokenToKebabCase, v as useTheme, w as useThemeOptional, x as visualThemeToStyle } from './Theme-uQq2B0Yk.cjs';
+export { A as AccentKey, a as AccentPalette, C as ComponentTheme, b as ComponentThemeName, c as ComponentThemeOptions, d as ComponentThemeOverride, e as ComponentThemeOverrides, f as ComponentThemeProps, g as ComponentThemeScope, h as CustomAccentInput, M as ModalThemeSlot, R as ResolvedThemeColors, T as ThemeBaseMode, i as ThemeColorOverrides, j as ThemeSemanticColors, k as ThemeSurfacePalette, l as ThemeTokens } from './componentThemeTypes-C7lS3Hi8.cjs';
+export { A as ACCENT_PRESETS, a as ACCENT_PRESETS_DARK, B as BuiltInThemeMode, D as DEFAULT_THEME_COLORS, b as DensityMode, F as FONT_STACKS, c as FontConfig, d as FontKey, R as ResolvedThemeMode, T as ThemeConfig, e as ThemeMode, f as ThemePreset, g as ThemePresets, h as ThemeProvider, i as ThemeProviderConfig, j as ThemeProviderProps, k as ThemeValue, l as applyTheme, m as componentTokensToStyle, n as deriveThemeColors, o as normalizeAccentInput, r as resolveThemeColorScheme, p as resolveThemeColors, q as resolveThemeMode, s as resolveVisualThemeSnapshot, t as themeColorsToStyle, u as themeTokenToKebabCase, v as useTheme, w as useThemeOptional, x as visualThemeToStyle } from './Theme-BJa0Nb3w.cjs';
 export { BuiltInLuminaThemePresetKey, LUMINA_THEME_PRESETS, cloneLuminaThemePreset, pickLuminaThemePresets } from './Theme.cjs';
 export { THEME_PANEL_DEFAULT_PRESET_OPTIONS, THEME_PANEL_DEFAULT_THEME_PRESETS, ThemePanel, ThemePanelCreateThemePayload, ThemePanelCreatedThemeMeta, ThemePanelDeleteThemePayload, ThemePanelModeOption, ThemePanelPresetOption, ThemePanelProps, ThemePanelSection, ThemePanelUpdateThemePayload } from './ThemePanel.cjs';
 export { Timeline, TimelineItemConfig, TimelineProps } from './Timeline.cjs';
@@ -54,6 +54,6 @@ import 'react/jsx-runtime';
 import 'react';
 
 /** Package version — bumped by release scripts. */
-declare const VERSION = "0.9.0";
+declare const VERSION = "0.9.2";
 
 export { VERSION };

package/dist/index.d.ts

@@ -45,8 +45,8 @@ export { Cascader, CascaderOption, CascaderOptionRenderInfo, CascaderProps, Casc
 export { BaseTypographyProps, CopyableConfig, EditableConfig, EllipsisConfig, Link, LinkProps, Paragraph, ParagraphProps, Text, TextProps, Title, TitleLevel, TitleProps, Typography, TypographyProps, TypographyType } from './Typography.js';
 export { ColorPicker, ColorPickerProps, ColorPickerTriggerElement } from './ColorPicker.js';
 export { Drawer, DrawerBodyInset, DrawerProps } from './Drawer.js';
-export { A as AccentKey, a as AccentPalette, C as ComponentTheme, b as ComponentThemeName, c as ComponentThemeOptions, d as ComponentThemeOverride, e as ComponentThemeOverrides, f as ComponentThemeProps, g as ComponentThemeScope, h as CustomAccentInput, R as ResolvedThemeColors, T as ThemeBaseMode, i as ThemeColorOverrides, j as ThemeSemanticColors, k as ThemeSurfacePalette, l as ThemeTokens } from './componentThemeTypes-Jt4B5aU8.js';
-export { A as ACCENT_PRESETS, a as ACCENT_PRESETS_DARK, B as BuiltInThemeMode, D as DEFAULT_THEME_COLORS, b as DensityMode, F as FONT_STACKS, c as FontConfig, d as FontKey, R as ResolvedThemeMode, T as ThemeConfig, e as ThemeMode, f as ThemePreset, g as ThemePresets, h as ThemeProvider, i as ThemeProviderConfig, j as ThemeProviderProps, k as ThemeValue, l as applyTheme, m as componentTokensToStyle, n as deriveThemeColors, o as normalizeAccentInput, r as resolveThemeColorScheme, p as resolveThemeColors, q as resolveThemeMode, s as resolveVisualThemeSnapshot, t as themeColorsToStyle, u as themeTokenToKebabCase, v as useTheme, w as useThemeOptional, x as visualThemeToStyle } from './Theme-CLedeJ_C.js';
+export { A as AccentKey, a as AccentPalette, C as ComponentTheme, b as ComponentThemeName, c as ComponentThemeOptions, d as ComponentThemeOverride, e as ComponentThemeOverrides, f as ComponentThemeProps, g as ComponentThemeScope, h as CustomAccentInput, M as ModalThemeSlot, R as ResolvedThemeColors, T as ThemeBaseMode, i as ThemeColorOverrides, j as ThemeSemanticColors, k as ThemeSurfacePalette, l as ThemeTokens } from './componentThemeTypes-C7lS3Hi8.js';
+export { A as ACCENT_PRESETS, a as ACCENT_PRESETS_DARK, B as BuiltInThemeMode, D as DEFAULT_THEME_COLORS, b as DensityMode, F as FONT_STACKS, c as FontConfig, d as FontKey, R as ResolvedThemeMode, T as ThemeConfig, e as ThemeMode, f as ThemePreset, g as ThemePresets, h as ThemeProvider, i as ThemeProviderConfig, j as ThemeProviderProps, k as ThemeValue, l as applyTheme, m as componentTokensToStyle, n as deriveThemeColors, o as normalizeAccentInput, r as resolveThemeColorScheme, p as resolveThemeColors, q as resolveThemeMode, s as resolveVisualThemeSnapshot, t as themeColorsToStyle, u as themeTokenToKebabCase, v as useTheme, w as useThemeOptional, x as visualThemeToStyle } from './Theme-DTtq_WWg.js';
 export { BuiltInLuminaThemePresetKey, LUMINA_THEME_PRESETS, cloneLuminaThemePreset, pickLuminaThemePresets } from './Theme.js';
 export { THEME_PANEL_DEFAULT_PRESET_OPTIONS, THEME_PANEL_DEFAULT_THEME_PRESETS, ThemePanel, ThemePanelCreateThemePayload, ThemePanelCreatedThemeMeta, ThemePanelDeleteThemePayload, ThemePanelModeOption, ThemePanelPresetOption, ThemePanelProps, ThemePanelSection, ThemePanelUpdateThemePayload } from './ThemePanel.js';
 export { Timeline, TimelineItemConfig, TimelineProps } from './Timeline.js';
@@ -54,6 +54,6 @@ import 'react/jsx-runtime';
 import 'react';
 
 /** Package version — bumped by release scripts. */
-declare const VERSION = "0.9.0";
+declare const VERSION = "0.9.2";
 
 export { VERSION };

package/dist/index.js

@@ -1,8 +1,8 @@
 export { Timeline } from './chunk-U7V2FOIM.js';
 export { Tooltip } from './chunk-TALNKJQ2.js';
 export { Link, Paragraph, Text, Title, Typography } from './chunk-2COQYOVG.js';
-export { TablePro } from './chunk-2NECDEAJ.js';
-export { Table } from './chunk-JMYUO7V7.js';
+export { TablePro } from './chunk-U3T6RC6U.js';
+export { Table } from './chunk-RM6JIM6O.js';
 export { Tabs } from './chunk-4JANYBXO.js';
 import './chunk-EE7IJ3MB.js';
 export { THEME_PANEL_DEFAULT_PRESET_OPTIONS, THEME_PANEL_DEFAULT_THEME_PRESETS, ThemePanel } from './chunk-IU6PLLEL.js';
@@ -17,9 +17,9 @@ export { Switch } from './chunk-O6PRE6MZ.js';
 export { InputNumber } from './chunk-RYF5ADJW.js';
 export { List } from './chunk-LACXN5CI.js';
 export { MessageContainer, ToastContainer, message, toast } from './chunk-2V6RQQRI.js';
-export { Modal } from './chunk-GMFOY7RD.js';
-export { Pagination } from './chunk-UCE53RYR.js';
-export { Select } from './chunk-AL2PYVVP.js';
+export { Modal } from './chunk-RJCPXAZ3.js';
+export { Pagination } from './chunk-LZXJN3XA.js';
+export { Select } from './chunk-MSWWABXP.js';
 export { Tag } from './chunk-OGMI3TO5.js';
 export { Popover } from './chunk-A34P5CU7.js';
 export { Progress } from './chunk-BOBT7JUB.js';
@@ -56,6 +56,6 @@ import './chunk-5HLNFDV4.js';
 export { ACCENT_PRESETS, ACCENT_PRESETS_DARK, DEFAULT_THEME_COLORS, FONT_STACKS, ThemeProvider, applyTheme, componentTokensToStyle, deriveThemeColors, normalizeAccentInput, resolveThemeColorScheme, resolveThemeColors, resolveThemeMode, resolveVisualThemeSnapshot, themeColorsToStyle, themeTokenToKebabCase, useTheme, useThemeOptional, visualThemeToStyle } from './chunk-CPVUDSIY.js';
 
 // src/index.ts
-var VERSION = "0.9.0";
+var VERSION = "0.9.2";
 
 export { VERSION };

package/dist/styles.css

@@ -1689,19 +1689,71 @@ button.collapse-chev {
   flex: 1;
   min-width: 0;
   align-items: center;
+  width: 100%;
 }
 .select.multi .select-trigger > .placeholder {
   padding-left: 6px;
   line-height: calc(var(--ctrl-h) - 8px);
 }
 .select.multi .select-tags > .tag {
-  max-width: 160px;
+  max-width: min(160px, 100%);
+  min-width: 0;
+  flex-shrink: 1;
 }
-.select.multi .select-tags > .tag > span:not(.dot):not(.x) {
+.select.multi .select-tag-label {
+  display: block;
+  min-width: 0;
   white-space: nowrap;
   overflow: hidden;
   text-overflow: ellipsis;
 }
+.select.multi .select-tag-label > * {
+  min-width: 0;
+  max-width: 100%;
+}
+.select.multi .select-tag-overflow {
+  flex-shrink: 0;
+}
+.select.multi.searchable .select-trigger {
+  cursor: text;
+}
+.select-search-input {
+  min-width: 0;
+  height: 24px;
+  padding: 0 2px;
+  border: 0;
+  outline: 0;
+  appearance: none;
+  background: transparent;
+  color: var(--lmn-select-fg, var(--fg));
+  font: inherit;
+  line-height: 24px;
+}
+.select-search-input.empty {
+  flex: 1 1 auto;
+  width: 100%;
+}
+.select-search-input.with-selection {
+  flex: 0 1 auto;
+  min-width: 2ch;
+  max-width: 100%;
+  field-sizing: content;
+}
+.select-search-input::placeholder {
+  color: var(--lmn-select-fg-subtle, var(--fg-subtle));
+}
+.select-search-input::-webkit-search-cancel-button {
+  appearance: none;
+}
+.select-search-input:focus-visible {
+  box-shadow: none;
+}
+.select.searchable:focus-within .select-trigger {
+  box-shadow: var(--lmn-select-neu-shadow-inset, var(--neu-shadow-inset)), 0 0 0 3px var(--lmn-select-accent-glow, var(--accent-glow));
+}
+.select.multi.searchable .select-caret {
+  cursor: pointer;
+}
 .select-clear {
   position: absolute;
   right: 30px;
@@ -1742,14 +1794,6 @@ button.collapse-chev {
   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) */
-.menu-search {
-  display: block;
-  padding: 4px 2px 8px;
-  margin: -2px -2px 4px;
-  border-bottom: 1px solid var(--lmn-select-divider, var(--divider));
-}
-.menu-search .input-wrap { width: 100%; }
 /* Menu state (loading / empty) */
 .menu-state {
   display: flex;
@@ -1997,6 +2041,8 @@ button.collapse-chev {
 }
 .modal-head {
   display: flex;
+  flex: 0 0 auto;
+  min-width: 0;
   align-items: flex-start;
   justify-content: space-between;
   gap: var(--gap-3);
@@ -2011,26 +2057,41 @@ button.collapse-chev {
 .modal-body {
   min-width: 0;
   min-height: 0;
-  margin-inline: calc(var(--gap-6) * -1);
+  margin-inline: calc(var(--overlay-shadow-safe-area) * -1);
   padding: var(--overlay-shadow-safe-area);
   color: var(--lmn-modal-fg-muted, var(--fg-muted));
   font-size: 13px;
   line-height: 1.6;
-  flex: 1;
+  flex: 1 1 auto;
+  overflow-x: hidden;
   overflow-y: auto;
 }
 .modal-body:first-child {
-  margin-top: calc(var(--gap-6) * -1);
+  margin-top: calc(var(--overlay-shadow-safe-area) * -1);
 }
-.modal-body:last-child {
-  margin-bottom: calc(var(--gap-6) * -1);
+.modal-body.default-overflow > * {
+  min-width: 0;
+  max-width: 100%;
+  flex-shrink: 0;
 }
 .modal-body.inset-none {
+  margin-inline: calc(var(--gap-6) * -1);
   padding: 0;
 }
+.modal-body.inset-none:first-child {
+  margin-top: calc(var(--gap-6) * -1);
+}
+.modal-body.inset-none:last-child {
+  margin-bottom: calc(var(--gap-6) * -1);
+}
 .modal-foot {
   display: flex;
-  gap: 10px;
+  flex: 0 0 auto;
+  min-width: 0;
+  min-height: var(--lmn-modal-footer-min-height, var(--ctrl-h));
+  margin-top: var(--lmn-modal-footer-gap, var(--gap-4));
+  align-items: center;
+  gap: var(--lmn-modal-footer-action-gap, var(--gap-3));
   justify-content: flex-end;
 }
 .modal-close {

package/docs/llms/modal.md

@@ -104,6 +104,28 @@ closable={false} 隐藏右上角 ×,closeIcon 可自定义。
 </Modal>
 ```
 
+### 长内容与独立 footer
+
+默认正文只纵向滚动并保留底部安全区；直接子控件不会被纵向压缩。footer 独立于滚动区，bodyOverflow="hidden" 仍可交给内层容器滚动。
+
+```tsx
+<Modal
+  footer={null}
+  bodyStyle={{ maxHeight: 360, display: "flex", flexDirection: "column" }}
+>
+  <Input placeholder="固定高度的搜索框" />
+  <LongList />
+</Modal>
+
+<Modal bodyStyle={{ maxHeight: 360 }}>
+  <LongForm />
+</Modal>
+
+<Modal bodyOverflow="hidden">
+  <InnerScrollableLayout />
+</Modal>
+```
+
 ### 嵌套浮层与 Esc 顺序
 
 子 Select 即使 Portal 到对话框之外，也会保持在 Modal 上方并参与同一焦点范围；连续按 Esc 会先关 Select，再关 Modal。
@@ -125,14 +147,14 @@ closable={false} 隐藏右上角 ×,closeIcon 可自定义。
 | onOk | `() => void` | — | 默认 OK 按钮点击 |
 | onCancel | `() => void` | — | 默认 Cancel 按钮 / Esc / 关闭 / 遮罩触发,缺省则用 onClose |
 | title / description | `ReactNode` | — | 标题/说明 |
-| footer | `ReactNode` | — | 自定义底部(null 去除) |
+| footer | `ReactNode` | — | 独立于正文滚动区的底部区域；自定义内容，null 去除 |
 | okText / cancelText | `ReactNode` | `"确定" / "取消"` | 默认按钮文案 |
 | okButtonProps / cancelButtonProps | `Partial<ButtonProps>` | — | 透传给默认按钮 |
 | confirmLoading | `boolean` | `false` | OK 按钮显示 spinner 并禁用 |
 | bodyClassName | `string` | — | 正文容器 className |
 | bodyStyle | `CSSProperties` | — | 正文容器内联样式 |
 | bodyProps | `HTMLAttributes<HTMLDivElement>` | — | 透传给正文容器的 DOM props |
-| bodyOverflow | `CSSProperties['overflow']` | — | 正文容器 overflow 快捷控制 |
+| bodyOverflow | `CSSProperties['overflow']` | — | 正文容器 overflow 快捷控制；hidden 可让复杂内层布局接管滚动 |
 | bodyInset | `"safe" | "none"` | `"safe"` | 正文边缘留白；safe 自动保护拟态阴影，none 用于贴边内容 |
 | closable | `boolean` | `true` | 显示右上角 × |
 | closeIcon | `ReactNode` | — | 自定义关闭图标 |

package/docs/llms/select.md

@@ -27,6 +27,43 @@ multiple + Tag 形式呈现已选项。
 <Select multiple clearable value={tags} onChange={setTags} options={...} />
 ```
 
+### 远程搜索多选
+
+searchable 在单选和多选中都复用选择框本体作为输入；多选 Tag 后的空输入会收缩，不单独占行。选中后保持展开和关键词，业务层负责防抖与迟到结果保护。
+
+```tsx
+const [value, setValue] = useState<string[]>([]);
+const [searchValue, setSearchValue] = useState("");
+const [options, setOptions] = useState<SelectOption[]>([]);
+const [loading, setLoading] = useState(false);
+const latestRequest = useRef(0);
+
+useEffect(() => {
+  const requestId = ++latestRequest.current;
+  setLoading(true);
+  const timer = window.setTimeout(() => {
+    void fetchOptions(searchValue).then((nextOptions) => {
+      if (requestId !== latestRequest.current) return;
+      setOptions(nextOptions);
+      setLoading(false);
+    });
+  }, 300);
+  return () => {
+    window.clearTimeout(timer);
+    if (requestId === latestRequest.current) latestRequest.current += 1;
+  };
+}, [searchValue]);
+
+<Select
+  multiple searchable clearable
+  value={value} onChange={setValue}
+  searchValue={searchValue} onSearch={setSearchValue}
+  options={options} loading={loading}
+  filterOption={false}
+  maxTagCount={2}
+/>
+```
+
 ### 数量上限 / 分类限选
 
 maxCount 限制总数；getOptionDisabled 可读取当前选择，实现“一类最多选一个”。
@@ -147,8 +184,10 @@ loading 时显示 spinner,emptyContent 自定义空态。
 | maxTagCount | `number` | — | 多选时显示的标签数(超出折叠 +N) |
 | maxCount | `number` | — | 多选允许的最大选择数；达到上限后禁用未选项 |
 | getOptionDisabled | `(option, selectedValues) => boolean` | — | 基于候选项和当前选择动态判断禁用状态 |
-| searchable | `boolean` | `false` | 可搜索 |
+| searchable | `boolean` | `false` | 在选择框本体内启用搜索，单选和多选共用同一交互形态 |
 | showSearch | `boolean` | `false` | searchable 的等价别名 |
+| searchValue / defaultSearchValue | `string` | — | 受控搜索词 / 非受控初始搜索词；多选 searchable 时输入框位于标签同一触发器内 |
+| onSearch | `(value: string) => void` | — | 搜索词交互变化回调；多选选中不会清空关键词，关闭时清空并回调空字符串 |
 | filterOption | `(input, option) => boolean` | — | 自定义过滤 |
 | optionFilterProp | `"label" | "value" | "text" | string` | — | 默认过滤使用的 option 字段 |
 | clearable | `boolean` | `false` | 显示独立且可访问的清除按钮 |

package/docs/llms/theme.md

@@ -272,7 +272,7 @@ applyTheme(document.documentElement, {
 | tokens | `ThemeTokens` | — | 短键会写入组件前缀变量；以 -- 开头的键作为高级原始变量逃生口 |
 | components | `ComponentThemeOverrides` | — | 继续定向配置当前组件内部或 subtree 后代的组件类型 |
 | styles.root | `CSSProperties` | — | 所有组件都支持真实视觉根节点；调用方 style 仍保持最高优先级 |
-| styles.popup / overlay / body | `CSSProperties` | — | 浮层、遮罩和正文等组件专用静态插槽；定位与用户 popupStyle 不会被覆盖 |
+| styles.popup / overlay / header / body / footer | `CSSProperties` | — | 浮层、遮罩和 Modal 头部/正文/footer 等稳定静态插槽；定位与用户实例样式不会被覆盖 |
 
 
 ---

package/docs/llms.md

@@ -3,7 +3,7 @@
 > 拟态风格的 React 18 组件库,目标是 Electron 桌面应用。**写给 AI 编程助手**的按需文档 —— 每个组件单独一个 `.md`,避免一次性读取全部。示例源自 playground 的 demo,可直接复制运行。
 
 - **包名**: `@fangxinyan/lumina`
-- **版本**: `0.9.0`
+- **版本**: `0.9.2`
 - **React 最低版本**: 18
 - **环境**: 带打包器的 React 工程(Vite / Next.js / Webpack / Remix / Electron + Vite 等)
 - **零运行时依赖**: 只依赖 `react` / `react-dom` (peer deps)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fangxinyan/lumina",
-  "version": "0.9.0",
+  "version": "0.9.2",
   "description": "Lumina — Neumorphic component library for Electron & React apps",
   "type": "module",
   "main": "./dist/index.cjs",