@astryx-vue/core 0.3.0 → 0.4.1

package/dist/index-CKUfpmFL.d.ts

@@ -0,0 +1,375 @@
+//#region src/utils/chainEventHandlers.d.ts
+/**
+ * 把多个事件处理函数串成一个。每个函数都会按参数顺序执行。
+ *
+ * 和「前一个调用了 preventDefault 就跳过后面」不同：组件自己的处理函数
+ * 不能把事件藏起来，调用方也不能用 preventDefault 取消组件的行为。
+ */
+declare function chainEventHandlers<E>(...handlers: (((event: E) => void) | undefined)[]): (event: E) => void;
+//#endregion
+//#region src/utils/dateTypes.d.ts
+/**
+ * ISO 8601 date string in YYYY-MM-DD format.
+ * Example: "2026-01-28"
+ */
+type ISODateString = `${number}${number}${number}${number}-${number}${number}-${number}${number}`;
+/** Day of week: 0 = Sunday through 6 = Saturday */
+type DayOfWeek = 0 | 1 | 2 | 3 | 4 | 5 | 6;
+/**
+ * Three-letter lowercase weekday name, 'sun' through 'sat'.
+ * A more self-documenting alternative to the numeric {@link DayOfWeek}.
+ */
+type DayOfWeekName = 'sun' | 'mon' | 'tue' | 'wed' | 'thu' | 'fri' | 'sat';
+/**
+ * Normalize a weekday to its numeric {@link DayOfWeek}. Accepts either a
+ * number (0–6) or a three-letter day name ('sun'–'sat', case-insensitive),
+ * so APIs like `weekStartsOn` can take whichever is more readable at the
+ * call site. Unrecognized values fall back to 0 (Sunday).
+ */
+declare function normalizeDayOfWeek(value: DayOfWeek | DayOfWeekName): DayOfWeek;
+/** Immutable date record with 1-based month. */
+interface PlainDate {
+  readonly year: number;
+  /** 1-based (1 = January, 12 = December) */
+  readonly month: number;
+  readonly day: number;
+}
+//#endregion
+//#region src/utils/plainDate.d.ts
+declare function plainDateCreate(year: number, month: number, day: number): PlainDate;
+declare function plainDateFromISO(str: ISODateString): PlainDate;
+declare function plainDateToISO(pd: PlainDate): ISODateString;
+declare function plainDateToDate(pd: PlainDate): Date;
+declare function plainDateFromDate(d: Date): PlainDate;
+declare function plainDateToday(): PlainDate;
+declare function getDaysInMonth(year: number, month: number): number;
+declare function plainDateDayOfWeek(pd: PlainDate): number;
+declare function plainDateAddMonths(pd: PlainDate, n: number): PlainDate;
+declare function plainDateAddDays(pd: PlainDate, n: number): PlainDate;
+/**
+ * Whole calendar days from `a` to `b`, ignoring time of day. Positive when
+ * `b` is after `a`, negative when before. Uses UTC midnight so DST shifts
+ * never add or drop a day.
+ */
+declare function plainDateDiffDays(a: PlainDate, b: PlainDate): number;
+/**
+ * The wall-clock fields an instant reads as in a given zone.
+ *
+ * A fixed `'en-US'` locale with `hourCycle: 'h23'` keeps the parts numeric and
+ * stable whatever locale the viewer has, so callers can assemble machine
+ * shapes (`YYYY-MM-DD`, `HH:mm:ss`) from them. Exported for Timestamp, whose
+ * `system_*` formats are built from these fields rather than through `Intl`
+ * formatting.
+ */
+declare function getTimeZoneParts(instant: number, timezoneID: string): {
+  year: number;
+  month: number;
+  day: number;
+  hour: number;
+  minute: number;
+  second: number;
+};
+declare function plainDateToInstant(date: PlainDate, timezoneID: string, hour?: number, minute?: number): number;
+declare function plainDateFromInstant(instant: number, timezoneID: string): PlainDate;
+declare function plainDateIsBefore(a: PlainDate, b: PlainDate): boolean;
+declare function plainDateIsAfter(a: PlainDate, b: PlainDate): boolean;
+declare function plainDateIsEqual(a: PlainDate, b: PlainDate): boolean;
+declare function plainDateMax(a: PlainDate, b: PlainDate): PlainDate;
+declare function plainDateMin(a: PlainDate, b: PlainDate): PlainDate;
+declare function plainDateIsInRange(pd: PlainDate, range: [PlainDate, PlainDate]): boolean;
+declare function plainDateSetFirstOfMonth(pd: PlainDate): PlainDate;
+declare function plainDateSetStartOfWeek(pd: PlainDate, weekStartsOn: number): PlainDate;
+declare function plainDateSetEndOfWeekExclusive(pd: PlainDate, weekStartsOn: number): PlainDate;
+declare function plainDateGetWeekNumber(pd: PlainDate): number;
+declare const DATE_FORMAT_WITH_WEEKDAY: Intl.DateTimeFormatOptions;
+declare const DATE_FORMAT_SHORT_WITH_WEEKDAY: Intl.DateTimeFormatOptions;
+declare const DATE_FORMAT_LONG: Intl.DateTimeFormatOptions;
+declare const DATE_FORMAT_MONTH_YEAR: Intl.DateTimeFormatOptions;
+declare const DATE_FORMAT_WEEKDAY_ONLY: Intl.DateTimeFormatOptions;
+declare const DATE_FORMAT_MONTH_ONLY: Intl.DateTimeFormatOptions;
+declare const DATE_FORMAT_SHORT: Intl.DateTimeFormatOptions;
+declare const DATE_FORMAT_SHORT_WITH_YEAR: Intl.DateTimeFormatOptions;
+/**
+ * Format a `PlainDate` for display.
+ *
+ * The locale defaults to the same `'en'` fallback as `useLocale()`, avoiding
+ * runtime-dependent output when no provider locale is available. Astryx date
+ * APIs currently model Gregorian dates, so this helper defaults to Gregorian
+ * when `options.calendar` is omitted. The explicit option remains supported for
+ * compatibility with the public `Intl.DateTimeFormatOptions` signature; it is a
+ * display-only escape hatch and does not change PlainDate arithmetic, parsing,
+ * serialization, or any Astryx component's calendar semantics.
+ */
+declare function plainDateFormat(pd: PlainDate, options: Intl.DateTimeFormatOptions, locale?: string): string;
+/**
+ * The locale's name for the "week of year" date field ("week", "Woche", "週"),
+ * from CLDR through `Intl.DisplayNames`. Calendar names its week-number
+ * column header with it, so no catalog string is needed for a word the
+ * platform already carries in every locale.
+ *
+ * `Intl.DisplayNames` with `type: 'dateTimeField'` is inside the Baseline − 2
+ * support tier (Chrome 106, Safari 15.4, Firefox 110). Should a host lack it
+ * or return nothing, the field's English CLDR name stands in rather than an
+ * empty header.
+ */
+declare function plainDateWeekFieldName(locale?: string): string;
+/**
+ * The date-only members of Timestamp's `format` vocabulary that a
+ * calendar-date field (no time-of-day) can render. Both Timestamp and
+ * DateInput share these string literals and the mapping below so that the same
+ * literal renders the same date shape in either component.
+ *
+ * - `date`: locale short-month date, e.g. "Mar 21, 2026"
+ * - `date_long`: locale long-month date, e.g. "March 21, 2026"
+ * - `date_weekday`: short weekday + short-month date, e.g. "Wed, Mar 21, 2026"
+ * - `system_date`: ISO 8601 calendar date, e.g. "2026-03-21"
+ */
+type SharedDateFormat = 'date' | 'date_long' | 'date_weekday' | 'system_date';
+/**
+ * Intl option bags for the locale-aware shared date members. `system_date` is
+ * intentionally absent — it is emitted as a fixed ISO `YYYY-MM-DD` string, not
+ * via `Intl` — and is handled directly by {@link formatSharedDate}.
+ *
+ * This is the single source of truth consumed by both Timestamp's
+ * `formatTimestamp` switch and DateInput's display path, so the two never
+ * drift for the members they share.
+ */
+declare const SHARED_DATE_FORMAT_OPTIONS: Record<Exclude<SharedDateFormat, 'system_date'>, Intl.DateTimeFormatOptions>;
+/**
+ * Renders a {@link PlainDate} using one of the {@link SharedDateFormat}
+ * members. The shared entry point DateInput uses for the named-format path;
+ * Timestamp maps the same members onto {@link SHARED_DATE_FORMAT_OPTIONS} in
+ * its own `formatTimestamp` switch (its input is a `Date`, not a `PlainDate`).
+ */
+declare function formatSharedDate(pd: PlainDate, format: SharedDateFormat, locale?: string): string;
+//#endregion
+//#region src/utils/dateParser.d.ts
+/**
+ * Detects if the locale uses day-first date format (DD/MM/YYYY).
+ * US and a few others use month-first (MM/DD/YYYY).
+ */
+declare function isLocaleDayFirst(locale?: string): boolean;
+/**
+ * Parses user input into a PlainDate.
+ *
+ * Supports ISO dates, English month names, and ASCII numeric dates with or
+ * without a year. For ambiguous ASCII numeric input where both fields are at
+ * most 12, `locale` selects month-first versus day-first order. It does not
+ * localize month-name parsing, accept non-ASCII digits, or provide a general
+ * locale-aware parser.
+ *
+ * @returns PlainDate if valid, null if unparseable
+ */
+declare function parseDateInput(input: string, locale?: string): PlainDate | null;
+//#endregion
+//#region src/utils/groupItems.d.ts
+/**
+ * 能按组摆放的条目。分组标题写在 `auxiliaryData.group`。
+ */
+interface GroupableItem {
+  auxiliaryData?: unknown;
+  [extra: string]: unknown;
+}
+/** 一组条目。`heading` 为 null 表示这组没有标题。 */
+interface ItemGroup<T> {
+  heading: string | null;
+  items: T[];
+}
+interface GroupItemsOptions {
+  /** 没有组名的条目放在有名字的组前面。默认放在最后。 */
+  ungroupedFirst?: boolean;
+}
+/** 读出条目上的组名。不是字符串就不算分组。空字符串仍算一个组名。 */
+declare function getItemGroup(item: GroupableItem): string | undefined;
+/**
+ * 按 `auxiliaryData.group` 分组，组的先后跟它们第一次出现的顺序。
+ * 没有任何组名时，返回一组 `heading: null`。
+ */
+declare function groupItems<T extends GroupableItem>(items: readonly T[], { ungroupedFirst }?: GroupItemsOptions): ItemGroup<T>[];
+//#endregion
+//#region src/utils/inputAria.d.ts
+interface InputARIAInputGroup {
+  /** ID of the visible InputGroup label. */
+  labelID: string;
+  /** Space-separated IDs for InputGroup description/status text. */
+  describedByIDs?: string;
+}
+interface InputARIA {
+  /** Value for aria-labelledby on the input. */
+  ariaLabelledBy?: string;
+  /** Value for aria-describedby on the input. */
+  ariaDescribedBy?: string;
+}
+type AriaID = string | null | undefined | false;
+declare function joinAriaIDs(...values: AriaID[]): string | undefined;
+/**
+ * Builds ARIA label/description wiring for an input.
+ *
+ * Standalone inputs keep their normal native label association. Grouped inputs
+ * are named by the visible InputGroup label plus their own input label, and
+ * inherit group description/status text in addition to input-local text.
+ */
+declare function getInputARIA(labelID: string, describedByIDs?: AriaID[], inputGroup?: InputARIAInputGroup | null): InputARIA;
+//#endregion
+//#region src/utils/inputPresentation.d.ts
+/** Picker-surface policy for date/time inputs (`spec:AST-043` FR1). */
+type InputPresentation = 'text-input' | 'popover' | 'bottom-sheet' | 'native' | 'adaptive-bottom-sheet' | 'adaptive-native';
+/** `presentation` for components without a text-only surface: all except `TimeInput` exclude `text-input` (AST-043). */
+type PickerPresentation = Exclude<InputPresentation, 'text-input'>;
+/** The surface a resolved `InputPresentation` actually renders. */
+type InputPresentationSurface = 'text-input' | 'desktop' | 'sheet' | 'native';
+/** The surface a resolved `PickerPresentation` renders: one where a picker opens. */
+type PickerPresentationSurface = Exclude<InputPresentationSurface, 'text-input'>;
+/** Deprecated picker policy (`spec:AST-043` FR3). */
+type LegacyNativePicker = 'touch' | 'always' | 'never';
+/**
+ * Typed as the narrower policy because the default opens a picker for every
+ * component; it is still a valid `InputPresentation`.
+ */
+declare const DEFAULT_INPUT_PRESENTATION: PickerPresentation;
+/**
+ * Map a deprecated `nativePicker` value to its `presentation` equivalent for
+ * a component whose every surface opens a picker (`DateInput`,
+ * `DateTimeInput`). Their released `never` was Astryx's own pickers on every
+ * pointer, so no value maps to `text-input` — which is what lets the return
+ * type exclude it.
+ */
+declare function pickerPresentationFromNativePicker(nativePicker: LegacyNativePicker): PickerPresentation;
+/**
+ * Map a deprecated `nativePicker` value to its `presentation` equivalent.
+ * `TimeInput` differs: its released `never` is the typed field on every
+ * pointer, so it maps to `text-input`, not a sheet policy.
+ */
+declare function presentationFromNativePicker(nativePicker: LegacyNativePicker, component: 'date' | 'time'): InputPresentation;
+/**
+ * The effective picker-only policy: explicit `presentation` wins over the
+ * deprecated prop. The narrow twin of {@link effectiveInputPresentation} for
+ * `DateInput` and `DateTimeInput`, whose `presentation` cannot be
+ * `text-input`.
+ */
+declare function effectivePickerPresentation(presentation: PickerPresentation | undefined, nativePicker: LegacyNativePicker | undefined): PickerPresentation;
+/** The effective policy: explicit `presentation` wins over the deprecated prop. */
+declare function effectiveInputPresentation(presentation: InputPresentation | undefined, nativePicker: LegacyNativePicker | undefined, component: 'date' | 'time'): InputPresentation;
+/** Resolve a picker-only policy to the surface rendered for the current pointer. */
+declare function resolvePickerPresentation(presentation: PickerPresentation, isCoarsePointer: boolean): PickerPresentationSurface;
+/** Resolve a policy to the surface rendered for the current pointer. */
+declare function resolveInputPresentation(presentation: InputPresentation, isCoarsePointer: boolean): InputPresentationSurface;
+//#endregion
+//#region src/utils/parseStyleKey.d.ts
+/**
+ * 把组件样式键编成 data 属性选择器后缀。
+ *
+ * `prop:value` 选择 `[data-prop="value"]`。裸状态选择 `[data-state="state"]`。
+ * `+` 把多个条件接在同一个组件目标上。轴名留在选择器里，避免不同属性的相同值撞在一起。
+ *
+ * @example
+ * parseStyleKey('base') // ''
+ * parseStyleKey('variant:secondary') // '[data-variant="secondary"]'
+ * parseStyleKey('checked+disabled') // '[data-checked="checked"][data-disabled="disabled"]'
+ */
+declare function parseStyleKey(key: string): string;
+//#endregion
+//#region src/utils/safeUrl.d.ts
+/**
+ * 导航地址的协议检查。
+ *
+ * 拦下 `javascript:`、`vbscript:` 和会当成页面打开的 `data:text/html`。
+ * 通过的字符串原样返回，不去掉调用方自己写的空白以外的内容。
+ * 图片、样式这类嵌入资源不走这里。
+ */
+/** 规范化后的导航地址。危险协议返回 null。 */
+declare function sanitizeUrl(url: string): string | null;
+/** 只判断，不改写调用方要交给浏览器的那个字符串。 */
+declare function isSafeUrl(url: string): boolean;
+/**
+ * 检查字符串，以及带 pathname / href / protocol 的路由对象。
+ * 空地址算安全（调用方本来就没有目的地）。不是字符串也不是对象的值算不安全。
+ */
+declare function isSafeDestination(destination: unknown): boolean;
+//#endregion
+//#region src/utils/sharedResizeObserver.d.ts
+type ResizeCallback = (entry: ResizeObserverEntry) => void;
+/**
+ * Observe an element's size via a shared ResizeObserver singleton.
+ *
+ * Fires the callback once synchronously on registration (with a
+ * synthetic entry) so callers don't need separate initial-measurement
+ * logic. Subsequent callbacks fire on actual resizes.
+ *
+ * Returns an unsubscribe function that removes only this registration, leaving
+ * every other observer of the same element intact — prefer it over
+ * `unobserveResize(element)`, which drops them all. The shared observer is
+ * destroyed when the last element is unobserved.
+ *
+ * @example
+ * ```
+ * const unsubscribe = observeResize(element, (entry) => {
+ *   console.log(entry.contentBoxSize);
+ * });
+ *
+ * // Cleanup:
+ * unsubscribe();
+ * ```
+ */
+declare function observeResize(element: Element, callback: ResizeCallback): () => void;
+/**
+ * Stop observing an element.
+ *
+ * Pass the callback to remove only that registration — the unsubscribe returned
+ * by `observeResize` does this for you. Omitting it removes EVERY callback on
+ * the element, which silences peers that are still mounted, so it is only
+ * correct for a caller that owns the element outright.
+ *
+ * If no elements remain, the shared observer is disconnected and released for
+ * garbage collection.
+ */
+declare function unobserveResize(element: Element, callback?: ResizeCallback): void;
+//#endregion
+//#region src/utils/timeParser.d.ts
+/**
+ * ISO time string in HH:MM or HH:MM:SS format (24-hour).
+ * Examples: "14:30", "09:15:00", "23:59:59"
+ */
+type ISOTimeString = string & {
+  readonly __brand: 'ISOTimeString';
+};
+/**
+ * Validates and creates an ISOTimeString from a string.
+ * Returns null if the string is not a valid time format.
+ */
+declare function createISOTimeString(value: string): ISOTimeString | null;
+/**
+ * Formats a time for display in 12-hour format.
+ * Example: "14:30" -> "2:30 PM"
+ */
+declare function formatDisplayTime12h(time: ISOTimeString | undefined, includeSeconds?: boolean): string;
+/**
+ * Formats a time for display in 24-hour format.
+ * Example: "14:30" -> "14:30"
+ */
+declare function formatDisplayTime24h(time: ISOTimeString | undefined, includeSeconds?: boolean): string;
+/**
+ * Parses user input into an ISOTimeString.
+ * Accepts various formats:
+ * - "2:30 PM", "2:30pm", "2:30 pm"
+ * - "14:30", "1430"
+ * - "2pm", "2 PM"
+ */
+declare function parseTimeInput(input: string, includeSeconds?: boolean): ISOTimeString | null;
+/**
+ * Compares two times. Returns:
+ * - negative if a < b
+ * - 0 if a === b
+ * - positive if a > b
+ */
+declare function compareTime(a: ISOTimeString | undefined, b: ISOTimeString | undefined): number;
+/**
+ * Clamps a time to a min/max range.
+ */
+declare function clampTime(time: ISOTimeString, min?: ISOTimeString, max?: ISOTimeString, includeSeconds?: boolean): ISOTimeString;
+/**
+ * Adjusts a time by adding/subtracting minutes.
+ */
+declare function adjustTime(time: ISOTimeString, deltaMinutes: number, includeSeconds?: boolean): ISOTimeString;
+//#endregion
+export { plainDateDayOfWeek as $, GroupItemsOptions as A, DATE_FORMAT_SHORT as B, presentationFromNativePicker as C, PlainDate as Ct, InputARIAInputGroup as D, InputARIA as E, isLocaleDayFirst as F, SHARED_DATE_FORMAT_OPTIONS as G, DATE_FORMAT_SHORT_WITH_YEAR as H, parseDateInput as I, getDaysInMonth as J, SharedDateFormat as K, DATE_FORMAT_LONG as L, ItemGroup as M, getItemGroup as N, getInputARIA as O, groupItems as P, plainDateCreate as Q, DATE_FORMAT_MONTH_ONLY as R, pickerPresentationFromNativePicker as S, ISODateString as St, resolvePickerPresentation as T, chainEventHandlers as Tt, DATE_FORMAT_WEEKDAY_ONLY as U, DATE_FORMAT_SHORT_WITH_WEEKDAY as V, DATE_FORMAT_WITH_WEEKDAY as W, plainDateAddDays as X, getTimeZoneParts as Y, plainDateAddMonths as Z, LegacyNativePicker as _, plainDateToInstant as _t, formatDisplayTime12h as a, plainDateGetWeekNumber as at, effectiveInputPresentation as b, DayOfWeek as bt, observeResize as c, plainDateIsEqual as ct, isSafeUrl as d, plainDateMin as dt, plainDateDiffDays as et, sanitizeUrl as f, plainDateSetEndOfWeekExclusive as ft, InputPresentationSurface as g, plainDateToISO as gt, InputPresentation as h, plainDateToDate as ht, createISOTimeString as i, plainDateFromInstant as it, GroupableItem as j, joinAriaIDs as k, unobserveResize as l, plainDateIsInRange as lt, DEFAULT_INPUT_PRESENTATION as m, plainDateSetStartOfWeek as mt, clampTime as n, plainDateFromDate as nt, formatDisplayTime24h as o, plainDateIsAfter as ot, parseStyleKey as p, plainDateSetFirstOfMonth as pt, formatSharedDate as q, compareTime as r, plainDateFromISO as rt, parseTimeInput as s, plainDateIsBefore as st, adjustTime as t, plainDateFormat as tt, isSafeDestination as u, plainDateMax as ut, PickerPresentation as v, plainDateToday as vt, resolveInputPresentation as w, normalizeDayOfWeek as wt, effectivePickerPresentation as x, DayOfWeekName as xt, PickerPresentationSurface as y, plainDateWeekFieldName as yt, DATE_FORMAT_MONTH_YEAR as z };

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

@@ -27,11 +27,11 @@ declare const __VLS_base: import("vue").DefineComponent<NavItemProps, {}, {}, {}
 }, string, import("vue").PublicProps, Readonly<NavItemProps> & Readonly<{
   onClick?: ((event: MouseEvent) => any) | undefined;
 }>, {
-  size: NavItemSize;
+  block: boolean;
+  isSelected: boolean;
   isDisabled: boolean;
+  size: NavItemSize;
   isIconOnly: boolean;
-  isSelected: boolean;
-  block: boolean;
   plain: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;

package/dist/{index-IBAInumL.d.ts → index-CMme-xmL.d.ts}

@@ -1,8 +1,8 @@
 import { n as SpacingStep } from "./types-BTk0WZ0b.js";
 import { n as BadgeVariant } from "./types-DIYwbkpe.js";
-import { a as SearchableItem, i as SearchSource } from "./useAsyncSource-xpQovjV_.js";
+import { a as SearchableItem, i as SearchSource } from "./useAsyncSource-aGzrvRkI.js";
 import { ComputedRef, InjectionKey, MaybeRefOrGetter, Ref, VNode } from "vue";
-//#region src/Chat/types.d.ts
+//#region src/Chat/messageTypes.d.ts
 /** Who sent a message row. `system` is centered and ignores avatar, name, and metadata. */
 type ChatMessageSender = 'user' | 'assistant' | 'system';
 /** Spacing and width preset shared by the layout, the list, and each message. */
@@ -269,6 +269,8 @@ interface ChatUnreadDividerProps {
   /** Short label at the end of the rule. Defaults to the localized "New". */
   label?: string;
 }
+//#endregion
+//#region src/Chat/composerTypes.d.ts
 /** Visual density of the composer shell. `spacious` uses the same spacing as `balanced`. */
 type ChatComposerDensity = ChatDensity;
 /** Resting elevation of the composer body. */
@@ -376,6 +378,14 @@ interface ChatComposerTrigger {
   renderItem?: (item: SearchableItem) => VNode;
   /** Plain text is inserted as-is. A token becomes a chip. */
   onSelect: (item: SearchableItem) => string | ChatComposerToken;
+  /**
+   * Keep this query through spaces and punctuation.
+   * It ends at a line break, after 64 characters, or when the same trigger
+   * character starts again after a space, a tab, or a line break.
+   * Another trigger character inside the query stays ordinary text.
+   * @default false
+   */
+  hasMultiWordQuery?: boolean;
   /**
    * Turn a serialized value back into a chip when a saved draft is loaded.
    * The input stores the value; callers use this when they rebuild chips.
@@ -383,7 +393,10 @@ interface ChatComposerTrigger {
   deserialize?: (value: string) => ChatComposerToken | null;
   /**
    * Shown when the query matches nothing.
-   * `null` and omission use the localized default. An empty string shows nothing.
+   * A single-token query uses the localized default when this is `null` or omitted.
+   * An empty string keeps the menu open and shows no message.
+   * A multi-word query hides the menu when this is `null` or omitted.
+   * Supply a string to keep that empty panel open.
    */
   emptySearchText?: string | VNode | null;
   /** Shown while an async search is in flight. */
@@ -594,7 +607,7 @@ declare const _default$14: typeof __VLS_export$14;
 //#endregion
 //#region src/Chat/ChatDictationButton.vue.d.ts
 declare const __VLS_export$13: import("vue").DefineComponent<ChatDictationButtonProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<ChatDictationButtonProps> & Readonly<{}>, {
-  size: "md" | "sm";
+  size: "sm" | "md";
   isHiddenWhenUnsupported: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default$13: typeof __VLS_export$13;
@@ -717,7 +730,7 @@ declare const __VLS_base$3: import("vue").DefineComponent<ChatSendButtonProps, {
   onStop?: (() => any) | undefined;
   onSend?: (() => any) | undefined;
 }>, {
-  size: "md" | "sm";
+  size: "sm" | "md";
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export$5: __VLS_WithSlots$3<typeof __VLS_base$3, __VLS_Slots$3>;
 declare const _default$5: typeof __VLS_export$5;
@@ -936,4 +949,4 @@ interface UseChatPasteAsTokenReturn {
 declare function pastedTextLabel(text: string): string;
 declare function useChatPasteAsToken(options: UseChatPasteAsTokenOptions): UseChatPasteAsTokenReturn;
 //#endregion
-export { ChatComposerTokenBadge as $, _default$9 as A, ChatSystemMessageProps as At, ChatComposerDrawerEmits as B, ChatTypingIndicatorProps as Bt, _default$2 as C, ChatMessageStatus as Ct, _default$6 as D, ChatSendButtonEmits as Dt, _default$5 as E, ChatReasoningSlots as Et, _default$14 as F, ChatToolCallItem as Ft, ChatComposerInputControl as G, ChatComposerDrawerSlots as H, _default$15 as I, ChatToolCallStatus as It, ChatComposerInputProps as J, ChatComposerInputEmits as K, _default$16 as L, ChatToolCallsEmits as Lt, _default$11 as M, ChatSystemMessageVariant as Mt, _default$12 as N, ChatTokenizedTextProps as Nt, _default$7 as O, ChatSendButtonProps as Ot, _default$13 as P, ChatTokenizedTextSlots as Pt, ChatComposerToken as Q, _default$17 as R, ChatToolCallsProps as Rt, _default$1 as S, ChatMessageSlots as St, _default$4 as T, ChatReasoningProps as Tt, ChatComposerElevation as U, ChatComposerDrawerProps as V, ChatUnreadDividerProps as Vt, ChatComposerEmits as W, ChatComposerSlots as X, ChatComposerProps as Y, ChatComposerStatus as Z, useChatComposerContext as _, ChatMessageListSlots as _t, useChatPasteAsToken as a, ChatDictationButtonProps as at, useChatMessageContext as b, ChatMessageProps as bt, SpeechRecognitionError as c, ChatLayoutScrollButtonProps as ct, useSpeechRecognition as d, ChatMessageBubbleGroup as dt, ChatComposerTokenCustom as et, TokenPortal as f, ChatMessageBubbleProps as ft, ChatComposerContextValue as g, ChatMessageListProps as gt, useChatComposerTokens as h, ChatMessageListAlign as ht, pastedTextLabel as i, ChatDensity as it, _default$10 as j, ChatSystemMessageSlots as jt, _default$8 as k, ChatSendButtonSlots as kt, UseSpeechRecognitionOptions as l, ChatLayoutScrollSlotProps as lt, UseChatComposerTokensReturn as m, ChatMessageBubbleVariant as mt, UseChatPasteAsTokenOptions as n, ChatComposerTrigger as nt, UseChatDictationOptions as o, ChatLayoutProps as ot, UseChatComposerTokensOptions as p, ChatMessageBubbleSlots as pt, ChatComposerInputHandle as q, UseChatPasteAsTokenReturn as r, ChatComposerTriggerItem as rt, useChatDictation as s, ChatLayoutScrollButtonEmits as st, PASTE_TOKEN_THRESHOLD as t, ChatComposerTokenElementProps as tt, UseSpeechRecognitionReturn as u, ChatLayoutSlots as ut, useChatLayoutContext as v, ChatMessageMetadataProps as vt, _default$3 as w, ChatReasoningEmits as wt, _default as x, ChatMessageSender as xt, useChatListContext as y, ChatMessageMetadataSlots as yt, ChatComposerDensity as z, ChatToolCallsSlots as zt };
+export { ChatComposerTokenBadge as $, _default$9 as A, ChatReasoningProps as At, ChatComposerDrawerEmits as B, ChatTypingIndicatorProps as Bt, _default$2 as C, ChatMessageMetadataProps as Ct, _default$6 as D, ChatMessageSlots as Dt, _default$5 as E, ChatMessageSender as Et, _default$14 as F, ChatToolCallItem as Ft, ChatComposerInputControl as G, ChatComposerDrawerSlots as H, _default$15 as I, ChatToolCallStatus as It, ChatComposerInputProps as J, ChatComposerInputEmits as K, _default$16 as L, ChatToolCallsEmits as Lt, _default$11 as M, ChatSystemMessageProps as Mt, _default$12 as N, ChatSystemMessageSlots as Nt, _default$7 as O, ChatMessageStatus as Ot, _default$13 as P, ChatSystemMessageVariant as Pt, ChatComposerToken as Q, _default$17 as R, ChatToolCallsProps as Rt, _default$1 as S, ChatMessageListSlots as St, _default$4 as T, ChatMessageProps as Tt, ChatComposerElevation as U, ChatComposerDrawerProps as V, ChatUnreadDividerProps as Vt, ChatComposerEmits as W, ChatComposerSlots as X, ChatComposerProps as Y, ChatComposerStatus as Z, useChatComposerContext as _, ChatMessageBubbleProps as _t, useChatPasteAsToken as a, ChatSendButtonEmits as at, useChatMessageContext as b, ChatMessageListAlign as bt, SpeechRecognitionError as c, ChatTokenizedTextProps as ct, useSpeechRecognition as d, ChatLayoutProps as dt, ChatComposerTokenCustom as et, TokenPortal as f, ChatLayoutScrollButtonEmits as ft, ChatComposerContextValue as g, ChatMessageBubbleGroup as gt, useChatComposerTokens as h, ChatLayoutSlots as ht, pastedTextLabel as i, ChatDictationButtonProps as it, _default$10 as j, ChatReasoningSlots as jt, _default$8 as k, ChatReasoningEmits as kt, UseSpeechRecognitionOptions as l, ChatTokenizedTextSlots as lt, UseChatComposerTokensReturn as m, ChatLayoutScrollSlotProps as mt, UseChatPasteAsTokenOptions as n, ChatComposerTrigger as nt, UseChatDictationOptions as o, ChatSendButtonProps as ot, UseChatComposerTokensOptions as p, ChatLayoutScrollButtonProps as pt, ChatComposerInputHandle as q, UseChatPasteAsTokenReturn as r, ChatComposerTriggerItem as rt, useChatDictation as s, ChatSendButtonSlots as st, PASTE_TOKEN_THRESHOLD as t, ChatComposerTokenElementProps as tt, UseSpeechRecognitionReturn as u, ChatDensity as ut, useChatLayoutContext as v, ChatMessageBubbleSlots as vt, _default$3 as w, ChatMessageMetadataSlots as wt, _default as x, ChatMessageListProps as xt, useChatListContext as y, ChatMessageBubbleVariant as yt, ChatComposerDensity as z, ChatToolCallsSlots as zt };

package/dist/{index-gW0HW02U.d.ts → index-COxy6LEW.d.ts}

@@ -125,8 +125,8 @@ declare const __VLS_base$1: import("vue").DefineComponent<__VLS_PublicProps, {
   onChange?: ((value: string) => any) | undefined;
   "onUpdate:modelValue"?: ((...args: unknown[]) => any) | undefined;
 }>, {
-  size: SegmentedControlSize;
   isDisabled: boolean;
+  size: SegmentedControlSize;
   layout: SegmentedControlLayout;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export$1: __VLS_WithSlots$1<typeof __VLS_base$1, __VLS_Slots$1>;

package/dist/{index-12QYAbiz.d.ts → index-CRrSHbok.d.ts}

@@ -1,5 +1,5 @@
 import { n as LayerPlacement, t as LayerAlignment } from "./position-DFW5ymAF.js";
-import { A as DropdownMenuSize, F as DropdownMenuSubMenuSlots, N as DropdownMenuSubMenuPresentation, P as DropdownMenuSubMenuProps, _ as DropdownMenuItemSlots, b as DropdownMenuPresentation, f as DropdownMenuGroupProps, g as DropdownMenuItemProps, i as DropdownMenuButtonProps, j as DropdownMenuSlots, p as DropdownMenuGroupSlots, v as DropdownMenuItemVariant, x as DropdownMenuProps } from "./DropdownMenuRadioItem.vue-CXEURBcq.js";
+import { C as DropdownMenuGroupSlots, D as DropdownMenuItemVariant, E as DropdownMenuItemSlots, F as DropdownMenuSubMenuProps, I as DropdownMenuSubMenuSlots, P as DropdownMenuSubMenuPresentation, S as DropdownMenuGroupProps, T as DropdownMenuItemProps, _ as DropdownMenuSlots, d as DropdownMenuPresentation, f as DropdownMenuProps, g as DropdownMenuSize } from "./DropdownMenuRadioItem.vue-Qd-8Rg4Q.js";
 import { ComputedRef, InjectionKey, Ref } from "vue";
 //#region src/DropdownMenu/useMenuDrillIn.d.ts
 /**
@@ -39,6 +39,8 @@ interface DropdownMenuContextValue {
   drillIn: ComputedRef<MenuDrillIn>;
   /** Move focus to the header or the footer. */
   focusRegion: (direction: 'previous' | 'next') => boolean;
+  /** Cycle Tab through the dialog around the menu. No-op without a header or footer. */
+  moveDialogTab: (event: KeyboardEvent, isFromFlyout?: boolean) => void;
 }
 /** The surrounding menu, or `undefined` when a row stands alone. */
 declare function useDropdownMenuContext(): DropdownMenuContextValue | undefined;
@@ -67,7 +69,6 @@ declare const __VLS_base$3: import("vue").DefineComponent<__VLS_PublicProps, {},
   onOpenChange?: ((isOpen: boolean) => any) | undefined;
   "onUpdate:isMenuOpen"?: ((...args: unknown[]) => any) | undefined;
 }>, {
-  button: DropdownMenuButtonProps;
   placement: LayerPlacement;
   alignment: LayerAlignment;
   presentation: DropdownMenuPresentation;

package/dist/{index-B42oE_F-.d.ts → index-CT5OEUxd.d.ts}

@@ -1,5 +1,6 @@
-import { a as SearchableItem, i as SearchSource } from "./useAsyncSource-xpQovjV_.js";
-import { t as PowerSearchMessages } from "./power-search-DrDfcoL1.js";
+import { a as SearchableItem, i as SearchSource } from "./useAsyncSource-aGzrvRkI.js";
+import { t as FieldPartStylingProps } from "./fieldParts-LXpQMKE8.js";
+import { t as PowerSearchMessages } from "./power-search-gHLIYXs5.js";
 import { Component, VNodeChild } from "vue";
 //#region src/PowerSearch/types.d.ts
 interface EmptyOperatorValue {
@@ -249,10 +250,13 @@ interface PowerSearchComponentOverride {
   editor?: Component;
 }
 type PowerSearchComponents = Partial<Record<OperatorValue['type'], PowerSearchComponentOverride>>;
-interface PowerSearchProps {
+interface PowerSearchProps extends FieldPartStylingProps {
   config: PowerSearchConfig;
   filters?: readonly PowerSearchFilter[];
   label?: string;
+  /** 视觉上隐藏标签。没传时隐藏。传 false 会把标签显示出来。 */
+  isLabelHidden?: boolean;
+  /** `isLabelHidden` 的旧名。两个都传时听正名。 */
   labelHidden?: boolean;
   placeholder?: string;
   autofocus?: boolean;
@@ -351,8 +355,17 @@ interface EditorPlacementInput {
   control: EditorBox;
   viewportWidth: number;
   direction: 'ltr' | 'rtl';
-  /** 视口左右各留出的安全距离。 */
+  /**
+   * 视口左右共用的留白。没单独给左右边时用它。
+   * 默认跟浮层基础留白一样，是 16。
+   */
   viewportInset?: number;
+  /** 视口左侧留白。没传时用 `viewportInset`。 */
+  inlineStart?: number;
+  /** 视口右侧留白。没传时用 `viewportInset`。 */
+  inlineEnd?: number;
+  /** 视口上下留白。没传时用 `viewportInset`。 */
+  blockInset?: number;
 }
 interface EditorPlacement {
   width: number;

package/dist/{index-DG52Bg0W.d.ts → index-CTf3SK0b.d.ts}

@@ -1,3 +1,4 @@
+import { Component } from "vue";
 //#region src/StatusDot/types.d.ts
 type StatusDotVariant = 'neutral' | 'info' | 'success' | 'warning' | 'error';
 interface StatusDotProps {
@@ -19,6 +20,11 @@ interface StatusDotProps {
    * Tooltip text shown on hover and on keyboard focus to explain the status.
    */
   tooltip?: string;
+  /**
+   * 画在圆点里的图标。不传时圆点只靠颜色表达状态。
+   * 插槽 `icon` 优先于这个属性。
+   */
+  icon?: Component;
 }
 //#endregion
 //#region src/StatusDot/StatusDot.vue.d.ts

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

@@ -1,8 +1,9 @@
 import { s as ButtonSize } from "./types-WlmsNL1I.js";
-import { t as ExtendedIconName } from "./types-CwyibrRB.js";
-import { l as FieldStatusVariant, o as FieldStatusInput } from "./types-0Q_SJv_F.js";
+import { t as ExtendedIconName } from "./types-C5GQ2KCK.js";
+import { l as FieldStatusVariant, o as FieldStatusInput } from "./types-Bb7OGivY.js";
+import { t as FieldPartStylingProps } from "./fieldParts-LXpQMKE8.js";
 import { r as PopoverPlacement, t as PopoverAlignment } from "./types-OGMYGejX.js";
-import { Component, Ref, VNode } from "vue";
+import { Component, HTMLAttributes, Ref, StyleValue, VNode } from "vue";
 //#region src/ComplexSelector/types.d.ts
 interface ComplexSelectorState {
   isOpen: boolean;
@@ -10,7 +11,7 @@ interface ComplexSelectorState {
   triggerId: string;
   contentId: string;
 }
-type ComplexSelectorVariant = 'input' | 'ghost';
+type ComplexSelectorVariant = 'input' | 'secondary' | 'ghost';
 interface ComplexSelectorHandle {
   /** Open the popup. */
   open: () => void;
@@ -45,7 +46,7 @@ interface ComplexSelectorSlotProps<Value> {
   close: () => void;
   state: ComplexSelectorState;
 }
-interface ComplexSelectorProps<Value = unknown> {
+interface ComplexSelectorProps<Value = unknown> extends FieldPartStylingProps {
   /** Field label. It also names the popup. */
   label: string;
   /** Current value. Bind with `v-model`. */
@@ -70,6 +71,12 @@ interface ComplexSelectorProps<Value = unknown> {
   /** @default 'attached' */
   statusVariant?: FieldStatusVariant | 'tooltip';
   labelTooltip?: string;
+  /** Explicit popup width (number = px). Unset keeps the popup matching the trigger; it is always capped to the viewport. */
+  popupWidth?: number | string;
+  /** Class for the popup content container, which carries the popup padding and scroll. */
+  contentClass?: HTMLAttributes['class'];
+  /** Inline style for the popup content container, e.g. `{ padding: 0 }` to let content reach the popup edges. */
+  contentStyle?: StyleValue;
   /** @default 'md' */
   size?: ButtonSize;
   width?: number | string;
@@ -86,7 +93,7 @@ interface ComplexSelectorProps<Value = unknown> {
    */
   startIcon?: ExtendedIconName | Component;
   /**
-   * `input` is the bordered field. `ghost` matches a toolbar button.
+   * `input` is the bordered field. `secondary` matches a secondary button. `ghost` matches a toolbar button.
    * @default 'input'
    */
   variant?: ComplexSelectorVariant;

package/dist/{index-DXpSFlPG.d.ts → index-CWaSYtk9.d.ts}

@@ -1,4 +1,4 @@
-import { s as AstryxMessages } from "./loadCatalog-BGHKG_9N.js";
+import { s as AstryxMessages } from "./loadCatalog-opk5hs94.js";
 import { ComputedRef, InjectionKey, MaybeRefOrGetter } from "vue";
 //#region src/locale/types.d.ts
 /** 内置文案的两种语言。其他语言用 `loadAstryxCatalog` 接原版 JSON。 */
@@ -8,9 +8,9 @@ type AstryxLocale = 'en' | 'zh-CN';
 declare const astryxLocaleKey: InjectionKey<MaybeRefOrGetter<string>>;
 declare const astryxMessagesKey: InjectionKey<MaybeRefOrGetter<AstryxMessages>>;
 /**
- * 把语言标签收成组件能用的写法。
- * `en` 和 `en-*` 收成 `en`。`zh`、`zh-CN`、`zh-Hans` 收成 `zh-CN`。
- * `zh-TW` 以及其他标签保留规范写法，用来接 `loadAstryxCatalog` 的结果。
+ * 把语言标签收成规范写法。
+ * `zh`、`zh-CN`、`zh-Hans` 收成 `zh-CN`，对上内置的简体中文文案。
+ * 其余标签只做大小写规范，例如 `en-gb` 收成 `en-GB`，日期和数字因此按这个地区的习惯排。
  * 空值和解析不了的标签回到 `en`。
  */
 declare function normalizeLocale(locale: string | null | undefined): string;

package/dist/{index-CVn0GBdB.d.ts → index-Ca8VIE4l.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;
-  isOptional: boolean;
   indicator: StepIndicator;
+  isOptional: boolean;
 }, {}, {}, {}, 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;