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

package/dist/examples/learning-journey-platform-tour/dist/track.js

@@ -0,0 +1,105 @@
+//#region ../learning-journey-platform-tour/dist/track.js
+const platformPrimitivesTourTrack = {
+	id: "platform_primitives_tour",
+	productId: "contractspec-platform",
+	name: "Platform Primitives Tour",
+	description: "Hands-on tour across identity, audit, notifications, jobs, flags, files, and metering.",
+	targetUserSegment: "platform_developer",
+	targetRole: "developer",
+	totalXp: 140,
+	completionRewards: {
+		xpBonus: 20,
+		badgeKey: "platform_primitives"
+	},
+	steps: [
+		{
+			id: "identity_rbac",
+			title: "Create org and member",
+			description: "Create an org and add at least one member.",
+			order: 1,
+			completion: {
+				eventName: "org.member.added",
+				sourceModule: "@lssm/lib.identity-rbac"
+			},
+			xpReward: 20,
+			metadata: { surface: "identity" }
+		},
+		{
+			id: "event_bus_audit",
+			title: "Emit an auditable event",
+			description: "Emit an event that lands in the audit log.",
+			order: 2,
+			completion: {
+				eventName: "audit_log.created",
+				sourceModule: "@lssm/module.audit-trail"
+			},
+			xpReward: 20,
+			metadata: { surface: "bus+audit" }
+		},
+		{
+			id: "notifications",
+			title: "Send a notification",
+			description: "Send yourself a notification and verify delivery.",
+			order: 3,
+			completion: {
+				eventName: "notification.sent",
+				sourceModule: "@lssm/module.notifications"
+			},
+			xpReward: 20,
+			metadata: { surface: "notifications" }
+		},
+		{
+			id: "jobs_scheduler",
+			title: "Schedule and run a job",
+			description: "Schedule a background job and let it run once.",
+			order: 4,
+			completion: {
+				eventName: "job.completed",
+				sourceModule: "@lssm/lib.jobs"
+			},
+			xpReward: 20,
+			metadata: { surface: "jobs" }
+		},
+		{
+			id: "feature_flags",
+			title: "Create and toggle a feature flag",
+			description: "Create a feature flag and toggle it at least once.",
+			order: 5,
+			completion: {
+				eventName: "flag.toggled",
+				sourceModule: "@lssm/lib.feature-flags"
+			},
+			xpReward: 20,
+			metadata: { surface: "feature-flags" }
+		},
+		{
+			id: "files_attachments",
+			title: "Attach a file",
+			description: "Upload and attach a file to any entity.",
+			order: 6,
+			completion: {
+				eventName: "attachment.attached",
+				sourceModule: "@lssm/lib.files"
+			},
+			xpReward: 20,
+			metadata: { surface: "files" }
+		},
+		{
+			id: "usage_metering",
+			title: "Record usage",
+			description: "Emit a usage metric (regeneration, agent run, or similar).",
+			order: 7,
+			completion: {
+				eventName: "usage.recorded",
+				sourceModule: "@lssm/lib.metering"
+			},
+			xpReward: 20,
+			metadata: { surface: "metering" }
+		}
+	],
+	metadata: { surfacedIn: ["studio/learning", "platform/dev-center"] }
+};
+const platformLearningTracks = [platformPrimitivesTourTrack];
+
+//#endregion
+export { platformLearningTracks };

package/dist/examples/learning-journey-quest-challenges/src/track.js

@@ -0,0 +1,35 @@
+//#region ../learning-journey-quest-challenges/src/track.ts
+const dayStep = (id, day, eventName, description) => ({
+	id,
+	title: `Day ${day}`,
+	description,
+	availability: { unlockOnDay: day },
+	completion: {
+		kind: "time_window",
+		eventName,
+		withinHoursOfStart: (day + 1) * 24
+	},
+	xpReward: 15,
+	metadata: { day }
+});
+const moneyResetQuestTrack = {
+	id: "money_reset_7day",
+	name: "7-day Money Reset",
+	description: "Time-bound quest to reset personal finances over a focused week.",
+	targetUserSegment: "money_user",
+	totalXp: 105,
+	completionRewards: { xpBonus: 30 },
+	steps: [
+		dayStep("day1_map_accounts", 1, "accounts.mapped", "Map bank and card accounts."),
+		dayStep("day2_categorize_transactions", 2, "transactions.categorized", "Categorize recent transactions."),
+		dayStep("day3_define_goals", 3, "goals.created", "Define at least one savings goal."),
+		dayStep("day4_setup_recurring_savings", 4, "recurring_rule.created", "Set a recurring savings rule."),
+		dayStep("day5_review_subscriptions", 5, "subscription.flagged_or_cancelled", "Review subscriptions and flag or cancel wasteful ones."),
+		dayStep("day6_plan_emergency", 6, "emergency_plan.completed", "Draft an emergency plan and target buffer."),
+		dayStep("day7_review_commit", 7, "quest.review.completed", "Review week outcomes and commit to the next month.")
+	]
+};
+const questTracks = [moneyResetQuestTrack];
+
+//#endregion
+export { questTracks };

package/dist/examples/learning-journey-studio-onboarding/dist/track.js

@@ -0,0 +1,90 @@
+//#region ../learning-journey-studio-onboarding/dist/track.js
+const studioGettingStartedTrack = {
+	id: "studio_getting_started",
+	productId: "contractspec-studio",
+	name: "Studio Getting Started",
+	description: "First 30 minutes in Studio: create a project, edit the spec, deploy/regenerate, and try key modules.",
+	targetUserSegment: "new_studio_user",
+	targetRole: "developer",
+	totalXp: 110,
+	streakRule: {
+		hoursWindow: 48,
+		bonusXp: 25
+	},
+	completionRewards: {
+		xpBonus: 25,
+		badgeKey: "studio_first_30m"
+	},
+	steps: [
+		{
+			id: "choose_template",
+			title: "Choose a template",
+			description: "Create your first Studio project (starter template).",
+			order: 1,
+			completion: {
+				eventName: "studio.template.instantiated",
+				sourceModule: "@lssm/bundle.contractspec-studio"
+			},
+			xpReward: 20,
+			metadata: { surface: "projects" }
+		},
+		{
+			id: "edit_spec",
+			title: "Edit the spec",
+			description: "Change the spec (not generated code) and save.",
+			instructions: "Open spec editor, tweak a contract or presentation, save.",
+			order: 2,
+			completion: {
+				eventName: "spec.changed",
+				sourceModule: "@lssm/bundle.contractspec-studio"
+			},
+			xpReward: 20,
+			metadata: { surface: "spec-editor" }
+		},
+		{
+			id: "regenerate_app",
+			title: "Regenerate the app",
+			description: "Regenerate artifacts from the updated spec.",
+			order: 3,
+			completion: {
+				eventName: "regeneration.completed",
+				sourceModule: "@lssm/lib.contracts/regenerator"
+			},
+			xpReward: 20,
+			metadata: { surface: "regenerator" }
+		},
+		{
+			id: "open_canvas",
+			title: "Open the canvas",
+			description: "Visit the canvas module for your project.",
+			order: 4,
+			completion: {
+				eventName: "module.navigated",
+				sourceModule: "@lssm/bundle.contractspec-studio",
+				payloadFilter: { moduleId: "canvas" }
+			},
+			xpReward: 20,
+			metadata: { surface: "canvas" }
+		},
+		{
+			id: "try_evolution_mode",
+			title: "Try evolution mode",
+			description: "Request a change via Evolution, then regenerate.",
+			order: 5,
+			completion: {
+				eventName: "studio.evolution.applied",
+				sourceModule: "@lssm/lib.evolution"
+			},
+			xpReward: 30,
+			metadata: { surface: "evolution" }
+		}
+	],
+	metadata: {
+		persona: "first_run",
+		surfacedIn: ["studio/home", "studio/sidebar/learning"]
+	}
+};
+const studioLearningTracks = [studioGettingStartedTrack];
+
+//#endregion
+export { studioLearningTracks };

package/dist/examples/learning-journey-ui-coaching/src/CoachingMiniApp.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 { ProgressView } 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-coaching/src/CoachingMiniApp.tsx
+function CoachingMiniApp({ 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(ProgressView, { ...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 { CoachingMiniApp };

package/dist/examples/learning-journey-ui-coaching/src/components/EngagementMeter.js

@@ -0,0 +1,107 @@
+'use client';
+
+import { jsx, jsxs } from "react/jsx-runtime";
+
+//#region ../learning-journey-ui-coaching/src/components/EngagementMeter.tsx
+function EngagementMeter({ acknowledged, actioned, pending, streak = 0 }) {
+	const total = acknowledged + actioned + pending;
+	const actionedPercent = total > 0 ? actioned / total * 100 : 0;
+	const acknowledgedPercent = total > 0 ? acknowledged / total * 100 : 0;
+	return /* @__PURE__ */ jsxs("div", {
+		className: "space-y-4",
+		children: [
+			/* @__PURE__ */ jsx("div", {
+				className: "flex items-center justify-center",
+				children: /* @__PURE__ */ jsxs("div", {
+					className: "relative h-32 w-32",
+					children: [/* @__PURE__ */ jsxs("svg", {
+						className: "h-full w-full -rotate-90",
+						viewBox: "0 0 100 100",
+						children: [
+							/* @__PURE__ */ jsx("circle", {
+								cx: "50",
+								cy: "50",
+								r: "40",
+								fill: "none",
+								strokeWidth: "12",
+								className: "stroke-muted"
+							}),
+							/* @__PURE__ */ jsx("circle", {
+								cx: "50",
+								cy: "50",
+								r: "40",
+								fill: "none",
+								strokeWidth: "12",
+								strokeLinecap: "round",
+								strokeDasharray: `${actionedPercent * 2.51} 251`,
+								className: "stroke-green-500 transition-all duration-500"
+							}),
+							/* @__PURE__ */ jsx("circle", {
+								cx: "50",
+								cy: "50",
+								r: "40",
+								fill: "none",
+								strokeWidth: "12",
+								strokeLinecap: "round",
+								strokeDasharray: `${acknowledgedPercent * 2.51} 251`,
+								strokeDashoffset: `${-actionedPercent * 2.51}`,
+								className: "stroke-amber-500 transition-all duration-500"
+							})
+						]
+					}), /* @__PURE__ */ jsxs("div", {
+						className: "absolute inset-0 flex flex-col items-center justify-center",
+						children: [/* @__PURE__ */ jsx("span", {
+							className: "text-2xl font-bold",
+							children: total
+						}), /* @__PURE__ */ jsx("span", {
+							className: "text-muted-foreground text-xs",
+							children: "tips"
+						})]
+					})]
+				})
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "flex justify-center gap-4 text-sm",
+				children: [
+					/* @__PURE__ */ jsxs("div", {
+						className: "flex items-center gap-1.5",
+						children: [/* @__PURE__ */ jsx("div", { className: "h-3 w-3 rounded-full bg-green-500" }), /* @__PURE__ */ jsxs("span", { children: [
+							"Actioned (",
+							actioned,
+							")"
+						] })]
+					}),
+					/* @__PURE__ */ jsxs("div", {
+						className: "flex items-center gap-1.5",
+						children: [/* @__PURE__ */ jsx("div", { className: "h-3 w-3 rounded-full bg-amber-500" }), /* @__PURE__ */ jsxs("span", { children: [
+							"Acknowledged (",
+							acknowledged,
+							")"
+						] })]
+					}),
+					/* @__PURE__ */ jsxs("div", {
+						className: "flex items-center gap-1.5",
+						children: [/* @__PURE__ */ jsx("div", { className: "bg-muted h-3 w-3 rounded-full" }), /* @__PURE__ */ jsxs("span", { children: [
+							"Pending (",
+							pending,
+							")"
+						] })]
+					})
+				]
+			}),
+			streak > 0 && /* @__PURE__ */ jsxs("div", {
+				className: "flex items-center justify-center gap-2 rounded-lg bg-orange-500/10 px-4 py-2",
+				children: [/* @__PURE__ */ jsx("span", {
+					className: "text-xl",
+					children: "🔥"
+				}), /* @__PURE__ */ jsxs("span", {
+					className: "font-semibold text-orange-500",
+					children: [streak, " day engagement streak!"]
+				})]
+			})
+		]
+	});
+}
+
+//#endregion
+export { EngagementMeter };

package/dist/examples/learning-journey-ui-coaching/src/components/TipCard.js

@@ -0,0 +1,75 @@
+'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 { jsx, jsxs } from "react/jsx-runtime";
+
+//#region ../learning-journey-ui-coaching/src/components/TipCard.tsx
+const TIP_ICONS = {
+	cash_buffer_too_high: "💰",
+	no_savings_goal: "🎯",
+	irregular_savings: "📅",
+	noise_late_evening: "🔇",
+	guest_frequency_high: "👥",
+	shared_space_conflicts: "🏠",
+	default: "💡"
+};
+function TipCard({ step, isCompleted, isCurrent, onComplete, onDismiss }) {
+	const icon = TIP_ICONS[step.metadata?.tipId ?? "default"] ?? TIP_ICONS.default;
+	return /* @__PURE__ */ jsx(Card, {
+		className: cn("transition-all", isCompleted && "opacity-60", isCurrent && "ring-2 ring-amber-500"),
+		children: /* @__PURE__ */ jsx(CardContent, {
+			className: "p-4",
+			children: /* @__PURE__ */ jsxs("div", {
+				className: "flex gap-4",
+				children: [/* @__PURE__ */ jsx("div", {
+					className: cn("flex h-12 w-12 shrink-0 items-center justify-center rounded-xl text-2xl", isCompleted ? "bg-green-500/10" : isCurrent ? "bg-amber-500/10" : "bg-muted"),
+					children: isCompleted ? "✓" : icon
+				}), /* @__PURE__ */ jsxs("div", {
+					className: "min-w-0 flex-1",
+					children: [
+						/* @__PURE__ */ jsxs("div", {
+							className: "flex items-start justify-between gap-2",
+							children: [/* @__PURE__ */ jsx("h4", {
+								className: "font-semibold",
+								children: step.title
+							}), step.xpReward && /* @__PURE__ */ jsxs("span", {
+								className: cn("shrink-0 rounded-full px-2 py-0.5 text-xs font-semibold", isCompleted ? "bg-green-500/10 text-green-500" : "bg-amber-500/10 text-amber-500"),
+								children: [
+									"+",
+									step.xpReward,
+									" XP"
+								]
+							})]
+						}),
+						/* @__PURE__ */ jsx("p", {
+							className: "text-muted-foreground mt-1 text-sm",
+							children: step.description
+						}),
+						!isCompleted && /* @__PURE__ */ jsxs("div", {
+							className: "mt-3 flex flex-wrap gap-2",
+							children: [/* @__PURE__ */ jsx(Button$1, {
+								size: "sm",
+								onClick: onComplete,
+								children: "Take Action"
+							}), /* @__PURE__ */ jsx(Button$1, {
+								variant: "outline",
+								size: "sm",
+								onClick: onDismiss,
+								children: "Dismiss"
+							})]
+						}),
+						isCompleted && /* @__PURE__ */ jsx("p", {
+							className: "mt-2 text-sm text-green-500",
+							children: "✓ Tip acknowledged"
+						})
+					]
+				})]
+			})
+		})
+	});
+}
+
+//#endregion
+export { TipCard };

package/dist/examples/learning-journey-ui-coaching/src/components/TipFeed.js

@@ -0,0 +1,65 @@
+'use client';
+
+import { cn } from "../../../../libs/ui-kit-web/dist/ui/utils.js";
+import { jsx, jsxs } from "react/jsx-runtime";
+
+//#region ../learning-journey-ui-coaching/src/components/TipFeed.tsx
+const TIP_ICONS = {
+	cash_buffer_too_high: "💰",
+	no_savings_goal: "🎯",
+	irregular_savings: "📅",
+	noise_late_evening: "🔇",
+	guest_frequency_high: "👥",
+	shared_space_conflicts: "🏠",
+	default: "💡"
+};
+function TipFeed({ items }) {
+	if (items.length === 0) return /* @__PURE__ */ jsx("div", {
+		className: "text-muted-foreground py-8 text-center",
+		children: "No tips yet. Start engaging with coaching tips!"
+	});
+	return /* @__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-4",
+			children: items.map((item, index) => {
+				const icon = TIP_ICONS[item.step.metadata?.tipId ?? "default"] ?? TIP_ICONS.default;
+				return /* @__PURE__ */ jsxs("div", {
+					className: "relative flex gap-4 pl-2",
+					children: [/* @__PURE__ */ jsx("div", {
+						className: cn("relative z-10 flex h-8 w-8 shrink-0 items-center justify-center rounded-full text-sm", item.isCompleted ? "bg-green-500 text-white" : "bg-muted text-muted-foreground"),
+						children: item.isCompleted ? "✓" : icon
+					}), /* @__PURE__ */ jsxs("div", {
+						className: "bg-card flex-1 rounded-lg border p-3",
+						children: [/* @__PURE__ */ jsxs("div", {
+							className: "flex items-start justify-between gap-2",
+							children: [/* @__PURE__ */ jsxs("div", { children: [/* @__PURE__ */ jsx("p", {
+								className: "font-medium",
+								children: item.step.title
+							}), /* @__PURE__ */ jsx("p", {
+								className: "text-muted-foreground mt-0.5 text-sm",
+								children: item.step.description
+							})] }), item.step.xpReward && /* @__PURE__ */ jsxs("span", {
+								className: cn("shrink-0 text-xs font-medium", item.isCompleted ? "text-green-500" : "text-muted-foreground"),
+								children: [
+									"+",
+									item.step.xpReward,
+									" XP"
+								]
+							})]
+						}), /* @__PURE__ */ jsx("div", {
+							className: "text-muted-foreground mt-2 flex items-center gap-2 text-xs",
+							children: item.isCompleted ? /* @__PURE__ */ jsxs("span", {
+								className: "text-green-500",
+								children: ["✓ Completed", item.completedAt && ` • ${item.completedAt}`]
+							}) : /* @__PURE__ */ jsx("span", { children: "Pending action" })
+						})]
+					})]
+				}, item.step.id);
+			})
+		})]
+	});
+}
+
+//#endregion
+export { TipFeed };

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

@@ -0,0 +1,3 @@
+import { TipCard } from "./TipCard.js";
+import { EngagementMeter } from "./EngagementMeter.js";
+import { TipFeed } from "./TipFeed.js";

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

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

package/dist/examples/learning-journey-ui-coaching/src/docs/learning-journey-ui-coaching.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-coaching/src/docs/learning-journey-ui-coaching.docblock.ts
+registerDocBlocks([{
+	id: "docs.examples.learning-journey-ui-coaching",
+	title: "Learning Journey UI — Coaching",
+	summary: "UI mini-app components for coaching: tips, engagement, progress.",
+	kind: "reference",
+	visibility: "public",
+	route: "/docs/examples/learning-journey-ui-coaching",
+	tags: [
+		"learning",
+		"ui",
+		"coaching"
+	],
+	body: `## Includes\n- Coaching mini-app shell\n- Views: overview, steps, progress, timeline\n- Components: tip card, engagement meter, tip feed\n\n## Notes\n- Compose using design system components.\n- Keep accessibility and mobile-friendly tap targets.`
+}]);
+
+//#endregion

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

@@ -0,0 +1,11 @@
+import { TipCard } from "./components/TipCard.js";
+import { Overview } from "./views/Overview.js";
+import { Steps } from "./views/Steps.js";
+import { EngagementMeter } from "./components/EngagementMeter.js";
+import { ProgressView } from "./views/Progress.js";
+import { TipFeed } from "./components/TipFeed.js";
+import { Timeline } from "./views/Timeline.js";
+import { CoachingMiniApp } from "./CoachingMiniApp.js";
+import "./views/index.js";
+import "./components/index.js";
+import "./docs/index.js";