feat(xp): expose experience descriptions

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>

src/app/(frontend)/layout.tsx

@@ -58,6 +58,7 @@ export default async function RootLayout(props: { children: React.ReactNode }) {
 
   let xpLevel: ResolvedLevel = {
     levelName: "Recruit",
+    levelDesc: "",
     progress: 0,
     currentLevelXP: 0,
     nextLevelXP: null,
@@ -96,6 +97,7 @@ export default async function RootLayout(props: { children: React.ReactNode }) {
         limit: 100,
         select: {
           name: true,
+          description: true,
           requiredPoints: true,
         },
       }),
@@ -156,11 +158,7 @@ export default async function RootLayout(props: { children: React.ReactNode }) {
         {user && <GameTickRealtime />}
         {isLogistics && <ShipmentToasts />}
         <Toaster />
-        <ShimLoader
+        <ShimLoader shims={shimEntries} userId={user?.id ?? null} userRoles={user?.roles ?? []} />
-          shims={shimEntries}
-          userId={user?.id ?? null}
-          userRoles={user?.roles ?? []}
-        />
       </body>
     </html>
   );

src/app/(frontend)/page.tsx

@@ -38,7 +38,7 @@ export default async function HomePage() {
       collection: "experience",
       sort: "requiredPoints",
       limit: 100,
-      select: { name: true, requiredPoints: true },
+      select: { name: true, description: true, requiredPoints: true },
     }),
     payload.find({
       collection: "assignments",

src/utils/xp/resolveLevel.ts

@@ -1,10 +1,14 @@
+import { convertLexicalToPlaintext } from "@payloadcms/richtext-lexical/plaintext";
+
 export type ExperienceLevel = {
   name: string;
+  description: any;
   requiredPoints: number;
 };
 
 export type ResolvedLevel = {
   levelName: string;
+  levelDesc: string;
   progress: number;
   currentLevelXP: number;
   nextLevelXP: number | null;
@@ -19,13 +23,11 @@ export type ResolvedLevel = {
  * current bracket: (xp - currentLevelXP) / (nextLevelXP - currentLevelXP).
  * At the max level the bar sits at 100%.
  */
-export function resolveLevel(
+export function resolveLevel(xp: number, levels: ExperienceLevel[]): ResolvedLevel {
-  xp: number,
-  levels: ExperienceLevel[],
-): ResolvedLevel {
   if (levels.length === 0) {
     return {
       levelName: "Unknown",
+      levelDesc: "Could not retrieve description.",
       progress: 0,
       currentLevelXP: 0,
       nextLevelXP: null,
@@ -60,6 +62,9 @@ export function resolveLevel(
 
   return {
     levelName: current.name,
+    levelDesc:
+      convertLexicalToPlaintext({ data: current.description }) ||
+      "Failed to retrieve description!",
     progress: Math.min(Math.max(progress, 0), 100),
     currentLevelXP,
     nextLevelXP,