@astryx-vue/core 0.2.2 → 0.2.4

package/dist/{index-DGXviOlp.d.ts → index-D-ezcKaY.d.ts}

@@ -24,6 +24,8 @@ type SelectorStatusInput = SelectorStatus | FieldStatusInput;
 type SelectorPresentation = 'popover' | 'bottom-sheet';
 type SelectorVariant = 'default' | 'ghost';
 type SelectorStatusVariant = 'attached' | 'detached' | 'tooltip';
+/** 选中标记画在选项行的哪一侧。没有选中时标记不占位。 */
+type SelectorIndicatorPosition = 'start' | 'end';
 interface SelectorProps {
   /** 选中的值 */
   modelValue?: string | number | null;
@@ -64,8 +66,10 @@ interface SelectorProps {
   clearable?: boolean;
   /** 清除按钮标签 */
   clearLabel?: string;
-  /** 空状态文本 */
+  /** 没有任何选项时的空状态。 */
   emptyText?: string;
+  /** 搜索没有命中时的文案。和没有任何选项不是同一句话。 */
+  emptySearchText?: string;
   /** 可见标签。不传时用占位文本作为隐藏的无障碍名称。 */
   label?: string;
   /** 隐藏可见标签，仍保留给读屏。 */
@@ -76,6 +80,23 @@ interface SelectorProps {
   width?: number | string;
   /** 名称（用于表单提交） */
   name?: string;
+  /**
+   * 只读。当前值还在，可以聚焦，也会随表单提交，但打不开列表，也没有清除和展开箭头。
+   * 不会变暗。和 disabled 同时设置时按禁用处理。
+   */
+  isReadOnly?: boolean;
+  /** 触发器里显示加载指示，面板在加载完成前不声称「没有选项」。 */
+  isLoading?: boolean;
+  /** 在标签旁标成可选。 */
+  isOptional?: boolean;
+  /** 在标签旁标成必填，并设置 aria-required。 */
+  isRequired?: boolean;
+  /**
+   * 选中标记在选项行的起始侧或结束侧。
+   * 未选中时默认的勾不占位；主题把勾换成单选圆点后，未选中的行也会画出空心圆。
+   * @default 'end'
+   */
+  indicatorPosition?: SelectorIndicatorPosition;
 }
 interface SelectorEmits {
   'update:modelValue': [value: string | number | null];
@@ -100,22 +121,27 @@ 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, {
-  search: (query: string) => any;
   change: (value: string | number | null) => any;
+  search: (query: string) => any;
   "update:modelValue": (value: string | number | null) => any;
 }, string, import("vue").PublicProps, Readonly<SelectorProps> & Readonly<{
-  onSearch?: ((query: string) => any) | undefined;
   onChange?: ((value: string | number | null) => any) | undefined;
+  onSearch?: ((query: string) => any) | undefined;
   "onUpdate:modelValue"?: ((value: string | number | null) => any) | undefined;
 }>, {
   size: SelectorSize;
+  isLoading: boolean;
   variant: SelectorVariant;
   status: SelectorStatusInput;
+  isOptional: boolean;
+  indicatorPosition: SelectorIndicatorPosition;
   modelValue: string | number | null;
   isLabelHidden: boolean;
+  isRequired: boolean;
   statusVariant: SelectorStatusVariant;
   disabled: boolean;
   clearable: boolean;
+  isReadOnly: boolean;
   presentation: SelectorPresentation;
   searchable: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
@@ -127,4 +153,4 @@ type __VLS_WithSlots<T, S> = T & {
   };
 };
 //#endregion
-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 };
+export { SelectorOption as a, SelectorProps as c, SelectorSlots as d, SelectorStatus as f, SelectorVariant as h, SelectorIndicatorPosition as i, SelectorSection as l, SelectorStatusVariant as m, SelectorEmits as n, SelectorOptionInput as o, SelectorStatusInput as p, SelectorEntry as r, SelectorPresentation as s, _default as t, SelectorSize as u };

package/dist/{index-Cm_TiLXU.d.ts → index-Dgg0bHVM.d.ts}

@@ -1,15 +1,19 @@
-import { i as TextProps, n as TextColor, o as TextType, r as TextDisplay, t as TextAs } from "./types-Bt-lSgYX.js";
+import { a as TextProps, c as TextType, i as TextJustify, n as TextColor, r as TextDisplay, s as TextTruncateTooltip, t as TextAs } from "./types-D9nP_X-c.js";
 //#region src/Text/Text.vue.d.ts
-declare var __VLS_7: {};
+declare var __VLS_13: {}, __VLS_21: {};
 type __VLS_Slots = {} & {
-  default?: (props: typeof __VLS_7) => any;
+  default?: (props: typeof __VLS_13) => any;
+} & {
+  default?: (props: typeof __VLS_21) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<TextProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<TextProps> & Readonly<{}>, {
   type: TextType;
   as: TextAs;
   color: TextColor;
   display: TextDisplay;
+  justify: TextJustify;
   maxLines: number;
+  hasTruncateTooltip: TextTruncateTooltip;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;

package/dist/index-DxR1FChm.d.ts

@@ -0,0 +1,158 @@
+import { a as SearchableItem, i as SearchSource } from "./useAsyncSource-xpQovjV_.js";
+//#region src/Typeahead/types.d.ts
+type TypeaheadSize = 'sm' | 'md' | 'lg';
+type TypeaheadStatus = 'default' | 'success' | 'warning' | 'error';
+interface BaseTypeaheadProps<T extends SearchableItem = SearchableItem> {
+  /** 当前选中的条目。空表示还没选。 */
+  modelValue?: T | null;
+  /** 静态或异步搜索源。 */
+  searchSource: SearchSource<T>;
+  /**
+   * 输入框的无障碍名。外面已经有 `<label for>` 时不用传，避免读两遍。
+   */
+  label?: string;
+  /** 外面指定的输入框 id，好让标签的 `for` 对上。 */
+  inputId?: string;
+  /** 外面已经算好的说明和状态 id。 */
+  describedBy?: string;
+  placeholder?: string;
+  disabled?: boolean;
+  /** 禁用原因。有值时控件仍可聚焦，方便读到原因。 */
+  disabledReason?: string;
+  /** 输入框边框的校验色。说明文字由外面的字段负责。 */
+  status?: TypeaheadStatus;
+  size?: TypeaheadSize;
+  /** 显示清除按钮。 */
+  clearable?: boolean;
+  /** 输入停顿后再搜索，单位毫秒。本地数据可设为 0。 */
+  debounceMs?: number;
+  /** 下拉最多显示多少条。 */
+  maxMenuItems?: number;
+  /** 聚焦时还没输入就展示结果。 */
+  showOnFocus?: boolean;
+  emptyText?: string;
+  required?: boolean;
+  /** 表单字段名。选中后提交条目的 id。 */
+  name?: string;
+}
+interface TypeaheadProps<T extends SearchableItem = SearchableItem> {
+  /** 当前选中的条目。空表示还没选。 */
+  modelValue?: T | null;
+  /** 静态或异步搜索源。 */
+  searchSource: SearchSource<T>;
+  /** 字段标签。屏幕阅读器始终读得到。 */
+  label: string;
+  /** 视觉上隐藏标签。 */
+  labelHidden?: boolean;
+  /** 标签下方的说明。 */
+  description?: string;
+  placeholder?: string;
+  disabled?: boolean;
+  /** 禁用原因。有值时控件仍可聚焦，方便读到原因。 */
+  disabledReason?: string;
+  status?: TypeaheadStatus;
+  statusMessage?: string;
+  size?: TypeaheadSize;
+  /** 显示清除按钮。 */
+  clearable?: boolean;
+  /** 输入停顿后再搜索，单位毫秒。本地数据可设为 0。 */
+  debounceMs?: number;
+  /** 下拉最多显示多少条。 */
+  maxMenuItems?: number;
+  /** 聚焦时还没输入就展示结果。 */
+  showOnFocus?: boolean;
+  emptyText?: string;
+  required?: boolean;
+  optional?: boolean;
+  /** 表单字段名。选中后提交条目的 id。 */
+  name?: string;
+  width?: number | string;
+}
+interface TypeaheadEmits<T extends SearchableItem = SearchableItem> {
+  'update:modelValue': [value: T | null];
+  'change': [value: T | null];
+  'search': [query: string];
+  'openChange': [isOpen: boolean];
+}
+interface TypeaheadItemProps {
+  /** 这一行对应的搜索结果。 */
+  item: SearchableItem;
+  /** 盖过条目自己的说明。 */
+  description?: string;
+  /** 这一行看起来不可选。 */
+  isDisabled?: boolean;
+}
+interface TypeaheadSlots<T extends SearchableItem = SearchableItem> {
+  /** 输入框开头的图标。 */
+  icon?: () => unknown;
+  /** 自定义下拉条目。 */
+  item?: (props: {
+    item: T;
+    isActive: boolean;
+    isSelected: boolean;
+  }) => unknown;
+  /** 自定义空状态。 */
+  empty?: () => unknown;
+}
+//#endregion
+//#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;
+    "onUpdate:modelValue"?: ((value: T | null) => any) | undefined;
+    onOpenChange?: ((isOpen: boolean) => any) | undefined;
+  }> & (typeof globalThis extends {
+    __VLS_PROPS_FALLBACK: infer P;
+  } ? P : {});
+  expose: (exposed: import("vue").ShallowUnwrapRef<{
+    focus: () => void | undefined;
+    blur: () => void | undefined;
+  }>) => 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);
+}>) => import("vue").VNode & {
+  __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
+};
+declare const _default$2: typeof __VLS_export$2;
+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/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;
+    "onUpdate:modelValue"?: ((value: T | null) => any) | undefined;
+    onOpenChange?: ((isOpen: boolean) => any) | undefined;
+  }> & (typeof globalThis extends {
+    __VLS_PROPS_FALLBACK: infer P;
+  } ? P : {});
+  expose: (exposed: import("vue").ShallowUnwrapRef<{
+    focus: () => void | undefined;
+    blur: () => void | undefined;
+  }>) => 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);
+}>) => import("vue").VNode & {
+  __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
+};
+declare const _default$1: typeof __VLS_export$1;
+type __VLS_PrettifyLocal<T> = (T extends any ? { [K in keyof T]: T[K]; } : { [K in keyof T as K]: T[K]; }) & {};
+//#endregion
+//#region src/Typeahead/TypeaheadItem.vue.d.ts
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+  icon?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<TypeaheadItemProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<TypeaheadItemProps> & 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 { TypeaheadEmits as a, TypeaheadSize as c, BaseTypeaheadProps as i, TypeaheadSlots as l, _default$1 as n, TypeaheadItemProps as o, _default$2 as r, TypeaheadProps as s, _default as t, TypeaheadStatus as u };