@mortenbrudvik/waveui 0.4.0 → 0.7.0

package/dist/components/table/useGridNavigation.mjs

@@ -0,0 +1,336 @@
+"use client";
+import { getArrowIntent as e, getDirection as t } from "../../lib/direction.mjs";
+import { FOCUSABLE_SELECTOR as n, getFirstTabbable as r, isFocusable as i } from "../../lib/focus.mjs";
+import * as a from "react";
+//#region src/components/table/useGridNavigation.ts
+var o = /* @__PURE__ */ new Set([
+	"checkbox",
+	"radio",
+	"button",
+	"submit",
+	"reset",
+	"image",
+	"file",
+	"color"
+]), s = /* @__PURE__ */ new Set([
+	"textbox",
+	"searchbox",
+	"combobox",
+	"spinbutton",
+	"slider"
+]), c = ["[data-roving-container]", ...[
+	"toolbar",
+	"radiogroup",
+	"listbox",
+	"grid",
+	"treegrid",
+	"tablist",
+	"menu",
+	"menubar",
+	"tree"
+].map((e) => `[role="${e}"]`)].join(", "), l = `${n}, ${c}`, u = [
+	"disabled",
+	"tabindex",
+	"hidden",
+	"inert",
+	"type",
+	"contenteditable",
+	"role",
+	"data-roving-container",
+	"aria-selected"
+];
+function d(e) {
+	let t = e.localName;
+	if (t === "textarea" || t === "select") return !0;
+	if (t === "input") return !o.has(e.type);
+	let n = e.getAttribute("contenteditable");
+	if (n !== null && n !== "false") return !0;
+	let r = e.getAttribute("role");
+	return r !== null && s.has(r);
+}
+function f(e) {
+	return e.matches(c);
+}
+function p(e, t) {
+	if (e === t) return !1;
+	for (let n = e.parentElement; n && n !== t; n = n.parentElement) if (f(n)) return !0;
+	return !1;
+}
+function m(e) {
+	let t = e.querySelector("[tabindex=\"0\"]");
+	return t && i(t) ? t : r(e, { includeContainer: !0 });
+}
+function h(e) {
+	return e.localName === "input" && e.type === "hidden" || e.matches(":disabled") ? !1 : e.closest("[hidden], [inert]") === null;
+}
+function g(e) {
+	if (!e.name) return !1;
+	let t = e.getRootNode();
+	if (typeof t.querySelectorAll != "function") return !1;
+	let n = t.querySelectorAll("input[type=\"radio\"]:checked");
+	for (let t of Array.from(n)) if (t !== e && t.name === e.name && t.form === e.form) return !0;
+	return !1;
+}
+function _(e) {
+	return e.localName === "td" || e.localName === "th";
+}
+function v(e) {
+	return e.getRootNode().activeElement === e;
+}
+function y(e, t) {
+	let n = t instanceof Element ? t : null;
+	for (; n && n !== e;) {
+		if (_(n) && n.closest("table") === e) return n;
+		n = n.parentElement;
+	}
+	return null;
+}
+function b(e) {
+	return Array.from(e.rows).filter((e) => e.cells.length > 0 && !e.hidden);
+}
+var x = 1e3;
+function S(e) {
+	let t = new Map(e.map((e, t) => [e, t])), n = e.map(() => []), r = (e, t, r, i) => {
+		for (let a = 0; a < r; a += 1) n[e][t + a] = i;
+	};
+	return e.forEach((e, i) => {
+		let a = n[i], o = 0;
+		for (let n of Array.from(e.cells)) {
+			for (; a[o];) o += 1;
+			let s = Math.min(Math.max(n.colSpan, 1), x);
+			r(i, o, s, n);
+			let c = n.rowSpan === 0 ? Infinity : n.rowSpan - 1;
+			for (let i = e.nextElementSibling; i && c > 0; i = i.nextElementSibling) {
+				if (i.localName !== "tr") continue;
+				--c;
+				let e = t.get(i);
+				e !== void 0 && r(e, o, s, n);
+			}
+			o += s;
+		}
+	}), n;
+}
+function C(e, t) {
+	for (let n = Math.min(t, e.length - 1); n >= 0; --n) {
+		let t = e[n];
+		if (t) return t;
+	}
+	return null;
+}
+function w(e, t, n) {
+	if (t instanceof Element) {
+		_(t) && t.closest("table") === e && n.add(t);
+		for (let r of Array.from(t.querySelectorAll("td, th"))) r.closest("table") === e && n.add(r);
+	}
+}
+function T(n = {}) {
+	let r = Math.max(1, n.pageSize ?? 10), [o, s] = a.useState(null), c = a.useRef(null), x = a.useRef(null), [T] = a.useState(() => /* @__PURE__ */ new WeakSet()), [E] = a.useState(() => /* @__PURE__ */ new WeakMap()), [D] = a.useState(() => /* @__PURE__ */ new WeakSet()), O = a.useRef(r);
+	a.useLayoutEffect(() => {
+		O.current = r;
+	}, [r]);
+	let k = a.useCallback((e, t) => {
+		let n = [], r = null;
+		for (let a of Array.from(e.querySelectorAll(l))) {
+			if (r && r.contains(a)) continue;
+			if (f(a)) {
+				r = a, (t ? m(a) !== null : h(a)) && n.push({
+					element: a,
+					composite: !0
+				});
+				continue;
+			}
+			let e = a.getAttribute("tabindex");
+			e !== null && Number(e) < 0 && !T.has(a) || (t ? i(a) : h(a)) && n.push({
+				element: a,
+				composite: !1
+			});
+		}
+		return n;
+	}, [T]), A = a.useCallback((e, t, n) => {
+		if (t.length !== 1) return e;
+		let [{ element: r, composite: i }] = t;
+		return i || d(r) || n && r instanceof HTMLInputElement && r.type === "radio" && !r.checked && g(r) ? e : r;
+	}, []), j = a.useCallback((e, t) => {
+		let n = String(t);
+		e.getAttribute("tabindex") !== n && (E.set(e, n), e.setAttribute("tabindex", n)), T.add(e);
+	}, [T, E]), M = a.useCallback((e, t, n) => {
+		let r = k(e, t);
+		if (n) {
+			D.delete(e), j(e, -1);
+			for (let e of r) e.composite || j(e.element, 0);
+			return;
+		}
+		let i = A(e, r, t), a = !1;
+		i === e ? (D.delete(e), j(e, t ? 0 : -1)) : T.has(e) && v(e) ? (a = !0, D.add(e), j(e, t ? 0 : -1)) : T.has(e) && (D.delete(e), T.delete(e), e.hasAttribute("tabindex") && (E.set(e, null), e.removeAttribute("tabindex")));
+		for (let e of r) {
+			if (e.composite) continue;
+			let n = e.element === i && t && !a;
+			j(e.element, n ? 0 : -1);
+		}
+	}, [
+		A,
+		k,
+		D,
+		j,
+		T,
+		E
+	]), N = a.useCallback((e, t) => {
+		let n = b(e), r = c.current, i = /* @__PURE__ */ new Set();
+		if ((!r || !r.isConnected || !n.includes(r.parentElement)) && (r = n[0]?.cells[0] ?? null, c.current = r, r && i.add(r)), x.current !== null && x.current !== r) {
+			let e = x.current;
+			x.current = null, i.add(e);
+		}
+		let a = x.current;
+		if (t === void 0) for (let e of n) for (let t of Array.from(e.cells)) i.add(t);
+		else for (let e of t) e && i.add(e);
+		for (let t of i) t.isConnected && y(e, t) === t && M(t, t === r, t === a);
+	}, [M]);
+	a.useLayoutEffect(() => {
+		if (!o || (N(o), typeof MutationObserver > "u")) return;
+		let e = new MutationObserver((e) => {
+			let t = !1, n = !1, r = /* @__PURE__ */ new Set();
+			for (let i of e) {
+				let e = i.target;
+				if (!(e instanceof Element) || p(e, o)) continue;
+				if (i.type === "attributes") {
+					if (i.attributeName === "tabindex" && E.has(e) && E.get(e) === e.getAttribute("tabindex")) continue;
+					t = !0;
+					let a = y(o, e);
+					a ? r.add(a) : e.localName === "tr" ? w(o, e, r) : n = !0;
+					continue;
+				}
+				t = !0;
+				let a = y(o, e);
+				if (a) {
+					r.add(a);
+					continue;
+				}
+				for (let e of Array.from(i.addedNodes)) w(o, e, r);
+			}
+			t && (c.current && r.add(c.current), N(o, n ? void 0 : r));
+		});
+		return e.observe(o, {
+			childList: !0,
+			subtree: !0,
+			attributes: !0,
+			attributeFilter: u
+		}), () => e.disconnect();
+	}, [
+		o,
+		N,
+		E
+	]);
+	let P = a.useCallback((e, t, n) => {
+		let r = c.current, i = x.current;
+		c.current = t, x.current = n ? t : null, N(e, [
+			r,
+			i,
+			t
+		]);
+	}, [N]), F = a.useCallback((e, t) => {
+		P(e, t, !1), A(t, k(t, !0), !0).focus();
+	}, [
+		P,
+		A,
+		k
+	]), I = a.useCallback((n) => {
+		let r = n.currentTarget;
+		if (n.defaultPrevented) return;
+		let i = y(r, n.target);
+		if (!i) return;
+		let a = k(i, !0), o = A(i, a, !1), s = n.target === i;
+		if (!s && n.target !== o) {
+			n.key === "Escape" && (n.preventDefault(), F(r, i));
+			return;
+		}
+		if (n.altKey || n.metaKey) return;
+		if ((n.key === "Enter" || n.key === "F2") && s) {
+			let e = null;
+			for (let t of a) if (e = t.composite ? m(t.element) : t.element, e) break;
+			if (!e) return;
+			n.preventDefault(), P(r, i, !0), e.focus();
+			return;
+		}
+		let c = b(r), l = c.findIndex((e) => e === i.parentElement);
+		if (l < 0) return;
+		let u = Array.from(c[l].cells).indexOf(i), d = c.length - 1, f = n.ctrlKey, p = null, h = null;
+		switch (n.key) {
+			case "ArrowLeft":
+			case "ArrowRight":
+				if (f) break;
+				p = [l, u + (e(n.key, {
+					orientation: "horizontal",
+					dir: t(r)
+				}) === "next" ? 1 : -1)];
+				break;
+			case "ArrowDown":
+				f || (h = [l + 1, 1]);
+				break;
+			case "ArrowUp":
+				f || (h = [l - 1, -1]);
+				break;
+			case "Home":
+				p = f ? [0, 0] : [l, 0];
+				break;
+			case "End":
+				p = f ? [d, Infinity] : [l, Infinity];
+				break;
+			case "PageDown":
+				f || (h = [Math.min(l + O.current, d), 1]);
+				break;
+			case "PageUp": f || (h = [Math.max(l - O.current, 0), -1]);
+		}
+		if (!p && !h) return;
+		n.preventDefault();
+		let g = null;
+		if (h) {
+			let e = S(c), t = Math.max(e[l].indexOf(i), 0);
+			for (let n = h[0]; n >= 0 && n <= d; n += h[1]) {
+				let r = C(e[n], t);
+				if (r && r !== i) {
+					g = r;
+					break;
+				}
+			}
+		} else if (p) {
+			let [e, t] = p, n = c[e].cells;
+			g = t === Infinity ? n[n.length - 1] : n.item(t);
+		}
+		g && g !== i && F(r, g);
+	}, [
+		P,
+		F,
+		A,
+		k
+	]), L = a.useCallback((e) => {
+		let t = e.currentTarget, n = e.target, r = y(t, n);
+		if (!r) return;
+		let i = n !== r && n !== A(r, k(r, !0), !1);
+		P(t, r, i);
+	}, [
+		P,
+		A,
+		k
+	]), R = a.useCallback((e) => {
+		let t = e.currentTarget, n = e.target, r = [];
+		n instanceof Element && _(n) && D.has(n) && r.push(n);
+		let i = e.relatedTarget, a = x.current;
+		a !== null && !(i instanceof Node && t.contains(i)) && (x.current = null, r.push(a)), r.length > 0 && N(t, r);
+	}, [D, N]);
+	return {
+		gridRef: s,
+		gridProps: a.useMemo(() => ({
+			onKeyDown: I,
+			onFocus: L,
+			onBlur: R
+		}), [
+			R,
+			L,
+			I
+		])
+	};
+}
+//#endregion
+export { d as isTextEntryElement, T as useGridNavigation };
+
+//# sourceMappingURL=useGridNavigation.mjs.map

package/dist/components/table/useGridNavigation.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGridNavigation.mjs","names":["React","NON_TEXT_INPUT_TYPES","KEY_CONSUMING_ROLES","COMPOSITE_SELECTOR","role","WIDGET_CANDIDATE_SELECTOR","FOCUSABLE_SELECTOR","OBSERVED_ATTRIBUTES","isTextEntryElement","tag","el","editable","isNestedComposite","isInsideNestedComposite","node","grid","getCompositeEntry","stop","composite","isFocusable","getFirstTabbable","isLikelyFocusable","hasCheckedPeer","radio","root","checked","other","isCellElement","isFocused","getCell","getRows","row","MAX_COL_SPAN","getColumnMap","indexOf","rows","index","map","cover","offset","colSpan","rowIndex","column","cell","own","remaining","next","covered","getCellAtColumn","rowMap","collectCells","into","useGridNavigation","pageSize","options","setGrid","activeCellRef","interactionCellRef","stamped","written","retained","pageSizeRef","getWidgets","widgets","precise","tabIndex","getTarget","element","checkRadioGroup","setTabIndex","value","syncCell","isActive","isInteraction","widget","target","keepCell","isStop","sync","table","active","targets","previous","interaction","cells","observer","relevant","all","dirty","record","records","activate","previousActive","previousInteraction","focusCell","onKeyDown","event","widgetTarget","onCell","entry","columnIndex","lastRow","ctrl","vertical","getArrowIntent","getDirection","destination","columns","candidate","nextRow","nextColumn","rowCells","onFocus","onBlur","left"],"sources":["../../../src/components/table/useGridNavigation.ts"],"sourcesContent":["import * as React from 'react';\nimport { getArrowIntent, getDirection } from '../../lib/direction';\nimport { FOCUSABLE_SELECTOR, getFirstTabbable, isFocusable } from '../../lib/focus';\n\n/** Options of {@link useGridNavigation}. */\nexport interface UseGridNavigationOptions {\n  /**\n   * How many rows PageUp and PageDown move focus.\n   * @default 10\n   */\n  pageSize?: number;\n}\n\n/** Handlers {@link useGridNavigation} needs on the grid element (compose them with the consumer's). */\nexport interface GridNavigationHandlers {\n  onKeyDown: React.KeyboardEventHandler<HTMLTableElement>;\n  onFocus: React.FocusEventHandler<HTMLTableElement>;\n  onBlur: React.FocusEventHandler<HTMLTableElement>;\n}\n\n/** Result of {@link useGridNavigation}. */\nexport interface UseGridNavigationResult {\n  /** Callback ref for the `<table role=\"grid\">` element. Stable identity. */\n  gridRef: React.RefCallback<HTMLTableElement>;\n  /** Keyboard and focus handlers for the grid element. Stable identities. */\n  gridProps: GridNavigationHandlers;\n}\n\n/** Input types that do not take arrow or character keys, so a lone one can be a cell's focus target. */\nconst NON_TEXT_INPUT_TYPES: ReadonlySet<string> = new Set([\n  'checkbox',\n  'radio',\n  'button',\n  'submit',\n  'reset',\n  'image',\n  'file',\n  'color',\n]);\n\n/** Widget roles that use arrow or character keys themselves (treated like text entry). */\nconst KEY_CONSUMING_ROLES: ReadonlySet<string> = new Set([\n  'textbox',\n  'searchbox',\n  'combobox',\n  'spinbutton',\n  'slider',\n]);\n\n/**\n * Roles of composite widgets that manage their own children (and usually their tab indexes): an\n * element with one of them, or with `data-roving-container`, is a nested composite. Close to the\n * list of `useRovingTabIndex`, which is kept separately and differs on purpose: here a `toolbar`\n * is a composite (a toolbar in a cell is one widget), while `spinbutton` is not (it is one\n * focusable control that uses the arrow keys, handled by `KEY_CONSUMING_ROLES` like a text\n * field). Keep both lists in mind when adding a role.\n */\nconst COMPOSITE_ROLES: readonly string[] = [\n  'toolbar',\n  'radiogroup',\n  'listbox',\n  'grid',\n  'treegrid',\n  'tablist',\n  'menu',\n  'menubar',\n  'tree',\n];\n\nconst COMPOSITE_SELECTOR = [\n  '[data-roving-container]',\n  ...COMPOSITE_ROLES.map((role) => `[role=\"${role}\"]`),\n].join(', ');\n\n/** Every element that can be a cell widget: a focusable element or a nested composite root. */\nconst WIDGET_CANDIDATE_SELECTOR = `${FOCUSABLE_SELECTOR}, ${COMPOSITE_SELECTOR}`;\n\n/**\n * Attributes whose changes can change a cell's widgets or the grid's rows. `aria-selected` on a row\n * signals a selection change, which can change the active cell's target (radio groups).\n */\nconst OBSERVED_ATTRIBUTES = [\n  'disabled',\n  'tabindex',\n  'hidden',\n  'inert',\n  'type',\n  'contenteditable',\n  'role',\n  'data-roving-container',\n  'aria-selected',\n];\n\n/**\n * Whether `el` is a text-entry control (or another widget that uses arrow keys itself): a text-like\n * `input`, `textarea`, `select`, a `contenteditable` element, or an element with role textbox,\n * searchbox, combobox, spinbutton or slider. Such widgets are never a cell's navigation target: the\n * cell takes focus and Enter/F2 moves into the widget, so the arrow keys keep moving the caret.\n */\nexport function isTextEntryElement(el: Element): boolean {\n  const tag = el.localName;\n  if (tag === 'textarea' || tag === 'select') return true;\n  if (tag === 'input') return !NON_TEXT_INPUT_TYPES.has((el as HTMLInputElement).type);\n  const editable = el.getAttribute('contenteditable');\n  if (editable !== null && editable !== 'false') return true;\n  const role = el.getAttribute('role');\n  return role !== null && KEY_CONSUMING_ROLES.has(role);\n}\n\n/** Whether `el` is a nested composite widget (own roving container or a composite role). */\nfunction isNestedComposite(el: Element): boolean {\n  return el.matches(COMPOSITE_SELECTOR);\n}\n\n/** Whether `node` is strictly inside a nested composite of `grid` (the composite root excluded). */\nfunction isInsideNestedComposite(node: Element, grid: HTMLTableElement): boolean {\n  if (node === grid) return false;\n  for (let el = node.parentElement; el && el !== grid; el = el.parentElement) {\n    if (isNestedComposite(el)) return true;\n  }\n  return false;\n}\n\n/**\n * The element a nested composite is entered at: its own tab stop (`tabindex=\"0\"`), else its first\n * tabbable element (the root itself when it is the focusable element).\n */\nfunction getCompositeEntry(composite: HTMLElement): HTMLElement | null {\n  const stop = composite.querySelector<HTMLElement>('[tabindex=\"0\"]');\n  if (stop && isFocusable(stop)) return stop;\n  return getFirstTabbable(composite, { includeContainer: true });\n}\n\n/**\n * A cheap focusability check for cells that do not hold the tab stop: no style reads, only the\n * attributes that take an element out of the focus order. The cell that holds (or receives) the tab\n * stop is checked precisely with `isFocusable`.\n */\nfunction isLikelyFocusable(el: HTMLElement): boolean {\n  if (el.localName === 'input' && (el as HTMLInputElement).type === 'hidden') return false;\n  if (el.matches(':disabled')) return false;\n  return el.closest('[hidden], [inert]') === null;\n}\n\n/** Whether another radio of `radio`'s named group is checked (the browser's tab stop of the group). */\nfunction hasCheckedPeer(radio: HTMLInputElement): boolean {\n  if (!radio.name) return false;\n  const root = radio.getRootNode() as Document | ShadowRoot;\n  if (typeof root.querySelectorAll !== 'function') return false;\n  const checked = root.querySelectorAll<HTMLInputElement>('input[type=\"radio\"]:checked');\n  for (const other of Array.from(checked)) {\n    if (other !== radio && other.name === radio.name && other.form === radio.form) return true;\n  }\n  return false;\n}\n\nfunction isCellElement(el: Element): el is HTMLTableCellElement {\n  return el.localName === 'td' || el.localName === 'th';\n}\n\n/** Whether `el` is the focused element of its document (or shadow root). */\nfunction isFocused(el: Element): boolean {\n  return (el.getRootNode() as Partial<DocumentOrShadowRoot>).activeElement === el;\n}\n\n/** The cell of `grid` that contains `node` (a nested table's cells belong to the outer cell). */\nfunction getCell(grid: HTMLTableElement, node: EventTarget | null): HTMLTableCellElement | null {\n  let el: Element | null = node instanceof Element ? node : null;\n  while (el && el !== grid) {\n    if (isCellElement(el) && el.closest('table') === grid) return el;\n    el = el.parentElement;\n  }\n  return null;\n}\n\n/** The rows of `grid` (header, body and footer rows; a nested table's rows are not included). */\nfunction getRows(grid: HTMLTableElement): HTMLTableRowElement[] {\n  return Array.from(grid.rows).filter((row) => row.cells.length > 0 && !row.hidden);\n}\n\n/** Browsers clamp `colSpan` to 1..1000 (`rowSpan` 0 covers the rest of its row group). */\nconst MAX_COL_SPAN = 1000;\n\n/** Per row, the cell covering each visual column (see {@link getColumnMap}). */\ntype ColumnMap = ReadonlyArray<ReadonlyArray<HTMLTableCellElement | undefined>>;\n\n/**\n * The HTML table model of `rows`: per row, the cell covering each visual column, with `colSpan` and\n * `rowSpan` counted. A row span covers the next rows of its row group in the DOM (a hidden row\n * counts, but gets no entry). A column no cell covers is empty. O(number of cells).\n */\nfunction getColumnMap(rows: readonly HTMLTableRowElement[]): ColumnMap {\n  const indexOf = new Map<Element, number>(rows.map((row, index) => [row, index]));\n  const map: Array<Array<HTMLTableCellElement | undefined>> = rows.map(() => []);\n  const cover = (rowIndex: number, column: number, colSpan: number, cell: HTMLTableCellElement) => {\n    for (let offset = 0; offset < colSpan; offset += 1) map[rowIndex][column + offset] = cell;\n  };\n  rows.forEach((row, rowIndex) => {\n    const own = map[rowIndex];\n    let column = 0;\n    for (const cell of Array.from(row.cells)) {\n      while (own[column]) column += 1;\n      const colSpan = Math.min(Math.max(cell.colSpan, 1), MAX_COL_SPAN);\n      cover(rowIndex, column, colSpan, cell);\n      let remaining = cell.rowSpan === 0 ? Infinity : cell.rowSpan - 1;\n      for (\n        let next = row.nextElementSibling;\n        next && remaining > 0;\n        next = next.nextElementSibling\n      ) {\n        if (next.localName !== 'tr') continue;\n        remaining -= 1;\n        const covered = indexOf.get(next);\n        if (covered !== undefined) cover(covered, column, colSpan, cell);\n      }\n      column += colSpan;\n    }\n  });\n  return map;\n}\n\n/** The cell of a row (as {@link getColumnMap} maps it) at `column`, else the last one before it. */\nfunction getCellAtColumn(\n  rowMap: ReadonlyArray<HTMLTableCellElement | undefined>,\n  column: number,\n): HTMLTableCellElement | null {\n  for (let index = Math.min(column, rowMap.length - 1); index >= 0; index -= 1) {\n    const cell = rowMap[index];\n    if (cell) return cell;\n  }\n  return null;\n}\n\n/** The grid cells in `node` (itself, or its descendants that belong to `grid`). */\nfunction collectCells(grid: HTMLTableElement, node: Node, into: Set<HTMLTableCellElement>): void {\n  if (!(node instanceof Element)) return;\n  if (isCellElement(node) && node.closest('table') === grid) into.add(node);\n  for (const el of Array.from(node.querySelectorAll<HTMLTableCellElement>('td, th'))) {\n    if (el.closest('table') === grid) into.add(el);\n  }\n}\n\n/** A widget of a cell: a focusable element, or a nested composite counted as one widget. */\ninterface CellWidget {\n  /** The focusable element, or the nested composite's root. */\n  element: HTMLElement;\n  /** A nested composite: the grid never writes `tabindex` on or inside it. */\n  composite: boolean;\n}\n\n/**\n * Grid keyboard model of the APG Grid pattern for a `<table role=\"grid\">` (DataGrid).\n *\n * - **One tab stop.** Exactly one cell of the grid is in the tab order (initially the first cell).\n *   Its focus target is its only focusable widget when that widget is not a text-entry control\n *   (a checkbox, a sort button, a link); otherwise — no widget, several widgets, a text-entry\n *   control or a nested composite — the cell itself. An unchecked radio whose named group has a\n *   checked radio is not a target either (browsers skip it in the Tab order), so its cell is.\n *   Every other cell and every widget inside a cell gets `tabindex=\"-1\"`. Rows are never focusable.\n *   When a widget becomes the target of the focused cell (Space on the cell checks its radio), the\n *   cell keeps focus and the tab stop (removing its `tabindex` would blur it) while its target stays\n *   at `tabindex=\"-1\"`; the target takes the tab stop once the cell is blurred.\n * - **Navigation mode** (focus on a cell or on its target widget): ArrowLeft/ArrowRight (the\n *   previous/next cell of the row, mirrored in RTL), ArrowUp/ArrowDown, Home/End (first/last cell\n *   of the row), Ctrl+Home/Ctrl+End (first cell of the grid / last cell of the last row) and\n *   PageUp/PageDown ({@link UseGridNavigationOptions.pageSize} rows) move focus between cells.\n *   ArrowUp/ArrowDown and PageUp/PageDown keep the visual column (`colSpan` and `rowSpan` counted,\n *   so a grouped header works), clamped to a shorter row. Space and Enter on a target widget reach\n *   the widget.\n * - **Interaction mode**: Enter or F2 on a cell that is its own target moves focus into its first\n *   widget; clicking a widget that is not the cell's target (a text input) enters it too. The\n *   grid keys are then ignored, so the arrow keys move the caret, and Tab moves between the cell's\n *   widgets. Escape returns focus to the cell. Leaving the grid ends interaction mode.\n * - **Nested composites** (an element with `data-roving-container` or role toolbar, radiogroup,\n *   listbox, grid, treegrid, tablist, menu, menubar or tree) count as one widget that uses the arrow\n *   keys: its cell takes focus, and Enter/F2 enters the composite at its own tab stop. The grid never\n *   writes `tabindex` on or inside a composite (the composite manages its own), so a composite\n *   keeps its own Tab stop — the same documented limitation as `useRovingTabIndex`.\n *\n * Keys are ignored when the event's default was prevented (a widget that handled the key, a\n * consumer handler), or with Alt/Meta held. The tab indexes are written to the DOM (layout effect\n * plus a `MutationObserver`), so rows and widgets added later are covered without a re-render. Focus\n * moves re-sync only the cells involved, the observer only the cells that changed, and the grid's\n * own `tabindex` writes do not trigger a re-sync.\n *\n * Internal to the table package.\n */\nexport function useGridNavigation(options: UseGridNavigationOptions = {}): UseGridNavigationResult {\n  const pageSize = Math.max(1, options.pageSize ?? 10);\n  const [grid, setGrid] = React.useState<HTMLTableElement | null>(null);\n  /** The cell that holds the tab stop. */\n  const activeCellRef = React.useRef<HTMLTableCellElement | null>(null);\n  /** The cell whose widgets are being interacted with, or `null` (navigation mode). */\n  const interactionCellRef = React.useRef<HTMLTableCellElement | null>(null);\n  /** Elements whose `tabindex` this hook wrote. */\n  const [stamped] = React.useState(() => new WeakSet<Element>());\n  /** The `tabindex` value this hook last wrote per element (`null`: removed), to skip own records. */\n  const [written] = React.useState(() => new WeakMap<Element, string | null>());\n  /**\n   * Cells kept focusable (holding the tab stop, their target at -1) because they were focused when\n   * a widget became their target (a radio that got checked, a widget added): they lose the\n   * attribute once blurred.\n   */\n  const [retained] = React.useState(() => new WeakSet<Element>());\n  const pageSizeRef = React.useRef(pageSize);\n\n  React.useLayoutEffect(() => {\n    pageSizeRef.current = pageSize;\n  }, [pageSize]);\n\n  /**\n   * The widgets of `cell` in DOM order. `precise` checks focusability with `isFocusable` (style\n   * reads); otherwise only attributes are checked (cells that do not hold the tab stop).\n   */\n  const getWidgets = React.useCallback(\n    (cell: HTMLTableCellElement, precise: boolean): CellWidget[] => {\n      const widgets: CellWidget[] = [];\n      let composite: HTMLElement | null = null;\n      for (const el of Array.from(cell.querySelectorAll<HTMLElement>(WIDGET_CANDIDATE_SELECTOR))) {\n        // Descendants of a nested composite belong to it (candidates come in document order).\n        if (composite && composite.contains(el)) continue;\n        if (isNestedComposite(el)) {\n          composite = el;\n          const available = precise ? getCompositeEntry(el) !== null : isLikelyFocusable(el);\n          if (available) widgets.push({ element: el, composite: true });\n          continue;\n        }\n        const tabIndex = el.getAttribute('tabindex');\n        // An author tabindex=\"-1\" (not written by this hook) opts the element out.\n        if (tabIndex !== null && Number(tabIndex) < 0 && !stamped.has(el)) continue;\n        if (precise ? isFocusable(el) : isLikelyFocusable(el)) {\n          widgets.push({ element: el, composite: false });\n        }\n      }\n      return widgets;\n    },\n    [stamped],\n  );\n\n  /**\n   * The element of `cell` that takes focus in navigation mode. `checkRadioGroup` applies the radio\n   * group rule, which only decides where the tab stop goes (the cell that holds it); a focused\n   * lone radio is in navigation mode either way.\n   */\n  const getTarget = React.useCallback(\n    (cell: HTMLTableCellElement, widgets: CellWidget[], checkRadioGroup: boolean): HTMLElement => {\n      if (widgets.length !== 1) return cell;\n      const [{ element, composite }] = widgets;\n      if (composite || isTextEntryElement(element)) return cell;\n      if (\n        checkRadioGroup &&\n        element instanceof HTMLInputElement &&\n        element.type === 'radio' &&\n        !element.checked &&\n        hasCheckedPeer(element)\n      ) {\n        return cell;\n      }\n      return element;\n    },\n    [],\n  );\n\n  const setTabIndex = React.useCallback(\n    (el: HTMLElement, value: 0 | -1) => {\n      const next = String(value);\n      if (el.getAttribute('tabindex') !== next) {\n        written.set(el, next);\n        el.setAttribute('tabindex', next);\n      }\n      stamped.add(el);\n    },\n    [stamped, written],\n  );\n\n  /** Writes the tab indexes of one cell and its widgets (only attributes that change). */\n  const syncCell = React.useCallback(\n    (cell: HTMLTableCellElement, isActive: boolean, isInteraction: boolean) => {\n      const widgets = getWidgets(cell, isActive);\n      if (isInteraction) {\n        retained.delete(cell);\n        setTabIndex(cell, -1);\n        for (const widget of widgets) {\n          if (!widget.composite) setTabIndex(widget.element, 0);\n        }\n        return;\n      }\n      const target = getTarget(cell, widgets, isActive);\n      /** The focused cell stands in for its target until it is blurred (see below). */\n      let keepCell = false;\n      if (target === cell) {\n        retained.delete(cell);\n        setTabIndex(cell, isActive ? 0 : -1);\n      } else if (stamped.has(cell) && isFocused(cell)) {\n        // A widget became the focused cell's target (its radio got checked, a widget was added).\n        // Removing the tabindex of the focused element blurs it (browsers move focus to the body,\n        // which ends the grid session), so the cell stays focusable and stays the grid's position.\n        // It keeps the tab stop (`tabindex=\"0\"`, when active) and its target stays at -1: the grid\n        // still has exactly one Tab stop even if focus is lost without a focusout, and Tab and\n        // Shift+Tab from the cell leave the grid (nothing after or before it inside is tabbable).\n        // Once the cell is blurred, onBlur re-syncs it and the target takes the tab stop.\n        keepCell = true;\n        retained.add(cell);\n        setTabIndex(cell, isActive ? 0 : -1);\n      } else if (stamped.has(cell)) {\n        // The cell's widget is its target: the cell itself is not focusable.\n        retained.delete(cell);\n        stamped.delete(cell);\n        if (cell.hasAttribute('tabindex')) {\n          written.set(cell, null);\n          cell.removeAttribute('tabindex');\n        }\n      }\n      for (const widget of widgets) {\n        if (widget.composite) continue;\n        const isStop = widget.element === target && isActive && !keepCell;\n        setTabIndex(widget.element, isStop ? 0 : -1);\n      }\n    },\n    [getTarget, getWidgets, retained, setTabIndex, stamped, written],\n  );\n\n  /**\n   * Re-resolves the active cell (the first cell when it is gone) and syncs `cells` — every cell\n   * when omitted. A new active cell is always synced.\n   */\n  const sync = React.useCallback(\n    (table: HTMLTableElement, cells?: Iterable<HTMLTableCellElement | null>) => {\n      const rows = getRows(table);\n      let active = activeCellRef.current;\n      const targets = new Set<HTMLTableCellElement>();\n      if (\n        !active ||\n        !active.isConnected ||\n        !rows.includes(active.parentElement as HTMLTableRowElement)\n      ) {\n        active = rows[0]?.cells[0] ?? null;\n        activeCellRef.current = active;\n        if (active) targets.add(active);\n      }\n      if (interactionCellRef.current !== null && interactionCellRef.current !== active) {\n        const previous = interactionCellRef.current;\n        interactionCellRef.current = null;\n        targets.add(previous);\n      }\n      const interaction = interactionCellRef.current;\n\n      if (cells === undefined) {\n        for (const row of rows) for (const cell of Array.from(row.cells)) targets.add(cell);\n      } else {\n        for (const cell of cells) if (cell) targets.add(cell);\n      }\n      for (const cell of targets) {\n        if (!cell.isConnected || getCell(table, cell) !== cell) continue;\n        syncCell(cell, cell === active, cell === interaction);\n      }\n    },\n    [syncCell],\n  );\n\n  React.useLayoutEffect(() => {\n    if (!grid) return;\n    sync(grid);\n    if (typeof MutationObserver === 'undefined') return;\n    const observer = new MutationObserver((records) => {\n      let relevant = false;\n      let all = false;\n      const dirty = new Set<HTMLTableCellElement>();\n      for (const record of records) {\n        const target = record.target;\n        if (!(target instanceof Element)) continue;\n        // A nested composite manages its own items (and their tab indexes).\n        if (isInsideNestedComposite(target, grid)) continue;\n        if (record.type === 'attributes') {\n          // The record of one of our own writes.\n          if (\n            record.attributeName === 'tabindex' &&\n            written.has(target) &&\n            written.get(target) === target.getAttribute('tabindex')\n          ) {\n            continue;\n          }\n          relevant = true;\n          const cell = getCell(grid, target);\n          if (cell) dirty.add(cell);\n          else if (target.localName === 'tr') collectCells(grid, target, dirty);\n          else all = true;\n          continue;\n        }\n        relevant = true;\n        const cell = getCell(grid, target);\n        if (cell) {\n          dirty.add(cell);\n          continue;\n        }\n        // Rows, sections or cells added (removed ones need no sync; `sync` re-resolves the\n        // active cell when it went away).\n        for (const node of Array.from(record.addedNodes)) collectCells(grid, node, dirty);\n      }\n      if (!relevant) return;\n      // The active cell's target can depend on other cells (a radio group whose checked radio\n      // changed, reflected by the rows' `aria-selected`), so it is always re-checked.\n      if (activeCellRef.current) dirty.add(activeCellRef.current);\n      sync(grid, all ? undefined : dirty);\n    });\n    observer.observe(grid, {\n      childList: true,\n      subtree: true,\n      attributes: true,\n      attributeFilter: OBSERVED_ATTRIBUTES,\n    });\n    return () => observer.disconnect();\n  }, [grid, sync, written]);\n\n  /**\n   * Makes `cell` the active cell (in interaction mode when `interaction`) and re-syncs only the\n   * cells involved: the previous active and interaction cells and `cell`.\n   */\n  const activate = React.useCallback(\n    (table: HTMLTableElement, cell: HTMLTableCellElement, interaction: boolean) => {\n      const previousActive = activeCellRef.current;\n      const previousInteraction = interactionCellRef.current;\n      activeCellRef.current = cell;\n      interactionCellRef.current = interaction ? cell : null;\n      sync(table, [previousActive, previousInteraction, cell]);\n    },\n    [sync],\n  );\n\n  const focusCell = React.useCallback(\n    (table: HTMLTableElement, cell: HTMLTableCellElement) => {\n      activate(table, cell, false);\n      getTarget(cell, getWidgets(cell, true), true).focus();\n    },\n    [activate, getTarget, getWidgets],\n  );\n\n  const onKeyDown = React.useCallback<React.KeyboardEventHandler<HTMLTableElement>>(\n    (event) => {\n      const table = event.currentTarget;\n      if (event.defaultPrevented) return;\n      const cell = getCell(table, event.target);\n      if (!cell) return;\n      const widgets = getWidgets(cell, true);\n      // A lone non-text widget is in navigation mode when focused, even an unchecked radio that\n      // the radio group rule keeps from holding the tab stop.\n      const widgetTarget = getTarget(cell, widgets, false);\n      const onCell = event.target === cell;\n\n      if (!onCell && event.target !== widgetTarget) {\n        // Interaction mode: the widget keeps its keys; Escape returns to the cell.\n        if (event.key === 'Escape') {\n          event.preventDefault();\n          focusCell(table, cell);\n        }\n        return;\n      }\n      if (event.altKey || event.metaKey) return;\n\n      if ((event.key === 'Enter' || event.key === 'F2') && onCell) {\n        let entry: HTMLElement | null = null;\n        for (const widget of widgets) {\n          entry = widget.composite ? getCompositeEntry(widget.element) : widget.element;\n          if (entry) break;\n        }\n        if (!entry) return;\n        event.preventDefault();\n        activate(table, cell, true);\n        entry.focus();\n        return;\n      }\n\n      const rows = getRows(table);\n      const rowIndex = rows.findIndex((row) => row === cell.parentElement);\n      if (rowIndex < 0) return;\n      const columnIndex = Array.from(rows[rowIndex].cells).indexOf(cell);\n      const lastRow = rows.length - 1;\n      const ctrl = event.ctrlKey;\n      /** Left/Right, Home/End: target row and cell index in it (`Infinity`: the row's last cell). */\n      let next: [row: number, column: number] | null = null;\n      /** Up/Down, PageUp/PageDown: the first row to try and the direction to keep going in. */\n      let vertical: [row: number, step: 1 | -1] | null = null;\n\n      switch (event.key) {\n        case 'ArrowLeft':\n        case 'ArrowRight': {\n          if (ctrl) break;\n          const intent = getArrowIntent(event.key, {\n            orientation: 'horizontal',\n            dir: getDirection(table),\n          });\n          next = [rowIndex, columnIndex + (intent === 'next' ? 1 : -1)];\n          break;\n        }\n        case 'ArrowDown':\n          if (!ctrl) vertical = [rowIndex + 1, 1];\n          break;\n        case 'ArrowUp':\n          if (!ctrl) vertical = [rowIndex - 1, -1];\n          break;\n        case 'Home':\n          next = ctrl ? [0, 0] : [rowIndex, 0];\n          break;\n        case 'End':\n          next = ctrl ? [lastRow, Infinity] : [rowIndex, Infinity];\n          break;\n        case 'PageDown':\n          if (!ctrl) vertical = [Math.min(rowIndex + pageSizeRef.current, lastRow), 1];\n          break;\n        case 'PageUp':\n          if (!ctrl) vertical = [Math.max(rowIndex - pageSizeRef.current, 0), -1];\n          break;\n        default:\n          break;\n      }\n      if (!next && !vertical) return;\n      // A handled key never scrolls the page or reaches the widget, even at the grid's edge.\n      event.preventDefault();\n      let destination: HTMLTableCellElement | null = null;\n      if (vertical) {\n        // Up/Down keep the visual column (spans counted), clamped to a shorter row; the rows a\n        // row-spanning cell covers are skipped when moving away from it.\n        const columns = getColumnMap(rows);\n        const column = Math.max(columns[rowIndex].indexOf(cell), 0);\n        for (let row = vertical[0]; row >= 0 && row <= lastRow; row += vertical[1]) {\n          const candidate = getCellAtColumn(columns[row], column);\n          if (candidate && candidate !== cell) {\n            destination = candidate;\n            break;\n          }\n        }\n      } else if (next) {\n        // Left/Right stop at the row's edges (no cell there).\n        const [nextRow, nextColumn] = next;\n        const rowCells = rows[nextRow].cells;\n        destination =\n          nextColumn === Infinity ? rowCells[rowCells.length - 1] : rowCells.item(nextColumn);\n      }\n      if (destination && destination !== cell) focusCell(table, destination);\n    },\n    [activate, focusCell, getTarget, getWidgets],\n  );\n\n  const onFocus = React.useCallback<React.FocusEventHandler<HTMLTableElement>>(\n    (event) => {\n      const table = event.currentTarget;\n      // React types `target` as the handler's element type; it is the focused descendant.\n      const target: EventTarget = event.target;\n      const cell = getCell(table, target);\n      if (!cell) return;\n      const interaction =\n        target !== cell && target !== getTarget(cell, getWidgets(cell, true), false);\n      activate(table, cell, interaction);\n    },\n    [activate, getTarget, getWidgets],\n  );\n\n  const onBlur = React.useCallback<React.FocusEventHandler<HTMLTableElement>>(\n    (event) => {\n      const table = event.currentTarget;\n      // React types `target` as the handler's element type; it is the blurred descendant.\n      const left: EventTarget = event.target;\n      const cells: HTMLTableCellElement[] = [];\n      // A cell kept focusable while focused (see syncCell) is re-synced now that it is blurred\n      // (during focusout the blurred element is no longer the active element).\n      if (left instanceof Element && isCellElement(left) && retained.has(left)) cells.push(left);\n      const next = event.relatedTarget;\n      const interaction = interactionCellRef.current;\n      if (interaction !== null && !(next instanceof Node && table.contains(next))) {\n        interactionCellRef.current = null;\n        cells.push(interaction);\n      }\n      if (cells.length > 0) sync(table, cells);\n    },\n    [retained, sync],\n  );\n\n  const gridProps = React.useMemo<GridNavigationHandlers>(\n    () => ({ onKeyDown, onFocus, onBlur }),\n    [onBlur, onFocus, onKeyDown],\n  );\n\n  return { gridRef: setGrid, gridProps };\n}\n"],"mappings":"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"}

package/dist/components/typography/Text.cjs

@@ -0,0 +1,2 @@
+"use client";const e=require("../../_virtual/_rolldown/runtime.cjs"),t=require("../../lib/cn.cjs"),n=require("../../lib/dev.cjs");let r=require("react");r=e.__toESM(r,1);let i=require("react/jsx-runtime");var a={"caption-2":`text-caption-2`,"caption-1":`text-caption-1`,"body-1":`text-body-1`,"body-2":`text-body-2`,"subtitle-2":`text-subtitle-2`,"subtitle-1":`text-subtitle-1`,"title-3":`text-title-3`,"title-2":`text-title-2`,"title-1":`text-title-1`,"large-title":`text-large-title`,display:`text-display`},o={regular:`font-normal`,semibold:`font-semibold`,bold:`font-bold`},s={400:`regular`,600:`semibold`,700:`bold`},c=e=>{let{as:r,variant:c=`body-1`,weight:l,className:u,...d}=e,f;return typeof l==`number`?(f=Object.hasOwn(s,l)?s[l]:void 0,f&&n.warnDeprecated(`Text`,`weight={${l}}`,`weight="${f}"`)):l!==void 0&&Object.hasOwn(o,l)&&(f=l),(0,i.jsx)(r??`span`,{...d,className:t.cn(a[c],f&&o[f],u)})};c.displayName=`Text`,exports.Text=c;
+//# sourceMappingURL=Text.cjs.map

package/dist/components/typography/Text.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Text.cjs","names":["cn","require_runtime","require_cn","require_dev","react","react_jsx_runtime","variantClasses","weightClasses","numericWeights","Text","rest","props","resolvedWeight","weight","as","variant","className"],"sources":["../../../src/components/typography/Text.tsx"],"sourcesContent":["import * as React from 'react';\nimport { cn } from '../../lib/cn';\nimport { warnDeprecated } from '../../lib/dev';\nimport type { PolymorphicComponent, PolymorphicProps } from '../../lib/polymorphic';\nimport type { TextWeight, TypographyVariant } from '../../lib/types';\n\n/**\n * The Text's own props (the XOwnProps rule of `PolymorphicProps`: component-specific props only).\n * Every other prop comes from the rendered element (`as`, default `'span'`).\n */\nexport interface TextOwnProps {\n  /** Typography variant controlling font size and line height (the Wave type ramp).\n   * @default 'body-1'\n   */\n  variant?: TypographyVariant;\n  /**\n   * Font weight: `'regular'`, `'semibold'` or `'bold'`. Unset, the variant's own weight applies:\n   * semibold for `'subtitle-2'` and every larger variant (`'subtitle-1'`, the titles,\n   * `'large-title'`, `'display'`), inherited for the caption and body variants. Pass `'regular'`\n   * for a title at regular weight. The numeric 0.4 values `400`, `600` and `700` still work but\n   * are deprecated.\n   */\n  weight?: TextWeight | 400 | 600 | 700;\n}\n\n/**\n * The 0.4 numeric weights, kept as deprecated aliases of {@link TextWeight} (written out in\n * {@link TextOwnProps}, not a public name).\n */\ntype DeprecatedNumericWeight = Exclude<NonNullable<TextOwnProps['weight']>, TextWeight>;\n\n/**\n * Props of {@link Text} rendered as `C` (default `'span'`). `TextProps` without a type argument\n * is the 0.4 name: the props of a Text rendered as a `<span>`, including `ref`.\n */\nexport type TextProps<C extends React.ElementType = 'span'> = PolymorphicProps<C, TextOwnProps>;\n\n/** The props the implementation reads, for any `as`. */\ntype TextImplProps = TextOwnProps & {\n  as?: React.ElementType;\n  className?: string;\n};\n\nconst variantClasses: Record<TypographyVariant, string> = {\n  'caption-2': 'text-caption-2',\n  'caption-1': 'text-caption-1',\n  'body-1': 'text-body-1',\n  'body-2': 'text-body-2',\n  'subtitle-2': 'text-subtitle-2',\n  'subtitle-1': 'text-subtitle-1',\n  'title-3': 'text-title-3',\n  'title-2': 'text-title-2',\n  'title-1': 'text-title-1',\n  'large-title': 'text-large-title',\n  display: 'text-display',\n};\n\nconst weightClasses: Record<TextWeight, string> = {\n  regular: 'font-normal',\n  semibold: 'font-semibold',\n  bold: 'font-bold',\n};\n\nconst numericWeights: Record<DeprecatedNumericWeight, TextWeight> = {\n  400: 'regular',\n  600: 'semibold',\n  700: 'bold',\n};\n\n/**\n * Text in the Wave type ramp. Renders a `<span>` by default; `as` renders any element with\n * correctly typed props (`<Text as=\"h1\" variant=\"title-1\">`, `<Text as=\"label\" htmlFor=\"…\">`).\n *\n * Text sets no color: it inherits the surrounding color (the provider's foreground by default),\n * so it follows the theme. Add a color with `className` (`text-muted-foreground`); the variant\n * stays applied.\n *\n * @example\n * <Text as=\"h2\" variant=\"title-2\">Settings</Text>\n * <Text variant=\"body-1\" weight=\"semibold\">Unsaved changes</Text>\n * <Text variant=\"caption-1\" className=\"text-muted-foreground\">Last saved 2 minutes ago</Text>\n */\nexport const Text: PolymorphicComponent<'span', TextOwnProps> = (props) => {\n  const { as, variant = 'body-1', weight, className, ...rest } = props as TextImplProps;\n\n  let resolvedWeight: TextWeight | undefined;\n  if (typeof weight === 'number') {\n    resolvedWeight = Object.hasOwn(numericWeights, weight) ? numericWeights[weight] : undefined;\n    // Warn-once during render is the sanctioned alias pattern (C-DEV).\n    if (resolvedWeight) warnDeprecated('Text', `weight={${weight}}`, `weight=\"${resolvedWeight}\"`);\n  } else if (weight !== undefined && Object.hasOwn(weightClasses, weight)) {\n    resolvedWeight = weight;\n  }\n\n  const Component: React.ElementType = as ?? 'span';\n  return (\n    <Component\n      {...rest}\n      className={cn(\n        variantClasses[variant],\n        resolvedWeight && weightClasses[resolvedWeight],\n        className,\n      )}\n    />\n  );\n};\n\nText.displayName = 'Text';\n"],"mappings":"6MA2CA,IAAMM,EAAoD,CACxD,YAAa,iBACb,YAAa,iBACb,SAAU,cACV,SAAU,cACV,aAAc,kBACd,aAAc,kBACd,UAAW,eACX,UAAW,eACX,UAAW,eACX,cAAe,mBACf,QAAS,cACX,EAEMC,EAA4C,CAChD,QAAS,cACT,SAAU,gBACV,KAAM,WACR,EAEMC,EAA8D,CAClE,IAAK,UACL,IAAK,WACL,IAAK,MACP,EAeaC,EAAoD,GAAU,CACzE,GAAM,CAAE,KAAI,UAAU,SAAU,SAAQ,YAAW,GAAGC,GAASC,EAE3DC,EAUJ,OATI,OAAOC,GAAW,UACpB,EAAiB,OAAO,OAAOL,EAAgBK,CAAM,EAAIL,EAAeK,GAAU,IAAA,GAE9ED,GAAgBT,EAAA,eAAe,OAAQ,WAAWU,EAAO,GAAI,WAAWD,EAAe,EAAE,GACpFC,IAAW,IAAA,IAAa,OAAO,OAAON,EAAeM,CAAM,IACpE,EAAiBA,IAKjB,EAAAR,EAAA,IAAA,CAFmCS,GAAM,OAEzC,CACE,GAAIJ,EACJ,UAAWV,EAAAA,GACTM,EAAeS,GACfH,GAAkBL,EAAcK,GAChCI,CACF,CACD,CAAA,CAEL,EAEA,EAAK,YAAc"}

package/dist/components/typography/Text.mjs

@@ -0,0 +1,38 @@
+"use client";
+import { cn as e } from "../../lib/cn.mjs";
+import { warnDeprecated as t } from "../../lib/dev.mjs";
+import "react";
+import { jsx as n } from "react/jsx-runtime";
+//#region src/components/typography/Text.tsx
+var r = {
+	"caption-2": "text-caption-2",
+	"caption-1": "text-caption-1",
+	"body-1": "text-body-1",
+	"body-2": "text-body-2",
+	"subtitle-2": "text-subtitle-2",
+	"subtitle-1": "text-subtitle-1",
+	"title-3": "text-title-3",
+	"title-2": "text-title-2",
+	"title-1": "text-title-1",
+	"large-title": "text-large-title",
+	display: "text-display"
+}, i = {
+	regular: "font-normal",
+	semibold: "font-semibold",
+	bold: "font-bold"
+}, a = {
+	400: "regular",
+	600: "semibold",
+	700: "bold"
+}, o = (o) => {
+	let { as: s, variant: c = "body-1", weight: l, className: u, ...d } = o, f;
+	return typeof l == "number" ? (f = Object.hasOwn(a, l) ? a[l] : void 0, f && t("Text", `weight={${l}}`, `weight="${f}"`)) : l !== void 0 && Object.hasOwn(i, l) && (f = l), /* @__PURE__ */ n(s ?? "span", {
+		...d,
+		className: e(r[c], f && i[f], u)
+	});
+};
+o.displayName = "Text";
+//#endregion
+export { o as Text };
+
+//# sourceMappingURL=Text.mjs.map

package/dist/components/typography/Text.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Text.mjs","names":["variantClasses","weightClasses","numericWeights","Text","rest","props","resolvedWeight","weight","warnDeprecated","as","cn","variant","className"],"sources":["../../../src/components/typography/Text.tsx"],"sourcesContent":["import * as React from 'react';\nimport { cn } from '../../lib/cn';\nimport { warnDeprecated } from '../../lib/dev';\nimport type { PolymorphicComponent, PolymorphicProps } from '../../lib/polymorphic';\nimport type { TextWeight, TypographyVariant } from '../../lib/types';\n\n/**\n * The Text's own props (the XOwnProps rule of `PolymorphicProps`: component-specific props only).\n * Every other prop comes from the rendered element (`as`, default `'span'`).\n */\nexport interface TextOwnProps {\n  /** Typography variant controlling font size and line height (the Wave type ramp).\n   * @default 'body-1'\n   */\n  variant?: TypographyVariant;\n  /**\n   * Font weight: `'regular'`, `'semibold'` or `'bold'`. Unset, the variant's own weight applies:\n   * semibold for `'subtitle-2'` and every larger variant (`'subtitle-1'`, the titles,\n   * `'large-title'`, `'display'`), inherited for the caption and body variants. Pass `'regular'`\n   * for a title at regular weight. The numeric 0.4 values `400`, `600` and `700` still work but\n   * are deprecated.\n   */\n  weight?: TextWeight | 400 | 600 | 700;\n}\n\n/**\n * The 0.4 numeric weights, kept as deprecated aliases of {@link TextWeight} (written out in\n * {@link TextOwnProps}, not a public name).\n */\ntype DeprecatedNumericWeight = Exclude<NonNullable<TextOwnProps['weight']>, TextWeight>;\n\n/**\n * Props of {@link Text} rendered as `C` (default `'span'`). `TextProps` without a type argument\n * is the 0.4 name: the props of a Text rendered as a `<span>`, including `ref`.\n */\nexport type TextProps<C extends React.ElementType = 'span'> = PolymorphicProps<C, TextOwnProps>;\n\n/** The props the implementation reads, for any `as`. */\ntype TextImplProps = TextOwnProps & {\n  as?: React.ElementType;\n  className?: string;\n};\n\nconst variantClasses: Record<TypographyVariant, string> = {\n  'caption-2': 'text-caption-2',\n  'caption-1': 'text-caption-1',\n  'body-1': 'text-body-1',\n  'body-2': 'text-body-2',\n  'subtitle-2': 'text-subtitle-2',\n  'subtitle-1': 'text-subtitle-1',\n  'title-3': 'text-title-3',\n  'title-2': 'text-title-2',\n  'title-1': 'text-title-1',\n  'large-title': 'text-large-title',\n  display: 'text-display',\n};\n\nconst weightClasses: Record<TextWeight, string> = {\n  regular: 'font-normal',\n  semibold: 'font-semibold',\n  bold: 'font-bold',\n};\n\nconst numericWeights: Record<DeprecatedNumericWeight, TextWeight> = {\n  400: 'regular',\n  600: 'semibold',\n  700: 'bold',\n};\n\n/**\n * Text in the Wave type ramp. Renders a `<span>` by default; `as` renders any element with\n * correctly typed props (`<Text as=\"h1\" variant=\"title-1\">`, `<Text as=\"label\" htmlFor=\"…\">`).\n *\n * Text sets no color: it inherits the surrounding color (the provider's foreground by default),\n * so it follows the theme. Add a color with `className` (`text-muted-foreground`); the variant\n * stays applied.\n *\n * @example\n * <Text as=\"h2\" variant=\"title-2\">Settings</Text>\n * <Text variant=\"body-1\" weight=\"semibold\">Unsaved changes</Text>\n * <Text variant=\"caption-1\" className=\"text-muted-foreground\">Last saved 2 minutes ago</Text>\n */\nexport const Text: PolymorphicComponent<'span', TextOwnProps> = (props) => {\n  const { as, variant = 'body-1', weight, className, ...rest } = props as TextImplProps;\n\n  let resolvedWeight: TextWeight | undefined;\n  if (typeof weight === 'number') {\n    resolvedWeight = Object.hasOwn(numericWeights, weight) ? numericWeights[weight] : undefined;\n    // Warn-once during render is the sanctioned alias pattern (C-DEV).\n    if (resolvedWeight) warnDeprecated('Text', `weight={${weight}}`, `weight=\"${resolvedWeight}\"`);\n  } else if (weight !== undefined && Object.hasOwn(weightClasses, weight)) {\n    resolvedWeight = weight;\n  }\n\n  const Component: React.ElementType = as ?? 'span';\n  return (\n    <Component\n      {...rest}\n      className={cn(\n        variantClasses[variant],\n        resolvedWeight && weightClasses[resolvedWeight],\n        className,\n      )}\n    />\n  );\n};\n\nText.displayName = 'Text';\n"],"mappings":";;;;;;AA2CA,IAAMA,IAAoD;CACxD,aAAa;CACb,aAAa;CACb,UAAU;CACV,UAAU;CACV,cAAc;CACd,cAAc;CACd,WAAW;CACX,WAAW;CACX,WAAW;CACX,eAAe;CACf,SAAS;AACX,GAEMC,IAA4C;CAChD,SAAS;CACT,UAAU;CACV,MAAM;AACR,GAEMC,IAA8D;CAClE,KAAK;CACL,KAAK;CACL,KAAK;AACP,GAeaC,KAAoD,MAAU;CACzE,IAAM,EAAE,OAAI,aAAU,UAAU,WAAQ,cAAW,GAAGC,MAASC,GAE3DC;CAUJ,OATI,OAAOC,KAAW,YACpB,IAAiB,OAAO,OAAOL,GAAgBK,CAAM,IAAIL,EAAeK,KAAU,KAAA,GAE9ED,KAAgBE,EAAe,QAAQ,WAAWD,EAAO,IAAI,WAAWD,EAAe,EAAE,KACpFC,MAAW,KAAA,KAAa,OAAO,OAAON,GAAeM,CAAM,MACpE,IAAiBA,IAKjB,kBAFmCE,KAAM,QAEzC;EACE,GAAIL;EACJ,WAAWM,EACTV,EAAeW,IACfL,KAAkBL,EAAcK,IAChCM,CACF;CACD,CAAA;AAEL;AAEA,EAAK,cAAc"}

package/dist/hooks/useAnnounce.cjs

@@ -0,0 +1,2 @@
+"use client";const e=require("../lib/globalRegistry.cjs");let t=require("react");var n=[`polite`,`assertive`],r={position:`absolute`,width:`1px`,height:`1px`,padding:`0`,margin:`-1px`,overflow:`hidden`,clip:`rect(0, 0, 0, 0)`,whiteSpace:`nowrap`,border:`0`};function i(){return e.getGlobalRegistry(`announcer`,()=>({root:null,regions:null,users:0,settled:!1,queued:{},cancelFrame:null}))}function a(){return typeof document<`u`&&document.body!=null}function o(e){if(typeof requestAnimationFrame==`function`){let t=requestAnimationFrame(()=>e());return()=>cancelAnimationFrame(t)}let t=setTimeout(e,16);return()=>clearTimeout(t)}function s(e){e.cancelFrame||=o(()=>{e.cancelFrame=null,e.settled=!0;let t=e.regions,r=e.queued;if(e.queued={},t)for(let e of n){let n=r[e];n!==void 0&&(t[e].textContent=n)}})}function c(e){e.cancelFrame?.(),e.cancelFrame=null,e.root?.remove(),e.root=null,e.regions=null,e.settled=!1,e.queued={}}function l(e){if(e.root&&e.regions&&e.root.isConnected)return e.regions;c(e);let t=document.createElement(`div`);t.setAttribute(`data-wave-announcer`,``),Object.assign(t.style,r);let n=document.createElement(`div`);n.setAttribute(`role`,`status`),n.setAttribute(`aria-live`,`polite`),n.setAttribute(`aria-atomic`,`true`);let i=document.createElement(`div`);return i.setAttribute(`aria-live`,`assertive`),i.setAttribute(`aria-atomic`,`true`),t.append(n,i),document.body.appendChild(t),e.root=t,e.regions={polite:n,assertive:i},e.settled=!1,s(e),e.regions}function u(e,t=`polite`){if(!a())return;let n=i(),r=l(n)[t];if(!n.settled||n.queued[t]!==void 0){n.queued[t]=e;return}if(r.textContent===e){r.textContent=``,n.queued[t]=e,s(n);return}r.textContent=e}function d(){return(0,t.useEffect)(()=>{if(!a())return;let e=i();return e.users+=1,l(e),()=>{e.users=Math.max(0,e.users-1),e.users===0&&c(e)}},[]),u}exports.announce=u,exports.useAnnounce=d;
+//# sourceMappingURL=useAnnounce.cjs.map

package/dist/hooks/useAnnounce.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAnnounce.cjs","names":["getGlobalRegistry","require_globalRegistry","react","POLITENESS","VISUALLY_HIDDEN","getState","canUseDom","requestFrame","handle","callback","scheduleFlush","state","regions","queued","politeness","message","removeRegions","ensureRegions","root","polite","assertive","announce","region","useAnnounce"],"sources":["../../src/hooks/useAnnounce.ts"],"sourcesContent":["import { useEffect } from 'react';\nimport { getGlobalRegistry } from '../lib/globalRegistry';\n\n/** How urgently assistive technology should read a message. */\nexport type Politeness = 'polite' | 'assertive';\n\ninterface AnnouncerState {\n  root: HTMLElement | null;\n  regions: Record<Politeness, HTMLElement> | null;\n  /** Number of mounted `useAnnounce` callers. */\n  users: number;\n  /** `false` until one frame has passed since the regions were created. */\n  settled: boolean;\n  queued: Partial<Record<Politeness, string>>;\n  cancelFrame: (() => void) | null;\n}\n\nconst POLITENESS: readonly Politeness[] = ['polite', 'assertive'];\n\nconst VISUALLY_HIDDEN: Partial<CSSStyleDeclaration> = {\n  position: 'absolute',\n  width: '1px',\n  height: '1px',\n  padding: '0',\n  margin: '-1px',\n  overflow: 'hidden',\n  clip: 'rect(0, 0, 0, 0)',\n  whiteSpace: 'nowrap',\n  border: '0',\n};\n\nfunction getState(): AnnouncerState {\n  return getGlobalRegistry<AnnouncerState>('announcer', () => ({\n    root: null,\n    regions: null,\n    users: 0,\n    settled: false,\n    queued: {},\n    cancelFrame: null,\n  }));\n}\n\nfunction canUseDom(): boolean {\n  return typeof document !== 'undefined' && document.body != null;\n}\n\nfunction requestFrame(callback: () => void): () => void {\n  if (typeof requestAnimationFrame === 'function') {\n    const handle = requestAnimationFrame(() => callback());\n    return () => cancelAnimationFrame(handle);\n  }\n  const handle = setTimeout(callback, 16);\n  return () => clearTimeout(handle);\n}\n\nfunction scheduleFlush(state: AnnouncerState): void {\n  if (state.cancelFrame) return;\n  state.cancelFrame = requestFrame(() => {\n    state.cancelFrame = null;\n    state.settled = true;\n    const regions = state.regions;\n    const queued = state.queued;\n    state.queued = {};\n    if (!regions) return;\n    for (const politeness of POLITENESS) {\n      const message = queued[politeness];\n      if (message !== undefined) regions[politeness].textContent = message;\n    }\n  });\n}\n\nfunction removeRegions(state: AnnouncerState): void {\n  state.cancelFrame?.();\n  state.cancelFrame = null;\n  state.root?.remove();\n  state.root = null;\n  state.regions = null;\n  state.settled = false;\n  state.queued = {};\n}\n\n/** Creates the singleton regions when they do not exist (or were removed from the document). */\nfunction ensureRegions(state: AnnouncerState): Record<Politeness, HTMLElement> {\n  if (state.root && state.regions && state.root.isConnected) return state.regions;\n  removeRegions(state);\n\n  const root = document.createElement('div');\n  root.setAttribute('data-wave-announcer', '');\n  Object.assign(root.style, VISUALLY_HIDDEN);\n\n  const polite = document.createElement('div');\n  polite.setAttribute('role', 'status');\n  polite.setAttribute('aria-live', 'polite');\n  polite.setAttribute('aria-atomic', 'true');\n\n  const assertive = document.createElement('div');\n  assertive.setAttribute('aria-live', 'assertive');\n  assertive.setAttribute('aria-atomic', 'true');\n\n  root.append(polite, assertive);\n  document.body.appendChild(root);\n\n  state.root = root;\n  state.regions = { polite, assertive };\n  state.settled = false;\n  // Live regions must exist before their content changes: the first write waits one frame.\n  scheduleFlush(state);\n  return state.regions;\n}\n\n/**\n * Announces `message` to screen readers through a shared, visually hidden live region\n * (`[data-wave-announcer]`, which modal isolation never makes inert).\n *\n * The regions are created on first use — the first `useAnnounce` mount or the first `announce()`\n * call. A message sent while they are being created is written on the next animation frame, so it\n * is not lost; repeating the current message clears the region and writes it again on the next\n * frame, so it is read again. A message sent while one is waiting for that frame replaces it (the\n * last call wins). No-op on the server.\n *\n * @param message    The text to read.\n * @param politeness `'polite'` (default, `role=\"status\"`) or `'assertive'`.\n */\nexport function announce(message: string, politeness: Politeness = 'polite'): void {\n  if (!canUseDom()) return;\n  const state = getState();\n  const regions = ensureRegions(state);\n  const region = regions[politeness];\n\n  // A message still waiting for the next frame (regions being created, or a repeat whose region\n  // was cleared) is replaced, so the last call wins and the flush never writes an older message.\n  if (!state.settled || state.queued[politeness] !== undefined) {\n    state.queued[politeness] = message;\n    return;\n  }\n  if (region.textContent === message) {\n    region.textContent = '';\n    state.queued[politeness] = message;\n    scheduleFlush(state);\n    return;\n  }\n  region.textContent = message;\n}\n\n/**\n * Returns {@link announce} and keeps the shared live regions alive while the caller is mounted\n * (they are created on mount and removed when the last caller unmounts).\n *\n * @example\n * const say = useAnnounce();\n * say(`${label} removed, ${count} selected`);\n */\nexport function useAnnounce(): (message: string, politeness?: Politeness) => void {\n  useEffect(() => {\n    if (!canUseDom()) return;\n    const state = getState();\n    state.users += 1;\n    ensureRegions(state);\n    return () => {\n      state.users = Math.max(0, state.users - 1);\n      if (state.users === 0) removeRegions(state);\n    };\n  }, []);\n  return announce;\n}\n\n/** Test helper: the current text of a region (`''` when the regions do not exist). */\nexport function __getAnnouncerText(politeness: Politeness = 'polite'): string {\n  return getState().regions?.[politeness].textContent ?? '';\n}\n\n/** Test helper: removes the regions and forgets queued messages and mounted callers. */\nexport function __resetAnnouncer(): void {\n  const state = getState();\n  removeRegions(state);\n  state.users = 0;\n}\n"],"mappings":"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"}

package/dist/hooks/useAnnounce.mjs

@@ -0,0 +1,88 @@
+"use client";
+import { getGlobalRegistry as e } from "../lib/globalRegistry.mjs";
+import { useEffect as t } from "react";
+//#region src/hooks/useAnnounce.ts
+var n = ["polite", "assertive"], r = {
+	position: "absolute",
+	width: "1px",
+	height: "1px",
+	padding: "0",
+	margin: "-1px",
+	overflow: "hidden",
+	clip: "rect(0, 0, 0, 0)",
+	whiteSpace: "nowrap",
+	border: "0"
+};
+function i() {
+	return e("announcer", () => ({
+		root: null,
+		regions: null,
+		users: 0,
+		settled: !1,
+		queued: {},
+		cancelFrame: null
+	}));
+}
+function a() {
+	return typeof document < "u" && document.body != null;
+}
+function o(e) {
+	if (typeof requestAnimationFrame == "function") {
+		let t = requestAnimationFrame(() => e());
+		return () => cancelAnimationFrame(t);
+	}
+	let t = setTimeout(e, 16);
+	return () => clearTimeout(t);
+}
+function s(e) {
+	e.cancelFrame ||= o(() => {
+		e.cancelFrame = null, e.settled = !0;
+		let t = e.regions, r = e.queued;
+		if (e.queued = {}, t) for (let e of n) {
+			let n = r[e];
+			n !== void 0 && (t[e].textContent = n);
+		}
+	});
+}
+function c(e) {
+	e.cancelFrame?.(), e.cancelFrame = null, e.root?.remove(), e.root = null, e.regions = null, e.settled = !1, e.queued = {};
+}
+function l(e) {
+	if (e.root && e.regions && e.root.isConnected) return e.regions;
+	c(e);
+	let t = document.createElement("div");
+	t.setAttribute("data-wave-announcer", ""), Object.assign(t.style, r);
+	let n = document.createElement("div");
+	n.setAttribute("role", "status"), n.setAttribute("aria-live", "polite"), n.setAttribute("aria-atomic", "true");
+	let i = document.createElement("div");
+	return i.setAttribute("aria-live", "assertive"), i.setAttribute("aria-atomic", "true"), t.append(n, i), document.body.appendChild(t), e.root = t, e.regions = {
+		polite: n,
+		assertive: i
+	}, e.settled = !1, s(e), e.regions;
+}
+function u(e, t = "polite") {
+	if (!a()) return;
+	let n = i(), r = l(n)[t];
+	if (!n.settled || n.queued[t] !== void 0) {
+		n.queued[t] = e;
+		return;
+	}
+	if (r.textContent === e) {
+		r.textContent = "", n.queued[t] = e, s(n);
+		return;
+	}
+	r.textContent = e;
+}
+function d() {
+	return t(() => {
+		if (!a()) return;
+		let e = i();
+		return e.users += 1, l(e), () => {
+			e.users = Math.max(0, e.users - 1), e.users === 0 && c(e);
+		};
+	}, []), u;
+}
+//#endregion
+export { u as announce, d as useAnnounce };
+
+//# sourceMappingURL=useAnnounce.mjs.map

package/dist/hooks/useAnnounce.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAnnounce.mjs","names":["POLITENESS","VISUALLY_HIDDEN","getState","getGlobalRegistry","canUseDom","requestFrame","handle","callback","scheduleFlush","state","regions","queued","politeness","message","removeRegions","ensureRegions","root","polite","assertive","announce","region","useAnnounce","useEffect"],"sources":["../../src/hooks/useAnnounce.ts"],"sourcesContent":["import { useEffect } from 'react';\nimport { getGlobalRegistry } from '../lib/globalRegistry';\n\n/** How urgently assistive technology should read a message. */\nexport type Politeness = 'polite' | 'assertive';\n\ninterface AnnouncerState {\n  root: HTMLElement | null;\n  regions: Record<Politeness, HTMLElement> | null;\n  /** Number of mounted `useAnnounce` callers. */\n  users: number;\n  /** `false` until one frame has passed since the regions were created. */\n  settled: boolean;\n  queued: Partial<Record<Politeness, string>>;\n  cancelFrame: (() => void) | null;\n}\n\nconst POLITENESS: readonly Politeness[] = ['polite', 'assertive'];\n\nconst VISUALLY_HIDDEN: Partial<CSSStyleDeclaration> = {\n  position: 'absolute',\n  width: '1px',\n  height: '1px',\n  padding: '0',\n  margin: '-1px',\n  overflow: 'hidden',\n  clip: 'rect(0, 0, 0, 0)',\n  whiteSpace: 'nowrap',\n  border: '0',\n};\n\nfunction getState(): AnnouncerState {\n  return getGlobalRegistry<AnnouncerState>('announcer', () => ({\n    root: null,\n    regions: null,\n    users: 0,\n    settled: false,\n    queued: {},\n    cancelFrame: null,\n  }));\n}\n\nfunction canUseDom(): boolean {\n  return typeof document !== 'undefined' && document.body != null;\n}\n\nfunction requestFrame(callback: () => void): () => void {\n  if (typeof requestAnimationFrame === 'function') {\n    const handle = requestAnimationFrame(() => callback());\n    return () => cancelAnimationFrame(handle);\n  }\n  const handle = setTimeout(callback, 16);\n  return () => clearTimeout(handle);\n}\n\nfunction scheduleFlush(state: AnnouncerState): void {\n  if (state.cancelFrame) return;\n  state.cancelFrame = requestFrame(() => {\n    state.cancelFrame = null;\n    state.settled = true;\n    const regions = state.regions;\n    const queued = state.queued;\n    state.queued = {};\n    if (!regions) return;\n    for (const politeness of POLITENESS) {\n      const message = queued[politeness];\n      if (message !== undefined) regions[politeness].textContent = message;\n    }\n  });\n}\n\nfunction removeRegions(state: AnnouncerState): void {\n  state.cancelFrame?.();\n  state.cancelFrame = null;\n  state.root?.remove();\n  state.root = null;\n  state.regions = null;\n  state.settled = false;\n  state.queued = {};\n}\n\n/** Creates the singleton regions when they do not exist (or were removed from the document). */\nfunction ensureRegions(state: AnnouncerState): Record<Politeness, HTMLElement> {\n  if (state.root && state.regions && state.root.isConnected) return state.regions;\n  removeRegions(state);\n\n  const root = document.createElement('div');\n  root.setAttribute('data-wave-announcer', '');\n  Object.assign(root.style, VISUALLY_HIDDEN);\n\n  const polite = document.createElement('div');\n  polite.setAttribute('role', 'status');\n  polite.setAttribute('aria-live', 'polite');\n  polite.setAttribute('aria-atomic', 'true');\n\n  const assertive = document.createElement('div');\n  assertive.setAttribute('aria-live', 'assertive');\n  assertive.setAttribute('aria-atomic', 'true');\n\n  root.append(polite, assertive);\n  document.body.appendChild(root);\n\n  state.root = root;\n  state.regions = { polite, assertive };\n  state.settled = false;\n  // Live regions must exist before their content changes: the first write waits one frame.\n  scheduleFlush(state);\n  return state.regions;\n}\n\n/**\n * Announces `message` to screen readers through a shared, visually hidden live region\n * (`[data-wave-announcer]`, which modal isolation never makes inert).\n *\n * The regions are created on first use — the first `useAnnounce` mount or the first `announce()`\n * call. A message sent while they are being created is written on the next animation frame, so it\n * is not lost; repeating the current message clears the region and writes it again on the next\n * frame, so it is read again. A message sent while one is waiting for that frame replaces it (the\n * last call wins). No-op on the server.\n *\n * @param message    The text to read.\n * @param politeness `'polite'` (default, `role=\"status\"`) or `'assertive'`.\n */\nexport function announce(message: string, politeness: Politeness = 'polite'): void {\n  if (!canUseDom()) return;\n  const state = getState();\n  const regions = ensureRegions(state);\n  const region = regions[politeness];\n\n  // A message still waiting for the next frame (regions being created, or a repeat whose region\n  // was cleared) is replaced, so the last call wins and the flush never writes an older message.\n  if (!state.settled || state.queued[politeness] !== undefined) {\n    state.queued[politeness] = message;\n    return;\n  }\n  if (region.textContent === message) {\n    region.textContent = '';\n    state.queued[politeness] = message;\n    scheduleFlush(state);\n    return;\n  }\n  region.textContent = message;\n}\n\n/**\n * Returns {@link announce} and keeps the shared live regions alive while the caller is mounted\n * (they are created on mount and removed when the last caller unmounts).\n *\n * @example\n * const say = useAnnounce();\n * say(`${label} removed, ${count} selected`);\n */\nexport function useAnnounce(): (message: string, politeness?: Politeness) => void {\n  useEffect(() => {\n    if (!canUseDom()) return;\n    const state = getState();\n    state.users += 1;\n    ensureRegions(state);\n    return () => {\n      state.users = Math.max(0, state.users - 1);\n      if (state.users === 0) removeRegions(state);\n    };\n  }, []);\n  return announce;\n}\n\n/** Test helper: the current text of a region (`''` when the regions do not exist). */\nexport function __getAnnouncerText(politeness: Politeness = 'polite'): string {\n  return getState().regions?.[politeness].textContent ?? '';\n}\n\n/** Test helper: removes the regions and forgets queued messages and mounted callers. */\nexport function __resetAnnouncer(): void {\n  const state = getState();\n  removeRegions(state);\n  state.users = 0;\n}\n"],"mappings":"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"}