@alexkroman1/aai-ui 8.2.1 → 9.0.0

package/README.md

@@ -22,7 +22,7 @@ still React, still the same theme tokens.
 `client()` mounts the default chat shell with your sidebar, or replaces the
 whole UI with a custom component:
 
-```tsx
+```tsx no-check
 import "@alexkroman1/aai-ui/styles.css";
 import { client, useAgentState, useTheme } from "@alexkroman1/aai-ui";
 
@@ -53,7 +53,7 @@ client({ sidebar: OrderSidebar });
 one control per scalar property of the workflow's own input schema, so adding
 a field to the schema adds it to the page:
 
-```tsx
+```tsx no-check
 import "@alexkroman1/aai-ui/styles.css";
 import {
   Form,
@@ -64,12 +64,14 @@ import {
   WorkflowFields,
   WorkflowProgress,
 } from "@alexkroman1/aai-ui";
+// Type-only, so it is ERASED — the agent module is not in this bundle.
+import type { digest } from "./agent.ts";
 
 function App() {
-  const { submit, run, pending, upload, error } = useWorkflowSubmit("digest");
+  const { submitForm, run, pending, upload, error } = useWorkflowSubmit<typeof digest>("digest");
   return (
     <main className="mx-auto flex max-w-2xl flex-col gap-6 p-8">
-      <Form onSubmit={submit} error={error}>
+      <Form onSubmit={submitForm} error={error}>
         <WorkflowFields workflow="digest" />
         <SubmitButton pending={pending}>Summarize</SubmitButton>
       </Form>

package/dist/_workflow-test-defs.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Synthetic workflow DEF types for this package's specs.
+ *
+ * The workflow hooks take a def rather than an output type, and the def is
+ * REQUIRED — there is no untyped fallback, because an escape hatch nobody needs
+ * is one somebody uses. That leaves the specs, whose subject is upload plumbing
+ * and polling rather than typing, needing a def to name.
+ *
+ * Built structurally rather than with a schema library: `zod` is not a
+ * dependency of this package, and `StandardSchemaV1` is published on
+ * `@alexkroman1/aai/host-internal`, which a browser package may not import. The
+ * shape below is the part of that contract `InferSchemaOutput` reads — the
+ * `types.output` slot — and nothing else, which is all a type-level def needs.
+ *
+ * A `.ts` module rather than a `_test-utils` export because it is types only.
+ */
+import type { WorkflowDef } from "@alexkroman1/aai";
+/** A Standard-Schema-shaped type whose parsed output is `O`. Never constructed. */
+type SchemaOf<O extends Record<string, unknown>> = {
+    readonly "~standard": {
+        readonly version: 1;
+        readonly vendor: string;
+        readonly validate: (value: unknown) => {
+            readonly value: O;
+        };
+        readonly types?: {
+            readonly input: unknown;
+            readonly output: O;
+        } | undefined;
+    };
+};
+/** A workflow taking `I` and answering `O`. */
+export type TestWorkflow<I extends Record<string, unknown> = Record<string, unknown>, O = unknown> = WorkflowDef<SchemaOf<I>, O>;
+/** The shape most specs here need: one `recording` upload id, an unknown result. */
+export type UploadWorkflow = TestWorkflow<{
+    recording: unknown;
+}>;
+export {};

package/dist/components/upload-progress.d.ts

@@ -32,13 +32,14 @@ import type { UploadStatus } from "../use-workflow-form.ts";
  * parent's state) has nothing to pause.
  *
  * @example
- * ```tsx
+ * ```tsx no-check
  * import { Form, SubmitButton, UploadProgressBar, useWorkflowSubmit, WorkflowFields } from "@alexkroman1/aai-ui";
+ * import type { transcribe } from "./agent.ts";
  *
  * function TranscribeForm() {
- *   const { submit, upload, pending, error } = useWorkflowSubmit("transcribe");
+ *   const { submitForm, upload, pending, error } = useWorkflowSubmit<typeof transcribe>("transcribe");
  *   return (
- *     <Form onSubmit={(values) => submit(values)} error={error}>
+ *     <Form onSubmit={submitForm} error={error}>
  *       <WorkflowFields workflow="transcribe" />
  *       <UploadProgressBar upload={upload} />
  *       <SubmitButton pending={pending}>Transcribe</SubmitButton>

package/dist/components/workflow-fields.d.ts

@@ -15,14 +15,15 @@ import type { WorkflowSummary } from "@alexkroman1/aai/workflow-api";
  * beside it are not reordered when the schema lands.
  *
  * @example
- * ```tsx
+ * ```tsx no-check
  * import { Form, SubmitButton, WorkflowFields, useWorkflowSubmit }
  *   from "@alexkroman1/aai-ui";
+ * import type { transcribe } from "./agent.ts";
  *
  * function StartRun() {
- *   const { submit, pending, error } = useWorkflowSubmit("transcribe");
+ *   const { submitForm, pending, error } = useWorkflowSubmit<typeof transcribe>("transcribe");
  *   return (
- *     <Form onSubmit={(values) => submit(values)} error={error}>
+ *     <Form onSubmit={submitForm} error={error}>
  *       <WorkflowFields workflow="transcribe" />
  *       <SubmitButton pending={pending}>Transcribe</SubmitButton>
  *     </Form>