@contractspec/example.learning-journey-ui-onboarding 1.57.0 → 1.58.0

package/dist/browser/index.js

@@ -0,0 +1,1116 @@
+// src/views/Overview.tsx
+import { Button } from "@contractspec/lib.design-system";
+import {
+  Card,
+  CardContent,
+  CardHeader,
+  CardTitle
+} from "@contractspec/lib.ui-kit-web/ui/card";
+import { Progress } from "@contractspec/lib.ui-kit-web/ui/progress";
+import { XpBar } from "@contractspec/example.learning-journey-ui-shared";
+import { jsxDEV } from "react/jsx-dev-runtime";
+"use client";
+function Overview({
+  track,
+  progress,
+  onStart
+}) {
+  const totalSteps = track.steps.length;
+  const completedSteps = progress.completedStepIds.length;
+  const percentComplete = totalSteps > 0 ? completedSteps / totalSteps * 100 : 0;
+  const isComplete = completedSteps === totalSteps;
+  const remainingSteps = totalSteps - completedSteps;
+  const estimatedMinutes = remainingSteps * 5;
+  const totalXp = track.totalXp ?? track.steps.reduce((sum, s) => sum + (s.xpReward ?? 0), 0) + (track.completionRewards?.xpBonus ?? 0);
+  return /* @__PURE__ */ jsxDEV("div", {
+    className: "space-y-6",
+    children: [
+      /* @__PURE__ */ jsxDEV(Card, {
+        className: "overflow-hidden bg-gradient-to-r from-blue-500/10 via-violet-500/10 to-purple-500/10",
+        children: /* @__PURE__ */ jsxDEV(CardContent, {
+          className: "p-8",
+          children: /* @__PURE__ */ jsxDEV("div", {
+            className: "flex flex-col items-center gap-6 text-center md:flex-row md:text-left",
+            children: [
+              /* @__PURE__ */ jsxDEV("div", {
+                className: "flex h-20 w-20 items-center justify-center rounded-2xl bg-gradient-to-br from-blue-500 to-violet-600 text-4xl shadow-lg",
+                children: isComplete ? "\uD83C\uDF89" : "\uD83D\uDE80"
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV("div", {
+                className: "flex-1",
+                children: [
+                  /* @__PURE__ */ jsxDEV("h1", {
+                    className: "text-2xl font-bold",
+                    children: track.name
+                  }, undefined, false, undefined, this),
+                  /* @__PURE__ */ jsxDEV("p", {
+                    className: "text-muted-foreground mt-1 max-w-2xl",
+                    children: track.description
+                  }, undefined, false, undefined, this),
+                  !isComplete && /* @__PURE__ */ jsxDEV("p", {
+                    className: "text-muted-foreground mt-3 text-sm",
+                    children: [
+                      "⏱️ Estimated time:",
+                      " ",
+                      estimatedMinutes > 0 ? `~${estimatedMinutes} minutes` : "Less than a minute"
+                    ]
+                  }, undefined, true, undefined, this)
+                ]
+              }, undefined, true, undefined, this),
+              !isComplete && /* @__PURE__ */ jsxDEV(Button, {
+                size: "lg",
+                onClick: onStart,
+                children: completedSteps > 0 ? "Continue" : "Get Started"
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this)
+        }, undefined, false, undefined, this)
+      }, undefined, false, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "grid gap-4 md:grid-cols-3",
+        children: [
+          /* @__PURE__ */ jsxDEV(Card, {
+            children: [
+              /* @__PURE__ */ jsxDEV(CardHeader, {
+                className: "pb-2",
+                children: /* @__PURE__ */ jsxDEV(CardTitle, {
+                  className: "text-muted-foreground text-sm font-medium",
+                  children: "Progress"
+                }, undefined, false, undefined, this)
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV(CardContent, {
+                children: [
+                  /* @__PURE__ */ jsxDEV("div", {
+                    className: "text-3xl font-bold",
+                    children: [
+                      Math.round(percentComplete),
+                      "%"
+                    ]
+                  }, undefined, true, undefined, this),
+                  /* @__PURE__ */ jsxDEV(Progress, {
+                    value: percentComplete,
+                    className: "mt-2 h-2"
+                  }, undefined, false, undefined, this),
+                  /* @__PURE__ */ jsxDEV("p", {
+                    className: "text-muted-foreground mt-2 text-sm",
+                    children: [
+                      completedSteps,
+                      " of ",
+                      totalSteps,
+                      " steps completed"
+                    ]
+                  }, undefined, true, undefined, this)
+                ]
+              }, undefined, true, undefined, this)
+            ]
+          }, undefined, true, undefined, this),
+          /* @__PURE__ */ jsxDEV(Card, {
+            children: [
+              /* @__PURE__ */ jsxDEV(CardHeader, {
+                className: "pb-2",
+                children: /* @__PURE__ */ jsxDEV(CardTitle, {
+                  className: "text-muted-foreground text-sm font-medium",
+                  children: "XP Earned"
+                }, undefined, false, undefined, this)
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV(CardContent, {
+                children: [
+                  /* @__PURE__ */ jsxDEV("div", {
+                    className: "text-3xl font-bold text-blue-500",
+                    children: progress.xpEarned
+                  }, undefined, false, undefined, this),
+                  /* @__PURE__ */ jsxDEV(XpBar, {
+                    current: progress.xpEarned,
+                    max: totalXp,
+                    showLabel: false,
+                    size: "sm"
+                  }, undefined, false, undefined, this)
+                ]
+              }, undefined, true, undefined, this)
+            ]
+          }, undefined, true, undefined, this),
+          /* @__PURE__ */ jsxDEV(Card, {
+            children: [
+              /* @__PURE__ */ jsxDEV(CardHeader, {
+                className: "pb-2",
+                children: /* @__PURE__ */ jsxDEV(CardTitle, {
+                  className: "text-muted-foreground text-sm font-medium",
+                  children: "Time Remaining"
+                }, undefined, false, undefined, this)
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV(CardContent, {
+                children: [
+                  /* @__PURE__ */ jsxDEV("div", {
+                    className: "text-3xl font-bold",
+                    children: isComplete ? "✓" : `~${estimatedMinutes}m`
+                  }, undefined, false, undefined, this),
+                  /* @__PURE__ */ jsxDEV("p", {
+                    className: "text-muted-foreground mt-2 text-sm",
+                    children: isComplete ? "All done!" : `${remainingSteps} steps to go`
+                  }, undefined, false, undefined, this)
+                ]
+              }, undefined, true, undefined, this)
+            ]
+          }, undefined, true, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV(Card, {
+        children: [
+          /* @__PURE__ */ jsxDEV(CardHeader, {
+            children: /* @__PURE__ */ jsxDEV(CardTitle, {
+              className: "flex items-center gap-2",
+              children: [
+                /* @__PURE__ */ jsxDEV("span", {
+                  children: "\uD83D\uDCCB"
+                }, undefined, false, undefined, this),
+                /* @__PURE__ */ jsxDEV("span", {
+                  children: "Your Journey"
+                }, undefined, false, undefined, this)
+              ]
+            }, undefined, true, undefined, this)
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(CardContent, {
+            children: /* @__PURE__ */ jsxDEV("div", {
+              className: "space-y-3",
+              children: track.steps.map((step, index) => {
+                const isStepCompleted = progress.completedStepIds.includes(step.id);
+                const isCurrent = !isStepCompleted && track.steps.slice(0, index).every((s) => progress.completedStepIds.includes(s.id));
+                return /* @__PURE__ */ jsxDEV("div", {
+                  className: "flex items-center gap-4 rounded-lg border p-3",
+                  children: [
+                    /* @__PURE__ */ jsxDEV("div", {
+                      className: `flex h-8 w-8 shrink-0 items-center justify-center rounded-full text-sm font-semibold ${isStepCompleted ? "bg-green-500 text-white" : isCurrent ? "bg-blue-500 text-white" : "bg-muted text-muted-foreground"}`,
+                      children: isStepCompleted ? "✓" : index + 1
+                    }, undefined, false, undefined, this),
+                    /* @__PURE__ */ jsxDEV("div", {
+                      className: "min-w-0 flex-1",
+                      children: /* @__PURE__ */ jsxDEV("p", {
+                        className: `font-medium ${isStepCompleted ? "text-green-500" : isCurrent ? "text-foreground" : "text-muted-foreground"}`,
+                        children: step.title
+                      }, undefined, false, undefined, this)
+                    }, undefined, false, undefined, this),
+                    step.xpReward && /* @__PURE__ */ jsxDEV("span", {
+                      className: "text-muted-foreground text-sm",
+                      children: [
+                        "+",
+                        step.xpReward,
+                        " XP"
+                      ]
+                    }, undefined, true, undefined, this)
+                  ]
+                }, step.id, true, undefined, this);
+              })
+            }, undefined, false, undefined, this)
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      isComplete && /* @__PURE__ */ jsxDEV(Card, {
+        className: "border-green-500/50 bg-green-500/5",
+        children: /* @__PURE__ */ jsxDEV(CardContent, {
+          className: "flex items-center gap-4 p-6",
+          children: [
+            /* @__PURE__ */ jsxDEV("div", {
+              className: "text-4xl",
+              children: "\uD83C\uDF89"
+            }, undefined, false, undefined, this),
+            /* @__PURE__ */ jsxDEV("div", {
+              children: [
+                /* @__PURE__ */ jsxDEV("h3", {
+                  className: "text-lg font-semibold text-green-500",
+                  children: "Onboarding Complete!"
+                }, undefined, false, undefined, this),
+                /* @__PURE__ */ jsxDEV("p", {
+                  className: "text-muted-foreground",
+                  children: [
+                    "You've completed all ",
+                    totalSteps,
+                    " steps. Welcome aboard!"
+                  ]
+                }, undefined, true, undefined, this)
+              ]
+            }, undefined, true, undefined, this)
+          ]
+        }, undefined, true, undefined, this)
+      }, undefined, false, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+
+// src/components/StepChecklist.tsx
+import { Button as Button2 } from "@contractspec/lib.design-system";
+import { cn } from "@contractspec/lib.ui-kit-core";
+import { jsxDEV as jsxDEV2 } from "react/jsx-dev-runtime";
+"use client";
+function StepChecklist({
+  step,
+  stepNumber,
+  isCompleted,
+  isCurrent,
+  isExpanded,
+  onToggle,
+  onComplete
+}) {
+  return /* @__PURE__ */ jsxDEV2("div", {
+    className: cn("rounded-xl border transition-all", isCompleted && "border-green-500/50 bg-green-500/5", isCurrent && !isCompleted && "border-violet-500 bg-violet-500/5", !isCompleted && !isCurrent && "border-border"),
+    children: [
+      /* @__PURE__ */ jsxDEV2("button", {
+        type: "button",
+        className: "flex w-full items-center gap-4 p-4 text-left",
+        onClick: onToggle,
+        children: [
+          /* @__PURE__ */ jsxDEV2("div", {
+            className: cn("flex h-8 w-8 shrink-0 items-center justify-center rounded-full border-2 text-sm font-semibold transition-colors", isCompleted && "border-green-500 bg-green-500 text-white", isCurrent && !isCompleted && "border-violet-500 text-violet-500", !isCompleted && !isCurrent && "border-muted-foreground text-muted-foreground"),
+            children: isCompleted ? "✓" : stepNumber
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV2("div", {
+            className: "min-w-0 flex-1",
+            children: [
+              /* @__PURE__ */ jsxDEV2("h4", {
+                className: cn("font-semibold", isCompleted && "text-green-500", isCurrent && !isCompleted && "text-foreground", !isCompleted && !isCurrent && "text-muted-foreground"),
+                children: step.title
+              }, undefined, false, undefined, this),
+              !isExpanded && step.description && /* @__PURE__ */ jsxDEV2("p", {
+                className: "text-muted-foreground truncate text-sm",
+                children: step.description
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this),
+          step.xpReward && /* @__PURE__ */ jsxDEV2("span", {
+            className: cn("shrink-0 rounded-full px-2 py-1 text-xs font-semibold", isCompleted ? "bg-green-500/10 text-green-500" : "bg-muted text-muted-foreground"),
+            children: [
+              "+",
+              step.xpReward,
+              " XP"
+            ]
+          }, undefined, true, undefined, this),
+          /* @__PURE__ */ jsxDEV2("span", {
+            className: cn("shrink-0 transition-transform", isExpanded && "rotate-180"),
+            children: "▼"
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      isExpanded && /* @__PURE__ */ jsxDEV2("div", {
+        className: "border-t px-4 py-4",
+        children: [
+          step.description && /* @__PURE__ */ jsxDEV2("p", {
+            className: "text-muted-foreground mb-4",
+            children: step.description
+          }, undefined, false, undefined, this),
+          step.instructions && /* @__PURE__ */ jsxDEV2("div", {
+            className: "bg-muted mb-4 rounded-lg p-4",
+            children: [
+              /* @__PURE__ */ jsxDEV2("p", {
+                className: "mb-2 text-sm font-medium",
+                children: "Instructions:"
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV2("p", {
+                className: "text-muted-foreground text-sm",
+                children: step.instructions
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this),
+          /* @__PURE__ */ jsxDEV2("div", {
+            className: "flex flex-wrap gap-2",
+            children: [
+              step.actionUrl && /* @__PURE__ */ jsxDEV2(Button2, {
+                variant: "outline",
+                size: "sm",
+                onClick: () => window.open(step.actionUrl, "_blank"),
+                children: step.actionLabel ?? "Try it"
+              }, undefined, false, undefined, this),
+              !isCompleted && /* @__PURE__ */ jsxDEV2(Button2, {
+                size: "sm",
+                onClick: onComplete,
+                children: "Mark as Complete"
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this)
+        ]
+      }, undefined, true, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+
+// src/views/Steps.tsx
+import { useState } from "react";
+import { Progress as Progress2 } from "@contractspec/lib.ui-kit-web/ui/progress";
+import { jsxDEV as jsxDEV3 } from "react/jsx-dev-runtime";
+"use client";
+function Steps({ track, progress, onStepComplete }) {
+  const [expandedStepId, setExpandedStepId] = useState(() => {
+    const firstIncomplete = track.steps.find((s) => !progress.completedStepIds.includes(s.id));
+    return firstIncomplete?.id ?? null;
+  });
+  const completedSteps = progress.completedStepIds.length;
+  const totalSteps = track.steps.length;
+  const percentComplete = totalSteps > 0 ? completedSteps / totalSteps * 100 : 0;
+  const currentStepIndex = track.steps.findIndex((s) => !progress.completedStepIds.includes(s.id));
+  return /* @__PURE__ */ jsxDEV3("div", {
+    className: "space-y-6",
+    children: [
+      /* @__PURE__ */ jsxDEV3("div", {
+        className: "space-y-2",
+        children: [
+          /* @__PURE__ */ jsxDEV3("div", {
+            className: "flex items-center justify-between",
+            children: [
+              /* @__PURE__ */ jsxDEV3("h2", {
+                className: "text-xl font-bold",
+                children: "Complete Each Step"
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV3("span", {
+                className: "text-muted-foreground text-sm",
+                children: [
+                  completedSteps,
+                  " / ",
+                  totalSteps,
+                  " completed"
+                ]
+              }, undefined, true, undefined, this)
+            ]
+          }, undefined, true, undefined, this),
+          /* @__PURE__ */ jsxDEV3(Progress2, {
+            value: percentComplete,
+            className: "h-2"
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV3("div", {
+        className: "space-y-3",
+        children: track.steps.map((step, index) => {
+          const isCompleted = progress.completedStepIds.includes(step.id);
+          const isCurrent = index === currentStepIndex;
+          return /* @__PURE__ */ jsxDEV3(StepChecklist, {
+            step,
+            stepNumber: index + 1,
+            isCompleted,
+            isCurrent,
+            isExpanded: expandedStepId === step.id,
+            onToggle: () => setExpandedStepId(expandedStepId === step.id ? null : step.id),
+            onComplete: () => {
+              onStepComplete?.(step.id);
+              const nextStep = track.steps[index + 1];
+              if (nextStep && !progress.completedStepIds.includes(nextStep.id)) {
+                setExpandedStepId(nextStep.id);
+              }
+            }
+          }, step.id, false, undefined, this);
+        })
+      }, undefined, false, undefined, this),
+      track.completionRewards && percentComplete < 100 && /* @__PURE__ */ jsxDEV3("div", {
+        className: "rounded-lg border border-blue-500/30 bg-blue-500/5 p-4",
+        children: /* @__PURE__ */ jsxDEV3("p", {
+          className: "text-sm",
+          children: [
+            "\uD83C\uDF81 Complete all steps to unlock:",
+            track.completionRewards.xpBonus && /* @__PURE__ */ jsxDEV3("span", {
+              className: "ml-2 font-semibold text-blue-500",
+              children: [
+                "+",
+                track.completionRewards.xpBonus,
+                " XP bonus"
+              ]
+            }, undefined, true, undefined, this),
+            track.completionRewards.badgeKey && /* @__PURE__ */ jsxDEV3("span", {
+              className: "ml-2 font-semibold text-amber-500",
+              children: [
+                '+ "',
+                track.completionRewards.badgeKey,
+                '" badge'
+              ]
+            }, undefined, true, undefined, this)
+          ]
+        }, undefined, true, undefined, this)
+      }, undefined, false, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+
+// src/views/Progress.tsx
+import {
+  Card as Card2,
+  CardContent as CardContent2,
+  CardHeader as CardHeader2,
+  CardTitle as CardTitle2
+} from "@contractspec/lib.ui-kit-web/ui/card";
+import { Progress as Progress3 } from "@contractspec/lib.ui-kit-web/ui/progress";
+import {
+  XpBar as XpBar2,
+  BadgeDisplay
+} from "@contractspec/example.learning-journey-ui-shared";
+import { jsxDEV as jsxDEV4 } from "react/jsx-dev-runtime";
+"use client";
+function ProgressView({ track, progress }) {
+  const totalSteps = track.steps.length;
+  const completedSteps = progress.completedStepIds.length;
+  const percentComplete = totalSteps > 0 ? completedSteps / totalSteps * 100 : 0;
+  const totalXp = track.totalXp ?? track.steps.reduce((sum, s) => sum + (s.xpReward ?? 0), 0) + (track.completionRewards?.xpBonus ?? 0);
+  const remainingSteps = totalSteps - completedSteps;
+  const estimatedMinutes = remainingSteps * 5;
+  return /* @__PURE__ */ jsxDEV4("div", {
+    className: "space-y-6",
+    children: [
+      /* @__PURE__ */ jsxDEV4(Card2, {
+        children: [
+          /* @__PURE__ */ jsxDEV4(CardHeader2, {
+            children: /* @__PURE__ */ jsxDEV4(CardTitle2, {
+              className: "flex items-center gap-2",
+              children: [
+                /* @__PURE__ */ jsxDEV4("span", {
+                  children: "\uD83D\uDCC8"
+                }, undefined, false, undefined, this),
+                /* @__PURE__ */ jsxDEV4("span", {
+                  children: "Your Progress"
+                }, undefined, false, undefined, this)
+              ]
+            }, undefined, true, undefined, this)
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV4(CardContent2, {
+            className: "space-y-6",
+            children: [
+              /* @__PURE__ */ jsxDEV4("div", {
+                className: "flex items-center justify-center",
+                children: /* @__PURE__ */ jsxDEV4("div", {
+                  className: "relative flex h-40 w-40 items-center justify-center",
+                  children: [
+                    /* @__PURE__ */ jsxDEV4("svg", {
+                      className: "absolute h-full w-full -rotate-90",
+                      viewBox: "0 0 100 100",
+                      children: [
+                        /* @__PURE__ */ jsxDEV4("circle", {
+                          cx: "50",
+                          cy: "50",
+                          r: "45",
+                          fill: "none",
+                          strokeWidth: "8",
+                          className: "stroke-muted"
+                        }, undefined, false, undefined, this),
+                        /* @__PURE__ */ jsxDEV4("circle", {
+                          cx: "50",
+                          cy: "50",
+                          r: "45",
+                          fill: "none",
+                          strokeWidth: "8",
+                          strokeLinecap: "round",
+                          strokeDasharray: `${percentComplete * 2.83} 283`,
+                          className: "stroke-blue-500 transition-all duration-500"
+                        }, undefined, false, undefined, this)
+                      ]
+                    }, undefined, true, undefined, this),
+                    /* @__PURE__ */ jsxDEV4("div", {
+                      className: "text-center",
+                      children: [
+                        /* @__PURE__ */ jsxDEV4("div", {
+                          className: "text-3xl font-bold",
+                          children: [
+                            Math.round(percentComplete),
+                            "%"
+                          ]
+                        }, undefined, true, undefined, this),
+                        /* @__PURE__ */ jsxDEV4("div", {
+                          className: "text-muted-foreground text-sm",
+                          children: "Complete"
+                        }, undefined, false, undefined, this)
+                      ]
+                    }, undefined, true, undefined, this)
+                  ]
+                }, undefined, true, undefined, this)
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV4("div", {
+                className: "grid grid-cols-3 gap-4 text-center",
+                children: [
+                  /* @__PURE__ */ jsxDEV4("div", {
+                    children: [
+                      /* @__PURE__ */ jsxDEV4("div", {
+                        className: "text-2xl font-bold text-green-500",
+                        children: completedSteps
+                      }, undefined, false, undefined, this),
+                      /* @__PURE__ */ jsxDEV4("div", {
+                        className: "text-muted-foreground text-sm",
+                        children: "Completed"
+                      }, undefined, false, undefined, this)
+                    ]
+                  }, undefined, true, undefined, this),
+                  /* @__PURE__ */ jsxDEV4("div", {
+                    children: [
+                      /* @__PURE__ */ jsxDEV4("div", {
+                        className: "text-2xl font-bold text-orange-500",
+                        children: remainingSteps
+                      }, undefined, false, undefined, this),
+                      /* @__PURE__ */ jsxDEV4("div", {
+                        className: "text-muted-foreground text-sm",
+                        children: "Remaining"
+                      }, undefined, false, undefined, this)
+                    ]
+                  }, undefined, true, undefined, this),
+                  /* @__PURE__ */ jsxDEV4("div", {
+                    children: [
+                      /* @__PURE__ */ jsxDEV4("div", {
+                        className: "text-2xl font-bold",
+                        children: [
+                          estimatedMinutes,
+                          "m"
+                        ]
+                      }, undefined, true, undefined, this),
+                      /* @__PURE__ */ jsxDEV4("div", {
+                        className: "text-muted-foreground text-sm",
+                        children: "Est. Time"
+                      }, undefined, false, undefined, this)
+                    ]
+                  }, undefined, true, undefined, this)
+                ]
+              }, undefined, true, undefined, this)
+            ]
+          }, undefined, true, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV4(Card2, {
+        children: [
+          /* @__PURE__ */ jsxDEV4(CardHeader2, {
+            children: /* @__PURE__ */ jsxDEV4(CardTitle2, {
+              className: "flex items-center gap-2",
+              children: [
+                /* @__PURE__ */ jsxDEV4("span", {
+                  children: "⚡"
+                }, undefined, false, undefined, this),
+                /* @__PURE__ */ jsxDEV4("span", {
+                  children: "Experience Points"
+                }, undefined, false, undefined, this)
+              ]
+            }, undefined, true, undefined, this)
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV4(CardContent2, {
+            className: "space-y-4",
+            children: [
+              /* @__PURE__ */ jsxDEV4("div", {
+                className: "flex items-baseline gap-2",
+                children: [
+                  /* @__PURE__ */ jsxDEV4("span", {
+                    className: "text-3xl font-bold text-blue-500",
+                    children: progress.xpEarned
+                  }, undefined, false, undefined, this),
+                  /* @__PURE__ */ jsxDEV4("span", {
+                    className: "text-muted-foreground",
+                    children: [
+                      "/ ",
+                      totalXp,
+                      " XP"
+                    ]
+                  }, undefined, true, undefined, this)
+                ]
+              }, undefined, true, undefined, this),
+              /* @__PURE__ */ jsxDEV4(XpBar2, {
+                current: progress.xpEarned,
+                max: totalXp,
+                showLabel: false,
+                size: "lg"
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV4(Card2, {
+        children: [
+          /* @__PURE__ */ jsxDEV4(CardHeader2, {
+            children: /* @__PURE__ */ jsxDEV4(CardTitle2, {
+              className: "flex items-center gap-2",
+              children: [
+                /* @__PURE__ */ jsxDEV4("span", {
+                  children: "\uD83C\uDFC5"
+                }, undefined, false, undefined, this),
+                /* @__PURE__ */ jsxDEV4("span", {
+                  children: "Achievements"
+                }, undefined, false, undefined, this)
+              ]
+            }, undefined, true, undefined, this)
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV4(CardContent2, {
+            children: [
+              /* @__PURE__ */ jsxDEV4(BadgeDisplay, {
+                badges: progress.badges,
+                size: "lg"
+              }, undefined, false, undefined, this),
+              progress.badges.length === 0 && track.completionRewards?.badgeKey && /* @__PURE__ */ jsxDEV4("p", {
+                className: "text-muted-foreground text-sm",
+                children: [
+                  'Complete all steps to earn the "',
+                  track.completionRewards.badgeKey,
+                  '" badge!'
+                ]
+              }, undefined, true, undefined, this)
+            ]
+          }, undefined, true, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV4(Card2, {
+        children: [
+          /* @__PURE__ */ jsxDEV4(CardHeader2, {
+            children: /* @__PURE__ */ jsxDEV4(CardTitle2, {
+              className: "flex items-center gap-2",
+              children: [
+                /* @__PURE__ */ jsxDEV4("span", {
+                  children: "\uD83D\uDCCB"
+                }, undefined, false, undefined, this),
+                /* @__PURE__ */ jsxDEV4("span", {
+                  children: "Step Details"
+                }, undefined, false, undefined, this)
+              ]
+            }, undefined, true, undefined, this)
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV4(CardContent2, {
+            children: /* @__PURE__ */ jsxDEV4("div", {
+              className: "space-y-3",
+              children: track.steps.map((step, index) => {
+                const isCompleted = progress.completedStepIds.includes(step.id);
+                const stepProgress = isCompleted ? 100 : 0;
+                return /* @__PURE__ */ jsxDEV4("div", {
+                  className: "space-y-1",
+                  children: [
+                    /* @__PURE__ */ jsxDEV4("div", {
+                      className: "flex items-center justify-between text-sm",
+                      children: [
+                        /* @__PURE__ */ jsxDEV4("span", {
+                          className: isCompleted ? "text-green-500" : "text-foreground",
+                          children: [
+                            index + 1,
+                            ". ",
+                            step.title
+                          ]
+                        }, undefined, true, undefined, this),
+                        /* @__PURE__ */ jsxDEV4("span", {
+                          className: isCompleted ? "text-green-500" : "text-muted-foreground",
+                          children: isCompleted ? "✓" : "Pending"
+                        }, undefined, false, undefined, this)
+                      ]
+                    }, undefined, true, undefined, this),
+                    /* @__PURE__ */ jsxDEV4(Progress3, {
+                      value: stepProgress,
+                      className: "h-1"
+                    }, undefined, false, undefined, this)
+                  ]
+                }, step.id, true, undefined, this);
+              })
+            }, undefined, false, undefined, this)
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+// src/components/JourneyMap.tsx
+import { cn as cn2 } from "@contractspec/lib.ui-kit-web/ui/utils";
+import { jsxDEV as jsxDEV5 } from "react/jsx-dev-runtime";
+"use client";
+var SURFACE_ICONS = {
+  templates: "\uD83D\uDCCB",
+  "spec-editor": "✏️",
+  regenerator: "\uD83D\uDD04",
+  playground: "\uD83C\uDFAE",
+  evolution: "\uD83E\uDD16",
+  dashboard: "\uD83D\uDCCA",
+  settings: "⚙️",
+  default: "\uD83D\uDCCD"
+};
+function JourneyMap({
+  steps,
+  completedStepIds,
+  currentStepId
+}) {
+  return /* @__PURE__ */ jsxDEV5("div", {
+    className: "relative overflow-x-auto pb-4",
+    children: /* @__PURE__ */ jsxDEV5("div", {
+      className: "flex min-w-max items-center gap-2",
+      children: steps.map((step, index) => {
+        const isCompleted = completedStepIds.includes(step.id);
+        const isCurrent = step.id === currentStepId;
+        const surface = step.metadata?.surface ?? "default";
+        const icon = SURFACE_ICONS[surface] ?? SURFACE_ICONS.default;
+        return /* @__PURE__ */ jsxDEV5("div", {
+          className: "flex items-center",
+          children: [
+            /* @__PURE__ */ jsxDEV5("div", {
+              className: "flex flex-col items-center gap-2",
+              children: [
+                /* @__PURE__ */ jsxDEV5("div", {
+                  className: cn2("flex h-14 w-14 items-center justify-center rounded-2xl border-2 text-2xl transition-all", isCompleted && "border-green-500 bg-green-500/10", isCurrent && !isCompleted && "border-violet-500 bg-violet-500/10 ring-4 ring-violet-500/20", !isCompleted && !isCurrent && "border-muted bg-muted/50"),
+                  children: isCompleted ? "✓" : icon
+                }, undefined, false, undefined, this),
+                /* @__PURE__ */ jsxDEV5("div", {
+                  className: "text-center",
+                  children: /* @__PURE__ */ jsxDEV5("p", {
+                    className: cn2("max-w-[100px] truncate text-xs font-medium", isCompleted && "text-green-500", isCurrent && !isCompleted && "text-violet-500", !isCompleted && !isCurrent && "text-muted-foreground"),
+                    children: step.title
+                  }, undefined, false, undefined, this)
+                }, undefined, false, undefined, this)
+              ]
+            }, undefined, true, undefined, this),
+            index < steps.length - 1 && /* @__PURE__ */ jsxDEV5("div", {
+              className: cn2("mx-2 h-1 w-8 rounded-full transition-colors", completedStepIds.includes(steps[index + 1]?.id ?? "") ? "bg-green-500" : isCompleted ? "bg-green-500/50" : "bg-muted")
+            }, undefined, false, undefined, this)
+          ]
+        }, step.id, true, undefined, this);
+      })
+    }, undefined, false, undefined, this)
+  }, undefined, false, undefined, this);
+}
+
+// src/views/Timeline.tsx
+import {
+  Card as Card3,
+  CardContent as CardContent3,
+  CardHeader as CardHeader3,
+  CardTitle as CardTitle3
+} from "@contractspec/lib.ui-kit-web/ui/card";
+import { jsxDEV as jsxDEV6 } from "react/jsx-dev-runtime";
+"use client";
+function Timeline({ track, progress }) {
+  const currentStepId = track.steps.find((s) => !progress.completedStepIds.includes(s.id))?.id ?? null;
+  return /* @__PURE__ */ jsxDEV6("div", {
+    className: "space-y-6",
+    children: [
+      /* @__PURE__ */ jsxDEV6("div", {
+        className: "text-center",
+        children: [
+          /* @__PURE__ */ jsxDEV6("h2", {
+            className: "text-xl font-bold",
+            children: "Your Learning Journey"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV6("p", {
+            className: "text-muted-foreground",
+            children: "Follow the path through each surface and feature"
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV6(Card3, {
+        children: [
+          /* @__PURE__ */ jsxDEV6(CardHeader3, {
+            children: /* @__PURE__ */ jsxDEV6(CardTitle3, {
+              className: "flex items-center gap-2",
+              children: [
+                /* @__PURE__ */ jsxDEV6("span", {
+                  children: "\uD83D\uDDFA️"
+                }, undefined, false, undefined, this),
+                /* @__PURE__ */ jsxDEV6("span", {
+                  children: "Journey Map"
+                }, undefined, false, undefined, this)
+              ]
+            }, undefined, true, undefined, this)
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV6(CardContent3, {
+            children: /* @__PURE__ */ jsxDEV6(JourneyMap, {
+              steps: track.steps,
+              completedStepIds: progress.completedStepIds,
+              currentStepId
+            }, undefined, false, undefined, this)
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV6(Card3, {
+        children: [
+          /* @__PURE__ */ jsxDEV6(CardHeader3, {
+            children: /* @__PURE__ */ jsxDEV6(CardTitle3, {
+              className: "flex items-center gap-2",
+              children: [
+                /* @__PURE__ */ jsxDEV6("span", {
+                  children: "\uD83D\uDCCD"
+                }, undefined, false, undefined, this),
+                /* @__PURE__ */ jsxDEV6("span", {
+                  children: "Step by Step"
+                }, undefined, false, undefined, this)
+              ]
+            }, undefined, true, undefined, this)
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV6(CardContent3, {
+            children: /* @__PURE__ */ jsxDEV6("div", {
+              className: "relative",
+              children: [
+                /* @__PURE__ */ jsxDEV6("div", {
+                  className: "bg-border absolute top-0 left-4 h-full w-0.5"
+                }, undefined, false, undefined, this),
+                /* @__PURE__ */ jsxDEV6("div", {
+                  className: "space-y-6",
+                  children: track.steps.map((step, index) => {
+                    const isCompleted = progress.completedStepIds.includes(step.id);
+                    const isCurrent = step.id === currentStepId;
+                    const surface = step.metadata?.surface ?? "general";
+                    return /* @__PURE__ */ jsxDEV6("div", {
+                      className: "relative flex gap-4 pl-2",
+                      children: [
+                        /* @__PURE__ */ jsxDEV6("div", {
+                          className: `relative z-10 flex h-8 w-8 shrink-0 items-center justify-center rounded-full border-2 transition-all ${isCompleted ? "border-green-500 bg-green-500 text-white" : isCurrent ? "border-blue-500 bg-blue-500 text-white ring-4 ring-blue-500/20" : "border-border bg-background text-muted-foreground"}`,
+                          children: isCompleted ? "✓" : index + 1
+                        }, undefined, false, undefined, this),
+                        /* @__PURE__ */ jsxDEV6("div", {
+                          className: "flex-1 pb-2",
+                          children: /* @__PURE__ */ jsxDEV6("div", {
+                            className: "rounded-lg border p-4",
+                            children: [
+                              /* @__PURE__ */ jsxDEV6("div", {
+                                className: "flex items-start justify-between gap-2",
+                                children: [
+                                  /* @__PURE__ */ jsxDEV6("div", {
+                                    children: [
+                                      /* @__PURE__ */ jsxDEV6("div", {
+                                        className: "flex items-center gap-2",
+                                        children: [
+                                          /* @__PURE__ */ jsxDEV6("h4", {
+                                            className: `font-semibold ${isCompleted ? "text-green-500" : isCurrent ? "text-blue-500" : "text-foreground"}`,
+                                            children: step.title
+                                          }, undefined, false, undefined, this),
+                                          /* @__PURE__ */ jsxDEV6("span", {
+                                            className: "bg-muted text-muted-foreground rounded px-2 py-0.5 text-xs",
+                                            children: surface
+                                          }, undefined, false, undefined, this)
+                                        ]
+                                      }, undefined, true, undefined, this),
+                                      /* @__PURE__ */ jsxDEV6("p", {
+                                        className: "text-muted-foreground mt-1 text-sm",
+                                        children: step.description
+                                      }, undefined, false, undefined, this)
+                                    ]
+                                  }, undefined, true, undefined, this),
+                                  step.xpReward && /* @__PURE__ */ jsxDEV6("span", {
+                                    className: `shrink-0 rounded-full px-2 py-1 text-xs font-semibold ${isCompleted ? "bg-green-500/10 text-green-500" : "bg-muted text-muted-foreground"}`,
+                                    children: [
+                                      "+",
+                                      step.xpReward,
+                                      " XP"
+                                    ]
+                                  }, undefined, true, undefined, this)
+                                ]
+                              }, undefined, true, undefined, this),
+                              /* @__PURE__ */ jsxDEV6("div", {
+                                className: "mt-3 text-xs",
+                                children: isCompleted ? /* @__PURE__ */ jsxDEV6("span", {
+                                  className: "text-green-500",
+                                  children: "✓ Completed"
+                                }, undefined, false, undefined, this) : isCurrent ? /* @__PURE__ */ jsxDEV6("span", {
+                                  className: "text-blue-500",
+                                  children: "→ In Progress"
+                                }, undefined, false, undefined, this) : /* @__PURE__ */ jsxDEV6("span", {
+                                  className: "text-muted-foreground",
+                                  children: "○ Not Started"
+                                }, undefined, false, undefined, this)
+                              }, undefined, false, undefined, this)
+                            ]
+                          }, undefined, true, undefined, this)
+                        }, undefined, false, undefined, this)
+                      ]
+                    }, step.id, true, undefined, this);
+                  })
+                }, undefined, false, undefined, this)
+              ]
+            }, undefined, true, undefined, this)
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+
+// src/OnboardingMiniApp.tsx
+import { useState as useState2, useCallback } from "react";
+import { Card as Card4, CardContent as CardContent4 } from "@contractspec/lib.ui-kit-web/ui/card";
+import {
+  ViewTabs,
+  useLearningProgress
+} from "@contractspec/example.learning-journey-ui-shared";
+import { jsxDEV as jsxDEV7 } from "react/jsx-dev-runtime";
+"use client";
+function OnboardingMiniApp({
+  track,
+  progress: externalProgress,
+  onStepComplete: externalOnStepComplete,
+  onViewChange,
+  initialView = "overview"
+}) {
+  const [currentView, setCurrentView] = useState2(initialView);
+  const { progress: internalProgress, completeStep: internalCompleteStep } = useLearningProgress(track);
+  const progress = externalProgress ?? internalProgress;
+  const handleViewChange = useCallback((view) => {
+    setCurrentView(view);
+    onViewChange?.(view);
+  }, [onViewChange]);
+  const handleStepComplete = useCallback((stepId) => {
+    if (externalOnStepComplete) {
+      externalOnStepComplete(stepId);
+    } else {
+      internalCompleteStep(stepId);
+    }
+  }, [externalOnStepComplete, internalCompleteStep]);
+  const handleStartFromOverview = useCallback(() => {
+    setCurrentView("steps");
+    onViewChange?.("steps");
+  }, [onViewChange]);
+  const renderView = () => {
+    const viewProps = {
+      track,
+      progress,
+      onStepComplete: handleStepComplete
+    };
+    switch (currentView) {
+      case "overview":
+        return /* @__PURE__ */ jsxDEV7(Overview, {
+          ...viewProps,
+          onStart: handleStartFromOverview
+        }, undefined, false, undefined, this);
+      case "steps":
+        return /* @__PURE__ */ jsxDEV7(Steps, {
+          ...viewProps
+        }, undefined, false, undefined, this);
+      case "progress":
+        return /* @__PURE__ */ jsxDEV7(ProgressView, {
+          ...viewProps
+        }, undefined, false, undefined, this);
+      case "timeline":
+        return /* @__PURE__ */ jsxDEV7(Timeline, {
+          ...viewProps
+        }, undefined, false, undefined, this);
+      default:
+        return /* @__PURE__ */ jsxDEV7(Overview, {
+          ...viewProps,
+          onStart: handleStartFromOverview
+        }, undefined, false, undefined, this);
+    }
+  };
+  return /* @__PURE__ */ jsxDEV7("div", {
+    className: "space-y-6",
+    children: [
+      /* @__PURE__ */ jsxDEV7(Card4, {
+        children: /* @__PURE__ */ jsxDEV7(CardContent4, {
+          className: "p-4",
+          children: /* @__PURE__ */ jsxDEV7(ViewTabs, {
+            currentView,
+            onViewChange: handleViewChange
+          }, undefined, false, undefined, this)
+        }, undefined, false, undefined, this)
+      }, undefined, false, undefined, this),
+      renderView()
+    ]
+  }, undefined, true, undefined, this);
+}
+
+// src/components/CodeSnippet.tsx
+import { useState as useState3 } from "react";
+import { Button as Button3 } from "@contractspec/lib.design-system";
+import { jsxDEV as jsxDEV8, Fragment } from "react/jsx-dev-runtime";
+"use client";
+function CodeSnippet({
+  code,
+  language = "typescript",
+  title
+}) {
+  const [copied, setCopied] = useState3(false);
+  const handleCopy = async () => {
+    await navigator.clipboard.writeText(code);
+    setCopied(true);
+    setTimeout(() => setCopied(false), 2000);
+  };
+  return /* @__PURE__ */ jsxDEV8("div", {
+    className: "bg-muted/50 overflow-hidden rounded-lg border",
+    children: [
+      /* @__PURE__ */ jsxDEV8("div", {
+        className: "bg-muted flex items-center justify-between border-b px-4 py-2",
+        children: [
+          /* @__PURE__ */ jsxDEV8("div", {
+            className: "flex items-center gap-2",
+            children: [
+              /* @__PURE__ */ jsxDEV8("span", {
+                className: "text-muted-foreground text-xs font-medium uppercase",
+                children: language
+              }, undefined, false, undefined, this),
+              title && /* @__PURE__ */ jsxDEV8(Fragment, {
+                children: [
+                  /* @__PURE__ */ jsxDEV8("span", {
+                    className: "text-muted-foreground",
+                    children: "•"
+                  }, undefined, false, undefined, this),
+                  /* @__PURE__ */ jsxDEV8("span", {
+                    className: "text-sm",
+                    children: title
+                  }, undefined, false, undefined, this)
+                ]
+              }, undefined, true, undefined, this)
+            ]
+          }, undefined, true, undefined, this),
+          /* @__PURE__ */ jsxDEV8(Button3, {
+            variant: "ghost",
+            size: "sm",
+            onClick: handleCopy,
+            className: "h-7 text-xs",
+            children: copied ? "✓ Copied" : "Copy"
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV8("pre", {
+        className: "overflow-x-auto p-4",
+        children: /* @__PURE__ */ jsxDEV8("code", {
+          className: "text-sm",
+          children: code
+        }, undefined, false, undefined, this)
+      }, undefined, false, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+// src/docs/learning-journey-ui-onboarding.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var blocks = [
+  {
+    id: "docs.examples.learning-journey-ui-onboarding",
+    title: "Learning Journey UI — Onboarding",
+    summary: "UI mini-app components for onboarding: checklists, snippets, and journey mapping.",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/examples/learning-journey-ui-onboarding",
+    tags: ["learning", "ui", "onboarding"],
+    body: `## Includes
+- Onboarding mini-app shell
+- Views: overview, steps, progress, timeline
+- Components: step checklist, code snippet, journey map
+
+## Notes
+- Compose with design system components.
+- Ensure accessible labels and keyboard navigation.`
+  }
+];
+registerDocBlocks(blocks);
+// src/example.ts
+import { defineExample } from "@contractspec/lib.contracts";
+var example = defineExample({
+  meta: {
+    key: "learning-journey-ui-onboarding",
+    version: "1.0.0",
+    title: "Learning Journey UI — Onboarding",
+    description: "UI mini-app for onboarding patterns: checklists, code snippets, journey map.",
+    kind: "ui",
+    visibility: "public",
+    stability: "experimental",
+    owners: ["@platform.core"],
+    tags: ["learning", "ui", "onboarding"]
+  },
+  docs: {
+    rootDocId: "docs.examples.learning-journey-ui-onboarding"
+  },
+  entrypoints: {
+    packageName: "@contractspec/example.learning-journey-ui-onboarding",
+    docs: "./docs"
+  },
+  surfaces: {
+    templates: true,
+    sandbox: { enabled: true, modes: ["playground", "markdown"] },
+    studio: { enabled: true, installable: true },
+    mcp: { enabled: true }
+  }
+});
+var example_default = example;
+export {
+  example_default as example,
+  Timeline,
+  Steps,
+  StepChecklist,
+  ProgressView as Progress,
+  Overview,
+  OnboardingMiniApp,
+  JourneyMap,
+  CodeSnippet
+};