@focus-reactive/payload-plugin-translator 0.9.0 → 0.9.2

package/dist/auto-translate-config.d.ts

@@ -1,7 +1,7 @@
 import type { CollectionConfig } from "payload";
-import type { AutoTranslateConfig } from "./core/auto-translate-config";
+import type { AutoTranslateConfig } from "./core/domain/auto-translate";
 export type { AutoTranslateConfig };
-export type { AutoTranslateStrategy } from "./core/auto-translate-config";
+export type { AutoTranslateStrategy } from "./core/domain/auto-translate";
 /**
  * Enable opt-in **auto-translate** for a collection: when a document's source-locale content changes
  * (and is published), the plugin automatically queues translations into the configured target locales.

package/dist/auto-translate-config.js

@@ -1,4 +1,4 @@
-import { AUTO_TRANSLATE_CUSTOM_KEY } from "./core/auto-translate-config";
+import { AUTO_TRANSLATE_CUSTOM_KEY } from "./core/domain/auto-translate";
 /**
  * Enable opt-in **auto-translate** for a collection: when a document's source-locale content changes
  * (and is published), the plugin automatically queues translations into the configured target locales.

package/dist/client/entities/translation/model/autoTranslateSummary.js

@@ -1,4 +1,4 @@
-import { getAutoTranslateConfig } from "../../../../core/auto-translate-config";
+import { getAutoTranslateConfig } from "../../../../core/domain/auto-translate";
 /**
  * Resolve a collection's auto-translate summary for the popup marker, or `null` when it should not
  * render. Reads the opt-in from the collection's `custom` (propagated onto the registered collection at

package/dist/core/{auto-translate-config → domain/auto-translate}/getAutoTranslateConfig.js

@@ -1,4 +1,4 @@
-import { isObject } from "../utils/isObject";
+import { isObject } from "../../kernel/utils/isObject";
 import { AUTO_TRANSLATE_CUSTOM_KEY } from "./types";
 /**
  * Structural guard: is `value` a well-formed auto-translate config? Validates the one crash-critical

package/dist/core/{auto-translate → domain/auto-translate}/hasSourceContentChanged.d.ts

@@ -1,4 +1,4 @@
-import type { FieldLike } from "../field-traversal";
+import type { FieldLike } from "../../kernel/field-traversal";
 /**
  * Whether a source-locale save actually changed translatable content — the auto-translate drift-gate,
  * in one place. Compares the translatable-content fingerprint of the previous vs the current document

package/dist/core/{auto-translate-config → domain/auto-translate}/index.d.ts

@@ -1,3 +1,4 @@
 export { getAutoTranslateConfig } from "./getAutoTranslateConfig";
+export { hasSourceContentChanged } from "./hasSourceContentChanged";
 export { AUTO_TRANSLATE_CUSTOM_KEY } from "./types";
 export type { AutoTranslateConfig, AutoTranslateStrategy } from "./types";

package/dist/core/{auto-translate-config → domain/auto-translate}/index.js

@@ -1,4 +1,5 @@
 export { getAutoTranslateConfig } from "./getAutoTranslateConfig";
+export { hasSourceContentChanged } from "./hasSourceContentChanged";
 export { AUTO_TRANSLATE_CUSTOM_KEY } from "./types";
 
 //# sourceMappingURL=index.js.map

package/dist/core/{content-projection → domain/content-projection}/computeSourceFingerprint.d.ts

@@ -1,4 +1,4 @@
-import type { FieldLike } from "../field-traversal";
+import type { FieldLike } from "../../kernel/field-traversal";
 /**
  * The staleness baseline: a stable hash of a document's translatable content.
  * `CURRENT = computeSourceFingerprint(sourceDoc, schema)` — the value provenance stores at translation

package/dist/core/{content-projection → domain/content-projection}/contentProjector.d.ts

@@ -9,7 +9,7 @@
  * translation can never disagree on which content is translatable. Payload-free and read-only:
  * it never mutates the document and never captures write handles.
  */
-import type { FieldLike } from "../field-traversal/types";
+import type { FieldLike } from "../../kernel/field-traversal/types";
 import type { IdPath } from "./idPath";
 /** One translatable leaf of a document: WHERE it lives ({@link IdPath}) and WHAT text it holds. */
 export interface ProjectionEntry {

package/dist/core/{content-projection → domain/content-projection}/contentProjector.js

@@ -8,8 +8,8 @@
  * {@link leafSourceText}) as the translation pipeline's `FieldChunkCollector`, so projection and
  * translation can never disagree on which content is translatable. Payload-free and read-only:
  * it never mutates the document and never captures write handles.
- */ import { resolveBlockFields, walkFields } from "../field-traversal";
-import { isObject } from "../utils/isObject";
+ */ import { resolveBlockFields, walkFields } from "../../kernel/field-traversal";
+import { isObject } from "../../kernel/utils/isObject";
 import { elementSegment, makeIdPath } from "./idPath";
 import { isTranslatableLeaf, leafSourceText } from "./translatableLeaf";
 /**

package/dist/core/{content-projection → domain/content-projection}/translatableLeaf.d.ts

@@ -7,7 +7,7 @@
  * Payload-free (structural {@link FieldLike} + owned `Serialized*` views only) so it can move to
  * `@repo/translator-core` unchanged.
  */
-import type { FieldLike, LeafFieldLike } from "../field-traversal/types";
+import type { FieldLike, LeafFieldLike } from "../../kernel/field-traversal/types";
 /**
  * The leaf-SELECTION decision shared by projection and translation: a leaf is a translation target
  * iff it is a translatable text type, localized, and not excluded via `custom.translateKit`.

package/dist/core/{content-projection → domain/content-projection}/translatableLeaf.js

@@ -7,8 +7,8 @@
  * Payload-free (structural {@link FieldLike} + owned `Serialized*` views only) so it can move to
  * `@repo/translator-core` unchanged.
  */ import { isFieldExcludedFromTranslation } from "../field-config";
-import { collectSerializedLexicalTextNodes } from "../lexical/collectTextNodes";
-import { isSerializedLexicalRoot } from "../lexical/guards";
+import { collectSerializedLexicalTextNodes } from "../../kernel/lexical/collectTextNodes";
+import { isSerializedLexicalRoot } from "../../kernel/lexical/guards";
 /** The field types this package translates (mirrors `isTranslatableField`, payload-free). */ const isTranslatableFieldType = (field)=>field.type === "text" || field.type === "textarea" || field.type === "richText";
 /** Mirrors `isLocalizedField` structurally. */ const isLocalizedFieldLike = (field)=>field.localized === true;
 /**

package/dist/core/index.d.ts

@@ -1,12 +1,12 @@
-export type { TranslationProvider, TranslationInput, TranslationOutput, TranslationIndex, } from "./translation-providers";
+export type { TranslationProvider, TranslationInput, TranslationOutput, TranslationIndex, } from "./domain/translation-providers";
 export { TranslationPipeline, translateContent } from "./translation-pipeline";
 export type { TranslateContentArgs, TranslationStrategy } from "./translation-pipeline";
-export type { ProvenanceKey, ProvenanceStore, TranslationProvenanceRecord } from "./provenance";
-export { projectTranslatableContent } from "./content-projection/contentProjector";
-export type { ProjectionEntry } from "./content-projection/contentProjector";
-export { fingerprint } from "./content-projection/fingerprinter";
-export { computeSourceFingerprint } from "./content-projection/computeSourceFingerprint";
-export { makeIdPath } from "./content-projection/idPath";
-export type { IdPath, PathSegment } from "./content-projection/idPath";
-export { classifyField, findFieldByPath, hasFields, isBlockItem, isTabsField, matchElementById, resolveBlockFields, tabScopes, walkFields, } from "./field-traversal";
-export type { ArrayFieldLike, BlockLike, BlocksFieldLike, FieldLike, FieldStructure, FieldWalker, GroupFieldLike, LeafField, LeafFieldLike, TabLike, TabScope, TabsFieldLike, } from "./field-traversal";
+export type { ProvenanceKey, ProvenanceStore, TranslationProvenanceRecord, } from "./domain/provenance";
+export { projectTranslatableContent } from "./domain/content-projection/contentProjector";
+export type { ProjectionEntry } from "./domain/content-projection/contentProjector";
+export { fingerprint } from "./domain/content-projection/fingerprinter";
+export { computeSourceFingerprint } from "./domain/content-projection/computeSourceFingerprint";
+export { makeIdPath } from "./domain/content-projection/idPath";
+export type { IdPath, PathSegment } from "./domain/content-projection/idPath";
+export { classifyField, findFieldByPath, hasFields, isBlockItem, isTabsField, matchElementById, resolveBlockFields, tabScopes, walkFields, } from "./kernel/field-traversal";
+export type { ArrayFieldLike, BlockLike, BlocksFieldLike, FieldLike, FieldStructure, FieldWalker, GroupFieldLike, LeafField, LeafFieldLike, TabLike, TabScope, TabsFieldLike, } from "./kernel/field-traversal";

package/dist/core/index.js

@@ -5,11 +5,11 @@
 // Translation pipeline
 export { TranslationPipeline, translateContent } from "./translation-pipeline";
 // Content projection
-export { projectTranslatableContent } from "./content-projection/contentProjector";
-export { fingerprint } from "./content-projection/fingerprinter";
-export { computeSourceFingerprint } from "./content-projection/computeSourceFingerprint";
-export { makeIdPath } from "./content-projection/idPath";
+export { projectTranslatableContent } from "./domain/content-projection/contentProjector";
+export { fingerprint } from "./domain/content-projection/fingerprinter";
+export { computeSourceFingerprint } from "./domain/content-projection/computeSourceFingerprint";
+export { makeIdPath } from "./domain/content-projection/idPath";
 // Field traversal
-export { classifyField, findFieldByPath, hasFields, isBlockItem, isTabsField, matchElementById, resolveBlockFields, tabScopes, walkFields } from "./field-traversal";
+export { classifyField, findFieldByPath, hasFields, isBlockItem, isTabsField, matchElementById, resolveBlockFields, tabScopes, walkFields } from "./kernel/field-traversal";
 
 //# sourceMappingURL=index.js.map

package/dist/core/{field-traversal → kernel/field-traversal}/index.d.ts

@@ -2,6 +2,7 @@ export { findFieldByPath } from "./findFieldByPath";
 export type { FieldPathResult } from "./findFieldByPath";
 export { hasFields, isBlockItem, isTabsField } from "./guards";
 export { classifyField, matchElementById, resolveBlockFields, tabScopes } from "./kernel";
+export { projectFieldsToFieldLike } from "./projectFieldLike";
 export { fieldAffectsData, fieldIsArrayType, fieldIsBlockType, fieldIsGroupType, tabHasName, } from "./predicates";
 export type { ArrayFieldLike, BlockLike, BlocksFieldLike, ChildCursor, ChildOutput, ContainerInfo, FieldLike, FieldStructure, FieldWalker, GroupFieldLike, LeafField, LeafFieldLike, TabLike, TabScope, TabsFieldLike, WalkSignal, } from "./types";
 export { walkFields } from "./walkFields";

package/dist/core/{field-traversal → kernel/field-traversal}/index.js

@@ -1,6 +1,7 @@
 export { findFieldByPath } from "./findFieldByPath";
 export { hasFields, isBlockItem, isTabsField } from "./guards";
 export { classifyField, matchElementById, resolveBlockFields, tabScopes } from "./kernel";
+export { projectFieldsToFieldLike } from "./projectFieldLike";
 export { fieldAffectsData, fieldIsArrayType, fieldIsBlockType, fieldIsGroupType, tabHasName } from "./predicates";
 export { walkFields } from "./walkFields";
 

package/dist/core/kernel/field-traversal/projectFieldLike.d.ts

@@ -0,0 +1,32 @@
+import type { FieldLike } from "./types";
+/**
+ * Deep-project a field schema into an independent {@link FieldLike} tree, copying ONLY the properties
+ * this layer reads. Replaces the `JSON.parse(JSON.stringify(fields))` clone the plugin used to snapshot
+ * a collection's schema before Payload's sanitizer mutates the originals.
+ *
+ * Why a bespoke projection rather than a structural clone:
+ * - **Independence is mandatory, not cosmetic.** Payload's `sanitizeFields` does `delete field.localized`
+ *   **in place** on any field nested under a localized ancestor (group/array/named tab). The pipeline
+ *   reads per-field `localized`, so a shared reference would silently lose it and the field would stop
+ *   being translated. Every field/container here is a NEW object, and `localized` is copied by value at
+ *   projection time (before sanitize runs), so the snapshot is preserved.
+ * - **`structuredClone` can't be used.** Field definitions embed Lexical editor configs containing async
+ *   functions, which `structuredClone` throws on. The old JSON round-trip "worked" only by silently
+ *   dropping every function; this projection drops them explicitly by copying a typed whitelist.
+ *
+ * The contract is exactly what the traversal/pipeline consumes: `type` (classify), `name`/`localized`
+ * (leaf data + translation gate), `custom` (only `custom.translateKit.exclude` is read), and the
+ * container members `fields` (group/array/row/collapsible/unnamed-group), `blocks` (with the
+ * load-bearing `block.slug` used for block-type dispatch), and `tabs` (named + unnamed). Every field is
+ * kept 1:1 (including presentational `ui`/`row`/`collapsible`) so downstream classification is unchanged;
+ * only the property set is narrowed.
+ *
+ * `custom` is copied by reference: it is a passthrough bag Payload does not mutate during sanitize (only
+ * `localized` is deleted, which we snapshot by value), and deep-copying it would re-introduce the
+ * `structuredClone`-on-functions problem this projection exists to avoid.
+ *
+ * @param fields - The source field list (Payload's `Field[]` is structurally assignable to `FieldLike[]`).
+ * @returns A new, independent `FieldLike[]` unaffected by later mutation of the source objects.
+ * @since 0.9.1
+ */
+export declare function projectFieldsToFieldLike(fields: FieldLike[]): FieldLike[];

package/dist/core/kernel/field-traversal/projectFieldLike.js

@@ -0,0 +1,60 @@
+function projectField(field) {
+    const out = {
+        type: field.type
+    };
+    if (field.name !== undefined) out.name = field.name;
+    if (field.localized !== undefined) out.localized = field.localized;
+    if (field.custom !== undefined) out.custom = field.custom;
+    if (field.fields) out.fields = field.fields.map(projectField);
+    if (field.blocks) {
+        out.blocks = field.blocks.map((block)=>({
+                slug: block.slug,
+                fields: block.fields.map(projectField)
+            }));
+    }
+    if (field.tabs) {
+        out.tabs = field.tabs.map((tab)=>{
+            const projected = {
+                fields: tab.fields.map(projectField)
+            };
+            if (tab.name !== undefined) projected.name = tab.name;
+            if (tab.localized !== undefined) projected.localized = tab.localized;
+            return projected;
+        });
+    }
+    return out;
+}
+/**
+ * Deep-project a field schema into an independent {@link FieldLike} tree, copying ONLY the properties
+ * this layer reads. Replaces the `JSON.parse(JSON.stringify(fields))` clone the plugin used to snapshot
+ * a collection's schema before Payload's sanitizer mutates the originals.
+ *
+ * Why a bespoke projection rather than a structural clone:
+ * - **Independence is mandatory, not cosmetic.** Payload's `sanitizeFields` does `delete field.localized`
+ *   **in place** on any field nested under a localized ancestor (group/array/named tab). The pipeline
+ *   reads per-field `localized`, so a shared reference would silently lose it and the field would stop
+ *   being translated. Every field/container here is a NEW object, and `localized` is copied by value at
+ *   projection time (before sanitize runs), so the snapshot is preserved.
+ * - **`structuredClone` can't be used.** Field definitions embed Lexical editor configs containing async
+ *   functions, which `structuredClone` throws on. The old JSON round-trip "worked" only by silently
+ *   dropping every function; this projection drops them explicitly by copying a typed whitelist.
+ *
+ * The contract is exactly what the traversal/pipeline consumes: `type` (classify), `name`/`localized`
+ * (leaf data + translation gate), `custom` (only `custom.translateKit.exclude` is read), and the
+ * container members `fields` (group/array/row/collapsible/unnamed-group), `blocks` (with the
+ * load-bearing `block.slug` used for block-type dispatch), and `tabs` (named + unnamed). Every field is
+ * kept 1:1 (including presentational `ui`/`row`/`collapsible`) so downstream classification is unchanged;
+ * only the property set is narrowed.
+ *
+ * `custom` is copied by reference: it is a passthrough bag Payload does not mutate during sanitize (only
+ * `localized` is deleted, which we snapshot by value), and deep-copying it would re-introduce the
+ * `structuredClone`-on-functions problem this projection exists to avoid.
+ *
+ * @param fields - The source field list (Payload's `Field[]` is structurally assignable to `FieldLike[]`).
+ * @returns A new, independent `FieldLike[]` unaffected by later mutation of the source objects.
+ * @since 0.9.1
+ */ export function projectFieldsToFieldLike(fields) {
+    return fields.map(projectField);
+}
+
+//# sourceMappingURL=projectFieldLike.js.map

package/dist/core/translation-pipeline/TranslationPipeline.d.ts

@@ -1,4 +1,4 @@
-import type { TranslationProvider } from "../translation-providers";
+import type { TranslationProvider } from "../domain/translation-providers";
 import type { PipelineConfig, PipelineResult } from "./types";
 import type { TranslationStrategy } from "./strategies";
 import type { TextExpander } from "./stages";

package/dist/core/translation-pipeline/stages/data-reconciler/DataReconciler.d.ts

@@ -1,4 +1,4 @@
-import type { FieldLike } from "../../../field-traversal";
+import type { FieldLike } from "../../../kernel/field-traversal";
 /**
  * Deep-merges source and target data with target priority, producing the full document shape
  * Payload validation needs. Built on the shared {@link walkFields} engine.

package/dist/core/translation-pipeline/stages/data-reconciler/DataReconciler.js

@@ -1,6 +1,6 @@
-import { isEmpty } from "../../../utils/isEmpty";
-import { isObject } from "../../../utils/isObject";
-import { matchElementById, resolveBlockFields, walkFields } from "../../../field-traversal";
+import { isEmpty } from "../../../kernel/utils/isEmpty";
+import { isObject } from "../../../kernel/utils/isObject";
+import { matchElementById, resolveBlockFields, walkFields } from "../../../kernel/field-traversal";
 const asObject = (value)=>isObject(value) ? value : {};
 /**
  * Reconcile walker: produces the full document shape from source + target, with target

package/dist/core/translation-pipeline/stages/field-collector/FieldChunkCollector.d.ts

@@ -1,4 +1,4 @@
-import type { FieldLike } from "../../../field-traversal";
+import type { FieldLike } from "../../../kernel/field-traversal";
 import type { TranslationStrategy } from "../../strategies";
 import type { FieldChunk } from "../../types";
 /**

package/dist/core/translation-pipeline/stages/field-collector/FieldChunkCollector.js

@@ -1,6 +1,6 @@
-import { isTranslatableLeaf } from "../../../content-projection/translatableLeaf";
-import { matchElementById, resolveBlockFields, walkFields } from "../../../field-traversal";
-import { isObject } from "../../../utils/isObject";
+import { isTranslatableLeaf } from "../../../domain/content-projection/translatableLeaf";
+import { matchElementById, resolveBlockFields, walkFields } from "../../../kernel/field-traversal";
+import { isObject } from "../../../kernel/utils/isObject";
 const asObject = (value)=>isObject(value) ? value : {};
 /**
  * Collects FieldChunks by walking schema + data with the shared {@link walkFields} engine.

package/dist/core/translation-pipeline/stages/text-expander/RichTextExpander.js

@@ -1,4 +1,4 @@
-import { isSerializedLexicalRoot, collectSerializedLexicalTextNodes } from "../../../lexical";
+import { isSerializedLexicalRoot, collectSerializedLexicalTextNodes } from "../../../kernel/lexical";
 /**
  * Expands richText fields into multiple RichTextChunks (one per text node).
  */ export class RichTextExpander {

package/dist/core/translation-pipeline/stages/translation/Translation.stage.d.ts

@@ -1,5 +1,5 @@
 import type { PipelineContext, PipelineStage } from "../../types";
-import type { TranslationProvider } from "../../../translation-providers";
+import type { TranslationProvider } from "../../../domain/translation-providers";
 /**
  * Calls translation provider to translate text.
  */

package/dist/core/translation-pipeline/strategies/Overwrite.strategy.js

@@ -1,4 +1,4 @@
-import { isEmpty } from "../../utils/isEmpty";
+import { isEmpty } from "../../kernel/utils/isEmpty";
 /**
  * Translates all fields, overwriting existing translations.
  * This is the default strategy.

package/dist/core/translation-pipeline/strategies/SkipExisting.strategy.js

@@ -1,6 +1,6 @@
-import { isEmptyRichText } from "../../lexical/isEmptyRichText";
-import { isSerializedLexicalRoot } from "../../lexical/guards";
-import { isEmpty } from "../../utils/isEmpty";
+import { isEmptyRichText } from "../../kernel/lexical/isEmptyRichText";
+import { isSerializedLexicalRoot } from "../../kernel/lexical/guards";
+import { isEmpty } from "../../kernel/utils/isEmpty";
 /**
  * Only translates fields that are empty or missing in the target locale.
  * Existing translations are preserved.

package/dist/core/translation-pipeline/translateContent.d.ts

@@ -1,5 +1,5 @@
-import type { FieldLike } from "../field-traversal";
-import type { TranslationProvider } from "../translation-providers";
+import type { FieldLike } from "../kernel/field-traversal";
+import type { TranslationProvider } from "../domain/translation-providers";
 import type { TranslationStrategyName } from "./strategies";
 export type TranslateContentArgs = {
     /** Schema subtree to translate (e.g. `[declaredFieldConfig]`). */

package/dist/core/translation-pipeline/types/FieldChunk.d.ts

@@ -1,4 +1,4 @@
-import type { LeafFieldLike } from "../../field-traversal/types";
+import type { LeafFieldLike } from "../../kernel/field-traversal/types";
 /**
  * Represents a field-level chunk containing schema metadata.
  * Used in stages 1-3 where schema awareness is needed.

package/dist/core/translation-pipeline/types/Pipeline.d.ts

@@ -1,4 +1,4 @@
-import type { FieldLike } from "../../field-traversal";
+import type { FieldLike } from "../../kernel/field-traversal";
 /**
  * Pipeline configuration for translation execution.
  * Contains only data transformation inputs — no persistence concerns.

package/dist/core/translation-pipeline/types/PipelineContext.d.ts

@@ -1,4 +1,4 @@
-import type { FieldLike } from "../../field-traversal";
+import type { FieldLike } from "../../kernel/field-traversal";
 import type { FieldChunk } from "./FieldChunk";
 import type { TextChunk } from "./TextChunk";
 /**

package/dist/core/translation-pipeline/types/TextChunk.d.ts

@@ -1,4 +1,4 @@
-import type { SerializedTextNode } from "../../lexical";
+import type { SerializedTextNode } from "../../kernel/lexical";
 /**
  * Text chunk for plain text/textarea fields.
  * Mutates dataRef[key] directly.

package/dist/field-config.d.ts

@@ -1,5 +1,5 @@
 import type { Field, RichTextField, TextareaField, TextField } from "payload";
-import type { FieldTranslationConfig } from "./core/field-config";
+import type { FieldTranslationConfig } from "./core/domain/field-config";
 export type { FieldTranslationConfig };
 /**
  * Field types eligible for the per-field translate control — the same text-bearing

package/dist/field-config.js

@@ -1,4 +1,4 @@
-import { TRANSLATE_KIT_CUSTOM_KEY } from "./core/field-config";
+import { TRANSLATE_KIT_CUSTOM_KEY } from "./core/domain/field-config";
 import { TranslateFieldControlExport } from "./client/widgets/translate-field-control/ui/TranslateFieldControl.export";
 import { beforeInputPositioner } from "./field-actions";
 /**

package/dist/plugin.d.ts

@@ -1,6 +1,6 @@
 import type { CollectionConfig, Config } from "payload";
 import type { AccessGuard } from "./types/AccessGuard";
-import type { TranslationProvider } from "./core/translation-providers";
+import type { TranslationProvider } from "./core/domain/translation-providers";
 import type { TaskRunnerProvider } from "./server/modules/task-runner";
 import type { TranslationLifecycleCallbacks } from "./server/modules/lifecycle";
 import type { TranslationLevel } from "./server/modules/translation-levels";

package/dist/plugin.js

@@ -1,6 +1,7 @@
 import { CacheProviderExport } from "./client/app/cache/CacheProvider.export";
 import { configureAutoTranslate } from "./server/modules/auto-translate";
 import { configureProvenance } from "./server/modules/provenance";
+import { projectFieldsToFieldLike } from "./core/kernel/field-traversal";
 import { wireTranslateRunner } from "./server/features/translate-document";
 import { documentLevel, collectionLevel } from "./composition/levels";
 import { PluginConfigBuilder } from "./server/modules/translation-levels/PluginConfigBuilder";
@@ -13,17 +14,15 @@ import { normalizePath } from "./server/shared";
     init() {
         return async (config)=>{
             const { access, translationProvider, runner, collections, levels, provenance, lifecycle, basePath: rawBasePath = "/translate" } = this.pluginConfig;
-            // Build schema map from deep-cloned collections.
-            // Deep clone is required because Payload mutates the original collection objects, removing
-            // `localized: true` from nested fields during sanitization. JSON round-trip (not
-            // structuredClone) because Lexical editor configs contain async functions structuredClone
-            // cannot handle.
-            // TODO: Consider introducing a FieldLike interface with only the properties used by the
-            // pipeline (name, type, localized, fields, blocks, tabs, custom) to make the contract explicit
-            // and avoid reliance on JSON round-trip.
+            // Snapshot each collection's schema as an independent FieldLike tree BEFORE Payload's sanitizer
+            // mutates the originals (it deletes `localized` from fields nested under a localized ancestor).
+            // `projectFieldsToFieldLike` deep-copies only the properties the pipeline reads — an explicit,
+            // typed contract, replacing the old JSON round-trip (which "worked" only by silently dropping the
+            // Lexical editor's async functions that structuredClone chokes on). Payload's `Field[]` is
+            // structurally assignable to `FieldLike[]`, so the projection happens right here at the boundary.
             const schemaMap = new Map(collections.map((col)=>[
                     col.slug,
-                    JSON.parse(JSON.stringify(col.fields))
+                    projectFieldsToFieldLike(col.fields)
                 ]));
             const collectionSlugs = new Set(schemaMap.keys());
             const basePath = normalizePath(rawBasePath);

package/dist/server/features/translate-document/handler.d.ts

@@ -1,6 +1,6 @@
 import type { Payload } from "payload";
 import type { Handler } from "../../shared";
-import type { TranslationProvider } from "../../../core/translation-providers";
+import type { TranslationProvider } from "../../../core/domain/translation-providers";
 import type { ProvenanceServiceFactory } from "../../modules/provenance";
 import type { CollectionSchemaMap } from "../../../types/CollectionSchemaMap";
 import type { TranslateDocumentInput, TranslateDocumentOutput } from "./model";

package/dist/server/features/translate-document/wireTranslateRunner.d.ts

@@ -1,5 +1,5 @@
 import type { CollectionSlug } from "payload";
-import type { TranslationProvider } from "../../../core/translation-providers";
+import type { TranslationProvider } from "../../../core/domain/translation-providers";
 import type { CollectionSchemaMap } from "../../../types/CollectionSchemaMap";
 import type { ConfigModifier } from "../../../types/ConfigModifier";
 import type { ProvenanceServiceFactory } from "../../modules/provenance";

package/dist/server/features/translate-field/model.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod";
 import type { CollectionSchemaMap } from "../../../types/CollectionSchemaMap";
-import type { TranslationProvider } from "../../../core/translation-providers";
+import type { TranslationProvider } from "../../../core/domain/translation-providers";
 /**
  * Max serialized size of the value the endpoint will translate — the value read from the
  * source-locale document (the request body no longer carries one; this is from-locale only). The

package/dist/server/features/translate-field/resolveFieldSubtree.d.ts

@@ -1,4 +1,4 @@
-import type { Field } from "payload";
+import type { FieldLike } from "../../../core/kernel/field-traversal";
 /**
  * Outcome of mapping a declared field path to a translatable subtree.
  *
@@ -14,7 +14,7 @@ import type { Field } from "payload";
  */
 export type FieldSubtreeResolution = {
     status: "resolved";
-    schema: Field[];
+    schema: FieldLike[];
     sourceData: Record<string, unknown>;
     fieldName: string;
 } | {
@@ -36,4 +36,4 @@ export type FieldSubtreeResolution = {
  * the element's `blockType` in `doc` picks the block schema. Without `doc`, a path through a
  * `blocks` field returns `inside-blocks`.
  */
-export declare function resolveFieldSubtree(rootFields: Field[], fieldPath: string, value: unknown, doc?: unknown): FieldSubtreeResolution;
+export declare function resolveFieldSubtree(rootFields: FieldLike[], fieldPath: string, value: unknown, doc?: unknown): FieldSubtreeResolution;

package/dist/server/features/translate-field/resolveFieldSubtree.js

@@ -1,5 +1,5 @@
 import { isTranslatableField } from "../../shared";
-import { findFieldByPath } from "../../../core/field-traversal";
+import { findFieldByPath } from "../../../core/kernel/field-traversal";
 /**
  * Map a declared `fieldPath` to the `{ schema, sourceData }` pair `translateContent` expects.
  * Walks the schema via the shared {@link findFieldByPath}. Descends transparently through

package/dist/server/modules/auto-translate/AutoTranslate.policy.d.ts

@@ -1,5 +1,5 @@
 import type { CollectionSlug } from "payload";
-import type { AutoTranslateConfig } from "../../../core/auto-translate-config";
+import type { AutoTranslateConfig } from "../../../core/domain/auto-translate";
 import type { TaskInput } from "../task-runner/types";
 /** A collection's auto-translate rule with defaults resolved — the shape the hook consumes. */
 export type NormalizedAutoTranslatePolicy = {

package/dist/server/modules/auto-translate/AutoTranslate.wiring.js

@@ -1,4 +1,4 @@
-import { getAutoTranslateConfig } from "../../../core/auto-translate-config";
+import { getAutoTranslateConfig } from "../../../core/domain/auto-translate";
 import { extractLocaleCodes, filterPolicyToKnownLocales, makeCollectionPolicyResolver, normalizeAutoTranslateConfig } from "./AutoTranslate.policy";
 import { injectAutoTranslateHook, makeAutoTranslateHook, propagateAutoTranslateCustom } from "./AutoTranslateEnqueue.hook";
 const NOOP = (config)=>config;

package/dist/server/modules/auto-translate/AutoTranslateEnqueue.hook.js

@@ -1,5 +1,5 @@
-import { hasSourceContentChanged } from "../../../core/auto-translate";
-import { AUTO_TRANSLATE_CUSTOM_KEY } from "../../../core/auto-translate-config";
+import { hasSourceContentChanged } from "../../../core/domain/auto-translate";
+import { AUTO_TRANSLATE_CUSTOM_KEY } from "../../../core/domain/auto-translate";
 import { AUTO_TRANSLATE_SKIP_CONTEXT_KEY } from "../../../types/AutoTranslateContext";
 import { buildAutoTranslateTasks, passesPublishGate } from "./AutoTranslate.policy";
 /**

package/dist/server/modules/auto-translate/index.js

@@ -1,5 +1,5 @@
 // Auto-translate adapter (Payload-backed). The payload-free drift predicate + config reader live in
-// the core (src/core/auto-translate*, src/core/content-projection); this module is the config-time
+// the core (src/core/domain/auto-translate, src/core/domain/content-projection); this module is the config-time
 // wiring + the afterChange hook that enqueues translations on a source-locale change (#51).
 export { configureAutoTranslate } from "./AutoTranslate.wiring";
 export { makeAutoTranslateHook, injectAutoTranslateHook } from "./AutoTranslateEnqueue.hook";

package/dist/server/modules/index.d.ts

@@ -1,2 +1,2 @@
-export * from "../../core/translation-providers";
+export * from "../../core/domain/translation-providers";
 export * from "../../core/translation-pipeline";

package/dist/server/modules/index.js

@@ -1,4 +1,4 @@
-export * from "../../core/translation-providers";
+export * from "../../core/domain/translation-providers";
 export * from "../../core/translation-pipeline";
 
 //# sourceMappingURL=index.js.map

package/dist/server/modules/provenance/Provenance.service.d.ts

@@ -1,5 +1,5 @@
 import type { CollectionSlug, Payload } from "payload";
-import type { ProvenanceKey, ProvenanceStore } from "../../../core/provenance";
+import type { ProvenanceKey, ProvenanceStore } from "../../../core/domain/provenance";
 import type { CollectionSchemaMap } from "../../../types/CollectionSchemaMap";
 /** Per-locale staleness for one document (snake_case, matching the other translation endpoints). */
 export type StalenessLocale = {

package/dist/server/modules/provenance/Provenance.service.js

@@ -1,5 +1,5 @@
-import { computeSourceFingerprint } from "../../../core/content-projection/computeSourceFingerprint";
-import { isRecordStale } from "../../../core/provenance";
+import { computeSourceFingerprint } from "../../../core/domain/content-projection/computeSourceFingerprint";
+import { isRecordStale } from "../../../core/domain/provenance";
 import { fetchSourceDocument } from "../../shared/payload/sourceDocument";
 /**
  * The single owner of provenance fingerprint policy — how the source is hashed on write, re-hashed on

package/dist/server/modules/provenance/Provenance.store.d.ts

@@ -1,5 +1,5 @@
 import type { Payload } from "payload";
-import type { ProvenanceKey, ProvenanceStore, TranslationProvenanceRecord } from "../../../core/provenance";
+import type { ProvenanceKey, ProvenanceStore, TranslationProvenanceRecord } from "../../../core/domain/provenance";
 /** Builds a provenance store bound to a Payload instance; absent when provenance is disabled. */
 export type ProvenanceStoreFactory = (payload: Payload) => ProvenanceStore;
 /**

package/dist/server/modules/provenance/index.js

@@ -1,5 +1,5 @@
 // Provenance adapter (Payload-backed). The framework-agnostic port + record types live in the core
-// (src/core/provenance); this module is the plugin-side implementation + its config-time wiring.
+// (src/core/domain/provenance); this module is the plugin-side implementation + its config-time wiring.
 export { DEFAULT_PROVENANCE_SLUG, isProvenanceCollection, makeProvenanceCollection } from "./Provenance.collection";
 export { PayloadProvenanceStore } from "./Provenance.store";
 export { injectProvenanceCleanup, makeProvenanceCleanupHook } from "./ProvenanceCleanup.hook";

package/dist/server/modules/translation-levels/PluginConfigBuilder.d.ts

@@ -3,7 +3,7 @@ import type { AccessGuard } from "../../../types/AccessGuard";
 import type { RawPayloadComponentExport } from "../../../types/PayloadComponentExport";
 import type { CollectionSchemaMap } from "../../../types/CollectionSchemaMap";
 import type { ConfigModifier } from "../../../types/ConfigModifier";
-import type { TranslationProvider } from "../../../core/translation-providers";
+import type { TranslationProvider } from "../../../core/domain/translation-providers";
 import type { TaskRunnerFactory } from "../task-runner";
 import type { ProvenanceServiceFactory } from "../provenance";
 import type { CollectionAdminSlot, LevelContext, TranslationContext } from "./types";

package/dist/server/modules/translation-levels/types.d.ts

@@ -2,7 +2,7 @@ import type { CollectionConfig, Endpoint } from "payload";
 import type { AccessGuard } from "../../../types/AccessGuard";
 import type { RawPayloadComponentExport } from "../../../types/PayloadComponentExport";
 import type { CollectionSchemaMap } from "../../../types/CollectionSchemaMap";
-import type { TranslationProvider } from "../../../core/translation-providers";
+import type { TranslationProvider } from "../../../core/domain/translation-providers";
 import type { TaskRunnerFactory } from "../task-runner";
 import type { ProvenanceServiceFactory } from "../provenance";
 export type CollectionAdminSlot = "beforeDocumentControls" | "beforeListTable";

package/dist/server/shared/index.d.ts

@@ -4,9 +4,9 @@ export type { AccessGuard, AccessGuardRequest, Handler } from "./access";
 export { isEmpty, isObject, normalizePath, pipe, getByPath, setByPath, filterLocalizedFields, } from "./utils";
 export type { TranslatableField } from "./guards";
 export { isTranslatableField, isLocalizedField, isRelationshipField } from "./guards";
-export { isTabsField, isBlockItem, hasFields } from "../../core/field-traversal";
-export { isFieldExcludedFromTranslation, getTranslateKitFieldConfig, } from "../../core/field-config";
-export type { TranslateKitFieldConfig } from "../../core/field-config";
-export { isSerializedLexicalRoot, isEmptyRichText, traverseLexicalTree, collectSerializedLexicalTextNodes, } from "../../core/lexical";
-export type { SerializedTextNodeRef } from "../../core/lexical";
+export { isTabsField, isBlockItem, hasFields } from "../../core/kernel/field-traversal";
+export { isFieldExcludedFromTranslation, getTranslateKitFieldConfig, } from "../../core/domain/field-config";
+export type { TranslateKitFieldConfig } from "../../core/domain/field-config";
+export { isSerializedLexicalRoot, isEmptyRichText, traverseLexicalTree, collectSerializedLexicalTextNodes, } from "../../core/kernel/lexical";
+export type { SerializedTextNodeRef } from "../../core/kernel/lexical";
 export { JobIdSchema } from "./validation";

package/dist/server/shared/index.js

@@ -5,11 +5,11 @@ export { AnyAccessGuard } from "./access";
 // General utilities
 export { isEmpty, isObject, normalizePath, pipe, getByPath, setByPath, filterLocalizedFields } from "./utils";
 export { isTranslatableField, isLocalizedField, isRelationshipField } from "./guards";
-export { isTabsField, isBlockItem, hasFields } from "../../core/field-traversal";
+export { isTabsField, isBlockItem, hasFields } from "../../core/kernel/field-traversal";
 // Field config
-export { isFieldExcludedFromTranslation, getTranslateKitFieldConfig } from "../../core/field-config";
+export { isFieldExcludedFromTranslation, getTranslateKitFieldConfig } from "../../core/domain/field-config";
 // Lexical utilities
-export { isSerializedLexicalRoot, isEmptyRichText, traverseLexicalTree, collectSerializedLexicalTextNodes } from "../../core/lexical";
+export { isSerializedLexicalRoot, isEmptyRichText, traverseLexicalTree, collectSerializedLexicalTextNodes } from "../../core/kernel/lexical";
 // Validation primitives
 export { JobIdSchema } from "./validation";
 

package/dist/server/shared/utils/filterLocalizedFields.js

@@ -1,6 +1,6 @@
-import { resolveBlockFields, walkFields } from "../../../core/field-traversal";
+import { resolveBlockFields, walkFields } from "../../../core/kernel/field-traversal";
 import { isLocalizedField, isTranslatableField } from "../guards";
-import { isObject } from "../../../core/utils/isObject";
+import { isObject } from "../../../core/kernel/utils/isObject";
 /**
  * Filter walker: keeps only translatable, localized leaves, rebuilding the surrounding
  * object/array/blocks structure and dropping any container left empty. `id` (array/block

package/dist/server/shared/utils/getByPath.js

@@ -1,4 +1,4 @@
-import { isObject } from "../../../core/utils/isObject";
+import { isObject } from "../../../core/kernel/utils/isObject";
 /**
  * Gets a value from an object by dot-notation path.
  *

package/dist/server/shared/utils/index.d.ts

@@ -1,5 +1,5 @@
-export { isEmpty } from "../../../core/utils/isEmpty";
-export { isObject } from "../../../core/utils/isObject";
+export { isEmpty } from "../../../core/kernel/utils/isEmpty";
+export { isObject } from "../../../core/kernel/utils/isObject";
 export { normalizePath } from "./normalizePath";
 export { getByPath } from "./getByPath";
 export { setByPath } from "./setByPath";

package/dist/server/shared/utils/index.js

@@ -1,5 +1,5 @@
-export { isEmpty } from "../../../core/utils/isEmpty";
-export { isObject } from "../../../core/utils/isObject";
+export { isEmpty } from "../../../core/kernel/utils/isEmpty";
+export { isObject } from "../../../core/kernel/utils/isObject";
 export { normalizePath } from "./normalizePath";
 export { getByPath } from "./getByPath";
 export { setByPath } from "./setByPath";

package/dist/server/shared/utils/setByPath.js

@@ -1,4 +1,4 @@
-import { isObject } from "../../../core/utils/isObject";
+import { isObject } from "../../../core/kernel/utils/isObject";
 /**
  * Sets a value in an object by dot-notation path.
  * Creates intermediate objects/arrays as needed.

package/dist/translation-providers/index.d.ts

@@ -1,2 +1,2 @@
-export type { TranslationProvider, TranslationInput, TranslationOutput, } from "../core/translation-providers";
+export type { TranslationProvider, TranslationInput, TranslationOutput, } from "../core/domain/translation-providers";
 export * from "./openai";

package/dist/translation-providers/openai/OpenAITranslation.provider.d.ts

@@ -1,4 +1,4 @@
-import type { TranslationProvider, TranslationInput, TranslationOutput } from "../../core/translation-providers/TranslationProvider.interface";
+import type { TranslationProvider, TranslationInput, TranslationOutput } from "../../core/domain/translation-providers/TranslationProvider.interface";
 import type { ChatModel } from "openai/resources/index.mjs";
 /**
  * Function to transform text in dry run mode.

package/dist/translation-providers/openai/OpenAITranslation.provider.js

@@ -1,5 +1,5 @@
 import OpenAI from "openai";
-import { isObject } from "../../core/utils/isObject";
+import { isObject } from "../../core/kernel/utils/isObject";
 /** @deprecated Use `createOpenAIProvider` function instead */ export class OpenAITranslationProvider {
     openAiClient;
     config;

package/dist/types/CollectionSchemaMap.d.ts

@@ -1,6 +1,9 @@
-import type { CollectionSlug, Field } from "payload";
+import type { CollectionSlug } from "payload";
+import type { FieldLike } from "../core/kernel/field-traversal";
 /**
- * Map of collection slug to original field schema.
- * Used to access original schemas before Payload sanitization.
+ * Map of collection slug to its projected field schema — an independent {@link FieldLike} snapshot
+ * taken (via `projectFieldsToFieldLike`) before Payload's sanitizer mutates the originals, so nested
+ * `localized` flags survive. Typed as `FieldLike[]` (not Payload's `Field[]`) because every consumer
+ * reads it structurally as `FieldLike`; the projection is the boundary that makes that explicit.
  */
-export type CollectionSchemaMap = Map<CollectionSlug, Field[]>;
+export type CollectionSchemaMap = Map<CollectionSlug, FieldLike[]>;

package/dist/types/CollectionSchemaMap.js

@@ -1,6 +1,8 @@
 /**
- * Map of collection slug to original field schema.
- * Used to access original schemas before Payload sanitization.
+ * Map of collection slug to its projected field schema — an independent {@link FieldLike} snapshot
+ * taken (via `projectFieldsToFieldLike`) before Payload's sanitizer mutates the originals, so nested
+ * `localized` flags survive. Typed as `FieldLike[]` (not Payload's `Field[]`) because every consumer
+ * reads it structurally as `FieldLike`; the projection is the boundary that makes that explicit.
  */ export { };
 
 //# sourceMappingURL=CollectionSchemaMap.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@focus-reactive/payload-plugin-translator",
-  "version": "0.9.0",
+  "version": "0.9.2",
   "description": "Translation plugin for Payload CMS 3.x. Automatically translate your localized content using any translation provider.",
   "type": "module",
   "license": "MIT",

package/dist/core/auto-translate/index.d.ts

@@ -1 +0,0 @@
-export { hasSourceContentChanged } from "./hasSourceContentChanged";

package/dist/core/auto-translate/index.js

@@ -1,3 +0,0 @@
-export { hasSourceContentChanged } from "./hasSourceContentChanged";
-
-//# sourceMappingURL=index.js.map