@sagmans/dsh-tui 0.6.0 → 0.7.0

package/lib/terminal-text/sgr.js

@@ -0,0 +1,203 @@
+/**
+ * The style state a renderer models: which attributes are on, which colour each
+ * names, and the sequences that move one state to the next.
+ *
+ * Apart from the grammar that reads those sequences and the renderer that emits
+ * rows, because which attributes and colours a terminal may set is a policy
+ * this surface owns, not a property of either.
+ */
+import { sgrBackgroundPrefix, sgrPrefix } from "../theme-capability.js";
+import { ESC, RESET, parseSgrParams } from "./scan.js";
+export const CSI = `${ESC}[`;
+/** The attributes a run may carry, in the order they are emitted. */
+const ATTRIBUTES = ['bold', 'dim', 'italic', 'underline', 'inverse', 'strike'];
+const ATTRIBUTE_ON = {
+    bold: `${CSI}1m`,
+    dim: `${CSI}2m`,
+    italic: `${CSI}3m`,
+    underline: `${CSI}4m`,
+    inverse: `${CSI}7m`,
+    strike: `${CSI}9m`,
+};
+const ATTRIBUTE_OFF = {
+    bold: `${CSI}22m`,
+    dim: `${CSI}22m`,
+    italic: `${CSI}23m`,
+    underline: `${CSI}24m`,
+    inverse: `${CSI}27m`,
+    strike: `${CSI}29m`,
+};
+const SGR_ATTRIBUTE_ON = { 1: 'bold', 2: 'dim', 3: 'italic', 4: 'underline', 7: 'inverse', 9: 'strike' };
+const SGR_ATTRIBUTE_OFF = {
+    21: ['bold', 'dim'],
+    22: ['bold', 'dim'],
+    23: ['italic'],
+    24: ['underline'],
+    27: ['inverse'],
+    29: ['strike'],
+};
+const FIRST_FG_SLOT = 30;
+const LAST_FG_SLOT = 37;
+const FIRST_BRIGHT_FG_SLOT = 90;
+const LAST_BRIGHT_FG_SLOT = 97;
+const FIRST_BG_SLOT = 40;
+const LAST_BG_SLOT = 47;
+const FIRST_BRIGHT_BG_SLOT = 100;
+const LAST_BRIGHT_BG_SLOT = 107;
+const FG_DEFAULT = 39;
+const BG_DEFAULT = 49;
+const EXTENDED_FG = 38;
+const EXTENDED_BG = 48;
+const EXTENDED_INDEXED = 5;
+const EXTENDED_RGB = 2;
+const RGB_COMPONENTS = 3;
+const HEX_PREFIX = '#';
+const HEX_PAD = 2;
+const COLOUR_MAX = 0xff;
+const BRIGHT_OFFSET = 8;
+const GROUND_FG = `${CSI}${FG_DEFAULT}m`;
+const GROUND_BG = `${CSI}${BG_DEFAULT}m`;
+export const GROUND = { attributes: 0 };
+function withAttributes(style, on, off) {
+    let attributes = style.attributes;
+    if (off !== undefined)
+        for (const attribute of off)
+            attributes &= ~(1 << ATTRIBUTES.indexOf(attribute));
+    if (on !== undefined)
+        attributes |= 1 << ATTRIBUTES.indexOf(on);
+    return attributes === style.attributes ? style : { ...style, attributes };
+}
+function hasAttribute(style, attribute) {
+    return (style.attributes & (1 << ATTRIBUTES.indexOf(attribute))) !== 0;
+}
+/**
+ * Build the encoder for one colour budget.
+ *
+ * The element's own colour is the ground state rather than a reset, because a
+ * tool that ends a coloured run must not clear the colour the card drew it in;
+ * a full reset is never emitted, so nothing outside the run is disturbed.
+ */
+export function encoder(color, base) {
+    if (color === 'none')
+        return { between: () => '' };
+    const groundCodes = (style) => {
+        let out = '';
+        for (const attribute of ATTRIBUTES)
+            if (hasAttribute(style, attribute))
+                out += ATTRIBUTE_OFF[attribute];
+        if (style.fg !== undefined)
+            out += GROUND_FG + base;
+        if (style.bg !== undefined)
+            out += GROUND_BG + base;
+        return out;
+    };
+    return {
+        between(previous, next) {
+            if (previous === next)
+                return '';
+            let out = '';
+            for (const attribute of ATTRIBUTES) {
+                if (hasAttribute(previous, attribute) && !hasAttribute(next, attribute))
+                    out += ATTRIBUTE_OFF[attribute];
+            }
+            for (const attribute of ATTRIBUTES) {
+                if (!hasAttribute(previous, attribute) && hasAttribute(next, attribute))
+                    out += ATTRIBUTE_ON[attribute];
+            }
+            if (next.fg !== previous.fg)
+                out += next.fg ?? GROUND_FG + base;
+            if (next.bg !== previous.bg)
+                out += next.bg ?? GROUND_BG + base;
+            return out;
+        },
+    };
+}
+function colourFor(params, at, color) {
+    const kind = params[at + 1];
+    if (kind === EXTENDED_INDEXED) {
+        const index = params[at + 2];
+        if (index === undefined)
+            return { next: params.length };
+        const code = params[at] === EXTENDED_FG ? sgrPrefix(index, color) : sgrBackgroundPrefix(index, color);
+        return { code: code === '' ? undefined : code, next: at + 3 };
+    }
+    if (kind === EXTENDED_RGB) {
+        const r = params[at + 2];
+        const g = params[at + 3];
+        const b = params[at + 4];
+        const spec = r === undefined || g === undefined || b === undefined ? undefined : rgbSpec(r, g, b);
+        if (spec === undefined)
+            return { next: at + 2 + RGB_COMPONENTS };
+        const code = params[at] === EXTENDED_FG ? sgrPrefix(spec, color) : sgrBackgroundPrefix(spec, color);
+        return { code: code === '' ? undefined : code, next: at + 2 + RGB_COMPONENTS };
+    }
+    return { next: at + 1 };
+}
+/** Apply an SGR sequence to the state a cell is written with. */
+export function applySgr(style, params, color) {
+    let next = style;
+    let at = 0;
+    while (at < params.length) {
+        const param = params[at] ?? RESET;
+        if (param === RESET) {
+            next = GROUND;
+            at += 1;
+            continue;
+        }
+        const on = SGR_ATTRIBUTE_ON[param];
+        if (on !== undefined) {
+            next = withAttributes(next, on, undefined);
+            at += 1;
+            continue;
+        }
+        const off = SGR_ATTRIBUTE_OFF[param];
+        if (off !== undefined) {
+            next = withAttributes(next, undefined, off);
+            at += 1;
+            continue;
+        }
+        if (param === EXTENDED_FG || param === EXTENDED_BG) {
+            const extended = colourFor(params, at, color);
+            if (extended.next <= at)
+                break;
+            next = extended.code === undefined
+                ? { ...next, ...(param === EXTENDED_FG ? { fg: undefined } : { bg: undefined }) }
+                : { ...next, ...(param === EXTENDED_FG ? { fg: extended.code } : { bg: extended.code }) };
+            at = extended.next;
+            continue;
+        }
+        if (param >= FIRST_FG_SLOT && param <= LAST_FG_SLOT) {
+            next = { ...next, fg: slotColour(param - FIRST_FG_SLOT, color, 'fg') };
+        }
+        else if (param >= FIRST_BRIGHT_FG_SLOT && param <= LAST_BRIGHT_FG_SLOT) {
+            next = { ...next, fg: slotColour(param - FIRST_BRIGHT_FG_SLOT + BRIGHT_OFFSET, color, 'fg') };
+        }
+        else if (param === FG_DEFAULT) {
+            next = { ...next, fg: undefined };
+        }
+        else if (param >= FIRST_BG_SLOT && param <= LAST_BG_SLOT) {
+            next = { ...next, bg: slotColour(param - FIRST_BG_SLOT, color, 'bg') };
+        }
+        else if (param >= FIRST_BRIGHT_BG_SLOT && param <= LAST_BRIGHT_BG_SLOT) {
+            next = { ...next, bg: slotColour(param - FIRST_BRIGHT_BG_SLOT + BRIGHT_OFFSET, color, 'bg') };
+        }
+        else if (param === BG_DEFAULT) {
+            next = { ...next, bg: undefined };
+        }
+        at += 1;
+    }
+    return next;
+}
+/** The hex spec the colour helpers take, or nothing when a tool sent a component a colour cannot hold. */
+function rgbSpec(r, g, b) {
+    for (const value of [r, g, b]) {
+        if (!Number.isInteger(value) || value < 0 || value > COLOUR_MAX)
+            return undefined;
+    }
+    return HEX_PREFIX + [r, g, b].map(value => value.toString(16).padStart(HEX_PAD, '0')).join('');
+}
+function slotColour(slot, color, layer) {
+    const code = layer === 'fg' ? sgrPrefix(slot, color) : sgrBackgroundPrefix(slot, color);
+    return code === '' ? undefined : code;
+}
+//# sourceMappingURL=sgr.js.map

package/lib/terminal-text/sgr.js.map

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

package/lib/terminal-text.d.ts

@@ -21,7 +21,7 @@
  * string would make its width arithmetic swallow the text after it), so a
  * sequence that is not SGR must be gone before any width is measured.
  */
-import { type ColourMode } from './theme-capability.ts';
+import type { ColourMode } from './theme-capability.ts';
 /** Columns between tab stops: the POSIX default, and what every terminal still uses. */
 export declare const TAB_STOP = 8;
 /** Whether a tab is drawn on its stop, or kept for a buffer that will hold it. */

package/lib/terminal-text.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"terminal-text.d.ts","sourceRoot":"","sources":["../src/terminal-text.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,EAAkC,KAAK,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAEvF,wFAAwF;AACxF,eAAO,MAAM,QAAQ,IAAI,CAAA;AAEzB,kFAAkF;AAClF,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAA;AAEzC,MAAM,WAAW,iBAAiB;IAChC,yFAAyF;IACzF,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACpC,QAAQ,CAAC,GAAG,CAAC,EAAE,SAAS,GAAG,SAAS,CAAA;CACrC;AAED,MAAM,WAAW,iBAAiB;IAChC,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;IAC1B,yFAAyF;IACzF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACrC;AAuRD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,MAAM,CAkCvF;AAsJD;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,MAAM,CA2ElF;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAwBvE"}
+{"version":3,"file":"terminal-text.d.ts","sourceRoot":"","sources":["../src/terminal-text.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAIvD,wFAAwF;AACxF,eAAO,MAAM,QAAQ,IAAI,CAAA;AAEzB,kFAAkF;AAClF,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAA;AAEzC,MAAM,WAAW,iBAAiB;IAChC,yFAAyF;IACzF,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACpC,QAAQ,CAAC,GAAG,CAAC,EAAE,SAAS,GAAG,SAAS,CAAA;CACrC;AAED,MAAM,WAAW,iBAAiB;IAChC,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;IAC1B,yFAAyF;IACzF,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACrC;AA8BD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,MAAM,CAkCvF;AASD;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,MAAM,CA2ElF;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAwBvE"}

package/lib/terminal-text.js

@@ -22,245 +22,11 @@
  * sequence that is not SGR must be gone before any width is measured.
  */
 import { visibleWidth } from '@earendil-works/pi-tui';
-import { sgrBackgroundPrefix, sgrPrefix } from "./theme-capability.js";
+import { NEEDS_READING, scan, spellControls } from "./terminal-text/scan.js";
+import { GROUND, applySgr, encoder } from "./terminal-text/sgr.js";
 /** Columns between tab stops: the POSIX default, and what every terminal still uses. */
 export const TAB_STOP = 8;
-const ESC = '\u001b';
-const CSI = `${ESC}[`;
-const REPLACEMENT = '\uFFFD';
-const C0_PREFIX = '\\x';
-const UNICODE_PREFIX = '\\u';
-const HEX2 = 2;
-const HEX4 = 4;
-const LAST_C0 = 0x1f;
-const TAB = 0x09;
-const LINE_FEED = 0x0a;
-const CARRIAGE_RETURN = 0x0d;
-const BACKSPACE = 0x08;
-const DELETE = 0x7f;
-const FIRST_C1 = 0x80;
-const LAST_C1 = 0x9f;
-const FIRST_SURROGATE = 0xd800;
-const LAST_SURROGATE = 0xdfff;
-/** The bytes a text fragment cannot be drawn with: they are either sequences to read or marks to spell. */
-const NEEDS_READING = /[\u0000-\u0009\u000B-\u001F\u007F-\u009F\u061C\u200E\u200F\u2028\u2029\u202A-\u202E\u2066-\u2069\uD800-\uDFFF]/u;
-/** Directional overrides and isolates, which reorder a row without drawing anything. */
-const BIDI_CONTROLS = new Set([0x202a, 0x202b, 0x202c, 0x202d, 0x202e, 0x2066, 0x2067, 0x2068, 0x2069]);
-const LINE_SEPARATOR = 0x2028;
-const PARAGRAPH_SEPARATOR = 0x2029;
-const ARABIC_LETTER_MARK = 0x061c;
-const LEFT_TO_RIGHT_MARK = 0x200e;
-const RIGHT_TO_LEFT_MARK = 0x200f;
 const GRAPHEMES = new Intl.Segmenter(undefined, { granularity: 'grapheme' });
-/** The SGR final byte, and the parameter bytes a sequence may carry before it. */
-const SGR_FINAL = 'm';
-const CSI_PARAMETER_LAST = 0x3f;
-const CSI_INTERMEDIATE_FIRST = 0x20;
-const CSI_INTERMEDIATE_LAST = 0x2f;
-const CSI_FINAL_FIRST = 0x40;
-const CSI_FINAL_LAST = 0x7e;
-const ESCAPE_FINAL_FIRST = 0x30;
-const OSC_INTRODUCER = ']';
-const STRING_INTRODUCERS = new Set(['P', 'X', '^', '_']);
-const STRING_END = '\u0007';
-/** The attributes a run may carry, in the order they are emitted. */
-const ATTRIBUTES = ['bold', 'dim', 'italic', 'underline', 'inverse', 'strike'];
-const ATTRIBUTE_ON = {
-    bold: `${CSI}1m`,
-    dim: `${CSI}2m`,
-    italic: `${CSI}3m`,
-    underline: `${CSI}4m`,
-    inverse: `${CSI}7m`,
-    strike: `${CSI}9m`,
-};
-const ATTRIBUTE_OFF = {
-    bold: `${CSI}22m`,
-    dim: `${CSI}22m`,
-    italic: `${CSI}23m`,
-    underline: `${CSI}24m`,
-    inverse: `${CSI}27m`,
-    strike: `${CSI}29m`,
-};
-const SGR_ATTRIBUTE_ON = { 1: 'bold', 2: 'dim', 3: 'italic', 4: 'underline', 7: 'inverse', 9: 'strike' };
-const SGR_ATTRIBUTE_OFF = {
-    21: ['bold', 'dim'],
-    22: ['bold', 'dim'],
-    23: ['italic'],
-    24: ['underline'],
-    27: ['inverse'],
-    29: ['strike'],
-};
-const FIRST_FG_SLOT = 30;
-const LAST_FG_SLOT = 37;
-const FIRST_BRIGHT_FG_SLOT = 90;
-const LAST_BRIGHT_FG_SLOT = 97;
-const FIRST_BG_SLOT = 40;
-const LAST_BG_SLOT = 47;
-const FIRST_BRIGHT_BG_SLOT = 100;
-const LAST_BRIGHT_BG_SLOT = 107;
-const FG_DEFAULT = 39;
-const BG_DEFAULT = 49;
-const EXTENDED_FG = 38;
-const EXTENDED_BG = 48;
-const EXTENDED_INDEXED = 5;
-const EXTENDED_RGB = 2;
-const RGB_COMPONENTS = 3;
-const HEX_PREFIX = '#';
-const HEX_PAD = 2;
-const COLOUR_MAX = 0xff;
-const BRIGHT_OFFSET = 8;
-const RESET = 0;
-const GROUND_FG = `${CSI}${FG_DEFAULT}m`;
-const GROUND_BG = `${CSI}${BG_DEFAULT}m`;
-function escapeCode(prefix, code, digits) {
-    return prefix + code.toString(16).toUpperCase().padStart(digits, '0');
-}
-/** Whether a code point is a mark this module spells instead of drawing. */
-function isSpelledControl(code) {
-    if (code <= LAST_C0 || code === DELETE)
-        return true;
-    if (code >= FIRST_C1 && code <= LAST_C1)
-        return true;
-    return BIDI_CONTROLS.has(code) || code === LINE_SEPARATOR || code === PARAGRAPH_SEPARATOR || code === ARABIC_LETTER_MARK || code === LEFT_TO_RIGHT_MARK || code === RIGHT_TO_LEFT_MARK;
-}
-function spelled(code) {
-    if (code <= 0xff)
-        return escapeCode(C0_PREFIX, code, HEX2);
-    return escapeCode(UNICODE_PREFIX, code, HEX4);
-}
-/** Every character of a sequence that is a control, spelled; the rest of it is printable. */
-function spellControls(raw) {
-    let out = '';
-    for (const character of raw) {
-        const code = character.codePointAt(0) ?? 0;
-        out += isSpelledControl(code) ? spelled(code) : character;
-    }
-    return out;
-}
-function isCsiFinal(code) {
-    return code >= CSI_FINAL_FIRST && code <= CSI_FINAL_LAST;
-}
-/**
- * Read one escape sequence at `at`.
- *
- * A string sequence (OSC, DCS, and their siblings) runs to BEL or ST; when its
- * terminator never arrives the sequence is reported incomplete rather than
- * swallowed to the end of the row, because the renderer and the editor want
- * different answers for a truncated sequence and only the scanner knows where
- * it stopped.
- */
-function readEscape(raw, at) {
-    const introducer = raw[at + 1];
-    if (introducer === undefined)
-        return undefined;
-    if (introducer === '[') {
-        let end = at + 2;
-        while (end < raw.length) {
-            const code = raw.charCodeAt(end);
-            if (isCsiFinal(code)) {
-                const source = raw.slice(at, end + 1);
-                if (raw[end] === SGR_FINAL) {
-                    const params = parseSgrParams(source.slice(2, -1));
-                    if (params !== undefined)
-                        return { token: { kind: 'sgr', params }, raw: source };
-                }
-                return { token: { kind: 'consumed' }, raw: source };
-            }
-            if (code > CSI_PARAMETER_LAST && (code < CSI_INTERMEDIATE_FIRST || code > CSI_INTERMEDIATE_LAST)) {
-                // A byte outside the CSI grammar ends the sequence as malformed; the
-                // sequence is consumed so its bytes cannot be drawn as text.
-                return { token: { kind: 'consumed' }, raw: raw.slice(at, end) };
-            }
-            end += 1;
-        }
-        return { token: { kind: 'incomplete' }, raw: raw.slice(at) };
-    }
-    if (introducer === OSC_INTRODUCER || STRING_INTRODUCERS.has(introducer)) {
-        let end = at + 2;
-        while (end < raw.length) {
-            if (raw[end] === STRING_END)
-                return { token: { kind: 'consumed' }, raw: raw.slice(at, end + 1) };
-            if (raw[end] === ESC && raw[end + 1] === '\\')
-                return { token: { kind: 'consumed' }, raw: raw.slice(at, end + 2) };
-            end += 1;
-        }
-        return { token: { kind: 'incomplete' }, raw: raw.slice(at) };
-    }
-    const code = raw.charCodeAt(at + 1);
-    if (code >= ESCAPE_FINAL_FIRST && code <= CSI_FINAL_LAST) {
-        return { token: { kind: 'consumed' }, raw: raw.slice(at, at + 2) };
-    }
-    return undefined;
-}
-/** The parameters of an SGR sequence, or nothing when it uses a form this module does not model. */
-function parseSgrParams(body) {
-    if (body === '')
-        return [RESET];
-    const params = [];
-    for (const part of body.split(';')) {
-        if (!/^[0-9]*$/.test(part))
-            return undefined;
-        params.push(part === '' ? RESET : Number(part));
-    }
-    return params;
-}
-/** Split a text fragment into the pieces a policy draws or spells. */
-function scan(raw) {
-    const pieces = [];
-    let text = '';
-    const flush = () => {
-        if (text === '')
-            return;
-        pieces.push({ token: { kind: 'text' }, raw: text });
-        text = '';
-    };
-    let at = 0;
-    while (at < raw.length) {
-        const code = raw.codePointAt(at) ?? 0;
-        const character = String.fromCodePoint(code);
-        if (code === LINE_FEED) {
-            flush();
-            pieces.push({ token: { kind: 'lineFeed' }, raw: character });
-        }
-        else if (code === TAB) {
-            flush();
-            pieces.push({ token: { kind: 'tab' }, raw: character });
-        }
-        else if (code === CARRIAGE_RETURN) {
-            flush();
-            pieces.push({ token: { kind: 'carriageReturn' }, raw: character });
-        }
-        else if (code === BACKSPACE) {
-            flush();
-            pieces.push({ token: { kind: 'backspace' }, raw: character });
-        }
-        else if (code === 0x1b) {
-            flush();
-            const sequence = readEscape(raw, at);
-            if (sequence === undefined) {
-                pieces.push({ token: { kind: 'control' }, raw: character });
-            }
-            else {
-                pieces.push(sequence);
-                at += sequence.raw.length;
-                continue;
-            }
-        }
-        else if (code >= FIRST_SURROGATE && code <= LAST_SURROGATE) {
-            text += REPLACEMENT;
-        }
-        else if (isSpelledControl(code)) {
-            flush();
-            pieces.push({ token: { kind: 'control' }, raw: character });
-        }
-        else {
-            text += character;
-        }
-        at += character.length;
-    }
-    flush();
-    return pieces;
-}
 /** How many characters a reader sees in this piece, which is what a row budget pays for. */
 function visibleLength(piece) {
     switch (piece.token.kind) {
@@ -330,149 +96,6 @@ export function escapeTerminalText(raw, options = {}) {
     }
     return out;
 }
-const GROUND = { attributes: 0 };
-function withAttributes(style, on, off) {
-    let attributes = style.attributes;
-    if (off !== undefined)
-        for (const attribute of off)
-            attributes &= ~(1 << ATTRIBUTES.indexOf(attribute));
-    if (on !== undefined)
-        attributes |= 1 << ATTRIBUTES.indexOf(on);
-    return attributes === style.attributes ? style : { ...style, attributes };
-}
-function hasAttribute(style, attribute) {
-    return (style.attributes & (1 << ATTRIBUTES.indexOf(attribute))) !== 0;
-}
-/**
- * Build the encoder for one colour budget.
- *
- * The element's own colour is the ground state rather than a reset, because a
- * tool that ends a coloured run must not clear the colour the card drew it in;
- * a full reset is never emitted, so nothing outside the run is disturbed.
- */
-function encoder(color, base) {
-    if (color === 'none')
-        return { between: () => '' };
-    const groundCodes = (style) => {
-        let out = '';
-        for (const attribute of ATTRIBUTES)
-            if (hasAttribute(style, attribute))
-                out += ATTRIBUTE_OFF[attribute];
-        if (style.fg !== undefined)
-            out += GROUND_FG + base;
-        if (style.bg !== undefined)
-            out += GROUND_BG + base;
-        return out;
-    };
-    return {
-        between(previous, next) {
-            if (previous === next)
-                return '';
-            let out = '';
-            for (const attribute of ATTRIBUTES) {
-                if (hasAttribute(previous, attribute) && !hasAttribute(next, attribute))
-                    out += ATTRIBUTE_OFF[attribute];
-            }
-            for (const attribute of ATTRIBUTES) {
-                if (!hasAttribute(previous, attribute) && hasAttribute(next, attribute))
-                    out += ATTRIBUTE_ON[attribute];
-            }
-            if (next.fg !== previous.fg)
-                out += next.fg ?? GROUND_FG + base;
-            if (next.bg !== previous.bg)
-                out += next.bg ?? GROUND_BG + base;
-            return out;
-        },
-    };
-}
-function colourFor(params, at, color) {
-    const kind = params[at + 1];
-    if (kind === EXTENDED_INDEXED) {
-        const index = params[at + 2];
-        if (index === undefined)
-            return { next: params.length };
-        const code = params[at] === EXTENDED_FG ? sgrPrefix(index, color) : sgrBackgroundPrefix(index, color);
-        return { code: code === '' ? undefined : code, next: at + 3 };
-    }
-    if (kind === EXTENDED_RGB) {
-        const r = params[at + 2];
-        const g = params[at + 3];
-        const b = params[at + 4];
-        const spec = r === undefined || g === undefined || b === undefined ? undefined : rgbSpec(r, g, b);
-        if (spec === undefined)
-            return { next: at + 2 + RGB_COMPONENTS };
-        const code = params[at] === EXTENDED_FG ? sgrPrefix(spec, color) : sgrBackgroundPrefix(spec, color);
-        return { code: code === '' ? undefined : code, next: at + 2 + RGB_COMPONENTS };
-    }
-    return { next: at + 1 };
-}
-/** Apply an SGR sequence to the state a cell is written with. */
-function applySgr(style, params, color) {
-    let next = style;
-    let at = 0;
-    while (at < params.length) {
-        const param = params[at] ?? RESET;
-        if (param === RESET) {
-            next = GROUND;
-            at += 1;
-            continue;
-        }
-        const on = SGR_ATTRIBUTE_ON[param];
-        if (on !== undefined) {
-            next = withAttributes(next, on, undefined);
-            at += 1;
-            continue;
-        }
-        const off = SGR_ATTRIBUTE_OFF[param];
-        if (off !== undefined) {
-            next = withAttributes(next, undefined, off);
-            at += 1;
-            continue;
-        }
-        if (param === EXTENDED_FG || param === EXTENDED_BG) {
-            const extended = colourFor(params, at, color);
-            if (extended.next <= at)
-                break;
-            next = extended.code === undefined
-                ? { ...next, ...(param === EXTENDED_FG ? { fg: undefined } : { bg: undefined }) }
-                : { ...next, ...(param === EXTENDED_FG ? { fg: extended.code } : { bg: extended.code }) };
-            at = extended.next;
-            continue;
-        }
-        if (param >= FIRST_FG_SLOT && param <= LAST_FG_SLOT) {
-            next = { ...next, fg: slotColour(param - FIRST_FG_SLOT, color, 'fg') };
-        }
-        else if (param >= FIRST_BRIGHT_FG_SLOT && param <= LAST_BRIGHT_FG_SLOT) {
-            next = { ...next, fg: slotColour(param - FIRST_BRIGHT_FG_SLOT + BRIGHT_OFFSET, color, 'fg') };
-        }
-        else if (param === FG_DEFAULT) {
-            next = { ...next, fg: undefined };
-        }
-        else if (param >= FIRST_BG_SLOT && param <= LAST_BG_SLOT) {
-            next = { ...next, bg: slotColour(param - FIRST_BG_SLOT, color, 'bg') };
-        }
-        else if (param >= FIRST_BRIGHT_BG_SLOT && param <= LAST_BRIGHT_BG_SLOT) {
-            next = { ...next, bg: slotColour(param - FIRST_BRIGHT_BG_SLOT + BRIGHT_OFFSET, color, 'bg') };
-        }
-        else if (param === BG_DEFAULT) {
-            next = { ...next, bg: undefined };
-        }
-        at += 1;
-    }
-    return next;
-}
-/** The hex spec the colour helpers take, or nothing when a tool sent a component a colour cannot hold. */
-function rgbSpec(r, g, b) {
-    for (const value of [r, g, b]) {
-        if (!Number.isInteger(value) || value < 0 || value > COLOUR_MAX)
-            return undefined;
-    }
-    return HEX_PREFIX + [r, g, b].map(value => value.toString(16).padStart(HEX_PAD, '0')).join('');
-}
-function slotColour(slot, color, layer) {
-    const code = layer === 'fg' ? sgrPrefix(slot, color) : sgrBackgroundPrefix(slot, color);
-    return code === '' ? undefined : code;
-}
 /**
  * Draw text as the terminal that produced it would have drawn it.
  *