hazo_ui 2.16.0 → 3.0.1

package/dist/test-harness/index.d.cts

@@ -0,0 +1,144 @@
+import React__default from 'react';
+
+interface NavItem {
+    label: string;
+    href: string;
+    icon?: React__default.ReactNode;
+}
+/**
+ * Two-column layout shell.
+ * - Left column: sidebar (fixed height, scrollable internally)
+ * - Right column: main content (fills remaining width, scrollable)
+ */
+declare function SidebarLayout({ sidebar, children, }: {
+    sidebar: React__default.ReactNode;
+    children: React__default.ReactNode;
+}): React__default.JSX.Element;
+/**
+ * Per-package navigation sidebar.
+ * Reads the current pathname from window.location (SSR-safe via state initialisation).
+ */
+declare function AppSidebar({ pkg, navItems, }: {
+    pkg: string;
+    navItems: NavItem[];
+}): React__default.JSX.Element;
+
+type RunStatus = "pending" | "running" | "passed" | "failed";
+interface CaseResult {
+    name: string;
+    scenarioId?: string;
+    status: RunStatus;
+    durationMs?: number;
+    error?: Error;
+    expected?: unknown;
+    actual?: unknown;
+}
+interface ScenarioResult {
+    id: string;
+    name: string;
+    status: RunStatus;
+    cases: CaseResult[];
+}
+interface AutoTestContextValue {
+    scenarios: Map<string, ScenarioResult>;
+    runScenario(id: string): Promise<void>;
+    runAll(): Promise<void>;
+    reset(): void;
+}
+declare function AutoTestProvider({ pkg: _pkg, children, }: {
+    pkg: string;
+    children: React__default.ReactNode;
+}): React__default.JSX.Element;
+declare function useAutoTest(): AutoTestContextValue;
+
+declare function AutoTestRunner(): React__default.JSX.Element;
+
+declare function CopyAllFailuresButton({ failedCases, }: {
+    failedCases: CaseResult[];
+}): React__default.JSX.Element;
+
+interface Case {
+    name: string;
+    run: () => Promise<void>;
+}
+interface Scenario {
+    id: string;
+    name: string;
+    pkg: string;
+    filePath?: string;
+    cases: Case[];
+}
+/**
+ * Register a scenario with the global registry.
+ * Call this at module load time in your scenario files.
+ */
+declare function registerScenario(id: string, opts: {
+    name: string;
+    pkg: string;
+    cases: Case[];
+}): void;
+/** Return the entire registry (read-only reference). */
+declare function getRegistry(): Map<string, Scenario>;
+/** Clear the registry — used in tests only. */
+declare function clearRegistry(): void;
+
+/**
+ * Assertion error thrown by all helpers in this module.
+ * Carries expected/actual values and the call-site string for prompt generation.
+ */
+declare class HazoAssertionError extends Error {
+    readonly expected: unknown;
+    readonly actual: unknown;
+    readonly callSite: string | undefined;
+    constructor(message: string, expected: unknown, actual: unknown, callSite: string | undefined);
+}
+/**
+ * Assert that actual deep-equals expected.
+ * Uses JSON serialisation for a lightweight but useful deep-equality check.
+ */
+declare function assertEqual<T>(actual: T, expected: T): void;
+/**
+ * Assert that fn throws (optionally an instance of ErrorClass).
+ */
+declare function assertThrows(fn: () => unknown, ErrorClass?: new (...a: unknown[]) => Error): void;
+/**
+ * Assert that the promise resolves without rejection.
+ */
+declare function assertResolves(promise: Promise<unknown>): Promise<void>;
+/**
+ * Assert that the promise rejects (optionally with a specific ErrorClass).
+ */
+declare function assertRejects(promise: Promise<unknown>, ErrorClass?: new (...a: unknown[]) => Error): Promise<void>;
+/**
+ * Assert that str matches pattern.
+ */
+declare function assertMatch(str: string, pattern: RegExp): void;
+/**
+ * Assert that arr includes value (using JSON equality).
+ */
+declare function assertIncludes<T>(arr: T[], value: T): void;
+
+interface FailedCase {
+    pkg: string;
+    scenarioId: string;
+    caseName: string;
+    correlationId?: string;
+    durationMs?: number;
+    failedAt: Date;
+    error: Error;
+    expected?: unknown;
+    actual?: unknown;
+    scenarioFilePath?: string;
+    /** e.g. 'sqlite (in-memory)' or 'postgres' */
+    adapter?: string;
+    /** Config values to surface in section 7. Secret values are auto-redacted. */
+    relevantConfig?: Record<string, string>;
+}
+interface FormatOptions {
+    includeRingBuffer?: boolean;
+    includeCodeContext?: boolean;
+    maxRingBufferEntries?: number;
+}
+declare function formatAsClaudePrompt(fc: FailedCase, opts?: FormatOptions): Promise<string>;
+
+export { AppSidebar, type AutoTestContextValue, AutoTestProvider, AutoTestRunner, type Case, type CaseResult, CopyAllFailuresButton, type FailedCase, type FormatOptions, HazoAssertionError, type NavItem, type RunStatus, type Scenario, type ScenarioResult, SidebarLayout, assertEqual, assertIncludes, assertMatch, assertRejects, assertResolves, assertThrows, clearRegistry, formatAsClaudePrompt, getRegistry, registerScenario, useAutoTest };

package/dist/test-harness/index.d.ts

@@ -0,0 +1,144 @@
+import React__default from 'react';
+
+interface NavItem {
+    label: string;
+    href: string;
+    icon?: React__default.ReactNode;
+}
+/**
+ * Two-column layout shell.
+ * - Left column: sidebar (fixed height, scrollable internally)
+ * - Right column: main content (fills remaining width, scrollable)
+ */
+declare function SidebarLayout({ sidebar, children, }: {
+    sidebar: React__default.ReactNode;
+    children: React__default.ReactNode;
+}): React__default.JSX.Element;
+/**
+ * Per-package navigation sidebar.
+ * Reads the current pathname from window.location (SSR-safe via state initialisation).
+ */
+declare function AppSidebar({ pkg, navItems, }: {
+    pkg: string;
+    navItems: NavItem[];
+}): React__default.JSX.Element;
+
+type RunStatus = "pending" | "running" | "passed" | "failed";
+interface CaseResult {
+    name: string;
+    scenarioId?: string;
+    status: RunStatus;
+    durationMs?: number;
+    error?: Error;
+    expected?: unknown;
+    actual?: unknown;
+}
+interface ScenarioResult {
+    id: string;
+    name: string;
+    status: RunStatus;
+    cases: CaseResult[];
+}
+interface AutoTestContextValue {
+    scenarios: Map<string, ScenarioResult>;
+    runScenario(id: string): Promise<void>;
+    runAll(): Promise<void>;
+    reset(): void;
+}
+declare function AutoTestProvider({ pkg: _pkg, children, }: {
+    pkg: string;
+    children: React__default.ReactNode;
+}): React__default.JSX.Element;
+declare function useAutoTest(): AutoTestContextValue;
+
+declare function AutoTestRunner(): React__default.JSX.Element;
+
+declare function CopyAllFailuresButton({ failedCases, }: {
+    failedCases: CaseResult[];
+}): React__default.JSX.Element;
+
+interface Case {
+    name: string;
+    run: () => Promise<void>;
+}
+interface Scenario {
+    id: string;
+    name: string;
+    pkg: string;
+    filePath?: string;
+    cases: Case[];
+}
+/**
+ * Register a scenario with the global registry.
+ * Call this at module load time in your scenario files.
+ */
+declare function registerScenario(id: string, opts: {
+    name: string;
+    pkg: string;
+    cases: Case[];
+}): void;
+/** Return the entire registry (read-only reference). */
+declare function getRegistry(): Map<string, Scenario>;
+/** Clear the registry — used in tests only. */
+declare function clearRegistry(): void;
+
+/**
+ * Assertion error thrown by all helpers in this module.
+ * Carries expected/actual values and the call-site string for prompt generation.
+ */
+declare class HazoAssertionError extends Error {
+    readonly expected: unknown;
+    readonly actual: unknown;
+    readonly callSite: string | undefined;
+    constructor(message: string, expected: unknown, actual: unknown, callSite: string | undefined);
+}
+/**
+ * Assert that actual deep-equals expected.
+ * Uses JSON serialisation for a lightweight but useful deep-equality check.
+ */
+declare function assertEqual<T>(actual: T, expected: T): void;
+/**
+ * Assert that fn throws (optionally an instance of ErrorClass).
+ */
+declare function assertThrows(fn: () => unknown, ErrorClass?: new (...a: unknown[]) => Error): void;
+/**
+ * Assert that the promise resolves without rejection.
+ */
+declare function assertResolves(promise: Promise<unknown>): Promise<void>;
+/**
+ * Assert that the promise rejects (optionally with a specific ErrorClass).
+ */
+declare function assertRejects(promise: Promise<unknown>, ErrorClass?: new (...a: unknown[]) => Error): Promise<void>;
+/**
+ * Assert that str matches pattern.
+ */
+declare function assertMatch(str: string, pattern: RegExp): void;
+/**
+ * Assert that arr includes value (using JSON equality).
+ */
+declare function assertIncludes<T>(arr: T[], value: T): void;
+
+interface FailedCase {
+    pkg: string;
+    scenarioId: string;
+    caseName: string;
+    correlationId?: string;
+    durationMs?: number;
+    failedAt: Date;
+    error: Error;
+    expected?: unknown;
+    actual?: unknown;
+    scenarioFilePath?: string;
+    /** e.g. 'sqlite (in-memory)' or 'postgres' */
+    adapter?: string;
+    /** Config values to surface in section 7. Secret values are auto-redacted. */
+    relevantConfig?: Record<string, string>;
+}
+interface FormatOptions {
+    includeRingBuffer?: boolean;
+    includeCodeContext?: boolean;
+    maxRingBufferEntries?: number;
+}
+declare function formatAsClaudePrompt(fc: FailedCase, opts?: FormatOptions): Promise<string>;
+
+export { AppSidebar, type AutoTestContextValue, AutoTestProvider, AutoTestRunner, type Case, type CaseResult, CopyAllFailuresButton, type FailedCase, type FormatOptions, HazoAssertionError, type NavItem, type RunStatus, type Scenario, type ScenarioResult, SidebarLayout, assertEqual, assertIncludes, assertMatch, assertRejects, assertResolves, assertThrows, clearRegistry, formatAsClaudePrompt, getRegistry, registerScenario, useAutoTest };