@hypercli/ui 0.1.1

package/dist/shortcuts.js

@@ -0,0 +1,117 @@
+/**
+ * Shortcuts — Quick opinionated API
+ *
+ * Provides c (color functions), s (composite styles), msg (structured messages),
+ * md (inline markdown), symbols, and tokens as convenient shortcuts.
+ */
+import { message } from "./components/index.js";
+import { divider, getContext, indent as indentPrimitive, styledText, symbol, } from "./primitives/index.js";
+// ---------------------------------------------------------------------------
+// md — inline markdown → styled text
+// ---------------------------------------------------------------------------
+export function md(text) {
+    return text
+        .replace(/`([^`]+)`/g, (_, code) => styledText(code, { color: "code" }))
+        .replace(/\*\*([^*]+)\*\*/g, (_, bold) => styledText(bold, { bold: true }))
+        .replace(/(?<!\*)\*([^*]+)\*(?!\*)/g, (_, dim) => styledText(dim, { dim: true }));
+}
+// ---------------------------------------------------------------------------
+// c — color functions
+// ---------------------------------------------------------------------------
+export const c = {
+    // Status colors
+    success: (text) => styledText(text, { color: "success" }),
+    error: (text) => styledText(text, { color: "error" }),
+    warning: (text) => styledText(text, { color: "warning" }),
+    info: (text) => styledText(text, { color: "info" }),
+    muted: (text) => styledText(text, { dim: true }),
+    // Hex-based / semantic
+    command: (text) => styledText(text, { color: "code" }),
+    danger: (text) => styledText(text, { color: "error", bold: true }),
+    // Formatting helpers
+    highlight: (text) => styledText(text, { color: "info" }),
+    dim: (text) => styledText(text, { dim: true }),
+    bold: (text) => styledText(text, { bold: true }),
+    subtle: (text) => styledText(text, { dim: true }),
+    text: (text) => text,
+    // CLI entity colors
+    kit: (text) => styledText(text, { color: "accent" }),
+    recipe: (text) => styledText(text, { color: "code" }),
+    cookbook: (text) => styledText(text, { color: "accent", bold: true }),
+    helper: (text) => styledText(text, { color: "warning" }),
+    // Code/data colors
+    property: (text) => styledText(text, { color: "info" }),
+    required: (text) => styledText(text, { color: "error", bold: true }),
+    default: (value) => styledText(` (default: ${JSON.stringify(value)})`, { dim: true }),
+    enum: (text) => styledText(text, { color: "warning" }),
+    // Headings & labels
+    title: (text) => styledText(text, { bold: true, color: "info" }),
+    heading: (text) => styledText(text, { bold: true, color: "warning" }),
+    version: (text) => styledText(text, { dim: true }),
+};
+// ---------------------------------------------------------------------------
+// s — composite style formatters
+// ---------------------------------------------------------------------------
+export const s = {
+    hint: (text) => styledText(text, { dim: true }),
+    // Status messages with icons
+    success: (text) => `${symbol("success")} ${styledText(text, { color: "success" })}`,
+    error: (text) => `${symbol("error")} ${styledText(text, { color: "error" })}`,
+    warning: (text) => `${symbol("warning")} ${styledText(text, { color: "warning" })}`,
+    info: (text) => `${symbol("info")} ${styledText(text, { color: "info" })}`,
+    section: (text) => styledText(text, { bold: true, color: "info" }),
+    code: (text) => styledText(`\`${text}\``, { dim: true }),
+    highlight: (text) => styledText(text, { color: "info", bold: true }),
+    title: (prefix, text) => styledText(`${prefix}: ${text}`, { bold: true, color: "info" }),
+    hr: () => divider(),
+    keyValue: (key, value, indent = 0) => `${" ".repeat(indent)}${styledText(`${key}:`, { color: "info" })} ${value}`,
+    header: (text, count) => styledText(count !== undefined ? `${text} (${count})` : text, { bold: true, color: "warning" }),
+    description: (text, level = 2) => indentPrimitive(styledText(text, { dim: true }), level),
+    listItem: (text) => `  ${symbol("bullet")} ${text}`,
+    /**
+     * Renders indented paragraph lines under a list item, followed by a blank line.
+     * Use this when a list item has body content (description, sub-items, etc.).
+     * Items without body content should NOT use this — they get no trailing blank line.
+     */
+    listItemBody: (...lines) => `${lines.join("\n")}\n`,
+    indent: (text, spaces) => " ".repeat(spaces) + text,
+    path: (text) => styledText(text, { dim: true }),
+    version: (text) => styledText(text, { dim: true }),
+    md,
+};
+function makeMessageFn(level) {
+    return (input) => {
+        if (typeof input === "string") {
+            return message({ level, text: input });
+        }
+        // Bridge from UI's API shape to DS's message component
+        return message({
+            level,
+            text: input.summary,
+            title: input.title,
+            details: input.body,
+        });
+    };
+}
+export const msg = {
+    error: makeMessageFn("error"),
+    warning: makeMessageFn("warning"),
+    success: makeMessageFn("success"),
+    info: makeMessageFn("info"),
+    tip: makeMessageFn("tip"),
+};
+// ---------------------------------------------------------------------------
+// symbols & tokens — resolved values
+// ---------------------------------------------------------------------------
+/** Get resolved symbol glyphs. Lazy getter to ensure system is initialized. */
+export function getSymbols() {
+    return getContext().tokens.symbol;
+}
+/** Get resolved tokens. Lazy getter to ensure system is initialized. */
+export function getTokens() {
+    return getContext().tokens;
+}
+// For backwards compat, export as objects that proxy to the context
+// These are functions, not static objects, because the context may not be initialized yet
+export { getSymbols as symbols, getTokens as tokens };
+//# sourceMappingURL=shortcuts.js.map

package/dist/shortcuts.js.map

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

package/dist/styles.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Composite style formatters — the `s` object.
+ *
+ * These produce multi-element styled strings (icon + text, key: value, etc.).
+ * Merged from gen/lib/styles.ts + core/ui/styles.ts.
+ */
+import { md } from "./md.js";
+export declare const s: {
+    /** Dim hint text */
+    hint: (text: string) => string;
+    /** Status messages with icons */
+    success: (text: string) => string;
+    error: (text: string) => string;
+    warning: (text: string) => string;
+    info: (text: string) => string;
+    /** Bold section heading */
+    section: (text: string) => string;
+    /** Inline code (gray backticks) */
+    code: (text: string) => string;
+    /** Emphasized text */
+    highlight: (text: string) => string;
+    /** "Prefix: text" title */
+    title: (prefix: string, text: string) => string;
+    /** Horizontal rule */
+    hr: () => string;
+    /** "key: value" with optional indent */
+    keyValue: (key: string, value: string, indent?: number) => string;
+    /** Section header with optional count */
+    header: (text: string, count?: number) => string;
+    /** Dim description with optional indent */
+    description: (text: string, indent?: number) => string;
+    /** Bulleted list item */
+    listItem: (text: string) => string;
+    /** Indent text by N spaces */
+    indent: (text: string, spaces: number) => string;
+    /** Dim file path */
+    path: (text: string) => string;
+    /** Dim version string */
+    version: (text: string) => string;
+    /** Inline markdown → styled terminal text */
+    md: typeof md;
+};
+//# sourceMappingURL=styles.d.ts.map

package/dist/styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../src/styles.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAE7B,eAAO,MAAM,CAAC;IACb,oBAAoB;iBACP,MAAM;IAEnB,iCAAiC;oBACjB,MAAM;kBACR,MAAM;oBACJ,MAAM;iBACT,MAAM;IAEnB,2BAA2B;oBACX,MAAM;IAEtB,mCAAmC;iBACtB,MAAM;IAEnB,sBAAsB;sBACJ,MAAM;IAExB,2BAA2B;oBACX,MAAM,QAAQ,MAAM;IAEpC,sBAAsB;;IAGtB,wCAAwC;oBACxB,MAAM,SAAS,MAAM;IAGrC,yCAAyC;mBAC1B,MAAM,UAAU,MAAM;IAGrC,2CAA2C;wBACvB,MAAM;IAE1B,yBAAyB;qBACR,MAAM;IAEvB,8BAA8B;mBACf,MAAM,UAAU,MAAM;IAErC,oBAAoB;iBACP,MAAM;IAEnB,yBAAyB;oBACT,MAAM;IAEtB,6CAA6C;;CAE7C,CAAC"}

package/dist/styles.js

@@ -0,0 +1,44 @@
+/**
+ * Composite style formatters — the `s` object.
+ *
+ * These produce multi-element styled strings (icon + text, key: value, etc.).
+ * Merged from gen/lib/styles.ts + core/ui/styles.ts.
+ */
+import chalk from "chalk";
+import { md } from "./md.js";
+export const s = {
+    /** Dim hint text */
+    hint: (text) => chalk.gray(text),
+    /** Status messages with icons */
+    success: (text) => chalk.green(`\u2714 ${text}`),
+    error: (text) => chalk.red(`\u2718 ${text}`),
+    warning: (text) => chalk.yellow(`\u26a0 ${text}`),
+    info: (text) => chalk.blue(`\u2139 ${text}`),
+    /** Bold section heading */
+    section: (text) => chalk.bold.cyan(text),
+    /** Inline code (gray backticks) */
+    code: (text) => chalk.gray(`\`${text}\``),
+    /** Emphasized text */
+    highlight: (text) => chalk.cyan.bold(text),
+    /** "Prefix: text" title */
+    title: (prefix, text) => chalk.bold.cyan(`${prefix}: ${text}`),
+    /** Horizontal rule */
+    hr: () => chalk.gray("\u2500".repeat(60)),
+    /** "key: value" with optional indent */
+    keyValue: (key, value, indent = 0) => `${" ".repeat(indent)}${chalk.cyan(`${key}:`)} ${value}`,
+    /** Section header with optional count */
+    header: (text, count) => chalk.bold.yellow(count !== undefined ? `${text} (${count})` : text),
+    /** Dim description with optional indent */
+    description: (text, indent = 0) => " ".repeat(indent) + chalk.gray(text),
+    /** Bulleted list item */
+    listItem: (text) => chalk.white(`  \u2022 ${text}`),
+    /** Indent text by N spaces */
+    indent: (text, spaces) => " ".repeat(spaces) + text,
+    /** Dim file path */
+    path: (text) => chalk.gray(text),
+    /** Dim version string */
+    version: (text) => chalk.gray(text),
+    /** Inline markdown → styled terminal text */
+    md,
+};
+//# sourceMappingURL=styles.js.map

package/dist/styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.js","sourceRoot":"","sources":["../src/styles.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAE7B,MAAM,CAAC,MAAM,CAAC,GAAG;IAChB,oBAAoB;IACpB,IAAI,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;IAExC,iCAAiC;IACjC,OAAO,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC;IACxD,KAAK,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC;IACpD,OAAO,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC;IACzD,IAAI,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC;IAEpD,2BAA2B;IAC3B,OAAO,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IAEhD,mCAAmC;IACnC,IAAI,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC;IAEjD,sBAAsB;IACtB,SAAS,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IAElD,2BAA2B;IAC3B,KAAK,EAAE,CAAC,MAAc,EAAE,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,KAAK,IAAI,EAAE,CAAC;IAE9E,sBAAsB;IACtB,EAAE,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAEzC,wCAAwC;IACxC,QAAQ,EAAE,CAAC,GAAW,EAAE,KAAa,EAAE,MAAM,GAAG,CAAC,EAAE,EAAE,CACpD,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC,IAAI,KAAK,EAAE;IAEzD,yCAAyC;IACzC,MAAM,EAAE,CAAC,IAAY,EAAE,KAAc,EAAE,EAAE,CACxC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IAErE,2CAA2C;IAC3C,WAAW,EAAE,CAAC,IAAY,EAAE,MAAM,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;IAEhF,yBAAyB;IACzB,QAAQ,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC;IAE3D,8BAA8B;IAC9B,MAAM,EAAE,CAAC,IAAY,EAAE,MAAc,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI;IAEnE,oBAAoB;IACpB,IAAI,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;IAExC,yBAAyB;IACzB,OAAO,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;IAE3C,6CAA6C;IAC7C,EAAE;CACF,CAAC"}

package/dist/symbols.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Unicode glyphs for CLI output.
+ *
+ * Consolidated from core/ui/symbols.ts and gen's inline usage.
+ */
+export declare const symbols: {
+    readonly error: "×";
+    readonly warning: "▲";
+    readonly success: "✔";
+    readonly info: "●";
+    readonly tip: "◆";
+    readonly bar: "│";
+    readonly bullet: "•";
+    readonly dash: "─";
+    readonly arrow: "▸";
+    readonly arrowFilled: "▶︎";
+    readonly arrowThin: "▹";
+};
+//# sourceMappingURL=symbols.d.ts.map

package/dist/symbols.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbols.d.ts","sourceRoot":"","sources":["../src/symbols.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,OAAO;;;;;;;;;;;;CAeV,CAAC"}

package/dist/symbols.js

@@ -0,0 +1,21 @@
+/**
+ * Unicode glyphs for CLI output.
+ *
+ * Consolidated from core/ui/symbols.ts and gen's inline usage.
+ */
+export const symbols = {
+    // Status indicators
+    error: "\u00d7", // ×
+    warning: "\u25b2", // ▲
+    success: "\u2714", // ✔
+    info: "\u25cf", // ●
+    tip: "\u25c6", // ◆
+    // Structural
+    bar: "\u2502", // │
+    bullet: "\u2022", // •
+    dash: "\u2500", // ─
+    arrow: "\u25b8", // ▸
+    arrowFilled: "\u25b6\ufe0e", // ▶︎
+    arrowThin: "\u25b9", // ▹
+};
+//# sourceMappingURL=symbols.js.map

package/dist/symbols.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbols.js","sourceRoot":"","sources":["../src/symbols.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG;IACtB,oBAAoB;IACpB,KAAK,EAAE,QAAQ,EAAE,IAAI;IACrB,OAAO,EAAE,QAAQ,EAAE,IAAI;IACvB,OAAO,EAAE,QAAQ,EAAE,IAAI;IACvB,IAAI,EAAE,QAAQ,EAAE,IAAI;IACpB,GAAG,EAAE,QAAQ,EAAE,IAAI;IAEnB,aAAa;IACb,GAAG,EAAE,QAAQ,EAAE,IAAI;IACnB,MAAM,EAAE,QAAQ,EAAE,IAAI;IACtB,IAAI,EAAE,QAAQ,EAAE,IAAI;IACpB,KAAK,EAAE,QAAQ,EAAE,IAAI;IACrB,WAAW,EAAE,cAAc,EAAE,KAAK;IAClC,SAAS,EAAE,QAAQ,EAAE,IAAI;CAChB,CAAC"}

package/dist/test/compare.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Output Comparison Utilities
+ *
+ * Compare rendered outputs ignoring ANSI codes, reporting visual differences.
+ */
+/** Result of comparing two rendered outputs. */
+export type ComparisonResult = {
+    /** Whether the outputs are visually identical (ignoring ANSI codes). */
+    equal: boolean;
+    /** Line-by-line differences found between the outputs. */
+    differences: Array<{
+        /** 1-indexed line number where the difference occurs. */
+        line: number;
+        /** Expected line content (ANSI stripped). */
+        expected: string;
+        /** Actual line content (ANSI stripped). */
+        actual: string;
+    }>;
+};
+/**
+ * Compares two styled outputs by stripping ANSI codes and diffing line-by-line.
+ *
+ * @param actual - The actual rendered output.
+ * @param expected - The expected rendered output.
+ * @returns A {@link ComparisonResult} with equality flag and detailed differences.
+ */
+export declare function compareOutput(actual: string, expected: string): ComparisonResult;
+//# sourceMappingURL=compare.d.ts.map

package/dist/test/compare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare.d.ts","sourceRoot":"","sources":["../../src/test/compare.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,gDAAgD;AAChD,MAAM,MAAM,gBAAgB,GAAG;IAC9B,wEAAwE;IACxE,KAAK,EAAE,OAAO,CAAC;IACf,0DAA0D;IAC1D,WAAW,EAAE,KAAK,CAAC;QAClB,yDAAyD;QACzD,IAAI,EAAE,MAAM,CAAC;QACb,6CAA6C;QAC7C,QAAQ,EAAE,MAAM,CAAC;QACjB,2CAA2C;QAC3C,MAAM,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;CACH,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CA2BhF"}

package/dist/test/compare.js

@@ -0,0 +1,37 @@
+/**
+ * Output Comparison Utilities
+ *
+ * Compare rendered outputs ignoring ANSI codes, reporting visual differences.
+ */
+import { stripAnsi } from "../render/index.js";
+/**
+ * Compares two styled outputs by stripping ANSI codes and diffing line-by-line.
+ *
+ * @param actual - The actual rendered output.
+ * @param expected - The expected rendered output.
+ * @returns A {@link ComparisonResult} with equality flag and detailed differences.
+ */
+export function compareOutput(actual, expected) {
+    const actualPlain = stripAnsi(actual);
+    const expectedPlain = stripAnsi(expected);
+    const actualLines = actualPlain.split("\n");
+    const expectedLines = expectedPlain.split("\n");
+    const maxLines = Math.max(actualLines.length, expectedLines.length);
+    const differences = [];
+    for (let i = 0; i < maxLines; i++) {
+        const actualLine = actualLines[i] ?? "";
+        const expectedLine = expectedLines[i] ?? "";
+        if (actualLine !== expectedLine) {
+            differences.push({
+                line: i + 1,
+                expected: expectedLine,
+                actual: actualLine,
+            });
+        }
+    }
+    return {
+        equal: differences.length === 0,
+        differences,
+    };
+}
+//# sourceMappingURL=compare.js.map

package/dist/test/compare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare.js","sourceRoot":"","sources":["../../src/test/compare.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAiB/C;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,QAAgB;IAC7D,MAAM,WAAW,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IACtC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IAE1C,MAAM,WAAW,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,aAAa,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAEhD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACpE,MAAM,WAAW,GAAoC,EAAE,CAAC;IAExD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACxC,MAAM,YAAY,GAAG,aAAa,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAE5C,IAAI,UAAU,KAAK,YAAY,EAAE,CAAC;YACjC,WAAW,CAAC,IAAI,CAAC;gBAChB,IAAI,EAAE,CAAC,GAAG,CAAC;gBACX,QAAQ,EAAE,YAAY;gBACtB,MAAM,EAAE,UAAU;aAClB,CAAC,CAAC;QACJ,CAAC;IACF,CAAC;IAED,OAAO;QACN,KAAK,EAAE,WAAW,CAAC,MAAM,KAAK,CAAC;QAC/B,WAAW;KACX,CAAC;AACH,CAAC"}

package/dist/test/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Test Utilities — Barrel Export
+ *
+ * Testing helpers for consumers of the CLI Design System.
+ * Exported as `cli-ds/test`.
+ */
+export { render } from "./render.ts";
+export type { RenderedOutput } from "./render.ts";
+export { mockCapabilities, mockTheme, setupTestContext } from "./mock.ts";
+export type { CapabilityPreset } from "./mock.ts";
+export { snapshot } from "./snapshot.ts";
+export { compareOutput } from "./compare.ts";
+export type { ComparisonResult } from "./compare.ts";
+export { stripAnsi } from "../render/index.ts";
+export { stringWidth } from "../render/index.ts";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/test/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC1E,YAAY,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAElD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGrD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/test/index.js

@@ -0,0 +1,14 @@
+/**
+ * Test Utilities — Barrel Export
+ *
+ * Testing helpers for consumers of the CLI Design System.
+ * Exported as `cli-ds/test`.
+ */
+export { render } from "./render.js";
+export { mockCapabilities, mockTheme, setupTestContext } from "./mock.js";
+export { snapshot } from "./snapshot.js";
+export { compareOutput } from "./compare.js";
+// Re-export commonly used utilities
+export { stripAnsi } from "../render/index.js";
+export { stringWidth } from "../render/index.js";
+//# sourceMappingURL=index.js.map

package/dist/test/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/test/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAG1E,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG7C,oCAAoC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/test/mock.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Test Mocking Utilities
+ *
+ * Helpers for creating mock capabilities, themes, and test contexts.
+ */
+import type { TerminalCapabilities } from "../capabilities/index.ts";
+import type { Theme, ThemeInput } from "../theme/index.ts";
+/**
+ * Predefined terminal capability presets for testing.
+ * - `'full'` — truecolor, unicode, TTY, 120 columns
+ * - `'ansi256'` — 256-color, unicode, TTY
+ * - `'ansi16'` — 16-color, unicode, TTY
+ * - `'nocolor'` — color disabled (NO_COLOR), unicode, TTY
+ * - `'dumb'` — no color, no unicode, TERM=dumb
+ * - `'ascii'` — 16-color, no unicode, TTY
+ * - `'ci'` — 16-color, unicode, non-TTY CI environment
+ */
+export type CapabilityPreset = "full" | "ansi256" | "ansi16" | "nocolor" | "dumb" | "ascii" | "ci";
+/**
+ * Creates a mock {@link TerminalCapabilities} object for testing at a specific tier.
+ *
+ * @param preset - A named capability preset, or omit for bare defaults.
+ * @param overrides - Additional overrides merged on top of the preset.
+ * @returns A frozen capabilities object.
+ */
+export declare function mockCapabilities(preset?: CapabilityPreset, overrides?: Partial<TerminalCapabilities>): TerminalCapabilities;
+/**
+ * Creates a mock theme for testing with sensible defaults.
+ *
+ * @param overrides - Partial theme properties to set.
+ * @returns A theme object with a default name of `'test-theme'`.
+ */
+export declare function mockTheme(overrides: Partial<Theme>): Theme;
+/**
+ * Sets up a global test context with the given capabilities and theme.
+ * Returns a cleanup function that resets the context to defaults.
+ *
+ * @param preset - Capability preset to use.
+ * @param themeInput - Optional theme configuration.
+ * @returns A cleanup function that restores the default context.
+ *
+ * @example
+ * ```ts
+ * const cleanup = setupTestContext('full')
+ * // ... run tests ...
+ * cleanup()
+ * ```
+ */
+export declare function setupTestContext(preset?: CapabilityPreset, themeInput?: ThemeInput): () => void;
+//# sourceMappingURL=mock.d.ts.map

package/dist/test/mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../src/test/mock.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAc,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAIjF,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE3D;;;;;;;;;GASG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAkFnG;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC/B,MAAM,CAAC,EAAE,gBAAgB,EACzB,SAAS,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GACvC,oBAAoB,CAGtB;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,KAAK,CAK1D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,gBAAgB,EAAE,UAAU,CAAC,EAAE,UAAU,GAAG,MAAM,IAAI,CAU/F"}

package/dist/test/mock.js

@@ -0,0 +1,135 @@
+/**
+ * Test Mocking Utilities
+ *
+ * Helpers for creating mock capabilities, themes, and test contexts.
+ */
+import { createCapabilities } from "../capabilities/index.js";
+import { createContext, setContext } from "../primitives/index.js";
+const PRESETS = {
+    full: {
+        colorDepth: "truecolor",
+        unicode: true,
+        isTTY: true,
+        isStderrTTY: true,
+        isCI: false,
+        isDumb: false,
+        noColor: false,
+        forceColor: false,
+        columns: 120,
+    },
+    ansi256: {
+        colorDepth: "256",
+        unicode: true,
+        isTTY: true,
+        isStderrTTY: true,
+        isCI: false,
+        isDumb: false,
+        noColor: false,
+        forceColor: false,
+        columns: 80,
+    },
+    ansi16: {
+        colorDepth: "16",
+        unicode: true,
+        isTTY: true,
+        isStderrTTY: true,
+        isCI: false,
+        isDumb: false,
+        noColor: false,
+        forceColor: false,
+        columns: 80,
+    },
+    nocolor: {
+        colorDepth: "none",
+        unicode: true,
+        isTTY: true,
+        isStderrTTY: true,
+        isCI: false,
+        isDumb: false,
+        noColor: true,
+        forceColor: false,
+        columns: 80,
+    },
+    dumb: {
+        colorDepth: "none",
+        unicode: false,
+        isTTY: true,
+        isStderrTTY: true,
+        isCI: false,
+        isDumb: true,
+        noColor: false,
+        forceColor: false,
+        columns: 80,
+    },
+    ascii: {
+        colorDepth: "16",
+        unicode: false,
+        isTTY: true,
+        isStderrTTY: true,
+        isCI: false,
+        isDumb: false,
+        noColor: false,
+        forceColor: false,
+        columns: 80,
+    },
+    ci: {
+        colorDepth: "16",
+        unicode: true,
+        isTTY: false,
+        isStderrTTY: false,
+        isCI: true,
+        isDumb: false,
+        noColor: false,
+        forceColor: false,
+        columns: 80,
+    },
+};
+/**
+ * Creates a mock {@link TerminalCapabilities} object for testing at a specific tier.
+ *
+ * @param preset - A named capability preset, or omit for bare defaults.
+ * @param overrides - Additional overrides merged on top of the preset.
+ * @returns A frozen capabilities object.
+ */
+export function mockCapabilities(preset, overrides) {
+    const base = preset ? PRESETS[preset] : {};
+    return createCapabilities({ ...base, ...overrides });
+}
+/**
+ * Creates a mock theme for testing with sensible defaults.
+ *
+ * @param overrides - Partial theme properties to set.
+ * @returns A theme object with a default name of `'test-theme'`.
+ */
+export function mockTheme(overrides) {
+    return {
+        name: overrides.name ?? "test-theme",
+        ...overrides,
+    };
+}
+/**
+ * Sets up a global test context with the given capabilities and theme.
+ * Returns a cleanup function that resets the context to defaults.
+ *
+ * @param preset - Capability preset to use.
+ * @param themeInput - Optional theme configuration.
+ * @returns A cleanup function that restores the default context.
+ *
+ * @example
+ * ```ts
+ * const cleanup = setupTestContext('full')
+ * // ... run tests ...
+ * cleanup()
+ * ```
+ */
+export function setupTestContext(preset, themeInput) {
+    const caps = mockCapabilities(preset);
+    const ctx = createContext(caps, themeInput);
+    setContext(ctx);
+    return () => {
+        // Reset to a default context
+        const defaultCtx = createContext();
+        setContext(defaultCtx);
+    };
+}
+//# sourceMappingURL=mock.js.map

package/dist/test/mock.js.map

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

package/dist/test/render.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Test Rendering Utilities
+ *
+ * Captures rendered output and provides assertions for ANSI-styled strings.
+ */
+export type RenderedOutput = {
+    /** The raw string with ANSI codes */
+    readonly styled: string;
+    /** Plain text with all ANSI codes stripped */
+    readonly plain: string;
+    /** Whether any color codes are present (not just typography) */
+    readonly hasColor: boolean;
+    /** Whether a specific SGR attribute is present */
+    hasStyle(attr: "bold" | "dim" | "italic" | "underline" | "strikethrough" | "inverse"): boolean;
+    /** Visual width of the first line */
+    readonly width: number;
+    /** Array of visual lines (split by \n, stripped of ANSI) */
+    readonly lines: string[];
+    /** Number of visual lines */
+    readonly lineCount: number;
+};
+/**
+ * Wraps a rendered string in a {@link RenderedOutput} object for inspection and assertions.
+ *
+ * @param output - The raw styled string to analyze.
+ * @returns A {@link RenderedOutput} object with plain text, color detection, and style queries.
+ */
+export declare function render(output: string): RenderedOutput;
+//# sourceMappingURL=render.d.ts.map

package/dist/test/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/test/render.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,MAAM,cAAc,GAAG;IAC5B,qCAAqC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,kDAAkD;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,WAAW,GAAG,eAAe,GAAG,SAAS,GAAG,OAAO,CAAC;IAC/F,qCAAqC;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IACzB,6BAA6B;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC3B,CAAC;AAwDF;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAqBrD"}