@astryx-vue/core 0.2.3 → 0.2.4

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-D8o50qOE.d.ts → index-cL3q7O4R.d.ts}

@@ -1,6 +1,6 @@
 //#region src/Pagination/types.d.ts
 /** 上一页和下一页之间显示什么。 */
-type PaginationVariant = 'pages' | 'count' | 'compact' | 'dots' | 'none';
+type PaginationVariant = 'pages' | 'count' | 'compact' | 'dots' | 'input' | 'none';
 /** 控件尺寸。 */
 type PaginationSize = 'sm' | 'md';
 interface PaginationProps {
@@ -17,10 +17,37 @@ interface PaginationProps {
   /**
    * 中间区域的形态。
    * `pages` 是页码，`count` 是「起–止 / 总数」，`compact` 是「第几页 / 共几页」，
-   * `dots` 是圆点，`none` 只留上一页和下一页。
+   * `dots` 是圆点，`input` 是可输入的页码，`none` 只留上一页和下一页。
    * @default 'pages'
    */
   variant?: PaginationVariant;
+  /**
+   * `pages` 形态下，当前页两侧各留几个页码。不传时宽容器是 1，窄容器会再收一档。
+   */
+  siblingCount?: number;
+  /**
+   * 上一页 / 下一页每次跳几页。越过边界时停在第一页或最后一页。
+   * @default 1
+   */
+  step?: number;
+  /**
+   * 总数还不知道时，后面是否还有内容。`total` 大于 0 时以总条目数为准，这个值不再生效。
+   */
+  hasMore?: boolean;
+  /**
+   * `input` 形态里，输入框前面的名词。不传时用当前语言的「Page」或「页」。
+   */
+  pageLabel?: string;
+  /**
+   * 是否在上一页 / 下一页外侧放跳到首尾的按钮。
+   * 不传时只在 `input` 形态、并且总页数已知时显示。
+   * `null` 和缺省是同一件事。布尔属性缺省会被当成 false，所以这里用 null 表示没指定。
+   */
+  hasFirstLast?: boolean | null;
+  /**
+   * 页码已经提交之后再跑的动作。控件会在它结束前标成忙碌，失败也不会把页码改回去。
+   */
+  changeAction?: (page: number) => void | Promise<void>;
   /**
    * 控件高度。
    * @default 'md'
@@ -66,12 +93,14 @@ declare const __VLS_base: import("vue").DefineComponent<PaginationProps, {}, {},
   "onUpdate:page"?: ((value: number) => any) | undefined;
   "onUpdate:pageSize"?: ((value: number) => any) | undefined;
 }>, {
-  variant: PaginationVariant;
   size: PaginationSize;
+  variant: PaginationVariant;
+  step: number;
   disabled: boolean;
   page: number;
   pageSize: number;
   total: number;
+  hasFirstLast: boolean | null;
   showSizeChanger: boolean;
   pageSizeOptions: number[];
   showTotal: boolean;

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-DkVEBdWa.d.ts → index-fa72tWIU.d.ts}

@@ -24,10 +24,10 @@ declare const __VLS_base: import("vue").DefineComponent<NavItemProps, {}, {}, {}
 }, string, import("vue").PublicProps, Readonly<NavItemProps> & Readonly<{
   onClick?: ((event: MouseEvent) => any) | undefined;
 }>, {
-  isSelected: boolean;
+  size: NavItemSize;
   isDisabled: boolean;
   isIconOnly: boolean;
-  size: NavItemSize;
+  isSelected: boolean;
   block: boolean;
   plain: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;

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-foQMNKZO.d.ts → index-hCpxKePE.d.ts}

@@ -1,4 +1,4 @@
-import { a as SyntaxTokenKey, i as SyntaxThemeTokens, n as SyntaxThemeDefinition } from "./syntaxTheme-Bcs1YMF7.js";
+import { i as SyntaxThemeDefinition, o as SyntaxThemeTokens, s as SyntaxTokenKey } from "./syntaxTheme-CwVEcVDk.js";
 import "./useClipboard-CU-kfqeJ.js";
 import { ComputedRef, VNodeChild } from "vue";
 //#region src/Code/types.d.ts
@@ -96,6 +96,17 @@ interface CodeBlockProps {
   hasLineNumbers?: boolean;
   /** One-indexed line numbers to emphasize with an accent background. */
   highlightLines?: number[];
+  /**
+   * Paint the code as a unified diff over `language`.
+   *
+   * A line starting with `+` is added, `-` is removed, and `@@` is a hunk
+   * header. A `--- ` line directly followed by a `+++ ` line and then `@@`
+   * is a file header. The glyph sits in its own column. The rest of every
+   * line keeps this language's syntax colors. Copy still writes `code`,
+   * glyphs included. The header reads `diff`, or `<language> diff`.
+   * @default false
+   */
+  isDiff?: boolean;
   /**
    * Whether to show the copy button.
    * @default true
@@ -198,12 +209,13 @@ 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;
   hasLineNumbers: boolean;
+  isDiff: boolean;
   hasCopyButton: boolean;
   isWrapped: boolean;
   isCollapsible: boolean;
@@ -215,6 +227,40 @@ declare const __VLS_export$1: import("vue").DefineComponent<CodeBlockProps, {
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default$1: typeof __VLS_export$1;
 //#endregion
+//#region src/Code/diff.d.ts
+/** How a unified-diff line reads: what it adds, removes, frames, or keeps. */
+type DiffLineKind = 'added' | 'removed' | 'header' | 'context';
+interface DiffLines {
+  kinds: DiffLineKind[];
+  glyphs: string[];
+  content: string[];
+}
+/**
+ * Read a fence info string the way a diff layer does.
+ * `diff` is the layer over plaintext. `diff-<lang>` is the layer over that
+ * language. Anything else, including `patch`, is just a language name.
+ */
+declare function parseFenceLanguage(info: string | undefined): {
+  language: string;
+  isDiff: boolean;
+};
+/**
+ * Split a diff into the glyph column and the code the base language sees.
+ * Added, removed, and space-led context lines lose their first character.
+ * A context line with no leading space keeps all of it. Header lines
+ * contribute an empty line so token offsets stay per line; the renderer
+ * paints those rows from the original text.
+ */
+declare function splitDiffLines(lines: readonly string[]): DiffLines;
+/**
+ * Classify one line by its first character.
+ * `+` is added, `-` is removed, `@@` is a hunk header. A `--- ` line
+ * directly followed by a `+++ ` line and then an `@@` line is a file header
+ * wherever it occurs. Every other `---` or `+++` line is a change, so
+ * `---i;` is never mistaken for a header.
+ */
+declare function diffLineKind(line: string, isFileHeader?: boolean): DiffLineKind;
+//#endregion
 //#region src/Code/highlightRanges.d.ts
 /** Token types painted by the stylesheet, so they never need a generated rule. */
 declare const HIGHLIGHTED_TOKEN_TYPES: readonly ["keyword", "string", "comment", "number", "function", "type", "tag", "attribute", "property", "operator", "constant", "punctuation", "variable"];
@@ -306,4 +352,4 @@ interface UseSyntaxThemeReturn {
  */
 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 };
+export { _default$2 as A, CodeSlots as B, applyHighlightRanges as C, parseFenceLanguage as D, diffLineKind as E, CodeBlockTokenizer as F, TokenLine as H, CodeColor as I, CodeHighlightMode as L, CodeBlockEmits as M, CodeBlockProps as N, splitDiffLines as O, CodeBlockSize as P, CodeProps as R, HIGHLIGHTED_TOKEN_TYPES as S, DiffLines as T, SyntaxToken as V, 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, CodeBlockContainer as j, _default$1 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, DiffLineKind as w, tokyoNightLight as x, solarizedLight as y, CodeSize as z };

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