@aletheia-dev/collection-flow-ui 0.1.0

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/FieldInput.tsx","../src/FileField.tsx","../src/SubmissionScope.ts","../src/StepForm.tsx","../src/StepPreview.tsx"],"sourcesContent":["export { FieldInput, type FieldInputProps } from './FieldInput.js';\nexport { FileField } from './FileField.js';\nexport {\n  SubmissionScopeContext,\n  useSubmissionScope,\n  type SubmissionScope,\n} from './SubmissionScope.js';\nexport { StepForm, type StepFormProps } from './StepForm.js';\nexport { StepPreview, type StepPreviewProps } from './StepPreview.js';\n","import type { Field } from '@aletheia-dev/core';\nimport { useContext } from 'react';\nimport { FileField } from './FileField.js';\nimport { SubmissionScopeContext } from './SubmissionScope.js';\n\nexport interface FieldInputProps {\n  field: Field;\n  value: unknown;\n  error?: string;\n  onChange: (value: unknown) => void;\n  /** Renders the control disabled (previews, read-only views). */\n  readOnly?: boolean;\n}\n\n/** Empty strings become undefined for every type except free text so optional fields validate. */\nfunction normalise(field: Field, raw: string): unknown {\n  if (raw === '' && field.type !== 'text') return undefined;\n  return raw;\n}\n\nfunction Control({ field, value, onChange, readOnly, id }: FieldInputProps & { id: string }) {\n  const scope = useContext(SubmissionScopeContext);\n  const text = typeof value === 'string' || typeof value === 'number' ? String(value) : '';\n  switch (field.type) {\n    case 'text':\n    case 'email':\n    case 'number':\n    case 'date':\n      return (\n        <input\n          id={id}\n          type={field.type}\n          value={text}\n          placeholder={field.placeholder}\n          min={field.type === 'number' ? field.validation?.min : undefined}\n          max={field.type === 'number' ? field.validation?.max : undefined}\n          disabled={readOnly}\n          onChange={(e) => onChange(normalise(field, e.target.value))}\n        />\n      );\n    case 'select':\n      return (\n        <select\n          id={id}\n          value={text}\n          disabled={readOnly}\n          onChange={(e) => onChange(normalise(field, e.target.value))}\n        >\n          <option value=\"\">Select…</option>\n          {(field.options ?? []).map((o) => (\n            <option key={o.value} value={o.value}>\n              {o.label}\n            </option>\n          ))}\n        </select>\n      );\n    case 'boolean':\n      return (\n        <input\n          id={id}\n          type=\"checkbox\"\n          checked={value === true}\n          disabled={readOnly}\n          onChange={(e) => onChange(e.target.checked)}\n        />\n      );\n    case 'file':\n      // Uploads are scoped to a submission; without one (builder preview) the control is inert.\n      if (!scope) {\n        return (\n          <div className=\"file-field\">\n            <input id={id} type=\"file\" disabled />\n            <p className=\"file-status muted\">File upload needs a submission</p>\n          </div>\n        );\n      }\n      return (\n        <FileField id={id} field={field} value={value} onChange={onChange} disabled={readOnly} />\n      );\n  }\n}\n\nexport function FieldInput(props: FieldInputProps) {\n  const { field, error } = props;\n  const id = `field-${field.key}`;\n  return (\n    <div className=\"field\">\n      <label htmlFor={id}>\n        {field.label}\n        {field.required && ' *'}\n      </label>\n      <Control {...props} id={id} />\n      {field.help && <small>{field.help}</small>}\n      {error && <span className=\"error\">{error}</span>}\n    </div>\n  );\n}\n","import {\n  checkFileBeforeUpload,\n  isTerminalDocumentStatus,\n  pollDocument,\n  uploadToStorage,\n  type Document,\n  type DocumentContentType,\n  type FileFieldValue,\n} from '@aletheia-dev/api-client';\nimport type { Field } from '@aletheia-dev/core';\nimport { useEffect, useRef, useState, type ChangeEvent } from 'react';\nimport { useSubmissionScope } from './SubmissionScope.js';\n\n/** Formats an unknown thrown value for display. */\nfunction errorMessage(value: unknown): string {\n  return value instanceof Error ? value.message : String(value);\n}\n\nconst ACCEPT = '.jpg,.jpeg,.png,.webp,.pdf,image/jpeg,image/png,image/webp,application/pdf';\n\ntype Phase =\n  | { kind: 'empty' }\n  /** A saved value exists; its status is being fetched. */\n  | { kind: 'loading'; fileName?: string }\n  | { kind: 'uploading'; fileName: string; fraction: number }\n  | { kind: 'scanning'; fileName: string }\n  | { kind: 'clean'; fileName: string }\n  | { kind: 'rejected'; fileName: string; reason: string }\n  | { kind: 'infected'; fileName: string }\n  /** Pre-check failure (not retryable) or an upload/network error (retryable from `create`). */\n  | { kind: 'error'; fileName: string; message: string; retryable: boolean };\n\ninterface FileFieldProps {\n  id: string;\n  field: Field;\n  value: unknown;\n  onChange: (value: FileFieldValue | undefined) => void;\n  /** Blocks picking a file (read-only views); upload/scan progress still shows. */\n  disabled?: boolean;\n}\n\nfunction savedValue(value: unknown): FileFieldValue | undefined {\n  if (typeof value !== 'object' || value === null) return undefined;\n  const { fileId, name } = value as { fileId?: unknown; name?: unknown };\n  if (typeof fileId !== 'string') return undefined;\n  return { fileId, name: typeof name === 'string' ? name : undefined };\n}\n\nfunction phaseFor(document: Document, fileName: string): Phase {\n  switch (document.status) {\n    case 'clean':\n      return { kind: 'clean', fileName };\n    case 'infected':\n      return { kind: 'infected', fileName };\n    case 'rejected':\n      return {\n        kind: 'rejected',\n        fileName,\n        reason: document.rejectionReason ?? 'The file was refused.',\n      };\n    default:\n      return { kind: 'scanning', fileName };\n  }\n}\n\n/**\n * A `file` field: pre-checks the pick, uploads straight to storage with progress, finalizes and\n * waits for the scan. The field value becomes `{ fileId, name }` only once the document is clean.\n */\nexport function FileField({ id, field, value, onChange, disabled }: FileFieldProps) {\n  const { api, submissionId, upload = uploadToStorage, pollIntervalMs } = useSubmissionScope();\n  const saved = savedValue(value);\n  const [phase, setPhase] = useState<Phase>(() =>\n    saved ? { kind: 'loading', fileName: saved.name } : { kind: 'empty' },\n  );\n  const inputRef = useRef<HTMLInputElement>(null);\n  const lastFile = useRef<File | undefined>(undefined);\n  const onChangeRef = useRef(onChange);\n  // Attempt counter: results of a superseded attempt (or after unmount) are dropped.\n  const attempt = useRef(0);\n  const mounted = useRef(false);\n  // Ids this field resolved itself, so a value it just set is not fetched again.\n  const resolvedId = useRef<string | undefined>(undefined);\n\n  useEffect(() => {\n    onChangeRef.current = onChange;\n  });\n  useEffect(() => {\n    mounted.current = true;\n    return () => {\n      mounted.current = false;\n    };\n  }, []);\n\n  const savedId = saved?.fileId;\n  const savedName = saved?.name;\n  useEffect(() => {\n    if (!savedId || savedId === resolvedId.current) return;\n    const current = ++attempt.current;\n    const alive = () => mounted.current && current === attempt.current;\n    const controller = new AbortController();\n    pollDocument(api, savedId, {\n      submissionId,\n      signal: controller.signal,\n      intervalMs: pollIntervalMs,\n    })\n      .then((document) => {\n        if (!alive()) return;\n        resolvedId.current = savedId;\n        const next = phaseFor(document, savedName ?? document.fileName);\n        setPhase(next);\n        if (next.kind !== 'clean') onChangeRef.current(undefined);\n      })\n      .catch((err: unknown) => {\n        if (!alive() || controller.signal.aborted) return;\n        setPhase({\n          kind: 'error',\n          fileName: savedName ?? '',\n          message: errorMessage(err),\n          retryable: false,\n        });\n      });\n    return () => controller.abort();\n  }, [api, submissionId, savedId, savedName, pollIntervalMs]);\n\n  async function start(file: File) {\n    const current = ++attempt.current;\n    const alive = () => mounted.current && current === attempt.current;\n    lastFile.current = file;\n    const check = checkFileBeforeUpload(file);\n    if (!check.ok) {\n      setPhase({ kind: 'error', fileName: file.name, message: check.reason, retryable: false });\n      return;\n    }\n    onChangeRef.current(undefined);\n    setPhase({ kind: 'uploading', fileName: file.name, fraction: 0 });\n    try {\n      const ticket = await api.documents.create({\n        fileName: file.name,\n        contentType: file.type as DocumentContentType,\n        sizeBytes: file.size,\n        submissionId,\n        fieldKey: field.key,\n      });\n      if (!alive()) return;\n      await upload(ticket, file, {\n        onProgress: (fraction) => {\n          if (alive()) setPhase({ kind: 'uploading', fileName: file.name, fraction });\n        },\n      });\n      if (!alive()) return;\n      setPhase({ kind: 'scanning', fileName: file.name });\n      let document = await api.documents.finalize(ticket.documentId, { submissionId });\n      if (!alive()) return;\n      if (!isTerminalDocumentStatus(document.status)) {\n        document = await pollDocument(api, ticket.documentId, {\n          submissionId,\n          intervalMs: pollIntervalMs,\n        });\n        if (!alive()) return;\n      }\n      const next = phaseFor(document, file.name);\n      setPhase(next);\n      if (next.kind === 'clean') {\n        resolvedId.current = document.id;\n        onChangeRef.current({ fileId: document.id, name: file.name });\n      }\n    } catch (err) {\n      if (!alive()) return;\n      setPhase({ kind: 'error', fileName: file.name, message: errorMessage(err), retryable: true });\n    }\n  }\n\n  function onPick(event: ChangeEvent<HTMLInputElement>) {\n    const file = event.target.files?.[0];\n    // Clear the control so picking the same file again fires `change`.\n    event.target.value = '';\n    if (file) void start(file);\n  }\n\n  const busy = phase.kind === 'uploading' || phase.kind === 'scanning' || phase.kind === 'loading';\n  const retry = (\n    <button\n      type=\"button\"\n      className=\"secondary inline\"\n      onClick={() => {\n        if (lastFile.current) void start(lastFile.current);\n      }}\n    >\n      Retry\n    </button>\n  );\n\n  return (\n    <div className=\"file-field\">\n      <input\n        ref={inputRef}\n        id={id}\n        type=\"file\"\n        accept={ACCEPT}\n        disabled={busy || disabled}\n        onChange={onPick}\n      />\n      {phase.kind === 'uploading' && (\n        <>\n          <progress value={phase.fraction} max={1} aria-label={`Uploading ${phase.fileName}`} />\n          <p className=\"file-status\" role=\"status\">\n            Uploading {phase.fileName}… {Math.round(phase.fraction * 100)}%\n          </p>\n        </>\n      )}\n      {phase.kind === 'loading' && (\n        <p className=\"file-status muted\" role=\"status\">\n          Checking {phase.fileName ?? 'the saved file'}…\n        </p>\n      )}\n      {phase.kind === 'scanning' && (\n        <p className=\"file-status muted\" role=\"status\">\n          Scanning {phase.fileName}…\n        </p>\n      )}\n      {phase.kind === 'clean' && (\n        <p className=\"file-status ok\" role=\"status\">\n          <span>{phase.fileName} uploaded and checked.</span>\n          <button\n            type=\"button\"\n            className=\"secondary inline\"\n            onClick={() => inputRef.current?.click()}\n          >\n            Replace\n          </button>\n        </p>\n      )}\n      {phase.kind === 'rejected' && (\n        <p className=\"file-status bad\" role=\"status\">\n          <span>\n            {phase.fileName} was rejected: {phase.reason}\n          </span>\n          {retry}\n        </p>\n      )}\n      {phase.kind === 'infected' && (\n        <p className=\"file-status bad\" role=\"status\">\n          {phase.fileName} failed the malware scan. Please choose another file.\n        </p>\n      )}\n      {phase.kind === 'error' && (\n        <p className=\"file-status bad\" role=\"status\">\n          <span>{phase.message}</span>\n          {phase.retryable && retry}\n        </p>\n      )}\n    </div>\n  );\n}\n","import type { ApiClient, uploadToStorage } from '@aletheia-dev/api-client';\nimport { createContext, useContext } from 'react';\n\n/** What fields that talk to the API (file uploads) need from the page rendering the flow. */\nexport interface SubmissionScope {\n  api: ApiClient;\n  submissionId: string;\n  /** Storage uploader; injectable so tests need no XMLHttpRequest. */\n  upload?: typeof uploadToStorage;\n  /** Scan polling interval; defaults to the client's 750 ms. */\n  pollIntervalMs?: number;\n}\n\nexport const SubmissionScopeContext = createContext<SubmissionScope | undefined>(undefined);\n\nexport function useSubmissionScope(): SubmissionScope {\n  const scope = useContext(SubmissionScopeContext);\n  if (!scope) throw new Error('useSubmissionScope must be used inside SubmissionScopeContext');\n  return scope;\n}\n","import { visibleFields } from '@aletheia-dev/collection-flow';\nimport type { FlowStep } from '@aletheia-dev/core';\nimport { FieldInput } from './FieldInput.js';\n\nexport interface StepFormProps {\n  step: FlowStep;\n  /** Current answers, keyed by field key; drives `visibleWhen`. */\n  value: Record<string, unknown>;\n  onChange: (key: string, value: unknown) => void;\n  /** Messages keyed by field key. */\n  errors?: Record<string, string>;\n  readOnly?: boolean;\n}\n\n/** Renders the currently visible fields of one flow step. */\nexport function StepForm({ step, value, onChange, errors, readOnly }: StepFormProps) {\n  return (\n    <>\n      {visibleFields(step, value).map((field) => (\n        <FieldInput\n          key={field.key}\n          field={field}\n          value={value[field.key]}\n          error={errors?.[field.key]}\n          readOnly={readOnly}\n          onChange={(next) => onChange(field.key, next)}\n        />\n      ))}\n    </>\n  );\n}\n","import { buildZodForStep } from '@aletheia-dev/collection-flow';\nimport type { FlowStep } from '@aletheia-dev/core';\nimport { useState } from 'react';\nimport { StepForm } from './StepForm.js';\n\nexport interface StepPreviewProps {\n  step: FlowStep;\n  /** Starting sample data; the preview keeps its own copy afterwards. */\n  initialData?: Record<string, unknown>;\n}\n\ntype Result =\n  | { kind: 'valid' }\n  | { kind: 'invalid'; issues: Array<{ path: string; message: string }> }\n  | { kind: 'broken'; message: string };\n\nfunction validate(step: FlowStep, data: Record<string, unknown>): Result {\n  try {\n    const parsed = buildZodForStep(step, data).safeParse(data);\n    if (parsed.success) return { kind: 'valid' };\n    return {\n      kind: 'invalid',\n      issues: parsed.error.issues.map((issue) => {\n        const path = issue.path.map(String).join('.');\n        const missing = issue.code === 'invalid_type' && data[path] === undefined;\n        return { path, message: missing ? 'This field is required' : issue.message };\n      }),\n    };\n  } catch (err) {\n    // A step that cannot produce a schema (e.g. a select without options) is a definition error.\n    return { kind: 'broken', message: err instanceof Error ? err.message : String(err) };\n  }\n}\n\n/**\n * A step rendered as the applicant would see it, with sample data and a \"Validate\" button that\n * runs the step's validation. Needs no API: file fields render disabled outside a submission.\n */\nexport function StepPreview({ step, initialData }: StepPreviewProps) {\n  const [data, setData] = useState<Record<string, unknown>>(() => ({ ...initialData }));\n  const [result, setResult] = useState<Result | undefined>();\n\n  const errors: Record<string, string> = {};\n  if (result?.kind === 'invalid') {\n    for (const issue of result.issues) {\n      const key = issue.path.split('.')[0] ?? '';\n      if (!(key in errors)) errors[key] = issue.message;\n    }\n  }\n\n  return (\n    <div className=\"step-preview\">\n      <h3>{step.title}</h3>\n      {step.description && <p className=\"muted\">{step.description}</p>}\n      <form\n        className=\"form\"\n        onSubmit={(e) => {\n          e.preventDefault();\n          setResult(validate(step, data));\n        }}\n      >\n        <StepForm\n          step={step}\n          value={data}\n          errors={errors}\n          onChange={(key, value) => {\n            setData((d) => ({ ...d, [key]: value }));\n            setResult(undefined);\n          }}\n        />\n        <div className=\"actions\">\n          <button type=\"submit\">Validate</button>\n        </div>\n      </form>\n      {result?.kind === 'valid' && (\n        <p className=\"preview-result ok\" role=\"status\">\n          Valid: this step would pass.\n        </p>\n      )}\n      {result?.kind === 'invalid' && (\n        <div className=\"preview-result bad\" role=\"status\">\n          <p>\n            {result.issues.length} issue{result.issues.length === 1 ? '' : 's'}:\n          </p>\n          <ul>\n            {result.issues.map((issue, i) => (\n              <li key={`${issue.path}-${i}`}>\n                <code>{issue.path || '(step)'}</code>: {issue.message}\n              </li>\n            ))}\n          </ul>\n        </div>\n      )}\n      {result?.kind === 'broken' && (\n        <p className=\"preview-result bad\" role=\"status\">\n          This step cannot be validated: {result.message}\n        </p>\n      )}\n    </div>\n  );\n}\n"],"mappings":"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","names":["import_react","import_react","import_jsx_runtime","import_jsx_runtime","import_collection_flow","import_react","import_jsx_runtime"]}

package/dist/index.d.cts

@@ -0,0 +1,64 @@
+import * as react from 'react';
+import { Field, FlowStep } from '@aletheia-dev/core';
+import { FileFieldValue, ApiClient, uploadToStorage } from '@aletheia-dev/api-client';
+
+interface FieldInputProps {
+    field: Field;
+    value: unknown;
+    error?: string;
+    onChange: (value: unknown) => void;
+    /** Renders the control disabled (previews, read-only views). */
+    readOnly?: boolean;
+}
+declare function FieldInput(props: FieldInputProps): react.JSX.Element;
+
+interface FileFieldProps {
+    id: string;
+    field: Field;
+    value: unknown;
+    onChange: (value: FileFieldValue | undefined) => void;
+    /** Blocks picking a file (read-only views); upload/scan progress still shows. */
+    disabled?: boolean;
+}
+/**
+ * A `file` field: pre-checks the pick, uploads straight to storage with progress, finalizes and
+ * waits for the scan. The field value becomes `{ fileId, name }` only once the document is clean.
+ */
+declare function FileField({ id, field, value, onChange, disabled }: FileFieldProps): react.JSX.Element;
+
+/** What fields that talk to the API (file uploads) need from the page rendering the flow. */
+interface SubmissionScope {
+    api: ApiClient;
+    submissionId: string;
+    /** Storage uploader; injectable so tests need no XMLHttpRequest. */
+    upload?: typeof uploadToStorage;
+    /** Scan polling interval; defaults to the client's 750 ms. */
+    pollIntervalMs?: number;
+}
+declare const SubmissionScopeContext: react.Context<SubmissionScope | undefined>;
+declare function useSubmissionScope(): SubmissionScope;
+
+interface StepFormProps {
+    step: FlowStep;
+    /** Current answers, keyed by field key; drives `visibleWhen`. */
+    value: Record<string, unknown>;
+    onChange: (key: string, value: unknown) => void;
+    /** Messages keyed by field key. */
+    errors?: Record<string, string>;
+    readOnly?: boolean;
+}
+/** Renders the currently visible fields of one flow step. */
+declare function StepForm({ step, value, onChange, errors, readOnly }: StepFormProps): react.JSX.Element;
+
+interface StepPreviewProps {
+    step: FlowStep;
+    /** Starting sample data; the preview keeps its own copy afterwards. */
+    initialData?: Record<string, unknown>;
+}
+/**
+ * A step rendered as the applicant would see it, with sample data and a "Validate" button that
+ * runs the step's validation. Needs no API: file fields render disabled outside a submission.
+ */
+declare function StepPreview({ step, initialData }: StepPreviewProps): react.JSX.Element;
+
+export { FieldInput, type FieldInputProps, FileField, StepForm, type StepFormProps, StepPreview, type StepPreviewProps, type SubmissionScope, SubmissionScopeContext, useSubmissionScope };

package/dist/index.d.ts

@@ -0,0 +1,64 @@
+import * as react from 'react';
+import { Field, FlowStep } from '@aletheia-dev/core';
+import { FileFieldValue, ApiClient, uploadToStorage } from '@aletheia-dev/api-client';
+
+interface FieldInputProps {
+    field: Field;
+    value: unknown;
+    error?: string;
+    onChange: (value: unknown) => void;
+    /** Renders the control disabled (previews, read-only views). */
+    readOnly?: boolean;
+}
+declare function FieldInput(props: FieldInputProps): react.JSX.Element;
+
+interface FileFieldProps {
+    id: string;
+    field: Field;
+    value: unknown;
+    onChange: (value: FileFieldValue | undefined) => void;
+    /** Blocks picking a file (read-only views); upload/scan progress still shows. */
+    disabled?: boolean;
+}
+/**
+ * A `file` field: pre-checks the pick, uploads straight to storage with progress, finalizes and
+ * waits for the scan. The field value becomes `{ fileId, name }` only once the document is clean.
+ */
+declare function FileField({ id, field, value, onChange, disabled }: FileFieldProps): react.JSX.Element;
+
+/** What fields that talk to the API (file uploads) need from the page rendering the flow. */
+interface SubmissionScope {
+    api: ApiClient;
+    submissionId: string;
+    /** Storage uploader; injectable so tests need no XMLHttpRequest. */
+    upload?: typeof uploadToStorage;
+    /** Scan polling interval; defaults to the client's 750 ms. */
+    pollIntervalMs?: number;
+}
+declare const SubmissionScopeContext: react.Context<SubmissionScope | undefined>;
+declare function useSubmissionScope(): SubmissionScope;
+
+interface StepFormProps {
+    step: FlowStep;
+    /** Current answers, keyed by field key; drives `visibleWhen`. */
+    value: Record<string, unknown>;
+    onChange: (key: string, value: unknown) => void;
+    /** Messages keyed by field key. */
+    errors?: Record<string, string>;
+    readOnly?: boolean;
+}
+/** Renders the currently visible fields of one flow step. */
+declare function StepForm({ step, value, onChange, errors, readOnly }: StepFormProps): react.JSX.Element;
+
+interface StepPreviewProps {
+    step: FlowStep;
+    /** Starting sample data; the preview keeps its own copy afterwards. */
+    initialData?: Record<string, unknown>;
+}
+/**
+ * A step rendered as the applicant would see it, with sample data and a "Validate" button that
+ * runs the step's validation. Needs no API: file fields render disabled outside a submission.
+ */
+declare function StepPreview({ step, initialData }: StepPreviewProps): react.JSX.Element;
+
+export { FieldInput, type FieldInputProps, FileField, StepForm, type StepFormProps, StepPreview, type StepPreviewProps, type SubmissionScope, SubmissionScopeContext, useSubmissionScope };

package/dist/index.js

@@ -0,0 +1,408 @@
+// src/FieldInput.tsx
+import { useContext as useContext2 } from "react";
+
+// src/FileField.tsx
+import {
+  checkFileBeforeUpload,
+  isTerminalDocumentStatus,
+  pollDocument,
+  uploadToStorage
+} from "@aletheia-dev/api-client";
+import { useEffect, useRef, useState } from "react";
+
+// src/SubmissionScope.ts
+import { createContext, useContext } from "react";
+var SubmissionScopeContext = createContext(void 0);
+function useSubmissionScope() {
+  const scope = useContext(SubmissionScopeContext);
+  if (!scope) throw new Error("useSubmissionScope must be used inside SubmissionScopeContext");
+  return scope;
+}
+
+// src/FileField.tsx
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+function errorMessage(value) {
+  return value instanceof Error ? value.message : String(value);
+}
+var ACCEPT = ".jpg,.jpeg,.png,.webp,.pdf,image/jpeg,image/png,image/webp,application/pdf";
+function savedValue(value) {
+  if (typeof value !== "object" || value === null) return void 0;
+  const { fileId, name } = value;
+  if (typeof fileId !== "string") return void 0;
+  return { fileId, name: typeof name === "string" ? name : void 0 };
+}
+function phaseFor(document, fileName) {
+  switch (document.status) {
+    case "clean":
+      return { kind: "clean", fileName };
+    case "infected":
+      return { kind: "infected", fileName };
+    case "rejected":
+      return {
+        kind: "rejected",
+        fileName,
+        reason: document.rejectionReason ?? "The file was refused."
+      };
+    default:
+      return { kind: "scanning", fileName };
+  }
+}
+function FileField({ id, field, value, onChange, disabled }) {
+  const { api, submissionId, upload = uploadToStorage, pollIntervalMs } = useSubmissionScope();
+  const saved = savedValue(value);
+  const [phase, setPhase] = useState(
+    () => saved ? { kind: "loading", fileName: saved.name } : { kind: "empty" }
+  );
+  const inputRef = useRef(null);
+  const lastFile = useRef(void 0);
+  const onChangeRef = useRef(onChange);
+  const attempt = useRef(0);
+  const mounted = useRef(false);
+  const resolvedId = useRef(void 0);
+  useEffect(() => {
+    onChangeRef.current = onChange;
+  });
+  useEffect(() => {
+    mounted.current = true;
+    return () => {
+      mounted.current = false;
+    };
+  }, []);
+  const savedId = saved?.fileId;
+  const savedName = saved?.name;
+  useEffect(() => {
+    if (!savedId || savedId === resolvedId.current) return;
+    const current = ++attempt.current;
+    const alive = () => mounted.current && current === attempt.current;
+    const controller = new AbortController();
+    pollDocument(api, savedId, {
+      submissionId,
+      signal: controller.signal,
+      intervalMs: pollIntervalMs
+    }).then((document) => {
+      if (!alive()) return;
+      resolvedId.current = savedId;
+      const next = phaseFor(document, savedName ?? document.fileName);
+      setPhase(next);
+      if (next.kind !== "clean") onChangeRef.current(void 0);
+    }).catch((err) => {
+      if (!alive() || controller.signal.aborted) return;
+      setPhase({
+        kind: "error",
+        fileName: savedName ?? "",
+        message: errorMessage(err),
+        retryable: false
+      });
+    });
+    return () => controller.abort();
+  }, [api, submissionId, savedId, savedName, pollIntervalMs]);
+  async function start(file) {
+    const current = ++attempt.current;
+    const alive = () => mounted.current && current === attempt.current;
+    lastFile.current = file;
+    const check = checkFileBeforeUpload(file);
+    if (!check.ok) {
+      setPhase({ kind: "error", fileName: file.name, message: check.reason, retryable: false });
+      return;
+    }
+    onChangeRef.current(void 0);
+    setPhase({ kind: "uploading", fileName: file.name, fraction: 0 });
+    try {
+      const ticket = await api.documents.create({
+        fileName: file.name,
+        contentType: file.type,
+        sizeBytes: file.size,
+        submissionId,
+        fieldKey: field.key
+      });
+      if (!alive()) return;
+      await upload(ticket, file, {
+        onProgress: (fraction) => {
+          if (alive()) setPhase({ kind: "uploading", fileName: file.name, fraction });
+        }
+      });
+      if (!alive()) return;
+      setPhase({ kind: "scanning", fileName: file.name });
+      let document = await api.documents.finalize(ticket.documentId, { submissionId });
+      if (!alive()) return;
+      if (!isTerminalDocumentStatus(document.status)) {
+        document = await pollDocument(api, ticket.documentId, {
+          submissionId,
+          intervalMs: pollIntervalMs
+        });
+        if (!alive()) return;
+      }
+      const next = phaseFor(document, file.name);
+      setPhase(next);
+      if (next.kind === "clean") {
+        resolvedId.current = document.id;
+        onChangeRef.current({ fileId: document.id, name: file.name });
+      }
+    } catch (err) {
+      if (!alive()) return;
+      setPhase({ kind: "error", fileName: file.name, message: errorMessage(err), retryable: true });
+    }
+  }
+  function onPick(event) {
+    const file = event.target.files?.[0];
+    event.target.value = "";
+    if (file) void start(file);
+  }
+  const busy = phase.kind === "uploading" || phase.kind === "scanning" || phase.kind === "loading";
+  const retry = /* @__PURE__ */ jsx(
+    "button",
+    {
+      type: "button",
+      className: "secondary inline",
+      onClick: () => {
+        if (lastFile.current) void start(lastFile.current);
+      },
+      children: "Retry"
+    }
+  );
+  return /* @__PURE__ */ jsxs("div", { className: "file-field", children: [
+    /* @__PURE__ */ jsx(
+      "input",
+      {
+        ref: inputRef,
+        id,
+        type: "file",
+        accept: ACCEPT,
+        disabled: busy || disabled,
+        onChange: onPick
+      }
+    ),
+    phase.kind === "uploading" && /* @__PURE__ */ jsxs(Fragment, { children: [
+      /* @__PURE__ */ jsx("progress", { value: phase.fraction, max: 1, "aria-label": `Uploading ${phase.fileName}` }),
+      /* @__PURE__ */ jsxs("p", { className: "file-status", role: "status", children: [
+        "Uploading ",
+        phase.fileName,
+        "\u2026 ",
+        Math.round(phase.fraction * 100),
+        "%"
+      ] })
+    ] }),
+    phase.kind === "loading" && /* @__PURE__ */ jsxs("p", { className: "file-status muted", role: "status", children: [
+      "Checking ",
+      phase.fileName ?? "the saved file",
+      "\u2026"
+    ] }),
+    phase.kind === "scanning" && /* @__PURE__ */ jsxs("p", { className: "file-status muted", role: "status", children: [
+      "Scanning ",
+      phase.fileName,
+      "\u2026"
+    ] }),
+    phase.kind === "clean" && /* @__PURE__ */ jsxs("p", { className: "file-status ok", role: "status", children: [
+      /* @__PURE__ */ jsxs("span", { children: [
+        phase.fileName,
+        " uploaded and checked."
+      ] }),
+      /* @__PURE__ */ jsx(
+        "button",
+        {
+          type: "button",
+          className: "secondary inline",
+          onClick: () => inputRef.current?.click(),
+          children: "Replace"
+        }
+      )
+    ] }),
+    phase.kind === "rejected" && /* @__PURE__ */ jsxs("p", { className: "file-status bad", role: "status", children: [
+      /* @__PURE__ */ jsxs("span", { children: [
+        phase.fileName,
+        " was rejected: ",
+        phase.reason
+      ] }),
+      retry
+    ] }),
+    phase.kind === "infected" && /* @__PURE__ */ jsxs("p", { className: "file-status bad", role: "status", children: [
+      phase.fileName,
+      " failed the malware scan. Please choose another file."
+    ] }),
+    phase.kind === "error" && /* @__PURE__ */ jsxs("p", { className: "file-status bad", role: "status", children: [
+      /* @__PURE__ */ jsx("span", { children: phase.message }),
+      phase.retryable && retry
+    ] })
+  ] });
+}
+
+// src/FieldInput.tsx
+import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
+function normalise(field, raw) {
+  if (raw === "" && field.type !== "text") return void 0;
+  return raw;
+}
+function Control({ field, value, onChange, readOnly, id }) {
+  const scope = useContext2(SubmissionScopeContext);
+  const text = typeof value === "string" || typeof value === "number" ? String(value) : "";
+  switch (field.type) {
+    case "text":
+    case "email":
+    case "number":
+    case "date":
+      return /* @__PURE__ */ jsx2(
+        "input",
+        {
+          id,
+          type: field.type,
+          value: text,
+          placeholder: field.placeholder,
+          min: field.type === "number" ? field.validation?.min : void 0,
+          max: field.type === "number" ? field.validation?.max : void 0,
+          disabled: readOnly,
+          onChange: (e) => onChange(normalise(field, e.target.value))
+        }
+      );
+    case "select":
+      return /* @__PURE__ */ jsxs2(
+        "select",
+        {
+          id,
+          value: text,
+          disabled: readOnly,
+          onChange: (e) => onChange(normalise(field, e.target.value)),
+          children: [
+            /* @__PURE__ */ jsx2("option", { value: "", children: "Select\u2026" }),
+            (field.options ?? []).map((o) => /* @__PURE__ */ jsx2("option", { value: o.value, children: o.label }, o.value))
+          ]
+        }
+      );
+    case "boolean":
+      return /* @__PURE__ */ jsx2(
+        "input",
+        {
+          id,
+          type: "checkbox",
+          checked: value === true,
+          disabled: readOnly,
+          onChange: (e) => onChange(e.target.checked)
+        }
+      );
+    case "file":
+      if (!scope) {
+        return /* @__PURE__ */ jsxs2("div", { className: "file-field", children: [
+          /* @__PURE__ */ jsx2("input", { id, type: "file", disabled: true }),
+          /* @__PURE__ */ jsx2("p", { className: "file-status muted", children: "File upload needs a submission" })
+        ] });
+      }
+      return /* @__PURE__ */ jsx2(FileField, { id, field, value, onChange, disabled: readOnly });
+  }
+}
+function FieldInput(props) {
+  const { field, error } = props;
+  const id = `field-${field.key}`;
+  return /* @__PURE__ */ jsxs2("div", { className: "field", children: [
+    /* @__PURE__ */ jsxs2("label", { htmlFor: id, children: [
+      field.label,
+      field.required && " *"
+    ] }),
+    /* @__PURE__ */ jsx2(Control, { ...props, id }),
+    field.help && /* @__PURE__ */ jsx2("small", { children: field.help }),
+    error && /* @__PURE__ */ jsx2("span", { className: "error", children: error })
+  ] });
+}
+
+// src/StepForm.tsx
+import { visibleFields } from "@aletheia-dev/collection-flow";
+import { Fragment as Fragment2, jsx as jsx3 } from "react/jsx-runtime";
+function StepForm({ step, value, onChange, errors, readOnly }) {
+  return /* @__PURE__ */ jsx3(Fragment2, { children: visibleFields(step, value).map((field) => /* @__PURE__ */ jsx3(
+    FieldInput,
+    {
+      field,
+      value: value[field.key],
+      error: errors?.[field.key],
+      readOnly,
+      onChange: (next) => onChange(field.key, next)
+    },
+    field.key
+  )) });
+}
+
+// src/StepPreview.tsx
+import { buildZodForStep } from "@aletheia-dev/collection-flow";
+import { useState as useState2 } from "react";
+import { jsx as jsx4, jsxs as jsxs3 } from "react/jsx-runtime";
+function validate(step, data) {
+  try {
+    const parsed = buildZodForStep(step, data).safeParse(data);
+    if (parsed.success) return { kind: "valid" };
+    return {
+      kind: "invalid",
+      issues: parsed.error.issues.map((issue) => {
+        const path = issue.path.map(String).join(".");
+        const missing = issue.code === "invalid_type" && data[path] === void 0;
+        return { path, message: missing ? "This field is required" : issue.message };
+      })
+    };
+  } catch (err) {
+    return { kind: "broken", message: err instanceof Error ? err.message : String(err) };
+  }
+}
+function StepPreview({ step, initialData }) {
+  const [data, setData] = useState2(() => ({ ...initialData }));
+  const [result, setResult] = useState2();
+  const errors = {};
+  if (result?.kind === "invalid") {
+    for (const issue of result.issues) {
+      const key = issue.path.split(".")[0] ?? "";
+      if (!(key in errors)) errors[key] = issue.message;
+    }
+  }
+  return /* @__PURE__ */ jsxs3("div", { className: "step-preview", children: [
+    /* @__PURE__ */ jsx4("h3", { children: step.title }),
+    step.description && /* @__PURE__ */ jsx4("p", { className: "muted", children: step.description }),
+    /* @__PURE__ */ jsxs3(
+      "form",
+      {
+        className: "form",
+        onSubmit: (e) => {
+          e.preventDefault();
+          setResult(validate(step, data));
+        },
+        children: [
+          /* @__PURE__ */ jsx4(
+            StepForm,
+            {
+              step,
+              value: data,
+              errors,
+              onChange: (key, value) => {
+                setData((d) => ({ ...d, [key]: value }));
+                setResult(void 0);
+              }
+            }
+          ),
+          /* @__PURE__ */ jsx4("div", { className: "actions", children: /* @__PURE__ */ jsx4("button", { type: "submit", children: "Validate" }) })
+        ]
+      }
+    ),
+    result?.kind === "valid" && /* @__PURE__ */ jsx4("p", { className: "preview-result ok", role: "status", children: "Valid: this step would pass." }),
+    result?.kind === "invalid" && /* @__PURE__ */ jsxs3("div", { className: "preview-result bad", role: "status", children: [
+      /* @__PURE__ */ jsxs3("p", { children: [
+        result.issues.length,
+        " issue",
+        result.issues.length === 1 ? "" : "s",
+        ":"
+      ] }),
+      /* @__PURE__ */ jsx4("ul", { children: result.issues.map((issue, i) => /* @__PURE__ */ jsxs3("li", { children: [
+        /* @__PURE__ */ jsx4("code", { children: issue.path || "(step)" }),
+        ": ",
+        issue.message
+      ] }, `${issue.path}-${i}`)) })
+    ] }),
+    result?.kind === "broken" && /* @__PURE__ */ jsxs3("p", { className: "preview-result bad", role: "status", children: [
+      "This step cannot be validated: ",
+      result.message
+    ] })
+  ] });
+}
+export {
+  FieldInput,
+  FileField,
+  StepForm,
+  StepPreview,
+  SubmissionScopeContext,
+  useSubmissionScope
+};
+//# sourceMappingURL=index.js.map