tubeless 0.2.12 → 0.2.13

package/dist/reporter/live-ticker-frame.js

@@ -0,0 +1,196 @@
+import { formatDurationMs } from "./reporter.js";
+export const SPINNER_TOKEN = "\u0001";
+const ELAPSED_TOKEN_START = "\u0002";
+const ELAPSED_TOKEN_END = "\u0003";
+const SHIMMER_TOKEN_START = "\u0004";
+const SHIMMER_TOKEN_END = "\u0005";
+export const TICKER_ANSI = {
+    clearDown: "\u001B[J",
+    hideCursor: "\u001B[?25l",
+    reset: "\u001B[0m",
+    showCursor: "\u001B[?25h",
+};
+const SHIMMER_BAND_COLUMNS = 3;
+const SHIMMER_BRIGHT = "\u001B[0;1;36m";
+const SHIMMER_DIM = "\u001B[0;2;36m";
+const SHIMMER_FRAME_MS = 80;
+const ANSI_STYLE = /\u001B\[[0-9;]*m/g;
+const ANSI_STYLE_PREFIX = /^\u001B\[[0-9;]*m/;
+const COMBINING_MARK = /\p{Mark}/u;
+const EMOJI = /\p{Extended_Pictographic}/u;
+const SPINNERS = {
+    ascii: ["-", "\\", "|", "/"],
+    unicode: ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"],
+};
+function characterWidth(character) {
+    if (COMBINING_MARK.test(character) || character === "\u200D")
+        return 0;
+    if (EMOJI.test(character))
+        return 2;
+    const codePoint = character.codePointAt(0) ?? 0;
+    return codePoint >= 0x1100 &&
+        (codePoint <= 0x115f ||
+            codePoint === 0x2329 ||
+            codePoint === 0x232a ||
+            (codePoint >= 0x2e80 && codePoint <= 0xa4cf) ||
+            (codePoint >= 0xac00 && codePoint <= 0xd7a3) ||
+            (codePoint >= 0xf900 && codePoint <= 0xfaff) ||
+            (codePoint >= 0xfe10 && codePoint <= 0xfe6f) ||
+            (codePoint >= 0xff00 && codePoint <= 0xff60) ||
+            (codePoint >= 0xffe0 && codePoint <= 0xffe6) ||
+            (codePoint >= 0x20000 && codePoint <= 0x3fffd))
+        ? 2
+        : 1;
+}
+function visibleWidth(value) {
+    return [...value].reduce((width, character) => width + characterWidth(character), 0);
+}
+function fitLine(value, columns, unicode) {
+    if (!columns || columns <= 1)
+        return value;
+    const maxWidth = columns - 1;
+    const plain = value.replace(ANSI_STYLE, "");
+    if (visibleWidth(plain) <= maxWidth)
+        return value;
+    const ellipsis = unicode ? "…" : ".".repeat(Math.min(3, maxWidth));
+    const targetWidth = Math.max(0, maxWidth - visibleWidth(ellipsis));
+    let width = 0;
+    let truncated = "";
+    let index = 0;
+    let hasStyle = false;
+    while (index < value.length) {
+        const style = value.slice(index).match(ANSI_STYLE_PREFIX)?.[0];
+        if (style) {
+            truncated += style;
+            index += style.length;
+            hasStyle = true;
+            continue;
+        }
+        const character = String.fromCodePoint(value.codePointAt(index) ?? 0);
+        const nextWidth = width + characterWidth(character);
+        if (nextWidth > targetWidth)
+            break;
+        truncated += character;
+        width = nextWidth;
+        index += character.length;
+    }
+    return `${truncated}${hasStyle ? TICKER_ANSI.reset : ""}${ellipsis}`;
+}
+export function elapsedToken(startedAtMs) {
+    return `${ELAPSED_TOKEN_START}${startedAtMs}${ELAPSED_TOKEN_END}`;
+}
+export function shimmerToken(value) {
+    return `${SHIMMER_TOKEN_START}${value}${SHIMMER_TOKEN_END}`;
+}
+function paintShimmerText(text, nowMs) {
+    const characters = [...text];
+    if (characters.length === 0)
+        return text;
+    const widths = characters.map(characterWidth);
+    const totalWidth = visibleWidth(text);
+    const period = Math.max(1, totalWidth + SHIMMER_BAND_COLUMNS);
+    const head = Math.floor(nowMs / SHIMMER_FRAME_MS) % period;
+    const bandStart = head - SHIMMER_BAND_COLUMNS + 1;
+    let column = 0;
+    let output = TICKER_ANSI.reset;
+    let last;
+    for (const [index, character] of characters.entries()) {
+        const width = widths[index] ?? 0;
+        const inBand = width === 0 ? last === "bright" : column <= head && column + width - 1 >= bandStart;
+        const style = inBand ? "bright" : "dim";
+        if (style !== last) {
+            output += style === "bright" ? SHIMMER_BRIGHT : SHIMMER_DIM;
+            last = style;
+        }
+        output += character;
+        column += width;
+    }
+    return `${output}${TICKER_ANSI.reset}`;
+}
+function replaceLiveTokens(line, spinner, nowMs, color) {
+    return line
+        .replaceAll(SPINNER_TOKEN, spinner)
+        .replace(new RegExp(`${ELAPSED_TOKEN_START}(\\d+)${ELAPSED_TOKEN_END}`, "g"), (_match, start) => formatDurationMs(Math.max(0, nowMs - Number(start))))
+        .replace(new RegExp(`${SHIMMER_TOKEN_START}(.*?)${SHIMMER_TOKEN_END}`, "g"), (_match, text) => (color ? paintShimmerText(text, nowMs) : text));
+}
+export function paintLiveLines(lines, spinner, nowMs, columns, color = false, unicode = true, logPane) {
+    const painted = lines.map((line) => replaceLiveTokens(line, spinner, nowMs, color));
+    if (!logPane || !columns || columns < 120) {
+        return painted.map((line) => fitLine(line, columns, unicode));
+    }
+    const paneWidth = Math.min(60, Math.floor(columns * 0.4));
+    const leftWidth = columns - paneWidth - 3;
+    const horizontal = unicode ? "─" : "-";
+    const vertical = unicode ? "│" : "|";
+    const pad = (line, width) => {
+        const fitted = fitLine(line, width + 1, unicode);
+        return fitted + " ".repeat(Math.max(0, width - visibleWidth(fitted.replace(ANSI_STYLE, ""))));
+    };
+    const pane = [
+        `${unicode ? "╭" : "+"}${horizontal} Logs ${horizontal.repeat(paneWidth - 9)}${unicode ? "╮" : "+"}`,
+        ...logPane.map((line) => `${vertical} ${pad(line, paneWidth - 4)} ${vertical}`),
+        `${unicode ? "╰" : "+"}${horizontal.repeat(paneWidth - 2)}${unicode ? "╯" : "+"}`,
+    ];
+    return Array.from({ length: Math.max(painted.length, pane.length) }, (_, index) => pane[index] === undefined
+        ? fitLine(painted[index] ?? "", leftWidth + 1, unicode)
+        : `${pad(painted[index] ?? "", leftWidth)}  ${pane[index]}`);
+}
+export class TickerFrame {
+    write;
+    paintedLines;
+    cursorHidden;
+    constructor(write, paintedLines = []) {
+        this.write = write;
+        this.paintedLines = paintedLines;
+        this.cursorHidden = paintedLines.length > 0;
+    }
+    showCursor() {
+        if (!this.cursorHidden)
+            return;
+        this.write(TICKER_ANSI.showCursor);
+        this.cursorHidden = false;
+    }
+    clear(columns) {
+        if (this.paintedLines.length === 0)
+            return;
+        // Resizing can reflow each previously painted line across several rows.
+        // Count those rows at the current width before moving back to the frame start.
+        let rows = this.paintedLines.length;
+        if (columns !== undefined && columns > 0) {
+            rows = 0;
+            for (const line of this.paintedLines) {
+                rows += 1;
+                let column = 0;
+                for (const character of line.replace(ANSI_STYLE, "")) {
+                    const width = characterWidth(character);
+                    if (column + width > columns) {
+                        rows += 1;
+                        column = 0;
+                    }
+                    column += width;
+                }
+            }
+        }
+        this.write(`\u001B[${rows}F${TICKER_ANSI.clearDown}`);
+        this.paintedLines = [];
+    }
+    redraw(lines, columns) {
+        if (!this.cursorHidden) {
+            this.write(TICKER_ANSI.hideCursor);
+            this.cursorHidden = true;
+        }
+        this.clear(columns);
+        if (lines.length === 0)
+            return;
+        this.write(`${lines.join("\n")}\n`);
+        this.paintedLines = lines;
+    }
+}
+export function currentSpinner(unicode, refreshIntervalMs) {
+    const frames = unicode ? SPINNERS.unicode : SPINNERS.ascii;
+    return frames[Math.floor(Date.now() / refreshIntervalMs) % frames.length] ?? frames[0];
+}
+export function hasLiveAnimation(lines) {
+    return lines.some((line) => line.includes(SPINNER_TOKEN) || line.includes(SHIMMER_TOKEN_START));
+}
+//# sourceMappingURL=live-ticker-frame.js.map

package/dist/reporter/live-ticker-frame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-ticker-frame.js","sourceRoot":"","sources":["../../src/reporter/live-ticker-frame.ts"],"names":[],"mappings":"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","sourcesContent":["import { formatDurationMs } from \"./reporter.js\";\n\nexport const SPINNER_TOKEN = \"\\u0001\";\nconst ELAPSED_TOKEN_START = \"\\u0002\";\nconst ELAPSED_TOKEN_END = \"\\u0003\";\nconst SHIMMER_TOKEN_START = \"\\u0004\";\nconst SHIMMER_TOKEN_END = \"\\u0005\";\n\nexport const TICKER_ANSI = {\n  clearDown: \"\\u001B[J\",\n  hideCursor: \"\\u001B[?25l\",\n  reset: \"\\u001B[0m\",\n  showCursor: \"\\u001B[?25h\",\n} as const;\n\nconst SHIMMER_BAND_COLUMNS = 3;\nconst SHIMMER_BRIGHT = \"\\u001B[0;1;36m\";\nconst SHIMMER_DIM = \"\\u001B[0;2;36m\";\nconst SHIMMER_FRAME_MS = 80;\n\nconst ANSI_STYLE = /\\u001B\\[[0-9;]*m/g;\nconst ANSI_STYLE_PREFIX = /^\\u001B\\[[0-9;]*m/;\nconst COMBINING_MARK = /\\p{Mark}/u;\nconst EMOJI = /\\p{Extended_Pictographic}/u;\n\nconst SPINNERS = {\n  ascii: [\"-\", \"\\\\\", \"|\", \"/\"],\n  unicode: [\"⠋\", \"⠙\", \"⠹\", \"⠸\", \"⠼\", \"⠴\", \"⠦\", \"⠧\", \"⠇\", \"⠏\"],\n} as const;\n\nfunction characterWidth(character: string): number {\n  if (COMBINING_MARK.test(character) || character === \"\\u200D\") return 0;\n  if (EMOJI.test(character)) return 2;\n  const codePoint = character.codePointAt(0) ?? 0;\n  return codePoint >= 0x1100 &&\n    (codePoint <= 0x115f ||\n      codePoint === 0x2329 ||\n      codePoint === 0x232a ||\n      (codePoint >= 0x2e80 && codePoint <= 0xa4cf) ||\n      (codePoint >= 0xac00 && codePoint <= 0xd7a3) ||\n      (codePoint >= 0xf900 && codePoint <= 0xfaff) ||\n      (codePoint >= 0xfe10 && codePoint <= 0xfe6f) ||\n      (codePoint >= 0xff00 && codePoint <= 0xff60) ||\n      (codePoint >= 0xffe0 && codePoint <= 0xffe6) ||\n      (codePoint >= 0x20000 && codePoint <= 0x3fffd))\n    ? 2\n    : 1;\n}\n\nfunction visibleWidth(value: string): number {\n  return [...value].reduce((width, character) => width + characterWidth(character), 0);\n}\n\nfunction fitLine(value: string, columns: number | undefined, unicode: boolean): string {\n  if (!columns || columns <= 1) return value;\n  const maxWidth = columns - 1;\n  const plain = value.replace(ANSI_STYLE, \"\");\n  if (visibleWidth(plain) <= maxWidth) return value;\n  const ellipsis = unicode ? \"…\" : \".\".repeat(Math.min(3, maxWidth));\n  const targetWidth = Math.max(0, maxWidth - visibleWidth(ellipsis));\n  let width = 0;\n  let truncated = \"\";\n  let index = 0;\n  let hasStyle = false;\n  while (index < value.length) {\n    const style = value.slice(index).match(ANSI_STYLE_PREFIX)?.[0];\n    if (style) {\n      truncated += style;\n      index += style.length;\n      hasStyle = true;\n      continue;\n    }\n    const character = String.fromCodePoint(value.codePointAt(index) ?? 0);\n    const nextWidth = width + characterWidth(character);\n    if (nextWidth > targetWidth) break;\n    truncated += character;\n    width = nextWidth;\n    index += character.length;\n  }\n  return `${truncated}${hasStyle ? TICKER_ANSI.reset : \"\"}${ellipsis}`;\n}\n\nexport function elapsedToken(startedAtMs: number): string {\n  return `${ELAPSED_TOKEN_START}${startedAtMs}${ELAPSED_TOKEN_END}`;\n}\n\nexport function shimmerToken(value: string): string {\n  return `${SHIMMER_TOKEN_START}${value}${SHIMMER_TOKEN_END}`;\n}\n\nfunction paintShimmerText(text: string, nowMs: number): string {\n  const characters = [...text];\n  if (characters.length === 0) return text;\n  const widths = characters.map(characterWidth);\n  const totalWidth = visibleWidth(text);\n  const period = Math.max(1, totalWidth + SHIMMER_BAND_COLUMNS);\n  const head = Math.floor(nowMs / SHIMMER_FRAME_MS) % period;\n  const bandStart = head - SHIMMER_BAND_COLUMNS + 1;\n  let column = 0;\n  let output = TICKER_ANSI.reset;\n  let last: \"bright\" | \"dim\" | undefined;\n  for (const [index, character] of characters.entries()) {\n    const width = widths[index] ?? 0;\n    const inBand =\n      width === 0 ? last === \"bright\" : column <= head && column + width - 1 >= bandStart;\n    const style = inBand ? \"bright\" : \"dim\";\n    if (style !== last) {\n      output += style === \"bright\" ? SHIMMER_BRIGHT : SHIMMER_DIM;\n      last = style;\n    }\n    output += character;\n    column += width;\n  }\n  return `${output}${TICKER_ANSI.reset}`;\n}\n\nfunction replaceLiveTokens(line: string, spinner: string, nowMs: number, color: boolean): string {\n  return line\n    .replaceAll(SPINNER_TOKEN, spinner)\n    .replace(\n      new RegExp(`${ELAPSED_TOKEN_START}(\\\\d+)${ELAPSED_TOKEN_END}`, \"g\"),\n      (_match, start: string) => formatDurationMs(Math.max(0, nowMs - Number(start)))\n    )\n    .replace(\n      new RegExp(`${SHIMMER_TOKEN_START}(.*?)${SHIMMER_TOKEN_END}`, \"g\"),\n      (_match, text: string) => (color ? paintShimmerText(text, nowMs) : text)\n    );\n}\n\nexport function paintLiveLines(\n  lines: readonly string[],\n  spinner: string,\n  nowMs: number,\n  columns?: number,\n  color = false,\n  unicode = true,\n  logPane?: readonly string[]\n): string[] {\n  const painted = lines.map((line) => replaceLiveTokens(line, spinner, nowMs, color));\n  if (!logPane || !columns || columns < 120) {\n    return painted.map((line) => fitLine(line, columns, unicode));\n  }\n  const paneWidth = Math.min(60, Math.floor(columns * 0.4));\n  const leftWidth = columns - paneWidth - 3;\n  const horizontal = unicode ? \"─\" : \"-\";\n  const vertical = unicode ? \"│\" : \"|\";\n  const pad = (line: string, width: number): string => {\n    const fitted = fitLine(line, width + 1, unicode);\n    return fitted + \" \".repeat(Math.max(0, width - visibleWidth(fitted.replace(ANSI_STYLE, \"\"))));\n  };\n  const pane = [\n    `${unicode ? \"╭\" : \"+\"}${horizontal} Logs ${horizontal.repeat(paneWidth - 9)}${unicode ? \"╮\" : \"+\"}`,\n    ...logPane.map((line) => `${vertical} ${pad(line, paneWidth - 4)} ${vertical}`),\n    `${unicode ? \"╰\" : \"+\"}${horizontal.repeat(paneWidth - 2)}${unicode ? \"╯\" : \"+\"}`,\n  ];\n  return Array.from({ length: Math.max(painted.length, pane.length) }, (_, index) =>\n    pane[index] === undefined\n      ? fitLine(painted[index] ?? \"\", leftWidth + 1, unicode)\n      : `${pad(painted[index] ?? \"\", leftWidth)}  ${pane[index]}`\n  );\n}\n\nexport class TickerFrame {\n  private cursorHidden: boolean;\n\n  constructor(\n    private readonly write: (chunk: string) => void,\n    private paintedLines: readonly string[] = []\n  ) {\n    this.cursorHidden = paintedLines.length > 0;\n  }\n\n  showCursor(): void {\n    if (!this.cursorHidden) return;\n    this.write(TICKER_ANSI.showCursor);\n    this.cursorHidden = false;\n  }\n\n  clear(columns?: number): void {\n    if (this.paintedLines.length === 0) return;\n    // Resizing can reflow each previously painted line across several rows.\n    // Count those rows at the current width before moving back to the frame start.\n    let rows = this.paintedLines.length;\n    if (columns !== undefined && columns > 0) {\n      rows = 0;\n      for (const line of this.paintedLines) {\n        rows += 1;\n        let column = 0;\n        for (const character of line.replace(ANSI_STYLE, \"\")) {\n          const width = characterWidth(character);\n          if (column + width > columns) {\n            rows += 1;\n            column = 0;\n          }\n          column += width;\n        }\n      }\n    }\n    this.write(`\\u001B[${rows}F${TICKER_ANSI.clearDown}`);\n    this.paintedLines = [];\n  }\n\n  redraw(lines: readonly string[], columns?: number): void {\n    if (!this.cursorHidden) {\n      this.write(TICKER_ANSI.hideCursor);\n      this.cursorHidden = true;\n    }\n    this.clear(columns);\n    if (lines.length === 0) return;\n    this.write(`${lines.join(\"\\n\")}\\n`);\n    this.paintedLines = lines;\n  }\n}\n\nexport function currentSpinner(unicode: boolean, refreshIntervalMs: number): string {\n  const frames = unicode ? SPINNERS.unicode : SPINNERS.ascii;\n  return frames[Math.floor(Date.now() / refreshIntervalMs) % frames.length] ?? frames[0]!;\n}\n\nexport function hasLiveAnimation(lines: readonly string[]): boolean {\n  return lines.some((line) => line.includes(SPINNER_TOKEN) || line.includes(SHIMMER_TOKEN_START));\n}\n"]}

package/dist/reporter/live-ticker-protocol.d.ts

@@ -0,0 +1,41 @@
+import type { MessagePort } from "node:worker_threads";
+export interface LiveTickerWorkerData {
+    color: boolean;
+    columns?: number;
+    fd: number;
+    framePort: MessagePort;
+    refreshIntervalMs: number;
+    stateBuffer: SharedArrayBuffer;
+    unicode: boolean;
+}
+export type TickerWorkerMessage = {
+    columns?: number;
+    lines: string[];
+    logPane?: readonly string[];
+    type: "lines";
+} | {
+    columns?: number;
+    text: string;
+    type: "log";
+} | {
+    columns?: number;
+    lines: string[];
+    logPane?: readonly string[];
+    type: "stop";
+};
+/** Shared output ownership and acknowledgements, viewed from either thread. */
+export declare class TickerWorkerState {
+    #private;
+    readonly buffer: SharedArrayBuffer;
+    constructor(buffer?: SharedArrayBuffer);
+    get acceptedLogs(): number;
+    acknowledgeLog(): void;
+    get inlineRequested(): boolean;
+    markStopped(): void;
+    waitForStop(timeoutMs: number): boolean;
+    withWorkerOutput(write: () => void): void;
+    /** Revoke worker writes, then acquire exclusive output ownership within the deadline. */
+    claimOutput(timeoutMs: number): boolean;
+    /** Only an exit event guarantees that an abandoned lock no longer protects a write. */
+    releaseOutputAfterWorkerExit(): void;
+}

package/dist/reporter/live-ticker-protocol.js

@@ -0,0 +1,59 @@
+const STOPPED = 0;
+const ACCEPTED_LOGS = 1;
+const INLINE_REQUESTED = 2;
+const OUTPUT_LOCK = 3;
+/** Shared output ownership and acknowledgements, viewed from either thread. */
+export class TickerWorkerState {
+    buffer;
+    #state;
+    constructor(buffer = new SharedArrayBuffer(4 * Int32Array.BYTES_PER_ELEMENT)) {
+        this.buffer = buffer;
+        this.#state = new Int32Array(buffer);
+    }
+    get acceptedLogs() {
+        return Atomics.load(this.#state, ACCEPTED_LOGS);
+    }
+    acknowledgeLog() {
+        Atomics.add(this.#state, ACCEPTED_LOGS, 1);
+    }
+    get inlineRequested() {
+        return Atomics.load(this.#state, INLINE_REQUESTED) === 1;
+    }
+    markStopped() {
+        Atomics.store(this.#state, STOPPED, 1);
+        Atomics.notify(this.#state, STOPPED);
+    }
+    waitForStop(timeoutMs) {
+        return Atomics.wait(this.#state, STOPPED, 0, timeoutMs) !== "timed-out";
+    }
+    withWorkerOutput(write) {
+        while (Atomics.compareExchange(this.#state, OUTPUT_LOCK, 0, 1) !== 0) {
+            Atomics.wait(this.#state, OUTPUT_LOCK, 1);
+        }
+        try {
+            if (!this.inlineRequested)
+                write();
+        }
+        finally {
+            Atomics.store(this.#state, OUTPUT_LOCK, 0);
+            Atomics.notify(this.#state, OUTPUT_LOCK);
+        }
+    }
+    /** Revoke worker writes, then acquire exclusive output ownership within the deadline. */
+    claimOutput(timeoutMs) {
+        Atomics.store(this.#state, INLINE_REQUESTED, 1);
+        const deadline = Date.now() + timeoutMs;
+        while (Atomics.compareExchange(this.#state, OUTPUT_LOCK, 0, 1) !== 0) {
+            const remainingMs = deadline - Date.now();
+            if (remainingMs <= 0)
+                return false;
+            Atomics.wait(this.#state, OUTPUT_LOCK, 1, remainingMs);
+        }
+        return true;
+    }
+    /** Only an exit event guarantees that an abandoned lock no longer protects a write. */
+    releaseOutputAfterWorkerExit() {
+        Atomics.store(this.#state, OUTPUT_LOCK, 0);
+    }
+}
+//# sourceMappingURL=live-ticker-protocol.js.map

package/dist/reporter/live-ticker-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-ticker-protocol.js","sourceRoot":"","sources":["../../src/reporter/live-ticker-protocol.ts"],"names":[],"mappings":"AAiBA,MAAM,OAAO,GAAG,CAAC,CAAC;AAClB,MAAM,aAAa,GAAG,CAAC,CAAC;AACxB,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAC3B,MAAM,WAAW,GAAG,CAAC,CAAC;AAEtB,+EAA+E;AAC/E,MAAM,OAAO,iBAAiB;IAGP,MAAM;IAFlB,MAAM,CAAa;IAE5B,YAAqB,MAAM,GAAG,IAAI,iBAAiB,CAAC,CAAC,GAAG,UAAU,CAAC,iBAAiB,CAAC;sBAAhE,MAAM;QACzB,IAAI,CAAC,MAAM,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IAED,IAAI,YAAY;QACd,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAClD,CAAC;IAED,cAAc;QACZ,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED,IAAI,eAAe;QACjB,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAC3D,CAAC;IAED,WAAW;QACT,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;QACvC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IAED,WAAW,CAAC,SAAiB;QAC3B,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,CAAC,KAAK,WAAW,CAAC;IAC1E,CAAC;IAED,gBAAgB,CAAC,KAAiB;QAChC,OAAO,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;YACrE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;QAC5C,CAAC;QACD,IAAI,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,eAAe;gBAAE,KAAK,EAAE,CAAC;QACrC,CAAC;gBAAS,CAAC;YACT,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;YAC3C,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,yFAAyF;IACzF,WAAW,CAAC,SAAiB;QAC3B,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QACxC,OAAO,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;YACrE,MAAM,WAAW,GAAG,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC1C,IAAI,WAAW,IAAI,CAAC;gBAAE,OAAO,KAAK,CAAC;YACnC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,EAAE,WAAW,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,uFAAuF;IACvF,4BAA4B;QAC1B,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;IAC7C,CAAC;CACF","sourcesContent":["import type { MessagePort } from \"node:worker_threads\";\n\nexport interface LiveTickerWorkerData {\n  color: boolean;\n  columns?: number;\n  fd: number;\n  framePort: MessagePort;\n  refreshIntervalMs: number;\n  stateBuffer: SharedArrayBuffer;\n  unicode: boolean;\n}\n\nexport type TickerWorkerMessage =\n  | { columns?: number; lines: string[]; logPane?: readonly string[]; type: \"lines\" }\n  | { columns?: number; text: string; type: \"log\" }\n  | { columns?: number; lines: string[]; logPane?: readonly string[]; type: \"stop\" };\n\nconst STOPPED = 0;\nconst ACCEPTED_LOGS = 1;\nconst INLINE_REQUESTED = 2;\nconst OUTPUT_LOCK = 3;\n\n/** Shared output ownership and acknowledgements, viewed from either thread. */\nexport class TickerWorkerState {\n  readonly #state: Int32Array;\n\n  constructor(readonly buffer = new SharedArrayBuffer(4 * Int32Array.BYTES_PER_ELEMENT)) {\n    this.#state = new Int32Array(buffer);\n  }\n\n  get acceptedLogs(): number {\n    return Atomics.load(this.#state, ACCEPTED_LOGS);\n  }\n\n  acknowledgeLog(): void {\n    Atomics.add(this.#state, ACCEPTED_LOGS, 1);\n  }\n\n  get inlineRequested(): boolean {\n    return Atomics.load(this.#state, INLINE_REQUESTED) === 1;\n  }\n\n  markStopped(): void {\n    Atomics.store(this.#state, STOPPED, 1);\n    Atomics.notify(this.#state, STOPPED);\n  }\n\n  waitForStop(timeoutMs: number): boolean {\n    return Atomics.wait(this.#state, STOPPED, 0, timeoutMs) !== \"timed-out\";\n  }\n\n  withWorkerOutput(write: () => void): void {\n    while (Atomics.compareExchange(this.#state, OUTPUT_LOCK, 0, 1) !== 0) {\n      Atomics.wait(this.#state, OUTPUT_LOCK, 1);\n    }\n    try {\n      if (!this.inlineRequested) write();\n    } finally {\n      Atomics.store(this.#state, OUTPUT_LOCK, 0);\n      Atomics.notify(this.#state, OUTPUT_LOCK);\n    }\n  }\n\n  /** Revoke worker writes, then acquire exclusive output ownership within the deadline. */\n  claimOutput(timeoutMs: number): boolean {\n    Atomics.store(this.#state, INLINE_REQUESTED, 1);\n    const deadline = Date.now() + timeoutMs;\n    while (Atomics.compareExchange(this.#state, OUTPUT_LOCK, 0, 1) !== 0) {\n      const remainingMs = deadline - Date.now();\n      if (remainingMs <= 0) return false;\n      Atomics.wait(this.#state, OUTPUT_LOCK, 1, remainingMs);\n    }\n    return true;\n  }\n\n  /** Only an exit event guarantees that an abandoned lock no longer protects a write. */\n  releaseOutputAfterWorkerExit(): void {\n    Atomics.store(this.#state, OUTPUT_LOCK, 0);\n  }\n}\n"]}

package/dist/reporter/live-ticker-worker.js

@@ -1,61 +1,48 @@
 import { writeSync } from "node:fs";
 import { parentPort, workerData } from "node:worker_threads";
-import { currentSpinner, paintLiveLines, SHIMMER_TOKEN_START, SPINNER_TOKEN, TickerFrame, } from "./live-ticker.js";
+import { currentSpinner, paintLiveLines, hasLiveAnimation, TickerFrame, } from "./live-ticker-frame.js";
+import { TickerWorkerState, } from "./live-ticker-protocol.js";
 const port = parentPort;
 if (port === null)
     throw new Error("live-ticker-worker must run in a worker thread");
 // SAFETY: createWorkerTicker owns the workerData shape.
 const data = workerData;
-// [0] stopped, [1] accepted logs, [2] inline owns output, [3] output lock
-const state = new Int32Array(data.stateBuffer);
+const state = new TickerWorkerState(data.stateBuffer);
 const frame = new TickerFrame((chunk) => writeSync(data.fd, chunk));
 let columns = data.columns;
 let lines = [];
 let logPane;
-function withOutputLock(write) {
-    while (Atomics.compareExchange(state, 3, 0, 1) !== 0) {
-        Atomics.wait(state, 3, 1);
-    }
-    try {
-        if (Atomics.load(state, 2) === 0)
-            write();
-    }
-    finally {
-        Atomics.store(state, 3, 0);
-        Atomics.notify(state, 3);
-    }
-}
 function paintFrame() {
     const painted = paintLiveLines(lines, currentSpinner(data.unicode, data.refreshIntervalMs), Date.now(), columns, data.color, data.unicode, logPane);
     frame.redraw(painted, columns);
     data.framePort.postMessage(painted);
 }
 function redraw() {
-    withOutputLock(paintFrame);
+    state.withWorkerOutput(paintFrame);
 }
 const timer = setInterval(() => {
-    if (Atomics.load(state, 2) === 1) {
+    if (state.inlineRequested) {
         clearInterval(timer);
         port.close();
         return;
     }
-    if (lines.some((line) => line.includes(SPINNER_TOKEN) || line.includes(SHIMMER_TOKEN_START))) {
+    if (hasLiveAnimation(lines)) {
         redraw();
     }
 }, data.refreshIntervalMs);
 port.on("message", (message) => {
-    if (Atomics.load(state, 2) === 1) {
+    if (state.inlineRequested) {
         clearInterval(timer);
         port.close();
         return;
     }
     columns = message.columns ?? columns;
     if (message.type === "log") {
-        withOutputLock(() => {
+        state.withWorkerOutput(() => {
             frame.clear(columns);
             data.framePort.postMessage([]);
             writeSync(data.fd, message.text);
-            Atomics.add(state, 1, 1);
+            state.acknowledgeLog();
         });
         return;
     }
@@ -67,12 +54,11 @@ port.on("message", (message) => {
     }
     clearInterval(timer);
     try {
-        withOutputLock(() => {
+        state.withWorkerOutput(() => {
             paintFrame();
             frame.showCursor();
         });
-        Atomics.store(state, 0, 1);
-        Atomics.notify(state, 0);
+        state.markStopped();
     }
     finally {
         port.close();

package/dist/reporter/live-ticker-worker.js.map

@@ -1 +1 @@
-{"version":3,"file":"live-ticker-worker.js","sourceRoot":"","sources":["../../src/reporter/live-ticker-worker.ts"],"names":[],"mappings":"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","sourcesContent":["import { writeSync } from \"node:fs\";\nimport { parentPort, workerData, type MessagePort } from \"node:worker_threads\";\nimport {\n  currentSpinner,\n  paintLiveLines,\n  SHIMMER_TOKEN_START,\n  SPINNER_TOKEN,\n  TickerFrame,\n} from \"./live-ticker.js\";\n\ninterface LiveTickerWorkerData {\n  color: boolean;\n  columns?: number;\n  fd: number;\n  framePort: MessagePort;\n  refreshIntervalMs: number;\n  stateBuffer: SharedArrayBuffer;\n  unicode: boolean;\n}\n\ntype TickerWorkerMessage =\n  | { columns?: number; lines: string[]; logPane?: readonly string[]; type: \"lines\" }\n  | { columns?: number; text: string; type: \"log\" }\n  | { columns?: number; lines: string[]; logPane?: readonly string[]; type: \"stop\" };\n\nconst port = parentPort;\nif (port === null) throw new Error(\"live-ticker-worker must run in a worker thread\");\n\n// SAFETY: createWorkerTicker owns the workerData shape.\nconst data = workerData as LiveTickerWorkerData;\n// [0] stopped, [1] accepted logs, [2] inline owns output, [3] output lock\nconst state = new Int32Array(data.stateBuffer);\nconst frame = new TickerFrame((chunk) => writeSync(data.fd, chunk));\nlet columns = data.columns;\nlet lines: string[] = [];\nlet logPane: readonly string[] | undefined;\n\nfunction withOutputLock(write: () => void): void {\n  while (Atomics.compareExchange(state, 3, 0, 1) !== 0) {\n    Atomics.wait(state, 3, 1);\n  }\n  try {\n    if (Atomics.load(state, 2) === 0) write();\n  } finally {\n    Atomics.store(state, 3, 0);\n    Atomics.notify(state, 3);\n  }\n}\n\nfunction paintFrame(): void {\n  const painted = paintLiveLines(\n    lines,\n    currentSpinner(data.unicode, data.refreshIntervalMs),\n    Date.now(),\n    columns,\n    data.color,\n    data.unicode,\n    logPane\n  );\n  frame.redraw(painted, columns);\n  data.framePort.postMessage(painted);\n}\n\nfunction redraw(): void {\n  withOutputLock(paintFrame);\n}\n\nconst timer = setInterval(() => {\n  if (Atomics.load(state, 2) === 1) {\n    clearInterval(timer);\n    port.close();\n    return;\n  }\n  if (lines.some((line) => line.includes(SPINNER_TOKEN) || line.includes(SHIMMER_TOKEN_START))) {\n    redraw();\n  }\n}, data.refreshIntervalMs);\n\nport.on(\"message\", (message: TickerWorkerMessage) => {\n  if (Atomics.load(state, 2) === 1) {\n    clearInterval(timer);\n    port.close();\n    return;\n  }\n  columns = message.columns ?? columns;\n  if (message.type === \"log\") {\n    withOutputLock(() => {\n      frame.clear(columns);\n      data.framePort.postMessage([]);\n      writeSync(data.fd, message.text);\n      Atomics.add(state, 1, 1);\n    });\n    return;\n  }\n  lines = message.lines;\n  logPane = message.logPane;\n  if (message.type === \"lines\") {\n    redraw();\n    return;\n  }\n  clearInterval(timer);\n  try {\n    withOutputLock(() => {\n      paintFrame();\n      frame.showCursor();\n    });\n    Atomics.store(state, 0, 1);\n    Atomics.notify(state, 0);\n  } finally {\n    port.close();\n  }\n});\n"]}
+{"version":3,"file":"live-ticker-worker.js","sourceRoot":"","sources":["../../src/reporter/live-ticker-worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EACL,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,WAAW,GACZ,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,iBAAiB,GAGlB,MAAM,2BAA2B,CAAC;AAEnC,MAAM,IAAI,GAAG,UAAU,CAAC;AACxB,IAAI,IAAI,KAAK,IAAI;IAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;AAErF,wDAAwD;AACxD,MAAM,IAAI,GAAG,UAAkC,CAAC;AAChD,MAAM,KAAK,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;AACtD,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC;AACpE,IAAI,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;AAC3B,IAAI,KAAK,GAAa,EAAE,CAAC;AACzB,IAAI,OAAsC,CAAC;AAE3C,SAAS,UAAU;IACjB,MAAM,OAAO,GAAG,cAAc,CAC5B,KAAK,EACL,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,iBAAiB,CAAC,EACpD,IAAI,CAAC,GAAG,EAAE,EACV,OAAO,EACP,IAAI,CAAC,KAAK,EACV,IAAI,CAAC,OAAO,EACZ,OAAO,CACR,CAAC;IACF,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC/B,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,MAAM;IACb,KAAK,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;IAC7B,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;QAC1B,aAAa,CAAC,KAAK,CAAC,CAAC;QACrB,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,OAAO;IACT,CAAC;IACD,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,EAAE,CAAC;IACX,CAAC;AACH,CAAC,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC;AAE3B,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,OAA4B,EAAE,EAAE;IAClD,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;QAC1B,aAAa,CAAC,KAAK,CAAC,CAAC;QACrB,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,OAAO;IACT,CAAC;IACD,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC;IACrC,IAAI,OAAO,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QAC3B,KAAK,CAAC,gBAAgB,CAAC,GAAG,EAAE;YAC1B,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACrB,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;YAC/B,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;YACjC,KAAK,CAAC,cAAc,EAAE,CAAC;QACzB,CAAC,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IACD,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IACtB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAC1B,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC7B,MAAM,EAAE,CAAC;QACT,OAAO;IACT,CAAC;IACD,aAAa,CAAC,KAAK,CAAC,CAAC;IACrB,IAAI,CAAC;QACH,KAAK,CAAC,gBAAgB,CAAC,GAAG,EAAE;YAC1B,UAAU,EAAE,CAAC;YACb,KAAK,CAAC,UAAU,EAAE,CAAC;QACrB,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,WAAW,EAAE,CAAC;IACtB,CAAC;YAAS,CAAC;QACT,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;AACH,CAAC,CAAC,CAAC","sourcesContent":["import { writeSync } from \"node:fs\";\nimport { parentPort, workerData } from \"node:worker_threads\";\nimport {\n  currentSpinner,\n  paintLiveLines,\n  hasLiveAnimation,\n  TickerFrame,\n} from \"./live-ticker-frame.js\";\nimport {\n  TickerWorkerState,\n  type LiveTickerWorkerData,\n  type TickerWorkerMessage,\n} from \"./live-ticker-protocol.js\";\n\nconst port = parentPort;\nif (port === null) throw new Error(\"live-ticker-worker must run in a worker thread\");\n\n// SAFETY: createWorkerTicker owns the workerData shape.\nconst data = workerData as LiveTickerWorkerData;\nconst state = new TickerWorkerState(data.stateBuffer);\nconst frame = new TickerFrame((chunk) => writeSync(data.fd, chunk));\nlet columns = data.columns;\nlet lines: string[] = [];\nlet logPane: readonly string[] | undefined;\n\nfunction paintFrame(): void {\n  const painted = paintLiveLines(\n    lines,\n    currentSpinner(data.unicode, data.refreshIntervalMs),\n    Date.now(),\n    columns,\n    data.color,\n    data.unicode,\n    logPane\n  );\n  frame.redraw(painted, columns);\n  data.framePort.postMessage(painted);\n}\n\nfunction redraw(): void {\n  state.withWorkerOutput(paintFrame);\n}\n\nconst timer = setInterval(() => {\n  if (state.inlineRequested) {\n    clearInterval(timer);\n    port.close();\n    return;\n  }\n  if (hasLiveAnimation(lines)) {\n    redraw();\n  }\n}, data.refreshIntervalMs);\n\nport.on(\"message\", (message: TickerWorkerMessage) => {\n  if (state.inlineRequested) {\n    clearInterval(timer);\n    port.close();\n    return;\n  }\n  columns = message.columns ?? columns;\n  if (message.type === \"log\") {\n    state.withWorkerOutput(() => {\n      frame.clear(columns);\n      data.framePort.postMessage([]);\n      writeSync(data.fd, message.text);\n      state.acknowledgeLog();\n    });\n    return;\n  }\n  lines = message.lines;\n  logPane = message.logPane;\n  if (message.type === \"lines\") {\n    redraw();\n    return;\n  }\n  clearInterval(timer);\n  try {\n    state.withWorkerOutput(() => {\n      paintFrame();\n      frame.showCursor();\n    });\n    state.markStopped();\n  } finally {\n    port.close();\n  }\n});\n"]}

package/dist/reporter/live-ticker.d.ts

@@ -1,8 +1,3 @@
-export declare const SPINNER_TOKEN = "\u0001";
-export declare const SHIMMER_TOKEN_START = "\u0004";
-export declare function elapsedToken(startedAtMs: number): string;
-export declare function shimmerToken(value: string): string;
-export declare function paintLiveLines(lines: readonly string[], spinner: string, nowMs: number, columns?: number, color?: boolean, unicode?: boolean, logPane?: readonly string[]): string[];
 export interface LiveTicker {
     setLines(lines: readonly string[], logPane?: readonly string[]): void;
     writeLog(text: string): void;
@@ -18,14 +13,4 @@ export interface LiveTickerOptions {
     write(chunk: string): void;
     workerUrl?: URL;
 }
-export declare class TickerFrame {
-    private readonly write;
-    private paintedLines;
-    private cursorHidden;
-    constructor(write: (chunk: string) => void, paintedLines?: readonly string[]);
-    showCursor(): void;
-    clear(columns?: number): void;
-    redraw(lines: readonly string[], columns?: number): void;
-}
-export declare function currentSpinner(unicode: boolean, refreshIntervalMs: number): string;
 export declare function createLiveTicker(options: LiveTickerOptions): LiveTicker;