@flyingrobots/bijou 0.10.0 → 1.1.0

package/dist/adapters/test/assertions.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Test assertion helpers for ANSI escape and output validation.
+ *
+ * These helpers import `vitest` and are intended for test files only —
+ * they are NOT exported from the main bijou barrel.
+ *
+ * @module adapters/test/assertions
+ */
+import type { TestContext } from './index.js';
+/**
+ * Assert that the output contains no ANSI escapes at all (no CSI, no OSC).
+ *
+ * @param output - The string to check.
+ */
+export declare function expectNoAnsi(output: string): void;
+/**
+ * Assert that the output contains no SGR color/style sequences.
+ *
+ * Allows cursor-control escapes like `\x1b[?25l` (hide cursor),
+ * `\x1b[K` (clear line), and `\x1b[3A` (move up). Only rejects
+ * sequences of the form `\x1b[<digits>m`.
+ *
+ * @param output - The string to check.
+ */
+export declare function expectNoAnsiSgr(output: string): void;
+/**
+ * Assert that the output contains at least one ANSI escape sequence.
+ *
+ * @param output - The string to check.
+ */
+export declare function expectContainsAnsi(output: string): void;
+/**
+ * Assert that the output contains the hide-cursor sequence (`\x1b[?25l`).
+ *
+ * @param output - The string to check.
+ */
+export declare function expectHiddenCursor(output: string): void;
+/**
+ * Assert that the output contains the show-cursor sequence (`\x1b[?25h`).
+ *
+ * @param output - The string to check.
+ */
+export declare function expectShownCursor(output: string): void;
+/**
+ * Assert that the combined written output of a test context contains a substring.
+ *
+ * @param ctx - A test context with a mock IO adapter.
+ * @param substring - The substring to search for in the joined output.
+ */
+export declare function expectWritten(ctx: TestContext, substring: string): void;
+//# sourceMappingURL=assertions.d.ts.map

package/dist/adapters/test/assertions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertions.d.ts","sourceRoot":"","sources":["../../../src/adapters/test/assertions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAQ9C;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAEjD;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAEvD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAEvD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAEtD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAEvE"}

package/dist/adapters/test/assertions.js

@@ -0,0 +1,67 @@
+/**
+ * Test assertion helpers for ANSI escape and output validation.
+ *
+ * These helpers import `vitest` and are intended for test files only —
+ * they are NOT exported from the main bijou barrel.
+ *
+ * @module adapters/test/assertions
+ */
+import { expect } from 'vitest';
+/** Matches any ANSI escape: CSI (`\x1b[`) or OSC (`\x1b]`). */
+const ANSI_RE = new RegExp('\\x1b[\\[\\]]');
+/** Matches SGR color/style sequences (`\x1b[<digits>m`) but not cursor control. */
+const SGR_RE = new RegExp('\\x1b\\[\\d+(?:;\\d+)*m');
+/**
+ * Assert that the output contains no ANSI escapes at all (no CSI, no OSC).
+ *
+ * @param output - The string to check.
+ */
+export function expectNoAnsi(output) {
+    expect(output).not.toMatch(ANSI_RE);
+}
+/**
+ * Assert that the output contains no SGR color/style sequences.
+ *
+ * Allows cursor-control escapes like `\x1b[?25l` (hide cursor),
+ * `\x1b[K` (clear line), and `\x1b[3A` (move up). Only rejects
+ * sequences of the form `\x1b[<digits>m`.
+ *
+ * @param output - The string to check.
+ */
+export function expectNoAnsiSgr(output) {
+    expect(output).not.toMatch(SGR_RE);
+}
+/**
+ * Assert that the output contains at least one ANSI escape sequence.
+ *
+ * @param output - The string to check.
+ */
+export function expectContainsAnsi(output) {
+    expect(output).toMatch(ANSI_RE);
+}
+/**
+ * Assert that the output contains the hide-cursor sequence (`\x1b[?25l`).
+ *
+ * @param output - The string to check.
+ */
+export function expectHiddenCursor(output) {
+    expect(output).toContain('\x1b[?25l');
+}
+/**
+ * Assert that the output contains the show-cursor sequence (`\x1b[?25h`).
+ *
+ * @param output - The string to check.
+ */
+export function expectShownCursor(output) {
+    expect(output).toContain('\x1b[?25h');
+}
+/**
+ * Assert that the combined written output of a test context contains a substring.
+ *
+ * @param ctx - A test context with a mock IO adapter.
+ * @param substring - The substring to search for in the joined output.
+ */
+export function expectWritten(ctx, substring) {
+    expect(ctx.io.written.join('')).toContain(substring);
+}
+//# sourceMappingURL=assertions.js.map

package/dist/adapters/test/assertions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertions.js","sourceRoot":"","sources":["../../../src/adapters/test/assertions.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,+DAA+D;AAC/D,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,eAAe,CAAC,CAAC;AAE5C,mFAAmF;AACnF,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,yBAAyB,CAAC,CAAC;AAErD;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AACtC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;AACrC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AAClC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;AACxC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;AACxC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,GAAgB,EAAE,SAAiB;IAC/D,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;AACvD,CAAC"}

package/dist/adapters/test/audit-style.d.ts

@@ -1,25 +1,46 @@
 import type { StylePort } from '../../ports/style.js';
 import type { TokenValue, RGB } from '../../core/theme/tokens.js';
+/**
+ * Record of a single styling invocation captured by {@link AuditStylePort}.
+ */
 export interface StyledCall {
-    method: 'styled' | 'rgb' | 'hex' | 'bold';
+    /** Which styling method was called. */
+    method: 'styled' | 'rgb' | 'hex' | 'bgRgb' | 'bgHex' | 'bold';
+    /** The text that was styled. */
     text: string;
+    /** The design-token value passed to `styled()`, if applicable. */
     token?: TokenValue;
+    /** The color argument passed to `rgb()` or `hex()`, if applicable. */
     color?: string | RGB;
 }
+/**
+ * Extended {@link StylePort} that records every call for test assertions.
+ *
+ * All styling methods return text unchanged (identity pass-through) so that
+ * string equality assertions work without stripping escape codes. Use the
+ * `calls` array or `wasStyled` helper to verify styling behavior.
+ */
 export interface AuditStylePort extends StylePort {
     /** All recorded style calls in order. */
     readonly calls: readonly StyledCall[];
-    /** Was the given token applied to text containing substring? */
+    /**
+     * Check whether a `styled()` call matched a given token and text substring.
+     * @param token - The design-token value to match against (compared by hex and modifiers).
+     * @param substring - A substring that must appear in the styled text.
+     * @returns `true` if a matching `styled()` call was recorded.
+     */
     wasStyled(token: TokenValue, substring: string): boolean;
-    /** Reset recorded calls. */
+    /** Clear all recorded calls. */
     reset(): void;
 }
 /**
- * Create a StylePort that records all styling calls for test assertions.
+ * Create a {@link StylePort} that records all styling calls for test assertions.
+ *
+ * Return text unchanged (like {@link plainStyle}) so existing string assertions
+ * still work. Record every call for post-hoc assertion via the `calls` array
+ * and the `wasStyled()` convenience method.
  *
- * Returns text unchanged (like `plainStyle`) so existing string assertions
- * still work. Records every call for post-hoc assertion via `calls` array
- * and `wasStyled()` convenience method.
+ * @returns An {@link AuditStylePort} with an empty call log.
  */
 export declare function auditStyle(): AuditStylePort;
 //# sourceMappingURL=audit-style.d.ts.map

package/dist/adapters/test/audit-style.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"audit-style.d.ts","sourceRoot":"","sources":["../../../src/adapters/test/audit-style.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,4BAA4B,CAAC;AAElE,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,QAAQ,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;CACtB;AAED,MAAM,WAAW,cAAe,SAAQ,SAAS;IAC/C,yCAAyC;IACzC,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;IACtC,gEAAgE;IAChE,SAAS,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IACzD,4BAA4B;IAC5B,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,IAAI,cAAc,CA0C3C"}
+{"version":3,"file":"audit-style.d.ts","sourceRoot":"","sources":["../../../src/adapters/test/audit-style.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,4BAA4B,CAAC;AAElE;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,uCAAuC;IACvC,MAAM,EAAE,QAAQ,GAAG,KAAK,GAAG,KAAK,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;IAC9D,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,sEAAsE;IACtE,KAAK,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;CACtB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,cAAe,SAAQ,SAAS;IAC/C,yCAAyC;IACzC,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;IAEtC;;;;;OAKG;IACH,SAAS,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IAEzD,gCAAgC;IAChC,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,IAAI,cAAc,CAmG3C"}

package/dist/adapters/test/audit-style.js

@@ -1,38 +1,95 @@
 /**
- * Create a StylePort that records all styling calls for test assertions.
+ * Create a {@link StylePort} that records all styling calls for test assertions.
  *
- * Returns text unchanged (like `plainStyle`) so existing string assertions
- * still work. Records every call for post-hoc assertion via `calls` array
- * and `wasStyled()` convenience method.
+ * Return text unchanged (like {@link plainStyle}) so existing string assertions
+ * still work. Record every call for post-hoc assertion via the `calls` array
+ * and the `wasStyled()` convenience method.
+ *
+ * @returns An {@link AuditStylePort} with an empty call log.
  */
 export function auditStyle() {
+    /** @internal Mutable backing array for recorded calls. */
     const _calls = [];
     return {
         get calls() {
             return _calls.slice();
         },
+        /**
+         * Record a `styled()` call and return the text unchanged.
+         * @param token - The design-token value.
+         * @param text - The text to style.
+         * @returns The original text, unmodified.
+         */
         styled(token, text) {
             _calls.push({ method: 'styled', text, token });
             return text;
         },
+        /**
+         * Record an `rgb()` call and return the text unchanged.
+         * @param r - Red channel (0-255).
+         * @param g - Green channel (0-255).
+         * @param b - Blue channel (0-255).
+         * @param text - The text to style.
+         * @returns The original text, unmodified.
+         */
         rgb(r, g, b, text) {
             _calls.push({ method: 'rgb', text, color: [r, g, b] });
             return text;
         },
+        /**
+         * Record a `hex()` call and return the text unchanged.
+         * @param color - Hex color string (e.g. `"#ff00aa"`).
+         * @param text - The text to style.
+         * @returns The original text, unmodified.
+         */
         hex(color, text) {
             _calls.push({ method: 'hex', text, color });
             return text;
         },
+        /**
+         * Record a `bgRgb()` call and return the text unchanged.
+         * @param r - Red channel (0-255).
+         * @param g - Green channel (0-255).
+         * @param b - Blue channel (0-255).
+         * @param text - The text to style.
+         * @returns The original text, unmodified.
+         */
+        bgRgb(r, g, b, text) {
+            _calls.push({ method: 'bgRgb', text, color: [r, g, b] });
+            return text;
+        },
+        /**
+         * Record a `bgHex()` call and return the text unchanged.
+         * @param color - Hex color string (e.g. `"#ff00aa"`).
+         * @param text - The text to style.
+         * @returns The original text, unmodified.
+         */
+        bgHex(color, text) {
+            _calls.push({ method: 'bgHex', text, color });
+            return text;
+        },
+        /**
+         * Record a `bold()` call and return the text unchanged.
+         * @param text - The text to style.
+         * @returns The original text, unmodified.
+         */
         bold(text) {
             _calls.push({ method: 'bold', text });
             return text;
         },
+        /**
+         * Check whether a `styled()` call matched a given token and text substring.
+         * @param token - The design-token value to match (compared by hex and modifiers).
+         * @param substring - A substring that must appear in the styled text.
+         * @returns `true` if a matching `styled()` call was recorded.
+         */
         wasStyled(token, substring) {
             return _calls.some((c) => c.method === 'styled'
                 && c.token?.hex === token.hex
                 && JSON.stringify([...(c.token?.modifiers ?? [])].sort()) === JSON.stringify([...(token.modifiers ?? [])].sort())
                 && c.text.includes(substring));
         },
+        /** Clear all recorded calls. */
         reset() {
             _calls.length = 0;
         },

package/dist/adapters/test/audit-style.js.map

@@ -1 +1 @@
-{"version":3,"file":"audit-style.js","sourceRoot":"","sources":["../../../src/adapters/test/audit-style.ts"],"names":[],"mappings":"AAmBA;;;;;;GAMG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,MAAM,GAAiB,EAAE,CAAC;IAEhC,OAAO;QACL,IAAI,KAAK;YACP,OAAO,MAAM,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC;QAED,MAAM,CAAC,KAAiB,EAAE,IAAY;YACpC,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YAC/C,OAAO,IAAI,CAAC;QACd,CAAC;QAED,GAAG,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS,EAAE,IAAY;YAC/C,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YACvD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,GAAG,CAAC,KAAa,EAAE,IAAY;YAC7B,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YAC5C,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,CAAC,IAAY;YACf,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YACtC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,SAAS,CAAC,KAAiB,EAAE,SAAiB;YAC5C,OAAO,MAAM,CAAC,IAAI,CAChB,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,MAAM,KAAK,QAAQ;mBAClB,CAAC,CAAC,KAAK,EAAE,GAAG,KAAK,KAAK,CAAC,GAAG;mBAC1B,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;mBAC9G,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAChC,CAAC;QACJ,CAAC;QAED,KAAK;YACH,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;QACpB,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"audit-style.js","sourceRoot":"","sources":["../../../src/adapters/test/audit-style.ts"],"names":[],"mappings":"AAwCA;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU;IACxB,0DAA0D;IAC1D,MAAM,MAAM,GAAiB,EAAE,CAAC;IAEhC,OAAO;QACL,IAAI,KAAK;YACP,OAAO,MAAM,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC;QAED;;;;;WAKG;QACH,MAAM,CAAC,KAAiB,EAAE,IAAY;YACpC,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YAC/C,OAAO,IAAI,CAAC;QACd,CAAC;QAED;;;;;;;WAOG;QACH,GAAG,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS,EAAE,IAAY;YAC/C,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YACvD,OAAO,IAAI,CAAC;QACd,CAAC;QAED;;;;;WAKG;QACH,GAAG,CAAC,KAAa,EAAE,IAAY;YAC7B,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YAC5C,OAAO,IAAI,CAAC;QACd,CAAC;QAED;;;;;;;WAOG;QACH,KAAK,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS,EAAE,IAAY;YACjD,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YACzD,OAAO,IAAI,CAAC;QACd,CAAC;QAED;;;;;WAKG;QACH,KAAK,CAAC,KAAa,EAAE,IAAY;YAC/B,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YAC9C,OAAO,IAAI,CAAC;QACd,CAAC;QAED;;;;WAIG;QACH,IAAI,CAAC,IAAY;YACf,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YACtC,OAAO,IAAI,CAAC;QACd,CAAC;QAED;;;;;WAKG;QACH,SAAS,CAAC,KAAiB,EAAE,SAAiB;YAC5C,OAAO,MAAM,CAAC,IAAI,CAChB,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,MAAM,KAAK,QAAQ;mBAClB,CAAC,CAAC,KAAK,EAAE,GAAG,KAAK,KAAK,CAAC,GAAG;mBAC1B,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;mBAC9G,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAChC,CAAC;QACJ,CAAC;QAED,gCAAgC;QAChC,KAAK;YACH,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;QACpB,CAAC;KACF,CAAC;AACJ,CAAC"}

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

@@ -1,5 +1,14 @@
+/**
+ * Test adapters for bijou's hexagonal ports.
+ *
+ * Re-exports mock/stub implementations of {@link RuntimePort}, {@link IOPort},
+ * and {@link StylePort} along with the {@link createTestContext} convenience
+ * factory that assembles them into a complete {@link BijouContext}.
+ *
+ * @module
+ */
 import type { BijouContext } from '../../ports/context.js';
-import type { OutputMode } from '../../core/detect/tty.js';
+import type { OutputMode, ColorScheme } from '../../core/detect/tty.js';
 import { type MockRuntimeOptions } from './runtime.js';
 import { type MockIOOptions, type MockIO } from './io.js';
 import type { Theme } from '../../core/theme/tokens.js';
@@ -7,15 +16,41 @@ export { mockRuntime, type MockRuntimeOptions } from './runtime.js';
 export { mockIO, type MockIOOptions, type MockIO } from './io.js';
 export { plainStyle } from './style.js';
 export { auditStyle, type StyledCall, type AuditStylePort } from './audit-style.js';
+export { expectNoAnsi, expectNoAnsiSgr, expectContainsAnsi, expectHiddenCursor, expectShownCursor, expectWritten, } from './assertions.js';
+/**
+ * Configuration for {@link createTestContext}.
+ */
 export interface TestContextOptions {
+    /** Overrides for the mock runtime (env vars, terminal dimensions). */
     runtime?: MockRuntimeOptions;
+    /** Overrides for mock I/O (pre-loaded answers, keys, virtual files). */
     io?: MockIOOptions;
+    /** Theme to resolve. Defaults to `CYAN_MAGENTA`. */
     theme?: Theme;
+    /** Output mode. Defaults to `'interactive'`. */
     mode?: OutputMode;
+    /** Whether to strip color from the resolved theme. Defaults to `false`. */
     noColor?: boolean;
+    /** Terminal color scheme for the resolved theme. Defaults to `'dark'`. */
+    colorScheme?: ColorScheme;
 }
+/**
+ * A {@link BijouContext} whose `io` property is narrowed to {@link MockIO},
+ * exposing test-inspection helpers such as `written` and `answerQueue`.
+ */
 export interface TestContext extends BijouContext {
+    /** Mock I/O adapter with inspectable internal buffers. */
     readonly io: MockIO;
 }
+/**
+ * Create a fully-wired {@link BijouContext} for unit and integration tests.
+ *
+ * Assemble a {@link mockRuntime}, {@link mockIO}, and {@link plainStyle}
+ * together with a resolved theme so tests can exercise bijou components
+ * without touching real terminals or filesystems.
+ *
+ * @param options - Optional overrides for runtime, I/O, theme, mode, and color.
+ * @returns A {@link TestContext} ready for use in tests.
+ */
 export declare function createTestContext(options?: TestContextOptions): TestContext;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/test/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAe,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAU,KAAK,aAAa,EAAE,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;AAIlE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AAExD,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEpF,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,EAAE,CAAC,EAAE,aAAa,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,WAAY,SAAQ,YAAY;IAC/C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,kBAAuB,GAAG,WAAW,CAQ/E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/test/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAe,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAU,KAAK,aAAa,EAAE,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;AAIlE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AAExD,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACpF,OAAO,EACL,YAAY,EACZ,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,GACd,MAAM,iBAAiB,CAAC;AAEzB;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,sEAAsE;IACtE,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,wEAAwE;IACxE,EAAE,CAAC,EAAE,aAAa,CAAC;IACnB,oDAAoD;IACpD,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,gDAAgD;IAChD,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0EAA0E;IAC1E,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,WAAY,SAAQ,YAAY;IAC/C,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,kBAAuB,GAAG,WAAW,CAQ/E"}

package/dist/adapters/test/index.js

@@ -7,11 +7,22 @@ export { mockRuntime } from './runtime.js';
 export { mockIO } from './io.js';
 export { plainStyle } from './style.js';
 export { auditStyle } from './audit-style.js';
+export { expectNoAnsi, expectNoAnsiSgr, expectContainsAnsi, expectHiddenCursor, expectShownCursor, expectWritten, } from './assertions.js';
+/**
+ * Create a fully-wired {@link BijouContext} for unit and integration tests.
+ *
+ * Assemble a {@link mockRuntime}, {@link mockIO}, and {@link plainStyle}
+ * together with a resolved theme so tests can exercise bijou components
+ * without touching real terminals or filesystems.
+ *
+ * @param options - Optional overrides for runtime, I/O, theme, mode, and color.
+ * @returns A {@link TestContext} ready for use in tests.
+ */
 export function createTestContext(options = {}) {
     const runtime = mockRuntime(options.runtime);
     const io = mockIO(options.io);
     const style = plainStyle();
-    const theme = createResolved(options.theme ?? CYAN_MAGENTA, options.noColor ?? false);
+    const theme = createResolved(options.theme ?? CYAN_MAGENTA, options.noColor ?? false, options.colorScheme ?? 'dark');
     const mode = options.mode ?? 'interactive';
     return { theme, mode, runtime, io, style };
 }

package/dist/adapters/test/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/test/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAA2B,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,MAAM,EAAmC,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAG3D,OAAO,EAAE,WAAW,EAA2B,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,MAAM,EAAmC,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,UAAU,EAAwC,MAAM,kBAAkB,CAAC;AAcpF,MAAM,UAAU,iBAAiB,CAAC,UAA8B,EAAE;IAChE,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7C,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC9B,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,CAAC,KAAK,IAAI,YAAY,EAAE,OAAO,CAAC,OAAO,IAAI,KAAK,CAAC,CAAC;IACtF,MAAM,IAAI,GAAe,OAAO,CAAC,IAAI,IAAI,aAAa,CAAC;IAEvD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;AAC7C,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/test/index.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,WAAW,EAA2B,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,MAAM,EAAmC,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAG3D,OAAO,EAAE,WAAW,EAA2B,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,MAAM,EAAmC,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,UAAU,EAAwC,MAAM,kBAAkB,CAAC;AACpF,OAAO,EACL,YAAY,EACZ,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,GACd,MAAM,iBAAiB,CAAC;AA6BzB;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAA8B,EAAE;IAChE,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7C,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC9B,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,CAAC,KAAK,IAAI,YAAY,EAAE,OAAO,CAAC,OAAO,IAAI,KAAK,EAAE,OAAO,CAAC,WAAW,IAAI,MAAM,CAAC,CAAC;IACrH,MAAM,IAAI,GAAe,OAAO,CAAC,IAAI,IAAI,aAAa,CAAC;IAEvD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;AAC7C,CAAC"}

package/dist/adapters/test/io.d.ts

@@ -1,15 +1,42 @@
 import type { IOPort } from '../../ports/io.js';
+/**
+ * Configuration for {@link mockIO}.
+ */
 export interface MockIOOptions {
+    /** Pre-loaded answers returned by {@link MockIO.question} in FIFO order. */
     answers?: string[];
+    /** Pre-loaded keypress strings delivered by {@link MockIO.rawInput} via microtasks. */
     keys?: string[];
+    /** Virtual filesystem entries (path to content) for {@link MockIO.readFile}. */
     files?: Record<string, string>;
+    /** Virtual directory listings (path to entries) for {@link MockIO.readDir}. */
     dirs?: Record<string, string[]>;
 }
+/**
+ * Extended {@link IOPort} exposing internal buffers for test assertions.
+ *
+ * Use `written` to inspect everything sent to the output stream, and
+ * `answerQueue` / `files` / `dirs` to prepopulate mock data.
+ */
 export interface MockIO extends IOPort {
+    /** All strings passed to {@link write} and prompt strings passed to {@link question}. */
     written: string[];
+    /** Remaining answers that will be consumed by {@link question}. */
     answerQueue: string[];
+    /** Mutable virtual filesystem backing {@link readFile}. */
     files: Record<string, string>;
+    /** Mutable virtual directory listing backing {@link readDir}. */
     dirs: Record<string, string[]>;
 }
+/**
+ * Create an in-memory {@link IOPort} for tests.
+ *
+ * Capture all output in `written`, resolve `question()` calls from a
+ * pre-loaded answer queue, deliver keypress events via microtasks, and
+ * serve filesystem reads from an in-memory map.
+ *
+ * @param options - Optional pre-loaded answers, keys, files, and directory listings.
+ * @returns A {@link MockIO} ready for use in tests.
+ */
 export declare function mockIO(options?: MockIOOptions): MockIO;
 //# sourceMappingURL=io.d.ts.map

package/dist/adapters/test/io.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../../../src/adapters/test/io.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAA+B,MAAM,mBAAmB,CAAC;AAG7E,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,MAAO,SAAQ,MAAM;IACpC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAChC;AAED,wBAAgB,MAAM,CAAC,OAAO,GAAE,aAAkB,GAAG,MAAM,CAyD1D"}
+{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../../../src/adapters/test/io.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAA+B,MAAM,mBAAmB,CAAC;AAG7E;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,uFAAuF;IACvF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,+EAA+E;IAC/E,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACjC;AAED;;;;;GAKG;AACH,MAAM,WAAW,MAAO,SAAQ,MAAM;IACpC,yFAAyF;IACzF,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,mEAAmE;IACnE,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAChC;AAED;;;;;;;;;GASG;AACH,wBAAgB,MAAM,CAAC,OAAO,GAAE,aAAkB,GAAG,MAAM,CAuG1D"}

package/dist/adapters/test/io.js

@@ -1,4 +1,14 @@
 import { join } from 'path';
+/**
+ * Create an in-memory {@link IOPort} for tests.
+ *
+ * Capture all output in `written`, resolve `question()` calls from a
+ * pre-loaded answer queue, deliver keypress events via microtasks, and
+ * serve filesystem reads from an in-memory map.
+ *
+ * @param options - Optional pre-loaded answers, keys, files, and directory listings.
+ * @returns A {@link MockIO} ready for use in tests.
+ */
 export function mockIO(options = {}) {
     const written = [];
     const answerQueue = [...(options.answers ?? [])];
@@ -9,16 +19,35 @@ export function mockIO(options = {}) {
         answerQueue,
         files,
         dirs,
+        /**
+         * Append a string to the `written` buffer.
+         * @param data - The string to write.
+         */
         write(data) {
             written.push(data);
         },
+        /**
+         * Record the prompt in `written` and resolve with the next queued answer.
+         * @param prompt - The prompt string displayed to the user.
+         * @returns The next answer from `answerQueue`, or `""` if exhausted.
+         */
         question(prompt) {
             written.push(prompt);
             return Promise.resolve(answerQueue.shift() ?? '');
         },
+        /**
+         * Deliver pre-loaded keys to the callback via microtasks.
+         *
+         * Each key is delivered one at a time; delivery stops when the handle
+         * is disposed or the key queue is exhausted.
+         *
+         * @param onKey - Callback invoked for each keypress.
+         * @returns A handle whose `dispose()` stops further key delivery.
+         */
         rawInput(onKey) {
             const keyQueue = [...(options.keys ?? [])];
             let disposed = false;
+            /** @internal Deliver the next key from the queue via microtask. */
             function deliver() {
                 if (disposed || keyQueue.length === 0)
                     return;
@@ -30,22 +59,49 @@ export function mockIO(options = {}) {
             queueMicrotask(deliver);
             return { dispose() { disposed = true; } };
         },
+        /**
+         * Register a resize callback (no-op in tests).
+         * @param _callback - Ignored; resize events are not simulated.
+         * @returns A no-op disposable handle.
+         */
         onResize(_callback) {
             return { dispose() { } };
         },
+        /**
+         * Start a real repeating timer via `globalThis.setInterval`.
+         * @param callback - Function to call at each interval.
+         * @param ms - Interval in milliseconds.
+         * @returns A handle whose `dispose()` cancels the timer.
+         */
         setInterval(callback, ms) {
             const id = globalThis.setInterval(callback, ms);
             return { dispose() { clearInterval(id); } };
         },
+        /**
+         * Read a file from the virtual filesystem.
+         * @param path - The file path to look up.
+         * @returns The file content as a string.
+         * @throws {Error} If the path is not present in the virtual filesystem.
+         */
         readFile(path) {
             const content = files[path];
             if (content === undefined)
                 throw new Error(`Mock: file not found: ${path}`);
             return content;
         },
+        /**
+         * List entries for a virtual directory.
+         * @param path - The directory path to look up.
+         * @returns The directory listing, or an empty array if not registered.
+         */
         readDir(path) {
             return dirs[path] ?? [];
         },
+        /**
+         * Join path segments using the platform separator (delegates to Node `path.join`).
+         * @param segments - Path components to join.
+         * @returns The joined path string.
+         */
         joinPath(...segments) {
             return join(...segments);
         },

package/dist/adapters/test/io.js.map

@@ -1 +1 @@
-{"version":3,"file":"io.js","sourceRoot":"","sources":["../../../src/adapters/test/io.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAgB5B,MAAM,UAAU,MAAM,CAAC,UAAyB,EAAE;IAChD,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,WAAW,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;IACjD,MAAM,KAAK,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;IAC3C,MAAM,IAAI,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC;IAEzC,OAAO;QACL,OAAO;QACP,WAAW;QACX,KAAK;QACL,IAAI;QAEJ,KAAK,CAAC,IAAY;YAChB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;QAED,QAAQ,CAAC,MAAc;YACrB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACrB,OAAO,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,CAAC;QAED,QAAQ,CAAC,KAA4B;YACnC,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;YAC3C,IAAI,QAAQ,GAAG,KAAK,CAAC;YACrB,SAAS,OAAO;gBACd,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;oBAAE,OAAO;gBAC9C,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,EAAG,CAAC;gBAC9B,KAAK,CAAC,GAAG,CAAC,CAAC;gBACX,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;oBAAE,cAAc,CAAC,OAAO,CAAC,CAAC;YACnD,CAAC;YACD,cAAc,CAAC,OAAO,CAAC,CAAC;YACxB,OAAO,EAAE,OAAO,KAAK,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5C,CAAC;QAED,QAAQ,CAAC,SAA+C;YACtD,OAAO,EAAE,OAAO,KAAI,CAAC,EAAE,CAAC;QAC1B,CAAC;QAED,WAAW,CAAC,QAAoB,EAAE,EAAU;YAC1C,MAAM,EAAE,GAAG,UAAU,CAAC,WAAW,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YAChD,OAAO,EAAE,OAAO,KAAK,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9C,CAAC;QAED,QAAQ,CAAC,IAAY;YACnB,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;YAC5B,IAAI,OAAO,KAAK,SAAS;gBAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,EAAE,CAAC,CAAC;YAC5E,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,OAAO,CAAC,IAAY;YAClB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAC1B,CAAC;QAED,QAAQ,CAAC,GAAG,QAAkB;YAC5B,OAAO,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC;QAC3B,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"io.js","sourceRoot":"","sources":["../../../src/adapters/test/io.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAiC5B;;;;;;;;;GASG;AACH,MAAM,UAAU,MAAM,CAAC,UAAyB,EAAE;IAChD,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,WAAW,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;IACjD,MAAM,KAAK,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;IAC3C,MAAM,IAAI,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC;IAEzC,OAAO;QACL,OAAO;QACP,WAAW;QACX,KAAK;QACL,IAAI;QAEJ;;;WAGG;QACH,KAAK,CAAC,IAAY;YAChB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;QAED;;;;WAIG;QACH,QAAQ,CAAC,MAAc;YACrB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACrB,OAAO,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,CAAC;QAED;;;;;;;;WAQG;QACH,QAAQ,CAAC,KAA4B;YACnC,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;YAC3C,IAAI,QAAQ,GAAG,KAAK,CAAC;YACrB,mEAAmE;YACnE,SAAS,OAAO;gBACd,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;oBAAE,OAAO;gBAC9C,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,EAAG,CAAC;gBAC9B,KAAK,CAAC,GAAG,CAAC,CAAC;gBACX,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;oBAAE,cAAc,CAAC,OAAO,CAAC,CAAC;YACnD,CAAC;YACD,cAAc,CAAC,OAAO,CAAC,CAAC;YACxB,OAAO,EAAE,OAAO,KAAK,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5C,CAAC;QAED;;;;WAIG;QACH,QAAQ,CAAC,SAA+C;YACtD,OAAO,EAAE,OAAO,KAAI,CAAC,EAAE,CAAC;QAC1B,CAAC;QAED;;;;;WAKG;QACH,WAAW,CAAC,QAAoB,EAAE,EAAU;YAC1C,MAAM,EAAE,GAAG,UAAU,CAAC,WAAW,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YAChD,OAAO,EAAE,OAAO,KAAK,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9C,CAAC;QAED;;;;;WAKG;QACH,QAAQ,CAAC,IAAY;YACnB,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;YAC5B,IAAI,OAAO,KAAK,SAAS;gBAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,EAAE,CAAC,CAAC;YAC5E,OAAO,OAAO,CAAC;QACjB,CAAC;QAED;;;;WAIG;QACH,OAAO,CAAC,IAAY;YAClB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAC1B,CAAC;QAED;;;;WAIG;QACH,QAAQ,CAAC,GAAG,QAAkB;YAC5B,OAAO,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC;QAC3B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/adapters/test/runtime.d.ts

@@ -1,10 +1,27 @@
 import type { RuntimePort } from '../../ports/runtime.js';
+/**
+ * Configuration for {@link mockRuntime}.
+ */
 export interface MockRuntimeOptions {
+    /** Environment variables to expose. Defaults to an empty record. */
     env?: Record<string, string>;
+    /** Whether stdout is a TTY. Defaults to `true`. */
     stdoutIsTTY?: boolean;
+    /** Whether stdin is a TTY. Defaults to `true`. */
     stdinIsTTY?: boolean;
+    /** Terminal width in columns. Defaults to `80`. */
     columns?: number;
+    /** Terminal height in rows. Defaults to `24`. */
     rows?: number;
 }
+/**
+ * Create an in-memory {@link RuntimePort} for tests.
+ *
+ * Provide deterministic environment variables and terminal dimensions
+ * without depending on the real `process` global.
+ *
+ * @param options - Optional overrides for environment and terminal geometry.
+ * @returns A {@link RuntimePort} backed by the supplied (or default) values.
+ */
 export declare function mockRuntime(options?: MockRuntimeOptions): RuntimePort;
 //# sourceMappingURL=runtime.d.ts.map

package/dist/adapters/test/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/adapters/test/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,WAAW,CAWzE"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/adapters/test/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,oEAAoE;IACpE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,mDAAmD;IACnD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,kDAAkD;IAClD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,WAAW,CAgBzE"}

package/dist/adapters/test/runtime.js

@@ -1,6 +1,20 @@
+/**
+ * Create an in-memory {@link RuntimePort} for tests.
+ *
+ * Provide deterministic environment variables and terminal dimensions
+ * without depending on the real `process` global.
+ *
+ * @param options - Optional overrides for environment and terminal geometry.
+ * @returns A {@link RuntimePort} backed by the supplied (or default) values.
+ */
 export function mockRuntime(options = {}) {
     const envMap = options.env ?? {};
     return {
+        /**
+         * Look up an environment variable by key.
+         * @param key - The variable name.
+         * @returns The value, or `undefined` if not set.
+         */
         env(key) {
             return envMap[key];
         },

package/dist/adapters/test/runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../../src/adapters/test/runtime.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,WAAW,CAAC,UAA8B,EAAE;IAC1D,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,IAAI,EAAE,CAAC;IACjC,OAAO;QACL,GAAG,CAAC,GAAW;YACb,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC;QACD,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,IAAI;QACxC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,IAAI;QACtC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;QAC9B,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,EAAE;KACzB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../../src/adapters/test/runtime.ts"],"names":[],"mappings":"AAkBA;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CAAC,UAA8B,EAAE;IAC1D,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,IAAI,EAAE,CAAC;IACjC,OAAO;QACL;;;;WAIG;QACH,GAAG,CAAC,GAAW;YACb,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC;QACD,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,IAAI;QACxC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,IAAI;QACtC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;QAC9B,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,EAAE;KACzB,CAAC;AACJ,CAAC"}

package/dist/adapters/test/style.d.ts

@@ -1,3 +1,12 @@
 import type { StylePort } from '../../ports/style.js';
+/**
+ * Create a no-op {@link StylePort} that returns text unchanged.
+ *
+ * Use in tests where color output is irrelevant; all methods act as
+ * identity functions so string equality assertions work without
+ * stripping ANSI escape codes.
+ *
+ * @returns A {@link StylePort} whose methods pass text through unmodified.
+ */
 export declare function plainStyle(): StylePort;
 //# sourceMappingURL=style.d.ts.map

package/dist/adapters/test/style.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"style.d.ts","sourceRoot":"","sources":["../../../src/adapters/test/style.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAGtD,wBAAgB,UAAU,IAAI,SAAS,CAetC"}
+{"version":3,"file":"style.d.ts","sourceRoot":"","sources":["../../../src/adapters/test/style.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAGtD;;;;;;;;GAQG;AACH,wBAAgB,UAAU,IAAI,SAAS,CAiEtC"}