@contractspec/example.learning-journey-ui-gamified 1.44.0

package/dist/views/Progress.js

@@ -0,0 +1,143 @@
+'use client';
+
+import { MasteryRing } from "../components/MasteryRing.js";
+import { Card, CardContent, CardHeader, CardTitle } from "@contractspec/lib.ui-kit-web/ui/card";
+import { BadgeDisplay, XpBar } from "@contractspec/example.learning-journey-ui-shared";
+import { jsx, jsxs } from "react/jsx-runtime";
+
+//#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
+export { Progress };
+//# sourceMappingURL=Progress.js.map

package/dist/views/Progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Progress.js","names":["surfaceColors: ('green' | 'blue' | 'violet' | 'orange')[]"],"sources":["../../src/views/Progress.tsx"],"sourcesContent":["'use client';\n\nimport {\n  Card,\n  CardContent,\n  CardHeader,\n  CardTitle,\n} from '@contractspec/lib.ui-kit-web/ui/card';\nimport {\n  XpBar,\n  BadgeDisplay,\n} from '@contractspec/example.learning-journey-ui-shared';\nimport { MasteryRing } from '../components/MasteryRing';\nimport type { LearningViewProps } from '@contractspec/example.learning-journey-ui-shared';\n\nexport function Progress({ track, progress }: LearningViewProps) {\n  const totalXp =\n    track.totalXp ??\n    track.steps.reduce((sum, s) => sum + (s.xpReward ?? 0), 0) +\n      (track.completionRewards?.xpBonus ?? 0);\n\n  const completedSteps = progress.completedStepIds.length;\n  const totalSteps = track.steps.length;\n  const percentComplete =\n    totalSteps > 0 ? (completedSteps / totalSteps) * 100 : 0;\n\n  // Group steps by metadata surface for mastery rings\n  const surfaces = new Map<string, { total: number; completed: number }>();\n  track.steps.forEach((step) => {\n    const surface = (step.metadata?.surface as string) ?? 'general';\n    const current = surfaces.get(surface) ?? { total: 0, completed: 0 };\n    surfaces.set(surface, {\n      total: current.total + 1,\n      completed:\n        current.completed +\n        (progress.completedStepIds.includes(step.id) ? 1 : 0),\n    });\n  });\n\n  const surfaceColors: ('green' | 'blue' | 'violet' | 'orange')[] = [\n    'green',\n    'blue',\n    'violet',\n    'orange',\n  ];\n\n  return (\n    <div className=\"space-y-6\">\n      {/* XP Progress */}\n      <Card>\n        <CardHeader>\n          <CardTitle className=\"flex items-center gap-2\">\n            <span>⚡</span>\n            <span>Experience Points</span>\n          </CardTitle>\n        </CardHeader>\n        <CardContent className=\"space-y-4\">\n          <div className=\"flex items-baseline gap-2\">\n            <span className=\"text-4xl font-bold text-violet-500\">\n              {progress.xpEarned.toLocaleString()}\n            </span>\n            <span className=\"text-muted-foreground\">\n              / {totalXp.toLocaleString()} XP\n            </span>\n          </div>\n          <XpBar\n            current={progress.xpEarned}\n            max={totalXp}\n            showLabel={false}\n            size=\"lg\"\n          />\n\n          {track.completionRewards?.xpBonus && percentComplete < 100 && (\n            <p className=\"text-muted-foreground text-sm\">\n              🎁 Complete all steps for a{' '}\n              <span className=\"font-semibold text-green-500\">\n                +{track.completionRewards.xpBonus} XP\n              </span>{' '}\n              bonus!\n            </p>\n          )}\n        </CardContent>\n      </Card>\n\n      {/* Mastery Rings */}\n      <Card>\n        <CardHeader>\n          <CardTitle className=\"flex items-center gap-2\">\n            <span>🎯</span>\n            <span>Skill Mastery</span>\n          </CardTitle>\n        </CardHeader>\n        <CardContent>\n          <div className=\"flex flex-wrap justify-center gap-6\">\n            {Array.from(surfaces.entries()).map(([surface, data], index) => (\n              <MasteryRing\n                key={surface}\n                label={surface.charAt(0).toUpperCase() + surface.slice(1)}\n                percentage={(data.completed / data.total) * 100}\n                color={surfaceColors[index % surfaceColors.length]}\n                size=\"lg\"\n              />\n            ))}\n            <MasteryRing\n              label=\"Overall\"\n              percentage={percentComplete}\n              color=\"violet\"\n              size=\"lg\"\n            />\n          </div>\n        </CardContent>\n      </Card>\n\n      {/* Badges */}\n      <Card>\n        <CardHeader>\n          <CardTitle className=\"flex items-center gap-2\">\n            <span>🏅</span>\n            <span>Badges Earned</span>\n          </CardTitle>\n        </CardHeader>\n        <CardContent>\n          <BadgeDisplay badges={progress.badges} size=\"lg\" maxVisible={10} />\n          {progress.badges.length === 0 && (\n            <p className=\"text-muted-foreground text-sm\">\n              Complete the track to earn your first badge!\n            </p>\n          )}\n        </CardContent>\n      </Card>\n\n      {/* Step Breakdown */}\n      <Card>\n        <CardHeader>\n          <CardTitle className=\"flex items-center gap-2\">\n            <span>📊</span>\n            <span>Step Breakdown</span>\n          </CardTitle>\n        </CardHeader>\n        <CardContent>\n          <div className=\"space-y-2\">\n            {track.steps.map((step) => {\n              const isCompleted = progress.completedStepIds.includes(step.id);\n              return (\n                <div\n                  key={step.id}\n                  className=\"flex items-center justify-between rounded-lg border p-3\"\n                >\n                  <div className=\"flex items-center gap-3\">\n                    <span\n                      className={\n                        isCompleted ? 'text-green-500' : 'text-muted-foreground'\n                      }\n                    >\n                      {isCompleted ? '✓' : '○'}\n                    </span>\n                    <span\n                      className={\n                        isCompleted\n                          ? 'text-foreground'\n                          : 'text-muted-foreground'\n                      }\n                    >\n                      {step.title}\n                    </span>\n                  </div>\n                  {step.xpReward && (\n                    <span\n                      className={`text-sm font-medium ${isCompleted ? 'text-green-500' : 'text-muted-foreground'}`}\n                    >\n                      {isCompleted ? '+' : ''}\n                      {step.xpReward} XP\n                    </span>\n                  )}\n                </div>\n              );\n            })}\n          </div>\n        </CardContent>\n      </Card>\n    </div>\n  );\n}\n"],"mappings":"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"}

package/dist/views/Steps.d.ts

@@ -0,0 +1,12 @@
+import { LearningViewProps } from "@contractspec/example.learning-journey-ui-shared";
+import * as react_jsx_runtime5 from "react/jsx-runtime";
+
+//#region src/views/Steps.d.ts
+declare function Steps({
+  track,
+  progress,
+  onStepComplete
+}: LearningViewProps): react_jsx_runtime5.JSX.Element;
+//#endregion
+export { Steps };
+//# sourceMappingURL=Steps.d.ts.map

package/dist/views/Steps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Steps.d.ts","names":[],"sources":["../../src/views/Steps.tsx"],"sourcesContent":[],"mappings":";;;;iBAKgB,KAAA;;;;GAA2C,oBAAiB,kBAAA,CAAA,GAAA,CAAA"}

package/dist/views/Steps.js

@@ -0,0 +1,56 @@
+'use client';
+
+import { FlashCard } from "../components/FlashCard.js";
+import { jsx, jsxs } from "react/jsx-runtime";
+
+//#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
+export { Steps };
+//# sourceMappingURL=Steps.js.map

package/dist/views/Steps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Steps.js","names":[],"sources":["../../src/views/Steps.tsx"],"sourcesContent":["'use client';\n\nimport { FlashCard } from '../components/FlashCard';\nimport type { LearningViewProps } from '@contractspec/example.learning-journey-ui-shared';\n\nexport function Steps({ track, progress, onStepComplete }: LearningViewProps) {\n  const currentStepIndex = track.steps.findIndex(\n    (s) => !progress.completedStepIds.includes(s.id)\n  );\n\n  return (\n    <div className=\"space-y-6\">\n      {/* Header */}\n      <div className=\"text-center\">\n        <h2 className=\"text-xl font-bold\">Complete Your Challenges</h2>\n        <p className=\"text-muted-foreground\">\n          Tap each card to reveal the action, then mark as complete\n        </p>\n      </div>\n\n      {/* Card Stack */}\n      <div className=\"grid gap-4 md:grid-cols-2\">\n        {track.steps.map((step, index) => {\n          const isCompleted = progress.completedStepIds.includes(step.id);\n          const isCurrent = index === currentStepIndex;\n\n          return (\n            <FlashCard\n              key={step.id}\n              step={step}\n              isCompleted={isCompleted}\n              isCurrent={isCurrent}\n              onComplete={() => onStepComplete?.(step.id)}\n            />\n          );\n        })}\n      </div>\n\n      {/* Progress Summary */}\n      <div className=\"text-muted-foreground text-center text-sm\">\n        {progress.completedStepIds.length} of {track.steps.length} completed\n        {track.completionRewards?.xpBonus && (\n          <span className=\"ml-2 text-green-500\">\n            (+{track.completionRewards.xpBonus} XP bonus on completion)\n          </span>\n        )}\n      </div>\n    </div>\n  );\n}\n"],"mappings":";;;;;;AAKA,SAAgB,MAAM,EAAE,OAAO,UAAU,kBAAqC;CAC5E,MAAM,mBAAmB,MAAM,MAAM,WAClC,MAAM,CAAC,SAAS,iBAAiB,SAAS,EAAE,GAAG,CACjD;AAED,QACE,qBAAC;EAAI,WAAU;;GAEb,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAoB;MAA6B,EAC/D,oBAAC;KAAE,WAAU;eAAwB;MAEjC;KACA;GAGN,oBAAC;IAAI,WAAU;cACZ,MAAM,MAAM,KAAK,MAAM,UAAU;AAIhC,YACE,oBAAC;MAEO;MACN,aAPgB,SAAS,iBAAiB,SAAS,KAAK,GAAG;MAQ3D,WAPc,UAAU;MAQxB,kBAAkB,iBAAiB,KAAK,GAAG;QAJtC,KAAK,GAKV;MAEJ;KACE;GAGN,qBAAC;IAAI,WAAU;;KACZ,SAAS,iBAAiB;KAAO;KAAK,MAAM,MAAM;KAAO;KACzD,MAAM,mBAAmB,WACxB,qBAAC;MAAK,WAAU;;OAAsB;OACjC,MAAM,kBAAkB;OAAQ;;OAC9B;;KAEL;;GACF"}

package/dist/views/Timeline.d.ts

@@ -0,0 +1,11 @@
+import { LearningViewProps } from "@contractspec/example.learning-journey-ui-shared";
+import * as react_jsx_runtime6 from "react/jsx-runtime";
+
+//#region src/views/Timeline.d.ts
+declare function Timeline({
+  track,
+  progress
+}: LearningViewProps): react_jsx_runtime6.JSX.Element;
+//#endregion
+export { Timeline };
+//# sourceMappingURL=Timeline.d.ts.map

package/dist/views/Timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Timeline.d.ts","names":[],"sources":["../../src/views/Timeline.tsx"],"sourcesContent":[],"mappings":";;;;iBAWgB,QAAA;;;GAA8B,oBAAiB,kBAAA,CAAA,GAAA,CAAA"}

package/dist/views/Timeline.js

@@ -0,0 +1,133 @@
+'use client';
+
+import { DayCalendar } from "../components/DayCalendar.js";
+import { Card, CardContent, CardHeader, CardTitle } from "@contractspec/lib.ui-kit-web/ui/card";
+import { jsx, jsxs } from "react/jsx-runtime";
+
+//#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 { Timeline };
+//# sourceMappingURL=Timeline.js.map

package/dist/views/Timeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Timeline.js","names":[],"sources":["../../src/views/Timeline.tsx"],"sourcesContent":["'use client';\n\nimport {\n  Card,\n  CardContent,\n  CardHeader,\n  CardTitle,\n} from '@contractspec/lib.ui-kit-web/ui/card';\nimport { DayCalendar } from '../components/DayCalendar';\nimport type { LearningViewProps } from '@contractspec/example.learning-journey-ui-shared';\n\nexport function Timeline({ track, progress }: LearningViewProps) {\n  // Check if this is a quest with day unlocks\n  const hasQuestDays = track.steps.some(\n    (s) => s.availability?.unlockOnDay !== undefined\n  );\n\n  if (hasQuestDays) {\n    // Quest-style calendar view\n    const totalDays = Math.max(\n      ...track.steps.map((s) => s.availability?.unlockOnDay ?? 1),\n      7\n    );\n\n    const completedDays = track.steps\n      .filter((s) => progress.completedStepIds.includes(s.id))\n      .map((s) => s.availability?.unlockOnDay ?? 1);\n\n    // Current day is the first incomplete day\n    const currentDay =\n      track.steps.find((s) => !progress.completedStepIds.includes(s.id))\n        ?.availability?.unlockOnDay ?? 1;\n\n    return (\n      <div className=\"space-y-6\">\n        {/* Header */}\n        <div className=\"text-center\">\n          <h2 className=\"text-xl font-bold\">{track.name}</h2>\n          <p className=\"text-muted-foreground\">\n            Complete each day's challenge to progress\n          </p>\n        </div>\n\n        {/* Calendar Grid */}\n        <Card>\n          <CardHeader>\n            <CardTitle className=\"flex items-center gap-2\">\n              <span>📅</span>\n              <span>Your Journey</span>\n            </CardTitle>\n          </CardHeader>\n          <CardContent className=\"flex justify-center\">\n            <DayCalendar\n              totalDays={totalDays}\n              currentDay={currentDay}\n              completedDays={completedDays}\n            />\n          </CardContent>\n        </Card>\n\n        {/* Daily Steps */}\n        <Card>\n          <CardHeader>\n            <CardTitle className=\"flex items-center gap-2\">\n              <span>📝</span>\n              <span>Daily Challenges</span>\n            </CardTitle>\n          </CardHeader>\n          <CardContent>\n            <div className=\"space-y-3\">\n              {track.steps.map((step) => {\n                const day = step.availability?.unlockOnDay ?? 1;\n                const isCompleted = progress.completedStepIds.includes(step.id);\n                const isLocked = day > currentDay;\n\n                return (\n                  <div\n                    key={step.id}\n                    className={`flex items-start gap-4 rounded-lg border p-4 ${\n                      isLocked ? 'opacity-50' : ''\n                    }`}\n                  >\n                    <div className=\"bg-muted flex h-10 w-10 shrink-0 items-center justify-center rounded-lg font-semibold\">\n                      {isCompleted ? '✓' : isLocked ? '🔒' : day}\n                    </div>\n                    <div className=\"flex-1\">\n                      <h4 className=\"font-semibold\">{step.title}</h4>\n                      <p className=\"text-muted-foreground text-sm\">\n                        {step.description}\n                      </p>\n                    </div>\n                    {step.xpReward && (\n                      <span\n                        className={`text-sm font-medium ${\n                          isCompleted\n                            ? 'text-green-500'\n                            : 'text-muted-foreground'\n                        }`}\n                      >\n                        +{step.xpReward} XP\n                      </span>\n                    )}\n                  </div>\n                );\n              })}\n            </div>\n          </CardContent>\n        </Card>\n      </div>\n    );\n  }\n\n  // Drill-style timeline (step order)\n  return (\n    <div className=\"space-y-6\">\n      {/* Header */}\n      <div className=\"text-center\">\n        <h2 className=\"text-xl font-bold\">Learning Path</h2>\n        <p className=\"text-muted-foreground\">\n          Follow the steps to master this skill\n        </p>\n      </div>\n\n      {/* Timeline */}\n      <Card>\n        <CardContent className=\"p-6\">\n          <div className=\"relative\">\n            {/* Vertical line */}\n            <div className=\"bg-border absolute top-0 left-5 h-full w-0.5\" />\n\n            {/* Steps */}\n            <div className=\"space-y-6\">\n              {track.steps.map((step, index) => {\n                const isCompleted = progress.completedStepIds.includes(step.id);\n                const isCurrent =\n                  !isCompleted &&\n                  track.steps\n                    .slice(0, index)\n                    .every((s) => progress.completedStepIds.includes(s.id));\n\n                return (\n                  <div key={step.id} className=\"relative flex gap-4 pl-2\">\n                    {/* Node */}\n                    <div\n                      className={`relative z-10 flex h-8 w-8 shrink-0 items-center justify-center rounded-full border-2 ${\n                        isCompleted\n                          ? 'border-green-500 bg-green-500 text-white'\n                          : isCurrent\n                            ? 'border-violet-500 bg-violet-500 text-white'\n                            : 'border-border bg-background'\n                      }`}\n                    >\n                      {isCompleted ? '✓' : index + 1}\n                    </div>\n\n                    {/* Content */}\n                    <div className=\"flex-1 pb-4\">\n                      <div className=\"flex items-start justify-between gap-2\">\n                        <div>\n                          <h4\n                            className={`font-semibold ${\n                              isCompleted\n                                ? 'text-foreground'\n                                : isCurrent\n                                  ? 'text-violet-500'\n                                  : 'text-muted-foreground'\n                            }`}\n                          >\n                            {step.title}\n                          </h4>\n                          <p className=\"text-muted-foreground mt-1 text-sm\">\n                            {step.description}\n                          </p>\n                        </div>\n                        {step.xpReward && (\n                          <span\n                            className={`shrink-0 rounded-full px-2 py-1 text-xs font-semibold ${\n                              isCompleted\n                                ? 'bg-green-500/10 text-green-500'\n                                : 'bg-muted text-muted-foreground'\n                            }`}\n                          >\n                            +{step.xpReward} XP\n                          </span>\n                        )}\n                      </div>\n                    </div>\n                  </div>\n                );\n              })}\n            </div>\n          </div>\n        </CardContent>\n      </Card>\n    </div>\n  );\n}\n"],"mappings":"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"}

package/dist/views/index.d.ts

@@ -0,0 +1,5 @@
+import { Overview } from "./Overview.js";
+import { Steps } from "./Steps.js";
+import { Progress } from "./Progress.js";
+import { Timeline } from "./Timeline.js";
+export { Overview, Progress, Steps, Timeline };

package/dist/views/index.js

@@ -0,0 +1,6 @@
+import { Overview } from "./Overview.js";
+import { Steps } from "./Steps.js";
+import { Progress } from "./Progress.js";
+import { Timeline } from "./Timeline.js";
+
+export { Overview, Progress, Steps, Timeline };

package/example.ts

@@ -0,0 +1 @@
+export { default } from './src/example';

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "@contractspec/example.learning-journey-ui-gamified",
+  "version": "1.44.0",
+  "description": "Duolingo-style gamified learning UI for drills and quests.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./components": "./dist/components/index.js",
+    "./components/DayCalendar": "./dist/components/DayCalendar.js",
+    "./components/FlashCard": "./dist/components/FlashCard.js",
+    "./components/MasteryRing": "./dist/components/MasteryRing.js",
+    "./docs": "./dist/docs/index.js",
+    "./docs/learning-journey-ui-gamified.docblock": "./dist/docs/learning-journey-ui-gamified.docblock.js",
+    "./example": "./dist/example.js",
+    "./GamifiedMiniApp": "./dist/GamifiedMiniApp.js",
+    "./views": "./dist/views/index.js",
+    "./views/Overview": "./dist/views/Overview.js",
+    "./views/Progress": "./dist/views/Progress.js",
+    "./views/Steps": "./dist/views/Steps.js",
+    "./views/Timeline": "./dist/views/Timeline.js",
+    "./*": "./*"
+  },
+  "scripts": {
+    "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
+    "publish:pkg:canary": "bun publish:pkg --tag canary",
+    "build": "bun build:types && bun build:bundle",
+    "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": {
+    "@contractspec/lib.schema": "1.44.0",
+    "@contractspec/lib.contracts": "1.44.0",
+    "@contractspec/example.learning-journey-ui-shared": "1.44.0",
+    "@contractspec/example.learning-journey-duo-drills": "1.44.0",
+    "@contractspec/example.learning-journey-quest-challenges": "1.44.0",
+    "@contractspec/module.learning-journey": "1.44.0",
+    "@contractspec/lib.design-system": "1.44.0",
+    "@contractspec/lib.ui-kit-web": "1.44.0",
+    "react": "19.2.3"
+  },
+  "devDependencies": {
+    "@contractspec/tool.tsdown": "1.44.0",
+    "@contractspec/tool.typescript": "1.44.0",
+    "@types/react": "^19.1.6",
+    "tsdown": "^0.18.3",
+    "typescript": "^5.9.3"
+  },
+  "peerDependencies": {
+    "react": "^19.2.3"
+  },
+  "module": "./dist/index.js",
+  "publishConfig": {
+    "exports": {
+      ".": "./dist/index.js",
+      "./example": "./dist/example.js",
+      "./docs": "./dist/docs/index.js",
+      "./views": "./dist/views/index.js",
+      "./components": "./dist/components/index.js",
+      "./*": "./*"
+    },
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lssm-tech/contractspec.git",
+    "directory": "packages/examples/learning-journey-ui-gamified"
+  },
+  "homepage": "https://contractspec.io"
+}

package/src/GamifiedMiniApp.tsx

@@ -0,0 +1,93 @@
+'use client';
+
+import { useState, useCallback } from 'react';
+import { Card, CardContent } from '@contractspec/lib.ui-kit-web/ui/card';
+import {
+  ViewTabs,
+  useLearningProgress,
+  type LearningView,
+  type LearningMiniAppProps,
+} from '@contractspec/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>
+  );
+}