@inhuman.tools/quickdraw 0.0.0-stage → 0.2.0

package/dist/layout/visual_draft.js

@@ -0,0 +1,199 @@
+/**
+ * Visual (painted) draft geometry — soft-wrap aware caret motion.
+ *
+ * Uses the same `pre-wrap` + display-column measure lineage as
+ * {@link chromeFrameBodyLines} / composer body paint, so ↑/↓/Home/End track
+ * spatial rows on screen, not only hard `\n`s.
+ */
+import { wrapText } from "./text.js";
+import { defaultMeasure, displayWidth } from "../measure/index.js";
+/**
+ * Partition `draft` into painted body rows at `textW` content columns.
+ * Empty draft → one empty visual line at 0 (caret-only row).
+ */
+export function visualDraftLines(draft, textW) {
+    const w = Math.max(1, Math.floor(textW));
+    if (draft.length === 0)
+        return [{ start: 0, end: 0, text: "" }];
+    const hardLines = draft.split("\n");
+    const out = [];
+    let pos = 0;
+    for (let hi = 0; hi < hardLines.length; hi++) {
+        const hard = hardLines[hi];
+        const soft = wrapText(hard, {
+            width: w,
+            whiteSpace: "pre-wrap",
+            measure: defaultMeasure,
+        });
+        let hardPos = 0;
+        for (const line of soft) {
+            const start = pos + hardPos;
+            out.push({ start, end: start + line.length, text: line });
+            hardPos += line.length;
+        }
+        // Empty hard line (e.g. trailing `\n` or `\n\n`) still paints a blank row.
+        if (soft.length === 0) {
+            out.push({ start: pos, end: pos, text: "" });
+        }
+        pos += hard.length;
+        if (hi < hardLines.length - 1)
+            pos += 1; // consumed `\n`
+    }
+    return out.length > 0 ? out : [{ start: 0, end: 0, text: "" }];
+}
+/**
+ * Index of the visual line containing `cursor`.
+ *
+ * Soft-wrap / full-row law (browser textarea):
+ *   - offset at end of row i that continues as row i+1 (shared boundary) → i+1
+ *   - offset at end of a **full-width last** row (measure ≥ textW, no next) →
+ *     a **virtual** empty continuation row at index `lines.length` (col 0).
+ *     Without this, park places the caret on the right border cell (one past
+ *     the text column) while paint only fills `textW` content cells.
+ *
+ * Hard newline is two offsets (`line.end` is the `\n`, next row starts at
+ * `end+1`). Cursor on `\n` stays on this row (after the last glyph). Cursor
+ * after `\n` is col 0 of the next row. Collapsing them onto the next row
+ * parks the caret on the empty line while insert still splices before `\n`.
+ *
+ * Returns `0..lines.length` inclusive (the last value is the virtual row).
+ */
+export function visualLineIndex(lines, cursor, textW) {
+    if (lines.length === 0)
+        return 0;
+    const c = Math.max(0, cursor);
+    const w = textW === undefined ? undefined : Math.max(1, Math.floor(textW));
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (c >= line.start && c <= line.end) {
+            // Prefer later real line at soft-wrap boundary.
+            if (c === line.end && i + 1 < lines.length && lines[i + 1].start === c) {
+                continue;
+            }
+            // Full last row: caret-after-last sits on a virtual next row at col 0.
+            if (w !== undefined && c === line.end && i === lines.length - 1 && displayWidth(line.text) >= w) {
+                return lines.length;
+            }
+            return i;
+        }
+    }
+    return lines.length - 1;
+}
+/**
+ * Display column of the caret within its visual line (0 = start of content).
+ */
+export function visualColInLine(draft, line, cursor) {
+    const c = Math.max(line.start, Math.min(line.end, cursor));
+    return displayWidth(draft.slice(line.start, c));
+}
+/**
+ * Map a preferred display column onto a UTF-16 offset within `line`.
+ * Lands before a grapheme when the column falls inside a wide cell.
+ */
+export function offsetAtVisualCol(draft, line, targetCol) {
+    if (targetCol <= 0)
+        return line.start;
+    const segmenter = new Intl.Segmenter(undefined, { granularity: "grapheme" });
+    let col = 0;
+    let offset = line.start;
+    for (const { segment } of segmenter.segment(draft.slice(line.start, line.end))) {
+        const w = displayWidth(segment);
+        if (col + w > targetCol)
+            return offset; // inside / at this grapheme → before it
+        col += w;
+        offset += segment.length;
+        if (col >= targetCol)
+            return offset;
+    }
+    return line.end;
+}
+/**
+ * Spatial caret park within the content box (0-based line, display col).
+ *
+ * Soft-wrap boundary law (browser / textarea): when the UTF-16 offset is both
+ * the end of visual row i and the start of row i+1, the caret sits on **row
+ * i+1 at col 0** — not trailing past the last glyph of row i. Park and ↑/↓
+ * must share this, or arrow-up from a wrap-start jumps to "after last" of
+ * the previous row (preferred-col = full width) instead of its first char.
+ */
+export function visualCaretGeometry(draft, cursor, textW) {
+    const w = Math.max(1, Math.floor(textW));
+    const lines = visualDraftLines(draft, w);
+    const c = Math.max(0, Math.min(draft.length, cursor));
+    const idx = visualLineIndex(lines, c, w);
+    // Virtual continuation row past a full last line: col 0.
+    if (idx >= lines.length) {
+        return {
+            line: lines.length,
+            colInContent: 0,
+            totalLines: lines.length + 1,
+        };
+    }
+    const line = lines[idx];
+    const col = visualColInLine(draft, line, c);
+    // Never park on the right border (relative col === textW) — that cell is the
+    // frame's `│`. Soft-wrap / last-row overflow already moved `idx` to the next
+    // (possibly virtual) row. A full row that a `\n` follows still has col === w
+    // at `line.end`; next-row col 0 would show start-of-next-line while insert
+    // splices before the `\n`. Clamp to the last text cell.
+    if (col >= w) {
+        return {
+            line: idx,
+            colInContent: Math.max(0, w - 1),
+            totalLines: Math.max(1, lines.length),
+        };
+    }
+    return {
+        line: idx,
+        colInContent: col,
+        totalLines: Math.max(1, lines.length),
+    };
+}
+/**
+ * Spatial caret motion over painted draft rows.
+ * `textW` must be the composer body content width (outer − chrome), same as paint.
+ */
+export function moveVisualDraft(draft, cursor, textW, motion) {
+    const w = Math.max(1, Math.floor(textW));
+    const lines = visualDraftLines(draft, w);
+    const c = Math.max(0, Math.min(draft.length, cursor));
+    const idx = visualLineIndex(lines, c, w);
+    // Virtual empty row after a full last line.
+    if (idx >= lines.length) {
+        switch (motion) {
+            case "line_home":
+            case "line_end":
+                return c; // empty virtual row — only one offset
+            case "line_up": {
+                const prev = lines.at(-1);
+                // From col 0 of virtual row → col 0 of previous (first char), not end.
+                return offsetAtVisualCol(draft, prev, 0);
+            }
+            case "line_down":
+                return c;
+        }
+    }
+    const line = lines[idx];
+    switch (motion) {
+        case "line_home":
+            return line.start;
+        case "line_end":
+            return line.end;
+        case "line_up": {
+            if (idx <= 0)
+                return c;
+            const col = visualColInLine(draft, line, c);
+            return offsetAtVisualCol(draft, lines[idx - 1], col);
+        }
+        case "line_down": {
+            if (idx >= lines.length - 1) {
+                // Stay, unless we're mid full-row and a virtual row would open — then
+                // line_end of this row is already c when c === line.end.
+                return c;
+            }
+            const col = visualColInLine(draft, line, c);
+            return offsetAtVisualCol(draft, lines[idx + 1], col);
+        }
+    }
+}
+//# sourceMappingURL=visual_draft.js.map

package/dist/layout/visual_draft.js.map

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

package/dist/lexicon/color.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Color value shapes — the raw material the vocabulary is spoken in.
+ * SSOT for these types.
+ */
+/** sRGB triple, 0–255 per channel. */
+export type Rgb = {
+    r: number;
+    g: number;
+    b: number;
+};
+/** OKLCH: l 0–1, c ≥ 0, h degrees 0–360. */
+export type Oklch = {
+    l: number;
+    c: number;
+    h: number;
+};
+/**
+ * Solve direction relative to ground: `up` = lighter than ground (dark
+ * terminals), `down` = darker (light terminals), `auto` = pick by ground.
+ */
+export type Polarity = "auto" | "up" | "down";
+//# sourceMappingURL=color.d.ts.map

package/dist/lexicon/color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../../src/lexicon/color.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,sCAAsC;AACtC,MAAM,MAAM,GAAG,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtD,4CAA4C;AAC5C,MAAM,MAAM,KAAK,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAExD;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,IAAI,GAAG,MAAM,CAAC"}

package/dist/lexicon/color.js

@@ -0,0 +1,6 @@
+/**
+ * Color value shapes — the raw material the vocabulary is spoken in.
+ * SSOT for these types.
+ */
+export {};
+//# sourceMappingURL=color.js.map

package/dist/lexicon/color.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.js","sourceRoot":"","sources":["../../src/lexicon/color.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/lexicon/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * ./index.js — the visual language, no paint.
+ *
+ * The dependency-root vocabulary every quickdraw/harness package speaks:
+ * semantic roles (hue = identity), tiers (contrast intent), branded
+ * prominence ladders (lightness = hierarchy), text attributes, the
+ * authoring-style contract, and the parity-law quarantine brands.
+ * Zero runtime dependencies; the solver lives in quickdraw-theme.
+ */
+export * from "./tiers.js";
+export * from "./roles.js";
+export * from "./prominence.js";
+export * from "./color.js";
+export * from "./quarantine.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/lexicon/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lexicon/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}

package/dist/lexicon/index.js

@@ -0,0 +1,15 @@
+/**
+ * ./index.js — the visual language, no paint.
+ *
+ * The dependency-root vocabulary every quickdraw/harness package speaks:
+ * semantic roles (hue = identity), tiers (contrast intent), branded
+ * prominence ladders (lightness = hierarchy), text attributes, the
+ * authoring-style contract, and the parity-law quarantine brands.
+ * Zero runtime dependencies; the solver lives in quickdraw-theme.
+ */
+export * from "./tiers.js";
+export * from "./roles.js";
+export * from "./prominence.js";
+export * from "./color.js";
+export * from "./quarantine.js";
+//# sourceMappingURL=index.js.map

package/dist/lexicon/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lexicon/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}

package/dist/lexicon/prominence.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Discrete prominence ladders — branded so app/TEA code cannot pass free floats.
+ *
+ * The brand is a number subtype: `FgP.*` / `BgP.*` assign to Style's bare
+ * `number` fields. Interpolated values (`fgProgress`) stay unbranded numbers.
+ *
+ * Two axes:
+ * - **Fg** — glyph/text weight (ghost → rising → secondary → primary)
+ * - **Bg** — region / panel fill weight (wash → panel → solid)
+ */
+declare const __fgProminence: unique symbol;
+declare const __bgProminence: unique symbol;
+/** Branded foreground prominence (text / border glyphs). */
+export type FgProminence = number & {
+    readonly [__fgProminence]: true;
+};
+/** Branded background / region prominence. */
+export type BgProminence = number & {
+    readonly [__bgProminence]: true;
+};
+export type FgProminenceStep = "whisper" | "ghost" | "rising" | "secondary" | "primary";
+export type BgProminenceStep = "mist" | "wash" | "panel" | "solid";
+/** Named FG steps — only legal prominence sources for TEA fg styles. */
+export declare const FgP: {
+    readonly whisper: FgProminence;
+    readonly ghost: FgProminence;
+    readonly rising: FgProminence;
+    readonly secondary: FgProminence;
+    readonly primary: FgProminence;
+};
+/** Named BG steps — only legal prominence sources for region/panel fills. */
+export declare const BgP: {
+    readonly mist: BgProminence;
+    readonly wash: BgProminence;
+    readonly panel: BgProminence;
+    readonly solid: BgProminence;
+};
+/**
+ * Continuous progress **between two branded endpoints** (render boundary only).
+ * Returns a bare number for Style.prominence — not a new brand.
+ * Partial fill: `fgProgress(FgP.ghost, FgP.secondary, frac)` so frac→1 matches
+ * filled contour and frac→0 matches ambient free (no discrete step jumps).
+ */
+export declare function fgProgress(from: FgProminence, to: FgProminence, t: number): number;
+export {};
+//# sourceMappingURL=prominence.d.ts.map

package/dist/lexicon/prominence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prominence.d.ts","sourceRoot":"","sources":["../../src/lexicon/prominence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,CAAC,MAAM,cAAc,EAAE,OAAO,MAAM,CAAC;AAC5C,OAAO,CAAC,MAAM,cAAc,EAAE,OAAO,MAAM,CAAC;AAE5C,4DAA4D;AAC5D,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,cAAc,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AACxE,8CAA8C;AAC9C,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,cAAc,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AAExE,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,CAAC;AACxF,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AA0CnE,wEAAwE;AACxE,eAAO,MAAM,GAAG;;;;;;CAM2C,CAAC;AAE5D,6EAA6E;AAC7E,eAAO,MAAM,GAAG;;;;;CAK2C,CAAC;AAE5D;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,YAAY,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAGlF"}

package/dist/lexicon/prominence.js

@@ -0,0 +1,73 @@
+/**
+ * Discrete prominence ladders — branded so app/TEA code cannot pass free floats.
+ *
+ * The brand is a number subtype: `FgP.*` / `BgP.*` assign to Style's bare
+ * `number` fields. Interpolated values (`fgProgress`) stay unbranded numbers.
+ *
+ * Two axes:
+ * - **Fg** — glyph/text weight (ghost → rising → secondary → primary)
+ * - **Bg** — region / panel fill weight (wash → panel → solid)
+ */
+/**
+ * FG numeric ladder (resolved into Style.prominence) — proximity to the
+ * reader: primary in hand, secondary on the desk, rising approaching,
+ * ghost in the periphery, whisper a memory trace.
+ * - whisper    — disabled rows, deep age-fade floor (identity stays on hue)
+ * - ghost      — ambient unfilled, gutters, whispers
+ * - rising     — partial fill mid-step (between ambient and contour)
+ * - secondary  — contour, meta, filled context, secondary labels
+ * - primary    — draft body, chevron, selected / primary labels
+ */
+const FG_VALUES = {
+    whisper: 0.28,
+    ghost: 0.42,
+    rising: 0.57,
+    secondary: 0.72,
+    primary: 1,
+};
+/**
+ * BG numeric ladder (regionProminence / panel fills) — depth of matter:
+ * solid object, panel furniture, wash atmosphere, mist weather.
+ * - mist   — procedural-field weight (bgfx wash strength)
+ * - wash   — soft backdrop fade
+ * - panel  — modal / solid-ish panel
+ * - solid  — full opacity region
+ */
+const BG_VALUES = {
+    mist: 0.28,
+    wash: 0.5,
+    panel: 0.85,
+    solid: 1,
+};
+function brandFg(n) {
+    return n;
+}
+function brandBg(n) {
+    return n;
+}
+/** Named FG steps — only legal prominence sources for TEA fg styles. */
+export const FgP = {
+    whisper: brandFg(FG_VALUES.whisper),
+    ghost: brandFg(FG_VALUES.ghost),
+    rising: brandFg(FG_VALUES.rising),
+    secondary: brandFg(FG_VALUES.secondary),
+    primary: brandFg(FG_VALUES.primary),
+};
+/** Named BG steps — only legal prominence sources for region/panel fills. */
+export const BgP = {
+    mist: brandBg(BG_VALUES.mist),
+    wash: brandBg(BG_VALUES.wash),
+    panel: brandBg(BG_VALUES.panel),
+    solid: brandBg(BG_VALUES.solid),
+};
+/**
+ * Continuous progress **between two branded endpoints** (render boundary only).
+ * Returns a bare number for Style.prominence — not a new brand.
+ * Partial fill: `fgProgress(FgP.ghost, FgP.secondary, frac)` so frac→1 matches
+ * filled contour and frac→0 matches ambient free (no discrete step jumps).
+ */
+export function fgProgress(from, to, t) {
+    const f = typeof t === "number" && Number.isFinite(t) ? Math.max(0, Math.min(1, t)) : 0;
+    return from + (to - from) * f;
+}
+//# sourceMappingURL=prominence.js.map

package/dist/lexicon/prominence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prominence.js","sourceRoot":"","sources":["../../src/lexicon/prominence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAaH;;;;;;;;;GASG;AACH,MAAM,SAAS,GAAG;IAChB,OAAO,EAAE,IAAI;IACb,KAAK,EAAE,IAAI;IACX,MAAM,EAAE,IAAI;IACZ,SAAS,EAAE,IAAI;IACf,OAAO,EAAE,CAAC;CACyC,CAAC;AAEtD;;;;;;;GAOG;AACH,MAAM,SAAS,GAAG;IAChB,IAAI,EAAE,IAAI;IACV,IAAI,EAAE,GAAG;IACT,KAAK,EAAE,IAAI;IACX,KAAK,EAAE,CAAC;CAC2C,CAAC;AAEtD,SAAS,OAAO,CAAC,CAAS;IACxB,OAAO,CAAiB,CAAC;AAC3B,CAAC;AACD,SAAS,OAAO,CAAC,CAAS;IACxB,OAAO,CAAiB,CAAC;AAC3B,CAAC;AAED,wEAAwE;AACxE,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC;IACnC,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC;IAC/B,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC;IACjC,SAAS,EAAE,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC;IACvC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC;CACsB,CAAC;AAE5D,6EAA6E;AAC7E,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC;IAC7B,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC;IAC7B,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC;IAC/B,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC;CAC0B,CAAC;AAE5D;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,IAAkB,EAAE,EAAgB,EAAE,CAAS;IACxE,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACxF,OAAO,IAAI,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;AAChC,CAAC"}

package/dist/lexicon/quarantine.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The parity law: every painted color states a role and a prominence.
+ * Literal colors survive only inside named quarantines, and the brand makes
+ * the naming mandatory — a bare Rgb cannot cross an API that asks for a
+ * QuarantinedRgb.
+ *
+ * - `artwork`          — shader fields, Shadertoy sources: color is content.
+ * - `test-vector`      — screenshot/emission fixtures: theming destroys them.
+ * - `data-passthrough` — externally-owned colors (syntax tokens): honored
+ *                        literally, still region-dimmed and depth-degraded.
+ */
+import type { Rgb } from "./color.js";
+export type QuarantineKind = "artwork" | "test-vector" | "data-passthrough";
+declare const __quarantine: unique symbol;
+/** A literal color that has declared why it is allowed to exist. */
+export type QuarantinedRgb = Rgb & {
+    readonly [__quarantine]: QuarantineKind;
+};
+export declare function quarantine(rgb: Rgb, _kind: QuarantineKind): QuarantinedRgb;
+export {};
+//# sourceMappingURL=quarantine.d.ts.map

package/dist/lexicon/quarantine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quarantine.d.ts","sourceRoot":"","sources":["../../src/lexicon/quarantine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAEtC,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,aAAa,GAAG,kBAAkB,CAAC;AAE5E,OAAO,CAAC,MAAM,YAAY,EAAE,OAAO,MAAM,CAAC;AAE1C,oEAAoE;AACpE,MAAM,MAAM,cAAc,GAAG,GAAG,GAAG;IAAE,QAAQ,CAAC,CAAC,YAAY,CAAC,EAAE,cAAc,CAAA;CAAE,CAAC;AAE/E,wBAAgB,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,cAAc,GAAG,cAAc,CAE1E"}

package/dist/lexicon/quarantine.js

@@ -0,0 +1,15 @@
+/**
+ * The parity law: every painted color states a role and a prominence.
+ * Literal colors survive only inside named quarantines, and the brand makes
+ * the naming mandatory — a bare Rgb cannot cross an API that asks for a
+ * QuarantinedRgb.
+ *
+ * - `artwork`          — shader fields, Shadertoy sources: color is content.
+ * - `test-vector`      — screenshot/emission fixtures: theming destroys them.
+ * - `data-passthrough` — externally-owned colors (syntax tokens): honored
+ *                        literally, still region-dimmed and depth-degraded.
+ */
+export function quarantine(rgb, _kind) {
+    return rgb;
+}
+//# sourceMappingURL=quarantine.js.map

package/dist/lexicon/quarantine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quarantine.js","sourceRoot":"","sources":["../../src/lexicon/quarantine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAWH,MAAM,UAAU,UAAU,CAAC,GAAQ,EAAE,KAAqB;IACxD,OAAO,GAAqB,CAAC;AAC/B,CAAC"}

package/dist/lexicon/roles.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Semantic roles — hue carries identity ("who is speaking"), never hierarchy.
+ * Hierarchy is the lightness axis (tier × prominence); state changes move
+ * along lightness, identity stays on hue. A disabled item is its role at
+ * `whisper` prominence, not a different role.
+ *
+ * Roles group into five families (the metaphor system):
+ *
+ * - **voice**      — the content speaking: itself (`foreground`), as an aside
+ *                    (`muted`), raised (`emphasis`), or verbatim (`code` —
+ *                    azure, body-weight; unspecified / unhighlighted source).
+ * - **furniture**  — the room: stagehand text (`chrome`), walls (`border`),
+ *                    floors (`surface`). Distinguished from voices by tier
+ *                    (recede), never by hue.
+ * - **signal**     — states of the world, the absolute grammar: red = broken
+ *                    (`error`), orange = caution (`warning`), green = go
+ *                    (`success`), magenta = machine-in-flux (`running`) —
+ *                    deliberately the one unnatural hue: a process-state
+ *                    outside the natural world-state grammar — plus the two
+ *                    unsupervised permission postures, which own their own
+ *                    hues so they cannot steal warning/error: blue 211
+ *                    classifier-on (`auto`), yellow 110 look-here (`attention`).
+ * - **affordance** — where attention can go (`accent`). Links are
+ *                    accent + underline; selection is accent-hued atmosphere
+ *                    (see quickdraw-theme selection.ts).
+ * - **delta**      — change itself (`diff_add`, `diff_del`): success/error hue
+ *                    families at reading chroma, because diffs are read at
+ *                    length while signals are glanced.
+ */
+export type SemanticRole = "foreground" | "accent" | "error" | "warning" | "success" | "emphasis" | "muted" | "border" | "chrome" | "surface" | "code" | "diff_add" | "diff_del" | "running" | "auto" | "attention";
+export type RoleFamily = "voice" | "furniture" | "signal" | "affordance" | "delta";
+export declare const ROLE_FAMILY: Record<SemanticRole, RoleFamily>;
+/** Every role, in declaration order. */
+export declare const ALL_ROLES: readonly SemanticRole[];
+/** Membership check for unvalidated strings (resolver guard). */
+export declare const ROLES: ReadonlySet<string>;
+//# sourceMappingURL=roles.d.ts.map

package/dist/lexicon/roles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roles.d.ts","sourceRoot":"","sources":["../../src/lexicon/roles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,MAAM,MAAM,YAAY,GACpB,YAAY,GACZ,QAAQ,GACR,OAAO,GACP,SAAS,GACT,SAAS,GACT,UAAU,GACV,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,MAAM,GACN,UAAU,GACV,UAAU,GACV,SAAS,GACT,MAAM,GACN,WAAW,CAAC;AAEhB,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,WAAW,GAAG,QAAQ,GAAG,YAAY,GAAG,OAAO,CAAC;AAEnF,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,YAAY,EAAE,UAAU,CAiBxD,CAAC;AAEF,wCAAwC;AACxC,eAAO,MAAM,SAAS,EAA+B,SAAS,YAAY,EAAE,CAAC;AAE7E,iEAAiE;AACjE,eAAO,MAAM,KAAK,EAAE,WAAW,CAAC,MAAM,CAAsB,CAAC"}

package/dist/lexicon/roles.js

@@ -0,0 +1,52 @@
+/**
+ * Semantic roles — hue carries identity ("who is speaking"), never hierarchy.
+ * Hierarchy is the lightness axis (tier × prominence); state changes move
+ * along lightness, identity stays on hue. A disabled item is its role at
+ * `whisper` prominence, not a different role.
+ *
+ * Roles group into five families (the metaphor system):
+ *
+ * - **voice**      — the content speaking: itself (`foreground`), as an aside
+ *                    (`muted`), raised (`emphasis`), or verbatim (`code` —
+ *                    azure, body-weight; unspecified / unhighlighted source).
+ * - **furniture**  — the room: stagehand text (`chrome`), walls (`border`),
+ *                    floors (`surface`). Distinguished from voices by tier
+ *                    (recede), never by hue.
+ * - **signal**     — states of the world, the absolute grammar: red = broken
+ *                    (`error`), orange = caution (`warning`), green = go
+ *                    (`success`), magenta = machine-in-flux (`running`) —
+ *                    deliberately the one unnatural hue: a process-state
+ *                    outside the natural world-state grammar — plus the two
+ *                    unsupervised permission postures, which own their own
+ *                    hues so they cannot steal warning/error: blue 211
+ *                    classifier-on (`auto`), yellow 110 look-here (`attention`).
+ * - **affordance** — where attention can go (`accent`). Links are
+ *                    accent + underline; selection is accent-hued atmosphere
+ *                    (see quickdraw-theme selection.ts).
+ * - **delta**      — change itself (`diff_add`, `diff_del`): success/error hue
+ *                    families at reading chroma, because diffs are read at
+ *                    length while signals are glanced.
+ */
+export const ROLE_FAMILY = {
+    foreground: "voice",
+    muted: "voice",
+    emphasis: "voice",
+    code: "voice",
+    chrome: "furniture",
+    border: "furniture",
+    surface: "furniture",
+    error: "signal",
+    warning: "signal",
+    success: "signal",
+    running: "signal",
+    auto: "signal",
+    attention: "signal",
+    accent: "affordance",
+    diff_add: "delta",
+    diff_del: "delta",
+};
+/** Every role, in declaration order. */
+export const ALL_ROLES = Object.keys(ROLE_FAMILY);
+/** Membership check for unvalidated strings (resolver guard). */
+export const ROLES = new Set(ALL_ROLES);
+//# sourceMappingURL=roles.js.map

package/dist/lexicon/roles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"roles.js","sourceRoot":"","sources":["../../src/lexicon/roles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAsBH,MAAM,CAAC,MAAM,WAAW,GAAqC;IAC3D,UAAU,EAAE,OAAO;IACnB,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,OAAO;IACjB,IAAI,EAAE,OAAO;IACb,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,WAAW;IACnB,OAAO,EAAE,WAAW;IACpB,KAAK,EAAE,QAAQ;IACf,OAAO,EAAE,QAAQ;IACjB,OAAO,EAAE,QAAQ;IACjB,OAAO,EAAE,QAAQ;IACjB,IAAI,EAAE,QAAQ;IACd,SAAS,EAAE,QAAQ;IACnB,MAAM,EAAE,YAAY;IACpB,QAAQ,EAAE,OAAO;IACjB,QAAQ,EAAE,OAAO;CAClB,CAAC;AAEF,wCAAwC;AACxC,MAAM,CAAC,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAA4B,CAAC;AAE7E,iEAAiE;AACjE,MAAM,CAAC,MAAM,KAAK,GAAwB,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC"}

package/dist/lexicon/tiers.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Salience tiers — how strongly a color separates from the terminal ground.
+ *
+ * A tier names a *contrast intent*, not a lightness: the solver
+ * (../theme/index.js salience.ts) turns tier + hue + measured
+ * ground into an OKLCH lightness via H-K-compensated apparent-lightness
+ * deltas. The numeric deltas live with the solver; the names live here.
+ *
+ * - `alarm`         — lowest lightness separation, highest chroma budget:
+ *                     salience comes from color, not brightness (error/danger).
+ * - `recede`        — furniture: chrome, borders, surfaces. Present, unheard.
+ * - `differentiate` — distinguishable at a glance without dominating.
+ * - `baseline`      — body text. The reference reading contrast.
+ * - `anchor`        — headings and landmarks the eye returns to.
+ */
+export declare const TIERS: readonly ["alarm", "recede", "differentiate", "baseline", "anchor"];
+export type Tier = (typeof TIERS)[number];
+//# sourceMappingURL=tiers.d.ts.map

package/dist/lexicon/tiers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tiers.d.ts","sourceRoot":"","sources":["../../src/lexicon/tiers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,KAAK,qEAAsE,CAAC;AAEzF,MAAM,MAAM,IAAI,GAAG,CAAC,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/lexicon/tiers.js

@@ -0,0 +1,17 @@
+/**
+ * Salience tiers — how strongly a color separates from the terminal ground.
+ *
+ * A tier names a *contrast intent*, not a lightness: the solver
+ * (../theme/index.js salience.ts) turns tier + hue + measured
+ * ground into an OKLCH lightness via H-K-compensated apparent-lightness
+ * deltas. The numeric deltas live with the solver; the names live here.
+ *
+ * - `alarm`         — lowest lightness separation, highest chroma budget:
+ *                     salience comes from color, not brightness (error/danger).
+ * - `recede`        — furniture: chrome, borders, surfaces. Present, unheard.
+ * - `differentiate` — distinguishable at a glance without dominating.
+ * - `baseline`      — body text. The reference reading contrast.
+ * - `anchor`        — headings and landmarks the eye returns to.
+ */
+export const TIERS = ["alarm", "recede", "differentiate", "baseline", "anchor"];
+//# sourceMappingURL=tiers.js.map

package/dist/lexicon/tiers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tiers.js","sourceRoot":"","sources":["../../src/lexicon/tiers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,QAAQ,CAAU,CAAC"}