silvery 0.21.0 → 0.23.0

package/dist/{progress-bar-oJwq22CR.mjs.map → progress-bar-BlFNsZL8.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"progress-bar-oJwq22CR.mjs","names":[],"sources":["../packages/ag-react/src/ui/cli/progress-bar.ts"],"sourcesContent":["/**\n * CLI ProgressBar - Determinate progress indicator with ETA\n */\n\nimport chalk from \"@silvery/ink/chalk\"\nimport type { ProgressBarOptions } from \"../types.js\"\nimport {\n  CURSOR_HIDE,\n  CURSOR_SHOW,\n  CURSOR_TO_START,\n  CLEAR_LINE_END,\n  write,\n  isTTY,\n  getTerminalWidth,\n} from \"./ansi\"\nimport { calculateETA, formatETA, DEFAULT_ETA_BUFFER_SIZE, type ETASample } from \"../utils/eta\"\n\n/** Default format string */\nconst DEFAULT_FORMAT = \":bar :percent | :current/:total | ETA: :eta\"\n\n/**\n * ProgressBar class for CLI progress indication\n *\n * @example\n * ```ts\n * const bar = new ProgressBar({ total: 100 });\n * bar.start();\n * for (let i = 0; i <= 100; i++) {\n *   await doWork();\n *   bar.update(i);\n * }\n * bar.stop();\n * ```\n */\nexport class ProgressBar {\n  private total: number\n  private format: string\n  private width: number\n  private complete: string\n  private incomplete: string\n  private stream: NodeJS.WriteStream\n  private hideCursor: boolean\n  private phases: Record<string, string>\n\n  private current = 0\n  private phase: string | null = null\n  private startTime: number | null = null\n  private isActive = false\n\n  // ETA smoothing - track last N update times\n  private etaBuffer: ETASample[] = []\n\n  constructor(options: ProgressBarOptions = {}) {\n    this.total = options.total ?? 100\n    this.format = options.format ?? DEFAULT_FORMAT\n    this.width = options.width ?? 40\n    this.complete = options.complete ?? \"█\"\n    this.incomplete = options.incomplete ?? \"░\"\n    this.stream = options.stream ?? process.stdout\n    this.hideCursor = options.hideCursor ?? true\n    this.phases = options.phases ?? {}\n  }\n\n  /**\n   * Start the progress bar\n   */\n  start(initialValue = 0, initialTotal?: number): this {\n    if (initialTotal !== undefined) {\n      this.total = initialTotal\n    }\n\n    this.current = initialValue\n    this.startTime = Date.now()\n    this.isActive = true\n    this.etaBuffer = [{ time: this.startTime, value: initialValue }]\n\n    if (this.hideCursor && isTTY(this.stream)) {\n      write(CURSOR_HIDE, this.stream)\n    }\n\n    this.render()\n    return this\n  }\n\n  /**\n   * Update progress value\n   */\n  update(value: number, tokens?: Record<string, string | number>): this {\n    this.current = Math.min(value, this.total)\n\n    // Update ETA buffer\n    const now = Date.now()\n    this.etaBuffer.push({ time: now, value: this.current })\n    if (this.etaBuffer.length > DEFAULT_ETA_BUFFER_SIZE) {\n      this.etaBuffer.shift()\n    }\n\n    if (this.isActive) {\n      this.render(tokens)\n    }\n\n    return this\n  }\n\n  /**\n   * Increment progress by amount (default: 1)\n   */\n  increment(amount = 1, tokens?: Record<string, string | number>): this {\n    return this.update(this.current + amount, tokens)\n  }\n\n  /**\n   * Set the current phase (for multi-phase progress)\n   */\n  setPhase(phaseName: string, options?: { current?: number; total?: number }): this {\n    this.phase = phaseName\n\n    if (options?.total !== undefined) {\n      this.total = options.total\n    }\n    if (options?.current !== undefined) {\n      this.current = options.current\n      // Reset ETA buffer on phase change\n      this.etaBuffer = [{ time: Date.now(), value: this.current }]\n    }\n\n    if (this.isActive) {\n      this.render()\n    }\n\n    return this\n  }\n\n  /**\n   * Stop the progress bar\n   */\n  stop(clear = false): this {\n    if (!this.isActive) {\n      return this\n    }\n\n    this.isActive = false\n\n    if (clear && isTTY(this.stream)) {\n      write(`${CURSOR_TO_START}${CLEAR_LINE_END}`, this.stream)\n    } else {\n      write(\"\\n\", this.stream)\n    }\n\n    if (this.hideCursor && isTTY(this.stream)) {\n      write(CURSOR_SHOW, this.stream)\n    }\n\n    return this\n  }\n\n  /** Get ETA in seconds using smoothed rate */\n  private getETASeconds(): number | null {\n    return calculateETA(this.etaBuffer, this.current, this.total)\n  }\n\n  /**\n   * Render the progress bar\n   */\n  private render(tokens?: Record<string, string | number>): void {\n    const percent = this.total > 0 ? this.current / this.total : 0\n    const eta = this.getETASeconds()\n\n    // Build the bar\n    const completeLength = Math.round(this.width * percent)\n    const incompleteLength = this.width - completeLength\n    const bar = this.complete.repeat(completeLength) + this.incomplete.repeat(incompleteLength)\n\n    // Get phase display name\n    const phaseDisplay = this.phase ? (this.phases[this.phase] ?? this.phase) : \"\"\n\n    // Calculate rate\n    const elapsed = this.startTime ? (Date.now() - this.startTime) / 1000 : 0\n    const rate = elapsed > 0 ? this.current / elapsed : 0\n\n    // Replace tokens in format string\n    let output = this.format\n      .replace(\":bar\", chalk.cyan(bar))\n      .replace(\":percent\", `${Math.round(percent * 100)}%`.padStart(4))\n      .replace(\":current\", String(this.current))\n      .replace(\":total\", String(this.total))\n      .replace(\":eta\", formatETA(eta))\n      .replace(\":elapsed\", formatETA(elapsed))\n      .replace(\":rate\", rate.toFixed(1))\n      .replace(\":phase\", chalk.dim(phaseDisplay))\n\n    // Replace custom tokens\n    if (tokens) {\n      for (const [key, value] of Object.entries(tokens)) {\n        output = output.replace(`:${key}`, String(value))\n      }\n    }\n\n    // Truncate to terminal width\n    const termWidth = getTerminalWidth(this.stream)\n    if (output.length > termWidth) {\n      output = output.slice(0, termWidth - 1)\n    }\n\n    if (isTTY(this.stream)) {\n      write(`${CURSOR_TO_START}${output}${CLEAR_LINE_END}`, this.stream)\n    }\n  }\n\n  /**\n   * Get current progress ratio (0-1)\n   */\n  get ratio(): number {\n    return this.total > 0 ? this.current / this.total : 0\n  }\n\n  /**\n   * Get current progress percentage (0-100)\n   */\n  get percentage(): number {\n    return Math.round(this.ratio * 100)\n  }\n\n  /**\n   * Dispose the progress bar (calls stop)\n   */\n  [Symbol.dispose](): void {\n    this.stop()\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"progress-bar-BlFNsZL8.mjs","names":[],"sources":["../packages/ag-react/src/ui/cli/progress-bar.ts"],"sourcesContent":["/**\n * CLI ProgressBar - Determinate progress indicator with ETA\n */\n\nimport chalk from \"@silvery/ink/chalk\"\nimport type { ProgressBarOptions } from \"../types.js\"\nimport {\n  CURSOR_HIDE,\n  CURSOR_SHOW,\n  CURSOR_TO_START,\n  CLEAR_LINE_END,\n  write,\n  isTTY,\n  getTerminalWidth,\n} from \"./ansi\"\nimport { calculateETA, formatETA, DEFAULT_ETA_BUFFER_SIZE, type ETASample } from \"../utils/eta\"\n\n/** Default format string */\nconst DEFAULT_FORMAT = \":bar :percent | :current/:total | ETA: :eta\"\n\n/**\n * ProgressBar class for CLI progress indication\n *\n * @example\n * ```ts\n * const bar = new ProgressBar({ total: 100 });\n * bar.start();\n * for (let i = 0; i <= 100; i++) {\n *   await doWork();\n *   bar.update(i);\n * }\n * bar.stop();\n * ```\n */\nexport class ProgressBar {\n  private total: number\n  private format: string\n  private width: number\n  private complete: string\n  private incomplete: string\n  private stream: NodeJS.WriteStream\n  private hideCursor: boolean\n  private phases: Record<string, string>\n\n  private current = 0\n  private phase: string | null = null\n  private startTime: number | null = null\n  private isActive = false\n\n  // ETA smoothing - track last N update times\n  private etaBuffer: ETASample[] = []\n\n  constructor(options: ProgressBarOptions = {}) {\n    this.total = options.total ?? 100\n    this.format = options.format ?? DEFAULT_FORMAT\n    this.width = options.width ?? 40\n    this.complete = options.complete ?? \"█\"\n    this.incomplete = options.incomplete ?? \"░\"\n    this.stream = options.stream ?? process.stdout\n    this.hideCursor = options.hideCursor ?? true\n    this.phases = options.phases ?? {}\n  }\n\n  /**\n   * Start the progress bar\n   */\n  start(initialValue = 0, initialTotal?: number): this {\n    if (initialTotal !== undefined) {\n      this.total = initialTotal\n    }\n\n    this.current = initialValue\n    this.startTime = Date.now()\n    this.isActive = true\n    this.etaBuffer = [{ time: this.startTime, value: initialValue }]\n\n    if (this.hideCursor && isTTY(this.stream)) {\n      write(CURSOR_HIDE, this.stream)\n    }\n\n    this.render()\n    return this\n  }\n\n  /**\n   * Update progress value\n   */\n  update(value: number, tokens?: Record<string, string | number>): this {\n    this.current = Math.min(value, this.total)\n\n    // Update ETA buffer\n    const now = Date.now()\n    this.etaBuffer.push({ time: now, value: this.current })\n    if (this.etaBuffer.length > DEFAULT_ETA_BUFFER_SIZE) {\n      this.etaBuffer.shift()\n    }\n\n    if (this.isActive) {\n      this.render(tokens)\n    }\n\n    return this\n  }\n\n  /**\n   * Increment progress by amount (default: 1)\n   */\n  increment(amount = 1, tokens?: Record<string, string | number>): this {\n    return this.update(this.current + amount, tokens)\n  }\n\n  /**\n   * Set the current phase (for multi-phase progress)\n   */\n  setPhase(phaseName: string, options?: { current?: number; total?: number }): this {\n    this.phase = phaseName\n\n    if (options?.total !== undefined) {\n      this.total = options.total\n    }\n    if (options?.current !== undefined) {\n      this.current = options.current\n      // Reset ETA buffer on phase change\n      this.etaBuffer = [{ time: Date.now(), value: this.current }]\n    }\n\n    if (this.isActive) {\n      this.render()\n    }\n\n    return this\n  }\n\n  /**\n   * Stop the progress bar\n   */\n  stop(clear = false): this {\n    if (!this.isActive) {\n      return this\n    }\n\n    this.isActive = false\n\n    if (clear && isTTY(this.stream)) {\n      write(`${CURSOR_TO_START}${CLEAR_LINE_END}`, this.stream)\n    } else {\n      write(\"\\n\", this.stream)\n    }\n\n    if (this.hideCursor && isTTY(this.stream)) {\n      write(CURSOR_SHOW, this.stream)\n    }\n\n    return this\n  }\n\n  /** Get ETA in seconds using smoothed rate */\n  private getETASeconds(): number | null {\n    return calculateETA(this.etaBuffer, this.current, this.total)\n  }\n\n  /**\n   * Render the progress bar\n   */\n  private render(tokens?: Record<string, string | number>): void {\n    const percent = this.total > 0 ? this.current / this.total : 0\n    const eta = this.getETASeconds()\n\n    // Build the bar\n    const completeLength = Math.round(this.width * percent)\n    const incompleteLength = this.width - completeLength\n    const bar = this.complete.repeat(completeLength) + this.incomplete.repeat(incompleteLength)\n\n    // Get phase display name\n    const phaseDisplay = this.phase ? (this.phases[this.phase] ?? this.phase) : \"\"\n\n    // Calculate rate\n    const elapsed = this.startTime ? (Date.now() - this.startTime) / 1000 : 0\n    const rate = elapsed > 0 ? this.current / elapsed : 0\n\n    // Replace tokens in format string\n    let output = this.format\n      .replace(\":bar\", chalk.cyan(bar))\n      .replace(\":percent\", `${Math.round(percent * 100)}%`.padStart(4))\n      .replace(\":current\", String(this.current))\n      .replace(\":total\", String(this.total))\n      .replace(\":eta\", formatETA(eta))\n      .replace(\":elapsed\", formatETA(elapsed))\n      .replace(\":rate\", rate.toFixed(1))\n      .replace(\":phase\", chalk.dim(phaseDisplay))\n\n    // Replace custom tokens\n    if (tokens) {\n      for (const [key, value] of Object.entries(tokens)) {\n        output = output.replace(`:${key}`, String(value))\n      }\n    }\n\n    // Truncate to terminal width\n    const termWidth = getTerminalWidth(this.stream)\n    if (output.length > termWidth) {\n      output = output.slice(0, termWidth - 1)\n    }\n\n    if (isTTY(this.stream)) {\n      write(`${CURSOR_TO_START}${output}${CLEAR_LINE_END}`, this.stream)\n    }\n  }\n\n  /**\n   * Get current progress ratio (0-1)\n   */\n  get ratio(): number {\n    return this.total > 0 ? this.current / this.total : 0\n  }\n\n  /**\n   * Get current progress percentage (0-100)\n   */\n  get percentage(): number {\n    return Math.round(this.ratio * 100)\n  }\n\n  /**\n   * Dispose the progress bar (calls stop)\n   */\n  [Symbol.dispose](): void {\n    this.stop()\n  }\n}\n"],"mappings":"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"}

package/dist/{reconciler-DldIJB93.mjs → reconciler--_-biN23.mjs}

@@ -1,11 +1,113 @@
-import { d as syncTextContentSignal } from "./layout-signals-Cnw6xk8Q.mjs";
-import { k as warnOnce, t as init_src } from "./src-BNTToU7l.mjs";
-import { A as getActiveLineHeight, D as displayWidth, rt as wrapText, z as isSoftBreakPoint } from "./ansi-yC4RyBNY.mjs";
-import { a as requireCapability, n as getConstants, r as getLayoutEngine } from "./layout-engine-C2px0RJE.mjs";
-import { createContext } from "react";
+import { m as syncTextContentSignal } from "./layout-signals-CGYbHmxy.mjs";
+import { I as wrapText, i as displayWidth, l as getActiveLineHeight, v as isSoftBreakPoint } from "./unicode-CxyxVGmB.mjs";
+import { O as warnOnce } from "./src-B8lf1kiR.mjs";
+import { a as requireCapability, n as getConstants, r as getLayoutEngine } from "./layout-engine-BgR58vL0.mjs";
 import { createLogger } from "loggily";
+import { createContext } from "react";
 import Reconciler from "react-reconciler";
 import { DefaultEventPriority, DiscreteEventPriority, NoEventPriority } from "react-reconciler/constants.js";
+//#region packages/ag/src/epoch.ts
+/**
+* The current render epoch. Incremented after each render pass.
+* Reconciler stamps dirty nodes with this value; render phase checks equality.
+*/
+let renderEpoch = 0;
+/** Get the current render epoch value. */
+function getRenderEpoch() {
+	return renderEpoch;
+}
+/**
+* Advance the render epoch. Called once at the end of each render pass.
+* All nodes stamped with the old epoch instantly become "not dirty".
+*/
+function advanceRenderEpoch() {
+	renderEpoch++;
+}
+/**
+* Check if an epoch stamp matches the current render epoch (i.e., "is dirty").
+*/
+function isCurrentEpoch(epoch) {
+	return epoch === renderEpoch;
+}
+/**
+* Check if a specific dirty bit is set for the current epoch.
+* Returns true if dirtyEpoch matches the current render epoch AND the bit is set.
+*/
+function isDirty(dirtyBits, dirtyEpoch, bit) {
+	return dirtyEpoch === renderEpoch && (dirtyBits & bit) !== 0;
+}
+/**
+* Check if ANY dirty bit is set for the current epoch.
+*/
+function isAnyDirty(dirtyBits, dirtyEpoch) {
+	return dirtyEpoch === renderEpoch && dirtyBits !== 0;
+}
+//#endregion
+//#region packages/ag-term/src/pipeline/collect-text.ts
+/**
+* Collect plain text from a node tree, applying internal_transform.
+*
+* This is the base traversal used by:
+* - measure-phase.ts (fit-content measurement)
+* - render-text.ts (DOM-level truncation budget)
+*
+* Does NOT filter hidden or display:none nodes — those are handled by
+* the layout engine (display:none gets 0x0 size) or by other phases.
+*/
+function collectPlainText(node) {
+	if (node.textContent !== void 0) return node.textContent;
+	let result = "";
+	for (let i = 0; i < node.children.length; i++) {
+		const child = node.children[i];
+		let childText = collectPlainText(child);
+		if (childText.length > 0 && child.props.internal_transform) childText = child.props.internal_transform(childText, i);
+		result += childText;
+	}
+	return result;
+}
+/**
+* Collect plain text from a node tree, skipping hidden children.
+*
+* Used by the reconciler's Yoga measure function where hidden nodes
+* (from Suspense) must not contribute to measured size.
+*
+* Identical to collectPlainText except for the hidden check.
+*/
+function collectPlainTextSkipHidden(node) {
+	if (node.textContent !== void 0) return node.textContent;
+	let result = "";
+	for (let i = 0; i < node.children.length; i++) {
+		const child = node.children[i];
+		if (child.hidden) continue;
+		let childText = collectPlainTextSkipHidden(child);
+		if (childText.length > 0 && child.props.internal_transform) childText = child.props.internal_transform(childText, i);
+		result += childText;
+	}
+	return result;
+}
+//#endregion
+//#region packages/ag-term/src/pipeline/measure-stats.ts
+/**
+* Profiling counters for measure function performance analysis (dev only).
+*
+* Shared between @silvery/ag-react/reconciler/nodes (where measure happens)
+* and @silvery/ag-term/pipeline/layout-phase (where stats are logged).
+*
+* Lives in @silvery/ag-term to keep the @silvery/ag-term barrel React-free.
+*/
+const measureStats = {
+	calls: 0,
+	cacheHits: 0,
+	textCollects: 0,
+	displayWidthCalls: 0,
+	reset() {
+		this.calls = 0;
+		this.cacheHits = 0;
+		this.textCollects = 0;
+		this.displayWidthCalls = 0;
+	}
+};
+//#endregion
 //#region packages/ag/src/dirty-tracking.ts
 /**
 * Nodes with any content/style dirty flag. Written by reconciler,
@@ -59,43 +161,6 @@ function clearDirtyTracking() {
 	scrollDirtyNodes.clear();
 }
 //#endregion
-//#region packages/ag/src/epoch.ts
-/**
-* The current render epoch. Incremented after each render pass.
-* Reconciler stamps dirty nodes with this value; render phase checks equality.
-*/
-let renderEpoch = 0;
-/** Get the current render epoch value. */
-function getRenderEpoch() {
-	return renderEpoch;
-}
-/**
-* Advance the render epoch. Called once at the end of each render pass.
-* All nodes stamped with the old epoch instantly become "not dirty".
-*/
-function advanceRenderEpoch() {
-	renderEpoch++;
-}
-/**
-* Check if an epoch stamp matches the current render epoch (i.e., "is dirty").
-*/
-function isCurrentEpoch(epoch) {
-	return epoch === renderEpoch;
-}
-/**
-* Check if a specific dirty bit is set for the current epoch.
-* Returns true if dirtyEpoch matches the current render epoch AND the bit is set.
-*/
-function isDirty(dirtyBits, dirtyEpoch, bit) {
-	return dirtyEpoch === renderEpoch && (dirtyBits & bit) !== 0;
-}
-/**
-* Check if ANY dirty bit is set for the current epoch.
-*/
-function isAnyDirty(dirtyBits, dirtyEpoch) {
-	return dirtyEpoch === renderEpoch && dirtyBits !== 0;
-}
-//#endregion
 //#region packages/scope/src/trace.ts
 /**
 * @silvery/scope/trace — opt-in leak detector for scopes and disposables.
@@ -601,71 +666,6 @@ function reportDisposeError(error, context) {
 	} catch {}
 }
 //#endregion
-//#region packages/ag-term/src/pipeline/collect-text.ts
-/**
-* Collect plain text from a node tree, applying internal_transform.
-*
-* This is the base traversal used by:
-* - measure-phase.ts (fit-content measurement)
-* - render-text.ts (DOM-level truncation budget)
-*
-* Does NOT filter hidden or display:none nodes — those are handled by
-* the layout engine (display:none gets 0x0 size) or by other phases.
-*/
-function collectPlainText(node) {
-	if (node.textContent !== void 0) return node.textContent;
-	let result = "";
-	for (let i = 0; i < node.children.length; i++) {
-		const child = node.children[i];
-		let childText = collectPlainText(child);
-		if (childText.length > 0 && child.props.internal_transform) childText = child.props.internal_transform(childText, i);
-		result += childText;
-	}
-	return result;
-}
-/**
-* Collect plain text from a node tree, skipping hidden children.
-*
-* Used by the reconciler's Yoga measure function where hidden nodes
-* (from Suspense) must not contribute to measured size.
-*
-* Identical to collectPlainText except for the hidden check.
-*/
-function collectPlainTextSkipHidden(node) {
-	if (node.textContent !== void 0) return node.textContent;
-	let result = "";
-	for (let i = 0; i < node.children.length; i++) {
-		const child = node.children[i];
-		if (child.hidden) continue;
-		let childText = collectPlainTextSkipHidden(child);
-		if (childText.length > 0 && child.props.internal_transform) childText = child.props.internal_transform(childText, i);
-		result += childText;
-	}
-	return result;
-}
-//#endregion
-//#region packages/ag-term/src/pipeline/measure-stats.ts
-/**
-* Profiling counters for measure function performance analysis (dev only).
-*
-* Shared between @silvery/ag-react/reconciler/nodes (where measure happens)
-* and @silvery/ag-term/pipeline/layout-phase (where stats are logged).
-*
-* Lives in @silvery/ag-term to keep the @silvery/ag-term barrel React-free.
-*/
-const measureStats = {
-	calls: 0,
-	cacheHits: 0,
-	textCollects: 0,
-	displayWidthCalls: 0,
-	reset() {
-		this.calls = 0;
-		this.cacheHits = 0;
-		this.textCollects = 0;
-		this.displayWidthCalls = 0;
-	}
-};
-//#endregion
 //#region packages/ag-react/src/reconciler/helpers.ts
 /**
 * Reconciler Helper Functions
@@ -729,9 +729,16 @@ const LAYOUT_PROPS = new Set([
 ]);
 /**
 * Set of content props that affect layout dimensions (trigger contentDirty + Flexily markDirty()).
-* wrap changes text line count; internal_transform changes text width.
+* wrap changes text line count; internal_transform changes text width; truncate
+* is a per-line elision hook whose output changes the painted line, so a change
+* to it must force a content re-render (its identity is unstable across renders,
+* which is also why render-text.ts bypasses the format cache when it is present).
 */
-const TEXT_CONTENT_PROPS = new Set(["wrap", "internal_transform"]);
+const TEXT_CONTENT_PROPS = new Set([
+	"wrap",
+	"internal_transform",
+	"truncate"
+]);
 /**
 * Set of style props that affect content (paint) but NOT layout dimensions.
 * borderColor, color, bold, etc. don't change how much space a node takes.
@@ -741,8 +748,10 @@ const TEXT_CONTENT_PROPS = new Set(["wrap", "internal_transform"]);
 */
 const STYLE_PROPS = new Set([
 	"color",
+	"truncateMarkerColor",
 	"backgroundColor",
 	"bold",
+	"internal_dim",
 	"italic",
 	"underline",
 	"underlineStyle",
@@ -764,6 +773,8 @@ const STYLE_PROPS = new Set([
 	"outlineBottom",
 	"outlineLeft",
 	"outlineRight",
+	"data-subtree-fade",
+	"userSelect",
 	"theme"
 ]);
 /** Shared singleton for the no-changes fast path (identity check). */
@@ -1342,7 +1353,6 @@ function justifyToConstant(justify) {
 * This is the bridge between React's reconciliation algorithm
 * and our custom terminal node tree.
 */
-init_src();
 const log = createLogger("silvery:reconciler");
 const mountLog = createLogger("silvery:mount");
 const DEBUG_PROP_NAMES = [
@@ -1435,19 +1445,42 @@ function normalizeNodeType(type) {
 	if (type === "ink-text") return "silvery-text";
 	return type;
 }
-/**
-* Callback invoked when a node is removed from the tree.
-* Used by the app layer to coordinate focus cleanup — if the focused element
-* is within a removed subtree, focus must be cleared to prevent dangling
-* references and broken navigation (indexOf → -1, hasFocusWithin lies).
-*/
-let onNodeRemovedCallback = null;
-/**
-* Register a callback to be called when any node is removed from the tree.
-* Returns a cleanup function to unregister. Only one callback at a time.
-*/
-function setOnNodeRemoved(callback) {
-	onNodeRemovedCallback = callback;
+const NODE_CONTAINERS_KEY = Symbol.for("@silvery/ag-react/reconciler/nodeContainers");
+const nodeContainers = globalThis[NODE_CONTAINERS_KEY] ?? (globalThis[NODE_CONTAINERS_KEY] = /* @__PURE__ */ new WeakMap());
+function bindSubtreeToContainer(node, container) {
+	nodeContainers.set(node, container);
+	for (const child of node.children) bindSubtreeToContainer(child, container);
+}
+function unbindSubtreeFromContainer(node) {
+	nodeContainers.delete(node);
+	for (const child of node.children) unbindSubtreeFromContainer(child);
+}
+function getOwningContainer(node) {
+	let current = node;
+	while (current) {
+		const container = nodeContainers.get(current);
+		if (container) return container;
+		current = current.parent;
+	}
+}
+function registerContainer(container) {
+	bindSubtreeToContainer(container.root, container);
+}
+function releaseContainerLifecycle(container) {
+	container.nodeLifecycle = null;
+	unbindSubtreeFromContainer(container.root);
+}
+function setContainerNodeLifecycle(container, observer) {
+	container.nodeLifecycle = observer;
+}
+function notifyNodeRemoved(container, removedNode) {
+	container?.nodeLifecycle?.onNodeRemoved?.(removedNode);
+}
+function notifyNodeUpdated(updatedNode) {
+	getOwningContainer(updatedNode)?.nodeLifecycle?.onNodeUpdated?.(updatedNode);
+}
+function notifySubtreeAttached(container, attachedRoot) {
+	container?.nodeLifecycle?.onSubtreeAttached?.(attachedRoot);
 }
 const NODE_SCOPES_KEY = Symbol.for("@silvery/ag-react/reconciler/nodeScopes");
 const nodeScopes = globalThis[NODE_SCOPES_KEY] ?? (globalThis[NODE_SCOPES_KEY] = /* @__PURE__ */ new WeakMap());
@@ -1600,6 +1633,8 @@ const hostConfig = {
 		}
 		child.parent = parentInstance;
 		parentInstance.children.push(child);
+		const container = getOwningContainer(parentInstance);
+		if (container) bindSubtreeToContainer(child, container);
 		if (parentInstance.layoutNode && child.layoutNode) {
 			const layoutIndex = parentInstance.children.filter((c) => c.layoutNode !== null).length - 1;
 			parentInstance.layoutNode.insertChild(child.layoutNode, layoutIndex);
@@ -1614,10 +1649,13 @@ const hostConfig = {
 		trackContentDirty(parentInstance);
 		markLayoutAncestorDirty(parentInstance);
 		markSubtreeDirty(parentInstance);
+		notifySubtreeAttached(container, child);
 	},
 	appendInitialChild(parentInstance, child) {
 		child.parent = parentInstance;
 		parentInstance.children.push(child);
+		const container = getOwningContainer(parentInstance);
+		if (container) bindSubtreeToContainer(child, container);
 		if (parentInstance.layoutNode && child.layoutNode) {
 			const layoutIndex = parentInstance.children.filter((c) => c.layoutNode !== null).length - 1;
 			parentInstance.layoutNode.insertChild(child.layoutNode, layoutIndex);
@@ -1631,6 +1669,7 @@ const hostConfig = {
 		}
 		child.parent = container.root;
 		container.root.children.push(child);
+		bindSubtreeToContainer(child, container);
 		if (container.root.layoutNode && child.layoutNode) {
 			const layoutIndex = container.root.children.filter((c) => c.layoutNode !== null).length - 1;
 			container.root.layoutNode.insertChild(child.layoutNode, layoutIndex);
@@ -1644,11 +1683,12 @@ const hostConfig = {
 		container.root.layoutNode?.markDirty();
 		trackContentDirty(container.root);
 		markSubtreeDirty(container.root);
+		notifySubtreeAttached(container, child);
 	},
 	removeChild(parentInstance, child) {
 		const index = parentInstance.children.indexOf(child);
 		if (index !== -1) {
-			onNodeRemovedCallback?.(child);
+			notifyNodeRemoved(getOwningContainer(parentInstance) ?? getOwningContainer(child), child);
 			logUnmountSubtree(child);
 			disposeSubtreeScopes(child);
 			parentInstance.children.splice(index, 1);
@@ -1656,6 +1696,7 @@ const hostConfig = {
 				parentInstance.layoutNode.removeChild(child.layoutNode);
 				child.layoutNode.free();
 			}
+			unbindSubtreeFromContainer(child);
 			child.parent = null;
 			{
 				const epoch = getRenderEpoch();
@@ -1672,7 +1713,7 @@ const hostConfig = {
 	removeChildFromContainer(container, child) {
 		const index = container.root.children.indexOf(child);
 		if (index !== -1) {
-			onNodeRemovedCallback?.(child);
+			notifyNodeRemoved(container, child);
 			logUnmountSubtree(child);
 			disposeSubtreeScopes(child);
 			container.root.children.splice(index, 1);
@@ -1680,6 +1721,7 @@ const hostConfig = {
 				container.root.layoutNode.removeChild(child.layoutNode);
 				child.layoutNode.free();
 			}
+			unbindSubtreeFromContainer(child);
 			child.parent = null;
 			{
 				const epoch = getRenderEpoch();
@@ -1702,6 +1744,8 @@ const hostConfig = {
 		if (beforeIndex !== -1) {
 			child.parent = parentInstance;
 			parentInstance.children.splice(beforeIndex, 0, child);
+			const container = getOwningContainer(parentInstance);
+			if (container) bindSubtreeToContainer(child, container);
 			if (parentInstance.layoutNode && child.layoutNode) {
 				const layoutIndex = parentInstance.children.slice(0, beforeIndex).filter((c) => c.layoutNode !== null).length;
 				parentInstance.layoutNode.insertChild(child.layoutNode, layoutIndex);
@@ -1716,6 +1760,7 @@ const hostConfig = {
 			trackContentDirty(parentInstance);
 			markLayoutAncestorDirty(parentInstance);
 			markSubtreeDirty(parentInstance);
+			notifySubtreeAttached(container, child);
 		}
 	},
 	insertInContainerBefore(container, child, beforeChild) {
@@ -1728,6 +1773,7 @@ const hostConfig = {
 		if (beforeIndex !== -1) {
 			child.parent = container.root;
 			container.root.children.splice(beforeIndex, 0, child);
+			bindSubtreeToContainer(child, container);
 			if (container.root.layoutNode && child.layoutNode) {
 				const layoutIndex = container.root.children.slice(0, beforeIndex).filter((c) => c.layoutNode !== null).length;
 				container.root.layoutNode.insertChild(child.layoutNode, layoutIndex);
@@ -1741,6 +1787,7 @@ const hostConfig = {
 			container.root.layoutNode?.markDirty();
 			trackContentDirty(container.root);
 			markSubtreeDirty(container.root);
+			notifySubtreeAttached(container, child);
 		}
 	},
 	prepareUpdate(_instance, _type, oldProps, newProps) {
@@ -1786,6 +1833,7 @@ const hostConfig = {
 		if (contentChanged === "style" && !layoutChanged && !isDirty(instance.dirtyBits, instance.dirtyEpoch, 4) && !isDirty(instance.dirtyBits, instance.dirtyEpoch, 1) && !isDirty(instance.dirtyBits, instance.dirtyEpoch, 8)) trackStyleOnlyDirty(instance);
 		instance.props = newProps;
 		logNodeLifecycle("update", instance);
+		notifyNodeUpdated(instance);
 		const scrollToChanged = oldProps.scrollTo !== newProps.scrollTo;
 		const scrollOffsetChanged = oldProps.scrollOffset !== newProps.scrollOffset;
 		if (scrollToChanged || scrollOffsetChanged) trackScrollDirty(instance);
@@ -1830,13 +1878,16 @@ const hostConfig = {
 	},
 	clearContainer(container) {
 		for (const child of container.root.children) {
-			onNodeRemovedCallback?.(child);
+			notifyNodeRemoved(container, child);
 			logUnmountSubtree(child);
 		}
 		disposeSubtreeScopes(container.root);
-		for (const child of container.root.children) if (container.root.layoutNode && child.layoutNode) {
-			container.root.layoutNode.removeChild(child.layoutNode);
-			child.layoutNode.free();
+		for (const child of container.root.children) {
+			if (container.root.layoutNode && child.layoutNode) {
+				container.root.layoutNode.removeChild(child.layoutNode);
+				child.layoutNode.free();
+			}
+			unbindSubtreeFromContainer(child);
 		}
 		container.root.children = [];
 		{
@@ -1865,6 +1916,7 @@ const hostConfig = {
 	},
 	detachDeletedInstance(node) {
 		disposeSubtreeScopes(node);
+		unbindSubtreeFromContainer(node);
 	},
 	setCurrentUpdatePriority(newPriority) {
 		currentUpdatePriority = newPriority;
@@ -1992,10 +2044,13 @@ const reconciler = Reconciler(hostConfig);
 * Create a container for rendering.
 */
 function createContainer(onRender) {
-	return {
+	const container = {
 		root: createRootNode(),
-		onRender
+		onRender,
+		nodeLifecycle: null
 	};
+	registerContainer(container);
+	return container;
 }
 /**
 * Create a React fiber root for a container (wraps the 10-argument reconciler call).
@@ -2024,7 +2079,7 @@ function getContainerRoot(container) {
 * 1. `createFiberRoot` uses `ConcurrentRoot` (mode 1). React's async
 *    `updateContainer(null, fiberRoot, ...)` does NOT run layout-effect
 *    cleanups before returning — useLayoutEffect / useBoxRect /
-*    useBoxMetrics / signal-effect disposers are scheduled but may not
+*    signal-effect disposers are scheduled but may not
 *    fire promptly. That keeps signal subscriptions alive past unmount,
 *    which keeps the React tree reachable, which keeps the host
 *    `RenderInstance` reachable. `updateContainerSync` + `flushSyncWork`
@@ -2060,6 +2115,7 @@ function unmountFiberRoot(fiberRoot, container) {
 */
 function releaseContainer(container) {
 	disposeSubtreeScopes(container.root);
+	releaseContainerLifecycle(container);
 	container.onRender = () => {};
 	const root = container.root;
 	root.children = [];
@@ -2078,6 +2134,6 @@ function releaseContainer(container) {
 	}
 }
 //#endregion
-export { trackContentDirty as S, isAnyDirty as _, unmountFiberRoot as a, clearDirtyTracking as b, setOnNodeRemoved as c, createScope as d, reportDisposeError as f, getRenderEpoch as g, advanceRenderEpoch as h, reconciler as i, measureStats as l, finaliseHandle as m, createFiberRoot as n, hostConfig as o, defineHandle as p, getContainerRoot as r, runWithDiscreteEvent as s, createContainer as t, collectPlainText as u, isCurrentEpoch as v, hasScrollDirty as x, isDirty as y };
+export { isDirty as C, isCurrentEpoch as S, measureStats as _, releaseContainer as a, getRenderEpoch as b, runWithDiscreteEvent as c, reportDisposeError as d, defineHandle as f, trackContentDirty as g, hasScrollDirty as h, reconciler as i, setContainerNodeLifecycle as l, clearDirtyTracking as m, createFiberRoot as n, unmountFiberRoot as o, finaliseHandle as p, getContainerRoot as r, hostConfig as s, createContainer as t, createScope as u, collectPlainText as v, isAnyDirty as x, advanceRenderEpoch as y };
 
-//# sourceMappingURL=reconciler-DldIJB93.mjs.map
+//# sourceMappingURL=reconciler--_-biN23.mjs.map