@promptctl/rich-js 0.17.0 → 0.18.0

package/dist/core/emoji.js

@@ -1,391 +0,0 @@
-/**
- * Emoji shortcode support — dictionary, replacement, and renderable.
- */
-import { Segment } from "./segment.js";
-// [LAW:one-source-of-truth] Single emoji dictionary for all shortcode lookups
-export const EMOJI = {
-    // Faces
-    smile: "😄",
-    laugh: "😂",
-    grinning: "😀",
-    wink: "😉",
-    blush: "😊",
-    innocent: "😇",
-    heart_eyes: "😍",
-    kissing: "😘",
-    thinking: "🤔",
-    shushing: "🤫",
-    zipper_mouth: "🤐",
-    raised_eyebrow: "🤨",
-    neutral: "😐",
-    expressionless: "😑",
-    unamused: "😒",
-    rolling_eyes: "🙄",
-    grimacing: "😬",
-    lying: "🤥",
-    relieved: "😌",
-    pensive: "😔",
-    sleepy: "😪",
-    sleeping: "😴",
-    mask: "😷",
-    thermometer_face: "🤒",
-    bandage_face: "🤕",
-    nauseated: "🤢",
-    sneezing: "🤧",
-    cold_face: "🥶",
-    hot_face: "🥵",
-    dizzy_face: "😵",
-    exploding_head: "🤯",
-    cowboy: "🤠",
-    party_face: "🥳",
-    sunglasses: "😎",
-    nerd: "🤓",
-    monocle: "🧐",
-    confused: "😕",
-    worried: "😟",
-    frowning: "☹",
-    open_mouth: "😮",
-    hushed: "😯",
-    astonished: "😲",
-    flushed: "😳",
-    pleading: "🥺",
-    cry: "😢",
-    sob: "😭",
-    scream: "😱",
-    sweat: "😰",
-    angry: "😡",
-    rage: "🤬",
-    devil: "😈",
-    skull: "💀",
-    poop: "💩",
-    clown: "🤡",
-    ghost: "👻",
-    alien: "👽",
-    robot: "🤖",
-    // Hands
-    wave: "👋",
-    raised_hand: "✋",
-    ok_hand: "👌",
-    pinching: "🤏",
-    victory: "✌",
-    crossed_fingers: "🤞",
-    love_you: "🤟",
-    rock_on: "🤘",
-    thumbs_up: "👍",
-    thumbs_down: "👎",
-    fist: "✊",
-    punch: "👊",
-    left_fist: "🤛",
-    right_fist: "🤜",
-    clap: "👏",
-    raised_hands: "🙌",
-    open_hands: "👐",
-    palms_up: "🤲",
-    handshake: "🤝",
-    pray: "🙏",
-    writing_hand: "✍",
-    nail_polish: "💅",
-    muscle: "💪",
-    point_up: "☝",
-    point_up_2: "👆",
-    point_down: "👇",
-    point_left: "👈",
-    point_right: "👉",
-    middle_finger: "🖕",
-    // Hearts
-    heart: "❤",
-    orange_heart: "🧡",
-    yellow_heart: "💛",
-    green_heart: "💚",
-    blue_heart: "💙",
-    purple_heart: "💜",
-    black_heart: "🖤",
-    white_heart: "🤍",
-    brown_heart: "🤎",
-    broken_heart: "💔",
-    heart_exclamation: "❣",
-    two_hearts: "💕",
-    revolving_hearts: "💞",
-    heartbeat: "💓",
-    heartpulse: "💗",
-    sparkling_heart: "💖",
-    growing_heart: "💗",
-    cupid: "💘",
-    gift_heart: "💝",
-    // Objects & Symbols
-    fire: "🔥",
-    star: "⭐",
-    star2: "🌟",
-    sparkles: "✨",
-    zap: "⚡",
-    boom: "💥",
-    droplet: "💧",
-    rainbow: "🌈",
-    sun: "☀",
-    moon: "🌙",
-    cloud: "☁",
-    snowflake: "❄",
-    umbrella: "☂",
-    // Status
-    check: "✅",
-    check_mark: "✔",
-    cross_mark: "❌",
-    warning: "⚠",
-    info: "ℹ",
-    question: "❓",
-    exclamation: "❗",
-    no_entry: "⛔",
-    prohibited: "🚫",
-    stop_sign: "🛑",
-    // Arrows
-    arrow_up: "⬆",
-    arrow_down: "⬇",
-    arrow_left: "⬅",
-    arrow_right: "➡",
-    arrow_upper_left: "↖",
-    arrow_upper_right: "↗",
-    arrow_lower_left: "↙",
-    arrow_lower_right: "↘",
-    left_right_arrow: "↔",
-    up_down_arrow: "↕",
-    arrows_clockwise: "🔃",
-    arrows_counterclockwise: "🔄",
-    // Tech
-    computer: "💻",
-    keyboard: "⌨",
-    desktop: "🖥",
-    printer: "🖨",
-    mouse: "🖱",
-    cd: "💿",
-    dvd: "📀",
-    floppy: "💾",
-    battery: "🔋",
-    plug: "🔌",
-    bulb: "💡",
-    flashlight: "🔦",
-    gear: "⚙",
-    wrench: "🔧",
-    hammer: "🔨",
-    nut_and_bolt: "🔩",
-    link: "🔗",
-    chains: "⛓",
-    lock: "🔒",
-    unlock: "🔓",
-    key: "🔑",
-    shield: "🛡",
-    bug: "🐛",
-    magnifying_glass: "🔍",
-    // Communication
-    speech_balloon: "💬",
-    thought_balloon: "💭",
-    megaphone: "📣",
-    loudspeaker: "📢",
-    bell: "🔔",
-    no_bell: "🔕",
-    envelope: "✉",
-    email: "📧",
-    inbox: "📥",
-    outbox: "📤",
-    package: "📦",
-    clipboard: "📋",
-    memo: "📝",
-    page: "📄",
-    bookmark: "🔖",
-    label: "🏷",
-    // Time
-    hourglass: "⌛",
-    hourglass_flowing: "⏳",
-    watch: "⌚",
-    alarm_clock: "⏰",
-    stopwatch: "⏱",
-    timer: "⏲",
-    clock: "🕐",
-    // Numbers
-    zero: "0️⃣",
-    one: "1️⃣",
-    two: "2️⃣",
-    three: "3️⃣",
-    four: "4️⃣",
-    five: "5️⃣",
-    six: "6️⃣",
-    seven: "7️⃣",
-    eight: "8️⃣",
-    nine: "9️⃣",
-    ten: "🔟",
-    hash: "#️⃣",
-    // Food & Drink
-    coffee: "☕",
-    tea: "🍵",
-    beer: "🍺",
-    wine: "🍷",
-    cocktail: "🍸",
-    pizza: "🍕",
-    hamburger: "🍔",
-    fries: "🍟",
-    hotdog: "🌭",
-    taco: "🌮",
-    cake: "🎂",
-    cookie: "🍪",
-    chocolate: "🍫",
-    candy: "🍬",
-    apple: "🍎",
-    banana: "🍌",
-    // Nature & Animals
-    dog: "🐕",
-    cat: "🐈",
-    snake: "🐍",
-    turtle: "🐢",
-    whale: "🐳",
-    dolphin: "🐬",
-    fish: "🐟",
-    butterfly: "🦋",
-    bee: "🐝",
-    ladybug: "🐞",
-    spider: "🕷",
-    tree: "🌲",
-    flower: "🌸",
-    rose: "🌹",
-    sunflower: "🌻",
-    cactus: "🌵",
-    // Activities
-    trophy: "🏆",
-    medal: "🏅",
-    crown: "👑",
-    gem: "💎",
-    money_bag: "💰",
-    dollar: "💵",
-    rocket: "🚀",
-    airplane: "✈",
-    car: "🚗",
-    bicycle: "🚲",
-    house: "🏠",
-    building: "🏢",
-    globe: "🌍",
-    world_map: "🗺",
-    flag: "🏁",
-    party: "🎉",
-    confetti: "🎊",
-    balloon: "🎈",
-    gift: "🎁",
-    art: "🎨",
-    music: "🎵",
-    notes: "🎶",
-    microphone: "🎤",
-    headphones: "🎧",
-    movie: "🎬",
-    camera: "📷",
-    book: "📖",
-    books: "📚",
-    scroll: "📜",
-    newspaper: "📰",
-    // People
-    person: "🧑",
-    man: "👨",
-    woman: "👩",
-    child: "🧒",
-    baby: "👶",
-    eyes: "👀",
-    eye: "👁",
-    brain: "🧠",
-    tongue: "👅",
-    ear: "👂",
-    nose: "👃",
-    foot: "🦶",
-    hand: "🤚",
-    // Misc
-    red_circle: "🔴",
-    orange_circle: "🟠",
-    yellow_circle: "🟡",
-    green_circle: "🟢",
-    blue_circle: "🔵",
-    purple_circle: "🟣",
-    black_circle: "⚫",
-    white_circle: "⚪",
-    red_square: "🟥",
-    orange_square: "🟧",
-    yellow_square: "🟨",
-    green_square: "🟩",
-    blue_square: "🟦",
-    purple_square: "🟪",
-    black_square: "⬛",
-    white_square: "⬜",
-    checkered_flag: "🏁",
-    triangular_flag: "🚩",
-    crossed_flags: "🎌",
-    pirate_flag: "🏴‍☠️",
-    white_flag: "🏳",
-    100: "💯",
-    infinity: "♾",
-    recycle: "♻",
-    peace: "☮",
-    yin_yang: "☯",
-    cross: "✝",
-    atom: "⚛",
-    radioactive: "☢",
-    biohazard: "☣",
-};
-const EMOJI_PATTERN = /:([a-z0-9_]+(?:-(?:emoji|text))?):/g;
-/**
- * Replaces :shortcode: patterns in text with emoji characters.
- */
-export function emojiReplace(text, defaultVariant) {
-    return text.replace(EMOJI_PATTERN, (_match, code) => {
-        let variant = defaultVariant;
-        let name = code;
-        // Check for inline variant suffix
-        if (name.endsWith("-emoji")) {
-            variant = "emoji";
-            name = name.slice(0, -6);
-        }
-        else if (name.endsWith("-text")) {
-            variant = "text";
-            name = name.slice(0, -5);
-        }
-        const emoji = EMOJI[name];
-        if (emoji === undefined)
-            return _match; // Not found, leave unchanged
-        // Apply variant selector
-        // [LAW:dataflow-not-control-flow] Always compute suffix, let the value decide
-        const suffix = variant === "emoji"
-            ? "\uFE0F"
-            : variant === "text"
-                ? "\uFE0E"
-                : "";
-        return emoji + suffix;
-    });
-}
-export class NoEmoji extends Error {
-    constructor(name) {
-        super(`No emoji with name: "${name}"`);
-        this.name = "NoEmoji";
-    }
-}
-export class Emoji {
-    name;
-    _char;
-    _style;
-    _variant;
-    constructor(name, style, variant) {
-        const emoji = EMOJI[name];
-        if (emoji === undefined)
-            throw new NoEmoji(name);
-        this.name = name;
-        this._char = emoji;
-        this._style = style;
-        this._variant = variant;
-    }
-    toString() {
-        const suffix = this._variant === "emoji"
-            ? "\uFE0F"
-            : this._variant === "text"
-                ? "\uFE0E"
-                : "";
-        return this._char + suffix;
-    }
-    *render(_options) {
-        yield new Segment(this.toString(), this._style);
-    }
-    static replace(text) {
-        return emojiReplace(text);
-    }
-}

package/dist/core/export-html.d.ts

@@ -1,24 +0,0 @@
-/**
- * export-html — recorded segments drawn as a standalone HTML document.
- *
- * An encoding of `export-lines` and nothing more. What a run looks like under
- * a theme is decided there; this module decides only how CSS says it. It never
- * sees a `Style`, so it cannot disagree with the SVG exporter about what
- * `reverse` or `dim` means — the two old converters that did disagree were
- * deleted when this replaced them.
- *
- * The rows are already laid out at console width, so `pre` never re-wraps
- * them: `white-space: pre`, and a scrollbar rather than a reflow when the page
- * is narrower than the terminal was.
- */
-import type { TerminalTheme } from "./color.js";
-import type { Segment } from "./segment.js";
-/**
- * `segments` under `theme` as a complete HTML document.
- *
- * A browser draws no line for a newline at either edge of a `pre`: the parser
- * drops the one straight after `<pre>`, and the one before `</pre>` ends a
- * line without starting another. So the page opens with a newline of its own
- * and every row ends with one, and a blank first or last row is still drawn.
- */
-export declare function encodeHtml(segments: Iterable<Segment>, theme?: TerminalTheme): string;

package/dist/core/export-html.js

@@ -1,106 +0,0 @@
-/**
- * export-html — recorded segments drawn as a standalone HTML document.
- *
- * An encoding of `export-lines` and nothing more. What a run looks like under
- * a theme is decided there; this module decides only how CSS says it. It never
- * sees a `Style`, so it cannot disagree with the SVG exporter about what
- * `reverse` or `dim` means — the two old converters that did disagree were
- * deleted when this replaced them.
- *
- * The rows are already laid out at console width, so `pre` never re-wraps
- * them: `white-space: pre`, and a scrollbar rather than a reflow when the page
- * is narrower than the terminal was.
- */
-import { exportCanvas, exportLines } from "./export-lines.js";
-const ENTITIES = { "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;" };
-const escapeText = (text) => text.replace(/[&<>]/g, (c) => ENTITIES[c]);
-const escapeAttribute = (value) => value.replace(/[&"<>]/g, (c) => ENTITIES[c]);
-const BLINK_KEYFRAMES = "rich-blink";
-// [LAW:dataflow-not-control-flow] Each enum-valued field of a look is a table
-// from its values to the declarations it adds, so every value is spelled once
-// and `Record` makes a new value a compile error until it has a row.
-// A double underline adds no line to the glyph's own span; `runHtml` draws it.
-const UNDERLINE_LINE = {
-    none: [],
-    single: ["underline"],
-    double: [],
-};
-const BLINK = {
-    none: [],
-    slow: [`animation:${BLINK_KEYFRAMES} 1s step-end infinite`],
-    fast: [`animation:${BLINK_KEYFRAMES} 0.5s step-end infinite`],
-};
-const FRAME = "box-shadow:inset 0 0 0 1px currentColor";
-const OUTLINE = {
-    none: [],
-    frame: [FRAME],
-    encircle: [FRAME, "border-radius:0.5em"],
-};
-/**
- * The glyph colour, and the background when one is painted.
- *
- * Dim arrives already blended into `foreground`. `opacity` is never written:
- * it fades a painted background along with the glyph, which is the bug the
- * blend exists to avoid.
- */
-function paintCss(look) {
-    return [
-        `color:${look.foreground.hex}`,
-        ...(look.background === "canvas" ? [] : [`background-color:${look.background.hex}`]),
-    ];
-}
-/** What is drawn on the glyph: weight, slant, single-style lines, blink, outline. */
-function glyphCss(look) {
-    const lines = [
-        ...UNDERLINE_LINE[look.underline],
-        ...(look.strike ? ["line-through"] : []),
-        ...(look.overline ? ["overline"] : []),
-    ];
-    return [
-        ...(look.bold ? ["font-weight:bold"] : []),
-        ...(look.italic ? ["font-style:italic"] : []),
-        ...(lines.length === 0 ? [] : [`text-decoration-line:${lines.join(" ")}`]),
-        ...BLINK[look.blink],
-        ...OUTLINE[look.outline],
-    ];
-}
-const span = (css, content) => `<span style="${escapeAttribute(css.join(";"))}">${content}</span>`;
-/**
- * One run as markup.
- *
- * An element has one `text-decoration-style`, so a double underline sharing a
- * span with a strike would double the strike too. It gets an outer span of its
- * own instead. That span carries the paint, because a descendant's background
- * may be painted over an ancestor's underline, and the blink, so the underline
- * blinks with the glyph.
- */
-function runHtml({ text, look }) {
-    const glyph = escapeText(text);
-    const drawn = look.underline === "double"
-        ? span([...paintCss(look), "text-decoration-line:underline", "text-decoration-style:double", ...BLINK[look.blink]], span([`color:${look.foreground.hex}`, ...glyphCss(look)], glyph))
-        : span([...paintCss(look), ...glyphCss(look)], glyph);
-    return look.href === null ? drawn : `<a href="${escapeAttribute(look.href)}">${drawn}</a>`;
-}
-/**
- * `segments` under `theme` as a complete HTML document.
- *
- * A browser draws no line for a newline at either edge of a `pre`: the parser
- * drops the one straight after `<pre>`, and the one before `</pre>` ends a
- * line without starting another. So the page opens with a newline of its own
- * and every row ends with one, and a blank first or last row is still drawn.
- */
-export function encodeHtml(segments, theme) {
-    const canvas = exportCanvas(theme);
-    const rows = exportLines(segments, theme).map((row) => `${row.map(runHtml).join("")}\n`);
-    const css = [
-        `body{background:${canvas.background.hex};color:${canvas.foreground.hex};padding:1em}`,
-        "pre{margin:0;font-family:monospace;white-space:pre;overflow-x:auto}",
-        "a{color:inherit;text-decoration:inherit}",
-        `@keyframes ${BLINK_KEYFRAMES}{50%{color:transparent}}`,
-    ].join("\n");
-    return [
-        "<!DOCTYPE html>",
-        `<html><head><meta charset="utf-8"><style>\n${css}\n</style></head>`,
-        `<body><pre>\n${rows.join("")}</pre></body></html>`,
-    ].join("\n");
-}

package/dist/core/export-lines.d.ts

@@ -1,121 +0,0 @@
-/**
- * export-lines — recorded segments resolved against a `TerminalTheme` into the
- * lines every exporter draws.
- *
- * The HTML and SVG exporters are two encodings of one picture, and this module
- * is the picture. What a styled cell *looks like* — which colour its glyph is,
- * whether its background is painted, which decorations it carries, where it
- * links — is decided here, once, and an exporter decides only how to write
- * that down. Before it existed the decision was made twice, by a CSS method
- * on `Style` and by a private converter on `Console`, and the two had already
- * disagreed: one honoured `underline2`, the other dropped it.
- *
- * [LAW:types-are-the-program] `ExportLook` has no `reverse`, `dim`, `conceal`
- * or default colour, because all four are consumed by `resolveLook` and turned
- * into plain RGB. An exporter holding a look cannot forget to swap a reversed
- * run or to fade a dim one: there is nothing left in its hands to forget. That
- * is the whole reason the representation is resolved rather than a `Style`
- * handed through.
- *
- * Runs rather than a cell grid. A grid gives a wide character a phantom
- * continuation cell every consumer must know to skip, and gives an HTML
- * exporter — which lays text out by flowing it — nothing it needs. A run's
- * column and cell width are `cellLen` of the text before it and of its own
- * text; they are not stored, so they cannot disagree with the text
- * [LAW:one-source-of-truth]. The SVG exporter, the one consumer that positions
- * anything, derives them.
- *
- * Browser-safe by construction: this imports `color`, `style`, `segment` and
- * nothing that touches the host, so `Console` can reach it from the main
- * barrel and the fs half of exporting stays in `src/node/save.ts`.
- */
-import { type ColorRgba, type TerminalTheme } from "./color.js";
-import { type Style } from "./style.js";
-import type { Segment } from "./segment.js";
-declare const _href: unique symbol;
-/**
- * A link target that is safe to write into a published document.
- *
- * [LAW:parse-dont-validate] Only `parseHref` produces one, so an exporter that
- * writes an `href` attribute from an `Href` cannot have skipped the check.
- */
-export type Href = string & {
-    readonly [_href]: true;
-};
-/**
- * Where a run's background comes from. `"canvas"` is the theme background
- * showing through — nothing painted — and is distinct from a painted colour
- * that happens to equal it, because `on default` and `on #000000` are
- * different requests even over a black theme.
- */
-export type Background = ColorRgba | "canvas";
-/** Everything an exporter needs to draw one run, and nothing left to resolve. */
-export interface ExportLook {
-    readonly foreground: ColorRgba;
-    readonly background: Background;
-    readonly bold: boolean;
-    readonly italic: boolean;
-    readonly underline: "none" | "single" | "double";
-    readonly strike: boolean;
-    readonly overline: boolean;
-    readonly blink: "none" | "slow" | "fast";
-    readonly outline: "none" | "frame" | "encircle";
-    readonly href: Href | null;
-}
-export interface ExportRun {
-    readonly text: string;
-    readonly look: ExportLook;
-}
-/** One terminal row, left to right. An empty array is a blank row. */
-export type ExportLine = readonly ExportRun[];
-/**
- * `Style.link` as a link an export may write, or `null` when it may not.
- *
- * A refused link loses only its target: the run keeps its text and every other
- * attribute, so nothing the terminal showed disappears from the export. The
- * canonical `URL.href` is what comes back, since the parse is what vouches for
- * it.
- */
-export declare function parseHref(link: string): Href | null;
-/** What an unstyled cell shows under a theme: the canvas, and ink on it. */
-export interface ExportCanvas {
-    readonly background: ColorRgba;
-    readonly foreground: ColorRgba;
-}
-/**
- * The ground every export is drawn on under `theme`.
- *
- * An exporter paints its page or window with this; `resolveLook` flattens
- * every run over the same `background`, so a run showing the canvas and the
- * page around it cannot come out different colours.
- */
-export declare function exportCanvas(theme?: TerminalTheme): ExportCanvas;
-/**
- * A `Style` as it appears on screen under `theme`.
- *
- * The order is the terminal's: colours resolve through the theme and lose
- * their alpha — paper over the canvas, ink over the paper, as `toSgrCodes`
- * flattens them — `reverse` swaps them, `dim` fades the glyph toward whatever
- * background it ended up on, and `conceal` finally paints the glyph in that
- * background. Every step after flattening works on opaque colour, so no
- * exporter ever draws a translucent one. Text under `conceal` is still
- * present, and still selectable, in both formats.
- *
- * The one difference from `toSgrCodes` is the substrate: a terminal cannot
- * know what lies under its cells and assumes black, while an export draws its
- * own canvas and flattens over that.
- *
- * `theme` omitted is `ColorSpec.getTruecolor`'s own fallback — black canvas,
- * white ink, the standard ANSI table. Choosing it there rather than naming a
- * preset here is what keeps `core/` from a third upward edge into `themes/`.
- */
-export declare function resolveLook(style: Style, theme?: TerminalTheme): ExportLook;
-/**
- * Recorded segments as terminal rows under `theme`.
- *
- * `"\n"` ends a row, so output that ends with a newline — every `print` does —
- * has no empty row after it, and `"a\n\nb"` keeps its blank row. Callers pass
- * the recording buffer, which already holds no control segments.
- */
-export declare function exportLines(segments: Iterable<Segment>, theme?: TerminalTheme): ExportLine[];
-export {};