@promptctl/rich-js 0.1.0

package/dist/core/markup.js

@@ -0,0 +1,401 @@
+/**
+ * Markup — BBCode-inspired markup parser for inline styling.
+ * Parses `[bold red]text[/bold red]` into RichText with styled spans.
+ *
+ * Plugin tags ([LAW:locality-or-seam]): a `MarkupRegistry` lets consumers
+ * register tag handlers without forking the parser. When the parser sees
+ * `[name attrs...]inner[/name]` and `name` is registered, it parses attrs,
+ * recursively renders the inner markup as a child Renderable, and calls the
+ * handler — splicing the handler's returned Renderable into the output. The
+ * built-in style dialect and the plugin dialect are routed by the registry,
+ * which is the single trust boundary between them.
+ */
+import { Style, StyleSyntaxError } from "./style.js";
+import { RichText, Span } from "./text.js";
+import { emojiReplace } from "./emoji.js";
+// --- Tag ---
+export class Tag {
+    name;
+    parameters;
+    constructor(name, parameters) {
+        this.name = name;
+        this.parameters = parameters;
+    }
+    toString() {
+        return this.parameters !== undefined
+            ? `${this.name} ${this.parameters}`
+            : this.name;
+    }
+    get markup() {
+        return this.parameters !== undefined
+            ? `[${this.name}=${this.parameters}]`
+            : `[${this.name}]`;
+    }
+}
+// --- MarkupError ---
+export class MarkupError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "MarkupError";
+    }
+}
+// --- escape ---
+/**
+ * Escapes markup characters so they render as literal text.
+ */
+export function escape(text) {
+    return text.replace(/\[/g, "\\[");
+}
+// --- render ---
+// Fast path: if no `[` in text, skip parsing entirely
+const HAS_TAG_RE = /\[/;
+// Match tags: [style], [/style], [/], [name=params]
+// Also handles escaped brackets: \[
+const TAG_RE = /(?:\\\[)|(\[(?:\/?)(?:[a-zA-Z#][a-zA-Z0-9_.# -]*(?:=[^\]]*)?|\/)\])/g;
+function parseTags(markup) {
+    const tags = [];
+    const re = new RegExp(TAG_RE.source, TAG_RE.flags);
+    let match;
+    while ((match = re.exec(markup)) !== null) {
+        // Escaped bracket
+        if (match[0] === "\\[")
+            continue;
+        const captured = match[1];
+        if (!captured)
+            continue;
+        const inner = captured.slice(1, -1); // Remove [ ]
+        const isImplicitClose = inner === "/";
+        const isClosing = inner.startsWith("/") && !isImplicitClose;
+        const stylePart = isClosing ? inner.slice(1) : inner;
+        // Check for parameters (name=value)
+        const eqIdx = stylePart.indexOf("=");
+        const styleName = eqIdx >= 0 ? stylePart.slice(0, eqIdx).trim() : stylePart.trim();
+        const parameters = eqIdx >= 0 ? stylePart.slice(eqIdx + 1) : undefined;
+        tags.push({
+            fullMatch: captured,
+            isClosing,
+            isImplicitClose,
+            styleName,
+            parameters,
+            start: match.index,
+            end: match.index + match[0].length,
+        });
+    }
+    return tags;
+}
+/**
+ * Parses markup text and returns a RichText with appropriate spans.
+ */
+export function render(markup, baseStyle, options) {
+    // Fast path: no brackets at all
+    if (!HAS_TAG_RE.test(markup)) {
+        let text = markup;
+        if (options?.emoji !== false) {
+            text = emojiReplace(text);
+        }
+        const result = new RichText(text);
+        if (baseStyle)
+            result.stylize(baseStyle);
+        return result;
+    }
+    const tags = parseTags(markup);
+    const doEmoji = options?.emoji !== false;
+    // Build plain text and track spans
+    let plainText = "";
+    const spans = [];
+    const openStack = [];
+    let lastEnd = 0;
+    for (const tag of tags) {
+        // Add text before this tag
+        const textBefore = markup.slice(lastEnd, tag.start);
+        const processed = unescapeBrackets(doEmoji ? emojiReplace(textBefore) : textBefore);
+        plainText += processed;
+        if (tag.isImplicitClose) {
+            // [/] — close the most recent open tag
+            if (openStack.length === 0) {
+                throw new MarkupError("Closing tag [/] has nothing to close");
+            }
+            const opened = openStack.pop();
+            const styleStr = opened.parameters !== undefined
+                ? `${opened.styleName} ${opened.parameters}`
+                : opened.styleName;
+            spans.push(new Span(opened.textStart, plainText.length, styleStr));
+        }
+        else if (tag.isClosing) {
+            // [/style] — find and close matching open tag
+            const idx = findLastOpen(openStack, tag.styleName);
+            if (idx === -1) {
+                throw new MarkupError(`Closing tag [/${tag.styleName}] doesn't match any open tag`);
+            }
+            const opened = openStack[idx];
+            const styleStr = opened.parameters !== undefined
+                ? `${opened.styleName} ${opened.parameters}`
+                : opened.styleName;
+            spans.push(new Span(opened.textStart, plainText.length, styleStr));
+            openStack.splice(idx, 1);
+        }
+        else {
+            // Opening tag
+            openStack.push({
+                styleName: tag.styleName,
+                parameters: tag.parameters,
+                textStart: plainText.length,
+            });
+        }
+        lastEnd = tag.end;
+    }
+    // Add remaining text after last tag
+    const trailing = markup.slice(lastEnd);
+    const processedTrailing = unescapeBrackets(doEmoji ? emojiReplace(trailing) : trailing);
+    plainText += processedTrailing;
+    // Auto-close any remaining open tags
+    for (const opened of openStack) {
+        const styleStr = opened.parameters !== undefined
+            ? `${opened.styleName} ${opened.parameters}`
+            : opened.styleName;
+        spans.push(new Span(opened.textStart, plainText.length, styleStr));
+    }
+    const result = new RichText(plainText);
+    if (baseStyle)
+        result.stylize(baseStyle);
+    // Apply link parameters as link styles
+    for (const span of spans) {
+        const style = typeof span.style === "string" ? span.style : span.style.toString();
+        // Check if this is a link tag (name=url pattern was parsed)
+        const linkMatch = /^link\s+(.+)$/.exec(style);
+        if (linkMatch) {
+            result.stylize(new Style({ link: linkMatch[1] }), span.start, span.end);
+        }
+        else {
+            result.stylize(style, span.start, span.end);
+        }
+    }
+    return result;
+}
+function findLastOpen(stack, name) {
+    // Handle "on" in style names for closing: [/red on blue] should match [red on blue]
+    const normalized = name.trim();
+    for (let i = stack.length - 1; i >= 0; i--) {
+        const entry = stack[i];
+        const entryFull = entry.parameters !== undefined
+            ? `${entry.styleName} ${entry.parameters}`
+            : entry.styleName;
+        if (entryFull === normalized || entry.styleName === normalized)
+            return i;
+    }
+    return -1;
+}
+function unescapeBrackets(text) {
+    return text.replace(/\\\[/g, "[");
+}
+export class MarkupRegistry {
+    _handlers = new Map();
+    register(name, handler) {
+        if (isReservedTagName(name)) {
+            throw new MarkupError(`Cannot register markup tag "${name}": name is reserved by a built-in style.`);
+        }
+        this._handlers.set(name, handler);
+    }
+    unregister(name) {
+        this._handlers.delete(name);
+    }
+    has(name) {
+        return this._handlers.has(name);
+    }
+    get(name) {
+        return this._handlers.get(name);
+    }
+}
+// [LAW:one-source-of-truth] Reserved-name detection delegates to Style.parse —
+// if a name is a valid built-in style, it cannot be hijacked by a plugin.
+// There is no second list of "reserved names" to drift out of sync.
+function isReservedTagName(name) {
+    try {
+        Style.parse(name);
+        return true;
+    }
+    catch (err) {
+        if (err instanceof StyleSyntaxError)
+            return false;
+        throw err;
+    }
+}
+export const globalMarkupRegistry = new MarkupRegistry();
+export function registerMarkupTag(name, handler) {
+    globalMarkupRegistry.register(name, handler);
+}
+export function unregisterMarkupTag(name) {
+    globalMarkupRegistry.unregister(name);
+}
+// --- Plugin-aware tag parsing ---
+function isAlpha(c) {
+    const cc = c.charCodeAt(0);
+    return (cc >= 65 && cc <= 90) || (cc >= 97 && cc <= 122);
+}
+function isIdentChar(c) {
+    if (isAlpha(c))
+        return true;
+    const cc = c.charCodeAt(0);
+    return (cc >= 48 && cc <= 57) || c === "_" || c === "-";
+}
+function isSpace(c) {
+    return c === " " || c === "\t";
+}
+function pluginNameOf(inner) {
+    if (inner.length === 0 || !isAlpha(inner[0]))
+        return null;
+    let i = 1;
+    while (i < inner.length && isIdentChar(inner[i]))
+        i++;
+    return inner.slice(0, i);
+}
+function parsePluginAttrs(after) {
+    // Hand-written tokenizer. Walks `key=value` pairs separated by whitespace;
+    // values may be bare, single-quoted, or double-quoted. Matches the syntax
+    // the regex it replaces accepted.
+    const attrs = {};
+    let i = 0;
+    while (i < after.length) {
+        while (i < after.length && isSpace(after[i]))
+            i++;
+        if (i >= after.length)
+            break;
+        if (!isAlpha(after[i])) {
+            // Skip a stray non-name character to avoid infinite loops on malformed
+            // input — the legacy regex would simply fail to match here.
+            i++;
+            continue;
+        }
+        const nameStart = i;
+        while (i < after.length && isIdentChar(after[i]))
+            i++;
+        const name = after.slice(nameStart, i);
+        while (i < after.length && isSpace(after[i]))
+            i++;
+        if (after[i] !== "=")
+            continue;
+        i++;
+        while (i < after.length && isSpace(after[i]))
+            i++;
+        let value = "";
+        const quote = after[i];
+        if (quote === '"' || quote === "'") {
+            i++;
+            const valStart = i;
+            while (i < after.length && after[i] !== quote)
+                i++;
+            value = after.slice(valStart, i);
+            if (i < after.length)
+                i++;
+        }
+        else {
+            const valStart = i;
+            while (i < after.length && !isSpace(after[i]) && after[i] !== "]")
+                i++;
+            value = after.slice(valStart, i);
+        }
+        attrs[name] = value;
+    }
+    return attrs;
+}
+/**
+ * Plugin-aware markup render. Always returns a `RichText`. Built-in style
+ * tags become spans; registered plugin tags are resolved by their handler,
+ * whose returned `RichText` is appended (text + spans) into the output. The
+ * recursion is over markup *slices* — between top-level plugin tag pairs and
+ * inside each pair — and every recursion node returns a `RichText`, so the
+ * append path is uniform.
+ */
+export function renderMarkup(markup, options) {
+    const registry = options?.registry ?? globalMarkupRegistry;
+    const baseStyle = options?.baseStyle;
+    const doEmoji = options?.emoji !== false;
+    // Fast path: no `[` at all → no possible tags.
+    if (!HAS_TAG_RE.test(markup)) {
+        return render(markup, baseStyle, { emoji: doEmoji });
+    }
+    const tags = parseTags(markup);
+    // Pair each opening plugin tag with its matching closer up-front, so the
+    // splice walk can just iterate top-level pairs in source order with no
+    // nested-state book-keeping.
+    const { annotated, topLevel: tagPairs } = pairPluginTags(tags, registry);
+    if (tagPairs.size === 0) {
+        return render(markup, baseStyle, { emoji: doEmoji });
+    }
+    // [LAW:one-type-per-behavior] Always assemble a single RichText. Fragments
+    // between plugin pairs are parsed by the built-in `render`, plugin pairs
+    // hand their inner slice (recursively) to a handler; both produce RichText,
+    // both get appended into one accumulator.
+    const out = new RichText("");
+    let cursor = 0;
+    for (const [openIdx, closeIdx] of tagPairs) {
+        const open = annotated[openIdx];
+        const close = annotated[closeIdx];
+        if (open.start > cursor) {
+            out.append(render(markup.slice(cursor, open.start), baseStyle, { emoji: doEmoji }));
+        }
+        const innerRaw = markup.slice(open.end, close.start);
+        const innerRichText = renderMarkup(innerRaw, options);
+        const handler = registry.get(open.pluginName);
+        out.append(handler({ attrs: open.attrs, children: innerRichText, raw: innerRaw }));
+        cursor = close.end;
+    }
+    if (cursor < markup.length) {
+        out.append(render(markup.slice(cursor), baseStyle, { emoji: doEmoji }));
+    }
+    if (baseStyle)
+        out.stylize(baseStyle);
+    return out;
+}
+function pairPluginTags(tags, registry) {
+    // Annotate tags with plugin info, then pair openers with closers. Only
+    // top-level pairs are returned; inner pairs will be re-discovered by the
+    // recursive `renderMarkup` call on the inner slice.
+    const annotated = tags.map((t) => annotatePluginTag(t, registry));
+    const stack = [];
+    const pairs = new Map();
+    for (let i = 0; i < annotated.length; i++) {
+        const t = annotated[i];
+        if (!t.pluginName)
+            continue;
+        if (t.isImplicitClose)
+            continue;
+        if (t.isClosing) {
+            // Find matching open in stack.
+            for (let j = stack.length - 1; j >= 0; j--) {
+                const openIdx = stack[j];
+                if (annotated[openIdx].pluginName === t.pluginName) {
+                    pairs.set(openIdx, i);
+                    stack.splice(j, 1);
+                    break;
+                }
+            }
+        }
+        else {
+            stack.push(i);
+        }
+    }
+    // Filter pairs to top-level only.
+    const topLevel = new Map();
+    let outerEnd = -1;
+    const sortedOpens = [...pairs.keys()].sort((a, b) => a - b);
+    for (const openIdx of sortedOpens) {
+        if (annotated[openIdx].start < outerEnd)
+            continue;
+        topLevel.set(openIdx, pairs.get(openIdx));
+        outerEnd = annotated[pairs.get(openIdx)].end;
+    }
+    return { annotated, topLevel };
+}
+function annotatePluginTag(tag, registry) {
+    // The legacy parser splits at the first `=`, so tag.styleName for
+    // `[click verb=foo]` is "click verb". Re-extract the leading identifier.
+    const inner = tag.fullMatch.slice(1, -1).replace(/^\//, "");
+    const name = pluginNameOf(inner);
+    if (!name || !registry.has(name))
+        return tag;
+    const after = inner.slice(name.length);
+    const attrs = tag.isClosing ? {} : parsePluginAttrs(after);
+    return { ...tag, pluginName: name, attrs };
+}
+//# sourceMappingURL=markup.js.map

package/dist/core/markup.js.map

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

package/dist/core/measure.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Measurement — min/max cell width calculation for renderables.
+ */
+import type { Measurable, RenderOptions } from "./protocol.js";
+export declare class Measurement {
+    readonly minimum: number;
+    readonly maximum: number;
+    constructor(minimum: number, maximum: number);
+    get span(): number;
+    normalize(): Measurement;
+    withMaximum(width: number): Measurement;
+    withMinimum(width: number): Measurement;
+    clamp(minWidth: number, maxWidth: number): Measurement;
+    static get(options: RenderOptions, measurable: Measurable): Measurement;
+}
+export declare function measureRenderables(options: RenderOptions, measurables: Measurable[]): Measurement;
+//# sourceMappingURL=measure.d.ts.map

package/dist/core/measure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"measure.d.ts","sourceRoot":"","sources":["../../src/core/measure.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE/D,qBAAa,WAAW;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBAEb,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAK5C,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,SAAS,IAAI,WAAW;IAMxB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW;IAOvC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW;IAMvC,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW;IAQtD,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,GAAG,WAAW;CAKxE;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,aAAa,EACtB,WAAW,EAAE,UAAU,EAAE,GACxB,WAAW,CAUb"}

package/dist/core/measure.js

@@ -0,0 +1,50 @@
+/**
+ * Measurement — min/max cell width calculation for renderables.
+ */
+export class Measurement {
+    minimum;
+    maximum;
+    constructor(minimum, maximum) {
+        this.minimum = minimum;
+        this.maximum = maximum;
+    }
+    get span() {
+        return this.maximum - this.minimum;
+    }
+    normalize() {
+        const min = Math.max(0, Math.min(this.minimum, this.maximum));
+        const max = Math.max(0, this.maximum);
+        return new Measurement(min, max);
+    }
+    withMaximum(width) {
+        return new Measurement(Math.min(this.minimum, width), Math.min(this.maximum, width));
+    }
+    withMinimum(width) {
+        const min = Math.max(this.minimum, width);
+        const max = Math.max(this.maximum, min);
+        return new Measurement(min, max);
+    }
+    clamp(minWidth, maxWidth) {
+        return new Measurement(Math.min(Math.max(this.minimum, minWidth), maxWidth), Math.min(Math.max(this.maximum, minWidth), maxWidth));
+    }
+    // [LAW:single-enforcer] Single entry point for measuring a Measurable
+    static get(options, measurable) {
+        if (options.maxWidth < 1)
+            return new Measurement(0, 0);
+        const { minimum, maximum } = measurable.measure(options);
+        return new Measurement(minimum, Math.min(maximum, options.maxWidth));
+    }
+}
+export function measureRenderables(options, measurables) {
+    if (measurables.length === 0)
+        return new Measurement(0, 0);
+    let minOfAll = 0;
+    let maxOfAll = 0;
+    for (const m of measurables) {
+        const measurement = Measurement.get(options, m);
+        minOfAll = Math.max(minOfAll, measurement.minimum);
+        maxOfAll = Math.max(maxOfAll, measurement.maximum);
+    }
+    return new Measurement(minOfAll, maxOfAll);
+}
+//# sourceMappingURL=measure.js.map

package/dist/core/measure.js.map

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

package/dist/core/protocol.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Rendering protocol interfaces — Renderable, Measurable, RenderOptions.
+ * [LAW:one-source-of-truth] These interfaces are the single authority for the rendering contract.
+ */
+import type { Segment } from "./segment.js";
+export interface RenderOptions {
+    maxWidth: number;
+    minWidth?: number;
+    height?: number;
+    maxHeight?: number;
+    isTerminal?: boolean;
+    encoding?: string;
+    legacyWindows?: boolean;
+    asciiOnly?: boolean;
+    justify?: "left" | "center" | "right" | "full";
+    overflow?: "fold" | "crop" | "ellipsis";
+    noWrap?: boolean;
+    highlight?: unknown;
+    markup?: unknown;
+}
+export interface Renderable {
+    render(options: RenderOptions): Iterable<Segment>;
+}
+export interface Measurable {
+    measure(options: RenderOptions): {
+        minimum: number;
+        maximum: number;
+    };
+}
+export declare function isRenderable(obj: unknown): obj is Renderable;
+export declare function isMeasurable(obj: unknown): obj is Measurable;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/core/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/core/protocol.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;IAC/C,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC;IACxC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CACvE;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,UAAU,CAO5D;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,UAAU,CAO5D"}

package/dist/core/protocol.js

@@ -0,0 +1,17 @@
+/**
+ * Rendering protocol interfaces — Renderable, Measurable, RenderOptions.
+ * [LAW:one-source-of-truth] These interfaces are the single authority for the rendering contract.
+ */
+export function isRenderable(obj) {
+    return (typeof obj === "object" &&
+        obj !== null &&
+        "render" in obj &&
+        typeof obj.render === "function");
+}
+export function isMeasurable(obj) {
+    return (typeof obj === "object" &&
+        obj !== null &&
+        "measure" in obj &&
+        typeof obj.measure === "function");
+}
+//# sourceMappingURL=protocol.js.map

package/dist/core/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/core/protocol.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA4BH,MAAM,UAAU,YAAY,CAAC,GAAY;IACvC,OAAO,CACL,OAAO,GAAG,KAAK,QAAQ;QACvB,GAAG,KAAK,IAAI;QACZ,QAAQ,IAAI,GAAG;QACf,OAAQ,GAAkB,CAAC,MAAM,KAAK,UAAU,CACjD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAY;IACvC,OAAO,CACL,OAAO,GAAG,KAAK,QAAQ;QACvB,GAAG,KAAK,IAAI;QACZ,SAAS,IAAI,GAAG;QAChB,OAAQ,GAAkB,CAAC,OAAO,KAAK,UAAU,CAClD,CAAC;AACJ,CAAC"}

package/dist/core/render.d.ts

@@ -0,0 +1,51 @@
+/**
+ * `renderToString` — stateless one-shot emission of a `Renderable` to a string
+ * of ANSI-encoded text. Pure function: same inputs produce byte-identical
+ * output. Does not write to `process.stdout` and does not require a `Console`
+ * instance.
+ *
+ * Note on `colorSystem: "auto"`: the `"auto"` spec resolves via
+ * `detectColorSystem`, which reads `process.env` and `process.stdout?.isTTY`
+ * by default. Callers that want a fully deterministic render must either pass
+ * an explicit `ColorDepth` enum / non-`"auto"` spec, or supply `env` and
+ * `isTTY` in the options so detection does not consult ambient process state.
+ *
+ * [LAW:single-enforcer] The Segment-to-ANSI conversion lives in `segmentsToString`
+ * and is the single way segments become wire bytes. `Console._renderSegment`
+ * delegates here, so terminal output and string export agree by construction.
+ *
+ * [LAW:dataflow-not-control-flow] The same loop runs every render: walk the
+ * generator, drop control segments, encode each remaining segment with the
+ * configured color system. `colorSystem === null` is data — it makes
+ * `Style.render` skip codes — not a separate code path.
+ */
+import { ColorDepth } from "./color.js";
+import type { Segment } from "./segment.js";
+import type { Renderable } from "./protocol.js";
+export interface RenderToStringOptions {
+    /** Cell width to render into. Default 80. */
+    width?: number;
+    /**
+     * Color encoding to emit. Accepts a string spec (`"auto"`, `"truecolor"`,
+     * `"256"`, `"ansi"`, `"none"`), a `ColorDepth` enum value, or `null` to
+     * strip all color codes. Default truecolor.
+     */
+    colorSystem?: string | ColorDepth | null;
+    /**
+     * Environment to consult when `colorSystem` is `"auto"`. Defaults to
+     * `process.env`. Pass an explicit value to keep rendering deterministic.
+     */
+    env?: NodeJS.ProcessEnv;
+    /**
+     * Whether output is going to a TTY when `colorSystem` is `"auto"`. Defaults
+     * to `process.stdout?.isTTY`. Pass an explicit value to keep rendering
+     * deterministic.
+     */
+    isTTY?: boolean;
+    /** When true, forces `colorSystem` to `null` regardless of the explicit value. */
+    noColor?: boolean;
+}
+export declare function segmentToString(segment: Segment, colorSystem: ColorDepth | null): string;
+export declare function segmentsToString(segments: Iterable<Segment>, colorSystem: ColorDepth | null): string;
+export declare function renderToString(renderable: Renderable, options?: RenderToStringOptions): string;
+//# sourceMappingURL=render.d.ts.map

package/dist/core/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/core/render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,UAAU,EAAsB,MAAM,YAAY,CAAC;AAE5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAiB,MAAM,eAAe,CAAC;AAE/D,MAAM,WAAW,qBAAqB;IACpC,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;IACzC;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kFAAkF;IAClF,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAID,wBAAgB,eAAe,CAC7B,OAAO,EAAE,OAAO,EAChB,WAAW,EAAE,UAAU,GAAG,IAAI,GAC7B,MAAM,CAIR;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,EAC3B,WAAW,EAAE,UAAU,GAAG,IAAI,GAC7B,MAAM,CAIR;AAED,wBAAgB,cAAc,CAC5B,UAAU,EAAE,UAAU,EACtB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,MAAM,CA8BR"}