@promptctl/rich-js 0.10.0 → 0.12.0

package/dist/core/style.js

@@ -1,14 +1,14 @@
 /**
  * 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.
-const SURFACE_BLACK = new ColorRgba(0, 0, 0);
+export const SURFACE_BLACK = new ColorRgba(0, 0, 0);
 // --- Attribute definitions ---
 /**
  * Canonical text-attribute inventory. Single source of truth consumed by
@@ -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
@@ -48,8 +48,9 @@ function hangingWhitespace(line) {
 // [LAW:single-enforcer] RichText is the data-model trust boundary for link
 // URLs: a `Style` is sanitized as it enters (`admitStyle`), and the `Style` a
 // stored string resolves to is sanitized as it leaves for a render
-// (`resolveStyle`). Wire-byte safety is enforced separately in render.ts and
-// style.ts through the same `stripOscTerminators`.
+// (`resolveStyle`). Wire-byte safety is enforced separately by `osc8Open`
+// (core/osc8.ts), which every link producer calls and which applies the same
+// `stripOscTerminators`.
 function sanitizeStyleLink(style) {
     const link = style.link;
     if (!link)
@@ -76,21 +77,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 +476,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 +488,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 +499,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 +694,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 +736,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 +988,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

@@ -3,7 +3,7 @@ export type { CellCol, CodeUnit, CodePoint } from "./core/cells.js";
 export { ColorRgba, ColorTable, ColorDepth, ColorSpec, ColorParseError, TerminalTheme, parseRgbHex, parseRgbaHex, blendRgb, resolveColorSystem, detectColorSystem, STANDARD_TABLE, EIGHT_BIT_TABLE, WINDOWS_TABLE, ANSI_COLOR_NAMES, } from "./core/color.js";
 export type { DetectColorOptions } from "./core/color.js";
 export { Oklch, IDENTITY, INVERT_LIGHTNESS, isIdentityKey, } from "./core/oklch.js";
-export type { ThemeKey } from "./core/oklch.js";
+export type { ThemeKey, OklchWeights } from "./core/oklch.js";
 export { Palette } from "./themes/palette.js";
 export { resolveColorRef, parseHexColor, ColorRefError, HEX_COLOR_RE, } from "./themes/colorRef.js";
 export { buildPalette } from "./themes/buildPalette.js";
@@ -23,19 +23,21 @@ 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";
 export type { RichTextOptions } from "./core/text.js";
-export { Strip, PowerlineJoiner, CapsuleJoiner, PlainJoiner, GradientJoiner, } from "./core/strip.js";
+export { Strip, PowerlineJoiner, SEAM_MIN_DELTA_E, POWERLINE_JOINER_GLYPHS, CapsuleJoiner, PlainJoiner, GradientJoiner, } from "./core/strip.js";
 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

@@ -38,15 +38,17 @@ export { Measurement, measureRenderables } from "./core/measure.js";
 // Text
 export { Span, RichText } from "./core/text.js";
 // Strip + Joiner
-export { Strip, PowerlineJoiner, CapsuleJoiner, PlainJoiner, GradientJoiner, } from "./core/strip.js";
+export { Strip, PowerlineJoiner, SEAM_MIN_DELTA_E, POWERLINE_JOINER_GLYPHS, 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

package/dist/node/traceback.js

@@ -110,4 +110,3 @@ export function installTraceback(options) {
     process.on("unhandledRejection", report);
     installed = report;
 }
-//# sourceMappingURL=traceback.js.map

package/dist/renderables/align.d.ts

@@ -14,4 +14,3 @@ export declare class Align implements Renderable, Measurable {
         maximum: number;
     };
 }
-//# sourceMappingURL=align.d.ts.map

package/dist/renderables/align.js

@@ -44,4 +44,3 @@ export class Align {
         return { minimum: 1, maximum: options.maxWidth };
     }
 }
-//# sourceMappingURL=align.js.map

package/dist/renderables/columns.d.ts

@@ -40,6 +40,18 @@ export declare class Columns implements Renderable, Measurable {
      * cropped forty cells of content down to `"x"` with no error at all.
      */
     private _itemWidth;
+    /**
+     * The declared column width, bounded by the width offered.
+     *
+     * [LAW:single-enforcer] A declared width is what a column asks for, not what
+     * it takes — the contract `Table._outerWidth` keeps for a declared table
+     * width. Read by `_divide` for render and by `_naturalWidth` for measure, so
+     * the two answer from one number: laid out at the raw declared width, a
+     * six-cell column offered three emitted six-cell lines while `measure`
+     * reported three, and the terminal's soft wrap took the frame of everything
+     * printed after it.
+     */
+    private _declaredWidth;
     /** The width at which every item sits on one row: n columns and the gutters between them. */
     private _naturalWidth;
     measure(rawOptions: RenderOptions): {
@@ -47,4 +59,3 @@ export declare class Columns implements Renderable, Measurable {
         maximum: number;
     };
 }
-//# sourceMappingURL=columns.d.ts.map