@marktiderman/genesis-forms 0.7.0 → 0.9.0

package/dist/index.d.cts

@@ -1,11 +1,11 @@
-import { a as FieldBlock, C as ContentBlock, P as PageBreakBlock, O as OptionsSource, F as FormDefinition, H as HiddenInput, b as FormLayout, L as LogicRule, E as Ending, c as FormSettings, J as Json, d as Condition, B as Block } from './types-oAckGR_Z.cjs';
-export { e as FormEvent, f as Operand, g as Operator } from './types-oAckGR_Z.cjs';
-import { P as PhotoFormat, a as PhotoRef } from './upload-protocol-Bw0CWRJc.cjs';
-export { D as DEFAULT_PHOTO_FILES, b as DEFAULT_PHOTO_SIZE_MB, M as MAX_PHOTO_FILES, c as MAX_PHOTO_ID_LENGTH, d as MAX_PHOTO_NAME_LENGTH, e as MAX_PHOTO_SIZE_MB, f as MAX_UPLOAD_REQUEST_BYTES, g as PHOTO_FORMATS, h as PHOTO_TYPE, i as PhotoLimits, S as SignedUpload, U as UPLOAD_FIELD_TYPES, j as UploadGrant, k as UploadRefusal, l as UploadRequest, m as isPhotoFormat, n as isPhotoRef, p as photoCountMessage, o as photoFormatList, q as photoLimits, r as photoRefs, s as photoSizeMessage, t as photoTypeMessage } from './upload-protocol-Bw0CWRJc.cjs';
-import { F as FormEngine, a as FormState } from './engine-C5tb3mkf.cjs';
-export { C as CreateFormOptions, c as createForm, i as isFormEvent, b as isJson, r as replay } from './engine-C5tb3mkf.cjs';
-import { F as FieldValidator } from './validate-BFpNJbjf.cjs';
-export { A as AnswerSnapshot, C as CHOICE_FIELD_TYPES, a as ChoiceOption, b as FieldTypeManifest, H as HostOptions, L as LinkParams, M as MAX_PREFILL_PARAM_LENGTH, O as OPTION_LIMITS, c as OTHER_MAX_LENGTH, d as OptionSnapshot, P as PrefillSetting, e as PrefillState, R as REQUIRED_MESSAGE, f as RestoredAnswers, S as SEARCHABLE_OPTION_COUNT, g as StandardSchemaV1, h as answerSnapshots, i as answersFromSnapshots, j as answersOnPath, k as choiceOptions, l as clearFilteredAnswers, m as dateLimits, n as filteredChoiceError, o as getFieldType, p as hasOptionFilters, q as hiddenByPrefill, r as isEmptyValue, s as isHttpsUrl, t as isIsoDate, u as isOtherValue, v as isPrefillParam, w as isSearchable, x as isSensitive, y as listFieldTypes, z as normalizeValue, B as numberLimits, D as optionFilter, E as optionJson, G as optionMatches, I as optionsSource, J as otherOption, K as prefillFromLink, N as prefillSetting, Q as ratingDisplay, T as readOption, U as registerFieldType, V as respondentPath, W as scaleLabels, X as searchOptions, Y as summarizeValue, Z as validateField, _ as visibleOptions, $ as withHostOptions } from './validate-BFpNJbjf.cjs';
+import { a as FieldBlock, b as ContentBlock, P as PageBreakBlock, O as OptionsSource, F as FormDefinition, H as HiddenInput, c as FormLayout, L as LogicRule, E as Ending, d as FormSettings, J as Json, C as Condition, B as Block } from './types-C0pUfew3.cjs';
+export { e as FormEvent, f as Operand, g as Operator } from './types-C0pUfew3.cjs';
+import { P as PhotoFormat, a as PhotoRef, S as SubmissionInput, b as SubmitRequest, c as SubmitFailureReason, d as SubmitResult } from './submit-protocol-D0cOckmK.cjs';
+export { D as DEFAULT_PHOTO_FILES, e as DEFAULT_PHOTO_SIZE_MB, I as IDEMPOTENCY_KEY_PATTERN, M as MAX_PHOTO_FILES, f as MAX_PHOTO_ID_LENGTH, g as MAX_PHOTO_NAME_LENGTH, h as MAX_PHOTO_SIZE_MB, i as MAX_UPLOAD_REQUEST_BYTES, j as MergeOptions, k as PHOTO_FORMATS, l as PHOTO_TYPE, m as PhotoLimits, n as SignedUpload, o as SubmitOutcome, U as UPLOAD_FIELD_TYPES, p as UploadGrant, q as UploadRefusal, r as UploadRequest, s as isIdempotencyKey, t as isPhotoFormat, u as isPhotoRef, v as isSubmitResult, w as mergeResponses, x as photoCountMessage, y as photoFormatList, z as photoLimits, A as photoRefs, B as photoSizeMessage, C as photoTypeMessage, E as submitOutcome } from './submit-protocol-D0cOckmK.cjs';
+import { F as FormEngine, a as FormState } from './engine-BaHPC2-1.cjs';
+export { C as CreateFormOptions, c as createForm, i as isFormEvent, b as isJson, r as replay } from './engine-BaHPC2-1.cjs';
+import { F as FieldValidator } from './validate-U5LoW3eR.cjs';
+export { A as AnswerSnapshot, C as CHOICE_FIELD_TYPES, a as ChoiceOption, b as ContentTypeManifest, c as FieldTypeManifest, H as HostOptions, L as LinkParams, d as LiteralType, M as MAX_PREFILL_PARAM_LENGTH, O as OPTION_LIMITS, e as OTHER_MAX_LENGTH, f as OptionSnapshot, P as PrefillSetting, g as PrefillState, h as PropsCheck, i as PropsChecker, R as REQUIRED_MESSAGE, j as RegisterOptions, k as RestoredAnswers, S as SEARCHABLE_OPTION_COUNT, l as StandardSchemaV1, V as VALIDATOR_FAILED_MESSAGE, m as answerSnapshots, n as answersFromSnapshots, o as answersOnPath, p as choiceKind, q as choiceOptions, r as clearFilteredAnswers, s as contentText, t as dateLimits, u as filteredChoiceError, v as getContentType, w as getFieldType, x as hasOptionFilters, y as hiddenByPrefill, z as isBuiltInFieldType, B as isChoiceField, D as isEmptyValue, E as isHttpsUrl, G as isIsoDate, I as isOtherValue, J as isPrefillParam, K as isSearchable, N as isSensitive, Q as listContentTypes, T as listFieldTypes, U as normalizeValue, W as numberLimits, X as optionFilter, Y as optionJson, Z as optionMatches, _ as optionsSource, $ as otherOption, a0 as prefillFromLink, a1 as prefillSetting, a2 as ratingDisplay, a3 as readOption, a4 as registerContentType, a5 as registerFieldType, a6 as respondentPath, a7 as scaleLabels, a8 as searchOptions, a9 as summarizeValue, aa as validateField, ab as visibleOptions, ac as withHostOptions } from './validate-U5LoW3eR.cjs';
 
 /** A field block that remembers its key and value type, for answer inference. */
 type FieldSpec<K extends string = string, V = unknown> = FieldBlock & {
@@ -300,8 +300,9 @@ type ParseResult = {
 /**
  * Check a definition before it is stored or rendered: structure, the types of
  * text fields, unique ids and keys, known field types, references that
- * resolve, operators that fit the field type. Warnings flag things that work
- * but are probably mistakes. Never throws, whatever the input.
+ * resolve, operators that fit the field type. Each field and content kind
+ * checks its own `props` (`checkProps` in the registry). Warnings flag things
+ * that work but are probably mistakes. Never throws, whatever the input.
  */
 declare function parseForm(input: unknown): ParseResult;
 
@@ -686,4 +687,280 @@ declare function describeCondition(condition: Condition, def: FormDefinition, fi
  */
 declare function carryAnswers(from: FormDefinition, to: FormDefinition, answers: Record<string, Json>, extra?: Record<string, Json | null | undefined>): Record<string, Json>;
 
-export { type AnswersOf, Block, CALCULATED_TYPE, COMPUTED_FIELD_TYPES, type CalculatedFormat, type CalculatedProps, type ChoiceFieldOptions, type CoerceHiddenOptions, type CoercedHidden, Condition, ContentBlock, Ending, type ExplainInput, type ExplainOptions, type Explanation, FORMULA_FUNCTIONS, FieldBlock, type FieldOptions, type FieldSpec, type FieldValidation, FieldValidator, type Form, FormDefinition, FormEngine, type FormInput, type FormIssue, FormLayout, type FormProgress, FormSettings, FormState, type FormulaFunction, type FormulaNode, type FormulaParseResult, type FormulaReader, type FormulaRef, type FormulaValue, HIGHLIGHT_NOTE_MESSAGE, HiddenInput, type Highlight, Json, type JumpTrace, type KeyResolver, LogicRule, MAX_CALCULATED_DECIMALS, MAX_FORMULA_ITEMS, MAX_FORMULA_LENGTH, MAX_FORM_FORMULA_LENGTH, MAX_HIDDEN_STRING_LENGTH, MAX_HIGHLIGHT_NOTE_LENGTH, MAX_HIGHLIGHT_QUOTE_LENGTH, MAX_SETTLE_ITEMS, MAX_TABLE_CELL_LENGTH, MAX_TABLE_COLUMNS, MAX_TIMESTAMP_SECONDS, type MediaNote, OptionsSource, PageBreakBlock, type ParseResult, type PathResult, PhotoFormat, PhotoRef, type RuleSpec, type RuleTrace, STRUCTURED_FIELD_TYPES, type TableColumn, calculatedProps, calculatedValue, canonicalJson, carryAnswers, coerceHidden, coerceHiddenValue, computePath, defineForm, describeCondition, evaluate, evaluateFormula, explain, f, fingerprint, formProgress, formatCalculated, formatTimestamp, formulaInput, formulaNumber, formulaRefs, furthestReached, listLimits, parseForm, parseFormula, parseTimestamp, recall, renameFormulaKey, ruleVisible, steps, tableColumns, tableLimits, when };
+/**
+ * The key-value storage drafts and the submit outbox keep their data in. One small shape
+ * that `localStorage` (web) and React Native's AsyncStorage both are already; MMKV and
+ * others take a three-line wrapper:
+ *
+ * ```ts
+ * const storage: KeyValueStorage = {
+ *   getItem: (key) => mmkv.getString(key) ?? null,
+ *   setItem: (key, value) => mmkv.set(key, value),
+ *   removeItem: (key) => mmkv.delete(key),
+ * };
+ * ```
+ */
+type MaybePromise<T> = T | Promise<T>;
+/** Strings by key, kept across restarts. Each method may answer at once or with a promise; a throw (or a rejection) is a failure the caller reports. */
+interface KeyValueStorage {
+    getItem(key: string): MaybePromise<string | null | undefined>;
+    setItem(key: string, value: string): MaybePromise<void>;
+    removeItem(key: string): MaybePromise<void>;
+}
+/** Storage that lasts as long as the page or app does: for tests, and where nothing may be kept on the device. */
+declare function memoryStorage(): KeyValueStorage & {
+    keys(): string[];
+};
+/**
+ * The browser's `localStorage` (or another `Storage`, such as `sessionStorage`), looked up on
+ * each call, so creating it during server rendering is safe. Where there is none (a server, a
+ * locked-down private window) every call throws, and the caller reports it.
+ */
+declare function webStorage(storage?: () => Pick<Storage, "getItem" | "setItem" | "removeItem"> | undefined): KeyValueStorage;
+
+/** Whose draft of which form, at which version of it. */
+interface DraftKey {
+    formId: string;
+    /** The definition's version (a published version label, or `fingerprint(definition)`). */
+    version: string;
+    /** Who is answering: a user id, or a session id made once on this device for anonymous visits. */
+    respondent: string;
+}
+/** A saved draft. Plain JSON. */
+interface FormDraft extends DraftKey {
+    /** The answers given, by field id, including ones logic hides now (so going back keeps them). Calculated fields are left out. */
+    values: Record<string, Json>;
+    /** Each saved field's type when it was saved, by field id, to tell whether the form still fits. */
+    types: Record<string, string>;
+    /** The furthest question reached (`formProgress(engine).fieldId`): `createForm`'s `resumeAt`. */
+    resumeAt: string | null;
+    /** When it was saved, in milliseconds since 1970. */
+    savedAt: number;
+}
+/** Where drafts are kept. One draft per form and respondent: saving another version replaces it. */
+interface DraftStore {
+    /** The draft of this form by this respondent, of any version, or null. */
+    get(key: DraftKey): MaybePromise<FormDraft | null>;
+    set(draft: FormDraft): MaybePromise<void>;
+    remove(key: DraftKey): MaybePromise<void>;
+}
+declare const DRAFT_KEY_PREFIX = "genesis-forms:draft:";
+/**
+ * A `DraftStore` over key-value storage, one entry per form and respondent (the version is
+ * inside it, so a new version finds the old draft and `restoreDraft` decides whether it still
+ * fits). A stored entry that doesn't read as a draft is answered null.
+ */
+declare function createDraftStore(storage: KeyValueStorage, options?: {
+    prefix?: string | undefined;
+}): DraftStore;
+interface DraftOptions {
+    /**
+     * Keep answers to sensitive fields (`isSensitive`) in the draft. Default false: they are
+     * left out, so a health detail or an ID number never sits in the device's storage, and the
+     * respondent answers them again after a restore.
+     */
+    keepSensitive?: boolean | undefined;
+}
+/** The engine's answers so far as a draft (null when nothing is answered). */
+declare function draftOf(engine: Pick<FormEngine, "definition" | "getState">, key: DraftKey, options?: DraftOptions & {
+    now?: (() => number) | undefined;
+}): FormDraft | null;
+/** 30 days: the default for how long a draft is kept. */
+declare const DRAFT_MAX_AGE_MS: number;
+type DraftRestore = {
+    ok: true;
+    /** For `createForm`'s `initialValues` (over the host's own prefill). */
+    values: Record<string, Json>;
+    /** For `createForm`'s `resumeAt`. */
+    resumeAt: string | null;
+} | {
+    ok: false;
+    /**
+     * `version`: the form changed and an answer no longer fits (its question is gone, has
+     * another type, or the answer isn't valid for it now). `expired`: older than `maxAgeMs`.
+     */
+    reason: "version" | "expired";
+};
+/**
+ * Whether a saved draft can be put back into this definition. The same version: yes. Another
+ * version: only when every saved answer still fits (its question is there, of the same type,
+ * and the answer passes its format checks); otherwise the whole draft is refused, never half
+ * put back. Pass the definition with the host's options filled in (`engine.definition`, or
+ * `withHostOptions`), so a picked option that's gone counts.
+ */
+declare function restoreDraft(definition: FormDefinition, draft: FormDraft, options: {
+    version: string;
+    now?: (() => number) | undefined;
+    maxAgeMs?: number | undefined;
+}): DraftRestore;
+interface DraftAutosaveOptions extends DraftOptions {
+    /** How long the respondent pauses before the draft is saved, in milliseconds. Default 800. */
+    delayMs?: number | undefined;
+    now?: (() => number) | undefined;
+    /** A save or removal that failed (storage full, unavailable). Default `console.warn`. Autosave never throws. */
+    onError?: ((error: unknown) => void) | undefined;
+    /** Each save that landed, with its time. */
+    onSaved?: ((draft: FormDraft) => void) | undefined;
+    /**
+     * A draft is stored for this key already (it was just restored). Answers cleared to nothing
+     * remove a stored draft; without this, only one this autosave wrote. Default false, so a
+     * draft that couldn't be read is never removed before the respondent answers anything.
+     */
+    stored?: boolean | undefined;
+}
+interface DraftAutosave {
+    /** Save now whatever is waiting. Resolves when it is written (or failed, through `onError`). */
+    flush(): Promise<void>;
+    /**
+     * Stop saving and remove the draft: call it once the submission is safe (queued in the
+     * outbox, or stored). Nothing waiting is written after it.
+     */
+    clear(): Promise<void>;
+    /** Stop listening. Whatever is waiting is saved first (`flush`). */
+    dispose(): Promise<void>;
+}
+/**
+ * Save the engine's answers to `store` as they change, `delayMs` after the last change, one
+ * write at a time and in order. Answers cleared to nothing remove the draft (one this
+ * autosave wrote, or the one restored: `stored`), so an emptied form doesn't come back filled.
+ */
+declare function createDraftAutosave(engine: Pick<FormEngine, "definition" | "getState" | "subscribe">, store: DraftStore, key: DraftKey, options?: DraftAutosaveOptions): DraftAutosave;
+
+/**
+ * The submit outbox: submissions wait on the device until the server has them. Each is
+ * queued with an idempotency key (so a retry is stored once), kept in storage across
+ * restarts, sent when online with backoff between tries, and never dropped silently: one the
+ * server refuses, or that runs out of tries, stays as `failed` until the respondent retries
+ * or discards it.
+ *
+ * Transport-agnostic: `send` is the app's, typically a `fetch` to its endpoint that runs
+ * `submitResponse` and answers its `SubmitResult` as JSON.
+ */
+
+/** One queued submission, as stored. Plain JSON. */
+interface OutboxEntry {
+    /** The submission's idempotency key. */
+    id: string;
+    /** Which form it is for: `send` picks the endpoint by it. */
+    formId: string;
+    /** The body sent, every time the same. */
+    request: SubmitRequest;
+    /** The app's own details to show in a list (a form's title), never sent. */
+    meta: Record<string, Json> | null;
+    createdAt: number;
+    /** Tries so far (since the last `retry`). */
+    attempts: number;
+    /** When it may be tried next. */
+    nextAttemptAt: number;
+    /** `pending`: will be sent. `failed`: refused, or out of tries; waits for `retry` or `discard`. */
+    state: "pending" | "failed";
+    /** Why the last try didn't deliver it, for the respondent or a log. Never holds an answer. */
+    lastError: string | null;
+    /** When the server refused it (`invalid` or `closed`), what it said. */
+    rejection: {
+        reason: SubmitFailureReason;
+        errors?: Record<string, string>;
+    } | null;
+}
+/** A queued submission as the outbox shows it. */
+interface OutboxItem extends OutboxEntry {
+    /** Being sent now. */
+    sending: boolean;
+}
+interface OutboxSnapshot {
+    /** Whether what was stored has been read. Until then `items` may be missing some. */
+    loaded: boolean;
+    online: boolean;
+    /** Oldest first. */
+    items: readonly OutboxItem[];
+    pending: number;
+    failed: number;
+    /** Reading or writing the storage failed; null once it works again. */
+    storageError: string | null;
+    /** Stored submissions that couldn't be read back, by id: left in storage, never sent or removed. */
+    unreadable: readonly string[];
+}
+interface EnqueueInput {
+    formId: string;
+    submission: SubmissionInput;
+    /** Default: a new UUID. Pass the same key again and the queued submission is returned, not queued twice. */
+    idempotencyKey?: string | undefined;
+    /** Default: now. */
+    clientSubmittedAt?: number | undefined;
+    /** The visit's attempt id, for a form with upload fields (`SubmitRequest.attemptId`). */
+    attemptId?: string | undefined;
+    meta?: Record<string, Json> | undefined;
+}
+interface SubmitOutboxOptions {
+    storage: KeyValueStorage;
+    /**
+     * Send one submission and answer what the server said: its `SubmitResult` (an endpoint's
+     * JSON body, whatever its status code). Throw, or answer anything else, and it is tried
+     * again later. Abort on `signal` (sent after `timeoutMs`).
+     */
+    send(item: OutboxItem, context: {
+        signal: AbortSignal;
+    }): Promise<unknown>;
+    /** Milliseconds since 1970. Default `Date.now`. */
+    now?: (() => number) | undefined;
+    /** Storage keys start with this. Default `genesis-forms:outbox`. One outbox per prefix. */
+    prefix?: string | undefined;
+    /**
+     * Tries before a submission is marked `failed` (it is kept). Default 10. A submission that
+     * ran out of tries (not one the server refused) is tried again from the start each time the
+     * outbox starts and each time the device comes back online.
+     */
+    maxAttempts?: number | undefined;
+    /** Wait before try n+1: about `baseMs * 2^(n-1)`, at most `maxMs`, with jitter. Default 2 seconds and 15 minutes. */
+    backoff?: {
+        baseMs?: number | undefined;
+        maxMs?: number | undefined;
+    } | undefined;
+    /** How long one send may take before it is aborted and tried again. Default 30 seconds. */
+    timeoutMs?: number | undefined;
+    /** Whether the device is online to begin with. Default true. Keep it current with `setOnline`. */
+    online?: boolean | undefined;
+    /**
+     * Makes idempotency keys. Default `crypto.randomUUID`; where there is none (React Native
+     * without a polyfill) pass one (expo-crypto's `randomUUID`), or `createSubmitOutbox` throws.
+     */
+    createKey?: (() => string) | undefined;
+    /** 0 to 1, for jitter. Default `Math.random`. */
+    random?: (() => number) | undefined;
+    /** A submission the server now has (stored now, or before: a duplicate). */
+    onDelivered?: ((item: OutboxItem, result: SubmitResult) => void) | undefined;
+    /** Something went wrong that the app may want to log. Default `console.warn`. */
+    log?: ((message: string) => void) | undefined;
+}
+interface SubmitOutbox {
+    /** Resolves once stored submissions are read (or reading failed: see `storageError`). Never rejects. */
+    readonly ready: Promise<void>;
+    /**
+     * Queue a submission. Resolves once it is in storage: only then is it safe to clear the
+     * draft. Rejects when storage can't take it (keep the draft, and tell the respondent).
+     * Sends it at once when the outbox is started and online.
+     */
+    enqueue(input: EnqueueInput): Promise<OutboxItem>;
+    /** Send every pending submission that is due, oldest first, one at a time. */
+    flush(): Promise<void>;
+    /** Try a failed submission again from its first try, now. */
+    retry(id: string): Promise<void>;
+    /** Remove a queued submission for good. False while it is being sent, or when it isn't there. */
+    discard(id: string): Promise<boolean>;
+    /** Tell the outbox whether the device is online. Coming online sends what's pending at once. */
+    setOnline(online: boolean): void;
+    /** Send as submissions come due (timers). `stop` ends it. */
+    start(): void;
+    stop(): void;
+    getSnapshot(): OutboxSnapshot;
+    subscribe(listener: () => void): () => void;
+}
+/**
+ * Each submission is stored under its own key, with an index of keys beside it. The index is
+ * read again and merged on every change, so two outboxes on one storage (two tabs) don't
+ * write each other's submissions out; both may send one, and its idempotency key makes the
+ * server store it once.
+ */
+declare function createSubmitOutbox(options: SubmitOutboxOptions): SubmitOutbox;
+
+export { type AnswersOf, Block, CALCULATED_TYPE, COMPUTED_FIELD_TYPES, type CalculatedFormat, type CalculatedProps, type ChoiceFieldOptions, type CoerceHiddenOptions, type CoercedHidden, Condition, ContentBlock, DRAFT_KEY_PREFIX, DRAFT_MAX_AGE_MS, type DraftAutosave, type DraftAutosaveOptions, type DraftKey, type DraftOptions, type DraftRestore, type DraftStore, Ending, type EnqueueInput, type ExplainInput, type ExplainOptions, type Explanation, FORMULA_FUNCTIONS, FieldBlock, type FieldOptions, type FieldSpec, type FieldValidation, FieldValidator, type Form, FormDefinition, type FormDraft, FormEngine, type FormInput, type FormIssue, FormLayout, type FormProgress, FormSettings, FormState, type FormulaFunction, type FormulaNode, type FormulaParseResult, type FormulaReader, type FormulaRef, type FormulaValue, HIGHLIGHT_NOTE_MESSAGE, HiddenInput, type Highlight, Json, type JumpTrace, type KeyResolver, type KeyValueStorage, LogicRule, MAX_CALCULATED_DECIMALS, MAX_FORMULA_ITEMS, MAX_FORMULA_LENGTH, MAX_FORM_FORMULA_LENGTH, MAX_HIDDEN_STRING_LENGTH, MAX_HIGHLIGHT_NOTE_LENGTH, MAX_HIGHLIGHT_QUOTE_LENGTH, MAX_SETTLE_ITEMS, MAX_TABLE_CELL_LENGTH, MAX_TABLE_COLUMNS, MAX_TIMESTAMP_SECONDS, type MaybePromise, type MediaNote, OptionsSource, type OutboxEntry, type OutboxItem, type OutboxSnapshot, PageBreakBlock, type ParseResult, type PathResult, PhotoFormat, PhotoRef, type RuleSpec, type RuleTrace, STRUCTURED_FIELD_TYPES, SubmitFailureReason, type SubmitOutbox, type SubmitOutboxOptions, SubmitRequest, SubmitResult, type TableColumn, calculatedProps, calculatedValue, canonicalJson, carryAnswers, coerceHidden, coerceHiddenValue, computePath, createDraftAutosave, createDraftStore, createSubmitOutbox, defineForm, describeCondition, draftOf, evaluate, evaluateFormula, explain, f, fingerprint, formProgress, formatCalculated, formatTimestamp, formulaInput, formulaNumber, formulaRefs, furthestReached, listLimits, memoryStorage, parseForm, parseFormula, parseTimestamp, recall, renameFormulaKey, restoreDraft, ruleVisible, steps, tableColumns, tableLimits, webStorage, when };

package/dist/index.d.ts

@@ -1,11 +1,11 @@
-import { a as FieldBlock, C as ContentBlock, P as PageBreakBlock, O as OptionsSource, F as FormDefinition, H as HiddenInput, b as FormLayout, L as LogicRule, E as Ending, c as FormSettings, J as Json, d as Condition, B as Block } from './types-oAckGR_Z.js';
-export { e as FormEvent, f as Operand, g as Operator } from './types-oAckGR_Z.js';
-import { P as PhotoFormat, a as PhotoRef } from './upload-protocol-PX0jroTV.js';
-export { D as DEFAULT_PHOTO_FILES, b as DEFAULT_PHOTO_SIZE_MB, M as MAX_PHOTO_FILES, c as MAX_PHOTO_ID_LENGTH, d as MAX_PHOTO_NAME_LENGTH, e as MAX_PHOTO_SIZE_MB, f as MAX_UPLOAD_REQUEST_BYTES, g as PHOTO_FORMATS, h as PHOTO_TYPE, i as PhotoLimits, S as SignedUpload, U as UPLOAD_FIELD_TYPES, j as UploadGrant, k as UploadRefusal, l as UploadRequest, m as isPhotoFormat, n as isPhotoRef, p as photoCountMessage, o as photoFormatList, q as photoLimits, r as photoRefs, s as photoSizeMessage, t as photoTypeMessage } from './upload-protocol-PX0jroTV.js';
-import { F as FormEngine, a as FormState } from './engine-DcNQ-6oJ.js';
-export { C as CreateFormOptions, c as createForm, i as isFormEvent, b as isJson, r as replay } from './engine-DcNQ-6oJ.js';
-import { F as FieldValidator } from './validate-qwkdcr3H.js';
-export { A as AnswerSnapshot, C as CHOICE_FIELD_TYPES, a as ChoiceOption, b as FieldTypeManifest, H as HostOptions, L as LinkParams, M as MAX_PREFILL_PARAM_LENGTH, O as OPTION_LIMITS, c as OTHER_MAX_LENGTH, d as OptionSnapshot, P as PrefillSetting, e as PrefillState, R as REQUIRED_MESSAGE, f as RestoredAnswers, S as SEARCHABLE_OPTION_COUNT, g as StandardSchemaV1, h as answerSnapshots, i as answersFromSnapshots, j as answersOnPath, k as choiceOptions, l as clearFilteredAnswers, m as dateLimits, n as filteredChoiceError, o as getFieldType, p as hasOptionFilters, q as hiddenByPrefill, r as isEmptyValue, s as isHttpsUrl, t as isIsoDate, u as isOtherValue, v as isPrefillParam, w as isSearchable, x as isSensitive, y as listFieldTypes, z as normalizeValue, B as numberLimits, D as optionFilter, E as optionJson, G as optionMatches, I as optionsSource, J as otherOption, K as prefillFromLink, N as prefillSetting, Q as ratingDisplay, T as readOption, U as registerFieldType, V as respondentPath, W as scaleLabels, X as searchOptions, Y as summarizeValue, Z as validateField, _ as visibleOptions, $ as withHostOptions } from './validate-qwkdcr3H.js';
+import { a as FieldBlock, b as ContentBlock, P as PageBreakBlock, O as OptionsSource, F as FormDefinition, H as HiddenInput, c as FormLayout, L as LogicRule, E as Ending, d as FormSettings, J as Json, C as Condition, B as Block } from './types-C0pUfew3.js';
+export { e as FormEvent, f as Operand, g as Operator } from './types-C0pUfew3.js';
+import { P as PhotoFormat, a as PhotoRef, S as SubmissionInput, b as SubmitRequest, c as SubmitFailureReason, d as SubmitResult } from './submit-protocol-CFi-0Qd0.js';
+export { D as DEFAULT_PHOTO_FILES, e as DEFAULT_PHOTO_SIZE_MB, I as IDEMPOTENCY_KEY_PATTERN, M as MAX_PHOTO_FILES, f as MAX_PHOTO_ID_LENGTH, g as MAX_PHOTO_NAME_LENGTH, h as MAX_PHOTO_SIZE_MB, i as MAX_UPLOAD_REQUEST_BYTES, j as MergeOptions, k as PHOTO_FORMATS, l as PHOTO_TYPE, m as PhotoLimits, n as SignedUpload, o as SubmitOutcome, U as UPLOAD_FIELD_TYPES, p as UploadGrant, q as UploadRefusal, r as UploadRequest, s as isIdempotencyKey, t as isPhotoFormat, u as isPhotoRef, v as isSubmitResult, w as mergeResponses, x as photoCountMessage, y as photoFormatList, z as photoLimits, A as photoRefs, B as photoSizeMessage, C as photoTypeMessage, E as submitOutcome } from './submit-protocol-CFi-0Qd0.js';
+import { F as FormEngine, a as FormState } from './engine-Da99Tv-E.js';
+export { C as CreateFormOptions, c as createForm, i as isFormEvent, b as isJson, r as replay } from './engine-Da99Tv-E.js';
+import { F as FieldValidator } from './validate-DpmBssFk.js';
+export { A as AnswerSnapshot, C as CHOICE_FIELD_TYPES, a as ChoiceOption, b as ContentTypeManifest, c as FieldTypeManifest, H as HostOptions, L as LinkParams, d as LiteralType, M as MAX_PREFILL_PARAM_LENGTH, O as OPTION_LIMITS, e as OTHER_MAX_LENGTH, f as OptionSnapshot, P as PrefillSetting, g as PrefillState, h as PropsCheck, i as PropsChecker, R as REQUIRED_MESSAGE, j as RegisterOptions, k as RestoredAnswers, S as SEARCHABLE_OPTION_COUNT, l as StandardSchemaV1, V as VALIDATOR_FAILED_MESSAGE, m as answerSnapshots, n as answersFromSnapshots, o as answersOnPath, p as choiceKind, q as choiceOptions, r as clearFilteredAnswers, s as contentText, t as dateLimits, u as filteredChoiceError, v as getContentType, w as getFieldType, x as hasOptionFilters, y as hiddenByPrefill, z as isBuiltInFieldType, B as isChoiceField, D as isEmptyValue, E as isHttpsUrl, G as isIsoDate, I as isOtherValue, J as isPrefillParam, K as isSearchable, N as isSensitive, Q as listContentTypes, T as listFieldTypes, U as normalizeValue, W as numberLimits, X as optionFilter, Y as optionJson, Z as optionMatches, _ as optionsSource, $ as otherOption, a0 as prefillFromLink, a1 as prefillSetting, a2 as ratingDisplay, a3 as readOption, a4 as registerContentType, a5 as registerFieldType, a6 as respondentPath, a7 as scaleLabels, a8 as searchOptions, a9 as summarizeValue, aa as validateField, ab as visibleOptions, ac as withHostOptions } from './validate-DpmBssFk.js';
 
 /** A field block that remembers its key and value type, for answer inference. */
 type FieldSpec<K extends string = string, V = unknown> = FieldBlock & {
@@ -300,8 +300,9 @@ type ParseResult = {
 /**
  * Check a definition before it is stored or rendered: structure, the types of
  * text fields, unique ids and keys, known field types, references that
- * resolve, operators that fit the field type. Warnings flag things that work
- * but are probably mistakes. Never throws, whatever the input.
+ * resolve, operators that fit the field type. Each field and content kind
+ * checks its own `props` (`checkProps` in the registry). Warnings flag things
+ * that work but are probably mistakes. Never throws, whatever the input.
  */
 declare function parseForm(input: unknown): ParseResult;
 
@@ -686,4 +687,280 @@ declare function describeCondition(condition: Condition, def: FormDefinition, fi
  */
 declare function carryAnswers(from: FormDefinition, to: FormDefinition, answers: Record<string, Json>, extra?: Record<string, Json | null | undefined>): Record<string, Json>;
 
-export { type AnswersOf, Block, CALCULATED_TYPE, COMPUTED_FIELD_TYPES, type CalculatedFormat, type CalculatedProps, type ChoiceFieldOptions, type CoerceHiddenOptions, type CoercedHidden, Condition, ContentBlock, Ending, type ExplainInput, type ExplainOptions, type Explanation, FORMULA_FUNCTIONS, FieldBlock, type FieldOptions, type FieldSpec, type FieldValidation, FieldValidator, type Form, FormDefinition, FormEngine, type FormInput, type FormIssue, FormLayout, type FormProgress, FormSettings, FormState, type FormulaFunction, type FormulaNode, type FormulaParseResult, type FormulaReader, type FormulaRef, type FormulaValue, HIGHLIGHT_NOTE_MESSAGE, HiddenInput, type Highlight, Json, type JumpTrace, type KeyResolver, LogicRule, MAX_CALCULATED_DECIMALS, MAX_FORMULA_ITEMS, MAX_FORMULA_LENGTH, MAX_FORM_FORMULA_LENGTH, MAX_HIDDEN_STRING_LENGTH, MAX_HIGHLIGHT_NOTE_LENGTH, MAX_HIGHLIGHT_QUOTE_LENGTH, MAX_SETTLE_ITEMS, MAX_TABLE_CELL_LENGTH, MAX_TABLE_COLUMNS, MAX_TIMESTAMP_SECONDS, type MediaNote, OptionsSource, PageBreakBlock, type ParseResult, type PathResult, PhotoFormat, PhotoRef, type RuleSpec, type RuleTrace, STRUCTURED_FIELD_TYPES, type TableColumn, calculatedProps, calculatedValue, canonicalJson, carryAnswers, coerceHidden, coerceHiddenValue, computePath, defineForm, describeCondition, evaluate, evaluateFormula, explain, f, fingerprint, formProgress, formatCalculated, formatTimestamp, formulaInput, formulaNumber, formulaRefs, furthestReached, listLimits, parseForm, parseFormula, parseTimestamp, recall, renameFormulaKey, ruleVisible, steps, tableColumns, tableLimits, when };
+/**
+ * The key-value storage drafts and the submit outbox keep their data in. One small shape
+ * that `localStorage` (web) and React Native's AsyncStorage both are already; MMKV and
+ * others take a three-line wrapper:
+ *
+ * ```ts
+ * const storage: KeyValueStorage = {
+ *   getItem: (key) => mmkv.getString(key) ?? null,
+ *   setItem: (key, value) => mmkv.set(key, value),
+ *   removeItem: (key) => mmkv.delete(key),
+ * };
+ * ```
+ */
+type MaybePromise<T> = T | Promise<T>;
+/** Strings by key, kept across restarts. Each method may answer at once or with a promise; a throw (or a rejection) is a failure the caller reports. */
+interface KeyValueStorage {
+    getItem(key: string): MaybePromise<string | null | undefined>;
+    setItem(key: string, value: string): MaybePromise<void>;
+    removeItem(key: string): MaybePromise<void>;
+}
+/** Storage that lasts as long as the page or app does: for tests, and where nothing may be kept on the device. */
+declare function memoryStorage(): KeyValueStorage & {
+    keys(): string[];
+};
+/**
+ * The browser's `localStorage` (or another `Storage`, such as `sessionStorage`), looked up on
+ * each call, so creating it during server rendering is safe. Where there is none (a server, a
+ * locked-down private window) every call throws, and the caller reports it.
+ */
+declare function webStorage(storage?: () => Pick<Storage, "getItem" | "setItem" | "removeItem"> | undefined): KeyValueStorage;
+
+/** Whose draft of which form, at which version of it. */
+interface DraftKey {
+    formId: string;
+    /** The definition's version (a published version label, or `fingerprint(definition)`). */
+    version: string;
+    /** Who is answering: a user id, or a session id made once on this device for anonymous visits. */
+    respondent: string;
+}
+/** A saved draft. Plain JSON. */
+interface FormDraft extends DraftKey {
+    /** The answers given, by field id, including ones logic hides now (so going back keeps them). Calculated fields are left out. */
+    values: Record<string, Json>;
+    /** Each saved field's type when it was saved, by field id, to tell whether the form still fits. */
+    types: Record<string, string>;
+    /** The furthest question reached (`formProgress(engine).fieldId`): `createForm`'s `resumeAt`. */
+    resumeAt: string | null;
+    /** When it was saved, in milliseconds since 1970. */
+    savedAt: number;
+}
+/** Where drafts are kept. One draft per form and respondent: saving another version replaces it. */
+interface DraftStore {
+    /** The draft of this form by this respondent, of any version, or null. */
+    get(key: DraftKey): MaybePromise<FormDraft | null>;
+    set(draft: FormDraft): MaybePromise<void>;
+    remove(key: DraftKey): MaybePromise<void>;
+}
+declare const DRAFT_KEY_PREFIX = "genesis-forms:draft:";
+/**
+ * A `DraftStore` over key-value storage, one entry per form and respondent (the version is
+ * inside it, so a new version finds the old draft and `restoreDraft` decides whether it still
+ * fits). A stored entry that doesn't read as a draft is answered null.
+ */
+declare function createDraftStore(storage: KeyValueStorage, options?: {
+    prefix?: string | undefined;
+}): DraftStore;
+interface DraftOptions {
+    /**
+     * Keep answers to sensitive fields (`isSensitive`) in the draft. Default false: they are
+     * left out, so a health detail or an ID number never sits in the device's storage, and the
+     * respondent answers them again after a restore.
+     */
+    keepSensitive?: boolean | undefined;
+}
+/** The engine's answers so far as a draft (null when nothing is answered). */
+declare function draftOf(engine: Pick<FormEngine, "definition" | "getState">, key: DraftKey, options?: DraftOptions & {
+    now?: (() => number) | undefined;
+}): FormDraft | null;
+/** 30 days: the default for how long a draft is kept. */
+declare const DRAFT_MAX_AGE_MS: number;
+type DraftRestore = {
+    ok: true;
+    /** For `createForm`'s `initialValues` (over the host's own prefill). */
+    values: Record<string, Json>;
+    /** For `createForm`'s `resumeAt`. */
+    resumeAt: string | null;
+} | {
+    ok: false;
+    /**
+     * `version`: the form changed and an answer no longer fits (its question is gone, has
+     * another type, or the answer isn't valid for it now). `expired`: older than `maxAgeMs`.
+     */
+    reason: "version" | "expired";
+};
+/**
+ * Whether a saved draft can be put back into this definition. The same version: yes. Another
+ * version: only when every saved answer still fits (its question is there, of the same type,
+ * and the answer passes its format checks); otherwise the whole draft is refused, never half
+ * put back. Pass the definition with the host's options filled in (`engine.definition`, or
+ * `withHostOptions`), so a picked option that's gone counts.
+ */
+declare function restoreDraft(definition: FormDefinition, draft: FormDraft, options: {
+    version: string;
+    now?: (() => number) | undefined;
+    maxAgeMs?: number | undefined;
+}): DraftRestore;
+interface DraftAutosaveOptions extends DraftOptions {
+    /** How long the respondent pauses before the draft is saved, in milliseconds. Default 800. */
+    delayMs?: number | undefined;
+    now?: (() => number) | undefined;
+    /** A save or removal that failed (storage full, unavailable). Default `console.warn`. Autosave never throws. */
+    onError?: ((error: unknown) => void) | undefined;
+    /** Each save that landed, with its time. */
+    onSaved?: ((draft: FormDraft) => void) | undefined;
+    /**
+     * A draft is stored for this key already (it was just restored). Answers cleared to nothing
+     * remove a stored draft; without this, only one this autosave wrote. Default false, so a
+     * draft that couldn't be read is never removed before the respondent answers anything.
+     */
+    stored?: boolean | undefined;
+}
+interface DraftAutosave {
+    /** Save now whatever is waiting. Resolves when it is written (or failed, through `onError`). */
+    flush(): Promise<void>;
+    /**
+     * Stop saving and remove the draft: call it once the submission is safe (queued in the
+     * outbox, or stored). Nothing waiting is written after it.
+     */
+    clear(): Promise<void>;
+    /** Stop listening. Whatever is waiting is saved first (`flush`). */
+    dispose(): Promise<void>;
+}
+/**
+ * Save the engine's answers to `store` as they change, `delayMs` after the last change, one
+ * write at a time and in order. Answers cleared to nothing remove the draft (one this
+ * autosave wrote, or the one restored: `stored`), so an emptied form doesn't come back filled.
+ */
+declare function createDraftAutosave(engine: Pick<FormEngine, "definition" | "getState" | "subscribe">, store: DraftStore, key: DraftKey, options?: DraftAutosaveOptions): DraftAutosave;
+
+/**
+ * The submit outbox: submissions wait on the device until the server has them. Each is
+ * queued with an idempotency key (so a retry is stored once), kept in storage across
+ * restarts, sent when online with backoff between tries, and never dropped silently: one the
+ * server refuses, or that runs out of tries, stays as `failed` until the respondent retries
+ * or discards it.
+ *
+ * Transport-agnostic: `send` is the app's, typically a `fetch` to its endpoint that runs
+ * `submitResponse` and answers its `SubmitResult` as JSON.
+ */
+
+/** One queued submission, as stored. Plain JSON. */
+interface OutboxEntry {
+    /** The submission's idempotency key. */
+    id: string;
+    /** Which form it is for: `send` picks the endpoint by it. */
+    formId: string;
+    /** The body sent, every time the same. */
+    request: SubmitRequest;
+    /** The app's own details to show in a list (a form's title), never sent. */
+    meta: Record<string, Json> | null;
+    createdAt: number;
+    /** Tries so far (since the last `retry`). */
+    attempts: number;
+    /** When it may be tried next. */
+    nextAttemptAt: number;
+    /** `pending`: will be sent. `failed`: refused, or out of tries; waits for `retry` or `discard`. */
+    state: "pending" | "failed";
+    /** Why the last try didn't deliver it, for the respondent or a log. Never holds an answer. */
+    lastError: string | null;
+    /** When the server refused it (`invalid` or `closed`), what it said. */
+    rejection: {
+        reason: SubmitFailureReason;
+        errors?: Record<string, string>;
+    } | null;
+}
+/** A queued submission as the outbox shows it. */
+interface OutboxItem extends OutboxEntry {
+    /** Being sent now. */
+    sending: boolean;
+}
+interface OutboxSnapshot {
+    /** Whether what was stored has been read. Until then `items` may be missing some. */
+    loaded: boolean;
+    online: boolean;
+    /** Oldest first. */
+    items: readonly OutboxItem[];
+    pending: number;
+    failed: number;
+    /** Reading or writing the storage failed; null once it works again. */
+    storageError: string | null;
+    /** Stored submissions that couldn't be read back, by id: left in storage, never sent or removed. */
+    unreadable: readonly string[];
+}
+interface EnqueueInput {
+    formId: string;
+    submission: SubmissionInput;
+    /** Default: a new UUID. Pass the same key again and the queued submission is returned, not queued twice. */
+    idempotencyKey?: string | undefined;
+    /** Default: now. */
+    clientSubmittedAt?: number | undefined;
+    /** The visit's attempt id, for a form with upload fields (`SubmitRequest.attemptId`). */
+    attemptId?: string | undefined;
+    meta?: Record<string, Json> | undefined;
+}
+interface SubmitOutboxOptions {
+    storage: KeyValueStorage;
+    /**
+     * Send one submission and answer what the server said: its `SubmitResult` (an endpoint's
+     * JSON body, whatever its status code). Throw, or answer anything else, and it is tried
+     * again later. Abort on `signal` (sent after `timeoutMs`).
+     */
+    send(item: OutboxItem, context: {
+        signal: AbortSignal;
+    }): Promise<unknown>;
+    /** Milliseconds since 1970. Default `Date.now`. */
+    now?: (() => number) | undefined;
+    /** Storage keys start with this. Default `genesis-forms:outbox`. One outbox per prefix. */
+    prefix?: string | undefined;
+    /**
+     * Tries before a submission is marked `failed` (it is kept). Default 10. A submission that
+     * ran out of tries (not one the server refused) is tried again from the start each time the
+     * outbox starts and each time the device comes back online.
+     */
+    maxAttempts?: number | undefined;
+    /** Wait before try n+1: about `baseMs * 2^(n-1)`, at most `maxMs`, with jitter. Default 2 seconds and 15 minutes. */
+    backoff?: {
+        baseMs?: number | undefined;
+        maxMs?: number | undefined;
+    } | undefined;
+    /** How long one send may take before it is aborted and tried again. Default 30 seconds. */
+    timeoutMs?: number | undefined;
+    /** Whether the device is online to begin with. Default true. Keep it current with `setOnline`. */
+    online?: boolean | undefined;
+    /**
+     * Makes idempotency keys. Default `crypto.randomUUID`; where there is none (React Native
+     * without a polyfill) pass one (expo-crypto's `randomUUID`), or `createSubmitOutbox` throws.
+     */
+    createKey?: (() => string) | undefined;
+    /** 0 to 1, for jitter. Default `Math.random`. */
+    random?: (() => number) | undefined;
+    /** A submission the server now has (stored now, or before: a duplicate). */
+    onDelivered?: ((item: OutboxItem, result: SubmitResult) => void) | undefined;
+    /** Something went wrong that the app may want to log. Default `console.warn`. */
+    log?: ((message: string) => void) | undefined;
+}
+interface SubmitOutbox {
+    /** Resolves once stored submissions are read (or reading failed: see `storageError`). Never rejects. */
+    readonly ready: Promise<void>;
+    /**
+     * Queue a submission. Resolves once it is in storage: only then is it safe to clear the
+     * draft. Rejects when storage can't take it (keep the draft, and tell the respondent).
+     * Sends it at once when the outbox is started and online.
+     */
+    enqueue(input: EnqueueInput): Promise<OutboxItem>;
+    /** Send every pending submission that is due, oldest first, one at a time. */
+    flush(): Promise<void>;
+    /** Try a failed submission again from its first try, now. */
+    retry(id: string): Promise<void>;
+    /** Remove a queued submission for good. False while it is being sent, or when it isn't there. */
+    discard(id: string): Promise<boolean>;
+    /** Tell the outbox whether the device is online. Coming online sends what's pending at once. */
+    setOnline(online: boolean): void;
+    /** Send as submissions come due (timers). `stop` ends it. */
+    start(): void;
+    stop(): void;
+    getSnapshot(): OutboxSnapshot;
+    subscribe(listener: () => void): () => void;
+}
+/**
+ * Each submission is stored under its own key, with an index of keys beside it. The index is
+ * read again and merged on every change, so two outboxes on one storage (two tabs) don't
+ * write each other's submissions out; both may send one, and its idempotency key makes the
+ * server store it once.
+ */
+declare function createSubmitOutbox(options: SubmitOutboxOptions): SubmitOutbox;
+
+export { type AnswersOf, Block, CALCULATED_TYPE, COMPUTED_FIELD_TYPES, type CalculatedFormat, type CalculatedProps, type ChoiceFieldOptions, type CoerceHiddenOptions, type CoercedHidden, Condition, ContentBlock, DRAFT_KEY_PREFIX, DRAFT_MAX_AGE_MS, type DraftAutosave, type DraftAutosaveOptions, type DraftKey, type DraftOptions, type DraftRestore, type DraftStore, Ending, type EnqueueInput, type ExplainInput, type ExplainOptions, type Explanation, FORMULA_FUNCTIONS, FieldBlock, type FieldOptions, type FieldSpec, type FieldValidation, FieldValidator, type Form, FormDefinition, type FormDraft, FormEngine, type FormInput, type FormIssue, FormLayout, type FormProgress, FormSettings, FormState, type FormulaFunction, type FormulaNode, type FormulaParseResult, type FormulaReader, type FormulaRef, type FormulaValue, HIGHLIGHT_NOTE_MESSAGE, HiddenInput, type Highlight, Json, type JumpTrace, type KeyResolver, type KeyValueStorage, LogicRule, MAX_CALCULATED_DECIMALS, MAX_FORMULA_ITEMS, MAX_FORMULA_LENGTH, MAX_FORM_FORMULA_LENGTH, MAX_HIDDEN_STRING_LENGTH, MAX_HIGHLIGHT_NOTE_LENGTH, MAX_HIGHLIGHT_QUOTE_LENGTH, MAX_SETTLE_ITEMS, MAX_TABLE_CELL_LENGTH, MAX_TABLE_COLUMNS, MAX_TIMESTAMP_SECONDS, type MaybePromise, type MediaNote, OptionsSource, type OutboxEntry, type OutboxItem, type OutboxSnapshot, PageBreakBlock, type ParseResult, type PathResult, PhotoFormat, PhotoRef, type RuleSpec, type RuleTrace, STRUCTURED_FIELD_TYPES, SubmitFailureReason, type SubmitOutbox, type SubmitOutboxOptions, SubmitRequest, SubmitResult, type TableColumn, calculatedProps, calculatedValue, canonicalJson, carryAnswers, coerceHidden, coerceHiddenValue, computePath, createDraftAutosave, createDraftStore, createSubmitOutbox, defineForm, describeCondition, draftOf, evaluate, evaluateFormula, explain, f, fingerprint, formProgress, formatCalculated, formatTimestamp, formulaInput, formulaNumber, formulaRefs, furthestReached, listLimits, memoryStorage, parseForm, parseFormula, parseTimestamp, recall, renameFormulaKey, restoreDraft, ruleVisible, steps, tableColumns, tableLimits, webStorage, when };