omk-tui 1.4.0 → 1.4.1

package/dist/windowed-container.d.ts

@@ -6,6 +6,8 @@ export interface WindowedRenderStats {
     refreshedChildren: number;
     /** Frozen segments whose line buffer was rebuilt this frame. */
     refreshedSegments: number;
+    /** Settled children skipped entirely this frame (virtual prefix). */
+    virtualChildren: number;
 }
 /**
  * Container that freezes settled children above a live-line budget into
@@ -19,6 +21,15 @@ export interface WindowedRenderStats {
  *   `invalidate()`, `clear()` and foreign edits of `children` thaw everything.
  * - Freezing releases the child's render caches (frozen lines are the only
  *   retained copy); a later change re-renders that one child from source.
+ *
+ * Virtual prefix (opt-in via `setPrefixSeed`/`setPrefixSeedViewport`):
+ * when a prefix seed is configured, children above the live budget PLUS the
+ * seed budget never render at all — `render()` returns zero lines for them.
+ * Rendered line work is bounded by live + seed; prefix identity/settledness
+ * checks still visit skipped children. The
+ * prefix is a contiguous run anchored at index 0; children above the seed
+ * budget never enter the output, so callers that need the whole transcript
+ * (`buildFinalSessionLog`, exports) must use `renderAll(width)`.
  */
 export declare class WindowedContainer extends Container {
     private segments;
@@ -27,6 +38,18 @@ export declare class WindowedContainer extends Container {
     private viewportRows?;
     private lastLiveLineBudget;
     private stats;
+    /**
+     * Children above live+seed that never render (opt-in). Contiguous from
+     * index 0; emits zero lines every frame once established.
+     */
+    private virtualChildren;
+    /** Unset preserves full-history rendering; zero seeds only the live tail. */
+    private seedLines?;
+    private seedViewportRows?;
+    private seedScreens?;
+    private lastPrefixSeedLines?;
+    /** Bound `isChildSettled` for the extracted segment helpers. */
+    private readonly settled;
     /** Fixed budget (tests, embedders); detaches any viewport set by `setViewportRows`. */
     setLiveLineBudget(lines: number): void;
     /**
@@ -35,6 +58,19 @@ export declare class WindowedContainer extends Container {
      */
     setViewportRows(rows: () => number): void;
     getLiveLineBudget(): number;
+    /**
+     * Opt in to the virtual prefix: settled children above
+     * `live budget + seedLines` never render — the first frame of a long
+     * transcript renders only live + seed lines. Zero seeds only the live
+     * tail; unset or non-finite input restores full-history rendering.
+     */
+    setPrefixSeed(lines?: number): void;
+    /** Seed budget follows the terminal height: `screens × rows`, re-read on every render. */
+    setPrefixSeedViewport(screens: number, rows: () => number): void;
+    /** Current seed budget in lines; undefined means virtualization is off. */
+    getPrefixSeedLines(): number | undefined;
+    /** Children skipped entirely by the last render (virtual prefix). */
+    getVirtualChildCount(): number;
     getFrozenChildCount(): number;
     getFrozenLineCount(): number;
     /** Diagnostics: number of frozen segments. */
@@ -51,13 +87,34 @@ export declare class WindowedContainer extends Container {
     removeChild(component: Component): void;
     clear(): void;
     invalidate(): void;
-    /** Drop every frozen segment; the next render re-renders all children. */
+    /** Drop every frozen segment and the virtual prefix; the next render re-lays out all children. */
     thaw(): void;
+    /**
+     * Render every child without any windowing or virtualization. For callers
+     * that need the complete transcript (final session log, exports) — the
+     * windowed state is untouched and the next `render()` resumes windowing.
+     */
+    renderAll(width: number): string[];
     render(width: number): string[];
+    /**
+     * Establish the virtual prefix in a single bottom-up pass: render children
+     * from the tail until `live + seed` lines are covered and mark everything
+     * above as virtual. Returns the rendered lines keyed by child index for
+     * the emit pass to reuse (children render at most once per frame).
+     *
+     * An unsettled child may end up inside the virtual prefix (the scan does
+     * not check settledness): `reconcileVirtual` then truncates the prefix
+     * there and the emit pass renders it live as usual, so no output is lost.
+     */
+    private scanVirtualBoundary;
+    /**
+     * Verify the virtual prefix is still a valid prefix of `children` and still
+     * settled. On the first mismatch (identity, reorder, un-settled) the prefix
+     * is truncated there: children past the cut render live this frame and
+     * their lines materialize as new output (a bounded repaint repair).
+     */
+    private reconcileVirtual;
     /** Drop unsettled segments and refresh children whose generation moved. */
     private reconcile;
-    private refreshSegment;
-    /** Freeze settled live children that sit above the live-line budget. */
-    private freezeAboveBudget;
 }
 //# sourceMappingURL=windowed-container.d.ts.map

package/dist/windowed-container.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"windowed-container.d.ts","sourceRoot":"","sources":["../src/windowed-container.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,SAAS,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAgCrD,MAAM,WAAW,mBAAmB;IACnC,yEAAyE;IACzE,YAAY,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gEAAgE;IAChE,iBAAiB,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,iBAAkB,SAAQ,SAAS;IAC/C,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,WAAW,CAAM;IACzB,OAAO,CAAC,cAAc,CAAwB;IAC9C,OAAO,CAAC,YAAY,CAAC,CAAe;IACpC,OAAO,CAAC,kBAAkB,CAAwB;IAClD,OAAO,CAAC,KAAK,CAAwF;IAErG,uFAAuF;IACvF,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAGrC;IAED;;;OAGG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,MAAM,GAAG,IAAI,CAExC;IAED,iBAAiB,IAAI,MAAM,CAI1B;IAED,mBAAmB,IAAI,MAAM,CAI5B;IAED,kBAAkB,IAAI,MAAM,CAI3B;IAED,8CAA8C;IAC9C,qBAAqB,IAAI,MAAM,CAE9B;IAED,yDAAyD;IACzD,eAAe,IAAI,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAE7D;IAED,8DAA8D;IAC9D,kBAAkB,IAAI,QAAQ,CAAC,mBAAmB,CAAC,CAElD;IAED,qFAAqF;IACrF,SAAS,CAAC,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAElD;IAEQ,WAAW,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAkB/C;IAEQ,KAAK,IAAI,IAAI,CAGrB;IAEQ,UAAU,IAAI,IAAI,CAG1B;IAED,0EAA0E;IAC1E,IAAI,IAAI,IAAI,CAGX;IAEQ,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAsCvC;IAED,2EAA2E;IAC3E,OAAO,CAAC,SAAS;IA4BjB,OAAO,CAAC,cAAc;IAwBtB,wEAAwE;IACxE,OAAO,CAAC,iBAAiB;CA8CzB","sourcesContent":["import { isRenderSettled, releaseRenderCache, renderGeneration } from \"./render-generation.ts\";\nimport { type Component, Container } from \"./tui.ts\";\n\n/**\n * A frozen segment never grows past this many lines (a single larger child\n * gets a segment of its own). Bounds the work of refreshing one changed child:\n * only its segment's line buffer is rebuilt, never the whole frozen history.\n */\nconst SEGMENT_MAX_LINES = 512;\n\n/**\n * Live-line budget: the bottom `max(120, 2 × terminal rows)` lines always\n * render live. Two viewports keep components that change without announcing\n * it (animations, stateful extension renderers) live wherever the user can\n * see them, also after scrolling back one screen; the 120 floor is the budget\n * when no viewport is attached and on small terminals.\n */\nconst MIN_LIVE_LINE_BUDGET = 120;\nconst LIVE_VIEWPORTS = 2;\n\n/** Contiguous settled children whose rendered lines are reused verbatim. */\ntype FrozenSegment = {\n\t/** Index in `children` of the first frozen child. */\n\tfrom: number;\n\t/** The frozen children themselves (identity-checked every frame). */\n\tchildren: Component[];\n\tlineCounts: number[];\n\t/** `getRenderGeneration()` of each child when its lines were taken. */\n\tgenerations: number[];\n\t/** Concatenation of the children's lines. */\n\tlines: string[];\n};\n\nexport interface WindowedRenderStats {\n\t/** Children rendered live this frame (live tail plus unsettled gaps). */\n\tliveChildren: number;\n\t/** Frozen children re-rendered because their generation moved. */\n\trefreshedChildren: number;\n\t/** Frozen segments whose line buffer was rebuilt this frame. */\n\trefreshedSegments: number;\n}\n\n/**\n * Container that freezes settled children above a live-line budget into\n * bounded line segments and stops re-rendering them.\n *\n * - Settledness comes from `isRenderSettled()` (missing ⇒ settled). Unsettled\n *   children always render live; settled runs on both sides of them freeze.\n * - Each frozen child remembers its `getRenderGeneration()`. When it moves,\n *   only that child is re-rendered and only its segment is rebuilt.\n * - An unsettled frozen child drops just its segment. Width changes,\n *   `invalidate()`, `clear()` and foreign edits of `children` thaw everything.\n * - Freezing releases the child's render caches (frozen lines are the only\n *   retained copy); a later change re-renders that one child from source.\n */\nexport class WindowedContainer extends Container {\n\tprivate segments: FrozenSegment[] = [];\n\tprivate frozenWidth = -1;\n\tprivate liveLineBudget = MIN_LIVE_LINE_BUDGET;\n\tprivate viewportRows?: () => number;\n\tprivate lastLiveLineBudget = MIN_LIVE_LINE_BUDGET;\n\tprivate stats: WindowedRenderStats = { liveChildren: 0, refreshedChildren: 0, refreshedSegments: 0 };\n\n\t/** Fixed budget (tests, embedders); detaches any viewport set by `setViewportRows`. */\n\tsetLiveLineBudget(lines: number): void {\n\t\tthis.viewportRows = undefined;\n\t\tthis.liveLineBudget = Math.max(1, Math.floor(lines));\n\t}\n\n\t/**\n\t * Follow the terminal height: budget = max(120, 2 × rows), re-read on every\n\t * render so a resize applies on the next frame.\n\t */\n\tsetViewportRows(rows: () => number): void {\n\t\tthis.viewportRows = rows;\n\t}\n\n\tgetLiveLineBudget(): number {\n\t\tif (!this.viewportRows) return this.liveLineBudget;\n\t\tconst rows = Math.floor(this.viewportRows());\n\t\treturn Math.max(MIN_LIVE_LINE_BUDGET, Number.isFinite(rows) ? rows * LIVE_VIEWPORTS : 0);\n\t}\n\n\tgetFrozenChildCount(): number {\n\t\tlet count = 0;\n\t\tfor (const segment of this.segments) count += segment.children.length;\n\t\treturn count;\n\t}\n\n\tgetFrozenLineCount(): number {\n\t\tlet count = 0;\n\t\tfor (const segment of this.segments) count += segment.lines.length;\n\t\treturn count;\n\t}\n\n\t/** Diagnostics: number of frozen segments. */\n\tgetFrozenSegmentCount(): number {\n\t\treturn this.segments.length;\n\t}\n\n\t/** Diagnostics: frozen child index ranges [from, to). */\n\tgetFrozenRanges(): ReadonlyArray<{ from: number; to: number }> {\n\t\treturn this.segments.map((segment) => ({ from: segment.from, to: segment.from + segment.children.length }));\n\t}\n\n\t/** Diagnostics: what the most recent `render` had to redo. */\n\tgetLastRenderStats(): Readonly<WindowedRenderStats> {\n\t\treturn this.stats;\n\t}\n\n\t/** Subclasses may add their own lifecycle knowledge (e.g. an agent_end backstop). */\n\tprotected isChildSettled(child: Component): boolean {\n\t\treturn isRenderSettled(child);\n\t}\n\n\toverride removeChild(component: Component): void {\n\t\tconst index = this.children.indexOf(component);\n\t\tif (index === -1) return;\n\t\tsuper.removeChild(component);\n\t\tfor (const segment of this.segments) {\n\t\t\tif (index < segment.from) {\n\t\t\t\tsegment.from -= 1;\n\t\t\t} else if (index < segment.from + segment.children.length) {\n\t\t\t\tconst j = index - segment.from;\n\t\t\t\tlet offset = 0;\n\t\t\t\tfor (let k = 0; k < j; k++) offset += segment.lineCounts[k];\n\t\t\t\tsegment.lines.splice(offset, segment.lineCounts[j]);\n\t\t\t\tsegment.children.splice(j, 1);\n\t\t\t\tsegment.lineCounts.splice(j, 1);\n\t\t\t\tsegment.generations.splice(j, 1);\n\t\t\t}\n\t\t}\n\t\tthis.segments = this.segments.filter((segment) => segment.children.length > 0);\n\t}\n\n\toverride clear(): void {\n\t\tthis.thaw();\n\t\tsuper.clear();\n\t}\n\n\toverride invalidate(): void {\n\t\tthis.thaw();\n\t\tsuper.invalidate();\n\t}\n\n\t/** Drop every frozen segment; the next render re-renders all children. */\n\tthaw(): void {\n\t\tthis.segments = [];\n\t\tthis.frozenWidth = -1;\n\t}\n\n\toverride render(width: number): string[] {\n\t\tconst budget = this.getLiveLineBudget();\n\t\t// A taller terminal widens the live window: thaw so rows now inside it render live.\n\t\tif (width !== this.frozenWidth || budget > this.lastLiveLineBudget) this.thaw();\n\t\tthis.lastLiveLineBudget = budget;\n\t\tthis.frozenWidth = width;\n\t\tthis.stats = { liveChildren: 0, refreshedChildren: 0, refreshedSegments: 0 };\n\t\tthis.reconcile(width);\n\n\t\tconst parts: string[][] = [];\n\t\tconst partStarts: number[] = [];\n\t\tconst live: number[] = [];\n\t\tconst liveLines: string[][] = [];\n\t\tlet segmentIndex = 0;\n\t\tfor (let i = 0; i < this.children.length; ) {\n\t\t\tconst segment = this.segments[segmentIndex];\n\t\t\tlet lines: string[];\n\t\t\tpartStarts.push(i);\n\t\t\tif (segment && segment.from === i) {\n\t\t\t\tlines = segment.lines;\n\t\t\t\ti += segment.children.length;\n\t\t\t\tsegmentIndex += 1;\n\t\t\t} else {\n\t\t\t\tlines = this.children[i].render(width);\n\t\t\t\tlive.push(i);\n\t\t\t\tliveLines.push(lines);\n\t\t\t\ti += 1;\n\t\t\t}\n\t\t\tparts.push(lines);\n\t\t}\n\t\tthis.stats.liveChildren = live.length;\n\n\t\t// Copy before freezing: freezing appends to segment line buffers. Native\n\t\t// concat is a bulk copy; spread arguments stay far below engine limits\n\t\t// because frozen rows arrive as a few hundred segment arrays.\n\t\tconst out = parts.length < 8192 ? ([] as string[]).concat(...parts) : parts.flat();\n\t\tthis.freezeAboveBudget(parts, partStarts, live, liveLines, budget);\n\t\treturn out;\n\t}\n\n\t/** Drop unsettled segments and refresh children whose generation moved. */\n\tprivate reconcile(width: number): void {\n\t\tconst kept: FrozenSegment[] = [];\n\t\tfor (const segment of this.segments) {\n\t\t\tlet dirty: number[] | undefined;\n\t\t\tlet settled = true;\n\t\t\tfor (let j = 0; j < segment.children.length; j++) {\n\t\t\t\tconst child = segment.children[j];\n\t\t\t\tif (this.children[segment.from + j] !== child) {\n\t\t\t\t\t// `children` was edited behind our back: nothing frozen can be trusted.\n\t\t\t\t\tthis.segments = [];\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tif (!this.isChildSettled(child)) {\n\t\t\t\t\tsettled = false;\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t\tif (renderGeneration(child) !== segment.generations[j]) {\n\t\t\t\t\tdirty ??= [];\n\t\t\t\t\tdirty.push(j);\n\t\t\t\t}\n\t\t\t}\n\t\t\tif (!settled) continue;\n\t\t\tif (dirty) this.refreshSegment(segment, dirty, width);\n\t\t\tkept.push(segment);\n\t\t}\n\t\tthis.segments = kept;\n\t}\n\n\tprivate refreshSegment(segment: FrozenSegment, dirty: number[], width: number): void {\n\t\tconst lines: string[] = [];\n\t\tlet offset = 0;\n\t\tlet next = 0;\n\t\tfor (let j = 0; j < segment.children.length; j++) {\n\t\t\tconst count = segment.lineCounts[j];\n\t\t\tif (dirty[next] === j) {\n\t\t\t\tnext += 1;\n\t\t\t\tconst child = segment.children[j];\n\t\t\t\tconst fresh = child.render(width);\n\t\t\t\tfor (const line of fresh) lines.push(line);\n\t\t\t\tsegment.lineCounts[j] = fresh.length;\n\t\t\t\tsegment.generations[j] = renderGeneration(child);\n\t\t\t\treleaseRenderCache(child);\n\t\t\t} else {\n\t\t\t\tfor (let l = offset; l < offset + count; l++) lines.push(segment.lines[l]);\n\t\t\t}\n\t\t\toffset += count;\n\t\t}\n\t\tsegment.lines = lines;\n\t\tthis.stats.refreshedChildren += dirty.length;\n\t\tthis.stats.refreshedSegments += 1;\n\t}\n\n\t/** Freeze settled live children that sit above the live-line budget. */\n\tprivate freezeAboveBudget(\n\t\tparts: string[][],\n\t\tpartStarts: number[],\n\t\tlive: number[],\n\t\tliveLines: string[][],\n\t\tbudget: number,\n\t): void {\n\t\tlet acc = 0;\n\t\tlet liveStart = this.children.length;\n\t\tfor (let p = parts.length - 1; p >= 0; p--) {\n\t\t\tacc += parts[p].length;\n\t\t\tliveStart = partStarts[p];\n\t\t\tif (acc >= budget) break;\n\t\t}\n\t\tlet segmentIndex = 0;\n\t\tfor (let n = 0; n < live.length && live[n] < liveStart; n++) {\n\t\t\tconst index = live[n];\n\t\t\tconst child = this.children[index];\n\t\t\tif (!this.isChildSettled(child)) continue;\n\t\t\tconst lines = liveLines[n];\n\t\t\twhile (segmentIndex < this.segments.length && this.segments[segmentIndex].from < index) segmentIndex += 1;\n\t\t\tconst previous = this.segments[segmentIndex - 1];\n\t\t\tconst generation = renderGeneration(child);\n\t\t\tif (\n\t\t\t\tprevious &&\n\t\t\t\tprevious.from + previous.children.length === index &&\n\t\t\t\tprevious.lines.length + lines.length <= SEGMENT_MAX_LINES\n\t\t\t) {\n\t\t\t\tprevious.children.push(child);\n\t\t\t\tprevious.lineCounts.push(lines.length);\n\t\t\t\tprevious.generations.push(generation);\n\t\t\t\tfor (const line of lines) previous.lines.push(line);\n\t\t\t} else {\n\t\t\t\tconst segment: FrozenSegment = {\n\t\t\t\t\tfrom: index,\n\t\t\t\t\tchildren: [child],\n\t\t\t\t\tlineCounts: [lines.length],\n\t\t\t\t\tgenerations: [generation],\n\t\t\t\t\tlines: lines.slice(),\n\t\t\t\t};\n\t\t\t\tthis.segments.splice(segmentIndex, 0, segment);\n\t\t\t\tsegmentIndex += 1;\n\t\t\t}\n\t\t\treleaseRenderCache(child);\n\t\t}\n\t}\n}\n"]}
+{"version":3,"file":"windowed-container.d.ts","sourceRoot":"","sources":["../src/windowed-container.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,SAAS,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAarD,MAAM,WAAW,mBAAmB;IACnC,yEAAyE;IACzE,YAAY,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gEAAgE;IAChE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qEAAqE;IACrE,eAAe,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,iBAAkB,SAAQ,SAAS;IAC/C,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,WAAW,CAAM;IACzB,OAAO,CAAC,cAAc,CAAwB;IAC9C,OAAO,CAAC,YAAY,CAAC,CAAe;IACpC,OAAO,CAAC,kBAAkB,CAAwB;IAClD,OAAO,CAAC,KAAK,CAKX;IACF;;;OAGG;IACH,OAAO,CAAC,eAAe,CAAmB;IAC1C,6EAA6E;IAC7E,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,gBAAgB,CAAC,CAAe;IACxC,OAAO,CAAC,WAAW,CAAC,CAAS;IAC7B,OAAO,CAAC,mBAAmB,CAAC,CAAS;IACrC,gEAAgE;IAChE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6D;IAErF,uFAAuF;IACvF,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAGrC;IAED;;;OAGG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,MAAM,GAAG,IAAI,CAExC;IAED,iBAAiB,IAAI,MAAM,CAI1B;IAED;;;;;OAKG;IACH,aAAa,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAIlC;IAED,2FAA0F;IAC1F,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,MAAM,GAAG,IAAI,CAI/D;IAED,2EAA2E;IAC3E,kBAAkB,IAAI,MAAM,GAAG,SAAS,CAKvC;IAED,qEAAqE;IACrE,oBAAoB,IAAI,MAAM,CAE7B;IAED,mBAAmB,IAAI,MAAM,CAI5B;IAED,kBAAkB,IAAI,MAAM,CAI3B;IAED,8CAA8C;IAC9C,qBAAqB,IAAI,MAAM,CAE9B;IAED,yDAAyD;IACzD,eAAe,IAAI,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAE7D;IAED,8DAA8D;IAC9D,kBAAkB,IAAI,QAAQ,CAAC,mBAAmB,CAAC,CAElD;IAED,qFAAqF;IACrF,SAAS,CAAC,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAElD;IAEQ,WAAW,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAM/C;IAEQ,KAAK,IAAI,IAAI,CAGrB;IAEQ,UAAU,IAAI,IAAI,CAG1B;IAED,kGAAkG;IAClG,IAAI,IAAI,IAAI,CAIX;IAED;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAEjC;IAEQ,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAiDvC;IAED;;;;;;;;;OASG;IACH,OAAO,CAAC,mBAAmB;IAe3B;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IAOxB,2EAA2E;IAC3E,OAAO,CAAC,SAAS;CAIjB","sourcesContent":["import { isRenderSettled } from \"./render-generation.ts\";\nimport { type Component, Container } from \"./tui.ts\";\nimport { dropFrozenChild, type FrozenSegment, freezeAboveBudget, reconcileSegments } from \"./windowed-segments.ts\";\n\n/**\n * Live-line budget: the bottom `max(120, 2 × terminal rows)` lines always\n * render live. Two viewports keep components that change without announcing\n * it (animations, stateful extension renderers) live wherever the user can\n * see them, also after scrolling back one screen; the 120 floor is the budget\n * when no viewport is attached and on small terminals.\n */\nconst MIN_LIVE_LINE_BUDGET = 120;\nconst LIVE_VIEWPORTS = 2;\n\nexport interface WindowedRenderStats {\n\t/** Children rendered live this frame (live tail plus unsettled gaps). */\n\tliveChildren: number;\n\t/** Frozen children re-rendered because their generation moved. */\n\trefreshedChildren: number;\n\t/** Frozen segments whose line buffer was rebuilt this frame. */\n\trefreshedSegments: number;\n\t/** Settled children skipped entirely this frame (virtual prefix). */\n\tvirtualChildren: number;\n}\n\n/**\n * Container that freezes settled children above a live-line budget into\n * bounded line segments and stops re-rendering them.\n *\n * - Settledness comes from `isRenderSettled()` (missing ⇒ settled). Unsettled\n *   children always render live; settled runs on both sides of them freeze.\n * - Each frozen child remembers its `getRenderGeneration()`. When it moves,\n *   only that child is re-rendered and only its segment is rebuilt.\n * - An unsettled frozen child drops just its segment. Width changes,\n *   `invalidate()`, `clear()` and foreign edits of `children` thaw everything.\n * - Freezing releases the child's render caches (frozen lines are the only\n *   retained copy); a later change re-renders that one child from source.\n *\n * Virtual prefix (opt-in via `setPrefixSeed`/`setPrefixSeedViewport`):\n * when a prefix seed is configured, children above the live budget PLUS the\n * seed budget never render at all — `render()` returns zero lines for them.\n * Rendered line work is bounded by live + seed; prefix identity/settledness\n * checks still visit skipped children. The\n * prefix is a contiguous run anchored at index 0; children above the seed\n * budget never enter the output, so callers that need the whole transcript\n * (`buildFinalSessionLog`, exports) must use `renderAll(width)`.\n */\nexport class WindowedContainer extends Container {\n\tprivate segments: FrozenSegment[] = [];\n\tprivate frozenWidth = -1;\n\tprivate liveLineBudget = MIN_LIVE_LINE_BUDGET;\n\tprivate viewportRows?: () => number;\n\tprivate lastLiveLineBudget = MIN_LIVE_LINE_BUDGET;\n\tprivate stats: WindowedRenderStats = {\n\t\tliveChildren: 0,\n\t\trefreshedChildren: 0,\n\t\trefreshedSegments: 0,\n\t\tvirtualChildren: 0,\n\t};\n\t/**\n\t * Children above live+seed that never render (opt-in). Contiguous from\n\t * index 0; emits zero lines every frame once established.\n\t */\n\tprivate virtualChildren: Component[] = [];\n\t/** Unset preserves full-history rendering; zero seeds only the live tail. */\n\tprivate seedLines?: number;\n\tprivate seedViewportRows?: () => number;\n\tprivate seedScreens?: number;\n\tprivate lastPrefixSeedLines?: number;\n\t/** Bound `isChildSettled` for the extracted segment helpers. */\n\tprivate readonly settled = (child: Component): boolean => this.isChildSettled(child);\n\n\t/** Fixed budget (tests, embedders); detaches any viewport set by `setViewportRows`. */\n\tsetLiveLineBudget(lines: number): void {\n\t\tthis.viewportRows = undefined;\n\t\tthis.liveLineBudget = Math.max(1, Math.floor(lines));\n\t}\n\n\t/**\n\t * Follow the terminal height: budget = max(120, 2 × rows), re-read on every\n\t * render so a resize applies on the next frame.\n\t */\n\tsetViewportRows(rows: () => number): void {\n\t\tthis.viewportRows = rows;\n\t}\n\n\tgetLiveLineBudget(): number {\n\t\tif (!this.viewportRows) return this.liveLineBudget;\n\t\tconst rows = Math.floor(this.viewportRows());\n\t\treturn Math.max(MIN_LIVE_LINE_BUDGET, Number.isFinite(rows) ? rows * LIVE_VIEWPORTS : 0);\n\t}\n\n\t/**\n\t * Opt in to the virtual prefix: settled children above\n\t * `live budget + seedLines` never render — the first frame of a long\n\t * transcript renders only live + seed lines. Zero seeds only the live\n\t * tail; unset or non-finite input restores full-history rendering.\n\t */\n\tsetPrefixSeed(lines?: number): void {\n\t\tthis.seedViewportRows = undefined;\n\t\tthis.seedScreens = undefined;\n\t\tthis.seedLines = lines !== undefined && Number.isFinite(lines) ? Math.max(0, Math.floor(lines)) : undefined;\n\t}\n\n\t/** Seed budget follows the terminal height: `screens × rows`, re-read on every render. */\n\tsetPrefixSeedViewport(screens: number, rows: () => number): void {\n\t\tthis.seedLines = undefined;\n\t\tthis.seedScreens = Number.isFinite(screens) ? Math.max(0, Math.floor(screens)) : undefined;\n\t\tthis.seedViewportRows = rows;\n\t}\n\n\t/** Current seed budget in lines; undefined means virtualization is off. */\n\tgetPrefixSeedLines(): number | undefined {\n\t\tif (!this.seedViewportRows) return this.seedLines;\n\t\tif (this.seedScreens === undefined) return undefined;\n\t\tconst rows = Math.floor(this.seedViewportRows());\n\t\treturn Math.max(0, Number.isFinite(rows) ? rows * this.seedScreens : 0);\n\t}\n\n\t/** Children skipped entirely by the last render (virtual prefix). */\n\tgetVirtualChildCount(): number {\n\t\treturn this.virtualChildren.length;\n\t}\n\n\tgetFrozenChildCount(): number {\n\t\tlet count = 0;\n\t\tfor (const segment of this.segments) count += segment.children.length;\n\t\treturn count;\n\t}\n\n\tgetFrozenLineCount(): number {\n\t\tlet count = 0;\n\t\tfor (const segment of this.segments) count += segment.lines.length;\n\t\treturn count;\n\t}\n\n\t/** Diagnostics: number of frozen segments. */\n\tgetFrozenSegmentCount(): number {\n\t\treturn this.segments.length;\n\t}\n\n\t/** Diagnostics: frozen child index ranges [from, to). */\n\tgetFrozenRanges(): ReadonlyArray<{ from: number; to: number }> {\n\t\treturn this.segments.map((segment) => ({ from: segment.from, to: segment.from + segment.children.length }));\n\t}\n\n\t/** Diagnostics: what the most recent `render` had to redo. */\n\tgetLastRenderStats(): Readonly<WindowedRenderStats> {\n\t\treturn this.stats;\n\t}\n\n\t/** Subclasses may add their own lifecycle knowledge (e.g. an agent_end backstop). */\n\tprotected isChildSettled(child: Component): boolean {\n\t\treturn isRenderSettled(child);\n\t}\n\n\toverride removeChild(component: Component): void {\n\t\tconst index = this.children.indexOf(component);\n\t\tif (index === -1) return;\n\t\tsuper.removeChild(component);\n\t\tif (index < this.virtualChildren.length) this.virtualChildren.splice(index, 1);\n\t\tdropFrozenChild(this.segments, index);\n\t}\n\n\toverride clear(): void {\n\t\tthis.thaw();\n\t\tsuper.clear();\n\t}\n\n\toverride invalidate(): void {\n\t\tthis.thaw();\n\t\tsuper.invalidate();\n\t}\n\n\t/** Drop every frozen segment and the virtual prefix; the next render re-lays out all children. */\n\tthaw(): void {\n\t\tthis.segments = [];\n\t\tthis.virtualChildren = [];\n\t\tthis.frozenWidth = -1;\n\t}\n\n\t/**\n\t * Render every child without any windowing or virtualization. For callers\n\t * that need the complete transcript (final session log, exports) — the\n\t * windowed state is untouched and the next `render()` resumes windowing.\n\t */\n\trenderAll(width: number): string[] {\n\t\treturn super.render(width);\n\t}\n\n\toverride render(width: number): string[] {\n\t\tconst budget = this.getLiveLineBudget();\n\t\tconst seed = this.getPrefixSeedLines();\n\t\t// Rebuild on seed changes too: a taller terminal can grow it without growing the live budget.\n\t\tif (width !== this.frozenWidth || budget > this.lastLiveLineBudget || seed !== this.lastPrefixSeedLines)\n\t\t\tthis.thaw();\n\t\tthis.lastLiveLineBudget = budget;\n\t\tthis.lastPrefixSeedLines = seed;\n\t\tthis.frozenWidth = width;\n\t\tthis.stats = { liveChildren: 0, refreshedChildren: 0, refreshedSegments: 0, virtualChildren: 0 };\n\t\t// Build the virtual prefix once, while no frozen segments exist. Lines\n\t\t// rendered during the boundary scan are memoized into the emit pass.\n\t\tconst memo =\n\t\t\tseed !== undefined && this.virtualChildren.length === 0 && this.segments.length === 0\n\t\t\t\t? this.scanVirtualBoundary(width, budget, seed)\n\t\t\t\t: undefined;\n\t\tthis.reconcileVirtual();\n\t\tthis.reconcile(width);\n\t\tthis.stats.virtualChildren = this.virtualChildren.length;\n\n\t\tconst parts: string[][] = [];\n\t\tconst partStarts: number[] = [];\n\t\tconst live: number[] = [];\n\t\tconst liveLines: string[][] = [];\n\t\tlet segmentIndex = 0;\n\t\tfor (let i = this.virtualChildren.length; i < this.children.length; ) {\n\t\t\tconst segment = this.segments[segmentIndex];\n\t\t\tlet lines: string[];\n\t\t\tpartStarts.push(i);\n\t\t\tif (segment && segment.from === i) {\n\t\t\t\tlines = segment.lines;\n\t\t\t\ti += segment.children.length;\n\t\t\t\tsegmentIndex += 1;\n\t\t\t} else {\n\t\t\t\tlines = memo?.get(i) ?? this.children[i].render(width);\n\t\t\t\tlive.push(i);\n\t\t\t\tliveLines.push(lines);\n\t\t\t\ti += 1;\n\t\t\t}\n\t\t\tparts.push(lines);\n\t\t}\n\t\tthis.stats.liveChildren = live.length;\n\n\t\t// Copy before freezing: freezing appends to segment line buffers. Native\n\t\t// concat is a bulk copy; spread arguments stay far below engine limits\n\t\t// because frozen rows arrive as a few hundred segment arrays.\n\t\tconst out = parts.length < 8192 ? ([] as string[]).concat(...parts) : parts.flat();\n\t\tfreezeAboveBudget(this.segments, this.children, this.settled, parts, partStarts, live, liveLines, budget);\n\t\treturn out;\n\t}\n\n\t/**\n\t * Establish the virtual prefix in a single bottom-up pass: render children\n\t * from the tail until `live + seed` lines are covered and mark everything\n\t * above as virtual. Returns the rendered lines keyed by child index for\n\t * the emit pass to reuse (children render at most once per frame).\n\t *\n\t * An unsettled child may end up inside the virtual prefix (the scan does\n\t * not check settledness): `reconcileVirtual` then truncates the prefix\n\t * there and the emit pass renders it live as usual, so no output is lost.\n\t */\n\tprivate scanVirtualBoundary(width: number, budget: number, seed: number): Map<number, string[]> {\n\t\tconst memo = new Map<number, string[]>();\n\t\tconst target = budget + seed;\n\t\tlet acc = 0;\n\t\tlet i = this.children.length;\n\t\twhile (i > 0 && acc < target) {\n\t\t\ti -= 1;\n\t\t\tconst lines = this.children[i].render(width);\n\t\t\tmemo.set(i, lines);\n\t\t\tacc += lines.length;\n\t\t}\n\t\tthis.virtualChildren = this.children.slice(0, i);\n\t\treturn memo;\n\t}\n\n\t/**\n\t * Verify the virtual prefix is still a valid prefix of `children` and still\n\t * settled. On the first mismatch (identity, reorder, un-settled) the prefix\n\t * is truncated there: children past the cut render live this frame and\n\t * their lines materialize as new output (a bounded repaint repair).\n\t */\n\tprivate reconcileVirtual(): void {\n\t\tconst count = this.virtualChildren.length;\n\t\tlet v = 0;\n\t\twhile (v < count && this.children[v] === this.virtualChildren[v] && this.isChildSettled(this.children[v])) v += 1;\n\t\tif (v < count) this.virtualChildren.length = v;\n\t}\n\n\t/** Drop unsettled segments and refresh children whose generation moved. */\n\tprivate reconcile(width: number): void {\n\t\tconst kept = reconcileSegments(this.segments, this.children, this.settled, width, this.stats);\n\t\tthis.segments = kept ?? [];\n\t}\n}\n"]}

package/dist/windowed-container.js

@@ -1,11 +1,6 @@
-import { isRenderSettled, releaseRenderCache, renderGeneration } from "./render-generation.js";
+import { isRenderSettled } from "./render-generation.js";
 import { Container } from "./tui.js";
-/**
- * A frozen segment never grows past this many lines (a single larger child
- * gets a segment of its own). Bounds the work of refreshing one changed child:
- * only its segment's line buffer is rebuilt, never the whole frozen history.
- */
-const SEGMENT_MAX_LINES = 512;
+import { dropFrozenChild, freezeAboveBudget, reconcileSegments } from "./windowed-segments.js";
 /**
  * Live-line budget: the bottom `max(120, 2 × terminal rows)` lines always
  * render live. Two viewports keep components that change without announcing
@@ -27,6 +22,15 @@ const LIVE_VIEWPORTS = 2;
  *   `invalidate()`, `clear()` and foreign edits of `children` thaw everything.
  * - Freezing releases the child's render caches (frozen lines are the only
  *   retained copy); a later change re-renders that one child from source.
+ *
+ * Virtual prefix (opt-in via `setPrefixSeed`/`setPrefixSeedViewport`):
+ * when a prefix seed is configured, children above the live budget PLUS the
+ * seed budget never render at all — `render()` returns zero lines for them.
+ * Rendered line work is bounded by live + seed; prefix identity/settledness
+ * checks still visit skipped children. The
+ * prefix is a contiguous run anchored at index 0; children above the seed
+ * budget never enter the output, so callers that need the whole transcript
+ * (`buildFinalSessionLog`, exports) must use `renderAll(width)`.
  */
 export class WindowedContainer extends Container {
     segments = [];
@@ -34,7 +38,24 @@ export class WindowedContainer extends Container {
     liveLineBudget = MIN_LIVE_LINE_BUDGET;
     viewportRows;
     lastLiveLineBudget = MIN_LIVE_LINE_BUDGET;
-    stats = { liveChildren: 0, refreshedChildren: 0, refreshedSegments: 0 };
+    stats = {
+        liveChildren: 0,
+        refreshedChildren: 0,
+        refreshedSegments: 0,
+        virtualChildren: 0,
+    };
+    /**
+     * Children above live+seed that never render (opt-in). Contiguous from
+     * index 0; emits zero lines every frame once established.
+     */
+    virtualChildren = [];
+    /** Unset preserves full-history rendering; zero seeds only the live tail. */
+    seedLines;
+    seedViewportRows;
+    seedScreens;
+    lastPrefixSeedLines;
+    /** Bound `isChildSettled` for the extracted segment helpers. */
+    settled = (child) => this.isChildSettled(child);
     /** Fixed budget (tests, embedders); detaches any viewport set by `setViewportRows`. */
     setLiveLineBudget(lines) {
         this.viewportRows = undefined;
@@ -53,6 +74,36 @@ export class WindowedContainer extends Container {
         const rows = Math.floor(this.viewportRows());
         return Math.max(MIN_LIVE_LINE_BUDGET, Number.isFinite(rows) ? rows * LIVE_VIEWPORTS : 0);
     }
+    /**
+     * Opt in to the virtual prefix: settled children above
+     * `live budget + seedLines` never render — the first frame of a long
+     * transcript renders only live + seed lines. Zero seeds only the live
+     * tail; unset or non-finite input restores full-history rendering.
+     */
+    setPrefixSeed(lines) {
+        this.seedViewportRows = undefined;
+        this.seedScreens = undefined;
+        this.seedLines = lines !== undefined && Number.isFinite(lines) ? Math.max(0, Math.floor(lines)) : undefined;
+    }
+    /** Seed budget follows the terminal height: `screens × rows`, re-read on every render. */
+    setPrefixSeedViewport(screens, rows) {
+        this.seedLines = undefined;
+        this.seedScreens = Number.isFinite(screens) ? Math.max(0, Math.floor(screens)) : undefined;
+        this.seedViewportRows = rows;
+    }
+    /** Current seed budget in lines; undefined means virtualization is off. */
+    getPrefixSeedLines() {
+        if (!this.seedViewportRows)
+            return this.seedLines;
+        if (this.seedScreens === undefined)
+            return undefined;
+        const rows = Math.floor(this.seedViewportRows());
+        return Math.max(0, Number.isFinite(rows) ? rows * this.seedScreens : 0);
+    }
+    /** Children skipped entirely by the last render (virtual prefix). */
+    getVirtualChildCount() {
+        return this.virtualChildren.length;
+    }
     getFrozenChildCount() {
         let count = 0;
         for (const segment of this.segments)
@@ -86,22 +137,9 @@ export class WindowedContainer extends Container {
         if (index === -1)
             return;
         super.removeChild(component);
-        for (const segment of this.segments) {
-            if (index < segment.from) {
-                segment.from -= 1;
-            }
-            else if (index < segment.from + segment.children.length) {
-                const j = index - segment.from;
-                let offset = 0;
-                for (let k = 0; k < j; k++)
-                    offset += segment.lineCounts[k];
-                segment.lines.splice(offset, segment.lineCounts[j]);
-                segment.children.splice(j, 1);
-                segment.lineCounts.splice(j, 1);
-                segment.generations.splice(j, 1);
-            }
-        }
-        this.segments = this.segments.filter((segment) => segment.children.length > 0);
+        if (index < this.virtualChildren.length)
+            this.virtualChildren.splice(index, 1);
+        dropFrozenChild(this.segments, index);
     }
     clear() {
         this.thaw();
@@ -111,26 +149,44 @@ export class WindowedContainer extends Container {
         this.thaw();
         super.invalidate();
     }
-    /** Drop every frozen segment; the next render re-renders all children. */
+    /** Drop every frozen segment and the virtual prefix; the next render re-lays out all children. */
     thaw() {
         this.segments = [];
+        this.virtualChildren = [];
         this.frozenWidth = -1;
     }
+    /**
+     * Render every child without any windowing or virtualization. For callers
+     * that need the complete transcript (final session log, exports) — the
+     * windowed state is untouched and the next `render()` resumes windowing.
+     */
+    renderAll(width) {
+        return super.render(width);
+    }
     render(width) {
         const budget = this.getLiveLineBudget();
-        // A taller terminal widens the live window: thaw so rows now inside it render live.
-        if (width !== this.frozenWidth || budget > this.lastLiveLineBudget)
+        const seed = this.getPrefixSeedLines();
+        // Rebuild on seed changes too: a taller terminal can grow it without growing the live budget.
+        if (width !== this.frozenWidth || budget > this.lastLiveLineBudget || seed !== this.lastPrefixSeedLines)
             this.thaw();
         this.lastLiveLineBudget = budget;
+        this.lastPrefixSeedLines = seed;
         this.frozenWidth = width;
-        this.stats = { liveChildren: 0, refreshedChildren: 0, refreshedSegments: 0 };
+        this.stats = { liveChildren: 0, refreshedChildren: 0, refreshedSegments: 0, virtualChildren: 0 };
+        // Build the virtual prefix once, while no frozen segments exist. Lines
+        // rendered during the boundary scan are memoized into the emit pass.
+        const memo = seed !== undefined && this.virtualChildren.length === 0 && this.segments.length === 0
+            ? this.scanVirtualBoundary(width, budget, seed)
+            : undefined;
+        this.reconcileVirtual();
         this.reconcile(width);
+        this.stats.virtualChildren = this.virtualChildren.length;
         const parts = [];
         const partStarts = [];
         const live = [];
         const liveLines = [];
         let segmentIndex = 0;
-        for (let i = 0; i < this.children.length;) {
+        for (let i = this.virtualChildren.length; i < this.children.length;) {
             const segment = this.segments[segmentIndex];
             let lines;
             partStarts.push(i);
@@ -140,7 +196,7 @@ export class WindowedContainer extends Container {
                 segmentIndex += 1;
             }
             else {
-                lines = this.children[i].render(width);
+                lines = memo?.get(i) ?? this.children[i].render(width);
                 live.push(i);
                 liveLines.push(lines);
                 i += 1;
@@ -152,108 +208,51 @@ export class WindowedContainer extends Container {
         // concat is a bulk copy; spread arguments stay far below engine limits
         // because frozen rows arrive as a few hundred segment arrays.
         const out = parts.length < 8192 ? [].concat(...parts) : parts.flat();
-        this.freezeAboveBudget(parts, partStarts, live, liveLines, budget);
+        freezeAboveBudget(this.segments, this.children, this.settled, parts, partStarts, live, liveLines, budget);
         return out;
     }
-    /** Drop unsettled segments and refresh children whose generation moved. */
-    reconcile(width) {
-        const kept = [];
-        for (const segment of this.segments) {
-            let dirty;
-            let settled = true;
-            for (let j = 0; j < segment.children.length; j++) {
-                const child = segment.children[j];
-                if (this.children[segment.from + j] !== child) {
-                    // `children` was edited behind our back: nothing frozen can be trusted.
-                    this.segments = [];
-                    return;
-                }
-                if (!this.isChildSettled(child)) {
-                    settled = false;
-                    break;
-                }
-                if (renderGeneration(child) !== segment.generations[j]) {
-                    dirty ??= [];
-                    dirty.push(j);
-                }
-            }
-            if (!settled)
-                continue;
-            if (dirty)
-                this.refreshSegment(segment, dirty, width);
-            kept.push(segment);
+    /**
+     * Establish the virtual prefix in a single bottom-up pass: render children
+     * from the tail until `live + seed` lines are covered and mark everything
+     * above as virtual. Returns the rendered lines keyed by child index for
+     * the emit pass to reuse (children render at most once per frame).
+     *
+     * An unsettled child may end up inside the virtual prefix (the scan does
+     * not check settledness): `reconcileVirtual` then truncates the prefix
+     * there and the emit pass renders it live as usual, so no output is lost.
+     */
+    scanVirtualBoundary(width, budget, seed) {
+        const memo = new Map();
+        const target = budget + seed;
+        let acc = 0;
+        let i = this.children.length;
+        while (i > 0 && acc < target) {
+            i -= 1;
+            const lines = this.children[i].render(width);
+            memo.set(i, lines);
+            acc += lines.length;
         }
-        this.segments = kept;
+        this.virtualChildren = this.children.slice(0, i);
+        return memo;
     }
-    refreshSegment(segment, dirty, width) {
-        const lines = [];
-        let offset = 0;
-        let next = 0;
-        for (let j = 0; j < segment.children.length; j++) {
-            const count = segment.lineCounts[j];
-            if (dirty[next] === j) {
-                next += 1;
-                const child = segment.children[j];
-                const fresh = child.render(width);
-                for (const line of fresh)
-                    lines.push(line);
-                segment.lineCounts[j] = fresh.length;
-                segment.generations[j] = renderGeneration(child);
-                releaseRenderCache(child);
-            }
-            else {
-                for (let l = offset; l < offset + count; l++)
-                    lines.push(segment.lines[l]);
-            }
-            offset += count;
-        }
-        segment.lines = lines;
-        this.stats.refreshedChildren += dirty.length;
-        this.stats.refreshedSegments += 1;
+    /**
+     * Verify the virtual prefix is still a valid prefix of `children` and still
+     * settled. On the first mismatch (identity, reorder, un-settled) the prefix
+     * is truncated there: children past the cut render live this frame and
+     * their lines materialize as new output (a bounded repaint repair).
+     */
+    reconcileVirtual() {
+        const count = this.virtualChildren.length;
+        let v = 0;
+        while (v < count && this.children[v] === this.virtualChildren[v] && this.isChildSettled(this.children[v]))
+            v += 1;
+        if (v < count)
+            this.virtualChildren.length = v;
     }
-    /** Freeze settled live children that sit above the live-line budget. */
-    freezeAboveBudget(parts, partStarts, live, liveLines, budget) {
-        let acc = 0;
-        let liveStart = this.children.length;
-        for (let p = parts.length - 1; p >= 0; p--) {
-            acc += parts[p].length;
-            liveStart = partStarts[p];
-            if (acc >= budget)
-                break;
-        }
-        let segmentIndex = 0;
-        for (let n = 0; n < live.length && live[n] < liveStart; n++) {
-            const index = live[n];
-            const child = this.children[index];
-            if (!this.isChildSettled(child))
-                continue;
-            const lines = liveLines[n];
-            while (segmentIndex < this.segments.length && this.segments[segmentIndex].from < index)
-                segmentIndex += 1;
-            const previous = this.segments[segmentIndex - 1];
-            const generation = renderGeneration(child);
-            if (previous &&
-                previous.from + previous.children.length === index &&
-                previous.lines.length + lines.length <= SEGMENT_MAX_LINES) {
-                previous.children.push(child);
-                previous.lineCounts.push(lines.length);
-                previous.generations.push(generation);
-                for (const line of lines)
-                    previous.lines.push(line);
-            }
-            else {
-                const segment = {
-                    from: index,
-                    children: [child],
-                    lineCounts: [lines.length],
-                    generations: [generation],
-                    lines: lines.slice(),
-                };
-                this.segments.splice(segmentIndex, 0, segment);
-                segmentIndex += 1;
-            }
-            releaseRenderCache(child);
-        }
+    /** Drop unsettled segments and refresh children whose generation moved. */
+    reconcile(width) {
+        const kept = reconcileSegments(this.segments, this.children, this.settled, width, this.stats);
+        this.segments = kept ?? [];
     }
 }
 //# sourceMappingURL=windowed-container.js.map

package/dist/windowed-container.js.map

@@ -1 +1 @@
-{"version":3,"file":"windowed-container.js","sourceRoot":"","sources":["../src/windowed-container.ts"],"names":[],"mappings":"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","sourcesContent":["import { isRenderSettled, releaseRenderCache, renderGeneration } from \"./render-generation.ts\";\nimport { type Component, Container } from \"./tui.ts\";\n\n/**\n * A frozen segment never grows past this many lines (a single larger child\n * gets a segment of its own). Bounds the work of refreshing one changed child:\n * only its segment's line buffer is rebuilt, never the whole frozen history.\n */\nconst SEGMENT_MAX_LINES = 512;\n\n/**\n * Live-line budget: the bottom `max(120, 2 × terminal rows)` lines always\n * render live. Two viewports keep components that change without announcing\n * it (animations, stateful extension renderers) live wherever the user can\n * see them, also after scrolling back one screen; the 120 floor is the budget\n * when no viewport is attached and on small terminals.\n */\nconst MIN_LIVE_LINE_BUDGET = 120;\nconst LIVE_VIEWPORTS = 2;\n\n/** Contiguous settled children whose rendered lines are reused verbatim. */\ntype FrozenSegment = {\n\t/** Index in `children` of the first frozen child. */\n\tfrom: number;\n\t/** The frozen children themselves (identity-checked every frame). */\n\tchildren: Component[];\n\tlineCounts: number[];\n\t/** `getRenderGeneration()` of each child when its lines were taken. */\n\tgenerations: number[];\n\t/** Concatenation of the children's lines. */\n\tlines: string[];\n};\n\nexport interface WindowedRenderStats {\n\t/** Children rendered live this frame (live tail plus unsettled gaps). */\n\tliveChildren: number;\n\t/** Frozen children re-rendered because their generation moved. */\n\trefreshedChildren: number;\n\t/** Frozen segments whose line buffer was rebuilt this frame. */\n\trefreshedSegments: number;\n}\n\n/**\n * Container that freezes settled children above a live-line budget into\n * bounded line segments and stops re-rendering them.\n *\n * - Settledness comes from `isRenderSettled()` (missing ⇒ settled). Unsettled\n *   children always render live; settled runs on both sides of them freeze.\n * - Each frozen child remembers its `getRenderGeneration()`. When it moves,\n *   only that child is re-rendered and only its segment is rebuilt.\n * - An unsettled frozen child drops just its segment. Width changes,\n *   `invalidate()`, `clear()` and foreign edits of `children` thaw everything.\n * - Freezing releases the child's render caches (frozen lines are the only\n *   retained copy); a later change re-renders that one child from source.\n */\nexport class WindowedContainer extends Container {\n\tprivate segments: FrozenSegment[] = [];\n\tprivate frozenWidth = -1;\n\tprivate liveLineBudget = MIN_LIVE_LINE_BUDGET;\n\tprivate viewportRows?: () => number;\n\tprivate lastLiveLineBudget = MIN_LIVE_LINE_BUDGET;\n\tprivate stats: WindowedRenderStats = { liveChildren: 0, refreshedChildren: 0, refreshedSegments: 0 };\n\n\t/** Fixed budget (tests, embedders); detaches any viewport set by `setViewportRows`. */\n\tsetLiveLineBudget(lines: number): void {\n\t\tthis.viewportRows = undefined;\n\t\tthis.liveLineBudget = Math.max(1, Math.floor(lines));\n\t}\n\n\t/**\n\t * Follow the terminal height: budget = max(120, 2 × rows), re-read on every\n\t * render so a resize applies on the next frame.\n\t */\n\tsetViewportRows(rows: () => number): void {\n\t\tthis.viewportRows = rows;\n\t}\n\n\tgetLiveLineBudget(): number {\n\t\tif (!this.viewportRows) return this.liveLineBudget;\n\t\tconst rows = Math.floor(this.viewportRows());\n\t\treturn Math.max(MIN_LIVE_LINE_BUDGET, Number.isFinite(rows) ? rows * LIVE_VIEWPORTS : 0);\n\t}\n\n\tgetFrozenChildCount(): number {\n\t\tlet count = 0;\n\t\tfor (const segment of this.segments) count += segment.children.length;\n\t\treturn count;\n\t}\n\n\tgetFrozenLineCount(): number {\n\t\tlet count = 0;\n\t\tfor (const segment of this.segments) count += segment.lines.length;\n\t\treturn count;\n\t}\n\n\t/** Diagnostics: number of frozen segments. */\n\tgetFrozenSegmentCount(): number {\n\t\treturn this.segments.length;\n\t}\n\n\t/** Diagnostics: frozen child index ranges [from, to). */\n\tgetFrozenRanges(): ReadonlyArray<{ from: number; to: number }> {\n\t\treturn this.segments.map((segment) => ({ from: segment.from, to: segment.from + segment.children.length }));\n\t}\n\n\t/** Diagnostics: what the most recent `render` had to redo. */\n\tgetLastRenderStats(): Readonly<WindowedRenderStats> {\n\t\treturn this.stats;\n\t}\n\n\t/** Subclasses may add their own lifecycle knowledge (e.g. an agent_end backstop). */\n\tprotected isChildSettled(child: Component): boolean {\n\t\treturn isRenderSettled(child);\n\t}\n\n\toverride removeChild(component: Component): void {\n\t\tconst index = this.children.indexOf(component);\n\t\tif (index === -1) return;\n\t\tsuper.removeChild(component);\n\t\tfor (const segment of this.segments) {\n\t\t\tif (index < segment.from) {\n\t\t\t\tsegment.from -= 1;\n\t\t\t} else if (index < segment.from + segment.children.length) {\n\t\t\t\tconst j = index - segment.from;\n\t\t\t\tlet offset = 0;\n\t\t\t\tfor (let k = 0; k < j; k++) offset += segment.lineCounts[k];\n\t\t\t\tsegment.lines.splice(offset, segment.lineCounts[j]);\n\t\t\t\tsegment.children.splice(j, 1);\n\t\t\t\tsegment.lineCounts.splice(j, 1);\n\t\t\t\tsegment.generations.splice(j, 1);\n\t\t\t}\n\t\t}\n\t\tthis.segments = this.segments.filter((segment) => segment.children.length > 0);\n\t}\n\n\toverride clear(): void {\n\t\tthis.thaw();\n\t\tsuper.clear();\n\t}\n\n\toverride invalidate(): void {\n\t\tthis.thaw();\n\t\tsuper.invalidate();\n\t}\n\n\t/** Drop every frozen segment; the next render re-renders all children. */\n\tthaw(): void {\n\t\tthis.segments = [];\n\t\tthis.frozenWidth = -1;\n\t}\n\n\toverride render(width: number): string[] {\n\t\tconst budget = this.getLiveLineBudget();\n\t\t// A taller terminal widens the live window: thaw so rows now inside it render live.\n\t\tif (width !== this.frozenWidth || budget > this.lastLiveLineBudget) this.thaw();\n\t\tthis.lastLiveLineBudget = budget;\n\t\tthis.frozenWidth = width;\n\t\tthis.stats = { liveChildren: 0, refreshedChildren: 0, refreshedSegments: 0 };\n\t\tthis.reconcile(width);\n\n\t\tconst parts: string[][] = [];\n\t\tconst partStarts: number[] = [];\n\t\tconst live: number[] = [];\n\t\tconst liveLines: string[][] = [];\n\t\tlet segmentIndex = 0;\n\t\tfor (let i = 0; i < this.children.length; ) {\n\t\t\tconst segment = this.segments[segmentIndex];\n\t\t\tlet lines: string[];\n\t\t\tpartStarts.push(i);\n\t\t\tif (segment && segment.from === i) {\n\t\t\t\tlines = segment.lines;\n\t\t\t\ti += segment.children.length;\n\t\t\t\tsegmentIndex += 1;\n\t\t\t} else {\n\t\t\t\tlines = this.children[i].render(width);\n\t\t\t\tlive.push(i);\n\t\t\t\tliveLines.push(lines);\n\t\t\t\ti += 1;\n\t\t\t}\n\t\t\tparts.push(lines);\n\t\t}\n\t\tthis.stats.liveChildren = live.length;\n\n\t\t// Copy before freezing: freezing appends to segment line buffers. Native\n\t\t// concat is a bulk copy; spread arguments stay far below engine limits\n\t\t// because frozen rows arrive as a few hundred segment arrays.\n\t\tconst out = parts.length < 8192 ? ([] as string[]).concat(...parts) : parts.flat();\n\t\tthis.freezeAboveBudget(parts, partStarts, live, liveLines, budget);\n\t\treturn out;\n\t}\n\n\t/** Drop unsettled segments and refresh children whose generation moved. */\n\tprivate reconcile(width: number): void {\n\t\tconst kept: FrozenSegment[] = [];\n\t\tfor (const segment of this.segments) {\n\t\t\tlet dirty: number[] | undefined;\n\t\t\tlet settled = true;\n\t\t\tfor (let j = 0; j < segment.children.length; j++) {\n\t\t\t\tconst child = segment.children[j];\n\t\t\t\tif (this.children[segment.from + j] !== child) {\n\t\t\t\t\t// `children` was edited behind our back: nothing frozen can be trusted.\n\t\t\t\t\tthis.segments = [];\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tif (!this.isChildSettled(child)) {\n\t\t\t\t\tsettled = false;\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t\tif (renderGeneration(child) !== segment.generations[j]) {\n\t\t\t\t\tdirty ??= [];\n\t\t\t\t\tdirty.push(j);\n\t\t\t\t}\n\t\t\t}\n\t\t\tif (!settled) continue;\n\t\t\tif (dirty) this.refreshSegment(segment, dirty, width);\n\t\t\tkept.push(segment);\n\t\t}\n\t\tthis.segments = kept;\n\t}\n\n\tprivate refreshSegment(segment: FrozenSegment, dirty: number[], width: number): void {\n\t\tconst lines: string[] = [];\n\t\tlet offset = 0;\n\t\tlet next = 0;\n\t\tfor (let j = 0; j < segment.children.length; j++) {\n\t\t\tconst count = segment.lineCounts[j];\n\t\t\tif (dirty[next] === j) {\n\t\t\t\tnext += 1;\n\t\t\t\tconst child = segment.children[j];\n\t\t\t\tconst fresh = child.render(width);\n\t\t\t\tfor (const line of fresh) lines.push(line);\n\t\t\t\tsegment.lineCounts[j] = fresh.length;\n\t\t\t\tsegment.generations[j] = renderGeneration(child);\n\t\t\t\treleaseRenderCache(child);\n\t\t\t} else {\n\t\t\t\tfor (let l = offset; l < offset + count; l++) lines.push(segment.lines[l]);\n\t\t\t}\n\t\t\toffset += count;\n\t\t}\n\t\tsegment.lines = lines;\n\t\tthis.stats.refreshedChildren += dirty.length;\n\t\tthis.stats.refreshedSegments += 1;\n\t}\n\n\t/** Freeze settled live children that sit above the live-line budget. */\n\tprivate freezeAboveBudget(\n\t\tparts: string[][],\n\t\tpartStarts: number[],\n\t\tlive: number[],\n\t\tliveLines: string[][],\n\t\tbudget: number,\n\t): void {\n\t\tlet acc = 0;\n\t\tlet liveStart = this.children.length;\n\t\tfor (let p = parts.length - 1; p >= 0; p--) {\n\t\t\tacc += parts[p].length;\n\t\t\tliveStart = partStarts[p];\n\t\t\tif (acc >= budget) break;\n\t\t}\n\t\tlet segmentIndex = 0;\n\t\tfor (let n = 0; n < live.length && live[n] < liveStart; n++) {\n\t\t\tconst index = live[n];\n\t\t\tconst child = this.children[index];\n\t\t\tif (!this.isChildSettled(child)) continue;\n\t\t\tconst lines = liveLines[n];\n\t\t\twhile (segmentIndex < this.segments.length && this.segments[segmentIndex].from < index) segmentIndex += 1;\n\t\t\tconst previous = this.segments[segmentIndex - 1];\n\t\t\tconst generation = renderGeneration(child);\n\t\t\tif (\n\t\t\t\tprevious &&\n\t\t\t\tprevious.from + previous.children.length === index &&\n\t\t\t\tprevious.lines.length + lines.length <= SEGMENT_MAX_LINES\n\t\t\t) {\n\t\t\t\tprevious.children.push(child);\n\t\t\t\tprevious.lineCounts.push(lines.length);\n\t\t\t\tprevious.generations.push(generation);\n\t\t\t\tfor (const line of lines) previous.lines.push(line);\n\t\t\t} else {\n\t\t\t\tconst segment: FrozenSegment = {\n\t\t\t\t\tfrom: index,\n\t\t\t\t\tchildren: [child],\n\t\t\t\t\tlineCounts: [lines.length],\n\t\t\t\t\tgenerations: [generation],\n\t\t\t\t\tlines: lines.slice(),\n\t\t\t\t};\n\t\t\t\tthis.segments.splice(segmentIndex, 0, segment);\n\t\t\t\tsegmentIndex += 1;\n\t\t\t}\n\t\t\treleaseRenderCache(child);\n\t\t}\n\t}\n}\n"]}
+{"version":3,"file":"windowed-container.js","sourceRoot":"","sources":["../src/windowed-container.ts"],"names":[],"mappings":"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","sourcesContent":["import { isRenderSettled } from \"./render-generation.ts\";\nimport { type Component, Container } from \"./tui.ts\";\nimport { dropFrozenChild, type FrozenSegment, freezeAboveBudget, reconcileSegments } from \"./windowed-segments.ts\";\n\n/**\n * Live-line budget: the bottom `max(120, 2 × terminal rows)` lines always\n * render live. Two viewports keep components that change without announcing\n * it (animations, stateful extension renderers) live wherever the user can\n * see them, also after scrolling back one screen; the 120 floor is the budget\n * when no viewport is attached and on small terminals.\n */\nconst MIN_LIVE_LINE_BUDGET = 120;\nconst LIVE_VIEWPORTS = 2;\n\nexport interface WindowedRenderStats {\n\t/** Children rendered live this frame (live tail plus unsettled gaps). */\n\tliveChildren: number;\n\t/** Frozen children re-rendered because their generation moved. */\n\trefreshedChildren: number;\n\t/** Frozen segments whose line buffer was rebuilt this frame. */\n\trefreshedSegments: number;\n\t/** Settled children skipped entirely this frame (virtual prefix). */\n\tvirtualChildren: number;\n}\n\n/**\n * Container that freezes settled children above a live-line budget into\n * bounded line segments and stops re-rendering them.\n *\n * - Settledness comes from `isRenderSettled()` (missing ⇒ settled). Unsettled\n *   children always render live; settled runs on both sides of them freeze.\n * - Each frozen child remembers its `getRenderGeneration()`. When it moves,\n *   only that child is re-rendered and only its segment is rebuilt.\n * - An unsettled frozen child drops just its segment. Width changes,\n *   `invalidate()`, `clear()` and foreign edits of `children` thaw everything.\n * - Freezing releases the child's render caches (frozen lines are the only\n *   retained copy); a later change re-renders that one child from source.\n *\n * Virtual prefix (opt-in via `setPrefixSeed`/`setPrefixSeedViewport`):\n * when a prefix seed is configured, children above the live budget PLUS the\n * seed budget never render at all — `render()` returns zero lines for them.\n * Rendered line work is bounded by live + seed; prefix identity/settledness\n * checks still visit skipped children. The\n * prefix is a contiguous run anchored at index 0; children above the seed\n * budget never enter the output, so callers that need the whole transcript\n * (`buildFinalSessionLog`, exports) must use `renderAll(width)`.\n */\nexport class WindowedContainer extends Container {\n\tprivate segments: FrozenSegment[] = [];\n\tprivate frozenWidth = -1;\n\tprivate liveLineBudget = MIN_LIVE_LINE_BUDGET;\n\tprivate viewportRows?: () => number;\n\tprivate lastLiveLineBudget = MIN_LIVE_LINE_BUDGET;\n\tprivate stats: WindowedRenderStats = {\n\t\tliveChildren: 0,\n\t\trefreshedChildren: 0,\n\t\trefreshedSegments: 0,\n\t\tvirtualChildren: 0,\n\t};\n\t/**\n\t * Children above live+seed that never render (opt-in). Contiguous from\n\t * index 0; emits zero lines every frame once established.\n\t */\n\tprivate virtualChildren: Component[] = [];\n\t/** Unset preserves full-history rendering; zero seeds only the live tail. */\n\tprivate seedLines?: number;\n\tprivate seedViewportRows?: () => number;\n\tprivate seedScreens?: number;\n\tprivate lastPrefixSeedLines?: number;\n\t/** Bound `isChildSettled` for the extracted segment helpers. */\n\tprivate readonly settled = (child: Component): boolean => this.isChildSettled(child);\n\n\t/** Fixed budget (tests, embedders); detaches any viewport set by `setViewportRows`. */\n\tsetLiveLineBudget(lines: number): void {\n\t\tthis.viewportRows = undefined;\n\t\tthis.liveLineBudget = Math.max(1, Math.floor(lines));\n\t}\n\n\t/**\n\t * Follow the terminal height: budget = max(120, 2 × rows), re-read on every\n\t * render so a resize applies on the next frame.\n\t */\n\tsetViewportRows(rows: () => number): void {\n\t\tthis.viewportRows = rows;\n\t}\n\n\tgetLiveLineBudget(): number {\n\t\tif (!this.viewportRows) return this.liveLineBudget;\n\t\tconst rows = Math.floor(this.viewportRows());\n\t\treturn Math.max(MIN_LIVE_LINE_BUDGET, Number.isFinite(rows) ? rows * LIVE_VIEWPORTS : 0);\n\t}\n\n\t/**\n\t * Opt in to the virtual prefix: settled children above\n\t * `live budget + seedLines` never render — the first frame of a long\n\t * transcript renders only live + seed lines. Zero seeds only the live\n\t * tail; unset or non-finite input restores full-history rendering.\n\t */\n\tsetPrefixSeed(lines?: number): void {\n\t\tthis.seedViewportRows = undefined;\n\t\tthis.seedScreens = undefined;\n\t\tthis.seedLines = lines !== undefined && Number.isFinite(lines) ? Math.max(0, Math.floor(lines)) : undefined;\n\t}\n\n\t/** Seed budget follows the terminal height: `screens × rows`, re-read on every render. */\n\tsetPrefixSeedViewport(screens: number, rows: () => number): void {\n\t\tthis.seedLines = undefined;\n\t\tthis.seedScreens = Number.isFinite(screens) ? Math.max(0, Math.floor(screens)) : undefined;\n\t\tthis.seedViewportRows = rows;\n\t}\n\n\t/** Current seed budget in lines; undefined means virtualization is off. */\n\tgetPrefixSeedLines(): number | undefined {\n\t\tif (!this.seedViewportRows) return this.seedLines;\n\t\tif (this.seedScreens === undefined) return undefined;\n\t\tconst rows = Math.floor(this.seedViewportRows());\n\t\treturn Math.max(0, Number.isFinite(rows) ? rows * this.seedScreens : 0);\n\t}\n\n\t/** Children skipped entirely by the last render (virtual prefix). */\n\tgetVirtualChildCount(): number {\n\t\treturn this.virtualChildren.length;\n\t}\n\n\tgetFrozenChildCount(): number {\n\t\tlet count = 0;\n\t\tfor (const segment of this.segments) count += segment.children.length;\n\t\treturn count;\n\t}\n\n\tgetFrozenLineCount(): number {\n\t\tlet count = 0;\n\t\tfor (const segment of this.segments) count += segment.lines.length;\n\t\treturn count;\n\t}\n\n\t/** Diagnostics: number of frozen segments. */\n\tgetFrozenSegmentCount(): number {\n\t\treturn this.segments.length;\n\t}\n\n\t/** Diagnostics: frozen child index ranges [from, to). */\n\tgetFrozenRanges(): ReadonlyArray<{ from: number; to: number }> {\n\t\treturn this.segments.map((segment) => ({ from: segment.from, to: segment.from + segment.children.length }));\n\t}\n\n\t/** Diagnostics: what the most recent `render` had to redo. */\n\tgetLastRenderStats(): Readonly<WindowedRenderStats> {\n\t\treturn this.stats;\n\t}\n\n\t/** Subclasses may add their own lifecycle knowledge (e.g. an agent_end backstop). */\n\tprotected isChildSettled(child: Component): boolean {\n\t\treturn isRenderSettled(child);\n\t}\n\n\toverride removeChild(component: Component): void {\n\t\tconst index = this.children.indexOf(component);\n\t\tif (index === -1) return;\n\t\tsuper.removeChild(component);\n\t\tif (index < this.virtualChildren.length) this.virtualChildren.splice(index, 1);\n\t\tdropFrozenChild(this.segments, index);\n\t}\n\n\toverride clear(): void {\n\t\tthis.thaw();\n\t\tsuper.clear();\n\t}\n\n\toverride invalidate(): void {\n\t\tthis.thaw();\n\t\tsuper.invalidate();\n\t}\n\n\t/** Drop every frozen segment and the virtual prefix; the next render re-lays out all children. */\n\tthaw(): void {\n\t\tthis.segments = [];\n\t\tthis.virtualChildren = [];\n\t\tthis.frozenWidth = -1;\n\t}\n\n\t/**\n\t * Render every child without any windowing or virtualization. For callers\n\t * that need the complete transcript (final session log, exports) — the\n\t * windowed state is untouched and the next `render()` resumes windowing.\n\t */\n\trenderAll(width: number): string[] {\n\t\treturn super.render(width);\n\t}\n\n\toverride render(width: number): string[] {\n\t\tconst budget = this.getLiveLineBudget();\n\t\tconst seed = this.getPrefixSeedLines();\n\t\t// Rebuild on seed changes too: a taller terminal can grow it without growing the live budget.\n\t\tif (width !== this.frozenWidth || budget > this.lastLiveLineBudget || seed !== this.lastPrefixSeedLines)\n\t\t\tthis.thaw();\n\t\tthis.lastLiveLineBudget = budget;\n\t\tthis.lastPrefixSeedLines = seed;\n\t\tthis.frozenWidth = width;\n\t\tthis.stats = { liveChildren: 0, refreshedChildren: 0, refreshedSegments: 0, virtualChildren: 0 };\n\t\t// Build the virtual prefix once, while no frozen segments exist. Lines\n\t\t// rendered during the boundary scan are memoized into the emit pass.\n\t\tconst memo =\n\t\t\tseed !== undefined && this.virtualChildren.length === 0 && this.segments.length === 0\n\t\t\t\t? this.scanVirtualBoundary(width, budget, seed)\n\t\t\t\t: undefined;\n\t\tthis.reconcileVirtual();\n\t\tthis.reconcile(width);\n\t\tthis.stats.virtualChildren = this.virtualChildren.length;\n\n\t\tconst parts: string[][] = [];\n\t\tconst partStarts: number[] = [];\n\t\tconst live: number[] = [];\n\t\tconst liveLines: string[][] = [];\n\t\tlet segmentIndex = 0;\n\t\tfor (let i = this.virtualChildren.length; i < this.children.length; ) {\n\t\t\tconst segment = this.segments[segmentIndex];\n\t\t\tlet lines: string[];\n\t\t\tpartStarts.push(i);\n\t\t\tif (segment && segment.from === i) {\n\t\t\t\tlines = segment.lines;\n\t\t\t\ti += segment.children.length;\n\t\t\t\tsegmentIndex += 1;\n\t\t\t} else {\n\t\t\t\tlines = memo?.get(i) ?? this.children[i].render(width);\n\t\t\t\tlive.push(i);\n\t\t\t\tliveLines.push(lines);\n\t\t\t\ti += 1;\n\t\t\t}\n\t\t\tparts.push(lines);\n\t\t}\n\t\tthis.stats.liveChildren = live.length;\n\n\t\t// Copy before freezing: freezing appends to segment line buffers. Native\n\t\t// concat is a bulk copy; spread arguments stay far below engine limits\n\t\t// because frozen rows arrive as a few hundred segment arrays.\n\t\tconst out = parts.length < 8192 ? ([] as string[]).concat(...parts) : parts.flat();\n\t\tfreezeAboveBudget(this.segments, this.children, this.settled, parts, partStarts, live, liveLines, budget);\n\t\treturn out;\n\t}\n\n\t/**\n\t * Establish the virtual prefix in a single bottom-up pass: render children\n\t * from the tail until `live + seed` lines are covered and mark everything\n\t * above as virtual. Returns the rendered lines keyed by child index for\n\t * the emit pass to reuse (children render at most once per frame).\n\t *\n\t * An unsettled child may end up inside the virtual prefix (the scan does\n\t * not check settledness): `reconcileVirtual` then truncates the prefix\n\t * there and the emit pass renders it live as usual, so no output is lost.\n\t */\n\tprivate scanVirtualBoundary(width: number, budget: number, seed: number): Map<number, string[]> {\n\t\tconst memo = new Map<number, string[]>();\n\t\tconst target = budget + seed;\n\t\tlet acc = 0;\n\t\tlet i = this.children.length;\n\t\twhile (i > 0 && acc < target) {\n\t\t\ti -= 1;\n\t\t\tconst lines = this.children[i].render(width);\n\t\t\tmemo.set(i, lines);\n\t\t\tacc += lines.length;\n\t\t}\n\t\tthis.virtualChildren = this.children.slice(0, i);\n\t\treturn memo;\n\t}\n\n\t/**\n\t * Verify the virtual prefix is still a valid prefix of `children` and still\n\t * settled. On the first mismatch (identity, reorder, un-settled) the prefix\n\t * is truncated there: children past the cut render live this frame and\n\t * their lines materialize as new output (a bounded repaint repair).\n\t */\n\tprivate reconcileVirtual(): void {\n\t\tconst count = this.virtualChildren.length;\n\t\tlet v = 0;\n\t\twhile (v < count && this.children[v] === this.virtualChildren[v] && this.isChildSettled(this.children[v])) v += 1;\n\t\tif (v < count) this.virtualChildren.length = v;\n\t}\n\n\t/** Drop unsettled segments and refresh children whose generation moved. */\n\tprivate reconcile(width: number): void {\n\t\tconst kept = reconcileSegments(this.segments, this.children, this.settled, width, this.stats);\n\t\tthis.segments = kept ?? [];\n\t}\n}\n"]}

package/dist/windowed-segments.d.ts

@@ -0,0 +1,37 @@
+import type { Component } from "./tui.ts";
+/**
+ * A frozen segment never grows past this many lines (a single larger child
+ * gets a segment of its own). Bounds the work of refreshing one changed child:
+ * only its segment's line buffer is rebuilt, never the whole frozen history.
+ */
+export declare const SEGMENT_MAX_LINES = 512;
+/** Contiguous settled children whose rendered lines are reused verbatim. */
+export type FrozenSegment = {
+    /** Index in `children` of the first frozen child. */
+    from: number;
+    /** The frozen children themselves (identity-checked every frame). */
+    children: Component[];
+    lineCounts: number[];
+    /** `getRenderGeneration()` of each child when its lines were taken. */
+    generations: number[];
+    /** Concatenation of the children's lines. */
+    lines: string[];
+};
+/** Per-frame counters a refresh accumulates into. */
+export type SegmentRefreshStats = {
+    refreshedChildren: number;
+    refreshedSegments: number;
+};
+type SettledCheck = (child: Component) => boolean;
+/** Splice one child out of the segment table after `children[index]` was removed. */
+export declare function dropFrozenChild(segments: FrozenSegment[], index: number): void;
+/**
+ * Drop unsettled segments and refresh children whose generation moved.
+ * Returns the kept segments, or null when a foreign edit of `children`
+ * invalidated every segment (the caller drops all state).
+ */
+export declare function reconcileSegments(segments: FrozenSegment[], children: readonly Component[], isSettled: SettledCheck, width: number, stats: SegmentRefreshStats): FrozenSegment[] | null;
+/** Freeze settled live children that sit above the live-line budget. */
+export declare function freezeAboveBudget(segments: FrozenSegment[], children: readonly Component[], isSettled: SettledCheck, parts: string[][], partStarts: number[], live: number[], liveLines: string[][], budget: number): void;
+export {};
+//# sourceMappingURL=windowed-segments.d.ts.map

package/dist/windowed-segments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"windowed-segments.d.ts","sourceRoot":"","sources":["../src/windowed-segments.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAErC,4EAA4E;AAC5E,MAAM,MAAM,aAAa,GAAG;IAC3B,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,uEAAuE;IACvE,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,6CAA6C;IAC7C,KAAK,EAAE,MAAM,EAAE,CAAC;CAChB,CAAC;AAEF,qDAAqD;AACrD,MAAM,MAAM,mBAAmB,GAAG;IAAE,iBAAiB,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3F,KAAK,YAAY,GAAG,CAAC,KAAK,EAAE,SAAS,KAAK,OAAO,CAAC;AAElD,qFAAqF;AACrF,wBAAgB,eAAe,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAiB9E;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAChC,QAAQ,EAAE,aAAa,EAAE,EACzB,QAAQ,EAAE,SAAS,SAAS,EAAE,EAC9B,SAAS,EAAE,YAAY,EACvB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,mBAAmB,GACxB,aAAa,EAAE,GAAG,IAAI,CAyBxB;AA0BD,wEAAwE;AACxE,wBAAgB,iBAAiB,CAChC,QAAQ,EAAE,aAAa,EAAE,EACzB,QAAQ,EAAE,SAAS,SAAS,EAAE,EAC9B,SAAS,EAAE,YAAY,EACvB,KAAK,EAAE,MAAM,EAAE,EAAE,EACjB,UAAU,EAAE,MAAM,EAAE,EACpB,IAAI,EAAE,MAAM,EAAE,EACd,SAAS,EAAE,MAAM,EAAE,EAAE,EACrB,MAAM,EAAE,MAAM,GACZ,IAAI,CAuCN","sourcesContent":["import { releaseRenderCache, renderGeneration } from \"./render-generation.ts\";\nimport type { Component } from \"./tui.ts\";\n\n/**\n * A frozen segment never grows past this many lines (a single larger child\n * gets a segment of its own). Bounds the work of refreshing one changed child:\n * only its segment's line buffer is rebuilt, never the whole frozen history.\n */\nexport const SEGMENT_MAX_LINES = 512;\n\n/** Contiguous settled children whose rendered lines are reused verbatim. */\nexport type FrozenSegment = {\n\t/** Index in `children` of the first frozen child. */\n\tfrom: number;\n\t/** The frozen children themselves (identity-checked every frame). */\n\tchildren: Component[];\n\tlineCounts: number[];\n\t/** `getRenderGeneration()` of each child when its lines were taken. */\n\tgenerations: number[];\n\t/** Concatenation of the children's lines. */\n\tlines: string[];\n};\n\n/** Per-frame counters a refresh accumulates into. */\nexport type SegmentRefreshStats = { refreshedChildren: number; refreshedSegments: number };\n\ntype SettledCheck = (child: Component) => boolean;\n\n/** Splice one child out of the segment table after `children[index]` was removed. */\nexport function dropFrozenChild(segments: FrozenSegment[], index: number): void {\n\tfor (const segment of segments) {\n\t\tif (index < segment.from) {\n\t\t\tsegment.from -= 1;\n\t\t} else if (index < segment.from + segment.children.length) {\n\t\t\tconst j = index - segment.from;\n\t\t\tlet offset = 0;\n\t\t\tfor (let k = 0; k < j; k++) offset += segment.lineCounts[k];\n\t\t\tsegment.lines.splice(offset, segment.lineCounts[j]);\n\t\t\tsegment.children.splice(j, 1);\n\t\t\tsegment.lineCounts.splice(j, 1);\n\t\t\tsegment.generations.splice(j, 1);\n\t\t}\n\t}\n\tfor (let i = segments.length - 1; i >= 0; i--) {\n\t\tif (segments[i].children.length === 0) segments.splice(i, 1);\n\t}\n}\n\n/**\n * Drop unsettled segments and refresh children whose generation moved.\n * Returns the kept segments, or null when a foreign edit of `children`\n * invalidated every segment (the caller drops all state).\n */\nexport function reconcileSegments(\n\tsegments: FrozenSegment[],\n\tchildren: readonly Component[],\n\tisSettled: SettledCheck,\n\twidth: number,\n\tstats: SegmentRefreshStats,\n): FrozenSegment[] | null {\n\tconst kept: FrozenSegment[] = [];\n\tfor (const segment of segments) {\n\t\tlet dirty: number[] | undefined;\n\t\tlet settled = true;\n\t\tfor (let j = 0; j < segment.children.length; j++) {\n\t\t\tconst child = segment.children[j];\n\t\t\tif (children[segment.from + j] !== child) {\n\t\t\t\t// `children` was edited behind our back: nothing frozen can be trusted.\n\t\t\t\treturn null;\n\t\t\t}\n\t\t\tif (!isSettled(child)) {\n\t\t\t\tsettled = false;\n\t\t\t\tbreak;\n\t\t\t}\n\t\t\tif (renderGeneration(child) !== segment.generations[j]) {\n\t\t\t\tdirty ??= [];\n\t\t\t\tdirty.push(j);\n\t\t\t}\n\t\t}\n\t\tif (!settled) continue;\n\t\tif (dirty) refreshSegment(segment, dirty, width, stats);\n\t\tkept.push(segment);\n\t}\n\treturn kept;\n}\n\nfunction refreshSegment(segment: FrozenSegment, dirty: number[], width: number, stats: SegmentRefreshStats): void {\n\tconst lines: string[] = [];\n\tlet offset = 0;\n\tlet next = 0;\n\tfor (let j = 0; j < segment.children.length; j++) {\n\t\tconst count = segment.lineCounts[j];\n\t\tif (dirty[next] === j) {\n\t\t\tnext += 1;\n\t\t\tconst child = segment.children[j];\n\t\t\tconst fresh = child.render(width);\n\t\t\tfor (const line of fresh) lines.push(line);\n\t\t\tsegment.lineCounts[j] = fresh.length;\n\t\t\tsegment.generations[j] = renderGeneration(child);\n\t\t\treleaseRenderCache(child);\n\t\t} else {\n\t\t\tfor (let l = offset; l < offset + count; l++) lines.push(segment.lines[l]);\n\t\t}\n\t\toffset += count;\n\t}\n\tsegment.lines = lines;\n\tstats.refreshedChildren += dirty.length;\n\tstats.refreshedSegments += 1;\n}\n\n/** Freeze settled live children that sit above the live-line budget. */\nexport function freezeAboveBudget(\n\tsegments: FrozenSegment[],\n\tchildren: readonly Component[],\n\tisSettled: SettledCheck,\n\tparts: string[][],\n\tpartStarts: number[],\n\tlive: number[],\n\tliveLines: string[][],\n\tbudget: number,\n): void {\n\tlet acc = 0;\n\tlet liveStart = children.length;\n\tfor (let p = parts.length - 1; p >= 0; p--) {\n\t\tacc += parts[p].length;\n\t\tliveStart = partStarts[p];\n\t\tif (acc >= budget) break;\n\t}\n\tlet segmentIndex = 0;\n\tfor (let n = 0; n < live.length && live[n] < liveStart; n++) {\n\t\tconst index = live[n];\n\t\tconst child = children[index];\n\t\tif (!isSettled(child)) continue;\n\t\tconst lines = liveLines[n];\n\t\twhile (segmentIndex < segments.length && segments[segmentIndex].from < index) segmentIndex += 1;\n\t\tconst previous = segments[segmentIndex - 1];\n\t\tconst generation = renderGeneration(child);\n\t\tif (\n\t\t\tprevious &&\n\t\t\tprevious.from + previous.children.length === index &&\n\t\t\tprevious.lines.length + lines.length <= SEGMENT_MAX_LINES\n\t\t) {\n\t\t\tprevious.children.push(child);\n\t\t\tprevious.lineCounts.push(lines.length);\n\t\t\tprevious.generations.push(generation);\n\t\t\tfor (const line of lines) previous.lines.push(line);\n\t\t} else {\n\t\t\tconst segment: FrozenSegment = {\n\t\t\t\tfrom: index,\n\t\t\t\tchildren: [child],\n\t\t\t\tlineCounts: [lines.length],\n\t\t\t\tgenerations: [generation],\n\t\t\t\tlines: lines.slice(),\n\t\t\t};\n\t\t\tsegments.splice(segmentIndex, 0, segment);\n\t\t\tsegmentIndex += 1;\n\t\t}\n\t\treleaseRenderCache(child);\n\t}\n}\n"]}