@lssm/example.learning-journey-ui-onboarding 0.0.0-canary-20251212210835

package/dist/views-DBF-jKGQ.mjs

@@ -0,0 +1,504 @@
+import { n as StepChecklist, t as JourneyMap } from "./JourneyMap-C6APUTsI.mjs";
+import { useState } from "react";
+import { Card, CardContent, CardHeader, CardTitle } from "@lssm/lib.ui-kit-web/ui/card";
+import { BadgeDisplay, XpBar } from "@lssm/example.learning-journey-ui-shared";
+import { Button } from "@lssm/lib.design-system";
+import { Progress } from "@lssm/lib.ui-kit-web/ui/progress";
+import { jsx, jsxs } from "react/jsx-runtime";
+
+//#region src/views/Overview.tsx
+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__ */ jsxs("div", {
+		className: "space-y-6",
+		children: [
+			/* @__PURE__ */ jsx(Card, {
+				className: "overflow-hidden bg-gradient-to-r from-blue-500/10 via-violet-500/10 to-purple-500/10",
+				children: /* @__PURE__ */ jsx(CardContent, {
+					className: "p-8",
+					children: /* @__PURE__ */ jsxs("div", {
+						className: "flex flex-col items-center gap-6 text-center md:flex-row md:text-left",
+						children: [
+							/* @__PURE__ */ jsx("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 ? "🎉" : "🚀"
+							}),
+							/* @__PURE__ */ jsxs("div", {
+								className: "flex-1",
+								children: [
+									/* @__PURE__ */ jsx("h1", {
+										className: "text-2xl font-bold",
+										children: track.name
+									}),
+									/* @__PURE__ */ jsx("p", {
+										className: "text-muted-foreground mt-1 max-w-2xl",
+										children: track.description
+									}),
+									!isComplete && /* @__PURE__ */ jsxs("p", {
+										className: "text-muted-foreground mt-3 text-sm",
+										children: [
+											"⏱️ Estimated time:",
+											" ",
+											estimatedMinutes > 0 ? `~${estimatedMinutes} minutes` : "Less than a minute"
+										]
+									})
+								]
+							}),
+							!isComplete && /* @__PURE__ */ jsx(Button, {
+								size: "lg",
+								onClick: onStart,
+								children: completedSteps > 0 ? "Continue" : "Get Started"
+							})
+						]
+					})
+				})
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "grid gap-4 md:grid-cols-3",
+				children: [
+					/* @__PURE__ */ jsxs(Card, { children: [/* @__PURE__ */ jsx(CardHeader, {
+						className: "pb-2",
+						children: /* @__PURE__ */ jsx(CardTitle, {
+							className: "text-muted-foreground text-sm font-medium",
+							children: "Progress"
+						})
+					}), /* @__PURE__ */ jsxs(CardContent, { children: [
+						/* @__PURE__ */ jsxs("div", {
+							className: "text-3xl font-bold",
+							children: [Math.round(percentComplete), "%"]
+						}),
+						/* @__PURE__ */ jsx(Progress, {
+							value: percentComplete,
+							className: "mt-2 h-2"
+						}),
+						/* @__PURE__ */ jsxs("p", {
+							className: "text-muted-foreground mt-2 text-sm",
+							children: [
+								completedSteps,
+								" of ",
+								totalSteps,
+								" steps completed"
+							]
+						})
+					] })] }),
+					/* @__PURE__ */ jsxs(Card, { children: [/* @__PURE__ */ jsx(CardHeader, {
+						className: "pb-2",
+						children: /* @__PURE__ */ jsx(CardTitle, {
+							className: "text-muted-foreground text-sm font-medium",
+							children: "XP Earned"
+						})
+					}), /* @__PURE__ */ jsxs(CardContent, { children: [/* @__PURE__ */ jsx("div", {
+						className: "text-3xl font-bold text-blue-500",
+						children: progress.xpEarned
+					}), /* @__PURE__ */ jsx(XpBar, {
+						current: progress.xpEarned,
+						max: totalXp,
+						showLabel: false,
+						size: "sm"
+					})] })] }),
+					/* @__PURE__ */ jsxs(Card, { children: [/* @__PURE__ */ jsx(CardHeader, {
+						className: "pb-2",
+						children: /* @__PURE__ */ jsx(CardTitle, {
+							className: "text-muted-foreground text-sm font-medium",
+							children: "Time Remaining"
+						})
+					}), /* @__PURE__ */ jsxs(CardContent, { children: [/* @__PURE__ */ jsx("div", {
+						className: "text-3xl font-bold",
+						children: isComplete ? "✓" : `~${estimatedMinutes}m`
+					}), /* @__PURE__ */ jsx("p", {
+						className: "text-muted-foreground mt-2 text-sm",
+						children: isComplete ? "All done!" : `${remainingSteps} steps to go`
+					})] })] })
+				]
+			}),
+			/* @__PURE__ */ jsxs(Card, { children: [/* @__PURE__ */ jsx(CardHeader, { children: /* @__PURE__ */ jsxs(CardTitle, {
+				className: "flex items-center gap-2",
+				children: [/* @__PURE__ */ jsx("span", { children: "📋" }), /* @__PURE__ */ jsx("span", { children: "Your Journey" })]
+			}) }), /* @__PURE__ */ jsx(CardContent, { children: /* @__PURE__ */ jsx("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__ */ jsxs("div", {
+						className: "flex items-center gap-4 rounded-lg border p-3",
+						children: [
+							/* @__PURE__ */ jsx("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
+							}),
+							/* @__PURE__ */ jsx("div", {
+								className: "min-w-0 flex-1",
+								children: /* @__PURE__ */ jsx("p", {
+									className: `font-medium ${isStepCompleted ? "text-green-500" : isCurrent ? "text-foreground" : "text-muted-foreground"}`,
+									children: step.title
+								})
+							}),
+							step.xpReward && /* @__PURE__ */ jsxs("span", {
+								className: "text-muted-foreground text-sm",
+								children: [
+									"+",
+									step.xpReward,
+									" XP"
+								]
+							})
+						]
+					}, step.id);
+				})
+			}) })] }),
+			isComplete && /* @__PURE__ */ jsx(Card, {
+				className: "border-green-500/50 bg-green-500/5",
+				children: /* @__PURE__ */ jsxs(CardContent, {
+					className: "flex items-center gap-4 p-6",
+					children: [/* @__PURE__ */ jsx("div", {
+						className: "text-4xl",
+						children: "🎉"
+					}), /* @__PURE__ */ jsxs("div", { children: [/* @__PURE__ */ jsx("h3", {
+						className: "text-lg font-semibold text-green-500",
+						children: "Onboarding Complete!"
+					}), /* @__PURE__ */ jsxs("p", {
+						className: "text-muted-foreground",
+						children: [
+							"You've completed all ",
+							totalSteps,
+							" steps. Welcome aboard!"
+						]
+					})] })]
+				})
+			})
+		]
+	});
+}
+
+//#endregion
+//#region src/views/Steps.tsx
+function Steps({ track, progress, onStepComplete }) {
+	const [expandedStepId, setExpandedStepId] = useState(() => {
+		return track.steps.find((s) => !progress.completedStepIds.includes(s.id))?.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__ */ jsxs("div", {
+		className: "space-y-6",
+		children: [
+			/* @__PURE__ */ jsxs("div", {
+				className: "space-y-2",
+				children: [/* @__PURE__ */ jsxs("div", {
+					className: "flex items-center justify-between",
+					children: [/* @__PURE__ */ jsx("h2", {
+						className: "text-xl font-bold",
+						children: "Complete Each Step"
+					}), /* @__PURE__ */ jsxs("span", {
+						className: "text-muted-foreground text-sm",
+						children: [
+							completedSteps,
+							" / ",
+							totalSteps,
+							" completed"
+						]
+					})]
+				}), /* @__PURE__ */ jsx(Progress, {
+					value: percentComplete,
+					className: "h-2"
+				})]
+			}),
+			/* @__PURE__ */ jsx("div", {
+				className: "space-y-3",
+				children: track.steps.map((step, index) => {
+					const isCompleted = progress.completedStepIds.includes(step.id);
+					const isCurrent = index === currentStepIndex;
+					return /* @__PURE__ */ jsx(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);
+				})
+			}),
+			track.completionRewards && percentComplete < 100 && /* @__PURE__ */ jsx("div", {
+				className: "rounded-lg border border-blue-500/30 bg-blue-500/5 p-4",
+				children: /* @__PURE__ */ jsxs("p", {
+					className: "text-sm",
+					children: [
+						"🎁 Complete all steps to unlock:",
+						track.completionRewards.xpBonus && /* @__PURE__ */ jsxs("span", {
+							className: "ml-2 font-semibold text-blue-500",
+							children: [
+								"+",
+								track.completionRewards.xpBonus,
+								" XP bonus"
+							]
+						}),
+						track.completionRewards.badgeKey && /* @__PURE__ */ jsxs("span", {
+							className: "ml-2 font-semibold text-amber-500",
+							children: [
+								"+ \"",
+								track.completionRewards.badgeKey,
+								"\" badge"
+							]
+						})
+					]
+				})
+			})
+		]
+	});
+}
+
+//#endregion
+//#region src/views/Progress.tsx
+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__ */ jsxs("div", {
+		className: "space-y-6",
+		children: [
+			/* @__PURE__ */ jsxs(Card, { children: [/* @__PURE__ */ jsx(CardHeader, { children: /* @__PURE__ */ jsxs(CardTitle, {
+				className: "flex items-center gap-2",
+				children: [/* @__PURE__ */ jsx("span", { children: "📈" }), /* @__PURE__ */ jsx("span", { children: "Your Progress" })]
+			}) }), /* @__PURE__ */ jsxs(CardContent, {
+				className: "space-y-6",
+				children: [/* @__PURE__ */ jsx("div", {
+					className: "flex items-center justify-center",
+					children: /* @__PURE__ */ jsxs("div", {
+						className: "relative flex h-40 w-40 items-center justify-center",
+						children: [/* @__PURE__ */ jsxs("svg", {
+							className: "absolute h-full w-full -rotate-90",
+							viewBox: "0 0 100 100",
+							children: [/* @__PURE__ */ jsx("circle", {
+								cx: "50",
+								cy: "50",
+								r: "45",
+								fill: "none",
+								strokeWidth: "8",
+								className: "stroke-muted"
+							}), /* @__PURE__ */ jsx("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"
+							})]
+						}), /* @__PURE__ */ jsxs("div", {
+							className: "text-center",
+							children: [/* @__PURE__ */ jsxs("div", {
+								className: "text-3xl font-bold",
+								children: [Math.round(percentComplete), "%"]
+							}), /* @__PURE__ */ jsx("div", {
+								className: "text-muted-foreground text-sm",
+								children: "Complete"
+							})]
+						})]
+					})
+				}), /* @__PURE__ */ jsxs("div", {
+					className: "grid grid-cols-3 gap-4 text-center",
+					children: [
+						/* @__PURE__ */ jsxs("div", { children: [/* @__PURE__ */ jsx("div", {
+							className: "text-2xl font-bold text-green-500",
+							children: completedSteps
+						}), /* @__PURE__ */ jsx("div", {
+							className: "text-muted-foreground text-sm",
+							children: "Completed"
+						})] }),
+						/* @__PURE__ */ jsxs("div", { children: [/* @__PURE__ */ jsx("div", {
+							className: "text-2xl font-bold text-orange-500",
+							children: remainingSteps
+						}), /* @__PURE__ */ jsx("div", {
+							className: "text-muted-foreground text-sm",
+							children: "Remaining"
+						})] }),
+						/* @__PURE__ */ jsxs("div", { children: [/* @__PURE__ */ jsxs("div", {
+							className: "text-2xl font-bold",
+							children: [estimatedMinutes, "m"]
+						}), /* @__PURE__ */ jsx("div", {
+							className: "text-muted-foreground text-sm",
+							children: "Est. Time"
+						})] })
+					]
+				})]
+			})] }),
+			/* @__PURE__ */ jsxs(Card, { children: [/* @__PURE__ */ jsx(CardHeader, { children: /* @__PURE__ */ jsxs(CardTitle, {
+				className: "flex items-center gap-2",
+				children: [/* @__PURE__ */ jsx("span", { children: "⚡" }), /* @__PURE__ */ jsx("span", { children: "Experience Points" })]
+			}) }), /* @__PURE__ */ jsxs(CardContent, {
+				className: "space-y-4",
+				children: [/* @__PURE__ */ jsxs("div", {
+					className: "flex items-baseline gap-2",
+					children: [/* @__PURE__ */ jsx("span", {
+						className: "text-3xl font-bold text-blue-500",
+						children: progress.xpEarned
+					}), /* @__PURE__ */ jsxs("span", {
+						className: "text-muted-foreground",
+						children: [
+							"/ ",
+							totalXp,
+							" XP"
+						]
+					})]
+				}), /* @__PURE__ */ jsx(XpBar, {
+					current: progress.xpEarned,
+					max: totalXp,
+					showLabel: false,
+					size: "lg"
+				})]
+			})] }),
+			/* @__PURE__ */ jsxs(Card, { children: [/* @__PURE__ */ jsx(CardHeader, { children: /* @__PURE__ */ jsxs(CardTitle, {
+				className: "flex items-center gap-2",
+				children: [/* @__PURE__ */ jsx("span", { children: "🏅" }), /* @__PURE__ */ jsx("span", { children: "Achievements" })]
+			}) }), /* @__PURE__ */ jsxs(CardContent, { children: [/* @__PURE__ */ jsx(BadgeDisplay, {
+				badges: progress.badges,
+				size: "lg"
+			}), progress.badges.length === 0 && track.completionRewards?.badgeKey && /* @__PURE__ */ jsxs("p", {
+				className: "text-muted-foreground text-sm",
+				children: [
+					"Complete all steps to earn the \"",
+					track.completionRewards.badgeKey,
+					"\" badge!"
+				]
+			})] })] }),
+			/* @__PURE__ */ jsxs(Card, { children: [/* @__PURE__ */ jsx(CardHeader, { children: /* @__PURE__ */ jsxs(CardTitle, {
+				className: "flex items-center gap-2",
+				children: [/* @__PURE__ */ jsx("span", { children: "📋" }), /* @__PURE__ */ jsx("span", { children: "Step Details" })]
+			}) }), /* @__PURE__ */ jsx(CardContent, { children: /* @__PURE__ */ jsx("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__ */ jsxs("div", {
+						className: "space-y-1",
+						children: [/* @__PURE__ */ jsxs("div", {
+							className: "flex items-center justify-between text-sm",
+							children: [/* @__PURE__ */ jsxs("span", {
+								className: isCompleted ? "text-green-500" : "text-foreground",
+								children: [
+									index + 1,
+									". ",
+									step.title
+								]
+							}), /* @__PURE__ */ jsx("span", {
+								className: isCompleted ? "text-green-500" : "text-muted-foreground",
+								children: isCompleted ? "✓" : "Pending"
+							})]
+						}), /* @__PURE__ */ jsx(Progress, {
+							value: stepProgress,
+							className: "h-1"
+						})]
+					}, step.id);
+				})
+			}) })] })
+		]
+	});
+}
+
+//#endregion
+//#region src/views/Timeline.tsx
+function Timeline({ track, progress }) {
+	const currentStepId = track.steps.find((s) => !progress.completedStepIds.includes(s.id))?.id ?? null;
+	return /* @__PURE__ */ jsxs("div", {
+		className: "space-y-6",
+		children: [
+			/* @__PURE__ */ jsxs("div", {
+				className: "text-center",
+				children: [/* @__PURE__ */ jsx("h2", {
+					className: "text-xl font-bold",
+					children: "Your Learning Journey"
+				}), /* @__PURE__ */ jsx("p", {
+					className: "text-muted-foreground",
+					children: "Follow the path through each surface and feature"
+				})]
+			}),
+			/* @__PURE__ */ jsxs(Card, { children: [/* @__PURE__ */ jsx(CardHeader, { children: /* @__PURE__ */ jsxs(CardTitle, {
+				className: "flex items-center gap-2",
+				children: [/* @__PURE__ */ jsx("span", { children: "🗺️" }), /* @__PURE__ */ jsx("span", { children: "Journey Map" })]
+			}) }), /* @__PURE__ */ jsx(CardContent, { children: /* @__PURE__ */ jsx(JourneyMap, {
+				steps: track.steps,
+				completedStepIds: progress.completedStepIds,
+				currentStepId
+			}) })] }),
+			/* @__PURE__ */ jsxs(Card, { children: [/* @__PURE__ */ jsx(CardHeader, { children: /* @__PURE__ */ jsxs(CardTitle, {
+				className: "flex items-center gap-2",
+				children: [/* @__PURE__ */ jsx("span", { children: "📍" }), /* @__PURE__ */ jsx("span", { children: "Step by Step" })]
+			}) }), /* @__PURE__ */ jsx(CardContent, { children: /* @__PURE__ */ jsxs("div", {
+				className: "relative",
+				children: [/* @__PURE__ */ jsx("div", { className: "bg-border absolute top-0 left-4 h-full w-0.5" }), /* @__PURE__ */ jsx("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__ */ jsxs("div", {
+							className: "relative flex gap-4 pl-2",
+							children: [/* @__PURE__ */ jsx("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
+							}), /* @__PURE__ */ jsx("div", {
+								className: "flex-1 pb-2",
+								children: /* @__PURE__ */ jsxs("div", {
+									className: "rounded-lg border p-4",
+									children: [/* @__PURE__ */ jsxs("div", {
+										className: "flex items-start justify-between gap-2",
+										children: [/* @__PURE__ */ jsxs("div", { children: [/* @__PURE__ */ jsxs("div", {
+											className: "flex items-center gap-2",
+											children: [/* @__PURE__ */ jsx("h4", {
+												className: `font-semibold ${isCompleted ? "text-green-500" : isCurrent ? "text-blue-500" : "text-foreground"}`,
+												children: step.title
+											}), /* @__PURE__ */ jsx("span", {
+												className: "bg-muted text-muted-foreground rounded px-2 py-0.5 text-xs",
+												children: surface
+											})]
+										}), /* @__PURE__ */ jsx("p", {
+											className: "text-muted-foreground mt-1 text-sm",
+											children: step.description
+										})] }), step.xpReward && /* @__PURE__ */ jsxs("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"
+											]
+										})]
+									}), /* @__PURE__ */ jsx("div", {
+										className: "mt-3 text-xs",
+										children: isCompleted ? /* @__PURE__ */ jsx("span", {
+											className: "text-green-500",
+											children: "✓ Completed"
+										}) : isCurrent ? /* @__PURE__ */ jsx("span", {
+											className: "text-blue-500",
+											children: "→ In Progress"
+										}) : /* @__PURE__ */ jsx("span", {
+											className: "text-muted-foreground",
+											children: "○ Not Started"
+										})
+									})]
+								})
+							})]
+						}, step.id);
+					})
+				})]
+			}) })] })
+		]
+	});
+}
+
+//#endregion
+export { Overview as i, ProgressView as n, Steps as r, Timeline as t };

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@lssm/example.learning-journey-ui-onboarding",
+  "version": "0.0.0-canary-20251212210835",
+  "description": "Developer onboarding UI with checklists and journey maps.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./src/index.ts",
+    "./views": "./src/views/index.ts",
+    "./components": "./src/components/index.ts",
+    "./*": "./*"
+  },
+  "scripts": {
+    "build": "bun build:bundle && bun build:types",
+    "build:bundle": "tsdown",
+    "build:types": "tsc --noEmit",
+    "dev": "bun build:bundle --watch",
+    "clean": "rimraf dist .turbo",
+    "lint": "bun lint:fix",
+    "lint:fix": "eslint src --fix",
+    "lint:check": "eslint src",
+    "test": "bun test"
+  },
+  "dependencies": {
+    "@lssm/example.learning-journey-ui-shared": "workspace:*",
+    "@lssm/example.learning-journey.studio-onboarding": "workspace:*",
+    "@lssm/example.learning-journey.platform-tour": "workspace:*",
+    "@lssm/module.learning-journey": "workspace:*",
+    "@lssm/lib.design-system": "workspace:*",
+    "@lssm/lib.ui-kit-web": "workspace:*",
+    "react": "^19.1.0"
+  },
+  "devDependencies": {
+    "@lssm/tool.tsdown": "workspace:*",
+    "@lssm/tool.typescript": "workspace:*",
+    "@types/react": "^19.1.6",
+    "tsdown": "^0.17.0",
+    "typescript": "^5.9.3"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "module": "./dist/index.js",
+  "publishConfig": {
+    "exports": {
+      ".": "./dist/index.js",
+      "./views": "./dist/views/index.js",
+      "./components": "./dist/components/index.js",
+      "./*": "./*"
+    }
+  }
+}

package/src/OnboardingMiniApp.tsx

@@ -0,0 +1,94 @@
+'use client';
+
+import { useState, useCallback } from 'react';
+import { Card, CardContent } from '@lssm/lib.ui-kit-web/ui/card';
+import {
+  ViewTabs,
+  useLearningProgress,
+  type LearningView,
+  type LearningMiniAppProps,
+} from '@lssm/example.learning-journey-ui-shared';
+import { Overview } from './views/Overview';
+import { Steps } from './views/Steps';
+import { Progress } from './views/Progress';
+import { Timeline } from './views/Timeline';
+
+type OnboardingMiniAppProps = Omit<LearningMiniAppProps, 'progress'> & {
+  progress?: LearningMiniAppProps['progress'];
+};
+
+export function OnboardingMiniApp({
+  track,
+  progress: externalProgress,
+  onStepComplete: externalOnStepComplete,
+  onViewChange,
+  initialView = 'overview',
+}: OnboardingMiniAppProps) {
+  const [currentView, setCurrentView] = useState<LearningView>(initialView);
+
+  // Use internal progress if not provided externally
+  const { progress: internalProgress, completeStep: internalCompleteStep } =
+    useLearningProgress(track);
+
+  const progress = externalProgress ?? internalProgress;
+
+  const handleViewChange = useCallback(
+    (view: LearningView) => {
+      setCurrentView(view);
+      onViewChange?.(view);
+    },
+    [onViewChange]
+  );
+
+  const handleStepComplete = useCallback(
+    (stepId: string) => {
+      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 <Overview {...viewProps} onStart={handleStartFromOverview} />;
+      case 'steps':
+        return <Steps {...viewProps} />;
+      case 'progress':
+        return <Progress {...viewProps} />;
+      case 'timeline':
+        return <Timeline {...viewProps} />;
+      default:
+        return <Overview {...viewProps} onStart={handleStartFromOverview} />;
+    }
+  };
+
+  return (
+    <div className="space-y-6">
+      {/* Navigation */}
+      <Card>
+        <CardContent className="p-4">
+          <ViewTabs currentView={currentView} onViewChange={handleViewChange} />
+        </CardContent>
+      </Card>
+
+      {/* Current View */}
+      {renderView()}
+    </div>
+  );
+}
+