@pigment/auto-translate 1.2.0

package/dist/types/index.d.ts

@@ -0,0 +1,103 @@
+import type { CollectionSlug, Payload } from 'payload';
+export type AutoTranslateConfig = {
+    /**
+     * Auto-inject translation control UI into all localized fields (default: true)
+     * Note: This is ignored if enableExclusions is false
+     */
+    autoInjectUI?: boolean;
+    /**
+     * List of collections to enable auto-translation
+     */
+    collections?: Partial<Record<CollectionSlug, boolean | CollectionTranslateConfig>>;
+    /**
+     * Enable field-level translation exclusions (default: true)
+     * When disabled:
+     * - Translation exclusions collection is hidden
+     * - Translation control buttons are not added to fields
+     * - All localized fields are always translated
+     */
+    enableExclusions?: boolean;
+    /**
+     * Show debug logs
+     */
+    debugging?: boolean;
+    /**
+     * Disable the plugin entirely
+     */
+    disabled?: boolean;
+    /**
+     * Enable deduplication of identical strings (default: true)
+     * When enabled, identical strings are only translated once and reused
+     * This significantly speeds up translation for documents with repeated content
+     */
+    enableDeduplication?: boolean;
+    /**
+     * Enable translation sync by default
+     */
+    enableTranslationSyncByDefault?: boolean;
+    /**
+     * Fields to exclude from translation globally
+     */
+    excludeFields?: string[];
+    /**
+     * Minimum string length to translate (default: 3)
+     * Strings shorter than this (after trimming) will be skipped
+     * This helps avoid translating single characters, dashes, spaces, etc.
+     */
+    minStringLength?: number;
+    /**
+     * Use optimized translation that extracts only translatable strings (default: true)
+     * This dramatically reduces API payload size and improves translation speed for large documents
+     */
+    optimizeTranslation?: boolean;
+    /**
+     * Translation provider settings
+     */
+    provider?: {
+        apiKey?: string;
+        baseURL?: string;
+        customTranslate?: (options: TranslateOptions) => Promise<any>;
+        model?: string;
+        type: 'custom' | 'openai';
+    };
+    /**
+     * Collection slug for storing translation exclusions metadata
+     */
+    translationExclusionsSlug?: string;
+    /**
+     * Global slug for translation settings UI
+     */
+    translationSettingsSlug?: string;
+};
+export type CollectionTranslateConfig = {
+    /**
+     * Enable translation for this collection
+     */
+    enabled?: boolean;
+    /**
+     * Fields to exclude from translation for this specific collection
+     */
+    excludeFields?: string[];
+};
+export type TranslateOptions = {
+    collection: CollectionSlug;
+    data: any;
+    excludedPaths?: string[];
+    fromLocale: string;
+    payload: Payload;
+    toLocale: string;
+};
+export type TranslationExclusion = {
+    collection: CollectionSlug;
+    createdAt?: string;
+    documentId: string;
+    excludedPaths: string[];
+    id?: string;
+    locale: string;
+    updatedAt?: string;
+};
+export type FieldPath = {
+    parentPath?: string;
+    path: string;
+    value: any;
+};

package/dist/types/index.js

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

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/index.ts"],"sourcesContent":["import type { CollectionSlug, Payload } from 'payload'\n\nexport type AutoTranslateConfig = {\n  /**\n   * Auto-inject translation control UI into all localized fields (default: true)\n   * Note: This is ignored if enableExclusions is false\n   */\n  autoInjectUI?: boolean\n\n  /**\n   * List of collections to enable auto-translation\n   */\n  collections?: Partial<Record<CollectionSlug, boolean | CollectionTranslateConfig>>\n\n  /**\n   * Enable field-level translation exclusions (default: true)\n   * When disabled:\n   * - Translation exclusions collection is hidden\n   * - Translation control buttons are not added to fields\n   * - All localized fields are always translated\n   */\n  enableExclusions?: boolean\n\n  /**\n   * Show debug logs\n   */\n  debugging?: boolean\n\n  /**\n   * Disable the plugin entirely\n   */\n  disabled?: boolean\n\n  /**\n   * Enable deduplication of identical strings (default: true)\n   * When enabled, identical strings are only translated once and reused\n   * This significantly speeds up translation for documents with repeated content\n   */\n  enableDeduplication?: boolean\n\n  /**\n   * Enable translation sync by default\n   */\n  enableTranslationSyncByDefault?: boolean\n\n  /**\n   * Fields to exclude from translation globally\n   */\n  excludeFields?: string[]\n\n  /**\n   * Minimum string length to translate (default: 3)\n   * Strings shorter than this (after trimming) will be skipped\n   * This helps avoid translating single characters, dashes, spaces, etc.\n   */\n  minStringLength?: number\n\n  /**\n   * Use optimized translation that extracts only translatable strings (default: true)\n   * This dramatically reduces API payload size and improves translation speed for large documents\n   */\n  optimizeTranslation?: boolean\n\n  /**\n   * Translation provider settings\n   */\n  provider?: {\n    apiKey?: string\n    baseURL?: string\n    customTranslate?: (options: TranslateOptions) => Promise<any>\n    model?: string\n    type: 'custom' | 'openai'\n  }\n\n  /**\n   * Collection slug for storing translation exclusions metadata\n   */\n  translationExclusionsSlug?: string\n\n  /**\n   * Global slug for translation settings UI\n   */\n  translationSettingsSlug?: string\n}\n\nexport type CollectionTranslateConfig = {\n  /**\n   * Enable translation for this collection\n   */\n  enabled?: boolean\n\n  /**\n   * Fields to exclude from translation for this specific collection\n   */\n  excludeFields?: string[]\n}\n\nexport type TranslateOptions = {\n  collection: CollectionSlug\n  data: any\n  excludedPaths?: string[]\n  fromLocale: string\n  payload: Payload\n  toLocale: string\n}\n\nexport type TranslationExclusion = {\n  collection: CollectionSlug\n  createdAt?: string\n  documentId: string\n  excludedPaths: string[] // Field paths like 'title', 'content.0.description'\n  id?: string\n  locale: string\n  updatedAt?: string\n}\n\nexport type FieldPath = {\n  parentPath?: string\n  path: string\n  value: any\n}\n"],"names":[],"mappings":"AAoHA,WAIC"}

package/dist/utilities/fieldHelpers.d.ts

@@ -0,0 +1,34 @@
+import type { Field } from 'payload';
+import type { FieldPath } from '../types/index.js';
+/**
+ * Recursively extracts all field paths and their values from a document
+ */
+export declare function extractFieldPaths(data: any, parentPath?: string, fields?: Field[]): FieldPath[];
+/**
+ * Filters out excluded paths from data before translation
+ */
+export declare function filterExcludedPaths(data: any, excludedPaths: string[]): any;
+/**
+ * Merges translated data back, respecting excluded paths
+ */
+export declare function mergeTranslatedData(originalData: any, translatedData: any, excludedPaths: string[]): any;
+/**
+ * Checks if a path is excluded or if any parent path is excluded
+ */
+export declare function isPathExcluded(path: string, excludedPaths: string[]): boolean;
+/**
+ * Gets value at path using dot notation
+ */
+export declare function getValueAtPath(obj: any, path: string): any;
+/**
+ * Sets value at path using dot notation
+ */
+export declare function setValueAtPath(obj: any, path: string, value: any): void;
+/**
+ * Checks if a field is a localized field
+ */
+export declare function isLocalizedField(field: Field): boolean;
+/**
+ * Gets all localized field paths from a collection config
+ */
+export declare function getLocalizedFieldPaths(fields: Field[], parentPath?: string): string[];

package/dist/utilities/fieldHelpers.js

@@ -0,0 +1,180 @@
+/**
+ * Recursively extracts all field paths and their values from a document
+ */ export function extractFieldPaths(data, parentPath = '', fields) {
+    const paths = [];
+    if (!data || typeof data !== 'object') {
+        return paths;
+    }
+    for (const [key, value] of Object.entries(data)){
+        const currentPath = parentPath ? `${parentPath}.${key}` : key;
+        // Skip internal fields
+        if (key === 'id' || key === '_id' || key === 'createdAt' || key === 'updatedAt' || key === 'translationSync' || key === '__v') {
+            continue;
+        }
+        // Add current field
+        paths.push({
+            parentPath,
+            path: currentPath,
+            value
+        });
+        // Recursively process nested objects
+        if (value && typeof value === 'object' && !Array.isArray(value)) {
+            paths.push(...extractFieldPaths(value, currentPath, fields));
+        }
+        // Process arrays
+        if (Array.isArray(value)) {
+            value.forEach((item, index)=>{
+                const arrayPath = `${currentPath}.${index}`;
+                if (item && typeof item === 'object') {
+                    paths.push(...extractFieldPaths(item, arrayPath, fields));
+                }
+            });
+        }
+    }
+    return paths;
+}
+/**
+ * Filters out excluded paths from data before translation
+ */ export function filterExcludedPaths(data, excludedPaths) {
+    if (!data || typeof data !== 'object' || excludedPaths.length === 0) {
+        return data;
+    }
+    const filtered = JSON.parse(JSON.stringify(data)) // Deep clone
+    ;
+    for (const excludedPath of excludedPaths){
+        deletePath(filtered, excludedPath);
+    }
+    return filtered;
+}
+/**
+ * Merges translated data back, respecting excluded paths
+ */ export function mergeTranslatedData(originalData, translatedData, excludedPaths) {
+    if (!translatedData || typeof translatedData !== 'object') {
+        return originalData;
+    }
+    const merged = JSON.parse(JSON.stringify(originalData)) // Deep clone
+    ;
+    function merge(target, source, currentPath = '') {
+        for(const key in source){
+            const fullPath = currentPath ? `${currentPath}.${key}` : key;
+            // Skip if this path is excluded
+            if (isPathExcluded(fullPath, excludedPaths)) {
+                continue;
+            }
+            // Skip internal fields
+            if (key === 'id' || key === '_id' || key === 'createdAt' || key === 'updatedAt' || key === 'translationSync' || key === '__v') {
+                continue;
+            }
+            if (source[key] && typeof source[key] === 'object' && !Array.isArray(source[key])) {
+                if (!target[key]) {
+                    target[key] = {};
+                }
+                merge(target[key], source[key], fullPath);
+            } else {
+                target[key] = source[key];
+            }
+        }
+    }
+    merge(merged, translatedData);
+    return merged;
+}
+/**
+ * Checks if a path is excluded or if any parent path is excluded
+ */ export function isPathExcluded(path, excludedPaths) {
+    return excludedPaths.some((excludedPath)=>{
+        // Exact match
+        if (path === excludedPath) {
+            return true;
+        }
+        // Check if path is a child of excluded path
+        if (path.startsWith(`${excludedPath}.`)) {
+            return true;
+        }
+        // Check if excluded path is a pattern match for arrays (e.g., content.0.title)
+        const pathParts = path.split('.');
+        const excludedParts = excludedPath.split('.');
+        for(let i = 0; i < Math.min(pathParts.length, excludedParts.length); i++){
+            if (excludedParts[i] !== pathParts[i]) {
+                // Check if it's an array index difference
+                if (!isNaN(Number(pathParts[i])) && !isNaN(Number(excludedParts[i]))) {
+                    continue;
+                }
+                return false;
+            }
+        }
+        return excludedParts.length <= pathParts.length;
+    });
+}
+/**
+ * Deletes a path from an object using dot notation
+ */ function deletePath(obj, path) {
+    const parts = path.split('.');
+    let current = obj;
+    for(let i = 0; i < parts.length - 1; i++){
+        if (!current[parts[i]]) {
+            return;
+        }
+        current = current[parts[i]];
+    }
+    delete current[parts[parts.length - 1]];
+}
+/**
+ * Gets value at path using dot notation
+ */ export function getValueAtPath(obj, path) {
+    return path.split('.').reduce((current, part)=>current?.[part], obj);
+}
+/**
+ * Sets value at path using dot notation
+ */ export function setValueAtPath(obj, path, value) {
+    const parts = path.split('.');
+    let current = obj;
+    for(let i = 0; i < parts.length - 1; i++){
+        if (!current[parts[i]]) {
+            current[parts[i]] = {};
+        }
+        current = current[parts[i]];
+    }
+    current[parts[parts.length - 1]] = value;
+}
+/**
+ * Checks if a field is a localized field
+ */ export function isLocalizedField(field) {
+    return 'localized' in field && field.localized === true;
+}
+/**
+ * Gets all localized field paths from a collection config
+ */ export function getLocalizedFieldPaths(fields, parentPath = '') {
+    const paths = [];
+    for (const field of fields){
+        if (!('name' in field)) {
+            continue;
+        }
+        const fieldPath = parentPath ? `${parentPath}.${field.name}` : field.name;
+        if (isLocalizedField(field)) {
+            paths.push(fieldPath);
+        }
+        // Recursively check nested fields
+        if ('fields' in field && Array.isArray(field.fields)) {
+            paths.push(...getLocalizedFieldPaths(field.fields, fieldPath));
+        }
+        // Check blocks
+        if (field.type === 'blocks' && 'blocks' in field && Array.isArray(field.blocks)) {
+            for (const block of field.blocks){
+                if ('fields' in block && Array.isArray(block.fields)) {
+                    paths.push(...getLocalizedFieldPaths(block.fields, fieldPath));
+                }
+            }
+        }
+        // Check group fields
+        if (field.type === 'group' && 'fields' in field && Array.isArray(field.fields)) {
+            paths.push(...getLocalizedFieldPaths(field.fields, fieldPath));
+        }
+        // Check array fields
+        if (field.type === 'array' && 'fields' in field && Array.isArray(field.fields)) {
+            paths.push(...getLocalizedFieldPaths(field.fields, fieldPath));
+        }
+    }
+    return paths;
+}
+
+//# sourceMappingURL=fieldHelpers.js.map

package/dist/utilities/fieldHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/fieldHelpers.ts"],"sourcesContent":["import type { Field } from 'payload'\n\nimport type { FieldPath } from '../types/index.js'\n\n/**\n * Recursively extracts all field paths and their values from a document\n */\nexport function extractFieldPaths(\n  data: any,\n  parentPath: string = '',\n  fields?: Field[],\n): FieldPath[] {\n  const paths: FieldPath[] = []\n\n  if (!data || typeof data !== 'object') {\n    return paths\n  }\n\n  for (const [key, value] of Object.entries(data)) {\n    const currentPath = parentPath ? `${parentPath}.${key}` : key\n\n    // Skip internal fields\n    if (\n      key === 'id' ||\n      key === '_id' ||\n      key === 'createdAt' ||\n      key === 'updatedAt' ||\n      key === 'translationSync' ||\n      key === '__v'\n    ) {\n      continue\n    }\n\n    // Add current field\n    paths.push({\n      parentPath,\n      path: currentPath,\n      value,\n    })\n\n    // Recursively process nested objects\n    if (value && typeof value === 'object' && !Array.isArray(value)) {\n      paths.push(...extractFieldPaths(value, currentPath, fields))\n    }\n\n    // Process arrays\n    if (Array.isArray(value)) {\n      value.forEach((item, index) => {\n        const arrayPath = `${currentPath}.${index}`\n        if (item && typeof item === 'object') {\n          paths.push(...extractFieldPaths(item, arrayPath, fields))\n        }\n      })\n    }\n  }\n\n  return paths\n}\n\n/**\n * Filters out excluded paths from data before translation\n */\nexport function filterExcludedPaths(data: any, excludedPaths: string[]): any {\n  if (!data || typeof data !== 'object' || excludedPaths.length === 0) {\n    return data\n  }\n\n  const filtered = JSON.parse(JSON.stringify(data)) // Deep clone\n\n  for (const excludedPath of excludedPaths) {\n    deletePath(filtered, excludedPath)\n  }\n\n  return filtered\n}\n\n/**\n * Merges translated data back, respecting excluded paths\n */\nexport function mergeTranslatedData(\n  originalData: any,\n  translatedData: any,\n  excludedPaths: string[],\n): any {\n  if (!translatedData || typeof translatedData !== 'object') {\n    return originalData\n  }\n\n  const merged = JSON.parse(JSON.stringify(originalData)) // Deep clone\n\n  function merge(target: any, source: any, currentPath: string = ''): void {\n    for (const key in source) {\n      const fullPath = currentPath ? `${currentPath}.${key}` : key\n\n      // Skip if this path is excluded\n      if (isPathExcluded(fullPath, excludedPaths)) {\n        continue\n      }\n\n      // Skip internal fields\n      if (\n        key === 'id' ||\n        key === '_id' ||\n        key === 'createdAt' ||\n        key === 'updatedAt' ||\n        key === 'translationSync' ||\n        key === '__v'\n      ) {\n        continue\n      }\n\n      if (source[key] && typeof source[key] === 'object' && !Array.isArray(source[key])) {\n        if (!target[key]) {\n          target[key] = {}\n        }\n        merge(target[key], source[key], fullPath)\n      } else {\n        target[key] = source[key]\n      }\n    }\n  }\n\n  merge(merged, translatedData)\n  return merged\n}\n\n/**\n * Checks if a path is excluded or if any parent path is excluded\n */\nexport function isPathExcluded(path: string, excludedPaths: string[]): boolean {\n  return excludedPaths.some((excludedPath) => {\n    // Exact match\n    if (path === excludedPath) {\n      return true\n    }\n\n    // Check if path is a child of excluded path\n    if (path.startsWith(`${excludedPath}.`)) {\n      return true\n    }\n\n    // Check if excluded path is a pattern match for arrays (e.g., content.0.title)\n    const pathParts = path.split('.')\n    const excludedParts = excludedPath.split('.')\n\n    for (let i = 0; i < Math.min(pathParts.length, excludedParts.length); i++) {\n      if (excludedParts[i] !== pathParts[i]) {\n        // Check if it's an array index difference\n        if (!isNaN(Number(pathParts[i])) && !isNaN(Number(excludedParts[i]))) {\n          continue\n        }\n        return false\n      }\n    }\n\n    return excludedParts.length <= pathParts.length\n  })\n}\n\n/**\n * Deletes a path from an object using dot notation\n */\nfunction deletePath(obj: any, path: string): void {\n  const parts = path.split('.')\n  let current = obj\n\n  for (let i = 0; i < parts.length - 1; i++) {\n    if (!current[parts[i]]) {\n      return\n    }\n    current = current[parts[i]]\n  }\n\n  delete current[parts[parts.length - 1]]\n}\n\n/**\n * Gets value at path using dot notation\n */\nexport function getValueAtPath(obj: any, path: string): any {\n  return path.split('.').reduce((current, part) => current?.[part], obj)\n}\n\n/**\n * Sets value at path using dot notation\n */\nexport function setValueAtPath(obj: any, path: string, value: any): void {\n  const parts = path.split('.')\n  let current = obj\n\n  for (let i = 0; i < parts.length - 1; i++) {\n    if (!current[parts[i]]) {\n      current[parts[i]] = {}\n    }\n    current = current[parts[i]]\n  }\n\n  current[parts[parts.length - 1]] = value\n}\n\n/**\n * Checks if a field is a localized field\n */\nexport function isLocalizedField(field: Field): boolean {\n  return 'localized' in field && field.localized === true\n}\n\n/**\n * Gets all localized field paths from a collection config\n */\nexport function getLocalizedFieldPaths(fields: Field[], parentPath: string = ''): string[] {\n  const paths: string[] = []\n\n  for (const field of fields) {\n    if (!('name' in field)) {\n      continue\n    }\n\n    const fieldPath = parentPath ? `${parentPath}.${field.name}` : field.name\n\n    if (isLocalizedField(field)) {\n      paths.push(fieldPath)\n    }\n\n    // Recursively check nested fields\n    if ('fields' in field && Array.isArray(field.fields)) {\n      paths.push(...getLocalizedFieldPaths(field.fields, fieldPath))\n    }\n\n    // Check blocks\n    if (field.type === 'blocks' && 'blocks' in field && Array.isArray(field.blocks)) {\n      for (const block of field.blocks) {\n        if ('fields' in block && Array.isArray(block.fields)) {\n          paths.push(...getLocalizedFieldPaths(block.fields, fieldPath))\n        }\n      }\n    }\n\n    // Check group fields\n    if (field.type === 'group' && 'fields' in field && Array.isArray(field.fields)) {\n      paths.push(...getLocalizedFieldPaths(field.fields, fieldPath))\n    }\n\n    // Check array fields\n    if (field.type === 'array' && 'fields' in field && Array.isArray(field.fields)) {\n      paths.push(...getLocalizedFieldPaths(field.fields, fieldPath))\n    }\n  }\n\n  return paths\n}\n"],"names":["extractFieldPaths","data","parentPath","fields","paths","key","value","Object","entries","currentPath","push","path","Array","isArray","forEach","item","index","arrayPath","filterExcludedPaths","excludedPaths","length","filtered","JSON","parse","stringify","excludedPath","deletePath","mergeTranslatedData","originalData","translatedData","merged","merge","target","source","fullPath","isPathExcluded","some","startsWith","pathParts","split","excludedParts","i","Math","min","isNaN","Number","obj","parts","current","getValueAtPath","reduce","part","setValueAtPath","isLocalizedField","field","localized","getLocalizedFieldPaths","fieldPath","name","type","blocks","block"],"mappings":"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"}

package/dist/utilities/injectTranslationControls.d.ts

@@ -0,0 +1,5 @@
+import type { Field } from 'payload';
+/**
+ * Recursively injects TranslationControl component into all localized fields
+ */
+export declare function injectTranslationControls(fields: Field[], defaultLocale: string, parentPath?: string): Field[];

package/dist/utilities/injectTranslationControls.js

@@ -0,0 +1,92 @@
+/**
+ * Recursively injects TranslationControl component into all localized fields
+ */ export function injectTranslationControls(fields, defaultLocale, parentPath = '') {
+    return fields.map((field)=>{
+        // Skip fields without names
+        if (!('name' in field)) {
+            return field;
+        }
+        const fieldPath = parentPath ? `${parentPath}.${field.name}` : field.name;
+        // Clone the field to avoid mutations
+        const clonedField = {
+            ...field
+        };
+        // Inject TranslationControl if the field is localized
+        // Skip for container fields - they're just UI/structural, not actual data fields
+        // Only their nested fields should have translation controls
+        const shouldSkipControl = clonedField.type === 'group' || // Groups are containers
+        clonedField.type === 'blocks' || // Blocks are containers
+        clonedField.type === 'array' || // Arrays are containers
+        clonedField.type === 'tabs' // Tabs are UI containers
+        ;
+        if ('localized' in clonedField && clonedField.localized === true && !shouldSkipControl) {
+            // Initialize admin if not present
+            if (!clonedField.admin) {
+                clonedField.admin = {};
+            }
+            // Initialize components if not present
+            if (!clonedField.admin.components) {
+                clonedField.admin.components = {};
+            }
+            // Initialize afterInput if not present
+            if (!clonedField.admin.components.afterInput) {
+                clonedField.admin.components.afterInput = [];
+            }
+            // Ensure afterInput is an array
+            if (!Array.isArray(clonedField.admin.components.afterInput)) {
+                clonedField.admin.components.afterInput = [
+                    clonedField.admin.components.afterInput
+                ];
+            }
+            // Check if TranslationControl is already added
+            const hasTranslationControl = clonedField.admin.components.afterInput.some((component)=>typeof component === 'object' && component.path === '@pigment/auto-translate/client#TranslationControl');
+            // Add TranslationControl if not already present
+            if (!hasTranslationControl) {
+                clonedField.admin.components.afterInput.push({
+                    clientProps: {
+                        defaultLocale,
+                        fieldPath
+                    },
+                    path: '@pigment/auto-translate/client#TranslationControl'
+                });
+            }
+        }
+        // Recursively inject into nested fields
+        if ('fields' in clonedField && Array.isArray(clonedField.fields)) {
+            clonedField.fields = injectTranslationControls(clonedField.fields, defaultLocale, fieldPath);
+        }
+        // Recursively inject into tabs
+        // Note: Tabs fields themselves don't create a path segment
+        // Named tabs (with 'name' property) create their own path segment
+        // Unnamed tabs use the parent path
+        if ('tabs' in clonedField && Array.isArray(clonedField.tabs)) {
+            clonedField.tabs = clonedField.tabs.map((tab)=>{
+                if (tab.fields) {
+                    // If the tab has a name, use it as the path segment
+                    // Otherwise, use the parent path (tabs field itself doesn't create a path)
+                    const tabPath = tab.name ? parentPath ? `${parentPath}.${tab.name}` : tab.name : parentPath;
+                    return {
+                        ...tab,
+                        fields: injectTranslationControls(tab.fields, defaultLocale, tabPath)
+                    };
+                }
+                return tab;
+            });
+        }
+        // Recursively inject into blocks
+        if (clonedField.type === 'blocks' && 'blocks' in clonedField) {
+            clonedField.blocks = clonedField.blocks.map((block)=>{
+                if (block.fields) {
+                    return {
+                        ...block,
+                        fields: injectTranslationControls(block.fields, defaultLocale, fieldPath)
+                    };
+                }
+                return block;
+            });
+        }
+        return clonedField;
+    });
+}
+
+//# sourceMappingURL=injectTranslationControls.js.map

package/dist/utilities/injectTranslationControls.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/injectTranslationControls.ts"],"sourcesContent":["import type { Field } from 'payload'\n\n/**\n * Recursively injects TranslationControl component into all localized fields\n */\nexport function injectTranslationControls(\n  fields: Field[],\n  defaultLocale: string,\n  parentPath: string = '',\n): Field[] {\n  return fields.map((field) => {\n    // Skip fields without names\n    if (!('name' in field)) {\n      return field\n    }\n\n    const fieldPath = parentPath ? `${parentPath}.${field.name}` : field.name\n\n    // Clone the field to avoid mutations\n    const clonedField: any = { ...field }\n\n    // Inject TranslationControl if the field is localized\n    // Skip for container fields - they're just UI/structural, not actual data fields\n    // Only their nested fields should have translation controls\n    const shouldSkipControl =\n      clonedField.type === 'group' ||   // Groups are containers\n      clonedField.type === 'blocks' ||  // Blocks are containers\n      clonedField.type === 'array' ||   // Arrays are containers\n      clonedField.type === 'tabs'       // Tabs are UI containers\n\n    if ('localized' in clonedField && clonedField.localized === true && !shouldSkipControl) {\n      // Initialize admin if not present\n      if (!clonedField.admin) {\n        clonedField.admin = {}\n      }\n\n      // Initialize components if not present\n      if (!clonedField.admin.components) {\n        clonedField.admin.components = {}\n      }\n\n      // Initialize afterInput if not present\n      if (!clonedField.admin.components.afterInput) {\n        clonedField.admin.components.afterInput = []\n      }\n\n      // Ensure afterInput is an array\n      if (!Array.isArray(clonedField.admin.components.afterInput)) {\n        clonedField.admin.components.afterInput = [clonedField.admin.components.afterInput]\n      }\n\n      // Check if TranslationControl is already added\n      const hasTranslationControl = clonedField.admin.components.afterInput.some(\n        (component: any) =>\n          typeof component === 'object' &&\n          component.path === '@pigment/auto-translate/client#TranslationControl',\n      )\n\n      // Add TranslationControl if not already present\n      if (!hasTranslationControl) {\n        clonedField.admin.components.afterInput.push({\n          clientProps: {\n            defaultLocale, // Pass default locale to component\n            fieldPath,\n          },\n          path: '@pigment/auto-translate/client#TranslationControl',\n        })\n      }\n    }\n\n    // Recursively inject into nested fields\n    if ('fields' in clonedField && Array.isArray(clonedField.fields)) {\n      clonedField.fields = injectTranslationControls(clonedField.fields, defaultLocale, fieldPath)\n    }\n\n    // Recursively inject into tabs\n    // Note: Tabs fields themselves don't create a path segment\n    // Named tabs (with 'name' property) create their own path segment\n    // Unnamed tabs use the parent path\n    if ('tabs' in clonedField && Array.isArray(clonedField.tabs)) {\n      clonedField.tabs = clonedField.tabs.map((tab: any) => {\n        if (tab.fields) {\n          // If the tab has a name, use it as the path segment\n          // Otherwise, use the parent path (tabs field itself doesn't create a path)\n          const tabPath = tab.name \n            ? (parentPath ? `${parentPath}.${tab.name}` : tab.name)\n            : parentPath\n          \n          return {\n            ...tab,\n            fields: injectTranslationControls(tab.fields, defaultLocale, tabPath),\n          }\n        }\n        return tab\n      })\n    }\n\n    // Recursively inject into blocks\n    if (clonedField.type === 'blocks' && 'blocks' in clonedField) {\n      clonedField.blocks = clonedField.blocks.map((block: any) => {\n        if (block.fields) {\n          return {\n            ...block,\n            fields: injectTranslationControls(block.fields, defaultLocale, fieldPath),\n          }\n        }\n        return block\n      })\n    }\n\n    return clonedField as Field\n  })\n}\n"],"names":["injectTranslationControls","fields","defaultLocale","parentPath","map","field","fieldPath","name","clonedField","shouldSkipControl","type","localized","admin","components","afterInput","Array","isArray","hasTranslationControl","some","component","path","push","clientProps","tabs","tab","tabPath","blocks","block"],"mappings":"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"}

package/package.json

@@ -0,0 +1,114 @@
+{
+  "name": "@pigment/auto-translate",
+  "version": "1.2.0",
+  "description": "Automatic translation plugin for Payload CMS with field-level exclusion controls and performance optimizations",
+  "keywords": [
+    "payload",
+    "payload-plugin",
+    "payloadcms",
+    "translation",
+    "auto-translate",
+    "i18n",
+    "localization",
+    "openai",
+    "gpt"
+  ],
+  "author": {
+    "name": "Team Pigment",
+    "email": "dev@pigment.se",
+    "url": "https://pigment.se"
+  },
+  "homepage": "https://pigment.se",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pigment-se/auto-translate"
+  },
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./client": {
+      "import": "./dist/exports/client.js",
+      "types": "./dist/exports/client.d.ts",
+      "default": "./dist/exports/client.js"
+    },
+    "./rsc": {
+      "import": "./dist/exports/rsc.js",
+      "types": "./dist/exports/rsc.d.ts",
+      "default": "./dist/exports/rsc.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "@eslint/eslintrc": "^3.2.0",
+    "@payloadcms/db-mongodb": "3.37.0",
+    "@payloadcms/db-postgres": "3.37.0",
+    "@payloadcms/db-sqlite": "3.37.0",
+    "@payloadcms/eslint-config": "3.9.0",
+    "@payloadcms/next": "3.37.0",
+    "@payloadcms/richtext-lexical": "3.37.0",
+    "@payloadcms/ui": "3.37.0",
+    "@playwright/test": "^1.52.0",
+    "@swc-node/register": "1.10.9",
+    "@swc/cli": "0.6.0",
+    "@types/node": "^22.5.4",
+    "@types/react": "19.1.8",
+    "@types/react-dom": "19.1.6",
+    "copyfiles": "2.4.1",
+    "cross-env": "^7.0.3",
+    "eslint": "^9.23.0",
+    "eslint-config-next": "15.4.4",
+    "graphql": "^16.8.1",
+    "mongodb-memory-server": "10.1.4",
+    "next": "15.4.4",
+    "open": "^10.1.0",
+    "payload": "3.37.0",
+    "prettier": "^3.4.2",
+    "qs-esm": "7.0.2",
+    "react": "19.1.0",
+    "react-dom": "19.1.0",
+    "rimraf": "3.0.2",
+    "sharp": "0.34.2",
+    "sort-package-json": "^2.10.0",
+    "typescript": "5.7.3",
+    "vite-tsconfig-paths": "^5.1.4",
+    "vitest": "^3.1.2"
+  },
+  "peerDependencies": {
+    "payload": "^3.37.0"
+  },
+  "engines": {
+    "node": "^18.20.2 || >=20.9.0",
+    "pnpm": "^9 || ^10"
+  },
+  "registry": "https://registry.npmjs.org/",
+  "dependencies": {
+    "openai": "^6.8.0"
+  },
+  "scripts": {
+    "build": "pnpm copyfiles && pnpm build:types && pnpm build:swc",
+    "build:swc": "swc ./src -d ./dist --config-file .swcrc --strip-leading-paths",
+    "build:types": "tsc --outDir dist --rootDir ./src",
+    "clean": "rimraf {dist,*.tsbuildinfo}",
+    "copyfiles": "copyfiles -u 1 \"src/**/*.{html,css,scss,ttf,woff,woff2,eot,svg,jpg,png,json}\" dist/",
+    "dev": "next dev dev --turbo",
+    "dev:generate-importmap": "pnpm dev:payload generate:importmap",
+    "dev:generate-types": "pnpm dev:payload generate:types",
+    "dev:payload": "cross-env PAYLOAD_CONFIG_PATH=./dev/payload.config.ts payload",
+    "generate:importmap": "pnpm dev:generate-importmap",
+    "generate:types": "pnpm dev:generate-types",
+    "lint": "eslint",
+    "lint:fix": "eslint ./src --fix",
+    "test": "pnpm test:int && pnpm test:e2e",
+    "test:e2e": "playwright test",
+    "test:int": "vitest"
+  }
+}