@astryx-vue/core 0.2.5 → 0.3.0

package/dist/{index-Be1czg3M.d.ts → index-BhpAUzUr.d.ts}

@@ -29,6 +29,8 @@ interface CommandPaletteProps<T extends SearchableItem = SearchableItem> {
 }
 interface CommandPaletteEmits {
   openChange: [isOpen: boolean];
+  /** Selected value in picker mode. `onValueChange` in the original API. */
+  valueChange: [value: string];
 }
 interface CommandPaletteItemSlotProps<T extends SearchableItem = SearchableItem> {
   item: T;
@@ -44,6 +46,16 @@ interface CommandPaletteInputProps {
   label?: string;
   /** @default true */
   hasAutoFocus?: boolean;
+  /**
+   * Search value. Bind with `v-model:value`.
+   * Read from the surrounding CommandPalette when omitted.
+   */
+  value?: string;
+}
+interface CommandPaletteInputEmits {
+  /** Next search value. Fired by `onValueChange` in the original API. */
+  'valueChange': [value: string];
+  'update:value': [value: string];
 }
 interface CommandPaletteListProps {
   label?: string;
@@ -54,6 +66,22 @@ interface CommandPaletteGroupProps {
 interface CommandPaletteItemProps {
   value: string;
   isDisabled?: boolean;
+  /**
+   * Whether this item is the active keyboard result.
+   * Derived from the surrounding CommandPalette when omitted.
+   * @default false
+   */
+  isHighlighted?: boolean;
+  /**
+   * Whether this item represents the selected value in picker mode.
+   * Derived from the surrounding CommandPalette when omitted.
+   * @default false
+   */
+  isSelected?: boolean;
+}
+interface CommandPaletteItemEmits {
+  /** Fired after the item is activated by pointer. */
+  select: [value: string];
 }
 //#endregion
 //#region src/CommandPalette/CommandPalette.vue.d.ts
@@ -63,13 +91,14 @@ declare const __VLS_export$6: <T extends SearchableItem>(__VLS_props: NonNullabl
   }) & {
     "onUpdate:value"?: ((value: string | undefined) => any) | undefined;
     onOpenChange?: ((isOpen: boolean) => any) | undefined;
+    onValueChange?: ((value: string) => any) | undefined;
   }> & (typeof globalThis extends {
     __VLS_PROPS_FALLBACK: infer P;
   } ? P : {});
   expose: (exposed: {}) => void;
   attrs: any;
   slots: CommandPaletteSlots<T>;
-  emit: ((evt: "openChange", isOpen: boolean) => void) & ((event: "update:value", value: string | undefined) => void);
+  emit: (((evt: "openChange", isOpen: boolean) => void) & ((evt: "valueChange", value: string) => void)) & ((event: "update:value", value: string | undefined) => void);
 }>) => import("vue").VNode & {
   __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
 };
@@ -119,11 +148,18 @@ type __VLS_WithSlots$3<T, S> = T & {
 };
 //#endregion
 //#region src/CommandPalette/CommandPaletteInput.vue.d.ts
-declare var __VLS_6: {};
-type __VLS_Slots$2 = {} & {
-  end?: (props: typeof __VLS_6) => any;
+type __VLS_Slots$2 = {
+  end?: () => unknown;
+  /** Same slot under the original prop name. */
+  endContent?: () => unknown;
 };
-declare const __VLS_base$2: import("vue").DefineComponent<CommandPaletteInputProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<CommandPaletteInputProps> & Readonly<{}>, {
+declare const __VLS_base$2: import("vue").DefineComponent<CommandPaletteInputProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+  "update:value": (value: string) => any;
+  valueChange: (value: string) => any;
+}, string, import("vue").PublicProps, Readonly<CommandPaletteInputProps> & Readonly<{
+  "onUpdate:value"?: ((value: string) => any) | undefined;
+  onValueChange?: ((value: string) => any) | undefined;
+}>, {
   hasAutoFocus: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export$2: __VLS_WithSlots$2<typeof __VLS_base$2, __VLS_Slots$2>;
@@ -139,7 +175,11 @@ declare var __VLS_1$1: {};
 type __VLS_Slots$1 = {} & {
   default?: (props: typeof __VLS_1$1) => any;
 };
-declare const __VLS_base$1: import("vue").DefineComponent<CommandPaletteItemProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<CommandPaletteItemProps> & Readonly<{}>, {
+declare const __VLS_base$1: import("vue").DefineComponent<CommandPaletteItemProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+  select: (value: string) => any;
+}, string, import("vue").PublicProps, Readonly<CommandPaletteItemProps> & Readonly<{
+  onSelect?: ((value: string) => any) | undefined;
+}>, {
   isDisabled: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export$1: __VLS_WithSlots$1<typeof __VLS_base$1, __VLS_Slots$1>;
@@ -164,4 +204,4 @@ type __VLS_WithSlots<T, S> = T & {
   };
 };
 //#endregion
-export { _default$4 as a, CommandPaletteEmits as c, CommandPaletteItemProps as d, CommandPaletteItemSlotProps as f, CommandPaletteSlots as h, _default$3 as i, CommandPaletteGroupProps as l, CommandPaletteProps as m, _default$1 as n, _default$5 as o, CommandPaletteListProps as p, _default$2 as r, _default$6 as s, _default as t, CommandPaletteInputProps as u };
+export { CommandPaletteSlots as _, _default$4 as a, CommandPaletteEmits as c, CommandPaletteInputProps as d, CommandPaletteItemEmits as f, CommandPaletteProps as g, CommandPaletteListProps as h, _default$3 as i, CommandPaletteGroupProps as l, CommandPaletteItemSlotProps as m, _default$1 as n, _default$5 as o, CommandPaletteItemProps as p, _default$2 as r, _default$6 as s, _default as t, CommandPaletteInputEmits as u };

package/dist/{index-BcJBLWJ0.d.ts → index-BkjSF265.d.ts}

@@ -1,4 +1,4 @@
-import { ComputedRef, InjectionKey, VNode } from "vue";
+import { ComputedRef, InjectionKey, MaybeRefOrGetter, Ref, VNode } from "vue";
 //#region src/Collapsible/types.d.ts
 /**
  * Logical side of the trigger label that carries the disclosure chevron.
@@ -95,6 +95,10 @@ type __VLS_WithSlots$1<T, S> = T & {
 type CollapsibleGroupDensity = 'compact' | 'balanced' | 'spacious';
 type CollapsibleGroupType = 'single' | 'multiple';
 type CollapsibleGroupValue = string | string[];
+interface CollapsibleGroupContextValue {
+  isOpen: (value: string) => boolean;
+  toggle: (value: string) => void;
+}
 //#endregion
 //#region src/Collapsible/groupTypes.d.ts
 interface CollapsibleGroupProps {
@@ -150,11 +154,11 @@ type __VLS_ModelProps = {
 };
 type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
 declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-  change: (value: CollapsibleGroupValue) => any;
   "update:value": (value: CollapsibleGroupValue | undefined) => any;
+  change: (value: CollapsibleGroupValue) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
-  onChange?: ((value: CollapsibleGroupValue) => any) | undefined;
   "onUpdate:value"?: ((value: CollapsibleGroupValue | undefined) => any) | undefined;
+  onChange?: ((value: CollapsibleGroupValue) => any) | undefined;
 }>, {
   type: CollapsibleGroupType;
   hasDividers: boolean;
@@ -168,4 +172,63 @@ type __VLS_WithSlots<T, S> = T & {
   };
 };
 //#endregion
-export { CollapsibleGroupDensity as a, _default$1 as c, CollapsibleProps as d, CollapsibleSlots as f, CollapsibleGroupSlots as i, CollapsibleChevronPosition as l, CollapsibleGroupEmits as n, CollapsibleGroupType as o, CollapsibleGroupProps as r, CollapsibleGroupValue as s, _default as t, CollapsibleEmits as u };
+//#region src/Collapsible/useCollapsible.d.ts
+/**
+ * 受控模式与默认值。传了这个对象，展开状态就不再是「自己管自己」，
+ * 而是先读 `isOpen`，读不到才用 `defaultIsOpen`。
+ */
+interface CollapsibleConfig {
+  /**
+   * 受控的展开状态，通常传 `v-model:isOpen` 的 model ref。
+   * 留空表示不受控，状态由 hook 自己保存。
+   */
+  isOpen?: Ref<boolean | undefined>;
+  /**
+   * 不受控时初始是否展开。
+   * @default true
+   */
+  defaultIsOpen?: MaybeRefOrGetter<boolean>;
+  /**
+   * 状态要变化时调用，参数是目标状态。
+   * 受控时它是「请求」，不受控时它是「通知」。
+   */
+  onOpenChange?: (isOpen: boolean) => void;
+}
+interface UseCollapsibleOptions {
+  /**
+   * 是否启用折叠能力。
+   * - `true`：自己管状态，初始展开。
+   * - `false`：关闭折叠，`isOpen` 恒为 false，`toggle` 不做任何事。
+   * - 传配置对象：做受控，或自定义默认值。
+   * @default true
+   */
+  isCollapsible?: MaybeRefOrGetter<boolean | CollapsibleConfig | undefined>;
+  /**
+   * 在 `CollapsibleGroup` 里的唯一标识。有明确值且位于组内时，展开状态由组统一管理。
+   */
+  value?: MaybeRefOrGetter<string | undefined>;
+  /**
+   * 组上下文。一般不用传，默认从最近的 `CollapsibleGroup` 注入。
+   */
+  group?: CollapsibleGroupContextValue | null;
+}
+interface UseCollapsibleReturn {
+  /** 折叠能力是否生效。`isCollapsible` 为 false 时是 false。 */
+  isEnabled: ComputedRef<boolean>;
+  /** 内容当前是否展开。 */
+  isOpen: ComputedRef<boolean>;
+  /** 切换展开状态：组内交给组，否则写受控 ref 或内部状态。 */
+  toggle: () => void;
+}
+/**
+ * 对应原版 Astryx 的 `hooks/useCollapsible`：折叠面板的状态机。
+ * 支持三种模式——组管理（在 `CollapsibleGroup` 里带 `value`）、受控（`isOpen`）、不受控。
+ * `Collapsible` 组件内部也用它，所以自定义折叠 UI 和组件本身的行为一致。
+ *
+ * ```ts
+ * const { isOpen, toggle } = useCollapsible({ isCollapsible: true })
+ * ```
+ */
+declare function useCollapsible(options?: UseCollapsibleOptions): UseCollapsibleReturn;
+//#endregion
+export { _default as a, CollapsibleGroupSlots as c, CollapsibleGroupValue as d, _default$1 as f, CollapsibleSlots as g, CollapsibleProps as h, useCollapsible as i, CollapsibleGroupDensity as l, CollapsibleEmits as m, UseCollapsibleOptions as n, CollapsibleGroupEmits as o, CollapsibleChevronPosition as p, UseCollapsibleReturn as r, CollapsibleGroupProps as s, CollapsibleConfig as t, CollapsibleGroupType as u };

package/dist/{index-DxR1FChm.d.ts → index-Bu8NA2SD.d.ts}

@@ -15,10 +15,18 @@ interface BaseTypeaheadProps<T extends SearchableItem = SearchableItem> {
   inputId?: string;
   /** 外面已经算好的说明和状态 id。 */
   describedBy?: string;
+  /** `aria-describedby` 的专用别名。给了就盖过原生属性。 */
+  ariaDescribedBy?: string;
+  /** `aria-labelledby` 的专用别名。给了就盖过原生属性。 */
+  ariaLabelledBy?: string;
+  /** 下拉挂靠的元素。不传就用输入框所在的外框。 */
+  anchorRef?: HTMLElement | null;
   placeholder?: string;
   disabled?: boolean;
   /** 禁用原因。有值时控件仍可聚焦，方便读到原因。 */
   disabledReason?: string;
+  /** 强制让禁用的控件还能聚焦，读屏能读到外部说明。 */
+  isFocusableDisabled?: boolean;
   /** 输入框边框的校验色。说明文字由外面的字段负责。 */
   status?: TypeaheadStatus;
   size?: TypeaheadSize;
@@ -28,12 +36,24 @@ interface BaseTypeaheadProps<T extends SearchableItem = SearchableItem> {
   debounceMs?: number;
   /** 下拉最多显示多少条。 */
   maxMenuItems?: number;
+  /** 下拉想要的宽度，单位像素。太宽时会被视口截住。 */
+  menuWidth?: number;
+  /** 少于这么多字符就不搜，下拉也不打开。按可见字符数。 */
+  minQueryLength?: number;
   /** 聚焦时还没输入就展示结果。 */
   showOnFocus?: boolean;
-  emptyText?: string;
+  /** `showOnFocus` 的原版名。 */
+  hasEntriesOnFocus?: boolean;
+  /** 挂载后自动聚焦输入框。 */
+  hasAutoFocus?: boolean;
+  emptyText?: string | null;
+  /** 一条结果都没有时显示的内容。`null` 当作没给。 */
+  emptySearchText?: string | null;
   required?: boolean;
   /** 表单字段名。选中后提交条目的 id。 */
   name?: string;
+  /** 输入框在 Tab 序里的位置。 */
+  inputTabIndex?: number;
 }
 interface TypeaheadProps<T extends SearchableItem = SearchableItem> {
   /** 当前选中的条目。空表示还没选。 */
@@ -46,22 +66,36 @@ interface TypeaheadProps<T extends SearchableItem = SearchableItem> {
   labelHidden?: boolean;
   /** 标签下方的说明。 */
   description?: string;
+  /** 标签旁边信息图标里的提示文字。 */
+  labelTooltip?: string;
   placeholder?: string;
   disabled?: boolean;
   /** 禁用原因。有值时控件仍可聚焦，方便读到原因。 */
   disabledReason?: string;
+  /** `disabledReason` 的原版名。 */
+  disabledMessage?: string;
   status?: TypeaheadStatus;
   statusMessage?: string;
   size?: TypeaheadSize;
   /** 显示清除按钮。 */
   clearable?: boolean;
+  /** `clearable` 的原版名。 */
+  hasClear?: boolean;
   /** 输入停顿后再搜索，单位毫秒。本地数据可设为 0。 */
   debounceMs?: number;
   /** 下拉最多显示多少条。 */
   maxMenuItems?: number;
+  /** 少于这么多字符就不搜，下拉也不打开。按可见字符数。 */
+  minQueryLength?: number;
   /** 聚焦时还没输入就展示结果。 */
   showOnFocus?: boolean;
-  emptyText?: string;
+  /** `showOnFocus` 的原版名。 */
+  hasEntriesOnFocus?: boolean;
+  /** 挂载后自动聚焦输入框。 */
+  hasAutoFocus?: boolean;
+  emptyText?: string | null;
+  /** 一条结果都没有时显示的内容。`null` 当作没给。 */
+  emptySearchText?: string | null;
   required?: boolean;
   optional?: boolean;
   /** 表单字段名。选中后提交条目的 id。 */
@@ -72,6 +106,8 @@ interface TypeaheadEmits<T extends SearchableItem = SearchableItem> {
   'update:modelValue': [value: T | null];
   'change': [value: T | null];
   'search': [query: string];
+  /** `search` 的原版名。 */
+  'changeQuery': [query: string];
   'openChange': [isOpen: boolean];
 }
 interface TypeaheadItemProps {
@@ -79,6 +115,11 @@ interface TypeaheadItemProps {
   item: SearchableItem;
   /** 盖过条目自己的说明。 */
   description?: string;
+  /**
+   * 分组标题。默认行不画标题，分组由下拉按 `item.auxiliaryData.group` 自己排，
+   * 这个属性只为和外部同名属性对得上而接受。
+   */
+  group?: string;
   /** 这一行看起来不可选。 */
   isDisabled?: boolean;
 }
@@ -100,8 +141,9 @@ declare const __VLS_export$2: <T extends SearchableItem>(__VLS_props: NonNullabl
   props: import("vue").PublicProps & __VLS_PrettifyLocal$1<BaseTypeaheadProps<T> & {
     onChange?: ((value: T | null) => any) | undefined;
     onSearch?: ((query: string) => any) | undefined;
-    "onUpdate:modelValue"?: ((value: T | null) => any) | undefined;
     onOpenChange?: ((isOpen: boolean) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: T | null) => any) | undefined;
+    onChangeQuery?: ((query: string) => any) | undefined;
   }> & (typeof globalThis extends {
     __VLS_PROPS_FALLBACK: infer P;
   } ? P : {});
@@ -111,7 +153,7 @@ declare const __VLS_export$2: <T extends SearchableItem>(__VLS_props: NonNullabl
   }>) => void;
   attrs: any;
   slots: TypeaheadSlots<T>;
-  emit: ((evt: "change", value: T | null) => void) & ((evt: "search", query: string) => void) & ((evt: "update:modelValue", value: T | null) => void) & ((evt: "openChange", isOpen: boolean) => void);
+  emit: ((evt: "change", value: T | null) => void) & ((evt: "search", query: string) => void) & ((evt: "openChange", isOpen: boolean) => void) & ((evt: "update:modelValue", value: T | null) => void) & ((evt: "changeQuery", query: string) => void);
 }>) => import("vue").VNode & {
   __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
 };
@@ -123,8 +165,9 @@ declare const __VLS_export$1: <T extends SearchableItem>(__VLS_props: NonNullabl
   props: import("vue").PublicProps & __VLS_PrettifyLocal<TypeaheadProps<T> & {
     onChange?: ((value: T | null) => any) | undefined;
     onSearch?: ((query: string) => any) | undefined;
-    "onUpdate:modelValue"?: ((value: T | null) => any) | undefined;
     onOpenChange?: ((isOpen: boolean) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: T | null) => any) | undefined;
+    onChangeQuery?: ((query: string) => any) | undefined;
   }> & (typeof globalThis extends {
     __VLS_PROPS_FALLBACK: infer P;
   } ? P : {});
@@ -134,7 +177,7 @@ declare const __VLS_export$1: <T extends SearchableItem>(__VLS_props: NonNullabl
   }>) => void;
   attrs: any;
   slots: TypeaheadSlots<T>;
-  emit: ((evt: "change", value: T | null) => void) & ((evt: "search", query: string) => void) & ((evt: "update:modelValue", value: T | null) => void) & ((evt: "openChange", isOpen: boolean) => void);
+  emit: ((evt: "change", value: T | null) => void) & ((evt: "search", query: string) => void) & ((evt: "openChange", isOpen: boolean) => void) & ((evt: "update:modelValue", value: T | null) => void) & ((evt: "changeQuery", query: string) => void);
 }>) => import("vue").VNode & {
   __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
 };

package/dist/{index-HV6W3xCx.d.ts → index-Byar3h1e.d.ts}

@@ -18,8 +18,8 @@ type __VLS_Slots = {} & {
   label?: (props: typeof __VLS_1) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<DividerProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<DividerProps> & Readonly<{}>, {
-  variant: DividerVariant;
   orientation: DividerOrientation;
+  variant: DividerVariant;
   isFullBleed: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;

package/dist/{index-C-QpeUlQ.d.ts → index-C2nbK2AA.d.ts}

@@ -1,3 +1,4 @@
+import { s as NavLinkComponent } from "./types-BG23kC3S.js";
 import { ComputedRef, Ref } from "vue";
 //#region src/TabList/types.d.ts
 type TabListSize = 'sm' | 'md' | 'lg';
@@ -36,6 +37,20 @@ interface TabListProps {
    * when this is omitted.
    */
   edgeCompensation?: TabListEdgeCompensation;
+  /**
+   * ARIA role for the strip.
+   *
+   * `tablist` asks for the WAI-ARIA tabs pattern: `role="tab"` and
+   * `aria-selected` on every tab, and each tab points at the panel it
+   * controls through its `panelId`. Only tabs belong in a tablist strip, and
+   * a tab's `href` is ignored there.
+   *
+   * Left unset, the strip is a navigation landmark that marks the current tab
+   * with `aria-current`, and tabs with an `href` render as links.
+   *
+   * Any other value is passed through to the element unchanged.
+   */
+  role?: string;
 }
 interface TabMenuOption {
   value: string;
@@ -57,8 +72,14 @@ interface TabProps {
    * Unique value for this tab.
    */
   value: string;
+  /**
+   * Visible text of the tab. Used as `aria-label` when `isLabelHidden` is set.
+   * The default slot wins when both are given.
+   */
+  label?: string;
   /**
    * ID of the controlled panel for aria-controls.
+   * Only used inside a `role="tablist"` strip.
    */
   panelId?: string;
   /**
@@ -66,6 +87,32 @@ interface TabProps {
    * @default false
    */
   disabled?: boolean;
+  /**
+   * URL to navigate to. Outside the tabs pattern the tab renders as a link.
+   * Ignored inside a `role="tablist"` strip.
+   */
+  href?: string;
+  /**
+   * Link root component, such as a router link. Only applies when `href` is
+   * given and the strip is not a tablist.
+   */
+  as?: NavLinkComponent;
+  /**
+   * Visually hides the label. Only the icon and the end content show, and
+   * `label` becomes the accessible name.
+   * @default false
+   */
+  isLabelHidden?: boolean;
+}
+interface TabSlots {
+  /** Visible text. Falls back to the `label` prop. */
+  default?: () => unknown;
+  /** Icon shown while the tab is not selected. */
+  icon?: () => unknown;
+  /** Icon shown while the tab is selected. Falls back to `icon`. */
+  selectedIcon?: () => unknown;
+  /** Content after the label, such as a badge count or a status dot. */
+  endContent?: () => unknown;
 }
 interface TabListTab {
   value: string;
@@ -80,11 +127,9 @@ interface TabListTab {
 }
 //#endregion
 //#region src/TabList/Tab.vue.d.ts
-declare var __VLS_1: {};
-type __VLS_Slots$1 = {} & {
-  default?: (props: typeof __VLS_1) => any;
-};
+type __VLS_Slots$1 = TabSlots;
 declare const __VLS_base$1: import("vue").DefineComponent<TabProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<TabProps> & Readonly<{}>, {
+  isLabelHidden: boolean;
   disabled: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export$2: __VLS_WithSlots$1<typeof __VLS_base$1, __VLS_Slots$1>;
@@ -100,11 +145,11 @@ type __VLS_Slots = {
   default: () => unknown;
 };
 declare const __VLS_base: import("vue").DefineComponent<TabListProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
-  change: (value: string) => any;
   "update:value": (value: string) => any;
+  change: (value: string) => any;
 }, string, import("vue").PublicProps, Readonly<TabListProps> & Readonly<{
-  onChange?: ((value: string) => any) | undefined;
   "onUpdate:value"?: ((value: string) => any) | undefined;
+  onChange?: ((value: string) => any) | undefined;
 }>, {
   size: TabListSize;
   isFullBleed: boolean;
@@ -123,4 +168,4 @@ type __VLS_WithSlots<T, S> = T & {
 declare const __VLS_export: import("vue").DefineComponent<TabMenuProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<TabMenuProps> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 //#endregion
-export { TabListProps as a, TabMenuOption as c, TabListLayout as i, TabMenuProps as l, _default$1 as n, TabListSize as o, _default$2 as r, TabListTab as s, _default as t, TabProps as u };
+export { TabListProps as a, TabMenuOption as c, TabSlots as d, TabListLayout as i, TabMenuProps as l, _default$1 as n, TabListSize as o, _default$2 as r, TabListTab as s, _default as t, TabProps as u };

package/dist/{index-iBLzInje.d.ts → index-C5e-7Obr.d.ts}

@@ -1,4 +1,4 @@
-import { a as FieldSlots, l as FieldStatusVariant, n as FieldLabelSlots, r as FieldProps, t as FieldLabelProps } from "./types-3eXh_5os.js";
+import { a as FieldSlots, l as FieldStatusVariant, n as FieldLabelSlots, r as FieldProps, t as FieldLabelProps } from "./types-0Q_SJv_F.js";
 //#region src/Field/Field.vue.d.ts
 type __VLS_Slots$1 = FieldSlots;
 declare const __VLS_base$1: import("vue").DefineComponent<FieldProps, {

package/dist/index-CEv_AvOg.d.ts

@@ -0,0 +1,17 @@
+import { i as SectionVariant, n as SectionProps, r as SectionSlots } from "./types-uFMH9NaM.js";
+//#region src/Section/Section.vue.d.ts
+type __VLS_Slots = SectionSlots;
+declare const __VLS_base: import("vue").DefineComponent<SectionProps, {
+  element: Readonly<import("vue").ShallowRef<HTMLDivElement | null>>;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<SectionProps> & Readonly<{}>, {
+  variant: SectionVariant;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+type __VLS_WithSlots<T, S> = T & {
+  new (): {
+    $slots: S;
+  };
+};
+//#endregion
+export { _default as t };

package/dist/{index-Dgg0bHVM.d.ts → index-CICeEoZV.d.ts}

@@ -1,4 +1,4 @@
-import { a as TextProps, c as TextType, i as TextJustify, n as TextColor, r as TextDisplay, s as TextTruncateTooltip, t as TextAs } from "./types-D9nP_X-c.js";
+import { a as TextProps, c as TextType, i as TextJustify, n as TextColor, r as TextDisplay, s as TextTruncateTooltip, t as TextAs } from "./types-Ckih2YJi.js";
 //#region src/Text/Text.vue.d.ts
 declare var __VLS_13: {}, __VLS_21: {};
 type __VLS_Slots = {} & {
@@ -10,6 +10,7 @@ declare const __VLS_base: import("vue").DefineComponent<TextProps, {}, {}, {}, {
   type: TextType;
   as: TextAs;
   color: TextColor;
+  hasCapsize: boolean;
   display: TextDisplay;
   justify: TextJustify;
   maxLines: number;

package/dist/{index-CB9Srua5.d.ts → index-CL1T2j4y.d.ts}

@@ -1,8 +1,11 @@
 import { a as NavItemSize, i as NavItemProps, n as NavIconSlots, o as NavItemSlots, s as NavLinkComponent, t as NavIconProps } from "./types-BG23kC3S.js";
 import { Component } from "vue";
 //#region src/NavItem/link.d.ts
-/** 有可用地址时用链接组件，否则用按钮。禁用的地址也不走链接。 */
-declare function resolveNavRoot(href: string | undefined, isDisabled: boolean, as?: NavLinkComponent): string | Component;
+/**
+ * 有可用地址时用链接组件，否则用按钮。禁用的地址也不走链接。
+ * `fallback` 是外层的默认链接组件，例如 `LinkProvider` 给的那个；`as` 写了就以 `as` 为准。
+ */
+declare function resolveNavRoot(href: string | undefined, isDisabled: boolean, as?: NavLinkComponent, fallback?: NavLinkComponent): string | Component;
 //#endregion
 //#region src/NavItem/NavIcon.vue.d.ts
 type __VLS_Slots$1 = NavIconSlots;
@@ -24,10 +27,10 @@ declare const __VLS_base: import("vue").DefineComponent<NavItemProps, {}, {}, {}
 }, string, import("vue").PublicProps, Readonly<NavItemProps> & Readonly<{
   onClick?: ((event: MouseEvent) => any) | undefined;
 }>, {
-  isSelected: boolean;
-  isDisabled: boolean;
   size: NavItemSize;
+  isDisabled: boolean;
   isIconOnly: boolean;
+  isSelected: boolean;
   block: boolean;
   plain: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;

package/dist/{index-DjMwF8ET.d.ts → index-COgrQZIL.d.ts}

@@ -20,6 +20,11 @@ interface ProgressBarProps {
   isLabelHidden?: boolean;
   description?: string;
   isIndeterminate?: boolean;
+  /**
+   * 变灰的禁用外观：填充和文字都降为次要色。用于已取消或不再进行的任务。
+   * @default false
+   */
+  isDisabled?: boolean;
   /** 在标签旁显示当前进度。`hasValueLabel` 是同一开关。 */
   showValue?: boolean;
   /** 与 `showValue` 相同，对齐原版属性名。 */
@@ -38,9 +43,10 @@ interface ProgressBarProps {
 //#endregion
 //#region src/ProgressBar/ProgressBar.vue.d.ts
 declare const __VLS_export: import("vue").DefineComponent<ProgressBarProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<ProgressBarProps> & Readonly<{}>, {
-  variant: ProgressBarVariant;
   size: ProgressBarSize;
+  isDisabled: boolean;
   value: number;
+  variant: ProgressBarVariant;
   isLabelHidden: boolean;
   min: number;
   max: number;

package/dist/{index-Ca8VIE4l.d.ts → index-CVn0GBdB.d.ts}

@@ -85,8 +85,8 @@ interface StepSlots {
 type __VLS_Slots$1 = StepSlots;
 declare const __VLS_base$1: import("vue").DefineComponent<StepProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<StepProps> & Readonly<{}>, {
   isDisabled: boolean;
-  indicator: StepIndicator;
   isOptional: boolean;
+  indicator: StepIndicator;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export$1: __VLS_WithSlots$1<typeof __VLS_base$1, __VLS_Slots$1>;
 declare const _default$1: typeof __VLS_export$1;

package/dist/{index-ChWlKHjc.d.ts → index-Cde5JvtX.d.ts}

@@ -1,7 +1,7 @@
 import { s as ButtonSize } from "./types-WlmsNL1I.js";
-import { l as FieldStatusVariant, o as FieldStatusInput } from "./types-3eXh_5os.js";
 import { t as ExtendedIconName } from "./types-CwyibrRB.js";
-import { r as PopoverPlacement, t as PopoverAlignment } from "./types-Db3Owy8Q.js";
+import { l as FieldStatusVariant, o as FieldStatusInput } from "./types-0Q_SJv_F.js";
+import { r as PopoverPlacement, t as PopoverAlignment } from "./types-OGMYGejX.js";
 import { Component, Ref, VNode } from "vue";
 //#region src/ComplexSelector/types.d.ts
 interface ComplexSelectorState {
@@ -108,6 +108,15 @@ interface ComplexSelectorProps<Value = unknown> {
 }
 interface ComplexSelectorEmits<Value> {
   change: [value: Value];
+  /**
+   * 触发器上的点击。打开之前先执行，event.preventDefault() 可以让弹层不打开。
+   * 用 trigger 插槽或 renderTrigger 自己画触发器时，它在开关之后执行，取消不了。
+   */
+  click: [event: MouseEvent];
+  /** 触发器上的按键。内置处理（包括 ArrowDown 打开）之后执行，每个键都会收到。 */
+  keydown: [event: KeyboardEvent];
+  /** 弹层每次开或关都会触发：触发器、键盘、点外面、Escape、close() 或命令式 handle。 */
+  openChange: [isOpen: boolean];
 }
 interface ComplexSelectorSlots<Value> {
   default?: (props: ComplexSelectorSlotProps<Value>) => VNode[];
@@ -124,6 +133,9 @@ declare const __VLS_export: <Value>(__VLS_props: NonNullable<Awaited<typeof __VL
     modelValue: Value;
   }) & {
     onChange?: ((value: Value) => any) | undefined;
+    onClick?: ((event: MouseEvent) => any) | undefined;
+    onKeydown?: ((event: KeyboardEvent) => any) | undefined;
+    onOpenChange?: ((isOpen: boolean) => any) | undefined;
     "onUpdate:modelValue"?: ((value: Value) => any) | undefined;
   }> & (typeof globalThis extends {
     __VLS_PROPS_FALLBACK: infer P;
@@ -131,7 +143,7 @@ declare const __VLS_export: <Value>(__VLS_props: NonNullable<Awaited<typeof __VL
   expose: (exposed: import("vue").ShallowUnwrapRef<ComplexSelectorHandle>) => void;
   attrs: any;
   slots: ComplexSelectorSlots<Value>;
-  emit: ((evt: "change", value: Value) => void) & ((event: "update:modelValue", value: Value) => void);
+  emit: (((evt: "change", value: Value) => void) & ((evt: "click", event: MouseEvent) => void) & ((evt: "keydown", event: KeyboardEvent) => void) & ((evt: "openChange", isOpen: boolean) => void)) & ((event: "update:modelValue", value: Value) => void);
 }>) => import("vue").VNode & {
   __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
 };

package/dist/index-CitZGSn0.d.ts

@@ -0,0 +1,39 @@
+import { Component, ComputedRef, InjectionKey } from "vue";
+//#region src/LinkProvider/context.d.ts
+/** 最近的 `LinkProvider` 给的链接组件。 */
+declare const linkComponentKey: InjectionKey<Component>;
+/**
+ * 子树默认使用的链接组件。没有 provider 时是 `undefined`，
+ * 各处退回自己原来的 `<a>`。
+ *
+ * 组件自己的 `as` 属性优先，所以用的时候写 `props.as ?? linkComponent.value`。
+ */
+declare function useLinkComponent(): ComputedRef<Component | undefined>;
+//#endregion
+//#region src/LinkProvider/types.d.ts
+/** 子树里所有链接默认使用的组件，例如 `RouterLink` 或 `NuxtLink`。 */
+type LinkComponentType = Component;
+interface LinkProviderProps {
+  /**
+   * 子树里所有链接元素默认渲染成这个组件，例如 `RouterLink`。
+   * 组件会收到 `href` 和 `to`。单个组件自己的 `as` 属性仍然优先。
+   */
+  component: LinkComponentType;
+}
+interface LinkProviderSlots {
+  /** 使用这个链接组件的子树。 */
+  default?: () => unknown;
+}
+//#endregion
+//#region src/LinkProvider/LinkProvider.vue.d.ts
+type __VLS_Slots = LinkProviderSlots;
+declare const __VLS_base: import("vue").DefineComponent<LinkProviderProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<LinkProviderProps> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+type __VLS_WithSlots<T, S> = T & {
+  new (): {
+    $slots: S;
+  };
+};
+//#endregion
+export { linkComponentKey as a, LinkProviderSlots as i, LinkComponentType as n, useLinkComponent as o, LinkProviderProps as r, _default as t };