@astryx-vue/core 0.2.2 → 0.2.4

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

@@ -1,8 +1,32 @@
 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 {
+  start: string;
+  end: string;
+}
+type WeekStartsOn = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 'sun' | 'mon' | 'tue' | 'wed' | 'thu' | 'fri' | 'sat';
+declare function resolveWeekStart(value: WeekStartsOn | number | undefined): number;
+declare function compareISODate(a: string, b: string): number;
+declare function spanDays(start: string, end: string): number;
+declare function orderRange(a: string, b: string): ISODateRange;
+declare function isSameRange(a: ISODateRange | null, b: ISODateRange | null): boolean;
+declare function isRangeWithinSpan(range: ISODateRange, minRangeSpan?: number, maxRangeSpan?: number): boolean;
+interface RangeClickResult {
+  pending: string | null;
+  commit: ISODateRange | null;
+}
+/**
+ * 第一次点击记下起点。第二次点击在跨度合法时提交区间。
+ * 再次点击起点时，最短跨度允许单日就提交单日，否则取消这次选择。
+ */
+declare function applyRangeClick(pending: string | null, day: string, minRangeSpan?: number, maxRangeSpan?: number): RangeClickResult;
+declare function isDayOutsideSpan(pending: string | null, day: string, minRangeSpan?: number, maxRangeSpan?: number): boolean;
+declare function formatDateRange(range: ISODateRange | null, locale: string): string;
+//#endregion
 //#region src/composables/internal/announce.d.ts
 /**
  * 对应原版 Astryx 的 `hooks/useAnnounce`。
@@ -221,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> {
   /**
@@ -252,29 +317,59 @@ interface ControllableState<T> {
  */
 declare function useControllableState<T>(options: UseControllableStateOptions<T>): ControllableState<T>;
 //#endregion
-//#region src/composables/useDateRange.d.ts
-interface ISODateRange {
-  start: string;
-  end: string;
+//#region src/composables/useTimeValue.d.ts
+type HourFormat = '12h' | '24h';
+type ISOTimeString = string;
+interface ParsedTime {
+  hours: number;
+  minutes: number;
+  seconds: number;
 }
-type WeekStartsOn = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 'sun' | 'mon' | 'tue' | 'wed' | 'thu' | 'fri' | 'sat';
-declare function resolveWeekStart(value: WeekStartsOn | number | undefined): number;
-declare function compareISODate(a: string, b: string): number;
-declare function spanDays(start: string, end: string): number;
-declare function orderRange(a: string, b: string): ISODateRange;
-declare function isSameRange(a: ISODateRange | null, b: ISODateRange | null): boolean;
-declare function isRangeWithinSpan(range: ISODateRange, minRangeSpan?: number, maxRangeSpan?: number): boolean;
-interface RangeClickResult {
-  pending: string | null;
-  commit: ISODateRange | null;
+declare function parseISOTime(value: string): ParsedTime | null;
+declare function formatISOTime(time: ParsedTime, hasSeconds: boolean): ISOTimeString;
+declare function formatDisplayTime(value: string, hourFormat: HourFormat, hasSeconds: boolean): string;
+declare function parseDisplayTime(text: string, hasSeconds: boolean): ISOTimeString | null;
+declare function shiftTime(value: string, minuteDelta: number, hasSeconds: boolean): ISOTimeString;
+declare function isTimeInRange(value: string, min?: string, max?: string): boolean;
+type TimePresentation = 'text-input' | 'popover' | 'bottom-sheet' | 'native' | 'adaptive-bottom-sheet' | 'adaptive-native';
+type NativePicker = 'touch' | 'always' | 'never';
+declare function resolveTimeSurface(options: {
+  presentation?: TimePresentation;
+  nativePicker?: NativePicker;
+  coarse: boolean;
+  hasSeconds: boolean;
+  increment: number;
+}): 'text' | 'native';
+//#endregion
+//#region src/composables/useDatePresentation.d.ts
+/** Which surface collects a date. The text-only option belongs to the time field. */
+type DatePresentation = 'popover' | 'bottom-sheet' | 'native' | 'adaptive-bottom-sheet' | 'adaptive-native';
+type DateSurface = 'popover' | 'sheet' | 'native';
+/**
+ * `presentation` wins over the older native picker name.
+ * With neither set, a mouse gets the calendar popover and a coarse pointer gets the system date control.
+ */
+declare function resolveDatePresentation(presentation: DatePresentation | undefined, nativePicker: NativePicker | undefined): DatePresentation;
+declare function resolveDateSurface(presentation: DatePresentation, coarse: boolean): DateSurface;
+//#endregion
+//#region src/composables/useDisclosureHandle.d.ts
+interface DisclosureHandle {
+  open: () => void;
+  close: () => void;
+  toggle: () => void;
+  isOpen: () => boolean;
 }
 /**
- * 第一次点击记下起点。第二次点击在跨度合法时提交区间。
- * 再次点击起点时，最短跨度允许单日就提交单日，否则取消这次选择。
+ * 模板里的 ref 会被自动解包，所以直接绑到模板上会拿到 null。
+ * 请把读取函数交给 useDisclosureHandle，函数里再返回这个句柄。
  */
-declare function applyRangeClick(pending: string | null, day: string, minRangeSpan?: number, maxRangeSpan?: number): RangeClickResult;
-declare function isDayOutsideSpan(pending: string | null, day: string, minRangeSpan?: number, maxRangeSpan?: number): boolean;
-declare function formatDateRange(range: ISODateRange | null, locale: string): string;
+type DisclosureHandleRef = Ref<DisclosureHandle | null> | ((handle: DisclosureHandle | null) => void);
+/**
+ * 把打开、关闭、切换和当前是否打开写到调用方持有的句柄上。
+ * 必须传入读取函数。句柄本身常常就是一个 ref，直接交给 Vue 的解包会拿到里面的 null。
+ * 句柄换掉时先把旧的清空，组件卸载时也清空。
+ */
+declare function useDisclosureHandle(read: () => DisclosureHandleRef | undefined, handle: DisclosureHandle): void;
 //#endregion
 //#region src/composables/useDismiss.d.ts
 interface UseDismissOptions {
@@ -288,6 +383,11 @@ interface UseDismissOptions {
   enableEscape?: Ref<boolean>;
   /** 关闭回调 */
   onDismiss: () => void;
+  /**
+   * Escape 单独处理。不传时和点击外部走同一个回调。
+   * 菜单钻进子层时，Escape 先退一层，点击外部仍整层关闭。
+   */
+  onEscape?: () => void;
 }
 /**
  * 统一处理浮层组件的关闭逻辑：点击外部和按 Escape 键。
@@ -300,6 +400,27 @@ interface UseDismissOptions {
  */
 declare function useDismiss(options: UseDismissOptions): void;
 //#endregion
+//#region src/composables/useFieldControlState.d.ts
+interface FieldControlStateInput {
+  disabled?: MaybeRefOrGetter<boolean | undefined>;
+  readOnly?: MaybeRefOrGetter<boolean | undefined>;
+  loading?: MaybeRefOrGetter<boolean | undefined>;
+}
+interface FieldControlState {
+  /** 禁用优先于只读。禁用时控件变暗，并且不能聚焦到可操作的状态。 */
+  isDisabled: ComputedRef<boolean>;
+  /** 只读保留当前值、焦点和表单提交，但不打开选择面，也不变暗。 */
+  isReadOnly: ComputedRef<boolean>;
+  isLoading: ComputedRef<boolean>;
+  /** 可以打开选择面或切换选项。 */
+  canActivate: ComputedRef<boolean>;
+}
+/**
+ * 选择器和复选列表共用的三种互斥状态。
+ * 同时标成禁用和只读时，按禁用处理。
+ */
+declare function useFieldControlState(input: FieldControlStateInput): FieldControlState;
+//#endregion
 //#region src/composables/useFileSelection.d.ts
 interface FileRejection {
   code: 'type' | 'size' | 'count';
@@ -374,6 +495,11 @@ interface GridRovingFocus {
  */
 declare function useGridRovingFocus(options: UseGridRovingFocusOptions): GridRovingFocus;
 //#endregion
+//#region src/composables/useHandleRef.d.ts
+type HandleRef<T> = Ref<T | null> | ((handle: T | null) => void);
+/** Keeps an imperative handle on a ref or a callback, and clears it when the owner goes away. */
+declare function useHandleRef<T extends object>(read: () => HandleRef<T> | undefined, handle: T): void;
+//#endregion
 //#region src/composables/useHotkeys.d.ts
 /**
  * 一条全局快捷键。
@@ -407,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
 /**
  * 一维列表的方向。
@@ -529,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;
@@ -662,6 +876,17 @@ declare function computeOverflow(input: ComputeOverflowInput): ComputeOverflowRe
 declare function useOverflow(element: Ref<HTMLElement | null>, isActive: Ref<boolean>): Ref<boolean>;
 declare function useOverflow(itemCount: MaybeRefOrGetter<number>, options?: UseOverflowOptions): UseOverflowReturn;
 //#endregion
+//#region src/composables/usePendingChange.d.ts
+interface PendingChange<T> {
+  busy: Readonly<Ref<boolean>>;
+  run: (value: T) => Promise<void>;
+}
+/**
+ * Runs a change action after the value is already committed.
+ * Overlapping calls stay busy until the last one settles.
+ */
+declare function usePendingChange<T>(action: () => ((value: T) => void | Promise<void>) | undefined): PendingChange<T>;
+//#endregion
 //#region src/composables/useRestoreFocus.d.ts
 interface UseRestoreFocusOptions {
   /** 是否启用焦点恢复 */
@@ -756,30 +981,6 @@ declare function snapToGraphemeBoundary(text: string, offset: number): number;
  */
 declare function useStreamingText(targetText: MaybeRefOrGetter<string>, isStreaming?: MaybeRefOrGetter<boolean>, options?: MaybeRefOrGetter<UseStreamingTextOptions>): ComputedRef<string>;
 //#endregion
-//#region src/composables/useTimeValue.d.ts
-type HourFormat = '12h' | '24h';
-type ISOTimeString = string;
-interface ParsedTime {
-  hours: number;
-  minutes: number;
-  seconds: number;
-}
-declare function parseISOTime(value: string): ParsedTime | null;
-declare function formatISOTime(time: ParsedTime, hasSeconds: boolean): ISOTimeString;
-declare function formatDisplayTime(value: string, hourFormat: HourFormat, hasSeconds: boolean): string;
-declare function parseDisplayTime(text: string, hasSeconds: boolean): ISOTimeString | null;
-declare function shiftTime(value: string, minuteDelta: number, hasSeconds: boolean): ISOTimeString;
-declare function isTimeInRange(value: string, min?: string, max?: string): boolean;
-type TimePresentation = 'text-input' | 'popover' | 'bottom-sheet' | 'native' | 'adaptive-bottom-sheet' | 'adaptive-native';
-type NativePicker = 'touch' | 'always' | 'never';
-declare function resolveTimeSurface(options: {
-  presentation?: TimePresentation;
-  nativePicker?: NativePicker;
-  coarse: boolean;
-  hasSeconds: boolean;
-  increment: number;
-}): 'text' | 'native';
-//#endregion
 //#region src/composables/useTypeahead.d.ts
 interface UseTypeaheadOptions {
   /** 当前 DOM 顺序上的标签。某一项可以是 null，表示这个下标不能匹配。 */
@@ -812,4 +1013,4 @@ interface UseTypeaheadReturn {
  */
 declare function useTypeahead(options: UseTypeaheadOptions): UseTypeaheadReturn;
 //#endregion
-export { useLongPress as $, useAppShellMobile as $t, UseScrollableAreaOptions as A, spanDays as At, computeOverflow as B, INTERACTIVE_SELECTORS as Bt, useScrollLock as C, compareISODate as Ct, ScrollRole as D, isSameRange as Dt, ScrollOverscroll as E, isRangeWithinSpan as Et, useRestoreFocus as F, ComboboxOption as Ft, addMonths as G, UseChatStreamScrollReturn as Gt, NumberField as H, useClickableContainer as Ht, ComputeOverflowInput as I, UseComboboxOptions as It, toISODate as J, UseChatNewMessagesOptions as Jt, buildMonthGrid as K, useChatStreamScroll as Kt, ComputeOverflowResult as L, useCombobox as Lt, useScrollableArea as M, UseControllableStateOptions as Mt, RestoreFocus as N, useControllableState as Nt, ScrollStickyContainment as O, orderRange as Ot, UseRestoreFocusOptions as P, Combobox as Pt, LongPressOptions as Q, appShellMobileKey as Qt, UseOverflowOptions as R, useCoarsePointer as Rt, useScrollOverflow as S, applyRangeClick as St, ScrollAxisState as T, isDayOutsideSpan as Tt, UseNumberFieldOptions as U, ChatScrollToBottomOptions as Ut, useOverflow as V, UseClickableContainerOptions as Vt, useNumberField as W, UseChatStreamScrollOptions as Wt, useMediaQuery as X, useChatNewMessages as Xt, todayISODate as Y, UseChatNewMessagesReturn as Yt, LongPressHandlers as Z, AppShellMobile as Zt, UseStreamingTextOptions as _, UseDismissOptions as _t, ISOTimeString as a, useHotkeys as at, ScrollOverflowState as b, RangeClickResult as bt, TimePresentation as c, useGridRovingFocus as ct, isTimeInRange as d, useFocusTrap as dt, AnnounceFn as en, ListFocus as et, parseDisplayTime as f, FileRejection as ft, StreamingTextSpeed as g, selectFiles as gt, shiftTime as h, formatFileSize as ht, HourFormat as i, Hotkey as it, UseScrollableAreaResult as j, ControllableState as jt, ScrollableAreaState as k, resolveWeekStart as kt, formatDisplayTime as l, FocusTrap as lt, resolveTimeSurface as m, FileSelectionResult as mt, UseTypeaheadReturn as n, useAnnounce as nn, UseListFocusOptions as nt, NativePicker as o, GridRovingFocus as ot, parseISOTime as p, FileSelectionOptions as pt, parseISODate as q, CHAT_MESSAGE_CLASS as qt, useTypeahead as r, useListFocus as rt, ParsedTime as s, UseGridRovingFocusOptions as st, UseTypeaheadOptions as t, AnnouncePoliteness as tn, ListFocusOrientation as tt, formatISOTime as u, UseFocusTrapOptions as ut, snapToGraphemeBoundary as v, useDismiss as vt, ScrollAxis as w, formatDateRange as wt, UseScrollOverflowResult as x, WeekStartsOn as xt, useStreamingText as y, ISODateRange as yt, UseOverflowReturn as z, ClickableContainerHandlers 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 };

package/dist/{index-DfgHJE7H.d.ts → index-z3uLM1O6.d.ts}

@@ -1,9 +1,94 @@
 import { Component, PropType, VNode, VNodeChild } from "vue";
+//#region src/Markdown/ast.d.ts
+interface MdPoint {
+  offset?: number | null;
+  line?: number;
+  column?: number;
+}
+interface MdPosition {
+  start?: MdPoint;
+  end?: MdPoint;
+}
+interface MdNode {
+  type: string;
+  value?: string;
+  children?: MdNode[];
+  depth?: 1 | 2 | 3 | 4 | 5 | 6;
+  ordered?: boolean;
+  start?: number | null;
+  spread?: boolean | null;
+  checked?: boolean | null;
+  lang?: string | null;
+  url?: string;
+  alt?: string | null;
+  title?: string | null;
+  align?: Array<'left' | 'right' | 'center' | null> | null;
+  identifier?: string;
+  label?: string | null;
+  /** Parser offsets. Used to tell a bare autolink from an explicit link. */
+  position?: MdPosition;
+  /**
+   * Set on `type: 'extension'` nodes a plugin inserts.
+   * `plugin` matches `MarkdownPlugin.name` or `MarkdownInlinePlugin.name`.
+   */
+  plugin?: string;
+  /** Name of an extension node within its plugin. */
+  name?: string;
+  /** `block` extension nodes are rendered as their own block. */
+  display?: 'inline' | 'block';
+  /** Extra fields a plugin wants the renderer to read. Keep values plain. */
+  data?: Readonly<Record<string, string | number | boolean | null>>;
+}
+declare function isMarkdownExtensionNode(node: MdNode, plugin?: string, name?: string): node is MdNode & {
+  type: 'extension';
+  plugin: string;
+  name: string;
+};
+//#endregion
+//#region src/Markdown/plugins.d.ts
+interface MarkdownTransformContext {
+  /** Record a problem. The document still renders. */
+  report: (message: string) => void;
+}
+interface MarkdownPluginRenderContext {
+  /** Render this node's children with the normal Markdown renderers. */
+  renderChildren: () => VNodeChild[];
+}
+/**
+ * A document plugin. `transform` receives the parsed root and returns the next
+ * root. Return the same root when nothing changed so a streaming render can
+ * reuse settled blocks. `render` draws `extension` nodes whose `plugin` equals
+ * `name`.
+ */
+interface MarkdownPlugin {
+  name: string;
+  transform?: (root: MdNode, context: MarkdownTransformContext) => MdNode;
+  render?: (node: MdNode, context: MarkdownPluginRenderContext) => VNodeChild | null;
+}
+/**
+ * A text-node plugin. `pattern` needs the `g` flag. Matches inside inline
+ * code and fenced code never run, because those nodes are not text.
+ * `replace` returns the node for the match, or `null` to skip it.
+ * `render` draws an extension node whose `plugin` equals `name`.
+ */
+interface MarkdownInlinePlugin {
+  name?: string;
+  pattern: RegExp;
+  getEndIndex?: (text: string, match: RegExpMatchArray) => number | false;
+  replace: (match: RegExpMatchArray) => MdNode | null;
+  render?: (node: MdNode, context: MarkdownPluginRenderContext) => VNodeChild | null;
+}
+declare function defineMarkdownPlugin<Plugin extends MarkdownPlugin>(plugin: Plugin): Plugin;
+declare function applyMarkdownPlugins(root: MdNode, plugins?: readonly MarkdownPlugin[]): MdNode;
+declare function applyInlinePlugins(root: MdNode, plugins?: readonly MarkdownInlinePlugin[]): MdNode;
+//#endregion
 //#region src/Markdown/types.d.ts
 type MarkdownDisplay = 'block' | 'inline';
 type MarkdownDensity = 'default' | 'compact';
 type MarkdownAlign = 'start' | 'center';
 type MarkdownHeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;
+type MarkdownAutolink = 'gfm';
+type MarkdownCitationStyle = 'label' | 'number';
 interface MarkdownHeadingProps {
   level: MarkdownHeadingLevel;
   id: string;
@@ -98,9 +183,29 @@ interface MarkdownProps {
    * Called when a link is activated. Return `false` to cancel navigation.
    */
   onLinkClick?: (href: string, event: MouseEvent) => void | false;
+  /**
+   * Document plugins. Each one may replace the parsed tree and draw the
+   * extension nodes it owns. An empty list leaves the document unchanged.
+   */
+  plugins?: readonly MarkdownPlugin[];
+  /**
+   * Patterns matched against text nodes, in order. The first match at a
+   * position wins. Inline code and fenced code are left alone.
+   */
+  inlinePlugins?: readonly MarkdownInlinePlugin[];
+  /**
+   * `'gfm'` links bare `https://` URLs, `www.` hosts, and emails.
+   * Omit it and those stay text. `<https://…>` and `<email>` stay links.
+   */
+  autolink?: MarkdownAutolink;
+  /**
+   * `label` is a chip with the source title. `number` is a compact badge.
+   * @default 'label'
+   */
+  citationStyle?: MarkdownCitationStyle;
   /**
    * Citation sources keyed by id. `[id]` and `【id】` that match a key render
-   * as a label chip instead of literal text.
+   * as a citation chip instead of literal text.
    */
   sources?: Record<string, MarkdownSource>;
 }
@@ -147,6 +252,22 @@ declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractP
     type: PropType<MarkdownProps["onLinkClick"]>;
     default: undefined;
   };
+  plugins: {
+    type: PropType<MarkdownProps["plugins"]>;
+    default: undefined;
+  };
+  inlinePlugins: {
+    type: PropType<MarkdownProps["inlinePlugins"]>;
+    default: undefined;
+  };
+  autolink: {
+    type: PropType<MarkdownProps["autolink"]>;
+    default: undefined;
+  };
+  citationStyle: {
+    type: PropType<MarkdownProps["citationStyle"]>;
+    default: string;
+  };
   sources: {
     type: PropType<MarkdownProps["sources"]>;
     default: undefined;
@@ -190,44 +311,52 @@ declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractP
     type: PropType<MarkdownProps["onLinkClick"]>;
     default: undefined;
   };
+  plugins: {
+    type: PropType<MarkdownProps["plugins"]>;
+    default: undefined;
+  };
+  inlinePlugins: {
+    type: PropType<MarkdownProps["inlinePlugins"]>;
+    default: undefined;
+  };
+  autolink: {
+    type: PropType<MarkdownProps["autolink"]>;
+    default: undefined;
+  };
+  citationStyle: {
+    type: PropType<MarkdownProps["citationStyle"]>;
+    default: string;
+  };
   sources: {
     type: PropType<MarkdownProps["sources"]>;
     default: undefined;
   };
 }>> & Readonly<{}>, {
   density: MarkdownDensity | undefined;
-  display: MarkdownDisplay | undefined;
   content: string;
-  contentAlign: MarkdownAlign | undefined;
+  display: MarkdownDisplay | undefined;
   contentWidth: string | number | undefined;
+  contentAlign: MarkdownAlign | undefined;
   components: MarkdownComponents | undefined;
   headingLevelStart: MarkdownHeadingLevel | undefined;
   onLinkClick: ((href: string, event: MouseEvent) => void | false) | undefined;
+  plugins: readonly MarkdownPlugin[] | undefined;
+  inlinePlugins: readonly MarkdownInlinePlugin[] | undefined;
+  autolink: "gfm" | undefined;
+  citationStyle: MarkdownCitationStyle | undefined;
   sources: Record<string, MarkdownSource> | undefined;
   isStreaming: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 //#endregion
-//#region src/Markdown/ast.d.ts
-interface MdNode {
-  type: string;
-  value?: string;
-  children?: MdNode[];
-  depth?: 1 | 2 | 3 | 4 | 5 | 6;
-  ordered?: boolean;
-  start?: number | null;
-  spread?: boolean | null;
-  checked?: boolean | null;
-  lang?: string | null;
-  url?: string;
-  alt?: string | null;
-  title?: string | null;
-  align?: Array<'left' | 'right' | 'center' | null> | null;
-  identifier?: string;
-  label?: string | null;
-}
-//#endregion
 //#region src/Markdown/parse.d.ts
-declare function parseMarkdown(source: string): MdNode;
+interface ParseMarkdownOptions {
+  /**
+   * `'gfm'` keeps GitHub-style bare URLs, `www.` hosts, and emails as links.
+   * Omit it and those stay text. Angle-bracket autolinks stay either way.
+   */
+  autolink?: 'gfm';
+}
+declare function parseMarkdown(source: string, options?: ParseMarkdownOptions): MdNode;
 //#endregion
 //#region src/Markdown/slug.d.ts
 /** URL slug for a heading. Letters and numbers from any language are kept. */
@@ -238,4 +367,4 @@ declare function slugify(value: string): string;
  */
 declare function uniqueSlug(baseSlug: string, counts: Map<string, number>): string;
 //#endregion
-export { MarkdownSlots as _, MarkdownAlign as a, MarkdownDensity as c, MarkdownHeadingProps as d, MarkdownImageProps as f, MarkdownProps as g, MarkdownListProps as h, _default as i, MarkdownDisplay as l, MarkdownLinkProps as m, uniqueSlug as n, MarkdownCodeProps as o, MarkdownInlineCodeProps as p, parseMarkdown as r, MarkdownComponents as s, slugify as t, MarkdownHeadingLevel as u };
+export { MarkdownPlugin as C, applyMarkdownPlugins as D, applyInlinePlugins as E, defineMarkdownPlugin as O, MarkdownInlinePlugin as S, MarkdownTransformContext as T, MarkdownLinkProps as _, _default as a, MarkdownSlots as b, MarkdownCitationStyle as c, MarkdownDensity as d, MarkdownDisplay as f, MarkdownInlineCodeProps as g, MarkdownImageProps as h, parseMarkdown as i, isMarkdownExtensionNode as k, MarkdownCodeProps as l, MarkdownHeadingProps as m, uniqueSlug as n, MarkdownAlign as o, MarkdownHeadingLevel as p, ParseMarkdownOptions as r, MarkdownAutolink as s, slugify as t, MarkdownComponents as u, MarkdownListProps as v, MarkdownPluginRenderContext as w, MarkdownSource as x, MarkdownProps as y };