@astryx-vue/core 0.1.3 → 0.2.1

package/dist/{index-mQ6EPmaG.d.ts → index-DsyKhauk.d.ts}

@@ -1,5 +1,6 @@
+import { a as SyntaxTokenKey, i as SyntaxThemeTokens, n as SyntaxThemeDefinition } from "./syntaxTheme-Bcs1YMF7.js";
 import "./useClipboard-CU-kfqeJ.js";
-import { VNodeChild } from "vue";
+import { ComputedRef, VNodeChild } from "vue";
 //#region src/Code/types.d.ts
 /**
  * The text color of inline code.
@@ -71,6 +72,13 @@ interface CodeBlockProps {
    * @default 'plaintext'
    */
   language?: string;
+  /**
+   * Syntax colors for this block.
+   *
+   * Shorthand for wrapping the block in `SyntaxTheme`. A surrounding
+   * `SyntaxTheme` still themes every code component in that region.
+   */
+  syntaxTheme?: SyntaxThemeDefinition;
   /** A filename or label shown in the header bar next to the language. */
   title?: string;
   /**
@@ -168,22 +176,22 @@ interface CodeBlockEmits {
 }
 //#endregion
 //#region src/Code/Code.vue.d.ts
-type __VLS_Slots = CodeSlots;
-declare const __VLS_base: import("vue").DefineComponent<CodeProps, {
+type __VLS_Slots$1 = CodeSlots;
+declare const __VLS_base$1: import("vue").DefineComponent<CodeProps, {
   element: import("vue").ComputedRef<HTMLElement | null>;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<CodeProps> & Readonly<{}>, {
   color: CodeColor;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
-declare const __VLS_export$1: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
-declare const _default$1: typeof __VLS_export$1;
-type __VLS_WithSlots<T, S> = T & {
+declare const __VLS_export$2: __VLS_WithSlots$1<typeof __VLS_base$1, __VLS_Slots$1>;
+declare const _default$2: typeof __VLS_export$2;
+type __VLS_WithSlots$1<T, S> = T & {
   new (): {
     $slots: S;
   };
 };
 //#endregion
 //#region src/Code/CodeBlock.vue.d.ts
-declare const __VLS_export: import("vue").DefineComponent<CodeBlockProps, {
+declare const __VLS_export$1: import("vue").DefineComponent<CodeBlockProps, {
   element: import("vue").ComputedRef<HTMLPreElement | null>;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
   copy: () => any;
@@ -205,7 +213,7 @@ declare const __VLS_export: import("vue").DefineComponent<CodeBlockProps, {
   copiedLabel: string;
   codeLabel: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
-declare const _default: typeof __VLS_export;
+declare const _default$1: typeof __VLS_export$1;
 //#endregion
 //#region src/Code/highlightRanges.d.ts
 /** Token types painted by the stylesheet, so they never need a generated rule. */
@@ -217,6 +225,50 @@ declare const HIGHLIGHTED_TOKEN_TYPES: readonly ["keyword", "string", "comment",
  */
 declare function applyHighlightRanges(codeElement: HTMLElement, tokenLines: TokenLine[]): () => void;
 //#endregion
+//#region src/Code/syntaxPresets.d.ts
+/** One Dark Pro (Binaryify), MIT. */
+declare const oneDarkPro: SyntaxThemeDefinition;
+/** Dracula (Zeno Rocha), MIT. */
+declare const dracula: SyntaxThemeDefinition;
+/** Monokai (Wimer Hazenberg), MIT. */
+declare const monokai: SyntaxThemeDefinition;
+/** Nord (Sven Greb), MIT. */
+declare const nord: SyntaxThemeDefinition;
+/** Tokyo Night (enkia), MIT. */
+declare const tokyoNight: SyntaxThemeDefinition;
+/** Catppuccin Mocha, MIT. */
+declare const catppuccinMocha: SyntaxThemeDefinition;
+/** GitHub Light (GitHub Primer team), MIT. */
+declare const githubLight: SyntaxThemeDefinition;
+/** Solarized Light (Ethan Schoonover), MIT. */
+declare const solarizedLight: SyntaxThemeDefinition;
+/** One Light (GitHub / Atom), MIT. */
+declare const oneLight: SyntaxThemeDefinition;
+/** Catppuccin Latte, MIT. */
+declare const catppuccinLatte: SyntaxThemeDefinition;
+/** Tokyo Night Light (enkia), MIT. */
+declare const tokyoNightLight: SyntaxThemeDefinition;
+declare const darkSyntaxPresets: readonly [SyntaxThemeDefinition, SyntaxThemeDefinition, SyntaxThemeDefinition, SyntaxThemeDefinition, SyntaxThemeDefinition, SyntaxThemeDefinition, SyntaxThemeDefinition];
+declare const lightSyntaxPresets: readonly [SyntaxThemeDefinition, SyntaxThemeDefinition, SyntaxThemeDefinition, SyntaxThemeDefinition, SyntaxThemeDefinition];
+declare const allSyntaxPresets: readonly [SyntaxThemeDefinition, SyntaxThemeDefinition, SyntaxThemeDefinition, SyntaxThemeDefinition, SyntaxThemeDefinition, SyntaxThemeDefinition, SyntaxThemeDefinition, SyntaxThemeDefinition, SyntaxThemeDefinition, SyntaxThemeDefinition, SyntaxThemeDefinition, SyntaxThemeDefinition];
+//#endregion
+//#region src/Code/SyntaxTheme.vue.d.ts
+type __VLS_Props = {
+  theme: SyntaxThemeDefinition;
+};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+  default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & 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
 //#region src/Code/tokenizer.d.ts
 /** Code shorter than this is tokenized synchronously instead of in chunks. */
 declare const SYNC_TOKENIZE_THRESHOLD = 2000;
@@ -237,4 +289,21 @@ declare function tokenizeAsync(code: string, language: string, signal?: AbortSig
  */
 declare function flatTokensToLines(tokens: SyntaxToken[], code: string): TokenLine[];
 //#endregion
-export { CodeSize as _, HIGHLIGHTED_TOKEN_TYPES as a, TokenLine as b, _default$1 as c, CodeBlockProps as d, CodeBlockSize as f, CodeProps as g, CodeHighlightMode as h, tokenizeAsync as i, CodeBlockContainer as l, CodeColor as m, flatTokensToLines as n, applyHighlightRanges as o, CodeBlockTokenizer as p, tokenize as r, _default as s, SYNC_TOKENIZE_THRESHOLD as t, CodeBlockEmits as u, CodeSlots as v, SyntaxToken as y };
+//#region src/Code/useSyntaxTheme.d.ts
+interface UseSyntaxThemeReturn {
+  /** Syntax theme name. Empty when the provider has no theme. */
+  name: ComputedRef<string>;
+  /** Mode used to pick a `light-dark()` stop. */
+  mode: ComputedRef<'light' | 'dark'>;
+  /** One syntax token for the effective mode. */
+  token: (name: SyntaxTokenKey) => string;
+  /** Every syntax token for the effective mode, or null when no theme applies. */
+  tokens: ComputedRef<SyntaxThemeTokens | null>;
+}
+/**
+ * Read the nearest SyntaxTheme, or the syntax field of the nearest Theme.
+ * Returns null when neither is present.
+ */
+declare function useSyntaxTheme(): UseSyntaxThemeReturn | null;
+//#endregion
+export { CodeBlockTokenizer as A, applyHighlightRanges as C, CodeBlockEmits as D, CodeBlockContainer as E, CodeSlots as F, SyntaxToken as I, TokenLine as L, CodeHighlightMode as M, CodeProps as N, CodeBlockProps as O, CodeSize as P, HIGHLIGHTED_TOKEN_TYPES as S, _default$2 as T, oneDarkPro as _, tokenize as a, tokyoNight as b, allSyntaxPresets as c, darkSyntaxPresets as d, dracula as f, nord as g, monokai as h, flatTokensToLines as i, CodeColor as j, CodeBlockSize as k, catppuccinLatte as l, lightSyntaxPresets as m, useSyntaxTheme as n, tokenizeAsync as o, githubLight as p, SYNC_TOKENIZE_THRESHOLD as r, _default as s, UseSyntaxThemeReturn as t, catppuccinMocha as u, oneLight as v, _default$1 as w, tokyoNightLight as x, solarizedLight as y };

package/dist/{index-C6RecznD.d.ts → index-I4J7gwa1.d.ts}

@@ -1,29 +1,61 @@
+import { o as FieldStatusInput } from "./types-3eXh_5os.js";
 //#region src/Selector/types.d.ts
 interface SelectorOption {
   value: string | number;
   label: string;
   disabled?: boolean;
   description?: string;
+  /** CSS icon class or a component, drawn before the label. */
+  icon?: string;
 }
+/** 字符串会当成 value 和 label 相同的选项，演练场模板一直这样传。 */
+type SelectorOptionInput = SelectorOption | string;
+/** A titled group of options. */
+interface SelectorSection {
+  type: 'section';
+  title?: string;
+  options: readonly SelectorOption[];
+}
+type SelectorEntry = SelectorOptionInput | SelectorSection;
 type SelectorSize = 'sm' | 'md' | 'lg';
 type SelectorStatus = 'default' | 'success' | 'warning' | 'error';
+/** 字符串状态，或演练场里那种 `{ type, message }`。 */
+type SelectorStatusInput = SelectorStatus | FieldStatusInput;
+type SelectorPresentation = 'popover' | 'bottom-sheet';
+type SelectorVariant = 'default' | 'ghost';
+type SelectorStatusVariant = 'attached' | 'detached' | 'tooltip';
 interface SelectorProps {
   /** 选中的值 */
   modelValue?: string | number | null;
-  /** 选项列表 */
-  options: readonly SelectorOption[];
+  /** 选项列表，可以按 section 分组 */
+  options: readonly SelectorEntry[];
   /** 占位文本 */
   placeholder?: string;
   /** 是否禁用 */
   disabled?: boolean;
   /** 禁用原因（鼠标悬停时显示） */
   disabledReason?: string;
-  /** 状态 */
-  status?: SelectorStatus;
+  /** 状态。可以是 `'error'`，也可以是 `{ type, message }`。 */
+  status?: SelectorStatusInput;
   /** 状态消息 */
   statusMessage?: string;
+  /**
+   * 状态文案的呈现。tooltip 只留给读屏，不在控件下再画一行。
+   * @default 'attached'
+   */
+  statusVariant?: SelectorStatusVariant;
   /** 尺寸 */
   size?: SelectorSize;
+  /**
+   * default 是带边框的输入框，ghost 去掉边框，适合放进工具栏。
+   * @default 'default'
+   */
+  variant?: SelectorVariant;
+  /**
+   * popover 锚在触发器下，bottom-sheet 在底部弹层里展开。
+   * @default 'popover'
+   */
+  presentation?: SelectorPresentation;
   /** 是否可搜索 */
   searchable?: boolean;
   /** 搜索占位文本 */
@@ -34,8 +66,14 @@ interface SelectorProps {
   clearLabel?: string;
   /** 空状态文本 */
   emptyText?: string;
-  /** 标签（用于无障碍） */
+  /** 可见标签。不传时用占位文本作为隐藏的无障碍名称。 */
   label?: string;
+  /** 隐藏可见标签，仍保留给读屏。 */
+  isLabelHidden?: boolean;
+  /** 标签下方的说明 */
+  description?: string;
+  /** 控件宽度。数字按像素，字符串原样使用。 */
+  width?: number | string;
   /** 名称（用于表单提交） */
   name?: string;
 }
@@ -62,19 +100,23 @@ interface SelectorSlots {
 //#region src/Selector/Selector.vue.d.ts
 type __VLS_Slots = SelectorSlots;
 declare const __VLS_base: import("vue").DefineComponent<SelectorProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-  change: (value: string | number | null) => any;
   search: (query: string) => any;
+  change: (value: string | number | null) => any;
   "update:modelValue": (value: string | number | null) => any;
 }, string, import("vue").PublicProps, Readonly<SelectorProps> & Readonly<{
-  onChange?: ((value: string | number | null) => any) | undefined;
   onSearch?: ((query: string) => any) | undefined;
+  onChange?: ((value: string | number | null) => any) | undefined;
   "onUpdate:modelValue"?: ((value: string | number | null) => any) | undefined;
 }>, {
+  status: SelectorStatusInput;
   size: SelectorSize;
-  status: SelectorStatus;
+  variant: SelectorVariant;
   modelValue: string | number | null;
+  isLabelHidden: boolean;
+  statusVariant: SelectorStatusVariant;
   disabled: boolean;
   clearable: boolean;
+  presentation: SelectorPresentation;
   searchable: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
@@ -85,4 +127,4 @@ type __VLS_WithSlots<T, S> = T & {
   };
 };
 //#endregion
-export { SelectorSize as a, SelectorProps as i, SelectorEmits as n, SelectorSlots as o, SelectorOption as r, SelectorStatus as s, _default as t };
+export { SelectorOptionInput as a, SelectorSection as c, SelectorStatus as d, SelectorStatusInput as f, SelectorOption as i, SelectorSize as l, SelectorVariant as m, SelectorEmits as n, SelectorPresentation as o, SelectorStatusVariant as p, SelectorEntry as r, SelectorProps as s, _default as t, SelectorSlots as u };

package/dist/{index-utZGF4GR.d.ts → index-NOXYEdOI.d.ts}

@@ -51,8 +51,8 @@ declare const __VLS_export$1: import("vue").DefineComponent<{
   orientation?: MetadataListOrientation | undefined;
   title?: string | undefined;
 }> & Readonly<{}>, {
-  label: Record<string, any>;
   orientation: string;
+  label: Record<string, any>;
   title: string;
   columns: string | number;
   maxNumOfItems: number;

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

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

package/dist/{index-CVn0GBdB.d.ts → index-cG1E0U2s.d.ts}

@@ -84,9 +84,9 @@ interface StepSlots {
 //#region src/Stepper/Step.vue.d.ts
 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<{}>, {
+  indicator: StepIndicator;
   isDisabled: boolean;
   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-DEeJowZf.d.ts → index-cGagYM1g.d.ts}

@@ -1,24 +1,37 @@
 //#region src/ProgressBar/types.d.ts
 type ProgressBarSize = 'sm' | 'md' | 'lg';
-type ProgressBarVariant = 'neutral' | 'success' | 'warning' | 'error' | 'info';
+type ProgressBarVariant = 'accent' | 'neutral' | 'success' | 'warning' | 'error' | 'info';
 interface ProgressBarProps {
-  value: number;
+  value?: number;
   min?: number;
   max?: number;
   size?: ProgressBarSize;
   variant?: ProgressBarVariant;
   label?: string;
+  /**
+   * Keep `label` available to assistive technology without painting it.
+   * @default false
+   */
+  isLabelHidden?: boolean;
   description?: string;
   isIndeterminate?: boolean;
+  /** 在标签旁显示当前进度。`hasValueLabel` 是同一开关。 */
   showValue?: boolean;
+  /** 与 `showValue` 相同，对齐原版属性名。 */
+  hasValueLabel?: boolean;
+  /** 自定义数值文案。优先于百分比和 `formatValueLabel`。 */
   valueText?: string;
+  /** 用当前值和最大值生成数值文案，例如 `3.2 GB / 5 GB`。 */
+  formatValueLabel?: (value: number, max: number) => string;
   width?: number | string;
 }
 //#endregion
 //#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<{}>, {
   size: ProgressBarSize;
+  value: number;
   variant: ProgressBarVariant;
+  isLabelHidden: boolean;
   min: number;
   max: number;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;

package/dist/{index-Ck8qy6Rf.d.ts → index-c_TaW8mM.d.ts}

@@ -1,11 +1,31 @@
 //#region src/Pagination/types.d.ts
+/** 上一页和下一页之间显示什么。 */
+type PaginationVariant = 'pages' | 'count' | 'compact' | 'dots' | 'none';
+/** 控件尺寸。 */
+type PaginationSize = 'sm' | 'md';
 interface PaginationProps {
   /** 当前页码（1-based） */
   page?: number;
   /** 每页条目数 */
   pageSize?: number;
-  /** 总条目数 */
+  /** 总条目数。和 `totalPages` 同时存在时以总条目数为准。 */
   total?: number;
+  /**
+   * 总页数。没有总条目数时使用，例如圆点轮播。
+   */
+  totalPages?: number;
+  /**
+   * 中间区域的形态。
+   * `pages` 是页码，`count` 是「起–止 / 总数」，`compact` 是「第几页 / 共几页」，
+   * `dots` 是圆点，`none` 只留上一页和下一页。
+   * @default 'pages'
+   */
+  variant?: PaginationVariant;
+  /**
+   * 控件高度。
+   * @default 'md'
+   */
+  size?: PaginationSize;
   /** 是否显示页面大小选择器 */
   showSizeChanger?: boolean;
   /** 页面大小选项 */
@@ -46,6 +66,8 @@ declare const __VLS_base: import("vue").DefineComponent<PaginationProps, {}, {},
   "onUpdate:page"?: ((value: number) => any) | undefined;
   "onUpdate:pageSize"?: ((value: number) => any) | undefined;
 }>, {
+  size: PaginationSize;
+  variant: PaginationVariant;
   disabled: boolean;
   page: number;
   pageSize: number;
@@ -62,4 +84,4 @@ type __VLS_WithSlots<T, S> = T & {
   };
 };
 //#endregion
-export { PaginationSlots as i, PaginationEmits as n, PaginationProps as r, _default as t };
+export { PaginationSlots as a, PaginationSize as i, PaginationEmits as n, PaginationVariant as o, PaginationProps as r, _default as t };

package/dist/{index-Bqb_Fyju.d.ts → index-jdjcb3Js.d.ts}

@@ -57,8 +57,8 @@ interface TypeaheadSlots<T extends SearchableItem = SearchableItem> {
 //#region src/Typeahead/Typeahead.vue.d.ts
 declare const __VLS_export: <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;
     "onUpdate:modelValue"?: ((value: T | null) => any) | undefined;
     onOpenChange?: ((isOpen: boolean) => any) | undefined;
   }> & (typeof globalThis extends {
@@ -70,7 +70,7 @@ declare const __VLS_export: <T extends SearchableItem>(__VLS_props: NonNullable<
   }>) => void;
   attrs: any;
   slots: TypeaheadSlots<T>;
-  emit: ((evt: "change", value: T | null) => void) & ((evt: "search", query: string) => void) & ((evt: "update:modelValue", value: T | null) => void) & ((evt: "openChange", isOpen: boolean) => void);
+  emit: ((evt: "search", query: string) => void) & ((evt: "change", value: T | null) => void) & ((evt: "update:modelValue", value: T | null) => void) & ((evt: "openChange", isOpen: boolean) => void);
 }>) => import("vue").VNode & {
   __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
 };