@astryx-vue/core 0.2.6 → 0.4.0

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

@@ -1,4 +1,6 @@
-import { a as SearchableItem, i as SearchSource } from "./useAsyncSource-xpQovjV_.js";
+import { a as SearchableItem, i as SearchSource } from "./useAsyncSource-aGzrvRkI.js";
+import { t as FieldPartStylingProps } from "./fieldParts-LXpQMKE8.js";
+import { HTMLAttributes, StyleValue } from "vue";
 //#region src/Typeahead/types.d.ts
 type TypeaheadSize = 'sm' | 'md' | 'lg';
 type TypeaheadStatus = 'default' | 'success' | 'warning' | 'error';
@@ -54,15 +56,20 @@ interface BaseTypeaheadProps<T extends SearchableItem = SearchableItem> {
   name?: string;
   /** 输入框在 Tab 序里的位置。 */
   inputTabIndex?: number;
+  /** 加到输入外框上，不落到原生 input。 */
+  controlClass?: HTMLAttributes['class'];
+  controlStyle?: StyleValue;
 }
-interface TypeaheadProps<T extends SearchableItem = SearchableItem> {
+interface TypeaheadProps<T extends SearchableItem = SearchableItem> extends FieldPartStylingProps {
   /** 当前选中的条目。空表示还没选。 */
   modelValue?: T | null;
   /** 静态或异步搜索源。 */
   searchSource: SearchSource<T>;
   /** 字段标签。屏幕阅读器始终读得到。 */
   label: string;
-  /** 视觉上隐藏标签。 */
+  /** 视觉上隐藏标签。读屏仍然读得到。 */
+  isLabelHidden?: boolean;
+  /** `isLabelHidden` 的旧名。两者任一为真就隐藏。 */
   labelHidden?: boolean;
   /** 标签下方的说明。 */
   description?: string;
@@ -101,6 +108,8 @@ interface TypeaheadProps<T extends SearchableItem = SearchableItem> {
   /** 表单字段名。选中后提交条目的 id。 */
   name?: string;
   width?: number | string;
+  /** 输入框起始侧的图标。没有 icon 插槽时使用。 */
+  startIcon?: unknown;
 }
 interface TypeaheadEmits<T extends SearchableItem = SearchableItem> {
   'update:modelValue': [value: T | null];
@@ -139,8 +148,8 @@ interface TypeaheadSlots<T extends SearchableItem = SearchableItem> {
 //#region src/Typeahead/BaseTypeahead.vue.d.ts
 declare const __VLS_export$2: <T extends SearchableItem>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal$1<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
   props: import("vue").PublicProps & __VLS_PrettifyLocal$1<BaseTypeaheadProps<T> & {
-    onChange?: ((value: T | null) => any) | undefined;
     onSearch?: ((query: string) => any) | undefined;
+    onChange?: ((value: T | null) => any) | undefined;
     onOpenChange?: ((isOpen: boolean) => any) | undefined;
     "onUpdate:modelValue"?: ((value: T | null) => any) | undefined;
     onChangeQuery?: ((query: string) => any) | undefined;
@@ -153,7 +162,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: "openChange", isOpen: boolean) => void) & ((evt: "update:modelValue", value: T | null) => void) & ((evt: "changeQuery", query: string) => void);
+  emit: ((evt: "search", query: string) => void) & ((evt: "change", value: T | null) => 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>>;
 };
@@ -163,8 +172,8 @@ type __VLS_PrettifyLocal$1<T> = (T extends any ? { [K in keyof T]: T[K]; } : { [
 //#region src/Typeahead/Typeahead.vue.d.ts
 declare const __VLS_export$1: <T extends SearchableItem>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
   props: import("vue").PublicProps & __VLS_PrettifyLocal<TypeaheadProps<T> & {
-    onChange?: ((value: T | null) => any) | undefined;
     onSearch?: ((query: string) => any) | undefined;
+    onChange?: ((value: T | null) => any) | undefined;
     onOpenChange?: ((isOpen: boolean) => any) | undefined;
     "onUpdate:modelValue"?: ((value: T | null) => any) | undefined;
     onChangeQuery?: ((query: string) => any) | undefined;
@@ -177,7 +186,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: "openChange", isOpen: boolean) => void) & ((evt: "update:modelValue", value: T | null) => void) & ((evt: "changeQuery", query: string) => void);
+  emit: ((evt: "search", query: string) => void) & ((evt: "change", value: T | null) => 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-Bo-ofFyg.d.ts

@@ -0,0 +1,166 @@
+import { c as ThemeProps, i as MediaThemeProps, n as DefineThemeInput, o as ThemeDefinition, s as ThemeMode } from "./types-CsqwQkf1.js";
+import { ComputedRef } from "vue";
+//#region src/Theme/dataTokens.d.ts
+/**
+ * Data-visualization color defaults, by upstream name.
+ *
+ * The CSS lives in `@astryx-vue/themes/data.css`, which every theme entry
+ * imports; this is the same group for code that paints outside CSS, such as
+ * a canvas chart, and for checking a theme's `--color-data-*` overrides.
+ * `data.test.ts` keeps the two in sync.
+ */
+declare const DATA_TOKEN_DEFAULTS: {
+  readonly '--color-data-categorical-blue': "light-dark(#0171E3, #0171E3)";
+  readonly '--color-data-categorical-orange': "light-dark(#EB6E00, #EB6E00)";
+  readonly '--color-data-categorical-purple': "light-dark(#6B1EFD, #6B1EFD)";
+  readonly '--color-data-categorical-green': "light-dark(#0B991F, #0B991F)";
+  readonly '--color-data-categorical-pink': "light-dark(#F351C0, #F351C0)";
+  readonly '--color-data-categorical-cyan': "light-dark(#0171A4, #0171A4)";
+  readonly '--color-data-categorical-red': "light-dark(#F5394F, #F5394F)";
+  readonly '--color-data-categorical-teal': "light-dark(#08A3A3, #08A3A3)";
+  readonly '--color-data-categorical-brown': "light-dark(#965E03, #965E03)";
+  readonly '--color-data-categorical-indigo': "light-dark(#6F8AFF, #6F8AFF)";
+  readonly '--color-data-neutral': "light-dark(#8494A3, #8C939B)";
+  readonly '--color-data-blue-5': "light-dark(#02165E, #02165E)";
+  readonly '--color-data-blue-4': "light-dark(#004CBC, #004CBC)";
+  readonly '--color-data-blue-3': "light-dark(#2694FE, #2694FE)";
+  readonly '--color-data-blue-2': "light-dark(#78BEFF, #78BEFF)";
+  readonly '--color-data-blue-1': "light-dark(#DBECFF, #DBECFF)";
+  readonly '--color-data-shamrock-5': "light-dark(#0B603D, #0B603D)";
+  readonly '--color-data-shamrock-4': "light-dark(#138546, #138546)";
+  readonly '--color-data-shamrock-3': "light-dark(#24BB5E, #24BB5E)";
+  readonly '--color-data-shamrock-2': "light-dark(#8EF7AA, #8EF7AA)";
+  readonly '--color-data-shamrock-1': "light-dark(#D6FEE4, #D6FEE4)";
+  readonly '--color-data-orange-5': "light-dark(#A13F04, #A13F04)";
+  readonly '--color-data-orange-4': "light-dark(#D66100, #D66100)";
+  readonly '--color-data-orange-3': "light-dark(#FD9537, #FD9537)";
+  readonly '--color-data-orange-2': "light-dark(#FDB876, #FDB876)";
+  readonly '--color-data-orange-1': "light-dark(#FFE6CF, #FFE6CF)";
+  readonly '--color-data-pink-5': "light-dark(#8E1073, #8E1073)";
+  readonly '--color-data-pink-4': "light-dark(#D123A1, #D123A1)";
+  readonly '--color-data-pink-3': "light-dark(#F989D3, #F989D3)";
+  readonly '--color-data-pink-2': "light-dark(#FEADE3, #FEADE3)";
+  readonly '--color-data-pink-1': "light-dark(#FCE3F4, #FCE3F4)";
+  readonly '--color-data-purple-5': "light-dark(#3E0697, #3E0697)";
+  readonly '--color-data-purple-4': "light-dark(#6B1EFD, #6B1EFD)";
+  readonly '--color-data-purple-3': "light-dark(#9081FF, #9081FF)";
+  readonly '--color-data-purple-2': "light-dark(#B3B0FE, #B3B0FE)";
+  readonly '--color-data-purple-1': "light-dark(#E8E8FB, #E8E8FB)";
+  readonly '--color-data-red-5': "light-dark(#9D0519, #9D0519)";
+  readonly '--color-data-red-4': "light-dark(#D31130, #D31130)";
+  readonly '--color-data-red-3': "light-dark(#FB7D87, #FB7D87)";
+  readonly '--color-data-red-2': "light-dark(#FFB2B8, #FFB2B8)";
+  readonly '--color-data-red-1': "light-dark(#FEE4E6, #FEE4E6)";
+  readonly '--color-data-teal-5': "light-dark(#08767D, #08767D)";
+  readonly '--color-data-teal-4': "light-dark(#0C9293, #0C9293)";
+  readonly '--color-data-teal-3': "light-dark(#0DB7AF, #0DB7AF)";
+  readonly '--color-data-teal-2': "light-dark(#6CE6D8, #6CE6D8)";
+  readonly '--color-data-teal-1': "light-dark(#D7FCF8, #D7FCF8)";
+  readonly '--color-data-yellow-5': "light-dark(#8A5001, #8A5001)";
+  readonly '--color-data-yellow-4': "light-dark(#D69804, #D69804)";
+  readonly '--color-data-yellow-3': "light-dark(#FBCE03, #FBCE03)";
+  readonly '--color-data-yellow-2': "light-dark(#FCEC85, #FCEC85)";
+  readonly '--color-data-yellow-1': "light-dark(#FDF6BA, #FDF6BA)";
+  readonly '--color-data-gray-5': "light-dark(#25363F, #333338)";
+  readonly '--color-data-gray-4': "light-dark(#5D6C7B, #666A72)";
+  readonly '--color-data-gray-3': "light-dark(#AFB9C4, #B2B8BE)";
+  readonly '--color-data-gray-2': "light-dark(#CCD3DB, #D0D3D6)";
+  readonly '--color-data-gray-1': "light-dark(#F1F4F7, #F2F4F6)";
+};
+type DataTokenName = keyof typeof DATA_TOKEN_DEFAULTS;
+//#endregion
+//#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;
+/**
+ * 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()`. `color`, `typography`, `radius`, and `motion` generate
+ * tokens; an explicit `tokens` entry wins for that name.
+ *
+ * `extends` starts from everything the base theme resolved to: tokens,
+ * local tokens, component styles, surfaces, adaptations, icons, indicators.
+ * This theme's own values win, and the result is self-contained.
+ */
+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: {};
+type __VLS_Slots$1 = {} & {
+  default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base$1: import("vue").DefineComponent<MediaThemeProps, {
+  element: Readonly<import("vue").ShallowRef<HTMLElement | null>>;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<MediaThemeProps> & Readonly<{}>, {
+  fallback: "dark" | "light";
+}, {}, {}, {}, 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/Theme/Theme.vue.d.ts
+declare var __VLS_6: {};
+type __VLS_Slots = {} & {
+  default?: (props: typeof __VLS_6) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<ThemeProps, {
+  element: Readonly<import("vue").ShallowRef<HTMLElement | null>>;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<ThemeProps> & Readonly<{}>, {
+  mode: ThemeMode;
+}, {}, {}, {}, 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
+//#region src/Theme/useMediaTheme.d.ts
+interface UseMediaThemeReturn {
+  /** Resolved surface. `off` means the children keep the surrounding theme. */
+  mode: ComputedRef<'dark' | 'light' | 'off'>;
+}
+/** Read the nearest MediaTheme. Outside one, the mode is `off`. */
+declare function useMediaTheme(): UseMediaThemeReturn;
+//#endregion
+//#region src/Theme/colorMode.d.ts
+type ResolvedColorMode = 'light' | 'dark';
+//#endregion
+//#region src/Theme/useTheme.d.ts
+interface UseThemeReturn {
+  /** Name of the nearest theme, or `neutral` when no theme is present. */
+  name: ComputedRef<string>;
+  /** Effective light or dark mode. `system` is resolved. */
+  mode: ComputedRef<ResolvedColorMode>;
+  /** Resolve one token for the effective mode. */
+  token: (name: string) => string;
+  /** Tokens declared by the nearest theme, resolved for the effective mode. */
+  tokens: ComputedRef<Record<string, string>>;
+}
+/**
+ * Read the nearest theme. Outside a `Theme`, the name is `neutral` and tokens
+ * are read from the document's custom properties.
+ *
+ * Values are the theme's root values. An adaptation rule that changes a token
+ * on narrow or touch screens applies through CSS only, so `token()` and
+ * `tokens` stay the same across environments.
+ *
+ * The returned object and `token` are created once per component. `name`,
+ * `mode`, and `tokens` update only when the theme or the effective mode
+ * changes, so watching them does not trigger on unrelated renders.
+ */
+declare function useTheme(): UseThemeReturn;
+//#endregion
+export { _default as a, isDefinedTheme as c, DATA_TOKEN_DEFAULTS as d, DataTokenName as f, 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-i0tNFWfz.d.ts → index-BqhgeAT4.d.ts}

@@ -18,6 +18,8 @@ interface TokenProps {
   /** 补充说明，读屏可读。 */
   description?: string;
   /** 视觉上隐藏文字，仍然作为无障碍名称。 */
+  isLabelHidden?: boolean;
+  /** `isLabelHidden` 的旧名。两者任一为真就隐藏。 */
   labelHidden?: boolean;
 }
 interface TokenEmits {

package/dist/{index-DWh2WC8W.d.ts → index-C4Cjz6OK.d.ts}

@@ -1,7 +1,7 @@
 import { n as SpacingStep } from "./types-BTk0WZ0b.js";
 import { o as SizeValue } from "./types-uFMH9NaM.js";
-import { r as ResizableProps } from "./useResizable-DDwPpPe6.js";
-import { ComputedRef, InjectionKey, VNodeChild } from "vue";
+import { r as ResizableProps } from "./useResizable-1MHPNaRD.js";
+import { ComputedRef, VNodeChild } from "vue";
 //#region src/Layout/context.d.ts
 type LayoutArea = 'header' | 'start' | 'content' | 'end' | 'footer';
 type LayoutHeight = 'fill' | 'auto';

package/dist/{index-B7yhzGUT.d.ts → index-C7sam-SB.d.ts}

@@ -52,13 +52,13 @@ interface TooltipProps {
 }
 //#endregion
 //#region src/Tooltip/Tooltip.vue.d.ts
-declare var __VLS_1: {}, __VLS_3: {}, __VLS_11: {};
+declare var __VLS_1: {}, __VLS_3: {}, __VLS_17: {};
 type __VLS_Slots = {} & {
   default?: (props: typeof __VLS_1) => any;
 } & {
   default?: (props: typeof __VLS_3) => any;
 } & {
-  content?: (props: typeof __VLS_11) => any;
+  content?: (props: typeof __VLS_17) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<TooltipProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
   openChange: (isOpen: boolean) => any;

package/dist/{index-BrJzFA5X.d.ts → index-C90l2rH1.d.ts}

@@ -1,4 +1,4 @@
-import { ComputedRef, InjectionKey, VNodeChild } from "vue";
+import { ComputedRef, VNodeChild } from "vue";
 //#region src/FormLayout/context.d.ts
 type FormLayoutDirection = 'vertical' | 'horizontal' | 'horizontal-labels';
 type FormOptionality = 'optional' | 'required';

package/dist/{index-vP0EtrJJ.d.ts → index-C9gAlDt_.d.ts}

@@ -1,4 +1,4 @@
-import { i as IconProps, n as IconColor, o as IconSlots, r as IconName } from "./types-CwyibrRB.js";
+import { c as NamespacedIconName, i as IconProps, n as IconColor, r as IconName, s as IconSlots } from "./types-C5GQ2KCK.js";
 import { ComputedRef, MaybeRefOrGetter } from "vue";
 //#region src/Icon/glyphs.d.ts
 /**
@@ -6,12 +6,15 @@ import { ComputedRef, MaybeRefOrGetter } from "vue";
  * components use, or a namespaced key such as `owner:key` that a component
  * owns.
  */
-type IconGlyphName = IconName | `${string}:${string}`;
+type IconGlyphName = IconName | NamespacedIconName;
 /**
  * The artwork kept for the components' own chrome. Applications bring their own
  * icons; this list only has to cover what astryx-vue draws itself.
+ *
+ * The shared names come first. Namespaced keys after them belong to one
+ * component each; a theme overrides them by key through `defineTheme({ icons })`.
  */
-declare const ICON_GLYPHS: readonly ["close", "chevronDown", "chevronLeft", "chevronRight", "chevronsLeft", "chevronsRight", "check", "success", "error", "warning", "info", "calendar", "clock", "externalLink", "menu", "moreHorizontal", "search", "upload", "arrowUp", "arrowDown", "arrowsUpDown", "funnel", "eyeSlash", "viewColumns", "copy", "checkDouble", "wrench", "stop", "microphone", "image"];
+declare const ICON_GLYPHS: readonly ["close", "chevronDown", "chevronLeft", "chevronRight", "chevronsLeft", "chevronsRight", "check", "success", "error", "warning", "info", "calendar", "clock", "externalLink", "menu", "moreHorizontal", "search", "upload", "arrowUp", "arrowDown", "arrowsUpDown", "funnel", "eyeSlash", "viewColumns", "copy", "checkDouble", "wrench", "stop", "microphone", "image", "numberInput:stepperDown"];
 declare function isIconGlyph(value: string): value is IconGlyphName;
 /** The CSS-safe form of a name, used as the `astryx-icon--<slug>` class. */
 declare function iconGlyphSlug(name: IconGlyphName): string;

package/dist/{index-csA1lH_0.d.ts → index-CJ6ajsUC.d.ts}

@@ -1,4 +1,4 @@
-import { c as TextType, l as TextWeight, n as TextColor, o as TextSize } from "./types-BBWrcHMD.js";
+import { c as TextType, l as TextWeight, n as TextColor, o as TextSize } from "./types-Ckih2YJi.js";
 //#region src/Timer/format.d.ts
 type TimerFormat = 'elapsed' | 'clock';
 interface TimerPresentation {
@@ -44,8 +44,8 @@ interface TimerProps {
 //#region src/Timer/Timer.vue.d.ts
 declare const __VLS_export: import("vue").DefineComponent<TimerProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<TimerProps> & Readonly<{}>, {
   type: TimerType;
-  color: TimerColor;
   format: "clock" | "elapsed";
+  color: TimerColor;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 //#endregion

package/dist/{index-CY-KvZ9B.d.ts → index-CK-Dbh0f.d.ts}

@@ -106,9 +106,9 @@ declare const __VLS_base: import("vue").DefineComponent<PaginationProps, {}, {},
   onPageSizeChange?: ((pageSize: number) => any) | undefined;
 }>, {
   isDisabled: boolean;
+  size: PaginationSize;
   variant: PaginationVariant;
   step: number;
-  size: PaginationSize;
   disabled: boolean;
   page: number;
   pageSize: number;