@extravirgin/payload-enchants-translator 1.0.8 → 1.1.0

package/README.md

@@ -1,8 +1,18 @@
-# Translator plugin for Payload 3.0 (beta)
+# Translator plugin for Payload 3
 
 ## Install
 
-`pnpm add @payload-enchants/translator`
+```sh
+pnpm add @extravirgin/payload-enchants-translator
+```
+
+When using the DeepL resolver, also install its optional peer dependency:
+
+```sh
+pnpm add deepl-node@^1.27.0
+```
+
+Use Payload 3 with localization enabled and at least two content locales. Register the collections and globals listed in the plugin options in your Payload config.
 
 ## Video
 
@@ -10,25 +20,38 @@ https://github.com/r1tsuu/payload-plugin-translator/assets/64744993/d39aeba4-baf
 
 ## Features:
 
-1. A flexible structure with [resolvers](https://github.com/r1tsuu/payload-plugin-translator/tree/6d0c8098467f9b5e757bf9fd8cfe63ff5da68d5b/plugin/src/resolvers) that allows you to apply any kind of transformation to your localizated data.
+1. A flexible structure with [resolvers](./src/resolvers) that allows you to apply any kind of transformation to your localized data.
 2. Can be used not only from the admin panel, but within Local API as well. [Example of the hook](#example-of-the-hook-that-uses-local-operation-to-copy-the-doc-data-to-other-locales) that automatically fills the other locales data on create
-3. Out of the box supports 3 resolvers - Copy, Google Translate, OpenAI and your own can be written easily.
+3. Includes Copy, DeepL, Google Translate, LibreTranslate, and OpenAI resolvers, with support for custom resolvers.
 4. Works with any nested document structure and 2 Rich Text editor adapters - Lexical and Slate.
-5. You can omit some fields to translate. [Documentation](#omitting-fields)
+5. You can omit fields from translation. [Documentation](#omitting-fields)
+6. Optional DeepL glossary: synchronize individual entries on save and synchronize the full list manually.
+7. English and German admin UI messages, following the current UI language.
+
+## Usage
 
-## Usage:
+Enable the resolvers your project needs. The glossary is optional; the following configuration does not register a glossary collection or sync endpoint.
 
 ```ts
-import { buildConfig } from 'payload/config';
+import { buildConfig } from 'payload';
+import { en } from '@payloadcms/translations/languages/en';
+import { de } from '@payloadcms/translations/languages/de';
 import {
   translator,
   copyResolver,
   googleResolver,
   openAIResolver,
   libreResolver,
-} from '@payload-enchants/translator';
+} from '@extravirgin/payload-enchants-translator';
 
 export default buildConfig({
+  localization: {
+    defaultLocale: 'en',
+    locales: ['en', 'de'],
+  },
+  i18n: {
+    supportedLanguages: { en, de },
+  },
   plugins: [
     translator({
       // collections with the enabled translator in the admin UI
@@ -55,6 +78,131 @@ export default buildConfig({
 
 ## Resolvers
 
+### DeepL without a glossary
+
+For translation only, omit `glossary` from both `translator()` and `deeplResolver()`, and omit `glossaryId`. Only `DEEPL_API_KEY` is needed; `DEEPL_GLOSSARY_ID` is not required.
+
+```ts
+import { deeplResolver, translator } from '@extravirgin/payload-enchants-translator';
+
+export const translatorPlugin = translator({
+  collections: ['pages', 'news'],
+  globals: ['global-settings'],
+  resolvers: [
+    deeplResolver({
+      apiKey: process.env.DEEPL_API_KEY!,
+      targetLocaleMap: { en: 'en-GB' },
+    }),
+  ],
+});
+```
+
+Add `translatorPlugin` to your Payload `plugins` array. Normal translation works without registering glossary fields, collections, controls, or sync endpoints.
+
+The DeepL resolver accepts:
+
+```ts
+export type DeepLResolverConfig = {
+  apiKey: string;
+  chunkLength?: number; // Concurrent text batch size; default: 100
+  glossary?: GlossaryConfig;
+  glossaryId?: string; // Existing DeepL multilingual glossary ID
+  sourceLocaleMap?: Record<string, string>;
+  targetLocaleMap?: Record<string, string>;
+};
+```
+
+Locale maps convert CMS locale codes to provider codes. For example, `en: 'en-GB'` selects British English for text translation; glossary language pairs use the base language `en`.
+
+### DeepL with an optional glossary
+
+Configure `DEEPL_API_KEY` and `DEEPL_GLOSSARY_ID` on the server. The glossary ID must identify an existing DeepL multilingual glossary accessible with that API key. The plugin does not create one automatically.
+
+Pass the same glossary configuration to the plugin and resolver:
+
+```ts
+import type { Access } from 'payload';
+import type { GlossaryConfig } from '@extravirgin/payload-enchants-translator';
+import { deeplResolver, translator } from '@extravirgin/payload-enchants-translator';
+
+// Replace this example with your project's admin/editor access policy.
+const authenticated: Access = ({ req }) => Boolean(req.user);
+
+const glossary: GlossaryConfig = {
+  slug: 'translation-glossary',
+  sourceLocale: 'de',
+  targetLocales: ['fr', 'it', 'en'],
+  access: { read: authenticated, update: authenticated },
+  localeLabels: {
+    de: { en: 'German (source)', de: 'Deutsch (Quelle)' },
+    fr: { en: 'French', de: 'Französisch' },
+    it: { en: 'Italian', de: 'Italienisch' },
+    en: { en: 'English', de: 'Englisch' },
+  },
+};
+
+export const translatorPlugin = translator({
+  collections: ['pages', 'news'],
+  globals: ['global-settings'],
+  glossary,
+  resolvers: [
+    deeplResolver({
+      apiKey: process.env.DEEPL_API_KEY!,
+      glossary,
+      glossaryId: process.env.DEEPL_GLOSSARY_ID!,
+      targetLocaleMap: { en: 'en-GB' },
+    }),
+  ],
+});
+```
+
+Configure the corresponding content locales in Payload. After adding the plugin or changing its schema, run your project's Payload migration, type-generation, and import-map workflow.
+
+#### Storage and validation
+
+- Entries use a collection named `<slug>-records`, or `translation-glossary-records` with the default slug. There is no glossary global or sync-state collection.
+- The source language is required. In the example, German is required and French, Italian, and English are optional.
+- Terms are trimmed, must be single-line without tabs, and may contain at most 1,024 UTF-8 bytes.
+- Source terms must be unique after trimming, Unicode normalization, and case normalization.
+- `access.read` controls reading. `access.update` controls creating, editing, and deleting entries. Synchronization requires both callbacks to return `true`.
+
+#### Saving an entry
+
+Creating or editing an entry sends only that item's populated translations to DeepL. Blank target languages are skipped. Other Payload glossary entries are neither read nor uploaded.
+
+Every save resends the item's populated translations, including unchanged ones. A German-only entry sends no dictionary updates. Saves wait for DeepL; synchronization errors are reported as save failures. There is no background worker, job queue, or automatic synchronization retry.
+
+#### Manual full synchronization
+
+The **Sync all to DeepL** button appears at the top-right of the glossary list. Its tooltip explains when full synchronization is needed.
+
+| Action                                   | On save                                                          | After Sync all                            |
+| ---------------------------------------- | ---------------------------------------------------------------- | ----------------------------------------- |
+| Add an item or edit a target translation | Merges that item's populated translations                        | Replaces the full configured dictionaries |
+| Rename the source term                   | Adds the new term; the old term remains in DeepL                 | Removes the old term                      |
+| Clear a target translation               | Skips the empty value; the previous translation remains in DeepL | Removes the previous translation          |
+| Delete an item                           | No DeepL request                                                 | Removes the deleted item from DeepL       |
+
+Full synchronization reads all saved entries in pages of 1,000, regardless of the list's current filters or page. It replaces each configured source/target dictionary and removes configured dictionaries that have no remaining entries. Unrelated language pairs in the same DeepL glossary are preserved. The uploaded glossary data is limited to 10 MiB.
+
+The button is disabled while syncing, then displays a success or error notification. Avoid editing entries while full synchronization runs. DeepL updates are not atomic across languages: a failed operation may already have updated some dictionaries. Retry the item save or use Sync all to reconcile DeepL with the saved Payload entries.
+
+The manual action uses `POST <basePath><apiRoute>/translator/glossary/sync`, where the default Payload API route is `/api`.
+
+#### Using the glossary during translation
+
+The resolver attaches the configured glossary when translating from its source locale to a configured target locale and at least one saved entry has a translation for that target. If there are no populated terms for that target, translation proceeds without a glossary. Other language directions also translate without it.
+
+Translating content does not synchronize the glossary. Run Sync all once to upload existing entries, and again after source renames, cleared translations, or deletions. In the admin editor, translated content still needs to be saved; both “Translate all” and “Translate only empty fields” are available.
+
+To omit the glossary feature entirely, remove `glossary` from both configurations and remove `glossaryId`. Setting `disabled: true` alone does not remove an explicitly configured glossary collection.
+
+### Admin UI language
+
+The plugin includes English and German labels, buttons, tooltips, validation messages, and user-facing errors. They follow the current admin UI language, independently of the document's content locale. Enable `en` and `de` under Payload's `i18n.supportedLanguages`, as shown above.
+
+Project translations under `i18n.translations[language]['plugin-translator']` override the plugin defaults. Detailed provider failures are logged on the server; glossary controls display localized error messages.
+
 ### OpenAI
 
 #### Config:
@@ -62,9 +210,10 @@ export default buildConfig({
 ```ts
 export type OpenAIResolverConfig = {
   apiKey: string; // API key
+  baseUrl?: string; // Optional API base URL
   chunkLength?: number; // How many texts to include into 1 request, default: 100
   model?: string; // model, default: 'gpt-3.5-turbo'
-  promt?: OpenAIPrompt; // custom prompt
+  prompt?: OpenAIPrompt; // custom prompt
 };
 ```
 
@@ -78,7 +227,7 @@ export type OpenAIPrompt = (args: {
 }) => string;
 
 // Default
-const defaultPromt: OpenAIPrompt = ({ localeFrom, localeTo, texts }) => {
+const defaultPrompt: OpenAIPrompt = ({ localeFrom, localeTo, texts }) => {
   return `Translate me the following array: ${JSON.stringify(texts)} in locale=${localeFrom} to locale ${localeTo}, respond me with the same array structure`;
 };
 ```
@@ -90,14 +239,17 @@ const defaultPromt: OpenAIPrompt = ({ localeFrom, localeTo, texts }) => {
 ```ts
 export type GoogleResolverConfig = {
   apiKey: string; // API key
-  chunkLength?: number; / /How many texts to include into 1 request, default: 100
+  chunkLength?: number; // How many texts to include into 1 request, default: 100
 };
 ```
 
 ### Writing your own
 
 ```ts
-import type { TranslateResolver } from '@payload-enchants/translator/resolvers/types';
+import { buildConfig } from 'payload';
+import { en } from '@payloadcms/translations/languages/en';
+import { translator } from '@extravirgin/payload-enchants-translator';
+import type { TranslateResolver } from '@extravirgin/payload-enchants-translator/resolvers/types';
 
 const myResolver: TranslateResolver = {
   key: 'my',
@@ -115,7 +267,7 @@ const myResolver: TranslateResolver = {
 
 export default buildConfig({
   plugins: [
-    payloadPluginTranslator({
+    translator({
       collections: ['posts', 'small-posts'],
       globals: [],
       resolvers: [myResolver],
@@ -127,7 +279,7 @@ export default buildConfig({
     translations: {
       en: {
         'plugin-translator': {
-          resolver_my_buttonLabel: 'Google Translate',
+          resolver_my_buttonLabel: 'Custom translation',
           resolver_my_errorMessage: 'An error occurred when trying to translate the data',
           resolver_my_modalTitle: 'Choose the locale to translate from',
           resolver_my_submitButtonLabelEmpty: 'Translate only empty fields',
@@ -143,7 +295,7 @@ export default buildConfig({
 ## Using the Local API
 
 ```ts
-import { translateOperation } from '@payload-enchants/translator';
+import { translateOperation } from '@extravirgin/payload-enchants-translator';
 
 const translateResult = await translateOperation({
   collectionSlug: 'posts', // or globalSlug if globals,
@@ -151,20 +303,21 @@ const translateResult = await translateOperation({
   id: postDefaultLocale.id, // pass the doc id if it's a collection
   locale: 'de', // locale to translate to
   localeFrom: 'en', // locale to translate from
-  payload, // payload instance, you can get it with getPayload or req.payload in hooks
-  req, // PayloadRequest, can be used instead of payload, more appreciable than payload if you have it
+  req, // Prefer the current PayloadRequest to preserve user, UI language, and transaction context
   overrideAccess: false, //
   resolver: 'copy', // pass resolver key
   update: true, // optional, should update immediately or just return the translated result, default false
-  data: {}, // Optional, if you want to translate from your data passed here instead of the current doc, should be in "localeFrom" locale, for example { title: "Hello" }
+  // data: destinationFormData, // Optional destination data; the source is read from localeFrom
 });
 ```
 
+For calls without an existing request, `payload` can be passed instead of `req`. When using glossary access rules based on the current user, pass an authenticated `req`.
+
 ### Example of the hook that uses local operation to copy the doc data to other locales
 
 ```ts
-import type { CollectionAfterChangeHook } from 'payload/types';
-import { translateOperation } from '@payload-enchants/translator';
+import type { CollectionAfterChangeHook } from 'payload';
+import { translateOperation } from '@extravirgin/payload-enchants-translator';
 
 export const copyOtherLocales: CollectionAfterChangeHook = async ({
   collection,

package/dist/client/components/GlossaryControls/index.d.ts

@@ -0,0 +1,4 @@
+export declare const GlossaryControls: ({ basePath }: {
+    basePath: string;
+}) => import("react").JSX.Element;
+//# sourceMappingURL=index.d.ts.map

package/dist/client/components/GlossaryControls/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/client/components/GlossaryControls/index.tsx"],"names":[],"mappings":"AAOA,eAAO,MAAM,gBAAgB,iBAAkB;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,gCA0ClE,CAAC"}

package/dist/client/components/GlossaryControls/index.js

@@ -0,0 +1,43 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Button, toast, useConfig, useTranslation } from '@payloadcms/ui';
+import { useState } from 'react';
+import { translatorT } from '../../../i18n-translations';
+export const GlossaryControls = ({ basePath })=>{
+    const { config } = useConfig();
+    const { i18n, t } = useTranslation();
+    const [syncing, setSyncing] = useState(false);
+    const sync = async ()=>{
+        setSyncing(true);
+        try {
+            const response = await fetch(`${config.serverURL}${basePath}${config.routes.api}/translator/glossary/sync`, {
+                credentials: 'include',
+                headers: {
+                    'Accept-Language': i18n.language
+                },
+                method: 'POST'
+            });
+            const result = await response.json();
+            if (!response.ok) {
+                toast.error(result.error || translatorT(t, 'glossary_syncError'));
+                return;
+            }
+            toast.success(translatorT(t, 'glossary_syncSuccess'));
+        } catch  {
+            toast.error(translatorT(t, 'glossary_syncError'));
+        } finally{
+            setSyncing(false);
+        }
+    };
+    return /*#__PURE__*/ _jsx(Button, {
+        disabled: syncing,
+        margin: false,
+        onClick: sync,
+        size: "small",
+        tooltip: translatorT(t, 'glossary_syncHint'),
+        type: "button",
+        children: translatorT(t, syncing ? 'glossary_syncing' : 'glossary_syncAll')
+    });
+};
+
+//# sourceMappingURL=index.js.map

package/dist/client/components/GlossaryControls/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/client/components/GlossaryControls/index.tsx"],"sourcesContent":["'use client';\n\nimport { Button, toast, useConfig, useTranslation } from '@payloadcms/ui';\nimport { useState } from 'react';\n\nimport { translatorT } from '../../../i18n-translations';\n\nexport const GlossaryControls = ({ basePath }: { basePath: string }) => {\n  const { config } = useConfig();\n\n  const { i18n, t } = useTranslation();\n\n  const [syncing, setSyncing] = useState(false);\n\n  const sync = async () => {\n    setSyncing(true);\n    try {\n      const response = await fetch(\n        `${config.serverURL}${basePath}${config.routes.api}/translator/glossary/sync`,\n        { credentials: 'include', headers: { 'Accept-Language': i18n.language }, method: 'POST' },\n      );\n\n      const result = await response.json();\n\n      if (!response.ok) {\n        toast.error(result.error || translatorT(t, 'glossary_syncError'));\n\n        return;\n      }\n      toast.success(translatorT(t, 'glossary_syncSuccess'));\n    } catch {\n      toast.error(translatorT(t, 'glossary_syncError'));\n    } finally {\n      setSyncing(false);\n    }\n  };\n\n  return (\n    <Button\n      disabled={syncing}\n      margin={false}\n      onClick={sync}\n      size='small'\n      tooltip={translatorT(t, 'glossary_syncHint')}\n      type='button'\n    >\n      {translatorT(t, syncing ? 'glossary_syncing' : 'glossary_syncAll')}\n    </Button>\n  );\n};\n"],"names":["Button","toast","useConfig","useTranslation","useState","translatorT","GlossaryControls","basePath","config","i18n","t","syncing","setSyncing","sync","response","fetch","serverURL","routes","api","credentials","headers","language","method","result","json","ok","error","success","disabled","margin","onClick","size","tooltip","type"],"mappings":"AAAA;;AAEA,SAASA,MAAM,EAAEC,KAAK,EAAEC,SAAS,EAAEC,cAAc,QAAQ,iBAAiB;AAC1E,SAASC,QAAQ,QAAQ,QAAQ;AAEjC,SAASC,WAAW,QAAQ,6BAA6B;AAEzD,OAAO,MAAMC,mBAAmB,CAAC,EAAEC,QAAQ,EAAwB;IACjE,MAAM,EAAEC,MAAM,EAAE,GAAGN;IAEnB,MAAM,EAAEO,IAAI,EAAEC,CAAC,EAAE,GAAGP;IAEpB,MAAM,CAACQ,SAASC,WAAW,GAAGR,SAAS;IAEvC,MAAMS,OAAO;QACXD,WAAW;QACX,IAAI;YACF,MAAME,WAAW,MAAMC,MACrB,GAAGP,OAAOQ,SAAS,GAAGT,WAAWC,OAAOS,MAAM,CAACC,GAAG,CAAC,yBAAyB,CAAC,EAC7E;gBAAEC,aAAa;gBAAWC,SAAS;oBAAE,mBAAmBX,KAAKY,QAAQ;gBAAC;gBAAGC,QAAQ;YAAO;YAG1F,MAAMC,SAAS,MAAMT,SAASU,IAAI;YAElC,IAAI,CAACV,SAASW,EAAE,EAAE;gBAChBxB,MAAMyB,KAAK,CAACH,OAAOG,KAAK,IAAIrB,YAAYK,GAAG;gBAE3C;YACF;YACAT,MAAM0B,OAAO,CAACtB,YAAYK,GAAG;QAC/B,EAAE,OAAM;YACNT,MAAMyB,KAAK,CAACrB,YAAYK,GAAG;QAC7B,SAAU;YACRE,WAAW;QACb;IACF;IAEA,qBACE,KAACZ;QACC4B,UAAUjB;QACVkB,QAAQ;QACRC,SAASjB;QACTkB,MAAK;QACLC,SAAS3B,YAAYK,GAAG;QACxBuB,MAAK;kBAEJ5B,YAAYK,GAAGC,UAAU,qBAAqB;;AAGrD,EAAE"}

package/dist/client/providers/Translator/TranslatorProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TranslatorProvider.d.ts","sourceRoot":"","sources":["../../../../src/client/providers/Translator/TranslatorProvider.tsx"],"names":[],"mappings":"AAYA,OAAO,EAAE,KAAK,SAAS,EAAgC,MAAM,OAAO,CAAC;AASrE,eAAO,MAAM,kBAAkB,iBAAkB;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,gCAmJvE,CAAC"}
+{"version":3,"file":"TranslatorProvider.d.ts","sourceRoot":"","sources":["../../../../src/client/providers/Translator/TranslatorProvider.tsx"],"names":[],"mappings":"AAYA,OAAO,EAAE,KAAK,SAAS,EAAgC,MAAM,OAAO,CAAC;AAUrE,eAAO,MAAM,kBAAkB,iBAAkB;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,gCAmJvE,CAAC"}

package/dist/client/providers/Translator/TranslatorProvider.js

@@ -3,6 +3,7 @@ import { toast, useAllFormFields, useConfig, useDocumentInfo, useForm, useLocale
 import { reduceFieldsToValues } from 'payload/shared';
 import { useEffect, useMemo, useState } from 'react';
 import { createClient } from '../../api';
+import { translatorT } from '../../../i18n-translations';
 import { TranslatorContext } from './context';
 const modalSlug = 'translator-modal';
 export const TranslatorProvider = ({ children })=>{
@@ -35,7 +36,7 @@ export const TranslatorProvider = ({ children })=>{
         custom,
         resolver
     ]);
-    if (!localization) throw new Error('Localization config is not provided and PluginTranslator is used');
+    if (!localization) throw new Error(translatorT(t, 'error_missingLocalization'));
     const localesOptions = localization.locales.filter((each)=>each.code !== locale.code);
     const [localeToTranslateFrom, setLocaleToTranslateFrom] = useState('');
     useEffect(()=>{

package/dist/client/providers/Translator/TranslatorProvider.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/client/providers/Translator/TranslatorProvider.tsx"],"sourcesContent":["import {\n  toast,\n  useAllFormFields,\n  useConfig,\n  useDocumentInfo,\n  useForm,\n  useLocale,\n  useModal,\n  useServerFunctions,\n  useTranslation,\n} from '@payloadcms/ui';\nimport { reduceFieldsToValues } from 'payload/shared';\nimport { type ReactNode, useEffect, useMemo, useState } from 'react';\n\nimport type { TranslateResolver } from '../../../resolvers/types';\nimport type { TranslateArgs } from '../../../translate/types';\nimport { createClient } from '../../api';\nimport { TranslatorContext } from './context';\n\nconst modalSlug = 'translator-modal';\n\nexport const TranslatorProvider = ({ children }: { children: ReactNode }) => {\n  const [resolver, setResolver] = useState<null | string>(null);\n\n  const [data, dispatch] = useAllFormFields();\n\n  const { getFormState } = useServerFunctions();\n\n  const { collectionSlug, getDocPreferences, globalSlug, id } = useDocumentInfo();\n\n  const { setModified } = useForm();\n\n  const modal = useModal();\n\n  const { t } = useTranslation();\n\n  const resolverT = (\n    key:\n      | 'buttonLabel'\n      | 'errorMessage'\n      | 'modalTitle'\n      | 'submitButtonLabelEmpty'\n      | 'submitButtonLabelFull'\n      | 'successMessage',\n  ) => {\n    if (!resolver) return '';\n\n    return t(`plugin-translator:resolver_${resolver}_${key}` as Parameters<typeof t>[0]);\n  };\n\n  const locale = useLocale();\n\n  const {\n    config: {\n      admin: { custom },\n      localization,\n      routes: { api },\n      serverURL,\n    },\n  } = useConfig();\n\n  const basePath = (custom?.translator?.basePath as string | undefined) ?? '';\n  const apiClient = createClient({ api, basePath, serverURL });\n\n  const resolverConfig = useMemo(() => {\n    if (!resolver) return null;\n\n    const resolvers = (custom?.translator?.resolvers as TranslateResolver[]) || undefined;\n\n    if (!resolvers) return null;\n\n    const resolverConfig = resolvers.find((each) => each.key === resolver);\n\n    return resolverConfig ?? null;\n  }, [custom, resolver]);\n\n  if (!localization)\n    throw new Error('Localization config is not provided and PluginTranslator is used');\n\n  const localesOptions = localization.locales.filter((each) => each.code !== locale.code);\n\n  const [localeToTranslateFrom, setLocaleToTranslateFrom] = useState<string>('');\n\n  useEffect(()=>{\n    const localeToTranslateFromExists = localesOptions.find((each)=>localeToTranslateFrom === each.code);\n    if (localeToTranslateFrom && localeToTranslateFromExists) return;\n    const defaultFromOptions = localesOptions.find((each)=>localization.defaultLocale === each.code);\n    if (defaultFromOptions) {\n        setLocaleToTranslateFrom(defaultFromOptions.code);\n        return;\n    }\n    setLocaleToTranslateFrom(localesOptions[0].code);\n}, [\n    locale,\n    localesOptions,\n    localization.defaultLocale\n]);\n\n  const closeTranslator = () => modal.closeModal(modalSlug);\n\n  const submit = async ({ emptyOnly }: { emptyOnly: boolean }) => {\n    if (!resolver) return;\n\n    const args: TranslateArgs = {\n      collectionSlug,\n      data: reduceFieldsToValues(data, true),\n      emptyOnly,\n      globalSlug,\n      id: id === null ? undefined : id,\n      locale: locale.code,\n      localeFrom: localeToTranslateFrom,\n      resolver,\n    };\n\n    const result = await apiClient.translate(args);\n\n    if (!result.success) {\n      toast.error(resolverT('errorMessage'));\n\n      return;\n    }\n\n    const { state } = await getFormState({\n      collectionSlug,\n      data: result.translatedData,\n      docPermissions: {\n        fields: true,\n        update: true,\n      },\n      docPreferences: await getDocPreferences(),\n      globalSlug,\n      locale: locale.code,\n      operation: 'update',\n      renderAllFields: true,\n      schemaPath: collectionSlug || globalSlug || '',\n    });\n\n    if (state) {\n      dispatch({\n        state,\n        type: 'REPLACE_STATE',\n      });\n      setModified(true);\n      toast.success(resolverT('successMessage'));\n    }\n    closeTranslator();\n  };\n\n  return (\n    <TranslatorContext.Provider\n      value={{\n        closeTranslator,\n        localeToTranslateFrom,\n        localesOptions,\n        modalSlug,\n        openTranslator: ({ resolverKey }) => {\n          setResolver(resolverKey);\n          modal.openModal(modalSlug);\n        },\n        resolver: resolverConfig,\n        resolverT,\n        setLocaleToTranslateFrom,\n        submit,\n      }}\n    >\n      {children}\n    </TranslatorContext.Provider>\n  );\n};\n"],"names":["toast","useAllFormFields","useConfig","useDocumentInfo","useForm","useLocale","useModal","useServerFunctions","useTranslation","reduceFieldsToValues","useEffect","useMemo","useState","createClient","TranslatorContext","modalSlug","TranslatorProvider","children","resolver","setResolver","data","dispatch","getFormState","collectionSlug","getDocPreferences","globalSlug","id","setModified","modal","t","resolverT","key","locale","config","admin","custom","localization","routes","api","serverURL","basePath","translator","apiClient","resolverConfig","resolvers","undefined","find","each","Error","localesOptions","locales","filter","code","localeToTranslateFrom","setLocaleToTranslateFrom","localeToTranslateFromExists","defaultFromOptions","defaultLocale","closeTranslator","closeModal","submit","emptyOnly","args","localeFrom","result","translate","success","error","state","translatedData","docPermissions","fields","update","docPreferences","operation","renderAllFields","schemaPath","type","Provider","value","openTranslator","resolverKey","openModal"],"mappings":";AAAA,SACEA,KAAK,EACLC,gBAAgB,EAChBC,SAAS,EACTC,eAAe,EACfC,OAAO,EACPC,SAAS,EACTC,QAAQ,EACRC,kBAAkB,EAClBC,cAAc,QACT,iBAAiB;AACxB,SAASC,oBAAoB,QAAQ,iBAAiB;AACtD,SAAyBC,SAAS,EAAEC,OAAO,EAAEC,QAAQ,QAAQ,QAAQ;AAIrE,SAASC,YAAY,QAAQ,YAAY;AACzC,SAASC,iBAAiB,QAAQ,YAAY;AAE9C,MAAMC,YAAY;AAElB,OAAO,MAAMC,qBAAqB,CAAC,EAAEC,QAAQ,EAA2B;IACtE,MAAM,CAACC,UAAUC,YAAY,GAAGP,SAAwB;IAExD,MAAM,CAACQ,MAAMC,SAAS,GAAGpB;IAEzB,MAAM,EAAEqB,YAAY,EAAE,GAAGf;IAEzB,MAAM,EAAEgB,cAAc,EAAEC,iBAAiB,EAAEC,UAAU,EAAEC,EAAE,EAAE,GAAGvB;IAE9D,MAAM,EAAEwB,WAAW,EAAE,GAAGvB;IAExB,MAAMwB,QAAQtB;IAEd,MAAM,EAAEuB,CAAC,EAAE,GAAGrB;IAEd,MAAMsB,YAAY,CAChBC;QAQA,IAAI,CAACb,UAAU,OAAO;QAEtB,OAAOW,EAAE,CAAC,2BAA2B,EAAEX,SAAS,CAAC,EAAEa,KAAK;IAC1D;IAEA,MAAMC,SAAS3B;IAEf,MAAM,EACJ4B,QAAQ,EACNC,OAAO,EAAEC,MAAM,EAAE,EACjBC,YAAY,EACZC,QAAQ,EAAEC,GAAG,EAAE,EACfC,SAAS,EACV,EACF,GAAGrC;IAEJ,MAAMsC,WAAW,AAACL,QAAQM,YAAYD,YAAmC;IACzE,MAAME,YAAY7B,aAAa;QAAEyB;QAAKE;QAAUD;IAAU;IAE1D,MAAMI,iBAAiBhC,QAAQ;QAC7B,IAAI,CAACO,UAAU,OAAO;QAEtB,MAAM0B,YAAY,AAACT,QAAQM,YAAYG,aAAqCC;QAE5E,IAAI,CAACD,WAAW,OAAO;QAEvB,MAAMD,iBAAiBC,UAAUE,IAAI,CAAC,CAACC,OAASA,KAAKhB,GAAG,KAAKb;QAE7D,OAAOyB,kBAAkB;IAC3B,GAAG;QAACR;QAAQjB;KAAS;IAErB,IAAI,CAACkB,cACH,MAAM,IAAIY,MAAM;IAElB,MAAMC,iBAAiBb,aAAac,OAAO,CAACC,MAAM,CAAC,CAACJ,OAASA,KAAKK,IAAI,KAAKpB,OAAOoB,IAAI;IAEtF,MAAM,CAACC,uBAAuBC,yBAAyB,GAAG1C,SAAiB;IAE3EF,UAAU;QACR,MAAM6C,8BAA8BN,eAAeH,IAAI,CAAC,CAACC,OAAOM,0BAA0BN,KAAKK,IAAI;QACnG,IAAIC,yBAAyBE,6BAA6B;QAC1D,MAAMC,qBAAqBP,eAAeH,IAAI,CAAC,CAACC,OAAOX,aAAaqB,aAAa,KAAKV,KAAKK,IAAI;QAC/F,IAAII,oBAAoB;YACpBF,yBAAyBE,mBAAmBJ,IAAI;YAChD;QACJ;QACAE,yBAAyBL,cAAc,CAAC,EAAE,CAACG,IAAI;IACnD,GAAG;QACCpB;QACAiB;QACAb,aAAaqB,aAAa;KAC7B;IAEC,MAAMC,kBAAkB,IAAM9B,MAAM+B,UAAU,CAAC5C;IAE/C,MAAM6C,SAAS,OAAO,EAAEC,SAAS,EAA0B;QACzD,IAAI,CAAC3C,UAAU;QAEf,MAAM4C,OAAsB;YAC1BvC;YACAH,MAAMX,qBAAqBW,MAAM;YACjCyC;YACApC;YACAC,IAAIA,OAAO,OAAOmB,YAAYnB;YAC9BM,QAAQA,OAAOoB,IAAI;YACnBW,YAAYV;YACZnC;QACF;QAEA,MAAM8C,SAAS,MAAMtB,UAAUuB,SAAS,CAACH;QAEzC,IAAI,CAACE,OAAOE,OAAO,EAAE;YACnBlE,MAAMmE,KAAK,CAACrC,UAAU;YAEtB;QACF;QAEA,MAAM,EAAEsC,KAAK,EAAE,GAAG,MAAM9C,aAAa;YACnCC;YACAH,MAAM4C,OAAOK,cAAc;YAC3BC,gBAAgB;gBACdC,QAAQ;gBACRC,QAAQ;YACV;YACAC,gBAAgB,MAAMjD;YACtBC;YACAO,QAAQA,OAAOoB,IAAI;YACnBsB,WAAW;YACXC,iBAAiB;YACjBC,YAAYrD,kBAAkBE,cAAc;QAC9C;QAEA,IAAI2C,OAAO;YACT/C,SAAS;gBACP+C;gBACAS,MAAM;YACR;YACAlD,YAAY;YACZ3B,MAAMkE,OAAO,CAACpC,UAAU;QAC1B;QACA4B;IACF;IAEA,qBACE,KAAC5C,kBAAkBgE,QAAQ;QACzBC,OAAO;YACLrB;YACAL;YACAJ;YACAlC;YACAiE,gBAAgB,CAAC,EAAEC,WAAW,EAAE;gBAC9B9D,YAAY8D;gBACZrD,MAAMsD,SAAS,CAACnE;YAClB;YACAG,UAAUyB;YACVb;YACAwB;YACAM;QACF;kBAEC3C;;AAGP,EAAE"}
+{"version":3,"sources":["../../../../src/client/providers/Translator/TranslatorProvider.tsx"],"sourcesContent":["import {\n  toast,\n  useAllFormFields,\n  useConfig,\n  useDocumentInfo,\n  useForm,\n  useLocale,\n  useModal,\n  useServerFunctions,\n  useTranslation,\n} from '@payloadcms/ui';\nimport { reduceFieldsToValues } from 'payload/shared';\nimport { type ReactNode, useEffect, useMemo, useState } from 'react';\n\nimport type { TranslateResolver } from '../../../resolvers/types';\nimport type { TranslateArgs } from '../../../translate/types';\nimport { createClient } from '../../api';\nimport { translatorT } from '../../../i18n-translations';\nimport { TranslatorContext } from './context';\n\nconst modalSlug = 'translator-modal';\n\nexport const TranslatorProvider = ({ children }: { children: ReactNode }) => {\n  const [resolver, setResolver] = useState<null | string>(null);\n\n  const [data, dispatch] = useAllFormFields();\n\n  const { getFormState } = useServerFunctions();\n\n  const { collectionSlug, getDocPreferences, globalSlug, id } = useDocumentInfo();\n\n  const { setModified } = useForm();\n\n  const modal = useModal();\n\n  const { t } = useTranslation();\n\n  const resolverT = (\n    key:\n      | 'buttonLabel'\n      | 'errorMessage'\n      | 'modalTitle'\n      | 'submitButtonLabelEmpty'\n      | 'submitButtonLabelFull'\n      | 'successMessage',\n  ) => {\n    if (!resolver) return '';\n\n    return t(`plugin-translator:resolver_${resolver}_${key}` as Parameters<typeof t>[0]);\n  };\n\n  const locale = useLocale();\n\n  const {\n    config: {\n      admin: { custom },\n      localization,\n      routes: { api },\n      serverURL,\n    },\n  } = useConfig();\n\n  const basePath = (custom?.translator?.basePath as string | undefined) ?? '';\n  const apiClient = createClient({ api, basePath, serverURL });\n\n  const resolverConfig = useMemo(() => {\n    if (!resolver) return null;\n\n    const resolvers = (custom?.translator?.resolvers as TranslateResolver[]) || undefined;\n\n    if (!resolvers) return null;\n\n    const resolverConfig = resolvers.find((each) => each.key === resolver);\n\n    return resolverConfig ?? null;\n  }, [custom, resolver]);\n\n  if (!localization)\n    throw new Error(translatorT(t, 'error_missingLocalization'));\n\n  const localesOptions = localization.locales.filter((each) => each.code !== locale.code);\n\n  const [localeToTranslateFrom, setLocaleToTranslateFrom] = useState<string>('');\n\n  useEffect(()=>{\n    const localeToTranslateFromExists = localesOptions.find((each)=>localeToTranslateFrom === each.code);\n    if (localeToTranslateFrom && localeToTranslateFromExists) return;\n    const defaultFromOptions = localesOptions.find((each)=>localization.defaultLocale === each.code);\n    if (defaultFromOptions) {\n        setLocaleToTranslateFrom(defaultFromOptions.code);\n        return;\n    }\n    setLocaleToTranslateFrom(localesOptions[0].code);\n}, [\n    locale,\n    localesOptions,\n    localization.defaultLocale\n]);\n\n  const closeTranslator = () => modal.closeModal(modalSlug);\n\n  const submit = async ({ emptyOnly }: { emptyOnly: boolean }) => {\n    if (!resolver) return;\n\n    const args: TranslateArgs = {\n      collectionSlug,\n      data: reduceFieldsToValues(data, true),\n      emptyOnly,\n      globalSlug,\n      id: id === null ? undefined : id,\n      locale: locale.code,\n      localeFrom: localeToTranslateFrom,\n      resolver,\n    };\n\n    const result = await apiClient.translate(args);\n\n    if (!result.success) {\n      toast.error(resolverT('errorMessage'));\n\n      return;\n    }\n\n    const { state } = await getFormState({\n      collectionSlug,\n      data: result.translatedData,\n      docPermissions: {\n        fields: true,\n        update: true,\n      },\n      docPreferences: await getDocPreferences(),\n      globalSlug,\n      locale: locale.code,\n      operation: 'update',\n      renderAllFields: true,\n      schemaPath: collectionSlug || globalSlug || '',\n    });\n\n    if (state) {\n      dispatch({\n        state,\n        type: 'REPLACE_STATE',\n      });\n      setModified(true);\n      toast.success(resolverT('successMessage'));\n    }\n    closeTranslator();\n  };\n\n  return (\n    <TranslatorContext.Provider\n      value={{\n        closeTranslator,\n        localeToTranslateFrom,\n        localesOptions,\n        modalSlug,\n        openTranslator: ({ resolverKey }) => {\n          setResolver(resolverKey);\n          modal.openModal(modalSlug);\n        },\n        resolver: resolverConfig,\n        resolverT,\n        setLocaleToTranslateFrom,\n        submit,\n      }}\n    >\n      {children}\n    </TranslatorContext.Provider>\n  );\n};\n"],"names":["toast","useAllFormFields","useConfig","useDocumentInfo","useForm","useLocale","useModal","useServerFunctions","useTranslation","reduceFieldsToValues","useEffect","useMemo","useState","createClient","translatorT","TranslatorContext","modalSlug","TranslatorProvider","children","resolver","setResolver","data","dispatch","getFormState","collectionSlug","getDocPreferences","globalSlug","id","setModified","modal","t","resolverT","key","locale","config","admin","custom","localization","routes","api","serverURL","basePath","translator","apiClient","resolverConfig","resolvers","undefined","find","each","Error","localesOptions","locales","filter","code","localeToTranslateFrom","setLocaleToTranslateFrom","localeToTranslateFromExists","defaultFromOptions","defaultLocale","closeTranslator","closeModal","submit","emptyOnly","args","localeFrom","result","translate","success","error","state","translatedData","docPermissions","fields","update","docPreferences","operation","renderAllFields","schemaPath","type","Provider","value","openTranslator","resolverKey","openModal"],"mappings":"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"}

package/dist/exports/client.d.ts

@@ -1,2 +1,3 @@
 export { CustomButtonWithTranslator } from '../client/components/CustomButton/CustomButtonWithTranslator';
+export { GlossaryControls } from '../client/components/GlossaryControls';
 //# sourceMappingURL=client.d.ts.map

package/dist/exports/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/exports/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,8DAA8D,CAAC"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/exports/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,8DAA8D,CAAC;AAE1G,OAAO,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC"}

package/dist/exports/client.js

@@ -1,3 +1,4 @@
 export { CustomButtonWithTranslator } from '../client/components/CustomButton/CustomButtonWithTranslator';
+export { GlossaryControls } from '../client/components/GlossaryControls';
 
 //# sourceMappingURL=client.js.map

package/dist/exports/client.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/exports/client.ts"],"sourcesContent":["export { CustomButtonWithTranslator } from '../client/components/CustomButton/CustomButtonWithTranslator';\n"],"names":["CustomButtonWithTranslator"],"mappings":"AAAA,SAASA,0BAA0B,QAAQ,+DAA+D"}
+{"version":3,"sources":["../../src/exports/client.ts"],"sourcesContent":["export { CustomButtonWithTranslator } from '../client/components/CustomButton/CustomButtonWithTranslator';\n\nexport { GlossaryControls } from '../client/components/GlossaryControls';\n"],"names":["CustomButtonWithTranslator","GlossaryControls"],"mappings":"AAAA,SAASA,0BAA0B,QAAQ,+DAA+D;AAE1G,SAASC,gBAAgB,QAAQ,wCAAwC"}

package/dist/glossary.d.ts

@@ -0,0 +1,17 @@
+import type { TFunction } from '@payloadcms/translations';
+import type { Access, CollectionConfig } from 'payload';
+export type GlossaryConfig = {
+    access: {
+        read: Access;
+        update: Access;
+    };
+    label?: NonNullable<CollectionConfig['labels']>['plural'];
+    localeLabels?: Record<string, Record<string, string> | string>;
+    slug?: string;
+    sourceLocale: string;
+    targetLocales: string[];
+};
+export declare const getGlossarySlug: (config: GlossaryConfig) => string;
+export declare const validateGlossaryEntries: (value: unknown, config: GlossaryConfig, t?: TFunction) => string | true;
+export declare const validateGlossaryConfig: (config: GlossaryConfig) => void;
+//# sourceMappingURL=glossary.d.ts.map

package/dist/glossary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glossary.d.ts","sourceRoot":"","sources":["../src/glossary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAIxD,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,KAAK,CAAC,EAAE,WAAW,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB,CAAC;AAEF,eAAO,MAAM,eAAe,WAAY,cAAc,WAA0C,CAAC;AAEjG,eAAO,MAAM,uBAAuB,UAC3B,OAAO,UACN,cAAc,MAClB,SAAS,KACZ,MAAM,GAAG,IAkCX,CAAC;AAEF,eAAO,MAAM,sBAAsB,WAAY,cAAc,KAAG,IAyB/D,CAAC"}

package/dist/glossary.js

@@ -0,0 +1,52 @@
+import { translatorT } from './i18n-translations';
+export const getGlossarySlug = (config)=>config.slug ?? 'translation-glossary';
+export const validateGlossaryEntries = (value, config, t)=>{
+    if (!Array.isArray(value) || !value.length) return translatorT(t, 'glossary_empty');
+    const locales = [
+        config.sourceLocale,
+        ...config.targetLocales
+    ];
+    const sources = new Set();
+    for (const entry of value){
+        for (const locale of locales){
+            const term = entry?.[locale];
+            if (locale !== config.sourceLocale && (term == null || typeof term === 'string' && !term.trim())) {
+                continue;
+            }
+            if (typeof term !== 'string' || !term.trim() || /[\t\r\n]/.test(term)) {
+                return translatorT(t, 'glossary_invalidTerm', {
+                    locale: config.sourceLocale.toUpperCase()
+                });
+            }
+            if (Buffer.byteLength(term.trim(), 'utf8') > 1024) {
+                return translatorT(t, 'glossary_termTooLong');
+            }
+        }
+        const source = entry[config.sourceLocale].trim().normalize('NFC').toLowerCase();
+        if (sources.has(source)) return translatorT(t, 'glossary_duplicateSource');
+        sources.add(source);
+    }
+    return true;
+};
+export const validateGlossaryConfig = (config)=>{
+    const locales = [
+        config.sourceLocale,
+        ...config.targetLocales
+    ];
+    if (!config.targetLocales.length || new Set(locales).size !== locales.length) {
+        throw new Error('The glossary requires distinct source and target locales.');
+    }
+    if (locales.some((locale)=>!/^[a-zA-Z][a-zA-Z0-9_]*$/.test(locale) || [
+            '__proto__',
+            'constructor',
+            'createdAt',
+            'id',
+            'prototype',
+            'sourceKey',
+            'updatedAt'
+        ].includes(locale))) {
+        throw new Error('Use valid Payload field names for glossary locales and map provider language codes in the resolver.');
+    }
+};
+
+//# sourceMappingURL=glossary.js.map

package/dist/glossary.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/glossary.ts"],"sourcesContent":["import type { TFunction } from '@payloadcms/translations';\nimport type { Access, CollectionConfig } from 'payload';\n\nimport { translatorT } from './i18n-translations';\n\nexport type GlossaryConfig = {\n  access: { read: Access; update: Access };\n  label?: NonNullable<CollectionConfig['labels']>['plural'];\n  localeLabels?: Record<string, Record<string, string> | string>;\n  slug?: string;\n  sourceLocale: string;\n  targetLocales: string[];\n};\n\nexport const getGlossarySlug = (config: GlossaryConfig) => config.slug ?? 'translation-glossary';\n\nexport const validateGlossaryEntries = (\n  value: unknown,\n  config: GlossaryConfig,\n  t?: TFunction,\n): string | true => {\n  if (!Array.isArray(value) || !value.length) return translatorT(t, 'glossary_empty');\n\n  const locales = [config.sourceLocale, ...config.targetLocales];\n\n  const sources = new Set<string>();\n\n  for (const entry of value) {\n    for (const locale of locales) {\n      const term = entry?.[locale];\n\n      if (\n        locale !== config.sourceLocale &&\n        (term == null || (typeof term === 'string' && !term.trim()))\n      ) {\n        continue;\n      }\n      if (typeof term !== 'string' || !term.trim() || /[\\t\\r\\n]/.test(term)) {\n        return translatorT(t, 'glossary_invalidTerm', {\n          locale: config.sourceLocale.toUpperCase(),\n        });\n      }\n      if (Buffer.byteLength(term.trim(), 'utf8') > 1024) {\n        return translatorT(t, 'glossary_termTooLong');\n      }\n    }\n\n    const source = entry[config.sourceLocale].trim().normalize('NFC').toLowerCase();\n\n    if (sources.has(source)) return translatorT(t, 'glossary_duplicateSource');\n    sources.add(source);\n  }\n\n  return true;\n};\n\nexport const validateGlossaryConfig = (config: GlossaryConfig): void => {\n  const locales = [config.sourceLocale, ...config.targetLocales];\n\n  if (!config.targetLocales.length || new Set(locales).size !== locales.length) {\n    throw new Error('The glossary requires distinct source and target locales.');\n  }\n  if (\n    locales.some(\n      (locale) =>\n        !/^[a-zA-Z][a-zA-Z0-9_]*$/.test(locale) ||\n        [\n          '__proto__',\n          'constructor',\n          'createdAt',\n          'id',\n          'prototype',\n          'sourceKey',\n          'updatedAt',\n        ].includes(locale),\n    )\n  ) {\n    throw new Error(\n      'Use valid Payload field names for glossary locales and map provider language codes in the resolver.',\n    );\n  }\n};\n"],"names":["translatorT","getGlossarySlug","config","slug","validateGlossaryEntries","value","t","Array","isArray","length","locales","sourceLocale","targetLocales","sources","Set","entry","locale","term","trim","test","toUpperCase","Buffer","byteLength","source","normalize","toLowerCase","has","add","validateGlossaryConfig","size","Error","some","includes"],"mappings":"AAGA,SAASA,WAAW,QAAQ,sBAAsB;AAWlD,OAAO,MAAMC,kBAAkB,CAACC,SAA2BA,OAAOC,IAAI,IAAI,uBAAuB;AAEjG,OAAO,MAAMC,0BAA0B,CACrCC,OACAH,QACAI;IAEA,IAAI,CAACC,MAAMC,OAAO,CAACH,UAAU,CAACA,MAAMI,MAAM,EAAE,OAAOT,YAAYM,GAAG;IAElE,MAAMI,UAAU;QAACR,OAAOS,YAAY;WAAKT,OAAOU,aAAa;KAAC;IAE9D,MAAMC,UAAU,IAAIC;IAEpB,KAAK,MAAMC,SAASV,MAAO;QACzB,KAAK,MAAMW,UAAUN,QAAS;YAC5B,MAAMO,OAAOF,OAAO,CAACC,OAAO;YAE5B,IACEA,WAAWd,OAAOS,YAAY,IAC7BM,CAAAA,QAAQ,QAAS,OAAOA,SAAS,YAAY,CAACA,KAAKC,IAAI,EAAE,GAC1D;gBACA;YACF;YACA,IAAI,OAAOD,SAAS,YAAY,CAACA,KAAKC,IAAI,MAAM,WAAWC,IAAI,CAACF,OAAO;gBACrE,OAAOjB,YAAYM,GAAG,wBAAwB;oBAC5CU,QAAQd,OAAOS,YAAY,CAACS,WAAW;gBACzC;YACF;YACA,IAAIC,OAAOC,UAAU,CAACL,KAAKC,IAAI,IAAI,UAAU,MAAM;gBACjD,OAAOlB,YAAYM,GAAG;YACxB;QACF;QAEA,MAAMiB,SAASR,KAAK,CAACb,OAAOS,YAAY,CAAC,CAACO,IAAI,GAAGM,SAAS,CAAC,OAAOC,WAAW;QAE7E,IAAIZ,QAAQa,GAAG,CAACH,SAAS,OAAOvB,YAAYM,GAAG;QAC/CO,QAAQc,GAAG,CAACJ;IACd;IAEA,OAAO;AACT,EAAE;AAEF,OAAO,MAAMK,yBAAyB,CAAC1B;IACrC,MAAMQ,UAAU;QAACR,OAAOS,YAAY;WAAKT,OAAOU,aAAa;KAAC;IAE9D,IAAI,CAACV,OAAOU,aAAa,CAACH,MAAM,IAAI,IAAIK,IAAIJ,SAASmB,IAAI,KAAKnB,QAAQD,MAAM,EAAE;QAC5E,MAAM,IAAIqB,MAAM;IAClB;IACA,IACEpB,QAAQqB,IAAI,CACV,CAACf,SACC,CAAC,0BAA0BG,IAAI,CAACH,WAChC;YACE;YACA;YACA;YACA;YACA;YACA;YACA;SACD,CAACgB,QAAQ,CAAChB,UAEf;QACA,MAAM,IAAIc,MACR;IAEJ;AACF,EAAE"}

package/dist/glossaryCollection.d.ts

@@ -0,0 +1,5 @@
+import type { CollectionConfig, PayloadRequest } from 'payload';
+import type { GlossaryConfig } from './glossary';
+export declare const getGlossaryEntriesSlug: (config: GlossaryConfig) => string;
+export declare const createGlossaryEntriesCollection: (config: GlossaryConfig, basePath: string, sync: (req: PayloadRequest, entry: Record<string, string>) => Promise<void>) => CollectionConfig;
+//# sourceMappingURL=glossaryCollection.d.ts.map

package/dist/glossaryCollection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glossaryCollection.d.ts","sourceRoot":"","sources":["../src/glossaryCollection.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAGhE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAKjD,eAAO,MAAM,sBAAsB,WAAY,cAAc,WACvB,CAAC;AAKvC,eAAO,MAAM,+BAA+B,WAClC,cAAc,YACZ,MAAM,QACV,CAAC,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,KAC1E,gBAkFF,CAAC"}