@astryx-vue/core 0.2.5 → 0.3.0

package/dist/useResizable-DDwPpPe6.d.ts

@@ -0,0 +1,409 @@
+import { n as SpacingStep } from "./types-BTk0WZ0b.js";
+import { i as SectionVariant } from "./types-uFMH9NaM.js";
+import { CSSProperties, MaybeRefOrGetter, Ref, VNode, VNodeChild } from "vue";
+//#region src/Toolbar/types.d.ts
+type ToolbarSize = 'sm' | 'md' | 'lg';
+type ToolbarOrientation = 'horizontal' | 'vertical';
+type ToolbarVariant = 'transparent' | 'muted';
+type ToolbarDivider = 'top' | 'bottom' | 'start' | 'end';
+interface ToolbarProps {
+  /** 工具栏的无障碍名称。 */
+  label: string;
+  /** 高度档，也决定默认的块方向内边距。 @default 'md' */
+  size?: ToolbarSize;
+  /** 每一组里各项的间距。 @default 1 */
+  gap?: SpacingStep;
+  /** 方向键沿哪一根轴移动焦点。 @default 'horizontal' */
+  orientation?: ToolbarOrientation;
+  /** 底色。muted 用来标出批量操作条。 @default 'transparent' */
+  variant?: ToolbarVariant;
+  /** 在指定边上画分隔线。 */
+  dividers?: ToolbarDivider[];
+}
+interface ToolbarSlots {
+  start?: () => unknown;
+  center?: () => unknown;
+  end?: () => unknown;
+}
+//#endregion
+//#region src/Table/plugins/selection.d.ts
+/**
+ * 选中集合的写入方式。钩子总是算好新的 `Set` 再交出去，所以接到值直接赋值就行；
+ * 原版那种同时支持 updater 的派发器（参数更宽）也能直接传进来。
+ */
+type TableSelectedKeysSetter = (keys: Set<string>) => void;
+interface UseTableSelectionStateConfig<T extends Record<string, unknown>> {
+  data: MaybeRefOrGetter<readonly T[]>;
+  /** 行的唯一键：属性名，或者从行里取出键的函数。 */
+  idKey: (keyof T & string) | ((item: T) => string);
+  selectedKeys: MaybeRefOrGetter<ReadonlySet<string>>;
+  setSelectedKeys: TableSelectedKeysSetter;
+  /** 这一行显示复选框吗。为 false 的行连复选框都没有，也不算进全选。 */
+  getIsItemSelectable?: (item: T) => boolean;
+  /** 这一行的复选框能点吗。为 false 的行复选框是禁用的，全选时保留它原来的状态。 */
+  getIsItemEnabled?: (item: T) => boolean;
+  getRowLabel?: (item: T) => string;
+  hasRowHighlight?: boolean;
+}
+/**
+ * 选择状态的只读快照。`useTableSelectionState` 返回它，选择相关的界面直接读这几个字段，
+ * 不用自己再数 `selectedKeys`。
+ */
+interface TableSelectionState {
+  /** 选中的全部键，含不在当前页里的行。 */
+  readonly selectedKeys: ReadonlySet<string>;
+  /** 选中的键的总数。 */
+  readonly selectedCount: number;
+  /** 是否至少选中了一个键。 */
+  readonly hasSelection: boolean;
+  /** 清空全部选中的键。 */
+  readonly clearSelection: () => void;
+}
+declare function useTableSelectionState<T extends Record<string, unknown>>(config: UseTableSelectionStateConfig<T>): {
+  selectionConfig: UseTableSelectionConfig<T> & {
+    readonly rows: readonly T[];
+  };
+  selectionState: TableSelectionState;
+};
+interface UseTableSelectionConfig<T extends Record<string, unknown>> {
+  getIsItemSelected: (item: T) => boolean;
+  onSelectItem: (event: {
+    item: T;
+    isSelected: boolean;
+  }) => void;
+  onSelectAll: (event: {
+    isAllSelected: boolean;
+  }) => void;
+  getIsAllSelected: () => boolean;
+  getIsIndeterminate?: () => boolean;
+  getIsItemSelectable?: (item: T) => boolean;
+  getIsItemEnabled?: (item: T) => boolean;
+  getRowLabel?: (item: T) => string;
+  hasRowHighlight?: boolean;
+}
+declare function useTableSelection<T extends Record<string, unknown>>(config: MaybeRefOrGetter<UseTableSelectionConfig<T>>): TablePlugin<T>;
+//#endregion
+//#region src/Table/types.d.ts
+type TableDensity = 'compact' | 'balanced' | 'spacious';
+type TableDividers = 'rows' | 'columns' | 'grid' | 'none';
+type TableTextOverflow = 'wrap' | 'truncate';
+type TableVerticalAlign = 'top' | 'middle' | 'bottom';
+type TableColumnAlign = 'start' | 'center' | 'end';
+type TableSortDirection = 'ascending' | 'descending';
+interface ProportionalWidth {
+  type: 'proportional';
+  value: number;
+  minWidth?: number;
+}
+interface PixelWidth {
+  type: 'pixel';
+  value: number;
+}
+type ColumnWidth = ProportionalWidth | PixelWidth;
+interface TableSortEntry<TSortKey extends string = string> {
+  sortKey: TSortKey;
+  direction: TableSortDirection;
+}
+type TableSortState<TSortKey extends string = string> = TableSortEntry<TSortKey>[];
+interface TableColumn<T extends Record<string, unknown> = Record<string, unknown>> {
+  key: string;
+  header?: string;
+  width?: ColumnWidth;
+  align?: TableColumnAlign;
+  verticalAlign?: TableVerticalAlign;
+  sortable?: boolean | {
+    sortKey?: string;
+    compare?: (a: T, b: T) => number;
+  };
+  /** Field key used by the filtering plugin. */
+  filter?: string;
+  /** 表头只留给读屏，视觉上留空。 */
+  headerHidden?: boolean;
+  /** 为 false 时，列宽拖动不给这一列画把手。 */
+  resizable?: boolean;
+  renderCell?: (item: T, index: number) => VNodeChild;
+}
+/**
+ * 过滤控件的输入类型。
+ * - `string`：文本，匹配子串。
+ * - `enum`：单选，命中其中一个选项。
+ * - `multi-select`：多选，命中其中任意一个选项。
+ * - `number`：数字，数值相等才算命中。
+ * - `date`：日期，单元格日期晚于选中日期才算命中。
+ */
+type TableFilterFieldType = 'string' | 'enum' | 'multi-select' | 'number' | 'date';
+interface TableFilterField {
+  key: string;
+  label: string;
+  type: TableFilterFieldType;
+  /** `enum` 和 `multi-select` 的选项。 */
+  options?: readonly {
+    value: string;
+    label: string;
+  }[];
+  /** `number` 字段允许的最小值。 */
+  min?: number;
+  /** `number` 字段允许的最大值。 */
+  max?: number;
+  /** `number` 字段的步进。`isIntegerOnly` 为真时默认 1。 */
+  step?: number;
+  /** `number` 字段只接受整数。 */
+  isIntegerOnly?: boolean;
+}
+/** 过滤值。`number` 字段存数字，`multi-select` 存字符串数组，其余存字符串。 */
+type TableFilterValue = string | number | string[];
+type TableFilterState = Record<string, TableFilterValue>;
+interface TableSortContribution {
+  direction: TableSortDirection | null;
+  rank: number | null;
+  label: string;
+  onClick: (event: MouseEvent) => void;
+}
+/** 过滤控件的摆放方式。`inline-compact` 和 `inline` 同位置，但控件更紧凑。 */
+type TableFilterVariant = 'inline' | 'inline-compact' | 'popover';
+interface TableFilterContribution {
+  variant: TableFilterVariant;
+  field: TableFilterField;
+  value: TableFilterValue | null;
+  onChange: (value: TableFilterValue | null) => void;
+}
+interface TableSelectionContribution<T> {
+  isAllSelected: () => boolean;
+  isIndeterminate: () => boolean;
+  isSelected: (row: T) => boolean;
+  isSelectable?: (row: T) => boolean;
+  /** 为 false 时这一行的复选框渲染成禁用状态。 */
+  isEnabled?: (row: T) => boolean;
+  selectAll: (selected: boolean) => void;
+  selectRow: (row: T, selected: boolean) => void;
+  rowLabel?: (row: T) => string;
+  hasRowHighlight?: boolean;
+}
+interface TableRowMenuItem {
+  id: string;
+  label: string;
+  icon?: string;
+  onSelect: () => void;
+}
+interface TableGroupPatch {
+  groupKey: string;
+  count: number;
+  collapsed: boolean;
+  onToggle: () => void;
+  render?: () => VNodeChild;
+}
+interface TablePanelPatch {
+  variant: 'muted' | 'transparent';
+  render: () => VNodeChild;
+}
+interface TableRowPatch {
+  attrs?: Record<string, string | undefined>;
+  class?: string;
+  onClick?: (event: MouseEvent) => void;
+  suppressSelection?: boolean;
+  skipRowIndex?: boolean;
+  group?: TableGroupPatch;
+  panel?: TablePanelPatch;
+  menu?: readonly TableRowMenuItem[];
+}
+interface TableCellPatch {
+  class?: string;
+  style?: CSSProperties;
+  attrs?: Record<string, string | undefined>;
+}
+interface TableCellPatchInput<T extends Record<string, unknown>> {
+  column: TableColumn<T>;
+  columns: readonly TableColumn<T>[];
+  row: T | null;
+  kind: 'header' | 'body';
+}
+interface TableHeaderPatch {
+  before?: () => VNodeChild;
+}
+/**
+ * 一列参与拖动改宽的方式。`Table` 用它画把手的无障碍属性，并在拖动时算出每一列的新宽度。
+ */
+interface TableColumnResizeContribution {
+  /** 当前生效的像素宽度。没被拖过时是 `undefined`，按 DOM 实际宽度算。 */
+  currentWidth?: number;
+  /** 这一列能拖到的最窄像素。 */
+  minWidth: number;
+  /** 这一列能拖到的最宽像素。 */
+  maxWidth: number;
+  /** 拖动时把宽度让给这一列的相邻列 key；`null` 表示这一列自己伸缩。 */
+  neighborKey: string | null;
+  /** 是否画把手。最后一列按比例伸缩时不画。 */
+  hasHandle: boolean;
+}
+interface TablePlugin<T extends Record<string, unknown> = Record<string, unknown>> {
+  transformColumns?: (columns: TableColumn<T>[]) => TableColumn<T>[];
+  sortFor?: (column: TableColumn<T>) => TableSortContribution | null;
+  filterFor?: (column: TableColumn<T>) => TableFilterContribution | null;
+  selection?: TableSelectionContribution<T>;
+  widthFor?: (column: TableColumn<T>) => number | undefined;
+  /**
+   * 一列怎么参与拖动改宽。`columns` 是当前表格里的全部列，用来找相邻列和最后一列。
+   * 返回 `null` 的列不参与。
+   */
+  resizeFor?: (column: TableColumn<T>, columns: readonly TableColumn<T>[]) => TableColumnResizeContribution | null;
+  /** 一次调整结束时调用（松开指针，或按方向键 / Home / End），带上所有宽度变了的列。 */
+  onColumnResizeEnd?: (updates: Record<string, number>) => void;
+  /** 渲染在表格上方的内容，分页这类插件用。 */
+  above?: () => VNodeChild;
+  below?: () => VNodeChild;
+  /** 改一行的属性、点击、分组头或展开面板。多个插件的结果会合并。 */
+  rowPatch?: (row: T, index: number, columnCount: number) => TableRowPatch | null;
+  /** 改表头或单元格的定位与类名。选择列的 key 是 `__select`。 */
+  cellPatch?: (input: TableCellPatchInput<T>) => TableCellPatch | null;
+  /** 在列表头文字前面加控件，例如树的全部展开。 */
+  headerPatch?: (column: TableColumn<T>) => TableHeaderPatch | null;
+  /** 表格滚动容器挂上或卸下时调用，用来画固定列的滚动阴影。 */
+  bindScrollRoot?: (element: HTMLElement | null) => void;
+}
+interface TableProps<T extends Record<string, unknown> = Record<string, unknown>> {
+  data?: readonly T[];
+  columns?: readonly TableColumn<T>[];
+  idKey?: string | ((item: T) => string);
+  /**
+   * 窗口里第一行数据的行号，从 1 计。
+   * 和 `rowCount` 任一设置后，数据行带 `aria-rowindex`。分组头和展开面板不计。
+   */
+  rowIndexStart?: number;
+  /**
+   * 完整结果集的行数，含当前窗口以外的行。
+   * 设置后表格带 `aria-rowcount`。只设置了 `rowIndexStart` 时，行数为未知（-1）。
+   */
+  rowCount?: number;
+  density?: TableDensity;
+  dividers?: TableDividers;
+  isStriped?: boolean;
+  hasHover?: boolean;
+  verticalAlign?: TableVerticalAlign;
+  textOverflow?: TableTextOverflow;
+  plugins?: Record<string, TablePlugin<T> | undefined>;
+  label?: string;
+}
+interface TableSlots {
+  default?: () => VNode[];
+  empty?: () => VNode[];
+}
+interface TableRowProps {
+  isHeaderRow?: boolean;
+}
+interface TableCellProps {
+  align?: TableColumnAlign;
+  colSpan?: number;
+  rowSpan?: number;
+  headers?: string;
+}
+interface TableSelectionToolbarProps {
+  /**
+   * 选中的行数。`selection` 没给时用它。
+   * @default 0
+   */
+  count?: number;
+  /**
+   * `useTableSelectionState` 返回的 `selectionState`。给了就代替 `count`，
+   * 并且一个都没选中时整条不渲染。
+   */
+  selection?: TableSelectionState;
+  /**
+   * 工具栏的无障碍名称。不传用内置文案。
+   */
+  label?: string;
+  /**
+   * 清空按钮的文字。不传用内置文案。
+   */
+  clearLabel?: string;
+  /**
+   * 高度档，同时决定清空按钮的高度。
+   * @default 'sm'
+   */
+  size?: ToolbarSize;
+  /**
+   * 底色。`section` 用表面色，`muted` 用弱化底，`transparent` 不铺底。
+   * @default 'muted'
+   */
+  variant?: SectionVariant;
+}
+interface TableSelectionToolbarSlots {
+  /** 产品自己的操作按钮，排在逻辑起点。 */
+  start?: () => VNodeChild;
+  /** 计数文字的替代渲染，参数里带 `count`。 */
+  label?: (props: {
+    count: number;
+  }) => VNodeChild;
+  /** `start` 的旧写法，两者都没给时不用。 */
+  default?: () => VNodeChild;
+}
+//#endregion
+//#region src/composables/useResizable.d.ts
+type ResizableDirection = 'horizontal' | 'vertical';
+interface ResizablePercentSize {
+  type: 'percent';
+  value: number;
+  min?: PixelWidth;
+  max?: PixelWidth;
+}
+type ResizableSize = number | `${number}px` | `${number}%` | PixelWidth | ResizablePercentSize;
+interface ResizableRegionConfig {
+  defaultSize?: ResizableSize | string;
+  minSize?: ResizableSize | string;
+  maxSize?: ResizableSize | string;
+  collapsible?: boolean;
+  collapsedSize?: number;
+  snaps?: number[];
+  /** Cascade priority. A lower number gives up space first when the shared container is narrower than the regions. */
+  shrinkOrder?: number;
+}
+interface UseResizableSingleOptions extends ResizableRegionConfig {
+  containerRef?: Ref<HTMLElement | null>;
+  direction?: ResizableDirection;
+  autoSaveId?: string;
+  defaultIsCollapsed?: boolean;
+  isCollapsed?: boolean;
+  onSizeChange?: (size: number) => void;
+  onCollapseChange?: (isCollapsed: boolean) => void;
+}
+interface UseResizableMultiConfig {
+  direction?: ResizableDirection;
+  containerRef?: Ref<HTMLElement | null>;
+  regions: Record<string, ResizableRegionConfig>;
+  autoSaveId?: string;
+}
+interface ResizableProps {
+  _size: number;
+  _isCollapsed: boolean;
+  _onResizeStart: () => void;
+  _onResizeMove: (delta: number) => void;
+  _onResizeEnd: () => void;
+  _onResizeCancel?: () => void;
+  _minSizePx: number;
+  _maxSizePx: number;
+  _snaps: number[];
+  _collapsedSize: number;
+  _collapsible: boolean;
+  _direction?: ResizableDirection;
+  _isResizableProps: true;
+}
+interface ResizableRegion {
+  size: number;
+  isCollapsed: boolean;
+  collapse: () => void;
+  expand: () => void;
+  resize: (size: number) => void;
+  props: ResizableProps;
+}
+declare function percent(value: number, options: {
+  min: PixelWidth;
+  max?: never;
+} | {
+  min?: never;
+  max: PixelWidth;
+}): ResizablePercentSize;
+declare function useResizable(options: UseResizableMultiConfig): Record<string, ResizableRegion>;
+declare function useResizable(options: UseResizableSingleOptions): ResizableRegion;
+type UseResizableOptions = UseResizableSingleOptions | UseResizableMultiConfig;
+type ResizableState = ResizableRegion;
+//#endregion
+export { ToolbarSlots as $, TablePanelPatch as A, TableSortEntry as B, TableFilterField as C, TableFilterVariant as D, TableFilterValue as E, TableRowProps as F, TableSelectionState as G, TableTextOverflow as H, TableSelectionToolbarProps as I, useTableSelection as J, UseTableSelectionConfig as K, TableSelectionToolbarSlots as L, TableProps as M, TableRowMenuItem as N, TableGroupPatch as O, TableRowPatch as P, ToolbarSize as Q, TableSlots as R, TableDividers as S, TableFilterState as T, TableVerticalAlign as U, TableSortState as V, TableSelectedKeysSetter as W, ToolbarOrientation as X, useTableSelectionState as Y, ToolbarProps as Z, TableCellProps as _, ResizableRegionConfig as a, TableColumnResizeContribution as b, UseResizableMultiConfig as c, percent as d, ToolbarVariant as et, useResizable as f, TableCellPatch as g, ProportionalWidth as h, ResizableRegion as i, TablePlugin as j, TableHeaderPatch as k, UseResizableOptions as l, PixelWidth as m, ResizablePercentSize as n, ResizableSize as o, ColumnWidth as p, UseTableSelectionStateConfig as q, ResizableProps as r, ResizableState as s, ResizableDirection as t, UseResizableSingleOptions as u, TableColumn as v, TableFilterFieldType as w, TableDensity as x, TableColumnAlign as y, TableSortDirection as z };

package/dist/useRestoreFocus-Djw9RUIf.js

@@ -0,0 +1,153 @@
+import { n as getFocusables } from "./focus-CpficIgf.js";
+import { onScopeDispose, ref, toValue, watch } from "vue";
+//#region src/composables/useFocusTrap.ts
+/**
+* 在容器内陷阱键盘焦点，按 Tab 时循环聚焦容器内的可聚焦元素。
+* 用于模态对话框、抽屉等需要限制焦点范围的浮层组件。
+*
+* 打开时把焦点送进容器，关闭或卸载时把焦点还给打开前聚焦的元素；
+* 焦点从没进过容器、或者已经被别处拿走时不还。
+*/
+function useFocusTrap(options = {}) {
+	const containerRef = options.container ?? ref(null);
+	/** 打开陷阱前聚焦的元素，关闭时还给它。 */
+	let previouslyFocused = null;
+	/** 焦点是否进过陷阱。没进过就不还焦点，免得抢走浮层触发器的焦点。 */
+	let hasFocusEntered = false;
+	function isActive() {
+		return toValue(options.isActive) ?? toValue(options.isEnabled) ?? false;
+	}
+	function isFocusInside() {
+		const el = containerRef.value;
+		if (el == null || typeof document === "undefined") return false;
+		const active = document.activeElement;
+		return active != null && el.contains(active);
+	}
+	function isTargetInside(event) {
+		const el = containerRef.value;
+		return el != null && event.target instanceof Node && el.contains(event.target);
+	}
+	function onKeyDown(event) {
+		if (!isActive()) return;
+		if (event.key === "Escape") {
+			if (options.onEscape != null && (isTargetInside(event) || isFocusInside())) options.onEscape();
+			return;
+		}
+		if (event.key !== "Tab") return;
+		const el = containerRef.value;
+		if (!el || !el.contains(event.target)) return;
+		const focusables = getFocusables(el);
+		if (focusables.length === 0) {
+			event.preventDefault();
+			return;
+		}
+		const first = focusables[0];
+		const last = focusables[focusables.length - 1];
+		const active = typeof document !== "undefined" ? document.activeElement : null;
+		if (event.shiftKey && active === first) {
+			event.preventDefault();
+			last.focus();
+		} else if (!event.shiftKey && active === last) {
+			event.preventDefault();
+			first.focus();
+		}
+	}
+	function onFocusIn() {
+		if (isFocusInside()) hasFocusEntered = true;
+	}
+	function update() {}
+	function focusFirst() {
+		const el = containerRef.value;
+		if (!el) return;
+		const focusables = getFocusables(el);
+		if (focusables.length > 0) focusables[0].focus();
+	}
+	function focusLast() {
+		const el = containerRef.value;
+		if (!el) return;
+		const focusables = getFocusables(el);
+		if (focusables.length > 0) focusables[focusables.length - 1].focus();
+	}
+	function activate() {
+		if (typeof document !== "undefined") {
+			const active = document.activeElement;
+			previouslyFocused = active instanceof HTMLElement && active !== document.body ? active : null;
+		}
+		hasFocusEntered = false;
+		setup();
+		const target = options.initialFocus?.();
+		if (target) target.focus();
+		else focusFirst();
+		if (isFocusInside()) hasFocusEntered = true;
+	}
+	function restoreFocus() {
+		const target = previouslyFocused;
+		const hasEntered = hasFocusEntered;
+		previouslyFocused = null;
+		hasFocusEntered = false;
+		if (target == null || !hasEntered || !target.isConnected) return;
+		const active = typeof document === "undefined" ? null : document.activeElement;
+		if (active != null && active !== document.body && !isFocusInside()) return;
+		target.focus();
+	}
+	function deactivate() {
+		teardown();
+		restoreFocus();
+	}
+	function setup() {
+		if (typeof document !== "undefined") {
+			document.addEventListener("keydown", onKeyDown, true);
+			document.addEventListener("focusin", onFocusIn, true);
+		}
+	}
+	function teardown() {
+		if (typeof document !== "undefined") {
+			document.removeEventListener("keydown", onKeyDown, true);
+			document.removeEventListener("focusin", onFocusIn, true);
+		}
+	}
+	watch(isActive, (enabled) => {
+		if (enabled) activate();
+		else deactivate();
+	}, { immediate: true });
+	onScopeDispose(deactivate);
+	return {
+		containerRef,
+		focusFirst,
+		focusLast,
+		update
+	};
+}
+//#endregion
+//#region src/composables/useRestoreFocus.ts
+/**
+* 在浮层组件打开时保存当前焦点元素，关闭时恢复焦点。
+* 用于对话框、抽屉、弹出菜单等浮层组件。
+*/
+function useRestoreFocus(options) {
+	const { isEnabled, shouldRestore } = options;
+	let savedElement = null;
+	function save() {
+		if (!isEnabled.value || typeof document === "undefined") return;
+		const active = document.activeElement;
+		if (active instanceof HTMLElement) savedElement = active;
+	}
+	function restore() {
+		if (!isEnabled.value || !savedElement) return;
+		if (savedElement.isConnected && !savedElement.hasAttribute("disabled")) savedElement.focus();
+		savedElement = null;
+	}
+	watch(shouldRestore, (should) => {
+		if (should) save();
+		else if (isEnabled.value && savedElement) restore();
+	});
+	onScopeDispose(() => {
+		savedElement = null;
+	});
+	return {
+		save,
+		restore
+	};
+}
+//#endregion
+export { useFocusTrap as n, useRestoreFocus as t };

package/dist/useScrollbars-C2NJ6Qwq.js

@@ -0,0 +1,43 @@
+import { inject, onScopeDispose, readonly, shallowRef, toValue, watch } from "vue";
+//#region src/Scrollbars/context.ts
+/**
+* 最近的 `ScrollbarsProvider` 提供的内容。
+*
+* 这个文件只能用 `import type` 引 overlayscrollbars。
+* 所有滚动组件都会引它，没有套 provider 的用户不应该因此把 overlayscrollbars 打进包。
+*/
+const scrollbarsKey = Symbol("astryx-scrollbars");
+//#endregion
+//#region src/Scrollbars/useScrollbars.ts
+/**
+* 给一个滚动容器挂上自绘滚动条。
+*
+* 外层没有 `ScrollbarsProvider` 时，或者在服务端渲染时，什么都不做，也不建任何 watcher。
+* 容器本身就是视口，所以容器的 overflow 怎么变，滚动条就怎么跟。
+*/
+function useScrollbars(target, options = {}) {
+	const ctx = inject(scrollbarsKey, null);
+	const active = shallowRef(false);
+	if (!ctx || typeof HTMLElement === "undefined") return { active: readonly(active) };
+	let handle = null;
+	function release() {
+		handle?.destroy();
+		handle = null;
+		active.value = false;
+	}
+	watch([() => toValue(target), () => ctx.enabled.value && (toValue(options.enabled) ?? true)], ([element, enabled]) => {
+		release();
+		if (enabled && element instanceof HTMLElement) {
+			handle = ctx.mount(element, ctx.options.value);
+			active.value = true;
+		}
+	}, {
+		immediate: true,
+		flush: "post"
+	});
+	watch(ctx.options, (next) => handle?.update(next), { deep: true });
+	onScopeDispose(release);
+	return { active: readonly(active) };
+}
+//#endregion
+export { scrollbarsKey as n, useScrollbars as t };

package/dist/{useTimeValue-DWk6oTAZ.js → useTimeValue-6ufHM15W.js}

@@ -103,7 +103,7 @@ function isTimeInRange(value, min, max) {
 }
 function resolveTimeSurface(options) {
 	const presentation = options.presentation ?? (options.nativePicker === "always" ? "native" : options.nativePicker === "never" ? "text-input" : "adaptive-native");
-	const needsTypedField = options.hasSeconds || options.increment !== 1;
+	const needsTypedField = options.hasSeconds || options.increment !== 1 || options.needsTypedField === true;
 	if (presentation === "text-input" || presentation === "popover" || presentation === "bottom-sheet") return "text";
 	if (needsTypedField) return "text";
 	if (presentation === "native") return "native";

package/dist/utils-D33VQDnk.js

@@ -0,0 +1,58 @@
+//#region src/AvatarGroup/context.ts
+const AvatarGroupContext = Symbol("AvatarGroupContext");
+//#endregion
+//#region src/Avatar/utils.ts
+function resolveSize(size) {
+	if (typeof size === "number") return size;
+	switch (size) {
+		case "xsm": return 20;
+		case "sm": return 24;
+		case "md": return 36;
+		case "lg": return 48;
+		case "xl": return 128;
+	}
+}
+/**
+* 按头像尺寸给出圆点尺寸。
+*
+* 用固定档位而不是等比缩放，是为了让每一档都落在整数像素上、看起来是刻意画的：
+*
+*   | 头像尺寸 | 圆点 | 边框 | 图标 | 线条 |
+*   |----------|------|------|------|------|
+*   | ≤ 36px   | 10px | 1px  | —    | 1px  |
+*   | 37–72px  | 20px | 2px  | 12px | 1.5px|
+*   | ≥ 73px   | 32px | 4px  | 18px | 2px  |
+*
+* 最小一档不画图标：10px 里塞图标看不清。自带的形状照画，所以任何尺寸下状态
+* 都能不靠颜色分辨。
+*/
+function resolveStatusDotMetrics(avatarSize) {
+	const metrics = (size, borderWidth, iconSize, stroke) => ({
+		size,
+		borderWidth,
+		iconSize,
+		field: size - borderWidth * 2,
+		stroke
+	});
+	if (avatarSize <= 36) return metrics(10, 1, 0, 1);
+	if (avatarSize <= 72) return metrics(20, 2, 12, 1.5);
+	return metrics(32, 4, 18, 2);
+}
+/** 把 `info` / `warning` 这类旧名字换成现在的语义变体。 */
+function resolveStatusDotVariant(variant) {
+	switch (variant) {
+		case "info": return "success";
+		case "warning": return "error";
+		default: return variant;
+	}
+}
+/**
+* 拼出头像的无障碍名称：名字和状态都有时按语言包的拼接文案拼
+* （英文「Jane Doe, Online」，中文「Jane Doe，在线」），否则取有的那一个。
+*/
+function composeAccessibleName(name, status, join) {
+	if (name && status) return join(name, status);
+	return name ?? status;
+}
+//#endregion
+export { AvatarGroupContext as a, resolveStatusDotVariant as i, resolveSize as n, resolveStatusDotMetrics as r, composeAccessibleName as t };

package/locales/SOURCE.json

@@ -1,7 +1,7 @@
 {
   "repository": "https://github.com/facebook/astryx",
   "path": "packages/core/locales",
-  "commit": "df75749470029f0b34680e13deac635f2d72c89d",
+  "commit": "fbc03f7b71eb093eb0283629dbc0820b12fb1710",
   "files": [
     "af-ZA.json",
     "ar-SA.json",