@form-engine-ts/core 4.5.0 → 4.7.0

package/README.md

@@ -62,6 +62,15 @@ operators include equality, containment, emptiness, and numeric comparisons; the
 and missing, translated, stale, or manual states for authoring tools. `populateSchemaTranslations` can populate stale
 and missing entries while preserving manual translations and reports skipped reasons.
 
+Legacy translation metadata can be recognized with `isManualTranslationMetadata` and migrated with
+`migrateSchemaTranslationMetadata`; pass a custom migrator (directly or as `{ migrator }`) when legacy fields need
+application-specific conversion. The migrator receives `TranslationMigrationContext` with the locale, JSON path,
+property, node kind, and node identifiers.
+`PopulateTranslationsOptions` is a compatibility alias for `PopulateTranslationOptions`, which also accepts custom
+manual-translation detection and metadata normalization callbacks. `removeLocaleFromSchema(schema, locale)` removes
+the locale from registrations and all form, page, field, option translation values and metadata; the default locale
+cannot be removed.
+
 The React builder uses canonical keys with legacy aliases when resolving UI translations:
 
 | Canonical key | Legacy alias |

package/dist/index.cjs

@@ -50,15 +50,18 @@ __export(index_exports, {
   getTranslationStatus: () => getTranslationStatus,
   isDisplayConditionGroupSatisfied: () => isDisplayConditionGroupSatisfied,
   isDisplayConditionSatisfied: () => isDisplayConditionSatisfied,
+  isManualTranslationMetadata: () => isManualTranslationMetadata,
   isQuestionVisible: () => isQuestionVisible,
   iterateSubmissionPages: () => iterateSubmissionPages,
   jsonValuesEqual: () => jsonValuesEqual,
   matchesSubmissionFilter: () => matchesSubmissionFilter,
   matchesSubmissionPageFilters: () => matchesSubmissionPageFilters,
+  migrateSchemaTranslationMetadata: () => migrateSchemaTranslationMetadata,
   normalizeSubmissionPageSize: () => normalizeSubmissionPageSize,
   pipeResponsesToCsvStream: () => pipeResponsesToCsvStream,
   populateSchemaTranslations: () => populateSchemaTranslations,
   publishDraft: () => publishDraft,
+  removeLocaleFromSchema: () => removeLocaleFromSchema,
   resolveFormTranslation: () => resolveFormTranslation,
   resolveLocalizedSchema: () => resolveLocalizedSchema,
   sanitizeSchema: () => sanitizeSchema,
@@ -2216,6 +2219,12 @@ function createSubmission(schema, values, options) {
 }
 
 // src/translation.ts
+var isManualTranslationMetadata = (metadata) => {
+  if (metadata === void 0) return false;
+  if ("isManuallyEdited" in metadata && metadata.isManuallyEdited === true || "isManual" in metadata && metadata.isManual === true)
+    return true;
+  return typeof metadata.translationSource === "string" && metadata.translationSource.toLowerCase() === "manual";
+};
 var computeSourceTextHash = (text) => {
   const normalized = text.normalize("NFKC").trim().replace(/\s+/gu, " ");
   let hash = 2166136261;
@@ -2226,11 +2235,14 @@ var computeSourceTextHash = (text) => {
   return (hash >>> 0).toString(16).padStart(8, "0");
 };
 function getTranslationStatus(sourceText, translatedText, metadata) {
+  return getTranslationStatusWithManualOverride(sourceText, translatedText, metadata, void 0);
+}
+function getTranslationStatusWithManualOverride(sourceText, translatedText, metadata, manualOverride) {
   if (translatedText === void 0 || translatedText.trim() === "") return "missing";
   if (metadata === void 0) return "translated";
   const currentHash = computeSourceTextHash(sourceText);
   const sourceHash = typeof metadata.sourceTextHash === "string" ? metadata.sourceTextHash : void 0;
-  const isManual = metadata.translationSource === "manual" || "isManual" in metadata && metadata.isManual === true;
+  const isManual = manualOverride ?? isManualTranslationMetadata(metadata);
   if (isManual) return sourceHash === void 0 || sourceHash === currentHash ? "manual" : "manual-stale";
   return sourceHash === void 0 || sourceHash === currentHash ? "translated" : "stale";
 }
@@ -2256,8 +2268,11 @@ function withTranslationMetadata(node, locale, property, metadata) {
     }
   };
 }
-function createSlot(kind, nodeId, property, locale, sourceText, existingText, nodeMetadata, existingTranslationMetadata) {
-  const status = getTranslationStatus(sourceText, existingText, existingTranslationMetadata);
+function createSlot(kind, nodeId, property, locale, sourceText, existingText, nodeMetadata, existingTranslationMetadata, options = {}) {
+  const path = `${kind}.${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);
   return {
     kind,
     nodeId,
@@ -2265,15 +2280,15 @@ function createSlot(kind, nodeId, property, locale, sourceText, existingText, no
     locale,
     sourceText,
     target: { kind, ...nodeId.length === 0 ? {} : { id: nodeId }, property },
-    path: `${kind}.${nodeId}.${property}`,
+    path,
     sourceTextHash: computeSourceTextHash(sourceText),
     status,
     ...existingText === void 0 ? {} : { existingText },
     ...nodeMetadata === void 0 ? {} : { nodeMetadata, metadata: nodeMetadata },
-    ...existingTranslationMetadata === void 0 ? {} : { existingTranslationMetadata }
+    ...normalizedMetadata === void 0 ? {} : { existingTranslationMetadata: normalizedMetadata }
   };
 }
-function translationSlots(schema, locale) {
+function translationSlots(schema, locale, options = {}) {
   const descriptors = [];
   const addFormSlot = (property, sourceText) => {
     const slot = createSlot(
@@ -2284,10 +2299,15 @@ function translationSlots(schema, locale) {
       sourceText,
       schema.translations?.[locale]?.[property],
       schema.metadata,
-      schema.translationMetadata?.[locale]?.[property]
+      schema.translationMetadata?.[locale]?.[property],
+      options
     );
     descriptors.push({
       slot,
+      manual: options.isManualTranslation?.(schema.translationMetadata?.[locale]?.[property], {
+        path: slot.path ?? "",
+        locale
+      }) ?? isManualTranslationMetadata(schema.translationMetadata?.[locale]?.[property]),
       apply: (current, value, metadata) => withTranslationMetadata(
         { ...current, translations: mergeLocalizedText(current.translations, locale, property, value) },
         locale,
@@ -2309,10 +2329,15 @@ function translationSlots(schema, locale) {
         sourceText,
         field.translations?.[locale]?.[property],
         field.metadata,
-        field.translationMetadata?.[locale]?.[property]
+        field.translationMetadata?.[locale]?.[property],
+        options
       );
       descriptors.push({
         slot,
+        manual: options.isManualTranslation?.(field.translationMetadata?.[locale]?.[property], {
+          path: slot.path ?? "",
+          locale
+        }) ?? isManualTranslationMetadata(field.translationMetadata?.[locale]?.[property]),
         apply: (current, value, metadata) => ({
           ...current,
           fields: current.fields.map(
@@ -2341,10 +2366,15 @@ function translationSlots(schema, locale) {
           option.label,
           option.translations?.[locale],
           option.metadata,
-          option.translationMetadata?.[locale]?.label
+          option.translationMetadata?.[locale]?.label,
+          options
         );
         descriptors.push({
           slot,
+          manual: options.isManualTranslation?.(option.translationMetadata?.[locale]?.label, {
+            path: slot.path ?? "",
+            locale
+          }) ?? isManualTranslationMetadata(option.translationMetadata?.[locale]?.label),
           apply: (current, value, metadata) => ({
             ...current,
             fields: current.fields.map((candidate, candidateIndex) => {
@@ -2379,10 +2409,15 @@ function translationSlots(schema, locale) {
         sourceText,
         page.translations?.[locale]?.[property],
         page.metadata,
-        page.translationMetadata?.[locale]?.[property]
+        page.translationMetadata?.[locale]?.[property],
+        options
       );
       descriptors.push({
         slot,
+        manual: options.isManualTranslation?.(page.translationMetadata?.[locale]?.[property], {
+          path: slot.path ?? "",
+          locale
+        }) ?? isManualTranslationMetadata(page.translationMetadata?.[locale]?.[property]),
         apply: (current, value, metadata) => ({
           ...current,
           ...current.pages === void 0 ? {} : {
@@ -2406,6 +2441,165 @@ function translationSlots(schema, locale) {
   });
   return descriptors;
 }
+function removeLocaleRecord(record, locale) {
+  if (record === void 0) return void 0;
+  const remaining = Object.entries(record).filter(([candidate]) => candidate !== locale);
+  return remaining.length === 0 ? void 0 : Object.fromEntries(remaining);
+}
+function removeLocalizedNodeLocale(node, locale) {
+  const translations = removeLocaleRecord(node.translations, locale);
+  const translationMetadata = removeLocaleRecord(node.translationMetadata, locale);
+  const { translations: _translations, translationMetadata: _translationMetadata, ...base } = node;
+  return {
+    ...base,
+    ...translations === void 0 ? {} : { translations },
+    ...translationMetadata === void 0 ? {} : { translationMetadata }
+  };
+}
+function defaultTranslationMetadataMigrator(metadata, sourceText, defaultLocale) {
+  const record = metadata !== null && typeof metadata === "object" ? metadata : void 0;
+  const sourceLocale = typeof record?.sourceLocale === "string" ? record.sourceLocale : defaultLocale;
+  const translationSource = isManualTranslationMetadata(record) ? "manual" : "automatic";
+  return {
+    sourceLocale,
+    sourceTextHash: computeSourceTextHash(sourceText),
+    translationSource,
+    ...typeof record?.translatedAt === "string" ? { translatedAt: record.translatedAt } : {},
+    ...typeof record?.editedAt === "string" ? { editedAt: record.editedAt } : {}
+  };
+}
+function migrateMetadata(metadata, sourceText, context, migrator) {
+  return migrator(metadata, sourceText, context);
+}
+function isTranslationMetadataProperty(property) {
+  return property === "title" || property === "description" || property === "label" || property === "completionMessage";
+}
+function migrateNodeMetadata(node, sourceTexts, contextFor, migrator) {
+  if (node.translationMetadata === void 0) return node;
+  const translationMetadata = Object.fromEntries(
+    Object.entries(node.translationMetadata).map(([locale, properties]) => [
+      locale,
+      Object.fromEntries(
+        Object.entries(properties).map(([property, metadata]) => {
+          if (!isTranslationMetadataProperty(property)) return [property, metadata];
+          return [
+            property,
+            migrateMetadata(metadata, sourceTexts[property] ?? "", contextFor(locale, property), migrator)
+          ];
+        })
+      )
+    ])
+  );
+  return { ...node, translationMetadata };
+}
+var migrateSchemaTranslationMetadata = (schema, migratorOrOptions) => {
+  const defaultLocale = schema.defaultLocale ?? "";
+  const migrator = typeof migratorOrOptions === "function" ? migratorOrOptions : migratorOrOptions?.migrator ?? ((metadata, sourceText, context) => defaultTranslationMetadataMigrator(metadata, sourceText, context.defaultLocale));
+  const migratedSchema = migrateNodeMetadata(
+    schema,
+    {
+      title: schema.title,
+      ...schema.description === void 0 ? {} : { description: schema.description },
+      ...schema.completionMessage === void 0 ? {} : { completionMessage: schema.completionMessage }
+    },
+    (locale, property) => ({
+      locale,
+      defaultLocale,
+      path: property,
+      property,
+      nodeKind: "form"
+    }),
+    migrator
+  );
+  const fields = schema.fields.map((field) => {
+    const migratedField = migrateNodeMetadata(
+      field,
+      { title: field.title, ...field.description === void 0 ? {} : { description: field.description } },
+      (locale, property) => ({
+        locale,
+        defaultLocale,
+        path: `fields.${field.id}.${property}`,
+        property,
+        nodeKind: "field",
+        nodeId: field.id
+      }),
+      migrator
+    );
+    if (!("options" in migratedField)) return migratedField;
+    return {
+      ...migratedField,
+      options: migratedField.options.map(
+        (option) => migrateNodeMetadata(
+          option,
+          { label: option.label },
+          (locale, property) => ({
+            locale,
+            defaultLocale,
+            path: `fields.${field.id}.options.${option.id}.${property}`,
+            property,
+            nodeKind: "option",
+            nodeId: option.id,
+            parentId: field.id
+          }),
+          migrator
+        )
+      )
+    };
+  });
+  const pages = schema.pages?.map(
+    (page) => migrateNodeMetadata(
+      page,
+      {
+        ...page.title === void 0 ? {} : { title: page.title },
+        ...page.description === void 0 ? {} : { description: page.description }
+      },
+      (locale, property) => ({
+        locale,
+        defaultLocale,
+        path: `pages.${page.id}.${property}`,
+        property,
+        nodeKind: "page",
+        nodeId: page.id
+      }),
+      migrator
+    )
+  );
+  return {
+    ...migratedSchema,
+    fields,
+    ...pages === void 0 ? {} : { pages }
+  };
+};
+var removeLocaleFromSchema = (schema, localeToRemove) => {
+  if (localeToRemove === schema.defaultLocale) {
+    throw new Error(`Cannot remove defaultLocale: ${localeToRemove}`);
+  }
+  const form = removeLocalizedNodeLocale(schema, localeToRemove);
+  const fields = schema.fields.map((field) => {
+    const localizedField = removeLocalizedNodeLocale(field, localeToRemove);
+    if (!("options" in localizedField)) return localizedField;
+    return {
+      ...localizedField,
+      options: localizedField.options.map((option) => {
+        const translations = removeLocaleRecord(option.translations, localeToRemove);
+        const translationMetadata = removeLocaleRecord(option.translationMetadata, localeToRemove);
+        const { translations: _translations, translationMetadata: _translationMetadata, ...base } = option;
+        return {
+          ...base,
+          ...translations === void 0 ? {} : { translations },
+          ...translationMetadata === void 0 ? {} : { translationMetadata }
+        };
+      })
+    };
+  });
+  const pages = schema.pages?.map((page) => removeLocalizedNodeLocale(page, localeToRemove));
+  return {
+    ...form,
+    supportedLocales: (schema.supportedLocales ?? []).filter((locale) => locale !== localeToRemove),
+    fields,
+    ...pages === void 0 ? {} : { pages }
+  };
+};
 function collectTranslationSlots(schema, locale) {
   return translationSlots(schema, locale).map((descriptor) => descriptor.slot);
 }
@@ -2469,7 +2663,7 @@ async function populateSchemaTranslations(schema, targetLocales, adapter, option
   const skippedReasons = {};
   let result = schema;
   for (const locale of locales) {
-    const descriptors = translationSlots(schema, locale);
+    const descriptors = translationSlots(schema, locale, options);
     if (options.markStaleTranslations ?? true) {
       for (const descriptor of descriptors) {
         if (descriptor.slot.status === "stale" || descriptor.slot.status === "manual-stale")
@@ -2479,8 +2673,9 @@ async function populateSchemaTranslations(schema, targetLocales, adapter, option
     const selected = [];
     for (const descriptor of descriptors) {
       const status = descriptor.slot.status ?? "missing";
-      const manual = status === "manual" || status === "manual-stale";
-      const shouldTranslate = options.shouldOverwrite?.(descriptor.slot) ?? ((!(options.preserveManualTranslations ?? true) || !manual) && (options.overwrite === "all" || (options.overwrite === "stale-and-missing" || options.overwrite === void 0 ? status === "missing" || status === "stale" || !(options.preserveManualTranslations ?? true) && status === "manual-stale" : status === "missing")));
+      const manual = descriptor.manual || status === "manual" || status === "manual-stale";
+      const requestedOverwrite = options.shouldOverwrite?.(descriptor.slot);
+      const shouldTranslate = (options.preserveManualTranslations ?? true) && manual ? false : requestedOverwrite ?? (options.overwrite === "all" || (options.overwrite === "stale-and-missing" || options.overwrite === void 0 ? status === "missing" || status === "stale" || !(options.preserveManualTranslations ?? true) && status === "manual-stale" : status === "missing"));
       if (shouldTranslate) selected.push(descriptor);
       else {
         skippedSlots.push(descriptor.slot);
@@ -2842,15 +3037,18 @@ function assertVersionMutable(status) {
   getTranslationStatus,
   isDisplayConditionGroupSatisfied,
   isDisplayConditionSatisfied,
+  isManualTranslationMetadata,
   isQuestionVisible,
   iterateSubmissionPages,
   jsonValuesEqual,
   matchesSubmissionFilter,
   matchesSubmissionPageFilters,
+  migrateSchemaTranslationMetadata,
   normalizeSubmissionPageSize,
   pipeResponsesToCsvStream,
   populateSchemaTranslations,
   publishDraft,
+  removeLocaleFromSchema,
   resolveFormTranslation,
   resolveLocalizedSchema,
   sanitizeSchema,

package/dist/index.d.cts

@@ -686,15 +686,55 @@ interface CanonicalTranslationMetadata {
     readonly translatedAt?: string;
     readonly editedAt?: string;
 }
+interface LegacyTranslationMetadata {
+    readonly isManuallyEdited?: boolean;
+    readonly translationSource?: "MANUAL" | "AUTOMATIC" | "manual" | "automatic" | string;
+    readonly sourceTextHash?: string;
+    readonly sourceText?: string;
+    readonly sourceLocale?: string;
+    readonly translatedAt?: string;
+    readonly editedAt?: string;
+    readonly isManual?: boolean;
+    readonly [key: string]: unknown;
+}
+interface TranslationMigrationContext {
+    /** Target locale code, for example "en" or "zh-Hans". */
+    readonly locale: string;
+    /** The schema's default locale. */
+    readonly defaultLocale: string;
+    /** JSON path of the translated property. */
+    readonly path: string;
+    /** Translated property name. */
+    readonly property: "title" | "description" | "label" | "completionMessage";
+    /** Kind of node that owns the translated property. */
+    readonly nodeKind: "form" | "page" | "field" | "option";
+    /** Identifier of the owning node. */
+    readonly nodeId?: string;
+    /** Identifier of the parent node, used for options. */
+    readonly parentId?: string;
+}
+type TranslationMetadataMigrator = (oldMeta: unknown, sourceText: string, context: TranslationMigrationContext) => CanonicalTranslationMetadata;
+interface MigrateSchemaTranslationMetadataOptions {
+    /** Custom migration function used instead of the built-in legacy normalizer. */
+    readonly migrator?: TranslationMetadataMigrator;
+}
+declare const isManualTranslationMetadata: (metadata?: LegacyTranslationMetadata | CanonicalTranslationMetadata) => boolean;
 interface PopulateTranslationOptions {
     readonly overwrite?: "all" | "missing-only" | "stale-and-missing";
     readonly preserveManualTranslations?: boolean;
     readonly markStaleTranslations?: boolean;
     readonly shouldOverwrite?: (slot: TranslationSlot) => boolean;
     readonly createMetadata?: (slot: TranslationSlot, translatedText: string) => Readonly<Record<string, JsonValue>>;
+    readonly isManualTranslation?: (metadata: unknown, context: {
+        readonly path: string;
+        readonly locale: string;
+    }) => boolean;
+    readonly normalizeMetadata?: (metadata: unknown, sourceText: string) => CanonicalTranslationMetadata;
     /** Applies locale admission and count limits before the adapter is called. */
     readonly policy?: Pick<FormPolicy, "allowedLocales" | "maxLocales">;
 }
+/** Compatibility alias for clients that used the pluralized options name. */
+type PopulateTranslationsOptions = PopulateTranslationOptions;
 interface TranslationReport {
     readonly updatedSlots: readonly TranslationSlot[];
     readonly skippedSlots: readonly TranslationSlot[];
@@ -703,6 +743,9 @@ interface TranslationReport {
 }
 declare const computeSourceTextHash: (text: string) => string;
 declare function getTranslationStatus(sourceText: string, translatedText: string | undefined, metadata: CanonicalTranslationMetadata | Readonly<Record<string, JsonValue>> | undefined): TranslationStatus;
+declare const migrateSchemaTranslationMetadata: (schema: FormSchema, migratorOrOptions?: ((oldMeta: unknown, sourceText: string) => CanonicalTranslationMetadata) | TranslationMetadataMigrator | MigrateSchemaTranslationMetadataOptions) => FormSchema;
+/** Removes a locale registration and every localized value and metadata entry for it. */
+declare const removeLocaleFromSchema: (schema: FormSchema, localeToRemove: string) => FormSchema;
 declare function collectTranslationSlots(schema: FormSchema, locale: string): readonly TranslationSlot[];
 declare function resolveLocalizedSchema(schema: FormSchema, targetLocale?: string): FormSchema;
 declare function populateSchemaTranslations(schema: FormSchema, targetLocales: readonly string[], adapter: AsyncTranslationAdapter, options?: PopulateTranslationOptions): Promise<{
@@ -725,4 +768,4 @@ declare function calculatePageVisibility(schema: FormSchema, currentAnswers: Rea
 declare function calculateFieldVisibility(schema: FormSchema, currentAnswers: Readonly<Record<string, unknown>>): Readonly<Record<string, boolean>>;
 declare function selectVisibleAnswers(schema: FormSchema, currentAnswers: FormValues): FormValues;
 
-export { type AccumulatorReport, type AccumulatorResponse, type AccumulatorSkipReason, type AnswerValidationResult, type AsyncTranslationAdapter, type BaseField, type BaseFieldConstraintRule, type BuilderTranslationKey, type CanonicalTranslationMetadata, type CheckboxField, type CheckboxQuestionAggregate, type ChoiceDistributionEntry, type ChoiceFieldConstraintRule, type ChoiceOption, type ChoiceQuestionAggregate, type CloneVersionOptions, type CollectedLocales, type ConditionOperator, type ConditionValue, type CreateSubmissionOptions, type CrossTabulationResult, type CsvColumnContext, type CsvColumnDef, type CsvExportOptions, DEFAULT_FIELD_TYPE_DEFINITIONS, type DeleteDraftOptions, type DisplayCondition, type DisplayConditionGroup, type DisplayRule, type ExtensibleNode, type FieldConstraintRule, type FieldDisplayCondition, type FieldOption, type FieldType, type FieldTypeDefinition, type FormAnalytics, type FormEvent, type FormEventType, type FormField, type FormPage, type FormPolicy, type FormResponse, type FormSchema, type FormStorageAdapter, type FormSubmission, type FormSubmissionSettings, type FormValue, type FormValues, type FormVersionRecord, type FormVersionState, type FormVersionStatus, type JsonValue, type LocalizedText, type MultiSelectField, type NodeWritableStream, type NumberField, type NumberQuestionAggregate, type NumericSummary, type OptionAggregate, type PagedSubmissionStorageAdapter, type PaginationIteratorOptions, type PopulateTranslationOptions, type PublishDraftOptions, type PublishDraftResult, type Question, type QuestionAggregate, type QuestionType, type RatingField, type RatingFieldConstraintRule, type ResponseAccumulator, type ResponseAccumulatorOptions, type Result, type SanitizeSchemaOptions, type SchemaIssue, type SchemaStructureIssue, type SchemaStructureIssueType, type SchemaTranslations, type SchemaValidationResult, type SelectField, type StorageAdapter, type StorageCommitError, type StreamCsvOptions, type SubmissionCursorValue, type SubmissionFilter, type SubmissionPage, type SubmissionPageQueryOptions, type SubmissionQueryOptions, type TextAnswerCursorValue, type TextAnswerItem, type TextAnswerPage, type TextAnswerPageQueryOptions, type TextField, type TextFieldConstraintRule, type TextQuestionAggregate, type TranslationAdapter, type TranslationReport, type TranslationSlot, type TranslationStatus, type ValidateFormSchemaOptions, type ValidationCode, type ValidationError, type ValidationIssue, type VersionTransitionError, type VersionTransitionEvent, type VersionTransitionPlan, type VersionedFormStorageAdapter, type WebhookConfig, type WebhookDispatchResult, aggregateResponses, assertValidFormSchema, assertVersionMutable, calculateChoiceDistribution, calculateCrossTabulation, calculateFieldVisibility, calculateNumericSummary, calculatePageVisibility, cloneVersionToDraft, collectSchemaLocales, collectTranslationSlots, computeSourceTextHash, createCloneTransitionPlan, createDeleteDraftTransitionPlan, createPublishTransitionPlan, createResponseAccumulator, createSubmission, decodeSubmissionCursor, decodeTextAnswerCursor, deleteDraft, dispatchWebhook, encodeSubmissionCursor, encodeTextAnswerCursor, escapeCsvCell, exportResponsesToCsv, exportResponsesToCsvStream, getTranslationStatus, isDisplayConditionGroupSatisfied, isDisplayConditionSatisfied, isQuestionVisible, iterateSubmissionPages, jsonValuesEqual, matchesSubmissionFilter, matchesSubmissionPageFilters, normalizeSubmissionPageSize, pipeResponsesToCsvStream, populateSchemaTranslations, publishDraft, resolveFormTranslation, resolveLocalizedSchema, sanitizeSchema, selectVisibleAnswers, transformFieldType, validateAnswers, validateFormSchema, validatePageAnswers, validateSchemaStructure };
+export { type AccumulatorReport, type AccumulatorResponse, type AccumulatorSkipReason, type AnswerValidationResult, type AsyncTranslationAdapter, type BaseField, type BaseFieldConstraintRule, type BuilderTranslationKey, type CanonicalTranslationMetadata, type CheckboxField, type CheckboxQuestionAggregate, type ChoiceDistributionEntry, type ChoiceFieldConstraintRule, type ChoiceOption, type ChoiceQuestionAggregate, type CloneVersionOptions, type CollectedLocales, type ConditionOperator, type ConditionValue, type CreateSubmissionOptions, type CrossTabulationResult, type CsvColumnContext, type CsvColumnDef, type CsvExportOptions, DEFAULT_FIELD_TYPE_DEFINITIONS, type DeleteDraftOptions, type DisplayCondition, type DisplayConditionGroup, type DisplayRule, type ExtensibleNode, type FieldConstraintRule, type FieldDisplayCondition, type FieldOption, type FieldType, type FieldTypeDefinition, type FormAnalytics, type FormEvent, type FormEventType, type FormField, type FormPage, type FormPolicy, type FormResponse, type FormSchema, type FormStorageAdapter, type FormSubmission, type FormSubmissionSettings, type FormValue, type FormValues, type FormVersionRecord, type FormVersionState, type FormVersionStatus, type JsonValue, type LegacyTranslationMetadata, type LocalizedText, type MigrateSchemaTranslationMetadataOptions, type MultiSelectField, type NodeWritableStream, type NumberField, type NumberQuestionAggregate, type NumericSummary, type OptionAggregate, type PagedSubmissionStorageAdapter, type PaginationIteratorOptions, type PopulateTranslationOptions, type PopulateTranslationsOptions, type PublishDraftOptions, type PublishDraftResult, type Question, type QuestionAggregate, type QuestionType, type RatingField, type RatingFieldConstraintRule, type ResponseAccumulator, type ResponseAccumulatorOptions, type Result, type SanitizeSchemaOptions, type SchemaIssue, type SchemaStructureIssue, type SchemaStructureIssueType, type SchemaTranslations, type SchemaValidationResult, type SelectField, type StorageAdapter, type StorageCommitError, type StreamCsvOptions, type SubmissionCursorValue, type SubmissionFilter, type SubmissionPage, type SubmissionPageQueryOptions, type SubmissionQueryOptions, type TextAnswerCursorValue, type TextAnswerItem, type TextAnswerPage, type TextAnswerPageQueryOptions, type TextField, type TextFieldConstraintRule, type TextQuestionAggregate, type TranslationAdapter, type TranslationMetadataMigrator, type TranslationMigrationContext, type TranslationReport, type TranslationSlot, type TranslationStatus, type ValidateFormSchemaOptions, type ValidationCode, type ValidationError, type ValidationIssue, type VersionTransitionError, type VersionTransitionEvent, type VersionTransitionPlan, type VersionedFormStorageAdapter, type WebhookConfig, type WebhookDispatchResult, aggregateResponses, assertValidFormSchema, assertVersionMutable, calculateChoiceDistribution, calculateCrossTabulation, calculateFieldVisibility, calculateNumericSummary, calculatePageVisibility, cloneVersionToDraft, collectSchemaLocales, collectTranslationSlots, computeSourceTextHash, createCloneTransitionPlan, createDeleteDraftTransitionPlan, createPublishTransitionPlan, createResponseAccumulator, createSubmission, decodeSubmissionCursor, decodeTextAnswerCursor, deleteDraft, dispatchWebhook, encodeSubmissionCursor, encodeTextAnswerCursor, escapeCsvCell, exportResponsesToCsv, exportResponsesToCsvStream, getTranslationStatus, isDisplayConditionGroupSatisfied, isDisplayConditionSatisfied, isManualTranslationMetadata, isQuestionVisible, iterateSubmissionPages, jsonValuesEqual, matchesSubmissionFilter, matchesSubmissionPageFilters, migrateSchemaTranslationMetadata, normalizeSubmissionPageSize, pipeResponsesToCsvStream, populateSchemaTranslations, publishDraft, removeLocaleFromSchema, resolveFormTranslation, resolveLocalizedSchema, sanitizeSchema, selectVisibleAnswers, transformFieldType, validateAnswers, validateFormSchema, validatePageAnswers, validateSchemaStructure };

package/dist/index.d.ts

@@ -686,15 +686,55 @@ interface CanonicalTranslationMetadata {
     readonly translatedAt?: string;
     readonly editedAt?: string;
 }
+interface LegacyTranslationMetadata {
+    readonly isManuallyEdited?: boolean;
+    readonly translationSource?: "MANUAL" | "AUTOMATIC" | "manual" | "automatic" | string;
+    readonly sourceTextHash?: string;
+    readonly sourceText?: string;
+    readonly sourceLocale?: string;
+    readonly translatedAt?: string;
+    readonly editedAt?: string;
+    readonly isManual?: boolean;
+    readonly [key: string]: unknown;
+}
+interface TranslationMigrationContext {
+    /** Target locale code, for example "en" or "zh-Hans". */
+    readonly locale: string;
+    /** The schema's default locale. */
+    readonly defaultLocale: string;
+    /** JSON path of the translated property. */
+    readonly path: string;
+    /** Translated property name. */
+    readonly property: "title" | "description" | "label" | "completionMessage";
+    /** Kind of node that owns the translated property. */
+    readonly nodeKind: "form" | "page" | "field" | "option";
+    /** Identifier of the owning node. */
+    readonly nodeId?: string;
+    /** Identifier of the parent node, used for options. */
+    readonly parentId?: string;
+}
+type TranslationMetadataMigrator = (oldMeta: unknown, sourceText: string, context: TranslationMigrationContext) => CanonicalTranslationMetadata;
+interface MigrateSchemaTranslationMetadataOptions {
+    /** Custom migration function used instead of the built-in legacy normalizer. */
+    readonly migrator?: TranslationMetadataMigrator;
+}
+declare const isManualTranslationMetadata: (metadata?: LegacyTranslationMetadata | CanonicalTranslationMetadata) => boolean;
 interface PopulateTranslationOptions {
     readonly overwrite?: "all" | "missing-only" | "stale-and-missing";
     readonly preserveManualTranslations?: boolean;
     readonly markStaleTranslations?: boolean;
     readonly shouldOverwrite?: (slot: TranslationSlot) => boolean;
     readonly createMetadata?: (slot: TranslationSlot, translatedText: string) => Readonly<Record<string, JsonValue>>;
+    readonly isManualTranslation?: (metadata: unknown, context: {
+        readonly path: string;
+        readonly locale: string;
+    }) => boolean;
+    readonly normalizeMetadata?: (metadata: unknown, sourceText: string) => CanonicalTranslationMetadata;
     /** Applies locale admission and count limits before the adapter is called. */
     readonly policy?: Pick<FormPolicy, "allowedLocales" | "maxLocales">;
 }
+/** Compatibility alias for clients that used the pluralized options name. */
+type PopulateTranslationsOptions = PopulateTranslationOptions;
 interface TranslationReport {
     readonly updatedSlots: readonly TranslationSlot[];
     readonly skippedSlots: readonly TranslationSlot[];
@@ -703,6 +743,9 @@ interface TranslationReport {
 }
 declare const computeSourceTextHash: (text: string) => string;
 declare function getTranslationStatus(sourceText: string, translatedText: string | undefined, metadata: CanonicalTranslationMetadata | Readonly<Record<string, JsonValue>> | undefined): TranslationStatus;
+declare const migrateSchemaTranslationMetadata: (schema: FormSchema, migratorOrOptions?: ((oldMeta: unknown, sourceText: string) => CanonicalTranslationMetadata) | TranslationMetadataMigrator | MigrateSchemaTranslationMetadataOptions) => FormSchema;
+/** Removes a locale registration and every localized value and metadata entry for it. */
+declare const removeLocaleFromSchema: (schema: FormSchema, localeToRemove: string) => FormSchema;
 declare function collectTranslationSlots(schema: FormSchema, locale: string): readonly TranslationSlot[];
 declare function resolveLocalizedSchema(schema: FormSchema, targetLocale?: string): FormSchema;
 declare function populateSchemaTranslations(schema: FormSchema, targetLocales: readonly string[], adapter: AsyncTranslationAdapter, options?: PopulateTranslationOptions): Promise<{
@@ -725,4 +768,4 @@ declare function calculatePageVisibility(schema: FormSchema, currentAnswers: Rea
 declare function calculateFieldVisibility(schema: FormSchema, currentAnswers: Readonly<Record<string, unknown>>): Readonly<Record<string, boolean>>;
 declare function selectVisibleAnswers(schema: FormSchema, currentAnswers: FormValues): FormValues;
 
-export { type AccumulatorReport, type AccumulatorResponse, type AccumulatorSkipReason, type AnswerValidationResult, type AsyncTranslationAdapter, type BaseField, type BaseFieldConstraintRule, type BuilderTranslationKey, type CanonicalTranslationMetadata, type CheckboxField, type CheckboxQuestionAggregate, type ChoiceDistributionEntry, type ChoiceFieldConstraintRule, type ChoiceOption, type ChoiceQuestionAggregate, type CloneVersionOptions, type CollectedLocales, type ConditionOperator, type ConditionValue, type CreateSubmissionOptions, type CrossTabulationResult, type CsvColumnContext, type CsvColumnDef, type CsvExportOptions, DEFAULT_FIELD_TYPE_DEFINITIONS, type DeleteDraftOptions, type DisplayCondition, type DisplayConditionGroup, type DisplayRule, type ExtensibleNode, type FieldConstraintRule, type FieldDisplayCondition, type FieldOption, type FieldType, type FieldTypeDefinition, type FormAnalytics, type FormEvent, type FormEventType, type FormField, type FormPage, type FormPolicy, type FormResponse, type FormSchema, type FormStorageAdapter, type FormSubmission, type FormSubmissionSettings, type FormValue, type FormValues, type FormVersionRecord, type FormVersionState, type FormVersionStatus, type JsonValue, type LocalizedText, type MultiSelectField, type NodeWritableStream, type NumberField, type NumberQuestionAggregate, type NumericSummary, type OptionAggregate, type PagedSubmissionStorageAdapter, type PaginationIteratorOptions, type PopulateTranslationOptions, type PublishDraftOptions, type PublishDraftResult, type Question, type QuestionAggregate, type QuestionType, type RatingField, type RatingFieldConstraintRule, type ResponseAccumulator, type ResponseAccumulatorOptions, type Result, type SanitizeSchemaOptions, type SchemaIssue, type SchemaStructureIssue, type SchemaStructureIssueType, type SchemaTranslations, type SchemaValidationResult, type SelectField, type StorageAdapter, type StorageCommitError, type StreamCsvOptions, type SubmissionCursorValue, type SubmissionFilter, type SubmissionPage, type SubmissionPageQueryOptions, type SubmissionQueryOptions, type TextAnswerCursorValue, type TextAnswerItem, type TextAnswerPage, type TextAnswerPageQueryOptions, type TextField, type TextFieldConstraintRule, type TextQuestionAggregate, type TranslationAdapter, type TranslationReport, type TranslationSlot, type TranslationStatus, type ValidateFormSchemaOptions, type ValidationCode, type ValidationError, type ValidationIssue, type VersionTransitionError, type VersionTransitionEvent, type VersionTransitionPlan, type VersionedFormStorageAdapter, type WebhookConfig, type WebhookDispatchResult, aggregateResponses, assertValidFormSchema, assertVersionMutable, calculateChoiceDistribution, calculateCrossTabulation, calculateFieldVisibility, calculateNumericSummary, calculatePageVisibility, cloneVersionToDraft, collectSchemaLocales, collectTranslationSlots, computeSourceTextHash, createCloneTransitionPlan, createDeleteDraftTransitionPlan, createPublishTransitionPlan, createResponseAccumulator, createSubmission, decodeSubmissionCursor, decodeTextAnswerCursor, deleteDraft, dispatchWebhook, encodeSubmissionCursor, encodeTextAnswerCursor, escapeCsvCell, exportResponsesToCsv, exportResponsesToCsvStream, getTranslationStatus, isDisplayConditionGroupSatisfied, isDisplayConditionSatisfied, isQuestionVisible, iterateSubmissionPages, jsonValuesEqual, matchesSubmissionFilter, matchesSubmissionPageFilters, normalizeSubmissionPageSize, pipeResponsesToCsvStream, populateSchemaTranslations, publishDraft, resolveFormTranslation, resolveLocalizedSchema, sanitizeSchema, selectVisibleAnswers, transformFieldType, validateAnswers, validateFormSchema, validatePageAnswers, validateSchemaStructure };
+export { type AccumulatorReport, type AccumulatorResponse, type AccumulatorSkipReason, type AnswerValidationResult, type AsyncTranslationAdapter, type BaseField, type BaseFieldConstraintRule, type BuilderTranslationKey, type CanonicalTranslationMetadata, type CheckboxField, type CheckboxQuestionAggregate, type ChoiceDistributionEntry, type ChoiceFieldConstraintRule, type ChoiceOption, type ChoiceQuestionAggregate, type CloneVersionOptions, type CollectedLocales, type ConditionOperator, type ConditionValue, type CreateSubmissionOptions, type CrossTabulationResult, type CsvColumnContext, type CsvColumnDef, type CsvExportOptions, DEFAULT_FIELD_TYPE_DEFINITIONS, type DeleteDraftOptions, type DisplayCondition, type DisplayConditionGroup, type DisplayRule, type ExtensibleNode, type FieldConstraintRule, type FieldDisplayCondition, type FieldOption, type FieldType, type FieldTypeDefinition, type FormAnalytics, type FormEvent, type FormEventType, type FormField, type FormPage, type FormPolicy, type FormResponse, type FormSchema, type FormStorageAdapter, type FormSubmission, type FormSubmissionSettings, type FormValue, type FormValues, type FormVersionRecord, type FormVersionState, type FormVersionStatus, type JsonValue, type LegacyTranslationMetadata, type LocalizedText, type MigrateSchemaTranslationMetadataOptions, type MultiSelectField, type NodeWritableStream, type NumberField, type NumberQuestionAggregate, type NumericSummary, type OptionAggregate, type PagedSubmissionStorageAdapter, type PaginationIteratorOptions, type PopulateTranslationOptions, type PopulateTranslationsOptions, type PublishDraftOptions, type PublishDraftResult, type Question, type QuestionAggregate, type QuestionType, type RatingField, type RatingFieldConstraintRule, type ResponseAccumulator, type ResponseAccumulatorOptions, type Result, type SanitizeSchemaOptions, type SchemaIssue, type SchemaStructureIssue, type SchemaStructureIssueType, type SchemaTranslations, type SchemaValidationResult, type SelectField, type StorageAdapter, type StorageCommitError, type StreamCsvOptions, type SubmissionCursorValue, type SubmissionFilter, type SubmissionPage, type SubmissionPageQueryOptions, type SubmissionQueryOptions, type TextAnswerCursorValue, type TextAnswerItem, type TextAnswerPage, type TextAnswerPageQueryOptions, type TextField, type TextFieldConstraintRule, type TextQuestionAggregate, type TranslationAdapter, type TranslationMetadataMigrator, type TranslationMigrationContext, type TranslationReport, type TranslationSlot, type TranslationStatus, type ValidateFormSchemaOptions, type ValidationCode, type ValidationError, type ValidationIssue, type VersionTransitionError, type VersionTransitionEvent, type VersionTransitionPlan, type VersionedFormStorageAdapter, type WebhookConfig, type WebhookDispatchResult, aggregateResponses, assertValidFormSchema, assertVersionMutable, calculateChoiceDistribution, calculateCrossTabulation, calculateFieldVisibility, calculateNumericSummary, calculatePageVisibility, cloneVersionToDraft, collectSchemaLocales, collectTranslationSlots, computeSourceTextHash, createCloneTransitionPlan, createDeleteDraftTransitionPlan, createPublishTransitionPlan, createResponseAccumulator, createSubmission, decodeSubmissionCursor, decodeTextAnswerCursor, deleteDraft, dispatchWebhook, encodeSubmissionCursor, encodeTextAnswerCursor, escapeCsvCell, exportResponsesToCsv, exportResponsesToCsvStream, getTranslationStatus, isDisplayConditionGroupSatisfied, isDisplayConditionSatisfied, isManualTranslationMetadata, isQuestionVisible, iterateSubmissionPages, jsonValuesEqual, matchesSubmissionFilter, matchesSubmissionPageFilters, migrateSchemaTranslationMetadata, normalizeSubmissionPageSize, pipeResponsesToCsvStream, populateSchemaTranslations, publishDraft, removeLocaleFromSchema, resolveFormTranslation, resolveLocalizedSchema, sanitizeSchema, selectVisibleAnswers, transformFieldType, validateAnswers, validateFormSchema, validatePageAnswers, validateSchemaStructure };

package/dist/index.js

@@ -2143,6 +2143,12 @@ function createSubmission(schema, values, options) {
 }
 
 // src/translation.ts
+var isManualTranslationMetadata = (metadata) => {
+  if (metadata === void 0) return false;
+  if ("isManuallyEdited" in metadata && metadata.isManuallyEdited === true || "isManual" in metadata && metadata.isManual === true)
+    return true;
+  return typeof metadata.translationSource === "string" && metadata.translationSource.toLowerCase() === "manual";
+};
 var computeSourceTextHash = (text) => {
   const normalized = text.normalize("NFKC").trim().replace(/\s+/gu, " ");
   let hash = 2166136261;
@@ -2153,11 +2159,14 @@ var computeSourceTextHash = (text) => {
   return (hash >>> 0).toString(16).padStart(8, "0");
 };
 function getTranslationStatus(sourceText, translatedText, metadata) {
+  return getTranslationStatusWithManualOverride(sourceText, translatedText, metadata, void 0);
+}
+function getTranslationStatusWithManualOverride(sourceText, translatedText, metadata, manualOverride) {
   if (translatedText === void 0 || translatedText.trim() === "") return "missing";
   if (metadata === void 0) return "translated";
   const currentHash = computeSourceTextHash(sourceText);
   const sourceHash = typeof metadata.sourceTextHash === "string" ? metadata.sourceTextHash : void 0;
-  const isManual = metadata.translationSource === "manual" || "isManual" in metadata && metadata.isManual === true;
+  const isManual = manualOverride ?? isManualTranslationMetadata(metadata);
   if (isManual) return sourceHash === void 0 || sourceHash === currentHash ? "manual" : "manual-stale";
   return sourceHash === void 0 || sourceHash === currentHash ? "translated" : "stale";
 }
@@ -2183,8 +2192,11 @@ function withTranslationMetadata(node, locale, property, metadata) {
     }
   };
 }
-function createSlot(kind, nodeId, property, locale, sourceText, existingText, nodeMetadata, existingTranslationMetadata) {
-  const status = getTranslationStatus(sourceText, existingText, existingTranslationMetadata);
+function createSlot(kind, nodeId, property, locale, sourceText, existingText, nodeMetadata, existingTranslationMetadata, options = {}) {
+  const path = `${kind}.${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);
   return {
     kind,
     nodeId,
@@ -2192,15 +2204,15 @@ function createSlot(kind, nodeId, property, locale, sourceText, existingText, no
     locale,
     sourceText,
     target: { kind, ...nodeId.length === 0 ? {} : { id: nodeId }, property },
-    path: `${kind}.${nodeId}.${property}`,
+    path,
     sourceTextHash: computeSourceTextHash(sourceText),
     status,
     ...existingText === void 0 ? {} : { existingText },
     ...nodeMetadata === void 0 ? {} : { nodeMetadata, metadata: nodeMetadata },
-    ...existingTranslationMetadata === void 0 ? {} : { existingTranslationMetadata }
+    ...normalizedMetadata === void 0 ? {} : { existingTranslationMetadata: normalizedMetadata }
   };
 }
-function translationSlots(schema, locale) {
+function translationSlots(schema, locale, options = {}) {
   const descriptors = [];
   const addFormSlot = (property, sourceText) => {
     const slot = createSlot(
@@ -2211,10 +2223,15 @@ function translationSlots(schema, locale) {
       sourceText,
       schema.translations?.[locale]?.[property],
       schema.metadata,
-      schema.translationMetadata?.[locale]?.[property]
+      schema.translationMetadata?.[locale]?.[property],
+      options
     );
     descriptors.push({
       slot,
+      manual: options.isManualTranslation?.(schema.translationMetadata?.[locale]?.[property], {
+        path: slot.path ?? "",
+        locale
+      }) ?? isManualTranslationMetadata(schema.translationMetadata?.[locale]?.[property]),
       apply: (current, value, metadata) => withTranslationMetadata(
         { ...current, translations: mergeLocalizedText(current.translations, locale, property, value) },
         locale,
@@ -2236,10 +2253,15 @@ function translationSlots(schema, locale) {
         sourceText,
         field.translations?.[locale]?.[property],
         field.metadata,
-        field.translationMetadata?.[locale]?.[property]
+        field.translationMetadata?.[locale]?.[property],
+        options
       );
       descriptors.push({
         slot,
+        manual: options.isManualTranslation?.(field.translationMetadata?.[locale]?.[property], {
+          path: slot.path ?? "",
+          locale
+        }) ?? isManualTranslationMetadata(field.translationMetadata?.[locale]?.[property]),
         apply: (current, value, metadata) => ({
           ...current,
           fields: current.fields.map(
@@ -2268,10 +2290,15 @@ function translationSlots(schema, locale) {
           option.label,
           option.translations?.[locale],
           option.metadata,
-          option.translationMetadata?.[locale]?.label
+          option.translationMetadata?.[locale]?.label,
+          options
         );
         descriptors.push({
           slot,
+          manual: options.isManualTranslation?.(option.translationMetadata?.[locale]?.label, {
+            path: slot.path ?? "",
+            locale
+          }) ?? isManualTranslationMetadata(option.translationMetadata?.[locale]?.label),
           apply: (current, value, metadata) => ({
             ...current,
             fields: current.fields.map((candidate, candidateIndex) => {
@@ -2306,10 +2333,15 @@ function translationSlots(schema, locale) {
         sourceText,
         page.translations?.[locale]?.[property],
         page.metadata,
-        page.translationMetadata?.[locale]?.[property]
+        page.translationMetadata?.[locale]?.[property],
+        options
       );
       descriptors.push({
         slot,
+        manual: options.isManualTranslation?.(page.translationMetadata?.[locale]?.[property], {
+          path: slot.path ?? "",
+          locale
+        }) ?? isManualTranslationMetadata(page.translationMetadata?.[locale]?.[property]),
         apply: (current, value, metadata) => ({
           ...current,
           ...current.pages === void 0 ? {} : {
@@ -2333,6 +2365,165 @@ function translationSlots(schema, locale) {
   });
   return descriptors;
 }
+function removeLocaleRecord(record, locale) {
+  if (record === void 0) return void 0;
+  const remaining = Object.entries(record).filter(([candidate]) => candidate !== locale);
+  return remaining.length === 0 ? void 0 : Object.fromEntries(remaining);
+}
+function removeLocalizedNodeLocale(node, locale) {
+  const translations = removeLocaleRecord(node.translations, locale);
+  const translationMetadata = removeLocaleRecord(node.translationMetadata, locale);
+  const { translations: _translations, translationMetadata: _translationMetadata, ...base } = node;
+  return {
+    ...base,
+    ...translations === void 0 ? {} : { translations },
+    ...translationMetadata === void 0 ? {} : { translationMetadata }
+  };
+}
+function defaultTranslationMetadataMigrator(metadata, sourceText, defaultLocale) {
+  const record = metadata !== null && typeof metadata === "object" ? metadata : void 0;
+  const sourceLocale = typeof record?.sourceLocale === "string" ? record.sourceLocale : defaultLocale;
+  const translationSource = isManualTranslationMetadata(record) ? "manual" : "automatic";
+  return {
+    sourceLocale,
+    sourceTextHash: computeSourceTextHash(sourceText),
+    translationSource,
+    ...typeof record?.translatedAt === "string" ? { translatedAt: record.translatedAt } : {},
+    ...typeof record?.editedAt === "string" ? { editedAt: record.editedAt } : {}
+  };
+}
+function migrateMetadata(metadata, sourceText, context, migrator) {
+  return migrator(metadata, sourceText, context);
+}
+function isTranslationMetadataProperty(property) {
+  return property === "title" || property === "description" || property === "label" || property === "completionMessage";
+}
+function migrateNodeMetadata(node, sourceTexts, contextFor, migrator) {
+  if (node.translationMetadata === void 0) return node;
+  const translationMetadata = Object.fromEntries(
+    Object.entries(node.translationMetadata).map(([locale, properties]) => [
+      locale,
+      Object.fromEntries(
+        Object.entries(properties).map(([property, metadata]) => {
+          if (!isTranslationMetadataProperty(property)) return [property, metadata];
+          return [
+            property,
+            migrateMetadata(metadata, sourceTexts[property] ?? "", contextFor(locale, property), migrator)
+          ];
+        })
+      )
+    ])
+  );
+  return { ...node, translationMetadata };
+}
+var migrateSchemaTranslationMetadata = (schema, migratorOrOptions) => {
+  const defaultLocale = schema.defaultLocale ?? "";
+  const migrator = typeof migratorOrOptions === "function" ? migratorOrOptions : migratorOrOptions?.migrator ?? ((metadata, sourceText, context) => defaultTranslationMetadataMigrator(metadata, sourceText, context.defaultLocale));
+  const migratedSchema = migrateNodeMetadata(
+    schema,
+    {
+      title: schema.title,
+      ...schema.description === void 0 ? {} : { description: schema.description },
+      ...schema.completionMessage === void 0 ? {} : { completionMessage: schema.completionMessage }
+    },
+    (locale, property) => ({
+      locale,
+      defaultLocale,
+      path: property,
+      property,
+      nodeKind: "form"
+    }),
+    migrator
+  );
+  const fields = schema.fields.map((field) => {
+    const migratedField = migrateNodeMetadata(
+      field,
+      { title: field.title, ...field.description === void 0 ? {} : { description: field.description } },
+      (locale, property) => ({
+        locale,
+        defaultLocale,
+        path: `fields.${field.id}.${property}`,
+        property,
+        nodeKind: "field",
+        nodeId: field.id
+      }),
+      migrator
+    );
+    if (!("options" in migratedField)) return migratedField;
+    return {
+      ...migratedField,
+      options: migratedField.options.map(
+        (option) => migrateNodeMetadata(
+          option,
+          { label: option.label },
+          (locale, property) => ({
+            locale,
+            defaultLocale,
+            path: `fields.${field.id}.options.${option.id}.${property}`,
+            property,
+            nodeKind: "option",
+            nodeId: option.id,
+            parentId: field.id
+          }),
+          migrator
+        )
+      )
+    };
+  });
+  const pages = schema.pages?.map(
+    (page) => migrateNodeMetadata(
+      page,
+      {
+        ...page.title === void 0 ? {} : { title: page.title },
+        ...page.description === void 0 ? {} : { description: page.description }
+      },
+      (locale, property) => ({
+        locale,
+        defaultLocale,
+        path: `pages.${page.id}.${property}`,
+        property,
+        nodeKind: "page",
+        nodeId: page.id
+      }),
+      migrator
+    )
+  );
+  return {
+    ...migratedSchema,
+    fields,
+    ...pages === void 0 ? {} : { pages }
+  };
+};
+var removeLocaleFromSchema = (schema, localeToRemove) => {
+  if (localeToRemove === schema.defaultLocale) {
+    throw new Error(`Cannot remove defaultLocale: ${localeToRemove}`);
+  }
+  const form = removeLocalizedNodeLocale(schema, localeToRemove);
+  const fields = schema.fields.map((field) => {
+    const localizedField = removeLocalizedNodeLocale(field, localeToRemove);
+    if (!("options" in localizedField)) return localizedField;
+    return {
+      ...localizedField,
+      options: localizedField.options.map((option) => {
+        const translations = removeLocaleRecord(option.translations, localeToRemove);
+        const translationMetadata = removeLocaleRecord(option.translationMetadata, localeToRemove);
+        const { translations: _translations, translationMetadata: _translationMetadata, ...base } = option;
+        return {
+          ...base,
+          ...translations === void 0 ? {} : { translations },
+          ...translationMetadata === void 0 ? {} : { translationMetadata }
+        };
+      })
+    };
+  });
+  const pages = schema.pages?.map((page) => removeLocalizedNodeLocale(page, localeToRemove));
+  return {
+    ...form,
+    supportedLocales: (schema.supportedLocales ?? []).filter((locale) => locale !== localeToRemove),
+    fields,
+    ...pages === void 0 ? {} : { pages }
+  };
+};
 function collectTranslationSlots(schema, locale) {
   return translationSlots(schema, locale).map((descriptor) => descriptor.slot);
 }
@@ -2396,7 +2587,7 @@ async function populateSchemaTranslations(schema, targetLocales, adapter, option
   const skippedReasons = {};
   let result = schema;
   for (const locale of locales) {
-    const descriptors = translationSlots(schema, locale);
+    const descriptors = translationSlots(schema, locale, options);
     if (options.markStaleTranslations ?? true) {
       for (const descriptor of descriptors) {
         if (descriptor.slot.status === "stale" || descriptor.slot.status === "manual-stale")
@@ -2406,8 +2597,9 @@ async function populateSchemaTranslations(schema, targetLocales, adapter, option
     const selected = [];
     for (const descriptor of descriptors) {
       const status = descriptor.slot.status ?? "missing";
-      const manual = status === "manual" || status === "manual-stale";
-      const shouldTranslate = options.shouldOverwrite?.(descriptor.slot) ?? ((!(options.preserveManualTranslations ?? true) || !manual) && (options.overwrite === "all" || (options.overwrite === "stale-and-missing" || options.overwrite === void 0 ? status === "missing" || status === "stale" || !(options.preserveManualTranslations ?? true) && status === "manual-stale" : status === "missing")));
+      const manual = descriptor.manual || status === "manual" || status === "manual-stale";
+      const requestedOverwrite = options.shouldOverwrite?.(descriptor.slot);
+      const shouldTranslate = (options.preserveManualTranslations ?? true) && manual ? false : requestedOverwrite ?? (options.overwrite === "all" || (options.overwrite === "stale-and-missing" || options.overwrite === void 0 ? status === "missing" || status === "stale" || !(options.preserveManualTranslations ?? true) && status === "manual-stale" : status === "missing"));
       if (shouldTranslate) selected.push(descriptor);
       else {
         skippedSlots.push(descriptor.slot);
@@ -2768,15 +2960,18 @@ export {
   getTranslationStatus,
   isDisplayConditionGroupSatisfied,
   isDisplayConditionSatisfied,
+  isManualTranslationMetadata,
   isQuestionVisible,
   iterateSubmissionPages,
   jsonValuesEqual,
   matchesSubmissionFilter,
   matchesSubmissionPageFilters,
+  migrateSchemaTranslationMetadata,
   normalizeSubmissionPageSize,
   pipeResponsesToCsvStream,
   populateSchemaTranslations,
   publishDraft,
+  removeLocaleFromSchema,
   resolveFormTranslation,
   resolveLocalizedSchema,
   sanitizeSchema,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@form-engine-ts/core",
-  "version": "4.5.0",
+  "version": "4.7.0",
   "publishConfig": {
     "access": "public"
   },