@inhuman.tools/quickdraw 0.0.0-stage → 0.2.0

package/dist/runtime/thought_birth.js

@@ -0,0 +1,122 @@
+/**
+ * Host-local birth frontier for live stream peeks.
+ *
+ * Walks declared `live.kind === "birth"` ops in the visible tree, steps W,
+ * and hands the map to paint. Only the last site in tape order crawls;
+ * earlier sites snap W = T so they paint solid (missing W would rest at
+ * T − tipWindow and leave a dim tail). Does not rebuild widget constructors.
+ */
+import { birthFrontierLive, createBirthFrontier, stepBirthFrontier, } from "../layout/index.js";
+export function collectBirthSites(node, out = [], seen = new Set()) {
+    if (typeof node !== "object" || node === null)
+        return out;
+    const rec = node;
+    if (rec.type === "disclosure") {
+        const visible = rec.collapsed === false ? (rec.children ?? []) : [rec.summary];
+        for (const child of visible)
+            collectBirthSites(child, out, seen);
+        return out;
+    }
+    if (rec.live?.kind === "birth" && !seen.has(rec.live.siteId)) {
+        seen.add(rec.live.siteId);
+        out.push({ siteId: rec.live.siteId, T: rec.live.T });
+    }
+    if (Array.isArray(rec.children)) {
+        for (const c of rec.children)
+            collectBirthSites(c, out, seen);
+    }
+    return out;
+}
+export function stepThoughtBirthLedger(roots, frontiers, nowMs) {
+    const sites = [];
+    const seen = new Set();
+    for (const root of roots) {
+        for (const site of collectBirthSites(root)) {
+            if (seen.has(site.siteId))
+                continue;
+            seen.add(site.siteId);
+            sites.push(site);
+        }
+    }
+    return stepLatestBirthSites(sites, frontiers, nowMs);
+}
+/** Step frontiers from an already-collected site list (Paint DOM path). */
+export function stepThoughtBirthFromSites(sites, frontiers, nowMs) {
+    return stepLatestBirthSites(sites, frontiers, nowMs);
+}
+export function stepThoughtBirthFromSnapshot(snapshot, frontiers, nowMs) {
+    const roots = [];
+    const tree = snapshot.tree;
+    if (tree && typeof tree === "object") {
+        if (tree.root != null)
+            roots.push(tree.root);
+        if (tree.boxes && typeof tree.boxes === "object") {
+            const ids = new Set(Object.values(tree.boxes));
+            for (const id of ids) {
+                if (typeof id === "number")
+                    roots.push(snapshot.getBox(id));
+            }
+        }
+    }
+    return stepThoughtBirthLedger(roots, frontiers, nowMs);
+}
+function stepLatestBirthSites(sites, frontiers, nowMs) {
+    const unique = [];
+    const seen = new Set();
+    for (const site of sites) {
+        if (seen.has(site.siteId))
+            continue;
+        seen.add(site.siteId);
+        unique.push(site);
+    }
+    const latestId = unique.at(-1)?.siteId;
+    const inject = new Map();
+    for (const site of unique) {
+        const field = stepOneBirthSite(site, frontiers, nowMs, {
+            resolve: site.siteId !== latestId,
+        });
+        if (field != null)
+            inject.set(site.siteId, field);
+    }
+    for (const id of frontiers.keys()) {
+        if (!seen.has(id))
+            frontiers.delete(id);
+    }
+    return inject;
+}
+function stepOneBirthSite(site, frontiers, nowMs, opts) {
+    const T = site.T;
+    if (T <= 0) {
+        frontiers.delete(site.siteId);
+        return null;
+    }
+    if (opts?.resolve === true) {
+        const resolved = {
+            W: T,
+            T,
+            lastStepMs: nowMs,
+            sealed: true,
+            lastAdvanceMs: nowMs,
+            v: 0,
+        };
+        frontiers.set(site.siteId, resolved);
+        return { W: T };
+    }
+    const prev = frontiers.get(site.siteId);
+    const next = stepBirthFrontier(prev == null ? createBirthFrontier() : { ...prev, sealed: false }, {
+        T,
+        nowMs,
+        sealed: false,
+    });
+    frontiers.set(site.siteId, next);
+    return { W: next.W };
+}
+/** Any frontier still animating? Present arms its live timer off this. */
+export function anyThoughtBirthLive(frontiers) {
+    for (const state of frontiers.values()) {
+        if (birthFrontierLive(state))
+            return true;
+    }
+    return false;
+}
+//# sourceMappingURL=thought_birth.js.map

package/dist/runtime/thought_birth.js.map

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

package/dist/runtime/thought_collapsed.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Host-local thought expand/collapse — display only.
+ * ThinkingStream stamps `onClick: { type: "toggle_collapsed", blockId }`; bare click
+ * flips `collapsed` on the disclosure. Both branches already live in the tree.
+ */
+import type { PaintSnapshot } from "./frame.js";
+export type ToggleCollapsedClick = {
+    readonly type: "toggle_collapsed";
+    readonly blockId: string;
+};
+export declare function isToggleCollapsedClick(value: unknown): value is ToggleCollapsedClick;
+/**
+ * Walk hit meta + byKey parent chain for toggle_collapsed.
+ * Accepts raw HitMeta or elementAt's `{ key, meta }` wrapper.
+ */
+export declare function toggleCollapsedFromHit(hit: {
+    onClick?: unknown;
+    parent?: string;
+    key?: string;
+} | {
+    key: string;
+    meta: {
+        onClick?: unknown;
+        parent?: string;
+        key?: string;
+    };
+} | null | undefined, byKey: Map<string, {
+    onClick?: unknown;
+    parent?: string;
+    key?: string;
+}>): ToggleCollapsedClick | null;
+/** `collapsedOverrides`: blockId → collapsed. Absent key → wire node.collapsed. */
+export declare function applyThoughtCollapsed(node: unknown, collapsedOverrides: ReadonlyMap<string, boolean>): unknown;
+export declare function paintSnapshotWithThoughtCollapsed(snapshot: PaintSnapshot, collapsedOverrides: ReadonlyMap<string, boolean>): PaintSnapshot;
+//# sourceMappingURL=thought_collapsed.d.ts.map

package/dist/runtime/thought_collapsed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thought_collapsed.d.ts","sourceRoot":"","sources":["../../src/runtime/thought_collapsed.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGhD,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,oBAAoB,CAKpF;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EACC;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAC3E,IAAI,GACJ,SAAS,EACb,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GACvE,oBAAoB,GAAG,IAAI,CA6B7B;AAED,mFAAmF;AACnF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,EAAE,kBAAkB,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAmC9G;AAED,wBAAgB,iCAAiC,CAC/C,QAAQ,EAAE,aAAa,EACvB,kBAAkB,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/C,aAAa,CAQf"}

package/dist/runtime/thought_collapsed.js

@@ -0,0 +1,94 @@
+export function isToggleCollapsedClick(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const rec = value;
+    if (rec.type !== "toggle_collapsed")
+        return false;
+    return typeof rec.blockId === "string";
+}
+/**
+ * Walk hit meta + byKey parent chain for toggle_collapsed.
+ * Accepts raw HitMeta or elementAt's `{ key, meta }` wrapper.
+ */
+export function toggleCollapsedFromHit(hit, byKey) {
+    let cur = hit && "meta" in hit && hit.meta ? hit.meta : hit;
+    const seen = new Set();
+    while (cur) {
+        if (isToggleCollapsedClick(cur.onClick))
+            return cur.onClick;
+        const parent = cur.parent;
+        if (!parent || seen.has(parent))
+            break;
+        seen.add(parent);
+        cur = byKey.get(parent);
+    }
+    const startKey = hit && "meta" in hit && hit.meta
+        ? (hit.meta.key ?? hit.key)
+        : hit && "key" in hit
+            ? hit.key
+            : undefined;
+    if (startKey) {
+        let key = startKey;
+        while (key.includes(":")) {
+            const parentKey = key.slice(0, key.lastIndexOf(":"));
+            if (seen.has(parentKey))
+                break;
+            seen.add(parentKey);
+            const meta = byKey.get(parentKey);
+            if (meta && isToggleCollapsedClick(meta.onClick))
+                return meta.onClick;
+            key = parentKey;
+        }
+    }
+    return null;
+}
+/** `collapsedOverrides`: blockId → collapsed. Absent key → wire node.collapsed. */
+export function applyThoughtCollapsed(node, collapsedOverrides) {
+    if (typeof node !== "object" || node === null)
+        return node;
+    const rec = node;
+    if (rec.type === "disclosure" && isToggleCollapsedClick(rec.onClick)) {
+        const { blockId } = rec.onClick;
+        if (collapsedOverrides.has(blockId)) {
+            return { ...rec, collapsed: collapsedOverrides.get(blockId) };
+        }
+    }
+    let changed = false;
+    let summary = rec.type === "disclosure" ? rec.summary : undefined;
+    if (summary) {
+        const next = applyThoughtCollapsed(summary, collapsedOverrides);
+        if (next !== summary) {
+            summary = next;
+            changed = true;
+        }
+    }
+    let children = rec.children;
+    if (Array.isArray(children)) {
+        const next = children.map((child) => {
+            const c = applyThoughtCollapsed(child, collapsedOverrides);
+            if (c !== child)
+                changed = true;
+            return c;
+        });
+        if (changed)
+            children = next;
+    }
+    if (!changed)
+        return node;
+    return {
+        ...rec,
+        summary,
+        children,
+    };
+}
+export function paintSnapshotWithThoughtCollapsed(snapshot, collapsedOverrides) {
+    if (collapsedOverrides.size === 0)
+        return snapshot;
+    return {
+        tree: snapshot.tree,
+        getBox(id) {
+            return applyThoughtCollapsed(snapshot.getBox(id), collapsedOverrides);
+        },
+    };
+}
+//# sourceMappingURL=thought_collapsed.js.map

package/dist/runtime/thought_collapsed.js.map

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

package/dist/runtime/tty.d.ts

@@ -0,0 +1,58 @@
+/**
+ * TTY lifecycle: ordered setup/teardown for alt-screen apps.
+ * Single owner of mode brackets. Leave-alt is LAST.
+ */
+export type TtyOptions = {
+    /** Mode 2026 synchronized output — env-flag only for MVP (no DECRQM probe) */
+    sync2026?: boolean;
+    hideCursor?: boolean;
+    noWrap?: boolean;
+};
+export type TtySession = {
+    readonly entered: boolean;
+    /** Ordered enter sequences (for tests / write) */
+    enterBytes(): string;
+    /**
+     * Just the input-mode brackets, closed — mouse, paste, focus, kitty,
+     * modifyOtherKeys. The leading part of {@link exitBytes}, available on its own
+     * because it has to be written EARLIER than the rest: a host that drops raw
+     * mode first hands the shell a terminal still reporting mouse events, and the
+     * SGR bytes for the next click land as garbage on the prompt. Idempotent
+     * (DECRST of an already-reset mode is a no-op), so writing it here and again
+     * inside `exitBytes` costs nothing and keeps one spelling of the bytes.
+     */
+    inputModesOffBytes(): string;
+    /** Ordered teardown — leave-alt last */
+    exitBytes(): string;
+    /**
+     * CUP park. CSI row;colH is 1-based — a 0-based write parks off-screen.
+     * Clamps to ≥1.
+     */
+    parkCursor(row: number, col: number): string;
+    markEntered(): void;
+    markExited(): void;
+};
+export declare function createTtySession(opts?: TtyOptions): TtySession;
+/**
+ * Host-owned 1003 any-motion. `enterBytes` never sends this — hover flood
+ * is scoped to slash-complete presence, and to copy-toast after its 3s arm
+ * (move dismisses the plaque). Written on the edge only.
+ *
+ * 1000/1002/1003 are mutually exclusive. `1003l` does not fall back to
+ * press+drag tracking — it drops mouse reporting entirely, so the
+ * terminal keeps the pointer (system selection, 1007 wheel-as-arrows)
+ * until the next `1003h`. Off re-asserts the enterBytes mouse set.
+ */
+export declare function mouseAnyMotionBytes(on: boolean): string;
+/**
+ * OSC 22 pointer shape (CSS cursor names; kitty / ghostty / xterm).
+ * `pointer` = clickable hit (`intent: activate`). `default` restores the
+ * I-beam / arrow. Written on the edge only — `enterBytes` never sends this.
+ * `exitBytes` restores default so the shell does not inherit a hand.
+ *
+ * Rejected: a `cursor` field on LayoutNode. TTY shape is host-owned, same
+ * as 1003; the layout already says clickable via intent.
+ */
+export type MousePointerShape = "default" | "pointer";
+export declare function mousePointerBytes(shape: MousePointerShape): string;
+//# sourceMappingURL=tty.d.ts.map

package/dist/runtime/tty.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tty.d.ts","sourceRoot":"","sources":["../../src/runtime/tty.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,MAAM,UAAU,GAAG;IACvB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,kDAAkD;IAClD,UAAU,IAAI,MAAM,CAAC;IACrB;;;;;;;;OAQG;IACH,kBAAkB,IAAI,MAAM,CAAC;IAC7B,wCAAwC;IACxC,SAAS,IAAI,MAAM,CAAC;IACpB;;;OAGG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7C,WAAW,IAAI,IAAI,CAAC;IACpB,UAAU,IAAI,IAAI,CAAC;CACpB,CAAC;AAuDF,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,UAAe,GAAG,UAAU,CA2DlE;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,OAAO,GAAG,MAAM,CAGvD;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,SAAS,CAAC;AAEtD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAElE"}

package/dist/runtime/tty.js

@@ -0,0 +1,130 @@
+/**
+ * TTY lifecycle: ordered setup/teardown for alt-screen apps.
+ * Single owner of mode brackets. Leave-alt is LAST.
+ */
+const ENTER_ALT = "\u001B[?1049h";
+const ERASE_DISPLAY = "\u001B[2J";
+const CUP_HOME = "\u001B[H";
+/**
+ * Build a session. Does not touch process.stdout — caller writes.
+ * Teardown order (TERMINAL L2/L3):
+ *  1. keyboard / paste modes off (kitty pop, modifyOtherKeys, bracketed paste)
+ *  2. ?2026l if was on
+ *  3. CSI r (release scroll region)
+ *  4. ?7h autowrap on
+ *  5. ?25h show cursor
+ *  6. CUP bottom + CR LF
+ *  7. ?1049l leave alt LAST
+ *
+ * Keyboard / focus opt-in (OpenTUI / Ink / crossterm / Bubble Tea pattern):
+ *  - CSI > 4 ; 2 m — xterm modifyOtherKeys mode 2 (Shift+Enter on partial
+ *    terminals). Must precede kitty setup: iTerm clears kitty flags when
+ *    modifyOtherKeys is enabled.
+ *  - CSI > 31 u then CSI = 31 ; 1 u — kitty progressive: flag 1
+ *    (disambiguate) | 2 (press / repeat / release) | 4 (shifted / base
+ *    layout keys) | 8 (report all keys as escape codes) | 16 (associated
+ *    text). Push so `CSI < u` restores the prior entry; SET is the spec's
+ *    primary request (terminals that ignore push). Flag 8 delivers
+ *    **Cmd/Super+letter** (e.g. Cmd+Z → CSI 122;9u) and isolated
+ *    Super/Control as `{ type: "mod" }` (`CSI 57444;9u` press — super bit
+ *    set). Flag 8 also stops UTF-8 letters — flag 16 puts the OS glyph in
+ *    CSI field 3 so Shift/Caps/layout stay insertable. Flag 4 is the
+ *    shifted-subfield fallback when field 3 is absent. Flag 2 is the
+ *    release (`:3`) so the chrome modifier layer can drop. Decoder must
+ *    accept plain CSI-u printables when this is on.
+ *  - CSI ? 2004 h — bracketed paste
+ *  - CSI ? 1004 h — focus in/out (CSI I / CSI O)
+ *  - CSI ? 1000 h + ? 1002 h + ? 1006 h — SGR mouse press/release plus
+ *    cell-motion-while-held, for drag-select (never ?1003 any-motion flood)
+ *  - CSI ? 1007 h — alternate scroll: alt-screen wheel → cursor keys when
+ *    mouse reporting is inactive (macOS Option is the native bypass)
+ */
+/**
+ * The input-mode brackets, closed. A free function rather than a method so
+ * `exitBytes` can reuse it without a `this` binding a destructured caller would
+ * lose.
+ */
+function inputModesOff() {
+    return [
+        "\u001B[?1006l", // SGR mouse off
+        "\u001B[?1002l", // cell-motion off
+        "\u001B[?1000l", // mouse tracking off
+        "\u001B[?1003l", // any-motion off (defensive)
+        "\u001B[?1007l", // alternate scroll off
+        "\u001B[?1004l", // focus report off
+        "\u001B[?2004l", // bracketed paste off
+        "\u001B[<u", // kitty keyboard pop
+        "\u001B[>4;0m", // modifyOtherKeys off
+    ].join("");
+}
+export function createTtySession(opts = {}) {
+    let entered = false;
+    const sync2026 = opts.sync2026 === true;
+    const hideCursor = opts.hideCursor !== false;
+    const noWrap = opts.noWrap !== false;
+    return {
+        get entered() {
+            return entered;
+        },
+        markEntered() {
+            entered = true;
+        },
+        markExited() {
+            entered = false;
+        },
+        enterBytes() {
+            const parts = [ENTER_ALT, ERASE_DISPLAY, CUP_HOME];
+            if (hideCursor)
+                parts.push("\u001B[?25l");
+            if (noWrap)
+                parts.push("\u001B[?7l");
+            if (sync2026)
+                parts.push("\u001B[?2026h");
+            // Input enhancements — ignored by unsupported terminals.
+            // Enable the fallback first: iTerm clears kitty flags on this request.
+            parts.push("\u001B[>4;2m", "\u001B[>31u", "\u001B[=31;1u", "\u001B[?2004h", "\u001B[?1004h", "\u001B[?1000h", "\u001B[?1002h", "\u001B[?1006h", "\u001B[?1007h");
+            return parts.join("");
+        },
+        inputModesOffBytes() {
+            return inputModesOff();
+        },
+        exitBytes() {
+            // 1 keyboard / paste / focus / mouse off before paint teardown
+            const parts = [
+                inputModesOff(),
+                mousePointerBytes("default"),
+                "\u001B[?2026l",
+                "\u001B[r",
+                "\u001B[?7h",
+                "\u001B[?25h",
+                "\u001B[999;1H\r\n",
+                "\u001B[?1049l",
+            ];
+            return parts.join("");
+        },
+        parkCursor(row, col) {
+            const r = Math.max(1, Math.floor(row));
+            const c = Math.max(1, Math.floor(col));
+            return `\u001B[${r};${c}H`;
+        },
+    };
+}
+/**
+ * Host-owned 1003 any-motion. `enterBytes` never sends this — hover flood
+ * is scoped to slash-complete presence, and to copy-toast after its 3s arm
+ * (move dismisses the plaque). Written on the edge only.
+ *
+ * 1000/1002/1003 are mutually exclusive. `1003l` does not fall back to
+ * press+drag tracking — it drops mouse reporting entirely, so the
+ * terminal keeps the pointer (system selection, 1007 wheel-as-arrows)
+ * until the next `1003h`. Off re-asserts the enterBytes mouse set.
+ */
+export function mouseAnyMotionBytes(on) {
+    if (on)
+        return "\u001B[?1003h";
+    return "\u001B[?1003l\u001B[?1000h\u001B[?1002h\u001B[?1006h";
+}
+export function mousePointerBytes(shape) {
+    return `\u001B]22;${shape}\u0007`;
+}
+//# sourceMappingURL=tty.js.map

package/dist/runtime/tty.js.map

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

package/dist/theme/ansi16.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Polarity-preserving ANSI16 degradation for semantic roles.
+ *
+ * Nearest-RGB quantization collapses hue (error→yellow, etc.). This table
+ * pins each role to a hue-preserving slot so category is never lost.
+ * Legibility > category preservation > tier separation.
+ *
+ * Literal RGB (syntax highlight, no role) degrades via nearest-RGB on the
+ * classic 0–15 xterm palette — hue-preserving slots stay role-only.
+ */
+import type { Rgb, SemanticRole } from "../lexicon/index.js";
+export type CanvasPolarity = "dark" | "light";
+export type Ansi16Slot = number;
+/**
+ * Named ANSI slot → theme role whose hue/chroma we keep. Bright and dim
+ * share a role; SGR 1 is weight. Inverse of {@link ansi16Slot} (role → slot).
+ * Black/white land on furniture/voice, not a claimed gray RGB.
+ */
+export declare const ANSI16_ROLE: readonly ["muted", "error", "success", "warning", "code", "running", "auto", "foreground", "muted", "error", "success", "emphasis", "code", "running", "accent", "foreground"];
+/** Prominence ≥ this → loud tier; below → soft. */
+export declare const LOUD_THRESHOLD = 0.8;
+/** Nearest ANSI16 index for an sRGB triple (0–255). Euclidean in sRGB. */
+export declare function nearestAnsi16(r: number, g: number, b: number): Ansi16Slot;
+export declare function nearestAnsi16FromRgb(rgb: Rgb): Ansi16Slot;
+/** Decode ANSI16 index to approximate RGB (xterm defaults). */
+export declare function ansi16ToRgb(index: number): Rgb;
+/**
+ * Canvas polarity from ground OKLCH L.
+ * `null` / undefined → reference ground polarity (dark).
+ */
+export declare function canvasPolarity(groundLightness: number | null | undefined): CanvasPolarity;
+/** Resolve role → ANSI16 slot for polarity + prominence. */
+export declare function ansi16Slot(role: SemanticRole, polarity: CanvasPolarity, prominence?: number): Ansi16Slot;
+//# sourceMappingURL=ansi16.d.ts.map

package/dist/theme/ansi16.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ansi16.d.ts","sourceRoot":"","sources":["../../src/theme/ansi16.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAE7D,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,OAAO,CAAC;AAC9C,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC;AAEhC;;;;GAIG;AACH,eAAO,MAAM,WAAW,gLAiBoB,CAAC;AAE7C,mDAAmD;AACnD,eAAO,MAAM,cAAc,MAAM,CAAC;AAsBlC,0EAA0E;AAC1E,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,UAAU,CAgBzE;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,GAAG,GAAG,UAAU,CAEzD;AAED,+DAA+D;AAC/D,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAI9C;AAmFD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,cAAc,CAGzF;AAMD,4DAA4D;AAC5D,wBAAgB,UAAU,CAAC,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,UAAU,SAAI,GAAG,UAAU,CAKnG"}