@astryx-vue/core 0.2.2 → 0.2.4

package/dist/{context-CiKncNSH.js → context-CPh7kE-a.js}

@@ -4,12 +4,24 @@ const calendarMessages = {
 	"en": {
 		label: "Calendar",
 		previousMonth: "Previous month",
-		nextMonth: "Next month"
+		nextMonth: "Next month",
+		rangeStart: (date) => `Range start, ${date}`,
+		rangeCleared: (date) => `Range cleared, ${date}`,
+		rangeComplete: (start, end) => `${start} to ${end}`,
+		rangeStartName: (date) => `${date}, range start`,
+		rangeEndName: (date) => `${date}, range end`,
+		rangeBoth: (date) => `${date}, range start and range end`
 	},
 	"zh-CN": {
 		label: "日历",
 		previousMonth: "上一月",
-		nextMonth: "下一月"
+		nextMonth: "下一月",
+		rangeStart: (date) => `已选择开始日期，${date}`,
+		rangeCleared: (date) => `已取消选择，${date}`,
+		rangeComplete: (start, end) => `${start}到${end}`,
+		rangeStartName: (date) => `${date}，范围开始`,
+		rangeEndName: (date) => `${date}，范围结束`,
+		rangeBoth: (date) => `${date}，范围开始和结束`
 	}
 };
 //#endregion
@@ -111,6 +123,12 @@ const chatMessages = {
 	}
 };
 //#endregion
+//#region src/locale/messages/checkbox-list.ts
+const checkboxListMessages = {
+	"en": { loading: "Loading" },
+	"zh-CN": { loading: "正在加载" }
+};
+//#endregion
 //#region src/locale/messages/citation.ts
 const citationMessages = {
 	"en": { label: (number, title) => `Citation ${number}: ${title}` },
@@ -159,14 +177,18 @@ const dateInputMessages = {
 		dialogLabel: "Choose date",
 		openCalendar: "Open calendar",
 		closeCalendar: "Close calendar",
-		clear: (label) => clearLabel(label, "Clear", "Clear ")
+		clear: (label) => clearLabel(label, "Clear", "Clear "),
+		invalidDate: "That date is not available",
+		loading: "Loading"
 	},
 	"zh-CN": {
 		placeholder: "选择日期",
 		dialogLabel: "选择日期",
 		openCalendar: "打开日历",
 		closeCalendar: "关闭日历",
-		clear: (label) => clearLabel(label, "清除", "清除")
+		clear: (label) => clearLabel(label, "清除", "清除"),
+		invalidDate: "这个日期不可用",
+		loading: "正在加载"
 	}
 };
 //#endregion
@@ -198,6 +220,18 @@ const dateTimeInputMessages = {
 	}
 };
 //#endregion
+//#region src/locale/messages/dropdown-menu.ts
+const dropdownMenuMessages = {
+	"en": {
+		back: "Back",
+		backTo: (parent) => `Back to ${parent}`
+	},
+	"zh-CN": {
+		back: "返回",
+		backTo: (parent) => `返回到${parent}`
+	}
+};
+//#endregion
 //#region src/locale/messages/file-input.ts
 const fileInputMessages = {
 	"en": {
@@ -224,6 +258,26 @@ const fileInputMessages = {
 	}
 };
 //#endregion
+//#region src/locale/messages/input.ts
+const inputMessages = {
+	"en": {
+		statusError: "Error details",
+		statusWarning: "Warning details",
+		statusSuccess: "Success details"
+	},
+	"zh-CN": {
+		statusError: "错误详情",
+		statusWarning: "警告详情",
+		statusSuccess: "成功详情"
+	}
+};
+//#endregion
+//#region src/locale/messages/keyboard-hint.ts
+const keyboardHintMessages = {
+	"en": { navigate: "to navigate" },
+	"zh-CN": { navigate: "移动" }
+};
+//#endregion
 //#region src/locale/messages/layout.ts
 const layoutMessages = {
 	"en": {
@@ -301,18 +355,30 @@ const multiSelectorMessages = {
 		search: "Search…",
 		clear: "Clear",
 		empty: "No matches",
+		emptySearch: "No results found",
 		selectAll: "Select all",
 		selected: (count) => `${count} selected`,
-		more: (count) => `+${count}`
+		more: (count) => `+${count}`,
+		resultCount: (count) => count === 1 ? "1 result" : `${count} results`,
+		create: (query) => `Create "${query}"`,
+		created: (label) => `${label} created`,
+		readOnly: "Read-only",
+		loading: "Loading"
 	},
 	"zh-CN": {
 		placeholder: "请选择",
 		search: "搜索…",
 		clear: "清除",
 		empty: "无匹配项",
+		emptySearch: "未找到结果",
 		selectAll: "全选",
 		selected: (count) => `已选 ${count} 项`,
-		more: (count) => `+${count}`
+		more: (count) => `+${count}`,
+		resultCount: (count) => `${count} 个结果`,
+		create: (query) => `创建“${query}”`,
+		created: (label) => `已创建 ${label}`,
+		readOnly: "只读",
+		loading: "正在加载"
 	}
 };
 //#endregion
@@ -331,7 +397,9 @@ const navMessages = {
 		moreItems: (count) => `${count} more`,
 		expandItem: (label) => `Expand ${label}`,
 		collapseItem: (label) => `Collapse ${label}`,
-		submenu: (label) => `${label} submenu`
+		submenu: (label) => `${label} submenu`,
+		resizeSidebar: "Resize sidebar",
+		opensInNewTab: "(opens in new tab)"
 	},
 	"zh-CN": {
 		sideNav: "侧边导航",
@@ -346,7 +414,9 @@ const navMessages = {
 		moreItems: (count) => `还有 ${count} 项`,
 		expandItem: (label) => `展开${label}`,
 		collapseItem: (label) => `收起${label}`,
-		submenu: (label) => `${label}子菜单`
+		submenu: (label) => `${label}子菜单`,
+		resizeSidebar: "调整侧栏宽度",
+		opensInNewTab: "（在新标签页打开）"
 	}
 };
 //#endregion
@@ -380,7 +450,14 @@ const paginationMessages = {
 		pageSize: (count) => `${count} / page`,
 		total: (total, from, to) => `${from}–${to} of ${total}`,
 		compact: (page, totalPages) => `${page} / ${totalPages}`,
-		pageOf: (page, totalPages) => `Page ${page} of ${totalPages}`
+		pageOf: (page, totalPages) => `Page ${page} of ${totalPages}`,
+		first: "First page",
+		last: "Last page",
+		previousBy: (step) => `Back ${step} pages`,
+		nextBy: (step) => `Forward ${step} pages`,
+		pageLabel: "Page",
+		goToPage: "Go to page",
+		ofTotal: (totalPages) => `/ ${totalPages}`
 	},
 	"zh-CN": {
 		nav: "分页导航",
@@ -392,7 +469,14 @@ const paginationMessages = {
 		pageSize: (count) => `${count} 条/页`,
 		total: (total, from, to) => `共 ${total} 条，显示 ${from}-${to}`,
 		compact: (page, totalPages) => `${page} / ${totalPages}`,
-		pageOf: (page, totalPages) => `第 ${page} 页，共 ${totalPages} 页`
+		pageOf: (page, totalPages) => `第 ${page} 页，共 ${totalPages} 页`,
+		first: "第一页",
+		last: "最后一页",
+		previousBy: (step) => `后退 ${step} 页`,
+		nextBy: (step) => `前进 ${step} 页`,
+		pageLabel: "页",
+		goToPage: "跳转到页",
+		ofTotal: (totalPages) => `/ ${totalPages}`
 	}
 };
 const powerSearchMessages = {
@@ -532,13 +616,21 @@ const selectorMessages = {
 		placeholder: "Select…",
 		search: "Search…",
 		clear: "Clear",
-		empty: "No matches"
+		empty: "No matches",
+		emptySearch: "No results found",
+		resultCount: (count) => count === 1 ? "1 result" : `${count} results`,
+		readOnly: "Read-only",
+		loading: "Loading"
 	},
 	"zh-CN": {
 		placeholder: "请选择",
 		search: "搜索…",
 		clear: "清除",
-		empty: "无匹配项"
+		empty: "无匹配项",
+		emptySearch: "未找到结果",
+		resultCount: (count) => `${count} 个结果`,
+		readOnly: "只读",
+		loading: "正在加载"
 	}
 };
 //#endregion
@@ -746,12 +838,16 @@ const astryxMessages = {
 		calendar: calendarMessages.en,
 		carousel: carouselMessages.en,
 		chat: chatMessages.en,
+		checkboxList: checkboxListMessages.en,
 		citation: citationMessages.en,
 		commandPalette: commandPaletteMessages.en,
 		dateInput: dateInputMessages.en,
 		dateRangeInput: dateRangeInputMessages.en,
 		dateTimeInput: dateTimeInputMessages.en,
+		dropdownMenu: dropdownMenuMessages.en,
 		fileInput: fileInputMessages.en,
+		input: inputMessages.en,
+		keyboardHint: keyboardHintMessages.en,
 		layout: layoutMessages.en,
 		lightbox: lightboxMessages.en,
 		markdown: markdownMessages.en,
@@ -777,12 +873,16 @@ const astryxMessages = {
 		calendar: calendarMessages["zh-CN"],
 		carousel: carouselMessages["zh-CN"],
 		chat: chatMessages["zh-CN"],
+		checkboxList: checkboxListMessages["zh-CN"],
 		citation: citationMessages["zh-CN"],
 		commandPalette: commandPaletteMessages["zh-CN"],
 		dateInput: dateInputMessages["zh-CN"],
 		dateRangeInput: dateRangeInputMessages["zh-CN"],
 		dateTimeInput: dateTimeInputMessages["zh-CN"],
+		dropdownMenu: dropdownMenuMessages["zh-CN"],
 		fileInput: fileInputMessages["zh-CN"],
+		input: inputMessages["zh-CN"],
+		keyboardHint: keyboardHintMessages["zh-CN"],
 		layout: layoutMessages["zh-CN"],
 		lightbox: lightboxMessages["zh-CN"],
 		markdown: markdownMessages["zh-CN"],
@@ -808,13 +908,31 @@ const astryxMessages = {
 //#endregion
 //#region src/locale/context.ts
 const astryxLocaleKey = Symbol("astryx-locale");
+const astryxMessagesKey = Symbol("astryx-messages");
+/**
+* 把语言标签收成组件能用的写法。
+* `en` 和 `en-*` 收成 `en`。`zh`、`zh-CN`、`zh-Hans` 收成 `zh-CN`。
+* `zh-TW` 以及其他标签保留规范写法，用来接 `loadAstryxCatalog` 的结果。
+* 空值和解析不了的标签回到 `en`。
+*/
 function normalizeLocale(locale) {
-	const value = locale?.trim().toLowerCase() ?? "";
-	if (value === "zh" || value.startsWith("zh-")) return "zh-CN";
-	return "en";
+	const trimmed = locale?.trim() ?? "";
+	if (trimmed === "") return "en";
+	let parsed;
+	try {
+		parsed = new Intl.Locale(trimmed);
+	} catch {
+		return "en";
+	}
+	const base = parsed.baseName;
+	const lower = base.toLowerCase();
+	if (lower === "en" || lower.startsWith("en-")) return "en";
+	if (lower === "zh" || lower === "zh-cn" || lower === "zh-hans" || lower.startsWith("zh-hans-")) return "zh-CN";
+	return base;
 }
-function provideAstryxLocale(locale) {
+function provideAstryxLocale(locale, messages) {
 	provide(astryxLocaleKey, computed(() => normalizeLocale(toValue(locale))));
+	if (messages !== void 0) provide(astryxMessagesKey, computed(() => toValue(messages)));
 }
 function useAstryxLocale() {
 	const injected = inject(astryxLocaleKey, void 0);
@@ -822,7 +940,11 @@ function useAstryxLocale() {
 }
 function useAstryxMessages() {
 	const locale = useAstryxLocale();
-	return computed(() => astryxMessages[locale.value]);
+	const provided = inject(astryxMessagesKey, void 0);
+	return computed(() => {
+		if (provided != null) return toValue(provided);
+		return locale.value === "zh-CN" ? astryxMessages["zh-CN"] : astryxMessages.en;
+	});
 }
 //#endregion
-export { useAstryxMessages as a, useAstryxLocale as i, normalizeLocale as n, provideAstryxLocale as r, astryxLocaleKey as t };
+export { useAstryxLocale as a, provideAstryxLocale as i, astryxMessagesKey as n, useAstryxMessages as o, normalizeLocale as r, astryxMessages as s, astryxLocaleKey as t };

package/dist/context-Cws_tXTr.js

@@ -0,0 +1,7 @@
+//#region src/Theme/context.ts
+const themeContextKey = Symbol("astryx-theme");
+/** Present when this component is already inside a Theme. */
+const themeNestingKey = Symbol("astryx-theme-nesting");
+const mediaThemeKey = Symbol("astryx-media-theme");
+//#endregion
+export { themeContextKey as n, themeNestingKey as r, mediaThemeKey as t };

package/dist/context-D5-MwxnN.js

@@ -0,0 +1,4 @@
+//#region src/InputGroup/context.ts
+const INPUT_GROUP_KEY = Symbol("InputGroup");
+//#endregion
+export { INPUT_GROUP_KEY as t };

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

@@ -1,6 +1,21 @@
 import { n as LayerPlacement, t as LayerAlignment } from "./position-DFW5ymAF.js";
-import { _ as DropdownMenuSubMenuProps, a as DropdownMenuGroupSlots, c as DropdownMenuItemProps, f as DropdownMenuPresentation, g as DropdownMenuSlots, h as DropdownMenuSize, i as DropdownMenuGroupProps, l as DropdownMenuItemSlots, p as DropdownMenuProps, t as DropdownMenuButtonProps, u as DropdownMenuItemVariant, v as DropdownMenuSubMenuSlots } from "./types-DDAAT1Xd.js";
-import { ComputedRef, InjectionKey } from "vue";
+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 { ComputedRef, InjectionKey, Ref } from "vue";
+//#region src/DropdownMenu/useMenuDrillIn.d.ts
+/**
+ * The view stack a menu root keeps so a submenu can replace the rows in place.
+ *
+ * Sampled once, when the menu opens, so the panel never changes shape under
+ * the pointer. Closing forgets the stack and the next open starts at the root.
+ */
+interface MenuDrillIn {
+  isCompactTouch: boolean;
+  viewStack: readonly string[];
+  host: HTMLElement | null;
+  push: (viewId: string) => void;
+  pop: () => void;
+}
+//#endregion
 //#region src/DropdownMenu/context.d.ts
 /**
  * What a `DropdownMenu` tells the rows inside it.
@@ -16,9 +31,25 @@ interface DropdownMenuContextValue {
   isOpen: ComputedRef<boolean>;
   /** Size of the menu, derived from the trigger button's size. */
   menuSize: ComputedRef<DropdownMenuSize>;
+  /** Name a drilled view's Back row returns to. */
+  menuLabel: ComputedRef<string | undefined>;
+  /** Whether a header or footer sits beside the menu. */
+  hasRegions: ComputedRef<boolean>;
+  /** View stack for submenus that replace the rows in place. */
+  drillIn: ComputedRef<MenuDrillIn>;
+  /** Move focus to the header or the footer. */
+  focusRegion: (direction: 'previous' | 'next') => boolean;
 }
 /** The surrounding menu, or `undefined` when a row stands alone. */
 declare function useDropdownMenuContext(): DropdownMenuContextValue | undefined;
+/** Single-select state owned by `DropdownMenuRadioGroup`. */
+interface DropdownMenuRadioGroupContext {
+  value: ComputedRef<string | undefined>;
+  hasCloseOnSelect: ComputedRef<boolean>;
+  select: (value: string) => void;
+}
+/** The radio group around this row, or `undefined` when there is none. */
+declare function useDropdownMenuRadioGroup(): DropdownMenuRadioGroupContext | undefined;
 //#endregion
 //#region src/DropdownMenu/DropdownMenu.vue.d.ts
 type __VLS_Props = DropdownMenuProps;
@@ -86,8 +117,14 @@ type __VLS_WithSlots$1<T, S> = T & {
 //#endregion
 //#region src/DropdownMenu/DropdownMenuSubMenu.vue.d.ts
 type __VLS_Slots = DropdownMenuSubMenuSlots;
-declare const __VLS_base: import("vue").DefineComponent<DropdownMenuSubMenuProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<DropdownMenuSubMenuProps> & Readonly<{}>, {
+declare const __VLS_base: import("vue").DefineComponent<DropdownMenuSubMenuProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+  openChange: (isOpen: boolean) => any;
+}, string, import("vue").PublicProps, Readonly<DropdownMenuSubMenuProps> & Readonly<{
+  onOpenChange?: ((isOpen: boolean) => any) | undefined;
+}>, {
   isDisabled: boolean;
+  presentation: DropdownMenuSubMenuPresentation;
+  hasSpinner: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;
@@ -97,4 +134,4 @@ type __VLS_WithSlots<T, S> = T & {
   };
 };
 //#endregion
-export { _default$4 as a, _default$3 as i, _default$1 as n, DropdownMenuContextValue as o, _default$2 as r, useDropdownMenuContext as s, _default as t };
+export { _default$4 as a, useDropdownMenuContext as c, _default$3 as i, useDropdownMenuRadioGroup as l, _default$1 as n, DropdownMenuContextValue as o, _default$2 as r, DropdownMenuRadioGroupContext as s, _default as t, MenuDrillIn as u };

package/dist/{index-Cs5pcwY3.d.ts → index-6yB8BtEu.d.ts}

@@ -363,21 +363,21 @@ declare const __VLS_base: import("vue").DefineComponent<PowerSearchProps, {
   focusTypeahead: () => void | undefined;
   blurTypeahead: () => void | undefined;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+  change: (filters: PowerSearchFilter[], changeType: PowerSearchChangeType, index: number) => any;
   blur: (event: FocusEvent) => any;
   focus: (event: FocusEvent) => any;
-  change: (filters: PowerSearchFilter[], changeType: PowerSearchChangeType, index: number) => any;
   "update:filters": (filters: PowerSearchFilter[]) => any;
 }, string, import("vue").PublicProps, Readonly<PowerSearchProps> & Readonly<{
+  onChange?: ((filters: PowerSearchFilter[], changeType: PowerSearchChangeType, index: number) => any) | undefined;
   onBlur?: ((event: FocusEvent) => any) | undefined;
   onFocus?: ((event: FocusEvent) => any) | undefined;
-  onChange?: ((filters: PowerSearchFilter[], changeType: PowerSearchChangeType, index: number) => any) | undefined;
   "onUpdate:filters"?: ((filters: PowerSearchFilter[]) => any) | undefined;
 }>, {
   size: PowerSearchSize;
   status: PowerSearchStatus;
   statusVariant: PowerSearchStatusVariant;
-  disabled: boolean;
   labelHidden: boolean;
+  disabled: boolean;
   clearable: boolean;
   overflow: PowerSearchOverflow;
   readOnly: boolean;

package/dist/{index-C7mxUcDR.d.ts → index-B4OOtNP8.d.ts}

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

package/dist/index-BBtJt5_A.d.ts

@@ -0,0 +1,26 @@
+import { n as LinkProps, t as LinkColor } from "./types-D_J66aPN.js";
+//#region src/Link/Link.vue.d.ts
+type __VLS_Slots = {
+  default: () => unknown;
+};
+declare const __VLS_base: import("vue").DefineComponent<LinkProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+  click: (event: MouseEvent) => any;
+}, string, import("vue").PublicProps, Readonly<LinkProps> & Readonly<{
+  onClick?: ((event: MouseEvent) => any) | undefined;
+}>, {
+  isDisabled: boolean;
+  color: LinkColor;
+  maxLines: number;
+  isExternalLink: boolean;
+  hasUnderline: boolean;
+  isStandalone: boolean;
+}, {}, {}, {}, 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-CRizexSC.d.ts → index-BH9PzQ1F.d.ts}

@@ -1,89 +1,29 @@
-import { n as SyntaxThemeDefinition } from "./syntaxTheme-Bcs1YMF7.js";
+import { c as ThemeProps, i as MediaThemeProps, n as DefineThemeInput, o as ThemeDefinition, s as ThemeMode } from "./types-gKsEkk2g.js";
 import { ComputedRef } from "vue";
-//#region src/Theme/types.d.ts
-/** Color mode for a theme subtree. `system` follows the page and the OS. */
-type ThemeMode = 'light' | 'dark' | 'system';
-/**
- * A token value.
- *
- * A string is used as written. A two-item tuple is the light stop, then the
- * dark stop, and becomes `light-dark()`.
- */
-type ThemeTokenValue = string | readonly [string, string];
-/** CSS custom properties for a theme. Keys may omit the `--astryx-` prefix. */
-type ThemeTokens = Record<string, ThemeTokenValue>;
-/** Token overrides for one inverted surface. */
-interface ThemeSurfaceInput {
-  tokens?: ThemeTokens;
-}
-interface DefineThemeInput {
-  /** Theme name. Used as `data-astryx-theme`. */
-  name: string;
-  /** Semantic token overrides for this theme. */
-  tokens?: ThemeTokens;
-  /** Another theme to start from. This theme's own values win. */
-  extends?: ThemeDefinition;
-  /** Syntax colors for code in this subtree, unless a SyntaxTheme is closer. */
-  syntax?: SyntaxThemeDefinition;
-  /** Extra tokens for content on a dark surface. */
-  onDark?: ThemeSurfaceInput;
-  /** Extra tokens for content on a light surface. */
-  onLight?: ThemeSurfaceInput;
-}
-interface ThemeDefinition {
-  name: string;
-  /** Token values already written as CSS. */
-  tokens: Readonly<Record<string, string>>;
-  /** Extra tokens applied by MediaTheme when the surface is dark. */
-  onDark: Readonly<Record<string, string>>;
-  /** Extra tokens applied by MediaTheme when the surface is light. */
-  onLight: Readonly<Record<string, string>>;
-  syntax?: SyntaxThemeDefinition;
-  readonly __astryxTheme: true;
-}
-interface ThemeProps {
-  /** Theme from `defineTheme()`. */
-  theme: ThemeDefinition;
-  /**
-   * Color mode for this subtree.
-   * @default 'system'
-   */
-  mode?: ThemeMode;
-}
-/** Surface luminance, `auto` to measure it, or `off` to leave the page theme. */
-type MediaThemeMode = 'dark' | 'light' | 'auto' | 'off';
-interface MediaThemeProps {
-  /**
-   * Which surface the children sit on.
-   * `auto` measures the parent. `off` keeps the surrounding theme.
-   */
-  mode: MediaThemeMode;
-  /**
-   * Side used by `auto` before the surface can be measured, and when it cannot.
-   * @default 'dark'
-   */
-  fallback?: 'dark' | 'light';
-}
+//#region src/Theme/tokenName.d.ts
+/** Accept `--color-accent`, `--astryx-color-accent`, or `color-accent`. */
+declare function normalizeTokenName(name: string): string;
 //#endregion
 //#region src/Theme/defineTheme.d.ts
 declare function isDefinedTheme(value: unknown): value is ThemeDefinition;
-/** Accept `--color-accent`, `--astryx-color-accent`, or `color-accent`. */
-declare function normalizeTokenName(name: string): string;
 /**
  * Create a theme object that `Theme` can apply to a subtree.
  *
  * Token names are the upstream names (`--color-accent`) or this package's
  * prefixed names (`--astryx-color-accent`). A `[light, dark]` tuple becomes
- * `light-dark()`.
+ * `light-dark()`. `color`, `typography`, `radius`, and `motion` generate
+ * tokens; an explicit `tokens` entry wins for that name.
+ *
+ * `var(--color-accent)` inside a value is rewritten to the prefixed name.
  */
 declare function defineTheme(input: DefineThemeInput): ThemeDefinition;
 /** Neutral, with no token overrides. Colors come from `@astryx-vue/themes/neutral.css`. */
 declare const neutralTheme: ThemeDefinition;
 //#endregion
 //#region src/Theme/MediaTheme.vue.d.ts
-declare var __VLS_1$1: {};
+declare var __VLS_1: {};
 type __VLS_Slots$1 = {} & {
-  default?: (props: typeof __VLS_1$1) => any;
+  default?: (props: typeof __VLS_1) => any;
 };
 declare const __VLS_base$1: import("vue").DefineComponent<MediaThemeProps, {
   element: Readonly<import("vue").ShallowRef<HTMLElement | null>>;
@@ -99,9 +39,9 @@ type __VLS_WithSlots$1<T, S> = T & {
 };
 //#endregion
 //#region src/Theme/Theme.vue.d.ts
-declare var __VLS_1: {};
+declare var __VLS_6: {};
 type __VLS_Slots = {} & {
-  default?: (props: typeof __VLS_1) => any;
+  default?: (props: typeof __VLS_6) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<ThemeProps, {
   element: Readonly<import("vue").ShallowRef<HTMLElement | null>>;
@@ -144,4 +84,4 @@ interface UseThemeReturn {
  */
 declare function useTheme(): UseThemeReturn;
 //#endregion
-export { ThemeSurfaceInput as _, _default as a, isDefinedTheme as c, DefineThemeInput as d, MediaThemeMode as f, ThemeProps as g, ThemeMode as h, useMediaTheme as i, neutralTheme as l, ThemeDefinition as m, useTheme as n, _default$1 as o, MediaThemeProps as p, UseMediaThemeReturn as r, defineTheme as s, UseThemeReturn as t, normalizeTokenName as u, ThemeTokenValue as v, ThemeTokens as y };
+export { _default as a, isDefinedTheme as c, useMediaTheme as i, neutralTheme as l, useTheme as n, _default$1 as o, UseMediaThemeReturn as r, defineTheme as s, UseThemeReturn as t, normalizeTokenName as u };

package/dist/index-BPwD6aBv.d.ts

@@ -0,0 +1,83 @@
+import { o as FieldStatusInput } from "./types-3eXh_5os.js";
+import { ComputedRef, InjectionKey } from "vue";
+//#region src/InputGroup/context.d.ts
+interface InputGroupContext {
+  size: ComputedRef<'sm' | 'md' | 'lg'>;
+  disabled: ComputedRef<boolean>;
+  /** 组标签的 id。没有标签时为空。 */
+  labelId: ComputedRef<string | undefined>;
+  /** 组的说明和状态文案 id，组内控件可以接进 aria-describedby。 */
+  describedBy: ComputedRef<string | undefined>;
+}
+declare const INPUT_GROUP_KEY: InjectionKey<InputGroupContext>;
+//#endregion
+//#region src/InputGroup/types.d.ts
+type InputGroupSize = 'sm' | 'md' | 'lg';
+interface InputGroupProps {
+  /**
+   * 整组的无障碍名称。写上之后，组会带上标签、说明、可选或必填，以及状态。
+   * 组内输入框自己的标签继续说明这一格填什么，通常隐藏起来。
+   */
+  label?: string;
+  /** 视觉上隐藏标签，读屏仍能读到。 */
+  isLabelHidden?: boolean;
+  /** 标签和控件之间的说明。 */
+  description?: string;
+  /** 是否禁用整组，并传给组内控件。 */
+  disabled?: boolean;
+  /** 在标签旁标成可选。 */
+  isOptional?: boolean;
+  /** 在标签旁标成必填。 */
+  isRequired?: boolean;
+  /** 尺寸，传给组内控件。 */
+  size?: InputGroupSize;
+  /** 整组边框和控件下方的状态。 */
+  status?: FieldStatusInput;
+  /** 标签末尾的提示。 */
+  labelTooltip?: string;
+}
+interface InputGroupSlots {
+  /** 前缀内容（图标或文本） */
+  before?: () => any;
+  /** 主输入框 */
+  default?: () => any;
+  /** 后缀内容（图标或按钮） */
+  after?: () => any;
+}
+interface InputGroupTextProps {
+  /** 供测试定位。 */
+  id?: string;
+}
+interface InputGroupTextSlots {
+  default?: () => any;
+}
+//#endregion
+//#region src/InputGroup/InputGroup.vue.d.ts
+type __VLS_Slots$1 = InputGroupSlots;
+declare const __VLS_base$1: import("vue").DefineComponent<InputGroupProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<InputGroupProps> & Readonly<{}>, {
+  size: InputGroupSize;
+  isOptional: boolean;
+  isLabelHidden: boolean;
+  isRequired: boolean;
+  disabled: 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;
+type __VLS_WithSlots$1<T, S> = T & {
+  new (): {
+    $slots: S;
+  };
+};
+//#endregion
+//#region src/InputGroup/InputGroupText.vue.d.ts
+type __VLS_Slots = InputGroupTextSlots;
+declare const __VLS_base: import("vue").DefineComponent<InputGroupTextProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<InputGroupTextProps> & 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 { InputGroupSlots as a, INPUT_GROUP_KEY as c, InputGroupSize as i, InputGroupContext as l, _default$1 as n, InputGroupTextProps as o, InputGroupProps as r, InputGroupTextSlots as s, _default as t };