@fangxinyan/lumina 0.1.0

package/dist/Avatar-OXDSG5Q6.css

@@ -0,0 +1,36 @@
+/* ============ Avatar ============ */
+.avatar {
+  --size: 40px;
+  width: var(--size); height: var(--size);
+  border-radius: 999px;
+  background: var(--bg);
+  box-shadow: var(--neu-out-sm);
+  display: grid; place-items: center;
+  overflow: hidden;
+  color: var(--accent-ink);
+  font-weight: 600;
+  font-size: calc(var(--size) / 2.6);
+  position: relative;
+  flex-shrink: 0;
+}
+.avatar.sm { --size: 28px; }
+.avatar.lg { --size: 56px; }
+.avatar.xl { --size: 80px; }
+.avatar img { width: 100%; height: 100%; object-fit: cover; }
+.avatar-status {
+  position: absolute;
+  bottom: 0; right: 0;
+  width: 25%; height: 25%;
+  min-width: 8px; min-height: 8px;
+  border-radius: 999px;
+  background: var(--success);
+  box-shadow: 0 0 0 2px var(--bg);
+}
+.avatar-status.online  { background: var(--success); }
+.avatar-status.busy    { background: var(--danger); }
+.avatar-status.away    { background: var(--warning); }
+.avatar-status.offline { background: var(--fg-subtle); }
+
+.avatar-group { display: inline-flex; }
+.avatar-group .avatar { border: 3px solid var(--bg); box-sizing: content-box; }
+.avatar-group .avatar + .avatar { margin-left: -12px; }

package/dist/Avatar.cjs

@@ -0,0 +1,12 @@
+'use strict';
+
+var chunkJWFVSBVX_cjs = require('./chunk-JWFVSBVX.cjs');
+
+
+
+Object.defineProperty(exports, "Avatar", {
+  enumerable: true,
+  get: function () { return chunkJWFVSBVX_cjs.Avatar; }
+});
+//# sourceMappingURL=Avatar.cjs.map
+//# sourceMappingURL=Avatar.cjs.map

package/dist/Avatar.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"Avatar.cjs"}

package/dist/Avatar.d.cts

@@ -0,0 +1,15 @@
+import * as React from 'react';
+
+interface AvatarProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "children"> {
+    src?: string;
+    alt?: string;
+    /** Initials if no image. Auto-derived from `alt` if omitted. */
+    initials?: string;
+    size?: number | "sm" | "md" | "lg" | "xl";
+    /** Status dot. */
+    status?: "online" | "busy" | "away" | "offline";
+}
+/** `Avatar` — user image or initials chip. */
+declare const Avatar: React.FC<AvatarProps>;
+
+export { Avatar, type AvatarProps };

package/dist/Avatar.d.ts

@@ -0,0 +1,15 @@
+import * as React from 'react';
+
+interface AvatarProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "children"> {
+    src?: string;
+    alt?: string;
+    /** Initials if no image. Auto-derived from `alt` if omitted. */
+    initials?: string;
+    size?: number | "sm" | "md" | "lg" | "xl";
+    /** Status dot. */
+    status?: "online" | "busy" | "away" | "offline";
+}
+/** `Avatar` — user image or initials chip. */
+declare const Avatar: React.FC<AvatarProps>;
+
+export { Avatar, type AvatarProps };

package/dist/Avatar.js

@@ -0,0 +1,3 @@
+export { Avatar } from './chunk-VXITDXLW.js';
+//# sourceMappingURL=Avatar.js.map
+//# sourceMappingURL=Avatar.js.map

package/dist/Avatar.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"Avatar.js"}

package/dist/Button-5UI7QXGU.css

@@ -0,0 +1,96 @@
+/* ============ Button ============ */
+.btn {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  gap: 8px;
+  height: var(--ctrl-h);
+  padding: 0 var(--ctrl-pad-x);
+  border: none;
+  border-radius: var(--r-md);
+  font-size: 13px;
+  font-weight: 500;
+  font-family: inherit;
+  color: var(--fg);
+  background: var(--bg);
+  box-shadow: var(--neu-out-sm);
+  cursor: pointer;
+  user-select: none;
+  white-space: nowrap;
+  flex-shrink: 0;
+  transition: all var(--dur-fast) var(--ease);
+}
+.btn > svg { flex-shrink: 0; }
+.btn.icon {
+  flex-shrink: 0;
+  overflow: visible;
+}
+.btn:hover { color: var(--accent-ink); }
+.btn:active, .btn.pressed {
+  box-shadow: var(--neu-in-sm);
+  color: var(--accent-ink);
+}
+
+.btn.primary {
+  color: var(--accent-ink);
+  background:
+    linear-gradient(145deg,
+      color-mix(in oklch, var(--accent-soft) 80%, var(--shadow-light)),
+      color-mix(in oklch, var(--accent-soft) 92%, var(--bg)));
+  box-shadow:
+    var(--neu-out-sm),
+    inset 1px 1px 0 color-mix(in oklch, var(--shadow-light) 60%, transparent),
+    inset -1px -1px 0 color-mix(in oklch, var(--accent) 15%, transparent);
+  font-weight: 600;
+}
+.btn.primary:hover {
+  background:
+    linear-gradient(145deg,
+      color-mix(in oklch, var(--accent-soft) 70%, var(--shadow-light)),
+      color-mix(in oklch, var(--accent) 18%, var(--accent-soft)));
+  box-shadow:
+    var(--neu-out-sm),
+    inset 1px 1px 0 color-mix(in oklch, var(--shadow-light) 70%, transparent),
+    inset -1px -1px 0 color-mix(in oklch, var(--accent) 20%, transparent),
+    0 0 16px -6px var(--accent-glow);
+}
+.btn.primary:active, .btn.primary.pressed {
+  box-shadow:
+    inset 2px 2px 4px color-mix(in oklch, var(--accent) 25%, var(--shadow-dark)),
+    inset -1px -1px 2px var(--shadow-light);
+  transform: none;
+}
+
+.btn.ghost {
+  background: transparent;
+  box-shadow: none;
+  color: var(--fg-muted);
+}
+.btn.ghost:hover { background: var(--bg); box-shadow: var(--neu-flat); color: var(--fg); }
+
+.btn.danger { color: var(--danger); }
+.btn.danger:hover { color: var(--danger); }
+
+.btn.icon { width: var(--ctrl-h); padding: 0; }
+.btn.sm { height: 30px; padding: 0 12px; font-size: 12px; border-radius: var(--r-sm); }
+.btn.sm.icon { width: 30px; padding: 0; }
+.btn.lg { height: 52px; padding: 0 24px; font-size: 15px; border-radius: var(--r-lg); }
+.btn.lg.icon { width: 52px; padding: 0; }
+
+.btn[disabled], .btn.disabled, .btn:disabled {
+  color: var(--fg-subtle);
+  cursor: not-allowed;
+  box-shadow: var(--neu-flat);
+  transform: none;
+}
+.btn[disabled]:hover, .btn:disabled:hover, .btn.disabled:hover { transform: none; color: var(--fg-subtle); background: var(--bg); }
+
+.btn.loading { cursor: wait; }
+.btn .spinner {
+  width: 14px; height: 14px;
+  border-radius: 999px;
+  border: 2px solid currentColor;
+  border-right-color: transparent;
+  animation: spin 0.8s linear infinite;
+  display: inline-block;
+}

package/dist/Button.cjs

@@ -0,0 +1,17 @@
+'use strict';
+
+var chunkAAMYURWQ_cjs = require('./chunk-AAMYURWQ.cjs');
+require('./chunk-YVO7XO4W.cjs');
+
+
+
+Object.defineProperty(exports, "Button", {
+  enumerable: true,
+  get: function () { return chunkAAMYURWQ_cjs.Button; }
+});
+Object.defineProperty(exports, "IconButton", {
+  enumerable: true,
+  get: function () { return chunkAAMYURWQ_cjs.IconButton; }
+});
+//# sourceMappingURL=Button.cjs.map
+//# sourceMappingURL=Button.cjs.map

package/dist/Button.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"Button.cjs"}

package/dist/Button.d.cts

@@ -0,0 +1,41 @@
+import * as React from 'react';
+import { IconName } from './Icon.cjs';
+
+type ButtonVariant = "default" | "primary" | "ghost" | "danger";
+type ButtonSize = "sm" | "md" | "lg";
+interface ButtonProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "type"> {
+    /** Visual variant. `primary` uses the accent color; `ghost` is borderless; `danger` is red. */
+    variant?: ButtonVariant;
+    /** Control height preset. */
+    size?: ButtonSize;
+    /** Leading icon. */
+    icon?: IconName;
+    /** Trailing icon. */
+    trailingIcon?: IconName;
+    /** Show spinner + disable interaction. */
+    loading?: boolean;
+    /** Button type attribute. Defaults to "button" to avoid accidental form submits. */
+    type?: "button" | "submit" | "reset";
+    /** Extra class names. */
+    className?: string;
+    children?: React.ReactNode;
+}
+/**
+ * `Button` — the primary action surface.
+ *
+ * @example
+ * <Button variant="primary" icon="plus">新建</Button>
+ * <Button variant="ghost" loading>保存</Button>
+ */
+declare const Button: React.ForwardRefExoticComponent<ButtonProps & React.RefAttributes<HTMLButtonElement>>;
+interface IconButtonProps extends Omit<ButtonProps, "icon" | "children"> {
+    icon: IconName;
+    tip?: string;
+    "aria-label"?: string;
+}
+/**
+ * `IconButton` — square button containing just an icon. Pair with a tooltip.
+ */
+declare const IconButton: React.ForwardRefExoticComponent<IconButtonProps & React.RefAttributes<HTMLButtonElement>>;
+
+export { Button, type ButtonProps, type ButtonSize, type ButtonVariant, IconButton, type IconButtonProps };

package/dist/Button.d.ts

@@ -0,0 +1,41 @@
+import * as React from 'react';
+import { IconName } from './Icon.js';
+
+type ButtonVariant = "default" | "primary" | "ghost" | "danger";
+type ButtonSize = "sm" | "md" | "lg";
+interface ButtonProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "type"> {
+    /** Visual variant. `primary` uses the accent color; `ghost` is borderless; `danger` is red. */
+    variant?: ButtonVariant;
+    /** Control height preset. */
+    size?: ButtonSize;
+    /** Leading icon. */
+    icon?: IconName;
+    /** Trailing icon. */
+    trailingIcon?: IconName;
+    /** Show spinner + disable interaction. */
+    loading?: boolean;
+    /** Button type attribute. Defaults to "button" to avoid accidental form submits. */
+    type?: "button" | "submit" | "reset";
+    /** Extra class names. */
+    className?: string;
+    children?: React.ReactNode;
+}
+/**
+ * `Button` — the primary action surface.
+ *
+ * @example
+ * <Button variant="primary" icon="plus">新建</Button>
+ * <Button variant="ghost" loading>保存</Button>
+ */
+declare const Button: React.ForwardRefExoticComponent<ButtonProps & React.RefAttributes<HTMLButtonElement>>;
+interface IconButtonProps extends Omit<ButtonProps, "icon" | "children"> {
+    icon: IconName;
+    tip?: string;
+    "aria-label"?: string;
+}
+/**
+ * `IconButton` — square button containing just an icon. Pair with a tooltip.
+ */
+declare const IconButton: React.ForwardRefExoticComponent<IconButtonProps & React.RefAttributes<HTMLButtonElement>>;
+
+export { Button, type ButtonProps, type ButtonSize, type ButtonVariant, IconButton, type IconButtonProps };

package/dist/Button.js

@@ -0,0 +1,4 @@
+export { Button, IconButton } from './chunk-5EYI27B6.js';
+import './chunk-GEYMWUW6.js';
+//# sourceMappingURL=Button.js.map
+//# sourceMappingURL=Button.js.map

package/dist/Button.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"Button.js"}

package/dist/Calendar-LHZELUDL.css

@@ -0,0 +1,65 @@
+/* ============ Calendar ============ */
+.calendar {
+  background: var(--bg);
+  border-radius: var(--r-lg);
+  padding: var(--gap-4);
+  box-shadow: var(--neu-out);
+  width: 320px;
+}
+.calendar-head {
+  display: flex; align-items: center; justify-content: space-between;
+  padding: 4px 4px 14px;
+}
+.calendar-title {
+  font-size: 14px; font-weight: 600;
+  display: inline-flex; align-items: center; gap: 8px;
+  cursor: pointer; padding: 6px 10px; border-radius: var(--r-sm);
+  border: none; background: transparent; color: var(--fg);
+  font-family: inherit;
+  transition: all var(--dur-fast) var(--ease);
+}
+.calendar-title:hover { background: var(--bg); box-shadow: var(--neu-flat); }
+.calendar-grid {
+  display: grid;
+  grid-template-columns: repeat(7, 1fr);
+  gap: 2px;
+}
+.calendar-dow {
+  text-align: center;
+  font-size: 10px;
+  font-weight: 600;
+  color: var(--fg-subtle);
+  text-transform: uppercase;
+  letter-spacing: 0.06em;
+  padding: 8px 0;
+}
+.calendar-cell {
+  position: relative;
+  aspect-ratio: 1;
+  display: grid; place-items: center;
+  font-size: 12px;
+  color: var(--fg);
+  border-radius: var(--r-sm);
+  cursor: pointer;
+  border: none;
+  background: transparent;
+  font-family: inherit;
+  transition: all var(--dur-fast) var(--ease);
+}
+.calendar-cell.out { color: var(--fg-subtle); opacity: 0.5; }
+.calendar-cell:hover { background: var(--bg); box-shadow: var(--neu-flat); }
+.calendar-cell.today { font-weight: 700; color: var(--accent-ink); }
+.calendar-cell.today::after {
+  content: ""; position: absolute; bottom: 4px; left: 50%;
+  width: 4px; height: 4px; border-radius: 999px;
+  background: var(--accent);
+  transform: translateX(-50%);
+}
+.calendar-cell.selected {
+  background: var(--bg);
+  box-shadow: var(--neu-in-sm);
+  color: var(--accent-ink);
+  font-weight: 600;
+}
+.calendar-cell.disabled { color: var(--fg-subtle); opacity: 0.4; cursor: not-allowed; }
+.calendar-cell.disabled:hover { background: transparent; box-shadow: none; }

package/dist/Calendar.cjs

@@ -0,0 +1,13 @@
+'use strict';
+
+var chunk7CKHWCEA_cjs = require('./chunk-7CKHWCEA.cjs');
+require('./chunk-YVO7XO4W.cjs');
+
+
+
+Object.defineProperty(exports, "Calendar", {
+  enumerable: true,
+  get: function () { return chunk7CKHWCEA_cjs.Calendar; }
+});
+//# sourceMappingURL=Calendar.cjs.map
+//# sourceMappingURL=Calendar.cjs.map

package/dist/Calendar.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"Calendar.cjs"}

package/dist/Calendar.d.cts

@@ -0,0 +1,16 @@
+import * as React from 'react';
+
+interface CalendarProps {
+    value?: Date;
+    defaultValue?: Date;
+    onChange?: (date: Date) => void;
+    /** Min selectable date. */
+    min?: Date;
+    /** Max selectable date. */
+    max?: Date;
+    className?: string;
+}
+/** `Calendar` — month-view date picker. */
+declare const Calendar: React.FC<CalendarProps>;
+
+export { Calendar, type CalendarProps };

package/dist/Calendar.d.ts

@@ -0,0 +1,16 @@
+import * as React from 'react';
+
+interface CalendarProps {
+    value?: Date;
+    defaultValue?: Date;
+    onChange?: (date: Date) => void;
+    /** Min selectable date. */
+    min?: Date;
+    /** Max selectable date. */
+    max?: Date;
+    className?: string;
+}
+/** `Calendar` — month-view date picker. */
+declare const Calendar: React.FC<CalendarProps>;
+
+export { Calendar, type CalendarProps };

package/dist/Calendar.js

@@ -0,0 +1,4 @@
+export { Calendar } from './chunk-FMG3ZPGK.js';
+import './chunk-GEYMWUW6.js';
+//# sourceMappingURL=Calendar.js.map
+//# sourceMappingURL=Calendar.js.map

package/dist/Calendar.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"Calendar.js"}

package/dist/Card-2CHHFD4Y.css

@@ -0,0 +1,28 @@
+/* ============ Card & Panel ============ */
+.card {
+  background: var(--bg);
+  border-radius: var(--r-lg);
+  box-shadow: var(--neu-out);
+  padding: var(--gap-5);
+}
+.card.flat   { box-shadow: var(--neu-flat); }
+.card.sunken { box-shadow: var(--neu-in); }
+.card.pad-none { padding: 0; }
+.card.pad-sm   { padding: var(--gap-3); }
+.card.pad-lg   { padding: var(--gap-6); }
+
+.panel {
+  background: var(--bg);
+  border-radius: var(--r-lg);
+  box-shadow: var(--neu-out);
+  padding: var(--gap-5);
+}
+.panel-head {
+  display: flex; align-items: flex-start; justify-content: space-between;
+  gap: var(--gap-3); margin-bottom: var(--gap-4);
+}
+.panel-titles { display: flex; flex-direction: column; gap: 2px; }
+.panel-title { font-size: 15px; font-weight: 600; }
+.panel-desc  { font-size: 12px; color: var(--fg-muted); }
+.panel-actions { display: flex; gap: 6px; }
+.panel-body { font-size: 13px; }

package/dist/Card.cjs

@@ -0,0 +1,16 @@
+'use strict';
+
+var chunkI2ERCHFV_cjs = require('./chunk-I2ERCHFV.cjs');
+
+
+
+Object.defineProperty(exports, "Card", {
+  enumerable: true,
+  get: function () { return chunkI2ERCHFV_cjs.Card; }
+});
+Object.defineProperty(exports, "Panel", {
+  enumerable: true,
+  get: function () { return chunkI2ERCHFV_cjs.Panel; }
+});
+//# sourceMappingURL=Card.cjs.map
+//# sourceMappingURL=Card.cjs.map

package/dist/Card.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"Card.cjs"}

package/dist/Card.d.cts

@@ -0,0 +1,25 @@
+import * as React from 'react';
+
+interface CardProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Visual variant. `raised` protrudes; `sunken` recesses; `flat` is subtle. */
+    variant?: "raised" | "sunken" | "flat";
+    /** Inner padding. */
+    padding?: "none" | "sm" | "md" | "lg";
+    children?: React.ReactNode;
+}
+/**
+ * `Card` — neumorphic surface container. Use to group related content.
+ */
+declare const Card: React.ForwardRefExoticComponent<CardProps & React.RefAttributes<HTMLDivElement>>;
+interface PanelProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "title"> {
+    title?: React.ReactNode;
+    description?: React.ReactNode;
+    actions?: React.ReactNode;
+    children?: React.ReactNode;
+}
+/**
+ * `Panel` — a titled `Card` with optional actions row.
+ */
+declare const Panel: React.FC<PanelProps>;
+
+export { Card, type CardProps, Panel, type PanelProps };

package/dist/Card.d.ts

@@ -0,0 +1,25 @@
+import * as React from 'react';
+
+interface CardProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Visual variant. `raised` protrudes; `sunken` recesses; `flat` is subtle. */
+    variant?: "raised" | "sunken" | "flat";
+    /** Inner padding. */
+    padding?: "none" | "sm" | "md" | "lg";
+    children?: React.ReactNode;
+}
+/**
+ * `Card` — neumorphic surface container. Use to group related content.
+ */
+declare const Card: React.ForwardRefExoticComponent<CardProps & React.RefAttributes<HTMLDivElement>>;
+interface PanelProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "title"> {
+    title?: React.ReactNode;
+    description?: React.ReactNode;
+    actions?: React.ReactNode;
+    children?: React.ReactNode;
+}
+/**
+ * `Panel` — a titled `Card` with optional actions row.
+ */
+declare const Panel: React.FC<PanelProps>;
+
+export { Card, type CardProps, Panel, type PanelProps };

package/dist/Card.js

@@ -0,0 +1,3 @@
+export { Card, Panel } from './chunk-OXYFB2ZI.js';
+//# sourceMappingURL=Card.js.map
+//# sourceMappingURL=Card.js.map

package/dist/Card.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"Card.js"}

package/dist/Cascader-TO2QMSLJ.css

@@ -0,0 +1,76 @@
+/* ============ Cascader ============ */
+.cascader {
+  position: relative;
+  display: inline-block;
+  min-width: 240px;
+  width: 100%;
+}
+.cascader-trigger {
+  width: 100%;
+  height: var(--ctrl-h);
+  padding: 0 36px 0 var(--ctrl-pad-x);
+  border-radius: var(--r-md);
+  background: var(--bg);
+  box-shadow: var(--neu-out-sm);
+  display: inline-flex;
+  align-items: center;
+  font-size: 13px;
+  font-family: inherit;
+  cursor: pointer;
+  position: relative;
+  border: none;
+  color: var(--fg);
+  text-align: left;
+}
+.cascader-trigger.placeholder { color: var(--fg-subtle); }
+.cascader.open .cascader-trigger { box-shadow: var(--neu-in-sm); color: var(--accent-ink); }
+.cascader-panel {
+  position: absolute;
+  top: calc(100% + 8px);
+  left: 0;
+  z-index: 50;
+  display: flex;
+  background: var(--bg);
+  border-radius: var(--r-md);
+  box-shadow: var(--neu-out-lg);
+  padding: 6px;
+  animation: menuIn var(--dur) var(--ease);
+  gap: 4px;
+}
+.cascader-col {
+  min-width: 160px;
+  max-height: 280px;
+  overflow-y: auto;
+  padding: 4px;
+  border-radius: var(--r-sm);
+}
+.cascader-col + .cascader-col {
+  border-left: 1px solid var(--divider);
+  margin-left: 2px;
+  padding-left: 6px;
+}
+.cascader-item {
+  padding: 8px 10px;
+  border-radius: var(--r-sm);
+  font-size: 13px;
+  color: var(--fg);
+  cursor: pointer;
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  transition: all var(--dur-fast) var(--ease);
+  border: none;
+  background: transparent;
+  font-family: inherit;
+  width: 100%;
+  text-align: left;
+}
+.cascader-item:hover { background: var(--bg); box-shadow: var(--neu-flat); color: var(--accent-ink); }
+.cascader-item.active {
+  background: var(--bg);
+  box-shadow: var(--neu-in-sm);
+  color: var(--accent-ink);
+  font-weight: 500;
+}
+.cascader-item .chev { margin-left: auto; color: var(--fg-subtle); display: inline-flex; }
+.cascader-item.active .chev { color: var(--accent); }

package/dist/Cascader.cjs

@@ -0,0 +1,13 @@
+'use strict';
+
+var chunkZXM247EM_cjs = require('./chunk-ZXM247EM.cjs');
+require('./chunk-YVO7XO4W.cjs');
+
+
+
+Object.defineProperty(exports, "Cascader", {
+  enumerable: true,
+  get: function () { return chunkZXM247EM_cjs.Cascader; }
+});
+//# sourceMappingURL=Cascader.cjs.map
+//# sourceMappingURL=Cascader.cjs.map

package/dist/Cascader.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"Cascader.cjs"}

package/dist/Cascader.d.cts

@@ -0,0 +1,23 @@
+import * as React from 'react';
+import { IconName } from './Icon.cjs';
+
+interface CascaderOption {
+    value: string;
+    label: React.ReactNode;
+    icon?: IconName;
+    children?: CascaderOption[];
+    disabled?: boolean;
+}
+interface CascaderProps {
+    options: CascaderOption[];
+    value?: string[];
+    defaultValue?: string[];
+    onChange?: (path: string[]) => void;
+    placeholder?: string;
+    disabled?: boolean;
+    className?: string;
+}
+/** `Cascader` — multi-column hierarchical selector. */
+declare const Cascader: React.FC<CascaderProps>;
+
+export { Cascader, type CascaderOption, type CascaderProps };