@astryx-vue/core 0.2.6 → 0.4.0

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-DXpSFlPG.d.ts → index-CKgBTAzC.d.ts}

@@ -1,4 +1,4 @@
-import { s as AstryxMessages } from "./loadCatalog-BGHKG_9N.js";
+import { s as AstryxMessages } from "./loadCatalog-DlLFZreI.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-EFqQF2Bx.d.ts → index-CPtDjmcX.d.ts}

@@ -8,14 +8,14 @@ declare const __VLS_base: import("vue").DefineComponent<ButtonProps, {
 }, string, import("vue").PublicProps, Readonly<ButtonProps> & Readonly<{
   onClick?: ((event: MouseEvent) => any) | undefined;
 }>, {
-  isDisabled: boolean;
-  variant: ButtonVariant;
-  elevation: ButtonElevation;
   type: "button" | "reset" | "submit";
-  isLoading: boolean;
   isIconOnly: boolean;
+  elevation: ButtonElevation;
+  isDisabled: boolean;
   isInterruptible: boolean;
+  isLoading: boolean;
   loadingLabel: string;
+  variant: ButtonVariant;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;

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-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-BNy3SW4S.d.ts → index-CTjkJP4x.d.ts}

@@ -9,7 +9,36 @@ type CardSizeValue = number | string;
  * and `muted` uses the muted surface for a de-emphasised card. The remaining
  * names are the non-semantic hues and use the tint for that hue.
  */
-type CardVariant = 'default' | 'transparent' | 'muted' | 'blue' | 'cyan' | 'gray' | 'green' | 'orange' | 'pink' | 'purple' | 'red' | 'teal' | 'yellow';
+/**
+ * 卡片背景变体。主题可以扩充这张表，从而给 `variant` 增加自己的名字：
+ *
+ * ```ts
+ * declare module '@astryx-vue/core' {
+ *   interface CardVariantMap {
+ *     brand: true
+ *   }
+ * }
+ * ```
+ *
+ * 新增的变体要在主题里自己写背景。可选卡片的描边读 `--astryx-selectable-card-accent`，
+ * 主题在同一条规则里指定它，避免组件去猜一种和填充色对比得过来的颜色。
+ */
+interface CardVariantMap {
+  default: true;
+  transparent: true;
+  muted: true;
+  blue: true;
+  cyan: true;
+  gray: true;
+  green: true;
+  orange: true;
+  pink: true;
+  purple: true;
+  red: true;
+  teal: true;
+  yellow: true;
+}
+type CardVariant = keyof CardVariantMap;
 /**
  * Resting shadow depth. `none` is flat; `low`, `med`, and `high` follow the
  * shadow scale, ascending in intensity.
@@ -82,8 +111,8 @@ type __VLS_Slots = CardSlots;
 declare const __VLS_base: import("vue").DefineComponent<CardProps, {
   element: Readonly<import("vue").ShallowRef<HTMLDivElement | null>>;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<CardProps> & Readonly<{}>, {
-  variant: CardVariant;
   elevation: CardElevation;
+  variant: keyof CardVariantMap;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;
@@ -93,4 +122,4 @@ type __VLS_WithSlots<T, S> = T & {
   };
 };
 //#endregion
-export { CardSlots as a, CardSizeValue as i, CardElevation as n, CardVariant as o, CardProps as r, _default as t };
+export { CardSlots as a, CardSizeValue as i, CardElevation as n, CardVariant as o, CardProps as r, CardVariantMap as s, _default as t };

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-YKCx03zD.d.ts → index-CdvmnNMH.d.ts}

@@ -44,9 +44,9 @@ interface ProgressBarProps {
 //#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<{}>, {
   isDisabled: boolean;
-  variant: ProgressBarVariant;
   size: ProgressBarSize;
   value: number;
+  variant: ProgressBarVariant;
   isLabelHidden: boolean;
   min: number;
   max: number;

package/dist/{index-BUEPz7BL.d.ts → index-CikMzeab.d.ts}

@@ -32,10 +32,10 @@ declare const __VLS_base$2: import("vue").DefineComponent<ItemProps, {
   focus: typeof focus;
   blur: typeof blur;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<ItemProps> & Readonly<{}>, {
-  isSelected: boolean;
+  as: ItemElement;
   isDisabled: boolean;
+  isSelected: boolean;
   density: ListDensity;
-  as: ItemElement;
   align: ItemAlign;
   layout: ItemLayout;
   isHighlighted: boolean;
@@ -53,8 +53,8 @@ type __VLS_Slots$1 = ListSlots;
 declare const __VLS_base$1: import("vue").DefineComponent<ListProps, {
   element: import("vue").ComputedRef<HTMLUListElement | HTMLOListElement | null>;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<ListProps> & Readonly<{}>, {
-  density: ListDensity;
   start: number;
+  density: ListDensity;
   hasDividers: boolean;
   listStyle: ListMarkerStyle;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;