@astryx-vue/core 0.2.5 → 0.3.0

package/dist/{index-CA6RbRWx.d.ts → index-TXcNH86P.d.ts}

@@ -1,4 +1,4 @@
-import { n as SpacingStep } from "./types-D7QNSqoN.js";
+import { n as SpacingStep } from "./types-BTk0WZ0b.js";
 import { VNodeChild } from "vue";
 //#region src/AppShell/types.d.ts
 type AppShellVariant = 'wash' | 'surface' | 'section' | 'elevated';
@@ -52,8 +52,8 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {
   "onUpdate:mobileNavOpen"?: ((value: boolean) => any) | undefined;
   onMobileNavOpenChange?: ((isOpen: boolean) => any) | undefined;
 }>, {
-  height: AppShellHeight;
   variant: AppShellVariant;
+  height: AppShellHeight;
   mobileNav: false | AppShellMobileNav;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;

package/dist/{index-BIPc1v82.d.ts → index-TntQsADQ.d.ts}

@@ -1,4 +1,4 @@
-import { n as FieldLabelSlots, o as FieldStatusInput, t as FieldLabelProps } from "./types-3eXh_5os.js";
+import { n as FieldLabelSlots, o as FieldStatusInput, t as FieldLabelProps } from "./types-0Q_SJv_F.js";
 //#region src/Slider/types.d.ts
 type SliderValue = number | [number, number];
 type SliderOrientation = 'horizontal' | 'vertical';

package/dist/index-fAZaRruV.d.ts

@@ -0,0 +1,125 @@
+import { InjectionKey, MaybeRefOrGetter, Ref } from "vue";
+import { PartialOptions, ScrollbarsAutoHideBehavior } from "overlayscrollbars";
+//#region src/Scrollbars/types.d.ts
+/** 滚动条自动隐藏的时机：`never` 一直显示，`scroll` 滚动时显示，`leave` 指针离开后隐藏，`move` 指针移动时显示。 */
+type ScrollbarsAutoHide = ScrollbarsAutoHideBehavior;
+/** 透传给 OverlayScrollbars 的选项。 */
+type ScrollbarsOptions = PartialOptions;
+interface ScrollbarsProviderProps {
+  /**
+   * 子树里是否使用自绘滚动条。设为 `false` 时子树不初始化，已经挂上的会被销毁。
+   * 嵌套时内层的 provider 覆盖外层。
+   * @default true
+   */
+  enabled?: boolean;
+  /**
+   * 滚动条自动隐藏的时机。
+   * @default 'scroll'
+   */
+  autoHide?: ScrollbarsAutoHide;
+  /**
+   * 自动隐藏前等待的毫秒数。
+   * @default 800
+   */
+  autoHideDelay?: number;
+  /**
+   * 透传给 OverlayScrollbars 的选项。最后合并，优先级最高。
+   */
+  options?: ScrollbarsOptions;
+}
+interface ScrollbarsProviderSlots {
+  /** 使用自绘滚动条的子树。 */
+  default?: () => unknown;
+}
+interface UseScrollbarsOptions {
+  /**
+   * 这个滚动容器自己要不要使用自绘滚动条。外层 provider 关闭时，这里设为 `true` 也不会生效。
+   * @default true
+   */
+  enabled?: MaybeRefOrGetter<boolean>;
+}
+interface UseScrollbarsResult {
+  /** 当前元素上是否已经挂上自绘滚动条。 */
+  active: Readonly<Ref<boolean>>;
+}
+/** `mount` 返回的句柄，用来更新选项或销毁滚动条。 */
+interface ScrollbarsHandle {
+  /** 用新的选项整体替换当前选项。 */
+  update: (options: ScrollbarsOptions) => void;
+  /** 销毁滚动条，还原元素。 */
+  destroy: () => void;
+}
+/** `ScrollbarsProvider` 向子树提供的内容。 */
+interface ScrollbarsContext {
+  /** 子树是否开启自绘滚动条。 */
+  enabled: Readonly<Ref<boolean>>;
+  /** 合并后的最终选项。 */
+  options: Readonly<Ref<ScrollbarsOptions>>;
+  /** 在滚动容器上挂自绘滚动条。容器本身就是视口，不会搬动子节点。 */
+  mount: (element: HTMLElement, options: ScrollbarsOptions) => ScrollbarsHandle;
+}
+//#endregion
+//#region src/Scrollbars/context.d.ts
+/**
+ * 最近的 `ScrollbarsProvider` 提供的内容。
+ *
+ * 这个文件只能用 `import type` 引 overlayscrollbars。
+ * 所有滚动组件都会引它，没有套 provider 的用户不应该因此把 overlayscrollbars 打进包。
+ */
+declare const scrollbarsKey: InjectionKey<ScrollbarsContext>;
+//#endregion
+//#region src/Scrollbars/ScrollbarsProvider.vue.d.ts
+type __VLS_Slots = ScrollbarsProviderSlots;
+declare const __VLS_base: import("vue").DefineComponent<ScrollbarsProviderProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<ScrollbarsProviderProps> & Readonly<{}>, {
+  options: {
+    paddingAbsolute?: boolean | undefined;
+    showNativeOverlaidScrollbars?: boolean | undefined;
+    update?: {
+      elementEvents?: [elementSelector: string, eventNames: string][] | null | undefined;
+      debounce?: {
+        mutation: import("overlayscrollbars").OptionsDebounceValue;
+        resize: import("overlayscrollbars").OptionsDebounceValue;
+        event: import("overlayscrollbars").OptionsDebounceValue;
+        env: import("overlayscrollbars").OptionsDebounceValue;
+      } | import("overlayscrollbars").OptionsDebounceValue | undefined;
+      attributes?: string[] | null | undefined;
+      ignoreMutation?: ((mutation: MutationRecord) => boolean | null | undefined | void) | null | undefined;
+      flowDirectionStyles?: ((viewport: HTMLElement) => Record<string, unknown> | false | null | undefined | void) | null | undefined;
+    } | undefined;
+    overflow?: {
+      x?: import("overlayscrollbars").OverflowBehavior | undefined;
+      y?: import("overlayscrollbars").OverflowBehavior | undefined;
+    } | undefined;
+    scrollbars?: {
+      theme?: string | null | undefined;
+      visibility?: import("overlayscrollbars").ScrollbarsVisibilityBehavior | undefined;
+      autoHide?: import("overlayscrollbars").ScrollbarsAutoHideBehavior | undefined;
+      autoHideDelay?: number | undefined;
+      autoHideSuspend?: boolean | undefined;
+      dragScroll?: boolean | undefined;
+      clickScroll?: import("overlayscrollbars").ScrollbarsClickScrollBehavior | undefined;
+      pointers?: string[] | null | undefined;
+    } | undefined;
+  };
+  enabled: boolean;
+  autoHide: import("overlayscrollbars").ScrollbarsAutoHideBehavior;
+  autoHideDelay: number;
+}, {}, {}, {}, 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/Scrollbars/useScrollbars.d.ts
+/**
+ * 给一个滚动容器挂上自绘滚动条。
+ *
+ * 外层没有 `ScrollbarsProvider` 时，或者在服务端渲染时，什么都不做，也不建任何 watcher。
+ * 容器本身就是视口，所以容器的 overflow 怎么变，滚动条就怎么跟。
+ */
+declare function useScrollbars(target: MaybeRefOrGetter<HTMLElement | null | undefined>, options?: UseScrollbarsOptions): UseScrollbarsResult;
+//#endregion
+export { ScrollbarsContext as a, ScrollbarsProviderProps as c, UseScrollbarsResult as d, ScrollbarsAutoHide as i, ScrollbarsProviderSlots as l, _default as n, ScrollbarsHandle as o, scrollbarsKey as r, ScrollbarsOptions as s, useScrollbars as t, UseScrollbarsOptions as u };

package/dist/{index-COxy6LEW.d.ts → index-gW0HW02U.d.ts}

@@ -125,8 +125,8 @@ declare const __VLS_base$1: import("vue").DefineComponent<__VLS_PublicProps, {
   onChange?: ((value: string) => any) | undefined;
   "onUpdate:modelValue"?: ((...args: unknown[]) => any) | undefined;
 }>, {
-  isDisabled: boolean;
   size: SegmentedControlSize;
+  isDisabled: boolean;
   layout: SegmentedControlLayout;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export$1: __VLS_WithSlots$1<typeof __VLS_base$1, __VLS_Slots$1>;

package/dist/{index-D5N9ikrS.d.ts → index-hCpxKePE.d.ts}

@@ -209,8 +209,8 @@ declare const __VLS_export$1: import("vue").DefineComponent<CodeBlockProps, {
 }, string, import("vue").PublicProps, Readonly<CodeBlockProps> & Readonly<{
   onCopy?: (() => any) | undefined;
 }>, {
-  width: string;
   size: CodeBlockSize;
+  width: string;
   container: CodeBlockContainer;
   language: string;
   hasLanguageLabel: boolean;

package/dist/{index-CpiWVbRZ.d.ts → index-i0tNFWfz.d.ts}

@@ -29,6 +29,8 @@ interface TokenSlots {
   icon?: () => unknown;
   /** 文字后面、删除按钮前面的内容。 */
   end?: () => unknown;
+  /** 和 `end` 是同一个插槽，用原版的属性名。 */
+  endContent?: () => unknown;
 }
 //#endregion
 //#region src/Token/Token.vue.d.ts
@@ -39,8 +41,8 @@ declare const __VLS_base: import("vue").DefineComponent<TokenProps, {}, {}, {},
   onRemove?: ((event: Event) => any) | undefined;
 }>, {
   size: TokenSize;
-  disabled: boolean;
   labelHidden: boolean;
+  disabled: boolean;
   color: "default" | "blue" | "cyan" | "gray" | "green" | "orange" | "pink" | "purple" | "red" | "teal" | "yellow";
   removable: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;

package/dist/{index-YmSe1ujk.d.ts → index-lgvUFSCO.d.ts}

@@ -121,8 +121,8 @@ declare const __VLS_base$4: import("vue").DefineComponent<__VLS_PublicProps, {},
 }>, {
   placement: "above" | "below" | "start" | "end";
   alignment: "start" | "end" | "center";
-  hideDelay: number;
   hover: boolean;
+  hideDelay: number;
   showDelay: number;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export$4: __VLS_WithSlots$4<typeof __VLS_base$4, __VLS_Slots$4>;

package/dist/{index-bvr3WHvs.d.ts → index-xrzJC4wm.d.ts}

@@ -1,4 +1,4 @@
-import { c as TextType, l as TextWeight, n as TextColor, o as TextSize } from "./types-D9nP_X-c.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 {

package/dist/{index-BK9T1TPZ.d.ts → index-yT1yiiww.d.ts}

@@ -1,4 +1,4 @@
-import { o as FieldStatusInput } from "./types-3eXh_5os.js";
+import { o as FieldStatusInput } from "./types-0Q_SJv_F.js";
 //#region src/Selector/types.d.ts
 interface SelectorOption {
   value: string | number;
@@ -35,7 +35,12 @@ interface SelectorProps {
   placeholder?: string;
   /** 是否禁用 */
   disabled?: boolean;
-  /** 禁用原因（鼠标悬停时显示） */
+  /**
+   * 禁用原因。禁用时鼠标悬停或键盘聚焦会弹出提示，触发器保持可聚焦（aria-disabled），
+   * 但打不开列表。不用再在外面套 Tooltip：禁用的控件收不到悬停事件。
+   */
+  disabledMessage?: string;
+  /** 禁用原因（旧名，和 disabledMessage 等价） */
   disabledReason?: string;
   /** 状态。可以是 `'error'`，也可以是 `{ type, message }`。 */
   status?: SelectorStatusInput;
@@ -62,8 +67,10 @@ interface SelectorProps {
   searchable?: boolean;
   /** 搜索占位文本 */
   searchPlaceholder?: string;
-  /** 是否可清除 */
+  /** 是否可清除。和 hasClear 等价，两者任一为真即生效。 */
   clearable?: boolean;
+  /** 是否可清除（原版名字） */
+  hasClear?: boolean;
   /** 清除按钮标签 */
   clearLabel?: string;
   /** 没有任何选项时的空状态。 */
@@ -102,6 +109,12 @@ interface SelectorEmits {
   'update:modelValue': [value: string | number | null];
   'change': [value: string | number | null];
   'search': [query: string];
+  /** 触发器上的点击。先执行，再切换面板；event.preventDefault() 不会阻止面板打开。 */
+  'click': [event: MouseEvent];
+  /** 触发器获得焦点时触发。 */
+  'focus': [event: FocusEvent];
+  /** 触发器上的按键。内置键盘模型处理（并取消）的按键不再透出。 */
+  'keydown': [event: KeyboardEvent];
 }
 interface SelectorSlots {
   /** 选中项内容 */
@@ -123,27 +136,33 @@ 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;
+  click: (event: MouseEvent) => any;
+  focus: (event: FocusEvent) => any;
+  keydown: (event: KeyboardEvent) => 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;
+  onClick?: ((event: MouseEvent) => any) | undefined;
+  onFocus?: ((event: FocusEvent) => any) | undefined;
+  onKeydown?: ((event: KeyboardEvent) => any) | undefined;
   "onUpdate:modelValue"?: ((value: string | number | null) => any) | undefined;
 }>, {
-  variant: SelectorVariant;
   size: SelectorSize;
   isLoading: boolean;
-  indicatorPosition: SelectorIndicatorPosition;
-  status: SelectorStatusInput;
-  isOptional: boolean;
+  variant: SelectorVariant;
   modelValue: string | number | null;
   isLabelHidden: boolean;
+  isOptional: boolean;
   isRequired: boolean;
+  status: SelectorStatusInput;
   statusVariant: SelectorStatusVariant;
+  indicatorPosition: SelectorIndicatorPosition;
   disabled: boolean;
-  presentation: SelectorPresentation;
-  searchable: boolean;
   clearable: boolean;
   isReadOnly: boolean;
+  presentation: SelectorPresentation;
+  searchable: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;