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

package/dist/node/views/Steps.js

@@ -0,0 +1,192 @@
+// src/components/StepChecklist.tsx
+import { Button } from "@contractspec/lib.design-system";
+import { cn } from "@contractspec/lib.ui-kit-core";
+import { jsxDEV } from "react/jsx-dev-runtime";
+"use client";
+function StepChecklist({
+  step,
+  stepNumber,
+  isCompleted,
+  isCurrent,
+  isExpanded,
+  onToggle,
+  onComplete
+}) {
+  return /* @__PURE__ */ jsxDEV("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__ */ jsxDEV("button", {
+        type: "button",
+        className: "flex w-full items-center gap-4 p-4 text-left",
+        onClick: onToggle,
+        children: [
+          /* @__PURE__ */ jsxDEV("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__ */ jsxDEV("div", {
+            className: "min-w-0 flex-1",
+            children: [
+              /* @__PURE__ */ jsxDEV("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__ */ jsxDEV("p", {
+                className: "text-muted-foreground truncate text-sm",
+                children: step.description
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this),
+          step.xpReward && /* @__PURE__ */ jsxDEV("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__ */ jsxDEV("span", {
+            className: cn("shrink-0 transition-transform", isExpanded && "rotate-180"),
+            children: "▼"
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      isExpanded && /* @__PURE__ */ jsxDEV("div", {
+        className: "border-t px-4 py-4",
+        children: [
+          step.description && /* @__PURE__ */ jsxDEV("p", {
+            className: "text-muted-foreground mb-4",
+            children: step.description
+          }, undefined, false, undefined, this),
+          step.instructions && /* @__PURE__ */ jsxDEV("div", {
+            className: "bg-muted mb-4 rounded-lg p-4",
+            children: [
+              /* @__PURE__ */ jsxDEV("p", {
+                className: "mb-2 text-sm font-medium",
+                children: "Instructions:"
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV("p", {
+                className: "text-muted-foreground text-sm",
+                children: step.instructions
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this),
+          /* @__PURE__ */ jsxDEV("div", {
+            className: "flex flex-wrap gap-2",
+            children: [
+              step.actionUrl && /* @__PURE__ */ jsxDEV(Button, {
+                variant: "outline",
+                size: "sm",
+                onClick: () => window.open(step.actionUrl, "_blank"),
+                children: step.actionLabel ?? "Try it"
+              }, undefined, false, undefined, this),
+              !isCompleted && /* @__PURE__ */ jsxDEV(Button, {
+                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 } from "@contractspec/lib.ui-kit-web/ui/progress";
+import { jsxDEV as jsxDEV2 } 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__ */ jsxDEV2("div", {
+    className: "space-y-6",
+    children: [
+      /* @__PURE__ */ jsxDEV2("div", {
+        className: "space-y-2",
+        children: [
+          /* @__PURE__ */ jsxDEV2("div", {
+            className: "flex items-center justify-between",
+            children: [
+              /* @__PURE__ */ jsxDEV2("h2", {
+                className: "text-xl font-bold",
+                children: "Complete Each Step"
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV2("span", {
+                className: "text-muted-foreground text-sm",
+                children: [
+                  completedSteps,
+                  " / ",
+                  totalSteps,
+                  " completed"
+                ]
+              }, undefined, true, undefined, this)
+            ]
+          }, undefined, true, undefined, this),
+          /* @__PURE__ */ jsxDEV2(Progress, {
+            value: percentComplete,
+            className: "h-2"
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV2("div", {
+        className: "space-y-3",
+        children: track.steps.map((step, index) => {
+          const isCompleted = progress.completedStepIds.includes(step.id);
+          const isCurrent = index === currentStepIndex;
+          return /* @__PURE__ */ jsxDEV2(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__ */ jsxDEV2("div", {
+        className: "rounded-lg border border-blue-500/30 bg-blue-500/5 p-4",
+        children: /* @__PURE__ */ jsxDEV2("p", {
+          className: "text-sm",
+          children: [
+            "\uD83C\uDF81 Complete all steps to unlock:",
+            track.completionRewards.xpBonus && /* @__PURE__ */ jsxDEV2("span", {
+              className: "ml-2 font-semibold text-blue-500",
+              children: [
+                "+",
+                track.completionRewards.xpBonus,
+                " XP bonus"
+              ]
+            }, undefined, true, undefined, this),
+            track.completionRewards.badgeKey && /* @__PURE__ */ jsxDEV2("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);
+}
+export {
+  Steps
+};

package/dist/node/views/Timeline.js

@@ -0,0 +1,213 @@
+// src/components/JourneyMap.tsx
+import { cn } from "@contractspec/lib.ui-kit-web/ui/utils";
+import { jsxDEV } 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__ */ jsxDEV("div", {
+    className: "relative overflow-x-auto pb-4",
+    children: /* @__PURE__ */ jsxDEV("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__ */ jsxDEV("div", {
+          className: "flex items-center",
+          children: [
+            /* @__PURE__ */ jsxDEV("div", {
+              className: "flex flex-col items-center gap-2",
+              children: [
+                /* @__PURE__ */ jsxDEV("div", {
+                  className: cn("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__ */ jsxDEV("div", {
+                  className: "text-center",
+                  children: /* @__PURE__ */ jsxDEV("p", {
+                    className: cn("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__ */ jsxDEV("div", {
+              className: cn("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,
+  CardContent,
+  CardHeader,
+  CardTitle
+} from "@contractspec/lib.ui-kit-web/ui/card";
+import { jsxDEV as jsxDEV2 } 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__ */ jsxDEV2("div", {
+    className: "space-y-6",
+    children: [
+      /* @__PURE__ */ jsxDEV2("div", {
+        className: "text-center",
+        children: [
+          /* @__PURE__ */ jsxDEV2("h2", {
+            className: "text-xl font-bold",
+            children: "Your Learning Journey"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV2("p", {
+            className: "text-muted-foreground",
+            children: "Follow the path through each surface and feature"
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV2(Card, {
+        children: [
+          /* @__PURE__ */ jsxDEV2(CardHeader, {
+            children: /* @__PURE__ */ jsxDEV2(CardTitle, {
+              className: "flex items-center gap-2",
+              children: [
+                /* @__PURE__ */ jsxDEV2("span", {
+                  children: "\uD83D\uDDFA️"
+                }, undefined, false, undefined, this),
+                /* @__PURE__ */ jsxDEV2("span", {
+                  children: "Journey Map"
+                }, undefined, false, undefined, this)
+              ]
+            }, undefined, true, undefined, this)
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV2(CardContent, {
+            children: /* @__PURE__ */ jsxDEV2(JourneyMap, {
+              steps: track.steps,
+              completedStepIds: progress.completedStepIds,
+              currentStepId
+            }, undefined, false, undefined, this)
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV2(Card, {
+        children: [
+          /* @__PURE__ */ jsxDEV2(CardHeader, {
+            children: /* @__PURE__ */ jsxDEV2(CardTitle, {
+              className: "flex items-center gap-2",
+              children: [
+                /* @__PURE__ */ jsxDEV2("span", {
+                  children: "\uD83D\uDCCD"
+                }, undefined, false, undefined, this),
+                /* @__PURE__ */ jsxDEV2("span", {
+                  children: "Step by Step"
+                }, undefined, false, undefined, this)
+              ]
+            }, undefined, true, undefined, this)
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV2(CardContent, {
+            children: /* @__PURE__ */ jsxDEV2("div", {
+              className: "relative",
+              children: [
+                /* @__PURE__ */ jsxDEV2("div", {
+                  className: "bg-border absolute top-0 left-4 h-full w-0.5"
+                }, undefined, false, undefined, this),
+                /* @__PURE__ */ jsxDEV2("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__ */ jsxDEV2("div", {
+                      className: "relative flex gap-4 pl-2",
+                      children: [
+                        /* @__PURE__ */ jsxDEV2("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__ */ jsxDEV2("div", {
+                          className: "flex-1 pb-2",
+                          children: /* @__PURE__ */ jsxDEV2("div", {
+                            className: "rounded-lg border p-4",
+                            children: [
+                              /* @__PURE__ */ jsxDEV2("div", {
+                                className: "flex items-start justify-between gap-2",
+                                children: [
+                                  /* @__PURE__ */ jsxDEV2("div", {
+                                    children: [
+                                      /* @__PURE__ */ jsxDEV2("div", {
+                                        className: "flex items-center gap-2",
+                                        children: [
+                                          /* @__PURE__ */ jsxDEV2("h4", {
+                                            className: `font-semibold ${isCompleted ? "text-green-500" : isCurrent ? "text-blue-500" : "text-foreground"}`,
+                                            children: step.title
+                                          }, undefined, false, undefined, this),
+                                          /* @__PURE__ */ jsxDEV2("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__ */ jsxDEV2("p", {
+                                        className: "text-muted-foreground mt-1 text-sm",
+                                        children: step.description
+                                      }, undefined, false, undefined, this)
+                                    ]
+                                  }, undefined, true, undefined, this),
+                                  step.xpReward && /* @__PURE__ */ jsxDEV2("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__ */ jsxDEV2("div", {
+                                className: "mt-3 text-xs",
+                                children: isCompleted ? /* @__PURE__ */ jsxDEV2("span", {
+                                  className: "text-green-500",
+                                  children: "✓ Completed"
+                                }, undefined, false, undefined, this) : isCurrent ? /* @__PURE__ */ jsxDEV2("span", {
+                                  className: "text-blue-500",
+                                  children: "→ In Progress"
+                                }, undefined, false, undefined, this) : /* @__PURE__ */ jsxDEV2("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);
+}
+export {
+  Timeline
+};