@marktiderman/genesis-forms 0.5.0 → 0.7.0

package/dist/index.d.cts

@@ -1,68 +1,11 @@
-import { a as FieldBlock, J as Json, 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, d as Condition, B as Block } from './types-BhYUbLJ-.cjs';
-export { e as FormEvent, f as Operand, g as Operator } from './types-BhYUbLJ-.cjs';
-import { F as FormEngine, a as FormState } from './engine-BDq0XJ21.cjs';
-export { C as CreateFormOptions, c as createForm, i as isFormEvent, b as isJson, r as replay } from './engine-BDq0XJ21.cjs';
-import { F as FieldValidator } from './validate-BsZ0YTQS.cjs';
-export { C as ChoiceOption, a as FieldTypeManifest, H as HostOptions, O as OTHER_MAX_LENGTH, R as REQUIRED_MESSAGE, S as StandardSchemaV1, c as choiceOptions, d as dateLimits, g as getFieldType, i as isEmptyValue, b as isIsoDate, e as isOtherValue, f as isSensitive, l as listFieldTypes, n as normalizeValue, h as numberLimits, o as optionsSource, j as otherOption, r as ratingDisplay, k as registerFieldType, s as scaleLabels, m as summarizeValue, v as validateField, w as withHostOptions } from './validate-BsZ0YTQS.cjs';
-
-/**
- * The `photo` field type: a respondent attaches up to a few photos, such as a
- * picture of broken equipment. The answer holds references the host's storage
- * handed back (`PhotoRef`), never the bytes: the renderer uploads through the
- * host (`onUpload` on genesis-forms-web's `Form`), so the engine and the
- * server stay storage-agnostic. A host's server should check that each
- * reference is a file it stored for this respondent before saving.
- *
- * Opt-in in a builder palette (`UPLOAD_FIELD_TYPES`), since a host must be
- * able to store the files.
- */
-declare const PHOTO_TYPE = "photo";
-/** Field types that need the host to store files; a builder offers them only when the host names them. */
-declare const UPLOAD_FIELD_TYPES: readonly ["photo"];
-/** One stored photo, as the host's upload returned it. */
-type PhotoRef = {
-    /** The host's id for the stored file. */
-    id: string;
-    /** The file's name on the respondent's device. */
-    name: string;
-    /** Its MIME type, such as `image/jpeg`. */
-    type: string;
-    /** Bytes. */
-    size: number;
-};
-type PhotoFormat = "jpeg" | "png" | "heic" | "webp";
-/** The MIME types each format covers. */
-declare const PHOTO_FORMATS: Record<PhotoFormat, readonly string[]>;
-declare const DEFAULT_PHOTO_FILES = 3;
-declare const MAX_PHOTO_FILES = 5;
-declare const DEFAULT_PHOTO_SIZE_MB = 10;
-declare const MAX_PHOTO_SIZE_MB = 25;
-/** The longest reference id and file name a photo answer may carry. */
-declare const MAX_PHOTO_ID_LENGTH = 200;
-declare const MAX_PHOTO_NAME_LENGTH = 255;
-declare const isPhotoFormat: (v: unknown) => v is PhotoFormat;
-interface PhotoLimits {
-    maxFiles: number;
-    maxSizeMb: number;
-    maxBytes: number;
-    formats: PhotoFormat[];
-    /** Every MIME type the formats cover. */
-    mimeTypes: string[];
-}
-/** A photo field's limits; a prop that is missing or out of range uses its default. */
-declare function photoLimits(field: FieldBlock): PhotoLimits;
-/** Whether `v` has a photo reference's shape (any type and size). */
-declare function isPhotoRef(v: unknown): v is PhotoRef;
-/** The well-formed references in a photo answer, as `{ id, name, type, size }` only. */
-declare function photoRefs(value: Json | undefined): PhotoRef[];
-/** "JPEG, PNG or WebP". */
-declare function photoFormatList(formats: readonly PhotoFormat[]): string;
-/** The message for a file of a type the field doesn't take. */
-declare const photoTypeMessage: (field: FieldBlock) => string;
-/** The message for a file over the field's size limit. */
-declare const photoSizeMessage: (field: FieldBlock) => string;
-/** The message for more photos than the field takes. */
-declare const photoCountMessage: (field: FieldBlock) => string;
+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';
 
 /** A field block that remembers its key and value type, for answer inference. */
 type FieldSpec<K extends string = string, V = unknown> = FieldBlock & {
@@ -87,6 +30,9 @@ interface ChoiceFieldOptions<O extends string> extends FieldOptions {
     options?: readonly {
         value: O;
         label?: string;
+        description?: string;
+        image?: string;
+        attributes?: Record<string, string | string[]>;
     }[] | undefined;
     /**
      * Options the app showing the form supplies, by key (`OptionsSource`), such
@@ -101,6 +47,17 @@ interface ChoiceFieldOptions<O extends string> extends FieldOptions {
     other?: boolean | {
         label?: string;
     } | undefined;
+    /**
+     * Preselect from the link the form was opened from: `{ param: "location" }` takes
+     * `?location=…` when it is one of the options; `hideWhenPrefilled` then skips the question.
+     * See `prefillFromLink`.
+     */
+    prefill?: {
+        param: string;
+        hideWhenPrefilled?: boolean;
+    } | undefined;
+    /** A search box over the options: true or false, or by default when there are more than 10 (`isSearchable`). */
+    searchable?: boolean | undefined;
 }
 interface HiddenOptions {
     source?: HiddenInput["source"] | undefined;
@@ -721,4 +678,12 @@ declare function explain(source: FormEngine | ExplainInput, blockId: string, opt
 /** A condition as a plain-English clause: `contact_me is not Yes`. */
 declare function describeCondition(condition: Condition, def: FormDefinition, fields?: Map<string, FieldBlock>): string;
 
-export { type AnswersOf, Block, CALCULATED_TYPE, COMPUTED_FIELD_TYPES, type CalculatedFormat, type CalculatedProps, type ChoiceFieldOptions, type CoerceHiddenOptions, type CoercedHidden, Condition, ContentBlock, DEFAULT_PHOTO_FILES, DEFAULT_PHOTO_SIZE_MB, 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_PHOTO_FILES, MAX_PHOTO_ID_LENGTH, MAX_PHOTO_NAME_LENGTH, MAX_PHOTO_SIZE_MB, MAX_SETTLE_ITEMS, MAX_TABLE_CELL_LENGTH, MAX_TABLE_COLUMNS, MAX_TIMESTAMP_SECONDS, type MediaNote, OptionsSource, PHOTO_FORMATS, PHOTO_TYPE, PageBreakBlock, type ParseResult, type PathResult, type PhotoFormat, type PhotoLimits, type PhotoRef, type RuleSpec, type RuleTrace, STRUCTURED_FIELD_TYPES, type TableColumn, UPLOAD_FIELD_TYPES, calculatedProps, calculatedValue, canonicalJson, coerceHidden, coerceHiddenValue, computePath, defineForm, describeCondition, evaluate, evaluateFormula, explain, f, fingerprint, formProgress, formatCalculated, formatTimestamp, formulaInput, formulaNumber, formulaRefs, furthestReached, isPhotoFormat, isPhotoRef, listLimits, parseForm, parseFormula, parseTimestamp, photoCountMessage, photoFormatList, photoLimits, photoRefs, photoSizeMessage, photoTypeMessage, recall, renameFormulaKey, ruleVisible, steps, tableColumns, tableLimits, when };
+/**
+ * Answers given to one version of a form, as answers to another (by field id), matched
+ * by field key: what an edit link prefills when the form has a newer version. Answers
+ * to fields the other version doesn't have are dropped; `extra` (by key) fills fields
+ * the stored answers leave out, such as contact details kept apart.
+ */
+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 };

package/dist/index.d.ts

@@ -1,68 +1,11 @@
-import { a as FieldBlock, J as Json, 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, d as Condition, B as Block } from './types-BhYUbLJ-.js';
-export { e as FormEvent, f as Operand, g as Operator } from './types-BhYUbLJ-.js';
-import { F as FormEngine, a as FormState } from './engine-Qzp6bX6O.js';
-export { C as CreateFormOptions, c as createForm, i as isFormEvent, b as isJson, r as replay } from './engine-Qzp6bX6O.js';
-import { F as FieldValidator } from './validate-Bs1lyoOl.js';
-export { C as ChoiceOption, a as FieldTypeManifest, H as HostOptions, O as OTHER_MAX_LENGTH, R as REQUIRED_MESSAGE, S as StandardSchemaV1, c as choiceOptions, d as dateLimits, g as getFieldType, i as isEmptyValue, b as isIsoDate, e as isOtherValue, f as isSensitive, l as listFieldTypes, n as normalizeValue, h as numberLimits, o as optionsSource, j as otherOption, r as ratingDisplay, k as registerFieldType, s as scaleLabels, m as summarizeValue, v as validateField, w as withHostOptions } from './validate-Bs1lyoOl.js';
-
-/**
- * The `photo` field type: a respondent attaches up to a few photos, such as a
- * picture of broken equipment. The answer holds references the host's storage
- * handed back (`PhotoRef`), never the bytes: the renderer uploads through the
- * host (`onUpload` on genesis-forms-web's `Form`), so the engine and the
- * server stay storage-agnostic. A host's server should check that each
- * reference is a file it stored for this respondent before saving.
- *
- * Opt-in in a builder palette (`UPLOAD_FIELD_TYPES`), since a host must be
- * able to store the files.
- */
-declare const PHOTO_TYPE = "photo";
-/** Field types that need the host to store files; a builder offers them only when the host names them. */
-declare const UPLOAD_FIELD_TYPES: readonly ["photo"];
-/** One stored photo, as the host's upload returned it. */
-type PhotoRef = {
-    /** The host's id for the stored file. */
-    id: string;
-    /** The file's name on the respondent's device. */
-    name: string;
-    /** Its MIME type, such as `image/jpeg`. */
-    type: string;
-    /** Bytes. */
-    size: number;
-};
-type PhotoFormat = "jpeg" | "png" | "heic" | "webp";
-/** The MIME types each format covers. */
-declare const PHOTO_FORMATS: Record<PhotoFormat, readonly string[]>;
-declare const DEFAULT_PHOTO_FILES = 3;
-declare const MAX_PHOTO_FILES = 5;
-declare const DEFAULT_PHOTO_SIZE_MB = 10;
-declare const MAX_PHOTO_SIZE_MB = 25;
-/** The longest reference id and file name a photo answer may carry. */
-declare const MAX_PHOTO_ID_LENGTH = 200;
-declare const MAX_PHOTO_NAME_LENGTH = 255;
-declare const isPhotoFormat: (v: unknown) => v is PhotoFormat;
-interface PhotoLimits {
-    maxFiles: number;
-    maxSizeMb: number;
-    maxBytes: number;
-    formats: PhotoFormat[];
-    /** Every MIME type the formats cover. */
-    mimeTypes: string[];
-}
-/** A photo field's limits; a prop that is missing or out of range uses its default. */
-declare function photoLimits(field: FieldBlock): PhotoLimits;
-/** Whether `v` has a photo reference's shape (any type and size). */
-declare function isPhotoRef(v: unknown): v is PhotoRef;
-/** The well-formed references in a photo answer, as `{ id, name, type, size }` only. */
-declare function photoRefs(value: Json | undefined): PhotoRef[];
-/** "JPEG, PNG or WebP". */
-declare function photoFormatList(formats: readonly PhotoFormat[]): string;
-/** The message for a file of a type the field doesn't take. */
-declare const photoTypeMessage: (field: FieldBlock) => string;
-/** The message for a file over the field's size limit. */
-declare const photoSizeMessage: (field: FieldBlock) => string;
-/** The message for more photos than the field takes. */
-declare const photoCountMessage: (field: FieldBlock) => string;
+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';
 
 /** A field block that remembers its key and value type, for answer inference. */
 type FieldSpec<K extends string = string, V = unknown> = FieldBlock & {
@@ -87,6 +30,9 @@ interface ChoiceFieldOptions<O extends string> extends FieldOptions {
     options?: readonly {
         value: O;
         label?: string;
+        description?: string;
+        image?: string;
+        attributes?: Record<string, string | string[]>;
     }[] | undefined;
     /**
      * Options the app showing the form supplies, by key (`OptionsSource`), such
@@ -101,6 +47,17 @@ interface ChoiceFieldOptions<O extends string> extends FieldOptions {
     other?: boolean | {
         label?: string;
     } | undefined;
+    /**
+     * Preselect from the link the form was opened from: `{ param: "location" }` takes
+     * `?location=…` when it is one of the options; `hideWhenPrefilled` then skips the question.
+     * See `prefillFromLink`.
+     */
+    prefill?: {
+        param: string;
+        hideWhenPrefilled?: boolean;
+    } | undefined;
+    /** A search box over the options: true or false, or by default when there are more than 10 (`isSearchable`). */
+    searchable?: boolean | undefined;
 }
 interface HiddenOptions {
     source?: HiddenInput["source"] | undefined;
@@ -721,4 +678,12 @@ declare function explain(source: FormEngine | ExplainInput, blockId: string, opt
 /** A condition as a plain-English clause: `contact_me is not Yes`. */
 declare function describeCondition(condition: Condition, def: FormDefinition, fields?: Map<string, FieldBlock>): string;
 
-export { type AnswersOf, Block, CALCULATED_TYPE, COMPUTED_FIELD_TYPES, type CalculatedFormat, type CalculatedProps, type ChoiceFieldOptions, type CoerceHiddenOptions, type CoercedHidden, Condition, ContentBlock, DEFAULT_PHOTO_FILES, DEFAULT_PHOTO_SIZE_MB, 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_PHOTO_FILES, MAX_PHOTO_ID_LENGTH, MAX_PHOTO_NAME_LENGTH, MAX_PHOTO_SIZE_MB, MAX_SETTLE_ITEMS, MAX_TABLE_CELL_LENGTH, MAX_TABLE_COLUMNS, MAX_TIMESTAMP_SECONDS, type MediaNote, OptionsSource, PHOTO_FORMATS, PHOTO_TYPE, PageBreakBlock, type ParseResult, type PathResult, type PhotoFormat, type PhotoLimits, type PhotoRef, type RuleSpec, type RuleTrace, STRUCTURED_FIELD_TYPES, type TableColumn, UPLOAD_FIELD_TYPES, calculatedProps, calculatedValue, canonicalJson, coerceHidden, coerceHiddenValue, computePath, defineForm, describeCondition, evaluate, evaluateFormula, explain, f, fingerprint, formProgress, formatCalculated, formatTimestamp, formulaInput, formulaNumber, formulaRefs, furthestReached, isPhotoFormat, isPhotoRef, listLimits, parseForm, parseFormula, parseTimestamp, photoCountMessage, photoFormatList, photoLimits, photoRefs, photoSizeMessage, photoTypeMessage, recall, renameFormulaKey, ruleVisible, steps, tableColumns, tableLimits, when };
+/**
+ * Answers given to one version of a form, as answers to another (by field id), matched
+ * by field key: what an edit link prefills when the form has a newer version. Answers
+ * to fields the other version doesn't have are dropped; `extra` (by key) fills fields
+ * the stored answers leave out, such as contact details kept apart.
+ */
+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 };