silvery 0.21.0 → 0.23.0

package/dist/{useLatest-DRDDVwjh.d.mts → useLatest-UOvWy0ZW.d.mts}

@@ -1,4 +1,4 @@
-import { n as EasingName, t as EasingFn } from "./easing-BI-ASGMO.mjs";
+import { n as EasingName, t as EasingFn } from "./easing-C5MrdO7V.mjs";
 
 //#region packages/ag-react/src/ui/animation/useAnimation.d.ts
 interface UseAnimationOptions {
@@ -131,4 +131,4 @@ declare function useLatest<T>(value: T): {
 };
 //#endregion
 export { useTransition as a, useAnimation as c, UseTransitionOptions as i, useTimeout as n, UseAnimationOptions as o, useInterval as r, UseAnimationResult as s, useLatest as t };
-//# sourceMappingURL=useLatest-DRDDVwjh.d.mts.map
+//# sourceMappingURL=useLatest-UOvWy0ZW.d.mts.map

package/dist/{useLatest-DRDDVwjh.d.mts.map → useLatest-UOvWy0ZW.d.mts.map}

@@ -1 +1 @@
-{"version":3,"file":"useLatest-DRDDVwjh.d.mts","names":[],"sources":["../packages/ag-react/src/ui/animation/useAnimation.ts","../packages/ag-react/src/ui/animation/useTransition.ts","../packages/ag-react/src/ui/animation/useInterval.ts","../packages/ag-react/src/ui/animation/useTimeout.ts","../packages/ag-react/src/ui/animation/useLatest.ts"],"mappings":";;;UAeiB,mBAAA;EAIN;EAFT,QAAA;EAIA;EAFA,MAAA,GAAS,UAAA,GAAa,QAAA;EAMtB;EAJA,KAAA;EAIO;EAFP,UAAA;EAKiC;EAHjC,OAAA;AAAA;AAAA,UAGe,kBAAA;EAIf;EAFA,KAAA;EAIK;EAFL,WAAA;EA2Bc;EAzBd,KAAA;AAAA;;;;;;;;;;ACnBF;;iBD4CgB,YAAA,CAAa,OAAA,EAAS,mBAAA,GAAsB,kBAAA;;;UC5C3C,oBAAA;EDIN;ECFT,QAAA;EDIA;ECFA,MAAA,GAAS,UAAA,GAAa,QAAA;AAAA;;;ADSxB;;;;;;;;;AA+BA;;;;iBCXgB,aAAA,CAAc,WAAA,UAAqB,OAAA,GAAU,oBAAA;;;;;;ADjC7D;;;;;;;;;;;;;iBEQgB,WAAA,CAAY,QAAA,cAAsB,EAAA,UAAY,OAAA;;;;;;AFR9D;;;;;;;;;;;;;AAaA;;;iBGFgB,UAAA,CACd,QAAA,cACA,EAAA,UACA,OAAA;EACG,KAAA;EAAmB,KAAA;AAAA;;;;;;AHfxB;;;;;;;;;;;;;AAaA;;;;;;;iBIEgB,SAAA,GAAA,CAAa,KAAA,EAAO,CAAA;EAAA,SAAe,OAAA,EAAS,CAAA;AAAA"}
+{"version":3,"file":"useLatest-UOvWy0ZW.d.mts","names":[],"sources":["../packages/ag-react/src/ui/animation/useAnimation.ts","../packages/ag-react/src/ui/animation/useTransition.ts","../packages/ag-react/src/ui/animation/useInterval.ts","../packages/ag-react/src/ui/animation/useTimeout.ts","../packages/ag-react/src/ui/animation/useLatest.ts"],"mappings":";;;UAeiB,mBAAA;EAIN;EAFT,QAAA;EAIA;EAFA,MAAA,GAAS,UAAA,GAAa,QAAA;EAMtB;EAJA,KAAA;EAIO;EAFP,UAAA;EAKiC;EAHjC,OAAA;AAAA;AAAA,UAGe,kBAAA;EAIf;EAFA,KAAA;EAIK;EAFL,WAAA;EA2Bc;EAzBd,KAAA;AAAA;;;;;;;;;;ACnBF;;iBD4CgB,YAAA,CAAa,OAAA,EAAS,mBAAA,GAAsB,kBAAA;;;UC5C3C,oBAAA;EDIN;ECFT,QAAA;EDIA;ECFA,MAAA,GAAS,UAAA,GAAa,QAAA;AAAA;;;ADSxB;;;;;;;;;AA+BA;;;;iBCXgB,aAAA,CAAc,WAAA,UAAqB,OAAA,GAAU,oBAAA;;;;;;ADjC7D;;;;;;;;;;;;;iBEQgB,WAAA,CAAY,QAAA,cAAsB,EAAA,UAAY,OAAA;;;;;;AFR9D;;;;;;;;;;;;;AAaA;;;iBGFgB,UAAA,CACd,QAAA,cACA,EAAA,UACA,OAAA;EACG,KAAA;EAAmB,KAAA;AAAA;;;;;;AHfxB;;;;;;;;;;;;;AAaA;;;;;;;iBIEgB,SAAA,GAAA,CAAa,KAAA,EAAO,CAAA;EAAA,SAAe,OAAA,EAAS,CAAA;AAAA"}

package/dist/useLayout-D5cE8OCI.mjs

@@ -0,0 +1,424 @@
+import { r as effect } from "./src-BqeBFB3X.mjs";
+import { _ as rectEqual, l as markObservedLayoutSignal, o as getLayoutSignals } from "./layout-signals-CGYbHmxy.mjs";
+import { a as NodeContext } from "./context-CEhuD1R_.mjs";
+import { useContext, useLayoutEffect, useReducer, useRef } from "react";
+//#region packages/ag-react/src/hooks/useLayout.ts
+/**
+* Layout Hooks — three coordinate systems for positioning in silvery.
+*
+* Every silvery node has three rects that differ only by how scroll and
+* sticky offsets are applied. Pick the one that matches your use case:
+*
+* - `useBoxRect()`    — layout position (border-box sized, minus padding/border).
+*                       Use for responsive sizing inside a component. Matches
+*                       CSS `clientWidth`/`clientHeight` for the content area.
+* - `useScrollRect()` — scroll-adjusted position, **pre** sticky clamping.
+*                       Use when you need the "natural" position of a node
+*                       in scrolled coordinates (can go off-screen).
+* - `useScreenRect()` — actual paint position on the terminal screen.
+*                       Use for hit testing, cursor positioning, and
+*                       cross-component visual navigation. The CSS
+*                       `getBoundingClientRect()` analogue.
+*
+* ## Deferred semantics (the only contract)
+*
+* Each hook returns the rect as of the **most recent committed layout** —
+* the value as of the last event-batch commit boundary. Within a single
+* batch, the returned value is invariant across every convergence pass;
+* React renders see one value per batch. After the batch's commit boundary
+* fires, the next batch sees the new value.
+*
+* This is the structural fix for the "render reads useBoxRect AND writes
+* a layout-affecting prop based on it" feedback loop. Under the in-flight
+* model that preceded this hook (pre 2026-05-06), the read returned the
+* latest measurement during the same batch, which could differ between
+* the first and second convergence passes — causing the write to flip
+* between branches and the loop to ping-pong until `MAX_CONVERGENCE_PASSES`
+* capped it. Under deferred semantics the read is invariant for the
+* batch, so the loop completes in one pass.
+*
+* **One-frame-late by design.** A component that mounts shows the
+* empty-rect fallback (`{ x: 0, y: 0, width: 0, height: 0 }`) on its
+* first render and the real rect on the next commit boundary. Layout
+* effects that run on the second render see the real rect and can write
+* positioned terminal escapes (Image, decorations) into the next
+* paintFrame.
+*
+* Components that need same-frame measurements must read `node.boxRect`
+* etc. directly via `useAgNode()` and gate on `useLayoutEffect` —
+* recommended only for leaf primitives in the silvery framework itself.
+*
+* For breakpoint logic, prefer `useResponsiveValue()` or
+* `useResponsiveBoxProps()` — bucketing into stable zones gives more
+* predictable behavior than branching on raw widths.
+*
+* See bead `@km/silvery/use-deferred-box-rect-and-post-commit-observers`.
+*/
+const EMPTY_RECT = {
+	x: 0,
+	y: 0,
+	width: 0,
+	height: 0
+};
+const EMPTY_SIZE = {
+	width: 0,
+	height: 0
+};
+/**
+* Get the inner content dimensions of a node (border-box minus padding and border).
+* This is the space available for the node's children.
+*
+* `boxRect` is passed in explicitly so the helper derives the inner rect
+* from the committed signal value rather than re-reading `node.boxRect`
+* (which holds the in-flight value mid-batch).
+*/
+function deriveInnerRect(node, boxRect) {
+	if (!boxRect) return null;
+	const props = node.props;
+	if (!props || node.type === "silvery-text") return boxRect;
+	const pTop = props.paddingTop ?? props.paddingY ?? props.padding ?? 0;
+	const pBottom = props.paddingBottom ?? props.paddingY ?? props.padding ?? 0;
+	const pLeft = props.paddingLeft ?? props.paddingX ?? props.padding ?? 0;
+	const pRight = props.paddingRight ?? props.paddingX ?? props.padding ?? 0;
+	let bTop = 0;
+	let bBottom = 0;
+	let bLeft = 0;
+	let bRight = 0;
+	if (props.borderStyle) {
+		bTop = props.borderTop !== false ? 1 : 0;
+		bBottom = props.borderBottom !== false ? 1 : 0;
+		bLeft = props.borderLeft !== false ? 1 : 0;
+		bRight = props.borderRight !== false ? 1 : 0;
+	}
+	return {
+		x: boxRect.x + pLeft + bLeft,
+		y: boxRect.y + pTop + bTop,
+		width: Math.max(0, boxRect.width - pLeft - pRight - bLeft - bRight),
+		height: Math.max(0, boxRect.height - pTop - pBottom - bTop - bBottom)
+	};
+}
+const COMMITTED_RECT_OBSERVED_KEY = {
+	boxRectCommitted: "boxRect",
+	scrollRectCommitted: "scrollRect",
+	screenRectCommitted: "screenRect"
+};
+const IN_FLIGHT_RECT_OBSERVED_KEY = {
+	boxRect: "boxRect",
+	scrollRect: "scrollRect",
+	screenRect: "screenRect"
+};
+/**
+* Reactive rect hook (deferred): subscribes to a committed rect signal and
+* re-renders when the value advances at a commit boundary. Returns the
+* rect derived from the committed value via `getCommittedRect`.
+*
+* Within a single event batch the committed signal does not change — every
+* convergence pass sees the same value, so a render that reads useBoxRect
+* and writes a layout-affecting prop converges in one pass. After the
+* batch's commit boundary (handled by the runtime via
+* `commitLayoutSnapshot`), the next batch's first render sees the new
+* value.
+*/
+function useReactiveRect(getCommittedRect, committedSignalKey) {
+	const node = useContext(NodeContext);
+	const [, forceUpdate] = useReducer((x) => x + 1, 0);
+	const prevRef = useRef(null);
+	useLayoutEffect(() => {
+		if (!node) return;
+		markObservedLayoutSignal(node, COMMITTED_RECT_OBSERVED_KEY[committedSignalKey]);
+		const rectSignal = getLayoutSignals(node)[committedSignalKey];
+		return effect(() => {
+			const next = getCommittedRect(rectSignal(), node) ?? null;
+			if (!rectEqual(prevRef.current, next)) {
+				prevRef.current = next;
+				forceUpdate();
+			}
+		});
+	}, [node]);
+	if (!node) return EMPTY_RECT;
+	markObservedLayoutSignal(node, COMMITTED_RECT_OBSERVED_KEY[committedSignalKey]);
+	return getCommittedRect(getLayoutSignals(node)[committedSignalKey](), node) ?? EMPTY_RECT;
+}
+/**
+* **DANGEROUS — measurement read on the render path.** Prefer a declarative
+* primitive (`<Box fitWidth>`, `useResponsiveBoxProps`, `useResponsiveValue`,
+* `useOnBoxRectCommitted`) before reaching for this hook.
+*
+* Returns the inner content dimensions for the current component's nearest
+* Box, as of the most recent committed layout. Width and height reflect
+* the space available for children (border-box minus padding and border),
+* like CSS `clientWidth`/`clientHeight`.
+*
+* ```tsx
+* function Header() {
+*   const { width } = useBoxRectDangerously()
+*   return <Text>{'='.repeat(Math.max(0, width))}</Text>
+* }
+* ```
+*
+* On first render returns `{ x: 0, y: 0, width: 0, height: 0 }`. After the
+* first commit boundary, automatically re-renders with the measured
+* dimensions. This **first-paint zero-rect transition** is the social cost
+* the rename announces — components that branch layout on this hook see a
+* flush-left / collapsed first paint, then re-flow when the real rect
+* commits one event-loop tick later. Visible jank under streaming / dynamic
+* mount / SIGWINCH burst.
+*
+* Use only when:
+* - You need a measurement read in JS control flow (animation, autoscroll
+*   thresholds, hit-testing) that **doesn't drive layout-affecting props**.
+* - No declarative primitive covers the case.
+*
+* Deferred semantics — see this file's docstring for the contract and the
+* one-frame-late behavior.
+*
+* Bead: `@km/silvery/responsive-layout-architecture-reframe` (Phase A.1
+* lands this rename; the full Phase A migrates each consumer to a
+* declarative primitive or, where genuinely needed, to a Suspense-friendly
+* `Promise<Rect>` form coordinated via `RectReadBarrier`).
+*/
+function useBoxRectDangerously() {
+	return useReactiveRect((committed, node) => deriveInnerRect(node, committed), "boxRectCommitted");
+}
+/**
+* @deprecated Renamed to `useBoxRectDangerously`. The original name read as
+* "the normal hook for getting your rect" — exactly the framing the Phase
+* A.1 rename is intended to break. App authors should reach for declarative
+* primitives first; this alias remains for one release cycle and logs a
+* dev-time warning per call site. Will be removed in the next major.
+*
+* Bead: `@km/silvery/responsive-layout-architecture-reframe`.
+*/
+function useBoxRect() {
+	if (process.env.NODE_ENV !== "production" && process.env.NODE_ENV !== "test") warnUseBoxRectDeprecation();
+	return useReactiveRect((committed, node) => deriveInnerRect(node, committed), "boxRectCommitted");
+}
+/**
+* Internal dimensions-only variant of the deferred box rect read.
+*
+* This is for framework primitives that build width/height-derived text
+* (Divider, ProgressBar, TextArea wrapping) but do not care where their
+* parent sits on screen. It subscribes to the same committed boxRect signal
+* as `useBoxRect()`, but only re-renders when the derived inner
+* `{width,height}` changes. Scrolling and virtual-window spacer movement
+* often change x/y without changing dimensions; full-rect subscriptions wake
+* these primitives on every such frame and steal scroll budget.
+*/
+function useBoxSize() {
+	const node = useContext(NodeContext);
+	const [, forceUpdate] = useReducer((x) => x + 1, 0);
+	const prevRef = useRef(null);
+	useLayoutEffect(() => {
+		if (!node) return;
+		markObservedLayoutSignal(node, "boxSize");
+		const signals = getLayoutSignals(node);
+		return effect(() => {
+			const rect = deriveInnerRect(node, signals.boxRectCommitted());
+			const next = rect ? {
+				width: rect.width,
+				height: rect.height
+			} : EMPTY_SIZE;
+			const prev = prevRef.current;
+			if (!prev || prev.width !== next.width || prev.height !== next.height) {
+				prevRef.current = next;
+				forceUpdate();
+			}
+		});
+	}, [node]);
+	if (!node) return EMPTY_SIZE;
+	markObservedLayoutSignal(node, "boxSize");
+	const rect = deriveInnerRect(node, getLayoutSignals(node).boxRectCommitted());
+	return rect ? {
+		width: rect.width,
+		height: rect.height
+	} : EMPTY_SIZE;
+}
+const useBoxRectWarnedCallSites = /* @__PURE__ */ new Set();
+function warnUseBoxRectDeprecation() {
+	const lines = ((/* @__PURE__ */ new Error()).stack ?? "").split("\n");
+	let consumerFrame = "";
+	for (let i = 1; i < lines.length; i++) {
+		const line = lines[i] ?? "";
+		if (!line.includes("useLayout.ts") && line.trim().startsWith("at ")) {
+			consumerFrame = line.trim();
+			break;
+		}
+	}
+	const key = consumerFrame || "<unknown>";
+	if (useBoxRectWarnedCallSites.has(key)) return;
+	useBoxRectWarnedCallSites.add(key);
+	console.warn(`[silvery] useBoxRect() is deprecated — rename to useBoxRectDangerously(), or migrate to a declarative primitive (<Box fitWidth>, useResponsiveBoxProps, useResponsiveValue, useOnBoxRectCommitted). See @km/silvery/responsive-layout-architecture-reframe. Call site: ${key}`);
+}
+/**
+* Returns the scroll-adjusted position for the current component, as of
+* the most recent committed layout.
+*
+* This is the node's position in scroll coordinates, *before* sticky
+* clamping. For non-sticky nodes it equals `useScreenRect()`. For sticky
+* nodes, the scrollRect reflects where the node would be without sticky
+* adjustment — so it can go off-screen (negative y, etc.) when scrolled
+* past.
+*
+* ```tsx
+* function Card({ id }) {
+*   const { y } = useScrollRect()
+*   return <Box>Scroll y: {y}</Box>
+* }
+* ```
+*
+* Deferred semantics — see this file's docstring.
+*/
+function useScrollRect() {
+	return useReactiveRect((committed) => committed, "scrollRectCommitted");
+}
+/**
+* Returns the actual paint position on the terminal screen as of the most
+* recent committed layout — the silvery analogue of
+* `getBoundingClientRect()`.
+*
+* For non-sticky nodes this equals `useScrollRect()`. For sticky nodes
+* (`position="sticky"`), it reflects the clamped position where pixels
+* actually land on screen.
+*
+* ```tsx
+* function StickyHeader() {
+*   const { y } = useScreenRect()
+*   return <Box position="sticky" stickyTop={0}>Header at row {y}</Box>
+* }
+* ```
+*
+* Deferred semantics — see this file's docstring.
+*/
+function useScreenRect() {
+	return useReactiveRect((committed) => committed, "screenRectCommitted");
+}
+/**
+* In-flight reactive rect hook (escape hatch): subscribes to the LIVE rect
+* signal — the value as written by the most recent layout pass within the
+* current convergence cycle. Re-renders when the in-flight value advances,
+* which can happen multiple times per event batch as the convergence loop
+* iterates.
+*
+* Use only inside silvery framework internals where first-paint measurement
+* is required and the consumer does not write layout-affecting props
+* derived from the read. App code must use the deferred form
+* (`useBoxRect()` / `useScrollRect()` / `useScreenRect()`) or
+* `useResponsiveBoxProps`/`useResponsiveValue` instead.
+*/
+function useReactiveRectInFlight(getDerivedRect, inFlightSignalKey) {
+	const node = useContext(NodeContext);
+	const [, forceUpdate] = useReducer((x) => x + 1, 0);
+	const prevRef = useRef(null);
+	useLayoutEffect(() => {
+		if (!node) return;
+		markObservedLayoutSignal(node, IN_FLIGHT_RECT_OBSERVED_KEY[inFlightSignalKey]);
+		const rectSignal = getLayoutSignals(node)[inFlightSignalKey];
+		return effect(() => {
+			const next = getDerivedRect(rectSignal(), node) ?? null;
+			if (!rectEqual(prevRef.current, next)) {
+				prevRef.current = next;
+				forceUpdate();
+			}
+		});
+	}, [node]);
+	if (!node) return EMPTY_RECT;
+	markObservedLayoutSignal(node, IN_FLIGHT_RECT_OBSERVED_KEY[inFlightSignalKey]);
+	return getDerivedRect(getLayoutSignals(node)[inFlightSignalKey](), node) ?? EMPTY_RECT;
+}
+/**
+* Returns the inner content dimensions of the current Box from the IN-FLIGHT
+* signal — the value as of the most recent layout pass, which may change
+* between convergence passes within an event batch.
+*
+* Silvery framework internals only — app code must use {@link useBoxRect}
+* (deferred) or `useResponsiveBoxProps`/`useResponsiveValue` instead.
+*
+* Unlike {@link useBoxRect} (the deferred form), this hook returns the
+* measured value on the first render after layout — there is no one-frame
+* fallback. The cost is that a render reading this hook AND writing a
+* layout-affecting prop can form a convergence-loop feedback edge; the
+* lint rule `silvery/no-in-flight-rect-in-app` enforces the call-site
+* scope.
+*/
+function useBoxRectInFlight() {
+	return useReactiveRectInFlight((raw, node) => deriveInnerRect(node, raw), "boxRect");
+}
+/**
+* Returns the scroll-adjusted position from the IN-FLIGHT signal — the
+* value as of the most recent layout pass, which may change between
+* convergence passes within an event batch.
+*
+* Silvery framework internals only — see {@link useBoxRectInFlight} for
+* the contract and the lint rule that gates app-code use.
+*/
+function useScrollRectInFlight() {
+	return useReactiveRectInFlight((raw) => raw, "scrollRect");
+}
+/**
+* Returns the actual paint position from the IN-FLIGHT signal — the value
+* as of the most recent layout pass, which may change between convergence
+* passes within an event batch.
+*
+* Silvery framework internals only — see {@link useBoxRectInFlight} for
+* the contract and the lint rule that gates app-code use.
+*/
+function useScreenRectInFlight() {
+	return useReactiveRectInFlight((raw) => raw, "screenRect");
+}
+/**
+* Subscribes to the committed rect signal and fires `cb(rect)` at each
+* commit boundary, **without** triggering a re-render of the consumer.
+*
+* Use for hot paths where a rect change drives an imperative side effect
+* (cursor store update, registry write, ANSI emission) and there is no
+* render path that needs to reflect the rect.
+*
+* The callback is invoked synchronously from a commit-boundary effect(),
+* with the derived rect (`getDerivedRect` applied to the committed signal
+* value). It is NOT invoked when the derived rect is null. The caller may
+* close over component state via refs; see `useCursor` / `useGridPosition`
+* for canonical patterns.
+*/
+function useOnRectCommitted(cb, getDerivedRect, committedSignalKey) {
+	const node = useContext(NodeContext);
+	const cbRef = useRef(cb);
+	cbRef.current = cb;
+	useLayoutEffect(() => {
+		if (!node) return;
+		const rectSignal = getLayoutSignals(node)[committedSignalKey];
+		let prev = null;
+		return effect(() => {
+			const next = getDerivedRect(rectSignal(), node) ?? null;
+			if (next == null) return;
+			if (rectEqual(prev, next)) return;
+			prev = next;
+			cbRef.current(next);
+		});
+	}, [node]);
+}
+/**
+* Subscribes to the committed boxRect (inner content) and fires `cb` at
+* each commit boundary without re-rendering. See {@link useBoxRect} for
+* the deferred-rect contract; this is the observer form.
+*/
+function useOnBoxRectCommitted(cb) {
+	useOnRectCommitted(cb, (committed, node) => deriveInnerRect(node, committed), "boxRectCommitted");
+}
+/**
+* Subscribes to the committed scrollRect and fires `cb` at each commit
+* boundary without re-rendering.
+*/
+function useOnScrollRectCommitted(cb) {
+	useOnRectCommitted(cb, (committed) => committed, "scrollRectCommitted");
+}
+/**
+* Subscribes to the committed screenRect and fires `cb` at each commit
+* boundary without re-rendering.
+*/
+function useOnScreenRectCommitted(cb) {
+	useOnRectCommitted(cb, (committed) => committed, "screenRectCommitted");
+}
+//#endregion
+export { useOnBoxRectCommitted as a, useScreenRect as c, useScrollRectInFlight as d, useBoxSize as i, useScreenRectInFlight as l, useBoxRectDangerously as n, useOnScreenRectCommitted as o, useBoxRectInFlight as r, useOnScrollRectCommitted as s, useBoxRect as t, useScrollRect as u };
+
+//# sourceMappingURL=useLayout-D5cE8OCI.mjs.map

package/dist/useLayout-D5cE8OCI.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLayout-D5cE8OCI.mjs","names":[],"sources":["../packages/ag-react/src/hooks/useLayout.ts"],"sourcesContent":["/**\n * Layout Hooks — three coordinate systems for positioning in silvery.\n *\n * Every silvery node has three rects that differ only by how scroll and\n * sticky offsets are applied. Pick the one that matches your use case:\n *\n * - `useBoxRect()`    — layout position (border-box sized, minus padding/border).\n *                       Use for responsive sizing inside a component. Matches\n *                       CSS `clientWidth`/`clientHeight` for the content area.\n * - `useScrollRect()` — scroll-adjusted position, **pre** sticky clamping.\n *                       Use when you need the \"natural\" position of a node\n *                       in scrolled coordinates (can go off-screen).\n * - `useScreenRect()` — actual paint position on the terminal screen.\n *                       Use for hit testing, cursor positioning, and\n *                       cross-component visual navigation. The CSS\n *                       `getBoundingClientRect()` analogue.\n *\n * ## Deferred semantics (the only contract)\n *\n * Each hook returns the rect as of the **most recent committed layout** —\n * the value as of the last event-batch commit boundary. Within a single\n * batch, the returned value is invariant across every convergence pass;\n * React renders see one value per batch. After the batch's commit boundary\n * fires, the next batch sees the new value.\n *\n * This is the structural fix for the \"render reads useBoxRect AND writes\n * a layout-affecting prop based on it\" feedback loop. Under the in-flight\n * model that preceded this hook (pre 2026-05-06), the read returned the\n * latest measurement during the same batch, which could differ between\n * the first and second convergence passes — causing the write to flip\n * between branches and the loop to ping-pong until `MAX_CONVERGENCE_PASSES`\n * capped it. Under deferred semantics the read is invariant for the\n * batch, so the loop completes in one pass.\n *\n * **One-frame-late by design.** A component that mounts shows the\n * empty-rect fallback (`{ x: 0, y: 0, width: 0, height: 0 }`) on its\n * first render and the real rect on the next commit boundary. Layout\n * effects that run on the second render see the real rect and can write\n * positioned terminal escapes (Image, decorations) into the next\n * paintFrame.\n *\n * Components that need same-frame measurements must read `node.boxRect`\n * etc. directly via `useAgNode()` and gate on `useLayoutEffect` —\n * recommended only for leaf primitives in the silvery framework itself.\n *\n * For breakpoint logic, prefer `useResponsiveValue()` or\n * `useResponsiveBoxProps()` — bucketing into stable zones gives more\n * predictable behavior than branching on raw widths.\n *\n * See bead `@km/silvery/use-deferred-box-rect-and-post-commit-observers`.\n */\n\nimport { useContext, useLayoutEffect, useReducer, useRef } from \"react\"\nimport { effect } from \"@silvery/signals\"\nimport { NodeContext } from \"../context\"\nimport { type AgNode, type BoxProps, type Rect, rectEqual } from \"@silvery/ag/types\"\nimport {\n  getLayoutSignals,\n  markObservedLayoutSignal,\n  type ObservedLayoutSignalKey,\n} from \"@silvery/ag/layout-signals\"\n\nexport type { Rect }\n\nconst EMPTY_RECT: Rect = { x: 0, y: 0, width: 0, height: 0 }\nconst EMPTY_SIZE: BoxSize = { width: 0, height: 0 }\n\nexport interface BoxSize {\n  width: number\n  height: number\n}\n\n/**\n * Get the inner content dimensions of a node (border-box minus padding and border).\n * This is the space available for the node's children.\n *\n * `boxRect` is passed in explicitly so the helper derives the inner rect\n * from the committed signal value rather than re-reading `node.boxRect`\n * (which holds the in-flight value mid-batch).\n */\nfunction deriveInnerRect(node: AgNode, boxRect: Rect | null | undefined): Rect | null {\n  if (!boxRect) return null\n\n  const props = node.props as BoxProps\n  if (!props || node.type === \"silvery-text\") return boxRect\n\n  // Compute padding\n  const pTop = props.paddingTop ?? props.paddingY ?? props.padding ?? 0\n  const pBottom = props.paddingBottom ?? props.paddingY ?? props.padding ?? 0\n  const pLeft = props.paddingLeft ?? props.paddingX ?? props.padding ?? 0\n  const pRight = props.paddingRight ?? props.paddingX ?? props.padding ?? 0\n\n  // Compute border (1px per side if borderStyle is set)\n  let bTop = 0\n  let bBottom = 0\n  let bLeft = 0\n  let bRight = 0\n  if (props.borderStyle) {\n    bTop = props.borderTop !== false ? 1 : 0\n    bBottom = props.borderBottom !== false ? 1 : 0\n    bLeft = props.borderLeft !== false ? 1 : 0\n    bRight = props.borderRight !== false ? 1 : 0\n  }\n\n  return {\n    x: boxRect.x + pLeft + bLeft,\n    y: boxRect.y + pTop + bTop,\n    width: Math.max(0, boxRect.width - pLeft - pRight - bLeft - bRight),\n    height: Math.max(0, boxRect.height - pTop - pBottom - bTop - bBottom),\n  }\n}\n\n/** Selector that picks which committed rect signal to subscribe to. */\ntype CommittedRectSignalKey = \"boxRectCommitted\" | \"scrollRectCommitted\" | \"screenRectCommitted\"\n\n/** Selector that picks which in-flight rect signal to subscribe to. */\ntype InFlightRectSignalKey = \"boxRect\" | \"scrollRect\" | \"screenRect\"\n\nconst COMMITTED_RECT_OBSERVED_KEY: Record<CommittedRectSignalKey, ObservedLayoutSignalKey> = {\n  boxRectCommitted: \"boxRect\",\n  scrollRectCommitted: \"scrollRect\",\n  screenRectCommitted: \"screenRect\",\n}\n\nconst IN_FLIGHT_RECT_OBSERVED_KEY: Record<InFlightRectSignalKey, ObservedLayoutSignalKey> = {\n  boxRect: \"boxRect\",\n  scrollRect: \"scrollRect\",\n  screenRect: \"screenRect\",\n}\n\n/**\n * Reactive rect hook (deferred): subscribes to a committed rect signal and\n * re-renders when the value advances at a commit boundary. Returns the\n * rect derived from the committed value via `getCommittedRect`.\n *\n * Within a single event batch the committed signal does not change — every\n * convergence pass sees the same value, so a render that reads useBoxRect\n * and writes a layout-affecting prop converges in one pass. After the\n * batch's commit boundary (handled by the runtime via\n * `commitLayoutSnapshot`), the next batch's first render sees the new\n * value.\n */\nfunction useReactiveRect(\n  getCommittedRect: (committed: Rect | null, node: AgNode) => Rect | null | undefined,\n  committedSignalKey: CommittedRectSignalKey,\n): Rect {\n  const node = useContext(NodeContext)\n  const [, forceUpdate] = useReducer((x: number) => x + 1, 0)\n  const prevRef = useRef<Rect | null>(null)\n\n  useLayoutEffect(() => {\n    if (!node) return\n\n    markObservedLayoutSignal(node, COMMITTED_RECT_OBSERVED_KEY[committedSignalKey])\n    const signals = getLayoutSignals(node)\n    const rectSignal = signals[committedSignalKey]\n\n    // effect() subscribes to the COMMITTED signal — re-runs when the signal\n    // value changes. The committed signal advances only at event-batch\n    // commit boundaries (see `commitLayoutSnapshot`), so this fires at most\n    // once per batch — never mid-batch — making it impossible to form a\n    // feedback edge with a render that branches on the read value.\n    const dispose = effect(() => {\n      const committed = rectSignal()\n      const next = getCommittedRect(committed, node) ?? null\n      if (!rectEqual(prevRef.current, next)) {\n        prevRef.current = next\n        forceUpdate()\n      }\n    })\n\n    return dispose\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [node])\n\n  if (!node) return EMPTY_RECT\n  // Synchronous read (called during render): use the committed signal's\n  // current value, NOT `node.boxRect` etc. The in-flight rect on the node\n  // may have been updated by an earlier convergence pass within this batch\n  // — reading it would re-introduce the feedback edge this hook exists to\n  // eliminate. The committed signal is invariant for the batch.\n  markObservedLayoutSignal(node, COMMITTED_RECT_OBSERVED_KEY[committedSignalKey])\n  const signals = getLayoutSignals(node)\n  const committed = signals[committedSignalKey]()\n  return getCommittedRect(committed, node) ?? EMPTY_RECT\n}\n\n// ============================================================================\n// boxRect — layout position (border-box minus padding/border)\n// ============================================================================\n\n/**\n * **DANGEROUS — measurement read on the render path.** Prefer a declarative\n * primitive (`<Box fitWidth>`, `useResponsiveBoxProps`, `useResponsiveValue`,\n * `useOnBoxRectCommitted`) before reaching for this hook.\n *\n * Returns the inner content dimensions for the current component's nearest\n * Box, as of the most recent committed layout. Width and height reflect\n * the space available for children (border-box minus padding and border),\n * like CSS `clientWidth`/`clientHeight`.\n *\n * ```tsx\n * function Header() {\n *   const { width } = useBoxRectDangerously()\n *   return <Text>{'='.repeat(Math.max(0, width))}</Text>\n * }\n * ```\n *\n * On first render returns `{ x: 0, y: 0, width: 0, height: 0 }`. After the\n * first commit boundary, automatically re-renders with the measured\n * dimensions. This **first-paint zero-rect transition** is the social cost\n * the rename announces — components that branch layout on this hook see a\n * flush-left / collapsed first paint, then re-flow when the real rect\n * commits one event-loop tick later. Visible jank under streaming / dynamic\n * mount / SIGWINCH burst.\n *\n * Use only when:\n * - You need a measurement read in JS control flow (animation, autoscroll\n *   thresholds, hit-testing) that **doesn't drive layout-affecting props**.\n * - No declarative primitive covers the case.\n *\n * Deferred semantics — see this file's docstring for the contract and the\n * one-frame-late behavior.\n *\n * Bead: `@km/silvery/responsive-layout-architecture-reframe` (Phase A.1\n * lands this rename; the full Phase A migrates each consumer to a\n * declarative primitive or, where genuinely needed, to a Suspense-friendly\n * `Promise<Rect>` form coordinated via `RectReadBarrier`).\n */\nexport function useBoxRectDangerously(): Rect {\n  return useReactiveRect((committed, node) => deriveInnerRect(node, committed), \"boxRectCommitted\")\n}\n\n/**\n * @deprecated Renamed to `useBoxRectDangerously`. The original name read as\n * \"the normal hook for getting your rect\" — exactly the framing the Phase\n * A.1 rename is intended to break. App authors should reach for declarative\n * primitives first; this alias remains for one release cycle and logs a\n * dev-time warning per call site. Will be removed in the next major.\n *\n * Bead: `@km/silvery/responsive-layout-architecture-reframe`.\n */\nexport function useBoxRect(): Rect {\n  // Deprecation warning fires once per call site in development. Skipped in\n  // production (won't ship) AND test (vitest's fail-on-console policy would\n  // trip on every test that exercises the legacy alias — including the very\n  // tests that verify backward-compat). Silvery's own internal call sites\n  // are migrated to `useBoxRectDangerously` as part of Phase A.1, so test\n  // suites don't see the warning either way.\n  if (process.env.NODE_ENV !== \"production\" && process.env.NODE_ENV !== \"test\") {\n    warnUseBoxRectDeprecation()\n  }\n  return useReactiveRect((committed, node) => deriveInnerRect(node, committed), \"boxRectCommitted\")\n}\n\n/**\n * Internal dimensions-only variant of the deferred box rect read.\n *\n * This is for framework primitives that build width/height-derived text\n * (Divider, ProgressBar, TextArea wrapping) but do not care where their\n * parent sits on screen. It subscribes to the same committed boxRect signal\n * as `useBoxRect()`, but only re-renders when the derived inner\n * `{width,height}` changes. Scrolling and virtual-window spacer movement\n * often change x/y without changing dimensions; full-rect subscriptions wake\n * these primitives on every such frame and steal scroll budget.\n */\nexport function useBoxSize(): BoxSize {\n  const node = useContext(NodeContext)\n  const [, forceUpdate] = useReducer((x: number) => x + 1, 0)\n  const prevRef = useRef<BoxSize | null>(null)\n\n  useLayoutEffect(() => {\n    if (!node) return\n\n    markObservedLayoutSignal(node, \"boxSize\")\n    const signals = getLayoutSignals(node)\n\n    const dispose = effect(() => {\n      const rect = deriveInnerRect(node, signals.boxRectCommitted())\n      const next = rect ? { width: rect.width, height: rect.height } : EMPTY_SIZE\n      const prev = prevRef.current\n      if (!prev || prev.width !== next.width || prev.height !== next.height) {\n        prevRef.current = next\n        forceUpdate()\n      }\n    })\n\n    return dispose\n  }, [node])\n\n  if (!node) return EMPTY_SIZE\n  markObservedLayoutSignal(node, \"boxSize\")\n  const rect = deriveInnerRect(node, getLayoutSignals(node).boxRectCommitted())\n  return rect ? { width: rect.width, height: rect.height } : EMPTY_SIZE\n}\n\nconst useBoxRectWarnedCallSites = new Set<string>()\n\nfunction warnUseBoxRectDeprecation(): void {\n  // Dedupe per-call-site so the warning fires once per source location, not\n  // once per render. The first stack frame outside this file is the consumer.\n  const stack = new Error().stack ?? \"\"\n  const lines = stack.split(\"\\n\")\n  let consumerFrame = \"\"\n  for (let i = 1; i < lines.length; i++) {\n    const line = lines[i] ?? \"\"\n    if (!line.includes(\"useLayout.ts\") && line.trim().startsWith(\"at \")) {\n      consumerFrame = line.trim()\n      break\n    }\n  }\n  const key = consumerFrame || \"<unknown>\"\n  if (useBoxRectWarnedCallSites.has(key)) return\n  useBoxRectWarnedCallSites.add(key)\n  // eslint-disable-next-line no-console\n  console.warn(\n    `[silvery] useBoxRect() is deprecated — rename to useBoxRectDangerously(), or migrate to a declarative primitive ` +\n      `(<Box fitWidth>, useResponsiveBoxProps, useResponsiveValue, useOnBoxRectCommitted). ` +\n      `See @km/silvery/responsive-layout-architecture-reframe. Call site: ${key}`,\n  )\n}\n\n// ============================================================================\n// scrollRect — scroll-adjusted position (pre-sticky clamping)\n// ============================================================================\n\n/**\n * Returns the scroll-adjusted position for the current component, as of\n * the most recent committed layout.\n *\n * This is the node's position in scroll coordinates, *before* sticky\n * clamping. For non-sticky nodes it equals `useScreenRect()`. For sticky\n * nodes, the scrollRect reflects where the node would be without sticky\n * adjustment — so it can go off-screen (negative y, etc.) when scrolled\n * past.\n *\n * ```tsx\n * function Card({ id }) {\n *   const { y } = useScrollRect()\n *   return <Box>Scroll y: {y}</Box>\n * }\n * ```\n *\n * Deferred semantics — see this file's docstring.\n */\nexport function useScrollRect(): Rect {\n  return useReactiveRect((committed) => committed, \"scrollRectCommitted\")\n}\n\n// ============================================================================\n// screenRect — actual paint position on the terminal screen\n// ============================================================================\n\n/**\n * Returns the actual paint position on the terminal screen as of the most\n * recent committed layout — the silvery analogue of\n * `getBoundingClientRect()`.\n *\n * For non-sticky nodes this equals `useScrollRect()`. For sticky nodes\n * (`position=\"sticky\"`), it reflects the clamped position where pixels\n * actually land on screen.\n *\n * ```tsx\n * function StickyHeader() {\n *   const { y } = useScreenRect()\n *   return <Box position=\"sticky\" stickyTop={0}>Header at row {y}</Box>\n * }\n * ```\n *\n * Deferred semantics — see this file's docstring.\n */\nexport function useScreenRect(): Rect {\n  return useReactiveRect((committed) => committed, \"screenRectCommitted\")\n}\n\n// ============================================================================\n// In-flight escape hatches — read the live (mid-batch) rect signal\n// ============================================================================\n//\n// The reactive `useBoxRect()` / `useScrollRect()` / `useScreenRect()` hooks\n// return the COMMITTED rect (one frame deferred) — see this file's docstring\n// for the contract. The committed-only contract eliminates render → write →\n// re-measure feedback loops by construction, but it forces components that\n// genuinely need first-paint dimensions to wait one frame.\n//\n// `useBoxRectInFlight()` / `useScrollRectInFlight()` / `useScreenRectInFlight()`\n// subscribe to the IN-FLIGHT signal — the rect as written by the most recent\n// layout pass within the current convergence cycle. The value can change\n// between convergence passes within a single event batch, so a render that\n// reads it AND writes a layout-affecting prop CAN form a feedback edge.\n//\n// **For silvery framework internals only.** Image, useCursor, useGridPosition,\n// and ListView's viewport-tracking path are the real consumers — leaf\n// primitives whose first-paint measurement is critical for scroll, decoration,\n// or absolute-positioning math, and which don't drive layout-affecting props\n// back into the React tree. (Lane snapping, once an in-flight consumer here,\n// now lives in the engine as the `fitWidth` Box prop and doesn't reach for\n// these hooks at all.)\n//\n// **Lint-gated.** App code (silvercode, km-tui, downstream consumers) must\n// not import these hooks — the ESLint rule `silvery/no-in-flight-rect-in-app`\n// blocks imports from outside `vendor/silvery/`. App code that needs\n// first-paint layout decisions must use `useResponsiveBoxProps` /\n// `useResponsiveValue` (declarative, no measurement reads) — the path\n// documented in [The Silvery Way §2](../../docs/guide/the-silvery-way.md).\n//\n// **Why both forms exist.** The deferred form is the safe default; the\n// in-flight form is an explicit escape hatch acknowledging that silvery's\n// own primitives can't always wait one frame for measurement. Naming the\n// escape hatch `*InFlight` makes the cost legible at the call site.\n//\n// See bead `@km/silvery/usebox-rect-deferred-only-breaks-first-paint`.\n\n/**\n * In-flight reactive rect hook (escape hatch): subscribes to the LIVE rect\n * signal — the value as written by the most recent layout pass within the\n * current convergence cycle. Re-renders when the in-flight value advances,\n * which can happen multiple times per event batch as the convergence loop\n * iterates.\n *\n * Use only inside silvery framework internals where first-paint measurement\n * is required and the consumer does not write layout-affecting props\n * derived from the read. App code must use the deferred form\n * (`useBoxRect()` / `useScrollRect()` / `useScreenRect()`) or\n * `useResponsiveBoxProps`/`useResponsiveValue` instead.\n */\nfunction useReactiveRectInFlight(\n  getDerivedRect: (raw: Rect | null, node: AgNode) => Rect | null | undefined,\n  inFlightSignalKey: InFlightRectSignalKey,\n): Rect {\n  const node = useContext(NodeContext)\n  const [, forceUpdate] = useReducer((x: number) => x + 1, 0)\n  const prevRef = useRef<Rect | null>(null)\n\n  useLayoutEffect(() => {\n    if (!node) return\n\n    markObservedLayoutSignal(node, IN_FLIGHT_RECT_OBSERVED_KEY[inFlightSignalKey])\n    const signals = getLayoutSignals(node)\n    const rectSignal = signals[inFlightSignalKey]\n\n    // effect() subscribes to the IN-FLIGHT signal — re-runs whenever the\n    // signal advances, including mid-batch as the convergence loop iterates.\n    // This is intentionally permissive vs the committed form; consumers that\n    // can't accept first-paint zero-rect (Image, useCursor, useGridPosition)\n    // opt in via this hook.\n    const dispose = effect(() => {\n      const raw = rectSignal()\n      const next = getDerivedRect(raw, node) ?? null\n      if (!rectEqual(prevRef.current, next)) {\n        prevRef.current = next\n        forceUpdate()\n      }\n    })\n\n    return dispose\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [node])\n\n  if (!node) return EMPTY_RECT\n  // Synchronous read (called during render): use the in-flight signal\n  // directly (NOT `node.boxRect` — that bypasses the reactive subscription\n  // edge and would let the render see one value while the effect sees\n  // another). The in-flight signal value reflects the most recent layout\n  // pass; it may differ between convergence passes within a batch.\n  markObservedLayoutSignal(node, IN_FLIGHT_RECT_OBSERVED_KEY[inFlightSignalKey])\n  const signals = getLayoutSignals(node)\n  const raw = signals[inFlightSignalKey]()\n  return getDerivedRect(raw, node) ?? EMPTY_RECT\n}\n\n/**\n * Returns the inner content dimensions of the current Box from the IN-FLIGHT\n * signal — the value as of the most recent layout pass, which may change\n * between convergence passes within an event batch.\n *\n * Silvery framework internals only — app code must use {@link useBoxRect}\n * (deferred) or `useResponsiveBoxProps`/`useResponsiveValue` instead.\n *\n * Unlike {@link useBoxRect} (the deferred form), this hook returns the\n * measured value on the first render after layout — there is no one-frame\n * fallback. The cost is that a render reading this hook AND writing a\n * layout-affecting prop can form a convergence-loop feedback edge; the\n * lint rule `silvery/no-in-flight-rect-in-app` enforces the call-site\n * scope.\n */\nexport function useBoxRectInFlight(): Rect {\n  return useReactiveRectInFlight((raw, node) => deriveInnerRect(node, raw), \"boxRect\")\n}\n\n/**\n * Returns the scroll-adjusted position from the IN-FLIGHT signal — the\n * value as of the most recent layout pass, which may change between\n * convergence passes within an event batch.\n *\n * Silvery framework internals only — see {@link useBoxRectInFlight} for\n * the contract and the lint rule that gates app-code use.\n */\nexport function useScrollRectInFlight(): Rect {\n  return useReactiveRectInFlight((raw) => raw, \"scrollRect\")\n}\n\n/**\n * Returns the actual paint position from the IN-FLIGHT signal — the value\n * as of the most recent layout pass, which may change between convergence\n * passes within an event batch.\n *\n * Silvery framework internals only — see {@link useBoxRectInFlight} for\n * the contract and the lint rule that gates app-code use.\n */\nexport function useScreenRectInFlight(): Rect {\n  return useReactiveRectInFlight((raw) => raw, \"screenRect\")\n}\n\n// ============================================================================\n// Callback observers — fire on commit boundary without triggering re-render\n// ============================================================================\n//\n// The reactive `useBoxRect()` / `useScrollRect()` / `useScreenRect()` hooks\n// re-render the consuming component every time the committed rect advances.\n// For hot paths where the rect change should NOT re-render the consumer\n// (cursor positioning, grid registry, decoration emission), the callback\n// observers below subscribe directly to the committed signal and invoke\n// `cb(rect)` at every commit boundary — no React state churn, no re-render.\n//\n// Restored 2026-05-10 to address the perf regression introduced by removing\n// the callback overload from `useBoxRect()` in silvery `63938779b6`. The\n// previous callback form was `useBoxRect((rect) => …)` overloaded on the\n// reactive hook; that fused two distinct contracts into one signature. The\n// observer hooks below split them: reactive read + commit-boundary observer.\n\n/**\n * Subscribes to the committed rect signal and fires `cb(rect)` at each\n * commit boundary, **without** triggering a re-render of the consumer.\n *\n * Use for hot paths where a rect change drives an imperative side effect\n * (cursor store update, registry write, ANSI emission) and there is no\n * render path that needs to reflect the rect.\n *\n * The callback is invoked synchronously from a commit-boundary effect(),\n * with the derived rect (`getDerivedRect` applied to the committed signal\n * value). It is NOT invoked when the derived rect is null. The caller may\n * close over component state via refs; see `useCursor` / `useGridPosition`\n * for canonical patterns.\n */\nfunction useOnRectCommitted(\n  cb: (rect: Rect) => void,\n  getDerivedRect: (committed: Rect | null, node: AgNode) => Rect | null | undefined,\n  committedSignalKey: CommittedRectSignalKey,\n): void {\n  const node = useContext(NodeContext)\n  const cbRef = useRef(cb)\n  cbRef.current = cb\n\n  useLayoutEffect(() => {\n    if (!node) return\n\n    const signals = getLayoutSignals(node)\n    const rectSignal = signals[committedSignalKey]\n    let prev: Rect | null = null\n\n    const dispose = effect(() => {\n      const committed = rectSignal()\n      const next = getDerivedRect(committed, node) ?? null\n      if (next == null) return\n      if (rectEqual(prev, next)) return\n      prev = next\n      cbRef.current(next)\n    })\n\n    return dispose\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [node])\n}\n\n/**\n * Subscribes to the committed boxRect (inner content) and fires `cb` at\n * each commit boundary without re-rendering. See {@link useBoxRect} for\n * the deferred-rect contract; this is the observer form.\n */\nexport function useOnBoxRectCommitted(cb: (rect: Rect) => void): void {\n  useOnRectCommitted(cb, (committed, node) => deriveInnerRect(node, committed), \"boxRectCommitted\")\n}\n\n/**\n * Subscribes to the committed scrollRect and fires `cb` at each commit\n * boundary without re-rendering.\n */\nexport function useOnScrollRectCommitted(cb: (rect: Rect) => void): void {\n  useOnRectCommitted(cb, (committed) => committed, \"scrollRectCommitted\")\n}\n\n/**\n * Subscribes to the committed screenRect and fires `cb` at each commit\n * boundary without re-rendering.\n */\nexport function useOnScreenRectCommitted(cb: (rect: Rect) => void): void {\n  useOnRectCommitted(cb, (committed) => committed, \"screenRectCommitted\")\n}\n"],"mappings":"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"}

package/dist/{with-text-input-YeohVLeo.d.mts → with-text-input-DLoSCBrm.d.mts}

@@ -1,5 +1,5 @@
-import { _ as TextInputOptions, b as WithSpinnerOptions, i as ProgressGenerator, o as SelectOption, y as WithSelectOptions } from "./types-kt_fKR37.mjs";
-import { r as Spinner } from "./spinner-CZINHpkV.mjs";
+import { _ as TextInputOptions, b as WithSpinnerOptions, i as ProgressGenerator, o as SelectOption, y as WithSelectOptions } from "./types-D_E0FbqA.mjs";
+import { r as Spinner } from "./spinner-DN10UfF0.mjs";
 import { EventEmitter } from "events";
 
 //#region packages/ag-react/src/ui/wrappers/with-spinner.d.ts
@@ -230,4 +230,4 @@ interface TextInputInstance {
 }
 //#endregion
 export { waitForEvent as a, wrapGenerator as c, withSelect as i, attachSpinner as l, withTextInput as n, wrapEmitter as o, createSelect as r, withIterableProgress as s, createTextInput as t, withSpinner as u };
-//# sourceMappingURL=with-text-input-YeohVLeo.d.mts.map
+//# sourceMappingURL=with-text-input-DLoSCBrm.d.mts.map

package/dist/{with-text-input-YeohVLeo.d.mts.map → with-text-input-DLoSCBrm.d.mts.map}

@@ -1 +1 @@
-{"version":3,"file":"with-text-input-YeohVLeo.d.mts","names":[],"sources":["../packages/ag-react/src/ui/wrappers/with-spinner.ts","../packages/ag-react/src/ui/wrappers/wrap-generator.ts","../packages/ag-react/src/ui/wrappers/wrap-emitter.ts","../packages/ag-react/src/ui/wrappers/with-select.ts","../packages/ag-react/src/ui/wrappers/with-text-input.ts"],"mappings":";;;;;AA6BA;;;;;;;;;;;;;;;;;;;;;;AAAA,iBAAsB,WAAA,GAAA,CACpB,OAAA,EAAS,OAAA,CAAQ,CAAA,WAAY,CAAA,GAAI,OAAA,CAAQ,CAAA,IACzC,IAAA,aAAiB,cAAA,sBACjB,OAAA,GAAS,kBAAA,GACR,OAAA,CAAQ,CAAA;;;;;;AAmDX;;;;;;;iBAAgB,aAAA,GAAA,CACd,OAAA,EAAS,OAAA,CAAQ,CAAA,GACjB,IAAA,UACA,OAAA,GAAS,kBAAA,IACP,OAAA,CAAQ,CAAA,GAAI,OAAA;;;;AA3DhB;;;;;;;;;;;;;;;;;iBCHsB,aAAA,GAAA,CACpB,SAAA,EAAW,iBAAA,CAAkB,CAAA,GAC7B,YAAA,aAAyB,QAAA;EAAY,OAAA;EAAiB,KAAA;AAAA,eACtD,OAAA;EAAW,eAAA;AAAA,IACV,OAAA,CAAQ,CAAA;;;;;;ADsDX;;;;;;iBCeuB,oBAAA,GAAA,CACrB,QAAA,EAAU,QAAA,CAAS,CAAA,IAAK,aAAA,CAAc,CAAA,GACtC,KAAA,UACA,OAAA;EAAW,eAAA;AAAA,IACV,cAAA,CAAe,CAAA;;;;UC/FR,WAAA;EFqBuB;EEnB/B,IAAA;EFoBiB;EElBjB,OAAA,IAAW,IAAA;EFkBkB;EEhB7B,OAAA;EFgBiC;EEdjC,IAAA;EFiBS;EEfT,IAAA;AAAA;;UAIQ,iBAAA;EFQC;EENT,MAAA,EAAQ,MAAA,SAAe,WAAA;EFMM;EEJ7B,WAAA;AAAA;;;;;;;;;;AF0DF;;;;;;;;;;iBEpCgB,WAAA,CAAY,OAAA,EAAS,YAAA,EAAc,MAAA,EAAQ,iBAAA;;;;;;;;;;iBA0DrC,YAAA,CACpB,OAAA,EAAS,YAAA,EACT,SAAA,UACA,IAAA,UACA,OAAA;EACE,UAAA;EACA,OAAA;AAAA,IAED,OAAA;;;;AFrFH;;;;;;;;;;;;;;;;;;;iBGOsB,UAAA,GAAA,CACpB,MAAA,UACA,OAAA,EAAS,YAAA,CAAa,CAAA,KACtB,aAAA,GAAe,iBAAA,GACd,OAAA,CAAQ,CAAA;;;;;;;;;AH4CX;;;;;iBGgHgB,YAAA,CACd,cAAA,GAAgB,iBAAA,OACX,MAAA,UAAgB,OAAA,EAAS,YAAA,CAAa,CAAA,KAAM,SAAA,GAAY,iBAAA,KAAsB,OAAA,CAAQ,CAAA;;;;AHzK7F;;;;;;;;;;;;;;;;;;;;;iBIQsB,aAAA,CACpB,MAAA,UACA,OAAA,GAAS,gBAAA,GACR,OAAA;;;;;;;AJ4CH;;;;;;iBIkNgB,eAAA,CAAgB,MAAA,UAAgB,OAAA,GAAS,gBAAA,GAAwB,iBAAA;;UA0EhE,iBAAA;EJxRM;EI0RrB,KAAA;EJ9R4B;EIgS5B,cAAA;EJ/RiB;EIiSjB,MAAA;EJhSA;EIkSA,MAAA,CAAO,IAAA;EJjSP;EImSA,SAAA;EJlSU;EIoSV,MAAA;EJpSqB;EIsSrB,KAAA;;EAEA,gBAAA;AAAA"}
+{"version":3,"file":"with-text-input-DLoSCBrm.d.mts","names":[],"sources":["../packages/ag-react/src/ui/wrappers/with-spinner.ts","../packages/ag-react/src/ui/wrappers/wrap-generator.ts","../packages/ag-react/src/ui/wrappers/wrap-emitter.ts","../packages/ag-react/src/ui/wrappers/with-select.ts","../packages/ag-react/src/ui/wrappers/with-text-input.ts"],"mappings":";;;;;AA6BA;;;;;;;;;;;;;;;;;;;;;;AAAA,iBAAsB,WAAA,GAAA,CACpB,OAAA,EAAS,OAAA,CAAQ,CAAA,WAAY,CAAA,GAAI,OAAA,CAAQ,CAAA,IACzC,IAAA,aAAiB,cAAA,sBACjB,OAAA,GAAS,kBAAA,GACR,OAAA,CAAQ,CAAA;;;;;;AAmDX;;;;;;;iBAAgB,aAAA,GAAA,CACd,OAAA,EAAS,OAAA,CAAQ,CAAA,GACjB,IAAA,UACA,OAAA,GAAS,kBAAA,IACP,OAAA,CAAQ,CAAA,GAAI,OAAA;;;;AA3DhB;;;;;;;;;;;;;;;;;iBCHsB,aAAA,GAAA,CACpB,SAAA,EAAW,iBAAA,CAAkB,CAAA,GAC7B,YAAA,aAAyB,QAAA;EAAY,OAAA;EAAiB,KAAA;AAAA,eACtD,OAAA;EAAW,eAAA;AAAA,IACV,OAAA,CAAQ,CAAA;;;;;;ADsDX;;;;;;iBCeuB,oBAAA,GAAA,CACrB,QAAA,EAAU,QAAA,CAAS,CAAA,IAAK,aAAA,CAAc,CAAA,GACtC,KAAA,UACA,OAAA;EAAW,eAAA;AAAA,IACV,cAAA,CAAe,CAAA;;;;UC/FR,WAAA;EFqBuB;EEnB/B,IAAA;EFoBiB;EElBjB,OAAA,IAAW,IAAA;EFkBkB;EEhB7B,OAAA;EFgBiC;EEdjC,IAAA;EFiBS;EEfT,IAAA;AAAA;;UAIQ,iBAAA;EFQC;EENT,MAAA,EAAQ,MAAA,SAAe,WAAA;EFMM;EEJ7B,WAAA;AAAA;;;;;;;;;;AF0DF;;;;;;;;;;iBEpCgB,WAAA,CAAY,OAAA,EAAS,YAAA,EAAc,MAAA,EAAQ,iBAAA;;;;;;;;;;iBA0DrC,YAAA,CACpB,OAAA,EAAS,YAAA,EACT,SAAA,UACA,IAAA,UACA,OAAA;EACE,UAAA;EACA,OAAA;AAAA,IAED,OAAA;;;;AFrFH;;;;;;;;;;;;;;;;;;;iBGQsB,UAAA,GAAA,CACpB,MAAA,UACA,OAAA,EAAS,YAAA,CAAa,CAAA,KACtB,aAAA,GAAe,iBAAA,GACd,OAAA,CAAQ,CAAA;;;;;;;;;AH2CX;;;;;iBGoHgB,YAAA,CACd,cAAA,GAAgB,iBAAA,OACX,MAAA,UAAgB,OAAA,EAAS,YAAA,CAAa,CAAA,KAAM,SAAA,GAAY,iBAAA,KAAsB,OAAA,CAAQ,CAAA;;;;AH7K7F;;;;;;;;;;;;;;;;;;;;;iBISsB,aAAA,CACpB,MAAA,UACA,OAAA,GAAS,gBAAA,GACR,OAAA;;;;;;;AJ2CH;;;;;;iBIkNgB,eAAA,CAAgB,MAAA,UAAgB,OAAA,GAAS,gBAAA,GAAwB,iBAAA;;UA0EhE,iBAAA;EJxRM;EI0RrB,KAAA;EJ9R4B;EIgS5B,cAAA;EJ/RiB;EIiSjB,MAAA;EJhSA;EIkSA,MAAA,CAAO,IAAA;EJjSP;EImSA,SAAA;EJlSU;EIoSV,MAAA;EJpSqB;EIsSrB,KAAA;;EAEA,gBAAA;AAAA"}