@flyingrobots/bijou-tui 7.2.0 → 8.0.0-rc.1

package/dist/app-frame-render-transition.js

@@ -0,0 +1,46 @@
+import { createSurface, } from '@flyingrobots/bijou';
+import { TRANSITION_SHADERS, } from './transition-shaders.js';
+/**
+ * Apply a transition shader to blend between previous and next page views.
+ *
+ * @param frame - Monotonic frame counter for temporal shader effects.
+ */
+export function renderTransition(prev, next, style, progress, width, height, ctx, frame = 0) {
+    const shader = typeof style === 'function' ? style : TRANSITION_SHADERS[style];
+    if (!shader || width <= 0 || height <= 0)
+        return next;
+    const surface = createSurface(width, height);
+    for (let y = 0; y < height; y++) {
+        for (let x = 0; x < width; x++) {
+            const seed = Math.sin(x * 12.9898 + y * 78.233) * 43758.5453;
+            const rand = seed - Math.floor(seed);
+            const result = shader({
+                x,
+                y,
+                width,
+                height,
+                progress,
+                rand,
+                frame,
+                ctx,
+            });
+            const base = result.showNext ? next.get(x, y) : prev.get(x, y);
+            surface.set(x, y, applyTransitionCell(base, result));
+        }
+    }
+    return surface;
+}
+function applyTransitionCell(baseCell, result) {
+    if (result.overrideCell != null) {
+        return {
+            ...baseCell,
+            ...result.overrideCell,
+            char: result.overrideCell.char,
+            empty: false,
+        };
+    }
+    return result.overrideChar === undefined
+        ? { ...baseCell, empty: false }
+        : { ...baseCell, char: result.overrideChar, empty: false };
+}
+//# sourceMappingURL=app-frame-render-transition.js.map

package/dist/app-frame-render-transition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-frame-render-transition.js","sourceRoot":"","sources":["../src/app-frame-render-transition.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,GAId,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,kBAAkB,GAEnB,MAAM,yBAAyB,CAAC;AAEjC;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAa,EACb,IAAa,EACb,KAAqB,EACrB,QAAgB,EAChB,KAAa,EACb,MAAc,EACd,GAAiB,EACjB,KAAK,GAAG,CAAC;IAET,MAAM,MAAM,GACV,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAClE,IAAI,CAAC,MAAM,IAAI,KAAK,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACtD,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC7C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,OAAO,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,UAAU,CAAC;YAC7D,MAAM,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACrC,MAAM,MAAM,GAAG,MAAM,CAAC;gBACpB,CAAC;gBACD,CAAC;gBACD,KAAK;gBACL,MAAM;gBACN,QAAQ;gBACR,IAAI;gBACJ,KAAK;gBACL,GAAG;aACJ,CAAC,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC/D,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,mBAAmB,CAAC,QAAc,EAAE,MAAwB;IACnE,IAAI,MAAM,CAAC,YAAY,IAAI,IAAI,EAAE,CAAC;QAChC,OAAO;YACL,GAAG,QAAQ;YACX,GAAG,MAAM,CAAC,YAAY;YACtB,IAAI,EAAE,MAAM,CAAC,YAAY,CAAC,IAAI;YAC9B,KAAK,EAAE,KAAK;SACb,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,YAAY,KAAK,SAAS;QACtC,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE;QAC/B,CAAC,CAAC,EAAE,GAAG,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,YAAY,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC/D,CAAC"}

package/dist/app-frame-render.d.ts

@@ -1,48 +1,10 @@
-import { type BijouContext, type Surface, type TokenValue } from '@flyingrobots/bijou';
-import type { FrameLayoutNode, FramePage, CreateFramedAppOptions } from './app-frame.js';
-import type { InternalFrameModel, RenderContext, RenderResult } from './app-frame-types.js';
-import type { LayoutRect } from './layout-rect.js';
-import type { PageTransition } from './app-frame.js';
-import { type ViewOutput } from './view-output.js';
-import type { FrameLayerDescriptor } from './app-frame-layers.js';
-export interface FrameHeaderTabTarget {
-    readonly pageId: string;
-    readonly startCol: number;
-    readonly endCol: number;
-}
-export interface FrameHeaderRenderResult {
-    readonly surface: Surface;
-    readonly tabTargets: readonly FrameHeaderTabTarget[];
-}
-export interface FramePaneGeometryResult {
-    readonly paneRects: ReadonlyMap<string, LayoutRect>;
-    readonly paneOrder: readonly string[];
-}
-export declare function renderFrameNode<PageModel, Msg>(node: FrameLayoutNode, rect: LayoutRect, ctx: RenderContext<PageModel, Msg>): RenderResult;
-/** Render a placeholder for a grid area that has no matching cell definition. */
-export declare function renderMissingGridCell(areaName: string, rect: LayoutRect, frameBackgroundToken?: TokenValue): RenderResult;
-/** Render a page's layout tree within the frame body rect. */
-export declare function renderPageContent<PageModel, Msg>(pageId: string, model: InternalFrameModel<PageModel, Msg>, bodyRect: LayoutRect, pagesById: Map<string, FramePage<PageModel, Msg>>, ctx?: BijouContext): RenderResult;
-/** Paint a page's layout tree directly into an existing target surface. */
-export declare function renderPageContentInto<PageModel, Msg>(pageId: string, model: InternalFrameModel<PageModel, Msg>, bodyRect: LayoutRect, pagesById: Map<string, FramePage<PageModel, Msg>>, target: Surface, offsetRow?: number, offsetCol?: number, scratchPool?: FramePaneScratchPool, ctx?: BijouContext): FramePaneGeometryResult;
-/** Render only the maximized pane at the full body rect. */
-export declare function renderMaximizedPane<PageModel, Msg>(pageId: string, model: InternalFrameModel<PageModel, Msg>, bodyRect: LayoutRect, pagesById: Map<string, FramePage<PageModel, Msg>>, maximizedPaneId: string, scratchPool?: FramePaneScratchPool, ctx?: BijouContext): RenderResult;
-/** Paint only the maximized pane directly into an existing target surface. */
-export declare function renderMaximizedPaneInto<PageModel, Msg>(pageId: string, model: InternalFrameModel<PageModel, Msg>, bodyRect: LayoutRect, pagesById: Map<string, FramePage<PageModel, Msg>>, maximizedPaneId: string, target: Surface, offsetRow?: number, offsetCol?: number, scratchPool?: FramePaneScratchPool, ctx?: BijouContext): FramePaneGeometryResult;
-/** Resolve the top header line plus clickable tab target geometry. */
-export declare function resolveHeaderLine<PageModel, Msg>(model: InternalFrameModel<PageModel, Msg>, options: CreateFramedAppOptions<PageModel, Msg>, pagesById: Map<string, FramePage<PageModel, Msg>>, scratch?: Surface, ctx?: BijouContext): FrameHeaderRenderResult;
-/** Render the footer status line showing mode, focused pane, and key hints. */
-export declare function renderHelpLine<PageModel, Msg>(model: InternalFrameModel<PageModel, Msg>, activeLayer: FrameLayerDescriptor, i18n: CreateFramedAppOptions<PageModel, Msg>['i18n'], notificationCue?: string, scratch?: Surface, ctx?: BijouContext): Surface;
-/**
- * Apply a transition shader to blend between the previous and next page views.
- *
- * @param frame - Monotonic frame counter passed to shaders for temporal effects
- *   (glitch flickering, static noise). Defaults to 0 for stateless shaders.
- */
-export declare function renderTransition(prev: Surface, next: Surface, style: PageTransition, progress: number, width: number, height: number, ctx: BijouContext, frame?: number): Surface;
-export declare function framePaneOutputToSurface(output: ViewOutput, width: number, height: number, scratch?: Surface): Surface;
-export declare function blockSurface(content: string, width: number, height: number): Surface;
-/** Per-size scratch surface pool for pane rendering. */
-export type FramePaneScratchPool = Map<string, Surface>;
-export declare function createFramePaneScratchPool(): FramePaneScratchPool;
+export type { FrameHeaderRenderResult, FrameHeaderTabTarget, FramePaneGeometryResult, } from './app-frame-render-contract.js';
+export { renderPageContent, renderPageContentInto, } from './app-frame-render-content.js';
+export { renderMissingGridCell } from './app-frame-render-grid.js';
+export { renderHelpLine, resolveHeaderLine, } from './app-frame-render-header.js';
+export { renderMaximizedPane, renderMaximizedPaneInto, } from './app-frame-render-maximized.js';
+export { renderFrameNode } from './app-frame-render-node.js';
+export { createFramePaneScratchPool, type FramePaneScratchPool, } from './app-frame-render-scratch.js';
+export { blockSurface, framePaneOutputToSurface, } from './app-frame-render-surface.js';
+export { renderTransition } from './app-frame-render-transition.js';
 //# sourceMappingURL=app-frame-render.d.ts.map

package/dist/app-frame-render.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-frame-render.d.ts","sourceRoot":"","sources":["../src/app-frame-render.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"app-frame-render.d.ts","sourceRoot":"","sources":["../src/app-frame-render.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,uBAAuB,EACvB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EACL,cAAc,EACd,iBAAiB,GAClB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EACL,0BAA0B,EAC1B,KAAK,oBAAoB,GAC1B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,YAAY,EACZ,wBAAwB,GACzB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/app-frame-render.js

@@ -1,534 +1,9 @@
-import { createSurface, darken, hexToRgb, lighten, mix, parseAnsiToSurface, resolveSafeCtx, saturate, } from '@flyingrobots/bijou';
-import { TRANSITION_SHADERS } from './transition-shaders.js';
-import { fitBlock } from './layout-utils.js';
-import { splitPaneLayout } from './split-pane.js';
-import { gridLayout } from './grid.js';
-import { createFocusAreaStateForSurface, focusAreaSurfaceInto, focusAreaScrollTo, focusAreaScrollToX, } from './focus-area.js';
-import { isMinimized, createPanelVisibilityState } from './panel-state.js';
-import { createPanelDockState, resolveChildOrder, getNodeId } from './panel-dock.js';
-import { visibleLength } from './viewport.js';
-import { helpShort } from './help.js';
-import { findPaneNode, isPaneMinimized, mergeMaps, offsetRect, fitLine, resolveFramePageText, } from './app-frame-utils.js';
-import { normalizeViewOutput, normalizeViewOutputInto } from './view-output.js';
-import { paintStyledTextSurfaceWithBCSS } from './css/text-style.js';
-import { frameModeLabel } from './app-frame-i18n.js';
-function relativeLuminance(hex) {
-    const [red, green, blue] = hexToRgb(hex);
-    const r = srgbChannelToLinear(red);
-    const g = srgbChannelToLinear(green);
-    const b = srgbChannelToLinear(blue);
-    return 0.2126 * r + 0.7152 * g + 0.0722 * b;
-}
-function srgbChannelToLinear(channel) {
-    const normalized = channel / 255;
-    return normalized <= 0.03928
-        ? normalized / 12.92
-        : ((normalized + 0.055) / 1.055) ** 2.4;
-}
-function contrastRatio(a, b) {
-    const lighter = Math.max(relativeLuminance(a), relativeLuminance(b));
-    const darker = Math.min(relativeLuminance(a), relativeLuminance(b));
-    return (lighter + 0.05) / (darker + 0.05);
-}
-function colorDistance(a, b) {
-    const [ar, ag, ab] = hexToRgb(a);
-    const [br, bg, bb] = hexToRgb(b);
-    return Math.sqrt((ar - br) ** 2 + (ag - bg) ** 2 + (ab - bb) ** 2);
-}
-function deriveActiveHeaderTabToken(ctx, backgroundHex, baseHex) {
-    const darkBackground = relativeLuminance(backgroundHex) < 0.35;
-    const accent = ctx.semantic('accent');
-    const info = ctx.semantic('info');
-    const primary = ctx.semantic('primary');
-    const warning = ctx.semantic('warning');
-    const seeds = [
-        accent,
-        info,
-        mix(accent, info, 0.5),
-        mix(accent, warning, 0.3),
-        mix(primary, accent, 0.3),
-    ];
-    const candidates = seeds.flatMap((seed) => {
-        const emphasized = saturate(seed, 0.35);
-        return darkBackground
-            ? [
-                emphasized,
-                lighten(seed, 0.18),
-                lighten(emphasized, 0.3),
-                lighten(mix(seed, primary, 0.25), 0.2),
-            ]
-            : [
-                darken(seed, 0.18),
-                darken(emphasized, 0.28),
-                darken(mix(seed, primary, 0.1), 0.22),
-            ];
-    });
-    let best = candidates[0] ?? accent;
-    let bestScore = Number.NEGATIVE_INFINITY;
-    for (const candidate of candidates) {
-        const contrast = contrastRatio(candidate.hex, backgroundHex);
-        const distance = colorDistance(candidate.hex, baseHex) / Math.sqrt(3 * 255 * 255);
-        const score = contrast * 3 + distance;
-        if (score > bestScore) {
-            bestScore = score;
-            best = candidate;
-        }
-    }
-    return {
-        hex: best.hex,
-        modifiers: ['bold'],
-    };
-}
-function paintActiveHeaderTab(surface, tabTargets, activePageId, ctx, tokenOverride) {
-    if (ctx == null)
-        return;
-    const activeTarget = tabTargets.find((target) => target.pageId === activePageId);
-    if (activeTarget == null)
-        return;
-    const sampleCell = surface.get(activeTarget.startCol, 0);
-    const backgroundHex = (typeof sampleCell.bg === 'string' ? sampleCell.bg : sampleCell.bg?.hex)
-        ?? ctx.surface('primary').bg
-        ?? ctx.surface('secondary').bg
-        ?? '#000000';
-    const baseHex = (typeof sampleCell.fg === 'string' ? sampleCell.fg : sampleCell.fg?.hex)
-        ?? ctx.surface('primary').hex;
-    const token = tokenOverride ?? deriveActiveHeaderTabToken(ctx, backgroundHex, baseHex);
-    for (let x = activeTarget.startCol; x <= activeTarget.endCol; x++) {
-        const cell = surface.get(x, 0);
-        const nextCell = {
-            ...cell,
-            fg: token.hex,
-            bg: token.bg ?? cell.bg,
-            fgRGB: token.fgRGB,
-            bgRGB: token.bgRGB,
-            modifiers: token.modifiers == null
-                ? cell.modifiers
-                : Array.from(new Set([...(cell.modifiers ?? []), ...token.modifiers])),
-            empty: false,
-        };
-        surface.set(x, 0, nextCell);
-    }
-}
-export function renderFrameNode(node, rect, ctx) {
-    if (rect.width <= 0 || rect.height <= 0) {
-        return { surface: createSurface(rect.width, rect.height), paneRects: new Map(), paneOrder: [] };
-    }
-    const surface = createSurface(rect.width, rect.height);
-    const painted = paintFrameNodeInto(node, { row: 0, col: 0, width: rect.width, height: rect.height }, rect, ctx, surface, createFramePaneScratchPool());
-    return { surface, paneRects: painted.paneRects, paneOrder: painted.paneOrder };
-}
-function paintFrameNodeInto(node, localRect, absoluteRect, ctx, target, scratchPool) {
-    if (localRect.width <= 0 || localRect.height <= 0) {
-        return { paneRects: new Map(), paneOrder: [] };
-    }
-    if (node.kind === 'pane') {
-        if (isMinimized(ctx.visibility, node.paneId)) {
-            const titleBar = `[${node.paneId}] \u25b8`; // ▸
-            target.blit(applySurfaceBackground(blockSurface(titleBar, localRect.width, localRect.height), ctx.frameBackgroundToken), localRect.col, localRect.row);
-            return {
-                paneRects: new Map([[node.paneId, absoluteRect]]),
-                paneOrder: [node.paneId],
-            };
-        }
-        const prior = ctx.scrollByPane[node.paneId] ?? { x: 0, y: 0 };
-        const contentSurface = framePaneOutputToSurface(node.render(localRect.width, localRect.height), localRect.width, localRect.height, getFramePaneScratch(scratchPool, localRect.width, localRect.height));
-        applySurfaceBackground(contentSurface, ctx.frameBackgroundToken);
-        let state = createFocusAreaStateForSurface(contentSurface, {
-            width: localRect.width,
-            height: localRect.height,
-            overflowX: node.overflowX ?? 'hidden',
-        });
-        state = focusAreaScrollTo(state, prior.y);
-        state = focusAreaScrollToX(state, prior.x);
-        focusAreaSurfaceInto(contentSurface, state, target, {
-            focused: node.paneId === ctx.focusedPaneId,
-            ctx: ctx.ctx,
-            id: node.paneId,
-            classes: [node.paneId === ctx.focusedPaneId ? 'focused' : 'unfocused'],
-            focusedGutterToken: node.focusedGutterToken,
-            unfocusedGutterToken: node.unfocusedGutterToken,
-        }, localRect.col, localRect.row);
-        return {
-            paneRects: new Map([[node.paneId, absoluteRect]]),
-            paneOrder: [node.paneId],
-        };
-    }
-    if (node.kind === 'split') {
-        const direction = node.direction ?? 'row';
-        const defaultChildIds = [getNodeId(node.paneA), getNodeId(node.paneB)];
-        const resolvedOrder = resolveChildOrder(ctx.dockState, node.splitId, defaultChildIds);
-        const swapped = resolvedOrder[0] !== defaultChildIds[0];
-        const effectiveA = swapped ? node.paneB : node.paneA;
-        const effectiveB = swapped ? node.paneA : node.paneB;
-        const aMinimized = isPaneMinimized(effectiveA, ctx.visibility);
-        const bMinimized = isPaneMinimized(effectiveB, ctx.visibility);
-        let splitState = node.state;
-        const ratioOverride = ctx.model.splitRatioOverrides[ctx.pageId]?.[node.splitId];
-        if (ratioOverride !== undefined) {
-            splitState = { ...splitState, ratio: ratioOverride };
-        }
-        if (aMinimized && !bMinimized) {
-            const mainAxisTotal = direction === 'row' ? localRect.width : localRect.height;
-            const minimizedSize = Math.min(1, mainAxisTotal);
-            splitState = { ...splitState, ratio: minimizedSize / Math.max(1, mainAxisTotal) };
-        }
-        else if (bMinimized && !aMinimized) {
-            const mainAxisTotal = direction === 'row' ? localRect.width : localRect.height;
-            const minimizedSize = Math.min(1, mainAxisTotal);
-            splitState = { ...splitState, ratio: 1 - minimizedSize / Math.max(1, mainAxisTotal) };
-        }
-        const layout = splitPaneLayout(splitState, {
-            direction,
-            width: localRect.width,
-            height: localRect.height,
-            minA: node.minA,
-            minB: node.minB,
-        });
-        const localARect = offsetRect(layout.paneA, localRect.row, localRect.col);
-        const localBRect = offsetRect(layout.paneB, localRect.row, localRect.col);
-        const absoluteARect = offsetRect(layout.paneA, absoluteRect.row, absoluteRect.col);
-        const absoluteBRect = offsetRect(layout.paneB, absoluteRect.row, absoluteRect.col);
-        const a = paintFrameNodeInto(effectiveA, localARect, absoluteARect, ctx, target, scratchPool);
-        const b = paintFrameNodeInto(effectiveB, localBRect, absoluteBRect, ctx, target, scratchPool);
-        paintDivider(target, offsetRect(layout.divider, localRect.row, localRect.col), node.dividerChar, direction);
-        return {
-            paneRects: mergeMaps(a.paneRects, b.paneRects),
-            paneOrder: [...a.paneOrder, ...b.paneOrder],
-        };
-    }
-    const relRects = gridLayout({
-        width: localRect.width,
-        height: localRect.height,
-        columns: node.columns,
-        rows: node.rows,
-        areas: node.areas,
-        gap: node.gap,
-    });
-    const paneRects = new Map();
-    const seenPaneIds = new Set();
-    const paneOrder = [];
-    for (const [areaName, areaRect] of relRects) {
-        const localAreaRect = offsetRect(areaRect, localRect.row, localRect.col);
-        const absoluteAreaRect = offsetRect(areaRect, absoluteRect.row, absoluteRect.col);
-        const child = node.cells[areaName];
-        if (child == null) {
-            ctx.ctx?.io.writeError(`createFramedApp: grid cell "${areaName}" missing in page "${ctx.pageId}" — rendering placeholder\n`);
-            target.blit(renderMissingGridCell(areaName, localAreaRect, ctx.frameBackgroundToken).surface, localAreaRect.col, localAreaRect.row);
-            continue;
-        }
-        const rendered = paintFrameNodeInto(child, localAreaRect, absoluteAreaRect, ctx, target, scratchPool);
-        for (const [paneId, paneRect] of rendered.paneRects.entries()) {
-            if (paneRects.has(paneId)) {
-                throw new Error(`createFramedApp: duplicate paneId "${paneId}" in rendered layout`);
-            }
-            paneRects.set(paneId, paneRect);
-        }
-        for (const paneId of rendered.paneOrder) {
-            if (seenPaneIds.has(paneId)) {
-                throw new Error(`createFramedApp: duplicate paneId "${paneId}" in rendered pane order`);
-            }
-            seenPaneIds.add(paneId);
-            paneOrder.push(paneId);
-        }
-    }
-    return { paneRects, paneOrder };
-}
-/** Render a placeholder for a grid area that has no matching cell definition. */
-export function renderMissingGridCell(areaName, rect, frameBackgroundToken) {
-    return {
-        surface: applySurfaceBackground(blockSurface(`[missing grid cell: ${areaName}]`, rect.width, rect.height), frameBackgroundToken),
-        paneRects: new Map(),
-        paneOrder: [],
-    };
-}
-/** Render a page's layout tree within the frame body rect. */
-export function renderPageContent(pageId, model, bodyRect, pagesById, ctx) {
-    const surface = createSurface(bodyRect.width, bodyRect.height);
-    const geometry = renderPageContentInto(pageId, model, bodyRect, pagesById, surface, 0, 0, createFramePaneScratchPool(), ctx);
-    return { surface, paneRects: geometry.paneRects, paneOrder: geometry.paneOrder };
-}
-/** Paint a page's layout tree directly into an existing target surface. */
-export function renderPageContentInto(pageId, model, bodyRect, pagesById, target, offsetRow = bodyRect.row, offsetCol = bodyRect.col, scratchPool = createFramePaneScratchPool(), ctx) {
-    const themeCtx = resolveRenderCtx(ctx);
-    const frameBackgroundToken = resolveFrameBackgroundToken(themeCtx);
-    fillSurfaceBackground(target, offsetCol, offsetRow, bodyRect.width, bodyRect.height, frameBackgroundToken);
-    const page = required(pagesById.get(pageId), `page "${pageId}"`);
-    const pageModel = required(model.pageModels[pageId], `page model "${pageId}"`);
-    const renderCtx = {
-        model,
-        pageId,
-        focusedPaneId: model.focusedPaneByPage[pageId],
-        scrollByPane: model.scrollByPage[pageId] ?? {},
-        visibility: model.minimizedByPage[pageId] ?? createPanelVisibilityState(),
-        dockState: model.dockStateByPage[pageId] ?? createPanelDockState(),
-        frameBackgroundToken,
-        ctx: themeCtx,
-    };
-    return paintFrameNodeInto(page.layout(pageModel), { row: offsetRow, col: offsetCol, width: bodyRect.width, height: bodyRect.height }, bodyRect, renderCtx, target, scratchPool);
-}
-/** Render only the maximized pane at the full body rect. */
-export function renderMaximizedPane(pageId, model, bodyRect, pagesById, maximizedPaneId, scratchPool = createFramePaneScratchPool(), ctx) {
-    const surface = createSurface(bodyRect.width, bodyRect.height);
-    const geometry = renderMaximizedPaneInto(pageId, model, bodyRect, pagesById, maximizedPaneId, surface, 0, 0, scratchPool, ctx);
-    return { surface, paneRects: geometry.paneRects, paneOrder: geometry.paneOrder };
-}
-/** Paint only the maximized pane directly into an existing target surface. */
-export function renderMaximizedPaneInto(pageId, model, bodyRect, pagesById, maximizedPaneId, target, offsetRow = bodyRect.row, offsetCol = bodyRect.col, scratchPool = createFramePaneScratchPool(), ctx) {
-    const themeCtx = resolveRenderCtx(ctx);
-    const frameBackgroundToken = resolveFrameBackgroundToken(themeCtx);
-    fillSurfaceBackground(target, offsetCol, offsetRow, bodyRect.width, bodyRect.height, frameBackgroundToken);
-    const page = required(pagesById.get(pageId), `page "${pageId}"`);
-    const pageModel = required(model.pageModels[pageId], `page model "${pageId}"`);
-    const layoutTree = page.layout(pageModel);
-    const paneNode = findPaneNode(layoutTree, maximizedPaneId);
-    if (paneNode == null) {
-        // Pane not found, fall back to normal rendering
-        return renderPageContentInto(pageId, model, bodyRect, pagesById, target, offsetRow, offsetCol, scratchPool, ctx);
-    }
-    const prior = model.scrollByPage[pageId]?.[maximizedPaneId] ?? { x: 0, y: 0 };
-    const contentSurface = framePaneOutputToSurface(paneNode.render(bodyRect.width, bodyRect.height), bodyRect.width, bodyRect.height, getFramePaneScratch(scratchPool, bodyRect.width, bodyRect.height));
-    applySurfaceBackground(contentSurface, frameBackgroundToken);
-    let state = createFocusAreaStateForSurface(contentSurface, {
-        width: bodyRect.width,
-        height: bodyRect.height,
-        overflowX: paneNode.overflowX ?? 'hidden',
-    });
-    state = focusAreaScrollTo(state, prior.y);
-    state = focusAreaScrollToX(state, prior.x);
-    focusAreaSurfaceInto(contentSurface, state, target, {
-        focused: true,
-        ctx: themeCtx,
-        id: maximizedPaneId,
-        classes: ['focused', 'maximized'],
-        focusedGutterToken: paneNode.focusedGutterToken,
-        unfocusedGutterToken: paneNode.unfocusedGutterToken,
-    }, offsetCol, offsetRow);
-    return {
-        paneRects: new Map([[maximizedPaneId, bodyRect]]),
-        paneOrder: [maximizedPaneId],
-    };
-}
-/** Resolve the top header line plus clickable tab target geometry. */
-export function resolveHeaderLine(model, options, pagesById, scratch, ctx) {
-    const renderCtx = resolveRenderCtx(ctx);
-    const frameBackgroundToken = resolveFrameBackgroundToken(renderCtx);
-    const activePage = required(pagesById.get(model.activePageId), `page "${model.activePageId}"`);
-    const activePageModel = required(model.pageModels[model.activePageId], `page model "${model.activePageId}"`);
-    const headerStyle = options.headerStyle?.({
-        model,
-        activePage,
-        pageModel: activePageModel,
-    });
-    const title = options.title ?? 'App';
-    let cursor = visibleLength(title) + 2;
-    const tabTargets = [];
-    const tabs = model.pageOrder.map((id, index) => {
-        const page = required(pagesById.get(id), `page "${id}"`);
-        const pageModel = required(model.pageModels[id], `page model "${id}"`);
-        const pageTitle = resolveFramePageText(page.title, pageModel) ?? '';
-        const label = id === model.activePageId ? `[${pageTitle}]` : ` ${pageTitle} `;
-        const width = visibleLength(label);
-        const startCol = cursor;
-        const endCol = cursor + width - 1;
-        if (endCol >= 0 && startCol < model.columns) {
-            tabTargets.push({
-                pageId: id,
-                startCol: Math.max(0, startCol),
-                endCol: Math.min(Math.max(0, model.columns - 1), endCol),
-            });
-        }
-        cursor += width;
-        if (index < model.pageOrder.length - 1) {
-            cursor += 1;
-        }
-        return label;
-    }).join(' ');
-    const line = fitLine(`${title}  ${tabs}`, model.columns);
-    const surface = paintStyledTextSurfaceWithBCSS(scratch, line, model.columns, renderCtx, {
-        type: 'FrameHeader',
-        id: 'frame-header',
-        classes: [`page-${model.activePageId}`],
-    });
-    paintActiveHeaderTab(surface, tabTargets, model.activePageId, renderCtx, headerStyle?.activeTabToken);
-    applySurfaceBackground(surface, frameBackgroundToken);
-    return {
-        surface,
-        tabTargets,
-    };
-}
-/** Render the footer status line showing mode, focused pane, and key hints. */
-export function renderHelpLine(model, activeLayer, i18n, notificationCue, scratch, ctx) {
-    const renderCtx = resolveRenderCtx(ctx);
-    const mode = activeLayer.kind === 'search' || activeLayer.kind === 'command-palette'
-        ? 'PALETTE'
-        : activeLayer.kind === 'help'
-            ? 'HELP'
-            : activeLayer.kind === 'quit-confirm'
-                ? 'QUIT'
-                : activeLayer.kind === 'settings'
-                    ? 'SETTINGS'
-                    : activeLayer.kind === 'notification-center'
-                        ? 'NOTICES'
-                        : activeLayer.kind === 'page-modal'
-                            ? 'MODAL'
-                            : 'NORMAL';
-    const focusedPane = model.focusedPaneByPage[model.activePageId] ?? '-';
-    const modeLabel = frameModeLabel(i18n, mode);
-    const status = notificationCue == null || notificationCue.length === 0
-        ? `[${modeLabel}] page:${model.activePageId} pane:${focusedPane}`
-        : `[${modeLabel}] page:${model.activePageId} pane:${focusedPane} ${notificationCue}`;
-    const hint = typeof activeLayer.hintSource === 'string'
-        ? activeLayer.hintSource
-        : activeLayer.hintSource == null
-            ? ''
-            : helpShort(activeLayer.hintSource);
-    const line = hint.length > 0
-        ? (() => {
-            const statusWithPadding = ` ${status}`;
-            const gap = model.columns - visibleLength(statusWithPadding) - visibleLength(hint);
-            return gap >= 2
-                ? `${statusWithPadding}${' '.repeat(gap)}${hint}`
-                : `${statusWithPadding}  ${hint}`;
-        })()
-        : ` ${status}`;
-    return applySurfaceBackground(paintStyledTextSurfaceWithBCSS(scratch, fitLine(line, model.columns), model.columns, renderCtx, {
-        type: 'FrameHelp',
-        id: 'frame-help',
-        classes: [`mode-${mode.toLowerCase()}`, `page-${model.activePageId}`],
-    }), resolveFrameBackgroundToken(renderCtx));
-}
-/**
- * Apply a transition shader to blend between the previous and next page views.
- *
- * @param frame - Monotonic frame counter passed to shaders for temporal effects
- *   (glitch flickering, static noise). Defaults to 0 for stateless shaders.
- */
-export function renderTransition(prev, next, style, progress, width, height, ctx, frame = 0) {
-    const shader = typeof style === 'function' ? style : TRANSITION_SHADERS[style];
-    if (!shader || width <= 0 || height <= 0)
-        return next;
-    const surface = createSurface(width, height);
-    for (let y = 0; y < height; y++) {
-        for (let x = 0; x < width; x++) {
-            const seed = Math.sin(x * 12.9898 + y * 78.233) * 43758.5453;
-            const rand = seed - Math.floor(seed);
-            const result = shader({ x, y, width, height, progress, rand, frame, ctx });
-            const baseCell = result.showNext ? next.get(x, y) : prev.get(x, y);
-            surface.set(x, y, applyTransitionCell(baseCell, result));
-        }
-    }
-    return surface;
-}
-export function framePaneOutputToSurface(output, width, height, scratch) {
-    return scratch == null
-        ? normalizeViewOutput(output, { width, height }).surface
-        : normalizeViewOutputInto(output, { width, height }, scratch).surface;
-}
-export function blockSurface(content, width, height) {
-    return parseAnsiToSurface(fitBlock(content, width, height).join('\n'), width, height);
-}
-function resolveFrameBackgroundToken(ctx) {
-    const primary = ctx?.surface('primary');
-    if (primary?.bg != null || primary?.bgRGB != null)
-        return primary;
-    const secondary = ctx?.surface('secondary');
-    if (secondary?.bg != null || secondary?.bgRGB != null)
-        return secondary;
-    return undefined;
-}
-function resolveRenderCtx(ctx) {
-    return ctx ?? resolveSafeCtx();
-}
-function fillSurfaceBackground(target, offsetCol, offsetRow, width, height, backgroundToken) {
-    if (backgroundToken == null || width <= 0 || height <= 0)
-        return;
-    if (backgroundToken.bg == null && backgroundToken.bgRGB == null)
-        return;
-    target.fill({
-        char: ' ',
-        fg: backgroundToken.hex,
-        bg: backgroundToken.bg,
-        fgRGB: backgroundToken.fgRGB,
-        bgRGB: backgroundToken.bgRGB,
-        empty: false,
-    }, offsetCol, offsetRow, width, height);
-}
-function applySurfaceBackground(surface, backgroundToken) {
-    if (backgroundToken == null)
-        return surface;
-    if (backgroundToken.bg == null && backgroundToken.bgRGB == null)
-        return surface;
-    const hasFallbackForeground = backgroundToken.hex.length > 0 || backgroundToken.fgRGB != null;
-    for (let y = 0; y < surface.height; y++) {
-        for (let x = 0; x < surface.width; x++) {
-            const cell = surface.get(x, y);
-            const needsBackground = cell.bg == null && cell.bgRGB == null;
-            const needsForeground = hasFallbackForeground && cell.fg == null && cell.fgRGB == null;
-            if (!needsBackground && !needsForeground)
-                continue;
-            surface.set(x, y, {
-                ...cell,
-                char: cell.char.length > 0 ? cell.char : ' ',
-                fg: needsForeground ? backgroundToken.hex : cell.fg,
-                bg: needsBackground ? backgroundToken.bg : cell.bg,
-                fgRGB: needsForeground ? backgroundToken.fgRGB : cell.fgRGB,
-                bgRGB: needsBackground ? backgroundToken.bgRGB : cell.bgRGB,
-                empty: false,
-            });
-        }
-    }
-    return surface;
-}
-function paintDivider(target, rect, dividerChar, direction) {
-    const unit = resolveDividerUnit(dividerChar, direction === 'row' ? '│' : '─');
-    for (let y = 0; y < rect.height; y++) {
-        for (let x = 0; x < rect.width; x++) {
-            const existing = target.get(rect.col + x, rect.row + y);
-            target.set(rect.col + x, rect.row + y, { ...existing, char: unit, empty: false });
-        }
-    }
-}
-function resolveDividerUnit(dividerChar, fallback) {
-    if (dividerChar == null || dividerChar.length === 0)
-        return fallback;
-    return dividerChar[0] ?? fallback;
-}
-export function createFramePaneScratchPool() {
-    return new Map();
-}
-function getFramePaneScratch(pool, width, height) {
-    const key = `${String(width)}x${String(height)}`;
-    let scratch = pool.get(key);
-    if (scratch == null) {
-        scratch = createSurface(width, height);
-        pool.set(key, scratch);
-    }
-    return scratch;
-}
-function required(value, label) {
-    if (value == null)
-        throw new Error(`createFramedApp: ${label} is not registered`);
-    return value;
-}
-function applyTransitionCell(baseCell, result) {
-    if (result.overrideCell != null) {
-        return {
-            ...baseCell,
-            ...result.overrideCell,
-            char: result.overrideCell.char,
-            empty: false,
-        };
-    }
-    if (result.overrideChar !== undefined) {
-        return {
-            ...baseCell,
-            char: result.overrideChar,
-            empty: false,
-        };
-    }
-    return {
-        ...baseCell,
-        empty: false,
-    };
-}
+export { renderPageContent, renderPageContentInto, } from './app-frame-render-content.js';
+export { renderMissingGridCell } from './app-frame-render-grid.js';
+export { renderHelpLine, resolveHeaderLine, } from './app-frame-render-header.js';
+export { renderMaximizedPane, renderMaximizedPaneInto, } from './app-frame-render-maximized.js';
+export { renderFrameNode } from './app-frame-render-node.js';
+export { createFramePaneScratchPool, } from './app-frame-render-scratch.js';
+export { blockSurface, framePaneOutputToSurface, } from './app-frame-render-surface.js';
+export { renderTransition } from './app-frame-render-transition.js';
 //# sourceMappingURL=app-frame-render.js.map