@marktiderman/genesis-forms 0.4.1 → 0.5.0

package/dist/{engine-Dz9J5ej2.d.ts → engine-BDq0XJ21.d.cts}

@@ -1,5 +1,5 @@
-import { e as FormEvent, J as Json, F as FormDefinition, a as FieldBlock, B as Block } from './types-BBKBQ8sp.js';
-import { F as FieldValidator } from './validate-BjNwF1UE.js';
+import { e as FormEvent, J as Json, F as FormDefinition, a as FieldBlock, B as Block } from './types-BhYUbLJ-.cjs';
+import { F as FieldValidator, H as HostOptions } from './validate-BsZ0YTQS.cjs';
 
 /** Guards and helpers for event logs and other untrusted JSON. No dependencies. */
 
@@ -29,6 +29,11 @@ interface FormState {
     current: string | null;
     /** Visited blocks, for Back. */
     history: string[];
+    /**
+     * The furthest block reached by moving on (`next`), kept after going back;
+     * the first block until then. `formProgress` reads it.
+     */
+    furthest: string | null;
     errors: Record<string, string>;
     status: "in_progress" | "completed";
     /** The ending reached once completed. */
@@ -43,8 +48,26 @@ interface CreateFormOptions {
     validators?: Record<string, FieldValidator> | undefined;
     /** Timestamps on events. Pass `() => undefined` to record none (anonymous forms). */
     clock?: (() => number | undefined) | undefined;
+    /**
+     * Pick up where the respondent was (with `initialValues` holding their saved
+     * answers): a block id, usually `formProgress`'s `fieldId` from an earlier
+     * visit. The form moves on from the first block with Next, as they did, until
+     * it reaches this one, so Back still walks their path; it stops early at a
+     * step that no longer passes (a question since made required), and does
+     * nothing when the block isn't on the path.
+     */
+    resumeAt?: string | null | undefined;
+    /**
+     * The option lists this app supplies, by key, for choice fields with
+     * `props.optionsFrom: { source: "host", key }` (see `withHostOptions`).
+     * `engine.definition` is the definition with them filled in, so renderers
+     * show them and validation accepts only them (and the field's own options).
+     * Pass the same lists to `validateSubmission` on the server.
+     */
+    hostOptions?: HostOptions | undefined;
 }
 interface FormEngine {
+    /** The definition being filled in, with `hostOptions` filled in (`withHostOptions`). */
     readonly definition: FormDefinition;
     getState(): FormState;
     subscribe(listener: () => void): () => void;

package/dist/{engine-BkNuzlna.d.cts → engine-Qzp6bX6O.d.ts}

@@ -1,5 +1,5 @@
-import { e as FormEvent, J as Json, F as FormDefinition, a as FieldBlock, B as Block } from './types-BBKBQ8sp.cjs';
-import { F as FieldValidator } from './validate-BXXqi0fq.cjs';
+import { e as FormEvent, J as Json, F as FormDefinition, a as FieldBlock, B as Block } from './types-BhYUbLJ-.js';
+import { F as FieldValidator, H as HostOptions } from './validate-Bs1lyoOl.js';
 
 /** Guards and helpers for event logs and other untrusted JSON. No dependencies. */
 
@@ -29,6 +29,11 @@ interface FormState {
     current: string | null;
     /** Visited blocks, for Back. */
     history: string[];
+    /**
+     * The furthest block reached by moving on (`next`), kept after going back;
+     * the first block until then. `formProgress` reads it.
+     */
+    furthest: string | null;
     errors: Record<string, string>;
     status: "in_progress" | "completed";
     /** The ending reached once completed. */
@@ -43,8 +48,26 @@ interface CreateFormOptions {
     validators?: Record<string, FieldValidator> | undefined;
     /** Timestamps on events. Pass `() => undefined` to record none (anonymous forms). */
     clock?: (() => number | undefined) | undefined;
+    /**
+     * Pick up where the respondent was (with `initialValues` holding their saved
+     * answers): a block id, usually `formProgress`'s `fieldId` from an earlier
+     * visit. The form moves on from the first block with Next, as they did, until
+     * it reaches this one, so Back still walks their path; it stops early at a
+     * step that no longer passes (a question since made required), and does
+     * nothing when the block isn't on the path.
+     */
+    resumeAt?: string | null | undefined;
+    /**
+     * The option lists this app supplies, by key, for choice fields with
+     * `props.optionsFrom: { source: "host", key }` (see `withHostOptions`).
+     * `engine.definition` is the definition with them filled in, so renderers
+     * show them and validation accepts only them (and the field's own options).
+     * Pass the same lists to `validateSubmission` on the server.
+     */
+    hostOptions?: HostOptions | undefined;
 }
 interface FormEngine {
+    /** The definition being filled in, with `hostOptions` filled in (`withHostOptions`). */
     readonly definition: FormDefinition;
     getState(): FormState;
     subscribe(listener: () => void): () => void;