@form-engine-ts/core 4.7.0 → 5.0.0

package/dist/index.cjs

@@ -21,7 +21,10 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   DEFAULT_FIELD_TYPE_DEFINITIONS: () => DEFAULT_FIELD_TYPE_DEFINITIONS,
+  EN_MESSAGES: () => EN_MESSAGES,
+  JA_MESSAGES: () => JA_MESSAGES,
   aggregateResponses: () => aggregateResponses,
+  applyTransitionPlan: () => applyTransitionPlan,
   assertValidFormSchema: () => assertValidFormSchema,
   assertVersionMutable: () => assertVersionMutable,
   calculateChoiceDistribution: () => calculateChoiceDistribution,
@@ -32,16 +35,22 @@ __export(index_exports, {
   cloneVersionToDraft: () => cloneVersionToDraft,
   collectSchemaLocales: () => collectSchemaLocales,
   collectTranslationSlots: () => collectTranslationSlots,
+  commitVersionTransition: () => commitVersionTransition,
   computeSourceTextHash: () => computeSourceTextHash,
   createCloneTransitionPlan: () => createCloneTransitionPlan,
   createDeleteDraftTransitionPlan: () => createDeleteDraftTransitionPlan,
+  createFormEngineTranslator: () => createFormEngineTranslator,
   createPublishTransitionPlan: () => createPublishTransitionPlan,
   createResponseAccumulator: () => createResponseAccumulator,
   createSubmission: () => createSubmission,
+  decodeStorageSubmissionCursor: () => decodeStorageSubmissionCursor,
+  decodeStorageTextAnswerCursor: () => decodeStorageTextAnswerCursor,
   decodeSubmissionCursor: () => decodeSubmissionCursor,
   decodeTextAnswerCursor: () => decodeTextAnswerCursor,
   deleteDraft: () => deleteDraft,
   dispatchWebhook: () => dispatchWebhook,
+  encodeStorageSubmissionCursor: () => encodeStorageSubmissionCursor,
+  encodeStorageTextAnswerCursor: () => encodeStorageTextAnswerCursor,
   encodeSubmissionCursor: () => encodeSubmissionCursor,
   encodeTextAnswerCursor: () => encodeTextAnswerCursor,
   escapeCsvCell: () => escapeCsvCell,
@@ -57,7 +66,9 @@ __export(index_exports, {
   matchesSubmissionFilter: () => matchesSubmissionFilter,
   matchesSubmissionPageFilters: () => matchesSubmissionPageFilters,
   migrateSchemaTranslationMetadata: () => migrateSchemaTranslationMetadata,
+  normalizeLocale: () => normalizeLocale,
   normalizeSubmissionPageSize: () => normalizeSubmissionPageSize,
+  paginateWithFilter: () => paginateWithFilter,
   pipeResponsesToCsvStream: () => pipeResponsesToCsvStream,
   populateSchemaTranslations: () => populateSchemaTranslations,
   publishDraft: () => publishDraft,
@@ -70,15 +81,32 @@ __export(index_exports, {
   validateAnswers: () => validateAnswers,
   validateFormSchema: () => validateFormSchema,
   validatePageAnswers: () => validatePageAnswers,
-  validateSchemaStructure: () => validateSchemaStructure
+  validateSchemaStructure: () => validateSchemaStructure,
+  validateSubmission: () => validateSubmission
 });
 module.exports = __toCommonJS(index_exports);
 
+// src/locale.ts
+var normalizeLocale = (rawLocale) => {
+  if (!rawLocale || typeof rawLocale !== "string") return null;
+  const trimmed = rawLocale.trim().replace(/_/gu, "-");
+  if (trimmed.length === 0) return null;
+  try {
+    return Intl.getCanonicalLocales(trimmed)[0] ?? null;
+  } catch {
+    return null;
+  }
+};
+function canonicalLocaleOrRaw(rawLocale) {
+  return normalizeLocale(rawLocale) ?? rawLocale;
+}
+
 // src/policy.ts
 function collectRecordKeys(value, path, pathsByLocale) {
-  for (const locale of Object.keys(value ?? {})) {
+  for (const rawLocale of Object.keys(value ?? {})) {
+    const locale = canonicalLocaleOrRaw(rawLocale);
     const paths = pathsByLocale.get(locale) ?? [];
-    paths.push(`${path}.${locale}`);
+    paths.push(`${path}.${rawLocale}`);
     pathsByLocale.set(locale, paths);
   }
 }
@@ -109,13 +137,15 @@ function collectSchemaLocales(schema) {
   });
   const translationLocales = new Set(pathsByLocale.keys());
   const allUniqueLocales = /* @__PURE__ */ new Set([
-    ...schema.defaultLocale === void 0 ? [] : [schema.defaultLocale],
-    ...schema.supportedLocales ?? [],
+    ...schema.defaultLocale === void 0 ? [] : [canonicalLocaleOrRaw(schema.defaultLocale)],
+    ...(schema.supportedLocales ?? []).map(canonicalLocaleOrRaw),
     ...translationLocales
   ]);
+  const defaultLocale = schema.defaultLocale === void 0 ? void 0 : canonicalLocaleOrRaw(schema.defaultLocale);
+  const supportedLocales = (schema.supportedLocales ?? []).map(canonicalLocaleOrRaw);
   return {
-    ...schema.defaultLocale === void 0 ? {} : { defaultLocale: schema.defaultLocale },
-    supportedLocales: schema.supportedLocales ?? [],
+    ...defaultLocale === void 0 ? {} : { defaultLocale },
+    supportedLocales,
     translationLocales,
     allUniqueLocales,
     translationLocalePaths: pathsByLocale
@@ -138,7 +168,12 @@ function displayRuleSourceIds(field) {
 }
 function registeredEntries(value, registeredLocales) {
   if (value === void 0) return void 0;
-  const entries = Object.entries(value).filter(([locale]) => registeredLocales.has(locale));
+  const entries = [];
+  for (const [rawLocale, entry] of Object.entries(value)) {
+    const locale = normalizeLocale(rawLocale);
+    if (locale === null || !registeredLocales.has(locale)) continue;
+    entries.push([locale, entry]);
+  }
   return entries.length === 0 ? void 0 : Object.fromEntries(entries);
 }
 function sanitizeNodeLocales(node, registeredLocales) {
@@ -176,6 +211,16 @@ function sanitizePageLocales(page, registeredLocales) {
   const translations = registeredEntries(page.translations, registeredLocales);
   return { ...base, ...translations === void 0 ? {} : { translations } };
 }
+function normalizedLocaleList(locales) {
+  return [
+    ...new Set(
+      locales.flatMap((locale) => {
+        const normalized = normalizeLocale(locale);
+        return normalized === null ? [] : [normalized];
+      })
+    )
+  ];
+}
 function sanitizeFieldConstraints(field, policy) {
   const constraint = policy?.fieldConstraints?.[field.type];
   if (constraint === void 0) return field;
@@ -290,10 +335,9 @@ function validateSchemaStructure(schema) {
 }
 function sanitizeSchema(schema, options = {}) {
   const existingQuestionIds = new Set(schema.fields.map((field) => field.id));
-  const registeredLocales = /* @__PURE__ */ new Set([
-    ...schema.defaultLocale === void 0 ? [] : [schema.defaultLocale],
-    ...schema.supportedLocales ?? []
-  ]);
+  const defaultLocale = schema.defaultLocale === void 0 ? null : normalizeLocale(schema.defaultLocale);
+  const supportedLocales = schema.supportedLocales === void 0 ? void 0 : normalizedLocaleList(schema.supportedLocales);
+  const registeredLocales = /* @__PURE__ */ new Set([...defaultLocale === null ? [] : [defaultLocale], ...supportedLocales ?? []]);
   const cyclic = cyclicQuestionIds(schema.fields);
   const sanitizedFields = schema.fields.map((sourceField) => {
     const field = sanitizeFieldConstraints(sanitizeFieldLocales(sourceField, registeredLocales), options.policy);
@@ -311,10 +355,17 @@ function sanitizeSchema(schema, options = {}) {
     return sanitized;
   });
   const localizedSchema = sanitizeNodeLocales(schema, registeredLocales);
-  const { translations: _translations, ...schemaWithoutLocaleContent } = localizedSchema;
+  const {
+    defaultLocale: _defaultLocale,
+    supportedLocales: _supportedLocales,
+    translations: _translations,
+    ...schemaWithoutLocaleContent
+  } = localizedSchema;
   const translations = registeredEntries(schema.translations, registeredLocales);
   const base = {
     ...schemaWithoutLocaleContent,
+    ...defaultLocale === null ? {} : { defaultLocale },
+    ...supportedLocales === void 0 ? {} : { supportedLocales },
     ...translations === void 0 ? {} : { translations },
     fields: sanitizedFields
   };
@@ -367,6 +418,12 @@ function isRecord(value) {
 function isNonEmptyString(value) {
   return typeof value === "string" && value.trim().length > 0;
 }
+function localeRecordEntry(record, locale) {
+  for (const [candidate, value] of Object.entries(record ?? {})) {
+    if (canonicalLocaleOrRaw(candidate) === locale) return value;
+  }
+  return void 0;
+}
 function issue(issues, path, code, message) {
   issues.push({ path, code, message });
 }
@@ -729,51 +786,55 @@ function collectSchemaText(schema) {
   return entries;
 }
 function addRequiredTranslationIssues(schema, locale, issues) {
-  if (!(schema.supportedLocales ?? []).includes(locale)) {
+  if (!(schema.supportedLocales ?? []).some((candidate) => canonicalLocaleOrRaw(candidate) === locale)) {
     issue(issues, "supportedLocales", "required_locale_missing", `Required locale ${locale} is missing.`);
   }
-  if (locale === schema.defaultLocale) return;
+  if (schema.defaultLocale !== void 0 && canonicalLocaleOrRaw(schema.defaultLocale) === locale) return;
+  const formTranslation = localeRecordEntry(schema.translations, locale);
   const required = [
-    { path: `translations.${locale}.title`, value: schema.translations?.[locale]?.title }
+    { path: `translations.${locale}.title`, value: formTranslation?.title }
   ];
   if (schema.description !== void 0)
-    required.push({ path: `translations.${locale}.description`, value: schema.translations?.[locale]?.description });
+    required.push({ path: `translations.${locale}.description`, value: formTranslation?.description });
   if (schema.completionMessage !== void 0) {
     required.push({
       path: `translations.${locale}.completionMessage`,
-      value: schema.translations?.[locale]?.completionMessage
+      value: formTranslation?.completionMessage
     });
   }
   schema.fields.forEach((field, fieldIndex) => {
+    const fieldTranslation = localeRecordEntry(field.translations, locale);
     required.push({
       path: `fields[${fieldIndex}].translations.${locale}.title`,
-      value: field.translations?.[locale]?.title
+      value: fieldTranslation?.title
     });
     if (field.description !== void 0) {
       required.push({
         path: `fields[${fieldIndex}].translations.${locale}.description`,
-        value: field.translations?.[locale]?.description
+        value: fieldTranslation?.description
       });
     }
     if (!("options" in field)) return;
     field.options.forEach((option, optionIndex) => {
+      const optionTranslation = localeRecordEntry(option.translations, locale);
       required.push({
         path: `fields[${fieldIndex}].options[${optionIndex}].translations.${locale}`,
-        value: option.translations?.[locale]
+        value: optionTranslation
       });
     });
   });
   schema.pages?.forEach((page, pageIndex) => {
+    const pageTranslation = localeRecordEntry(page.translations, locale);
     if (page.title !== void 0) {
       required.push({
         path: `pages[${pageIndex}].translations.${locale}.title`,
-        value: page.translations?.[locale]?.title
+        value: pageTranslation?.title
       });
     }
     if (page.description !== void 0) {
       required.push({
         path: `pages[${pageIndex}].translations.${locale}.description`,
-        value: page.translations?.[locale]?.description
+        value: pageTranslation?.description
       });
     }
   });
@@ -906,8 +967,8 @@ function validatePolicy(schema, policy, issues) {
   }
   const collectedLocales = collectSchemaLocales(schema);
   const registeredLocales = /* @__PURE__ */ new Set([
-    ...schema.defaultLocale === void 0 ? [] : [schema.defaultLocale],
-    ...schema.supportedLocales ?? []
+    ...collectedLocales.defaultLocale === void 0 ? [] : [collectedLocales.defaultLocale],
+    ...collectedLocales.supportedLocales
   ]);
   for (const locale of collectedLocales.translationLocales) {
     if (registeredLocales.has(locale)) continue;
@@ -921,23 +982,27 @@ function validatePolicy(schema, policy, issues) {
     }
   }
   if (policy.allowedLocales !== void 0) {
+    const allowedLocales = new Set(policy.allowedLocales.map(canonicalLocaleOrRaw));
     const pathsByLocale = /* @__PURE__ */ new Map();
-    if (schema.defaultLocale !== void 0) pathsByLocale.set(schema.defaultLocale, ["defaultLocale"]);
+    if (collectedLocales.defaultLocale !== void 0)
+      pathsByLocale.set(collectedLocales.defaultLocale, ["defaultLocale"]);
     schema.supportedLocales?.forEach((locale, index) => {
-      pathsByLocale.set(locale, [...pathsByLocale.get(locale) ?? [], `supportedLocales[${index}]`]);
+      const canonical = canonicalLocaleOrRaw(locale);
+      pathsByLocale.set(canonical, [...pathsByLocale.get(canonical) ?? [], `supportedLocales[${index}]`]);
     });
     for (const [locale, paths] of collectedLocales.translationLocalePaths) {
       pathsByLocale.set(locale, [...pathsByLocale.get(locale) ?? [], ...paths]);
     }
     for (const [locale, paths] of pathsByLocale) {
-      if (!policy.allowedLocales.includes(locale)) {
+      if (!allowedLocales.has(locale)) {
         for (const path of paths) {
           issue(issues, path, "disallowed_locale", `Locale ${locale} is not allowed by the form policy.`);
         }
       }
     }
-    for (const locale of policy.requiredLocales ?? []) {
-      if (!policy.allowedLocales.includes(locale)) {
+    for (const rawLocale of policy.requiredLocales ?? []) {
+      const locale = canonicalLocaleOrRaw(rawLocale);
+      if (!allowedLocales.has(locale)) {
         issue(
           issues,
           "policy.requiredLocales",
@@ -950,7 +1015,8 @@ function validatePolicy(schema, policy, issues) {
   if (policy.maxLocales !== void 0 && collectedLocales.allUniqueLocales.size > policy.maxLocales) {
     issue(issues, "supportedLocales", "max_locales_exceeded", `At most ${policy.maxLocales} locales are allowed.`);
   }
-  for (const locale of policy.requiredLocales ?? []) addRequiredTranslationIssues(schema, locale, issues);
+  for (const locale of policy.requiredLocales ?? [])
+    addRequiredTranslationIssues(schema, canonicalLocaleOrRaw(locale), issues);
   if (policy.maxSchemaBytes !== void 0) {
     try {
       const byteLength = new TextEncoder().encode(JSON.stringify(schema)).byteLength;
@@ -985,8 +1051,12 @@ function validateFormSchema(input, options = {}) {
       );
     }
   }
-  if (input.defaultLocale !== void 0 && !isNonEmptyString(input.defaultLocale)) {
-    issue(issues, "defaultLocale", "invalid_locale", "Expected a non-empty default locale.");
+  if (input.defaultLocale !== void 0) {
+    if (!isNonEmptyString(input.defaultLocale)) {
+      issue(issues, "defaultLocale", "invalid_locale", "Expected a non-empty default locale.");
+    } else if (normalizeLocale(input.defaultLocale) === null) {
+      issue(issues, "defaultLocale", "invalid_locale", "Expected a valid BCP 47 locale.");
+    }
   }
   if (input.supportedLocales !== void 0) {
     if (!Array.isArray(input.supportedLocales) || input.supportedLocales.length === 0) {
@@ -996,10 +1066,15 @@ function validateFormSchema(input, options = {}) {
       input.supportedLocales.forEach((locale, index) => {
         if (!isNonEmptyString(locale)) {
           issue(issues, `supportedLocales[${index}]`, "invalid_locale", "Expected a non-empty locale.");
-        } else if (locales.has(locale)) {
-          issue(issues, `supportedLocales[${index}]`, "duplicate_locale", "Locales must be unique.");
         } else {
-          locales.add(locale);
+          const normalized = normalizeLocale(locale);
+          if (normalized === null) {
+            issue(issues, `supportedLocales[${index}]`, "invalid_locale", "Expected a valid BCP 47 locale.");
+          } else if (locales.has(normalized)) {
+            issue(issues, `supportedLocales[${index}]`, "duplicate_locale", "Locales must be unique.");
+          } else {
+            locales.add(normalized);
+          }
         }
       });
     }
@@ -1869,7 +1944,408 @@ var DEFAULT_FIELD_TYPE_DEFINITIONS = [
   }
 ];
 
+// src/i18n/catalogs/en.ts
+var EN_MESSAGES = Object.freeze({
+  "builder.formTitle": "Form title",
+  "builder.formDescription": "Form description",
+  "builder.completionMessage": "Completion message",
+  "builder.addQuestion": "Add question",
+  "builder.actions.addField": "Add question",
+  "builder.actions.deleteField": "Delete",
+  "builder.actions.moveUp": "Move up",
+  "builder.actions.moveDown": "Move down",
+  "builder.actions.add": "Add",
+  "builder.actions.delete": "Delete",
+  "builder.actions.edit": "Edit",
+  "builder.actions.settings": "Settings",
+  "builder.actions.translate": "Translate",
+  "builder.actions.close": "Close",
+  "builder.actions.dragHandle": "Reorder",
+  "builder.fields.selectType": "Select field type",
+  "builder.fields.typeText": "Text",
+  "builder.fields.typeTextarea": "Textarea",
+  "builder.fields.typeNumber": "Number",
+  "builder.fields.typeRadio": "Radio",
+  "builder.fields.typeCheckbox": "Checkbox",
+  "builder.fields.typeSelect": "Select",
+  "builder.fields.typeRating": "Rating",
+  "builder.fields.typeMultiSelect": "Multi-select",
+  "builder.fieldType.text": "Text",
+  "builder.fieldType.textarea": "Textarea",
+  "builder.fieldType.number": "Number",
+  "builder.fieldType.radio": "Radio",
+  "builder.fieldType.checkbox": "Checkbox",
+  "builder.fieldType.select": "Select",
+  "builder.fieldType.rating": "Rating",
+  "builder.fieldType.multi-select": "Multi-select",
+  "builder.fieldTypeDescription.text": "A single-line text answer",
+  "builder.fieldTypeDescription.textarea": "A long-form text answer",
+  "builder.fieldTypeDescription.number": "A numeric answer",
+  "builder.fieldTypeDescription.radio": "A single-choice answer",
+  "builder.fieldTypeDescription.checkbox": "A yes/no answer",
+  "builder.fieldTypeDescription.select": "A dropdown choice",
+  "builder.fieldTypeDescription.rating": "A rating scale answer",
+  "builder.fieldTypeDescription.multi-select": "Multiple choices",
+  "builder.fieldCategory.text": "Text",
+  "builder.fieldCategory.choice": "Choice",
+  "builder.fieldCategory.number": "Number",
+  "builder.fieldCategory.advanced": "Advanced",
+  "builder.required": "Required",
+  "builder.options": "Options",
+  "builder.localization.title": "Localization",
+  "builder.localization": "Localization",
+  "builder.localization.addLocale": "Add locale",
+  "builder.localization.selectLocaleToAdd": "Select a locale to add",
+  "builder.localization.defaultLocale": "Default locale",
+  "builder.localization.translateAll": "Translate all text",
+  "builder.localization.noLocalesConfigured": "Translations not configured",
+  "builder.localization.localesConfiguredSummary": "{{count}} locales configured",
+  "builder.localization.allLocalesAdded": "All available locales have been added",
+  "builder.localization.maxLocalesReached": "The maximum number of locales ({{max}}) has been reached",
+  "builder.submissionSettings.title": "Submission settings",
+  "builder.submissionSettings.showConfirmation": "Show confirmation before submit",
+  "builder.submissionSettings.renderMode": "Confirmation display mode",
+  "builder.formBuilder": "Form builder",
+  "builder.basicSettings": "Basic settings",
+  "builder.description": "Description",
+  "builder.moveUp": "Move {{title}} up",
+  "builder.moveDown": "Move {{title}} down",
+  "builder.delete": "Delete {{title}}",
+  "builder.deleteAction": "Delete",
+  "builder.questionTitle": "Question title",
+  "builder.questionTitlePlaceholder": "Example: Tell us what we could improve",
+  "builder.newQuestionTitle": "New question",
+  "builder.type": "Type",
+  "builder.minimum": "Minimum",
+  "builder.maximum": "Maximum",
+  "builder.minimumLength": "Minimum length",
+  "builder.maximumLength": "Maximum length",
+  "builder.pattern": "Pattern",
+  "builder.step": "Step",
+  "builder.optionLabel": "Option label {{index}}",
+  "builder.optionLabelPlaceholder": "Example: Very satisfied",
+  "builder.newOptionLabel": "Option {{index}}",
+  "builder.remove": "Remove",
+  "builder.addOption": "Add option",
+  "builder.displayCondition": "Display condition",
+  "builder.alwaysVisible": "Always visible",
+  "builder.conditionOperator": "Condition operator",
+  "builder.conditionValue": "Condition value",
+  "builder.conditionTrue": "true",
+  "builder.conditionFalse": "false",
+  "builder.pages": "Page manager",
+  "builder.enablePages": "Enable multi-step pages",
+  "builder.addPage": "Add page",
+  "builder.newPage": "New page",
+  "builder.pageTitle": "Page title",
+  "builder.pageDescription": "Page description",
+  "builder.pageQuestion": "Question to move to the new page",
+  "builder.questionPage": "Page",
+  "builder.pageCondition": "Page display condition",
+  "builder.unassigned": "Unassigned",
+  "builder.defaultLocale": "Default locale",
+  "builder.supportedLocales": "Supported locales",
+  "builder.addLocale": "Add locale",
+  "builder.editLocale": "Edit locale",
+  "builder.autoTranslate": "Translate all text",
+  "builder.translating": "Translating\u2026",
+  "builder.translationLocale": "Translation locale",
+  "builder.selectLocale": "Select a locale to edit translations.",
+  "builder.selectLocaleToAdd": "Select a locale to add",
+  "builder.translation": "{{locale}} translation",
+  "builder.translatedFormTitle": "Translated form title",
+  "builder.translatedFormDescription": "Translated form description",
+  "builder.translatedCompletionMessage": "Translated completion message",
+  "builder.translatedQuestionTitle": "Translated question title",
+  "builder.translatedDescription": "Translated description",
+  "builder.translationUnavailable": "Provide an async translation adapter to enable automatic translation.",
+  "builder.operator.equals": "equals",
+  "builder.operator.not_equals": "does not equal",
+  "builder.operator.contains": "contains",
+  "builder.operator.not_empty": "is not empty",
+  "builder.showConfirmationBeforeSubmit": "Show confirmation before submit",
+  "builder.confirmationRenderMode": "Confirmation display mode",
+  "renderer.submitButton": "Submit",
+  "renderer.submittingButton": "Submitting...",
+  "renderer.retryButton": "Retry",
+  "renderer.requiredField": "This field is required.",
+  "renderer.alreadySubmittedTitle": "Already Submitted",
+  "renderer.alreadySubmittedMessage": "Already submitted.",
+  "renderer.serverErrorSummary": "Submission failed. Please check your answers and try again.",
+  "renderer.confirmSensitiveDataTitle": "Sensitive data may be included",
+  "renderer.confirmSensitiveDataMessage": "The following answers may contain personal information. Continue submitting?",
+  "renderer.confirmButton": "Proceed",
+  "renderer.cancelButton": "Cancel",
+  "form.submit": "Submit",
+  "form.submitting": "Submitting...",
+  "form.back": "Back",
+  "form.next": "Next",
+  "form.step": "{{current}} / {{total}}",
+  "form.draftRestored": "Draft restored",
+  "form.submissionBlocked": "Submission blocked because personal information was detected.",
+  "form.confirmSensitiveData": "Sensitive data may be included. Please review before submitting.",
+  "form.confirmSubmission": "Proceed",
+  "form.cancelSubmission": "Cancel",
+  "form.yes": "Yes",
+  "form.no": "No",
+  "form.alreadySubmitted": "Already submitted.",
+  "form.submitAnother": "Submit another response",
+  "validation.required": "This field is required.",
+  "validation.invalidOption": "Select a valid option.",
+  "validation.invalidType": "Enter a valid value.",
+  "validation.max": "Value is too large.",
+  "validation.maxLength": "Value is too long.",
+  "validation.maxSelections": "Select fewer options.",
+  "validation.min": "Value is too small.",
+  "validation.minLength": "Value is too short.",
+  "validation.minSelections": "Select more options.",
+  "validation.pattern": "Value has an invalid format.",
+  "validation.sensitiveData": "Sensitive data may be included.",
+  "validation.step": "Enter a value with the correct step.",
+  "validation.unknownField": "This field is not recognized.",
+  "workspace.title": "Translation workspace",
+  "workspace.status.missing": "Missing",
+  "workspace.status.translated": "Translated",
+  "workspace.status.stale": "Source changed",
+  "workspace.status.manual": "Manual",
+  "workspace.status.manualStale": "Manual / source changed",
+  "workspace.errors.localeNotAllowed": "Locale {{locale}} is not allowed.",
+  "workspace.errors.maxLocalesExceeded": "The maximum number of locales ({{max}}) has been reached.",
+  "workspace.errors.readOnly": "This workspace is read-only.",
+  "workspace.errors.adapterNotConfigured": "A translation adapter is not configured.",
+  "workspace.errors.translationFailed": "Translation failed."
+});
+
+// src/i18n/catalogs/ja.ts
+var JA_MESSAGES = Object.freeze({
+  "builder.formTitle": "\u30D5\u30A9\u30FC\u30E0\u306E\u30BF\u30A4\u30C8\u30EB",
+  "builder.formDescription": "\u30D5\u30A9\u30FC\u30E0\u306E\u8AAC\u660E",
+  "builder.completionMessage": "\u9001\u4FE1\u5B8C\u4E86\u30E1\u30C3\u30BB\u30FC\u30B8",
+  "builder.addQuestion": "\u8CEA\u554F\u3092\u8FFD\u52A0",
+  "builder.actions.addField": "\u8CEA\u554F\u3092\u8FFD\u52A0",
+  "builder.actions.deleteField": "\u524A\u9664",
+  "builder.actions.moveUp": "\u4E0A\u3078\u79FB\u52D5",
+  "builder.actions.moveDown": "\u4E0B\u3078\u79FB\u52D5",
+  "builder.actions.add": "\u8FFD\u52A0",
+  "builder.actions.delete": "\u524A\u9664",
+  "builder.actions.edit": "\u7DE8\u96C6",
+  "builder.actions.settings": "\u8A2D\u5B9A",
+  "builder.actions.translate": "\u7FFB\u8A33",
+  "builder.actions.close": "\u9589\u3058\u308B",
+  "builder.actions.dragHandle": "\u4E26\u3079\u66FF\u3048",
+  "builder.fields.selectType": "\u8CEA\u554F\u5F62\u5F0F\u3092\u9078\u629E",
+  "builder.fields.typeText": "\u4E00\u884C\u30C6\u30AD\u30B9\u30C8",
+  "builder.fields.typeTextarea": "\u9577\u6587\u30C6\u30AD\u30B9\u30C8",
+  "builder.fields.typeNumber": "\u6570\u5024",
+  "builder.fields.typeRadio": "\u5358\u4E00\u9078\u629E (\u30E9\u30B8\u30AA\u30DC\u30BF\u30F3)",
+  "builder.fields.typeCheckbox": "\u30C1\u30A7\u30C3\u30AF\u30DC\u30C3\u30AF\u30B9",
+  "builder.fields.typeSelect": "\u30C9\u30ED\u30C3\u30D7\u30C0\u30A6\u30F3",
+  "builder.fields.typeRating": "\u8A55\u4FA1\u30B9\u30B1\u30FC\u30EB",
+  "builder.fields.typeMultiSelect": "\u8907\u6570\u9078\u629E",
+  "builder.fieldType.text": "\u4E00\u884C\u30C6\u30AD\u30B9\u30C8",
+  "builder.fieldType.textarea": "\u9577\u6587\u30C6\u30AD\u30B9\u30C8",
+  "builder.fieldType.number": "\u6570\u5024",
+  "builder.fieldType.radio": "\u5358\u4E00\u9078\u629E",
+  "builder.fieldType.checkbox": "\u30C1\u30A7\u30C3\u30AF\u30DC\u30C3\u30AF\u30B9",
+  "builder.fieldType.select": "\u30C9\u30ED\u30C3\u30D7\u30C0\u30A6\u30F3",
+  "builder.fieldType.rating": "\u8A55\u4FA1\u30B9\u30B1\u30FC\u30EB",
+  "builder.fieldType.multi-select": "\u8907\u6570\u9078\u629E",
+  "builder.fieldTypeDescription.text": "\u4E00\u884C\u306E\u56DE\u7B54",
+  "builder.fieldTypeDescription.textarea": "\u9577\u6587\u306E\u56DE\u7B54",
+  "builder.fieldTypeDescription.number": "\u6570\u5024\u306E\u56DE\u7B54",
+  "builder.fieldTypeDescription.radio": "\u5358\u4E00\u9078\u629E\u306E\u56DE\u7B54",
+  "builder.fieldTypeDescription.checkbox": "\u306F\u3044 / \u3044\u3044\u3048\u306E\u56DE\u7B54",
+  "builder.fieldTypeDescription.select": "\u30C9\u30ED\u30C3\u30D7\u30C0\u30A6\u30F3\u5F62\u5F0F\u306E\u56DE\u7B54",
+  "builder.fieldTypeDescription.rating": "\u8A55\u4FA1\u30B9\u30B1\u30FC\u30EB\u306E\u56DE\u7B54",
+  "builder.fieldTypeDescription.multi-select": "\u8907\u6570\u9078\u629E\u306E\u56DE\u7B54",
+  "builder.fieldCategory.text": "\u30C6\u30AD\u30B9\u30C8",
+  "builder.fieldCategory.choice": "\u9078\u629E\u5F0F",
+  "builder.fieldCategory.number": "\u6570\u5024",
+  "builder.fieldCategory.advanced": "\u8A73\u7D30\u8A2D\u5B9A",
+  "builder.required": "\u5FC5\u9808\u9805\u76EE\u306B\u3059\u308B",
+  "builder.options": "\u9078\u629E\u80A2\u4E00\u89A7",
+  "builder.localization.title": "\u591A\u8A00\u8A9E\u8A2D\u5B9A",
+  "builder.localization": "\u591A\u8A00\u8A9E\u8A2D\u5B9A",
+  "builder.localization.addLocale": "\u8A00\u8A9E\u3092\u8FFD\u52A0",
+  "builder.localization.selectLocaleToAdd": "\u8FFD\u52A0\u3059\u308B\u8A00\u8A9E\u3092\u9078\u629E",
+  "builder.localization.defaultLocale": "\u30C7\u30D5\u30A9\u30EB\u30C8\u8A00\u8A9E (\u5143\u8A00\u8A9E)",
+  "builder.localization.translateAll": "\u4E00\u62EC\u81EA\u52D5\u7FFB\u8A33",
+  "builder.localization.noLocalesConfigured": "\u7FFB\u8A33\u8A00\u8A9E\u306F\u307E\u3060\u8A2D\u5B9A\u3055\u308C\u3066\u3044\u307E\u305B\u3093\u3002",
+  "builder.localization.localesConfiguredSummary": "{{count}}\u8A00\u8A9E\u306E\u7FFB\u8A33\u304C\u8A2D\u5B9A\u3055\u308C\u3066\u3044\u307E\u3059\u3002",
+  "builder.localization.allLocalesAdded": "\u3059\u3079\u3066\u306E\u5019\u88DC\u8A00\u8A9E\u304C\u8FFD\u52A0\u6E08\u307F\u3067\u3059",
+  "builder.localization.maxLocalesReached": "\u767B\u9332\u53EF\u80FD\u306A\u6700\u5927\u8A00\u8A9E\u6570 ({{max}}) \u306B\u9054\u3057\u307E\u3057\u305F",
+  "builder.submissionSettings.title": "\u9001\u4FE1\u8A2D\u5B9A",
+  "builder.submissionSettings.showConfirmation": "\u9001\u4FE1\u524D\u306B\u56DE\u7B54\u78BA\u8A8D\u753B\u9762\u3092\u8868\u793A\u3059\u308B",
+  "builder.submissionSettings.renderMode": "\u78BA\u8A8D\u753B\u9762\u306E\u8868\u793A\u5F62\u5F0F",
+  "builder.formBuilder": "\u30D5\u30A9\u30FC\u30E0\u30D3\u30EB\u30C0\u30FC",
+  "builder.basicSettings": "\u57FA\u672C\u8A2D\u5B9A",
+  "builder.description": "\u8AAC\u660E",
+  "builder.moveUp": "{{title}}\u3092\u4E0A\u3078\u79FB\u52D5",
+  "builder.moveDown": "{{title}}\u3092\u4E0B\u3078\u79FB\u52D5",
+  "builder.delete": "{{title}}\u3092\u524A\u9664",
+  "builder.deleteAction": "\u524A\u9664",
+  "builder.questionTitle": "\u8CEA\u554F\u6587",
+  "builder.questionTitlePlaceholder": "\u4F8B: \u6539\u5584\u3067\u304D\u308B\u70B9\u3092\u6559\u3048\u3066\u304F\u3060\u3055\u3044",
+  "builder.newQuestionTitle": "\u65B0\u3057\u3044\u8CEA\u554F",
+  "builder.type": "\u5F62\u5F0F",
+  "builder.minimum": "\u6700\u5C0F\u5024",
+  "builder.maximum": "\u6700\u5927\u5024",
+  "builder.minimumLength": "\u6700\u5C0F\u6587\u5B57\u6570",
+  "builder.maximumLength": "\u6700\u5927\u6587\u5B57\u6570",
+  "builder.pattern": "\u5F62\u5F0F\u30D1\u30BF\u30FC\u30F3",
+  "builder.step": "\u523B\u307F\u5E45",
+  "builder.optionLabel": "\u9078\u629E\u80A2 {{index}}",
+  "builder.optionLabelPlaceholder": "\u4F8B: \u3068\u3066\u3082\u6E80\u8DB3",
+  "builder.newOptionLabel": "\u9078\u629E\u80A2 {{index}}",
+  "builder.remove": "\u524A\u9664",
+  "builder.addOption": "\u9078\u629E\u80A2\u3092\u8FFD\u52A0",
+  "builder.displayCondition": "\u8868\u793A\u6761\u4EF6",
+  "builder.alwaysVisible": "\u5E38\u306B\u8868\u793A",
+  "builder.conditionOperator": "\u6761\u4EF6\u6F14\u7B97\u5B50",
+  "builder.conditionValue": "\u6761\u4EF6\u5024",
+  "builder.conditionTrue": "\u306F\u3044",
+  "builder.conditionFalse": "\u3044\u3044\u3048",
+  "builder.pages": "\u30DA\u30FC\u30B8\u7BA1\u7406",
+  "builder.enablePages": "\u8907\u6570\u30DA\u30FC\u30B8\u3092\u6709\u52B9\u306B\u3059\u308B",
+  "builder.addPage": "\u30DA\u30FC\u30B8\u3092\u8FFD\u52A0",
+  "builder.newPage": "\u65B0\u3057\u3044\u30DA\u30FC\u30B8",
+  "builder.pageTitle": "\u30DA\u30FC\u30B8\u30BF\u30A4\u30C8\u30EB",
+  "builder.pageDescription": "\u30DA\u30FC\u30B8\u306E\u8AAC\u660E",
+  "builder.pageQuestion": "\u65B0\u3057\u3044\u30DA\u30FC\u30B8\u3078\u79FB\u52D5\u3059\u308B\u8CEA\u554F",
+  "builder.questionPage": "\u30DA\u30FC\u30B8",
+  "builder.pageCondition": "\u30DA\u30FC\u30B8\u306E\u8868\u793A\u6761\u4EF6",
+  "builder.unassigned": "\u672A\u5272\u308A\u5F53\u3066",
+  "builder.defaultLocale": "\u30C7\u30D5\u30A9\u30EB\u30C8\u8A00\u8A9E",
+  "builder.supportedLocales": "\u5BFE\u5FDC\u8A00\u8A9E",
+  "builder.addLocale": "\u8A00\u8A9E\u3092\u8FFD\u52A0",
+  "builder.editLocale": "\u8A00\u8A9E\u3092\u7DE8\u96C6",
+  "builder.autoTranslate": "\u3059\u3079\u3066\u7FFB\u8A33",
+  "builder.translating": "\u7FFB\u8A33\u4E2D\u2026",
+  "builder.translationLocale": "\u7FFB\u8A33\u8A00\u8A9E",
+  "builder.selectLocale": "\u7FFB\u8A33\u3092\u7DE8\u96C6\u3059\u308B\u8A00\u8A9E\u3092\u9078\u629E\u3057\u3066\u304F\u3060\u3055\u3044\u3002",
+  "builder.selectLocaleToAdd": "\u8FFD\u52A0\u3059\u308B\u8A00\u8A9E\u3092\u9078\u629E",
+  "builder.translation": "{{locale}}\u7FFB\u8A33",
+  "builder.translatedFormTitle": "\u7FFB\u8A33\u5F8C\u306E\u30D5\u30A9\u30FC\u30E0\u30BF\u30A4\u30C8\u30EB",
+  "builder.translatedFormDescription": "\u7FFB\u8A33\u5F8C\u306E\u30D5\u30A9\u30FC\u30E0\u8AAC\u660E",
+  "builder.translatedCompletionMessage": "\u7FFB\u8A33\u5F8C\u306E\u9001\u4FE1\u5B8C\u4E86\u30E1\u30C3\u30BB\u30FC\u30B8",
+  "builder.translatedQuestionTitle": "\u7FFB\u8A33\u5F8C\u306E\u8CEA\u554F\u6587",
+  "builder.translatedDescription": "\u7FFB\u8A33\u5F8C\u306E\u8AAC\u660E",
+  "builder.translationUnavailable": "\u81EA\u52D5\u7FFB\u8A33\u306B\u306F\u975E\u540C\u671F\u7FFB\u8A33\u30A2\u30C0\u30D7\u30BF\u30FC\u3092\u8A2D\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044\u3002",
+  "builder.operator.equals": "\u7B49\u3057\u3044",
+  "builder.operator.not_equals": "\u7B49\u3057\u304F\u306A\u3044",
+  "builder.operator.contains": "\u542B\u3080",
+  "builder.operator.not_empty": "\u7A7A\u3067\u306F\u306A\u3044",
+  "builder.showConfirmationBeforeSubmit": "\u9001\u4FE1\u524D\u306B\u78BA\u8A8D\u753B\u9762\u3092\u8868\u793A\u3059\u308B",
+  "builder.confirmationRenderMode": "\u78BA\u8A8D\u753B\u9762\u306E\u8868\u793A\u5F62\u5F0F",
+  "renderer.submitButton": "\u9001\u4FE1\u3059\u308B",
+  "renderer.submittingButton": "\u9001\u4FE1\u4E2D...",
+  "renderer.retryButton": "\u518D\u9001\u4FE1\u3059\u308B",
+  "renderer.requiredField": "\u3053\u306E\u9805\u76EE\u306F\u5FC5\u9808\u3067\u3059\u3002",
+  "renderer.alreadySubmittedTitle": "\u56DE\u7B54\u6E08\u307F\u3067\u3059",
+  "renderer.alreadySubmittedMessage": "\u3053\u306E\u30A2\u30F3\u30B1\u30FC\u30C8\u306B\u306F\u3059\u3067\u306B\u56DE\u7B54\u3057\u3066\u3044\u307E\u3059\u3002",
+  "renderer.serverErrorSummary": "\u9001\u4FE1\u306B\u5931\u6557\u3057\u307E\u3057\u305F\u3002\u5185\u5BB9\u3092\u3054\u78BA\u8A8D\u306E\u4E0A\u3001\u518D\u5EA6\u304A\u8A66\u3057\u304F\u3060\u3055\u3044\u3002",
+  "renderer.confirmSensitiveDataTitle": "\u500B\u4EBA\u60C5\u5831\u304C\u542B\u307E\u308C\u3066\u3044\u308B\u53EF\u80FD\u6027\u304C\u3042\u308A\u307E\u3059",
+  "renderer.confirmSensitiveDataMessage": "\u4EE5\u4E0B\u306E\u9805\u76EE\u306B\u500B\u4EBA\u60C5\u5831\u3068\u307F\u3089\u308C\u308B\u8A18\u8FF0\u304C\u3042\u308A\u307E\u3059\u3002\u3053\u306E\u307E\u307E\u9001\u4FE1\u3057\u3066\u3082\u3088\u308D\u3057\u3044\u3067\u3059\u304B\uFF1F",
+  "renderer.confirmButton": "\u3053\u306E\u307E\u307E\u9001\u4FE1",
+  "renderer.cancelButton": "\u4FEE\u6B63\u3059\u308B",
+  "form.submit": "\u9001\u4FE1\u3059\u308B",
+  "form.submitting": "\u9001\u4FE1\u4E2D...",
+  "form.back": "\u623B\u308B",
+  "form.next": "\u6B21\u3078",
+  "form.step": "{{current}} / {{total}}",
+  "form.draftRestored": "\u4E0B\u66F8\u304D\u3092\u5FA9\u5143\u3057\u307E\u3057\u305F",
+  "form.submissionBlocked": "\u500B\u4EBA\u60C5\u5831\u304C\u691C\u51FA\u3055\u308C\u305F\u305F\u3081\u9001\u4FE1\u3067\u304D\u307E\u305B\u3093\u3002",
+  "form.confirmSensitiveData": "\u500B\u4EBA\u60C5\u5831\u304C\u542B\u307E\u308C\u3066\u3044\u308B\u53EF\u80FD\u6027\u304C\u3042\u308A\u307E\u3059\u3002\u9001\u4FE1\u524D\u306B\u78BA\u8A8D\u3057\u3066\u304F\u3060\u3055\u3044\u3002",
+  "form.confirmSubmission": "\u3053\u306E\u307E\u307E\u9001\u4FE1",
+  "form.cancelSubmission": "\u4FEE\u6B63\u3059\u308B",
+  "form.yes": "\u306F\u3044",
+  "form.no": "\u3044\u3044\u3048",
+  "form.alreadySubmitted": "\u56DE\u7B54\u6E08\u307F\u3067\u3059",
+  "form.submitAnother": "\u5225\u306E\u56DE\u7B54\u3092\u9001\u4FE1",
+  "validation.required": "\u3053\u306E\u9805\u76EE\u306F\u5FC5\u9808\u3067\u3059\u3002",
+  "validation.invalidOption": "\u6709\u52B9\u306A\u9078\u629E\u80A2\u3092\u9078\u629E\u3057\u3066\u304F\u3060\u3055\u3044\u3002",
+  "validation.invalidType": "\u6709\u52B9\u306A\u5024\u3092\u5165\u529B\u3057\u3066\u304F\u3060\u3055\u3044\u3002",
+  "validation.max": "\u5024\u304C\u5927\u304D\u3059\u304E\u307E\u3059\u3002",
+  "validation.maxLength": "\u5165\u529B\u304C\u9577\u3059\u304E\u307E\u3059\u3002",
+  "validation.maxSelections": "\u9078\u629E\u6570\u3092\u6E1B\u3089\u3057\u3066\u304F\u3060\u3055\u3044\u3002",
+  "validation.min": "\u5024\u304C\u5C0F\u3055\u3059\u304E\u307E\u3059\u3002",
+  "validation.minLength": "\u5165\u529B\u304C\u77ED\u3059\u304E\u307E\u3059\u3002",
+  "validation.minSelections": "\u3055\u3089\u306B\u9078\u629E\u3057\u3066\u304F\u3060\u3055\u3044\u3002",
+  "validation.pattern": "\u5165\u529B\u5F62\u5F0F\u304C\u6B63\u3057\u304F\u3042\u308A\u307E\u305B\u3093\u3002",
+  "validation.sensitiveData": "\u500B\u4EBA\u60C5\u5831\u304C\u542B\u307E\u308C\u3066\u3044\u308B\u53EF\u80FD\u6027\u304C\u3042\u308A\u307E\u3059\u3002",
+  "validation.step": "\u6B63\u3057\u3044\u523B\u307F\u5E45\u306E\u5024\u3092\u5165\u529B\u3057\u3066\u304F\u3060\u3055\u3044\u3002",
+  "validation.unknownField": "\u3053\u306E\u9805\u76EE\u306F\u8A8D\u8B58\u3055\u308C\u307E\u305B\u3093\u3002",
+  "workspace.title": "\u591A\u8A00\u8A9E\u7FFB\u8A33\u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9",
+  "workspace.status.missing": "\u672A\u7FFB\u8A33",
+  "workspace.status.translated": "\u7FFB\u8A33\u6E08\u307F",
+  "workspace.status.stale": "\u539F\u6587\u66F4\u65B0\u3042\u308A",
+  "workspace.status.manual": "\u624B\u52D5\u7DE8\u96C6\u6E08\u307F",
+  "workspace.status.manualStale": "\u624B\u52D5\u7DE8\u96C6\u6E08\u307F (\u539F\u6587\u66F4\u65B0\u3042\u308A)",
+  "workspace.errors.localeNotAllowed": "\u6307\u5B9A\u3055\u308C\u305F\u8A00\u8A9E\u300C{{locale}}\u300D\u306F\u8A2D\u5B9A\u3067\u304D\u307E\u305B\u3093\u3002",
+  "workspace.errors.maxLocalesExceeded": "\u767B\u9332\u53EF\u80FD\u306A\u6700\u5927\u8A00\u8A9E\u6570 ({{max}}) \u306B\u9054\u3057\u307E\u3057\u305F\u3002",
+  "workspace.errors.readOnly": "\u8AAD\u307F\u53D6\u308A\u5C02\u7528\u30E2\u30FC\u30C9\u306E\u305F\u3081\u5909\u66F4\u3067\u304D\u307E\u305B\u3093\u3002",
+  "workspace.errors.adapterNotConfigured": "\u7FFB\u8A33\u30A2\u30C0\u30D7\u30BF\u30FC\u304C\u8A2D\u5B9A\u3055\u308C\u3066\u3044\u307E\u305B\u3093\u3002",
+  "workspace.errors.translationFailed": "\u7FFB\u8A33\u51E6\u7406\u306B\u5931\u6557\u3057\u307E\u3057\u305F\u3002"
+});
+
+// src/i18n/translator.ts
+function formatTemplate(template, params = {}) {
+  return template.replace(
+    /\{\{?(\w+)\}\}?/gu,
+    (token, name) => Object.hasOwn(params, name) ? String(params[name]) : token
+  );
+}
+function defaultCatalog(locale) {
+  return locale.toLowerCase().startsWith("ja") ? JA_MESSAGES : EN_MESSAGES;
+}
+var createFormEngineTranslator = (options = {}) => {
+  const { locale = "ja", fallbackLocale = "en", messages = {}, customCatalogs = {}, fallbackTextResolver } = options;
+  const currentCatalog = { ...defaultCatalog(locale), ...customCatalogs[locale], ...messages };
+  const fallbackCatalog = { ...defaultCatalog(fallbackLocale), ...customCatalogs[fallbackLocale] };
+  return (rawKey, params = {}) => {
+    const key = rawKey;
+    const template = currentCatalog[key] ?? fallbackCatalog[key];
+    if (template !== void 0 && template !== "") return formatTemplate(template, params);
+    if (fallbackTextResolver !== void 0) return fallbackTextResolver(key, locale);
+    return "";
+  };
+};
+
 // src/pagination.ts
+async function paginateWithFilter(params) {
+  const { pageSize, cursor, maxScanPages = 5, fetchPage, filterPredicate, encodeCursor } = params;
+  normalizeSubmissionPageSize(pageSize);
+  if (!Number.isSafeInteger(maxScanPages) || maxScanPages < 1) {
+    throw new TypeError("maxScanPages must be a positive safe integer.");
+  }
+  const collected = [];
+  let currentRawCursor = cursor;
+  let totalScannedCount = 0;
+  let scanCount = 0;
+  while (collected.length < pageSize && scanCount < maxScanPages) {
+    scanCount += 1;
+    const fetchLimit = pageSize - collected.length + 1;
+    const { rawItems, rawNextCursor } = await fetchPage(currentRawCursor, fetchLimit);
+    totalScannedCount += rawItems.length;
+    for (const item of rawItems) {
+      if (!filterPredicate(item)) continue;
+      collected.push(item);
+      if (collected.length === pageSize) {
+        const lastItem = collected.at(-1);
+        if (lastItem === void 0) break;
+        return {
+          items: collected,
+          hasMore: rawNextCursor !== void 0,
+          ...rawNextCursor === void 0 ? {} : { nextCursor: encodeCursor(lastItem) },
+          totalScannedCount
+        };
+      }
+    }
+    if (rawItems.length === 0 || rawNextCursor === void 0) break;
+    currentRawCursor = rawNextCursor;
+  }
+  return { items: collected, hasMore: false, totalScannedCount };
+}
 function asFormResponse2(submission) {
   return {
     responseId: submission.id,
@@ -1918,6 +2394,43 @@ async function* iterateSubmissionPages(adapter, formId, queryOptions = {}, optio
     cursor = nextCursor;
   }
 }
+function encodeStorageSubmissionCursor(value) {
+  if (value.kind !== "submission" || value.formId.length === 0 || value.submittedAt.length === 0 || value.id.length === 0) {
+    throw new TypeError("Submission cursor values are invalid.");
+  }
+  return encodeBase64Url(new TextEncoder().encode(JSON.stringify(value)));
+}
+function decodeStorageSubmissionCursor(cursor) {
+  const parsed = decodeCursorPayload(cursor, "submission cursor payload is invalid.");
+  if (parsed.kind !== "submission" || typeof parsed.formId !== "string" || parsed.formId.length === 0 || typeof parsed.submittedAt !== "string" || parsed.submittedAt.length === 0 || typeof parsed.id !== "string" || parsed.id.length === 0) {
+    throw new TypeError("submission cursor payload is invalid.");
+  }
+  return {
+    kind: "submission",
+    formId: parsed.formId,
+    submittedAt: parsed.submittedAt,
+    id: parsed.id
+  };
+}
+function encodeStorageTextAnswerCursor(value) {
+  if (value.kind !== "text_answer" || value.formId.length === 0 || value.fieldId.length === 0 || value.submittedAt.length === 0 || value.submissionId.length === 0) {
+    throw new TypeError("Text answer cursor values are invalid.");
+  }
+  return encodeBase64Url(new TextEncoder().encode(JSON.stringify(value)));
+}
+function decodeStorageTextAnswerCursor(cursor) {
+  const parsed = decodeCursorPayload(cursor, "text answer cursor payload is invalid.");
+  if (parsed.kind !== "text_answer" || typeof parsed.formId !== "string" || parsed.formId.length === 0 || typeof parsed.fieldId !== "string" || parsed.fieldId.length === 0 || typeof parsed.submittedAt !== "string" || parsed.submittedAt.length === 0 || typeof parsed.submissionId !== "string" || parsed.submissionId.length === 0) {
+    throw new TypeError("text answer cursor payload is invalid.");
+  }
+  return {
+    kind: "text_answer",
+    formId: parsed.formId,
+    fieldId: parsed.fieldId,
+    submittedAt: parsed.submittedAt,
+    submissionId: parsed.submissionId
+  };
+}
 var BASE64_ALPHABET = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
 function encodeBase64(bytes) {
   let result = "";
@@ -1948,6 +2461,20 @@ function decodeBase64(value) {
   }
   return new Uint8Array(bytes);
 }
+function encodeBase64Url(bytes) {
+  return encodeBase64(bytes).replaceAll("+", "-").replaceAll("/", "_").replace(/=+$/u, "");
+}
+function decodeCursorPayload(cursor, invalidMessage) {
+  try {
+    const normalized = cursor.replaceAll("-", "+").replaceAll("_", "/").padEnd(Math.ceil(cursor.length / 4) * 4, "=");
+    const parsed = JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(decodeBase64(normalized)));
+    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) throw new TypeError(invalidMessage);
+    return parsed;
+  } catch (cause) {
+    if (cause instanceof TypeError && cause.message === invalidMessage) throw cause;
+    throw new TypeError("cursor must be a valid Base64URL JSON token.", { cause });
+  }
+}
 function encodeSubmissionCursor(value) {
   if (value.submittedAt.length === 0 || value.responseId.length === 0) {
     throw new TypeError("Cursor values must not be empty.");
@@ -2185,6 +2712,28 @@ function validatePageAnswers(schema, pageIndex, values) {
   }
   return issues.length === 0 ? { valid: true, issues: [] } : { valid: false, issues };
 }
+function validateSubmission(schema, submission, options) {
+  const values = submission.values;
+  const answerValidation = validateAnswers(schema, values);
+  const fieldErrors = {};
+  for (const issue2 of answerValidation.issues) {
+    const existing = fieldErrors[issue2.fieldId];
+    fieldErrors[issue2.fieldId] = existing === void 0 ? issue2.messageKey : `${existing}; ${issue2.messageKey}`;
+  }
+  const piiFindings = options?.privacyEngine?.detect(schema, { ...values });
+  if (piiFindings !== void 0) {
+    for (const finding of piiFindings) {
+      const existing = fieldErrors[finding.fieldId];
+      fieldErrors[finding.fieldId] = existing === void 0 ? "validation.sensitiveData" : `${existing}; validation.sensitiveData`;
+    }
+  }
+  return {
+    valid: Object.keys(fieldErrors).length === 0,
+    fieldErrors,
+    formErrors: [],
+    ...piiFindings === void 0 ? {} : { piiFindings }
+  };
+}
 
 // src/submission.ts
 function cloneValues(values) {
@@ -2192,7 +2741,46 @@ function cloneValues(values) {
     Object.entries(values).map(([key, value]) => [key, Array.isArray(value) ? Object.freeze([...value]) : value])
   );
 }
-function createSubmission(schema, values, options) {
+function generatedSubmissionId() {
+  return globalThis.crypto?.randomUUID?.() ?? `${Date.now()}-${Math.random().toString(36).slice(2)}`;
+}
+function toFormValues(answers) {
+  const values = {};
+  for (const [key, value] of Object.entries(answers)) {
+    if (isFormValue(value)) values[key] = value;
+  }
+  return values;
+}
+function isFormValue(value) {
+  return value === void 0 || typeof value === "string" || typeof value === "number" || typeof value === "boolean" || Array.isArray(value) && value.every((item) => typeof item === "string");
+}
+function createSubmission(schemaOrInput, values, options) {
+  if ("answers" in schemaOrInput) {
+    const input = schemaOrInput;
+    const id = input.id ?? generatedSubmissionId();
+    if (input.formId.trim().length === 0) throw new TypeError("formId must not be empty.");
+    if (!Number.isSafeInteger(input.formVersion) || input.formVersion < 1) {
+      throw new TypeError("formVersion must be a positive safe integer.");
+    }
+    const submittedAt = input.submittedAt ?? (/* @__PURE__ */ new Date()).toISOString();
+    if (submittedAt.trim().length === 0 || !Number.isFinite(Date.parse(submittedAt))) {
+      throw new TypeError("submittedAt must be a valid date string.");
+    }
+    const answers = Object.freeze({ ...input.answers });
+    return Object.freeze({
+      id,
+      formId: input.formId,
+      formVersion: input.formVersion,
+      locale: "",
+      values: Object.freeze(cloneValues(toFormValues(answers))),
+      answers,
+      metadata: input.metadata,
+      submittedAt,
+      ...input.schemaRevision === void 0 ? {} : { schemaRevision: input.schemaRevision }
+    });
+  }
+  const schema = schemaOrInput;
+  if (values === void 0 || options === void 0) throw new TypeError("values and options are required.");
   assertValidFormSchema(schema);
   if (options.id.trim().length === 0) throw new TypeError("Submission ID must not be empty.");
   if (options.locale.trim().length === 0) throw new TypeError("Submission locale must not be empty.");
@@ -2212,6 +2800,7 @@ function createSubmission(schema, values, options) {
     formVersion: schema.version,
     locale: options.locale,
     values: Object.freeze(cloneValues(visibleValues)),
+    answers: Object.freeze({ ...visibleValues }),
     submittedAt: options.submittedAt,
     ...options.metadata === void 0 ? {} : { metadata: Object.freeze({ ...options.metadata }) },
     ...options.translationMetadata === void 0 ? {} : { translationMetadata: Object.freeze({ ...options.translationMetadata }) }
@@ -2268,8 +2857,15 @@ function withTranslationMetadata(node, locale, property, metadata) {
     }
   };
 }
-function createSlot(kind, nodeId, property, locale, sourceText, existingText, nodeMetadata, existingTranslationMetadata, options = {}) {
-  const path = `${kind}.${nodeId}.${property}`;
+function localeRecordEntry2(record, locale) {
+  const normalizedLocale = normalizeLocale(locale) ?? locale;
+  for (const [candidate, value] of Object.entries(record ?? {})) {
+    if ((normalizeLocale(candidate) ?? candidate) === normalizedLocale) return value;
+  }
+  return void 0;
+}
+function createSlot(kind, nodeId, property, locale, sourceText, existingText, nodeMetadata, existingTranslationMetadata, options = {}, parentId) {
+  const path = kind === "form" ? `form.${property}` : kind === "option" ? `fields.${parentId ?? ""}.options.${nodeId}.${property}` : `${kind}s.${nodeId}.${property}`;
   const manual = options.isManualTranslation?.(existingTranslationMetadata, { path, locale }) ?? isManualTranslationMetadata(existingTranslationMetadata);
   const normalizedMetadata = existingTranslationMetadata === void 0 ? void 0 : options.normalizeMetadata === void 0 ? existingTranslationMetadata : { ...options.normalizeMetadata(existingTranslationMetadata, sourceText) };
   const status = getTranslationStatusWithManualOverride(sourceText, existingText, normalizedMetadata, manual);
@@ -2289,7 +2885,10 @@ function createSlot(kind, nodeId, property, locale, sourceText, existingText, no
   };
 }
 function translationSlots(schema, locale, options = {}) {
+  locale = normalizeLocale(locale) ?? locale;
   const descriptors = [];
+  const schemaTranslation = localeRecordEntry2(schema.translations, locale);
+  const schemaTranslationMetadata = localeRecordEntry2(schema.translationMetadata, locale);
   const addFormSlot = (property, sourceText) => {
     const slot = createSlot(
       "form",
@@ -2297,17 +2896,17 @@ function translationSlots(schema, locale, options = {}) {
       property,
       locale,
       sourceText,
-      schema.translations?.[locale]?.[property],
+      schemaTranslation?.[property],
       schema.metadata,
-      schema.translationMetadata?.[locale]?.[property],
+      schemaTranslationMetadata?.[property],
       options
     );
     descriptors.push({
       slot,
-      manual: options.isManualTranslation?.(schema.translationMetadata?.[locale]?.[property], {
+      manual: options.isManualTranslation?.(schemaTranslationMetadata?.[property], {
         path: slot.path ?? "",
         locale
-      }) ?? isManualTranslationMetadata(schema.translationMetadata?.[locale]?.[property]),
+      }) ?? isManualTranslationMetadata(schemaTranslationMetadata?.[property]),
       apply: (current, value, metadata) => withTranslationMetadata(
         { ...current, translations: mergeLocalizedText(current.translations, locale, property, value) },
         locale,
@@ -2320,6 +2919,8 @@ function translationSlots(schema, locale, options = {}) {
   if (schema.description !== void 0) addFormSlot("description", schema.description);
   if (schema.completionMessage !== void 0) addFormSlot("completionMessage", schema.completionMessage);
   schema.fields.forEach((field, fieldIndex) => {
+    const fieldTranslation = localeRecordEntry2(field.translations, locale);
+    const fieldTranslationMetadata = localeRecordEntry2(field.translationMetadata, locale);
     const addFieldSlot = (property, sourceText) => {
       const slot = createSlot(
         "field",
@@ -2327,17 +2928,17 @@ function translationSlots(schema, locale, options = {}) {
         property,
         locale,
         sourceText,
-        field.translations?.[locale]?.[property],
+        fieldTranslation?.[property],
         field.metadata,
-        field.translationMetadata?.[locale]?.[property],
+        fieldTranslationMetadata?.[property],
         options
       );
       descriptors.push({
         slot,
-        manual: options.isManualTranslation?.(field.translationMetadata?.[locale]?.[property], {
+        manual: options.isManualTranslation?.(fieldTranslationMetadata?.[property], {
           path: slot.path ?? "",
           locale
-        }) ?? isManualTranslationMetadata(field.translationMetadata?.[locale]?.[property]),
+        }) ?? isManualTranslationMetadata(fieldTranslationMetadata?.[property]),
         apply: (current, value, metadata) => ({
           ...current,
           fields: current.fields.map(
@@ -2358,23 +2959,26 @@ function translationSlots(schema, locale, options = {}) {
     if (field.description !== void 0) addFieldSlot("description", field.description);
     if ("options" in field) {
       field.options.forEach((option, optionIndex) => {
+        const optionTranslation = localeRecordEntry2(option.translations, locale);
+        const optionTranslationMetadata = localeRecordEntry2(option.translationMetadata, locale);
         const slot = createSlot(
           "option",
           option.id,
           "label",
           locale,
           option.label,
-          option.translations?.[locale],
+          optionTranslation,
           option.metadata,
-          option.translationMetadata?.[locale]?.label,
-          options
+          optionTranslationMetadata?.label,
+          options,
+          field.id
         );
         descriptors.push({
           slot,
-          manual: options.isManualTranslation?.(option.translationMetadata?.[locale]?.label, {
+          manual: options.isManualTranslation?.(optionTranslationMetadata?.label, {
             path: slot.path ?? "",
             locale
-          }) ?? isManualTranslationMetadata(option.translationMetadata?.[locale]?.label),
+          }) ?? isManualTranslationMetadata(optionTranslationMetadata?.label),
           apply: (current, value, metadata) => ({
             ...current,
             fields: current.fields.map((candidate, candidateIndex) => {
@@ -2400,6 +3004,8 @@ function translationSlots(schema, locale, options = {}) {
     }
   });
   schema.pages?.forEach((page, pageIndex) => {
+    const pageTranslation = localeRecordEntry2(page.translations, locale);
+    const pageTranslationMetadata = localeRecordEntry2(page.translationMetadata, locale);
     const addPageSlot = (property, sourceText) => {
       const slot = createSlot(
         "page",
@@ -2407,17 +3013,17 @@ function translationSlots(schema, locale, options = {}) {
         property,
         locale,
         sourceText,
-        page.translations?.[locale]?.[property],
+        pageTranslation?.[property],
         page.metadata,
-        page.translationMetadata?.[locale]?.[property],
+        pageTranslationMetadata?.[property],
         options
       );
       descriptors.push({
         slot,
-        manual: options.isManualTranslation?.(page.translationMetadata?.[locale]?.[property], {
+        manual: options.isManualTranslation?.(pageTranslationMetadata?.[property], {
           path: slot.path ?? "",
           locale
-        }) ?? isManualTranslationMetadata(page.translationMetadata?.[locale]?.[property]),
+        }) ?? isManualTranslationMetadata(pageTranslationMetadata?.[property]),
         apply: (current, value, metadata) => ({
           ...current,
           ...current.pages === void 0 ? {} : {
@@ -2505,7 +3111,7 @@ var migrateSchemaTranslationMetadata = (schema, migratorOrOptions) => {
     (locale, property) => ({
       locale,
       defaultLocale,
-      path: property,
+      path: `form.${property}`,
       property,
       nodeKind: "form"
     }),
@@ -2604,8 +3210,11 @@ function collectTranslationSlots(schema, locale) {
   return translationSlots(schema, locale).map((descriptor) => descriptor.slot);
 }
 function resolveLocalizedSchema(schema, targetLocale) {
-  if (targetLocale === void 0 || targetLocale.length === 0 || targetLocale === schema.defaultLocale) return schema;
-  const formTranslation = schema.translations?.[targetLocale];
+  if (targetLocale === void 0 || targetLocale.length === 0) return schema;
+  const normalizedTargetLocale = normalizeLocale(targetLocale) ?? targetLocale;
+  const defaultLocale = schema.defaultLocale === void 0 ? void 0 : normalizeLocale(schema.defaultLocale);
+  if (normalizedTargetLocale === defaultLocale || targetLocale === schema.defaultLocale) return schema;
+  const formTranslation = localeRecordEntry2(schema.translations, normalizedTargetLocale);
   const completionMessage = formTranslation?.completionMessage ?? schema.completionMessage;
   return {
     ...schema,
@@ -2613,7 +3222,7 @@ function resolveLocalizedSchema(schema, targetLocale) {
     ...(formTranslation?.description ?? schema.description) === void 0 ? {} : { description: formTranslation?.description ?? schema.description },
     ...completionMessage === void 0 ? {} : { completionMessage },
     fields: schema.fields.map((field) => {
-      const translation = field.translations?.[targetLocale];
+      const translation = localeRecordEntry2(field.translations, normalizedTargetLocale);
       const localized = {
         ...field,
         title: translation?.title ?? field.title,
@@ -2624,13 +3233,13 @@ function resolveLocalizedSchema(schema, targetLocale) {
         ...localized,
         options: field.options.map((option) => ({
           ...option,
-          label: option.translations?.[targetLocale] ?? option.label
+          label: localeRecordEntry2(option.translations, normalizedTargetLocale) ?? option.label
         }))
       };
     }),
     ...schema.pages === void 0 ? {} : {
       pages: schema.pages.map((page) => {
-        const translation = page.translations?.[targetLocale];
+        const translation = localeRecordEntry2(page.translations, normalizedTargetLocale);
         const title = translation?.title ?? page.title;
         const description = translation?.description ?? page.description;
         return {
@@ -2644,8 +3253,13 @@ function resolveLocalizedSchema(schema, targetLocale) {
 }
 async function populateSchemaTranslations(schema, targetLocales, adapter, options = {}) {
   assertValidFormSchema(schema);
-  const locales = [...new Set(targetLocales.filter((locale) => locale.length > 0 && locale !== schema.defaultLocale))];
-  const allowedLocales = options.policy?.allowedLocales;
+  const defaultLocale = schema.defaultLocale === void 0 ? void 0 : normalizeLocale(schema.defaultLocale) ?? schema.defaultLocale;
+  const locales = [
+    ...new Set(
+      targetLocales.map((locale) => normalizeLocale(locale) ?? locale.trim()).filter((locale) => locale.length > 0 && locale !== defaultLocale)
+    )
+  ];
+  const allowedLocales = options.policy?.allowedLocales?.map((locale) => normalizeLocale(locale) ?? locale);
   const collectedLocales = collectSchemaLocales(schema);
   const disallowedLocale = [...collectedLocales.allUniqueLocales, ...locales].find(
     (locale) => allowedLocales !== void 0 && !allowedLocales.includes(locale)
@@ -2687,7 +3301,7 @@ async function populateSchemaTranslations(schema, targetLocales, adapter, option
       adapter,
       selected.map((descriptor) => descriptor.slot.sourceText),
       locale,
-      schema.defaultLocale
+      defaultLocale
     );
     if (translated.length !== selected.length) {
       throw new Error(`Translation adapter returned ${translated.length} texts for ${selected.length} inputs.`);
@@ -2696,7 +3310,7 @@ async function populateSchemaTranslations(schema, targetLocales, adapter, option
       const translatedText = translated[index];
       if (translatedText === void 0) throw new Error("Translation adapter returned an unexpected result.");
       const metadata = options.createMetadata?.(descriptor.slot, translatedText) ?? {
-        sourceLocale: schema.defaultLocale ?? "",
+        sourceLocale: defaultLocale ?? "",
         sourceTextHash: computeSourceTextHash(descriptor.slot.sourceText),
         translationSource: "automatic",
         translatedAt: (/* @__PURE__ */ new Date()).toISOString()
@@ -2707,8 +3321,8 @@ async function populateSchemaTranslations(schema, targetLocales, adapter, option
   }
   const supportedLocales = [
     .../* @__PURE__ */ new Set([
-      ...schema.defaultLocale === void 0 ? [] : [schema.defaultLocale],
-      ...schema.supportedLocales ?? [],
+      ...defaultLocale === void 0 ? [] : [defaultLocale],
+      ...(schema.supportedLocales ?? []).map((locale) => normalizeLocale(locale) ?? locale),
       ...locales
     ])
   ];
@@ -3005,10 +3619,50 @@ function assertVersionMutable(status) {
     throw new TypeError(`A ${status} form version is immutable.`, { cause: error });
   }
 }
+function applyTransitionPlan(plan) {
+  if (plan.schema !== void 0) return plan.schema;
+  if (plan.publishedRecordToSave !== void 0) return plan.publishedRecordToSave.schema;
+  if (plan.draftToCreate !== void 0) return plan.draftToCreate.schema;
+  const archivedSchema = plan.archivedRecordsToSave?.[0]?.schema;
+  if (archivedSchema !== void 0) return archivedSchema;
+  throw new TypeError("A version transition plan must include a target schema.");
+}
+async function commitVersionTransition(options) {
+  const { context, beforeTransition, afterTransition, persistAdapter } = options;
+  const { formId, toVersion, expectedRevision, plan } = context;
+  let currentDomainData = context.domainData;
+  try {
+    if (beforeTransition !== void 0) {
+      const hookResult = await beforeTransition(context);
+      if (hookResult !== void 0) currentDomainData = hookResult;
+    }
+    const nextSchema = applyTransitionPlan(plan);
+    const { nextRevision } = await persistAdapter({
+      formId,
+      targetVersion: toVersion,
+      expectedRevision,
+      schema: nextSchema,
+      ...currentDomainData === void 0 ? {} : { domainData: currentDomainData }
+    });
+    if (afterTransition !== void 0) {
+      await afterTransition({
+        ...context,
+        ...currentDomainData === void 0 ? {} : { domainData: currentDomainData },
+        nextRevision
+      });
+    }
+    return { success: true, nextRevision };
+  } catch (cause) {
+    return { success: false, nextRevision: expectedRevision, error: { type: "transition_failed", cause } };
+  }
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   DEFAULT_FIELD_TYPE_DEFINITIONS,
+  EN_MESSAGES,
+  JA_MESSAGES,
   aggregateResponses,
+  applyTransitionPlan,
   assertValidFormSchema,
   assertVersionMutable,
   calculateChoiceDistribution,
@@ -3019,16 +3673,22 @@ function assertVersionMutable(status) {
   cloneVersionToDraft,
   collectSchemaLocales,
   collectTranslationSlots,
+  commitVersionTransition,
   computeSourceTextHash,
   createCloneTransitionPlan,
   createDeleteDraftTransitionPlan,
+  createFormEngineTranslator,
   createPublishTransitionPlan,
   createResponseAccumulator,
   createSubmission,
+  decodeStorageSubmissionCursor,
+  decodeStorageTextAnswerCursor,
   decodeSubmissionCursor,
   decodeTextAnswerCursor,
   deleteDraft,
   dispatchWebhook,
+  encodeStorageSubmissionCursor,
+  encodeStorageTextAnswerCursor,
   encodeSubmissionCursor,
   encodeTextAnswerCursor,
   escapeCsvCell,
@@ -3044,7 +3704,9 @@ function assertVersionMutable(status) {
   matchesSubmissionFilter,
   matchesSubmissionPageFilters,
   migrateSchemaTranslationMetadata,
+  normalizeLocale,
   normalizeSubmissionPageSize,
+  paginateWithFilter,
   pipeResponsesToCsvStream,
   populateSchemaTranslations,
   publishDraft,
@@ -3057,5 +3719,6 @@ function assertVersionMutable(status) {
   validateAnswers,
   validateFormSchema,
   validatePageAnswers,
-  validateSchemaStructure
+  validateSchemaStructure,
+  validateSubmission
 });