@promptctl/rich-js 0.1.0

package/dist/renderables/tree.js

@@ -0,0 +1,107 @@
+/**
+ * Tree — hierarchical view with guide lines.
+ */
+import { Segment } from "../core/segment.js";
+import { Style, NULL_STYLE } from "../core/style.js";
+import { RichText } from "../core/text.js";
+// Guide characters
+const GUIDE_BRANCH = "├── ";
+const GUIDE_LAST = "└── ";
+const GUIDE_VERT = "│   ";
+const GUIDE_SPACE = "    ";
+// ASCII fallback
+const GUIDE_BRANCH_ASCII = "+-- ";
+const GUIDE_LAST_ASCII = "+-- ";
+const GUIDE_VERT_ASCII = "|   ";
+function resolveStyle(style) {
+    if (style === undefined)
+        return NULL_STYLE;
+    if (typeof style === "string")
+        return Style.parse(style);
+    return style;
+}
+function toRenderable(label) {
+    if (typeof label === "string")
+        return new RichText(label, { end: "" });
+    if (label instanceof RichText) {
+        // Ensure no trailing newline in tree labels
+        const copy = label.copy();
+        copy.end = "";
+        return copy;
+    }
+    return label;
+}
+export class Tree {
+    label;
+    children;
+    expanded;
+    hideRoot;
+    guideStyle;
+    style;
+    constructor(label, options) {
+        this.label = toRenderable(label);
+        this.children = [];
+        this.expanded = options?.expanded !== false;
+        this.hideRoot = options?.hideRoot ?? false;
+        this.guideStyle = resolveStyle(options?.guide_style);
+        this.style = resolveStyle(options?.style);
+    }
+    add(label, options) {
+        const child = new Tree(label, {
+            guide_style: options?.guide_style,
+            style: options?.style,
+            expanded: options?.expanded,
+        });
+        this.children.push(child);
+        return child;
+    }
+    *render(options) {
+        yield* this._renderNode(options, [], !this.hideRoot);
+    }
+    *_renderNode(options, prefixes, showLabel) {
+        const ascii = options.asciiOnly ?? false;
+        const guideStyle = this.guideStyle.isNull ? undefined : this.guideStyle;
+        if (showLabel) {
+            // Render prefix
+            for (const prefix of prefixes) {
+                yield new Segment(prefix, guideStyle);
+            }
+            // [LAW:single-enforcer] Tree owns its row boundaries explicitly instead
+            // of depending on label renderables to invent trailing newlines.
+            yield* this.label.render(options);
+            yield Segment.line();
+        }
+        if (!this.expanded)
+            return;
+        for (let i = 0; i < this.children.length; i++) {
+            const child = this.children[i];
+            const isLast = i === this.children.length - 1;
+            const branch = ascii
+                ? (isLast ? GUIDE_LAST_ASCII : GUIDE_BRANCH_ASCII)
+                : (isLast ? GUIDE_LAST : GUIDE_BRANCH);
+            const continuation = ascii
+                ? (isLast ? GUIDE_SPACE : GUIDE_VERT_ASCII)
+                : (isLast ? GUIDE_SPACE : GUIDE_VERT);
+            // Child label with branch guide
+            const childGuideStyle = child.guideStyle.isNull ? guideStyle : (child.guideStyle.isNull ? undefined : child.guideStyle);
+            // Render child label
+            for (const prefix of prefixes) {
+                yield new Segment(prefix, childGuideStyle);
+            }
+            yield new Segment(branch, childGuideStyle);
+            yield* child.label.render(options);
+            yield Segment.line();
+            // Render grandchildren with continuation prefix
+            if (child.expanded && child.children.length > 0) {
+                const grandPrefixes = [...prefixes, continuation];
+                for (let j = 0; j < child.children.length; j++) {
+                    yield* child.children[j]._renderNode(options, grandPrefixes, true);
+                }
+            }
+        }
+    }
+    measure(options) {
+        return { minimum: 4, maximum: options.maxWidth };
+    }
+}
+//# sourceMappingURL=tree.js.map

package/dist/renderables/tree.js.map

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

package/dist/template-bindings/index.d.ts

@@ -0,0 +1,61 @@
+/**
+ * rich-js template bindings — public entry point.
+ *
+ * [LAW:one-source-of-truth] This module is the single place where rich-js's
+ * styling vocabulary is exposed as `@promptctl/go-template-js` template
+ * functions. The current registration set covers foreground colour
+ * (named, palette index, hex, RGB), background (`on`), and text
+ * attributes (canonical names, short aliases, `not_*` negations) — all
+ * registered via `richTextStyleFuncs`. `link`, palette / theme /
+ * auto-contrast helpers, and per-position hue rotation ship in follow-up
+ * epics on the same `template-bindings` topic and merge into this same
+ * map. Consumers compose templates against the Engine returned here;
+ * nesting is plain function composition (`{{ red (bold "x") }}`), not a
+ * second markup grammar.
+ *
+ * Fragment type: `RichText`. Chosen because it is the library's primary
+ * text type (implements `Renderable` + `Measurable`), composes via
+ * `append`, and flows directly into the existing render pipeline with no
+ * adapter. Top-level template expressions emit as `RichText[]` — natural
+ * for cases where a single template produces multiple independently
+ * addressable fragments (e.g. multiple top-level `link` calls, each
+ * carrying its own URL).
+ */
+import { type Engine, type FuncMap } from "@promptctl/go-template-js";
+import { RichText } from "../core/text.js";
+/**
+ * Funcs registered by the rich-js binding. Style functions
+ * (foreground / attribute / background) are populated by
+ * `richTextStyleFuncs`; subsequent epics on the `template-bindings`
+ * topic merge `link`, palette/theme/auto-contrast, and per-position
+ * hue rotation into the same map. Exposed as a factory (not a const)
+ * so future registrations that need configuration (e.g. a palette
+ * resolver bound at construction time) have a place to receive
+ * arguments without breaking the public shape.
+ *
+ * `FuncMap` is not parameterised over `T` in `@promptctl/go-template-js` — the engine's
+ * `T` lives on the `Engine`/`EngineConfig`, and per-function input/output
+ * types are carried as runtime `argTypes` on each `TemplateFunc`. The map
+ * therefore *type-checks* against any `EngineConfig<T>.funcs`, but the
+ * functions returned here are only *runtime-compatible* with
+ * `Engine<RichText>`: each style function returns a `RichText` and
+ * requires its lifted child to be a `RichText` (enforced by an
+ * `instanceof` check that throws on misuse). Consumers merging this map
+ * into a wider engine must keep `T = RichText`; merging into an engine
+ * whose `T` is something else will compile but fail at evaluation time.
+ */
+export declare function richTextFuncs(): FuncMap;
+/**
+ * Construct an `Engine<RichText>` with the rich-js style-function set
+ * registered. Consumers that already manage their own engine should call
+ * `richTextFuncs()` and merge the result into their own `createEngine`
+ * configuration; consumers that just want rich-js styling can use this
+ * factory directly.
+ *
+ * `fromString` lifts text literals into `RichText`. `toString` flattens a
+ * `RichText` to its plain text — the engine's no-silent-flatten guard uses
+ * this only for `printf "%s"` / `"%q"` and `print*` slots, where ANSI is
+ * not desired anyway.
+ */
+export declare function createRichTextEngine(): Engine<RichText>;
+//# sourceMappingURL=index.d.ts.map

package/dist/template-bindings/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/template-bindings/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAgB,KAAK,MAAM,EAAE,KAAK,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACpF,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAG3C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAAC,QAAQ,CAAC,CAMvD"}

package/dist/template-bindings/index.js

@@ -0,0 +1,70 @@
+/**
+ * rich-js template bindings — public entry point.
+ *
+ * [LAW:one-source-of-truth] This module is the single place where rich-js's
+ * styling vocabulary is exposed as `@promptctl/go-template-js` template
+ * functions. The current registration set covers foreground colour
+ * (named, palette index, hex, RGB), background (`on`), and text
+ * attributes (canonical names, short aliases, `not_*` negations) — all
+ * registered via `richTextStyleFuncs`. `link`, palette / theme /
+ * auto-contrast helpers, and per-position hue rotation ship in follow-up
+ * epics on the same `template-bindings` topic and merge into this same
+ * map. Consumers compose templates against the Engine returned here;
+ * nesting is plain function composition (`{{ red (bold "x") }}`), not a
+ * second markup grammar.
+ *
+ * Fragment type: `RichText`. Chosen because it is the library's primary
+ * text type (implements `Renderable` + `Measurable`), composes via
+ * `append`, and flows directly into the existing render pipeline with no
+ * adapter. Top-level template expressions emit as `RichText[]` — natural
+ * for cases where a single template produces multiple independently
+ * addressable fragments (e.g. multiple top-level `link` calls, each
+ * carrying its own URL).
+ */
+import { createEngine } from "@promptctl/go-template-js";
+import { RichText } from "../core/text.js";
+import { richTextStyleFuncs } from "./style-funcs.js";
+/**
+ * Funcs registered by the rich-js binding. Style functions
+ * (foreground / attribute / background) are populated by
+ * `richTextStyleFuncs`; subsequent epics on the `template-bindings`
+ * topic merge `link`, palette/theme/auto-contrast, and per-position
+ * hue rotation into the same map. Exposed as a factory (not a const)
+ * so future registrations that need configuration (e.g. a palette
+ * resolver bound at construction time) have a place to receive
+ * arguments without breaking the public shape.
+ *
+ * `FuncMap` is not parameterised over `T` in `@promptctl/go-template-js` — the engine's
+ * `T` lives on the `Engine`/`EngineConfig`, and per-function input/output
+ * types are carried as runtime `argTypes` on each `TemplateFunc`. The map
+ * therefore *type-checks* against any `EngineConfig<T>.funcs`, but the
+ * functions returned here are only *runtime-compatible* with
+ * `Engine<RichText>`: each style function returns a `RichText` and
+ * requires its lifted child to be a `RichText` (enforced by an
+ * `instanceof` check that throws on misuse). Consumers merging this map
+ * into a wider engine must keep `T = RichText`; merging into an engine
+ * whose `T` is something else will compile but fail at evaluation time.
+ */
+export function richTextFuncs() {
+    return richTextStyleFuncs();
+}
+/**
+ * Construct an `Engine<RichText>` with the rich-js style-function set
+ * registered. Consumers that already manage their own engine should call
+ * `richTextFuncs()` and merge the result into their own `createEngine`
+ * configuration; consumers that just want rich-js styling can use this
+ * factory directly.
+ *
+ * `fromString` lifts text literals into `RichText`. `toString` flattens a
+ * `RichText` to its plain text — the engine's no-silent-flatten guard uses
+ * this only for `printf "%s"` / `"%q"` and `print*` slots, where ANSI is
+ * not desired anyway.
+ */
+export function createRichTextEngine() {
+    return createEngine({
+        fromString: (s) => new RichText(s),
+        toString: (rt) => rt.plain,
+        funcs: richTextFuncs(),
+    });
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/template-bindings/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,YAAY,EAA6B,MAAM,2BAA2B,CAAC;AACpF,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,kBAAkB,EAAE,CAAC;AAC9B,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"}

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

@@ -0,0 +1,30 @@
+/**
+ * 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` —
+ * foreground colours (named, palette index, hex, RGB), background
+ * (`on`), text attributes (positive + negated), and short aliases.
+ * Each registration is a templating-time analogue of a piece of
+ * `Style.parse`, so a template fragment composed by these functions
+ * round-trips through `Style` without semantic drift.
+ *
+ * [LAW:dataflow-not-control-flow] Every function follows the same
+ * shape: child `RichText` in, `RichText` out. The styling difference
+ * lives in a captured `Style` value (or constructor closure), not in
+ * branches inside a single dispatch. That is why this file is mostly
+ * factories — the data (the colour, the attribute name) is the
+ * variability; the operation is fixed.
+ */
+import type { FuncMap } from "@promptctl/go-template-js";
+/**
+ * The full binding registration set populated by the template-bindings
+ * style epics — foreground colours (named + generic forms), background
+ * (`on`), text attributes (canonical names, short aliases, and `not_*`
+ * negations), and the hyperlink cell-splitter (`link`).
+ *
+ * Palette/theme/auto-contrast and per-position hue rotation are
+ * deliberately absent — they ship in `rich-template-bindings-83q`.
+ */
+export declare function richTextStyleFuncs(): FuncMap;
+//# sourceMappingURL=style-funcs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"style-funcs.d.ts","sourceRoot":"","sources":["../../src/template-bindings/style-funcs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAgB,MAAM,2BAA2B,CAAC;AAkKvE;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAU5C"}

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

@@ -0,0 +1,172 @@
+/**
+ * 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` —
+ * foreground colours (named, palette index, hex, RGB), background
+ * (`on`), text attributes (positive + negated), and short aliases.
+ * Each registration is a templating-time analogue of a piece of
+ * `Style.parse`, so a template fragment composed by these functions
+ * round-trips through `Style` without semantic drift.
+ *
+ * [LAW:dataflow-not-control-flow] Every function follows the same
+ * shape: child `RichText` in, `RichText` out. The styling difference
+ * lives in a captured `Style` value (or constructor closure), not in
+ * branches inside a single dispatch. That is why this file is mostly
+ * factories — the data (the colour, the attribute name) is the
+ * variability; the operation is fixed.
+ */
+import { Style, ATTRIBUTE_NAMES, ATTRIBUTE_SHORT_ALIASES, } from "../core/style.js";
+import { ColorSpec, ANSI_COLOR_NAMES } from "../core/color.js";
+import { RichText } from "../core/text.js";
+// --- Helpers ---
+/**
+ * Apply a style on top of an already-styled RichText fragment.
+ *
+ * The engine's `"liftable"` arg type lifts string literals to
+ * `RichText` via the binding's `fromString` *before* the body runs,
+ * so by the time we get here, `child` is always a `RichText`. The
+ * defensive instanceof check exists because `"liftable"` admits any
+ * non-primitive value — the engine cannot prove the object is the
+ * binding's own `T`. A misuse (`{{ red someMap }}`) lands here and
+ * fails loudly rather than producing a malformed fragment.
+ *
+ * Conflict resolution follows `Style.add`: the outer (newly applied)
+ * style wins. `red (bold "x")` → bold + red; `red (red "x")` → red.
+ * Spans inside the inner fragment are preserved as-is — their styles
+ * compose with the new wrapper at render time via the segment
+ * pipeline's existing additive semantics.
+ */
+function applyStyleToFragment(child, style) {
+    if (!(child instanceof RichText)) {
+        throw new TypeError(`style function expected a RichText fragment, got ${typeof child === "object" ? Object.prototype.toString.call(child) : typeof child}`);
+    }
+    const result = child.copy();
+    result.style = child.style.add(style);
+    return result;
+}
+function fgFunc(style) {
+    return {
+        fn: ((child) => applyStyleToFragment(child, style)),
+        argTypes: ["liftable"],
+        returnType: "T",
+    };
+}
+// --- Foreground colours: named ---
+function namedColorFuncs() {
+    const out = {};
+    for (const name of Object.keys(ANSI_COLOR_NAMES)) {
+        const colorSpec = ColorSpec.parse(name);
+        out[name] = fgFunc(new Style({ color: colorSpec }));
+    }
+    return out;
+}
+// --- Foreground colours: generic forms ---
+const colorPaletteFunc = {
+    fn: ((index, child) => {
+        if (!Number.isInteger(index) || index < 0 || index > 255) {
+            throw new RangeError(`color index ${index} is out of range (0-255)`);
+        }
+        return applyStyleToFragment(child, new Style({ color: ColorSpec.fromAnsi(index) }));
+    }),
+    argTypes: ["number", "liftable"],
+    returnType: "T",
+};
+// [LAW:types-are-the-program] `hex` advertises a narrower domain than the
+// general colour-spec parser — only `#RRGGBB` / `#RRGGBBAA` is admitted.
+// Without this gate, `ColorSpec.parse` would silently accept any colour-spec
+// string (named colours, `rgb(...)`, `color(N)`), letting `hex "red"` succeed
+// and masking author mistakes.
+const HEX_INPUT_RE = /^#[0-9a-fA-F]{6}([0-9a-fA-F]{2})?$/;
+const colorHexFunc = {
+    fn: ((hex, child) => {
+        if (!HEX_INPUT_RE.test(hex)) {
+            throw new RangeError(`hex expected #RRGGBB or #RRGGBBAA, got ${JSON.stringify(hex)}`);
+        }
+        return applyStyleToFragment(child, new Style({ color: ColorSpec.parse(hex) }));
+    }),
+    argTypes: ["string", "liftable"],
+    returnType: "T",
+};
+const colorRgbFunc = {
+    fn: ((r, g, b, child) => {
+        return applyStyleToFragment(child, new Style({ color: ColorSpec.fromRgb(r, g, b) }));
+    }),
+    argTypes: ["number", "number", "number", "liftable"],
+    returnType: "T",
+};
+// --- Background ---
+const onFunc = {
+    fn: ((spec, child) => {
+        return applyStyleToFragment(child, new Style({ bgcolor: ColorSpec.parse(spec) }));
+    }),
+    argTypes: ["string", "liftable"],
+    returnType: "T",
+};
+// --- Text attributes ---
+//
+// [LAW:one-source-of-truth] The attribute and short-alias inventories
+// come from `core/style.ts`. This file derives the template registration
+// set from the same data `Style.parse` consults — adding an attribute or
+// alias in one place propagates here automatically.
+function attrStyle(name, value) {
+    return new Style({ [name]: value });
+}
+function attributeFuncs() {
+    const out = {};
+    for (const name of ATTRIBUTE_NAMES) {
+        out[name] = fgFunc(attrStyle(name, true));
+        out[`not_${name}`] = fgFunc(attrStyle(name, false));
+    }
+    for (const [alias, canonical] of Object.entries(ATTRIBUTE_SHORT_ALIASES)) {
+        out[alias] = fgFunc(attrStyle(canonical, true));
+    }
+    return out;
+}
+// --- Hyperlink ---
+//
+// `link` is the cell-splitter for the multi-cell consumer contract.
+// Implementation-wise it is the same shape as any other style function:
+// it sets the `link` slot of `Style` exactly as the existing string-form
+// `link URL` does, so a template-built fragment is byte-equivalent to
+// `RichText("x", { style: Style.parse("link u") })`.
+//
+// The cell-boundary signal that consumers (cc-candybar et al.) walk is
+// `fragment.style.link` being truthy. `Style.add` propagates `link`
+// through any outer wrapping call, so `{{ red (link "u" "x") }}` and
+// `{{ link "u" "x" }}` produce shapes that both qualify as cells from
+// the consumer's perspective. Outer-wins on nested links comes for free
+// from `Style.add`'s right-wins-on-conflict rule.
+//
+// [LAW:dataflow-not-control-flow] No special-case AST node, no
+// `LinkFragment` subclass, no second emitter path — the variability is
+// the value of `style.link`, not whether some control-flow branch ran.
+const linkFunc = {
+    fn: ((url, child) => {
+        return applyStyleToFragment(child, new Style({ link: url }));
+    }),
+    argTypes: ["string", "liftable"],
+    returnType: "T",
+};
+// --- Public assembly ---
+/**
+ * The full binding registration set populated by the template-bindings
+ * style epics — foreground colours (named + generic forms), background
+ * (`on`), text attributes (canonical names, short aliases, and `not_*`
+ * negations), and the hyperlink cell-splitter (`link`).
+ *
+ * Palette/theme/auto-contrast and per-position hue rotation are
+ * deliberately absent — they ship in `rich-template-bindings-83q`.
+ */
+export function richTextStyleFuncs() {
+    return {
+        ...namedColorFuncs(),
+        color: colorPaletteFunc,
+        hex: colorHexFunc,
+        rgb: colorRgbFunc,
+        on: onFunc,
+        ...attributeFuncs(),
+        link: linkFunc,
+    };
+}
+//# sourceMappingURL=style-funcs.js.map

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

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

package/dist/themes/buildPalette.d.ts

@@ -0,0 +1,31 @@
+import { ColorRgba } from "../core/color.js";
+import { Palette } from "./palette.js";
+/**
+ * Base colors required to build a full semantic palette.
+ * All are ColorRgba — callers construct from whatever source (hex, HSL, etc.).
+ */
+export interface BaseColors {
+    primary: ColorRgba;
+    secondary: ColorRgba;
+    accent: ColorRgba;
+    success: ColorRgba;
+    warning: ColorRgba;
+    error: ColorRgba;
+    background: ColorRgba;
+    foreground: ColorRgba;
+}
+/**
+ * Build a full semantic palette from base colors.
+ *
+ * Derived entries follow Textual's formulas:
+ * - `*-muted` = color blended 70% toward background
+ * - `text-*`  = contrast text tinted 66% with the accent color (use as
+ *              foreground in muted/background-tinted contexts)
+ * - `on-*`    = WCAG-correct contrast colour (black or white) for use as
+ *              foreground when the FULL accent is the background. Picked
+ *              by relative luminance — single source of truth so widgets
+ *              never need to invert / reverse fg/bg to get readable text.
+ * - `surface` = background blended 5% toward foreground
+ */
+export declare function buildPalette(name: string, dark: boolean, base: BaseColors): Palette;
+//# sourceMappingURL=buildPalette.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"buildPalette.d.ts","sourceRoot":"","sources":["../../src/themes/buildPalette.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAY,MAAM,kBAAkB,CAAC;AAEvD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,SAAS,CAAC;IACnB,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,SAAS,CAAC;IAClB,OAAO,EAAE,SAAS,CAAC;IACnB,OAAO,EAAE,SAAS,CAAC;IACnB,KAAK,EAAE,SAAS,CAAC;IACjB,UAAU,EAAE,SAAS,CAAC;IACtB,UAAU,EAAE,SAAS,CAAC;CACvB;AAUD;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAyBnF"}

package/dist/themes/buildPalette.js

@@ -0,0 +1,43 @@
+import { blendRgb } from "../core/color.js";
+import { alphaBlend, contrastFor } from "./colorMath.js";
+import { Palette } from "./palette.js";
+const MUTED_BLEND = 0.7;
+const TEXT_ALPHA = 0.66;
+const SURFACE_LIFT = 0.05;
+const ACCENT_KEYS = ["primary", "secondary", "accent", "success", "warning", "error"];
+/**
+ * Build a full semantic palette from base colors.
+ *
+ * Derived entries follow Textual's formulas:
+ * - `*-muted` = color blended 70% toward background
+ * - `text-*`  = contrast text tinted 66% with the accent color (use as
+ *              foreground in muted/background-tinted contexts)
+ * - `on-*`    = WCAG-correct contrast colour (black or white) for use as
+ *              foreground when the FULL accent is the background. Picked
+ *              by relative luminance — single source of truth so widgets
+ *              never need to invert / reverse fg/bg to get readable text.
+ * - `surface` = background blended 5% toward foreground
+ */
+export function buildPalette(name, dark, base) {
+    const vars = new Map();
+    // Base entries
+    vars.set("background", base.background);
+    vars.set("foreground", base.foreground);
+    for (const key of ACCENT_KEYS) {
+        vars.set(key, base[key]);
+    }
+    // Surface — subtle lift from background
+    vars.set("surface", blendRgb(base.background, base.foreground, SURFACE_LIFT));
+    // Derived: muted, text-, and on- for each accent.
+    // [LAW:single-enforcer] contrastFor is the only place that decides
+    // black-vs-white for "text on this accent" — widgets read on-${accent}.
+    const contrastText = contrastFor(base.background);
+    for (const key of ACCENT_KEYS) {
+        const color = base[key];
+        vars.set(`${key}-muted`, blendRgb(color, base.background, MUTED_BLEND));
+        vars.set(`text-${key}`, alphaBlend(color, contrastText, TEXT_ALPHA));
+        vars.set(`on-${key}`, contrastFor(color));
+    }
+    return new Palette(name, dark, vars);
+}
+//# sourceMappingURL=buildPalette.js.map

package/dist/themes/buildPalette.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildPalette.js","sourceRoot":"","sources":["../../src/themes/buildPalette.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAiBvC,MAAM,WAAW,GAAG,GAAG,CAAC;AACxB,MAAM,UAAU,GAAG,IAAI,CAAC;AACxB,MAAM,YAAY,GAAG,IAAI,CAAC;AAI1B,MAAM,WAAW,GAAgB,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;AAEnG;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,IAAa,EAAE,IAAgB;IACxE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAqB,CAAC;IAE1C,eAAe;IACf,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IACxC,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IACxC,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QAC9B,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,CAAC;IAED,wCAAwC;IACxC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC;IAE9E,kDAAkD;IAClD,mEAAmE;IACnE,wEAAwE;IACxE,MAAM,YAAY,GAAG,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAClD,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;QACxB,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,QAAQ,EAAE,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC;QACxE,IAAI,CAAC,GAAG,CAAC,QAAQ,GAAG,EAAE,EAAE,UAAU,CAAC,KAAK,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC;QACrE,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,EAAE,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AACvC,CAAC"}

package/dist/themes/colorMath.d.ts

@@ -0,0 +1,23 @@
+import { ColorRgba } from "../core/color.js";
+/**
+ * Darken a color by N levels, where each level reduces HSL lightness by 10%.
+ * Negative levels lighten. Level 0 returns an equivalent triplet (after the
+ * RGB↔HSL roundtrip; values may differ by ±1 due to rounding).
+ */
+export declare function darken(color: ColorRgba, levels: number): ColorRgba;
+/**
+ * Lighten a color by N levels. Equivalent to `darken(color, -levels)`.
+ */
+export declare function lighten(color: ColorRgba, levels: number): ColorRgba;
+/**
+ * Composite `fg` over `bg` with the given alpha (0..1). At alpha=0 returns bg;
+ * at alpha=1 returns fg.
+ */
+export declare function alphaBlend(fg: ColorRgba, bg: ColorRgba, alpha: number): ColorRgba;
+/**
+ * Pick a contrasting foreground (black or white) for a background, using the
+ * WCAG relative-luminance threshold of 0.179 (the perceptually correct cutoff
+ * where black and white are equally readable).
+ */
+export declare function contrastFor(bg: ColorRgba): ColorRgba;
+//# sourceMappingURL=colorMath.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"colorMath.d.ts","sourceRoot":"","sources":["../../src/themes/colorMath.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAY,MAAM,kBAAkB,CAAC;AAmEvD;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAIlE;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAEnE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,EAAE,EAAE,SAAS,EACb,EAAE,EAAE,SAAS,EACb,KAAK,EAAE,MAAM,GACZ,SAAS,CAEX;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,SAAS,GAAG,SAAS,CAKpD"}