@dappermountain/payload-plugin-achievements 0.2.3 → 0.2.5

package/README.md

@@ -133,9 +133,13 @@ When your Payload config enables **`localization`**, catalog display fields are
 
 | Collection | Localized | Not localized |
 | --- | --- | --- |
-| Achievements / tiers | `name`, `description` | `slug`, rules, flags |
+| Achievements / tiers | `name` (text), `description` (**Lexical** rich text) | `slug`, rules, flags |
 | Metrics / event types | `name` | `slug`, system flags |
 
+Tier `icon` is a searchable Lucide picker in Admin (stores the kebab-case name, e.g. `sparkles`). Hosts must peer-depend on `@payloadcms/richtext-lexical` and `lucide-react` (same major as Payload). After upgrading, run `payload generate:importmap` and push/migrate schema so `description` columns accept JSON.
+
+Progress / `GET /api/achievements/me` pass through catalog `description` as **Lexical** (same as the collection document). Convert to HTML/plaintext in the UI with `@payloadcms/richtext-lexical` helpers (`convertLexicalToHTML`, `convertLexicalToPlaintext`) — the plugin also exports `descriptionToPlaintext` / `plainTextToLexical` for hosts.
+
 UI chrome and validation messages ship in English. Application UI copy stays in your app’s i18n layer — the plugin does not inject host translation dictionaries. Seed extra locales yourself after the English system catalog is in place.
 
 ## Configuration reference

package/dist/admin/LucideIconField.d.ts

@@ -0,0 +1,6 @@
+import type { TextFieldClientComponent } from 'payload';
+/**
+ * Searchable Lucide icon picker. Stores the kebab-case Lucide name (e.g. `sparkles`).
+ */
+export declare const LucideIconField: TextFieldClientComponent;
+//# sourceMappingURL=LucideIconField.d.ts.map

package/dist/admin/LucideIconField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LucideIconField.d.ts","sourceRoot":"","sources":["../../src/admin/LucideIconField.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,wBAAwB,EAAgB,MAAM,SAAS,CAAA;AA4BrE;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,wBA4D7B,CAAA"}

package/dist/admin/LucideIconField.js

@@ -0,0 +1,56 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { FieldDescription, FieldError, FieldLabel, SelectInput, useField } from '@payloadcms/ui';
+import { icons } from 'lucide-react';
+import { useMemo } from 'react';
+function toKebabCase(pascal) {
+    return pascal
+        .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
+        .replace(/([A-Z])([A-Z][a-z])/g, '$1-$2')
+        .toLowerCase();
+}
+function toPascalCase(kebab) {
+    return kebab
+        .split('-')
+        .filter(Boolean)
+        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+        .join('');
+}
+const ICON_OPTIONS = Object.keys(icons)
+    .filter((key) => /^[A-Z]/.test(key))
+    .map((pascal) => {
+    const value = toKebabCase(pascal);
+    return { label: value, value };
+})
+    .sort((a, b) => a.value.localeCompare(b.value));
+/**
+ * Searchable Lucide icon picker. Stores the kebab-case Lucide name (e.g. `sparkles`).
+ */
+export const LucideIconField = (props) => {
+    const { field, path: pathFromProps, readOnly } = props;
+    const path = pathFromProps ?? field?.name ?? 'icon';
+    const { errorMessage, setValue, showError, value } = useField({
+        path,
+    });
+    const selected = typeof value === 'string' && value.length > 0 ? value : undefined;
+    const PreviewIcon = selected
+        ? icons[toPascalCase(selected)]
+        : undefined;
+    const options = useMemo(() => ICON_OPTIONS, []);
+    return (_jsxs("div", { className: "field-type", children: [_jsx(FieldLabel, { label: field?.label ?? 'Icon', path: path, required: Boolean(field?.required) }), _jsxs("div", { style: { alignItems: 'center', display: 'flex', gap: '0.75rem' }, children: [_jsx("div", { "aria-hidden": true, style: {
+                            alignItems: 'center',
+                            border: '1px solid var(--theme-elevation-150)',
+                            borderRadius: 6,
+                            display: 'flex',
+                            flexShrink: 0,
+                            height: 40,
+                            justifyContent: 'center',
+                            width: 40,
+                        }, children: PreviewIcon ? (_jsx(PreviewIcon, { size: 20 })) : (_jsx("span", { style: { color: 'var(--theme-elevation-400)', fontSize: 12 }, children: "\u2014" })) }), _jsx("div", { style: { flex: 1, minWidth: 0 }, children: _jsx(SelectInput, { isClearable: true, name: path, onChange: (option) => {
+                                if (Array.isArray(option)) {
+                                    setValue(option[0]?.value ?? null);
+                                    return;
+                                }
+                                setValue(option?.value ?? null);
+                            }, options: options, path: path, readOnly: Boolean(readOnly), value: selected }) })] }), _jsx(FieldDescription, { description: field?.admin?.description, path: path }), _jsx(FieldError, { message: errorMessage, path: path, showError: showError })] }));
+};

package/dist/collections/Tiers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/collections/Tiers/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAQ/C,wBAAgB,oBAAoB,IAAI,gBAAgB,CAwFvD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/collections/Tiers/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAQ/C,wBAAgB,oBAAoB,IAAI,gBAAgB,CA2FvD"}

package/dist/collections/Tiers/index.js

@@ -49,7 +49,10 @@ export function buildTiersCollection() {
                         type: 'text',
                         admin: {
                             width: mediaCollection ? '50%' : '100%',
-                            description: 'Optional icon key your app maps (e.g. Lucide names: sparkles, shield, crown, gem). Used on the rank ladder when no image is set.',
+                            description: 'Optional Lucide icon for the rank ladder when no image is set (searchable by name).',
+                            components: {
+                                Field: '@dappermountain/payload-plugin-achievements/client#LucideIconField',
+                            },
                         },
                     },
                     ...(mediaCollection

package/dist/collections/fields/localizedText.d.ts

@@ -6,5 +6,6 @@ import type { Field } from 'payload';
 export declare function localizedNameField(admin?: {
     width?: string;
 }): Field;
+/** Catalog blurb — Lexical in Admin; seed may still pass plain strings (coerced). */
 export declare function localizedDescriptionField(): Field;
 //# sourceMappingURL=localizedText.d.ts.map

package/dist/collections/fields/localizedText.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"localizedText.d.ts","sourceRoot":"","sources":["../../../src/collections/fields/localizedText.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAEpC;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,KAAK,CAQpE;AAED,wBAAgB,yBAAyB,IAAI,KAAK,CAMjD"}
+{"version":3,"file":"localizedText.d.ts","sourceRoot":"","sources":["../../../src/collections/fields/localizedText.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAgBpC;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,KAAK,CAQpE;AAED,qFAAqF;AACrF,wBAAgB,yBAAyB,IAAI,KAAK,CA4BjD"}

package/dist/collections/fields/localizedText.js

@@ -1,3 +1,5 @@
+import { BoldFeature, FixedToolbarFeature, InlineToolbarFeature, ItalicFeature, LinkFeature, OrderedListFeature, ParagraphFeature, UnderlineFeature, UnorderedListFeature, lexicalEditor, } from '@payloadcms/richtext-lexical';
+import { plainTextToLexical } from '../../fields/plainTextToLexical.js';
 /**
  * Display copy for catalog rows. Localized when the host enables Payload `localization`.
  * Slugs stay non-localized identifiers for rules and code.
@@ -11,10 +13,35 @@ export function localizedNameField(admin) {
         ...(admin ? { admin } : {}),
     };
 }
+/** Catalog blurb — Lexical in Admin; seed may still pass plain strings (coerced). */
 export function localizedDescriptionField() {
     return {
         name: 'description',
-        type: 'textarea',
+        type: 'richText',
         localized: true,
+        editor: lexicalEditor({
+            features: () => [
+                ParagraphFeature(),
+                BoldFeature(),
+                ItalicFeature(),
+                UnderlineFeature(),
+                UnorderedListFeature(),
+                OrderedListFeature(),
+                LinkFeature(),
+                FixedToolbarFeature(),
+                InlineToolbarFeature(),
+            ],
+        }),
+        hooks: {
+            beforeValidate: [
+                ({ value }) => {
+                    if (value == null || value === '')
+                        return value;
+                    if (typeof value === 'string')
+                        return plainTextToLexical(value);
+                    return value;
+                },
+            ],
+        },
     };
 }

package/dist/collections/fields/usersAchievementsGroup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usersAchievementsGroup.d.ts","sourceRoot":"","sources":["../../../src/collections/fields/usersAchievementsGroup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAEpC,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAA;AAEnE;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,0BAA0B,GAAG,KAAK,CAgCjF"}
+{"version":3,"file":"usersAchievementsGroup.d.ts","sourceRoot":"","sources":["../../../src/collections/fields/usersAchievementsGroup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAEpC,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAA;AAEnE;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,0BAA0B,GAAG,KAAK,CAiCjF"}

package/dist/collections/fields/usersAchievementsGroup.js

@@ -17,7 +17,8 @@ export function usersAchievementsGroup(options) {
                 collection: slugs.grants,
                 on: 'user',
                 admin: {
-                    allowCreate: false,
+                    // Create from the user doc — Payload pre-fills `user` on the grant drawer.
+                    allowCreate: true,
                     defaultColumns: ['achievement', 'completedAt', 'scope'],
                 },
             },

package/dist/exports/client.d.ts

@@ -1,4 +1,5 @@
 export { ActorField } from '../admin/ActorField.js';
+export { LucideIconField } from '../admin/LucideIconField.js';
 export { MetricChangeField } from '../admin/MetricChangeField.js';
 export { MetricField } from '../admin/MetricField.js';
 export { ReconcileProgressionButton } from '../admin/ReconcileProgressionButton.js';

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,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AACrD,OAAO,EAAE,0BAA0B,EAAE,MAAM,wCAAwC,CAAA"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/exports/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AACrD,OAAO,EAAE,0BAA0B,EAAE,MAAM,wCAAwC,CAAA"}

package/dist/exports/client.js

@@ -1,4 +1,5 @@
 export { ActorField } from '../admin/ActorField.js';
+export { LucideIconField } from '../admin/LucideIconField.js';
 export { MetricChangeField } from '../admin/MetricChangeField.js';
 export { MetricField } from '../admin/MetricField.js';
 export { ReconcileProgressionButton } from '../admin/ReconcileProgressionButton.js';

package/dist/fields/descriptionPlaintext.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Progress / me APIs expose catalog blurbs as plain strings for search and simple UI.
+ * Admin stores Lexical JSON; legacy string rows still work.
+ */
+export declare function descriptionToPlaintext(value: unknown): string | undefined;
+//# sourceMappingURL=descriptionPlaintext.d.ts.map

package/dist/fields/descriptionPlaintext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptionPlaintext.d.ts","sourceRoot":"","sources":["../../src/fields/descriptionPlaintext.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAgBzE"}

package/dist/fields/descriptionPlaintext.js

@@ -0,0 +1,24 @@
+import { convertLexicalToPlaintext } from '@payloadcms/richtext-lexical/plaintext';
+/**
+ * Progress / me APIs expose catalog blurbs as plain strings for search and simple UI.
+ * Admin stores Lexical JSON; legacy string rows still work.
+ */
+export function descriptionToPlaintext(value) {
+    if (value == null)
+        return undefined;
+    if (typeof value === 'string') {
+        const trimmed = value.trim();
+        return trimmed.length > 0 ? trimmed : undefined;
+    }
+    if (typeof value !== 'object')
+        return undefined;
+    try {
+        const plaintext = convertLexicalToPlaintext({
+            data: value,
+        }).trim();
+        return plaintext.length > 0 ? plaintext : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}

package/dist/fields/plainTextToLexical.d.ts

@@ -0,0 +1,7 @@
+import type { SerializedEditorState } from '@payloadcms/richtext-lexical/lexical';
+/**
+ * Minimal Lexical editor state for a single paragraph of plain text.
+ * Used by seed + beforeValidate coercion when hosts still pass strings.
+ */
+export declare function plainTextToLexical(text: string): SerializedEditorState;
+//# sourceMappingURL=plainTextToLexical.d.ts.map

package/dist/fields/plainTextToLexical.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plainTextToLexical.d.ts","sourceRoot":"","sources":["../../src/fields/plainTextToLexical.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAA;AAEjF;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB,CAmCtE"}

package/dist/fields/plainTextToLexical.js

@@ -0,0 +1,40 @@
+/**
+ * Minimal Lexical editor state for a single paragraph of plain text.
+ * Used by seed + beforeValidate coercion when hosts still pass strings.
+ */
+export function plainTextToLexical(text) {
+    const trimmed = text.trim();
+    return {
+        root: {
+            type: 'root',
+            format: '',
+            indent: 0,
+            version: 1,
+            direction: 'ltr',
+            children: [
+                {
+                    type: 'paragraph',
+                    format: '',
+                    indent: 0,
+                    version: 1,
+                    direction: 'ltr',
+                    textFormat: 0,
+                    textStyle: '',
+                    children: trimmed
+                        ? [
+                            {
+                                type: 'text',
+                                text: trimmed,
+                                detail: 0,
+                                format: 0,
+                                mode: 'normal',
+                                style: '',
+                                version: 1,
+                            },
+                        ]
+                        : [],
+                },
+            ],
+        },
+    };
+}

package/dist/index.d.ts

@@ -10,4 +10,6 @@ export { DEFAULT_COLLECTION_BASE_SLUGS, DEFAULT_COLLECTION_PREFIX, DEFAULT_ADMIN
 export { DEFAULT_ME_ENDPOINT_PATH, DEFAULT_RECONCILE_ENDPOINT_PATH } from './defaults.js';
 export { collectionOf, slugOf } from './collections/helpers.js';
 export { isAchievementPluginEnabled } from './enabled.js';
+export { descriptionToPlaintext } from './fields/descriptionPlaintext.js';
+export { plainTextToLexical } from './fields/plainTextToLexical.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,+BAA+B,EAC/B,kBAAkB,EAClB,cAAc,GACf,MAAM,cAAc,CAAA;AACrB,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AACzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAC1E,YAAY,EACV,0BAA0B,EAC1B,yBAAyB,EACzB,oBAAoB,EACpB,4BAA4B,EAC5B,mBAAmB,GACpB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,8BAA8B,EAC9B,0BAA0B,EAC1B,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,SAAS,EACT,kBAAkB,EAClB,oBAAoB,EACpB,wBAAwB,EACxB,gCAAgC,EAChC,yBAAyB,EACzB,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,EACxB,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,EACxB,UAAU,EACV,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,iCAAiC,CAAA;AACxC,YAAY,EACV,YAAY,EACZ,SAAS,EACT,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,UAAU,EACV,iBAAiB,EACjB,wBAAwB,EACxB,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,iCAAiC,CAAA;AACxC,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,wBAAwB,EACxB,6BAA6B,EAC7B,6BAA6B,EAC7B,2BAA2B,EAC3B,wBAAwB,EACxB,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,6BAA6B,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AACtH,OAAO,EAAE,wBAAwB,EAAE,+BAA+B,EAAE,MAAM,eAAe,CAAA;AACzF,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAA;AAC/D,OAAO,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,+BAA+B,EAC/B,kBAAkB,EAClB,cAAc,GACf,MAAM,cAAc,CAAA;AACrB,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AACzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAC1E,YAAY,EACV,0BAA0B,EAC1B,yBAAyB,EACzB,oBAAoB,EACpB,4BAA4B,EAC5B,mBAAmB,GACpB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,8BAA8B,EAC9B,0BAA0B,EAC1B,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,SAAS,EACT,kBAAkB,EAClB,oBAAoB,EACpB,wBAAwB,EACxB,gCAAgC,EAChC,yBAAyB,EACzB,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,EACxB,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,EACxB,UAAU,EACV,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,iCAAiC,CAAA;AACxC,YAAY,EACV,YAAY,EACZ,SAAS,EACT,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,UAAU,EACV,iBAAiB,EACjB,wBAAwB,EACxB,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,iCAAiC,CAAA;AACxC,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,wBAAwB,EACxB,6BAA6B,EAC7B,6BAA6B,EAC7B,2BAA2B,EAC3B,wBAAwB,EACxB,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,6BAA6B,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AACtH,OAAO,EAAE,wBAAwB,EAAE,+BAA+B,EAAE,MAAM,eAAe,CAAA;AACzF,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAA;AAC/D,OAAO,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAA;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAA;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA"}

package/dist/index.js

@@ -6,3 +6,5 @@ export { DEFAULT_COLLECTION_BASE_SLUGS, DEFAULT_COLLECTION_PREFIX, DEFAULT_ADMIN
 export { DEFAULT_ME_ENDPOINT_PATH, DEFAULT_RECONCILE_ENDPOINT_PATH } from './defaults.js';
 export { collectionOf, slugOf } from './collections/helpers.js';
 export { isAchievementPluginEnabled } from './enabled.js';
+export { descriptionToPlaintext } from './fields/descriptionPlaintext.js';
+export { plainTextToLexical } from './fields/plainTextToLexical.js';

package/dist/seed/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/seed/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAMtC,mGAAmG;AACnG,MAAM,MAAM,4BAA4B,GAAG,MAAM,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;CAAE,CAAA;AAExG,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,4BAA4B,CAAA;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,4BAA4B,CAAA;IAC1C,sFAAsF;IACtF,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,qFAAqF;IACrF,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,8FAA8F;IAC9F,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;KAAE,CAAA;CACrG,CAAA;AAED,MAAM,MAAM,0BAA0B,GAAG;IACvC,IAAI,EAAE,4BAA4B,CAAA;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,4BAA4B,CAAA;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;KAAE,CAAA;IACzG,qGAAqG;IACrG,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;KAAE,CAAA;CACzG,CAAA;AAED,MAAM,MAAM,yBAAyB,GAAG;IACtC,IAAI,EAAE,4BAA4B,CAAA;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,yEAAyE;IACzE,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,gFAAgF;IAChF,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,UAAU,CAAC,EAAE,yBAAyB,EAAE,CAAA;IACxC,OAAO,CAAC,EAAE,yBAAyB,EAAE,CAAA;IACrC,KAAK,CAAC,EAAE,mBAAmB,EAAE,CAAA;IAC7B,YAAY,CAAC,EAAE,0BAA0B,EAAE,CAAA;IAC3C,gEAAgE;IAChE,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAA;CAClC,CAAA;AAmMD,2FAA2F;AAC3F,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmB5F;AAiCD;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmLnG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/seed/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAOtC,mGAAmG;AACnG,MAAM,MAAM,4BAA4B,GAAG,MAAM,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;CAAE,CAAA;AAExG,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,4BAA4B,CAAA;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,4BAA4B,CAAA;IAC1C,sFAAsF;IACtF,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,qFAAqF;IACrF,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,8FAA8F;IAC9F,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;KAAE,CAAA;CACrG,CAAA;AAED,MAAM,MAAM,0BAA0B,GAAG;IACvC,IAAI,EAAE,4BAA4B,CAAA;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,4BAA4B,CAAA;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;KAAE,CAAA;IACzG,qGAAqG;IACrG,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;KAAE,CAAA;CACzG,CAAA;AAED,MAAM,MAAM,yBAAyB,GAAG;IACtC,IAAI,EAAE,4BAA4B,CAAA;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,yEAAyE;IACzE,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,gFAAgF;IAChF,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,UAAU,CAAC,EAAE,yBAAyB,EAAE,CAAA;IACxC,OAAO,CAAC,EAAE,yBAAyB,EAAE,CAAA;IACrC,KAAK,CAAC,EAAE,mBAAmB,EAAE,CAAA;IAC7B,YAAY,CAAC,EAAE,0BAA0B,EAAE,CAAA;IAC3C,gEAAgE;IAChE,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAA;CAClC,CAAA;AAmMD,2FAA2F;AAC3F,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmB5F;AAiCD;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqLnG"}

package/dist/seed/index.js

@@ -1,5 +1,6 @@
 import { ENGINE_EVENT_TYPES, ENGINE_METRICS } from '../catalog.js';
 import { collectionOf } from '../collections/helpers.js';
+import { plainTextToLexical } from '../fields/plainTextToLexical.js';
 import { normalizeRuleGroup } from '../services/achievement/evaluateRules.js';
 function localizedParts(value) {
     if (value == null)
@@ -31,7 +32,7 @@ async function writeLocalizedFields(payload, args) {
             data: {
                 ...(locale === 'en' ? base : {}),
                 ...(name != null ? { name } : {}),
-                ...(description != null ? { description } : {}),
+                ...(description != null ? { description: plainTextToLexical(description) } : {}),
             },
             locale: locale,
             overrideAccess: true,
@@ -242,7 +243,7 @@ export async function seedAchievements(payload, input) {
                     ...baseData,
                     name: nameParts.en ?? tier.slug,
                     ...(localizedParts(tier.description).en != null
-                        ? { description: localizedParts(tier.description).en }
+                        ? { description: plainTextToLexical(localizedParts(tier.description).en) }
                         : {}),
                 },
                 locale: 'en',
@@ -290,7 +291,9 @@ export async function seedAchievements(payload, input) {
                 data: {
                     ...baseData,
                     name: nameParts.en ?? achievement.slug,
-                    ...(descriptionParts.en != null ? { description: descriptionParts.en } : {}),
+                    ...(descriptionParts.en != null
+                        ? { description: plainTextToLexical(descriptionParts.en) }
+                        : {}),
                 },
                 locale: 'en',
                 overrideAccess: true,

package/dist/services/achievement/buildCatalogProgressGroups.d.ts

@@ -2,7 +2,8 @@ export type CatalogProgressItem = {
     id: string;
     name?: string;
     slug?: string;
-    description?: string;
+    /** Same as the achievement collection field (Lexical JSON, or legacy string). */
+    description?: unknown;
     completedAt?: string | null;
     earned: boolean;
 };
@@ -10,14 +11,15 @@ export type CatalogProgressGroup = {
     id: string;
     title: string;
     slug?: string;
-    description?: string;
+    /** Same as the achievement collection field (Lexical JSON, or legacy string). */
+    description?: unknown;
     items: CatalogProgressItem[];
 };
 type CatalogDoc = {
     id: string;
     name?: string;
     slug?: string;
-    description?: string | null;
+    description?: unknown;
     completionRules?: unknown;
 };
 type GrantDoc = {

package/dist/services/achievement/buildCatalogProgressGroups.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buildCatalogProgressGroups.d.ts","sourceRoot":"","sources":["../../../src/services/achievement/buildCatalogProgressGroups.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,MAAM,EAAE,OAAO,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,EAAE,mBAAmB,EAAE,CAAA;CAC7B,CAAA;AAED,KAAK,UAAU,GAAG;IAChB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B,CAAA;AAED,KAAK,QAAQ,GAAG;IACd,EAAE,EAAE,MAAM,CAAA;IACV,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB,CAAA;AAWD;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE;IAC/C,YAAY,EAAE,UAAU,EAAE,CAAA;IAC1B,MAAM,EAAE,QAAQ,EAAE,CAAA;CACnB,GAAG,oBAAoB,EAAE,CA2DzB"}
+{"version":3,"file":"buildCatalogProgressGroups.d.ts","sourceRoot":"","sources":["../../../src/services/achievement/buildCatalogProgressGroups.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,iFAAiF;IACjF,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,MAAM,EAAE,OAAO,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,iFAAiF;IACjF,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,KAAK,EAAE,mBAAmB,EAAE,CAAA;CAC7B,CAAA;AAED,KAAK,UAAU,GAAG;IAChB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B,CAAA;AAED,KAAK,QAAQ,GAAG;IACd,EAAE,EAAE,MAAM,CAAA;IACV,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB,CAAA;AAiBD;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE;IAC/C,YAAY,EAAE,UAAU,EAAE,CAAA;IAC1B,MAAM,EAAE,QAAQ,EAAE,CAAA;CACnB,GAAG,oBAAoB,EAAE,CAyDzB"}

package/dist/services/achievement/buildCatalogProgressGroups.js

@@ -7,6 +7,13 @@ function grantKey(achievement) {
         : '';
     return { id, slug };
 }
+function passDescription(value) {
+    if (typeof value === 'string' && value.trim().length > 0)
+        return value;
+    if (value != null && typeof value === 'object')
+        return value;
+    return undefined;
+}
 /**
  * Groups catalog achievements by composite parents (`completionRules`).
  * Children follow completion-rule order. Unearned children stay in the list with `earned: false`.
@@ -27,14 +34,13 @@ export function buildCatalogProgressGroups(args) {
         .map((doc) => [String(doc.slug), doc]));
     const toItem = (doc) => {
         const grant = grantsById.get(doc.id) ?? (doc.slug ? grantsBySlug.get(doc.slug) : undefined);
+        const description = passDescription(doc.description);
         return {
             id: doc.id,
             earned: Boolean(grant),
             ...(typeof doc.name === 'string' && doc.name ? { name: doc.name } : {}),
             ...(typeof doc.slug === 'string' && doc.slug ? { slug: doc.slug } : {}),
-            ...(typeof doc.description === 'string' && doc.description
-                ? { description: doc.description }
-                : {}),
+            ...(description !== undefined ? { description } : {}),
             completedAt: grant?.completedAt ?? null,
         };
     };
@@ -56,13 +62,12 @@ export function buildCatalogProgressGroups(args) {
             seen.add(child.id);
             items.push(toItem(child));
         }
+        const description = passDescription(parent.description);
         return {
             id: parent.id,
             title: parent.name || parent.slug || parent.id,
             ...(parent.slug ? { slug: parent.slug } : {}),
-            ...(typeof parent.description === 'string' && parent.description
-                ? { description: parent.description }
-                : {}),
+            ...(description !== undefined ? { description } : {}),
             items,
         };
     });

package/dist/services/achievement/getUserProgress.d.ts

@@ -1,9 +1,10 @@
 import type { PaginatedDocs, Payload, PayloadRequest } from 'payload';
+/** Catalog slice — `description` matches the collection (Lexical JSON, or legacy string). */
 type LeanCatalog = {
     id: string;
     name?: string;
     slug?: string;
-    description?: string;
+    description?: unknown;
 };
 type LeanTier = LeanCatalog & {
     rank?: number;

package/dist/services/achievement/getUserProgress.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getUserProgress.d.ts","sourceRoot":"","sources":["../../../src/services/achievement/getUserProgress.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAOrE,KAAK,WAAW,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AACrF,KAAK,QAAQ,GAAG,WAAW,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAA;AAExE,MAAM,MAAM,qBAAqB,GAAG;IAClC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB,CAAA;AAiBD,iBAAS,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;EAU9C;AAED,iBAAS,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;EAShD;AAoBD,MAAM,MAAM,sBAAsB,GAAG,aAAa,CAAC,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC,GAAG;IACjF,sCAAsC;IACtC,KAAK,EAAE,QAAQ,EAAE,CAAA;IACjB,QAAQ,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,EAAE,CAAA;CAC3C,CAAA;AAkED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,OAAO,EAAE,OAAO,CAAA;IAChB,GAAG,CAAC,EAAE,cAAc,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,MAAM,CAAC,EAAE,qBAAqB,CAAA;IAC9B,0FAA0F;IAC1F,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAiDlC"}
+{"version":3,"file":"getUserProgress.d.ts","sourceRoot":"","sources":["../../../src/services/achievement/getUserProgress.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAOrE,6FAA6F;AAC7F,KAAK,WAAW,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,CAAA;AACtF,KAAK,QAAQ,GAAG,WAAW,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAA;AAExE,MAAM,MAAM,qBAAqB,GAAG;IAClC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB,CAAA;AAmBD,iBAAS,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;EAU9C;AAED,iBAAS,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;EAShD;AAoBD,MAAM,MAAM,sBAAsB,GAAG,aAAa,CAAC,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC,GAAG;IACjF,sCAAsC;IACtC,KAAK,EAAE,QAAQ,EAAE,CAAA;IACjB,QAAQ,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,EAAE,CAAA;CAC3C,CAAA;AAkED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,OAAO,EAAE,OAAO,CAAA;IAChB,GAAG,CAAC,EAAE,cAAc,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,MAAM,CAAC,EAAE,qBAAqB,CAAA;IAC9B,0FAA0F;IAC1F,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAiDlC"}

package/dist/services/achievement/getUserProgress.js

@@ -9,13 +9,14 @@ function leanCatalog(value) {
     if (!value || typeof value !== 'object')
         return { id };
     const row = value;
+    const description = row.description;
+    const hasDescription = (typeof description === 'string' && description.trim().length > 0) ||
+        (description != null && typeof description === 'object');
     return {
         id,
         ...(typeof row.name === 'string' && row.name ? { name: row.name } : {}),
         ...(typeof row.slug === 'string' && row.slug ? { slug: row.slug } : {}),
-        ...(typeof row.description === 'string' && row.description
-            ? { description: row.description }
-            : {}),
+        ...(hasDescription ? { description } : {}),
     };
 }
 function leanGrant(doc) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dappermountain/payload-plugin-achievements",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "description": "A robust, Admin-configured achievements engine for Payload: composable unlock rules, derived rank progress, request/review grants, metrics, and scoped multi-tenant support.",
   "license": "MIT",
   "type": "module",
@@ -69,16 +69,20 @@
     "skills:check": "bunx skills check -p"
   },
   "peerDependencies": {
+    "@payloadcms/richtext-lexical": "^3.88.0",
     "@payloadcms/ui": "^3.88.0",
+    "lucide-react": "^0.543.0",
     "payload": "^3.88.0",
     "react": "^19.0.0"
   },
   "devDependencies": {
     "@dappermountain/agent-payload": "^0.1.5",
     "@dappermountain/agent-practices": "^0.1.2",
+    "@payloadcms/richtext-lexical": "3.88.0",
     "@payloadcms/ui": "3.88.0",
     "@types/bun": "1.4.0",
     "@types/react": "^19.0.0",
+    "lucide-react": "0.543.0",
     "payload": "3.88.0",
     "prettier": "^3.6.2",
     "react": "19.2.4",