hazo_ui 3.2.1 → 3.4.1

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

@@ -23,9 +23,46 @@ declare function AppSidebar({ pkg, navItems, }: {
     navItems: NavItem[];
 }): React__default.JSX.Element;
 
+interface CaseDoc {
+    /** What this test verifies, in plain language. */
+    description: string;
+    /** The inputs / preconditions the case feeds in (URL, payload, fixture, state). */
+    inputs: string;
+    /** The outputs / state the case asserts on success. */
+    expectedOutputs: string;
+    /** Known limitations, assumptions, or gotchas. Use "None" when not applicable. */
+    caveats: string;
+}
+interface Case {
+    name: string;
+    run: () => Promise<void>;
+    doc: CaseDoc;
+}
+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;
+
 type RunStatus = "pending" | "running" | "passed" | "failed";
 interface CaseResult {
     name: string;
+    doc?: CaseDoc;
     scenarioId?: string;
     status: RunStatus;
     durationMs?: number;
@@ -57,31 +94,6 @@ 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.
@@ -141,4 +153,4 @@ interface FormatOptions {
 }
 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 };
+export { AppSidebar, type AutoTestContextValue, AutoTestProvider, AutoTestRunner, type Case, type CaseDoc, 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

@@ -23,9 +23,46 @@ declare function AppSidebar({ pkg, navItems, }: {
     navItems: NavItem[];
 }): React__default.JSX.Element;
 
+interface CaseDoc {
+    /** What this test verifies, in plain language. */
+    description: string;
+    /** The inputs / preconditions the case feeds in (URL, payload, fixture, state). */
+    inputs: string;
+    /** The outputs / state the case asserts on success. */
+    expectedOutputs: string;
+    /** Known limitations, assumptions, or gotchas. Use "None" when not applicable. */
+    caveats: string;
+}
+interface Case {
+    name: string;
+    run: () => Promise<void>;
+    doc: CaseDoc;
+}
+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;
+
 type RunStatus = "pending" | "running" | "passed" | "failed";
 interface CaseResult {
     name: string;
+    doc?: CaseDoc;
     scenarioId?: string;
     status: RunStatus;
     durationMs?: number;
@@ -57,31 +94,6 @@ 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.
@@ -141,4 +153,4 @@ interface FormatOptions {
 }
 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 };
+export { AppSidebar, type AutoTestContextValue, AutoTestProvider, AutoTestRunner, type Case, type CaseDoc, 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.js

@@ -2,7 +2,7 @@ import React, { createContext, useState, useRef, useCallback, useContext } from
 import { clsx } from 'clsx';
 import { twMerge } from 'tailwind-merge';
 import { jsxs, jsx } from 'react/jsx-runtime';
-import { optional_import } from 'hazo_core';
+import { optional_import } from 'hazo_core/client';
 
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
@@ -146,6 +146,7 @@ function build_initial_state() {
       status: "pending",
       cases: scenario.cases.map((c) => ({
         name: c.name,
+        doc: c.doc,
         status: "pending"
       }))
     });
@@ -854,6 +855,63 @@ function CopySinglePromptButton({
     }
   );
 }
+function CaseRow({
+  c,
+  scenario_id,
+  pkg
+}) {
+  const [expanded, set_expanded] = useState(false);
+  return /* @__PURE__ */ jsxs("div", { className: "px-6 py-2", children: [
+    /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-2 text-sm", children: [
+      c.doc && /* @__PURE__ */ jsx(
+        "button",
+        {
+          onClick: () => set_expanded((v) => !v),
+          className: "text-gray-400 hover:text-gray-600 text-xs font-mono w-3 shrink-0",
+          "aria-label": expanded ? "Collapse doc" : "Expand doc",
+          children: expanded ? "\u25BE" : "\u25B8"
+        }
+      ),
+      !c.doc && /* @__PURE__ */ jsx("span", { className: "w-3 shrink-0" }),
+      /* @__PURE__ */ jsx(StatusIcon, { status: c.status }),
+      /* @__PURE__ */ jsx("span", { className: cn(
+        "flex-1",
+        c.status === "failed" ? "text-red-700" : "text-gray-700"
+      ), children: c.name }),
+      c.durationMs != null && /* @__PURE__ */ jsxs("span", { className: "text-xs text-gray-400", children: [
+        c.durationMs,
+        "ms"
+      ] }),
+      c.status === "failed" && c.error && /* @__PURE__ */ jsx(
+        CopySinglePromptButton,
+        {
+          scenario_id,
+          case_result: c,
+          pkg
+        }
+      )
+    ] }),
+    expanded && c.doc && /* @__PURE__ */ jsxs("div", { className: "mt-2 ml-8 text-xs rounded border border-gray-100 bg-gray-50 divide-y divide-gray-100", children: [
+      /* @__PURE__ */ jsxs("div", { className: "px-3 py-2", children: [
+        /* @__PURE__ */ jsx("span", { className: "font-semibold text-gray-600", children: "Description" }),
+        /* @__PURE__ */ jsx("p", { className: "mt-0.5 text-gray-700", children: c.doc.description })
+      ] }),
+      /* @__PURE__ */ jsxs("div", { className: "px-3 py-2", children: [
+        /* @__PURE__ */ jsx("span", { className: "font-semibold text-gray-600", children: "Inputs" }),
+        /* @__PURE__ */ jsx("p", { className: "mt-0.5 text-gray-700", children: c.doc.inputs })
+      ] }),
+      /* @__PURE__ */ jsxs("div", { className: "px-3 py-2", children: [
+        /* @__PURE__ */ jsx("span", { className: "font-semibold text-gray-600", children: "Expected outputs" }),
+        /* @__PURE__ */ jsx("p", { className: "mt-0.5 text-gray-700", children: c.doc.expectedOutputs })
+      ] }),
+      /* @__PURE__ */ jsxs("div", { className: "px-3 py-2", children: [
+        /* @__PURE__ */ jsx("span", { className: "font-semibold text-gray-600", children: "Caveats" }),
+        /* @__PURE__ */ jsx("p", { className: "mt-0.5 text-gray-700", children: c.doc.caveats })
+      ] })
+    ] }),
+    c.status === "failed" && c.error && /* @__PURE__ */ jsx("div", { className: "mt-1 ml-8 text-xs text-red-600 bg-red-50 rounded px-2 py-1 font-mono", children: c.error.message })
+  ] });
+}
 function ScenarioRow({
   scenario,
   pkg
@@ -895,28 +953,7 @@ function ScenarioRow({
         }
       )
     ] }),
-    expanded && /* @__PURE__ */ jsx("div", { className: "divide-y divide-gray-100", children: scenario.cases.map((c, i) => /* @__PURE__ */ jsxs("div", { className: "px-6 py-2", children: [
-      /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-2 text-sm", children: [
-        /* @__PURE__ */ jsx(StatusIcon, { status: c.status }),
-        /* @__PURE__ */ jsx("span", { className: cn(
-          "flex-1",
-          c.status === "failed" ? "text-red-700" : "text-gray-700"
-        ), children: c.name }),
-        c.durationMs != null && /* @__PURE__ */ jsxs("span", { className: "text-xs text-gray-400", children: [
-          c.durationMs,
-          "ms"
-        ] }),
-        c.status === "failed" && c.error && /* @__PURE__ */ jsx(
-          CopySinglePromptButton,
-          {
-            scenario_id: scenario.id,
-            case_result: c,
-            pkg
-          }
-        )
-      ] }),
-      c.status === "failed" && c.error && /* @__PURE__ */ jsx("div", { className: "mt-1 ml-5 text-xs text-red-600 bg-red-50 rounded px-2 py-1 font-mono", children: c.error.message })
-    ] }, i)) })
+    expanded && /* @__PURE__ */ jsx("div", { className: "divide-y divide-gray-100", children: scenario.cases.map((c, i) => /* @__PURE__ */ jsx(CaseRow, { c, scenario_id: scenario.id, pkg }, i)) })
   ] });
 }
 function AutoTestRunner() {