@depup/payload 3.79.1-depup.0

package/dist/utilities/dynamicImport.js

@@ -0,0 +1,24 @@
+import path from 'path';
+import { pathToFileURL } from 'url';
+/**
+ * Dynamically imports a module from a file path or module specifier.
+ *
+ * Uses a direct `import()` in Vitest (where eval'd imports fail with ERR_VM_DYNAMIC_IMPORT_CALLBACK_MISSING),
+ * and `eval(`import(...)`)` elsewhere to hide the import from Next.js bundler static analysis.
+ *
+ * @param modulePathOrSpecifier - Either an absolute file path or a module specifier (package name)
+ */ export async function dynamicImport(modulePathOrSpecifier) {
+    // Convert absolute file paths to file:// URLs, but leave package specifiers as-is
+    const importPath = path.isAbsolute(modulePathOrSpecifier) ? pathToFileURL(modulePathOrSpecifier).href : modulePathOrSpecifier;
+    // Vitest runs tests in a VM context where eval'd dynamic imports fail with
+    // ERR_VM_DYNAMIC_IMPORT_CALLBACK_MISSING. Use direct import in test environment.
+    if (process.env.VITEST) {
+        return await import(/* webpackIgnore: true */ importPath);
+    }
+    // Without the eval, the Next.js bundler will throw this error when encountering the import statement:
+    // ⚠ Compiled with warnings in X.Xs
+    // Critical dependency: the request of a dependency is an expression
+    return await eval(`import('${importPath}')`);
+}
+
+//# sourceMappingURL=dynamicImport.js.map

package/dist/utilities/dynamicImport.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/dynamicImport.ts"],"sourcesContent":["import path from 'path'\nimport { pathToFileURL } from 'url'\n\n/**\n * Dynamically imports a module from a file path or module specifier.\n *\n * Uses a direct `import()` in Vitest (where eval'd imports fail with ERR_VM_DYNAMIC_IMPORT_CALLBACK_MISSING),\n * and `eval(`import(...)`)` elsewhere to hide the import from Next.js bundler static analysis.\n *\n * @param modulePathOrSpecifier - Either an absolute file path or a module specifier (package name)\n */\nexport async function dynamicImport<T = unknown>(modulePathOrSpecifier: string): Promise<T> {\n  // Convert absolute file paths to file:// URLs, but leave package specifiers as-is\n  const importPath = path.isAbsolute(modulePathOrSpecifier)\n    ? pathToFileURL(modulePathOrSpecifier).href\n    : modulePathOrSpecifier\n\n  // Vitest runs tests in a VM context where eval'd dynamic imports fail with\n  // ERR_VM_DYNAMIC_IMPORT_CALLBACK_MISSING. Use direct import in test environment.\n  if (process.env.VITEST) {\n    return await import(/* webpackIgnore: true */ importPath)\n  }\n\n  // Without the eval, the Next.js bundler will throw this error when encountering the import statement:\n  // ⚠ Compiled with warnings in X.Xs\n  // Critical dependency: the request of a dependency is an expression\n  return await eval(`import('${importPath}')`)\n}\n"],"names":["path","pathToFileURL","dynamicImport","modulePathOrSpecifier","importPath","isAbsolute","href","process","env","VITEST","eval"],"mappings":"AAAA,OAAOA,UAAU,OAAM;AACvB,SAASC,aAAa,QAAQ,MAAK;AAEnC;;;;;;;CAOC,GACD,OAAO,eAAeC,cAA2BC,qBAA6B;IAC5E,kFAAkF;IAClF,MAAMC,aAAaJ,KAAKK,UAAU,CAACF,yBAC/BF,cAAcE,uBAAuBG,IAAI,GACzCH;IAEJ,2EAA2E;IAC3E,iFAAiF;IACjF,IAAII,QAAQC,GAAG,CAACC,MAAM,EAAE;QACtB,OAAO,MAAM,MAAM,CAAC,uBAAuB,GAAGL;IAChD;IAEA,sGAAsG;IACtG,mCAAmC;IACnC,oEAAoE;IACpE,OAAO,MAAMM,KAAK,CAAC,QAAQ,EAAEN,WAAW,EAAE,CAAC;AAC7C"}

package/dist/utilities/escapeRegExp.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Escapes special characters in a string for use in a regular expression
+ * @param string - The string to escape
+ * @returns The escaped string safe for use in RegExp
+ */
+export declare const escapeRegExp: (string: string) => string;
+//# sourceMappingURL=escapeRegExp.d.ts.map

package/dist/utilities/escapeRegExp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escapeRegExp.d.ts","sourceRoot":"","sources":["../../src/utilities/escapeRegExp.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,YAAY,WAAY,MAAM,KAAG,MACC,CAAA"}

package/dist/utilities/escapeRegExp.js

@@ -0,0 +1,7 @@
+/**
+ * Escapes special characters in a string for use in a regular expression
+ * @param string - The string to escape
+ * @returns The escaped string safe for use in RegExp
+ */ export const escapeRegExp = (string)=>string.replace(/[\\^$*+?.()|[\]{}]/g, '\\$&');
+
+//# sourceMappingURL=escapeRegExp.js.map

package/dist/utilities/escapeRegExp.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/escapeRegExp.ts"],"sourcesContent":["/**\n * Escapes special characters in a string for use in a regular expression\n * @param string - The string to escape\n * @returns The escaped string safe for use in RegExp\n */\nexport const escapeRegExp = (string: string): string =>\n  string.replace(/[\\\\^$*+?.()|[\\]{}]/g, '\\\\$&')\n"],"names":["escapeRegExp","string","replace"],"mappings":"AAAA;;;;CAIC,GACD,OAAO,MAAMA,eAAe,CAACC,SAC3BA,OAAOC,OAAO,CAAC,uBAAuB,QAAO"}

package/dist/utilities/extractID.d.ts

@@ -0,0 +1,4 @@
+export declare const extractID: <IDType extends number | string>(objectOrID: {
+    id: IDType;
+} | IDType) => IDType;
+//# sourceMappingURL=extractID.d.ts.map

package/dist/utilities/extractID.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractID.d.ts","sourceRoot":"","sources":["../../src/utilities/extractID.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS,GAAI,MAAM,SAAS,MAAM,GAAG,MAAM,cAC1C;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,KAClC,MAMF,CAAA"}

package/dist/utilities/extractID.js

@@ -0,0 +1,8 @@
+export const extractID = (objectOrID)=>{
+    if (typeof objectOrID === 'string' || typeof objectOrID === 'number') {
+        return objectOrID;
+    }
+    return objectOrID.id;
+};
+
+//# sourceMappingURL=extractID.js.map

package/dist/utilities/extractID.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/extractID.ts"],"sourcesContent":["export const extractID = <IDType extends number | string>(\n  objectOrID: { id: IDType } | IDType,\n): IDType => {\n  if (typeof objectOrID === 'string' || typeof objectOrID === 'number') {\n    return objectOrID\n  }\n\n  return objectOrID.id\n}\n"],"names":["extractID","objectOrID","id"],"mappings":"AAAA,OAAO,MAAMA,YAAY,CACvBC;IAEA,IAAI,OAAOA,eAAe,YAAY,OAAOA,eAAe,UAAU;QACpE,OAAOA;IACT;IAEA,OAAOA,WAAWC,EAAE;AACtB,EAAC"}

package/dist/utilities/filterDataToSelectedLocales.d.ts

@@ -0,0 +1,19 @@
+import type { Field } from '../fields/config/types.js';
+import type { SanitizedConfig } from '../index.js';
+import type { JsonObject } from '../types/index.js';
+type FilterDataToSelectedLocalesArgs = {
+    configBlockReferences: SanitizedConfig['blocks'];
+    docWithLocales: JsonObject;
+    fields: Field[];
+    parentIsLocalized?: boolean;
+    selectedLocales: string[];
+};
+/**
+ * Filters localized field data to only include specified locales.
+ * For non-localized fields, returns all data as-is.
+ * For localized fields, if selectedLocales is provided, returns only those locales.
+ * If selectedLocales is not provided and field is localized, returns all locales.
+ */
+export declare function filterDataToSelectedLocales({ configBlockReferences, docWithLocales, fields, parentIsLocalized, selectedLocales, }: FilterDataToSelectedLocalesArgs): JsonObject;
+export {};
+//# sourceMappingURL=filterDataToSelectedLocales.d.ts.map

package/dist/utilities/filterDataToSelectedLocales.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filterDataToSelectedLocales.d.ts","sourceRoot":"","sources":["../../src/utilities/filterDataToSelectedLocales.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAS,KAAK,EAAkB,MAAM,2BAA2B,CAAA;AAC7E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAInD,KAAK,+BAA+B,GAAG;IACrC,qBAAqB,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAA;IAChD,cAAc,EAAE,UAAU,CAAA;IAC1B,MAAM,EAAE,KAAK,EAAE,CAAA;IACf,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,eAAe,EAAE,MAAM,EAAE,CAAA;CAC1B,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,EAC1C,qBAAqB,EACrB,cAAc,EACd,MAAM,EACN,iBAAyB,EACzB,eAAe,GAChB,EAAE,+BAA+B,GAAG,UAAU,CA8K9C"}

package/dist/utilities/filterDataToSelectedLocales.js

@@ -0,0 +1,173 @@
+import { fieldAffectsData, fieldShouldBeLocalized, tabHasName } from '../fields/config/types.js';
+/**
+ * Filters localized field data to only include specified locales.
+ * For non-localized fields, returns all data as-is.
+ * For localized fields, if selectedLocales is provided, returns only those locales.
+ * If selectedLocales is not provided and field is localized, returns all locales.
+ */ export function filterDataToSelectedLocales({ configBlockReferences, docWithLocales, fields, parentIsLocalized = false, selectedLocales }) {
+    if (!docWithLocales || typeof docWithLocales !== 'object') {
+        return docWithLocales;
+    }
+    const result = {};
+    for (const field of fields){
+        if (fieldAffectsData(field)) {
+            const fieldIsLocalized = fieldShouldBeLocalized({
+                field,
+                parentIsLocalized
+            });
+            switch(field.type){
+                case 'array':
+                    {
+                        if (Array.isArray(docWithLocales[field.name])) {
+                            result[field.name] = docWithLocales[field.name].map((item)=>filterDataToSelectedLocales({
+                                    configBlockReferences,
+                                    docWithLocales: item,
+                                    fields: field.fields,
+                                    parentIsLocalized: fieldIsLocalized,
+                                    selectedLocales
+                                }));
+                        }
+                        break;
+                    }
+                case 'blocks':
+                    {
+                        if (field.name in docWithLocales && Array.isArray(docWithLocales[field.name])) {
+                            result[field.name] = docWithLocales[field.name].map((blockData)=>{
+                                let block;
+                                if (configBlockReferences && field.blockReferences) {
+                                    for (const blockOrReference of field.blockReferences){
+                                        if (typeof blockOrReference === 'string') {
+                                            block = configBlockReferences.find((b)=>b.slug === blockData.blockType);
+                                        } else {
+                                            block = blockOrReference;
+                                        }
+                                    }
+                                } else if (field.blocks) {
+                                    block = field.blocks.find((b)=>b.slug === blockData.blockType);
+                                }
+                                if (block) {
+                                    const filtered = filterDataToSelectedLocales({
+                                        configBlockReferences,
+                                        docWithLocales: blockData,
+                                        fields: block?.fields || [],
+                                        parentIsLocalized: fieldIsLocalized,
+                                        selectedLocales
+                                    });
+                                    // blockType, id, blockName are set by Payload internally
+                                    // and not part of block.fields, so they must be preserved explicitly
+                                    filtered.blockType = blockData.blockType;
+                                    filtered.id = blockData.id;
+                                    filtered.blockName = blockData.blockName;
+                                    return filtered;
+                                }
+                                return blockData;
+                            });
+                        }
+                        break;
+                    }
+                case 'group':
+                    {
+                        // Named groups create a nested data structure
+                        if (fieldAffectsData(field) && field.name in docWithLocales && typeof docWithLocales[field.name] === 'object') {
+                            result[field.name] = filterDataToSelectedLocales({
+                                configBlockReferences,
+                                docWithLocales: docWithLocales[field.name],
+                                fields: field.fields,
+                                parentIsLocalized: fieldIsLocalized,
+                                selectedLocales
+                            });
+                        } else {
+                            // Unnamed groups pass through the same data level
+                            const nestedResult = filterDataToSelectedLocales({
+                                configBlockReferences,
+                                docWithLocales,
+                                fields: field.fields,
+                                parentIsLocalized,
+                                selectedLocales
+                            });
+                            Object.assign(result, nestedResult);
+                        }
+                        break;
+                    }
+                default:
+                    {
+                        // For all other data-affecting fields (text, number, select, etc.)
+                        if (field.name in docWithLocales) {
+                            const value = docWithLocales[field.name];
+                            // If the field is localized and has locale data
+                            if (fieldIsLocalized && value && typeof value === 'object' && !Array.isArray(value)) {
+                                // If selectedLocales is provided, filter to only those locales
+                                if (selectedLocales && selectedLocales.length > 0) {
+                                    const filtered = {};
+                                    for (const locale of selectedLocales){
+                                        if (locale in value) {
+                                            filtered[locale] = value[locale];
+                                        }
+                                    }
+                                    if (Object.keys(filtered).length > 0) {
+                                        result[field.name] = filtered;
+                                    }
+                                } else {
+                                    // If no selectedLocales, include all locales
+                                    result[field.name] = value;
+                                }
+                            } else {
+                                // Non-localized field or non-object value
+                                result[field.name] = value;
+                            }
+                        }
+                        break;
+                    }
+            }
+        } else {
+            // Layout-only fields that don't affect data structure
+            switch(field.type){
+                case 'collapsible':
+                case 'row':
+                    {
+                        // These pass through the same data level
+                        const nestedResult = filterDataToSelectedLocales({
+                            configBlockReferences,
+                            docWithLocales,
+                            fields: field.fields,
+                            parentIsLocalized,
+                            selectedLocales
+                        });
+                        Object.assign(result, nestedResult);
+                        break;
+                    }
+                case 'tabs':
+                    {
+                        for (const tab of field.tabs){
+                            if (tabHasName(tab)) {
+                                // Named tabs create a nested data structure
+                                if (tab.name in docWithLocales && typeof docWithLocales[tab.name] === 'object') {
+                                    result[tab.name] = filterDataToSelectedLocales({
+                                        configBlockReferences,
+                                        docWithLocales: docWithLocales[tab.name],
+                                        fields: tab.fields,
+                                        parentIsLocalized,
+                                        selectedLocales
+                                    });
+                                }
+                            } else {
+                                // Unnamed tabs pass through the same data level
+                                const nestedResult = filterDataToSelectedLocales({
+                                    configBlockReferences,
+                                    docWithLocales,
+                                    fields: tab.fields,
+                                    parentIsLocalized,
+                                    selectedLocales
+                                });
+                                Object.assign(result, nestedResult);
+                            }
+                        }
+                        break;
+                    }
+            }
+        }
+    }
+    return result;
+}
+
+//# sourceMappingURL=filterDataToSelectedLocales.js.map

package/dist/utilities/filterDataToSelectedLocales.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/filterDataToSelectedLocales.ts"],"sourcesContent":["import type { Block, Field, FlattenedBlock } from '../fields/config/types.js'\nimport type { SanitizedConfig } from '../index.js'\nimport type { JsonObject } from '../types/index.js'\n\nimport { fieldAffectsData, fieldShouldBeLocalized, tabHasName } from '../fields/config/types.js'\n\ntype FilterDataToSelectedLocalesArgs = {\n  configBlockReferences: SanitizedConfig['blocks']\n  docWithLocales: JsonObject\n  fields: Field[]\n  parentIsLocalized?: boolean\n  selectedLocales: string[]\n}\n\n/**\n * Filters localized field data to only include specified locales.\n * For non-localized fields, returns all data as-is.\n * For localized fields, if selectedLocales is provided, returns only those locales.\n * If selectedLocales is not provided and field is localized, returns all locales.\n */\nexport function filterDataToSelectedLocales({\n  configBlockReferences,\n  docWithLocales,\n  fields,\n  parentIsLocalized = false,\n  selectedLocales,\n}: FilterDataToSelectedLocalesArgs): JsonObject {\n  if (!docWithLocales || typeof docWithLocales !== 'object') {\n    return docWithLocales\n  }\n\n  const result: JsonObject = {}\n\n  for (const field of fields) {\n    if (fieldAffectsData(field)) {\n      const fieldIsLocalized = fieldShouldBeLocalized({ field, parentIsLocalized })\n\n      switch (field.type) {\n        case 'array': {\n          if (Array.isArray(docWithLocales[field.name])) {\n            result[field.name] = docWithLocales[field.name].map((item: JsonObject) =>\n              filterDataToSelectedLocales({\n                configBlockReferences,\n                docWithLocales: item,\n                fields: field.fields,\n                parentIsLocalized: fieldIsLocalized,\n                selectedLocales,\n              }),\n            )\n          }\n          break\n        }\n\n        case 'blocks': {\n          if (field.name in docWithLocales && Array.isArray(docWithLocales[field.name])) {\n            result[field.name] = docWithLocales[field.name].map((blockData: JsonObject) => {\n              let block: Block | FlattenedBlock | undefined\n              if (configBlockReferences && field.blockReferences) {\n                for (const blockOrReference of field.blockReferences) {\n                  if (typeof blockOrReference === 'string') {\n                    block = configBlockReferences.find((b) => b.slug === blockData.blockType)\n                  } else {\n                    block = blockOrReference\n                  }\n                }\n              } else if (field.blocks) {\n                block = field.blocks.find((b) => b.slug === blockData.blockType)\n              }\n\n              if (block) {\n                const filtered = filterDataToSelectedLocales({\n                  configBlockReferences,\n                  docWithLocales: blockData,\n                  fields: block?.fields || [],\n                  parentIsLocalized: fieldIsLocalized,\n                  selectedLocales,\n                })\n\n                // blockType, id, blockName are set by Payload internally\n                // and not part of block.fields, so they must be preserved explicitly\n                filtered.blockType = blockData.blockType\n                filtered.id = blockData.id\n                filtered.blockName = blockData.blockName\n\n                return filtered\n              }\n\n              return blockData\n            })\n          }\n          break\n        }\n\n        case 'group': {\n          // Named groups create a nested data structure\n          if (\n            fieldAffectsData(field) &&\n            field.name in docWithLocales &&\n            typeof docWithLocales[field.name] === 'object'\n          ) {\n            result[field.name] = filterDataToSelectedLocales({\n              configBlockReferences,\n              docWithLocales: docWithLocales[field.name] as JsonObject,\n              fields: field.fields,\n              parentIsLocalized: fieldIsLocalized,\n              selectedLocales,\n            })\n          } else {\n            // Unnamed groups pass through the same data level\n            const nestedResult = filterDataToSelectedLocales({\n              configBlockReferences,\n              docWithLocales,\n              fields: field.fields,\n              parentIsLocalized,\n              selectedLocales,\n            })\n            Object.assign(result, nestedResult)\n          }\n          break\n        }\n\n        default: {\n          // For all other data-affecting fields (text, number, select, etc.)\n          if (field.name in docWithLocales) {\n            const value = docWithLocales[field.name]\n\n            // If the field is localized and has locale data\n            if (fieldIsLocalized && value && typeof value === 'object' && !Array.isArray(value)) {\n              // If selectedLocales is provided, filter to only those locales\n              if (selectedLocales && selectedLocales.length > 0) {\n                const filtered: Record<string, unknown> = {}\n                for (const locale of selectedLocales) {\n                  if (locale in value) {\n                    filtered[locale] = value[locale]\n                  }\n                }\n                if (Object.keys(filtered).length > 0) {\n                  result[field.name] = filtered\n                }\n              } else {\n                // If no selectedLocales, include all locales\n                result[field.name] = value\n              }\n            } else {\n              // Non-localized field or non-object value\n              result[field.name] = value\n            }\n          }\n          break\n        }\n      }\n    } else {\n      // Layout-only fields that don't affect data structure\n      switch (field.type) {\n        case 'collapsible':\n        case 'row': {\n          // These pass through the same data level\n          const nestedResult = filterDataToSelectedLocales({\n            configBlockReferences,\n            docWithLocales,\n            fields: field.fields,\n            parentIsLocalized,\n            selectedLocales,\n          })\n          Object.assign(result, nestedResult)\n          break\n        }\n\n        case 'tabs': {\n          for (const tab of field.tabs) {\n            if (tabHasName(tab)) {\n              // Named tabs create a nested data structure\n              if (tab.name in docWithLocales && typeof docWithLocales[tab.name] === 'object') {\n                result[tab.name] = filterDataToSelectedLocales({\n                  configBlockReferences,\n                  docWithLocales: docWithLocales[tab.name],\n                  fields: tab.fields,\n                  parentIsLocalized,\n                  selectedLocales,\n                })\n              }\n            } else {\n              // Unnamed tabs pass through the same data level\n              const nestedResult = filterDataToSelectedLocales({\n                configBlockReferences,\n                docWithLocales,\n                fields: tab.fields,\n                parentIsLocalized,\n                selectedLocales,\n              })\n              Object.assign(result, nestedResult)\n            }\n          }\n          break\n        }\n      }\n    }\n  }\n\n  return result\n}\n"],"names":["fieldAffectsData","fieldShouldBeLocalized","tabHasName","filterDataToSelectedLocales","configBlockReferences","docWithLocales","fields","parentIsLocalized","selectedLocales","result","field","fieldIsLocalized","type","Array","isArray","name","map","item","blockData","block","blockReferences","blockOrReference","find","b","slug","blockType","blocks","filtered","id","blockName","nestedResult","Object","assign","value","length","locale","keys","tab","tabs"],"mappings":"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"}

package/dist/utilities/filterDataToSelectedLocales.spec.js

@@ -0,0 +1,193 @@
+import { describe, expect, it } from 'vitest';
+import { filterDataToSelectedLocales } from './filterDataToSelectedLocales.js';
+describe('filterDataToSelectedLocales', ()=>{
+    const selectedLocales = [
+        'en'
+    ];
+    const configBlockReferences = [];
+    describe('block metadata preservation', ()=>{
+        it('should preserve blockType, id, and blockName on non-localized blocks', ()=>{
+            const fields = [
+                {
+                    name: 'layout',
+                    type: 'blocks',
+                    blocks: [
+                        {
+                            slug: 'content',
+                            fields: [
+                                {
+                                    name: 'richText',
+                                    type: 'richText',
+                                    localized: true
+                                }
+                            ]
+                        }
+                    ]
+                }
+            ];
+            const docWithLocales = {
+                layout: [
+                    {
+                        blockType: 'content',
+                        id: 'abc123',
+                        blockName: 'My Block',
+                        richText: {
+                            en: 'English',
+                            es: 'Spanish'
+                        }
+                    }
+                ]
+            };
+            const result = filterDataToSelectedLocales({
+                configBlockReferences: [],
+                docWithLocales,
+                fields,
+                selectedLocales
+            });
+            expect(result.layout).toHaveLength(1);
+            expect(result.layout[0].blockType).toBe('content');
+            expect(result.layout[0].id).toBe('abc123');
+            expect(result.layout[0].blockName).toBe('My Block');
+            expect(result.layout[0].richText).toEqual({
+                en: 'English'
+            });
+        });
+        it('should preserve blockType and id when block has no blockName', ()=>{
+            const fields = [
+                {
+                    name: 'layout',
+                    type: 'blocks',
+                    blocks: [
+                        {
+                            slug: 'text',
+                            fields: [
+                                {
+                                    name: 'text',
+                                    type: 'text',
+                                    localized: true
+                                }
+                            ]
+                        }
+                    ]
+                }
+            ];
+            const docWithLocales = {
+                layout: [
+                    {
+                        blockType: 'text',
+                        id: 'def456',
+                        text: {
+                            en: 'English',
+                            es: 'Spanish'
+                        }
+                    }
+                ]
+            };
+            const result = filterDataToSelectedLocales({
+                configBlockReferences: [],
+                docWithLocales,
+                fields,
+                selectedLocales
+            });
+            expect(result.layout).toHaveLength(1);
+            expect(result.layout[0].blockType).toBe('text');
+            expect(result.layout[0].id).toBe('def456');
+            expect(result.layout[0].text).toEqual({
+                en: 'English'
+            });
+        });
+        it('should preserve blockType and id with configBlockReferences', ()=>{
+            const fields = [
+                {
+                    name: 'layout',
+                    type: 'blocks',
+                    blocks: [],
+                    blockReferences: [
+                        'content'
+                    ]
+                }
+            ];
+            const result = filterDataToSelectedLocales({
+                configBlockReferences: [
+                    {
+                        slug: 'content',
+                        fields: [
+                            {
+                                name: 'body',
+                                type: 'text',
+                                localized: true
+                            }
+                        ]
+                    }
+                ],
+                docWithLocales: {
+                    layout: [
+                        {
+                            blockType: 'content',
+                            id: 'ref123',
+                            body: {
+                                en: 'English',
+                                es: 'Spanish'
+                            }
+                        }
+                    ]
+                },
+                fields,
+                selectedLocales
+            });
+            expect(result.layout).toHaveLength(1);
+            expect(result.layout[0].blockType).toBe('content');
+            expect(result.layout[0].id).toBe('ref123');
+            expect(result.layout[0].body).toEqual({
+                en: 'English'
+            });
+        });
+    });
+    describe('simple fields', ()=>{
+        it('should filter localized field values to selected locales', ()=>{
+            const fields = [
+                {
+                    name: 'title',
+                    type: 'text',
+                    localized: true
+                }
+            ];
+            const docWithLocales = {
+                title: {
+                    en: 'English Title',
+                    es: 'Spanish Title',
+                    de: 'German Title'
+                }
+            };
+            const result = filterDataToSelectedLocales({
+                configBlockReferences: [],
+                docWithLocales,
+                fields,
+                selectedLocales
+            });
+            expect(result.title).toEqual({
+                en: 'English Title'
+            });
+        });
+        it('should pass through non-localized fields as-is', ()=>{
+            const fields = [
+                {
+                    name: 'slug',
+                    type: 'text'
+                }
+            ];
+            const docWithLocales = {
+                slug: 'my-slug'
+            };
+            const result = filterDataToSelectedLocales({
+                configBlockReferences: [],
+                docWithLocales,
+                fields,
+                selectedLocales
+            });
+            expect(result.slug).toBe('my-slug');
+        });
+    });
+});
+
+//# sourceMappingURL=filterDataToSelectedLocales.spec.js.map

package/dist/utilities/filterDataToSelectedLocales.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utilities/filterDataToSelectedLocales.spec.ts"],"sourcesContent":["import type { Field } from '../fields/config/types.js'\n\nimport { describe, expect, it } from 'vitest'\n\nimport { filterDataToSelectedLocales } from './filterDataToSelectedLocales.js'\n\ndescribe('filterDataToSelectedLocales', () => {\n  const selectedLocales = ['en']\n  const configBlockReferences = []\n\n  describe('block metadata preservation', () => {\n    it('should preserve blockType, id, and blockName on non-localized blocks', () => {\n      const fields: Field[] = [\n        {\n          name: 'layout',\n          type: 'blocks',\n          blocks: [\n            {\n              slug: 'content',\n              fields: [\n                {\n                  name: 'richText',\n                  type: 'richText',\n                  localized: true,\n                },\n              ],\n            },\n          ],\n        },\n      ]\n\n      const docWithLocales = {\n        layout: [\n          {\n            blockType: 'content',\n            id: 'abc123',\n            blockName: 'My Block',\n            richText: { en: 'English', es: 'Spanish' },\n          },\n        ],\n      }\n\n      const result = filterDataToSelectedLocales({\n        configBlockReferences: [],\n        docWithLocales,\n        fields,\n        selectedLocales,\n      })\n\n      expect(result.layout).toHaveLength(1)\n      expect(result.layout[0].blockType).toBe('content')\n      expect(result.layout[0].id).toBe('abc123')\n      expect(result.layout[0].blockName).toBe('My Block')\n      expect(result.layout[0].richText).toEqual({ en: 'English' })\n    })\n\n    it('should preserve blockType and id when block has no blockName', () => {\n      const fields: Field[] = [\n        {\n          name: 'layout',\n          type: 'blocks',\n          blocks: [\n            {\n              slug: 'text',\n              fields: [\n                {\n                  name: 'text',\n                  type: 'text',\n                  localized: true,\n                },\n              ],\n            },\n          ],\n        },\n      ]\n\n      const docWithLocales = {\n        layout: [\n          {\n            blockType: 'text',\n            id: 'def456',\n            text: { en: 'English', es: 'Spanish' },\n          },\n        ],\n      }\n\n      const result = filterDataToSelectedLocales({\n        configBlockReferences: [],\n        docWithLocales,\n        fields,\n        selectedLocales,\n      })\n\n      expect(result.layout).toHaveLength(1)\n      expect(result.layout[0].blockType).toBe('text')\n      expect(result.layout[0].id).toBe('def456')\n      expect(result.layout[0].text).toEqual({ en: 'English' })\n    })\n\n    it('should preserve blockType and id with configBlockReferences', () => {\n      const fields: Field[] = [\n        {\n          name: 'layout',\n          type: 'blocks',\n          blocks: [],\n          blockReferences: ['content'],\n        },\n      ]\n\n      const result = filterDataToSelectedLocales({\n        configBlockReferences: [\n          {\n            slug: 'content',\n            fields: [\n              {\n                name: 'body',\n                type: 'text',\n                localized: true,\n              },\n            ],\n          },\n        ],\n        docWithLocales: {\n          layout: [\n            {\n              blockType: 'content',\n              id: 'ref123',\n              body: { en: 'English', es: 'Spanish' },\n            },\n          ],\n        },\n        fields,\n        selectedLocales,\n      })\n\n      expect(result.layout).toHaveLength(1)\n      expect(result.layout[0].blockType).toBe('content')\n      expect(result.layout[0].id).toBe('ref123')\n      expect(result.layout[0].body).toEqual({ en: 'English' })\n    })\n  })\n\n  describe('simple fields', () => {\n    it('should filter localized field values to selected locales', () => {\n      const fields: Field[] = [\n        {\n          name: 'title',\n          type: 'text',\n          localized: true,\n        },\n      ]\n\n      const docWithLocales = {\n        title: {\n          en: 'English Title',\n          es: 'Spanish Title',\n          de: 'German Title',\n        },\n      }\n\n      const result = filterDataToSelectedLocales({\n        configBlockReferences: [],\n        docWithLocales,\n        fields,\n        selectedLocales,\n      })\n\n      expect(result.title).toEqual({ en: 'English Title' })\n    })\n\n    it('should pass through non-localized fields as-is', () => {\n      const fields: Field[] = [\n        {\n          name: 'slug',\n          type: 'text',\n        },\n      ]\n\n      const docWithLocales = {\n        slug: 'my-slug',\n      }\n\n      const result = filterDataToSelectedLocales({\n        configBlockReferences: [],\n        docWithLocales,\n        fields,\n        selectedLocales,\n      })\n\n      expect(result.slug).toBe('my-slug')\n    })\n  })\n})\n"],"names":["describe","expect","it","filterDataToSelectedLocales","selectedLocales","configBlockReferences","fields","name","type","blocks","slug","localized","docWithLocales","layout","blockType","id","blockName","richText","en","es","result","toHaveLength","toBe","toEqual","text","blockReferences","body","title","de"],"mappings":"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"}

package/dist/utilities/findUp.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Synchronously walks up parent directories until a condition is met and/or one of the file names within the fileNames array is found.
+ */
+export declare function findUpSync({ condition, dir, fileNames, }: {
+    condition?: (dir: string) => boolean | Promise<boolean | string> | string;
+    dir: string;
+    fileNames?: string[];
+}): null | string;
+/**
+ * Asynchronously walks up parent directories until a condition is met and/or one of the file names within the fileNames array is found.
+ */
+export declare function findUp({ condition, dir, fileNames, }: {
+    condition?: (dir: string) => boolean | Promise<boolean | string> | string;
+    dir: string;
+    fileNames?: string[];
+}): Promise<null | string>;
+export declare function pathExistsAndIsAccessibleSync(path: string): boolean;
+export declare function pathExistsAndIsAccessible(path: string): Promise<boolean>;
+//# sourceMappingURL=findUp.d.ts.map

package/dist/utilities/findUp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findUp.d.ts","sourceRoot":"","sources":["../../src/utilities/findUp.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAgB,UAAU,CAAC,EACzB,SAAS,EACT,GAAG,EACH,SAAS,GACV,EAAE;IACD,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC,GAAG,MAAM,CAAA;IACzE,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;CACrB,GAAG,IAAI,GAAG,MAAM,CAkChB;AAED;;GAEG;AACH,wBAAsB,MAAM,CAAC,EAC3B,SAAS,EACT,GAAG,EACH,SAAS,GACV,EAAE;IACD,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC,GAAG,MAAM,CAAA;IACzE,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;CACrB,GAAG,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC,CAkCzB;AAMD,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,WAOzD;AAED,wBAAsB,yBAAyB,CAAC,IAAI,EAAE,MAAM,oBAO3D"}

package/dist/utilities/findUp.js

@@ -0,0 +1,98 @@
+import fs from 'fs';
+import path from 'path';
+/**
+ * Synchronously walks up parent directories until a condition is met and/or one of the file names within the fileNames array is found.
+ */ export function findUpSync({ condition, dir, fileNames }) {
+    const { root } = path.parse(dir);
+    while(true){
+        if (fileNames?.length) {
+            let found = false;
+            for (const fileName of fileNames){
+                const filePath = path.join(dir, fileName);
+                const exists = pathExistsAndIsAccessibleSync(filePath);
+                if (exists) {
+                    if (!condition) {
+                        return filePath;
+                    }
+                    found = true;
+                    break;
+                }
+            }
+            if (!found && dir !== root) {
+                dir = path.dirname(dir); // Move up one directory level.
+                continue;
+            }
+        }
+        const result = condition?.(dir);
+        if (result === true) {
+            return dir;
+        }
+        if (typeof result === 'string' && result?.length) {
+            return result;
+        }
+        if (dir === root) {
+            return null // Reached the root directory without a match.
+            ;
+        }
+        dir = path.dirname(dir); // Move up one directory level.
+    }
+}
+/**
+ * Asynchronously walks up parent directories until a condition is met and/or one of the file names within the fileNames array is found.
+ */ export async function findUp({ condition, dir, fileNames }) {
+    const { root } = path.parse(dir);
+    while(true){
+        if (fileNames?.length) {
+            let found = false;
+            for (const fileName of fileNames){
+                const filePath = path.resolve(dir, fileName);
+                const exists = await pathExistsAndIsAccessible(filePath);
+                if (exists) {
+                    if (!condition) {
+                        return filePath;
+                    }
+                    found = true;
+                    break;
+                }
+            }
+            if (!found && dir !== root) {
+                dir = path.dirname(dir); // Move up one directory level.
+                continue;
+            }
+        }
+        const result = await condition?.(dir);
+        if (result === true) {
+            return dir;
+        }
+        if (typeof result === 'string' && result?.length) {
+            return result;
+        }
+        if (dir === root) {
+            return null // Reached the root directory without a match.
+            ;
+        }
+        dir = path.dirname(dir); // Move up one directory level.
+    }
+}
+// From https://github.com/sindresorhus/path-exists/blob/main/index.js
+// fs.accessSync is preferred over fs.existsSync as it's usually a good idea
+// to check if the process has permission to read/write to a file before doing so.
+// Also see https://github.com/nodejs/node/issues/39960
+export function pathExistsAndIsAccessibleSync(path) {
+    try {
+        fs.accessSync(path);
+        return true;
+    } catch  {
+        return false;
+    }
+}
+export async function pathExistsAndIsAccessible(path) {
+    try {
+        await fs.promises.access(path);
+        return true;
+    } catch  {
+        return false;
+    }
+}
+
+//# sourceMappingURL=findUp.js.map