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

package/dist/views-B-DapxWu.mjs

@@ -0,0 +1,467 @@
+import { n as MasteryRing, r as FlashCard, t as DayCalendar } from "./DayCalendar-Cha869Bi.mjs";
+import { Card, CardContent, CardHeader, CardTitle } from "@lssm/lib.ui-kit-web/ui/card";
+import { BadgeDisplay, StreakCounter, XpBar } from "@lssm/example.learning-journey-ui-shared";
+import { Button } from "@lssm/lib.design-system";
+import { jsx, jsxs } from "react/jsx-runtime";
+
+//#region src/views/Overview.tsx
+function Overview({ track, progress, onStart }) {
+	const totalXp = track.totalXp ?? track.steps.reduce((sum, s) => sum + (s.xpReward ?? 0), 0) + (track.completionRewards?.xpBonus ?? 0);
+	const completedSteps = progress.completedStepIds.length;
+	const totalSteps = track.steps.length;
+	const isComplete = completedSteps === totalSteps;
+	return /* @__PURE__ */ jsxs("div", {
+		className: "space-y-6",
+		children: [
+			/* @__PURE__ */ jsx(Card, {
+				className: "overflow-hidden bg-gradient-to-br from-violet-500/10 via-purple-500/10 to-fuchsia-500/10",
+				children: /* @__PURE__ */ jsx(CardContent, {
+					className: "p-6",
+					children: /* @__PURE__ */ jsxs("div", {
+						className: "flex flex-col items-center gap-4 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-violet-500 to-purple-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",
+									children: track.description
+								})]
+							}),
+							/* @__PURE__ */ jsx("div", {
+								className: "flex items-center gap-3",
+								children: /* @__PURE__ */ jsx(StreakCounter, {
+									days: progress.streakDays,
+									size: "lg"
+								})
+							})
+						]
+					})
+				})
+			}),
+			/* @__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: "XP Progress"
+						})
+					}), /* @__PURE__ */ jsxs(CardContent, { children: [/* @__PURE__ */ jsx("div", {
+						className: "text-3xl font-bold text-violet-500",
+						children: progress.xpEarned.toLocaleString()
+					}), /* @__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: "Steps Completed"
+						})
+					}), /* @__PURE__ */ jsxs(CardContent, { children: [/* @__PURE__ */ jsxs("div", {
+						className: "text-3xl font-bold",
+						children: [
+							completedSteps,
+							" ",
+							/* @__PURE__ */ jsxs("span", {
+								className: "text-muted-foreground text-lg",
+								children: ["/ ", totalSteps]
+							})
+						]
+					}), /* @__PURE__ */ jsx("div", {
+						className: "bg-muted mt-2 h-2 w-full overflow-hidden rounded-full",
+						children: /* @__PURE__ */ jsx("div", {
+							className: "h-full bg-green-500 transition-all duration-500",
+							style: { width: `${completedSteps / totalSteps * 100}%` }
+						})
+					})] })] }),
+					/* @__PURE__ */ jsxs(Card, { children: [/* @__PURE__ */ jsx(CardHeader, {
+						className: "pb-2",
+						children: /* @__PURE__ */ jsx(CardTitle, {
+							className: "text-muted-foreground text-sm font-medium",
+							children: "Badges Earned"
+						})
+					}), /* @__PURE__ */ jsx(CardContent, { children: /* @__PURE__ */ jsx(BadgeDisplay, {
+						badges: progress.badges,
+						size: "lg"
+					}) })] })
+				]
+			}),
+			!isComplete && /* @__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: "Next Challenge" })]
+			}) }), /* @__PURE__ */ jsx(CardContent, { children: (() => {
+				const nextStep = track.steps.find((s) => !progress.completedStepIds.includes(s.id));
+				if (!nextStep) return null;
+				return /* @__PURE__ */ jsxs("div", {
+					className: "flex items-center justify-between gap-4",
+					children: [/* @__PURE__ */ jsxs("div", { children: [/* @__PURE__ */ jsx("h3", {
+						className: "font-semibold",
+						children: nextStep.title
+					}), /* @__PURE__ */ jsx("p", {
+						className: "text-muted-foreground text-sm",
+						children: nextStep.description
+					})] }), /* @__PURE__ */ jsxs("div", {
+						className: "flex items-center gap-3",
+						children: [nextStep.xpReward && /* @__PURE__ */ jsxs("span", {
+							className: "rounded-full bg-green-500/10 px-3 py-1 text-sm font-semibold text-green-500",
+							children: [
+								"+",
+								nextStep.xpReward,
+								" XP"
+							]
+						}), /* @__PURE__ */ jsx(Button, {
+							onClick: onStart,
+							children: "Start"
+						})]
+					})]
+				});
+			})() })] }),
+			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: "Track Complete!"
+					}), /* @__PURE__ */ jsxs("p", {
+						className: "text-muted-foreground",
+						children: [
+							"You've mastered all ",
+							totalSteps,
+							" challenges and earned",
+							" ",
+							progress.xpEarned,
+							" XP."
+						]
+					})] })]
+				})
+			})
+		]
+	});
+}
+
+//#endregion
+//#region src/views/Steps.tsx
+function Steps({ track, progress, onStepComplete }) {
+	const currentStepIndex = track.steps.findIndex((s) => !progress.completedStepIds.includes(s.id));
+	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: "Complete Your Challenges"
+				}), /* @__PURE__ */ jsx("p", {
+					className: "text-muted-foreground",
+					children: "Tap each card to reveal the action, then mark as complete"
+				})]
+			}),
+			/* @__PURE__ */ jsx("div", {
+				className: "grid gap-4 md:grid-cols-2",
+				children: track.steps.map((step, index) => {
+					return /* @__PURE__ */ jsx(FlashCard, {
+						step,
+						isCompleted: progress.completedStepIds.includes(step.id),
+						isCurrent: index === currentStepIndex,
+						onComplete: () => onStepComplete?.(step.id)
+					}, step.id);
+				})
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "text-muted-foreground text-center text-sm",
+				children: [
+					progress.completedStepIds.length,
+					" of ",
+					track.steps.length,
+					" completed",
+					track.completionRewards?.xpBonus && /* @__PURE__ */ jsxs("span", {
+						className: "ml-2 text-green-500",
+						children: [
+							"(+",
+							track.completionRewards.xpBonus,
+							" XP bonus on completion)"
+						]
+					})
+				]
+			})
+		]
+	});
+}
+
+//#endregion
+//#region src/views/Progress.tsx
+function Progress({ track, progress }) {
+	const totalXp = track.totalXp ?? track.steps.reduce((sum, s) => sum + (s.xpReward ?? 0), 0) + (track.completionRewards?.xpBonus ?? 0);
+	const completedSteps = progress.completedStepIds.length;
+	const totalSteps = track.steps.length;
+	const percentComplete = totalSteps > 0 ? completedSteps / totalSteps * 100 : 0;
+	const surfaces = /* @__PURE__ */ new Map();
+	track.steps.forEach((step) => {
+		const surface = step.metadata?.surface ?? "general";
+		const current = surfaces.get(surface) ?? {
+			total: 0,
+			completed: 0
+		};
+		surfaces.set(surface, {
+			total: current.total + 1,
+			completed: current.completed + (progress.completedStepIds.includes(step.id) ? 1 : 0)
+		});
+	});
+	const surfaceColors = [
+		"green",
+		"blue",
+		"violet",
+		"orange"
+	];
+	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: "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-4xl font-bold text-violet-500",
+							children: progress.xpEarned.toLocaleString()
+						}), /* @__PURE__ */ jsxs("span", {
+							className: "text-muted-foreground",
+							children: [
+								"/ ",
+								totalXp.toLocaleString(),
+								" XP"
+							]
+						})]
+					}),
+					/* @__PURE__ */ jsx(XpBar, {
+						current: progress.xpEarned,
+						max: totalXp,
+						showLabel: false,
+						size: "lg"
+					}),
+					track.completionRewards?.xpBonus && percentComplete < 100 && /* @__PURE__ */ jsxs("p", {
+						className: "text-muted-foreground text-sm",
+						children: [
+							"🎁 Complete all steps for a",
+							" ",
+							/* @__PURE__ */ jsxs("span", {
+								className: "font-semibold text-green-500",
+								children: [
+									"+",
+									track.completionRewards.xpBonus,
+									" XP"
+								]
+							}),
+							" ",
+							"bonus!"
+						]
+					})
+				]
+			})] }),
+			/* @__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: "Skill Mastery" })]
+			}) }), /* @__PURE__ */ jsx(CardContent, { children: /* @__PURE__ */ jsxs("div", {
+				className: "flex flex-wrap justify-center gap-6",
+				children: [Array.from(surfaces.entries()).map(([surface, data], index) => /* @__PURE__ */ jsx(MasteryRing, {
+					label: surface.charAt(0).toUpperCase() + surface.slice(1),
+					percentage: data.completed / data.total * 100,
+					color: surfaceColors[index % surfaceColors.length],
+					size: "lg"
+				}, surface)), /* @__PURE__ */ jsx(MasteryRing, {
+					label: "Overall",
+					percentage: percentComplete,
+					color: "violet",
+					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: "Badges Earned" })]
+			}) }), /* @__PURE__ */ jsxs(CardContent, { children: [/* @__PURE__ */ jsx(BadgeDisplay, {
+				badges: progress.badges,
+				size: "lg",
+				maxVisible: 10
+			}), progress.badges.length === 0 && /* @__PURE__ */ jsx("p", {
+				className: "text-muted-foreground text-sm",
+				children: "Complete the track to earn your first 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 Breakdown" })]
+			}) }), /* @__PURE__ */ jsx(CardContent, { children: /* @__PURE__ */ jsx("div", {
+				className: "space-y-2",
+				children: track.steps.map((step) => {
+					const isCompleted = progress.completedStepIds.includes(step.id);
+					return /* @__PURE__ */ jsxs("div", {
+						className: "flex items-center justify-between rounded-lg border p-3",
+						children: [/* @__PURE__ */ jsxs("div", {
+							className: "flex items-center gap-3",
+							children: [/* @__PURE__ */ jsx("span", {
+								className: isCompleted ? "text-green-500" : "text-muted-foreground",
+								children: isCompleted ? "✓" : "○"
+							}), /* @__PURE__ */ jsx("span", {
+								className: isCompleted ? "text-foreground" : "text-muted-foreground",
+								children: step.title
+							})]
+						}), step.xpReward && /* @__PURE__ */ jsxs("span", {
+							className: `text-sm font-medium ${isCompleted ? "text-green-500" : "text-muted-foreground"}`,
+							children: [
+								isCompleted ? "+" : "",
+								step.xpReward,
+								" XP"
+							]
+						})]
+					}, step.id);
+				})
+			}) })] })
+		]
+	});
+}
+
+//#endregion
+//#region src/views/Timeline.tsx
+function Timeline({ track, progress }) {
+	if (track.steps.some((s) => s.availability?.unlockOnDay !== void 0)) {
+		const totalDays = Math.max(...track.steps.map((s) => s.availability?.unlockOnDay ?? 1), 7);
+		const completedDays = track.steps.filter((s) => progress.completedStepIds.includes(s.id)).map((s) => s.availability?.unlockOnDay ?? 1);
+		const currentDay = track.steps.find((s) => !progress.completedStepIds.includes(s.id))?.availability?.unlockOnDay ?? 1;
+		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: track.name
+					}), /* @__PURE__ */ jsx("p", {
+						className: "text-muted-foreground",
+						children: "Complete each day's challenge to progress"
+					})]
+				}),
+				/* @__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, {
+					className: "flex justify-center",
+					children: /* @__PURE__ */ jsx(DayCalendar, {
+						totalDays,
+						currentDay,
+						completedDays
+					})
+				})] }),
+				/* @__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: "Daily Challenges" })]
+				}) }), /* @__PURE__ */ jsx(CardContent, { children: /* @__PURE__ */ jsx("div", {
+					className: "space-y-3",
+					children: track.steps.map((step) => {
+						const day = step.availability?.unlockOnDay ?? 1;
+						const isCompleted = progress.completedStepIds.includes(step.id);
+						const isLocked = day > currentDay;
+						return /* @__PURE__ */ jsxs("div", {
+							className: `flex items-start gap-4 rounded-lg border p-4 ${isLocked ? "opacity-50" : ""}`,
+							children: [
+								/* @__PURE__ */ jsx("div", {
+									className: "bg-muted flex h-10 w-10 shrink-0 items-center justify-center rounded-lg font-semibold",
+									children: isCompleted ? "✓" : isLocked ? "🔒" : day
+								}),
+								/* @__PURE__ */ jsxs("div", {
+									className: "flex-1",
+									children: [/* @__PURE__ */ jsx("h4", {
+										className: "font-semibold",
+										children: step.title
+									}), /* @__PURE__ */ jsx("p", {
+										className: "text-muted-foreground text-sm",
+										children: step.description
+									})]
+								}),
+								step.xpReward && /* @__PURE__ */ jsxs("span", {
+									className: `text-sm font-medium ${isCompleted ? "text-green-500" : "text-muted-foreground"}`,
+									children: [
+										"+",
+										step.xpReward,
+										" XP"
+									]
+								})
+							]
+						}, step.id);
+					})
+				}) })] })
+			]
+		});
+	}
+	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: "Learning Path"
+			}), /* @__PURE__ */ jsx("p", {
+				className: "text-muted-foreground",
+				children: "Follow the steps to master this skill"
+			})]
+		}), /* @__PURE__ */ jsx(Card, { children: /* @__PURE__ */ jsx(CardContent, {
+			className: "p-6",
+			children: /* @__PURE__ */ jsxs("div", {
+				className: "relative",
+				children: [/* @__PURE__ */ jsx("div", { className: "bg-border absolute top-0 left-5 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 = !isCompleted && track.steps.slice(0, index).every((s) => progress.completedStepIds.includes(s.id));
+						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 ${isCompleted ? "border-green-500 bg-green-500 text-white" : isCurrent ? "border-violet-500 bg-violet-500 text-white" : "border-border bg-background"}`,
+								children: isCompleted ? "✓" : index + 1
+							}), /* @__PURE__ */ jsx("div", {
+								className: "flex-1 pb-4",
+								children: /* @__PURE__ */ jsxs("div", {
+									className: "flex items-start justify-between gap-2",
+									children: [/* @__PURE__ */ jsxs("div", { children: [/* @__PURE__ */ jsx("h4", {
+										className: `font-semibold ${isCompleted ? "text-foreground" : isCurrent ? "text-violet-500" : "text-muted-foreground"}`,
+										children: step.title
+									}), /* @__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"
+										]
+									})]
+								})
+							})]
+						}, step.id);
+					})
+				})]
+			})
+		}) })]
+	});
+}
+
+//#endregion
+export { Overview as i, Progress as n, Steps as r, Timeline as t };

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@lssm/example.learning-journey-ui-gamified",
+  "version": "0.0.0-canary-20251212210835",
+  "description": "Duolingo-style gamified learning UI for drills and quests.",
+  "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.duo-drills": "workspace:*",
+    "@lssm/example.learning-journey.quest-challenges": "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/GamifiedMiniApp.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 GamifiedMiniAppProps = Omit<LearningMiniAppProps, 'progress'> & {
+  progress?: LearningMiniAppProps['progress'];
+};
+
+export function GamifiedMiniApp({
+  track,
+  progress: externalProgress,
+  onStepComplete: externalOnStepComplete,
+  onViewChange,
+  initialView = 'overview',
+}: GamifiedMiniAppProps) {
+  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>
+  );
+}
+

package/src/components/DayCalendar.tsx

@@ -0,0 +1,54 @@
+'use client';
+
+import { cn } from '@lssm/lib.ui-kit-web/ui/utils';
+
+interface DayCalendarProps {
+  totalDays: number;
+  currentDay: number;
+  completedDays: number[];
+}
+
+export function DayCalendar({
+  totalDays,
+  currentDay,
+  completedDays,
+}: DayCalendarProps) {
+  const days = Array.from({ length: totalDays }, (_, i) => i + 1);
+
+  return (
+    <div className="grid grid-cols-7 gap-2">
+      {days.map((day) => {
+        const isCompleted = completedDays.includes(day);
+        const isCurrent = day === currentDay;
+        const isLocked = day > currentDay;
+
+        return (
+          <div
+            key={day}
+            className={cn(
+              'flex h-12 w-12 flex-col items-center justify-center rounded-lg border text-sm font-medium transition-all',
+              isCompleted && 'border-green-500 bg-green-500/10 text-green-500',
+              isCurrent &&
+                !isCompleted &&
+                'border-violet-500 bg-violet-500/10 text-violet-500 ring-2 ring-violet-500/50',
+              isLocked && 'border-muted bg-muted/50 text-muted-foreground',
+              !isCompleted && !isCurrent && !isLocked && 'border-border bg-card'
+            )}
+          >
+            {isCompleted ? (
+              <span className="text-lg">✓</span>
+            ) : isLocked ? (
+              <span className="text-lg">🔒</span>
+            ) : (
+              <>
+                <span className="text-muted-foreground text-xs">Day</span>
+                <span>{day}</span>
+              </>
+            )}
+          </div>
+        );
+      })}
+    </div>
+  );
+}
+