flagstaff 0.1.0 → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ofri Peretz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,4 +1,22 @@
-# flagstaff
+<p align="center">
+  <a href="https://github.com/ofri-peretz/burgee/tree/main/packages/flagstaff" target="blank">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/ofri-peretz/burgee/main/brand-assets/flagstaff-lockup.svg" />
+      <img src="https://raw.githubusercontent.com/ofri-peretz/burgee/main/brand-assets/flagstaff-lockup-light.svg" alt="flagstaff" width="360" />
+    </picture>
+  </a>
+</p>
+
+<p align="center">
+  The staff the flag flies from — a terminal frame loop that an agent can read.
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/flagstaff"><img src="https://img.shields.io/npm/v/flagstaff?style=flat-square&color=0a6b47" alt="npm version" /></a>
+  <img src="https://img.shields.io/badge/dependencies-roundel-0a6b47?style=flat-square" alt="One dependency: roundel" />
+  <img src="https://img.shields.io/badge/Node.js-24+-green.svg?style=flat-square" alt="Node.js 24+" />
+  <img src="https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square" alt="License: MIT" />
+</p>
 
 ora animates a spinner and, off a terminal, prints frames anyway — `\r` after `\r` into the
 log an agent reads back. Ink fixes the terminal by shipping React and a layout engine.
@@ -316,8 +334,8 @@ never the plugin registry; `flagstaff/plugin` 8.4 KB, of which 2.4 KB is the sch
 `flagstaff/spinner` 9.4 KB; `flagstaff/ora` 46.5 KB — 55.9 KB with roundel counted, against
 ora's own 113.6 KB; `flagstaff/log-update` 29.6 KB, reaching **no package at all**, against
 log-update's own 113.4 KB across sixteen; `flagstaff/boxen` 33.7 KB — 43.0 KB with roundel
-counted, against boxen's own 151.4 KB across fourteen; `flagstaff/cli-table3` 32.9 KB —
-42.3 KB with roundel, against cli-table3's own 161.7 KB across seven. The three façades share `wrap.js` and
+counted, against boxen's own 132.4 KB across nineteen; `flagstaff/cli-table3` 32.9 KB —
+42.3 KB with roundel, against cli-table3's own 106.0 KB across seven. The three façades share `wrap.js` and
 `width.js`, and the first two share `cursor.js`; none reaches another's port, and none
 reaches the core. `sideEffects: false` lets a
 bundler drop what a program does not use. ESM with a `default` condition, so
@@ -333,6 +351,22 @@ Every component, every registered plugin and every border is on the
 which is generated by running them — the static projection beside the animation, in all
 five modes.
 
-Part of the [burgee](https://github.com/ofri-peretz/burgee) family: a CLI on burgee declares
-what it is, roundel carries its colours, flagstaff flies it, caique answers back. Each is
-an independent package; none requires the others.
+## Following along
+
+The intent and design are committed before the code is, so you can read what it will be —
+and argue with it — before it exists:
+
+- [`.sdlc/intents/flagstaff/`](https://github.com/ofri-peretz/burgee/tree/main/.sdlc/intents/flagstaff)
+  — the intent and the design.
+- [Open an issue](https://github.com/ofri-peretz/burgee/issues) if your CLI needs something
+  this list does not cover. That is the cheapest time to say so.
+
+---
+
+Part of the [burgee](https://github.com/ofri-peretz/burgee) family: a CLI on
+[burgee](https://www.npmjs.com/package/burgee) declares what it is,
+[roundel](https://www.npmjs.com/package/roundel) carries its colours, flagstaff flies it, and
+[caique](https://www.npmjs.com/package/caique) answers back. Each is an independent package;
+none requires the others.
+
+MIT © Ofri Peretz — see [LICENSE](./LICENSE).

package/dist/box.js

@@ -1,7 +1,7 @@
+import { width } from 'linegauge';
+import { wrap } from 'linegauge/wrap';
 import { muted } from 'roundel/tokens';
 import { lookupBorder } from './plugin.js';
-import { width } from './width.js';
-import { wrap } from './wrap.js';
 const DEFAULT_WIDTH = 80;
 const DEFAULT_PAD_X = 1;
 const DEFAULT_PAD_Y = 0;

package/dist/boxen.js

@@ -1,6 +1,6 @@
+import { width as stringWidth } from 'linegauge';
+import { wrap as wrapAnsi } from 'linegauge/wrap';
 import chalk from 'roundel/chalk';
-import { width as stringWidth } from './width.js';
-import { wrap as wrapAnsi } from './wrap.js';
 const NEWLINE = '\n';
 const PAD = ' ';
 const NONE = 'none';

package/dist/cli-table3.js

@@ -1,5 +1,5 @@
+import { measure } from 'linegauge';
 import chalk from 'roundel/chalk';
-import { measure } from './width.js';
 const ESC = '\u001B';
 const SGR = /\u001B\[(?:\d*;){0,5}\d*m/g;
 const SGR_CAPTURE = /\u001B\[((?:\d*;){0,5}\d*)m/g;

package/dist/cli.js

@@ -8,6 +8,8 @@ const MODES = ['tty', 'pipe', 'ci', 'json', 'accessible'];
 const ENV = { tty: {}, pipe: {}, ci: { CI: 'true' }, json: {}, accessible: { CLI_ACCESSIBLE: '1' } };
 const LABEL_WIDTH = 12;
 const FRAMES_SHOWN = 3;
+const EXIT_OK = 0;
+const EXIT_RUNTIME = 1;
 const EXIT_USAGE = 2;
 const KNOWN = ['$schema', 'name', 'contract', 'tokens', 'glyphs', 'spinners', 'borders', 'components'];
 const KINDS = ['spinners', 'borders', 'components', 'glyphs', 'tokens'];
@@ -57,7 +59,7 @@ function census(plugin) {
 }
 function refuse(code, message, fix, write) {
     write(`${code}: ${message}\n  fix: ${fix}\n`);
-    return 1;
+    return EXIT_RUNTIME;
 }
 function sampleFor(def) {
     const own = def.sample;
@@ -114,7 +116,7 @@ async function main(argv, write) {
     if (broke.length > 0)
         return refuse('E_COMPONENT_THREW', broke.join('; '), FIX_THREW, write);
     write(`${name}: ok${before.has(name) ? ' (replaces an earlier registration)' : ''}\n`);
-    return 0;
+    return EXIT_OK;
 }
 const [, , command, ...rest] = process.argv;
 const args = command === 'check' ? rest : [command, ...rest].filter((a) => a !== undefined);
@@ -122,5 +124,5 @@ main(args, (s) => process.stdout.write(s)).then((code) => {
     process.exitCode = code;
 }, (e) => {
     process.stderr.write(`${e instanceof Error ? e.message : String(e)}\n`);
-    process.exitCode = 1;
+    process.exitCode = EXIT_RUNTIME;
 });

package/dist/log-update.js

@@ -1,6 +1,6 @@
 import process from 'node:process';
+import { wrap } from 'linegauge/wrap';
 import { HIDE_CURSOR, restoreCursorOnExit, SHOW_CURSOR } from './cursor.js';
-import { wrap } from './wrap.js';
 const CSI = '\u001B[';
 const SYNCHRONIZED_OUTPUT_ENABLE = `${CSI}?2026h`;
 const SYNCHRONIZED_OUTPUT_DISABLE = `${CSI}?2026l`;

package/dist/ora.js

@@ -1,9 +1,9 @@
 import { Buffer } from 'node:buffer';
 import process from 'node:process';
+import { lineCount } from 'linegauge';
 import chalk from 'roundel/chalk';
 import { HIDE_CURSOR, restoreCursorOnExit, SHOW_CURSOR } from './cursor.js';
 import spinnerCorpus from './spinners.json' with { type: 'json' };
-import { lineCount } from './width.js';
 export const spinners = spinnerCorpus;
 function isUnicodeSupported() {
     const { env } = process;

package/dist/table.js

@@ -1,6 +1,6 @@
+import { width } from 'linegauge';
+import { wrap } from 'linegauge/wrap';
 import { heading, muted } from 'roundel/tokens';
-import { width } from './width.js';
-import { wrap } from './wrap.js';
 const DEFAULT_WIDTH = 80;
 const CHROME_PER_COLUMN = 3;
 const CHROME_FIXED = 1;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flagstaff",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "The staff the flag flies from. A terminal frame loop with a static projection for agents and screen readers, and a plugin host for spinners, progress, boxes and tables. Drop-in paths for ora, log-update, boxen and cli-table3. Zero dependencies.",
   "license": "MIT",
   "type": "module",
@@ -89,6 +89,7 @@
     "build": "tsc -p tsconfig.build.json && node ../../scripts/strip-comments.mjs dist",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "test": "vitest run --passWithNoTests",
+    "coverage": "vitest run --coverage.enabled",
     "lint": "eslint src"
   },
   "repository": {
@@ -114,13 +115,12 @@
     "plugins"
   ],
   "dependencies": {
-    "roundel": "^0.1.0"
+    "linegauge": "^0.1.0",
+    "roundel": "^0.2.0"
   },
   "devDependencies": {
     "cli-boxes": "^4.0.1",
     "cli-spinners": "^3.2.0",
-    "string-width": "^8.1.0",
-    "vitest": "^5.0.0",
-    "wrap-ansi": "^10.0.1"
+    "vitest": "^5.0.0"
   }
 }

package/dist/width.d.ts

@@ -1,13 +0,0 @@
-/**
- * Columns a string of *plain* text occupies — no escape scan. The wrapper below has
- * already split its input into text runs and complete sequences, so rescanning would only
- * give a malformed sequence a second chance to be mistaken for one.
- */
-export declare function measure(text: string): number;
-/** How many terminal columns `input` occupies once its escape sequences are removed. */
-export declare function width(input: string): number;
-/**
- * Lines a string occupies in a terminal `columns` wide — the measurement the frame loop
- * actually asks for. An empty line still occupies one.
- */
-export declare function lineCount(text: string, columns: number): number;

package/dist/width.js

@@ -1,86 +0,0 @@
-import { stripVTControlCharacters } from 'node:util';
-const WIDE = [
-    0x1100, 0x115F, 0x231A, 0x231B, 0x2329, 0x232A, 0x23E9, 0x23EC, 0x23F0, 0x23F0,
-    0x23F3, 0x23F3, 0x25FD, 0x25FE, 0x2614, 0x2615, 0x2630, 0x2637, 0x2648, 0x2653,
-    0x267F, 0x267F, 0x268A, 0x268F, 0x2693, 0x2693, 0x26A1, 0x26A1, 0x26AA, 0x26AB,
-    0x26BD, 0x26BE, 0x26C4, 0x26C5, 0x26CE, 0x26CE, 0x26D4, 0x26D4, 0x26EA, 0x26EA,
-    0x26F2, 0x26F3, 0x26F5, 0x26F5, 0x26FA, 0x26FA, 0x26FD, 0x26FD, 0x2705, 0x2705,
-    0x270A, 0x270B, 0x2728, 0x2728, 0x274C, 0x274C, 0x274E, 0x274E, 0x2753, 0x2755,
-    0x2757, 0x2757, 0x2795, 0x2797, 0x27B0, 0x27B0, 0x27BF, 0x27BF, 0x2B1B, 0x2B1C,
-    0x2B50, 0x2B50, 0x2B55, 0x2B55, 0x2E80, 0x2E99, 0x2E9B, 0x2EF3, 0x2F00, 0x2FD5,
-    0x2FF0, 0x303E, 0x3041, 0x3096, 0x3099, 0x30FF, 0x3105, 0x312F, 0x3131, 0x318E,
-    0x3190, 0x31E5, 0x31EF, 0x321E, 0x3220, 0x3247, 0x3250, 0xA48C, 0xA490, 0xA4C6,
-    0xA960, 0xA97C, 0xAC00, 0xD7A3, 0xF900, 0xFAFF, 0xFE10, 0xFE19, 0xFE30, 0xFE52,
-    0xFE54, 0xFE66, 0xFE68, 0xFE6B, 0xFF01, 0xFF60, 0xFFE0, 0xFFE6, 0x16FE0, 0x16FE4,
-    0x16FF0, 0x16FF1, 0x17000, 0x187F7, 0x18800, 0x18CD5, 0x18CFF, 0x18D08, 0x1AFF0, 0x1AFF3,
-    0x1AFF5, 0x1AFFB, 0x1AFFD, 0x1AFFE, 0x1B000, 0x1B122, 0x1B132, 0x1B132, 0x1B150, 0x1B152,
-    0x1B155, 0x1B155, 0x1B164, 0x1B167, 0x1B170, 0x1B2FB, 0x1D300, 0x1D356, 0x1D360, 0x1D376,
-    0x1F004, 0x1F004, 0x1F0CF, 0x1F0CF, 0x1F18E, 0x1F18E, 0x1F191, 0x1F19A, 0x1F200, 0x1F202,
-    0x1F210, 0x1F23B, 0x1F240, 0x1F248, 0x1F250, 0x1F251, 0x1F260, 0x1F265, 0x1F300, 0x1F320,
-    0x1F32D, 0x1F335, 0x1F337, 0x1F37C, 0x1F37E, 0x1F393, 0x1F3A0, 0x1F3CA, 0x1F3CF, 0x1F3D3,
-    0x1F3E0, 0x1F3F0, 0x1F3F4, 0x1F3F4, 0x1F3F8, 0x1F43E, 0x1F440, 0x1F440, 0x1F442, 0x1F4FC,
-    0x1F4FF, 0x1F53D, 0x1F54B, 0x1F54E, 0x1F550, 0x1F567, 0x1F57A, 0x1F57A, 0x1F595, 0x1F596,
-    0x1F5A4, 0x1F5A4, 0x1F5FB, 0x1F64F, 0x1F680, 0x1F6C5, 0x1F6CC, 0x1F6CC, 0x1F6D0, 0x1F6D2,
-    0x1F6D5, 0x1F6D7, 0x1F6DC, 0x1F6DF, 0x1F6EB, 0x1F6EC, 0x1F6F4, 0x1F6FC, 0x1F7E0, 0x1F7EB,
-    0x1F7F0, 0x1F7F0, 0x1F90C, 0x1F93A, 0x1F93C, 0x1F945, 0x1F947, 0x1F9FF, 0x1FA70, 0x1FA7C,
-    0x1FA80, 0x1FA89, 0x1FA8F, 0x1FAC6, 0x1FACE, 0x1FADC, 0x1FADF, 0x1FAE9, 0x1FAF0, 0x1FAF8,
-    0x20000, 0x2FFFD, 0x30000, 0x3FFFD,
-];
-const NARROW = 1;
-const WIDE_COLUMNS = 2;
-const PAIR = 2;
-function isWide(codePoint) {
-    let low = 0;
-    let high = WIDE.length / PAIR - 1;
-    while (low <= high) {
-        const mid = (low + high) >> 1;
-        const start = WIDE[mid * PAIR] ?? 0;
-        const end = WIDE[mid * PAIR + 1] ?? 0;
-        if (codePoint < start)
-            high = mid - 1;
-        else if (codePoint > end)
-            low = mid + 1;
-        else
-            return true;
-    }
-    return false;
-}
-const ZERO_WIDTH_CLUSTER = /^(?:\p{Default_Ignorable_Code_Point}|\p{Control}|\p{Mark}|\p{Surrogate})+$/v;
-const LEADING_NON_PRINTING = /^[\p{Default_Ignorable_Code_Point}\p{Control}\p{Format}\p{Mark}\p{Surrogate}]+/v;
-const RGI_EMOJI = /^\p{RGI_Emoji}$/v;
-const FORMS_FIRST = 0xff00;
-const FORMS_LAST = 0xffef;
-const segmenter = new Intl.Segmenter();
-function trailingForms(cluster) {
-    let extra = 0;
-    for (const character of [...cluster].slice(1)) {
-        const codePoint = character.codePointAt(0) ?? 0;
-        if (codePoint >= FORMS_FIRST && codePoint <= FORMS_LAST)
-            extra += isWide(codePoint) ? WIDE_COLUMNS : NARROW;
-    }
-    return extra;
-}
-export function measure(text) {
-    let columns = 0;
-    for (const { segment } of segmenter.segment(text)) {
-        if (ZERO_WIDTH_CLUSTER.test(segment))
-            continue;
-        if (RGI_EMOJI.test(segment)) {
-            columns += WIDE_COLUMNS;
-            continue;
-        }
-        const codePoint = segment.replace(LEADING_NON_PRINTING, '').codePointAt(0) ?? 0;
-        columns += isWide(codePoint) ? WIDE_COLUMNS : NARROW;
-        columns += trailingForms(segment);
-    }
-    return columns;
-}
-export function width(input) {
-    return input === '' ? 0 : measure(stripVTControlCharacters(input));
-}
-export function lineCount(text, columns) {
-    let count = 0;
-    for (const line of stripVTControlCharacters(text).split('\n'))
-        count += Math.max(1, Math.ceil(width(line) / columns));
-    return count;
-}

package/dist/wrap.d.ts

@@ -1,10 +0,0 @@
-export interface WrapOptions {
-    /** Trim leading and trailing whitespace from each row. Default true. */
-    trim?: boolean;
-    /** Break a word longer than `columns` rather than let it overflow. Default false. */
-    hard?: boolean;
-    /** Break on any character rather than at word boundaries. Default true. */
-    wordWrap?: boolean;
-}
-/** Wrap `string` to `columns`, keeping its ANSI intact and each row self-contained. */
-export declare function wrap(string: string, columns: number, options?: WrapOptions): string;

package/dist/wrap.js

@@ -1,447 +0,0 @@
-import { measure } from './width.js';
-const ESC = '\u001B';
-const BELL = '\u0007';
-const C1_CSI = '\u009B';
-const CSI = '[';
-const OSC = ']';
-const SGR_TERMINATOR = 'm';
-const SGR_RESET = 0;
-const SGR_RESET_FOREGROUND = 39;
-const SGR_RESET_BACKGROUND = 49;
-const SGR_RESET_UNDERLINE_COLOR = 59;
-const SGR_FOREGROUND_EXTENDED = 38;
-const SGR_BACKGROUND_EXTENDED = 48;
-const SGR_UNDERLINE_COLOR_EXTENDED = 58;
-const SGR_COLOR_MODE_RGB = 2;
-const SGR_COLOR_MODE_256 = 5;
-const FOREGROUND_FIRST = 30;
-const FOREGROUND_LAST = 37;
-const FOREGROUND_BRIGHT_FIRST = 90;
-const FOREGROUND_BRIGHT_LAST = 97;
-const BACKGROUND_FIRST = 40;
-const BACKGROUND_LAST = 47;
-const BACKGROUND_BRIGHT_FIRST = 100;
-const BACKGROUND_BRIGHT_LAST = 107;
-const TAB_SIZE = 8;
-const COLOR_256_PARTS = 3;
-const COLOR_RGB_PARTS = 3;
-const COLON_RGB_WITH_SPACE = 6;
-const ESCAPES = new Set([ESC, C1_CSI]);
-const ESCAPE_CHARACTERS = [...ESCAPES].join('');
-const CSI_INTRODUCER = `(?:${ESC}\\${CSI}|${C1_CSI})`;
-const CSI_PARAMETERS = '[0-?]*[ -/]*[@-~]';
-const SGR_PARAMETERS = `(?<sgr>[0-9;:]*)${SGR_TERMINATOR}`;
-const OSC_TERMINATOR = `(?:${BELL}|${ESC}\\\\)`;
-const OSC_PAYLOAD = String.raw `[^\u0000-\u001F\u007F-\u009F]*`;
-const LINK_PARAMETERS = String.raw `8;(?<parameters>[^;\u0000-\u001F\u007F-\u009F]*);(?<uri>${OSC_PAYLOAD})${OSC_TERMINATOR}`;
-const ANSI_ESCAPE = new RegExp(`${CSI_INTRODUCER}(?:${SGR_PARAMETERS}|${CSI_PARAMETERS})|${ESC}\\${OSC}(?:${LINK_PARAMETERS}|${OSC_PAYLOAD}${OSC_TERMINATOR})`, 'y');
-const ESCAPE_INTRODUCER = new RegExp(`[${ESCAPE_CHARACTERS}]`, 'g');
-const ROW_BOUNDARY = new RegExp(`[\\n${ESCAPE_CHARACTERS}]`, 'g');
-const ASCII_PRINTABLE = /^[ -~]*$/;
-const MODIFIER_CLOSE = new Map([
-    [1, 22],
-    [2, 22],
-    [3, 23],
-    [4, 24],
-    [7, 27],
-    [8, 28],
-    [9, 29],
-    [53, 55],
-]);
-const MODIFIER_CLOSE_CODES = new Set(MODIFIER_CLOSE.values());
-const segmenter = new Intl.Segmenter();
-const sgr = (code) => `${ESC}${CSI}${code}${SGR_TERMINATOR}`;
-const hyperlink = (url, parameters = '') => `${ESC}${OSC}8;${parameters};${url}${BELL}`;
-function matchEscape(string, index) {
-    if (!ESCAPES.has(string[index] ?? ''))
-        return undefined;
-    ANSI_ESCAPE.lastIndex = index;
-    return ANSI_ESCAPE.exec(string) ?? undefined;
-}
-function forEachSegment(string, onPlainText, onEscape = () => undefined) {
-    let plainStart = 0;
-    let index = 0;
-    while (index < string.length) {
-        ESCAPE_INTRODUCER.lastIndex = index;
-        const introducer = ESCAPE_INTRODUCER.exec(string);
-        if (introducer === null)
-            break;
-        const escape = matchEscape(string, introducer.index);
-        if (escape === undefined) {
-            index = introducer.index + 1;
-            continue;
-        }
-        if (introducer.index > plainStart)
-            onPlainText(string.slice(plainStart, introducer.index));
-        onEscape(escape[0]);
-        index = introducer.index + escape[0].length;
-        plainStart = index;
-    }
-    if (plainStart < string.length)
-        onPlainText(string.slice(plainStart));
-}
-function visibleWidth(string) {
-    let plainText = '';
-    forEachSegment(string, (part) => {
-        plainText += part;
-    });
-    return measure(plainText);
-}
-function tokenize(string) {
-    const tokens = [];
-    forEachSegment(string, (plainText) => {
-        if (ASCII_PRINTABLE.test(plainText)) {
-            for (const character of plainText)
-                tokens.push({ value: character, width: 1 });
-            return;
-        }
-        for (const { segment } of segmenter.segment(plainText))
-            tokens.push({ value: segment, width: measure(segment) });
-    }, (escape) => tokens.push({ value: escape, width: 0 }));
-    return tokens;
-}
-function splitWords(string) {
-    let current = { value: '', plainText: '', width: 0 };
-    const words = [current];
-    forEachSegment(string, (plainText) => {
-        const parts = plainText.split(' ');
-        current.value += parts[0] ?? '';
-        current.plainText += parts[0] ?? '';
-        for (let index = 1; index < parts.length; index += 1) {
-            const part = parts[index] ?? '';
-            current = { value: part, plainText: part, width: 0 };
-            words.push(current);
-        }
-    }, (escape) => {
-        current.value += escape;
-    });
-    for (const word of words)
-        word.width = measure(word.plainText);
-    return words;
-}
-const isDigits = (value) => /^\d+$/.test(value);
-function colonColorToken(parameter) {
-    const parts = parameter.split(':');
-    const code = Number.parseInt(parts[0] ?? '', 10);
-    const mode = Number.parseInt(parts[1] ?? '', 10);
-    if (![SGR_FOREGROUND_EXTENDED, SGR_BACKGROUND_EXTENDED, SGR_UNDERLINE_COLOR_EXTENDED].includes(code))
-        return undefined;
-    if (mode === SGR_COLOR_MODE_256 && parts.length === COLOR_256_PARTS && isDigits(parts[2] ?? '')) {
-        return { code, open: parameter, hasArguments: true };
-    }
-    if (mode !== SGR_COLOR_MODE_RGB)
-        return undefined;
-    const withSpace = parts.length === COLON_RGB_WITH_SPACE;
-    const components = withSpace ? parts.slice(3) : parts.slice(2);
-    const colorSpace = withSpace ? parts[2] : undefined;
-    if (components.length === COLOR_RGB_PARTS && components.every(isDigits) && (colorSpace === undefined || /^\d*$/.test(colorSpace))) {
-        return { code, open: parameter, hasArguments: true };
-    }
-    return undefined;
-}
-function extendedColorToken(code, parameters, index) {
-    const mode = Number.parseInt(parameters[index + 1] ?? '', 10);
-    const first = Number.parseInt(parameters[index + 2] ?? '', 10);
-    if (mode === SGR_COLOR_MODE_256 && Number.isFinite(first)) {
-        return { token: { code, open: [code, mode, first].join(';'), hasArguments: true }, consumed: 2 };
-    }
-    const green = Number.parseInt(parameters[index + 3] ?? '', 10);
-    const blue = Number.parseInt(parameters[index + 4] ?? '', 10);
-    if (mode === SGR_COLOR_MODE_RGB && Number.isFinite(first) && Number.isFinite(green) && Number.isFinite(blue)) {
-        return { token: { code, open: [code, mode, first, green, blue].join(';'), hasArguments: true }, consumed: 4 };
-    }
-    return undefined;
-}
-const isExtendedColor = (code) => code === SGR_FOREGROUND_EXTENDED || code === SGR_BACKGROUND_EXTENDED || code === SGR_UNDERLINE_COLOR_EXTENDED;
-function sgrTokens(parameters) {
-    const parts = parameters.split(';');
-    const tokens = [];
-    for (let index = 0; index < parts.length; index += 1) {
-        const parameter = parts[index] ?? '';
-        if (parameter.includes(':')) {
-            const token = colonColorToken(parameter);
-            if (token !== undefined)
-                tokens.push(token);
-            continue;
-        }
-        const code = parameter === '' ? SGR_RESET : Number.parseInt(parameter, 10);
-        if (!Number.isFinite(code))
-            continue;
-        if (isExtendedColor(code)) {
-            if (index + 1 >= parts.length)
-                break;
-            const extended = extendedColorToken(code, parts, index);
-            if (extended === undefined)
-                break;
-            tokens.push(extended.token);
-            index += extended.consumed;
-            continue;
-        }
-        tokens.push({ code, open: String(code), hasArguments: false });
-    }
-    return tokens;
-}
-function removeFamily(active, family) {
-    const at = active.findIndex((style) => style.family === family);
-    if (at !== -1)
-        active.splice(at, 1);
-}
-function colorStyle(token) {
-    const { code, open, hasArguments } = token;
-    if ((code >= FOREGROUND_FIRST && code <= FOREGROUND_LAST) || (code >= FOREGROUND_BRIGHT_FIRST && code <= FOREGROUND_BRIGHT_LAST) || (code === SGR_FOREGROUND_EXTENDED && hasArguments)) {
-        return { family: 'foreground', open, close: SGR_RESET_FOREGROUND };
-    }
-    if ((code >= BACKGROUND_FIRST && code <= BACKGROUND_LAST) || (code >= BACKGROUND_BRIGHT_FIRST && code <= BACKGROUND_BRIGHT_LAST) || (code === SGR_BACKGROUND_EXTENDED && hasArguments)) {
-        return { family: 'background', open, close: SGR_RESET_BACKGROUND };
-    }
-    if (code === SGR_UNDERLINE_COLOR_EXTENDED && hasArguments) {
-        return { family: 'underlineColor', open, close: SGR_RESET_UNDERLINE_COLOR };
-    }
-    return undefined;
-}
-function applyResetCode(code, active) {
-    if (code === SGR_RESET) {
-        active.length = 0;
-        return true;
-    }
-    if (code === SGR_RESET_FOREGROUND) {
-        removeFamily(active, 'foreground');
-        return true;
-    }
-    if (code === SGR_RESET_BACKGROUND) {
-        removeFamily(active, 'background');
-        return true;
-    }
-    if (code === SGR_RESET_UNDERLINE_COLOR) {
-        removeFamily(active, 'underlineColor');
-        return true;
-    }
-    if (MODIFIER_CLOSE_CODES.has(code)) {
-        for (let index = active.length - 1; index >= 0; index -= 1) {
-            const style = active[index];
-            if (style !== undefined && style.family.startsWith('modifier-') && style.close === code)
-                active.splice(index, 1);
-        }
-        return true;
-    }
-    return false;
-}
-function applyToken(token, active) {
-    if (applyResetCode(token.code, active))
-        return;
-    const color = colorStyle(token);
-    if (color !== undefined) {
-        removeFamily(active, color.family);
-        active.push(color);
-        return;
-    }
-    const close = MODIFIER_CLOSE.get(token.code);
-    if (close !== undefined && close !== SGR_RESET) {
-        const family = `modifier-${token.code}`;
-        removeFamily(active, family);
-        active.push({ family, open: token.open, close });
-    }
-}
-const applyParameters = (parameters, active) => {
-    for (const token of sgrTokens(parameters))
-        applyToken(token, active);
-};
-const applyResets = (parameters, active) => {
-    for (const { code } of sgrTokens(parameters))
-        applyResetCode(code, active);
-};
-function applyLeadingResets(string, startIndex, active) {
-    let index = startIndex;
-    while (index < string.length) {
-        const match = matchEscape(string, index);
-        if (match === undefined)
-            break;
-        if (match.groups?.['sgr'] !== undefined)
-            applyResets(match.groups['sgr'], active);
-        index += match[0].length;
-    }
-}
-const closingSequence = (active) => [...active].reverse().map((style) => sgr(style.close)).join('');
-const openingSequence = (active) => active.map((style) => sgr(style.open)).join('');
-function wrapWord(rows, word, columns, rowWidth) {
-    const tokens = tokenize(word);
-    let visible = rowWidth;
-    for (const [index, token] of tokens.entries()) {
-        if (token.width > 0 && visible > 0 && visible + token.width > columns) {
-            rows.push('');
-            visible = 0;
-        }
-        rows[rows.length - 1] += token.value;
-        visible += token.width;
-        if (visible === columns && index < tokens.length - 1) {
-            rows.push('');
-            visible = 0;
-        }
-    }
-    const last = rows.at(-1) ?? '';
-    if (!visible && last.length > 0 && rows.length > 1)
-        rows[rows.length - 2] += rows.pop() ?? '';
-    return visibleWidth(rows.at(-1) ?? '');
-}
-function trimVisibleEnd(string) {
-    if (!string.includes(' '))
-        return string;
-    const segments = [];
-    forEachSegment(string, (plainText) => segments.push({ value: plainText, isEscape: false }), (escape) => segments.push({ value: escape, isEscape: true }));
-    for (let index = segments.length - 1; index >= 0; index -= 1) {
-        const segment = segments[index];
-        if (segment === undefined || segment.isEscape)
-            continue;
-        let end = segment.value.length;
-        while (end > 0 && segment.value[end - 1] === ' ')
-            end -= 1;
-        segment.value = segment.value.slice(0, end);
-        if (measure(segment.value) > 0)
-            break;
-    }
-    return segments.map((segment) => segment.value).join('');
-}
-function expandTabs(line) {
-    if (!line.includes('\t'))
-        return line;
-    let visible = 0;
-    let expanded = '';
-    let sinceTab = '';
-    forEachSegment(line, (plainText) => {
-        const parts = plainText.split('\t');
-        for (const [index, part] of parts.entries()) {
-            expanded += part;
-            sinceTab += part;
-            if (index < parts.length - 1) {
-                visible += measure(sinceTab);
-                sinceTab = '';
-                const spaces = TAB_SIZE - (visible % TAB_SIZE);
-                expanded += ' '.repeat(spaces);
-                visible += spaces;
-            }
-        }
-    }, (escape) => {
-        expanded += escape;
-    });
-    return expanded;
-}
-function restoreStylesAcrossRows(preString) {
-    let out = '';
-    let activeHyperlink;
-    const active = [];
-    let index = 0;
-    let copied = 0;
-    while (index < preString.length) {
-        ROW_BOUNDARY.lastIndex = index;
-        const boundary = ROW_BOUNDARY.exec(preString);
-        if (boundary === null)
-            break;
-        index = boundary.index;
-        if (boundary[0] !== '\n') {
-            const escape = matchEscape(preString, index);
-            if (escape === undefined) {
-                index += 1;
-                continue;
-            }
-            const groups = escape.groups ?? {};
-            if (groups['sgr'] !== undefined)
-                applyParameters(groups['sgr'], active);
-            else if (groups['uri'] !== undefined)
-                activeHyperlink = groups['uri'].length === 0 ? undefined : { parameters: groups['parameters'] ?? '', uri: groups['uri'] };
-            index += escape[0].length;
-            continue;
-        }
-        out += preString.slice(copied, index);
-        if (index > copied) {
-            if (activeHyperlink !== undefined)
-                out += hyperlink('');
-            out += closingSequence(active);
-        }
-        out += '\n';
-        index += 1;
-        copied = index;
-        if (index < preString.length && preString[index] !== '\n') {
-            const opening = [...active];
-            applyLeadingResets(preString, index, opening);
-            out += openingSequence(opening);
-            if (activeHyperlink !== undefined)
-                out += hyperlink(activeHyperlink.uri, activeHyperlink.parameters);
-        }
-    }
-    return out + preString.slice(copied);
-}
-function shouldStartLongWordOnNextRow(wordWidth, columns, rowLength) {
-    const remaining = columns - rowLength;
-    const breaksStartingThisRow = 1 + Math.floor((wordWidth - remaining - 1) / columns);
-    const breaksStartingNextRow = Math.floor((wordWidth - 1) / columns);
-    return breaksStartingNextRow < breaksStartingThisRow;
-}
-function wrapLine(string, columns, options) {
-    const trim = options.trim !== false;
-    if (trim && string.trim() === '')
-        return '';
-    const words = splitWords(string);
-    let rows = [''];
-    let rowLength = 0;
-    let trimmedRowIndex = -1;
-    let isFirstWord = true;
-    for (const word of words) {
-        const rowIndex = rows.length - 1;
-        if (trim && trimmedRowIndex !== rowIndex) {
-            const row = rows[rowIndex] ?? '';
-            const trimmedRow = row.trimStart();
-            if (trimmedRow.length !== row.length) {
-                rows[rowIndex] = trimmedRow;
-                rowLength = visibleWidth(trimmedRow);
-            }
-            if (trimmedRow.length > 0)
-                trimmedRowIndex = rowIndex;
-        }
-        if (isFirstWord) {
-            isFirstWord = false;
-        }
-        else {
-            if (rowLength >= columns && (options.wordWrap === false || !trim)) {
-                rows.push('');
-                rowLength = 0;
-            }
-            if (rowLength > 0 || !trim) {
-                rows[rows.length - 1] += ' ';
-                rowLength += 1;
-            }
-        }
-        if (options.hard === true && options.wordWrap !== false && word.width > columns) {
-            if (shouldStartLongWordOnNextRow(word.width, columns, rowLength)) {
-                rows.push('');
-                rowLength = 0;
-            }
-            rowLength = wrapWord(rows, word.value, columns, rowLength);
-            continue;
-        }
-        if (rowLength + word.width > columns && rowLength > 0 && word.width > 0) {
-            if (options.wordWrap === false && rowLength < columns) {
-                rowLength = wrapWord(rows, word.value, columns, rowLength);
-                continue;
-            }
-            rows.push('');
-            rowLength = 0;
-        }
-        if (rowLength + word.width > columns && options.wordWrap === false) {
-            rowLength = wrapWord(rows, word.value, columns, rowLength);
-            continue;
-        }
-        rows[rows.length - 1] += word.value;
-        rowLength += word.width;
-    }
-    if (trim)
-        rows = rows.map((row) => trimVisibleEnd(row));
-    return restoreStylesAcrossRows(rows.join('\n'));
-}
-export function wrap(string, columns, options = {}) {
-    return String(string)
-        .normalize()
-        .replaceAll('\r\n', '\n')
-        .split('\n')
-        .map((line) => wrapLine(expandTabs(line), columns, options))
-        .join('\n');
-}