@promptctl/rich-js 0.6.0 → 0.8.0

package/dist/themes/colorRef.d.ts

@@ -0,0 +1,52 @@
+import { ColorRgba } from "../core/color.js";
+import type { Palette } from "./palette.js";
+/**
+ * A **color reference** is the one string form an author uses to name a
+ * concrete color: a palette variable name (`"primary"`, `"surface-active"`,
+ * `"text-primary"`) or a literal `#RRGGBB` / `#RRGGBBAA`.
+ *
+ * [LAW:parse-dont-validate] `resolveColorRef` is the single checkpoint that
+ * turns an untrusted reference string into a `ColorRgba`. Everything
+ * downstream — color math, `Style` construction, serialization — takes
+ * `ColorRgba` and therefore cannot ask again whether the name existed. There
+ * is no `isValidColorRef` companion, deliberately: a validator would hand back
+ * the same `string` it was given and every consumer would re-check.
+ *
+ * [LAW:no-silent-failure] A miss throws. An unknown palette name is a broken
+ * config, and the author needs to see which name and what was available — not
+ * a silently substituted default that makes the bar merely look wrong.
+ */
+export declare class ColorRefError extends Error {
+    readonly ref: string;
+    constructor(ref: string, detail: string);
+}
+/**
+ * The literal-color shape, exported so the template bindings gate on the same
+ * pattern this module parses. [LAW:one-source-of-truth] — one regex, one
+ * parser body; the bindings add only their own error wording.
+ */
+export declare const HEX_COLOR_RE: RegExp;
+/**
+ * Parse a `#RRGGBB` / `#RRGGBBAA` literal. The hex arm of
+ * {@link resolveColorRef}, separated so callers that accept *only* literal
+ * colors (color math, which cannot meaningfully operate on a palette name)
+ * share the one implementation instead of re-deriving it.
+ *
+ * @throws {ColorRefError} when `hex` is not a well-formed literal.
+ */
+export declare function parseHexColor(hex: string): ColorRgba;
+/**
+ * Resolve a color reference against `palette`.
+ *
+ * Accepting hex alongside names is what makes this **idempotent**:
+ * `resolveColorRef(p, resolveColorRef(p, r).hex)` equals
+ * `resolveColorRef(p, r)` for every `r` this function accepts. Callers
+ * therefore never branch on "is this a palette name or already a color" —
+ * they call it unconditionally on whatever the author wrote, whether that is
+ * `"surface-active"` or the output of a chain of color math.
+ * [LAW:dataflow-not-control-flow]
+ *
+ * @throws {ColorRefError} on malformed hex or an unknown palette name.
+ */
+export declare function resolveColorRef(palette: Palette, ref: string): ColorRgba;
+//# sourceMappingURL=colorRef.d.ts.map

package/dist/themes/colorRef.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colorRef.d.ts","sourceRoot":"","sources":["../../src/themes/colorRef.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAA6B,MAAM,kBAAkB,CAAC;AACxE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,aAAc,SAAQ,KAAK;IAEpC,QAAQ,CAAC,GAAG,EAAE,MAAM;gBAAX,GAAG,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM;CAKjB;AAUD;;;;GAIG;AACH,eAAO,MAAM,YAAY,QAAuC,CAAC;AAIjE;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAUpD;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,CAcxE"}

package/dist/themes/colorRef.js

@@ -0,0 +1,97 @@
+import { parseRgbHex, parseRgbaHex } from "../core/color.js";
+/**
+ * A **color reference** is the one string form an author uses to name a
+ * concrete color: a palette variable name (`"primary"`, `"surface-active"`,
+ * `"text-primary"`) or a literal `#RRGGBB` / `#RRGGBBAA`.
+ *
+ * [LAW:parse-dont-validate] `resolveColorRef` is the single checkpoint that
+ * turns an untrusted reference string into a `ColorRgba`. Everything
+ * downstream — color math, `Style` construction, serialization — takes
+ * `ColorRgba` and therefore cannot ask again whether the name existed. There
+ * is no `isValidColorRef` companion, deliberately: a validator would hand back
+ * the same `string` it was given and every consumer would re-check.
+ *
+ * [LAW:no-silent-failure] A miss throws. An unknown palette name is a broken
+ * config, and the author needs to see which name and what was available — not
+ * a silently substituted default that makes the bar merely look wrong.
+ */
+export class ColorRefError extends Error {
+    ref;
+    constructor(ref, detail) {
+        super(`color reference ${JSON.stringify(ref)} did not resolve — ${detail}`);
+        this.ref = ref;
+        this.name = "ColorRefError";
+    }
+}
+// A reference *shaped* like hex is resolved as hex; anything else is a palette
+// name. This is a lexical distinction with no overlap — palette variable names
+// never begin with `#` — so it is a parse, not a mode. A `#`-leading string
+// that is malformed hex fails loudly here rather than falling through to a
+// palette lookup that would report a confusing "unknown name" instead of
+// "malformed hex".
+const HEX_LEAD = "#";
+/**
+ * The literal-color shape, exported so the template bindings gate on the same
+ * pattern this module parses. [LAW:one-source-of-truth] — one regex, one
+ * parser body; the bindings add only their own error wording.
+ */
+export const HEX_COLOR_RE = /^#[0-9a-fA-F]{6}([0-9a-fA-F]{2})?$/;
+const OPAQUE_HEX_LENGTH = 7; // "#RRGGBB"
+/**
+ * Parse a `#RRGGBB` / `#RRGGBBAA` literal. The hex arm of
+ * {@link resolveColorRef}, separated so callers that accept *only* literal
+ * colors (color math, which cannot meaningfully operate on a palette name)
+ * share the one implementation instead of re-deriving it.
+ *
+ * @throws {ColorRefError} when `hex` is not a well-formed literal.
+ */
+export function parseHexColor(hex) {
+    const trimmed = hex.trim();
+    if (!HEX_COLOR_RE.test(trimmed)) {
+        throw new ColorRefError(hex, "expected #RRGGBB or #RRGGBBAA");
+    }
+    // Both parsers take the digits without the leading `#`.
+    const digits = trimmed.slice(1);
+    return trimmed.length > OPAQUE_HEX_LENGTH
+        ? parseRgbaHex(digits)
+        : parseRgbHex(digits);
+}
+// Cap the "did you mean" list. Palettes carry ~150 variables; dumping all of
+// them buries the message. Nearby names are what a mistyped reference needs.
+const SUGGESTION_LIMIT = 8;
+/**
+ * Resolve a color reference against `palette`.
+ *
+ * Accepting hex alongside names is what makes this **idempotent**:
+ * `resolveColorRef(p, resolveColorRef(p, r).hex)` equals
+ * `resolveColorRef(p, r)` for every `r` this function accepts. Callers
+ * therefore never branch on "is this a palette name or already a color" —
+ * they call it unconditionally on whatever the author wrote, whether that is
+ * `"surface-active"` or the output of a chain of color math.
+ * [LAW:dataflow-not-control-flow]
+ *
+ * @throws {ColorRefError} on malformed hex or an unknown palette name.
+ */
+export function resolveColorRef(palette, ref) {
+    const trimmed = ref.trim();
+    if (trimmed.startsWith(HEX_LEAD))
+        return parseHexColor(trimmed);
+    const hit = palette.get(trimmed);
+    if (hit === undefined) {
+        throw new ColorRefError(ref, `no such variable in palette ${JSON.stringify(palette.name)}` +
+            suggest(palette, trimmed));
+    }
+    return hit;
+}
+// Names sharing a prefix or suffix with the miss — enough to catch the two
+// mistakes that actually happen (a wrong qualifier, `surface-active` vs
+// `surface-lighten`; a wrong root, `text-primary` vs `primary-text`) without
+// printing the whole palette.
+function suggest(palette, miss) {
+    const parts = miss.split("-");
+    const near = [...palette.vars.keys()]
+        .filter((name) => parts.some((part) => part !== "" && name.includes(part)))
+        .slice(0, SUGGESTION_LIMIT);
+    return near.length === 0 ? "" : `; did you mean: ${near.join(", ")}`;
+}
+//# sourceMappingURL=colorRef.js.map

package/dist/themes/colorRef.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colorRef.js","sourceRoot":"","sources":["../../src/themes/colorRef.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,WAAW,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGxE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,aAAc,SAAQ,KAAK;IAE3B;IADX,YACW,GAAW,EACpB,MAAc;QAEd,KAAK,CAAC,mBAAmB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,sBAAsB,MAAM,EAAE,CAAC,CAAC;QAHnE,QAAG,GAAH,GAAG,CAAQ;QAIpB,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,+EAA+E;AAC/E,+EAA+E;AAC/E,4EAA4E;AAC5E,2EAA2E;AAC3E,yEAAyE;AACzE,mBAAmB;AACnB,MAAM,QAAQ,GAAG,GAAG,CAAC;AAErB;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,oCAAoC,CAAC;AAEjE,MAAM,iBAAiB,GAAG,CAAC,CAAC,CAAC,YAAY;AAEzC;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,aAAa,CAAC,GAAG,EAAE,+BAA+B,CAAC,CAAC;IAChE,CAAC;IACD,wDAAwD;IACxD,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAChC,OAAO,OAAO,CAAC,MAAM,GAAG,iBAAiB;QACvC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC;QACtB,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;AAC1B,CAAC;AAED,6EAA6E;AAC7E,6EAA6E;AAC7E,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAE3B;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe,CAAC,OAAgB,EAAE,GAAW;IAC3D,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAE3B,IAAI,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC;IAEhE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACjC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,MAAM,IAAI,aAAa,CACrB,GAAG,EACH,+BAA+B,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;YAC3D,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAC5B,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,2EAA2E;AAC3E,wEAAwE;AACxE,6EAA6E;AAC7E,8BAA8B;AAC9B,SAAS,OAAO,CAAC,OAAgB,EAAE,IAAY;IAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9B,MAAM,IAAI,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAClC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;SAC1E,KAAK,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC;IAC9B,OAAO,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,mBAAmB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AACvE,CAAC"}

package/dist/themes/palette.d.ts

@@ -7,8 +7,10 @@ import type { ColorRgba } from "../core/color.js";
  * `accent`, `error`, etc. — and are the foundation of the theming system.
  *
  * Storage is uniformly ColorRgba; consumers that load from hex JSON
- * parse to ColorRgba at load time. Spec resolution (modifier, alpha,
- * auto-contrast) lives in PaletteResolver, not here.
+ * parse to ColorRgba at load time. `get` is a bare lookup — turning an
+ * author-written *reference* (a name, or a `#RRGGBB` literal) into a colour
+ * is `resolveColorRef`'s job in `colorRef.ts`, so a Palette never has to
+ * know about the syntax callers write.
  */
 export declare class Palette {
     readonly name: string;

package/dist/themes/palette.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"palette.d.ts","sourceRoot":"","sources":["../../src/themes/palette.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD;;;;;;;;;;GAUG;AACH,qBAAa,OAAO;IAClB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;gBAG5C,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC;IAStC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;CAGxC"}
+{"version":3,"file":"palette.d.ts","sourceRoot":"","sources":["../../src/themes/palette.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD;;;;;;;;;;;;GAYG;AACH,qBAAa,OAAO;IAClB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;gBAG5C,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC;IAStC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;CAGxC"}

package/dist/themes/palette.js

@@ -6,8 +6,10 @@
  * `accent`, `error`, etc. — and are the foundation of the theming system.
  *
  * Storage is uniformly ColorRgba; consumers that load from hex JSON
- * parse to ColorRgba at load time. Spec resolution (modifier, alpha,
- * auto-contrast) lives in PaletteResolver, not here.
+ * parse to ColorRgba at load time. `get` is a bare lookup — turning an
+ * author-written *reference* (a name, or a `#RRGGBB` literal) into a colour
+ * is `resolveColorRef`'s job in `colorRef.ts`, so a Palette never has to
+ * know about the syntax callers write.
  */
 export class Palette {
     name;

package/dist/themes/palette.js.map

@@ -1 +1 @@
-{"version":3,"file":"palette.js","sourceRoot":"","sources":["../../src/themes/palette.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,OAAO,OAAO;IACT,IAAI,CAAS;IACb,IAAI,CAAU;IACd,IAAI,CAAiC;IAE9C,YACE,IAAY,EACZ,IAAa,EACb,IAAoC;QAEpC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,2EAA2E;QAC3E,sEAAsE;QACtE,IAAI,CAAC,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;CACF"}
+{"version":3,"file":"palette.js","sourceRoot":"","sources":["../../src/themes/palette.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,OAAO;IACT,IAAI,CAAS;IACb,IAAI,CAAU;IACd,IAAI,CAAiC;IAE9C,YACE,IAAY,EACZ,IAAa,EACb,IAAoC;QAEpC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,2EAA2E;QAC3E,sEAAsE;QACtE,IAAI,CAAC,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;CACF"}

package/dist/themes/ramp.d.ts

@@ -0,0 +1,84 @@
+/**
+ * A color ramp: a number mapped onto a color through ordered stops.
+ *
+ * "What does 73 % spent look like" has no answer in a vocabulary of discrete
+ * adjustments (`darken`, `mix`, `contrastOn`): each takes colors and returns a
+ * color, and none takes a *measurement*. Without a ramp the answer gets
+ * computed outside the theme system — a script emits a hex, a template
+ * branches `if ge .pct 80 … else if ge .pct 50 …` — and that color decision
+ * can no longer transpose with the palette it was meant to belong to. A ramp
+ * is the one function whose input is a number, so the decision stays inside.
+ *
+ * A threshold cascade is a ramp too: the same stops with a `step` easing hold
+ * each color until the next position, which is exactly `≥ threshold → hotter`
+ * written as data. [LAW:one-type-per-behavior] One primitive; the easing is a
+ * value, so a gradient and a cascade differ by one word, not by which function
+ * was called.
+ *
+ * Interpolation is in OKLCH (`Oklch.mix`), so a `linear` ramp between two
+ * theme colors passes through perceptually even steps rather than the muddy
+ * midpoints of an sRGB blend.
+ *
+ * [LAW:one-way-deps] Imports `core/color` and `core/oklch` only; nothing here
+ * knows what a palette is. Resolving stop *names* is the template binding's
+ * job (`paletteFuncs`), which hands this module resolved colors.
+ */
+import type { ColorRgba } from "../core/color.js";
+/** One stop: the color the ramp is exactly `color` at position `at`. */
+export interface ColorStop {
+    readonly at: number;
+    readonly color: ColorRgba;
+}
+/**
+ * How a value between two stops maps to progress along them. Each easing is
+ * a function on segment progress `t ∈ [0, 1)` — `linear` keeps it, `step`
+ * holds the left stop for the whole segment.
+ *
+ * [LAW:dataflow-not-control-flow] The easing is looked up by name and applied
+ * unconditionally; `at` runs the same code for a gradient and a cascade.
+ */
+export declare const RAMP_EASINGS: {
+    readonly linear: (t: number) => number;
+    readonly step: () => number;
+};
+export type RampEasing = keyof typeof RAMP_EASINGS;
+export declare const RAMP_EASING_NAMES: readonly RampEasing[];
+/**
+ * The gate a spelled easing crosses. [LAW:parse-dont-validate] — returns the
+ * narrowed name, so `ColorRamp` never re-checks. Unknown names throw naming
+ * every legal one. [LAW:no-silent-failure]
+ */
+export declare function parseRampEasing(name: string): RampEasing;
+/**
+ * An immutable ramp over stops sorted by position.
+ *
+ * [LAW:single-enforcer] The constructor is the one place a ramp's shape is
+ * checked — at least one stop, every position finite, positions
+ * non-decreasing — matching the `ColorRgba`/`Oklch` pattern. Positions are
+ * required to arrive in order rather than being sorted here: a ramp whose
+ * stops are read from configuration (`warning at 80, error at 50`) is an
+ * authoring mistake, and sorting would quietly render a different ramp than
+ * the one written. [LAW:no-silent-failure]
+ *
+ * Two stops may share a position: that is a hard edge, the later color
+ * taking over at exactly that value (CSS gradients spell a hard stop the
+ * same way).
+ */
+export declare class ColorRamp {
+    readonly easing: RampEasing;
+    readonly stops: readonly ColorStop[];
+    constructor(easing: RampEasing, stops: readonly ColorStop[]);
+    /**
+     * The color at `value`. Below the first stop it is the first color; at or
+     * above the last stop it is the last; between two stops it is `easing`
+     * of the way from the lower to the upper, so a value exactly on a stop is
+     * that stop's color, byte for byte.
+     *
+     * The two endpoint returns are the exactness contract, not a shortcut:
+     * the sRGB → OKLCH → sRGB round-trip can land a channel one unit off, and a
+     * ramp that does not hit its own stops exactly would make a `step` ramp
+     * paint a color the author never wrote.
+     */
+    at(value: number): ColorRgba;
+}
+//# sourceMappingURL=ramp.d.ts.map

package/dist/themes/ramp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ramp.d.ts","sourceRoot":"","sources":["../../src/themes/ramp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD,wEAAwE;AACxE,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;CAC3B;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY;yBACX,MAAM,KAAG,MAAM;yBACjB,MAAM;CACR,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,YAAY,CAAC;AAEnD,eAAO,MAAM,iBAAiB,EAAgC,SAAS,UAAU,EAAE,CAAC;AAEpF;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAQxD;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,SAAS;IAElB,QAAQ,CAAC,MAAM,EAAE,UAAU;IAC3B,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE;gBAD3B,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,SAAS,SAAS,EAAE;IAmBtC;;;;;;;;;;OAUG;IACH,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS;CAmB7B"}

package/dist/themes/ramp.js

@@ -0,0 +1,123 @@
+/**
+ * A color ramp: a number mapped onto a color through ordered stops.
+ *
+ * "What does 73 % spent look like" has no answer in a vocabulary of discrete
+ * adjustments (`darken`, `mix`, `contrastOn`): each takes colors and returns a
+ * color, and none takes a *measurement*. Without a ramp the answer gets
+ * computed outside the theme system — a script emits a hex, a template
+ * branches `if ge .pct 80 … else if ge .pct 50 …` — and that color decision
+ * can no longer transpose with the palette it was meant to belong to. A ramp
+ * is the one function whose input is a number, so the decision stays inside.
+ *
+ * A threshold cascade is a ramp too: the same stops with a `step` easing hold
+ * each color until the next position, which is exactly `≥ threshold → hotter`
+ * written as data. [LAW:one-type-per-behavior] One primitive; the easing is a
+ * value, so a gradient and a cascade differ by one word, not by which function
+ * was called.
+ *
+ * Interpolation is in OKLCH (`Oklch.mix`), so a `linear` ramp between two
+ * theme colors passes through perceptually even steps rather than the muddy
+ * midpoints of an sRGB blend.
+ *
+ * [LAW:one-way-deps] Imports `core/color` and `core/oklch` only; nothing here
+ * knows what a palette is. Resolving stop *names* is the template binding's
+ * job (`paletteFuncs`), which hands this module resolved colors.
+ */
+import { Oklch } from "../core/oklch.js";
+/**
+ * How a value between two stops maps to progress along them. Each easing is
+ * a function on segment progress `t ∈ [0, 1)` — `linear` keeps it, `step`
+ * holds the left stop for the whole segment.
+ *
+ * [LAW:dataflow-not-control-flow] The easing is looked up by name and applied
+ * unconditionally; `at` runs the same code for a gradient and a cascade.
+ */
+export const RAMP_EASINGS = {
+    linear: (t) => t,
+    step: () => 0,
+};
+export const RAMP_EASING_NAMES = Object.keys(RAMP_EASINGS);
+/**
+ * The gate a spelled easing crosses. [LAW:parse-dont-validate] — returns the
+ * narrowed name, so `ColorRamp` never re-checks. Unknown names throw naming
+ * every legal one. [LAW:no-silent-failure]
+ */
+export function parseRampEasing(name) {
+    if (!Object.hasOwn(RAMP_EASINGS, name)) {
+        throw new RangeError(`unknown ramp easing ${JSON.stringify(name)}; expected one of ` +
+            RAMP_EASING_NAMES.map((n) => JSON.stringify(n)).join(", "));
+    }
+    return name;
+}
+/**
+ * An immutable ramp over stops sorted by position.
+ *
+ * [LAW:single-enforcer] The constructor is the one place a ramp's shape is
+ * checked — at least one stop, every position finite, positions
+ * non-decreasing — matching the `ColorRgba`/`Oklch` pattern. Positions are
+ * required to arrive in order rather than being sorted here: a ramp whose
+ * stops are read from configuration (`warning at 80, error at 50`) is an
+ * authoring mistake, and sorting would quietly render a different ramp than
+ * the one written. [LAW:no-silent-failure]
+ *
+ * Two stops may share a position: that is a hard edge, the later color
+ * taking over at exactly that value (CSS gradients spell a hard stop the
+ * same way).
+ */
+export class ColorRamp {
+    easing;
+    stops;
+    constructor(easing, stops) {
+        this.easing = easing;
+        this.stops = stops;
+        if (stops.length === 0) {
+            throw new RangeError("a ColorRamp needs at least one stop");
+        }
+        for (const [i, stop] of stops.entries()) {
+            if (!Number.isFinite(stop.at)) {
+                throw new RangeError(`ColorRamp stop ${i} has a non-finite position ${stop.at}`);
+            }
+            const prev = stops[i - 1];
+            if (prev !== undefined && stop.at < prev.at) {
+                throw new RangeError(`ColorRamp stops must be in ascending position order; ` +
+                    `stop ${i} at ${stop.at} follows stop ${i - 1} at ${prev.at}`);
+            }
+        }
+    }
+    /**
+     * The color at `value`. Below the first stop it is the first color; at or
+     * above the last stop it is the last; between two stops it is `easing`
+     * of the way from the lower to the upper, so a value exactly on a stop is
+     * that stop's color, byte for byte.
+     *
+     * The two endpoint returns are the exactness contract, not a shortcut:
+     * the sRGB → OKLCH → sRGB round-trip can land a channel one unit off, and a
+     * ramp that does not hit its own stops exactly would make a `step` ramp
+     * paint a color the author never wrote.
+     */
+    at(value) {
+        if (!Number.isFinite(value)) {
+            throw new RangeError(`ColorRamp.at needs a finite value, got ${value}`);
+        }
+        const stops = this.stops;
+        // The last stop at or below `value`; -1 when `value` is below them all.
+        let lower = -1;
+        while (lower + 1 < stops.length && stops[lower + 1].at <= value)
+            lower++;
+        if (lower < 0)
+            return stops[0].color;
+        const from = stops[lower];
+        if (lower === stops.length - 1)
+            return from.color;
+        // `to.at > value >= from.at` by construction of `lower`, so the segment
+        // has positive width and `t ∈ [0, 1)`.
+        const to = stops[lower + 1];
+        const t = RAMP_EASINGS[this.easing]((value - from.at) / (to.at - from.at));
+        if (t <= 0)
+            return from.color;
+        if (t >= 1)
+            return to.color;
+        return Oklch.fromRgba(from.color).mix(Oklch.fromRgba(to.color), t).toRgba();
+    }
+}
+//# sourceMappingURL=ramp.js.map

package/dist/themes/ramp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ramp.js","sourceRoot":"","sources":["../../src/themes/ramp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAGH,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAQzC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,MAAM,EAAE,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC;IAChC,IAAI,EAAE,GAAW,EAAE,CAAC,CAAC;CACb,CAAC;AAIX,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAA0B,CAAC;AAEpF;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,IAAI,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,UAAU,CAClB,uBAAuB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,oBAAoB;YAC7D,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAC7D,CAAC;IACJ,CAAC;IACD,OAAO,IAAkB,CAAC;AAC5B,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,SAAS;IAET;IACA;IAFX,YACW,MAAkB,EAClB,KAA2B;QAD3B,WAAM,GAAN,MAAM,CAAY;QAClB,UAAK,GAAL,KAAK,CAAsB;QAEpC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,UAAU,CAAC,qCAAqC,CAAC,CAAC;QAC9D,CAAC;QACD,KAAK,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YACxC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC9B,MAAM,IAAI,UAAU,CAAC,kBAAkB,CAAC,8BAA8B,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;YACnF,CAAC;YACD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC1B,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;gBAC5C,MAAM,IAAI,UAAU,CAClB,uDAAuD;oBACrD,QAAQ,CAAC,OAAO,IAAI,CAAC,EAAE,iBAAiB,CAAC,GAAG,CAAC,OAAO,IAAI,CAAC,EAAE,EAAE,CAChE,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;;;;;;OAUG;IACH,EAAE,CAAC,KAAa;QACd,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,UAAU,CAAC,0CAA0C,KAAK,EAAE,CAAC,CAAC;QAC1E,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACzB,wEAAwE;QACxE,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC;QACf,OAAO,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,IAAK,KAAK,CAAC,KAAK,GAAG,CAAC,CAAe,CAAC,EAAE,IAAI,KAAK;YAAE,KAAK,EAAE,CAAC;QACxF,IAAI,KAAK,GAAG,CAAC;YAAE,OAAQ,KAAK,CAAC,CAAC,CAAe,CAAC,KAAK,CAAC;QACpD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAc,CAAC;QACvC,IAAI,KAAK,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC;QAClD,wEAAwE;QACxE,uCAAuC;QACvC,MAAM,EAAE,GAAG,KAAK,CAAC,KAAK,GAAG,CAAC,CAAc,CAAC;QACzC,MAAM,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAC3E,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC;QAC9B,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,EAAE,CAAC,KAAK,CAAC;QAC5B,OAAO,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC9E,CAAC;CACF"}

package/dist/widgets/dropdown.d.ts

@@ -20,7 +20,7 @@
  *
  * Width invariant: measure() always returns maxLabelLen(options) + 4
  * regardless of filter state — the query is right-clipped, never wider
- * than the header. See spec/widgets.md → Dropdown → Filtering.
+ * than the header. See docs/widgets.md → Dropdown.
  */
 import { Segment } from "../core/segment.js";
 import type { RenderOptions } from "../core/protocol.js";

package/dist/widgets/dropdown.js

@@ -20,7 +20,7 @@
  *
  * Width invariant: measure() always returns maxLabelLen(options) + 4
  * regardless of filter state — the query is right-clipped, never wider
- * than the header. See spec/widgets.md → Dropdown → Filtering.
+ * than the header. See docs/widgets.md → Dropdown.
  */
 var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
     var useValue = arguments.length > 2;

package/dist/widgets/event-router.d.ts

@@ -17,8 +17,9 @@
  * if it extends the sequence. Tests can call `flush()` to drain synchronously.
  */
 import { KeyEvent } from "./types.js";
-import type { Screen, FocusManager, InteractiveWidget, WidgetMouseEvent, KeyHandlerOptions, Unsubscribe } from "./types.js";
-import type { TerminalHost } from "./terminal-host.js";
+import type { Screen, FocusManager, InteractiveWidget, WidgetMouseEvent, KeyHandlerOptions } from "./types.js";
+import type { Unsubscribe } from "../core/subscription.js";
+import type { TerminalHost } from "../host/terminal-host.js";
 type KeyHandler = (event: KeyEvent) => void;
 type WidgetSource = {
     focusManager: FocusManager;

package/dist/widgets/event-router.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-router.d.ts","sourceRoot":"","sources":["../../src/widgets/event-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,KAAK,EACV,MAAM,EACN,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EAEjB,WAAW,EACZ,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,KAAK,UAAU,GAAG,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;AAM5C,KAAK,YAAY,GAAG;IAClB,YAAY,EAAE,YAAY,CAAC;IAC3B,UAAU,EAAE,MAAM,SAAS,iBAAiB,EAAE,CAAC;CAChD,CAAC;AAEF,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,GAAG,YAAY,CAAC;IAC9B;;;;OAIG;IACH,IAAI,EAAE,YAAY,CAAC;IACnB;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAuGD,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAe;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAU;IACtC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;IAOxC,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,eAAe,CAA0B;IAMjD,OAAO,CAAC,QAAQ,CAA4C;IAM5D,OAAO,CAAC,cAAc,CAAkC;IAKxD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8B;IACvD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgD;gBAElE,OAAO,EAAE,kBAAkB;IA0BvC,KAAK,IAAI,IAAI;IAcb,IAAI,IAAI,IAAI;IA+BZ,KAAK,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,WAAW;IAYpE,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,GAAG,WAAW;IAOhE,oEAAoE;IACpE,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI;IAoBtC,oDAAoD;IACpD,KAAK,IAAI,IAAI;IAab,OAAO,CAAC,KAAK;IAWb,OAAO,CAAC,UAAU;IA6ClB,OAAO,CAAC,gBAAgB;IAsBxB,OAAO,CAAC,aAAa;IA2ErB,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,UAAU;IA2DlB,OAAO,CAAC,WAAW;IA4BnB,OAAO,CAAC,aAAa;CA+BtB"}
+{"version":3,"file":"event-router.d.ts","sourceRoot":"","sources":["../../src/widgets/event-router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,KAAK,EACV,MAAM,EACN,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EAElB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,KAAK,UAAU,GAAG,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;AAM5C,KAAK,YAAY,GAAG;IAClB,YAAY,EAAE,YAAY,CAAC;IAC3B,UAAU,EAAE,MAAM,SAAS,iBAAiB,EAAE,CAAC;CAChD,CAAC;AAEF,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,GAAG,YAAY,CAAC;IAC9B;;;;OAIG;IACH,IAAI,EAAE,YAAY,CAAC;IACnB;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAuGD,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAe;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAU;IACtC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;IAOxC,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,eAAe,CAA0B;IAMjD,OAAO,CAAC,QAAQ,CAA4C;IAM5D,OAAO,CAAC,cAAc,CAAkC;IAKxD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8B;IACvD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgD;gBAElE,OAAO,EAAE,kBAAkB;IA0BvC,KAAK,IAAI,IAAI;IAcb,IAAI,IAAI,IAAI;IA+BZ,KAAK,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,WAAW;IAYpE,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,GAAG,WAAW;IAOhE,oEAAoE;IACpE,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI;IAoBtC,oDAAoD;IACpD,KAAK,IAAI,IAAI;IAab,OAAO,CAAC,KAAK;IAWb,OAAO,CAAC,UAAU;IA6ClB,OAAO,CAAC,gBAAgB;IAsBxB,OAAO,CAAC,aAAa;IA2ErB,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,UAAU;IA2DlB,OAAO,CAAC,WAAW;IA4BnB,OAAO,CAAC,aAAa;CA+BtB"}

package/dist/widgets/focus-manager.d.ts

@@ -4,7 +4,8 @@
  * [LAW:dataflow-not-control-flow] focus transitions are observable state;
  * widgets react to focus/blur events, the manager never skips dispatch.
  */
-import type { InteractiveWidget, FocusManager, KeyEvent, Unsubscribe } from "./types.js";
+import type { InteractiveWidget, FocusManager, KeyEvent } from "./types.js";
+import type { Unsubscribe } from "../core/subscription.js";
 export declare class DefaultFocusManager implements FocusManager {
     accessor widgetList: InteractiveWidget[];
     accessor currentWidget: InteractiveWidget | null;

package/dist/widgets/focus-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"focus-manager.d.ts","sourceRoot":"","sources":["../../src/widgets/focus-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,iBAAiB,EACjB,YAAY,EACZ,QAAQ,EACR,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB,qBAAa,mBAAoB,YAAW,YAAY;IAEtD,QAAQ,CAAC,UAAU,EAAE,iBAAiB,EAAE,CAAM;IAG9C,QAAQ,CAAC,aAAa,EAAE,iBAAiB,GAAG,IAAI,CAAQ;IAExD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA0D;;IAMzF,IAAI,OAAO,IAAI,iBAAiB,GAAG,IAAI,CAEtC;IAED,IAAI,OAAO,IAAI,SAAS,iBAAiB,EAAE,CAE1C;IAGD,QAAQ,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAazC,UAAU,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAkB3C,IAAI,IAAI,IAAI;IAUZ,IAAI,IAAI,IAAI;IAUZ,KAAK,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAOtC,IAAI,IAAI,IAAI;IASZ,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,KAAK,IAAI,GAAG,WAAW;IAS3E,SAAS,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAShC,OAAO,CAAC,gBAAgB;IAKxB,OAAO,CAAC,QAAQ;IAUhB,OAAO,CAAC,UAAU;CAKnB"}
+{"version":3,"file":"focus-manager.d.ts","sourceRoot":"","sources":["../../src/widgets/focus-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,iBAAiB,EACjB,YAAY,EACZ,QAAQ,EACT,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,qBAAa,mBAAoB,YAAW,YAAY;IAEtD,QAAQ,CAAC,UAAU,EAAE,iBAAiB,EAAE,CAAM;IAG9C,QAAQ,CAAC,aAAa,EAAE,iBAAiB,GAAG,IAAI,CAAQ;IAExD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA0D;;IAMzF,IAAI,OAAO,IAAI,iBAAiB,GAAG,IAAI,CAEtC;IAED,IAAI,OAAO,IAAI,SAAS,iBAAiB,EAAE,CAE1C;IAGD,QAAQ,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAazC,UAAU,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAkB3C,IAAI,IAAI,IAAI;IAUZ,IAAI,IAAI,IAAI;IAUZ,KAAK,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAOtC,IAAI,IAAI,IAAI;IASZ,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,KAAK,IAAI,GAAG,WAAW;IAS3E,SAAS,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAShC,OAAO,CAAC,gBAAgB;IAKxB,OAAO,CAAC,QAAQ;IAUhB,OAAO,CAAC,UAAU;CAKnB"}

package/dist/widgets/index.d.ts

@@ -1,4 +1,4 @@
-export type { KeyEventInit, KeyHandlerPriority, KeyHandlerOptions, WidgetMouseEvent, WidgetFocusEvent, WidgetBounds, InteractiveWidget, OverlayRenderable, FocusManager, Screen, MountEntry, Placement, Unsubscribe, } from "./types.js";
+export type { KeyEventInit, KeyHandlerPriority, KeyHandlerOptions, WidgetMouseEvent, WidgetFocusEvent, WidgetBounds, InteractiveWidget, OverlayRenderable, FocusManager, Screen, MountEntry, Placement, } from "./types.js";
 export { FLOW, hasOverlay, KeyEvent } from "./types.js";
 export { StaticItem } from "./static-item.js";
 export type { StaticItemOptions } from "./static-item.js";
@@ -12,15 +12,12 @@ export { Checkbox } from "./checkbox.js";
 export type { CheckboxOptions } from "./checkbox.js";
 export { Toggle } from "./toggle.js";
 export type { ToggleVariant, ToggleOptions } from "./toggle.js";
-export { TextInput } from "./text-input.js";
-export type { TextInputOptions } from "./text-input.js";
+export { TextInput, charGreedyWrap } from "./text-input.js";
+export type { TextInputOptions, WrapStrategy, WrapRow } from "./text-input.js";
 export { Dropdown } from "./dropdown.js";
 export type { DropdownOptions } from "./dropdown.js";
 export { Slider } from "./slider.js";
 export type { SliderOptions } from "./slider.js";
 export { EventRouter } from "./event-router.js";
 export type { EventRouterOptions } from "./event-router.js";
-export { NodeTerminalHost, BrowserTerminalHost } from "./terminal-host.js";
-export type { TerminalHost, TerminalSize, DataHandler, ResizeHandler, NodeTerminalHostOptions, BrowserTerminalHostOptions, XtermTerminal, XtermDisposable, XtermResizeEvent, } from "./terminal-host.js";
-export { hostStream } from "./host-stream.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/widgets/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,MAAM,EACN,UAAU,EACV,SAAS,EACT,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC3E,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,aAAa,EACb,uBAAuB,EACvB,0BAA0B,EAC1B,aAAa,EACb,eAAe,EACf,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/widgets/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,MAAM,EACN,UAAU,EACV,SAAS,GACV,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC5D,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC/E,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/widgets/index.js

@@ -6,10 +6,11 @@ export { DefaultScreen } from "./screen.js";
 export { Button } from "./button.js";
 export { Checkbox } from "./checkbox.js";
 export { Toggle } from "./toggle.js";
-export { TextInput } from "./text-input.js";
+export { TextInput, charGreedyWrap } from "./text-input.js";
 export { Dropdown } from "./dropdown.js";
 export { Slider } from "./slider.js";
 export { EventRouter } from "./event-router.js";
-export { NodeTerminalHost, BrowserTerminalHost } from "./terminal-host.js";
-export { hostStream } from "./host-stream.js";
+// The terminal seam is not re-exported here. It lives on the `host` subpath,
+// and a second path to `TerminalHost` would be the two-clocks problem the
+// subpath split exists to remove.
 //# sourceMappingURL=index.js.map

package/dist/widgets/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/widgets/index.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAY3E,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/widgets/index.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAE5D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD,6EAA6E;AAC7E,0EAA0E;AAC1E,kCAAkC"}

package/dist/widgets/screen.d.ts

@@ -51,7 +51,7 @@
  */
 import { ColorDepth } from "../core/color.js";
 import type { Screen, InteractiveWidget, FocusManager, MountEntry } from "./types.js";
-import type { TerminalHost } from "./terminal-host.js";
+import type { TerminalHost } from "../host/terminal-host.js";
 export type ColorSystemSpec = ColorDepth | "auto" | "truecolor" | "256" | "ansi" | "none" | null;
 export interface ScreenOptions {
     /**

package/dist/widgets/screen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"screen.d.ts","sourceRoot":"","sources":["../../src/widgets/screen.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAMH,OAAO,EAAE,UAAU,EAAsB,MAAM,kBAAkB,CAAC;AAIlE,OAAO,KAAK,EACV,MAAM,EACN,iBAAiB,EACjB,YAAY,EACZ,UAAU,EAGX,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,MAAM,eAAe,GACvB,UAAU,GACV,MAAM,GACN,WAAW,GACX,KAAK,GACL,MAAM,GACN,MAAM,GACN,IAAI,CAAC;AAET,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAmBD,qBAAa,aAAc,YAAW,MAAM;IAC1C,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IAKpC,QAAQ,CAAC,UAAU,EAAE,iBAAiB,EAAE,CAAM;IAM9C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA2C;IAOtE,OAAO,CAAC,eAAe,CAAqC;IAE5D,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,cAAc,CAAgC;IACtD,OAAO,CAAC,eAAe,CAAS;IAKhC,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,aAAa,CAAK;IAE1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAe;IACpC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;IACnD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoB;IAChD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAU;gBAE3B,OAAO,EAAE,aAAa;IAYlC,IAAI,OAAO,IAAI,OAAO,CAErB;IASD,IAAI,OAAO,IAAI,SAAS,iBAAiB,EAAE,CAQ1C;IAID,KAAK,CAAC,GAAG,OAAO,EAAE,UAAU,EAAE,GAAG,IAAI;IAcrC,OAAO,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAcxC,KAAK,IAAI,IAAI;IAoBb,IAAI,IAAI,IAAI;IAwBZ,OAAO,KAAK,KAAK,GAGhB;IAED,OAAO,CAAC,YAAY;IA8IpB,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,IAAI;CAyDb"}
+{"version":3,"file":"screen.d.ts","sourceRoot":"","sources":["../../src/widgets/screen.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAMH,OAAO,EAAE,UAAU,EAAsB,MAAM,kBAAkB,CAAC;AAIlE,OAAO,KAAK,EACV,MAAM,EACN,iBAAiB,EACjB,YAAY,EACZ,UAAU,EAGX,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,MAAM,MAAM,eAAe,GACvB,UAAU,GACV,MAAM,GACN,WAAW,GACX,KAAK,GACL,MAAM,GACN,MAAM,GACN,IAAI,CAAC;AAET,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAmBD,qBAAa,aAAc,YAAW,MAAM;IAC1C,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IAKpC,QAAQ,CAAC,UAAU,EAAE,iBAAiB,EAAE,CAAM;IAM9C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA2C;IAOtE,OAAO,CAAC,eAAe,CAAqC;IAE5D,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,cAAc,CAAgC;IACtD,OAAO,CAAC,eAAe,CAAS;IAKhC,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,aAAa,CAAK;IAE1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAe;IACpC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;IACnD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoB;IAChD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAU;gBAE3B,OAAO,EAAE,aAAa;IAYlC,IAAI,OAAO,IAAI,OAAO,CAErB;IASD,IAAI,OAAO,IAAI,SAAS,iBAAiB,EAAE,CAQ1C;IAID,KAAK,CAAC,GAAG,OAAO,EAAE,UAAU,EAAE,GAAG,IAAI;IAcrC,OAAO,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAcxC,KAAK,IAAI,IAAI;IAoBb,IAAI,IAAI,IAAI;IAwBZ,OAAO,KAAK,KAAK,GAGhB;IAED,OAAO,CAAC,YAAY;IA8IpB,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,IAAI;CAyDb"}