@react-x11/components 0.1.0 → 0.2.1

package/dist/ansi/cast.d.ts

@@ -0,0 +1,48 @@
+/** The recording's own metadata: the grid it was made at, and its title. */
+export interface AnsiCastHeader {
+    version: number;
+    width: number;
+    height: number;
+    title?: string;
+    /** Unix seconds, when the recording says. */
+    timestamp?: number;
+    env?: Readonly<Record<string, string>>;
+}
+/** One recorded event. `'o'` is output — the only kind that has pixels. */
+export interface AnsiCastEvent {
+    /** Seconds from the start of the recording. Absolute, v1's deltas
+     *  included: a reader should not have to know which version it opened. */
+    readonly time: number;
+    readonly kind: 'o' | 'i' | 'r' | 'm' | string;
+    readonly data: string;
+}
+export interface AnsiCast {
+    readonly header: AnsiCastHeader;
+    readonly events: readonly AnsiCastEvent[];
+}
+/** What `parseCast` refuses. Its own type so an app can tell "not a cast"
+ *  from a read error, which is the only distinction a caller acts on. */
+export declare class CastFormatError extends Error {
+    constructor(message: string);
+}
+/**
+ * Read a recording.
+ *
+ * A malformed *event* line is skipped rather than fatal — a recording still
+ * being written has a partial last line, and refusing the whole file over it
+ * is the wrong trade. A missing or unreadable *header* throws, because
+ * without one there is no recording to read.
+ */
+export declare function parseCast(text: string): AnsiCast;
+/**
+ * The recorded output, concatenated — what a terminal received.
+ *
+ * `until` is a moment in seconds: pass it to render the session as it looked
+ * then, which with a slider in the app is a scrubber and without one is a
+ * still. Input, resize and marker events are left out, because only output
+ * has pixels.
+ */
+export declare function castOutput(cast: AnsiCast, options?: {
+    until?: number;
+}): string;
+//# sourceMappingURL=cast.d.ts.map

package/dist/ansi/cast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cast.d.ts","sourceRoot":"","sources":["../../src/ansi/cast.ts"],"names":[],"mappings":"AAaA,4EAA4E;AAC5E,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACxC;AAED,2EAA2E;AAC3E,MAAM,WAAW,aAAa;IAC5B;8EAC0E;IAC1E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,MAAM,CAAC;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;CAC3C;AAED;yEACyE;AACzE,qBAAa,eAAgB,SAAQ,KAAK;IACxC,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAmBD;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAgEhD;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,QAAQ,EACd,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/B,MAAM,CASR"}

package/dist/ansi/cast.js

@@ -0,0 +1,135 @@
+// asciinema recordings, read.
+//
+// A cast is the standard interchange format for "I ran this in a pty and kept
+// it", so a static renderer that cannot open one is a static renderer that
+// asks every user to write the same twenty lines. Both published versions are
+// read: v2 is JSON Lines (a header object, then `[time, kind, data]` events),
+// v1 is one JSON document with relative delays.
+//
+// **This is a reader, not a player.** `castOutput(cast, { until })` gives the
+// bytes up to a moment and `parseAnsi` turns those into a document; scheduling
+// the moments is the app's, because a component with a timer inside it never
+// settles in a screenshot test. See the PRD.
+/** What `parseCast` refuses. Its own type so an app can tell "not a cast"
+ *  from a read error, which is the only distinction a caller acts on. */
+export class CastFormatError extends Error {
+    constructor(message) {
+        super(`@react-x11/components: ${message}`);
+        this.name = 'CastFormatError';
+    }
+}
+function headerOf(value) {
+    const raw = (value ?? {});
+    const num = (v, dflt) => typeof v === 'number' && Number.isFinite(v) ? v : dflt;
+    const header = {
+        version: num(raw.version, 2),
+        width: Math.max(1, num(raw.width, 80)),
+        height: Math.max(1, num(raw.height, 24)),
+    };
+    if (typeof raw.title === 'string')
+        header.title = raw.title;
+    if (typeof raw.timestamp === 'number')
+        header.timestamp = raw.timestamp;
+    if (raw.env && typeof raw.env === 'object') {
+        header.env = raw.env;
+    }
+    return header;
+}
+/**
+ * Read a recording.
+ *
+ * A malformed *event* line is skipped rather than fatal — a recording still
+ * being written has a partial last line, and refusing the whole file over it
+ * is the wrong trade. A missing or unreadable *header* throws, because
+ * without one there is no recording to read.
+ */
+export function parseCast(text) {
+    const trimmed = text.trim();
+    if (!trimmed)
+        throw new CastFormatError('the recording is empty');
+    // v1 is one JSON document, so it is exactly the case where parsing the
+    // whole file succeeds. A v2 file is several JSON values and does not.
+    let whole;
+    try {
+        whole = JSON.parse(trimmed);
+    }
+    catch {
+        whole = undefined;
+    }
+    if (whole && typeof whole === 'object') {
+        const raw = whole;
+        if (Array.isArray(raw.stdout)) {
+            const header = headerOf(raw);
+            const events = [];
+            let time = 0;
+            for (const entry of raw.stdout) {
+                if (!Array.isArray(entry) || entry.length < 2)
+                    continue;
+                const [delay, data] = entry;
+                if (typeof delay !== 'number' || typeof data !== 'string')
+                    continue;
+                // v1 records the gap since the previous event; every consumer wants
+                // the moment, so the conversion happens here rather than in each one.
+                time += delay;
+                events.push({ time, kind: 'o', data });
+            }
+            return { header: { ...header, version: 1 }, events };
+        }
+        // A v2 file whose recording is empty: a header and nothing after it.
+        return { header: headerOf(raw), events: [] };
+    }
+    const lines = trimmed.split('\n');
+    let header = null;
+    const events = [];
+    for (const line of lines) {
+        const source = line.trim();
+        if (!source)
+            continue;
+        let value;
+        try {
+            value = JSON.parse(source);
+        }
+        catch {
+            continue;
+        }
+        if (!header) {
+            if (Array.isArray(value)) {
+                throw new CastFormatError('the recording starts with an event rather than a header — ' +
+                    'this does not look like an asciinema cast');
+            }
+            header = headerOf(value);
+            continue;
+        }
+        if (!Array.isArray(value) || value.length < 3)
+            continue;
+        const [time, kind, data] = value;
+        if (typeof time !== 'number' || typeof data !== 'string')
+            continue;
+        events.push({ time, kind: typeof kind === 'string' ? kind : 'o', data });
+    }
+    if (!header) {
+        throw new CastFormatError('the recording has no header line');
+    }
+    return { header, events };
+}
+/**
+ * The recorded output, concatenated — what a terminal received.
+ *
+ * `until` is a moment in seconds: pass it to render the session as it looked
+ * then, which with a slider in the app is a scrubber and without one is a
+ * still. Input, resize and marker events are left out, because only output
+ * has pixels.
+ */
+export function castOutput(cast, options = {}) {
+    const until = options.until ?? Infinity;
+    let out = '';
+    for (const event of cast.events) {
+        if (event.kind !== 'o')
+            continue;
+        if (event.time > until)
+            break;
+        out += event.data;
+    }
+    return out;
+}
+//# sourceMappingURL=cast.js.map

package/dist/ansi/cast.js.map

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

package/dist/ansi/index.d.ts

@@ -0,0 +1,10 @@
+export { parseAnsi, stripAnsi, AnsiState } from './parse.js';
+export type { AnsiDocument, AnsiInput, AnsiLine, AnsiSpan, ParseAnsiOptions, } from './parse.js';
+export { PLAIN, Style, ansiColor, rgbColor, param, ABSENT } from './sgr.js';
+export type { AnsiAttrs, AnsiColor, AnsiUnderline } from './sgr.js';
+export { ANSI_16, ansiPalette, cssColor, mixRgb, parseCssColor, resolveAnsiColors, } from './palette.js';
+export type { AnsiColorAttrs, AnsiPalette, AnsiPaletteOptions, ResolvedAnsiColors, Rgb, } from './palette.js';
+export { CastFormatError, castOutput, parseCast } from './cast.js';
+export type { AnsiCast, AnsiCastEvent, AnsiCastHeader } from './cast.js';
+export { Utf8Decoder } from './utf8.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/ansi/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ansi/index.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC7D,YAAY,EACV,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAC5E,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEpE,OAAO,EACL,OAAO,EACP,WAAW,EACX,QAAQ,EACR,MAAM,EACN,aAAa,EACb,iBAAiB,GAClB,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,cAAc,EACd,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EAClB,GAAG,GACJ,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACnE,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEzE,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC"}

package/dist/ansi/index.js

@@ -0,0 +1,27 @@
+// A captured terminal session, as a document — the parser under
+// `<TerminalOutput>`, and useful on its own.
+//
+// ```ts
+// import { parseAnsi } from '@react-x11/components/ansi';
+//
+// const doc = parseAnsi(await readFile('build.log'));
+// doc.lines.map((line) => line.text); // the text, escapes resolved away
+// doc.needsScreen;                    // did these bytes want a grid?
+// doc.dropped;                        // what could not be honoured
+// ```
+//
+// **A shared module, not a component.** Nothing here registers an element,
+// renders anything, or does any work at import time; there is no optional
+// dependency and no `@xterm/headless`. It has a subpath of its own because
+// "turn a log into styled text" is a thing to want without a terminal
+// anywhere near it — colouring a build log inside a `<Markdown>` document,
+// say, or stripping escapes before a diff.
+//
+// `docs/prd-terminal-output.md` is the design record: why a log is a document
+// rather than a grid, and what that model can and cannot represent.
+export { parseAnsi, stripAnsi, AnsiState } from './parse.js';
+export { PLAIN, Style, ansiColor, rgbColor, param, ABSENT } from './sgr.js';
+export { ANSI_16, ansiPalette, cssColor, mixRgb, parseCssColor, resolveAnsiColors, } from './palette.js';
+export { CastFormatError, castOutput, parseCast } from './cast.js';
+export { Utf8Decoder } from './utf8.js';
+//# sourceMappingURL=index.js.map

package/dist/ansi/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ansi/index.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,6CAA6C;AAC7C,EAAE;AACF,QAAQ;AACR,0DAA0D;AAC1D,EAAE;AACF,sDAAsD;AACtD,yEAAyE;AACzE,sEAAsE;AACtE,oEAAoE;AACpE,MAAM;AACN,EAAE;AACF,2EAA2E;AAC3E,0EAA0E;AAC1E,2EAA2E;AAC3E,sEAAsE;AACtE,2EAA2E;AAC3E,2CAA2C;AAC3C,EAAE;AACF,8EAA8E;AAC9E,oEAAoE;AACpE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAS7D,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAG5E,OAAO,EACL,OAAO,EACP,WAAW,EACX,QAAQ,EACR,MAAM,EACN,aAAa,EACb,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAStB,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGnE,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC"}

package/dist/ansi/palette.d.ts

@@ -0,0 +1,79 @@
+import type { AnsiColor } from './sgr.js';
+/** A colour as a packed `0xRRGGBB`, the way the arithmetic below wants it. */
+export type Rgb = number;
+/**
+ * The standard 16 — xterm's own defaults, which is what an application's
+ * colour choices were made against.
+ */
+export declare const ANSI_16: readonly Rgb[];
+export interface AnsiPalette {
+    /** 256 entries: the 16 ANSI, the 6×6×6 cube, the 24 greys. */
+    readonly colors: Int32Array;
+    readonly foreground: Rgb;
+    readonly background: Rgb;
+    /** Bold promotes ANSI 0–7 to 8–15, which is how most colour schemes were
+     *  designed to be read. */
+    readonly brightBold: boolean;
+}
+export interface AnsiPaletteOptions {
+    /** The default ink. A CSS colour; anything unparseable keeps the default
+     *  rather than painting something arbitrary. */
+    foreground?: string;
+    background?: string;
+    /** ANSI 0–15, sparse — an entry left out keeps the standard colour. */
+    palette?: readonly (string | undefined)[];
+    /** Default true. */
+    brightBold?: boolean;
+}
+/**
+ * `#rgb`, `#rrggbb`, `rgb(…)` and the handful of names above.
+ *
+ * `null` for anything else, and every caller keeps its default rather than
+ * guessing — a theme token that did not resolve should look like the theme,
+ * not like black.
+ */
+export declare function parseCssColor(value: string | undefined): Rgb | null;
+/** `#rrggbb`, which is what a `<richtext>` run takes. */
+export declare function cssColor(rgb: Rgb): string;
+/** Mix towards `b`, `t` in 0..1 — what `dim` uses. */
+export declare function mixRgb(a: Rgb, b: Rgb, t: number): Rgb;
+/**
+ * The 256-colour palette.
+ *
+ * 0–15 come from `palette` where it has an entry and from the standard set
+ * where it does not; 16–231 are the 6×6×6 cube and 232–255 the 24 greys, both
+ * fixed by the protocol rather than by taste.
+ */
+export declare function ansiPalette(options?: AnsiPaletteOptions): AnsiPalette;
+/** What a span is actually painted in. */
+export interface ResolvedAnsiColors {
+    fg: string;
+    /**
+     * Absent means "whatever is behind" — the page, the block's own fill.
+     *
+     * The distinction is the whole reason a log can sit inside a document: text
+     * in the default background must not paint a rectangle, or every line
+     * becomes an opaque strip and the block stops being part of the page.
+     */
+    bg?: string;
+}
+/** The attribute slice the resolution reads — the six fields of an
+ *  `AnsiAttrs` that can change a colour, and nothing else. */
+export interface AnsiColorAttrs {
+    readonly fg?: AnsiColor;
+    readonly bg?: AnsiColor;
+    readonly bold?: boolean;
+    readonly dim?: boolean;
+    readonly inverse?: boolean;
+    readonly conceal?: boolean;
+}
+/**
+ * A span's two colours, after every transform that can change them.
+ *
+ * The order is the one every terminal agrees on, and it is the same order
+ * `../terminal/vt/colors.ts` applies to a live cell — bright-bold, dim,
+ * inverse, conceal — so a capture and the program that produced it look the
+ * same in one window.
+ */
+export declare function resolveAnsiColors(attrs: AnsiColorAttrs, palette: AnsiPalette): ResolvedAnsiColors;
+//# sourceMappingURL=palette.d.ts.map

package/dist/ansi/palette.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"palette.d.ts","sourceRoot":"","sources":["../../src/ansi/palette.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,8EAA8E;AAC9E,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC;AAEzB;;;GAGG;AACH,eAAO,MAAM,OAAO,EAAE,SAAS,GAAG,EAIjC,CAAC;AAEF,MAAM,WAAW,WAAW;IAC1B,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC;IACzB;+BAC2B;IAC3B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAkB;IACjC;oDACgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,OAAO,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,CAAC;IAC1C,oBAAoB;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAgBD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,GAAG,GAAG,IAAI,CAqCnE;AAED,yDAAyD;AACzD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAEzC;AAED,sDAAsD;AACtD,wBAAgB,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,GAAG,GAAG,CAOrD;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,WAAW,CAsBzE;AAED,0CAA0C;AAC1C,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX;;;;;;OAMG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED;8DAC8D;AAC9D,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC;IACxB,QAAQ,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAQD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,WAAW,GACnB,kBAAkB,CA4BpB"}

package/dist/ansi/palette.js

@@ -0,0 +1,155 @@
+/**
+ * The standard 16 — xterm's own defaults, which is what an application's
+ * colour choices were made against.
+ */
+export const ANSI_16 = [
+    0x000000, 0xcd0000, 0x00cd00, 0xcdcd00, 0x0000ee, 0xcd00cd, 0x00cdcd,
+    0xe5e5e5, 0x7f7f7f, 0xff0000, 0x00ff00, 0xffff00, 0x5c5cff, 0xff00ff,
+    0x00ffff, 0xffffff,
+];
+/** The names a terminal colour prop plausibly carries. Not CSS's whole list. */
+const NAMED = {
+    black: 0x000000,
+    white: 0xffffff,
+    red: 0xff0000,
+    green: 0x008000,
+    blue: 0x0000ff,
+    yellow: 0xffff00,
+    cyan: 0x00ffff,
+    magenta: 0xff00ff,
+    gray: 0x808080,
+    grey: 0x808080,
+};
+/**
+ * `#rgb`, `#rrggbb`, `rgb(…)` and the handful of names above.
+ *
+ * `null` for anything else, and every caller keeps its default rather than
+ * guessing — a theme token that did not resolve should look like the theme,
+ * not like black.
+ */
+export function parseCssColor(value) {
+    if (!value)
+        return null;
+    const text = value.trim().toLowerCase();
+    if (text.startsWith('#')) {
+        const hex = text.slice(1);
+        if (hex.length === 3 || hex.length === 4) {
+            const r = Number.parseInt(hex[0] + hex[0], 16);
+            const g = Number.parseInt(hex[1] + hex[1], 16);
+            const b = Number.parseInt(hex[2] + hex[2], 16);
+            if (Number.isNaN(r + g + b))
+                return null;
+            return (r << 16) | (g << 8) | b;
+        }
+        if (hex.length === 6 || hex.length === 8) {
+            const n = Number.parseInt(hex.slice(0, 6), 16);
+            return Number.isNaN(n) ? null : n;
+        }
+        return null;
+    }
+    const fn = /^rgba?\(([^)]+)\)$/.exec(text);
+    if (fn) {
+        const parts = fn[1].split(/[\s,/]+/).filter(Boolean);
+        if (parts.length < 3)
+            return null;
+        const channel = (part) => {
+            const n = part.endsWith('%')
+                ? (Number.parseFloat(part) * 255) / 100
+                : Number.parseFloat(part);
+            return Number.isFinite(n)
+                ? Math.max(0, Math.min(255, Math.round(n)))
+                : -1;
+        };
+        const r = channel(parts[0]);
+        const g = channel(parts[1]);
+        const b = channel(parts[2]);
+        if (r < 0 || g < 0 || b < 0)
+            return null;
+        return (r << 16) | (g << 8) | b;
+    }
+    return NAMED[text] ?? null;
+}
+/** `#rrggbb`, which is what a `<richtext>` run takes. */
+export function cssColor(rgb) {
+    return `#${(rgb & 0xffffff).toString(16).padStart(6, '0')}`;
+}
+/** Mix towards `b`, `t` in 0..1 — what `dim` uses. */
+export function mixRgb(a, b, t) {
+    const lerp = (shift) => {
+        const av = (a >> shift) & 0xff;
+        const bv = (b >> shift) & 0xff;
+        return Math.round(av + (bv - av) * t);
+    };
+    return (lerp(16) << 16) | (lerp(8) << 8) | lerp(0);
+}
+/**
+ * The 256-colour palette.
+ *
+ * 0–15 come from `palette` where it has an entry and from the standard set
+ * where it does not; 16–231 are the 6×6×6 cube and 232–255 the 24 greys, both
+ * fixed by the protocol rather than by taste.
+ */
+export function ansiPalette(options = {}) {
+    const colors = new Int32Array(256);
+    for (let i = 0; i < 16; i++) {
+        colors[i] = parseCssColor(options.palette?.[i]) ?? ANSI_16[i];
+    }
+    const cube = [0, 95, 135, 175, 215, 255];
+    for (let i = 0; i < 216; i++) {
+        const r = cube[Math.floor(i / 36) % 6];
+        const g = cube[Math.floor(i / 6) % 6];
+        const b = cube[i % 6];
+        colors[16 + i] = (r << 16) | (g << 8) | b;
+    }
+    for (let i = 0; i < 24; i++) {
+        const v = 8 + i * 10;
+        colors[232 + i] = (v << 16) | (v << 8) | v;
+    }
+    return {
+        colors,
+        foreground: parseCssColor(options.foreground) ?? 0xe6e6e6,
+        background: parseCssColor(options.background) ?? 0x101014,
+        brightBold: options.brightBold ?? true,
+    };
+}
+function rgbOf(color, palette) {
+    return color.kind === 'rgb'
+        ? color.value & 0xffffff
+        : palette.colors[Math.max(0, Math.min(255, color.index))];
+}
+/**
+ * A span's two colours, after every transform that can change them.
+ *
+ * The order is the one every terminal agrees on, and it is the same order
+ * `../terminal/vt/colors.ts` applies to a live cell — bright-bold, dim,
+ * inverse, conceal — so a capture and the program that produced it look the
+ * same in one window.
+ */
+export function resolveAnsiColors(attrs, palette) {
+    const fgColor = attrs.fg;
+    const bgColor = attrs.bg;
+    let fg = fgColor ? rgbOf(fgColor, palette) : palette.foreground;
+    let bg = bgColor ? rgbOf(bgColor, palette) : palette.background;
+    /** Nothing has claimed the background yet, so the surface keeps it. */
+    let bare = bgColor === undefined;
+    if (attrs.bold &&
+        palette.brightBold &&
+        fgColor?.kind === 'ansi' &&
+        fgColor.index < 8) {
+        fg = palette.colors[fgColor.index + 8];
+    }
+    if (attrs.dim)
+        fg = mixRgb(fg, bg, 0.5);
+    if (attrs.inverse) {
+        const swap = fg;
+        fg = bg;
+        bg = swap;
+        // An inverted run paints its background even when neither colour was set:
+        // that is the entire visible effect of SGR 7.
+        bare = false;
+    }
+    if (attrs.conceal)
+        fg = bg;
+    return bare ? { fg: cssColor(fg) } : { fg: cssColor(fg), bg: cssColor(bg) };
+}
+//# sourceMappingURL=palette.js.map

package/dist/ansi/palette.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"palette.js","sourceRoot":"","sources":["../../src/ansi/palette.ts"],"names":[],"mappings":"AAmBA;;;GAGG;AACH,MAAM,CAAC,MAAM,OAAO,GAAmB;IACrC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ;IACpE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ;IACpE,QAAQ,EAAE,QAAQ;CACnB,CAAC;AAuBF,gFAAgF;AAChF,MAAM,KAAK,GAAkC;IAC3C,KAAK,EAAE,QAAQ;IACf,KAAK,EAAE,QAAQ;IACf,GAAG,EAAE,QAAQ;IACb,KAAK,EAAE,QAAQ;IACf,IAAI,EAAE,QAAQ;IACd,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,QAAQ;IACjB,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,QAAQ;CACf,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,KAAyB;IACrD,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACxC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzC,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAE,GAAG,GAAG,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,CAAC;YACjD,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAE,GAAG,GAAG,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,CAAC;YACjD,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAE,GAAG,GAAG,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,CAAC;YACjD,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBAAE,OAAO,IAAI,CAAC;YACzC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QAClC,CAAC;QACD,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzC,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC/C,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACpC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,EAAE,GAAG,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3C,IAAI,EAAE,EAAE,CAAC;QACP,MAAM,KAAK,GAAG,EAAE,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACtD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QAClC,MAAM,OAAO,GAAG,CAAC,IAAY,EAAU,EAAE;YACvC,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;gBAC1B,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG;gBACvC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YAC5B,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;gBACvB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC3C,CAAC,CAAC,CAAC,CAAC,CAAC;QACT,CAAC,CAAC;QACF,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC;QAC7B,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC;QAC7B,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC;QAC7B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QACzC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;AAC7B,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,QAAQ,CAAC,GAAQ;IAC/B,OAAO,IAAI,CAAC,GAAG,GAAG,QAAQ,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AAC9D,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,MAAM,CAAC,CAAM,EAAE,CAAM,EAAE,CAAS;IAC9C,MAAM,IAAI,GAAG,CAAC,KAAa,EAAU,EAAE;QACrC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC;QAC/B,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC;QAC/B,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxC,CAAC,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;AACrD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,OAAO,GAAuB,EAAE;IAC1D,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC;IACnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,MAAM,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAE,CAAC;IACjE,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IACzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7B,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAE,CAAC;QACxC,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;QACvC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;QACvB,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IAC5C,CAAC;IACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;QACrB,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO;QACL,MAAM;QACN,UAAU,EAAE,aAAa,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,QAAQ;QACzD,UAAU,EAAE,aAAa,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,QAAQ;QACzD,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,IAAI;KACvC,CAAC;AACJ,CAAC;AA0BD,SAAS,KAAK,CAAC,KAAgB,EAAE,OAAoB;IACnD,OAAO,KAAK,CAAC,IAAI,KAAK,KAAK;QACzB,CAAC,CAAC,KAAK,CAAC,KAAK,GAAG,QAAQ;QACxB,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC;AAC/D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAqB,EACrB,OAAoB;IAEpB,MAAM,OAAO,GAAG,KAAK,CAAC,EAAE,CAAC;IACzB,MAAM,OAAO,GAAG,KAAK,CAAC,EAAE,CAAC;IACzB,IAAI,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;IAChE,IAAI,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;IAChE,uEAAuE;IACvE,IAAI,IAAI,GAAG,OAAO,KAAK,SAAS,CAAC;IAEjC,IACE,KAAK,CAAC,IAAI;QACV,OAAO,CAAC,UAAU;QAClB,OAAO,EAAE,IAAI,KAAK,MAAM;QACxB,OAAO,CAAC,KAAK,GAAG,CAAC,EACjB,CAAC;QACD,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,GAAG,CAAC,CAAE,CAAC;IAC1C,CAAC;IACD,IAAI,KAAK,CAAC,GAAG;QAAE,EAAE,GAAG,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;IACxC,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,MAAM,IAAI,GAAG,EAAE,CAAC;QAChB,EAAE,GAAG,EAAE,CAAC;QACR,EAAE,GAAG,IAAI,CAAC;QACV,0EAA0E;QAC1E,8CAA8C;QAC9C,IAAI,GAAG,KAAK,CAAC;IACf,CAAC;IACD,IAAI,KAAK,CAAC,OAAO;QAAE,EAAE,GAAG,EAAE,CAAC;IAE3B,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;AAC9E,CAAC"}

package/dist/ansi/parse.d.ts

@@ -0,0 +1,114 @@
+import type { AnsiAttrs } from './sgr.js';
+/** One run of characters sharing every attribute. */
+export type AnsiSpan = AnsiAttrs & {
+    readonly text: string;
+};
+/** One line of the capture. `text` is the spans concatenated. */
+export interface AnsiLine {
+    readonly spans: readonly AnsiSpan[];
+    readonly text: string;
+}
+/** What a capture reduces to. A plain immutable value — snapshot it, keep it,
+ *  hand it to React. */
+export interface AnsiDocument {
+    readonly lines: readonly AnsiLine[];
+    /** The last title the capture set, through OSC 0 or OSC 2. */
+    readonly title?: string;
+    /** The stream addressed the cursor absolutely, scrolled a region, or
+     *  entered the alternate screen: these bytes wanted a grid. */
+    readonly needsScreen: boolean;
+    /** What could not be honoured, by name, with counts. */
+    readonly dropped: Readonly<Record<string, number>>;
+    /** Lines evicted by `maxLines`, oldest first. */
+    readonly truncated: number;
+    /** The resume point. Pass the document back as `from` to continue. */
+    readonly state: AnsiState;
+}
+export type AnsiInput = string | Uint8Array | readonly (string | Uint8Array)[];
+export interface ParseAnsiOptions {
+    /** Continue a previous parse rather than starting one. A partial escape
+     *  sequence or a half-arrived UTF-8 character at the boundary is held, not
+     *  mangled — the same rule `<Markdown>` follows for an unterminated tail. */
+    from?: AnsiDocument | AnsiState;
+    /** Default 8, the terminal's. */
+    tabWidth?: number;
+    /** Keep only the last N lines, dropping from the front. Unbounded by
+     *  default: the app read the file, so the app decided how big it is. */
+    maxLines?: number;
+}
+/**
+ * A capture, reduced.
+ *
+ * ```ts
+ * const doc = parseAnsi(await readFile('build.log'));
+ * doc.lines.map((line) => line.text);
+ * ```
+ */
+export declare function parseAnsi(data: AnsiInput, options?: ParseAnsiOptions): AnsiDocument;
+/** The capture's text with every escape sequence resolved away. What a
+ *  round-trip test compares against, and what a plain-text export wants. */
+export declare function stripAnsi(data: AnsiInput, options?: ParseAnsiOptions): string;
+/**
+ * The reducer's state: the escape machine, the current attributes, the line
+ * being written, and the lines already finished.
+ *
+ * Held across calls so an append costs the appended bytes. Completed lines
+ * are never mutated, so an older `AnsiDocument` snapshot stays valid after
+ * the next `write()`.
+ */
+export declare class AnsiState {
+    private readonly _tabWidth;
+    private readonly _maxLines;
+    private _style;
+    private _decoder;
+    private _lines;
+    private _truncated;
+    private _chars;
+    private _attrs;
+    private _col;
+    private _lastPrinted;
+    private _joinNext;
+    private _title;
+    private _needsScreen;
+    private _dropped;
+    private _phase;
+    private _params;
+    private _group;
+    private _digits;
+    private _prefix;
+    private _string;
+    private _stringEsc;
+    constructor(options?: {
+        tabWidth?: number;
+        maxLines?: number;
+    });
+    /** Feed the next chunk. Bytes are preferred — see `./utf8.ts`. */
+    write(data: AnsiInput): void;
+    /** The document as it stands. Cheap: only the line still being written is
+     *  rebuilt, and the finished ones are shared by reference. */
+    snapshot(): AnsiDocument;
+    private _feed;
+    private _control;
+    private _step;
+    private _escape;
+    private _csi;
+    private _value;
+    private _dispatch;
+    private _private;
+    private _stringByte;
+    private _endString;
+    private _print;
+    private _put;
+    private _newline;
+    private _pushLine;
+    private _eraseLine;
+    private _eraseChars;
+    private _deleteChars;
+    private _insertBlanks;
+    private _drop;
+    /** Dropped, and it is the kind of sequence that means the capture wanted a
+     *  real screen. Both, always: `needsScreen` says which renderer to use and
+     *  `dropped` says what it cost to use the other one. */
+    private _screen;
+}
+//# sourceMappingURL=parse.d.ts.map

package/dist/ansi/parse.d.ts.map

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