@lssm/example.learning-journey-registry 0.0.0-canary-20251217060834 → 0.0.0-canary-20251217072406

package/dist/examples/learning-journey-ui-coaching/src/views/Progress.js

@@ -0,0 +1,117 @@
+'use client';
+
+import { Card, CardContent, CardHeader, CardTitle } from "../../../../libs/ui-kit-web/dist/ui/card.js";
+import { XpBar } from "../../../learning-journey-ui-shared/src/components/XpBar.js";
+import { StreakCounter } from "../../../learning-journey-ui-shared/src/components/StreakCounter.js";
+import { BadgeDisplay } from "../../../learning-journey-ui-shared/src/components/BadgeDisplay.js";
+import "../../../learning-journey-ui-shared/src/index.js";
+import { EngagementMeter } from "../components/EngagementMeter.js";
+import { jsx, jsxs } from "react/jsx-runtime";
+
+//#region ../learning-journey-ui-coaching/src/views/Progress.tsx
+function ProgressView({ track, progress }) {
+	const totalXp = track.totalXp ?? track.steps.reduce((sum, s) => sum + (s.xpReward ?? 0), 0);
+	const completedSteps = progress.completedStepIds.length;
+	const pendingSteps = track.steps.length - completedSteps;
+	const actioned = Math.floor(completedSteps * .7);
+	const acknowledged = completedSteps - actioned;
+	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: "Engagement Overview" })]
+			}) }), /* @__PURE__ */ jsx(CardContent, { children: /* @__PURE__ */ jsx(EngagementMeter, {
+				actioned,
+				acknowledged,
+				pending: pendingSteps,
+				streak: progress.streakDays
+			}) })] }),
+			/* @__PURE__ */ jsxs("div", {
+				className: "grid gap-4 md:grid-cols-2",
+				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 Earned"
+					})
+				}), /* @__PURE__ */ jsxs(CardContent, {
+					className: "space-y-3",
+					children: [/* @__PURE__ */ jsxs("div", {
+						className: "flex items-baseline gap-2",
+						children: [/* @__PURE__ */ jsx("span", {
+							className: "text-3xl font-bold text-orange-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, {
+					className: "pb-2",
+					children: /* @__PURE__ */ jsx(CardTitle, {
+						className: "text-muted-foreground text-sm font-medium",
+						children: "Engagement Streak"
+					})
+				}), /* @__PURE__ */ jsx(CardContent, { children: /* @__PURE__ */ jsxs("div", {
+					className: "flex items-center gap-4",
+					children: [/* @__PURE__ */ jsx(StreakCounter, {
+						days: progress.streakDays,
+						size: "lg"
+					}), /* @__PURE__ */ jsx("div", {
+						className: "text-muted-foreground text-sm",
+						children: progress.streakDays > 0 ? "Keep going!" : "Start your streak today!"
+					})]
+				}) })] })]
+			}),
+			/* @__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",
+				maxVisible: 10
+			}), progress.badges.length === 0 && /* @__PURE__ */ jsx("p", {
+				className: "text-muted-foreground text-sm",
+				children: "Action tips to unlock achievements!"
+			})] })] }),
+			/* @__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: "Tip Status" })]
+			}) }), /* @__PURE__ */ jsx(CardContent, { children: /* @__PURE__ */ jsx("div", {
+				className: "space-y-3",
+				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-amber-500",
+								children: isCompleted ? "✓" : "○"
+							}), /* @__PURE__ */ jsx("span", {
+								className: isCompleted ? "text-muted-foreground" : "text-foreground",
+								children: step.title
+							})]
+						}), /* @__PURE__ */ jsx("span", {
+							className: `text-sm ${isCompleted ? "text-green-500" : "text-muted-foreground"}`,
+							children: isCompleted ? "Actioned" : "Pending"
+						})]
+					}, step.id);
+				})
+			}) })] })
+		]
+	});
+}
+
+//#endregion
+export { ProgressView };

package/dist/examples/learning-journey-ui-coaching/src/views/Steps.js

@@ -0,0 +1,68 @@
+'use client';
+
+import { TipCard } from "../components/TipCard.js";
+import { jsx, jsxs } from "react/jsx-runtime";
+
+//#region ../learning-journey-ui-coaching/src/views/Steps.tsx
+function Steps({ track, progress, onStepComplete }) {
+	const completedSteps = progress.completedStepIds.length;
+	const totalSteps = track.steps.length;
+	const sortedSteps = [...track.steps].sort((a, b) => {
+		const aCompleted = progress.completedStepIds.includes(a.id);
+		if (aCompleted === progress.completedStepIds.includes(b.id)) return 0;
+		return aCompleted ? 1 : -1;
+	});
+	const currentStepId = track.steps.find((s) => !progress.completedStepIds.includes(s.id))?.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: "Coaching Tips"
+					}),
+					/* @__PURE__ */ jsx("p", {
+						className: "text-muted-foreground",
+						children: "Review and take action on personalized tips"
+					}),
+					/* @__PURE__ */ jsxs("p", {
+						className: "text-muted-foreground mt-2 text-sm",
+						children: [
+							completedSteps,
+							" of ",
+							totalSteps,
+							" tips actioned"
+						]
+					})
+				]
+			}),
+			/* @__PURE__ */ jsx("div", {
+				className: "space-y-3",
+				children: sortedSteps.map((step) => {
+					return /* @__PURE__ */ jsx(TipCard, {
+						step,
+						isCompleted: progress.completedStepIds.includes(step.id),
+						isCurrent: step.id === currentStepId,
+						onComplete: () => onStepComplete?.(step.id),
+						onDismiss: () => onStepComplete?.(step.id)
+					}, step.id);
+				})
+			}),
+			completedSteps === totalSteps && /* @__PURE__ */ jsxs("div", {
+				className: "text-muted-foreground text-center",
+				children: [/* @__PURE__ */ jsx("span", {
+					className: "text-2xl",
+					children: "✨"
+				}), /* @__PURE__ */ jsx("p", {
+					className: "mt-2",
+					children: "All tips have been addressed!"
+				})]
+			})
+		]
+	});
+}
+
+//#endregion
+export { Steps };

package/dist/examples/learning-journey-ui-coaching/src/views/Timeline.js

@@ -0,0 +1,112 @@
+'use client';
+
+import { Card, CardContent, CardHeader, CardTitle } from "../../../../libs/ui-kit-web/dist/ui/card.js";
+import { TipFeed } from "../components/TipFeed.js";
+import { jsx, jsxs } from "react/jsx-runtime";
+
+//#region ../learning-journey-ui-coaching/src/views/Timeline.tsx
+function Timeline({ track, progress }) {
+	const feedItems = track.steps.map((step) => ({
+		step,
+		isCompleted: progress.completedStepIds.includes(step.id),
+		completedAt: progress.completedStepIds.includes(step.id) ? "Recently" : void 0
+	})).sort((a, b) => {
+		if (a.isCompleted && !b.isCompleted) return -1;
+		if (!a.isCompleted && b.isCompleted) return 1;
+		return 0;
+	});
+	const completedCount = feedItems.filter((f) => f.isCompleted).length;
+	const pendingCount = feedItems.length - completedCount;
+	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: "Activity Timeline"
+				}), /* @__PURE__ */ jsx("p", {
+					className: "text-muted-foreground",
+					children: "Your coaching journey and tip history"
+				})]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "grid grid-cols-2 gap-4",
+				children: [/* @__PURE__ */ jsx(Card, { children: /* @__PURE__ */ jsxs(CardContent, {
+					className: "p-4 text-center",
+					children: [/* @__PURE__ */ jsx("div", {
+						className: "text-2xl font-bold text-green-500",
+						children: completedCount
+					}), /* @__PURE__ */ jsx("div", {
+						className: "text-muted-foreground text-sm",
+						children: "Tips Actioned"
+					})]
+				}) }), /* @__PURE__ */ jsx(Card, { children: /* @__PURE__ */ jsxs(CardContent, {
+					className: "p-4 text-center",
+					children: [/* @__PURE__ */ jsx("div", {
+						className: "text-2xl font-bold text-amber-500",
+						children: pendingCount
+					}), /* @__PURE__ */ jsx("div", {
+						className: "text-muted-foreground text-sm",
+						children: "Tips Pending"
+					})]
+				}) })]
+			}),
+			/* @__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: "Coaching Feed" })]
+			}) }), /* @__PURE__ */ jsx(CardContent, { children: /* @__PURE__ */ jsx(TipFeed, { items: feedItems }) })] }),
+			/* @__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 Stats" })]
+			}) }), /* @__PURE__ */ jsx(CardContent, { children: /* @__PURE__ */ jsxs("div", {
+				className: "space-y-4",
+				children: [
+					/* @__PURE__ */ jsxs("div", {
+						className: "flex items-center justify-between",
+						children: [/* @__PURE__ */ jsx("span", {
+							className: "text-muted-foreground",
+							children: "Total Tips"
+						}), /* @__PURE__ */ jsx("span", {
+							className: "font-semibold",
+							children: track.steps.length
+						})]
+					}),
+					/* @__PURE__ */ jsxs("div", {
+						className: "flex items-center justify-between",
+						children: [/* @__PURE__ */ jsx("span", {
+							className: "text-muted-foreground",
+							children: "Completed"
+						}), /* @__PURE__ */ jsx("span", {
+							className: "font-semibold text-green-500",
+							children: completedCount
+						})]
+					}),
+					/* @__PURE__ */ jsxs("div", {
+						className: "flex items-center justify-between",
+						children: [/* @__PURE__ */ jsx("span", {
+							className: "text-muted-foreground",
+							children: "XP Earned"
+						}), /* @__PURE__ */ jsx("span", {
+							className: "font-semibold text-orange-500",
+							children: progress.xpEarned
+						})]
+					}),
+					/* @__PURE__ */ jsxs("div", {
+						className: "flex items-center justify-between",
+						children: [/* @__PURE__ */ jsx("span", {
+							className: "text-muted-foreground",
+							children: "Current Streak"
+						}), /* @__PURE__ */ jsx("span", {
+							className: "font-semibold",
+							children: progress.streakDays > 0 ? `🔥 ${progress.streakDays} days` : "Start today!"
+						})]
+					})
+				]
+			}) })] })
+		]
+	});
+}
+
+//#endregion
+export { Timeline };

package/dist/examples/learning-journey-ui-coaching/src/views/index.js

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

package/dist/examples/learning-journey-ui-gamified/src/GamifiedMiniApp.js

@@ -0,0 +1,64 @@
+'use client';
+
+import { Card, CardContent } from "../../../libs/ui-kit-web/dist/ui/card.js";
+import { useLearningProgress } from "../../learning-journey-ui-shared/src/hooks/useLearningProgress.js";
+import { ViewTabs } from "../../learning-journey-ui-shared/src/components/ViewTabs.js";
+import "../../learning-journey-ui-shared/src/index.js";
+import { Overview } from "./views/Overview.js";
+import { Steps } from "./views/Steps.js";
+import { Progress } from "./views/Progress.js";
+import { Timeline } from "./views/Timeline.js";
+import { useCallback, useState } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+
+//#region ../learning-journey-ui-gamified/src/GamifiedMiniApp.tsx
+function GamifiedMiniApp({ track, progress: externalProgress, onStepComplete: externalOnStepComplete, onViewChange, initialView = "overview" }) {
+	const [currentView, setCurrentView] = useState(initialView);
+	const { progress: internalProgress, completeStep: internalCompleteStep } = useLearningProgress(track);
+	const progress = externalProgress ?? internalProgress;
+	const handleViewChange = useCallback((view) => {
+		setCurrentView(view);
+		onViewChange?.(view);
+	}, [onViewChange]);
+	const handleStepComplete = useCallback((stepId) => {
+		if (externalOnStepComplete) externalOnStepComplete(stepId);
+		else internalCompleteStep(stepId);
+	}, [externalOnStepComplete, internalCompleteStep]);
+	const handleStartFromOverview = useCallback(() => {
+		setCurrentView("steps");
+		onViewChange?.("steps");
+	}, [onViewChange]);
+	const renderView = () => {
+		const viewProps = {
+			track,
+			progress,
+			onStepComplete: handleStepComplete
+		};
+		switch (currentView) {
+			case "overview": return /* @__PURE__ */ jsx(Overview, {
+				...viewProps,
+				onStart: handleStartFromOverview
+			});
+			case "steps": return /* @__PURE__ */ jsx(Steps, { ...viewProps });
+			case "progress": return /* @__PURE__ */ jsx(Progress, { ...viewProps });
+			case "timeline": return /* @__PURE__ */ jsx(Timeline, { ...viewProps });
+			default: return /* @__PURE__ */ jsx(Overview, {
+				...viewProps,
+				onStart: handleStartFromOverview
+			});
+		}
+	};
+	return /* @__PURE__ */ jsxs("div", {
+		className: "space-y-6",
+		children: [/* @__PURE__ */ jsx(Card, { children: /* @__PURE__ */ jsx(CardContent, {
+			className: "p-4",
+			children: /* @__PURE__ */ jsx(ViewTabs, {
+				currentView,
+				onViewChange: handleViewChange
+			})
+		}) }), renderView()]
+	});
+}
+
+//#endregion
+export { GamifiedMiniApp };

package/dist/examples/learning-journey-ui-gamified/src/components/DayCalendar.js

@@ -0,0 +1,32 @@
+'use client';
+
+import { cn } from "../../../../libs/ui-kit-web/dist/ui/utils.js";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+
+//#region ../learning-journey-ui-gamified/src/components/DayCalendar.tsx
+function DayCalendar({ totalDays, currentDay, completedDays }) {
+	return /* @__PURE__ */ jsx("div", {
+		className: "grid grid-cols-7 gap-2",
+		children: Array.from({ length: totalDays }, (_, i) => i + 1).map((day) => {
+			const isCompleted = completedDays.includes(day);
+			const isCurrent = day === currentDay;
+			const isLocked = day > currentDay;
+			return /* @__PURE__ */ jsx("div", {
+				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"),
+				children: isCompleted ? /* @__PURE__ */ jsx("span", {
+					className: "text-lg",
+					children: "✓"
+				}) : isLocked ? /* @__PURE__ */ jsx("span", {
+					className: "text-lg",
+					children: "🔒"
+				}) : /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx("span", {
+					className: "text-muted-foreground text-xs",
+					children: "Day"
+				}), /* @__PURE__ */ jsx("span", { children: day })] })
+			}, day);
+		})
+	});
+}
+
+//#endregion
+export { DayCalendar };

package/dist/examples/learning-journey-ui-gamified/src/components/FlashCard.js

@@ -0,0 +1,79 @@
+'use client';
+
+import { Card, CardContent } from "../../../../libs/ui-kit-web/dist/ui/card.js";
+import { cn } from "../../../../libs/ui-kit-web/dist/ui/utils.js";
+import { Button$1 } from "../../../../libs/design-system/dist/components/atoms/Button.js";
+import { useState } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+
+//#region ../learning-journey-ui-gamified/src/components/FlashCard.tsx
+function FlashCard({ step, isCompleted, isCurrent, onComplete }) {
+	const [isFlipped, setIsFlipped] = useState(false);
+	return /* @__PURE__ */ jsx(Card, {
+		className: cn("relative cursor-pointer overflow-hidden transition-all duration-300", isCurrent && "ring-primary ring-2", isCompleted && "opacity-60"),
+		onClick: () => !isCompleted && setIsFlipped(!isFlipped),
+		children: /* @__PURE__ */ jsxs(CardContent, {
+			className: "p-6",
+			children: [/* @__PURE__ */ jsxs("div", {
+				className: cn("space-y-4 transition-opacity duration-200", isFlipped ? "opacity-0" : "opacity-100"),
+				children: [
+					/* @__PURE__ */ jsxs("div", {
+						className: "flex items-start justify-between",
+						children: [/* @__PURE__ */ jsxs("div", {
+							className: "flex-1",
+							children: [/* @__PURE__ */ jsx("h3", {
+								className: "text-lg font-semibold",
+								children: step.title
+							}), step.description && /* @__PURE__ */ jsx("p", {
+								className: "text-muted-foreground mt-1 text-sm",
+								children: step.description
+							})]
+						}), step.xpReward && /* @__PURE__ */ jsxs("span", {
+							className: "rounded-full bg-green-500/10 px-2 py-1 text-xs font-semibold text-green-500",
+							children: [
+								"+",
+								step.xpReward,
+								" XP"
+							]
+						})]
+					}),
+					isCompleted && /* @__PURE__ */ jsxs("div", {
+						className: "flex items-center gap-2 text-green-500",
+						children: [/* @__PURE__ */ jsx("span", { children: "✓" }), /* @__PURE__ */ jsx("span", {
+							className: "text-sm font-medium",
+							children: "Completed"
+						})]
+					}),
+					isCurrent && !isCompleted && /* @__PURE__ */ jsx("p", {
+						className: "text-muted-foreground text-xs",
+						children: "Tap to reveal action"
+					})
+				]
+			}), isFlipped && !isCompleted && /* @__PURE__ */ jsxs("div", {
+				className: "absolute inset-0 flex flex-col items-center justify-center gap-4 bg-gradient-to-br from-violet-500/10 to-violet-600/10 p-6",
+				children: [/* @__PURE__ */ jsx("p", {
+					className: "text-center text-sm",
+					children: step.instructions ?? "Complete this step to earn XP"
+				}), /* @__PURE__ */ jsxs("div", {
+					className: "flex gap-2",
+					children: [/* @__PURE__ */ jsx(Button$1, {
+						variant: "outline",
+						size: "sm",
+						onClick: () => setIsFlipped(false),
+						children: "Back"
+					}), /* @__PURE__ */ jsx(Button$1, {
+						size: "sm",
+						onClick: (e) => {
+							e.stopPropagation();
+							onComplete?.();
+						},
+						children: "Mark Complete"
+					})]
+				})]
+			})]
+		})
+	});
+}
+
+//#endregion
+export { FlashCard };

package/dist/examples/learning-journey-ui-gamified/src/components/MasteryRing.js

@@ -0,0 +1,81 @@
+'use client';
+
+import { cn } from "../../../../libs/ui-kit-web/dist/ui/utils.js";
+import { jsx, jsxs } from "react/jsx-runtime";
+
+//#region ../learning-journey-ui-gamified/src/components/MasteryRing.tsx
+const sizeStyles = {
+	sm: {
+		container: "h-16 w-16",
+		text: "text-xs",
+		ring: 48,
+		stroke: 4
+	},
+	md: {
+		container: "h-24 w-24",
+		text: "text-sm",
+		ring: 72,
+		stroke: 6
+	},
+	lg: {
+		container: "h-32 w-32",
+		text: "text-base",
+		ring: 96,
+		stroke: 8
+	}
+};
+const colorStyles = {
+	green: "stroke-green-500",
+	blue: "stroke-blue-500",
+	violet: "stroke-violet-500",
+	orange: "stroke-orange-500"
+};
+function MasteryRing({ label, percentage, size = "md", color = "violet" }) {
+	const styles = sizeStyles[size];
+	const radius = (styles.ring - styles.stroke) / 2;
+	const circumference = 2 * Math.PI * radius;
+	const strokeDashoffset = circumference - percentage / 100 * circumference;
+	return /* @__PURE__ */ jsxs("div", {
+		className: cn("relative flex flex-col items-center gap-1", styles.container),
+		children: [
+			/* @__PURE__ */ jsxs("svg", {
+				className: "absolute -rotate-90",
+				width: styles.ring,
+				height: styles.ring,
+				viewBox: `0 0 ${styles.ring} ${styles.ring}`,
+				children: [/* @__PURE__ */ jsx("circle", {
+					cx: styles.ring / 2,
+					cy: styles.ring / 2,
+					r: radius,
+					fill: "none",
+					strokeWidth: styles.stroke,
+					className: "stroke-muted"
+				}), /* @__PURE__ */ jsx("circle", {
+					cx: styles.ring / 2,
+					cy: styles.ring / 2,
+					r: radius,
+					fill: "none",
+					strokeWidth: styles.stroke,
+					strokeLinecap: "round",
+					strokeDasharray: circumference,
+					strokeDashoffset,
+					className: cn("transition-all duration-500", colorStyles[color])
+				})]
+			}),
+			/* @__PURE__ */ jsx("div", {
+				className: "flex h-full flex-col items-center justify-center",
+				children: /* @__PURE__ */ jsxs("span", {
+					className: cn("font-bold", styles.text),
+					children: [Math.round(percentage), "%"]
+				})
+			}),
+			/* @__PURE__ */ jsx("span", {
+				className: cn("text-muted-foreground mt-1 truncate", styles.text),
+				children: label
+			})
+		]
+	});
+}
+
+//#endregion
+export { MasteryRing };

package/dist/examples/learning-journey-ui-gamified/src/components/index.js

@@ -0,0 +1,3 @@
+import { FlashCard } from "./FlashCard.js";
+import { MasteryRing } from "./MasteryRing.js";
+import { DayCalendar } from "./DayCalendar.js";

package/dist/examples/learning-journey-ui-gamified/src/docs/index.js

@@ -0,0 +1 @@
+import "./learning-journey-ui-gamified.docblock.js";

package/dist/examples/learning-journey-ui-gamified/src/docs/learning-journey-ui-gamified.docblock.js

@@ -0,0 +1,20 @@
+import { registerDocBlocks } from "../../../../libs/contracts/dist/docs/registry.js";
+import "../../../../libs/contracts/dist/docs/index.js";
+
+//#region ../learning-journey-ui-gamified/src/docs/learning-journey-ui-gamified.docblock.ts
+registerDocBlocks([{
+	id: "docs.examples.learning-journey-ui-gamified",
+	title: "Learning Journey UI — Gamified",
+	summary: "UI mini-app components for gamified learning: flashcards, mastery, streak/calendar.",
+	kind: "reference",
+	visibility: "public",
+	route: "/docs/examples/learning-journey-ui-gamified",
+	tags: [
+		"learning",
+		"ui",
+		"gamified"
+	],
+	body: `## Includes\n- Gamified mini-app shell\n- Views: overview, steps, progress, timeline\n- Components: flash card, mastery ring, day calendar\n\n## Notes\n- Compose with design system components.\n- Respect prefers-reduced-motion; keep tap targets large.`
+}]);
+
+//#endregion

package/dist/examples/learning-journey-ui-gamified/src/index.js

@@ -0,0 +1,11 @@
+import { Overview } from "./views/Overview.js";
+import { FlashCard } from "./components/FlashCard.js";
+import { Steps } from "./views/Steps.js";
+import { MasteryRing } from "./components/MasteryRing.js";
+import { Progress } from "./views/Progress.js";
+import { DayCalendar } from "./components/DayCalendar.js";
+import { Timeline } from "./views/Timeline.js";
+import { GamifiedMiniApp } from "./GamifiedMiniApp.js";
+import "./views/index.js";
+import "./components/index.js";
+import "./docs/index.js";