import { z } from 'zod'; type FormResourceKind = "schema" | "version" | "state" | "submission" | "auditEvent" | "internal"; type FormDeletionCounts = Readonly>; interface FormDeletionScope { readonly tenantId?: string; readonly ownerId?: string; } interface FormDeletionRequest extends FormDeletionScope { readonly formId: string; readonly allowNonAtomic?: boolean; readonly dryRun?: boolean; readonly pageSize?: number; readonly cursor?: string; } interface FormResource { readonly kind: FormResourceKind; readonly id: string; readonly value: unknown; } interface FormLifecycleOptions { /** Map each stored resource (including internal records) to its actual scope. */ readonly scope?: (resource: FormResource) => FormDeletionScope; } interface FormDeletionInspection { readonly counts: FormDeletionCounts; readonly targets: readonly Pick[]; readonly nextCursor?: string; } interface FormDeletionResult { readonly status: "deleted" | "dry_run" | "partial" | "failed"; readonly atomic: boolean; readonly counts: FormDeletionCounts; readonly inspection?: FormDeletionInspection; readonly error?: { readonly code: "transaction_unsupported" | "storage_error"; readonly cause?: unknown; }; } interface FormLifecycleAdapter { readonly lifecycleCapabilities: { readonly resources: readonly FormResourceKind[]; readonly atomic: boolean; }; inspectFormDeletion(request: FormDeletionRequest): Promise; deleteForm(request: FormDeletionRequest): Promise; } interface FormLifecycleBackend { readonly resources: readonly FormResourceKind[]; readonly list: (formId: string) => Promise; /** Must condition deletion on the enumerated identity/value and return the actual affected count. */ readonly remove: (resource: FormResource) => Promise; /** Supplies an isolated backend bound to the transaction; rejection rolls back every removal. */ readonly transaction?: (operation: (backend: FormLifecycleBackend) => Promise) => Promise; } declare function emptyFormDeletionCounts(): Record; declare function createFormLifecycleAdapter(backend: FormLifecycleBackend, options?: FormLifecycleOptions): FormLifecycleAdapter; type FormContentMode = "survey" | "poll" | "quiz"; interface PollMetadata { readonly resultVisibility: "after_submit" | "always" | "closed_only" | "private"; readonly strictOneVotePerUser?: boolean; } interface QuizFieldMetadata { readonly correctOptionId: string; readonly explanation?: string; readonly points?: number; } interface QuizMetadata { readonly showExplanation: "after_submit" | "immediate"; readonly passingScore?: number; } interface CustomFormMetadata { readonly mode: FormContentMode; readonly poll?: PollMetadata; readonly quiz?: QuizMetadata; readonly [key: string]: unknown; } type ContentModeConstraintCode = "CONTENT_MODE_CONSTRAINT" | "POLL_SINGLE_FIELD_REQUIRED" | "POLL_INVALID_FIELD_TYPE" | "POLL_MIN_OPTIONS_REQUIRED" | "RADIO_TEXT_INPUT_SURVEY_ONLY" | "QUIZ_CORRECT_OPTION_MISSING" | "QUIZ_INVALID_CORRECT_OPTION"; interface ContentModeConstraintIssue extends SchemaIssue { readonly code: ContentModeConstraintCode; } interface ContentModeValidationResult { readonly valid: boolean; readonly issues: readonly ContentModeConstraintIssue[]; } declare function getFormContentMode(metadata: unknown): FormContentMode; declare function readPollMetadata(metadata: unknown): PollMetadata; declare function readQuizMetadata(metadata: unknown): QuizMetadata; declare function readQuizFieldMetadata(metadata: unknown): QuizFieldMetadata; interface ContentModeSettings { readonly minFields?: number; readonly maxFields?: number; readonly allowedFieldTypes?: FormPolicy["allowedFieldTypes"]; readonly minOptionsPerField?: number; readonly maxOptionsPerField?: number; readonly evaluateQuiz?: (schema: FormSchema, answers: FormValues) => QuizEvaluationResult; } declare function resolveContentModeSettings(mode: FormContentMode, policy?: FormPolicy): ContentModeSettings; declare function validateContentModeConstraints(schema: FormSchema, policy?: FormPolicy): ContentModeValidationResult; /** Explicit JSON boundary: rejects non-JSON values instead of silently dropping them. */ declare function contentMetadataToJson(value: unknown): Readonly>; declare function createInitialSchemaByMode(mode: FormContentMode, options: { readonly title: string; readonly locale: string; readonly id?: string; }): FormSchema; declare function getContentModePolicy(mode: FormContentMode, policy?: FormPolicy): FormPolicy; interface ContentModeIssue { readonly path: string; readonly message: string; } type ContentModeIssueCode = "field_count" | "options_maximum" | "quiz_evaluator_missing" | "poll_field_count" | "quiz_field_count" | "unsupported_field_type" | "options_minimum" | "radio_text_input" | "correct_option_missing" | "points_type" | "explanation_type" | "points_range" | "poll_result_visibility" | "poll_strict_one_vote" | "quiz_explanation_timing" | "quiz_passing_score"; interface ContentModeDiagnostic extends ContentModeIssue { readonly code: ContentModeIssueCode; } /** Opt-in validation, separate from the backwards-compatible base schema validator. */ declare function getContentModeDiagnostics(schema: FormSchema, policy?: FormPolicy): readonly ContentModeDiagnostic[]; /** Opt-in validation, separate from the backwards-compatible base schema validator. */ declare function validateContentMode(schema: FormSchema, policy?: FormPolicy): readonly ContentModeIssue[]; interface QuizQuestionResult { readonly fieldId: string; readonly title: string; readonly correct: boolean; readonly correctOption: string; readonly explanation?: string; readonly points: number; readonly earned: number; } interface QuizResult { readonly questions: readonly QuizQuestionResult[]; readonly score: number; readonly total: number; readonly passed?: boolean; } interface QuizQuestionEvaluation { readonly questionId: string; readonly isCorrect: boolean; readonly correctOptionId?: string; readonly selectedOptionId?: string; readonly explanation?: string; readonly scoreEarned: number; readonly maxScore: number; } interface QuizEvaluationResult { readonly totalScore: number; readonly maxPossibleScore: number; readonly isPassed?: boolean; readonly questions: readonly QuizQuestionEvaluation[]; readonly reward?: { readonly type: "coupon" | "badge" | "text"; readonly code?: string; readonly message?: string; }; } declare function evaluateQuizLocally(schema: FormSchema, answers: FormValues, policy?: FormPolicy): QuizEvaluationResult; declare function evaluateQuiz(schema: FormSchema, answers: FormValues, policy?: FormPolicy): QuizResult; interface PollAccessContext { readonly submitted: boolean; readonly closed: boolean; readonly canViewResults: boolean; } declare function canShowPollResults(metadata: PollMetadata, context: PollAccessContext): boolean; /** Implementations must enforce identity and authorization at the persistence boundary. */ interface PollRuntimeAdapter { readonly loadResults: (schema: FormSchema, signal: AbortSignal) => Promise; readonly canVote: (schema: FormSchema) => Promise; } interface ValidateFormSchemaOptions { readonly policy?: FormPolicy; } declare function validateFormSchema(input: unknown, options?: ValidateFormSchemaOptions): SchemaValidationResult; declare function assertValidFormSchema(input: unknown, options?: ValidateFormSchemaOptions): asserts input is FormSchema; interface ChoiceDistributionEntry { readonly count: number; readonly percentage: number; } interface NumericSummary { readonly average: number | null; readonly min: number | null; readonly max: number | null; readonly total: number; } declare function calculateChoiceDistribution(responses: readonly FormSubmission[], questionId: string): Record; declare function calculateNumericSummary(responses: readonly FormSubmission[], questionId: string): NumericSummary; declare function calculateCrossTabulation(responses: readonly FormSubmission[], rowQuestionId: string, colQuestionId: string): CrossTabulationResult; declare function aggregateResponses(schema: FormSchema, submissions: readonly FormSubmission[], options?: ValidateFormSchemaOptions): FormAnalytics; type AccumulatorResponse = FormSubmission | FormResponse; type AccumulatorSkipReason = "form_id_mismatch" | "version_mismatch" | "invalid_structure"; interface AccumulatorReport { readonly processedCount: number; readonly skippedCount: number; readonly skipReasons: readonly { readonly responseId: string; readonly reason: AccumulatorSkipReason; }[]; } interface ResponseAccumulator { add(submission: AccumulatorResponse): { readonly success: boolean; readonly skipped?: boolean; readonly error?: string; }; addMany(submissions: Iterable): AccumulatorReport; merge(other: ResponseAccumulator): ResponseAccumulator; finalize(): FormAnalytics; getReport(): AccumulatorReport; } interface ResponseAccumulatorOptions { readonly mode?: "strict" | "lenient"; readonly policy?: FormPolicy; } declare function createResponseAccumulator(schema: FormSchema, options?: ResponseAccumulatorOptions): ResponseAccumulator; declare function escapeCsvCell(value: string | number | boolean | null | undefined, neutralizeFormulas?: boolean): string; interface CsvColumnDefinition { readonly key: string; readonly header: string; readonly getValue: (submission: FormSubmission, schema: FormSchema) => string | number | boolean | null | undefined; } interface CsvExportOptions { readonly policy?: FormPolicy; readonly withBom?: boolean; readonly neutralizeFormulas?: boolean; /** Alias for withBom used by the public export contract. */ readonly useBom?: boolean; /** Alias for neutralizeFormulas used by the public export contract. */ readonly preventFormulaInjection?: boolean; readonly customColumns?: readonly CsvColumnDefinition[]; readonly includePiiStatus?: boolean; readonly includeLocale?: boolean; } interface MetadataCsvExportOptions extends CsvExportOptions { readonly includeMetadataFields?: readonly Extract[]; } interface CsvColumnDef { readonly header: string; readonly getValue: (context: CsvColumnContext) => string | number | boolean | null | undefined | Promise; } interface CsvColumnContext extends FormResponse { readonly submission: FormResponse; readonly formVersion: number; readonly schema: FormSchema; } interface StreamCsvOptions extends CsvExportOptions { readonly columns?: readonly CsvColumnDef[]; readonly includeDefaultColumns?: boolean; } interface TypedStreamCsvOptions extends Omit { readonly includeMetadataFields?: readonly Extract[]; } type CsvStream = ReadableStream & AsyncIterable; declare function exportResponsesToCsvStream(schema: FormSchema, submissions: AsyncIterable, options?: StreamCsvOptions): AsyncIterable; declare function exportResponsesToCsvStream(schema: FormSchema, submissions: Iterable> | AsyncIterable>, options?: TypedStreamCsvOptions): CsvStream; declare function exportResponsesToCsvStream(schema: FormSchema, submissions: Iterable | AsyncIterable, options?: StreamCsvOptions): CsvStream; interface NodeWritableStream { write(chunk: Uint8Array): boolean; once(event: "drain", listener: () => void): unknown; once(event: "error", listener: (error: Error) => void): unknown; removeListener(event: "drain", listener: () => void): unknown; removeListener(event: "error", listener: (error: Error) => void): unknown; end(callback: () => void): unknown; } declare function pipeResponsesToCsvStream(schema: FormSchema, submissions: AsyncIterable, writable: WritableStream | NodeWritableStream, options?: StreamCsvOptions): Promise; declare function exportResponsesToCsv(schema: FormSchema, responses: readonly FormSubmission[], options?: CsvExportOptions): string; declare function exportResponsesToCsv(schema: FormSchema, responses: readonly FormSubmission[], options?: MetadataCsvExportOptions): string; type KnownBuilderTranslationKey = "authoring.prompt.label" | "authoring.prompt.submit" | "authoring.preview.selectAll" | "authoring.preview.apply" | "authoring.preview.reject" | "authoring.preview.before" | "authoring.preview.after" | "authoring.preview.invalid" | "authoring.preview.label" | "authoring.preview.property.type" | "authoring.preview.property.title" | "authoring.preview.property.description" | "authoring.preview.property.required" | "authoring.preview.property.option" | "authoring.preview.property.completionMessage" | "authoring.preview.property.submitLabel" | "authoring.preview.value.required" | "authoring.preview.value.optional" | "authoring.preview.value.none" | "authoring.preview.value.enabled" | "authoring.preview.value.disabled" | "authoring.action.ai" | "authoring.action.rewrite" | "authoring.action.shorten" | "authoring.action.generateOptions" | "authoring.operation.addField" | "authoring.operation.updateField" | "authoring.operation.updateForm" | "authoring.operation.addOption" | "authoring.operation.updateOption" | "builder.content.mode" | "builder.content.survey" | "builder.content.poll" | "builder.content.quiz" | "builder.content.pollSettings" | "builder.content.quizSettings" | "builder.content.resultVisibility" | "builder.content.after_submit" | "builder.content.always" | "builder.content.closed_only" | "builder.content.private" | "builder.content.strictOneVotePerUser" | "builder.content.showExplanation" | "builder.content.immediate" | "builder.content.enablePassingScore" | "builder.content.passingScore" | "builder.content.correctAnswer" | "builder.content.explanation" | "builder.content.points" | "builder.content.validationTitle" | "builder.content.validation.poll_field_count" | "builder.content.validation.quiz_field_count" | "builder.content.validation.unsupported_field_type" | "builder.content.validation.options_minimum" | "builder.content.validation.correct_option_missing" | "builder.content.validation.points_type" | "builder.content.validation.explanation_type" | "builder.content.validation.points_range" | "builder.content.validation.poll_result_visibility" | "builder.content.validation.poll_strict_one_vote" | "builder.content.validation.quiz_explanation_timing" | "builder.content.validation.quiz_passing_score" | "builder.formTitle" | "builder.formDescription" | "builder.completionMessage" | "builder.structure" | "builder.page" | "builder.questions" | "builder.expand" | "builder.collapse" | "builder.validationProblems" | "builder.fixIssue" | "builder.addQuestion" | "builder.actions.addField" | "builder.actions.deleteField" | "builder.actions.moveUp" | "builder.actions.moveDown" | "builder.actions.add" | "builder.actions.delete" | "builder.actions.edit" | "builder.actions.settings" | "builder.actions.translate" | "builder.actions.close" | "builder.actions.dragHandle" | "builder.fields.selectType" | "builder.fields.typeText" | "builder.fields.typeTextarea" | "builder.fields.typeNumber" | "builder.fields.typeRadio" | "builder.fields.typeCheckbox" | "builder.fields.typeSelect" | "builder.fields.typeRating" | "builder.fields.typeMultiSelect" | "builder.fields.typeDate" | "builder.fields.typeTime" | "builder.fields.typeEmail" | "builder.fields.typeTel" | "builder.fields.typeUrl" | "builder.fieldType.text" | "builder.fieldType.textarea" | "builder.fieldType.number" | "builder.fieldType.radio" | "builder.fieldType.checkbox" | "builder.fieldType.select" | "builder.fieldType.rating" | "builder.fieldType.multi-select" | "builder.fieldType.date" | "builder.fieldType.time" | "builder.fieldType.email" | "builder.fieldType.tel" | "builder.fieldType.url" | "builder.fieldTypeDescription.text" | "builder.fieldTypeDescription.textarea" | "builder.fieldTypeDescription.number" | "builder.fieldTypeDescription.radio" | "builder.fieldTypeDescription.checkbox" | "builder.fieldTypeDescription.select" | "builder.fieldTypeDescription.rating" | "builder.fieldTypeDescription.multi-select" | "builder.fieldTypeDescription.date" | "builder.fieldTypeDescription.time" | "builder.fieldTypeDescription.email" | "builder.fieldTypeDescription.tel" | "builder.fieldTypeDescription.url" | "builder.fieldCategory.text" | "builder.fieldCategory.choice" | "builder.fieldCategory.number" | "builder.fieldCategory.advanced" | "builder.required" | "builder.options" | "builder.shuffleOptions" | "builder.pinOption" | "builder.optionTextInput" | "builder.openAt" | "builder.closeAt" | "builder.maxResponses" | "builder.closedMessage" | "builder.notYetOpenMessage" | "builder.honeypotFieldId" | "builder.localization.title" | "builder.localization" | "builder.localization.addLocale" | "builder.localization.selectLocaleToAdd" | "builder.localization.defaultLocale" | "builder.localization.translateAll" | "builder.localization.noLocalesConfigured" | "builder.localization.localesConfiguredSummary" | "builder.localization.allLocalesAdded" | "builder.localization.maxLocalesReached" | "builder.submissionSettings.title" | "builder.submissionSettings.showConfirmation" | "builder.submissionSettings.renderMode" | "builder.formBuilder" | "builder.basicSettings" | "builder.description" | "builder.moveUp" | "builder.moveDown" | "builder.delete" | "builder.deleteAction" | "builder.questionTitle" | "builder.questionTitlePlaceholder" | "builder.newQuestionTitle" | "builder.type" | "builder.minimum" | "builder.maximum" | "builder.minimumLength" | "builder.maximumLength" | "builder.pattern" | "builder.step" | "builder.optionLabel" | "builder.optionLabelPlaceholder" | "builder.newOptionLabel" | "builder.remove" | "builder.addOption" | "builder.displayCondition" | "builder.alwaysVisible" | "builder.conditionOperator" | "builder.conditionValue" | "builder.conditionTrue" | "builder.conditionFalse" | "builder.pages" | "builder.enablePages" | "builder.addPage" | "builder.splitPage" | "builder.newPage" | "builder.pageTitle" | "builder.pageDescription" | "builder.pageQuestion" | "builder.pageQuestionToMove" | "builder.noPageQuestions" | "builder.pageDeleteMoves" | "builder.pageDeleteLast" | "builder.questionPage" | "builder.pageCondition" | "builder.unassigned" | "builder.defaultLocale" | "builder.supportedLocales" | "builder.addLocale" | "builder.editLocale" | "builder.autoTranslate" | "builder.translating" | "builder.translationLocale" | "builder.selectLocale" | "builder.selectLocaleToAdd" | "builder.translation" | "builder.translatedFormTitle" | "builder.translatedFormDescription" | "builder.translatedCompletionMessage" | "builder.translatedQuestionTitle" | "builder.translatedDescription" | "builder.translationUnavailable" | "builder.operator.equals" | "builder.operator.not_equals" | "builder.operator.contains" | "builder.operator.not_empty" | "builder.showConfirmationBeforeSubmit" | "builder.confirmationRenderMode"; type BuilderTranslationKey = KnownBuilderTranslationKey; type RendererTranslationKey = "renderer.submitButton" | "renderer.submittingButton" | "renderer.retryButton" | "renderer.requiredField" | "renderer.validationSummary" | "renderer.validationSummaryPlural" | "renderer.alreadySubmittedTitle" | "renderer.alreadySubmittedMessage" | "renderer.progressLabel" | "renderer.remainingQuestions" | "renderer.serverErrorSummary" | "renderer.confirmSensitiveDataTitle" | "renderer.confirmSensitiveDataMessage" | "renderer.confirmButton" | "renderer.cancelButton" | "renderer.draftResumeTitle" | "renderer.draftResumeMessage" | "renderer.draftResumeContinue" | "renderer.draftResumeStartOver" | "renderer.draftResumeEnabled" | "renderer.draftResumeDisabled" | "renderer.draftSaved" | "renderer.draftSaveFailed" | "renderer.draftDeleteFailed" | "form.submit" | "form.submitting" | "form.back" | "form.next" | "form.step" | "form.draftRestored" | "form.submissionBlocked" | "form.confirmSensitiveData" | "form.confirmSubmission" | "form.cancelSubmission" | "form.yes" | "form.no" | "form.alreadySubmitted" | "form.submitAnother" | "form.closed" | "form.notYetOpen" | "form.responseLimitReached" | "form.optionText" | "validation.required" | "validation.invalidOption" | "validation.invalidType" | "validation.max" | "validation.maxLength" | "validation.maxSelections" | "validation.min" | "validation.minLength" | "validation.minSelections" | "validation.pattern" | "validation.invalidFormat" | "validation.sensitiveData" | "validation.step" | "validation.unknownField"; type ContentResultTranslationKey = "content.results.totalScore" | "content.results.passed" | "content.results.notPassed" | "content.results.correct" | "content.results.incorrect" | "content.results.correctOption" | "content.results.pollResults" | "content.results.votes" | "content.results.loading" | "content.results.retry" | "content.results.loadError" | "content.results.invalidQuiz" | "content.results.share" | "content.results.shared" | "content.results.copied" | "content.results.shareFailed"; type TranslationWorkspaceTranslationKey = "workspace.title" | "workspace.status.missing" | "workspace.status.translated" | "workspace.status.stale" | "workspace.status.manual" | "workspace.status.manualStale" | "workspace.errors.localeNotAllowed" | "workspace.errors.maxLocalesExceeded" | "workspace.errors.readOnly" | "workspace.errors.adapterNotConfigured" | "workspace.errors.translationFailed" | "workspace.errors.localeAlreadyExists" | "workspace.errors.sourceLocale" | "workspace.errors.invalidLocale" | "workspace.errors.targetLocaleMissing" | "workspace.errors.partialFailure" | "workspace.errors.cancelled"; type TranslationWorkspaceDetailedKey = "workspace.header.title" | "workspace.header.sourceLocale" | "workspace.header.targetLocale" | "workspace.header.addLocale" | "workspace.header.removeLocale" | "workspace.header.translateAll" | "workspace.header.cancel" | "workspace.header.retry" | "workspace.header.progress" | "workspace.header.batchProgress" | "workspace.slot.sourceText" | "workspace.slot.translatedText" | "workspace.slot.translateSingle" | "workspace.slot.revertManual" | "workspace.confirm.removeLocaleTitle" | "workspace.confirm.removeLocaleMessage" | "workspace.confirm.removeLocaleTranslatedCount" | "workspace.confirm.cancel" | "workspace.confirm.remove" | "workspace.empty.noTargetLocales" | "workspace.empty.noSlotsToTranslate"; type TranslationComparisonTranslationKey = "workspace.comparison.title" | "workspace.comparison.emptyStateTitle" | "workspace.comparison.sourceHeader" | "workspace.comparison.targetHeader" | "workspace.comparison.property.title" | "workspace.comparison.property.description" | "workspace.comparison.property.label" | "workspace.comparison.property.completionMessage" | "workspace.comparison.property.closedMessage" | "workspace.comparison.property.notYetOpenMessage" | "workspace.comparison.nodeKind.form" | "workspace.comparison.nodeKind.page" | "workspace.comparison.nodeKind.field" | "workspace.comparison.nodeKind.option" | "workspace.comparison.emptySource" | "workspace.comparison.staleWarning" | "workspace.comparison.placeholder.title" | "workspace.comparison.placeholder.completionMessage" | "workspace.comparison.placeholder.question" | "workspace.comparison.placeholder.option"; type FormEngineTranslationKey = KnownBuilderTranslationKey | RendererTranslationKey | ContentResultTranslationKey | TranslationWorkspaceTranslationKey | TranslationWorkspaceDetailedKey | TranslationComparisonTranslationKey; type FormEngineMessages = Partial>; interface SensitiveDataFinding { readonly fieldId: string; readonly type: string; readonly start?: number; readonly end?: number; readonly matchedText?: string; readonly maskedText?: string; } interface PrivacyEngine { detect(schema: FormSchema, values: Record): readonly SensitiveDataFinding[]; } interface SubmissionValidationResult { readonly valid: boolean; readonly fieldErrors: Readonly>; readonly formErrors: readonly string[]; readonly piiFindings?: readonly SensitiveDataFinding[]; } /** A Zod-compatible schema accepted by storage and RPC integrations. */ interface SubmissionSchema { readonly safeParse: (value: unknown) => { readonly success: true; readonly data: TOutput; } | { readonly success: false; readonly error: unknown; }; } type FormSubmissionValidatorResult = undefined | boolean | SubmissionValidationResult; /** Application-owned submission validation callback. */ type FormSubmissionValidator = (submission: FormSubmission) => unknown | Promise; type FormSubmissionValidationSource = FormSchema | SubmissionSchema | FormSubmissionValidator; /** Validates one non-empty field value with the same rules used by form submission validation. */ declare function validateFieldValue(field: FormField, value: FormValue): boolean; declare function validateAnswers(schema: FormSchema, values: FormValues): AnswerValidationResult; declare function validatePageAnswers(schema: FormSchema, pageIndex: number, values: FormValues): AnswerValidationResult; declare function validateSubmission(schema: FormSchema, submission: FormSubmission, options?: { readonly privacyEngine?: PrivacyEngine; }): SubmissionValidationResult; type Result = { readonly success: true; readonly value: T; } | { readonly success: false; readonly error: E; }; type FormVersionStatus = "draft" | "published" | "archived"; interface FormVersionRecord extends ExtensibleNode { readonly formId: string; readonly version: number; readonly status: FormVersionStatus; readonly schema: FormSchema; readonly revision: number; readonly createdFromVersion?: number; readonly createdAt: string; readonly publishedAt?: string; readonly archivedAt?: string; } interface FormVersionState { readonly formId: string; readonly draftVersion?: number; readonly publishedVersion?: number; readonly nextVersion: number; readonly revision: number; } interface VersionTransitionEvent { readonly type: "draft.created" | "draft.deleted" | "version.published" | "version.archived"; readonly formId: string; readonly fromRevision: number; readonly toRevision: number; readonly affectedVersions: readonly number[]; readonly occurredAt: string; } type VersionTransitionError = { readonly type: "draft_already_exists"; readonly currentDraftVersion: number; } | { readonly type: "draft_not_found"; } | { readonly type: "missing_published_record"; readonly expectedVersion: number; } | { readonly type: "form_id_mismatch"; } | { readonly type: "invalid_published_status"; } | { readonly type: "unexpected_published_record"; } | { readonly type: "revision_conflict"; readonly expectedRevision: number; readonly actualRevision: number; } | { readonly type: "invalid_source_version"; readonly requestedVersion: number; readonly publishedVersion?: number; } | { readonly type: "version_immutable"; readonly status: FormVersionStatus; } | { readonly type: "max_version_exceeded"; readonly max: number; } | { readonly type: "validation_failed"; readonly issues: readonly SchemaIssue[]; } | { readonly type: "transition_failed"; readonly cause: unknown; }; interface VersionTransitionContext { readonly formId: string; readonly fromVersion: number; readonly toVersion: number; readonly expectedRevision: number; readonly plan: FormVersionTransitionPlan; readonly domainData?: TDomain; } type FormVersionTransitionPlan = VersionTransitionPlan; interface CommitVersionTransitionOptions { readonly context: VersionTransitionContext; readonly beforeTransition?: (context: VersionTransitionContext) => Promise | TDomain | void; readonly afterTransition?: (context: VersionTransitionContext & { readonly nextRevision: number; }) => Promise | void; readonly persistAdapter: (params: { readonly formId: string; readonly targetVersion: number; readonly expectedRevision: number; readonly schema: FormSchema; readonly domainData?: TDomain; }) => Promise<{ readonly nextRevision: number; }>; } interface CloneVersionOptions { readonly maxVersions?: number; readonly expectedRevision?: number; readonly clonedAt?: string; readonly metadata?: Readonly>; /** Additional known published versions that may be used as a clone source. */ readonly allowedSourceVersions?: readonly number[]; } interface PublishDraftOptions { readonly expectedRevision?: number; readonly currentPublishedRecord?: FormVersionRecord; readonly validate?: (schema: FormSchema) => boolean | Promise | readonly SchemaIssue[] | Promise; readonly publishedAt?: string; /** @deprecated Use publishedAt. */ readonly timestamp?: string; } interface DeleteDraftOptions { readonly expectedRevision?: number; readonly deletedAt?: string; } interface PublishDraftResult { readonly nextState: FormVersionState; readonly publishedRecord: FormVersionRecord; readonly archivedRecords: readonly FormVersionRecord[]; /** @deprecated Read archivedRecords instead. */ readonly archivedVersion?: number; } declare function cloneVersionToDraft(state: FormVersionState, sourceSchema: FormSchema, options?: CloneVersionOptions): Result<{ readonly nextState: FormVersionState; readonly draftSchema: FormSchema; }, VersionTransitionError>; declare function createCloneTransitionPlan(state: FormVersionState, sourceRecord: FormVersionRecord, options?: CloneVersionOptions): Result<{ readonly nextState: FormVersionState; readonly plan: VersionTransitionPlan; }, VersionTransitionError>; declare function publishDraft(state: FormVersionState, draftSchema: FormSchema, options?: PublishDraftOptions): Promise>; declare function createPublishTransitionPlan(state: FormVersionState, draftRecord: FormVersionRecord, options?: PublishDraftOptions): Promise>; declare function deleteDraft(state: FormVersionState, options?: DeleteDraftOptions): Result<{ readonly nextState: FormVersionState; }, VersionTransitionError>; declare function createDeleteDraftTransitionPlan(state: FormVersionState, draftRecord: FormVersionRecord, options?: DeleteDraftOptions): Result<{ readonly nextState: FormVersionState; readonly plan: VersionTransitionPlan; }, VersionTransitionError>; declare function assertVersionMutable(status: FormVersionStatus): void; declare function applyTransitionPlan(plan: FormVersionTransitionPlan): FormSchema; declare function commitVersionTransition(options: CommitVersionTransitionOptions): Promise<{ readonly success: boolean; readonly nextRevision: number; readonly error?: VersionTransitionError; }>; type FieldType = "text" | "textarea" | "number" | "rating" | "date" | "time" | "email" | "tel" | "url" | "select" | "multi-select" | "checkbox" | "radio"; type QuestionType = FieldType; interface BaseFieldConstraintRule { readonly defaultRequired?: boolean; readonly fixedRequired?: boolean; } interface RatingFieldConstraintRule extends BaseFieldConstraintRule { readonly defaultMin?: number; readonly defaultMax?: number; readonly fixedMin?: number; readonly fixedMax?: number; readonly allowedMinRange?: readonly [number, number]; readonly allowedMaxRange?: readonly [number, number]; } interface TextFieldConstraintRule extends BaseFieldConstraintRule { readonly defaultMaxLength?: number; readonly maxMaxLength?: number; } interface ChoiceFieldConstraintRule extends BaseFieldConstraintRule { readonly minOptions?: number; readonly maxOptions?: number; } type FieldConstraintRule = RatingFieldConstraintRule | TextFieldConstraintRule | ChoiceFieldConstraintRule | BaseFieldConstraintRule; interface FormPolicy { readonly contentMode?: ContentModeSettings; readonly allowedFieldTypes?: readonly FieldType[]; readonly maxFields?: number; readonly maxOptionsPerField?: number; readonly requiredLocales?: readonly string[]; readonly allowedLocales?: readonly string[]; readonly maxLocales?: number; readonly maxTextLength?: number; readonly maxSchemaBytes?: number; /** Per-question-type defaults and immutable or bounded field constraints. */ readonly fieldConstraints?: Partial>; } type ConditionOperator = "equals" | "not_equals" | "contains" | "not_contains" | "is_empty" | "is_not_empty" | "greater_than" | "less_than" /** @deprecated Use is_not_empty instead. */ | "not_empty"; type ConditionValue = string | number | boolean; type JsonValue = string | number | boolean | null | readonly JsonValue[] | { readonly [key: string]: JsonValue; }; interface BaseSubmissionMetadata { readonly [key: string]: JsonValue | undefined; } /** A contract or tenant-managed locale and its translation capabilities. */ interface LocaleOption { /** Canonical BCP 47 locale tag. */ readonly locale: string; /** Human-readable locale name. */ readonly label: string; /** Whether automatic translation is allowed for this locale. Defaults to true. */ readonly translatable?: boolean; /** Whether the locale may be removed from the form. Defaults to true. */ readonly removable?: boolean; readonly metadata?: Readonly>; } /** Arbitrary, JSON-serializable data preserved by every form-engine operation. */ interface ExtensibleNode { readonly metadata?: Readonly>; /** Locale -> translated property -> metadata created for that translation. */ readonly translationMetadata?: Readonly>>>>>; } interface DisplayCondition { readonly questionId: string; readonly operator: ConditionOperator; readonly value?: ConditionValue; } interface FieldDisplayCondition { readonly fieldId: string; readonly operator: ConditionOperator; readonly value?: unknown; } interface DisplayConditionGroup { readonly logic: "all" | "any"; readonly conditions: readonly (FieldDisplayCondition | DisplayConditionGroup)[]; } interface DisplayRule { readonly action: "show" | "hide"; readonly condition: DisplayConditionGroup; } interface LocalizedText { readonly title?: string; readonly description?: string; readonly completionMessage?: string; readonly closedMessage?: string; readonly notYetOpenMessage?: string; } type SchemaTranslations = Readonly>; type ValidationCode = "required" | "invalid_type" | "min_length" | "max_length" | "pattern" | "min" | "max" | "step" | "invalid_option" | "min_selections" | "max_selections" | "invalid_format" | "unknown_field"; interface FieldOption extends ExtensibleNode { readonly id: string; readonly label: string; readonly textInput?: boolean; readonly pinned?: boolean; readonly translations?: Readonly>; } interface BaseField extends ExtensibleNode { readonly id: string; readonly type: FieldType; readonly title: string; readonly description?: string; readonly translationKey?: string; readonly required: boolean; readonly messages?: Partial>; readonly displayCondition?: DisplayCondition; readonly displayRule?: DisplayRule; readonly translations?: SchemaTranslations; } interface TextField extends BaseField { readonly type: "text" | "textarea"; readonly placeholderKey?: string; readonly minLength?: number; readonly maxLength?: number; readonly pattern?: string; } interface DateField extends BaseField { readonly type: "date"; readonly placeholderKey?: string; readonly minDate?: string; readonly maxDate?: string; } interface TimeField extends BaseField { readonly type: "time"; readonly placeholderKey?: string; readonly minTime?: string; readonly maxTime?: string; } interface EmailField extends BaseField { readonly type: "email"; readonly placeholderKey?: string; } interface TelField extends BaseField { readonly type: "tel"; readonly placeholderKey?: string; } interface UrlField extends BaseField { readonly type: "url"; readonly placeholderKey?: string; } interface NumberField extends BaseField { readonly type: "number"; readonly placeholderKey?: string; readonly min?: number; readonly max?: number; readonly step?: number; } interface RatingField extends BaseField { readonly type: "rating"; readonly min?: number; readonly max?: number; } interface SelectField extends BaseField { readonly type: "select" | "radio"; readonly options: readonly FieldOption[]; readonly shuffleOptions?: boolean; } interface MultiSelectField extends BaseField { readonly type: "multi-select"; readonly options: readonly FieldOption[]; readonly shuffleOptions?: boolean; readonly minSelections?: number; readonly maxSelections?: number; } interface CheckboxField extends BaseField { readonly type: "checkbox"; } type FormField = TextField | DateField | TimeField | EmailField | TelField | UrlField | NumberField | RatingField | SelectField | MultiSelectField | CheckboxField; interface FormPage extends ExtensibleNode { readonly id: string; readonly title?: string; readonly description?: string; readonly questionIds: readonly string[]; readonly displayCondition?: DisplayCondition; readonly translations?: SchemaTranslations; } interface FormSchema extends ExtensibleNode { readonly id: string; readonly version: number; readonly title: string; readonly description?: string; readonly completionMessage?: string; readonly submitLabelKey?: string; readonly defaultLocale?: string; readonly supportedLocales?: readonly string[]; readonly translations?: SchemaTranslations; readonly fields: readonly FormField[]; readonly pages?: readonly FormPage[]; readonly submissionSettings?: FormSubmissionSettings; } /** Metadata-typed schema view that keeps the legacy FormSchema contract unchanged. */ type TypedExtensibleNode> = Readonly>, TTranslationMetadata extends Readonly> = Readonly>> = Omit & { readonly metadata?: TMetadata; readonly translationMetadata?: Readonly>>>; }; type TypedFieldOption> = Readonly>, TTranslationMetadata extends Readonly> = Readonly>> = Omit & TypedExtensibleNode; type TypedFormFieldVariant>, TTranslationMetadata extends Readonly>> = Omit & TypedExtensibleNode & (TField extends { readonly options: readonly FieldOption[]; } ? { readonly options: readonly TypedFieldOption[]; } : object); type TypedFormField> = Readonly>, TTranslationMetadata extends Readonly> = Readonly>> = FormField extends infer TField ? TField extends FormField ? TypedFormFieldVariant : never : never; type TypedFormSchema> = Readonly>, TTranslationMetadata extends Readonly> = Readonly>> = Omit & TypedExtensibleNode & { readonly fields: readonly TypedFormField[]; }; interface FormSubmissionSettings extends ExtensibleNode { readonly showConfirmationBeforeSubmit?: boolean; readonly confirmationRenderMode?: "dialog" | "inline" | "replace"; readonly confirmButtonLabel?: string; readonly cancelButtonLabel?: string; readonly openAt?: string; readonly closeAt?: string; readonly maxResponses?: number; readonly closedMessage?: string; readonly notYetOpenMessage?: string; readonly honeypotFieldId?: string; } interface RadioTextAnswer { readonly optionId: string; readonly text: string; } type FormValue = string | number | boolean | readonly string[] | RadioTextAnswer | undefined; type FormValues = Readonly>; interface SchemaIssue { readonly path: string; readonly code: string; readonly message: string; /** Compatibility discriminator for structured policy issues. */ readonly type?: string; /** Present for policy issues that identify a field property and its expected value. */ readonly fieldId?: string; readonly property?: string; readonly expected?: boolean | number | readonly [number, number]; readonly cycle?: readonly string[]; } type SchemaValidationResult = { readonly valid: true; readonly value: FormSchema; readonly issues: readonly []; } | { readonly valid: false; readonly issues: readonly SchemaIssue[]; }; interface ValidationIssue { readonly fieldId: string; readonly code: ValidationCode; readonly messageKey: string; readonly params: Readonly>; } type ValidationError = ValidationIssue; type AnswerValidationResult = { readonly valid: true; readonly issues: readonly []; } | { readonly valid: false; readonly issues: readonly ValidationIssue[]; }; interface FormSubmissionBase extends Pick { readonly id: string; readonly formId: string; readonly formVersion: number; readonly locale?: string; readonly values: FormValues; readonly submittedAt: string; readonly schemaRevision?: number; } type FormSubmission = FormSubmissionBase & ([TMeta] extends [undefined] ? { readonly metadata?: BaseSubmissionMetadata; } : { readonly metadata: TMeta; }); type SubmissionSaveResult = { readonly status: "created"; readonly submission: FormSubmission; readonly payloadHash: string; } | { readonly status: "duplicate"; readonly submission: FormSubmission; readonly payloadHash: string; } | { readonly status: "conflict"; readonly submissionId: string; readonly payloadHash: string; readonly existingPayloadHash: string; }; interface SaveSubmissionOptions { /** Return a typed duplicate/conflict result instead of propagating a duplicate-key error. */ readonly idempotent?: boolean; /** Re-fetch and validate the stored FormSchema before persisting. */ readonly validateAgainstSchema?: boolean; /** Validate with an explicitly supplied FormSchema, Zod-compatible schema, or callback. */ readonly validation?: FormSubmissionValidationSource; /** Alias for `validation` for adapters that expose a validator-oriented API. */ readonly validator?: FormSubmissionValidationSource; /** Explicit schema alias for adapters that expose schema-oriented options. */ readonly schema?: FormSubmissionValidationSource; } /** A submission whose persisted or transport representation always includes a locale. */ interface StrictFormSubmission extends Omit { readonly values: Readonly>; readonly locale: string; readonly metadata: TMeta; } /** Clean network and persistence representation of a form submission. */ interface FormSubmissionWire { readonly id: string; readonly formId: string; readonly formVersion: number; readonly values: Readonly>; readonly locale?: string; readonly metadata: TMeta; readonly submittedAt: string; readonly schemaRevision?: number; } /** Strict wire representation used by integrations that require a locale. */ interface StrictFormSubmissionWire extends Omit, "locale"> { readonly locale: string; } interface CreateSubmissionInput { readonly id?: string; readonly idFormat?: "uuid" | "ulid" | "custom"; readonly formId: string; readonly formVersion: number; readonly answers: Record; readonly metadata: TMeta; readonly submittedAt?: string; readonly schemaRevision?: number; } interface TranslationAdapter { /** Return null or undefined when the key cannot be resolved by the adapter. */ translate(key: string, locale: string, params?: Readonly>): string | undefined | null; } interface AsyncTranslationAdapter { translateText(text: string, targetLocale: string, sourceLocale?: string, signal?: AbortSignal): Promise; translateBatch(texts: readonly string[], targetLocale: string, sourceLocale?: string, signal?: AbortSignal): Promise; } interface SubmissionQueryOptions { readonly since?: string; readonly until?: string; } interface StorageAdapter { saveSubmission(submission: FormSubmission): Promise; /** Atomically saves a submission only while the form version remains below its response limit. */ saveSubmissionWithinLimit?(submission: FormSubmission, maxResponses: number, options?: SaveSubmissionOptions): Promise; countSubmissions(formId: string, formVersion?: number, options?: SubmissionQueryOptions): Promise; listSubmissions(formId: string, formVersion?: number, options?: SubmissionQueryOptions): Promise; clearResponses?(formId: string): Promise; clear(): Promise; } interface FormStorageAdapter extends StorageAdapter { saveSchema(schema: FormSchema): Promise; getSchema(formId: string, formVersion: number): Promise; listSchemas(): Promise; deleteSchema(formId: string, formVersion: number): Promise; deleteSubmission(submissionId: string): Promise; readonly inspectFormDeletion?: FormLifecycleAdapter["inspectFormDeletion"]; readonly deleteForm?: FormLifecycleAdapter["deleteForm"]; readonly lifecycleCapabilities?: FormLifecycleAdapter["lifecycleCapabilities"]; } interface SubmissionPageQueryOptions { readonly version?: number; readonly cursor?: string; readonly pageSize?: number; readonly since?: string; readonly until?: string; readonly locale?: string; readonly filter?: SubmissionFilter | ((submission: FormSubmission) => boolean); /** @deprecated Prefer the generic filter AST. */ readonly metadataFilters?: Readonly>; } interface TextAnswerPageQueryOptions extends SubmissionPageQueryOptions { readonly fieldIds?: readonly string[]; } type SubmissionFilter = { readonly op: "eq"; readonly path: string; readonly value: JsonValue; } | { readonly op: "in"; readonly path: string; readonly values: readonly JsonValue[]; } | { readonly op: "range"; readonly path: string; readonly from?: JsonValue; readonly to?: JsonValue; } | { readonly op: "exists"; readonly path: string; readonly value: boolean; } | { readonly op: "and"; readonly filters: readonly SubmissionFilter[]; } | { readonly op: "or"; readonly filters: readonly SubmissionFilter[]; }; interface SubmissionPage { readonly items: readonly FormSubmission[]; readonly nextCursor?: string; readonly hasMore: boolean; } interface PagedSubmissionStorageAdapter extends FormStorageAdapter { listSubmissionPage(formId: string, options?: SubmissionPageQueryOptions): Promise; listTextAnswerPage?(formId: string, fieldIdOrOptions?: string | TextAnswerPageQueryOptions, options?: TextAnswerPageQueryOptions): Promise; } /** Metadata-typed submission contract for application-owned storage adapters. */ interface TypedStorageAdapter { saveSubmission(submission: FormSubmission): Promise; countSubmissions(formId: string, formVersion?: number, options?: SubmissionQueryOptions): Promise; listSubmissions(formId: string, formVersion?: number, options?: SubmissionQueryOptions): Promise[]>; clearResponses?(formId: string): Promise; clear(): Promise; } /** Metadata-typed form storage contract. */ interface TypedFormStorageAdapter extends TypedStorageAdapter { saveSchema(schema: FormSchema): Promise; getSchema(formId: string, formVersion: number): Promise; listSchemas(): Promise; deleteSchema(formId: string, formVersion: number): Promise; deleteSubmission(submissionId: string): Promise; } /** Metadata-typed query options for paged storage. */ interface TypedSubmissionPageQueryOptions { readonly version?: number; readonly cursor?: string; readonly pageSize?: number; readonly since?: string; readonly until?: string; /** @deprecated Use `since`. */ readonly fromSubmittedAt?: string; /** @deprecated Use `until`. */ readonly toSubmittedAt?: string; readonly locale?: string; readonly filter?: SubmissionFilter | ((submission: FormSubmission) => boolean); readonly metadataFilters?: Readonly>; } /** Metadata-typed page returned by application-owned paged storage. */ interface TypedSubmissionPage { readonly items: readonly FormSubmission[]; readonly nextCursor?: string; readonly hasMore: boolean; } /** Metadata-typed paged form storage contract. */ interface TypedPagedSubmissionStorageAdapter extends TypedFormStorageAdapter { listSubmissionPage(formId: string, options?: TypedSubmissionPageQueryOptions): Promise>; } /** * Common submission-only contract for storage adapters that support typed saves and cursor paging. * MongoDB and Azure Table implementations expose this same surface so callers do not need an * adapter-specific branch. */ interface UnifiedSubmissionStorageAdapter { saveSubmission(submission: FormSubmission, options?: SaveSubmissionOptions): Promise>; /** Atomically saves a submission only while the form version remains below its response limit. */ saveSubmissionWithinLimit(submission: FormSubmission, maxResponses: number, options?: SaveSubmissionOptions): Promise | { readonly status: "limit_reached"; }>; listSubmissionPage(formId: string, options?: TypedSubmissionPageQueryOptions): Promise>; listTextAnswerPage(formId: string, fieldIdOrOptions?: string | TextAnswerPageQueryOptions, options?: TextAnswerPageQueryOptions): Promise>; countSubmissions(formId: string, formVersion?: number, options?: SubmissionQueryOptions): Promise; aggregateResponses(schema: FormSchema, options?: TypedSubmissionPageQueryOptions): Promise; exportResponsesToCsv(schema: FormSchema, options?: StorageSubmissionExportOptions): Promise; validateSubmission(submission: FormSubmission, source?: FormSubmissionValidationSource): Promise; } interface StorageSubmissionExportOptions extends Omit, "customColumns" | "includeMetadataFields"> { readonly query?: TypedSubmissionPageQueryOptions; readonly customColumns?: TMeta extends BaseSubmissionMetadata ? MetadataCsvExportOptions["customColumns"] : MetadataCsvExportOptions["customColumns"]; readonly includeMetadataFields?: TMeta extends BaseSubmissionMetadata ? MetadataCsvExportOptions["includeMetadataFields"] : MetadataCsvExportOptions["includeMetadataFields"]; } interface TextAnswerItem { readonly responseId: string; readonly formId: string; readonly formVersion: number; readonly fieldId: string; readonly text: string; readonly locale?: string; readonly submittedAt: string; readonly metadata?: Readonly>; } interface TextAnswerPage { readonly items: readonly TextAnswerItem[]; readonly nextCursor?: string; readonly hasMore: boolean; } /** Text-answer page retaining the metadata type of the source submission. */ interface TypedTextAnswerItem extends Omit { readonly metadata?: [TMeta] extends [undefined] ? Readonly> : TMeta; } interface TypedTextAnswerPage { readonly items: readonly TypedTextAnswerItem[]; readonly nextCursor?: string; readonly hasMore: boolean; } interface VersionTransitionPlan { readonly formId: string; readonly expectedRevision: number; readonly nextRevision: number; readonly draftToCreate?: FormVersionRecord; readonly draftToDeleteVersion?: number; readonly publishedRecordToSave?: FormVersionRecord; readonly archivedRecordsToSave?: readonly FormVersionRecord[]; readonly events: readonly VersionTransitionEvent[]; /** The complete next state value used by persistent adapters. */ readonly nextVersion?: number; /** Optional target schema for adapters that do not use a version record. */ readonly schema?: FormSchema; readonly timestamp: string; } type StorageCommitError = { readonly type: "revision_conflict"; readonly expectedRevision: number; readonly actualRevision?: number; } | { readonly type: "draft_already_exists"; readonly currentDraftVersion: number; } | { readonly type: "transaction_unsupported"; } | { readonly type: "invalid_transition"; readonly message: string; } | { readonly type: "storage_error"; readonly cause: unknown; }; interface VersionedFormStorageAdapter extends FormStorageAdapter { getVersionState(formId: string): Promise; getVersionRecord(formId: string, version: number): Promise; listVersionRecords(formId: string): Promise; commitVersionTransition(plan: VersionTransitionPlan): Promise>; } interface BaseQuestionAggregate { readonly fieldId: string; readonly answeredCount: number; readonly unansweredCount: number; } interface TextQuestionAggregate extends BaseQuestionAggregate { readonly kind: "text" | "textarea" | "date" | "time" | "email" | "tel" | "url"; } interface NumberQuestionAggregate extends BaseQuestionAggregate { readonly kind: "number" | "rating"; readonly minimum: number | null; readonly maximum: number | null; readonly average: number | null; readonly total: number; } interface OptionAggregate { readonly id: string; readonly count: number; readonly percentageOfSubmissions: number; } interface ChoiceQuestionAggregate extends BaseQuestionAggregate { readonly kind: "select" | "radio" | "multi-select"; readonly options: readonly OptionAggregate[]; } interface CheckboxQuestionAggregate extends BaseQuestionAggregate { readonly kind: "checkbox"; readonly trueCount: number; readonly falseCount: number; readonly truePercentageOfSubmissions: number; readonly falsePercentageOfSubmissions: number; } type QuestionAggregate = TextQuestionAggregate | NumberQuestionAggregate | ChoiceQuestionAggregate | CheckboxQuestionAggregate; interface FormAnalytics { readonly formId: string; readonly formVersion: number; readonly submissionCount: number; readonly questions: readonly QuestionAggregate[]; } type Question = FormField; type ChoiceOption = FieldOption; interface FieldTypeDefinition { readonly type: QuestionType; readonly labelKey: BuilderTranslationKey; readonly defaultLabel: string; readonly category: "text" | "choice" | "number" | "advanced"; readonly hasOptions: boolean; } interface FormResponse extends ExtensibleNode { readonly responseId: string; readonly formId: string; readonly formVersion?: number; readonly sourceLocale?: string; readonly answers: Readonly>; readonly submittedAt: string; } interface CrossTabulationResult { readonly rowQuestionId: string; readonly colQuestionId: string; readonly matrix: Readonly>>>; readonly rowTotals: Readonly>; readonly colTotals: Readonly>; readonly grandTotal: number; } type FormAcceptanceStatus = "open" | "not_yet_open" | "closed" | "limit_reached"; type FormAcceptanceResult = { readonly status: "open"; readonly accepted: true; } | { readonly status: Exclude; readonly accepted: false; }; declare function getFormAcceptanceStatus(schema: FormSchema, options?: { readonly now?: Date; readonly submissionCount?: number; }): FormAcceptanceResult; type AggregationSkipReason = "missing_field" | "type_mismatch" | "invalid_option" | "unsupported_version" | "locale_mismatch" | "pii_unconfirmed"; interface AggregationReport { readonly totalProcessed: number; readonly aggregatedCount: number; readonly skippedItems: readonly { readonly submissionId: string; readonly fieldId: string; readonly reason: AggregationSkipReason; }[]; } type AuthoringIntent = "generate_form" | "add_questions" | "improve_text" | "generate_options" | "rewrite_field"; type AuthoringTarget = { readonly kind: "form"; } | { readonly kind: "field"; readonly fieldId: string; } | { readonly kind: "option"; readonly fieldId: string; readonly optionId: string; }; interface AuthoringRequest { readonly intent: AuthoringIntent; readonly prompt?: string; readonly target?: AuthoringTarget; readonly context?: Readonly>; } interface AuthoringAssistantAdapter { generate: (request: AuthoringRequest, signal?: AbortSignal) => Promise; } interface AuthoringOptionInput { readonly label: string; readonly textInput?: boolean; readonly pinned?: boolean; } /** A field proposed by AI. IDs are deliberately absent and are assigned on apply. */ interface AuthoringFieldInput { readonly type: QuestionType; readonly title: string; readonly description?: string; readonly required?: boolean; readonly translationKey?: string; readonly messages?: FormField["messages"]; readonly placeholderKey?: string; readonly minLength?: number; readonly maxLength?: number; readonly pattern?: string; readonly minDate?: string; readonly maxDate?: string; readonly minTime?: string; readonly maxTime?: string; readonly min?: number; readonly max?: number; readonly step?: number; readonly shuffleOptions?: boolean; readonly minSelections?: number; readonly maxSelections?: number; readonly options?: readonly AuthoringOptionInput[]; } interface AddFieldOperation { readonly operationId: string; readonly type: "addField"; readonly field: AuthoringFieldInput; readonly pageId?: string; } type AuthoringFieldPatch = Readonly<{ readonly title?: string; readonly description?: string; readonly required?: boolean; readonly placeholderKey?: string; readonly minLength?: number; readonly maxLength?: number; readonly pattern?: string; readonly minDate?: string; readonly maxDate?: string; readonly minTime?: string; readonly maxTime?: string; readonly min?: number; readonly max?: number; readonly step?: number; readonly shuffleOptions?: boolean; readonly minSelections?: number; readonly maxSelections?: number; readonly messages?: FormField["messages"]; }>; interface UpdateFieldOperation { readonly operationId: string; readonly type: "updateField"; readonly fieldId: string; readonly patch: AuthoringFieldPatch; } interface UpdateFormOperation { readonly operationId: string; readonly type: "updateForm"; readonly patch: Readonly>>; } interface AddOptionOperation { readonly operationId: string; readonly type: "addOption"; readonly fieldId: string; readonly option: AuthoringOptionInput; } interface UpdateOptionOperation { readonly operationId: string; readonly type: "updateOption"; readonly fieldId: string; readonly optionId: string; readonly patch: Readonly>>; } type AuthoringOperation = AddFieldOperation | UpdateFieldOperation | UpdateFormOperation | AddOptionOperation | UpdateOptionOperation; interface AuthoringSuggestion { readonly id: string; readonly summary: string; readonly operations: readonly AuthoringOperation[]; readonly rationale?: string; readonly baseSchemaHash: string; } type AuthoringValidationCode = "invalid_suggestion" | "duplicate_operation_id" | "unsupported_operation" | "stale_schema" | "field_not_found" | "option_not_found" | "page_not_found" | "disallowed_field_type" | "max_fields_exceeded" | "max_options_exceeded" | "max_text_length_exceeded" | "schema_invalid" | "policy_violation"; interface AuthoringValidationIssue { readonly code: AuthoringValidationCode; readonly operationId?: string; readonly path?: string; readonly message: string; } interface AuthoringValidationResult { readonly valid: boolean; readonly issues: readonly AuthoringValidationIssue[]; } type AuthoringPreviewValue = { readonly kind: "form"; readonly title?: string; readonly description?: string; readonly completionMessage?: string; readonly submitLabelKey?: string; } | { readonly kind: "field"; readonly field?: FormField | AuthoringFieldInput; } | { readonly kind: "option"; readonly option?: FieldOption | AuthoringOptionInput; }; interface AuthoringOperationPreview { readonly operationId: string; readonly operation: AuthoringOperation; readonly valid: boolean; readonly before?: AuthoringPreviewValue; readonly after?: AuthoringPreviewValue; readonly issues: readonly AuthoringValidationIssue[]; } interface AuthoringPreview { readonly valid: boolean; readonly baseSchemaHash: string; readonly schema: FormSchema; readonly operations: readonly AuthoringOperation[]; readonly operationPreviews: readonly AuthoringOperationPreview[]; readonly issues: readonly AuthoringValidationIssue[]; } interface AuthoringPreviewOptions { readonly operationIds?: readonly string[]; readonly policy?: FormPolicy; readonly idFactory?: AuthoringApplyOptions["idFactory"]; } type AuthoringApplyError = { readonly code: "stale_schema"; readonly issues: readonly AuthoringValidationIssue[]; } | { readonly code: "validation_failed"; readonly issues: readonly AuthoringValidationIssue[]; } | { readonly code: "apply_failed"; readonly issues: readonly AuthoringValidationIssue[]; }; type AuthoringApplyResult = { readonly success: true; readonly schema: FormSchema; readonly appliedOperationIds: readonly string[]; } | { readonly success: false; readonly error: AuthoringApplyError; }; interface AuthoringApplyOptions { readonly policy?: FormPolicy; readonly idFactory?: (kind: "field" | "option", existingIds: ReadonlySet) => string; } declare function applyAuthoringSuggestion(schema: FormSchema, suggestion: AuthoringSuggestion, selectedOperationIds?: readonly string[], options?: AuthoringApplyOptions): AuthoringApplyResult; interface BuildAuthoringContextOptions { readonly schema: FormSchema; readonly request: AuthoringRequest; readonly policy?: FormPolicy; } interface AuthoringContext extends Readonly> { readonly fields: readonly JsonValue[]; } declare function buildAuthoringContext({ schema, request, policy }: BuildAuthoringContextOptions): AuthoringContext; /** Deterministic, local fingerprint for stale-suggestion protection. */ declare function computeAuthoringSchemaHash(schema: FormSchema): string; declare const AuthoringSuggestionSchema: z.ZodObject<{ id: z.ZodString; summary: z.ZodString; operations: z.ZodArray; field: z.ZodObject<{ type: z.ZodEnum<{ number: "number"; text: "text"; select: "select"; radio: "radio"; "multi-select": "multi-select"; textarea: "textarea"; date: "date"; time: "time"; email: "email"; tel: "tel"; url: "url"; rating: "rating"; checkbox: "checkbox"; }>; title: z.ZodString; description: z.ZodOptional; required: z.ZodOptional; translationKey: z.ZodOptional; messages: z.ZodOptional>; placeholderKey: z.ZodOptional; minLength: z.ZodOptional; maxLength: z.ZodOptional; pattern: z.ZodOptional; minDate: z.ZodOptional; maxDate: z.ZodOptional; minTime: z.ZodOptional; maxTime: z.ZodOptional; min: z.ZodOptional; max: z.ZodOptional; step: z.ZodOptional; shuffleOptions: z.ZodOptional; minSelections: z.ZodOptional; maxSelections: z.ZodOptional; options: z.ZodOptional; pinned: z.ZodOptional; }, z.core.$strict>>>; }, z.core.$strict>; pageId: z.ZodOptional; }, z.core.$strict>, z.ZodObject<{ operationId: z.ZodString; type: z.ZodLiteral<"updateField">; fieldId: z.ZodString; patch: z.ZodObject<{ title: z.ZodOptional; description: z.ZodOptional; required: z.ZodOptional; placeholderKey: z.ZodOptional; minLength: z.ZodOptional; maxLength: z.ZodOptional; pattern: z.ZodOptional; minDate: z.ZodOptional; maxDate: z.ZodOptional; minTime: z.ZodOptional; maxTime: z.ZodOptional; min: z.ZodOptional; max: z.ZodOptional; step: z.ZodOptional; shuffleOptions: z.ZodOptional; minSelections: z.ZodOptional; maxSelections: z.ZodOptional; messages: z.ZodOptional>; }, z.core.$strict>; }, z.core.$strict>, z.ZodObject<{ operationId: z.ZodString; type: z.ZodLiteral<"updateForm">; patch: z.ZodObject<{ title: z.ZodOptional; description: z.ZodOptional; completionMessage: z.ZodOptional; submitLabelKey: z.ZodOptional; }, z.core.$strict>; }, z.core.$strict>, z.ZodObject<{ operationId: z.ZodString; type: z.ZodLiteral<"addOption">; fieldId: z.ZodString; option: z.ZodObject<{ label: z.ZodString; textInput: z.ZodOptional; pinned: z.ZodOptional; }, z.core.$strict>; }, z.core.$strict>, z.ZodObject<{ operationId: z.ZodString; type: z.ZodLiteral<"updateOption">; fieldId: z.ZodString; optionId: z.ZodString; patch: z.ZodObject<{ label: z.ZodOptional; textInput: z.ZodOptional; pinned: z.ZodOptional; }, z.core.$strict>; }, z.core.$strict>], "type">>; rationale: z.ZodOptional; baseSchemaHash: z.ZodString; }, z.core.$strict>; declare const AUTHORING_SUGGESTION_JSON_SCHEMA: z.core.ZodStandardJSONSchemaPayload; field: z.ZodObject<{ type: z.ZodEnum<{ number: "number"; text: "text"; select: "select"; radio: "radio"; "multi-select": "multi-select"; textarea: "textarea"; date: "date"; time: "time"; email: "email"; tel: "tel"; url: "url"; rating: "rating"; checkbox: "checkbox"; }>; title: z.ZodString; description: z.ZodOptional; required: z.ZodOptional; translationKey: z.ZodOptional; messages: z.ZodOptional>; placeholderKey: z.ZodOptional; minLength: z.ZodOptional; maxLength: z.ZodOptional; pattern: z.ZodOptional; minDate: z.ZodOptional; maxDate: z.ZodOptional; minTime: z.ZodOptional; maxTime: z.ZodOptional; min: z.ZodOptional; max: z.ZodOptional; step: z.ZodOptional; shuffleOptions: z.ZodOptional; minSelections: z.ZodOptional; maxSelections: z.ZodOptional; options: z.ZodOptional; pinned: z.ZodOptional; }, z.core.$strict>>>; }, z.core.$strict>; pageId: z.ZodOptional; }, z.core.$strict>, z.ZodObject<{ operationId: z.ZodString; type: z.ZodLiteral<"updateField">; fieldId: z.ZodString; patch: z.ZodObject<{ title: z.ZodOptional; description: z.ZodOptional; required: z.ZodOptional; placeholderKey: z.ZodOptional; minLength: z.ZodOptional; maxLength: z.ZodOptional; pattern: z.ZodOptional; minDate: z.ZodOptional; maxDate: z.ZodOptional; minTime: z.ZodOptional; maxTime: z.ZodOptional; min: z.ZodOptional; max: z.ZodOptional; step: z.ZodOptional; shuffleOptions: z.ZodOptional; minSelections: z.ZodOptional; maxSelections: z.ZodOptional; messages: z.ZodOptional>; }, z.core.$strict>; }, z.core.$strict>, z.ZodObject<{ operationId: z.ZodString; type: z.ZodLiteral<"updateForm">; patch: z.ZodObject<{ title: z.ZodOptional; description: z.ZodOptional; completionMessage: z.ZodOptional; submitLabelKey: z.ZodOptional; }, z.core.$strict>; }, z.core.$strict>, z.ZodObject<{ operationId: z.ZodString; type: z.ZodLiteral<"addOption">; fieldId: z.ZodString; option: z.ZodObject<{ label: z.ZodString; textInput: z.ZodOptional; pinned: z.ZodOptional; }, z.core.$strict>; }, z.core.$strict>, z.ZodObject<{ operationId: z.ZodString; type: z.ZodLiteral<"updateOption">; fieldId: z.ZodString; optionId: z.ZodString; patch: z.ZodObject<{ label: z.ZodOptional; textInput: z.ZodOptional; pinned: z.ZodOptional; }, z.core.$strict>; }, z.core.$strict>], "type">>; rationale: z.ZodOptional; baseSchemaHash: z.ZodString; }, z.core.$strict>>; declare function parseAuthoringSuggestion(value: unknown): AuthoringSuggestion; declare function validateAuthoringSuggestion(suggestion: AuthoringSuggestion, schema: FormSchema, policy?: FormPolicy): AuthoringValidationResult; declare function previewAuthoringSuggestion(schema: FormSchema, suggestion: AuthoringSuggestion, options?: AuthoringPreviewOptions): AuthoringPreview; interface SurveyCreationBrief { readonly purpose?: string; readonly audience?: string; readonly goals?: readonly string[]; readonly constraints?: { readonly targetQuestionCount?: number; readonly targetDurationMinutes?: number; readonly anonymous?: boolean; readonly tone?: "formal" | "neutral" | "casual"; }; readonly locale?: string; readonly contentMode?: FormContentMode; readonly notes?: readonly string[]; } type CreationBriefField = "purpose" | "audience" | "goals" | "constraints" | "locale" | "contentMode"; interface CreationQuickReply { readonly id: string; readonly label: string; readonly value: string; } interface CreationMessage { readonly role: "user" | "assistant"; readonly content: string; } interface CreationAssistantRequest { readonly latestMessage: string; readonly brief: SurveyCreationBrief; readonly messages?: readonly CreationMessage[]; readonly policy?: FormPolicy; readonly locale?: string; readonly contentMode?: FormContentMode; readonly appConstraints?: Readonly>; } interface CreationClarificationResponse { readonly type: "clarification"; readonly message: string; readonly brief: SurveyCreationBrief; readonly missing: readonly CreationBriefField[]; readonly suggestions?: readonly CreationQuickReply[]; } interface CreationReadyResponse { readonly type: "ready"; readonly message: string; readonly brief: SurveyCreationBrief; } type CreationAssistantResponse = CreationClarificationResponse | CreationReadyResponse; interface CreationAssistantAdapter { respond: (request: CreationAssistantRequest, signal?: AbortSignal) => Promise; } interface CreationBriefReadiness { readonly ready: boolean; readonly missing: readonly CreationBriefField[]; } interface CreationAuthoringRequestOptions { readonly brief: SurveyCreationBrief; readonly prompt?: string; readonly target?: AuthoringRequest["target"]; } type CreationDraftResult = { readonly success: true; readonly suggestion: AuthoringSuggestion; } | { readonly success: false; readonly error: unknown; }; declare const SurveyCreationBriefSchema: z.ZodObject<{ purpose: z.ZodOptional; audience: z.ZodOptional; goals: z.ZodOptional>; constraints: z.ZodOptional; targetDurationMinutes: z.ZodOptional; anonymous: z.ZodOptional; tone: z.ZodOptional>; }, z.core.$strict>>; locale: z.ZodOptional; contentMode: z.ZodOptional>; notes: z.ZodOptional>; }, z.core.$strict>; declare const CreationAssistantResponseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{ type: z.ZodLiteral<"clarification">; message: z.ZodString; brief: z.ZodObject<{ purpose: z.ZodOptional; audience: z.ZodOptional; goals: z.ZodOptional>; constraints: z.ZodOptional; targetDurationMinutes: z.ZodOptional; anonymous: z.ZodOptional; tone: z.ZodOptional>; }, z.core.$strict>>; locale: z.ZodOptional; contentMode: z.ZodOptional>; notes: z.ZodOptional>; }, z.core.$strict>; missing: z.ZodArray>; suggestions: z.ZodOptional>>; }, z.core.$strict>, z.ZodObject<{ type: z.ZodLiteral<"ready">; message: z.ZodString; brief: z.ZodObject<{ purpose: z.ZodOptional; audience: z.ZodOptional; goals: z.ZodOptional>; constraints: z.ZodOptional; targetDurationMinutes: z.ZodOptional; anonymous: z.ZodOptional; tone: z.ZodOptional>; }, z.core.$strict>>; locale: z.ZodOptional; contentMode: z.ZodOptional>; notes: z.ZodOptional>; }, z.core.$strict>; }, z.core.$strict>], "type">; declare const CREATION_ASSISTANT_RESPONSE_JSON_SCHEMA: z.core.ZodStandardJSONSchemaPayload; message: z.ZodString; brief: z.ZodObject<{ purpose: z.ZodOptional; audience: z.ZodOptional; goals: z.ZodOptional>; constraints: z.ZodOptional; targetDurationMinutes: z.ZodOptional; anonymous: z.ZodOptional; tone: z.ZodOptional>; }, z.core.$strict>>; locale: z.ZodOptional; contentMode: z.ZodOptional>; notes: z.ZodOptional>; }, z.core.$strict>; missing: z.ZodArray>; suggestions: z.ZodOptional>>; }, z.core.$strict>, z.ZodObject<{ type: z.ZodLiteral<"ready">; message: z.ZodString; brief: z.ZodObject<{ purpose: z.ZodOptional; audience: z.ZodOptional; goals: z.ZodOptional>; constraints: z.ZodOptional; targetDurationMinutes: z.ZodOptional; anonymous: z.ZodOptional; tone: z.ZodOptional>; }, z.core.$strict>>; locale: z.ZodOptional; contentMode: z.ZodOptional>; notes: z.ZodOptional>; }, z.core.$strict>; }, z.core.$strict>], "type">>; declare function parseSurveyCreationBrief(value: unknown): SurveyCreationBrief; declare function parseCreationAssistantResponse(value: unknown): CreationAssistantResponse; declare function mergeSurveyCreationBrief(current: SurveyCreationBrief, update: SurveyCreationBrief): SurveyCreationBrief; declare function evaluateCreationBriefReadiness(brief: SurveyCreationBrief): CreationBriefReadiness; declare function canGenerateCreationDraft(brief: SurveyCreationBrief, clarificationTurns: number, maxClarificationTurns?: number): boolean; type CrossFormSkipReason = "schema_missing" | "invalid_answers" | "not_quiz" | "evaluation_failed"; interface CrossFormAnalyticsOptions { readonly policy?: FormPolicy; readonly byLocale?: boolean; readonly byContentMode?: boolean; readonly metadata?: Readonly string | number | boolean | null | undefined>>; readonly scores?: boolean; readonly includeSkipDetails?: boolean; } interface CrossFormScoreSummary { readonly evaluatedCount: number; readonly averageScore: number | null; readonly scoreRate: number | null; readonly passCount: number; readonly passEligibleCount: number; readonly passRate: number | null; } interface CrossFormAnalytics { readonly processedCount: number; readonly aggregatedCount: number; readonly forms: readonly FormAnalytics[]; readonly groups: Readonly>; readonly scores?: CrossFormScoreSummary; readonly skipCounts: Readonly>; readonly skipDetails?: readonly { readonly submissionId: string; readonly reason: CrossFormSkipReason; }[]; } declare function aggregateForms(schemas: readonly FormSchema[], submissions: readonly TSubmission[], options?: CrossFormAnalyticsOptions): CrossFormAnalytics; interface FormSubmissionSerializedError { readonly code: "VALIDATION_FAILED" | "PII_CONFIRMATION_REQUIRED" | "SUBMISSION_BLOCKED" | "FORM_CLOSED" | "STORAGE_ERROR"; readonly messageKey: FormEngineTranslationKey | string; readonly messageParams?: Readonly>; readonly fieldErrors?: Readonly>; readonly formErrors?: readonly string[]; readonly piiFindings?: readonly SensitiveDataFinding[]; readonly piiWarningAcknowledged?: boolean; } /** JSON payload carried by a tRPC error's `data` or `shape.data` property. */ interface TrpcFormSubmissionErrorData extends FormSubmissionSerializedError { readonly source: "form-engine"; } interface TrpcSubmissionErrorAdapter { readonly serialize: (error: FormSubmissionError) => TrpcFormSubmissionErrorData; readonly deserialize: (error: unknown) => FormSubmissionError | undefined; } type TrpcProcedureType = "query" | "mutation" | "subscription"; /** Structural equivalent of tRPC's ErrorFormatter input; no `@trpc/server` dependency is required. */ interface TrpcSubmissionErrorFormatterOptions = Record> { readonly error: unknown; readonly type: TrpcProcedureType | undefined; readonly path: string | undefined; readonly input: unknown; readonly ctx: unknown; readonly shape: TShape & { readonly data?: unknown; }; } type TrpcSubmissionErrorShape> = Omit & { readonly data: Partial & Omit : Record, keyof TrpcFormSubmissionErrorData>; }; type TrpcSubmissionErrorFormatter = Record> = (options: TrpcSubmissionErrorFormatterOptions) => TrpcSubmissionErrorShape; /** A ready-to-use server/client tRPC boundary for FormSubmissionError. */ interface TrpcSubmissionErrorIntegration { readonly errorFormatter: TrpcSubmissionErrorFormatter; readonly deserialize: (error: unknown) => FormSubmissionError | undefined; readonly getData: (error: unknown) => TrpcFormSubmissionErrorData | undefined; } declare function isFormSubmissionSerializedError(value: unknown): value is FormSubmissionSerializedError; /** Error with a stable, JSON-serializable payload for RPC boundaries. */ declare class FormSubmissionError extends Error { readonly payload: FormSubmissionSerializedError; constructor(payload: FormSubmissionSerializedError); toJSON(): FormSubmissionSerializedError; } declare const serializeSubmissionError: (error: FormSubmissionError) => FormSubmissionSerializedError; declare const deserializeSubmissionError: (json: FormSubmissionSerializedError) => FormSubmissionError; /** Converts a FormSubmissionError into data safe to return from a tRPC procedure. */ declare function serializeSubmissionErrorForTrpc(error: FormSubmissionError): TrpcFormSubmissionErrorData; /** Restores a FormSubmissionError from a tRPC error, including `data` and `shape.data`. */ declare function deserializeSubmissionErrorFromTrpc(error: unknown): FormSubmissionError | undefined; /** Returns the typed Form Engine payload from a tRPC error shape without an application cast. */ declare function getTrpcSubmissionErrorData(error: unknown): TrpcFormSubmissionErrorData | undefined; /** Standard transport adapter for tRPC server/client boundaries. */ declare const trpcSubmissionErrorAdapter: TrpcSubmissionErrorAdapter; declare const createTrpcSubmissionErrorAdapter: () => TrpcSubmissionErrorAdapter; /** * Creates the tRPC integration used by both a server `errorFormatter` and a client error boundary. * The formatter preserves tRPC's existing `shape.data` values and adds the typed submission payload * only when the thrown error is a FormSubmissionError. */ declare function createTrpcSubmissionErrorIntegration(): TrpcSubmissionErrorIntegration; /** Server-side convenience helper for tRPC's `errorFormatter` option. */ declare const createTrpcSubmissionErrorFormatter: () => TrpcSubmissionErrorFormatter>; type FormEventType = "response.submitted" | "schema.updated"; interface FormEvent { readonly id: string; readonly type: FormEventType; readonly formId: string; readonly timestamp: string; readonly payload: T; } interface WebhookConfig { readonly url: string; readonly secret?: string; readonly headers?: Readonly>; readonly timeoutMs?: number; } interface WebhookDispatchResult { readonly success: boolean; readonly status?: number; readonly error?: string; } declare function dispatchWebhook(event: FormEvent, config: WebhookConfig, fetchImpl?: typeof fetch): Promise; /** * Changes only the type-specific shape of a field. Authoring content and extension * data are deliberately retained so UI adapters cannot accidentally discard them. */ declare function transformFieldType(field: FormField, nextType: QuestionType): FormField; declare const DEFAULT_FIELD_TYPE_DEFINITIONS: readonly FieldTypeDefinition[]; interface SubmissionGuardContext { readonly formId: string; readonly formVersion: number; readonly locale: string; readonly submittedAt: string; readonly challengeToken?: string; readonly clientKey?: string; readonly honeypotValue?: string; readonly metadata?: TMeta; } type SubmissionGuardResult = { readonly status: "allow"; } | { readonly status: "confirm"; readonly message?: string; } | { readonly status: "block"; readonly message?: string; }; type SubmissionGuard = (input: { readonly schema: FormSchema; readonly values: FormValues; readonly context: SubmissionGuardContext; }) => SubmissionGuardResult | Promise; declare function createHoneypotGuard(fieldId?: string): SubmissionGuard; interface RateLimiter { check(key: string, now?: Date): Promise<{ readonly allowed: boolean; readonly retryAfterMs?: number; }>; } declare function createMemoryRateLimiter(options: { readonly limit: number; readonly windowMs: number; }): RateLimiter; declare function createRateLimitGuard(limiter: RateLimiter, keyFrom: (context: SubmissionGuardContext) => string): SubmissionGuard; declare function createChallengeGuard(verify: (token: string, context: SubmissionGuardContext) => boolean | Promise): SubmissionGuard; declare const EN_MESSAGES: Readonly