@promptctl/rich-js 0.7.0 → 0.9.0

package/dist/template-bindings/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/template-bindings/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,EAAE,YAAY,EAA6B,MAAM,2BAA2B,CAAC;AACpF,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,EAAE,GAAG,kBAAkB,EAAE,EAAE,GAAG,UAAU,EAAE,EAAE,CAAC;AACtD,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO,YAAY,CAAW;QAC5B,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC;QAClC,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK;QAC1B,KAAK,EAAE,aAAa,EAAE;KACvB,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAwB,EACxB,MAAc,EACd,QAAiB,EAAE,EACnB,OAAoD;IAEpD,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC;QAC5C,MAAM,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACzC,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC;YAC1B,QAAQ,EAAE,OAAO,EAAE,QAAQ,IAAI,GAAG;YAClC,UAAU,EAAE,IAAI;YAChB,QAAQ,EAAE,OAAO;SAClB,CAAC,CAAC,CAAC;IACN,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,IAAI,OAAO,CAAC,WAAW,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,cAAc,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IAClG,CAAC;AACH,CAAC;AAED,uEAAuE;AACvE,wEAAwE;AACxE,wEAAwE;AACxE,4DAA4D;AAC5D,MAAM,oBAAoB,GAAG,IAAI,KAAK,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;AACpE,SAAS,cAAc,CAAC,IAAwB;IAC9C,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,oBAAoB,CAAC;IACpD,IAAI,CAAC;QACH,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,oBAAoB,CAAC;IAC9B,CAAC;AACH,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/template-bindings/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,EAAE,YAAY,EAA6B,MAAM,2BAA2B,CAAC;AACpF,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,EAAE,GAAG,kBAAkB,EAAE,EAAE,GAAG,UAAU,EAAE,EAAE,CAAC;AACtD,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO,YAAY,CAAW;QAC5B,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC;QAClC,QAAQ,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK;QAC1B,KAAK,EAAE,aAAa,EAAE;KACvB,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAwB,EACxB,MAAc,EACd,QAAiB,EAAE,EACnB,OAAoD;IAEpD,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC;QAC5C,MAAM,EAAE,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACzC,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC;YAC1B,QAAQ,EAAE,OAAO,EAAE,QAAQ,IAAI,GAAG;YAClC,UAAU,EAAE,IAAI;YAChB,QAAQ,EAAE,OAAO;SAClB,CAAC,CAAC,CAAC;IACN,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,IAAI,OAAO,CAAC,WAAW,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,cAAc,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IAClG,CAAC;AACH,CAAC;AAED,uEAAuE;AACvE,wEAAwE;AACxE,wEAAwE;AACxE,4DAA4D;AAC5D,MAAM,oBAAoB,GAAG,IAAI,KAAK,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;AACpE,SAAS,cAAc,CAAC,IAAwB;IAC9C,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,oBAAoB,CAAC;IACpD,IAAI,CAAC;QACH,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,oBAAoB,CAAC;IAC9B,CAAC;AACH,CAAC"}

package/dist/template-bindings/palette-funcs.d.ts

@@ -1,7 +1,8 @@
 /**
- * The one palette-dependent template function: `color`.
+ * The palette-dependent template functions: `color`, and `ramp` whose stops
+ * are color references.
  *
- * ### Why exactly one
+ * ### Why `color` is the one name resolver
  *
  * This module used to register four kinds of thing: one function per
  * identifier-safe palette variable (`{{ primary child }}`, `{{ accent child }}`,
@@ -31,6 +32,17 @@
  * `style-funcs.ts` paint them. One shape, total over the palette, open to
  * arbitrary composition. [LAW:one-type-per-behavior]
  *
+ * ### Why `ramp` lives here and not with the color math
+ *
+ * `ramp` is the one function whose input is a *number*, and its stops are
+ * spelled as color references — `ramp .pct "step" 0 "panel" 50 "warning" 80
+ * "error"` — resolved through the same `resolveColorRef` that `color` crosses.
+ * Requiring `(color "panel")` around every stop would put the boilerplate
+ * back that this binding exists to remove, and an author who writes a hex
+ * literal loses nothing: the resolver is idempotent on hex. The arithmetic
+ * itself is `ColorRamp` in `themes/ramp.ts`, palette-free; only the
+ * reference resolution is here. [LAW:one-way-deps]
+ *
  * ### Why a getter, not a palette
  *
  * `paletteFuncs` takes `() => Palette` rather than a `Palette`. A consumer
@@ -46,9 +58,9 @@
  * engine and their bodies run at *evaluate* time, so reading the palette
  * through a getter leaves parse-once/evaluate-many completely intact. What the
  * getter must not change is *which functions exist* — and it cannot, because
- * there is now exactly one, whose name does not depend on the palette's
- * contents. That was not true of the generated per-variable functions, which
- * is the second reason they are gone.
+ * the two names here do not depend on the palette's contents. That was not
+ * true of the generated per-variable functions, which is the second reason
+ * they are gone.
  */
 import type { FuncMap } from "@promptctl/go-template-js";
 import type { Palette } from "../themes/palette.js";

package/dist/template-bindings/palette-funcs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"palette-funcs.d.ts","sourceRoot":"","sources":["../../src/template-bindings/palette-funcs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAgB,MAAM,2BAA2B,CAAC;AACvE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAGpD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,OAAO,GAAG,OAAO,CAO/D"}
+{"version":3,"file":"palette-funcs.d.ts","sourceRoot":"","sources":["../../src/template-bindings/palette-funcs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAgB,MAAM,2BAA2B,CAAC;AACvE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAsCpD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,OAAO,GAAG,OAAO,CA8B/D"}

package/dist/template-bindings/palette-funcs.js

@@ -1,7 +1,8 @@
 /**
- * The one palette-dependent template function: `color`.
+ * The palette-dependent template functions: `color`, and `ramp` whose stops
+ * are color references.
  *
- * ### Why exactly one
+ * ### Why `color` is the one name resolver
  *
  * This module used to register four kinds of thing: one function per
  * identifier-safe palette variable (`{{ primary child }}`, `{{ accent child }}`,
@@ -31,6 +32,17 @@
  * `style-funcs.ts` paint them. One shape, total over the palette, open to
  * arbitrary composition. [LAW:one-type-per-behavior]
  *
+ * ### Why `ramp` lives here and not with the color math
+ *
+ * `ramp` is the one function whose input is a *number*, and its stops are
+ * spelled as color references — `ramp .pct "step" 0 "panel" 50 "warning" 80
+ * "error"` — resolved through the same `resolveColorRef` that `color` crosses.
+ * Requiring `(color "panel")` around every stop would put the boilerplate
+ * back that this binding exists to remove, and an author who writes a hex
+ * literal loses nothing: the resolver is idempotent on hex. The arithmetic
+ * itself is `ColorRamp` in `themes/ramp.ts`, palette-free; only the
+ * reference resolution is here. [LAW:one-way-deps]
+ *
  * ### Why a getter, not a palette
  *
  * `paletteFuncs` takes `() => Palette` rather than a `Palette`. A consumer
@@ -46,11 +58,41 @@
  * engine and their bodies run at *evaluate* time, so reading the palette
  * through a getter leaves parse-once/evaluate-many completely intact. What the
  * getter must not change is *which functions exist* — and it cannot, because
- * there is now exactly one, whose name does not depend on the palette's
- * contents. That was not true of the generated per-variable functions, which
- * is the second reason they are gone.
+ * the two names here do not depend on the palette's contents. That was not
+ * true of the generated per-variable functions, which is the second reason
+ * they are gone.
  */
 import { resolveColorRef } from "../themes/colorRef.js";
+import { ColorRamp, parseRampEasing } from "../themes/ramp.js";
+/**
+ * The `(position, color-ref)` pairs a `ramp` call's tail spells, as stops.
+ *
+ * The engine's `alternating` gate has already typed every even slot as a
+ * float and every odd slot as a string; what it cannot see is the *pairing*
+ * — a trailing position with no color — nor that the string is a color
+ * reference. Both are settled here, once, and `ColorRamp` receives resolved
+ * stops it never re-checks. [LAW:parse-dont-validate]
+ *
+ * Each reference resolves against the palette of *this* evaluation, so a
+ * ramp over palette names follows the theme exactly as `color` does.
+ */
+function colorStops(tail, palette) {
+    if (tail.length === 0) {
+        throw new RangeError(`ramp needs at least one stop after the easing: ramp <value> <easing> <position> <color> …`);
+    }
+    if (tail.length % 2 !== 0) {
+        throw new RangeError(`ramp's last stop (position ${String(tail[tail.length - 1])}) has no color — ` +
+            `stops are <position> <color> pairs`);
+    }
+    const stops = [];
+    for (let i = 0; i < tail.length; i += 2) {
+        stops.push({
+            at: tail[i],
+            color: resolveColorRef(palette, tail[i + 1]),
+        });
+    }
+    return stops;
+}
 /**
  * Register `color "name-or-hex"` against a live palette.
  *
@@ -84,6 +126,27 @@ export function paletteFuncs(getPalette) {
         argTypes: ["string"],
         returnType: "string",
     };
-    return { color: colorFunc };
+    // `ramp <value> <easing> <position> <color> …` — the argument list is one
+    // float/string cycle end to end (value, easing, then each stop's position
+    // and color), so the engine's `alternating` gate types every slot; the
+    // pairing and the references are parsed in `colorStops`.
+    // [LAW:types-are-the-program]
+    const rampFunc = {
+        fn: ((...args) => {
+            // The engine's `alternating` gate types each slot but sets no minimum
+            // count, so `{{ ramp }}` and `{{ ramp 65 }}` both reach here: one
+            // check over the whole list, naming what is missing. [LAW:no-silent-failure]
+            if (args.length < 2) {
+                throw new RangeError(`ramp needs a value and an easing before its stops (got ${args.length}): ` +
+                    `ramp <value> "linear"|"step" <position> <color> …`);
+            }
+            const [value, easing, ...tail] = args;
+            return new ColorRamp(parseRampEasing(easing), colorStops(tail, getPalette())).at(value).hex;
+        }),
+        argTypes: ["float", "string"],
+        argTypePattern: "alternating",
+        returnType: "string",
+    };
+    return { color: colorFunc, ramp: rampFunc };
 }
 //# sourceMappingURL=palette-funcs.js.map

package/dist/template-bindings/palette-funcs.js.map

@@ -1 +1 @@
-{"version":3,"file":"palette-funcs.js","sourceRoot":"","sources":["../../src/template-bindings/palette-funcs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AAIH,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,YAAY,CAAC,UAAyB;IACpD,MAAM,SAAS,GAAiB;QAC9B,EAAE,EAAE,CAAC,CAAC,GAAW,EAAE,EAAE,CAAC,eAAe,CAAC,UAAU,EAAE,EAAE,GAAG,CAAC,CAAC,GAAG,CAAuB;QACnF,QAAQ,EAAE,CAAC,QAAQ,CAAC;QACpB,UAAU,EAAE,QAAQ;KACrB,CAAC;IACF,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AAC9B,CAAC"}
+{"version":3,"file":"palette-funcs.js","sourceRoot":"","sources":["../../src/template-bindings/palette-funcs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AAIH,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,eAAe,EAAkB,MAAM,mBAAmB,CAAC;AAE/E;;;;;;;;;;;GAWG;AACH,SAAS,UAAU,CAAC,IAAwB,EAAE,OAAgB;IAC5D,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,UAAU,CAClB,2FAA2F,CAC5F,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,UAAU,CAClB,8BAA8B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,mBAAmB;YAC5E,oCAAoC,CACvC,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAgB,EAAE,CAAC;IAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC;YACT,EAAE,EAAE,IAAI,CAAC,CAAC,CAAW;YACrB,KAAK,EAAE,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,CAAW,CAAC;SACvD,CAAC,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,YAAY,CAAC,UAAyB;IACpD,MAAM,SAAS,GAAiB;QAC9B,EAAE,EAAE,CAAC,CAAC,GAAW,EAAE,EAAE,CAAC,eAAe,CAAC,UAAU,EAAE,EAAE,GAAG,CAAC,CAAC,GAAG,CAAuB;QACnF,QAAQ,EAAE,CAAC,QAAQ,CAAC;QACpB,UAAU,EAAE,QAAQ;KACrB,CAAC;IACF,0EAA0E;IAC1E,0EAA0E;IAC1E,uEAAuE;IACvE,yDAAyD;IACzD,8BAA8B;IAC9B,MAAM,QAAQ,GAAiB;QAC7B,EAAE,EAAE,CAAC,CAAC,GAAG,IAAe,EAAE,EAAE;YAC1B,sEAAsE;YACtE,kEAAkE;YAClE,6EAA6E;YAC7E,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpB,MAAM,IAAI,UAAU,CAClB,0DAA0D,IAAI,CAAC,MAAM,KAAK;oBACxE,mDAAmD,CACtD,CAAC;YACJ,CAAC;YACD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,IAAsC,CAAC;YACxE,OAAO,IAAI,SAAS,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC;QAC9F,CAAC,CAAuB;QACxB,QAAQ,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC;QAC7B,cAAc,EAAE,aAAa;QAC7B,UAAU,EAAE,QAAQ;KACrB,CAAC;IACF,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAC9C,CAAC"}

package/dist/template-bindings/style-funcs.d.ts

@@ -2,7 +2,7 @@
  * Style-function registrations for the rich-js template binding.
  *
  * [LAW:one-source-of-truth] The function inventory below mirrors the
- * string-syntax style vocabulary documented in `spec/style.md` — the two
+ * string-syntax style vocabulary documented in `docs/style.md` — the two
  * colour slots (`fg`/`bg`), text attributes (positive + negated), short
  * aliases, and the hyperlink. Each registration is a templating-time analogue
  * of a piece of `Style.parse`, so a template fragment composed by these

package/dist/template-bindings/style-funcs.js

@@ -2,7 +2,7 @@
  * Style-function registrations for the rich-js template binding.
  *
  * [LAW:one-source-of-truth] The function inventory below mirrors the
- * string-syntax style vocabulary documented in `spec/style.md` — the two
+ * string-syntax style vocabulary documented in `docs/style.md` — the two
  * colour slots (`fg`/`bg`), text attributes (positive + negated), short
  * aliases, and the hyperlink. Each registration is a templating-time analogue
  * of a piece of `Style.parse`, so a template fragment composed by these

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":"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"}

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"}

package/dist/widgets/text-input.d.ts

@@ -100,9 +100,8 @@ export interface WrapRow {
  * awareness, just fits the line to the width.
  *
  * Wide characters (CJK, emoji) are treated as atomic: a char that would
- * straddle the budget is moved to the next row rather than split. When the
- * budget is too narrow to fit even one character, that character is
- * force-taken to guarantee progress (avoids an infinite loop).
+ * straddle the budget is moved to the next row rather than split, and one too
+ * wide for the whole budget is force-taken — see `cellStepFrom`.
  */
 export declare const charGreedyWrap: WrapStrategy;
 export interface TextInputOptions {

package/dist/widgets/text-input.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"text-input.d.ts","sourceRoot":"","sources":["../../src/widgets/text-input.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"text-input.d.ts","sourceRoot":"","sources":["../../src/widgets/text-input.ts"],"names":[],"mappings":"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"}

package/dist/widgets/text-input.js

@@ -93,7 +93,7 @@ import { observable, action } from "mobx";
 import { Segment } from "../core/segment.js";
 import { Style } from "../core/style.js";
 import { ColorSpec } from "../core/color.js";
-import { cellLen, setCellSize, splitText, cellFitFrom, cellColToCodeUnitOffset, asCellCol, asCodePoint, nextCodePoint, prevCodePoint, } from "../core/cells.js";
+import { cellLen, setCellSize, splitText, cellStepFrom, cellColToCodeUnitOffset, asCellCol, asCodePoint, nextCodePoint, prevCodePoint, } from "../core/cells.js";
 import { DEFAULT_TERMINAL_THEME } from "../themes/terminalThemes.js";
 import { WidgetBase } from "./widget-base.js";
 /**
@@ -103,9 +103,8 @@ import { WidgetBase } from "./widget-base.js";
  * awareness, just fits the line to the width.
  *
  * Wide characters (CJK, emoji) are treated as atomic: a char that would
- * straddle the budget is moved to the next row rather than split. When the
- * budget is too narrow to fit even one character, that character is
- * force-taken to guarantee progress (avoids an infinite loop).
+ * straddle the budget is moved to the next row rather than split, and one too
+ * wide for the whole budget is force-taken — see `cellStepFrom`.
  */
 export const charGreedyWrap = (line, { firstWidth, continuationWidth }) => {
     if (line.length === 0)
@@ -117,14 +116,7 @@ export const charGreedyWrap = (line, { firstWidth, continuationWidth }) => {
         const cap = isFirst ? firstWidth : continuationWidth;
         if (cap <= 0)
             break;
-        let end = cellFitFrom(line, pos, cap);
-        if (end === pos) {
-            // Leading character exceeds cap — force-take one code point to guarantee
-            // progress when the terminal is extremely narrow.
-            end = nextCodePoint(line, pos);
-            if (end === pos)
-                break;
-        }
+        const end = cellStepFrom(line, pos, cap);
         rows.push({ content: line.slice(pos, end), start: pos });
         pos = end;
         isFirst = false;