@promptctl/rich-js 0.28.0 → 0.29.0

package/dist/host/app.d.ts

@@ -39,7 +39,7 @@ import { type HostFrame, type FrameHost } from "../core/protocol.js";
 import type { Unsubscribe } from "../core/subscription.js";
 import { Timeline } from "../core/timeline.js";
 import { type View } from "../core/view.js";
-import { type KeyPress, type ScreenMouseEvent, type TerminalReply } from "./input.js";
+import { type KeyEvent, type TerminalMouseEvent, type TerminalReply } from "./input.js";
 import type { TerminalHost } from "./terminal-host.js";
 /**
  * Where an app is in its life. `idle` has not run; `running` holds the
@@ -89,7 +89,7 @@ export interface AppOptions extends DrawOptions {
  * A turn of the wheel, where the pointer was when it turned: `lines` is
  * positive towards the end of the content, a line a notch.
  */
-export interface Wheel {
+export interface WheelEvent {
     readonly x: number;
     readonly y: number;
     readonly lines: number;
@@ -98,11 +98,11 @@ declare const WHEEL_LINES: {
     readonly scroll_up: -1;
     readonly scroll_down: 1;
 };
-type WheelTurn = Extract<ScreenMouseEvent, {
+type WheelTurn = Extract<TerminalMouseEvent, {
     type: keyof typeof WHEEL_LINES;
 }>;
 /** A pointer event `onMouse` hears: every one but the vertical wheel, which is `onWheel`'s. */
-export type AppMouseEvent = Exclude<ScreenMouseEvent, WheelTurn>;
+export type AppMouseEvent = Exclude<TerminalMouseEvent, WheelTurn>;
 /**
  * How an ask ended, with the replies heard before it did. `answered`: the
  * terminal answered DA1, so a query with no reply among `replies` is one it
@@ -148,8 +148,8 @@ export declare class App implements FrameHost {
     private settle;
     constructor(options: AppOptions);
     /**
-     * The terminal the app draws on: the colours a cell that sets none is drawn
-     * in, and the sixteen an ANSI colour names — as given, or as the colour
+     * The terminal the app draws on: the colors a cell that sets none is drawn
+     * in, and the sixteen an ANSI color names — as given, or as the color
      * depth assumes (`resolveTerminal`).
      */
     get terminal(): TerminalColors;
@@ -226,10 +226,10 @@ export declare class App implements FrameHost {
      */
     onPaint(handler: (frame: readonly (readonly Segment[])[]) => void): Unsubscribe;
     /**
-     * Hear every key the app does not quit on, by the `KeyPress` the terminal
+     * Hear every key the app does not quit on, by the `KeyEvent` the terminal
      * reported; `keyName` names it. A handler that throws fails the app.
      */
-    onKey(handler: (press: KeyPress) => void): Unsubscribe;
+    onKey(handler: (press: KeyEvent) => void): Unsubscribe;
     /**
      * Hear every pointer event but the vertical wheel, which is `onWheel`'s,
      * in terminal cells. Only the alternate surface reports the pointer. A
@@ -244,7 +244,7 @@ export declare class App implements FrameHost {
      * and the first that moves something takes it. A handler that throws fails
      * the app.
      */
-    onWheel(handler: (wheel: Wheel) => boolean): Unsubscribe;
+    onWheel(handler: (wheel: WheelEvent) => boolean): Unsubscribe;
     /** Hand the terminal back for good; `run` resolves. */
     stop(): void;
     /**

package/dist/host/app.js

@@ -34,17 +34,17 @@ import { frameRate, systemClock } from "../core/clock.js";
 import { ColorDepth, resolveTerminal } from "../core/color.js";
 import { Console } from "../core/console.js";
 import { Segment } from "../core/segment.js";
-import { SurfacePainter } from "../core/paint.js";
+import { SurfaceRenderer } from "../core/paint.js";
 import { fitHeight, render } from "../core/protocol.js";
 import { Timeline } from "../core/timeline.js";
 import { drawView, frameNow, hostView, undrawn } from "../core/view.js";
 import { hostEnvironment } from "./host-environment.js";
 import { InputParser, keyName, parseKeyName } from "./input.js";
 // [LAW:one-source-of-truth] How a frame draws — its glyphs, the terminal its
-// colours resolve on, the style names it knows, what happens to a style it
+// colors resolve on, the style names it knows, what happens to a style it
 // cannot resolve, markup and highlighting — is the console's to say, so App takes those options as the
 // console declares them. This list is both the type and what is copied: the
-// host alone decides the console's size, colours and sink, so no other
+// host alone decides the console's size, colors and sink, so no other
 // property of the options object reaches it, whatever the object carries.
 const DRAW_OPTIONS = ["asciiOnly", "reducedMotion", "textOrder", "terminal", "theme", "onStyleError", "markup", "highlight", "highlighter"];
 function drawOptions(options) {
@@ -91,10 +91,10 @@ export class App {
     // What the frame on screen says about when it changes, on the clock.
     // Before a frame, nothing.
     said = undrawn(0);
-    // The one wait for the frame's `nextChange`, armed after each frame.
+    // The one wait for the frame's `validUntil`, armed after each frame.
     waking = null;
     // [LAW:one-source-of-truth] The host is the console's whole environment:
-    // its size, its colours, where bytes go. Every frame renders with this
+    // its size, its colors, where bytes go. Every frame renders with this
     // console's options and is encoded for its destination.
     console;
     drawing;
@@ -122,7 +122,7 @@ export class App {
         this.host = options.host;
         this.input = new InputParser({ key: (press) => this.key(press), mouse: (event) => this.mouse(event), reply: (reply) => this.reply(reply) }, options.host.inputChunks);
         this.surface = options.surface;
-        this.painter = new SurfacePainter(options.surface, (bytes) => this.host.write(bytes));
+        this.painter = new SurfaceRenderer(options.surface, (bytes) => this.host.write(bytes));
         this.view = hostView(options.view);
         this._clock = options.clock ?? systemClock();
         this._epoch = this._clock.now();
@@ -133,8 +133,8 @@ export class App {
         this.console = this.drawingConsole();
     }
     /**
-     * The terminal the app draws on: the colours a cell that sets none is drawn
-     * in, and the sixteen an ANSI colour names — as given, or as the colour
+     * The terminal the app draws on: the colors a cell that sets none is drawn
+     * in, and the sixteen an ANSI color names — as given, or as the color
      * depth assumes (`resolveTerminal`).
      */
     get terminal() {
@@ -348,7 +348,7 @@ export class App {
         return () => this.paintHandlers.delete(handler);
     }
     /**
-     * Hear every key the app does not quit on, by the `KeyPress` the terminal
+     * Hear every key the app does not quit on, by the `KeyEvent` the terminal
      * reported; `keyName` names it. A handler that throws fails the app.
      */
     onKey(handler) {
@@ -488,8 +488,8 @@ export class App {
     // says whether the view moves.
     tick() {
         const running = this._phase === "running";
-        const { t, nextChange } = this.said;
-        const wanted = running && nextChange === t;
+        const { t, validUntil } = this.said;
+        const wanted = running && validUntil === t;
         if (this.ticking !== null && (!wanted || this.ticking.rate.perSecond !== this._rate.perSecond)) {
             this.ticking.stop();
             this.ticking = null;
@@ -498,7 +498,7 @@ export class App {
             this.ticking = { rate: this._rate, stop: this._clock.every(this._rate, () => this.paint()) };
         }
         this.waking?.();
-        this.waking = running && t < nextChange && nextChange < Number.POSITIVE_INFINITY ? this._clock.at(nextChange, () => this.paint()) : null;
+        this.waking = running && t < validUntil && validUntil < Number.POSITIVE_INFINITY ? this._clock.at(validUntil, () => this.paint()) : null;
     }
     // [LAW:no-silent-failure] A frame that throws ends the app with that
     // error: the terminal is handed back, and `run` rejects with it.

package/dist/host/host-environment.d.ts

@@ -5,10 +5,10 @@
  *
  * [LAW:one-source-of-truth] A console asks its destination four things: where
  * bytes go, is it a terminal, how big is it, and — through the environment —
- * what colours it draws. A bare sink answers only the first, and the other
+ * what colors it draws. A bare sink answers only the first, and the other
  * three fall to the ambient `process`: some other stream's answer in node,
  * none in a browser, where a console on xterm.js saw an unnamed TTY and drew
- * 16 colours. Handing the console the whole environment keeps all four
+ * 16 colors. Handing the console the whole environment keeps all four
  * answers the host's.
  *
  * The host's size is `size()`, so the environment handed on carries no

package/dist/host/host-environment.js

@@ -5,10 +5,10 @@
  *
  * [LAW:one-source-of-truth] A console asks its destination four things: where
  * bytes go, is it a terminal, how big is it, and — through the environment —
- * what colours it draws. A bare sink answers only the first, and the other
+ * what colors it draws. A bare sink answers only the first, and the other
  * three fall to the ambient `process`: some other stream's answer in node,
  * none in a browser, where a console on xterm.js saw an unnamed TTY and drew
- * 16 colours. Handing the console the whole environment keeps all four
+ * 16 colors. Handing the console the whole environment keeps all four
  * answers the host's.
  *
  * The host's size is `size()`, so the environment handed on carries no

package/dist/host/index.d.ts

@@ -2,8 +2,8 @@ export { BrowserTerminalHost } from "./terminal-host.js";
 export type { TerminalHost, TerminalSize, DataHandler, InputChunks, ResizeHandler, ExitHandler, BrowserTerminalHostOptions, XtermTerminal, XtermDisposable, XtermResizeEvent, } from "./terminal-host.js";
 export { hostEnvironment } from "./host-environment.js";
 export { App } from "./app.js";
-export type { AppMouseEvent, AppOptions, AppPhase, Asked, AskOptions, Wheel } from "./app.js";
+export type { AppMouseEvent, AppOptions, AppPhase, Asked, AskOptions, WheelEvent } from "./app.js";
 export { terminalColors } from "./terminal-colors.js";
 export type { Surface } from "../core/paint.js";
 export { keyName } from "./input.js";
-export type { KeyPress, ScreenMouseEvent, TerminalReply } from "./input.js";
+export type { KeyEvent, TerminalMouseEvent, TerminalReply } from "./input.js";

package/dist/host/input.d.ts

@@ -1,6 +1,6 @@
 /**
  * Terminal input: the bytes a terminal sends for keys and the pointer,
- * parsed into `KeyPress` and `ScreenMouseEvent` values, and the one name
+ * parsed into `KeyEvent` and `TerminalMouseEvent` values, and the one name
  * each key goes by.
  *
  * [LAW:single-enforcer] Escape-sequence parsing lives only here. `App` owns
@@ -42,7 +42,7 @@
  */
 import type { InputChunks } from "./terminal-host.js";
 /** A key as the terminal reported it: plain data, with no say over who hears it. */
-export interface KeyPress {
+export interface KeyEvent {
     readonly key: string;
     /** The printable character the key types, or "" for a key that types none. */
     readonly character: string;
@@ -50,7 +50,7 @@ export interface KeyPress {
     readonly ctrl: boolean;
     readonly meta: boolean;
 }
-export type ScreenMouseEvent = {
+export type TerminalMouseEvent = {
     [T in MouseEventType]: MouseEventOf<T>;
 }[MouseEventType];
 type MouseEventType = "mouse_down" | "mouse_up" | "mouse_move" | "scroll_up" | "scroll_down" | "scroll_left" | "scroll_right";
@@ -70,7 +70,7 @@ interface MouseEventOf<Type extends string> {
  * `ctrl+c`, `shift+tab`, `meta+left`. Shift is not named on a character,
  * which already carries it: Shift+G is `G`.
  */
-export declare function keyName(press: KeyPress): string;
+export declare function keyName(press: KeyEvent): string;
 /**
  * What a terminal sends back when it is asked something: an OSC, DCS or APC
  * string, its introducer and terminator taken off (`11;rgb:1e1e/1e1e/1e1e`
@@ -84,8 +84,8 @@ export interface TerminalReply {
 }
 /** Where a parser delivers what it parses. */
 export interface InputSink {
-    key(press: KeyPress): void;
-    mouse(event: ScreenMouseEvent): void;
+    key(press: KeyEvent): void;
+    mouse(event: TerminalMouseEvent): void;
     reply(reply: TerminalReply): void;
 }
 /**
@@ -114,7 +114,7 @@ export declare class InputParser {
     /** Feed a chunk of bytes (or a string of them) into the parser. */
     feed(chunk: Uint8Array | string): void;
     private drainAndHold;
-    private hold;
+    private validity;
     /**
      * Whether an ask is awaiting the terminal's replies, told by whoever asks
      * at the ask's start and end. Only while one is does an unfinished

package/dist/host/input.js

@@ -1,6 +1,6 @@
 /**
  * Terminal input: the bytes a terminal sends for keys and the pointer,
- * parsed into `KeyPress` and `ScreenMouseEvent` values, and the one name
+ * parsed into `KeyEvent` and `TerminalMouseEvent` values, and the one name
  * each key goes by.
  *
  * [LAW:single-enforcer] Escape-sequence parsing lives only here. `App` owns
@@ -250,7 +250,7 @@ export class InputParser {
             this.drainFully();
         }
         finally {
-            this.hold();
+            this.validity();
         }
     }
     // [LAW:no-ambient-temporal-coupling] Whatever drain leaves at an ESC is an
@@ -264,7 +264,7 @@ export class InputParser {
     // While a reply may arrive the delay settles no hold that may open one: a
     // reply split over a slow link may take longer than it. The wait's end arms
     // it afresh (`awaitReplies`), so what is held then gets the whole delay.
-    hold() {
+    validity() {
         this.cancelEscape();
         if (this.buffer[0] !== ESC)
             return;
@@ -285,7 +285,7 @@ export class InputParser {
     awaitReplies(awaiting) {
         this.awaiting = awaiting;
         if (!awaiting && this.chunks === "split")
-            this.hold();
+            this.validity();
     }
     // [LAW:single-enforcer] The one reading of whether an unfinished control
     // string may be a reply still arriving: only a split host splits one, and

package/dist/host/terminal-colors.d.ts

@@ -1,6 +1,6 @@
 /**
  * The terminal's own foreground and background, asked of it with OSC 10 and
- * OSC 11 — the colours every contrast decision is measured against, which the
+ * OSC 11 — the colors every contrast decision is measured against, which the
  * library otherwise has to assume.
  *
  * [LAW:effects-at-boundaries] The ask is `App`'s, the one reader of its
@@ -11,7 +11,7 @@ import { TerminalColors } from "../core/color.js";
 import type { App } from "./app.js";
 /**
  * Ask the terminal `app` runs on for its foreground and background, and return
- * the terminal `app` draws on with them in place — its sixteen ANSI colours
+ * the terminal `app` draws on with them in place — its sixteen ANSI colors
  * kept, since nothing asks for those. `undefined` when the terminal did not
  * answer both, so the caller keeps what it had. Set it as `app.terminal`.
  */

package/dist/host/terminal-colors.js

@@ -1,6 +1,6 @@
 /**
  * The terminal's own foreground and background, asked of it with OSC 10 and
- * OSC 11 — the colours every contrast decision is measured against, which the
+ * OSC 11 — the colors every contrast decision is measured against, which the
  * library otherwise has to assume.
  *
  * [LAW:effects-at-boundaries] The ask is `App`'s, the one reader of its
@@ -13,12 +13,12 @@ import { pattern } from "../core/pattern.js";
 const QUERIES = ["\x1b]10;?\x1b\\", "\x1b]11;?\x1b\\"];
 // XParseColor's `rgb:` form, 1–4 hex digits a channel, as xterm and every
 // terminal that copies it answers, or `rgba:`, as urxvt answers with
-// transparency on; the alpha says nothing about the colour a cell is drawn in.
+// transparency on; the alpha says nothing about the color a cell is drawn in.
 const RGB = pattern(/^rgba?:([0-9a-f]{1,4})\/([0-9a-f]{1,4})\/([0-9a-f]{1,4})(?:\/[0-9a-f]{1,4})?$/i);
 // A channel of n hex digits is a fraction of 16ⁿ − 1, scaled to 8 bits.
 const channel = (hex) => Math.round((parseInt(hex, 16) / (16 ** hex.length - 1)) * 255);
 /**
- * The colour an OSC 10 or OSC 11 reply reports, or `undefined` when `reply`
+ * The color an OSC 10 or OSC 11 reply reports, or `undefined` when `reply`
  * is not that answer to `slot`.
  */
 function parseColorReply(reply, slot) {
@@ -32,7 +32,7 @@ function parseColorReply(reply, slot) {
 }
 /**
  * Ask the terminal `app` runs on for its foreground and background, and return
- * the terminal `app` draws on with them in place — its sixteen ANSI colours
+ * the terminal `app` draws on with them in place — its sixteen ANSI colors
  * kept, since nothing asks for those. `undefined` when the terminal did not
  * answer both, so the caller keeps what it had. Set it as `app.terminal`.
  */

package/dist/host/terminal-host.d.ts

@@ -96,13 +96,13 @@ export interface TerminalHost {
     readonly isTTY: boolean;
     /**
      * Whether the bytes `write` sends land on a terminal, whatever the input
-     * is. Colour detection asks this: a program with piped stdin and a terminal
+     * is. Color detection asks this: a program with piped stdin and a terminal
      * stdout still draws on a terminal, and `isTTY` would call it plain.
      */
     readonly writesToTerminal: boolean;
     /**
      * The environment a program running on this terminal sees — `TERM`,
-     * `COLORTERM`, `NO_COLOR` and the rest. Colour detection reads it: what a
+     * `COLORTERM`, `NO_COLOR` and the rest. Color detection reads it: what a
      * terminal can draw is a fact about the host, so it travels with the host
      * rather than being read off whatever `process` the renderer happens to
      * share a runtime with, which in a browser is none.

package/dist/host/terminal-host.js

@@ -64,7 +64,7 @@ export class BrowserTerminalHost {
     }
     // What xterm.js is, stated the way a terminal states it: it identifies as
     // `xterm-256color` and draws 24-bit SGR. With no env at all, detection saw
-    // an unnamed TTY and drew every colour at 16-colour depth.
+    // an unnamed TTY and drew every color at 16-color depth.
     get env() {
         return XTERM_ENV;
     }

package/dist/index.d.ts

@@ -1,10 +1,10 @@
 export { cellLen, setCellSize, splitText, chopCells, cellFit, graphemes, asCellCol, asCodePoint, } from "./core/cells.js";
 export type { CellCol, CodeUnit, CodePoint } from "./core/cells.js";
-export { ColorRgba, ColorTable, ColorDepth, ColorSpec, ColorParseError, TerminalTheme, type TerminalColors, parseRgbHex, parseRgbaHex, parseHexColor, blendRgb, resolveColorSystem, detectColorSystem, resolveDestination, STANDARD_TABLE, EIGHT_BIT_TABLE, WINDOWS_TABLE, ANSI_COLOR_NAMES, } from "./core/color.js";
-export type { ColorSystemName, DetectColorOptions, Destination, DestinationOptions } from "./core/color.js";
+export { ColorRgba, ColorTable, ColorDepth, ColorSpec, ColorParseError, TerminalTheme, type TerminalColors, parseRgbHex, parseRgbaHex, parseHexColor, blendRgb, resolveColorSystem, detectColorSystem, resolveOutputTarget, STANDARD_TABLE, EIGHT_BIT_TABLE, WINDOWS_TABLE, ANSI_COLOR_NAMES, } from "./core/color.js";
+export type { ColorSystemName, DetectColorOptions, OutputTarget, DestinationOptions } from "./core/color.js";
 export type { TextOrder } from "./core/text-order.js";
 export { Oklch, IDENTITY, INVERT_LIGHTNESS, isIdentityKey, } from "./core/oklch.js";
-export type { ThemeKey, OklchWeights } from "./core/oklch.js";
+export type { ColorAdjustment, OklchWeights } from "./core/oklch.js";
 export { Palette } from "./themes/palette.js";
 export type { AccentRole, BaseRole, PaletteRole, PaletteRoles, ShadedRole } from "./themes/palette.js";
 export { resolveColorRef, ColorRefError } from "./themes/colorRef.js";
@@ -13,21 +13,21 @@ export type { BaseColors, StatedRoles } from "./themes/buildPalette.js";
 export { DEFAULT_TERMINAL_THEME, MONOKAI, SVG_EXPORT_THEME, NORD, GRUVBOX, DRACULA, TOKYO_NIGHT, FLEXOKI, CYBERPUNK, CATPPUCCIN_MOCHA, CATPPUCCIN_LATTE, CATPPUCCIN_FRAPPE, CATPPUCCIN_MACCHIATO, SOLARIZED_DARK, SOLARIZED_LIGHT, ROSE_PINE, ROSE_PINE_MOON, ROSE_PINE_DAWN, ATOM_ONE_DARK, ATOM_ONE_LIGHT, TEXTUAL_DARK, TEXTUAL_LIGHT, TEXTUAL_ANSI, } from "./themes/terminalThemes.js";
 export { getThemePalette, listThemePalettes } from "./themes/registry.js";
 export type { ThemeName } from "./themes/registry.js";
-export { transposePalette, themeKeyForRoot, isAnchored, ANCHORED_ROOTS, } from "./themes/transpose.js";
-export { lighten, darken, relativeLuminance, contrastRatio, contrastFor, ensureContrast, ensureDrawn, drawnColour, } from "./themes/colorMath.js";
+export { adjustPalette, adjustmentForRoot, isHueLocked, HUE_LOCKED_ROOTS, } from "./themes/adjust.js";
+export { lighten, darken, relativeLuminance, contrastRatio, contrastFor, ensureContrast, ensureMinimumDelta, compositedColor, } from "./themes/colorMath.js";
 export { ColorRamp } from "./themes/ramp.js";
 export type { ColorStop, RampMotion } from "./themes/ramp.js";
-export { EASES, Phase, beat, cubicBezier, parseEase, spring, steps } from "./core/easing.js";
-export type { Beat, Ease, SpringOptions, StepPosition, Timing } from "./core/easing.js";
+export { EASES, WrapMode, stepSequence, cubicBezier, parseEasing, spring, steps } from "./core/easing.js";
+export type { StepSequence, Easing, SpringOptions, StepPosition, Timing } from "./core/easing.js";
 export { Animation } from "./core/animation.js";
-export type { Moves, Timed } from "./core/animation.js";
+export type { Reads, Behavior } from "./core/animation.js";
 export { tween } from "./core/tween.js";
 export { Timeline } from "./core/timeline.js";
 export type { View } from "./core/view.js";
 export { frameRate, systemClock } from "./core/clock.js";
 export type { Clock, FrameRate } from "./core/clock.js";
 export { Style, StyleSyntaxError, StyleStack, Theme, NULL_STYLE, DEFAULT_STYLES, } from "./core/style.js";
-export type { Attributes, Hold, StyleOptions, TextStyle, LayeredStyle } from "./core/style.js";
+export type { Attributes, ValidityInterval, StyleOptions, TextStyle, LayeredStyle } from "./core/style.js";
 export { Segment, ControlType, } from "./core/segment.js";
 export type { ControlCode } from "./core/segment.js";
 export type { Anchor } from "./core/anchor.js";
@@ -35,13 +35,13 @@ export { Box } from "./core/box.js";
 export type { EdgeChars, ContentChars, RowLevel, SubstituteOptions } from "./core/box.js";
 export { ASCII, ASCII2, ASCII_DOUBLE_HEAD, SQUARE, SQUARE_DOUBLE_HEAD, MINIMAL, MINIMAL_HEAVY_HEAD, MINIMAL_DOUBLE_HEAD, SIMPLE, SIMPLE_HEAD, SIMPLE_HEAVY, HORIZONTALS, ROUNDED, HEAVY, HEAVY_EDGE, HEAVY_HEAD, DOUBLE, DOUBLE_EDGE, MARKDOWN, } from "./core/box.js";
 export { render, isRenderable, isMeasurable, withCellWidth, withBoundedWidth, insetHeight, stackedHeight, regionRows, fitHeight, getStyle, } from "./core/protocol.js";
-export type { RenderOptions, OverflowMethod, Height, Renderable, Measurable, Presence, StyleErrorHandler, FrameHost, HostFrame, } from "./core/protocol.js";
+export type { RenderOptions, OverflowMethod, Height, Renderable, Measurable, Visibility, StyleErrorHandler, FrameHost, HostFrame, } from "./core/protocol.js";
 export type { Unsubscribe } from "./core/subscription.js";
 export { Measurement, measureRenderables } from "./core/measure.js";
 export { Span, RichText } from "./core/text.js";
 export type { RichTextOptions } from "./core/text.js";
-export { Strip, CellJoiner, SEAM_MIN_DELTA_E, SEAMS, CAPS, JOINERS, joinerNamed, gradientSeam, } from "./core/strip.js";
-export type { StyledRenderable, Joiner, JoinContext, JoinSeam, JoinCaps, SeamForm, CapsForm, SeamCell, JoinCell, CellColor, Paint, JoinerSpec, } from "./core/strip.js";
+export { Strip, CellSeparator, SEAM_MIN_DELTA_E, SEPARATORS, END_CAPS, SEPARATOR_STYLES, separatorNamed, gradientSeam, } from "./core/strip.js";
+export type { StyledRenderable, Separator, JoinContext, SeparatorSeam, EndCaps, SeamForm, CapsForm, SeamCell, JoinCell, CellColor, Paint, SeparatorSpec, } from "./core/strip.js";
 export { renderToString, segmentToString, segmentsToString, } from "./core/render.js";
 export type { RenderToStringOptions } from "./core/render.js";
 export { OSC8, osc8Sequences } from "./core/osc8.js";
@@ -64,8 +64,8 @@ export type { Env } from "./core/env.js";
 export { Constrain } from "./renderables/constrain.js";
 export { Effected, confined, drawnOf } from "./renderables/effect.js";
 export type { CellAttributes, CellColors, CellLook, Drawn, Effect, EffectCell, EffectedOptions, EffectFrame, ListedCell, Pair, Placed } from "./renderables/effect.js";
-export { ATTRIBUTE_DEFAULTS, EFFECT_CATALOGUE, EFFECT_CURVES, EFFECT_LIGHTS, blink, dissolveOut, fadeIn, gradient, onBeat, layered, onColors, pulse, shimmer, sparkle, steppedInk, wheel, } from "./renderables/effects.js";
-export type { AttributeLoopName, Blink, ColorStep, Curve, EffectTarget, Field, Loop, LoopName, Touch, Transition, TransitionName } from "./renderables/effects.js";
+export { ATTRIBUTE_DEFAULTS, EFFECT_CATALOGUE, EFFECT_CURVES, EFFECT_LIGHTS, blink, dissolveOut, fadeIn, gradient, sampleAndHold, layered, onColors, pulse, shimmer, sparkle, steppedInk, wheel, } from "./renderables/effects.js";
+export type { AttributeLoopName, Blink, ColorStep, Curve, EffectTarget, Field, Loop, LoopName, ColorModifier, Transition, TransitionName } from "./renderables/effects.js";
 export { crossfade, wipe } from "./renderables/change.js";
 export type { Between, Change } from "./renderables/change.js";
 export { lifecycle, throughColors, throughGlyphs } from "./renderables/lifecycle.js";

package/dist/index.js

@@ -1,17 +1,17 @@
 // Core primitives
 export { cellLen, setCellSize, splitText, chopCells, cellFit, graphemes, asCellCol, asCodePoint, } from "./core/cells.js";
-export { ColorRgba, ColorTable, ColorDepth, ColorSpec, ColorParseError, TerminalTheme, parseRgbHex, parseRgbaHex, parseHexColor, blendRgb, resolveColorSystem, detectColorSystem, resolveDestination, STANDARD_TABLE, EIGHT_BIT_TABLE, WINDOWS_TABLE, ANSI_COLOR_NAMES, } from "./core/color.js";
-// Perceptually-uniform color space (manipulation, transposition).
+export { ColorRgba, ColorTable, ColorDepth, ColorSpec, ColorParseError, TerminalTheme, parseRgbHex, parseRgbaHex, parseHexColor, blendRgb, resolveColorSystem, detectColorSystem, resolveOutputTarget, STANDARD_TABLE, EIGHT_BIT_TABLE, WINDOWS_TABLE, ANSI_COLOR_NAMES, } from "./core/color.js";
+// Perceptually-uniform color space (manipulation, adjustment).
 export { Oklch, IDENTITY, INVERT_LIGHTNESS, isIdentityKey, } from "./core/oklch.js";
 // Themes — semantic palettes (distinct from ColorTable quantization LUTs)
 export { Palette } from "./themes/palette.js";
-// The one checkpoint turning an author-written colour string — a palette
-// variable name or a `#RRGGBB` literal — into a colour. [LAW:parse-dont-validate]
+// The one checkpoint turning an author-written color string — a palette
+// variable name or a `#RRGGBB` literal — into a color. [LAW:parse-dont-validate]
 export { resolveColorRef, ColorRefError } from "./themes/colorRef.js";
 export { buildPalette } from "./themes/buildPalette.js";
 export { DEFAULT_TERMINAL_THEME, MONOKAI, SVG_EXPORT_THEME, NORD, GRUVBOX, DRACULA, TOKYO_NIGHT, FLEXOKI, CYBERPUNK, CATPPUCCIN_MOCHA, CATPPUCCIN_LATTE, CATPPUCCIN_FRAPPE, CATPPUCCIN_MACCHIATO, SOLARIZED_DARK, SOLARIZED_LIGHT, ROSE_PINE, ROSE_PINE_MOON, ROSE_PINE_DAWN, ATOM_ONE_DARK, ATOM_ONE_LIGHT, TEXTUAL_DARK, TEXTUAL_LIGHT, TEXTUAL_ANSI, } from "./themes/terminalThemes.js";
 export { getThemePalette, listThemePalettes } from "./themes/registry.js";
-export { transposePalette, themeKeyForRoot, isAnchored, ANCHORED_ROOTS, } from "./themes/transpose.js";
+export { adjustPalette, adjustmentForRoot, isHueLocked, HUE_LOCKED_ROOTS, } from "./themes/adjust.js";
 // WCAG contrast toolkit — accessibility-aware color for styled output.
 // `ensureContrast` keeps a color's hue and only slides its OKLCH lightness to
 // meet the ratio, so themed text stays themed; `contrastFor` picks black/white
@@ -21,7 +21,7 @@ export { transposePalette, themeKeyForRoot, isAnchored, ANCHORED_ROOTS, } from "
 // reaches for to tint a resolved color against itself (e.g. a focused-while-open
 // menu cell lightening its inherited background) without re-deriving from a
 // palette name. Negative levels invert (lighten(c,-n) === darken(c,n)).
-export { lighten, darken, relativeLuminance, contrastRatio, contrastFor, ensureContrast, ensureDrawn, drawnColour, } from "./themes/colorMath.js";
+export { lighten, darken, relativeLuminance, contrastRatio, contrastFor, ensureContrast, ensureMinimumDelta, compositedColor, } from "./themes/colorMath.js";
 // A number → a color through ordered stops, interpolated in OKLCH — the one
 // color operation whose input is a measurement rather than a color, so a
 // gradient (or, with the `step` ease, a threshold cascade) stays inside the
@@ -29,7 +29,7 @@ export { lighten, darken, relativeLuminance, contrastRatio, contrastFor, ensureC
 export { ColorRamp } from "./themes/ramp.js";
 // Progress in [0, 1]: phases turn seconds into it, eases reshape it. One
 // vocabulary for ramps and time-based effects alike, CSS's names throughout.
-export { EASES, Phase, beat, cubicBezier, parseEase, spring, steps } from "./core/easing.js";
+export { EASES, WrapMode, stepSequence, cubicBezier, parseEasing, spring, steps } from "./core/easing.js";
 // A value for a time, and when it next changes: the one type every kind of
 // motion is an instance of — beats, frame sequences, spinners, effects.
 export { Animation } from "./core/animation.js";
@@ -52,8 +52,8 @@ export { render, isRenderable, isMeasurable, withCellWidth, withBoundedWidth, in
 export { Measurement, measureRenderables } from "./core/measure.js";
 // Text
 export { Span, RichText } from "./core/text.js";
-// Strip + Joiner
-export { Strip, CellJoiner, SEAM_MIN_DELTA_E, SEAMS, CAPS, JOINERS, joinerNamed, gradientSeam, } from "./core/strip.js";
+// Strip + Separator
+export { Strip, CellSeparator, SEAM_MIN_DELTA_E, SEPARATORS, END_CAPS, SEPARATOR_STYLES, separatorNamed, gradientSeam, } from "./core/strip.js";
 // renderToString — stateless one-shot emission
 export { renderToString, segmentToString, segmentsToString, } from "./core/render.js";
 // OSC 8 hyperlink wire grammar — for consumers that read rendered bytes back
@@ -79,7 +79,7 @@ export { Console } from "./core/console.js";
 // Renderables
 export { Constrain } from "./renderables/constrain.js";
 export { Effected, confined, drawnOf } from "./renderables/effect.js";
-export { ATTRIBUTE_DEFAULTS, EFFECT_CATALOGUE, EFFECT_CURVES, EFFECT_LIGHTS, blink, dissolveOut, fadeIn, gradient, onBeat, layered, onColors, pulse, shimmer, sparkle, steppedInk, wheel, } from "./renderables/effects.js";
+export { ATTRIBUTE_DEFAULTS, EFFECT_CATALOGUE, EFFECT_CURVES, EFFECT_LIGHTS, blink, dissolveOut, fadeIn, gradient, sampleAndHold, layered, onColors, pulse, shimmer, sparkle, steppedInk, wheel, } from "./renderables/effects.js";
 export { crossfade, wipe } from "./renderables/change.js";
 export { lifecycle, throughColors, throughGlyphs } from "./renderables/lifecycle.js";
 export { scroll } from "./renderables/scroll.js";

package/dist/node/prompt.d.ts

@@ -16,7 +16,7 @@
  * The prompt is printed by the `Console` it was asked on — the app's, when it
  * passed one as `console`, a new default one otherwise — and then a line is
  * read, as Rich's `Console.input` prints its prompt and calls `input()`. So
- * the prompt is coloured exactly as that console's own output would be and
+ * the prompt is colored exactly as that console's own output would be and
  * goes to its target: a console on stderr asks on stderr, beside the
  * invalid-answer messages it prints. It goes as one logical line, never broken
  * at the console's width: the terminal wraps it at whatever width it has.

package/dist/node/prompt.js

@@ -16,7 +16,7 @@
  * The prompt is printed by the `Console` it was asked on — the app's, when it
  * passed one as `console`, a new default one otherwise — and then a line is
  * read, as Rich's `Console.input` prints its prompt and calls `input()`. So
- * the prompt is coloured exactly as that console's own output would be and
+ * the prompt is colored exactly as that console's own output would be and
  * goes to its target: a console on stderr asks on stderr, beside the
  * invalid-answer messages it prints. It goes as one logical line, never broken
  * at the console's width: the terminal wraps it at whatever width it has.

package/dist/node/terminal-host.d.ts

@@ -88,7 +88,7 @@ export interface NodeTerminalHostOptions {
      */
     stdout?: NodeWritable;
     /**
-     * The environment colour detection reads. Defaults to `process.env`; tests
+     * The environment color detection reads. Defaults to `process.env`; tests
      * pass a fixed map so what the host reports does not depend on the shell
      * that ran them.
      */

package/dist/node/traceback.js

@@ -77,8 +77,8 @@ export function installTraceback(options) {
         crashing = true;
         // [LAW:effects-at-boundaries] Render to a string first, then perform one
         // write. `beginCapture` redirects the console's sink without setting
-        // `file:`, so stderr's TTY status still drives colour depth — a `file:`
-        // sink would report `isTTY === false` and silently strip colour.
+        // `file:`, so stderr's TTY status still drives color depth — a `file:`
+        // sink would report `isTTY === false` and silently strip color.
         const out = new Console({ stderr: true });
         out.beginCapture();
         out.print(new Traceback(reason, options));

package/dist/renderables/change.js

@@ -25,7 +25,7 @@ import { Measurement } from "../core/measure.js";
 import { render } from "../core/protocol.js";
 import { Segment } from "../core/segment.js";
 import { Recolored } from "./effect.js";
-import { requireCurve, transition, veiled } from "./effects.js";
+import { requireCurve, transition, mask } from "./effects.js";
 const clamp01 = (x) => Math.min(1, Math.max(0, x));
 /** How much of a cell `p` of the way through a change shows: all of it at either end, none at the half, where the old gives way to the new. */
 const shows = (p) => Math.abs(2 * p - 1);
@@ -85,7 +85,7 @@ class ChangeFrame {
             ...(row < after.length - 1 || ended ? [Segment.line()] : []),
         ]);
         // The change's own animation says it moves every frame, and reads nothing this frame tells.
-        const veil = veiled(() => (cell) => shows(at(cell.row, cell.col)), this.swing);
+        const veil = mask(() => (cell) => shows(at(cell.row, cell.col)), this.swing);
         return render(new Recolored({ render: () => rows }, veil, { t: this.t, key: "change" }), options);
     }
     measure(options) {