@astryx-vue/core 0.2.3 → 0.2.5

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 };

package/dist/{index-f4NGT-e2.d.ts → index-EFqQF2Bx.d.ts}

@@ -12,9 +12,9 @@ declare const __VLS_base: import("vue").DefineComponent<ButtonProps, {
   variant: ButtonVariant;
   elevation: ButtonElevation;
   type: "button" | "reset" | "submit";
+  isLoading: boolean;
   isIconOnly: boolean;
   isInterruptible: boolean;
-  isLoading: boolean;
   loadingLabel: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;

package/dist/{index-BB5yVIN-.d.ts → index-JL4auphT.d.ts}

@@ -1,4 +1,4 @@
-import { a as ItemLayout, d as ListEdgeCompensation, f as ListItemProps, g as ListSlots, h as ListProps, m as ListMarkerStyle, o as ItemProps, p as ListItemSlots, r as ItemElement, s as ItemSlots, t as ItemAlign, u as ListDensity } from "./types-CAZY4Xua.js";
+import { _ as ListItemSlots, a as ItemLayout, b as ListSlots, g as ListItemProps, h as ListEdgeCompensation, m as ListDensity, o as ItemProps, r as ItemElement, s as ItemSlots, t as ItemAlign, v as ListMarkerStyle, y as ListProps } from "./types-DGYHIu4I.js";
 import { ComputedRef, InjectionKey } from "vue";
 //#region src/List/context.d.ts
 /**
@@ -34,8 +34,8 @@ declare const __VLS_base$2: import("vue").DefineComponent<ItemProps, {
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<ItemProps> & Readonly<{}>, {
   isSelected: boolean;
   isDisabled: boolean;
-  density: ListDensity;
   as: ItemElement;
+  density: ListDensity;
   align: ItemAlign;
   layout: ItemLayout;
   isHighlighted: boolean;

package/dist/{index-B9f1rUEv.d.ts → index-XuAAcYiP.d.ts}

@@ -1,4 +1,4 @@
-import { _ as IndicatorProps, d as IndicatorComponent, h as IndicatorName, i as ThemeDefinition, u as CoreIndicatorName, y as IndicatorSize } from "./types-jmqqnkKA.js";
+import { C as IndicatorComponent, D as IndicatorName, S as CoreIndicatorName, j as IndicatorSize, k as IndicatorProps, o as ThemeDefinition } from "./types-gKsEkk2g.js";
 import { ComputedRef, VNodeChild } from "vue";
 //#region src/Indicator/CheckIndicator.vue.d.ts
 type __VLS_Props$1 = IndicatorProps<'singleSelection'>;

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

@@ -69,15 +69,50 @@ interface NavDisclosureSlots {
     focusRequest: NavMenuFocusRequest;
   }) => unknown;
 }
+interface NavHeadingMenuProps {
+  /** 菜单的无障碍名称。标题没传时可以自己写。 */
+  label?: string;
+  /** 菜单宽度档，也会传给每一项的内边距。 @default 'md' */
+  size?: NavMenuSize;
+  /** 覆盖按档位算出的最小宽度。数字按像素。 */
+  minWidth?: number | string;
+  /** 键盘打开后聚焦第一项或最后一项。 */
+  focusRequest?: NavMenuFocusRequest;
+}
+interface NavHeadingMenuEmits {
+  close: [];
+}
+interface NavHeadingMenuItemProps {
+  /** 主文字。自定义内容用默认插槽，插槽优先。 */
+  label?: string;
+  /** 主文字下面的辅助说明。 */
+  description?: string;
+  /** 有地址时渲染成链接。 */
+  href?: string;
+  /** 链接根组件。 */
+  as?: NavLinkComponent;
+  /** 图标 CSS class。 */
+  iconClass?: string;
+  /** 禁用后不响应点击，方向键和首字母查找也会跳过。 @default false */
+  isDisabled?: boolean;
+}
+interface NavHeadingMenuItemEmits {
+  click: [event: MouseEvent];
+}
+interface NavHeadingMenuItemSlots {
+  /** 自定义主文字。有插槽时不再显示 `label`。 */
+  default?: () => unknown;
+  icon?: () => unknown;
+}
 //#endregion
 //#region src/NavMenu/NavDisclosure.vue.d.ts
 type __VLS_Props = NavDisclosureProps;
-type __VLS_Slots$2 = NavDisclosureSlots;
+type __VLS_Slots$4 = NavDisclosureSlots;
 type __VLS_ModelProps = {
   'isOpen'?: boolean;
 };
 type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
-declare const __VLS_base$2: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+declare const __VLS_base$4: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
   openChange: (isOpen: boolean) => any;
   "update:isOpen": (value: boolean) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
@@ -90,6 +125,44 @@ declare const __VLS_base$2: import("vue").DefineComponent<__VLS_PublicProps, {},
   hover: boolean;
   showDelay: number;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export$4: __VLS_WithSlots$4<typeof __VLS_base$4, __VLS_Slots$4>;
+declare const _default$4: typeof __VLS_export$4;
+type __VLS_WithSlots$4<T, S> = T & {
+  new (): {
+    $slots: S;
+  };
+};
+//#endregion
+//#region src/NavMenu/NavHeadingMenu.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<NavHeadingMenuProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+  close: () => any;
+}, string, import("vue").PublicProps, Readonly<NavHeadingMenuProps> & Readonly<{
+  onClose?: (() => any) | undefined;
+}>, {
+  size: NavMenuSize;
+  focusRequest: NavMenuFocusRequest;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export$3: __VLS_WithSlots$3<typeof __VLS_base$3, __VLS_Slots$3>;
+declare const _default$3: typeof __VLS_export$3;
+type __VLS_WithSlots$3<T, S> = T & {
+  new (): {
+    $slots: S;
+  };
+};
+//#endregion
+//#region src/NavMenu/NavHeadingMenuItem.vue.d.ts
+type __VLS_Slots$2 = NavHeadingMenuItemSlots;
+declare const __VLS_base$2: import("vue").DefineComponent<NavHeadingMenuItemProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+  click: (event: MouseEvent) => any;
+}, string, import("vue").PublicProps, Readonly<NavHeadingMenuItemProps> & Readonly<{
+  onClick?: ((event: MouseEvent) => any) | undefined;
+}>, {
+  isDisabled: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export$2: __VLS_WithSlots$2<typeof __VLS_base$2, __VLS_Slots$2>;
 declare const _default$2: typeof __VLS_export$2;
 type __VLS_WithSlots$2<T, S> = T & {
@@ -138,4 +211,4 @@ type __VLS_WithSlots<T, S> = T & {
   };
 };
 //#endregion
-export { NavMenuEmits as a, NavMenuProps as c, NavDisclosureProps as i, NavMenuFocusRequest as l, _default$1 as n, NavMenuItemEmits as o, _default$2 as r, NavMenuItemProps as s, _default as t, NavMenuSize as u };
+export { _default$4 as a, NavHeadingMenuItemEmits as c, NavMenuEmits as d, NavMenuItemEmits as f, NavMenuSize as g, NavMenuFocusRequest as h, _default$3 as i, NavHeadingMenuItemProps as l, NavMenuProps as m, _default$1 as n, NavDisclosureProps as o, NavMenuItemProps as p, _default$2 as r, NavHeadingMenuEmits as s, _default as t, NavHeadingMenuProps as u };

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

@@ -1,4 +1,4 @@
-import { a as TextSize, n as TextColor, o as TextType, s as TextWeight } from "./types-Bt-lSgYX.js";
+import { c as TextType, l as TextWeight, n as TextColor, o as TextSize } from "./types-D9nP_X-c.js";
 //#region src/Timer/format.d.ts
 type TimerFormat = 'elapsed' | 'clock';
 interface TimerPresentation {

package/dist/{index-CDDMDHJM.d.ts → index-c67ca7eJ.d.ts}

@@ -142,8 +142,8 @@ type __VLS_Slots$1 = GridSlots;
 declare const __VLS_base$1: import("vue").DefineComponent<GridProps, {
   element: Readonly<import("vue").ShallowRef<HTMLDivElement | null>>;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<GridProps> & Readonly<{}>, {
-  align: GridAlignment;
   justify: GridAlignment;
+  align: GridAlignment;
 }, {}, {}, {}, 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-CGZ2xi3r.d.ts → index-eshFLli0.d.ts}

@@ -4,6 +4,10 @@ type HeadingType = 'display-1' | 'display-2' | 'display-3' | 'body' | 'large' |
 type HeadingColor = 'primary' | 'secondary' | 'accent' | 'inherit';
 type HeadingWeight = 'regular' | 'medium' | 'semibold' | 'bold';
 type HeadingDisplay = 'block' | 'inline';
+type HeadingWrap = 'wrap' | 'nowrap' | 'balance' | 'pretty';
+type HeadingWordBreak = 'break-word' | 'break-all';
+type HeadingJustify = 'start' | 'center' | 'end';
+type HeadingTruncateTooltip = boolean | 'above' | 'below' | 'start' | 'end';
 interface HeadingProps {
   /**
    * Heading level (1-6). Determines the semantic HTML element (h1–h6).
@@ -27,22 +31,55 @@ interface HeadingProps {
    * @default 'block'
    */
   display?: HeadingDisplay;
+  /**
+   * Document outline level when it should differ from the visual `level`.
+   * The element stays `h{level}`; assistive technology reads this instead.
+   */
+  accessibilityLevel?: HeadingLevel;
+  /**
+   * CSS `text-wrap` behavior.
+   */
+  textWrap?: HeadingWrap;
+  /**
+   * How long unbroken strings break. Single-line truncation defaults to
+   * `break-all`; more than one line defaults to `break-word`.
+   */
+  wordBreak?: HeadingWordBreak;
+  /**
+   * Text alignment. `start` and `end` follow the writing direction.
+   * @default 'start'
+   */
+  justify?: HeadingJustify;
+  /**
+   * Draws a line through the text.
+   * @default false
+   */
+  hasStrikethrough?: boolean;
   /**
    * Maximum lines before truncation. 0 means no truncation.
    * @default 0
    */
   maxLines?: number;
+  /**
+   * 截断之后要不要把全文放进提示。`true` 出现在上方，方位字符串指定位置，`false` 关掉。
+   * @default true
+   */
+  hasTruncateTooltip?: HeadingTruncateTooltip;
 }
 //#endregion
 //#region src/Heading/Heading.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<HeadingProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<HeadingProps> & Readonly<{}>, {
   color: HeadingColor;
   display: HeadingDisplay;
+  justify: HeadingJustify;
   maxLines: number;
+  hasTruncateTooltip: HeadingTruncateTooltip;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;
@@ -52,4 +89,4 @@ type __VLS_WithSlots<T, S> = T & {
   };
 };
 //#endregion
-export { HeadingProps as a, HeadingLevel as i, HeadingColor as n, HeadingType as o, HeadingDisplay as r, HeadingWeight as s, _default as t };
+export { HeadingLevel as a, HeadingType as c, HeadingWrap as d, HeadingJustify as i, HeadingWeight as l, HeadingColor as n, HeadingProps as o, HeadingDisplay as r, HeadingTruncateTooltip as s, _default as t, HeadingWordBreak as u };

package/dist/{index-DxsKyAxq.d.ts → index-vizlhXVs.d.ts}

@@ -1,7 +1,7 @@
 import "./useAsyncSource-xpQovjV_.js";
 import "./useClipboard-CU-kfqeJ.js";
 import "./useResizable-CUoNPmUw.js";
-import { CSSProperties, ComputedRef, InjectionKey, MaybeRefOrGetter, Ref } from "vue";
+import { CSSProperties, Component, ComputedRef, InjectionKey, MaybeRefOrGetter, Ref } from "vue";
 import { CalendarDate } from "@internationalized/date";
 //#region src/composables/useDateRange.d.ts
 interface ISODateRange {
@@ -245,6 +245,47 @@ interface Combobox<T = string | number> {
  */
 declare function useCombobox<T = string | number>(options: UseComboboxOptions<T>): Combobox<T>;
 //#endregion
+//#region src/composables/useContainerReveal.d.ts
+interface UseContainerRevealOptions {
+  /**
+   * 为 false 时什么样式都不加，里面的内容一直可见。
+   * 每次调用都会重新读，所以可以随组件自己的开关变。
+   */
+  isEnabled?: MaybeRefOrGetter<boolean>;
+}
+interface ContainerRevealOptions {
+  /**
+   * 指针必须停这么多毫秒，悬停揭示才开始。键盘和粗指针不等待。
+   */
+  hoverDelay?: number;
+  /**
+   * 把容器钉在揭示或收起。`inactive` 仍让键盘焦点和粗指针看见内容。
+   */
+  forceState?: 'active' | 'inactive';
+}
+interface ContentRevealOptions {
+  /** 反过来：平时可见，悬停时藏起。只影响指针，键盘和触摸仍看得到。 */
+  isRevealInverted?: boolean;
+  /** 藏起时仍占位，避免布局跳动。 */
+  isLayoutPreserved?: boolean;
+  /** 这一块自己的可见性，不跟容器走。`hidden` 在焦点进来时仍会露出。 */
+  forceVisibility?: 'shown' | 'hidden';
+}
+/**
+ * 悬停或键盘焦点时才露出行内操作。状态写在容器的自定义属性上，
+ * 嵌套容器会盖住外层，所以两层不会串。内容用透明度和定位藏起，不从无障碍树里拿掉。
+ */
+interface UseContainerReveal {
+  containerProps: (reveal?: ContainerRevealOptions) => {
+    class?: string | Record<string, boolean>;
+    style?: CSSProperties;
+  };
+  contentProps: (reveal?: ContentRevealOptions) => {
+    class?: string | Record<string, boolean>;
+  };
+}
+declare function useContainerReveal(options?: UseContainerRevealOptions): UseContainerReveal;
+//#endregion
 //#region src/composables/useControllableState.d.ts
 interface UseControllableStateOptions<T> {
   /**
@@ -492,6 +533,63 @@ interface Hotkey {
  */
 declare function useHotkeys(hotkeys: MaybeRefOrGetter<readonly Hotkey[]>): void;
 //#endregion
+//#region src/composables/useImageMode.d.ts
+interface ImageSampleRegion {
+  /** 左边缘，0 是左，1 是右。 */
+  x: number;
+  /** 上边缘，0 是上，1 是下。 */
+  y: number;
+  /** 宽度占整张图的比例。 */
+  width: number;
+  /** 高度占整张图的比例。 */
+  height: number;
+}
+interface UseImageModeOptions {
+  /** 只采样这一块。不传时用整张图。坐标都是 0 到 1。 */
+  region?: ImageSampleRegion;
+  /** 低于这个亮度算暗，高于算亮。 */
+  threshold?: number;
+  /** 还在加载，或者读图失败时返回的值。 */
+  fallback?: 'dark' | 'light' | null;
+}
+/**
+ * APCA 感知亮度。先把 sRGB 按 2.4 线性化，再用接近 BT.709 的系数合成，
+ * 最后做 0.56 次方，让 0.5 接近视觉上的中灰。饱和色比简单的伽马亮度更准。
+ */
+declare function perceptualLightness(r: number, g: number, b: number): number;
+/** 一组采样像素的平均亮度，再和阈值比出深浅。 */
+declare function imageModeFromPixels(pixels: Uint8ClampedArray, threshold?: number): 'dark' | 'light';
+/**
+ * 按图片亮度判断该用深色还是浅色前景。采样走 OffscreenCanvas，不往页面上画。
+ * 跨域或网络失败时返回 `fallback`。
+ */
+declare function useImageMode(src: MaybeRefOrGetter<string | null | undefined>, options?: MaybeRefOrGetter<UseImageModeOptions>): Ref<'dark' | 'light' | null>;
+//#endregion
+//#region src/composables/useKeyboardHint.d.ts
+type KeyboardHintOrientation = 'horizontal' | 'vertical' | 'both';
+interface UseKeyboardHintOptions {
+  /** 提示里画哪些方向键。 */
+  orientation?: KeyboardHintOrientation;
+  /** 出现之后多久自己消失，单位毫秒。 */
+  dismissAfterMs?: number;
+  /** 为 false 时这个实例不再提示。 */
+  isEnabled?: boolean;
+}
+interface UseKeyboardHint {
+  visible: Ref<boolean>;
+  anchor: Ref<HTMLElement | null>;
+  orientation: ComputedRef<KeyboardHintOrientation>;
+  onFocus: (event: FocusEvent) => void;
+  onBlur: (event: FocusEvent) => void;
+  onKeyDown: (event: KeyboardEvent) => void;
+  Hint: Component;
+}
+/**
+ * 一组方向键控件第一次被键盘点进来时，在当前项旁边短暂提示「用方向键移动」。
+ * 按过方向键、超时或焦点离开之后不再出现。
+ */
+declare function useKeyboardHint(options?: UseKeyboardHintOptions): UseKeyboardHint;
+//#endregion
 //#region src/composables/useListFocus.d.ts
 /**
  * 一维列表的方向。
@@ -614,6 +712,37 @@ declare function useLongPress(options: LongPressOptions): LongPressHandlers;
  */
 declare function useMediaQuery(query: string): Ref<boolean>;
 //#endregion
+//#region src/ContextMenu/useMenuPress.d.ts
+/** Forget an armed swallower. Called when a surface unmounts and in tests. */
+declare function resetMenuPress(): void;
+interface MenuPressOptions {
+  /** The element carrying `role="menu"` for this level. */
+  menuRef: Ref<HTMLElement | null>;
+  /** Whether the surface carries the press model right now. */
+  isEnabled: () => boolean;
+  /** A mouse press that began inside the menu was released outside it. */
+  onDismiss: () => void;
+}
+interface MenuPress {
+  /** Attach to the menu root's `pointerdown`. */
+  onPointerDown: (event: PointerEvent) => void;
+}
+/**
+ * The press model of a painted menu surface.
+ *
+ * A finger's pointer events stay with the element it landed on, so the gesture
+ * is tracked at the document level by `pointerId`:
+ *
+ * - The highlight follows the finger.
+ * - The row under the RELEASE acts, the way its own click would, carrying the
+ *   release's modifiers; the browser's own click for that gesture is swallowed
+ *   so the row never acts twice.
+ * - A finger released outside leaves the menu open; a mouse released outside
+ *   dismisses it.
+ * - `pointercancel` and a second pointer end the gesture with nothing acting.
+ */
+declare function useMenuPress(options: MenuPressOptions): MenuPress;
+//#endregion
 //#region src/composables/useMonthGrid.d.ts
 declare function toISODate(date: CalendarDate): string;
 declare function parseISODate(value: string): CalendarDate;
@@ -884,4 +1013,4 @@ interface UseTypeaheadReturn {
  */
 declare function useTypeahead(options: UseTypeaheadOptions): UseTypeaheadReturn;
 //#endregion
-export { UseGridRovingFocusOptions as $, AppShellMobile as $t, computeOverflow as A, parseISOTime as At, useMediaQuery as B, useCoarsePointer as Bt, useRestoreFocus as C, NativePicker as Ct, ComputeOverflowResult as D, formatISOTime as Dt, ComputeOverflowInput as E, formatDisplayTime as Et, addMonths as F, useControllableState as Ft, ListFocusOrientation as G, ChatScrollToBottomOptions as Gt, LongPressOptions as H, INTERACTIVE_SELECTORS as Ht, buildMonthGrid as I, Combobox as It, Hotkey as J, useChatStreamScroll as Jt, UseListFocusOptions as K, UseChatStreamScrollOptions as Kt, parseISODate as L, ComboboxOption as Lt, NumberField as M, shiftTime as Mt, UseNumberFieldOptions as N, ControllableState as Nt, UseOverflowOptions as O, isTimeInRange as Ot, useNumberField as P, UseControllableStateOptions as Pt, GridRovingFocus as Q, useChatNewMessages as Qt, toISODate as R, UseComboboxOptions as Rt, UseRestoreFocusOptions as S, ISOTimeString as St, usePendingChange as T, TimePresentation as Tt, useLongPress as U, UseClickableContainerOptions as Ut, LongPressHandlers as V, ClickableContainerHandlers as Vt, ListFocus as W, useClickableContainer as Wt, HandleRef as X, UseChatNewMessagesOptions as Xt, useHotkeys as Y, CHAT_MESSAGE_CLASS as Yt, useHandleRef as Z, UseChatNewMessagesReturn as Zt, ScrollableAreaState as _, DatePresentation as _t, UseStreamingTextOptions as a, ISODateRange as an, FileSelectionOptions as at, useScrollableArea as b, resolveDateSurface as bt, ScrollOverflowState as c, applyRangeClick as cn, selectFiles as ct, useScrollLock as d, isDayOutsideSpan as dn, useFieldControlState as dt, appShellMobileKey as en, useGridRovingFocus as et, ScrollAxis as f, isRangeWithinSpan as fn, UseDismissOptions as ft, ScrollStickyContainment as g, spanDays as gn, useDisclosureHandle as gt, ScrollRole as h, resolveWeekStart as hn, DisclosureHandleRef as ht, StreamingTextSpeed as i, useAnnounce as in, FileRejection as it, useOverflow as j, resolveTimeSurface as jt, UseOverflowReturn as k, parseDisplayTime as kt, UseScrollOverflowResult as l, compareISODate as ln, FieldControlState as lt, ScrollOverscroll as m, orderRange as mn, DisclosureHandle as mt, UseTypeaheadReturn as n, AnnounceFn as nn, UseFocusTrapOptions as nt, snapToGraphemeBoundary as o, RangeClickResult as on, FileSelectionResult as ot, ScrollAxisState as p, isSameRange as pn, useDismiss as pt, useListFocus as q, UseChatStreamScrollReturn as qt, useTypeahead as r, AnnouncePoliteness as rn, useFocusTrap as rt, useStreamingText as s, WeekStartsOn as sn, formatFileSize as st, UseTypeaheadOptions as t, useAppShellMobile as tn, FocusTrap as tt, useScrollOverflow as u, formatDateRange as un, FieldControlStateInput as ut, UseScrollableAreaOptions as v, DateSurface as vt, PendingChange as w, ParsedTime as wt, RestoreFocus as x, HourFormat as xt, UseScrollableAreaResult as y, resolveDatePresentation as yt, todayISODate as z, useCombobox as zt };
+export { UseKeyboardHint as $, useContainerReveal as $t, computeOverflow as A, isRangeWithinSpan as An, DatePresentation as At, MenuPress as B, formatISOTime as Bt, useRestoreFocus as C, ISODateRange as Cn, FieldControlStateInput as Ct, ComputeOverflowResult as D, compareISODate as Dn, DisclosureHandle as Dt, ComputeOverflowInput as E, applyRangeClick as En, useDismiss as Et, addMonths as F, ISOTimeString as Ft, LongPressHandlers as G, shiftTime as Gt, resetMenuPress as H, parseDisplayTime as Ht, buildMonthGrid as I, NativePicker as It, ListFocus as J, useControllableState as Jt, LongPressOptions as K, ControllableState as Kt, parseISODate as L, ParsedTime as Lt, NumberField as M, orderRange as Mn, resolveDatePresentation as Mt, UseNumberFieldOptions as N, resolveWeekStart as Nn, resolveDateSurface as Nt, UseOverflowOptions as O, formatDateRange as On, DisclosureHandleRef as Ot, useNumberField as P, spanDays as Pn, HourFormat as Pt, KeyboardHintOrientation as Q, UseContainerRevealOptions as Qt, toISODate as R, TimePresentation as Rt, UseRestoreFocusOptions as S, useAnnounce as Sn, FieldControlState as St, usePendingChange as T, WeekStartsOn as Tn, UseDismissOptions as Tt, useMenuPress as U, parseISOTime as Ut, MenuPressOptions as V, isTimeInRange as Vt, useMediaQuery as W, resolveTimeSurface as Wt, UseListFocusOptions as X, ContentRevealOptions as Xt, ListFocusOrientation as Y, ContainerRevealOptions as Yt, useListFocus as Z, UseContainerReveal as Zt, ScrollableAreaState as _, AppShellMobile as _n, FileRejection as _t, UseStreamingTextOptions as a, ClickableContainerHandlers as an, perceptualLightness as at, useScrollableArea as b, AnnounceFn as bn, formatFileSize as bt, ScrollOverflowState as c, useClickableContainer as cn, useHotkeys as ct, useScrollLock as d, UseChatStreamScrollReturn as dn, GridRovingFocus as dt, Combobox as en, UseKeyboardHintOptions as et, ScrollAxis as f, useChatStreamScroll as fn, UseGridRovingFocusOptions as ft, ScrollStickyContainment as g, useChatNewMessages as gn, useFocusTrap as gt, ScrollRole as h, UseChatNewMessagesReturn as hn, UseFocusTrapOptions as ht, StreamingTextSpeed as i, useCoarsePointer as in, imageModeFromPixels as it, useOverflow as j, isSameRange as jn, DateSurface as jt, UseOverflowReturn as k, isDayOutsideSpan as kn, useDisclosureHandle as kt, UseScrollOverflowResult as l, ChatScrollToBottomOptions as ln, HandleRef as lt, ScrollOverscroll as m, UseChatNewMessagesOptions as mn, FocusTrap as mt, UseTypeaheadReturn as n, UseComboboxOptions as nn, ImageSampleRegion as nt, snapToGraphemeBoundary as o, INTERACTIVE_SELECTORS as on, useImageMode as ot, ScrollAxisState as p, CHAT_MESSAGE_CLASS as pn, useGridRovingFocus as pt, useLongPress as q, UseControllableStateOptions as qt, useTypeahead as r, useCombobox as rn, UseImageModeOptions as rt, useStreamingText as s, UseClickableContainerOptions as sn, Hotkey as st, UseTypeaheadOptions as t, ComboboxOption as tn, useKeyboardHint as tt, useScrollOverflow as u, UseChatStreamScrollOptions as un, useHandleRef as ut, UseScrollableAreaOptions as v, appShellMobileKey as vn, FileSelectionOptions as vt, PendingChange as w, RangeClickResult as wn, useFieldControlState as wt, RestoreFocus as x, AnnouncePoliteness as xn, selectFiles as xt, UseScrollableAreaResult as y, useAppShellMobile as yn, FileSelectionResult as yt, todayISODate as z, formatDisplayTime as zt };