@promptctl/rich-js 0.1.0

package/dist/core/cells.js.map

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

package/dist/core/color.d.ts

@@ -0,0 +1,158 @@
+/**
+ * Terminal color representation, parsing, downgrading, and ANSI code generation.
+ */
+/**
+ * Immutable RGBA color value. Alpha defaults to 1 (fully opaque).
+ *
+ * [LAW:single-enforcer] The constructor is the sole validation site for
+ * channel/alpha invariants. Float-arithmetic callers (HSL roundtrips, blends,
+ * lerps) are responsible for `Math.round` + clamp before construction; the
+ * constructor throws rather than silently masking out-of-range input.
+ */
+export declare class ColorRgba {
+    readonly red: number;
+    readonly green: number;
+    readonly blue: number;
+    readonly alpha: number;
+    constructor(red: number, green: number, blue: number, alpha?: number);
+    /** 6-char `#RRGGBB` when fully opaque, 8-char `#RRGGBBAA` otherwise. */
+    get hex(): string;
+    /** `rgb(r,g,b)` when fully opaque, `rgba(r,g,b,a)` otherwise. */
+    get rgb(): string;
+    /** [r/255, g/255, b/255, alpha] — alpha is already 0..1, no division. */
+    get normalized(): [number, number, number, number];
+    /**
+     * Composite this color over an opaque background. Returns a fully opaque
+     * ColorRgba (alpha=1). Per-channel linear interpolation by alpha.
+     *
+     * [LAW:dataflow-not-control-flow] alpha=1 short-circuits to `this`, so
+     * callers can invoke this unconditionally; the data decides whether work
+     * happens.
+     */
+    compositeOver(bg: ColorRgba): ColorRgba;
+}
+export declare class ColorTable {
+    private readonly colors;
+    private readonly matchCache;
+    constructor(colors: ColorRgba[]);
+    get(index: number): ColorRgba;
+    get size(): number;
+    /**
+     * Finds the nearest table index to the given color (Euclidean RGB distance, cached).
+     * Alpha is part of the cache key so two values that differ only in alpha
+     * don't collide, but is not used in the distance metric.
+     */
+    match(value: ColorRgba): number;
+}
+export declare enum ColorDepth {
+    DEFAULT = 0,
+    STANDARD = 1,
+    EIGHT_BIT = 2,
+    TRUECOLOR = 3,
+    WINDOWS = 4
+}
+export interface DetectColorOptions {
+    /** Environment to probe. Defaults to `process.env`. */
+    env?: NodeJS.ProcessEnv;
+    /** Whether output is going to a real terminal. Defaults to `process.stdout?.isTTY`. */
+    isTTY?: boolean;
+}
+/**
+ * Detect the terminal's color capability from env + TTY state.
+ *
+ * Probes (in priority order): NO_COLOR (per https://no-color.org —
+ * any non-empty value disables color), FORCE_COLOR (numeric/boolean override),
+ * TTY presence, TERM=dumb/unknown, COLORTERM, known terminal/TERM_PROGRAM
+ * names, and TERM regex patterns. Returns `null` for "no color".
+ *
+ * [LAW:dataflow-not-control-flow] Same probes run every call; variability is
+ * in the env values, not in which checks execute.
+ */
+export declare function detectColorSystem(options?: DetectColorOptions): ColorDepth | null;
+/**
+ * Resolve a string spec into a `ColorDepth` (or `null` for no color).
+ *
+ * `"auto"` triggers env-based detection; all other recognized specs are
+ * direct table lookups against `STRING_TO_DEPTH`. Throws on unknown specs
+ * — silent fallback would mask user typos.
+ *
+ * [LAW:single-enforcer] All string→ColorDepth resolution flows through here.
+ */
+export declare function resolveColorSystem(spec: string, options?: DetectColorOptions): ColorDepth | null;
+export declare class ColorParseError extends Error {
+    constructor(message: string);
+}
+export declare class ColorSpec {
+    readonly name: string;
+    readonly type: ColorDepth;
+    readonly number: number | undefined;
+    readonly value: ColorRgba | undefined;
+    private downgradeCache;
+    constructor(name: string, type: ColorDepth, number?: number, value?: ColorRgba);
+    get isDefault(): boolean;
+    get isSystemDefined(): boolean;
+    /**
+     * Generates SGR parameter strings for this color.
+     */
+    getAnsiCodes(foreground?: boolean): string[];
+    /**
+     * Composite this color's alpha (if any) against an opaque background,
+     * returning a fully-opaque ColorSpec. Non-truecolor specs (palette
+     * indices, default) have no alpha and pass through unchanged.
+     *
+     * [LAW:single-enforcer] Sole alpha-flattening site for the render
+     * pipeline. Run *before* downgrade — otherwise palette matching on the
+     * still-translucent RGB silently drops alpha (the "flatten then lose
+     * alpha" path the unification ticket forbids).
+     *
+     * [LAW:dataflow-not-control-flow] `ColorRgba.compositeOver` is a no-op
+     * when alpha=1, so callers invoke this unconditionally; the data
+     * (alpha value) decides whether work happens.
+     */
+    flattenAlpha(bg: ColorRgba): ColorSpec;
+    /**
+     * Downgrade to a lower-fidelity color depth. Cached.
+     */
+    downgrade(targetSystem: ColorDepth): ColorSpec;
+    /**
+     * Resolves to an actual RGB(A) value for any color type.
+     */
+    getTruecolor(theme?: TerminalTheme, foreground?: boolean): ColorRgba;
+    static default(): ColorSpec;
+    static fromAnsi(n: number): ColorSpec;
+    static fromRgba(value: ColorRgba): ColorSpec;
+    static fromRgb(r: number, g: number, b: number): ColorSpec;
+    /**
+     * Parse a color string. Cached — identical strings return the same instance.
+     */
+    static parse(colorString: string): ColorSpec;
+    private performDowngrade;
+}
+export declare function parseRgbHex(hex: string): ColorRgba;
+export declare function parseRgbaHex(hex: string): ColorRgba;
+export declare function blendRgb(color1: ColorRgba, color2: ColorRgba, crossFade?: number): ColorRgba;
+/**
+ * A terminal theme — surface/foreground baseline, the ANSI 16/256 LUT, and a
+ * semantic palette.
+ *
+ * **`ansiColors` is the canonical ANSI table, not a per-theme override.** All
+ * preset themes in this codebase use `STANDARD_TABLE` for `ansiColors`. Theme
+ * identity lives entirely in `palette` (primary, accent, text-*, surface, ...);
+ * `ColorSpec.parse("red")` is intentionally consistent across themes — same
+ * design as Textual itself, which models theming at the truecolor/semantic
+ * layer rather than overloading the ANSI 16. Custom callers building bespoke
+ * themes that *do* want to retint ANSI 16 are free to pass their own
+ * `ColorTable`; that path is supported but not how the built-in presets work.
+ */
+export declare class TerminalTheme {
+    readonly backgroundColor: ColorRgba;
+    readonly foregroundColor: ColorRgba;
+    readonly ansiColors: ColorTable;
+    readonly palette: import("../themes/palette.js").Palette;
+    constructor(backgroundColor: ColorRgba, foregroundColor: ColorRgba, ansiColors: ColorTable, palette: import("../themes/palette.js").Palette);
+}
+export declare const STANDARD_TABLE: ColorTable;
+export declare const EIGHT_BIT_TABLE: ColorTable;
+export declare const WINDOWS_TABLE: ColorTable;
+export declare const ANSI_COLOR_NAMES: Record<string, number>;
+//# sourceMappingURL=color.d.ts.map

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

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