@flyingrobots/bijou 7.2.0 → 8.0.0-rc.1

package/dist/ports/surface-cell.js

@@ -0,0 +1,42 @@
+export const FULL_MASK = {
+    char: true,
+    fg: true,
+    bg: true,
+    modifiers: true,
+    alpha: true,
+};
+export function maskCell(cell, mask) {
+    return {
+        char: mask.char ? cell.char : ' ',
+        fg: mask.fg ? cell.fg : undefined,
+        bg: mask.bg ? cell.bg : undefined,
+        fgRGB: mask.fg ? cell.fgRGB : undefined,
+        bgRGB: mask.bg ? cell.bgRGB : undefined,
+        modifiers: mask.modifiers ? cell.modifiers : undefined,
+        empty: mask.alpha ? (cell.empty ?? false) : false,
+        opacity: mask.alpha ? (cell.opacity ?? 1) : 1,
+    };
+}
+export function cloneCell(cell) {
+    return {
+        char: cell.char,
+        fg: cell.fg,
+        bg: cell.bg,
+        fgRGB: cell.fgRGB,
+        bgRGB: cell.bgRGB,
+        modifiers: cell.modifiers,
+        empty: cell.empty,
+        opacity: cell.opacity,
+    };
+}
+export function copyCellInto(target, source) {
+    target.char = source.char;
+    target.fg = source.fg;
+    target.bg = source.bg;
+    target.fgRGB = source.fgRGB;
+    target.bgRGB = source.bgRGB;
+    target.modifiers = source.modifiers;
+    target.empty = source.empty;
+    target.opacity = source.opacity;
+}
+//# sourceMappingURL=surface-cell.js.map

package/dist/ports/surface-cell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-cell.js","sourceRoot":"","sources":["../../src/ports/surface-cell.ts"],"names":[],"mappings":"AAkCA,MAAM,CAAC,MAAM,SAAS,GAAa;IACjC,IAAI,EAAE,IAAI;IACV,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,SAAS,EAAE,IAAI;IACf,KAAK,EAAE,IAAI;CACZ,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,IAAU,EAAE,IAAc;IACjD,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG;QACjC,EAAE,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS;QACjC,EAAE,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS;QACjC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;QACvC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;QACvC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;QACtD,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK;QACjD,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KAC9C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAU;IAClC,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,OAAO,EAAE,IAAI,CAAC,OAAO;KACtB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAY,EAAE,MAAY;IACrD,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IAC1B,MAAM,CAAC,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC;IACtB,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC5B,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC5B,MAAM,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;IACpC,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC5B,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;AAClC,CAAC"}

package/dist/ports/surface-contract.d.ts

@@ -0,0 +1,53 @@
+import type { Cell, CellMask } from './surface-cell.js';
+import type { Matrix3x3, TransformOptions } from './surface-transform.js';
+export interface Surface {
+    /** Width in columns. */
+    readonly width: number;
+    /** Height in rows. */
+    readonly height: number;
+    /** Flattened cell array indexed by `y * width + x`. */
+    readonly cells: Cell[];
+    /** Reset every cell to the default empty state. */
+    clear(): void;
+    /** Read a masked cell, returning an empty cell outside the surface. */
+    get(x: number, y: number, mask?: CellMask): Cell;
+    /** Write a masked cell; coordinates outside the surface are ignored. */
+    set(x: number, y: number, cell: Cell, mask?: CellMask): void;
+    /**
+     * Write numeric color channels directly into the packed buffer.
+     *
+     * This allocation-free path avoids the color parsing performed by
+     * {@link set}. A red channel of `-1` selects the terminal default.
+     */
+    setRGB(x: number, y: number, char: number | string, fgR: number, fgG: number, fgB: number, bgR: number, bgG: number, bgB: number, flags?: number): void;
+    /** Fill a rectangular region, defaulting to the complete surface. */
+    fill(cell: Cell, x?: number, y?: number, width?: number, height?: number, mask?: CellMask): void;
+    /** Copy a rectangular region from another surface. */
+    blit(source: Surface, x: number, y: number, sourceX?: number, sourceY?: number, sourceWidth?: number, sourceHeight?: number, mask?: CellMask): void;
+    /** Apply an affine transformation from another surface. */
+    transform(source: Surface, matrix: Matrix3x3, options?: TransformOptions): void;
+    /** Read a masked horizontal span of cells. */
+    getRow(y: number, x?: number, width?: number, mask?: CellMask): Cell[];
+    /** Write a masked horizontal span of cells. */
+    setRow(y: number, cells: Cell[], x?: number, mask?: CellMask): void;
+    /** Create a deep copy of this surface. */
+    clone(): Surface;
+}
+export interface PackedSurface extends Surface {
+    /** Raw `CELL_STRIDE`-byte cells in row-major order. */
+    readonly buffer: Uint8Array;
+    /** Multi-codepoint graphemes referenced by packed character indexes. */
+    readonly sideTable: string[];
+    /**
+     * One render-dirty bit per cell. The union of the front and back surface
+     * bitmaps identifies both new paints and cells that require erasure.
+     */
+    readonly renderDirtyWords: Uint32Array;
+    /** Mark every cell for lazy decode and rendering. */
+    markAllDirty(): void;
+    /** Clear render-dirty bits without mutating packed cell bytes. */
+    markAllRenderClean(): void;
+}
+/** Return whether a surface exposes Bijou's packed storage contract. */
+export declare function isPackedSurface(surface: Surface): surface is PackedSurface;
+//# sourceMappingURL=surface-contract.d.ts.map

package/dist/ports/surface-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-contract.d.ts","sourceRoot":"","sources":["../../src/ports/surface-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1E,MAAM,WAAW,OAAO;IACtB,wBAAwB;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,sBAAsB;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,uDAAuD;IACvD,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC;IACvB,mDAAmD;IACnD,KAAK,IAAI,IAAI,CAAC;IACd,uEAAuE;IACvE,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;IACjD,wEAAwE;IACxE,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC7D;;;;;OAKG;IACH,MAAM,CACJ,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,IAAI,EAAE,MAAM,GAAG,MAAM,EACrB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,MAAM,GACb,IAAI,CAAC;IACR,qEAAqE;IACrE,IAAI,CACF,IAAI,EAAE,IAAI,EACV,CAAC,CAAC,EAAE,MAAM,EACV,CAAC,CAAC,EAAE,MAAM,EACV,KAAK,CAAC,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,QAAQ,GACd,IAAI,CAAC;IACR,sDAAsD;IACtD,IAAI,CACF,MAAM,EAAE,OAAO,EACf,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,MAAM,EACpB,YAAY,CAAC,EAAE,MAAM,EACrB,IAAI,CAAC,EAAE,QAAQ,GACd,IAAI,CAAC;IACR,2DAA2D;IAC3D,SAAS,CACP,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,SAAS,EACjB,OAAO,CAAC,EAAE,gBAAgB,GACzB,IAAI,CAAC;IACR,8CAA8C;IAC9C,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,IAAI,EAAE,CAAC;IACvE,+CAA+C;IAC/C,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;IACpE,0CAA0C;IAC1C,KAAK,IAAI,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,aAAc,SAAQ,OAAO;IAC5C,uDAAuD;IACvD,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,wEAAwE;IACxE,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,EAAE,WAAW,CAAC;IACvC,qDAAqD;IACrD,YAAY,IAAI,IAAI,CAAC;IACrB,kEAAkE;IAClE,kBAAkB,IAAI,IAAI,CAAC;CAC5B;AAED,wEAAwE;AACxE,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,aAAa,CAE1E"}

package/dist/ports/surface-contract.js

@@ -0,0 +1,5 @@
+/** Return whether a surface exposes Bijou's packed storage contract. */
+export function isPackedSurface(surface) {
+    return 'buffer' in surface && surface.buffer instanceof Uint8Array;
+}
+//# sourceMappingURL=surface-contract.js.map

package/dist/ports/surface-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-contract.js","sourceRoot":"","sources":["../../src/ports/surface-contract.ts"],"names":[],"mappings":"AAoFA,wEAAwE;AACxE,MAAM,UAAU,eAAe,CAAC,OAAgB;IAC9C,OAAO,QAAQ,IAAI,OAAO,IAAI,OAAO,CAAC,MAAM,YAAY,UAAU,CAAC;AACrE,CAAC"}

package/dist/ports/surface-create.d.ts

@@ -0,0 +1,4 @@
+import { type Cell } from './surface-cell.js';
+import type { PackedSurface } from './surface-contract.js';
+export declare function createSurface(width: number, height: number, fill?: Cell): PackedSurface;
+//# sourceMappingURL=surface-create.d.ts.map

package/dist/ports/surface-create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-create.d.ts","sourceRoot":"","sources":["../../src/ports/surface-create.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,IAAI,EACV,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAoB3D,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,IAAI,GACV,aAAa,CAuGf"}

package/dist/ports/surface-create.js

@@ -0,0 +1,48 @@
+import { FULL_MASK, } from './surface-cell.js';
+import { blitSurface, transformSurface } from './surface-packed-compose.js';
+import { copySurfaceIntoClone, getSurfaceCell, getSurfaceRow, setSurfaceRow, } from './surface-packed-read.js';
+import { createPackedSurfaceState, markAllDirty, markAllRenderClean, } from './surface-packed-state.js';
+import { clearSurface, fillSurface, setSurfaceCell, setSurfaceRgb, } from './surface-packed-write.js';
+export function createSurface(width, height, fill) {
+    const state = createPackedSurfaceState(width, height, fill);
+    const surface = {
+        width: state.width,
+        height: state.height,
+        cells: state.cells,
+        buffer: state.buffer,
+        sideTable: state.sideTable,
+        renderDirtyWords: state.renderDirtyWords,
+        markAllDirty: () => {
+            markAllDirty(state);
+        },
+        markAllRenderClean: () => {
+            markAllRenderClean(state);
+        },
+        clear: () => {
+            clearSurface(state);
+        },
+        get: (x, y, mask = FULL_MASK) => getSurfaceCell(state, x, y, mask),
+        set: (x, y, cell, mask = FULL_MASK) => {
+            setSurfaceCell(state, x, y, cell, mask);
+        },
+        setRGB: (x, y, char, foregroundRed, foregroundGreen, foregroundBlue, backgroundRed, backgroundGreen, backgroundBlue, flags = 0) => {
+            setSurfaceRgb(state, x, y, char, foregroundRed, foregroundGreen, foregroundBlue, backgroundRed, backgroundGreen, backgroundBlue, flags);
+        },
+        fill: (cell, x = 0, y = 0, regionWidth = state.width, regionHeight = state.height, mask = FULL_MASK) => {
+            fillSurface(state, cell, x, y, regionWidth, regionHeight, mask);
+        },
+        blit: (source, x, y, sourceX = 0, sourceY = 0, sourceWidth = source.width, sourceHeight = source.height, mask = FULL_MASK) => {
+            blitSurface(state, source, x, y, sourceX, sourceY, sourceWidth, sourceHeight, mask);
+        },
+        transform: (source, matrix, options = {}) => {
+            transformSurface(state, source, matrix, options);
+        },
+        getRow: (y, x = 0, rowWidth = state.width - x, mask = FULL_MASK) => getSurfaceRow(state, y, x, rowWidth, mask),
+        setRow: (y, cells, x = 0, mask = FULL_MASK) => {
+            setSurfaceRow(state, y, cells, x, mask);
+        },
+        clone: () => copySurfaceIntoClone(state, createSurface(state.width, state.height)),
+    };
+    return surface;
+}
+//# sourceMappingURL=surface-create.js.map

package/dist/ports/surface-create.js.map

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

package/dist/ports/surface-layout.d.ts

@@ -0,0 +1,29 @@
+import type { Surface } from './surface-contract.js';
+export interface LayoutRect {
+    /** Zero-based column index. */
+    x: number;
+    /** Zero-based row index. */
+    y: number;
+    /** Width in columns. */
+    width: number;
+    /** Height in rows. */
+    height: number;
+}
+export interface LayoutNode {
+    /** Unique identifier matching a CSS ID selector. */
+    id?: string;
+    /** Component type matching a CSS type selector. */
+    type?: string;
+    /** CSS class names attached to this node. */
+    classes?: string[];
+    /** Calculated rectangle for this node. */
+    rect: LayoutRect;
+    /** Child layout nodes. */
+    children: LayoutNode[];
+    /** Optional surface painted at this node's position. */
+    surface?: Surface;
+}
+export interface LayoutEngine<Options, Child> {
+    calculate(options: Options, children: Child[], bounds: LayoutRect): LayoutNode;
+}
+//# sourceMappingURL=surface-layout.d.ts.map

package/dist/ports/surface-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-layout.d.ts","sourceRoot":"","sources":["../../src/ports/surface-layout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErD,MAAM,WAAW,UAAU;IACzB,+BAA+B;IAC/B,CAAC,EAAE,MAAM,CAAC;IACV,4BAA4B;IAC5B,CAAC,EAAE,MAAM,CAAC;IACV,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,oDAAoD;IACpD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,0CAA0C;IAC1C,IAAI,EAAE,UAAU,CAAC;IACjB,0BAA0B;IAC1B,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,wDAAwD;IACxD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,YAAY,CAAC,OAAO,EAAE,KAAK;IAC1C,SAAS,CACP,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,KAAK,EAAE,EACjB,MAAM,EAAE,UAAU,GACjB,UAAU,CAAC;CACf"}

package/dist/ports/surface-layout.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=surface-layout.js.map

package/dist/ports/surface-layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-layout.js","sourceRoot":"","sources":["../../src/ports/surface-layout.ts"],"names":[],"mappings":""}

package/dist/ports/surface-packed-codec.d.ts

@@ -0,0 +1,6 @@
+import type { Cell, CellMask } from './surface-cell.js';
+export declare function encodeCellIntoBuffer(buffer: Uint8Array, index: number, cell: Cell, sideTable: string[]): void;
+export declare function decodeCellFromBuffer(buffer: Uint8Array, index: number, sideTable: readonly string[]): Cell;
+export declare function syncCellFromBuffer(cell: Cell, buffer: Uint8Array, index: number, sideTable: readonly string[], exactOpacity?: number): void;
+export declare function applyMaskToBuffer(buffer: Uint8Array, index: number, source: Cell, mask: CellMask, sideTable: string[]): void;
+//# sourceMappingURL=surface-packed-codec.d.ts.map

package/dist/ports/surface-packed-codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-packed-codec.d.ts","sourceRoot":"","sources":["../../src/ports/surface-packed-codec.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAOxD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,MAAM,EAAE,GAClB,IAAI,CAoBN;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,SAAS,MAAM,EAAE,GAC3B,IAAI,CAmBN;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,YAAY,CAAC,EAAE,MAAM,GACpB,IAAI,CAUN;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,IAAI,EACZ,IAAI,EAAE,QAAQ,EACd,SAAS,EAAE,MAAM,EAAE,GAClB,IAAI,CAwCN"}

package/dist/ports/surface-packed-codec.js

@@ -0,0 +1,86 @@
+import { byteAt, hexAt, rgbAt, } from '../core/render/safe-read.js';
+import { CELL_STRIDE, FLAG_BG_SET, FLAG_EMPTY, FLAG_FG_SET, OFF_ALPHA, OFF_BG_R, OFF_CHAR, OFF_FG_R, OFF_FLAGS, OPACITY_MASK, decodeChar, decodeModifiers, decodeOpacity, encodeChar, encodeModifiers, encodeOpacity, } from '../core/render/packed-cell.js';
+import { colorHex, colorRgb } from '../core/theme/color.js';
+import { clearRgb, writeColorRefInto, writeMaskedColor, } from './surface-packed-color.js';
+export function encodeCellIntoBuffer(buffer, index, cell, sideTable) {
+    const offset = index * CELL_STRIDE;
+    const charCode = encodeChar(cell.char, sideTable);
+    buffer[offset + OFF_CHAR] = charCode & 0xff;
+    buffer[offset + OFF_CHAR + 1] = (charCode >> 8) & 0xff;
+    let alphaBits = 0;
+    if (writeColorRefInto(cell.fg, cell.fgRGB, buffer, offset + OFF_FG_R)) {
+        alphaBits |= FLAG_FG_SET;
+    }
+    else {
+        clearRgb(buffer, offset + OFF_FG_R);
+    }
+    if (writeColorRefInto(cell.bg, cell.bgRGB, buffer, offset + OFF_BG_R)) {
+        alphaBits |= FLAG_BG_SET;
+    }
+    else {
+        clearRgb(buffer, offset + OFF_BG_R);
+    }
+    buffer[offset + OFF_FLAGS] =
+        encodeModifiers(cell.modifiers) | (cell.empty ? FLAG_EMPTY : 0);
+    buffer[offset + OFF_ALPHA] =
+        (encodeOpacity(cell.opacity) & OPACITY_MASK) | alphaBits;
+}
+export function decodeCellFromBuffer(buffer, index, sideTable) {
+    const offset = index * CELL_STRIDE;
+    const charCode = byteAt(buffer, offset + OFF_CHAR) |
+        (byteAt(buffer, offset + OFF_CHAR + 1) << 8);
+    const alpha = byteAt(buffer, offset + OFF_ALPHA);
+    const flags = byteAt(buffer, offset + OFF_FLAGS);
+    const fgSet = (alpha & FLAG_FG_SET) !== 0;
+    const bgSet = (alpha & FLAG_BG_SET) !== 0;
+    return {
+        char: decodeChar(charCode, sideTable),
+        fg: fgSet ? hexAt(buffer, offset + OFF_FG_R) : undefined,
+        bg: bgSet ? hexAt(buffer, offset + OFF_BG_R) : undefined,
+        fgRGB: fgSet ? rgbAt(buffer, offset + OFF_FG_R) : undefined,
+        bgRGB: bgSet ? rgbAt(buffer, offset + OFF_BG_R) : undefined,
+        modifiers: decodeModifiers(flags & ~FLAG_EMPTY),
+        empty: (flags & FLAG_EMPTY) !== 0,
+        opacity: decodeOpacity(alpha & OPACITY_MASK),
+    };
+}
+export function syncCellFromBuffer(cell, buffer, index, sideTable, exactOpacity) {
+    const decoded = decodeCellFromBuffer(buffer, index, sideTable);
+    cell.char = decoded.char;
+    cell.fg = colorHex(decoded.fg);
+    cell.bg = colorHex(decoded.bg);
+    cell.fgRGB = colorRgb(decoded.fg);
+    cell.bgRGB = colorRgb(decoded.bg);
+    cell.modifiers = decoded.modifiers;
+    cell.empty = decoded.empty;
+    cell.opacity = exactOpacity ?? decoded.opacity;
+}
+export function applyMaskToBuffer(buffer, index, source, mask, sideTable) {
+    if (source.empty)
+        return;
+    const offset = index * CELL_STRIDE;
+    if (mask.char) {
+        const code = encodeChar(source.char, sideTable);
+        buffer[offset + OFF_CHAR] = code & 0xff;
+        buffer[offset + OFF_CHAR + 1] = (code >> 8) & 0xff;
+    }
+    if (mask.fg) {
+        writeMaskedColor(buffer, offset, OFF_FG_R, FLAG_FG_SET, source.fg, source.fgRGB);
+    }
+    if (mask.bg) {
+        writeMaskedColor(buffer, offset, OFF_BG_R, FLAG_BG_SET, source.bg, source.bgRGB);
+    }
+    if (mask.modifiers) {
+        const existing = byteAt(buffer, offset + OFF_FLAGS);
+        buffer[offset + OFF_FLAGS] =
+            (existing & FLAG_EMPTY) | encodeModifiers(source.modifiers);
+    }
+    if (mask.alpha) {
+        buffer[offset + OFF_FLAGS] =
+            byteAt(buffer, offset + OFF_FLAGS) & ~FLAG_EMPTY;
+        const alpha = byteAt(buffer, offset + OFF_ALPHA);
+        buffer[offset + OFF_ALPHA] =
+            (alpha & ~OPACITY_MASK) | encodeOpacity(source.opacity ?? 1);
+    }
+}
+//# sourceMappingURL=surface-packed-codec.js.map

package/dist/ports/surface-packed-codec.js.map

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

package/dist/ports/surface-packed-color.d.ts

@@ -0,0 +1,7 @@
+import { type ColorRef } from '../core/theme/color.js';
+import { OFF_BG_R, OFF_FG_R } from '../core/render/packed-cell.js';
+import type { Cell } from './surface-cell.js';
+export declare function writeColorRefInto(reference: ColorRef | undefined, rgb: readonly [number, number, number] | undefined, output: Uint8Array, offset: number): boolean;
+export declare function writeMaskedColor(buffer: Uint8Array, cellOffset: number, colorOffset: typeof OFF_FG_R | typeof OFF_BG_R, presentFlag: number, reference: Cell['fg'], rgb: Cell['fgRGB']): void;
+export declare function clearRgb(buffer: Uint8Array, offset: number): void;
+//# sourceMappingURL=surface-packed-color.d.ts.map

package/dist/ports/surface-packed-color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-packed-color.d.ts","sourceRoot":"","sources":["../../src/ports/surface-packed-color.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,QAAQ,EACd,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAEL,QAAQ,EACR,QAAQ,EACT,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAE9C,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,QAAQ,GAAG,SAAS,EAC/B,GAAG,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EAClD,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAeT;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,UAAU,EAClB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,OAAO,QAAQ,GAAG,OAAO,QAAQ,EAC9C,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,EACrB,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,GACjB,IAAI,CAQN;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAIjE"}

package/dist/ports/surface-packed-color.js

@@ -0,0 +1,53 @@
+import { isResolvedColor, } from '../core/theme/color.js';
+import { OFF_ALPHA, } from '../core/render/packed-cell.js';
+import { byteAt } from '../core/render/safe-read.js';
+export function writeColorRefInto(reference, rgb, output, offset) {
+    if (rgb !== undefined) {
+        output[offset] = rgb[0];
+        output[offset + 1] = rgb[1];
+        output[offset + 2] = rgb[2];
+        return true;
+    }
+    if (reference == null)
+        return false;
+    if (isResolvedColor(reference)) {
+        output[offset] = reference.rgb[0];
+        output[offset + 1] = reference.rgb[1];
+        output[offset + 2] = reference.rgb[2];
+        return true;
+    }
+    return inlineHexRgb(reference, output, offset);
+}
+export function writeMaskedColor(buffer, cellOffset, colorOffset, presentFlag, reference, rgb) {
+    const alphaOffset = cellOffset + OFF_ALPHA;
+    if (writeColorRefInto(reference, rgb, buffer, cellOffset + colorOffset)) {
+        buffer[alphaOffset] = byteAt(buffer, alphaOffset) | presentFlag;
+        return;
+    }
+    clearRgb(buffer, cellOffset + colorOffset);
+    buffer[alphaOffset] = byteAt(buffer, alphaOffset) & ~presentFlag;
+}
+export function clearRgb(buffer, offset) {
+    buffer[offset] = 0;
+    buffer[offset + 1] = 0;
+    buffer[offset + 2] = 0;
+}
+function inlineHexRgb(hex, output, offset) {
+    if (hex.length !== 7)
+        return false;
+    output[offset] =
+        (hexDigit(hex.charCodeAt(1)) << 4) | hexDigit(hex.charCodeAt(2));
+    output[offset + 1] =
+        (hexDigit(hex.charCodeAt(3)) << 4) | hexDigit(hex.charCodeAt(4));
+    output[offset + 2] =
+        (hexDigit(hex.charCodeAt(5)) << 4) | hexDigit(hex.charCodeAt(6));
+    return true;
+}
+function hexDigit(code) {
+    if (code >= 97)
+        return code - 87;
+    if (code >= 65)
+        return code - 55;
+    return code - 48;
+}
+//# sourceMappingURL=surface-packed-color.js.map

package/dist/ports/surface-packed-color.js.map

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

package/dist/ports/surface-packed-compose.d.ts

@@ -0,0 +1,7 @@
+import type { Surface } from './surface-contract.js';
+import { type CellMask } from './surface-cell.js';
+import type { Matrix3x3, TransformOptions } from './surface-transform.js';
+import { type PackedSurfaceState } from './surface-packed-state.js';
+export declare function blitSurface(state: PackedSurfaceState, source: Surface, destinationX: number, destinationY: number, sourceX: number, sourceY: number, sourceWidth: number, sourceHeight: number, mask: CellMask): void;
+export declare function transformSurface(state: PackedSurfaceState, source: Surface, matrix: Matrix3x3, options: TransformOptions): void;
+//# sourceMappingURL=surface-packed-compose.d.ts.map

package/dist/ports/surface-packed-compose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-packed-compose.d.ts","sourceRoot":"","sources":["../../src/ports/surface-packed-compose.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAEL,KAAK,QAAQ,EACd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAI1E,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,2BAA2B,CAAC;AAEnC,wBAAgB,WAAW,CACzB,KAAK,EAAE,kBAAkB,EACzB,MAAM,EAAE,OAAO,EACf,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,QAAQ,GACb,IAAI,CA4DN;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,kBAAkB,EACzB,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,gBAAgB,GACxB,IAAI,CAgCN"}

package/dist/ports/surface-packed-compose.js

@@ -0,0 +1,66 @@
+import { FULL_MASK, } from './surface-cell.js';
+import { isPackedSurface } from './surface-contract.js';
+import { applyMaskToBuffer } from './surface-packed-codec.js';
+import { copyPackedSurfaceRegion } from './surface-packed-read.js';
+import { markCellDirty, } from './surface-packed-state.js';
+export function blitSurface(state, source, destinationX, destinationY, sourceX, sourceY, sourceWidth, sourceHeight, mask) {
+    const sourceStartX = Math.max(0, sourceX);
+    const sourceStartY = Math.max(0, sourceY);
+    const width = Math.min(sourceWidth - (sourceStartX - sourceX), source.width - sourceStartX);
+    const height = Math.min(sourceHeight - (sourceStartY - sourceY), source.height - sourceStartY);
+    if (width <= 0 || height <= 0)
+        return;
+    const unclippedDestinationX = destinationX + (sourceStartX - sourceX);
+    const unclippedDestinationY = destinationY + (sourceStartY - sourceY);
+    const destinationStartX = Math.max(0, unclippedDestinationX);
+    const destinationStartY = Math.max(0, unclippedDestinationY);
+    const adjustedSourceX = sourceStartX + (destinationStartX - unclippedDestinationX);
+    const adjustedSourceY = sourceStartY + (destinationStartY - unclippedDestinationY);
+    const copyWidth = Math.min(state.width - destinationStartX, width - (adjustedSourceX - sourceStartX));
+    const copyHeight = Math.min(state.height - destinationStartY, height - (adjustedSourceY - sourceStartY));
+    if (copyWidth <= 0 || copyHeight <= 0)
+        return;
+    if (isPackedSurface(source) && mask === FULL_MASK) {
+        copyPackedSurfaceRegion(state, source, destinationStartX, destinationStartY, adjustedSourceX, adjustedSourceY, copyWidth, copyHeight);
+        return;
+    }
+    for (let row = 0; row < copyHeight; row++) {
+        for (let column = 0; column < copyWidth; column++) {
+            const index = (destinationStartY + row) * state.width +
+                destinationStartX +
+                column;
+            applyMaskToBuffer(state.buffer, index, source.get(adjustedSourceX + column, adjustedSourceY + row), mask, state.sideTable);
+            markCellDirty(state, index);
+        }
+    }
+}
+export function transformSurface(state, source, matrix, options) {
+    const { charMap = {}, mask = FULL_MASK } = options;
+    const [a, b, c, d, translateX, translateY] = matrix;
+    const determinant = a * d - b * c;
+    if (Math.abs(determinant) < 0.0001)
+        return;
+    for (let y = 0; y < state.height; y++) {
+        for (let x = 0; x < state.width; x++) {
+            const sourceX = Math.round((d * (x - translateX) - b * (y - translateY)) / determinant);
+            const sourceY = Math.round((a * (y - translateY) - c * (x - translateX)) / determinant);
+            if (sourceX < 0 ||
+                sourceX >= source.width ||
+                sourceY < 0 ||
+                sourceY >= source.height) {
+                continue;
+            }
+            const sourceCell = source.get(sourceX, sourceY);
+            if (sourceCell.empty)
+                continue;
+            const cell = {
+                ...sourceCell,
+                char: charMap[sourceCell.char] ?? sourceCell.char,
+            };
+            const index = y * state.width + x;
+            applyMaskToBuffer(state.buffer, index, cell, mask, state.sideTable);
+            markCellDirty(state, index);
+        }
+    }
+}
+//# sourceMappingURL=surface-packed-compose.js.map

package/dist/ports/surface-packed-compose.js.map

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

package/dist/ports/surface-packed-read.d.ts

@@ -0,0 +1,9 @@
+import type { PackedSurface, Surface } from './surface-contract.js';
+import { type Cell, type CellMask } from './surface-cell.js';
+import { type PackedSurfaceState } from './surface-packed-state.js';
+export declare function getSurfaceCell(state: PackedSurfaceState, x: number, y: number, mask?: CellMask): Cell;
+export declare function getSurfaceRow(state: PackedSurfaceState, y: number, x: number, width: number, mask: CellMask): Cell[];
+export declare function setSurfaceRow(state: PackedSurfaceState, y: number, row: Cell[], x: number, mask: CellMask): void;
+export declare function copySurfaceIntoClone(state: PackedSurfaceState, clone: PackedSurface): Surface;
+export declare function copyPackedSurfaceRegion(state: PackedSurfaceState, source: PackedSurface, destinationX: number, destinationY: number, sourceX: number, sourceY: number, width: number, height: number): void;
+//# sourceMappingURL=surface-packed-read.d.ts.map

package/dist/ports/surface-packed-read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-packed-read.d.ts","sourceRoot":"","sources":["../../src/ports/surface-packed-read.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAGL,KAAK,IAAI,EACT,KAAK,QAAQ,EACd,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,2BAA2B,CAAC;AAEnC,wBAAgB,cAAc,CAC5B,KAAK,EAAE,kBAAkB,EACzB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,IAAI,GAAE,QAAoB,GACzB,IAAI,CAKN;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,kBAAkB,EACzB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,QAAQ,GACb,IAAI,EAAE,CAYR;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,kBAAkB,EACzB,CAAC,EAAE,MAAM,EACT,GAAG,EAAE,IAAI,EAAE,EACX,CAAC,EAAE,MAAM,EACT,IAAI,EAAE,QAAQ,GACb,IAAI,CAeN;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,kBAAkB,EACzB,KAAK,EAAE,aAAa,GACnB,OAAO,CAOT;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,kBAAkB,EACzB,MAAM,EAAE,aAAa,EACrB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,IAAI,CAoBN"}

package/dist/ports/surface-packed-read.js

@@ -0,0 +1,77 @@
+import { byteAt, cellAt } from '../core/render/safe-read.js';
+import { CELL_STRIDE, FLAG_EMPTY, OFF_CHAR, OFF_FLAGS, SIDE_TABLE_THRESHOLD, encodeChar, } from '../core/render/packed-cell.js';
+import { FULL_MASK, maskCell, } from './surface-cell.js';
+import { applyMaskToBuffer } from './surface-packed-codec.js';
+import { ensureCellClean, markCellDirty, } from './surface-packed-state.js';
+export function getSurfaceCell(state, x, y, mask = FULL_MASK) {
+    if (!inBounds(state, x, y))
+        return { char: ' ', empty: true };
+    const index = y * state.width + x;
+    ensureCellClean(state, index);
+    return maskCell(cellAt(state.cells, index), mask);
+}
+export function getSurfaceRow(state, y, x, width, mask) {
+    if (y < 0 || y >= state.height)
+        return [];
+    const startX = Math.max(0, x);
+    const count = Math.min(state.width - startX, width);
+    if (count <= 0)
+        return [];
+    const start = y * state.width + startX;
+    for (let index = 0; index < count; index++) {
+        ensureCellClean(state, start + index);
+    }
+    return state.cells
+        .slice(start, start + count)
+        .map((cell) => maskCell(cell, mask));
+}
+export function setSurfaceRow(state, y, row, x, mask) {
+    if (y < 0 || y >= state.height)
+        return;
+    const startX = Math.max(0, x);
+    const count = Math.min(state.width - startX, row.length);
+    for (let offset = 0; offset < count; offset++) {
+        const index = y * state.width + startX + offset;
+        applyMaskToBuffer(state.buffer, index, cellAt(row, offset), mask, state.sideTable);
+        markCellDirty(state, index);
+    }
+}
+export function copySurfaceIntoClone(state, clone) {
+    clone.buffer.set(state.buffer);
+    for (const entry of state.sideTable) {
+        if (!clone.sideTable.includes(entry))
+            clone.sideTable.push(entry);
+    }
+    clone.markAllDirty();
+    return clone;
+}
+export function copyPackedSurfaceRegion(state, source, destinationX, destinationY, sourceX, sourceY, width, height) {
+    for (let row = 0; row < height; row++) {
+        for (let column = 0; column < width; column++) {
+            const sourceIndex = (sourceY + row) * source.width + sourceX + column;
+            const sourceOffset = sourceIndex * CELL_STRIDE;
+            if (byteAt(source.buffer, sourceOffset + OFF_FLAGS) & FLAG_EMPTY) {
+                continue;
+            }
+            const targetIndex = (destinationY + row) * state.width + destinationX + column;
+            const targetOffset = targetIndex * CELL_STRIDE;
+            state.buffer.set(source.buffer.subarray(sourceOffset, sourceOffset + CELL_STRIDE), targetOffset);
+            copySideTableCharacter(state, source, sourceOffset, targetOffset);
+            markCellDirty(state, targetIndex);
+        }
+    }
+}
+function copySideTableCharacter(state, source, sourceOffset, targetOffset) {
+    const code = byteAt(source.buffer, sourceOffset) |
+        (byteAt(source.buffer, sourceOffset + 1) << 8);
+    if (code < SIDE_TABLE_THRESHOLD)
+        return;
+    const char = source.sideTable[code - SIDE_TABLE_THRESHOLD] ?? ' ';
+    const targetCode = encodeChar(char, state.sideTable);
+    state.buffer[targetOffset + OFF_CHAR] = targetCode & 0xff;
+    state.buffer[targetOffset + OFF_CHAR + 1] = (targetCode >> 8) & 0xff;
+}
+function inBounds(state, x, y) {
+    return x >= 0 && x < state.width && y >= 0 && y < state.height;
+}
+//# sourceMappingURL=surface-packed-read.js.map

package/dist/ports/surface-packed-read.js.map

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

package/dist/ports/surface-packed-state.d.ts

@@ -0,0 +1,19 @@
+import type { Cell } from './surface-cell.js';
+export interface PackedSurfaceState {
+    readonly width: number;
+    readonly height: number;
+    readonly size: number;
+    readonly defaultCell: Cell;
+    readonly sideTable: string[];
+    readonly buffer: Uint8Array;
+    readonly dirtyWords: Uint32Array;
+    readonly renderDirtyWords: Uint32Array;
+    readonly cells: Cell[];
+}
+export declare function createPackedSurfaceState(width: number, height: number, fill?: Cell): PackedSurfaceState;
+export declare function markCellDirty(state: PackedSurfaceState, index: number): void;
+export declare function ensureCellClean(state: PackedSurfaceState, index: number): void;
+export declare function markAllClean(state: PackedSurfaceState): void;
+export declare function markAllDirty(state: PackedSurfaceState): void;
+export declare function markAllRenderClean(state: PackedSurfaceState): void;
+//# sourceMappingURL=surface-packed-state.d.ts.map