@astryx-vue/lab 0.0.0-stage → 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,912 @@
+import { VNodeChild } from "vue";
+import { FieldStatusInput, IconSize, PopoverPlacement } from "@astryx-vue/core";
+//#region src/CircularProgress/types.d.ts
+/** Variants a theme can extend through declaration merging in TypeScript. */
+interface CircularProgressVariantMap {
+  accent: true;
+  success: true;
+  warning: true;
+  error: true;
+  neutral: true;
+}
+type CircularProgressVariant = keyof CircularProgressVariantMap;
+type CircularProgressSize = 'sm' | 'md' | 'lg';
+interface CircularProgressProps {
+  /** Current value of the circular progress. Ignored when `isIndeterminate` is true. */
+  value?: number;
+  /**
+   * Maximum value.
+   * @default 100
+   */
+  max?: number;
+  /** Accessible label for the progress indicator. Required for a11y. */
+  label: string;
+  /**
+   * When true, the label is visually hidden but stays accessible to screen readers.
+   * @default true
+   */
+  isLabelHidden?: boolean;
+  /**
+   * When true, shows the formatted value (e.g. "75%") in the center of the ring.
+   * Ignored when `isIndeterminate` is true, or when the default slot provides
+   * custom center content.
+   * @default false
+   */
+  hasValueLabel?: boolean;
+  /**
+   * Custom formatter for the value label.
+   * @default (value, max) => `${Math.round((value / max) * 100)}%`
+   */
+  formatValueLabel?: (value: number, max: number) => string;
+  /**
+   * Diameter of the ring.
+   * @default 'md'
+   */
+  size?: CircularProgressSize;
+  /**
+   * Visual style variant mapped to semantic color tokens.
+   * @default 'accent'
+   */
+  variant?: CircularProgressVariant;
+  /**
+   * Animated indeterminate indicator for unknown progress. `value` and
+   * `hasValueLabel` are ignored in this mode; reduced motion slows the animation.
+   * @default false
+   */
+  isIndeterminate?: boolean;
+  /**
+   * Disabled colors for canceled or inactive operations.
+   * @default false
+   */
+  isDisabled?: boolean;
+}
+//#endregion
+//#region src/CircularProgress/CircularProgress.vue.d.ts
+declare var __VLS_1$1: {};
+type __VLS_Slots$3 = {} & {
+  default?: (props: typeof __VLS_1$1) => any;
+};
+declare const __VLS_base$3: import("vue").DefineComponent<CircularProgressProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<CircularProgressProps> & Readonly<{}>, {
+  value: number;
+  size: CircularProgressSize;
+  max: number;
+  isLabelHidden: boolean;
+  hasValueLabel: boolean;
+  formatValueLabel: (value: number, max: number) => string;
+  variant: keyof CircularProgressVariantMap;
+  isIndeterminate: boolean;
+  isDisabled: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export$8: __VLS_WithSlots$3<typeof __VLS_base$3, __VLS_Slots$3>;
+declare const _default: typeof __VLS_export$8;
+type __VLS_WithSlots$3<T, S> = T & {
+  new (): {
+    $slots: S;
+  };
+};
+//#endregion
+//#region src/InfoTip/types.d.ts
+/**
+ * Size of the info icon. Maps 1:1 to core `Icon` sizes
+ * (xsm: 12px, sm: 16px, md: 20px, lg: 24px).
+ */
+type InfoTipSize = IconSize;
+interface InfoTipProps {
+  /**
+   * Tooltip content as plain text. Use the `content` slot for rich content.
+   */
+  content?: string;
+  /**
+   * Accessible name for the trigger button.
+   * @default 'More information'
+   */
+  label?: string;
+  /**
+   * Size of the info icon.
+   * @default 'sm'
+   */
+  size?: InfoTipSize;
+}
+//#endregion
+//#region src/InfoTip/InfoTip.vue.d.ts
+declare var __VLS_13$1: {};
+type __VLS_Slots$2 = {} & {
+  content?: (props: typeof __VLS_13$1) => any;
+};
+declare const __VLS_base$2: import("vue").DefineComponent<InfoTipProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<InfoTipProps> & Readonly<{}>, {
+  label: string;
+  size: import("@astryx-vue/core").IconSize;
+  content: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export$7: __VLS_WithSlots$2<typeof __VLS_base$2, __VLS_Slots$2>;
+declare const _default$1: typeof __VLS_export$7;
+type __VLS_WithSlots$2<T, S> = T & {
+  new (): {
+    $slots: S;
+  };
+};
+//#endregion
+//#region src/ListInput/types.d.ts
+/** 一次列表改动。`update` 里 `columnKey` 是触发改动的列。 */
+type ListInputChange<T> = {
+  type: 'add';
+  item: T;
+  index: number;
+} | {
+  type: 'update';
+  item: T;
+  previousItem: T;
+  index: number;
+  columnKey?: string;
+} | {
+  type: 'remove';
+  item: T;
+  index: number;
+} | {
+  type: 'reorder';
+  item: T;
+  fromIndex: number;
+  toIndex: number;
+};
+/** 单元格渲染器拿到的、和位置有关的上下文。 */
+interface ListInputValueContext<T> {
+  /** 当前记录。 */
+  item: T;
+  /** 当前可见位置，从 0 开始。 */
+  index: number;
+  /** 单元格的无障碍名，已经带上这是第几条。 */
+  label: string;
+  /** 永远是 `true`：列名由 ListInput 自己画，字段不用再画一遍。 */
+  isLabelHidden: boolean;
+}
+interface ListInputRenderContext<T> extends ListInputValueContext<T> {
+  /** 这一格自己的校验状态。 */
+  status?: {
+    type: 'error' | 'warning' | 'success';
+    message?: string;
+  };
+  /** 交给 Astryx 输入控件，让它用自带的提示气泡显示状态。 */
+  statusVariant: 'tooltip';
+  isDisabled: boolean;
+  isLoading: boolean;
+  /** 换掉这一条记录。`columnKey` 不传时用当前列的 key。 */
+  updateItem: (nextItem: T, columnKey?: string) => void;
+}
+/** 列宽：按比例分配时给一个最小宽度兜底，也可以直接写死像素。 */
+type ListInputColumnWidth = {
+  type: 'proportional';
+  value?: number;
+  minWidth?: number;
+} | {
+  type: 'pixel';
+  value: number;
+};
+interface ListInputColumn<T> {
+  /** 列标识，同时传给 `getFieldStatus`。 */
+  key: string;
+  /** 列名。只在第一条上显示；行堆叠时每条都显示。 */
+  header: string;
+  /** 列宽。默认是比例列，最小 140px。 */
+  width?: ListInputColumnWidth;
+  /** 画这一格的输入控件。 */
+  renderInput: (context: ListInputRenderContext<T>) => VNodeChild;
+}
+interface ListInputProps<T> {
+  /** 列表的可见标签，也是无障碍名。 */
+  label: string;
+  description?: string;
+  modelValue?: T[];
+  /** 每条记录的唯一键，用来保持焦点和顺序。 */
+  getItemKey: (item: T) => string | number;
+  /** 点「添加」时造一条新记录。 */
+  createItem: () => T;
+  columns: ListInputColumn<T>[];
+  /** 操作名和播报里用的单数名词。 */
+  itemName?: string;
+  /** 整个列表的校验状态。 */
+  status?: {
+    type: 'error' | 'warning' | 'success';
+    message?: string;
+  };
+  /** 一条记录整体的校验状态，显示在该行下方。 */
+  getItemStatus?: (item: T, index: number) => {
+    type: 'error' | 'warning' | 'success';
+    message?: string;
+  } | undefined;
+  /** 单格的校验状态，交给对应的输入控件。 */
+  getFieldStatus?: (item: T, columnKey: string, index: number) => {
+    type: 'error' | 'warning' | 'success';
+    message?: string;
+  } | undefined;
+  /** 显示拖动手柄，可以拖动或用键盘调整顺序。 */
+  isReorderable?: boolean;
+  isDisabled?: boolean;
+  /** 列表正忙：所有改动都被挡住，但值仍然可读。 */
+  isLoading?: boolean;
+  /** 最多几条。到上限时「添加」禁用，但删除照常可用。 */
+  maxItems?: number;
+  isLabelHidden?: boolean;
+  isOptional?: boolean;
+  isRequired?: boolean;
+}
+interface ListInputEmits<T> {
+  'update:modelValue': [value: T[]];
+  'change': [value: T[], change: ListInputChange<T>];
+}
+//#endregion
+//#region src/ListInput/ListInput.vue.d.ts
+declare const __VLS_export$6: <T>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal$3<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$3<ListInputProps<T> & {
+    "onUpdate:modelValue"?: ((value: T[]) => any) | undefined;
+    onChange?: ((value: T[], change: ListInputChange<T>) => any) | undefined;
+  }> & (typeof globalThis extends {
+    __VLS_PROPS_FALLBACK: infer P;
+  } ? P : {});
+  expose: (exposed: {}) => void;
+  attrs: any;
+  slots: {};
+  emit: ((evt: "update:modelValue", value: T[]) => void) & ((evt: "change", value: T[], change: ListInputChange<T>) => void);
+}>) => import("vue").VNode & {
+  __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
+};
+declare const _default$2: typeof __VLS_export$6;
+type __VLS_PrettifyLocal$3<T> = (T extends any ? { [K in keyof T]: T[K]; } : { [K in keyof T as K]: T[K]; }) & {};
+//#endregion
+//#region src/LogStream/types.d.ts
+/** Severity of one log entry. */
+type LogStreamLevel = 'info' | 'warn' | 'error' | 'debug';
+/** One row in the stream; all strings are pre-formatted by the caller. */
+interface LogEntry {
+  /** Stable unique key, e.g. `"req-1042"`. */
+  id: string;
+  /** Pre-formatted timestamp, e.g. `"14:02:11.482"`. Deterministic. */
+  timestamp: string;
+  level: LogStreamLevel;
+  message: string;
+  /** Emitting service/component, e.g. `"api-gateway"`. */
+  source?: string;
+  /**
+   * When set, the row becomes a disclosure button that opens this detail.
+   *
+   * 纯文字用这个字段；要放富内容时同时给 `detail` 插槽（`#detail="{ entry }"`），
+   * 插槽内容优先，而这一行是否可展开仍然只看这个字段有没有值。
+   */
+  detail?: string;
+}
+interface LogStreamProps {
+  /** Log rows, oldest first (live tails append at the end). */
+  entries: LogEntry[];
+  /**
+   * Visual treatment. `'terminal'` renders dark chrome regardless of the active
+   * color scheme: terminal output is a brand surface, like a real shell.
+   * @default 'default'
+   */
+  variant?: 'default' | 'terminal';
+  /**
+   * Pin scroll to the newest entry as entries append. Unpins when the user
+   * scrolls up. Bind it with `v-model:isFollowing` for controlled usage; leave
+   * it unbound and the component owns the state (initially unpinned).
+   */
+  isFollowing?: boolean;
+  /** Max height of the scroll area before it scrolls. */
+  maxHeight?: number | string;
+  /**
+   * Show the timestamp column.
+   * @default true
+   */
+  hasTimestamps?: boolean;
+  /**
+   * Accessible label for the log region.
+   * @default 'Log stream'
+   */
+  label?: string;
+}
+interface LogStreamEmits {
+  /** Emitted with the follow state the user asks for (scroll-up, "Jump to latest"). */
+  followChange: [following: boolean];
+}
+//#endregion
+//#region src/LogStream/LogStream.vue.d.ts
+type __VLS_Props = LogStreamProps;
+type __VLS_ModelProps = {
+  'isFollowing'?: boolean;
+};
+type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
+declare var __VLS_2: {
+  entry: LogEntry;
+}, __VLS_13: {
+  entry: LogEntry;
+};
+type __VLS_Slots$1 = {} & {
+  entry?: (props: typeof __VLS_2) => any;
+} & {
+  detail?: (props: typeof __VLS_13) => any;
+};
+declare const __VLS_base$1: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+  "update:isFollowing": (value: boolean) => any;
+  followChange: (following: boolean) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+  "onUpdate:isFollowing"?: ((value: boolean) => any) | undefined;
+  onFollowChange?: ((following: boolean) => any) | undefined;
+}>, {
+  label: string;
+  variant: "default" | "terminal";
+  maxHeight: string | number;
+  hasTimestamps: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export$5: __VLS_WithSlots$1<typeof __VLS_base$1, __VLS_Slots$1>;
+declare const _default$3: typeof __VLS_export$5;
+type __VLS_WithSlots$1<T, S> = T & {
+  new (): {
+    $slots: S;
+  };
+};
+//#endregion
+//#region src/MobileTokenizer/types.d.ts
+/**
+ * 一条可搜索的候选项。字段和 core `Typeahead` 的 `SearchableItem` 一致，
+ * 这样 core 的 `SearchSource` 可以直接传进来。
+ */
+interface SearchableItem {
+  id: string;
+  label: string;
+  disabled?: boolean;
+  description?: string;
+}
+/**
+ * 搜索数据源。同步数组和 Promise 都可以，和 core `Typeahead` 的 `SearchSource` 同形。
+ * 空查询时优先走 `bootstrap`，没有就用空字符串搜一次。
+ */
+interface SearchSource<T extends SearchableItem = SearchableItem> {
+  search: (query: string, signal?: AbortSignal) => Promise<T[]> | T[];
+  bootstrap?: (signal?: AbortSignal) => Promise<T[]> | T[];
+  cancel?: () => void;
+}
+/**
+ * 一次选择变化。`add` 加已有条目，`create` 加用户新造的值，
+ * `remove` 去掉一条。一次清空全部时 `item` 是原来最后一条。
+ */
+type MobileTokenizerChange<T extends SearchableItem = SearchableItem> = {
+  item: T;
+  type: 'add';
+} | {
+  item: T;
+  type: 'create';
+} | {
+  item: T;
+  type: 'remove';
+};
+interface MobileTokenizerProps<T extends SearchableItem = SearchableItem> {
+  /** 字段标签，同时是底部面板的无障碍名。 */
+  label: string;
+  searchSource: SearchSource<T>;
+  modelValue?: readonly T[];
+  /** 一条都没选时触发器里的提示文字。 */
+  placeholder?: string;
+  /** 标签下方的说明。 */
+  description?: string;
+  isOptional?: boolean;
+  isDisabled?: boolean;
+  /** 给没匹配上的文字提供 `Create "…"` 的加一项操作。 */
+  hasCreate?: boolean;
+  /** 最多选几条；到上限后没选中的行会禁用。 */
+  maxEntries?: number;
+  /** 搜索结果最多留多少条，超出的靠滚动分批画出来。 */
+  maxMenuItems?: number;
+  /** 少于这么多字符就不搜。 */
+  minQueryLength?: number;
+  /** 输入停顿多久之后才搜，单位毫秒。 */
+  debounceMs?: number;
+  /** 搜索没有结果时显示的标题。 */
+  emptySearchResultsText?: string;
+}
+interface MobileTokenizerEmits<T extends SearchableItem = SearchableItem> {
+  'update:modelValue': [value: T[]];
+  'change': [value: T[], change: MobileTokenizerChange<T>];
+  'update:query': [query: string];
+  'changeQuery': [query: string];
+  'openChange': [isOpen: boolean];
+}
+//#endregion
+//#region src/MobileTokenizer/MobileTokenizer.vue.d.ts
+declare const __VLS_export$4: <T extends SearchableItem>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal$2<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$2<MobileTokenizerProps<T> & {
+    "onUpdate:modelValue"?: ((value: T[]) => any) | undefined;
+    onChange?: ((value: T[], change: MobileTokenizerChange<T>) => any) | undefined;
+    "onUpdate:query"?: ((query: string) => any) | undefined;
+    onChangeQuery?: ((query: string) => any) | undefined;
+    onOpenChange?: ((isOpen: boolean) => any) | undefined;
+  }> & (typeof globalThis extends {
+    __VLS_PROPS_FALLBACK: infer P;
+  } ? P : {});
+  expose: (exposed: {}) => void;
+  attrs: any;
+  slots: {};
+  emit: ((evt: "update:modelValue", value: T[]) => void) & ((evt: "change", value: T[], change: MobileTokenizerChange<T>) => void) & ((evt: "update:query", query: string) => void) & ((evt: "changeQuery", query: string) => void) & ((evt: "openChange", isOpen: boolean) => void);
+}>) => import("vue").VNode & {
+  __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
+};
+declare const _default$4: typeof __VLS_export$4;
+type __VLS_PrettifyLocal$2<T> = (T extends any ? { [K in keyof T]: T[K]; } : { [K in keyof T as K]: T[K]; }) & {};
+//#endregion
+//#region src/Stat/types.d.ts
+/** Trend direction of a delta; picks the glyph (up/down arrow, flat dash). */
+type StatDeltaDirection = 'up' | 'down' | 'flat';
+/** Color tone of a delta; overrides the default direction mapping. */
+type StatDeltaSentiment = 'positive' | 'negative' | 'neutral';
+/** Size variant controlling the value's font size. */
+type StatSize = 'sm' | 'md' | 'lg';
+/** Change indicator rendered next to the value: a direction glyph plus colored text. */
+interface StatDelta {
+  /** Pre-formatted change text, e.g. `"+12.4%"` or `"-8 ms"`. */
+  value: string;
+  /** Trend direction. Picks the glyph and the default sentiment. */
+  direction: StatDeltaDirection;
+  /** Overrides the direction-to-color mapping, for metrics where down is good. */
+  sentiment?: StatDeltaSentiment;
+}
+interface StatProps {
+  /** Metric name shown above the value, e.g. "Total requests". */
+  label: string;
+  /**
+   * 预先格式化好的核心数值，如 `"1.2M"`。
+   * 要放富内容（带单位的小字、图标）时改用默认插槽，插槽优先。
+   */
+  value?: string;
+  /** Change indicator rendered next to the value. */
+  delta?: StatDelta;
+  /** Muted supporting line under the value, e.g. "vs. previous 30 days". */
+  description?: string;
+  /**
+   * Size variant controlling the value's font size.
+   * @default 'md'
+   */
+  size?: StatSize;
+}
+//#endregion
+//#region src/Stat/Stat.vue.d.ts
+declare var __VLS_1: {}, __VLS_3: {};
+type __VLS_Slots = {} & {
+  default?: (props: typeof __VLS_1) => any;
+} & {
+  media?: (props: typeof __VLS_3) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<StatProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<StatProps> & Readonly<{}>, {
+  value: string;
+  delta: StatDelta;
+  description: string;
+  size: StatSize;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export$3: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default$6: typeof __VLS_export$3;
+type __VLS_WithSlots<T, S> = T & {
+  new (): {
+    $slots: S;
+  };
+};
+//#endregion
+//#region src/SVGIcon/types.d.ts
+type SVGIconVariation = 'linear' | 'bold' | 'twotone' | 'bulk' | 'broken';
+type SVGIconSize = 'xsm' | 'sm' | 'md' | 'lg';
+type SVGIconColor = 'primary' | 'secondary' | 'disabled' | 'accent' | 'positive' | 'negative' | 'warning' | 'inherit';
+/**
+ * 一个图形元素在不同变体下的表现：
+ * - `fill`：闭合形状。linear 里描边，bold 里填充。
+ * - `stroke`：线条和细节。所有变体下都保持描边。
+ */
+type IconShapeRole = 'fill' | 'stroke';
+/** 图标一层里的一个图形元素。 */
+interface IconShape {
+  /** SVG 元素类型。 */
+  type: 'path' | 'circle' | 'rect' | 'line' | 'polyline' | 'polygon';
+  /** 这个元素的 SVG 属性（d、cx、cy、r、points、x1、y1 等）。 */
+  attrs: Record<string, string>;
+  /**
+   * 这个元素在不同变体下的表现。
+   * @default 'fill'
+   */
+  role?: IconShapeRole;
+}
+/** 一个图标图形的定义。 */
+interface SVGIconDef {
+  /** 显示名。 */
+  name: string;
+  /** 视口尺寸。 @default '0 0 24 24' */
+  viewBox?: string;
+  /** 主层图形（主体轮廓）。 */
+  primary: IconShape[];
+  /** 次层图形（细节）。 */
+  secondary?: IconShape[];
+}
+interface SVGIconProps {
+  /** 图标定义，带路径数据。 */
+  icon: SVGIconDef;
+  /**
+   * 变体预设。
+   * @default 'linear'
+   */
+  variation?: SVGIconVariation;
+  /**
+   * 尺寸，带光学描边补偿：越小描边越粗。
+   * @default 'md'
+   */
+  size?: SVGIconSize;
+  /**
+   * 语义颜色。
+   * @default 'primary'
+   */
+  color?: SVGIconColor;
+  /** 直接指定描边宽度，绕过光学补偿。 */
+  strokeWidth?: number;
+}
+//#endregion
+//#region src/SVGIcon/icons.d.ts
+/** Simple stroke-only: X / Close — both lines are stroke-role */
+export declare const xIcon: SVGIconDef;
+/** Simple stroke-only: Check */
+export declare const checkIcon: SVGIconDef;
+/** Two-layer with mixed roles: Bell body is fill, clapper is stroke */
+export declare const bellIcon: SVGIconDef;
+/**
+ * Two-layer: Home — house outline is fill, door is fill (secondary).
+ * In bold mode the door gets masked out of the house body.
+ */
+export declare const homeIcon: SVGIconDef;
+/** Complex: Settings — gear body is fill, center circle is fill (secondary, masked in bold) */
+export declare const settingsIcon: SVGIconDef;
+/** Mixed roles: Calendar frame is fill, pegs are stroke, divider line is stroke */
+export declare const calendarIcon: SVGIconDef;
+/** Stroke-only: Menu / Hamburger — all lines are stroke-role */
+export declare const menuIcon: SVGIconDef;
+/** Single curved path: Heart */
+export declare const heartIcon: SVGIconDef;
+/** Nested shapes: Eye — outer shape (fill) + pupil (fill, secondary) */
+export declare const eyeIcon: SVGIconDef;
+/** Complex single path: Star */
+export declare const starIcon: SVGIconDef;
+/** Single panel: Folder */
+export declare const folderIcon: SVGIconDef;
+/** Single path: Shield */
+export declare const shieldIcon: SVGIconDef;
+/** Mixed: Search — glass (fill) + handle (stroke, secondary) */
+export declare const searchIcon: SVGIconDef;
+/** Mixed: Mail — body (fill) + flap line (stroke, secondary) */
+export declare const mailIcon: SVGIconDef;
+/** Mixed: Lock — body (fill) + shackle (stroke) */
+export declare const lockIcon: SVGIconDef;
+/** All starter icons for convenience */
+export declare const starterIcons: SVGIconDef[];
+//#endregion
+//#region src/SVGIcon/pathTransforms/transforms.d.ts
+/**
+ * @file pathTransforms/transforms.ts
+ * @description 按百分比调整路径的三个人格轴：圆角、曲率、张力。
+ *
+ * 变形保留原图的主次关系——尖角比圆角动得多，直线比已有曲线动得多。
+ */
+/**
+ * Round corners at L→L junctions by inserting quadratic bezier curves.
+ *
+ * @param d - SVG path d-string
+ * @param cornerRounding - 0-1 percentile. 0 = sharp (no change). 1 = max rounding.
+ * @returns Modified d-string with rounded corners
+ */
+export declare function roundCorners(d: string, cornerRounding: number): string;
+/**
+ * Bow straight line segments by replacing L with Q.
+ *
+ * @param d - SVG path d-string
+ * @param curvature - 0-1 percentile. 0 = straight. 1 = max bow.
+ * @returns Modified d-string with curved segments
+ */
+export declare function addCurvature(d: string, curvature: number): string;
+/**
+ * Adjust tension on existing bezier curves.
+ *
+ * @param d - SVG path d-string
+ * @param tension - 0-1. 0 = loose (curves balloon). 0.5 = unchanged. 1 = tight.
+ * @returns Modified d-string
+ */
+export declare function adjustTension(d: string, tension: number): string;
+interface PathPersonality {
+  cornerRounding?: number;
+  segmentCurvature?: number;
+  tension?: number;
+}
+/**
+ * Apply all personality transforms to a path d-string.
+ * Order: corner rounding → segment curvature → tension.
+ */
+export declare function applyPersonality(d: string, personality: PathPersonality): string;
+//#endregion
+//#region src/SVGIcon/SVGIcon.vue.d.ts
+declare const __VLS_export$2: import("vue").DefineComponent<SVGIconProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<SVGIconProps> & Readonly<{}>, {
+  size: SVGIconSize;
+  strokeWidth: number;
+  variation: SVGIconVariation;
+  color: SVGIconColor;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default$5: typeof __VLS_export$2;
+//#endregion
+//#region src/SVGIcon/types-xif.d.ts
+/**
+ * @file xif-types.ts
+ * @description Astryx Icon Format (XIF) type definitions — v0.1.0 draft
+ *
+ * Icons are pure structure — zero visual values. The theme resolves
+ * all visual properties (color, weight, rounding, timing).
+ *
+ * This file defines the SOURCE format types. The resolved/build output
+ * uses a simpler pre-computed format (see theme build pipeline).
+ */
+/**
+ * Percentile adjustment parameters for shape personality.
+ * All values 0-1. 0 = artist's original. 1 = maximum shift.
+ * Adjustments are RELATIVE — they preserve the artist's hierarchy
+ * of sharp vs soft, straight vs curved.
+ */
+interface XIFPersonality {
+  /**
+   * Shift corners toward rounded.
+   * A sharp 90° corner shifts more than an already-gentle 150° corner.
+   * Formula: adjustedR = baseR + (maxR - baseR) × cornerRounding
+   */
+  cornerRounding?: number;
+  /**
+   * Shift straight segments toward curved.
+   * A straight line gains a bow; an existing curve barely changes.
+   * Formula: adjusted = original + (1 - original) × segmentCurvature
+   */
+  segmentCurvature?: number;
+  /**
+   * How tightly curves hug their control points.
+   * 0 = loose (curves balloon). 0.5 = neutral. 1 = tight (near-straight).
+   */
+  tension?: number;
+}
+/**
+ * Animation intent for a path element.
+ * Declares WHAT animates and in WHAT ORDER — not timing or easing.
+ * The theme resolves all visual animation properties.
+ */
+interface XIFAnimate {
+  /**
+   * Semantic animation type.
+   * - draw: stroke reveals along path (dasharray/dashoffset)
+   * - fade: opacity entrance
+   * - scale: grow from center
+   * - rotate: continuous spin (loaders)
+   * - morph: interpolate between variation states
+   */
+  type: 'draw' | 'fade' | 'scale' | 'rotate' | 'morph';
+  /**
+   * Stagger order. Lower numbers animate first.
+   * Paths with the same sequence animate simultaneously.
+   */
+  sequence?: number;
+}
+/**
+ * A named position where a sub-icon can be injected.
+ * The theme resolves position/size to actual viewBox coordinates.
+ */
+interface XIFSlot {
+  /** Slot identifier — used in component props */
+  name: string;
+  /** Semantic position. Theme resolves to coordinates. */
+  position: 'center' | 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right' | {
+    x: number;
+    y: number;
+  };
+  /**
+   * Size of the injected icon relative to parent.
+   * 'content' = auto-sized by theme. number = fraction of parent.
+   */
+  size?: 'content' | number;
+}
+/**
+ * A single shape element within an icon.
+ * Contains geometry + semantic metadata. Zero visual values.
+ */
+interface XIFPath {
+  /** SVG element type. Default: 'path' */
+  type?: 'path' | 'circle' | 'rect' | 'line' | 'polyline' | 'ellipse' | 'polygon';
+  /** SVG geometry attributes (d, cx, cy, r, x, y, width, height, etc.) */
+  attrs: Record<string, string | number>;
+  /**
+   * Rendering behavior across variations.
+   * - 'fill': Closed shape — stroked in linear, filled in bold.
+   * - 'stroke': Line/detail — always rendered as a stroke.
+   * Default: 'fill'
+   */
+  role?: 'fill' | 'stroke';
+  /**
+   * Visual hierarchy for twotone/bulk and bold knockouts.
+   * - 'primary': Full opacity. In bold, rendered as solid fill.
+   * - 'secondary': Reduced opacity in twotone/bulk. Knocked out in bold.
+   * Default: 'primary'
+   */
+  layer?: 'primary' | 'secondary';
+  /** Per-path personality overrides (shift from theme/icon defaults) */
+  personality?: XIFPersonality;
+  /** Animation intent */
+  animate?: XIFAnimate;
+}
+/**
+ * Root type for an Astryx Icon Format definition.
+ * Pure structure — no visual values.
+ */
+interface XIFIcon {
+  /** Unique identifier */
+  name: string;
+  /** ViewBox dimensions. Default: '0 0 24 24' */
+  viewBox?: string;
+  /** Shape elements that compose the icon */
+  paths: XIFPath[];
+  /**
+   * Per-variation geometry overrides.
+   * Rendered in DOM alongside default paths; CSS toggles visibility.
+   */
+  overrides?: {
+    bold?: XIFPath[];
+    broken?: XIFPath[];
+  };
+  /** Named slots for sub-icon composition */
+  slots?: XIFSlot[];
+  /** Icon-level personality overrides */
+  personality?: XIFPersonality;
+  /** Tags for search and categorization */
+  tags?: string[];
+}
+//#endregion
+//#region src/SVGIcon/xif-examples.d.ts
+export declare const xifCheck: XIFIcon;
+export declare const xifHome: XIFIcon;
+export declare const xifFile: XIFIcon;
+export declare const xifShield: XIFIcon;
+export declare const xifBell: XIFIcon;
+export declare const xifStar: XIFIcon;
+export declare const xifBellOverride: XIFIcon;
+export declare const xifExamples: XIFIcon[];
+//#endregion
+//#region src/TransferList/types.d.ts
+/** 一个可搬运的选项。`value` 唯一，`label` 是可见文字，也是操作名的来源。 */
+interface TransferListOption<T extends string = string> {
+  value: T;
+  label: string;
+  /** 搜索时会一起匹配的补充说明。默认行里不显示。 */
+  description?: VNodeChild;
+  /** 可选面板里的分组标题。 */
+  group?: string;
+  /** 不能在两栏之间搬动。 */
+  isTransferDisabled?: boolean;
+  /** 不能在已选栏里调整顺序，位置固定。 */
+  isReorderDisabled?: boolean;
+  /** 说明为什么搬不动或调不了顺序。 */
+  disabledMessage?: string;
+}
+interface TransferListProps<T extends string = string> {
+  /** 整个控件的无障碍名。 */
+  label: string;
+  /** 视觉上隐藏标签，读屏仍然读得到。 */
+  isLabelHidden?: boolean;
+  /** 标签下方的说明。 */
+  description?: string;
+  /** 完整的选项表，`value` 不能重复。 */
+  options: readonly TransferListOption<T>[];
+  /** 已选项的顺序，同时是唯一的真相来源。 */
+  modelValue?: readonly T[];
+  /** 已选面板的标题。默认取文案表。 */
+  selectedLabel?: string;
+  /** 可选面板的标题。默认取文案表。 */
+  availableLabel?: string;
+  /** 一个搜索框同时过滤两栏。 */
+  hasSearch?: boolean;
+  /** 搜索框的无障碍名。默认是 `Search {label}`。 */
+  searchLabel?: string;
+  searchPlaceholder?: string;
+  /** 已选项可以拖动或按键调整顺序。 */
+  isReorderable?: boolean;
+  /** 显示「全部添加」。 */
+  hasSelectAll?: boolean;
+  /** 显示「清空」。搬不动的已选项会留下。 */
+  hasClear?: boolean;
+  selectedEmptyText?: string;
+  availableEmptyText?: string;
+  noResultsText?: string;
+}
+interface TransferListEmits<T extends string = string> {
+  'update:modelValue': [value: readonly T[]];
+  'change': [value: readonly T[]];
+}
+interface TransferListSlots<T extends string = string> {
+  /** 自定义一行里的内容。 */
+  option?: (props: {
+    option: TransferListOption<T>;
+  }) => VNodeChild;
+}
+/** 面板里的一行：选项本身，加上它在这一栏里的位置。 */
+interface PanelRow<T extends string = string> {
+  option: TransferListOption<T>;
+  index: number;
+}
+/** 可选栏按 `group` 分出来的一段。 */
+interface PanelGroup<T extends string = string> {
+  group: string;
+  options: PanelRow<T>[];
+}
+//#endregion
+//#region src/TransferList/TransferList.vue.d.ts
+declare const __VLS_export$1: <T extends string>(__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<TransferListProps<T> & {
+    "onUpdate:modelValue"?: ((value: readonly T[]) => any) | undefined;
+    onChange?: ((value: readonly T[]) => any) | undefined;
+  }> & (typeof globalThis extends {
+    __VLS_PROPS_FALLBACK: infer P;
+  } ? P : {});
+  expose: (exposed: {}) => void;
+  attrs: any;
+  slots: TransferListSlots<T>;
+  emit: ((evt: "update:modelValue", value: readonly T[]) => void) & ((evt: "change", value: readonly T[]) => void);
+}>) => import("vue").VNode & {
+  __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
+};
+declare const _default$7: typeof __VLS_export$1;
+type __VLS_PrettifyLocal$1<T> = (T extends any ? { [K in keyof T]: T[K]; } : { [K in keyof T as K]: T[K]; }) & {};
+//#endregion
+//#region src/TransferList/TransferListSelector.vue.d.ts
+declare const __VLS_export: <T extends string>(__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<{
+    label: string;
+    modelValue?: readonly T[];
+    options: readonly TransferListOption<T>[];
+    description?: string;
+    isLabelHidden?: boolean;
+    isOptional?: boolean;
+    isRequired?: boolean;
+    isDisabled?: boolean;
+    isLoading?: boolean;
+    labelTooltip?: string;
+    status?: FieldStatusInput;
+    statusVariant?: "attached" | "detached" | "tooltip";
+    size?: "sm" | "md" | "lg";
+    width?: number | string;
+    placement?: PopoverPlacement;
+    triggerLabel?: string;
+    selectedLabel?: string;
+    availableLabel?: string;
+    hasSearch?: boolean;
+    searchLabel?: string;
+    searchPlaceholder?: string;
+    isReorderable?: boolean;
+    hasSelectAll?: boolean;
+    hasClear?: boolean;
+    selectedEmptyText?: string;
+    availableEmptyText?: string;
+    noResultsText?: string;
+    /** `immediate` 每次改动立刻生效，`staged` 等用户按 Apply。 */
+    commitBehavior?: "immediate" | "staged";
+    applyLabel?: string;
+    cancelLabel?: string;
+  } & {
+    "onUpdate:modelValue"?: ((value: readonly T[]) => any) | undefined;
+    onChange?: ((value: readonly T[]) => any) | undefined;
+    onOpenChange?: ((isOpen: boolean) => any) | undefined;
+    onChangeAction?: ((value: readonly T[]) => any) | undefined;
+  }> & (typeof globalThis extends {
+    __VLS_PROPS_FALLBACK: infer P;
+  } ? P : {});
+  expose: (exposed: {}) => void;
+  attrs: any;
+  slots: {
+    option?: (props: {
+      option: TransferListOption<T>;
+    }) => any;
+  };
+  emit: ((evt: "update:modelValue", value: readonly T[]) => void) & ((evt: "change", value: readonly T[]) => void) & ((evt: "openChange", isOpen: boolean) => void) & ((evt: "changeAction", value: readonly T[]) => void);
+}>) => import("vue").VNode & {
+  __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
+};
+declare const _default$8: typeof __VLS_export;
+type __VLS_PrettifyLocal<T> = (T extends any ? { [K in keyof T]: T[K]; } : { [K in keyof T as K]: T[K]; }) & {};
+//#endregion
+export { _default as CircularProgress, type CircularProgressProps, type CircularProgressSize, type CircularProgressVariant, type CircularProgressVariantMap, type IconShape, type IconShapeRole, _default$1 as InfoTip, type InfoTipProps, type InfoTipSize, _default$2 as ListInput, type ListInputChange, type ListInputColumn, type ListInputColumnWidth, type ListInputEmits, type ListInputProps, type ListInputRenderContext, type ListInputValueContext, type LogEntry, _default$3 as LogStream, type LogStreamEmits, type LogStreamLevel, type LogStreamProps, _default$4 as MobileTokenizer, type MobileTokenizerChange, type MobileTokenizerEmits, type MobileTokenizerProps, type PanelGroup, type PanelRow, type PathPersonality, _default$5 as SVGIcon, type SVGIconColor, type SVGIconDef, type SVGIconProps, type SVGIconSize, type SVGIconVariation, type SearchSource, type SearchableItem, _default$6 as Stat, type StatDelta, type StatDeltaDirection, type StatDeltaSentiment, type StatProps, type StatSize, _default$7 as TransferList, type TransferListEmits, type TransferListOption, type TransferListProps, _default$8 as TransferListSelector, type TransferListSlots, type XIFAnimate, type XIFIcon, type XIFPath, type XIFPersonality, type XIFSlot };