@flyingrobots/bijou-tui 1.7.0 → 2.1.0

package/dist/app-frame-render.js

@@ -0,0 +1,277 @@
+/**
+ * Layout rendering for `app-frame.ts`.
+ *
+ * Recursive tree renderer, page content, maximized pane, header/help lines,
+ * transition shader, and string-to-grid tokenization.
+ */
+import { resolveSafeCtx } from '@flyingrobots/bijou';
+import { TRANSITION_SHADERS } from './transition-shaders.js';
+import { fitBlock } from './layout-utils.js';
+import { splitPane, splitPaneLayout } from './split-pane.js';
+import { grid, gridLayout } from './grid.js';
+import { createFocusAreaState, focusArea, focusAreaScrollTo, focusAreaScrollToX, } from './focus-area.js';
+import { isMinimized, createPanelVisibilityState } from './panel-state.js';
+import { createPanelDockState, resolveChildOrder, getNodeId } from './panel-dock.js';
+import { tokenizeAnsi } from './viewport.js';
+import { helpShort } from './help.js';
+import { findPaneNode, isPaneMinimized, mergeMaps, offsetRect, fitLine, mergeBindingSources, } from './app-frame-utils.js';
+/** Recursively render a layout tree node (pane, split, or grid) into a rect. */
+export function renderFrameNode(node, rect, ctx) {
+    if (rect.width <= 0 || rect.height <= 0) {
+        return { output: '', paneRects: new Map(), paneOrder: [] };
+    }
+    if (node.kind === 'pane') {
+        // Minimized pane: render as collapsed title bar
+        if (isMinimized(ctx.visibility, node.paneId)) {
+            const titleBar = `[${node.paneId}] \u25b8`; // ▸
+            const output = fitBlock(titleBar, rect.width, rect.height).join('\n');
+            return {
+                output,
+                paneRects: new Map([[node.paneId, rect]]),
+                paneOrder: [node.paneId],
+            };
+        }
+        const prior = ctx.scrollByPane[node.paneId] ?? { x: 0, y: 0 };
+        const content = node.render(rect.width, rect.height);
+        let state = createFocusAreaState({
+            content,
+            width: rect.width,
+            height: rect.height,
+            overflowX: node.overflowX ?? 'hidden',
+        });
+        state = focusAreaScrollTo(state, prior.y);
+        state = focusAreaScrollToX(state, prior.x);
+        const output = focusArea(state, { focused: node.paneId === ctx.focusedPaneId });
+        return {
+            output,
+            paneRects: new Map([[node.paneId, rect]]),
+            paneOrder: [node.paneId],
+        };
+    }
+    if (node.kind === 'split') {
+        const direction = node.direction ?? 'row';
+        // Consult dock state for child order
+        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;
+        // Check for minimized panes — give minimized pane 1 row, sibling gets rest
+        const aMinimized = isPaneMinimized(effectiveA, ctx.visibility);
+        const bMinimized = isPaneMinimized(effectiveB, ctx.visibility);
+        let splitState = node.state;
+        // Apply split ratio overrides from layout presets
+        const ratioOverride = ctx.model.splitRatioOverrides[ctx.pageId]?.[node.splitId];
+        if (ratioOverride !== undefined) {
+            splitState = { ...splitState, ratio: ratioOverride };
+        }
+        if (aMinimized && !bMinimized) {
+            // A is minimized: give it minimal space
+            const mainAxisTotal = direction === 'row' ? rect.width : rect.height;
+            const minimizedSize = Math.min(1, mainAxisTotal);
+            splitState = { ...splitState, ratio: minimizedSize / Math.max(1, mainAxisTotal) };
+        }
+        else if (bMinimized && !aMinimized) {
+            // B is minimized: give A most of the space
+            const mainAxisTotal = direction === 'row' ? rect.width : rect.height;
+            const minimizedSize = Math.min(1, mainAxisTotal);
+            splitState = { ...splitState, ratio: 1 - minimizedSize / Math.max(1, mainAxisTotal) };
+        }
+        const layout = splitPaneLayout(splitState, {
+            direction,
+            width: rect.width,
+            height: rect.height,
+            minA: node.minA,
+            minB: node.minB,
+        });
+        const aRect = offsetRect(layout.paneA, rect.row, rect.col);
+        const bRect = offsetRect(layout.paneB, rect.row, rect.col);
+        const a = renderFrameNode(effectiveA, aRect, ctx);
+        const b = renderFrameNode(effectiveB, bRect, ctx);
+        const output = splitPane(splitState, {
+            direction,
+            width: rect.width,
+            height: rect.height,
+            minA: node.minA,
+            minB: node.minB,
+            dividerChar: node.dividerChar,
+            paneA: () => a.output,
+            paneB: () => b.output,
+        });
+        return {
+            output,
+            paneRects: mergeMaps(a.paneRects, b.paneRects),
+            paneOrder: [...a.paneOrder, ...b.paneOrder],
+        };
+    }
+    const relRects = gridLayout({
+        width: rect.width,
+        height: rect.height,
+        columns: node.columns,
+        rows: node.rows,
+        areas: node.areas,
+        gap: node.gap,
+    });
+    const renderedByArea = new Map();
+    for (const [areaName, areaRect] of relRects) {
+        const absoluteAreaRect = offsetRect(areaRect, rect.row, rect.col);
+        const child = node.cells[areaName];
+        if (child == null) {
+            resolveSafeCtx()?.io.writeError(`createFramedApp: grid cell "${areaName}" missing in page "${ctx.pageId}" — rendering placeholder\n`);
+            renderedByArea.set(areaName, renderMissingGridCell(areaName, absoluteAreaRect));
+            continue;
+        }
+        renderedByArea.set(areaName, renderFrameNode(child, absoluteAreaRect, ctx));
+    }
+    const output = grid({
+        width: rect.width,
+        height: rect.height,
+        columns: node.columns,
+        rows: node.rows,
+        areas: node.areas,
+        gap: node.gap,
+        cells: Object.fromEntries([...renderedByArea.entries()].map(([name, rendered]) => [name, () => rendered.output])),
+    });
+    let paneRects = new Map();
+    const seenPaneIds = new Set();
+    const paneOrder = [];
+    for (const rendered of renderedByArea.values()) {
+        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 { output, paneRects, paneOrder };
+}
+/** Render a placeholder for a grid area that has no matching cell definition. */
+export function renderMissingGridCell(areaName, rect) {
+    return {
+        output: fitBlock(`[missing grid cell: ${areaName}]`, rect.width, rect.height).join('\n'),
+        paneRects: new Map(),
+        paneOrder: [],
+    };
+}
+/** Render a page's layout tree within the frame body rect. */
+export function renderPageContent(pageId, model, bodyRect, pagesById) {
+    const page = pagesById.get(pageId);
+    const pageModel = model.pageModels[pageId];
+    const renderCtx = {
+        model,
+        pageId,
+        focusedPaneId: model.focusedPaneByPage[pageId],
+        scrollByPane: model.scrollByPage[pageId] ?? {},
+        visibility: model.minimizedByPage[pageId] ?? createPanelVisibilityState(),
+        dockState: model.dockStateByPage[pageId] ?? createPanelDockState(),
+    };
+    return renderFrameNode(page.layout(pageModel), bodyRect, renderCtx);
+}
+/** Render only the maximized pane at the full body rect. */
+export function renderMaximizedPane(pageId, model, bodyRect, pagesById, maximizedPaneId) {
+    const page = pagesById.get(pageId);
+    const pageModel = model.pageModels[pageId];
+    const layoutTree = page.layout(pageModel);
+    const paneNode = findPaneNode(layoutTree, maximizedPaneId);
+    if (paneNode == null) {
+        // Pane not found, fall back to normal rendering
+        return renderPageContent(pageId, model, bodyRect, pagesById);
+    }
+    const prior = model.scrollByPage[pageId]?.[maximizedPaneId] ?? { x: 0, y: 0 };
+    const content = paneNode.render(bodyRect.width, bodyRect.height);
+    let state = createFocusAreaState({
+        content,
+        width: bodyRect.width,
+        height: bodyRect.height,
+        overflowX: paneNode.overflowX ?? 'hidden',
+    });
+    state = focusAreaScrollTo(state, prior.y);
+    state = focusAreaScrollToX(state, prior.x);
+    const output = focusArea(state, { focused: true });
+    return {
+        output,
+        paneRects: new Map([[maximizedPaneId, bodyRect]]),
+        paneOrder: [maximizedPaneId],
+    };
+}
+/** Render the top header line showing the app title and tab bar. */
+export function renderHeaderLine(model, options, pagesById) {
+    const title = options.title ?? 'App';
+    const tabs = model.pageOrder.map((id) => {
+        const page = pagesById.get(id);
+        return id === model.activePageId ? `[${page.title}]` : ` ${page.title} `;
+    }).join(' ');
+    return fitLine(`${title}  ${tabs}`, model.columns);
+}
+/** Render the bottom status line showing mode, focused pane, and key hints. */
+export function renderHelpLine(model, frameKeys, options, activePage) {
+    const mode = model.commandPalette != null
+        ? 'PALETTE'
+        : model.helpOpen
+            ? 'HELP'
+            : 'NORMAL';
+    const focusedPane = model.focusedPaneByPage[model.activePageId] ?? '-';
+    const status = `[${mode}] page:${model.activePageId} pane:${focusedPane}`;
+    const source = mergeBindingSources(frameKeys, options.globalKeys, activePage.helpSource ?? activePage.keyMap);
+    const hint = helpShort(source);
+    const line = hint.length > 0
+        ? ` ${status}  ${hint}`
+        : ` ${status}`;
+    return fitLine(line, model.columns);
+}
+/**
+ * Split a styled multiline string into a 2D grid of single-column characters.
+ * Each cell is a fully-styled string (including resets).
+ */
+export function stringToGrid(str, width, height) {
+    const lines = str.split('\n');
+    const grid = [];
+    for (let y = 0; y < height; y++) {
+        const line = lines[y] ?? '';
+        grid.push(tokenizeAnsi(line, width));
+    }
+    return grid;
+}
+/**
+ * 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)
+        return next;
+    if (width <= 0 || height <= 0)
+        return next;
+    const prevGrid = stringToGrid(prev, width, height);
+    const nextGrid = stringToGrid(next, width, height);
+    const lines = [];
+    for (let y = 0; y < height; y++) {
+        let line = '';
+        for (let x = 0; x < width; x++) {
+            // Shared stable-ish pseudo-random seed based on coordinates
+            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 showNext = result.showNext;
+            const charOverride = result.char;
+            if (charOverride !== undefined) {
+                line += charOverride;
+            }
+            else {
+                line += (showNext ? nextGrid[y]?.[x] : prevGrid[y]?.[x]) ?? ' ';
+            }
+        }
+        lines.push(line);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=app-frame-render.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"app-frame-render.js","sourceRoot":"","sources":["../src/app-frame-render.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,135 @@
+/**
+ * Internal types and message utilities for `app-frame.ts`.
+ *
+ * These types are NOT part of the public API surface — they support
+ * the internal wiring of `createFramedApp`.
+ */
+import type { CommandPaletteItem } from './command-palette.js';
+import type { KeyMsg, Cmd } from './types.js';
+import type { BindingInfo } from './keybindings.js';
+import type { PanelVisibilityState } from './panel-state.js';
+import type { PanelDockState } from './panel-dock.js';
+import type { FrameModel } from './app-frame.js';
+export declare const PAGE_MSG_TOKEN: unique symbol;
+export declare const FRAME_MSG_TOKEN: unique symbol;
+/** Internal model extending the public FrameModel with palette entries. */
+export interface InternalFrameModel<PageModel, Msg> extends FrameModel<PageModel> {
+    readonly commandPaletteEntries?: readonly PaletteEntry<Msg>[];
+}
+/** A command palette entry linking a UI item to an action or message. */
+export interface PaletteEntry<Msg> {
+    readonly id: string;
+    readonly item: CommandPaletteItem;
+    readonly msgAction?: Msg;
+    readonly targetPageId?: string;
+    readonly frameAction?: FrameAction;
+}
+/** Per-call context passed through the recursive layout renderer. */
+export interface RenderContext<PageModel, Msg> {
+    readonly model: InternalFrameModel<PageModel, Msg>;
+    readonly pageId: string;
+    readonly focusedPaneId: string | undefined;
+    readonly scrollByPane: Readonly<Record<string, {
+        readonly x: number;
+        readonly y: number;
+    }>>;
+    readonly visibility: PanelVisibilityState;
+    readonly dockState: PanelDockState;
+}
+/** Output of a layout node render pass. */
+export interface RenderResult {
+    readonly output: string;
+    readonly paneRects: ReadonlyMap<string, import('./layout-rect.js').LayoutRect>;
+    readonly paneOrder: readonly string[];
+}
+/** Discriminated union of all frame-level actions (tabs, panes, scroll, palette, help, transitions). */
+export type FrameAction = {
+    type: 'toggle-help';
+} | {
+    type: 'prev-tab';
+} | {
+    type: 'next-tab';
+} | {
+    type: 'next-pane';
+} | {
+    type: 'prev-pane';
+} | {
+    type: 'scroll-up';
+} | {
+    type: 'scroll-down';
+} | {
+    type: 'page-up';
+} | {
+    type: 'page-down';
+} | {
+    type: 'top';
+} | {
+    type: 'bottom';
+} | {
+    type: 'scroll-left';
+} | {
+    type: 'scroll-right';
+} | {
+    type: 'open-palette';
+} | {
+    type: 'toggle-minimize';
+} | {
+    type: 'toggle-maximize';
+} | {
+    type: 'dock-up';
+} | {
+    type: 'dock-down';
+} | {
+    type: 'dock-left';
+} | {
+    type: 'dock-right';
+} | {
+    type: 'transition';
+    progress: number;
+    generation: number;
+} | {
+    type: 'transition-complete';
+    generation: number;
+};
+/** Discriminated union of command palette navigation/selection actions. */
+export type PaletteAction = {
+    type: 'cp-next';
+} | {
+    type: 'cp-prev';
+} | {
+    type: 'cp-page-down';
+} | {
+    type: 'cp-page-up';
+} | {
+    type: 'cp-select';
+} | {
+    type: 'cp-close';
+};
+/** Wrapper that tags a user message with its originating page ID. */
+export interface PageScopedMsg<Msg> {
+    readonly [PAGE_MSG_TOKEN]: true;
+    readonly pageId: string;
+    readonly msg: Msg;
+}
+/** Wrapper that tags a frame-internal action for the update loop. */
+export interface FrameScopedMsg {
+    readonly [FRAME_MSG_TOKEN]: true;
+    readonly action: FrameAction;
+}
+/** Type guard: is this message a frame-internal action wrapper? */
+export declare function isFrameScopedMsg(value: unknown): value is FrameScopedMsg;
+/** Wrap a frame action into a FrameScopedMsg for the update loop. */
+export declare function wrapFrameMsg(action: FrameAction): FrameScopedMsg;
+/** Type guard: is this message a page-scoped wrapper? */
+export declare function isPageScopedMsg<Msg>(value: unknown): value is PageScopedMsg<Msg>;
+/** Tag a user message with its originating page ID. */
+export declare function wrapPageMsg<Msg>(pageId: string, msg: Msg): Msg;
+/** Create a command that immediately resolves with the given message. */
+export declare function emitMsg<Msg>(msg: Msg): Cmd<Msg>;
+/** Create a command that emits a page-scoped message. */
+export declare function emitMsgForPage<Msg>(pageId: string, msg: Msg): Cmd<Msg>;
+/** Wrap a page-level command so its emitted messages are tagged with the page ID. */
+export declare function wrapCmdForPage<Msg>(pageId: string, cmd: Cmd<Msg>): Cmd<Msg>;
+/** Convert a binding's key combo into a synthetic KeyMsg for dispatch. */
+export declare function comboToMsg(binding: BindingInfo): KeyMsg;
+//# sourceMappingURL=app-frame-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"app-frame-types.d.ts","sourceRoot":"","sources":["../src/app-frame-types.ts"],"names":[],"mappings":"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"}

package/dist/app-frame-types.js

@@ -0,0 +1,72 @@
+/**
+ * Internal types and message utilities for `app-frame.ts`.
+ *
+ * These types are NOT part of the public API surface — they support
+ * the internal wiring of `createFramedApp`.
+ */
+import { QUIT } from './types.js';
+// ---------------------------------------------------------------------------
+// Symbols
+// ---------------------------------------------------------------------------
+export const PAGE_MSG_TOKEN = Symbol('app-frame-page-msg');
+export const FRAME_MSG_TOKEN = Symbol('app-frame-frame-msg');
+// ---------------------------------------------------------------------------
+// Message utility functions
+// ---------------------------------------------------------------------------
+/** Type guard: is this message a frame-internal action wrapper? */
+export function isFrameScopedMsg(value) {
+    return typeof value === 'object'
+        && value !== null
+        && FRAME_MSG_TOKEN in value
+        && value[FRAME_MSG_TOKEN] === true;
+}
+/** Wrap a frame action into a FrameScopedMsg for the update loop. */
+export function wrapFrameMsg(action) {
+    return {
+        [FRAME_MSG_TOKEN]: true,
+        action,
+    };
+}
+/** Type guard: is this message a page-scoped wrapper? */
+export function isPageScopedMsg(value) {
+    return typeof value === 'object'
+        && value !== null
+        && PAGE_MSG_TOKEN in value
+        && value[PAGE_MSG_TOKEN] === true;
+}
+/** Tag a user message with its originating page ID. */
+export function wrapPageMsg(pageId, msg) {
+    return {
+        [PAGE_MSG_TOKEN]: true,
+        pageId,
+        msg,
+    };
+}
+/** Create a command that immediately resolves with the given message. */
+export function emitMsg(msg) {
+    return () => Promise.resolve(msg);
+}
+/** Create a command that emits a page-scoped message. */
+export function emitMsgForPage(pageId, msg) {
+    return async () => wrapPageMsg(pageId, msg);
+}
+/** Wrap a page-level command so its emitted messages are tagged with the page ID. */
+export function wrapCmdForPage(pageId, cmd) {
+    return async (emit) => {
+        const result = await cmd((msg) => emit(wrapPageMsg(pageId, msg)));
+        if (result === undefined || result === QUIT)
+            return result;
+        return wrapPageMsg(pageId, result);
+    };
+}
+/** Convert a binding's key combo into a synthetic KeyMsg for dispatch. */
+export function comboToMsg(binding) {
+    return {
+        type: 'key',
+        key: binding.combo.key,
+        ctrl: binding.combo.ctrl,
+        alt: binding.combo.alt,
+        shift: binding.combo.shift,
+    };
+}
+//# sourceMappingURL=app-frame-types.js.map

package/dist/app-frame-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-frame-types.js","sourceRoot":"","sources":["../src/app-frame-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAMlC,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,oBAAoB,CAAC,CAAC;AAC3D,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC;AA4F7D,8EAA8E;AAC9E,4BAA4B;AAC5B,8EAA8E;AAE9E,mEAAmE;AACnE,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,OAAO,KAAK,KAAK,QAAQ;WAC3B,KAAK,KAAK,IAAI;WACd,eAAe,IAAI,KAAK;WACvB,KAAwB,CAAC,eAAe,CAAC,KAAK,IAAI,CAAC;AAC3D,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,YAAY,CAAC,MAAmB;IAC9C,OAAO;QACL,CAAC,eAAe,CAAC,EAAE,IAAI;QACvB,MAAM;KACP,CAAC;AACJ,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,eAAe,CAAM,KAAc;IACjD,OAAO,OAAO,KAAK,KAAK,QAAQ;WAC3B,KAAK,KAAK,IAAI;WACd,cAAc,IAAI,KAAK;WACtB,KAA4B,CAAC,cAAc,CAAC,KAAK,IAAI,CAAC;AAC9D,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,WAAW,CAAM,MAAc,EAAE,GAAQ;IACvD,OAAO;QACL,CAAC,cAAc,CAAC,EAAE,IAAI;QACtB,MAAM;QACN,GAAG;KACc,CAAC;AACtB,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,OAAO,CAAM,GAAQ;IACnC,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;AACpC,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,cAAc,CAAM,MAAc,EAAE,GAAQ;IAC1D,OAAO,KAAK,IAAI,EAAE,CAAC,WAAW,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAC9C,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,cAAc,CAAM,MAAc,EAAE,GAAa;IAC/D,OAAO,KAAK,EAAE,IAAI,EAAE,EAAE;QACpB,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,GAAG,CAAmB,CAAC,CAAC,CAAC;QACpF,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,MAAM,CAAC;QAC3D,OAAO,WAAW,CAAC,MAAM,EAAE,MAAa,CAAC,CAAC;IAC5C,CAAC,CAAC;AACJ,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,UAAU,CAAC,OAAoB;IAC7C,OAAO;QACL,IAAI,EAAE,KAAK;QACX,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG;QACtB,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI;QACxB,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG;QACtB,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK;KAC3B,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,37 @@
+/**
+ * Pure utility functions for `app-frame.ts`.
+ *
+ * Tree traversal, layout geometry, key map construction, and binding
+ * source merging — no state, no side effects.
+ */
+import type { FrameLayoutNode } from './app-frame.js';
+import type { FrameAction } from './app-frame-types.js';
+import type { LayoutRect } from './layout-rect.js';
+import type { PanelVisibilityState } from './panel-state.js';
+import { type KeyMap } from './keybindings.js';
+import type { BindingSource } from './help.js';
+/** Recursively collect all pane IDs from a layout tree in declaration order. */
+export declare function collectPaneIds(node: FrameLayoutNode): string[];
+/** Extract unique area names from CSS-grid-style template strings. */
+export declare function declaredAreaNames(areas: readonly string[]): string[];
+/** Throw if any pane ID appears more than once in the given list. */
+export declare function assertUniquePaneIds(paneIds: readonly string[], scope: string): void;
+/** Walk the layout tree to find the pane node with the given ID. */
+export declare function findPaneNode(node: FrameLayoutNode, paneId: string): Extract<FrameLayoutNode, {
+    kind: 'pane';
+}> | undefined;
+/** Check if a layout node (or its first descendant pane) is minimized. */
+export declare function isPaneMinimized(node: FrameLayoutNode, visibility: PanelVisibilityState): boolean;
+/** Merge two read-only maps into a new mutable map. */
+export declare function mergeMaps<K, V>(a: ReadonlyMap<K, V>, b: ReadonlyMap<K, V>): Map<K, V>;
+/** Translate a layout rect by the given row and column offsets. */
+export declare function offsetRect(rect: LayoutRect, rowOffset: number, colOffset: number): LayoutRect;
+/** Compute the available rect for page content (screen minus header and footer). */
+export declare function frameBodyRect(columns: number, rows: number): LayoutRect;
+/** Clip or pad a single line to exactly `width` visible columns. */
+export declare function fitLine(line: string, width: number): string;
+/** Combine multiple binding sources into a single source for help display. */
+export declare function mergeBindingSources(...sources: Array<BindingSource | undefined>): BindingSource;
+/** Build the default key map for frame-level actions (tabs, panes, scroll, help '?', command palette 'ctrl+p'/':'). */
+export declare function createFrameKeyMap(): KeyMap<FrameAction>;
+//# sourceMappingURL=app-frame-utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"app-frame-utils.d.ts","sourceRoot":"","sources":["../src/app-frame-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAE7D,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAI/C,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,EAAE,CAW9D;AAED,sEAAsE;AACtE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAQpE;AAED,qEAAqE;AACrE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAQnF;AAED,oEAAoE;AACpE,wBAAgB,YAAY,CAAC,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,SAAS,CAQ1H;AAED,0EAA0E;AAC1E,wBAAgB,eAAe,CAAC,IAAI,EAAE,eAAe,EAAE,UAAU,EAAE,oBAAoB,GAAG,OAAO,CAKhG;AAED,uDAAuD;AACvD,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAKrF;AAED,mEAAmE;AACnE,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU,CAO7F;AAED,oFAAoF;AACpF,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,CAOvE;AAED,oEAAoE;AACpE,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAG3D;AAED,8EAA8E;AAC9E,wBAAgB,mBAAmB,CAAC,GAAG,OAAO,EAAE,KAAK,CAAC,aAAa,GAAG,SAAS,CAAC,GAAG,aAAa,CAW/F;AAED,uHAAuH;AACvH,wBAAgB,iBAAiB,IAAI,MAAM,CAAC,WAAW,CAAC,CA6BvD"}