@promptctl/rich-js 0.9.0 → 0.11.0

package/dist/core/protocol.js

@@ -99,4 +99,3 @@ export function isMeasurable(obj) {
         "measure" in obj &&
         typeof obj.measure === "function");
 }
-//# sourceMappingURL=protocol.js.map

package/dist/core/render.d.ts

@@ -67,4 +67,3 @@ export declare function segmentToString(segment: Segment, colorSystem: ColorDept
  */
 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.js

@@ -29,7 +29,7 @@
  * mechanical fold over it.
  */
 import { ColorDepth, resolveColorSystem } from "./color.js";
-import { stripOscTerminators } from "./sanitize.js";
+import { OSC8_CLOSE, osc8Open } from "./osc8.js";
 const DEFAULT_WIDTH = 80;
 function segmentToPiece(segment, colorSystem) {
     if (segment.isControl)
@@ -86,16 +86,10 @@ export function segmentsToString(segments, colorSystem) {
             while (l < j && pieces[l].link === link)
                 l++;
             if (link) {
-                // [LAW:single-enforcer] Wire-byte trust boundary — sanitize the URL
-                // at the one place it becomes an OSC 8 sequence, regardless of which
-                // upstream API attached it to the Style. Defense-in-depth for the
-                // RichText data-model boundary in text.ts; also covers Style paths
-                // that don't go through RichText (Console.print({style: ...}), any
-                // direct `Segment.applyStyle(... new Style({ link })) ...`).
-                parts.push(`\x1b]8;;${stripOscTerminators(link)}\x1b\\`);
+                parts.push(osc8Open(link));
                 for (let m = k; m < l; m++)
                     parts.push(pieces[m].text);
-                parts.push("\x1b]8;;\x1b\\");
+                parts.push(OSC8_CLOSE);
             }
             else {
                 for (let m = k; m < l; m++)
@@ -141,4 +135,3 @@ export function renderToString(renderable, options) {
     };
     return segmentsToString(renderable.render(renderOptions), colorSystem);
 }
-//# sourceMappingURL=render.js.map

package/dist/core/segment.d.ts

@@ -140,4 +140,3 @@ export declare class Segment {
      */
     static splitAndCropLines(segments: Iterable<Segment>, width: number, pad?: boolean, includeNewLines?: boolean, style?: Style): Segment[][];
 }
-//# sourceMappingURL=segment.d.ts.map

package/dist/core/segment.js

@@ -431,4 +431,3 @@ function stylesEqual(a, b) {
         return false;
     return a.equals(b);
 }
-//# sourceMappingURL=segment.js.map

package/dist/core/spinnerData.d.ts

@@ -8,4 +8,3 @@ export interface SpinnerData {
 }
 export declare const SPINNERS: Record<string, SpinnerData>;
 export declare const DEFAULT_SPINNER = "dots";
-//# sourceMappingURL=spinnerData.d.ts.map

package/dist/core/spinnerData.js

@@ -113,4 +113,3 @@ export const SPINNERS = {
         ], interval: 80 },
 };
 export const DEFAULT_SPINNER = "dots";
-//# sourceMappingURL=spinnerData.js.map

package/dist/core/strip.d.ts

@@ -102,4 +102,3 @@ export declare class GradientJoiner<T extends StyledRenderable = StyledRenderabl
     constructor(options?: GradientJoinerOptions);
     join(left: T | null, right: T | null): Renderable;
 }
-//# sourceMappingURL=strip.d.ts.map

package/dist/core/strip.js

@@ -51,6 +51,18 @@ export class Strip {
             const next = i + 1 < items.length ? items[i + 1] : null;
             yield* this.joiner.join(item, next).render(options);
         }
+        // [LAW:one-source-of-truth] `Strip`'s sibling `FlexStrip` ends every line
+        // it emits, including the last, and the other block-level renderables
+        // (`Panel`/`Rule`/`Table` structurally, `RichText` via `end`) do too — so
+        // `Group` can emit children back to back with nothing in between
+        // (docs/group.md). A `Strip` that left its last line open broke only
+        // under composition: printed alone, Console's own "close whatever the
+        // renderable left open" step (console.ts) papered over it, and a `Group`
+        // of a Strip and a RichText ran the RichText onto the Strip's line
+        // instead of below it. (Not every renderable follows this — a `Spinner`
+        // or `ProgressBar` is a line *fragment*, not a block; see
+        // rich-flexstrip-5kf.4cq for the open question of formalizing that split.)
+        yield Segment.line();
     }
 }
 // --- Helpers ---
@@ -206,4 +218,3 @@ export class GradientJoiner {
         });
     }
 }
-//# sourceMappingURL=strip.js.map

package/dist/core/style.d.ts

@@ -2,7 +2,6 @@
  * Immutable style descriptors — colors, text attributes, links, metadata.
  */
 import { ColorSpec, ColorDepth } from "./color.js";
-import type { TerminalTheme } from "./color.js";
 /**
  * Canonical text-attribute inventory. Single source of truth consumed by
  * `Style.parse` / `Style.toString` and the template bindings — adding an
@@ -38,7 +37,7 @@ export interface StyleOptions {
     meta?: Record<string, unknown>;
 }
 export declare class StyleSyntaxError extends Error {
-    constructor(message: string);
+    constructor(message: string, options?: ErrorOptions);
 }
 export declare class Style {
     readonly color: ColorSpec | undefined;
@@ -85,10 +84,6 @@ export declare class Style {
      * Render text with this style's ANSI escape codes.
      */
     render(text: string, colorSystem?: ColorDepth): string;
-    /**
-     * Returns a CSS style string for HTML rendering.
-     */
-    getHtmlStyle(theme?: TerminalTheme): string;
     /**
      * Serializes to a canonical string that round-trips through `Style.parse()`.
      */
@@ -141,4 +136,3 @@ export declare const DEFAULT_STYLES: Record<string, Style>;
  * a renderable sees outside a `Console`, as in `renderToString`.
  */
 export declare const DEFAULT_THEME: Theme;
-//# sourceMappingURL=style.d.ts.map

package/dist/core/style.js

@@ -1,10 +1,10 @@
 /**
  * Immutable style descriptors — colors, text attributes, links, metadata.
  */
-import { ColorRgba, ColorSpec, } from "./color.js";
-import { stripOscTerminators } from "./sanitize.js";
+import { COLOR_NAMES, ColorRgba, ColorSpec, } from "./color.js";
+import { OSC8_CLOSE, osc8Open } from "./osc8.js";
 // [LAW:one-way-deps] `core/style` depends only on `core/color` and the leaf
-// `core/sanitize` (a dep-free utility module). The substrate fallback is the
+// `core/osc8` (the link wire grammar). The substrate fallback is the
 // canonical canvas color (black), inlined to avoid pulling in any preset
 // theme constants. Preset themes live in `src/themes/` and depend on core,
 // never the reverse.
@@ -64,8 +64,8 @@ export const ATTRIBUTE_SHORT_ALIASES = {
     uu: "underline2",
 };
 export class StyleSyntaxError extends Error {
-    constructor(message) {
-        super(message);
+    constructor(message, options) {
+        super(message, options);
         this.name = "StyleSyntaxError";
     }
 }
@@ -315,57 +315,11 @@ export class Style {
         const codes = this.toSgrCodes(colorSystem);
         let result = codes.length > 0 ? `\x1b[${codes}m${text}\x1b[0m` : text;
         if (this.link) {
-            // [LAW:types-are-the-program] OSC 8 emits with empty params so the
-            // byte stream is a pure function of (style, text, colorSystem) — no
-            // global counter, no construction-order dependence. Tradeoff: terminals
-            // can no longer hover-group non-adjacent same-URL spans (when linked
-            // segments are separated by other content, each becomes its own OSC 8
-            // pair instead of sharing an id). The coalescer in render.ts already
-            // merges adjacent same-link runs into one wrap, so the common case is
-            // unaffected; non-adjacent hover-grouping is the intentional sacrifice.
-            //
-            // [LAW:single-enforcer] Wire-byte sanitization at the OSC 8 emit site
-            // — paired with the same call in render.ts:segmentsToString so every
-            // path that turns `Style.link` into bytes goes through one rule. Style
-            // itself stays a faithful container (this.link is unchanged); only the
-            // bytes going out the door are stripped.
-            result = `\x1b]8;;${stripOscTerminators(this.link)}\x1b\\${result}\x1b]8;;\x1b\\`;
+            // [LAW:single-enforcer] One OSC 8 spelling, shared with segmentsToString.
+            result = `${osc8Open(this.link)}${result}${OSC8_CLOSE}`;
         }
         return result;
     }
-    /**
-     * Returns a CSS style string for HTML rendering.
-     */
-    getHtmlStyle(theme) {
-        if (this.isNull)
-            return "";
-        const parts = [];
-        if (this.color) {
-            const triplet = this.color.getTruecolor(theme, true);
-            parts.push(`color: ${triplet.hex}`);
-        }
-        if (this.bgcolor) {
-            const triplet = this.bgcolor.getTruecolor(theme, false);
-            parts.push(`background-color: ${triplet.hex}`);
-        }
-        if (this.bold)
-            parts.push("font-weight: bold");
-        if (this.italic)
-            parts.push("font-style: italic");
-        const decorations = [];
-        if (this.underline)
-            decorations.push("underline");
-        if (this.strike)
-            decorations.push("line-through");
-        if (this.overline)
-            decorations.push("overline");
-        if (decorations.length > 0) {
-            parts.push(`text-decoration: ${decorations.join(" ")}`);
-        }
-        if (this.dim)
-            parts.push("opacity: 0.5");
-        return parts.join("; ");
-    }
     /**
      * Serializes to a canonical string that round-trips through `Style.parse()`.
      */
@@ -503,6 +457,80 @@ export class Theme {
 }
 // --- Parse helpers ---
 const ATTRIBUTE_SET = new Set(ATTRIBUTE_NAMES);
+// The words each position of a definition can hold: a bare token is a keyword,
+// an attribute or a colour name; `on` takes a colour name; `not` an attribute.
+// The short aliases are left out, since `b` is no help to someone who typed
+// `bolt` and a one-letter name sits one edit from every other short word.
+// [LAW:one-source-of-truth] Derived from the lists the parser accepts from; the
+// keywords are the three `parseStyleDefinition` reads before anything else.
+const FOREGROUND_WORDS = ["not", "on", "link", ...ATTRIBUTE_NAMES, ...COLOR_NAMES];
+/**
+ * Optimal string alignment distance: insertions, deletions, substitutions, and
+ * swaps of two neighbouring letters each cost one edit, so `cyna` is as near
+ * `cyan` as `rd` is to `red`. Kept to three rows, since only the two before the
+ * current one are ever read.
+ */
+function editDistance(a, b) {
+    let before = [];
+    let previous = Array.from({ length: b.length + 1 }, (_, j) => j);
+    for (let i = 1; i <= a.length; i++) {
+        const current = [i];
+        for (let j = 1; j <= b.length; j++) {
+            const swap = i > 1 && j > 1 && a[i - 1] === b[j - 2] && a[i - 2] === b[j - 1];
+            current[j] = Math.min(previous[j] + 1, current[j - 1] + 1, previous[j - 1] + Number(a[i - 1] !== b[j - 1]), swap ? before[j - 2] + 1 : Infinity);
+        }
+        [before, previous] = [previous, current];
+    }
+    return previous[b.length];
+}
+/**
+ * The ` (did you mean …?)` clause for a word no position accepted, or `""`
+ * when nothing in `words` is a plausible typo of it.
+ *
+ * Plausible means within one edit per three letters, at least one, which lets
+ * `rd` reach `red` and keeps `hello` from reaching `yellow`. Every name tied
+ * for nearest is offered: `gold` is one edit from `bold` and from three
+ * `goldN` colours, and choosing among them would be a guess the reader cannot
+ * tell from a finding. Case is not an edit, because the colour parser ignores
+ * it: `Cyna` is as near `cyan` as `cyna` is.
+ *
+ * This runs on every render that meets the bad style, since only successful
+ * parses are cached. Two words differ by at least their difference in length,
+ * so a name outside the budget on length alone is never measured — which is
+ * also what keeps a long garbage token from costing length × length per name.
+ */
+function nearMiss(word, words) {
+    const typed = word.toLowerCase();
+    const budget = Math.max(1, Math.floor(typed.length / 3));
+    const scored = words
+        .filter((name) => Math.abs(name.length - typed.length) <= budget)
+        .map((name) => ({ name, distance: editDistance(typed, name) }));
+    const nearest = Math.min(budget, ...scored.map((s) => s.distance));
+    const names = scored
+        .filter((s) => s.distance === nearest)
+        .map((s) => `"${s.name}"`)
+        .sort();
+    return names.length === 0 ? "" : ` (did you mean ${names.join(" or ")}?)`;
+}
+/**
+ * A style token read as a colour. The colour parser's own error is the reason
+ * the token failed, so it rides along twice: in the message, for a reader with
+ * only the text, and as `cause`, for code that wants the original error.
+ *
+ * [LAW:single-enforcer] Both colour positions in a definition rewrap here, and
+ * the near miss is named here rather than by the colour parser: only a
+ * definition knows whether the token could also have been an attribute.
+ */
+function parseStyleColor(token, failure, words) {
+    try {
+        return ColorSpec.parse(token);
+    }
+    catch (cause) {
+        throw new StyleSyntaxError(`${failure} "${token}"${nearMiss(token, words)}: ${String(cause)}`, {
+            cause,
+        });
+    }
+}
 function parseStyleDefinition(definition) {
     const tokens = definition.split(/\s+/);
     const opts = {};
@@ -518,7 +546,7 @@ function parseStyleDefinition(definition) {
             }
             const attrName = ATTRIBUTE_SHORT_ALIASES[next] ?? next;
             if (!ATTRIBUTE_SET.has(attrName)) {
-                throw new StyleSyntaxError(`Invalid attribute: "${next}"`);
+                throw new StyleSyntaxError(`Invalid attribute: "${next}"${nearMiss(next, ATTRIBUTE_NAMES)}`);
             }
             opts[attrName] = false;
             i++;
@@ -531,12 +559,7 @@ function parseStyleDefinition(definition) {
             if (!next) {
                 throw new StyleSyntaxError(`Expected color after "on" in style definition`);
             }
-            try {
-                opts.bgcolor = ColorSpec.parse(next);
-            }
-            catch {
-                throw new StyleSyntaxError(`Invalid background color: "${next}"`);
-            }
+            opts.bgcolor = parseStyleColor(next, "Invalid background color", COLOR_NAMES);
             i++;
             continue;
         }
@@ -558,12 +581,7 @@ function parseStyleDefinition(definition) {
             continue;
         }
         // Must be a color
-        try {
-            opts.color = ColorSpec.parse(token);
-        }
-        catch {
-            throw new StyleSyntaxError(`Invalid style definition: "${token}"`);
-        }
+        opts.color = parseStyleColor(token, "Invalid style definition", FOREGROUND_WORDS);
         i++;
     }
     return new Style(opts);
@@ -713,4 +731,3 @@ export const DEFAULT_STYLES = {
  * a renderable sees outside a `Console`, as in `renderToString`.
  */
 export const DEFAULT_THEME = new Theme();
-//# sourceMappingURL=style.js.map

package/dist/core/subscription.d.ts

@@ -10,4 +10,3 @@
  * `widgets/types.ts` and the host seam was importing it from there.
  */
 export type Unsubscribe = () => void;
-//# sourceMappingURL=subscription.d.ts.map

package/dist/core/subscription.js

@@ -10,4 +10,3 @@
  * `widgets/types.ts` and the host seam was importing it from there.
  */
 export {};
-//# sourceMappingURL=subscription.js.map

package/dist/core/text.d.ts

@@ -104,8 +104,7 @@ export declare class RichText implements Renderable, Measurable {
     setLength(length: number): this;
     extendStyle(count: number): this;
     /**
-     * Truncate to a fixed cell-column width. Three modes, plus a back-compat
-     * `overflow` form.
+     * Truncate to a fixed cell-column width, in one of three modes.
      *
      * - `mode: "right"` (default) \u2014 drop characters from the right; append
      *   `marker` (if any) at the cut.
@@ -117,10 +116,6 @@ export declare class RichText implements Renderable, Measurable {
      * Marker default is `"\u2026"`. Pass `marker: ""` for raw cropping without an
      * indicator glyph.
      *
-     * Legacy form: `{ overflow: "ellipsis" }` is equivalent to
-     * `{ mode: "right", marker: "\u2026" }`; `{ overflow: "crop" | "fold" }` is
-     * equivalent to `{ marker: "" }`.
-     *
      * Spans are preserved through the cut: characters that survive keep their
      * styling; the marker (if any) is inserted as plain text with no span.
      * Use `stylize(...)` on the result to color the marker if needed.
@@ -130,7 +125,6 @@ export declare class RichText implements Renderable, Measurable {
      * branch \u2014 the unchanged path just early-returns when content fits.
      */
     truncate(width: number, options?: {
-        overflow?: "fold" | "crop" | "ellipsis";
         mode?: "right" | "left" | "middle";
         marker?: string;
     }): this;
@@ -259,4 +253,3 @@ export declare class RichText implements Renderable, Measurable {
      */
     private _fitLine;
 }
-//# sourceMappingURL=text.d.ts.map

package/dist/core/text.js

@@ -5,7 +5,7 @@ import { cellLen, cellCount } from "./cells.js";
 import { divideLine } from "./wrap.js";
 import { Segment } from "./segment.js";
 import { Style, NULL_STYLE, StyleSyntaxError } from "./style.js";
-import { stripOscTerminators } from "./sanitize.js";
+import { stripOscTerminators } from "./osc8.js";
 import { getStyle, withBoundedWidth } from "./protocol.js";
 // Strip control characters except \t and \n
 // [LAW:single-enforcer] Single place where control chars are sanitized
@@ -76,21 +76,29 @@ function isEmptyStyle(style) {
 /**
  * The style a stored `string | Style` stands for in this render.
  *
+ * A parsed string can carry a link, so the result is sanitized on the way out
+ * as well.
+ */
+function resolveStyle(options, style) {
+    return sanitizeStyleLink(style instanceof Style ? style : resolveDefinition(options, style));
+}
+/**
  * [LAW:single-enforcer] Styling is non-critical — an unrecognized style name
  * (typo, missing theme key, bad concatenation) degrades to unstyled rather
  * than crashing, as the reference's `Text.render` resolves with a null
  * default. Absorb only StyleSyntaxError here; other errors are genuine bugs
- * and must surface. A parsed string can carry a link, so the result is
- * sanitized on the way out as well.
+ * and must surface. The render's `onStyleError` hears about each one first,
+ * and a handler that throws turns the degrade into a failure.
  */
-function resolveStyle(options, style) {
+function resolveDefinition(options, style) {
     try {
-        return sanitizeStyleLink(getStyle(options, style));
+        return getStyle(options, style);
     }
     catch (err) {
-        if (err instanceof StyleSyntaxError)
-            return NULL_STYLE;
-        throw err;
+        if (!(err instanceof StyleSyntaxError))
+            throw err;
+        options.onStyleError?.(err, style);
+        return NULL_STYLE;
     }
 }
 // --- Span ---
@@ -467,8 +475,7 @@ export class RichText {
     }
     // --- Truncation ---
     /**
-     * Truncate to a fixed cell-column width. Three modes, plus a back-compat
-     * `overflow` form.
+     * Truncate to a fixed cell-column width, in one of three modes.
      *
      * - `mode: "right"` (default) \u2014 drop characters from the right; append
      *   `marker` (if any) at the cut.
@@ -480,10 +487,6 @@ export class RichText {
      * Marker default is `"\u2026"`. Pass `marker: ""` for raw cropping without an
      * indicator glyph.
      *
-     * Legacy form: `{ overflow: "ellipsis" }` is equivalent to
-     * `{ mode: "right", marker: "\u2026" }`; `{ overflow: "crop" | "fold" }` is
-     * equivalent to `{ marker: "" }`.
-     *
      * Spans are preserved through the cut: characters that survive keep their
      * styling; the marker (if any) is inserted as plain text with no span.
      * Use `stylize(...)` on the result to color the marker if needed.
@@ -495,15 +498,8 @@ export class RichText {
     truncate(width, options) {
         if (this.cellLength <= width)
             return this;
-        const overflow = options?.overflow;
         const mode = options?.mode ?? "right";
-        const marker = options?.marker !== undefined
-            ? options.marker
-            : overflow === "ellipsis"
-                ? "\u2026"
-                : overflow === undefined && options?.mode !== undefined
-                    ? "\u2026"
-                    : "";
+        const marker = options?.marker ?? "\u2026";
         const markerWidth = cellLen(marker);
         if (width <= 0) {
             this.plain = "";
@@ -697,11 +693,6 @@ export class RichText {
     // --- Renderable ---
     *render(options) {
         const text = this._expandTabs(this._text);
-        if (text.length === 0) {
-            if (this._end)
-                yield new Segment(this._end);
-            return;
-        }
         const base = this.resolvedStyle(options);
         const allSegments = this._buildSegments(text, base, options);
         const logicalLines = Segment.splitLines(allSegments);
@@ -744,7 +735,13 @@ export class RichText {
                 }
             }
         }
-        if (this._end && this._end !== "\n") {
+        // [LAW:single-enforcer] The one place `end` is emitted, for empty and
+        // non-empty text alike — the pre-fix code checked it once for empty text
+        // (truthy) and again for non-empty text (truthy and not the default
+        // "\n"), which gave `end` two meanings depending on whether the text was
+        // empty (rich-text-5ai). Empty text takes zero iterations of the loop
+        // above, so this is reached either way with nothing yielded but this.
+        if (this._end) {
             yield new Segment(this._end);
         }
     }
@@ -990,4 +987,3 @@ export class RichText {
         yield* Segment.adjustLineLength(line, maxWidth, undefined, false);
     }
 }
-//# sourceMappingURL=text.js.map

package/dist/core/wrap.d.ts

@@ -39,4 +39,3 @@ import { type CellCol } from "./cells.js";
 export declare function divideLine(text: string, width: CellCol, options: {
     fold: boolean;
 }): CellCol[];
-//# sourceMappingURL=wrap.d.ts.map

package/dist/core/wrap.js

@@ -125,4 +125,3 @@ export function divideLine(text, width, options) {
     }
     return cuts;
 }
-//# sourceMappingURL=wrap.js.map

package/dist/host/host-stream.d.ts

@@ -28,4 +28,3 @@ import type { TerminalHost } from "./terminal-host.js";
  * defeats the point.
  */
 export declare function hostStream(host: TerminalHost): ConsoleSink;
-//# sourceMappingURL=host-stream.d.ts.map

package/dist/host/host-stream.js

@@ -33,4 +33,3 @@ export function hostStream(host) {
         },
     };
 }
-//# sourceMappingURL=host-stream.js.map

package/dist/host/index.d.ts

@@ -1,4 +1,3 @@
 export { BrowserTerminalHost } from "./terminal-host.js";
 export type { TerminalHost, TerminalSize, DataHandler, ResizeHandler, BrowserTerminalHostOptions, XtermTerminal, XtermDisposable, XtermResizeEvent, } from "./terminal-host.js";
 export { hostStream } from "./host-stream.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/host/index.js

@@ -1,3 +1,2 @@
 export { BrowserTerminalHost } from "./terminal-host.js";
 export { hostStream } from "./host-stream.js";
-//# sourceMappingURL=index.js.map

package/dist/host/terminal-host.d.ts

@@ -141,4 +141,3 @@ export declare class BrowserTerminalHost implements TerminalHost {
     start(): void;
     stop(): void;
 }
-//# sourceMappingURL=terminal-host.d.ts.map

package/dist/host/terminal-host.js

@@ -130,4 +130,3 @@ export class BrowserTerminalHost {
         this.resizeHandlers.clear();
     }
 }
-//# sourceMappingURL=terminal-host.js.map

package/dist/index.d.ts

@@ -23,7 +23,7 @@ export { Box } from "./core/box.js";
 export type { EdgeChars, ContentChars, RowLevel, SubstituteOptions } from "./core/box.js";
 export { ASCII, ASCII2, ASCII_DOUBLE_HEAD, SQUARE, SQUARE_DOUBLE_HEAD, MINIMAL, MINIMAL_HEAVY_HEAD, MINIMAL_DOUBLE_HEAD, SIMPLE, SIMPLE_HEAD, SIMPLE_HEAVY, HORIZONTALS, ROUNDED, HEAVY, HEAVY_EDGE, HEAVY_HEAD, DOUBLE, DOUBLE_EDGE, MARKDOWN, } from "./core/box.js";
 export { isRenderable, isMeasurable, withCellWidth, withBoundedWidth, } from "./core/protocol.js";
-export type { RenderOptions, Renderable, Measurable, } from "./core/protocol.js";
+export type { RenderOptions, Renderable, Measurable, StyleErrorHandler, } from "./core/protocol.js";
 export type { Unsubscribe } from "./core/subscription.js";
 export { Measurement, measureRenderables } from "./core/measure.js";
 export { Span, RichText } from "./core/text.js";
@@ -32,10 +32,12 @@ export { Strip, PowerlineJoiner, CapsuleJoiner, PlainJoiner, GradientJoiner, } f
 export type { StyledRenderable, Joiner, PowerlineJoinerOptions, CapsuleJoinerOptions, PlainJoinerOptions, GradientJoinerOptions, } from "./core/strip.js";
 export { renderToString, segmentToString, segmentsToString, } from "./core/render.js";
 export type { RenderToStringOptions } from "./core/render.js";
+export { OSC8, osc8Sequences } from "./core/osc8.js";
+export type { Osc8Sequence } from "./core/osc8.js";
 export { MarkupRegistry, globalMarkupRegistry, renderMarkup, } from "./core/markup.js";
 export type { MarkupTagContext, MarkupTagHandler, RenderMarkupOptions, } from "./core/markup.js";
 export { EMOJI, emojiReplace, Emoji, NoEmoji } from "./core/emoji.js";
-export { MarkupError, escape as escapeMarkup } from "./core/markup.js";
+export { MarkupError, MarkupSyntaxError, escape as escapeMarkup } from "./core/markup.js";
 export { Highlighter, NullHighlighter, RegexHighlighter, ReprHighlighter, JSONHighlighter, ISO8601Highlighter, } from "./core/highlighter.js";
 export { Pretty } from "./core/pretty.js";
 export type { PrettyOptions } from "./core/pretty.js";
@@ -83,4 +85,3 @@ export { Markdown } from "./renderables/markdown.js";
 export type { MarkdownOptions } from "./renderables/markdown.js";
 export { Layout } from "./renderables/layout.js";
 export type { LayoutOptions } from "./renderables/layout.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -41,12 +41,14 @@ export { Span, RichText } from "./core/text.js";
 export { Strip, PowerlineJoiner, CapsuleJoiner, PlainJoiner, GradientJoiner, } from "./core/strip.js";
 // renderToString — stateless one-shot emission
 export { renderToString, segmentToString, segmentsToString, } from "./core/render.js";
+// OSC 8 hyperlink wire grammar — for consumers that read rendered bytes back
+export { OSC8, osc8Sequences } from "./core/osc8.js";
 // Markup plugin tags
 export { MarkupRegistry, globalMarkupRegistry, renderMarkup, } from "./core/markup.js";
 // Emoji
 export { EMOJI, emojiReplace, Emoji, NoEmoji } from "./core/emoji.js";
 // Markup
-export { MarkupError, escape as escapeMarkup } from "./core/markup.js";
+export { MarkupError, MarkupSyntaxError, escape as escapeMarkup } from "./core/markup.js";
 // Highlighter
 export { Highlighter, NullHighlighter, RegexHighlighter, ReprHighlighter, JSONHighlighter, ISO8601Highlighter, } from "./core/highlighter.js";
 // Pretty
@@ -100,4 +102,3 @@ export { Layout } from "./renderables/layout.js";
 //
 // This is also why there is no widget list here to keep in sync: `src/widgets/index.ts`
 // is that list, and a copy of it in this file would be a second one to drift from.
-//# sourceMappingURL=index.js.map

package/dist/node/prompt.d.ts

@@ -19,4 +19,3 @@
  */
 import type { PromptInput } from "../renderables/prompt.js";
 export declare const nodeAsk: PromptInput;
-//# sourceMappingURL=prompt.d.ts.map

package/dist/node/prompt.js

@@ -28,4 +28,3 @@ export const nodeAsk = (prompt) => new Promise((resolve) => {
         resolve(answer);
     });
 });
-//# sourceMappingURL=prompt.js.map

package/dist/node/save.d.ts

@@ -13,10 +13,5 @@
  * the IO sink.
  */
 import type { Console } from "../core/console.js";
-export declare function saveText(out: Console, path: string, options?: {
-    clear?: boolean;
-}): void;
-export declare function saveHtml(out: Console, path: string, options?: {
-    clear?: boolean;
-}): void;
-//# sourceMappingURL=save.d.ts.map
+export declare function saveText(out: Console, path: string, options?: Parameters<Console["exportText"]>[0]): void;
+export declare function saveHtml(out: Console, path: string, options?: Parameters<Console["exportHtml"]>[0]): void;

package/dist/node/save.js

@@ -19,4 +19,3 @@ export function saveText(out, path, options) {
 export function saveHtml(out, path, options) {
     writeFileSync(path, out.exportHtml(options), "utf-8");
 }
-//# sourceMappingURL=save.js.map

package/dist/node/terminal-host.d.ts

@@ -82,4 +82,3 @@ export declare class NodeTerminalHost implements TerminalHost {
     stop(): void;
 }
 export {};
-//# sourceMappingURL=terminal-host.d.ts.map

package/dist/node/terminal-host.js

@@ -158,4 +158,3 @@ export class NodeTerminalHost {
         }
     }
 }
-//# sourceMappingURL=terminal-host.js.map

package/dist/node/traceback.d.ts

@@ -25,4 +25,3 @@ import type { TracebackOptions } from "../renderables/traceback.js";
  * renderer no matter how many entry points reach for it.
  */
 export declare function installTraceback(options?: TracebackOptions): void;
-//# sourceMappingURL=traceback.d.ts.map