@contractspec/example.learning-journey-registry 0.0.0-canary-20260113170453

package/dist/api-types.d.ts

@@ -0,0 +1,41 @@
+import { LearningJourneyTrackSpec } from "@contractspec/module.learning-journey/track-spec";
+
+//#region src/api-types.d.ts
+interface LearningEvent {
+  name: string;
+  version?: number;
+  sourceModule?: string;
+  payload?: Record<string, unknown>;
+  occurredAt?: Date;
+  learnerId: string;
+  trackId?: string;
+}
+type StepStatus = 'PENDING' | 'COMPLETED';
+interface StepProgress {
+  id: string;
+  status: StepStatus;
+  xpEarned: number;
+  completedAt?: Date;
+  triggeringEvent?: string;
+  eventPayload?: Record<string, unknown>;
+  occurrences?: number;
+  counterStartedAt?: Date;
+  availableAt?: Date;
+  dueAt?: Date;
+  masteryCount?: number;
+}
+interface TrackProgress {
+  learnerId: string;
+  trackId: string;
+  progress: number;
+  isCompleted: boolean;
+  xpEarned: number;
+  startedAt?: Date;
+  completedAt?: Date;
+  lastActivityAt?: Date;
+  steps: StepProgress[];
+}
+type TrackResolver = (trackId: string) => LearningJourneyTrackSpec | undefined;
+//#endregion
+export { LearningEvent, StepProgress, StepStatus, TrackProgress, TrackResolver };
+//# sourceMappingURL=api-types.d.ts.map

package/dist/api-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-types.d.ts","names":[],"sources":["../src/api-types.ts"],"sourcesContent":[],"mappings":";;;UAEiB,aAAA;;EAAA,OAAA,CAAA,EAAA,MAAa;EAUlB,YAAA,CAAU,EAAA,MAAA;EAEL,OAAA,CAAA,EARL,MAQiB,CAAA,MAAA,EAAA,OAAA,CAAA;EAEnB,UAAA,CAAA,EATK,IASL;EAEM,SAAA,EAAA,MAAA;EAEC,OAAA,CAAA,EAAA,MAAA;;AAGD,KAXJ,UAAA,GAWI,SAAA,GAAA,WAAA;AACN,UAVO,YAAA,CAUP;EAAI,EAAA,EAAA,MAAA;EAIG,MAAA,EAZP,UAYoB;EAMhB,QAAA,EAAA,MAAA;EACE,WAAA,CAAA,EAjBA,IAiBA;EACG,eAAA,CAAA,EAAA,MAAA;EACV,YAAA,CAAA,EAjBQ,MAiBR,CAAA,MAAA,EAAA,OAAA,CAAA;EAAY,WAAA,CAAA,EAAA,MAAA;EAGT,gBAAa,CAAA,EAlBJ,IAkBI;gBAjBT;UACN;;;UAIO,aAAA;;;;;;cAMH;gBACE;mBACG;SACV;;KAGG,aAAA,wBAEP"}

package/dist/api.d.ts

@@ -0,0 +1,13 @@
+import { LearningEvent, TrackProgress } from "./api-types.js";
+import { LearningJourneyTrackSpec } from "@contractspec/module.learning-journey/track-spec";
+
+//#region src/api.d.ts
+declare const listTracks: (learnerId?: string) => {
+  tracks: LearningJourneyTrackSpec[];
+  progress: TrackProgress[];
+};
+declare const getProgress: (trackId: string, learnerId: string) => TrackProgress | undefined;
+declare const recordEvent: (event: LearningEvent) => TrackProgress[];
+//#endregion
+export { getProgress, listTracks, recordEvent };
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","names":[],"sources":["../src/api.ts"],"sourcesContent":[],"mappings":";;;;cAyLa;UAWZ;EAXY,QAAA,EAWZ,aAAA,EAAA;AAED,CAAA;AAUa,cAVA,WAUsB,EAAA,CAAA,OAAA,EAAA,MAAa,EAAA,SAAA,EAAA,MAAA,EAAA,GAVc,aAUd,GAAA,SAAA;cAAnC,qBAAsB,kBAAa"}

package/dist/api.js

@@ -0,0 +1,171 @@
+import { learningJourneyTracks } from "./tracks.js";
+import { getLearnerTracks, getTrackResolver, initProgress } from "./progress-store.js";
+
+//#region src/api.ts
+const getTrack = getTrackResolver(learningJourneyTracks);
+const matchesFilter = (filter, payload) => {
+	if (!filter) return true;
+	if (!payload) return false;
+	return Object.entries(filter).every(([key, value]) => payload[key] === value);
+};
+const matchesBaseEvent = (condition, event) => {
+	if (condition.eventName !== event.name) return false;
+	if (condition.eventVersion !== void 0 && event.version !== void 0) {
+		if (condition.eventVersion !== event.version) return false;
+	}
+	if (condition.sourceModule && event.sourceModule && condition.sourceModule !== event.sourceModule) return false;
+	return matchesFilter(condition.payloadFilter, event.payload);
+};
+const matchesCondition = (condition, event, step, trackStartedAt) => {
+	if (condition.kind === "count") {
+		if (!matchesBaseEvent(condition, event)) return { matched: false };
+		const occurrences = (step.occurrences ?? 0) + 1;
+		return {
+			matched: (condition.withinHours === void 0 || Boolean(trackStartedAt && event.occurredAt && (event.occurredAt.getTime() - trackStartedAt.getTime()) / (1e3 * 60 * 60) <= condition.withinHours)) && occurrences >= condition.atLeast,
+			occurrences
+		};
+	}
+	if (condition.kind === "time_window") {
+		if (!matchesBaseEvent(condition, event)) return { matched: false };
+		if (condition.withinHoursOfStart !== void 0 && trackStartedAt && event.occurredAt) {
+			if ((event.occurredAt.getTime() - trackStartedAt.getTime()) / (1e3 * 60 * 60) > condition.withinHoursOfStart) return { matched: false };
+		}
+		return { matched: true };
+	}
+	if (condition.kind === "srs_mastery") {
+		if (event.name !== condition.eventName) return { matched: false };
+		const payload = event.payload;
+		if (!matchesFilter(condition.payloadFilter, payload)) return { matched: false };
+		const skillKey = condition.skillIdField ?? "skillId";
+		const masteryKey = condition.masteryField ?? "mastery";
+		const skillId = payload?.[skillKey];
+		const masteryValue = payload?.[masteryKey];
+		if (skillId === void 0 || masteryValue === void 0) return { matched: false };
+		if (typeof masteryValue !== "number") return { matched: false };
+		if (masteryValue < condition.minimumMastery) return { matched: false };
+		const masteryCount = (step.masteryCount ?? 0) + 1;
+		return {
+			matched: masteryCount >= (condition.requiredCount ?? 1),
+			masteryCount
+		};
+	}
+	return { matched: matchesBaseEvent(condition, event) };
+};
+const getAvailability = (availability, startedAt) => {
+	if (!availability || !startedAt) return {};
+	const baseTime = startedAt.getTime();
+	let unlockTime = baseTime;
+	if (availability.unlockOnDay !== void 0) unlockTime = baseTime + (availability.unlockOnDay - 1) * 24 * 60 * 60 * 1e3;
+	if (availability.unlockAfterHours !== void 0) unlockTime = baseTime + availability.unlockAfterHours * 60 * 60 * 1e3;
+	const availableAt = new Date(unlockTime);
+	return {
+		availableAt,
+		dueAt: availability.dueWithinHours !== void 0 ? new Date(availableAt.getTime() + availability.dueWithinHours * 60 * 60 * 1e3) : void 0
+	};
+};
+const computeProgressPercent = (steps) => {
+	const total = steps.length || 1;
+	const done = steps.filter((s) => s.status === "COMPLETED").length;
+	return Math.round(done / total * 100);
+};
+const applyTrackCompletionBonuses = (track, progress) => {
+	if (progress.isCompleted) return progress;
+	const completedAt = /* @__PURE__ */ new Date();
+	const startedAt = progress.startedAt ?? completedAt;
+	const hoursElapsed = (completedAt.getTime() - startedAt.getTime()) / (1e3 * 60 * 60);
+	let xpEarned = progress.xpEarned;
+	const { completionRewards, streakRule } = track;
+	if (completionRewards?.xpBonus) xpEarned += completionRewards.xpBonus;
+	if (streakRule?.hoursWindow !== void 0 && hoursElapsed <= streakRule.hoursWindow && streakRule.bonusXp) xpEarned += streakRule.bonusXp;
+	return {
+		...progress,
+		xpEarned,
+		isCompleted: true,
+		completedAt,
+		lastActivityAt: completedAt
+	};
+};
+const listTracks = (learnerId) => {
+	const progressMap = learnerId ? getLearnerTracks(learnerId) : void 0;
+	return {
+		tracks: learningJourneyTracks,
+		progress: learnerId && progressMap ? Array.from(progressMap.values()) : []
+	};
+};
+const getProgress = (trackId, learnerId) => {
+	const track = getTrack(trackId);
+	if (!track) return void 0;
+	const map = getLearnerTracks(learnerId);
+	const existing = map.get(trackId) ?? initProgress(learnerId, track);
+	map.set(trackId, existing);
+	return existing;
+};
+const recordEvent = (event) => {
+	const targets = event.trackId !== void 0 ? learningJourneyTracks.filter((t) => t.id === event.trackId) : learningJourneyTracks;
+	const updated = [];
+	const eventTime = event.occurredAt ?? /* @__PURE__ */ new Date();
+	for (const track of targets) {
+		const map = getLearnerTracks(event.learnerId);
+		const current = map.get(track.id) ?? initProgress(event.learnerId, track);
+		const startedAt = current.startedAt ?? eventTime;
+		let changed = current.startedAt === void 0;
+		const steps = current.steps.map((step) => {
+			if (step.status === "COMPLETED") return step;
+			const spec = track.steps.find((s) => s.id === step.id);
+			if (!spec) return step;
+			const { availableAt, dueAt } = getAvailability(spec.availability, startedAt);
+			if (availableAt && eventTime < availableAt) return {
+				...step,
+				availableAt,
+				dueAt
+			};
+			if (dueAt && eventTime > dueAt) return {
+				...step,
+				availableAt,
+				dueAt
+			};
+			const result = matchesCondition(spec.completion, event, step, startedAt);
+			if (result.matched) {
+				changed = true;
+				return {
+					...step,
+					status: "COMPLETED",
+					xpEarned: spec.xpReward ?? 0,
+					completedAt: eventTime,
+					triggeringEvent: event.name,
+					eventPayload: event.payload,
+					occurrences: result.occurrences ?? step.occurrences,
+					masteryCount: result.masteryCount ?? step.masteryCount,
+					availableAt,
+					dueAt
+				};
+			}
+			if (result.occurrences !== void 0 || result.masteryCount !== void 0) changed = true;
+			return {
+				...step,
+				occurrences: result.occurrences ?? step.occurrences,
+				masteryCount: result.masteryCount ?? step.masteryCount,
+				availableAt,
+				dueAt
+			};
+		});
+		if (!changed) continue;
+		const xpEarned = steps.reduce((sum, s) => sum + s.xpEarned, 0) + (track.totalXp ?? 0);
+		let progress = {
+			...current,
+			steps,
+			xpEarned,
+			startedAt,
+			lastActivityAt: eventTime,
+			progress: computeProgressPercent(steps)
+		};
+		if (steps.every((s) => s.status === "COMPLETED")) progress = applyTrackCompletionBonuses(track, progress);
+		map.set(track.id, progress);
+		updated.push(progress);
+	}
+	return updated;
+};
+
+//#endregion
+export { getProgress, listTracks, recordEvent };
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","names":[],"sources":["../src/api.ts"],"sourcesContent":["import { learningJourneyTracks } from './tracks';\nimport type {\n  LearningJourneyTrackSpec,\n  StepAvailabilitySpec,\n  StepCompletionConditionSpec,\n} from '@contractspec/module.learning-journey/track-spec';\nimport type { LearningEvent, StepProgress, TrackProgress } from './api-types';\nimport {\n  getLearnerTracks,\n  getTrackResolver,\n  initProgress,\n} from './progress-store';\n\nconst getTrack = getTrackResolver(learningJourneyTracks);\n\nconst matchesFilter = (\n  filter: Record<string, unknown> | undefined,\n  payload: Record<string, unknown> | undefined\n): boolean => {\n  if (!filter) return true;\n  if (!payload) return false;\n  return Object.entries(filter).every(([key, value]) => payload[key] === value);\n};\n\nconst matchesBaseEvent = (\n  condition: {\n    eventName: string;\n    eventVersion?: number;\n    sourceModule?: string;\n    payloadFilter?: Record<string, unknown>;\n  },\n  event: LearningEvent\n): boolean => {\n  if (condition.eventName !== event.name) return false;\n  if (condition.eventVersion !== undefined && event.version !== undefined) {\n    if (condition.eventVersion !== event.version) return false;\n  }\n  if (\n    condition.sourceModule &&\n    event.sourceModule &&\n    condition.sourceModule !== event.sourceModule\n  ) {\n    return false;\n  }\n  return matchesFilter(\n    condition.payloadFilter,\n    event.payload as Record<string, unknown> | undefined\n  );\n};\n\nconst matchesCondition = (\n  condition: StepCompletionConditionSpec,\n  event: LearningEvent,\n  step: StepProgress,\n  trackStartedAt: Date | undefined\n): {\n  matched: boolean;\n  occurrences?: number;\n  masteryCount?: number;\n} => {\n  if (condition.kind === 'count') {\n    if (!matchesBaseEvent(condition, event)) return { matched: false };\n    const occurrences = (step.occurrences ?? 0) + 1;\n    const within =\n      condition.withinHours === undefined ||\n      Boolean(\n        trackStartedAt &&\n        event.occurredAt &&\n        (event.occurredAt.getTime() - trackStartedAt.getTime()) /\n          (1000 * 60 * 60) <=\n          condition.withinHours\n      );\n    return { matched: within && occurrences >= condition.atLeast, occurrences };\n  }\n\n  if (condition.kind === 'time_window') {\n    if (!matchesBaseEvent(condition, event)) return { matched: false };\n    if (\n      condition.withinHoursOfStart !== undefined &&\n      trackStartedAt &&\n      event.occurredAt\n    ) {\n      const hoursSinceStart =\n        (event.occurredAt.getTime() - trackStartedAt.getTime()) /\n        (1000 * 60 * 60);\n      if (hoursSinceStart > condition.withinHoursOfStart) {\n        return { matched: false };\n      }\n    }\n    return { matched: true };\n  }\n\n  if (condition.kind === 'srs_mastery') {\n    if (event.name !== condition.eventName) return { matched: false };\n    const payload = event.payload as Record<string, unknown> | undefined;\n    if (!matchesFilter(condition.payloadFilter, payload)) {\n      return { matched: false };\n    }\n    const skillKey = condition.skillIdField ?? 'skillId';\n    const masteryKey = condition.masteryField ?? 'mastery';\n    const skillId = payload?.[skillKey];\n    const masteryValue = payload?.[masteryKey];\n    if (skillId === undefined || masteryValue === undefined) {\n      return { matched: false };\n    }\n    if (typeof masteryValue !== 'number') return { matched: false };\n    if (masteryValue < condition.minimumMastery) return { matched: false };\n    const masteryCount = (step.masteryCount ?? 0) + 1;\n    const required = condition.requiredCount ?? 1;\n    return { matched: masteryCount >= required, masteryCount };\n  }\n\n  return { matched: matchesBaseEvent(condition, event) };\n};\n\nconst getAvailability = (\n  availability: StepAvailabilitySpec | undefined,\n  startedAt: Date | undefined\n): { availableAt?: Date; dueAt?: Date } => {\n  if (!availability || !startedAt) return {};\n\n  const baseTime = startedAt.getTime();\n  let unlockTime = baseTime;\n\n  if (availability.unlockOnDay !== undefined) {\n    unlockTime =\n      baseTime + (availability.unlockOnDay - 1) * 24 * 60 * 60 * 1000;\n  }\n\n  if (availability.unlockAfterHours !== undefined) {\n    unlockTime = baseTime + availability.unlockAfterHours * 60 * 60 * 1000;\n  }\n\n  const availableAt = new Date(unlockTime);\n  const dueAt =\n    availability.dueWithinHours !== undefined\n      ? new Date(\n          availableAt.getTime() + availability.dueWithinHours * 60 * 60 * 1000\n        )\n      : undefined;\n\n  return { availableAt, dueAt };\n};\n\nconst computeProgressPercent = (steps: StepProgress[]): number => {\n  const total = steps.length || 1;\n  const done = steps.filter((s) => s.status === 'COMPLETED').length;\n  return Math.round((done / total) * 100);\n};\n\nconst applyTrackCompletionBonuses = (\n  track: LearningJourneyTrackSpec,\n  progress: TrackProgress\n) => {\n  if (progress.isCompleted) return progress;\n\n  const completedAt = new Date();\n  const startedAt = progress.startedAt ?? completedAt;\n  const hoursElapsed =\n    (completedAt.getTime() - startedAt.getTime()) / (1000 * 60 * 60);\n\n  let xpEarned = progress.xpEarned;\n  const { completionRewards, streakRule } = track;\n\n  if (completionRewards?.xpBonus) {\n    xpEarned += completionRewards.xpBonus;\n  }\n\n  if (\n    streakRule?.hoursWindow !== undefined &&\n    hoursElapsed <= streakRule.hoursWindow &&\n    streakRule.bonusXp\n  ) {\n    xpEarned += streakRule.bonusXp;\n  }\n\n  return {\n    ...progress,\n    xpEarned,\n    isCompleted: true,\n    completedAt,\n    lastActivityAt: completedAt,\n  };\n};\n\nexport const listTracks = (learnerId?: string) => {\n  const progressMap = learnerId ? getLearnerTracks(learnerId) : undefined;\n  const progress =\n    learnerId && progressMap\n      ? Array.from(progressMap.values())\n      : ([] as TrackProgress[]);\n\n  return {\n    tracks: learningJourneyTracks,\n    progress,\n  };\n};\n\nexport const getProgress = (trackId: string, learnerId: string) => {\n  const track = getTrack(trackId);\n  if (!track) return undefined;\n\n  const map = getLearnerTracks(learnerId);\n  const existing = map.get(trackId) ?? initProgress(learnerId, track);\n  map.set(trackId, existing);\n  return existing;\n};\n\nexport const recordEvent = (event: LearningEvent) => {\n  const targets =\n    event.trackId !== undefined\n      ? learningJourneyTracks.filter((t) => t.id === event.trackId)\n      : learningJourneyTracks;\n\n  const updated: TrackProgress[] = [];\n  const eventTime = event.occurredAt ?? new Date();\n\n  for (const track of targets) {\n    const map = getLearnerTracks(event.learnerId);\n    const current = map.get(track.id) ?? initProgress(event.learnerId, track);\n    const startedAt = current.startedAt ?? eventTime;\n\n    let changed = current.startedAt === undefined;\n    const steps: StepProgress[] = current.steps.map((step) => {\n      if (step.status === 'COMPLETED') return step;\n\n      const spec = track.steps.find((s) => s.id === step.id);\n      if (!spec) return step;\n\n      const { availableAt, dueAt } = getAvailability(\n        spec.availability,\n        startedAt\n      );\n      if (availableAt && eventTime < availableAt) {\n        return { ...step, availableAt, dueAt };\n      }\n      if (dueAt && eventTime > dueAt) {\n        // keep pending but note deadlines\n        return { ...step, availableAt, dueAt };\n      }\n\n      const result = matchesCondition(spec.completion, event, step, startedAt);\n\n      if (result.matched) {\n        changed = true;\n        return {\n          ...step,\n          status: 'COMPLETED',\n          xpEarned: spec.xpReward ?? 0,\n          completedAt: eventTime,\n          triggeringEvent: event.name,\n          eventPayload: event.payload,\n          occurrences: result.occurrences ?? step.occurrences,\n          masteryCount: result.masteryCount ?? step.masteryCount,\n          availableAt,\n          dueAt,\n        };\n      }\n\n      if (\n        result.occurrences !== undefined ||\n        result.masteryCount !== undefined\n      ) {\n        changed = true;\n      }\n\n      return {\n        ...step,\n        occurrences: result.occurrences ?? step.occurrences,\n        masteryCount: result.masteryCount ?? step.masteryCount,\n        availableAt,\n        dueAt,\n      };\n    });\n\n    if (!changed) {\n      continue;\n    }\n\n    const xpEarned =\n      steps.reduce((sum, s) => sum + s.xpEarned, 0) + (track.totalXp ?? 0);\n    let progress: TrackProgress = {\n      ...current,\n      steps,\n      xpEarned,\n      startedAt,\n      lastActivityAt: eventTime,\n      progress: computeProgressPercent(steps),\n    };\n\n    const allDone = steps.every((s) => s.status === 'COMPLETED');\n    if (allDone) {\n      progress = applyTrackCompletionBonuses(track, progress);\n    }\n\n    map.set(track.id, progress);\n    updated.push(progress);\n  }\n\n  return updated;\n};\n"],"mappings":";;;;AAaA,MAAM,WAAW,iBAAiB,sBAAsB;AAExD,MAAM,iBACJ,QACA,YACY;AACZ,KAAI,CAAC,OAAQ,QAAO;AACpB,KAAI,CAAC,QAAS,QAAO;AACrB,QAAO,OAAO,QAAQ,OAAO,CAAC,OAAO,CAAC,KAAK,WAAW,QAAQ,SAAS,MAAM;;AAG/E,MAAM,oBACJ,WAMA,UACY;AACZ,KAAI,UAAU,cAAc,MAAM,KAAM,QAAO;AAC/C,KAAI,UAAU,iBAAiB,UAAa,MAAM,YAAY,QAC5D;MAAI,UAAU,iBAAiB,MAAM,QAAS,QAAO;;AAEvD,KACE,UAAU,gBACV,MAAM,gBACN,UAAU,iBAAiB,MAAM,aAEjC,QAAO;AAET,QAAO,cACL,UAAU,eACV,MAAM,QACP;;AAGH,MAAM,oBACJ,WACA,OACA,MACA,mBAKG;AACH,KAAI,UAAU,SAAS,SAAS;AAC9B,MAAI,CAAC,iBAAiB,WAAW,MAAM,CAAE,QAAO,EAAE,SAAS,OAAO;EAClE,MAAM,eAAe,KAAK,eAAe,KAAK;AAU9C,SAAO;GAAE,UARP,UAAU,gBAAgB,UAC1B,QACE,kBACA,MAAM,eACL,MAAM,WAAW,SAAS,GAAG,eAAe,SAAS,KACnD,MAAO,KAAK,OACb,UAAU,YACb,KACyB,eAAe,UAAU;GAAS;GAAa;;AAG7E,KAAI,UAAU,SAAS,eAAe;AACpC,MAAI,CAAC,iBAAiB,WAAW,MAAM,CAAE,QAAO,EAAE,SAAS,OAAO;AAClE,MACE,UAAU,uBAAuB,UACjC,kBACA,MAAM,YAKN;QAFG,MAAM,WAAW,SAAS,GAAG,eAAe,SAAS,KACrD,MAAO,KAAK,MACO,UAAU,mBAC9B,QAAO,EAAE,SAAS,OAAO;;AAG7B,SAAO,EAAE,SAAS,MAAM;;AAG1B,KAAI,UAAU,SAAS,eAAe;AACpC,MAAI,MAAM,SAAS,UAAU,UAAW,QAAO,EAAE,SAAS,OAAO;EACjE,MAAM,UAAU,MAAM;AACtB,MAAI,CAAC,cAAc,UAAU,eAAe,QAAQ,CAClD,QAAO,EAAE,SAAS,OAAO;EAE3B,MAAM,WAAW,UAAU,gBAAgB;EAC3C,MAAM,aAAa,UAAU,gBAAgB;EAC7C,MAAM,UAAU,UAAU;EAC1B,MAAM,eAAe,UAAU;AAC/B,MAAI,YAAY,UAAa,iBAAiB,OAC5C,QAAO,EAAE,SAAS,OAAO;AAE3B,MAAI,OAAO,iBAAiB,SAAU,QAAO,EAAE,SAAS,OAAO;AAC/D,MAAI,eAAe,UAAU,eAAgB,QAAO,EAAE,SAAS,OAAO;EACtE,MAAM,gBAAgB,KAAK,gBAAgB,KAAK;AAEhD,SAAO;GAAE,SAAS,iBADD,UAAU,iBAAiB;GACA;GAAc;;AAG5D,QAAO,EAAE,SAAS,iBAAiB,WAAW,MAAM,EAAE;;AAGxD,MAAM,mBACJ,cACA,cACyC;AACzC,KAAI,CAAC,gBAAgB,CAAC,UAAW,QAAO,EAAE;CAE1C,MAAM,WAAW,UAAU,SAAS;CACpC,IAAI,aAAa;AAEjB,KAAI,aAAa,gBAAgB,OAC/B,cACE,YAAY,aAAa,cAAc,KAAK,KAAK,KAAK,KAAK;AAG/D,KAAI,aAAa,qBAAqB,OACpC,cAAa,WAAW,aAAa,mBAAmB,KAAK,KAAK;CAGpE,MAAM,cAAc,IAAI,KAAK,WAAW;AAQxC,QAAO;EAAE;EAAa,OANpB,aAAa,mBAAmB,SAC5B,IAAI,KACF,YAAY,SAAS,GAAG,aAAa,iBAAiB,KAAK,KAAK,IACjE,GACD;EAEuB;;AAG/B,MAAM,0BAA0B,UAAkC;CAChE,MAAM,QAAQ,MAAM,UAAU;CAC9B,MAAM,OAAO,MAAM,QAAQ,MAAM,EAAE,WAAW,YAAY,CAAC;AAC3D,QAAO,KAAK,MAAO,OAAO,QAAS,IAAI;;AAGzC,MAAM,+BACJ,OACA,aACG;AACH,KAAI,SAAS,YAAa,QAAO;CAEjC,MAAM,8BAAc,IAAI,MAAM;CAC9B,MAAM,YAAY,SAAS,aAAa;CACxC,MAAM,gBACH,YAAY,SAAS,GAAG,UAAU,SAAS,KAAK,MAAO,KAAK;CAE/D,IAAI,WAAW,SAAS;CACxB,MAAM,EAAE,mBAAmB,eAAe;AAE1C,KAAI,mBAAmB,QACrB,aAAY,kBAAkB;AAGhC,KACE,YAAY,gBAAgB,UAC5B,gBAAgB,WAAW,eAC3B,WAAW,QAEX,aAAY,WAAW;AAGzB,QAAO;EACL,GAAG;EACH;EACA,aAAa;EACb;EACA,gBAAgB;EACjB;;AAGH,MAAa,cAAc,cAAuB;CAChD,MAAM,cAAc,YAAY,iBAAiB,UAAU,GAAG;AAM9D,QAAO;EACL,QAAQ;EACR,UANA,aAAa,cACT,MAAM,KAAK,YAAY,QAAQ,CAAC,GAC/B,EAAE;EAKR;;AAGH,MAAa,eAAe,SAAiB,cAAsB;CACjE,MAAM,QAAQ,SAAS,QAAQ;AAC/B,KAAI,CAAC,MAAO,QAAO;CAEnB,MAAM,MAAM,iBAAiB,UAAU;CACvC,MAAM,WAAW,IAAI,IAAI,QAAQ,IAAI,aAAa,WAAW,MAAM;AACnE,KAAI,IAAI,SAAS,SAAS;AAC1B,QAAO;;AAGT,MAAa,eAAe,UAAyB;CACnD,MAAM,UACJ,MAAM,YAAY,SACd,sBAAsB,QAAQ,MAAM,EAAE,OAAO,MAAM,QAAQ,GAC3D;CAEN,MAAM,UAA2B,EAAE;CACnC,MAAM,YAAY,MAAM,8BAAc,IAAI,MAAM;AAEhD,MAAK,MAAM,SAAS,SAAS;EAC3B,MAAM,MAAM,iBAAiB,MAAM,UAAU;EAC7C,MAAM,UAAU,IAAI,IAAI,MAAM,GAAG,IAAI,aAAa,MAAM,WAAW,MAAM;EACzE,MAAM,YAAY,QAAQ,aAAa;EAEvC,IAAI,UAAU,QAAQ,cAAc;EACpC,MAAM,QAAwB,QAAQ,MAAM,KAAK,SAAS;AACxD,OAAI,KAAK,WAAW,YAAa,QAAO;GAExC,MAAM,OAAO,MAAM,MAAM,MAAM,MAAM,EAAE,OAAO,KAAK,GAAG;AACtD,OAAI,CAAC,KAAM,QAAO;GAElB,MAAM,EAAE,aAAa,UAAU,gBAC7B,KAAK,cACL,UACD;AACD,OAAI,eAAe,YAAY,YAC7B,QAAO;IAAE,GAAG;IAAM;IAAa;IAAO;AAExC,OAAI,SAAS,YAAY,MAEvB,QAAO;IAAE,GAAG;IAAM;IAAa;IAAO;GAGxC,MAAM,SAAS,iBAAiB,KAAK,YAAY,OAAO,MAAM,UAAU;AAExE,OAAI,OAAO,SAAS;AAClB,cAAU;AACV,WAAO;KACL,GAAG;KACH,QAAQ;KACR,UAAU,KAAK,YAAY;KAC3B,aAAa;KACb,iBAAiB,MAAM;KACvB,cAAc,MAAM;KACpB,aAAa,OAAO,eAAe,KAAK;KACxC,cAAc,OAAO,gBAAgB,KAAK;KAC1C;KACA;KACD;;AAGH,OACE,OAAO,gBAAgB,UACvB,OAAO,iBAAiB,OAExB,WAAU;AAGZ,UAAO;IACL,GAAG;IACH,aAAa,OAAO,eAAe,KAAK;IACxC,cAAc,OAAO,gBAAgB,KAAK;IAC1C;IACA;IACD;IACD;AAEF,MAAI,CAAC,QACH;EAGF,MAAM,WACJ,MAAM,QAAQ,KAAK,MAAM,MAAM,EAAE,UAAU,EAAE,IAAI,MAAM,WAAW;EACpE,IAAI,WAA0B;GAC5B,GAAG;GACH;GACA;GACA;GACA,gBAAgB;GAChB,UAAU,uBAAuB,MAAM;GACxC;AAGD,MADgB,MAAM,OAAO,MAAM,EAAE,WAAW,YAAY,CAE1D,YAAW,4BAA4B,OAAO,SAAS;AAGzD,MAAI,IAAI,MAAM,IAAI,SAAS;AAC3B,UAAQ,KAAK,SAAS;;AAGxB,QAAO"}

package/dist/docs/index.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/docs/index.js

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

package/dist/docs/learning-journey-registry.docblock.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/docs/learning-journey-registry.docblock.js

@@ -0,0 +1,38 @@
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+
+//#region src/docs/learning-journey-registry.docblock.ts
+registerDocBlocks([{
+	id: "docs.learning-journey.registry",
+	title: "Learning Journey — Example Track Registry",
+	summary: "Aggregates learning journey example tracks (Studio onboarding, Platform tour, CRM first win, Drills, Ambient Coach, Quest challenges).",
+	kind: "usage",
+	visibility: "public",
+	route: "/docs/learning-journey/registry",
+	tags: [
+		"learning",
+		"registry",
+		"onboarding"
+	],
+	body: `## Tracks
+- \`studio_getting_started\` (Studio onboarding)
+- \`platform_primitives_tour\` (Platform primitives)
+- \`crm_first_win\` (CRM pipeline onboarding)
+- \`drills_language_basics\` (Drills & SRS)
+- \`money_ambient_coach\`, \`coliving_ambient_coach\` (Ambient tips)
+- \`money_reset_7day\` (Quest/challenge)
+
+## Exports
+- \`learningJourneyTracks\` — raw specs
+- \`onboardingTrackCatalog\` — DTOs aligned with onboarding API
+- \`mapTrackSpecToDto\` — helper to map individual tracks
+
+## Wiring
+- Use with onboarding API contracts:
+  - \`learning.onboarding.listTracks\`
+  - \`learning.onboarding.getProgress\`
+  - \`learning.onboarding.recordEvent\`
+- Intended for registry/adapters in Studio UI or services that surface tracks.`
+}]);
+
+//#endregion
+//# sourceMappingURL=learning-journey-registry.docblock.js.map

package/dist/docs/learning-journey-registry.docblock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"learning-journey-registry.docblock.js","names":[],"sources":["../../src/docs/learning-journey-registry.docblock.ts"],"sourcesContent":["import type { DocBlock } from '@contractspec/lib.contracts/docs';\nimport { registerDocBlocks } from '@contractspec/lib.contracts/docs';\n\nconst registryDocBlocks: DocBlock[] = [\n  {\n    id: 'docs.learning-journey.registry',\n    title: 'Learning Journey — Example Track Registry',\n    summary:\n      'Aggregates learning journey example tracks (Studio onboarding, Platform tour, CRM first win, Drills, Ambient Coach, Quest challenges).',\n    kind: 'usage',\n    visibility: 'public',\n    route: '/docs/learning-journey/registry',\n    tags: ['learning', 'registry', 'onboarding'],\n    body: `## Tracks\n- \\`studio_getting_started\\` (Studio onboarding)\n- \\`platform_primitives_tour\\` (Platform primitives)\n- \\`crm_first_win\\` (CRM pipeline onboarding)\n- \\`drills_language_basics\\` (Drills & SRS)\n- \\`money_ambient_coach\\`, \\`coliving_ambient_coach\\` (Ambient tips)\n- \\`money_reset_7day\\` (Quest/challenge)\n\n## Exports\n- \\`learningJourneyTracks\\` — raw specs\n- \\`onboardingTrackCatalog\\` — DTOs aligned with onboarding API\n- \\`mapTrackSpecToDto\\` — helper to map individual tracks\n\n## Wiring\n- Use with onboarding API contracts:\n  - \\`learning.onboarding.listTracks\\`\n  - \\`learning.onboarding.getProgress\\`\n  - \\`learning.onboarding.recordEvent\\`\n- Intended for registry/adapters in Studio UI or services that surface tracks.`,\n  },\n];\n\nregisterDocBlocks(registryDocBlocks);\n"],"mappings":";;;AAmCA,kBAhCsC,CACpC;CACE,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EAAC;EAAY;EAAY;EAAa;CAC5C,MAAM;;;;;;;;;;;;;;;;;;;CAmBP,CACF,CAEmC"}

package/dist/example.d.ts

@@ -0,0 +1,7 @@
+import * as _contractspec_lib_contracts4 from "@contractspec/lib.contracts";
+
+//#region src/example.d.ts
+declare const example: _contractspec_lib_contracts4.ExampleSpec;
+//#endregion
+export { example as default };
+//# sourceMappingURL=example.d.ts.map

package/dist/example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.d.ts","names":[],"sources":["../src/example.ts"],"sourcesContent":[],"mappings":";;;cAEM,SA0BJ,4BAAA,CA1BW"}

package/dist/example.js

@@ -0,0 +1,42 @@
+import { defineExample } from "@contractspec/lib.contracts";
+
+//#region src/example.ts
+const example = defineExample({
+	meta: {
+		key: "learning-journey-registry",
+		version: "1.0.0",
+		title: "Learning Journey Registry",
+		description: "Registry of learning journey tracks + presentations + UI mini-app bindings.",
+		kind: "library",
+		visibility: "public",
+		stability: "experimental",
+		owners: ["@platform.core"],
+		tags: [
+			"learning",
+			"journey",
+			"registry"
+		]
+	},
+	docs: { rootDocId: "docs.examples.learning-journey-registry" },
+	entrypoints: {
+		packageName: "@contractspec/example.learning-journey-registry",
+		docs: "./docs"
+	},
+	surfaces: {
+		templates: true,
+		sandbox: {
+			enabled: true,
+			modes: ["markdown", "specs"]
+		},
+		studio: {
+			enabled: true,
+			installable: true
+		},
+		mcp: { enabled: true }
+	}
+});
+var example_default = example;
+
+//#endregion
+export { example_default as default };
+//# sourceMappingURL=example.js.map

package/dist/example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.js","names":[],"sources":["../src/example.ts"],"sourcesContent":["import { defineExample } from '@contractspec/lib.contracts';\n\nconst example = defineExample({\n  meta: {\n    key: 'learning-journey-registry',\n    version: '1.0.0',\n    title: 'Learning Journey Registry',\n    description:\n      'Registry of learning journey tracks + presentations + UI mini-app bindings.',\n    kind: 'library',\n    visibility: 'public',\n    stability: 'experimental',\n    owners: ['@platform.core'],\n    tags: ['learning', 'journey', 'registry'],\n  },\n  docs: {\n    rootDocId: 'docs.examples.learning-journey-registry',\n  },\n  entrypoints: {\n    packageName: '@contractspec/example.learning-journey-registry',\n    docs: './docs',\n  },\n  surfaces: {\n    templates: true,\n    sandbox: { enabled: true, modes: ['markdown', 'specs'] },\n    studio: { enabled: true, installable: true },\n    mcp: { enabled: true },\n  },\n});\n\nexport default example;\n"],"mappings":";;;AAEA,MAAM,UAAU,cAAc;CAC5B,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aACE;EACF,MAAM;EACN,YAAY;EACZ,WAAW;EACX,QAAQ,CAAC,iBAAiB;EAC1B,MAAM;GAAC;GAAY;GAAW;GAAW;EAC1C;CACD,MAAM,EACJ,WAAW,2CACZ;CACD,aAAa;EACX,aAAa;EACb,MAAM;EACP;CACD,UAAU;EACR,WAAW;EACX,SAAS;GAAE,SAAS;GAAM,OAAO,CAAC,YAAY,QAAQ;GAAE;EACxD,QAAQ;GAAE,SAAS;GAAM,aAAa;GAAM;EAC5C,KAAK,EAAE,SAAS,MAAM;EACvB;CACF,CAAC;AAEF,sBAAe"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+import { getProgress, listTracks, recordEvent } from "./api.js";
+import example from "./example.js";
+import { OnboardingStepDto, OnboardingTrackDto, crmLearningTracks, learningJourneyTracks, mapStep, mapTrackSpecToDto, onboardingTrackCatalog, platformLearningTracks, studioLearningTracks } from "./tracks.js";
+import { LearningTrackDetailPresentation, LearningTrackListPresentation, LearningTrackProgressWidgetPresentation, learningJourneyPresentations } from "./presentations/index.js";
+import { LearningJourneyRegistryFeature } from "./learning-journey-registry.feature.js";
+import { LearningMiniApp, getLearningTemplateIds, isLearningTemplate } from "./ui/LearningMiniApp.js";
+import "./ui/index.js";
+export { LearningJourneyRegistryFeature, LearningMiniApp, LearningTrackDetailPresentation, LearningTrackListPresentation, LearningTrackProgressWidgetPresentation, OnboardingStepDto, OnboardingTrackDto, crmLearningTracks, example, getLearningTemplateIds, getProgress, isLearningTemplate, learningJourneyPresentations, learningJourneyTracks, listTracks, mapStep, mapTrackSpecToDto, onboardingTrackCatalog, platformLearningTracks, recordEvent, studioLearningTracks };

package/dist/index.js

@@ -0,0 +1,10 @@
+import { crmLearningTracks, learningJourneyTracks, mapStep, mapTrackSpecToDto, onboardingTrackCatalog, platformLearningTracks, studioLearningTracks } from "./tracks.js";
+import { getProgress, listTracks, recordEvent } from "./api.js";
+import example_default from "./example.js";
+import "./docs/index.js";
+import { LearningTrackDetailPresentation, LearningTrackListPresentation, LearningTrackProgressWidgetPresentation, learningJourneyPresentations } from "./presentations/index.js";
+import { LearningJourneyRegistryFeature } from "./learning-journey-registry.feature.js";
+import { LearningMiniApp, getLearningTemplateIds, isLearningTemplate } from "./ui/LearningMiniApp.js";
+import "./ui/index.js";
+
+export { LearningJourneyRegistryFeature, LearningMiniApp, LearningTrackDetailPresentation, LearningTrackListPresentation, LearningTrackProgressWidgetPresentation, crmLearningTracks, example_default as example, getLearningTemplateIds, getProgress, isLearningTemplate, learningJourneyPresentations, learningJourneyTracks, listTracks, mapStep, mapTrackSpecToDto, onboardingTrackCatalog, platformLearningTracks, recordEvent, studioLearningTracks };

package/dist/learning-journey-registry.feature.d.ts

@@ -0,0 +1,12 @@
+import * as _contractspec_lib_contracts0 from "@contractspec/lib.contracts";
+
+//#region src/learning-journey-registry.feature.d.ts
+
+/**
+ * Learning Journey Registry feature module that bundles
+ * the shared presentations for learning journey tracks.
+ */
+declare const LearningJourneyRegistryFeature: _contractspec_lib_contracts0.FeatureModuleSpec;
+//#endregion
+export { LearningJourneyRegistryFeature };
+//# sourceMappingURL=learning-journey-registry.feature.d.ts.map

package/dist/learning-journey-registry.feature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"learning-journey-registry.feature.d.ts","names":[],"sources":["../src/learning-journey-registry.feature.ts"],"sourcesContent":[],"mappings":";;;;;;;AAWA;cAAa,gCAoDX,4BAAA,CApDyC"}

package/dist/learning-journey-registry.feature.js

@@ -0,0 +1,75 @@
+import { defineFeature } from "@contractspec/lib.contracts";
+
+//#region src/learning-journey-registry.feature.ts
+/**
+* Learning Journey Registry Feature Module Specification
+*
+* Defines the feature module for the learning journey registry.
+*/
+/**
+* Learning Journey Registry feature module that bundles
+* the shared presentations for learning journey tracks.
+*/
+const LearningJourneyRegistryFeature = defineFeature({
+	meta: {
+		key: "learning-journey-registry",
+		version: "1.0.0",
+		title: "Learning Journey Registry",
+		description: "Shared registry and presentations for learning journey tracks",
+		domain: "learning-journey",
+		owners: ["@learning-team"],
+		tags: [
+			"learning",
+			"journey",
+			"onboarding",
+			"registry"
+		],
+		stability: "experimental"
+	},
+	operations: [],
+	events: [],
+	presentations: [
+		{
+			key: "learning.journey.track_list",
+			version: "1.0.0"
+		},
+		{
+			key: "learning.journey.track_detail",
+			version: "1.0.0"
+		},
+		{
+			key: "learning.journey.progress_widget",
+			version: "1.0.0"
+		}
+	],
+	opToPresentation: [],
+	presentationsTargets: [
+		{
+			key: "learning.journey.track_list",
+			version: "1.0.0",
+			targets: ["react", "markdown"]
+		},
+		{
+			key: "learning.journey.track_detail",
+			version: "1.0.0",
+			targets: [
+				"react",
+				"markdown",
+				"application/json"
+			]
+		},
+		{
+			key: "learning.journey.progress_widget",
+			version: "1.0.0",
+			targets: ["react"]
+		}
+	],
+	capabilities: { requires: [{
+		key: "identity",
+		version: "1.0.0"
+	}] }
+});
+
+//#endregion
+export { LearningJourneyRegistryFeature };
+//# sourceMappingURL=learning-journey-registry.feature.js.map

package/dist/learning-journey-registry.feature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"learning-journey-registry.feature.js","names":[],"sources":["../src/learning-journey-registry.feature.ts"],"sourcesContent":["/**\n * Learning Journey Registry Feature Module Specification\n *\n * Defines the feature module for the learning journey registry.\n */\nimport { defineFeature } from '@contractspec/lib.contracts';\n\n/**\n * Learning Journey Registry feature module that bundles\n * the shared presentations for learning journey tracks.\n */\nexport const LearningJourneyRegistryFeature = defineFeature({\n  meta: {\n    key: 'learning-journey-registry',\n    version: '1.0.0',\n    title: 'Learning Journey Registry',\n    description:\n      'Shared registry and presentations for learning journey tracks',\n    domain: 'learning-journey',\n    owners: ['@learning-team'],\n    tags: ['learning', 'journey', 'onboarding', 'registry'],\n    stability: 'experimental',\n  },\n\n  // No operations in the registry - it's presentation-only\n  operations: [],\n\n  // Events emitted by this feature\n  events: [],\n\n  // Presentations associated with this feature\n  presentations: [\n    { key: 'learning.journey.track_list', version: '1.0.0' },\n    { key: 'learning.journey.track_detail', version: '1.0.0' },\n    { key: 'learning.journey.progress_widget', version: '1.0.0' },\n  ],\n\n  // No op to presentation links for registry\n  opToPresentation: [],\n\n  // Target requirements for multi-surface rendering\n  presentationsTargets: [\n    {\n      key: 'learning.journey.track_list',\n      version: '1.0.0',\n      targets: ['react', 'markdown'],\n    },\n    {\n      key: 'learning.journey.track_detail',\n      version: '1.0.0',\n      targets: ['react', 'markdown', 'application/json'],\n    },\n    {\n      key: 'learning.journey.progress_widget',\n      version: '1.0.0',\n      targets: ['react'],\n    },\n  ],\n\n  // Capability requirements\n  capabilities: {\n    requires: [{ key: 'identity', version: '1.0.0' }],\n  },\n});\n"],"mappings":";;;;;;;;;;;;AAWA,MAAa,iCAAiC,cAAc;CAC1D,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aACE;EACF,QAAQ;EACR,QAAQ,CAAC,iBAAiB;EAC1B,MAAM;GAAC;GAAY;GAAW;GAAc;GAAW;EACvD,WAAW;EACZ;CAGD,YAAY,EAAE;CAGd,QAAQ,EAAE;CAGV,eAAe;EACb;GAAE,KAAK;GAA+B,SAAS;GAAS;EACxD;GAAE,KAAK;GAAiC,SAAS;GAAS;EAC1D;GAAE,KAAK;GAAoC,SAAS;GAAS;EAC9D;CAGD,kBAAkB,EAAE;CAGpB,sBAAsB;EACpB;GACE,KAAK;GACL,SAAS;GACT,SAAS,CAAC,SAAS,WAAW;GAC/B;EACD;GACE,KAAK;GACL,SAAS;GACT,SAAS;IAAC;IAAS;IAAY;IAAmB;GACnD;EACD;GACE,KAAK;GACL,SAAS;GACT,SAAS,CAAC,QAAQ;GACnB;EACF;CAGD,cAAc,EACZ,UAAU,CAAC;EAAE,KAAK;EAAY,SAAS;EAAS,CAAC,EAClD;CACF,CAAC"}

package/dist/presentations/index.d.ts

@@ -0,0 +1,10 @@
+import * as _contractspec_lib_contracts0 from "@contractspec/lib.contracts";
+
+//#region src/presentations/index.d.ts
+declare const LearningTrackListPresentation: _contractspec_lib_contracts0.PresentationSpec;
+declare const LearningTrackDetailPresentation: _contractspec_lib_contracts0.PresentationSpec;
+declare const LearningTrackProgressWidgetPresentation: _contractspec_lib_contracts0.PresentationSpec;
+declare const learningJourneyPresentations: _contractspec_lib_contracts0.PresentationSpec[];
+//#endregion
+export { LearningTrackDetailPresentation, LearningTrackListPresentation, LearningTrackProgressWidgetPresentation, learningJourneyPresentations };
+//# sourceMappingURL=index.d.ts.map

package/dist/presentations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/presentations/index.ts"],"sourcesContent":[],"mappings":";;;cAea,+BAaX,4BAAA,CAbwC;cAe7B,iCAaX,4BAAA,CAb0C;cAe/B,yCAaX,4BAAA,CAbkD;AA9BvC,cA6CA,4BAhCX,EAoCD,4BAAA,CAJwC,gBAAA,EAhCvC"}

package/dist/presentations/index.js

@@ -0,0 +1,71 @@
+import { StabilityEnum, definePresentation } from "@contractspec/lib.contracts";
+
+//#region src/presentations/index.ts
+const baseMeta = {
+	domain: "learning-journey",
+	title: "Learning Journey",
+	owners: ["@learning-team"],
+	tags: [
+		"learning",
+		"journey",
+		"onboarding"
+	],
+	stability: StabilityEnum.Experimental,
+	goal: "Progress through learning tracks",
+	context: "Learning journey section"
+};
+const LearningTrackListPresentation = definePresentation({
+	meta: {
+		key: "learning.journey.track_list",
+		version: "1.0.0",
+		description: "List of learning journeys available to the learner.",
+		...baseMeta
+	},
+	source: {
+		type: "component",
+		framework: "react",
+		componentKey: "LearningTrackList"
+	},
+	targets: ["react", "markdown"]
+});
+const LearningTrackDetailPresentation = definePresentation({
+	meta: {
+		key: "learning.journey.track_detail",
+		version: "1.0.0",
+		description: "Track detail with steps and progress state.",
+		...baseMeta
+	},
+	source: {
+		type: "component",
+		framework: "react",
+		componentKey: "LearningTrackDetail"
+	},
+	targets: [
+		"react",
+		"markdown",
+		"application/json"
+	]
+});
+const LearningTrackProgressWidgetPresentation = definePresentation({
+	meta: {
+		key: "learning.journey.progress_widget",
+		version: "1.0.0",
+		description: "Compact widget showing progress for active track.",
+		...baseMeta
+	},
+	source: {
+		type: "component",
+		framework: "react",
+		componentKey: "LearningTrackProgressWidget"
+	},
+	targets: ["react"]
+});
+const learningJourneyPresentations = [
+	LearningTrackListPresentation,
+	LearningTrackDetailPresentation,
+	LearningTrackProgressWidgetPresentation
+];
+
+//#endregion
+export { LearningTrackDetailPresentation, LearningTrackListPresentation, LearningTrackProgressWidgetPresentation, learningJourneyPresentations };
+//# sourceMappingURL=index.js.map

package/dist/presentations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/presentations/index.ts"],"sourcesContent":["import { definePresentation, StabilityEnum, type PresentationSpecMeta } from '@contractspec/lib.contracts';\n\nconst baseMeta: Pick<\n  PresentationSpecMeta,\n  'domain' | 'owners' | 'tags' | 'title' | 'stability' | 'goal' | 'context'\n> = {\n  domain: 'learning-journey',\n  title: 'Learning Journey',\n  owners: ['@learning-team'] as string[],\n  tags: ['learning', 'journey', 'onboarding'] as string[],\n  stability: StabilityEnum.Experimental,\n  goal: 'Progress through learning tracks',\n  context: 'Learning journey section',\n};\n\nexport const LearningTrackListPresentation = definePresentation({\n  meta: {\n    key: 'learning.journey.track_list',\n    version: '1.0.0',\n    description: 'List of learning journeys available to the learner.',\n    ...baseMeta,\n  },\n  source: {\n    type: 'component',\n    framework: 'react',\n    componentKey: 'LearningTrackList',\n  },\n  targets: ['react', 'markdown'],\n});\n\nexport const LearningTrackDetailPresentation = definePresentation({\n  meta: {\n    key: 'learning.journey.track_detail',\n    version: '1.0.0',\n    description: 'Track detail with steps and progress state.',\n    ...baseMeta,\n  },\n  source: {\n    type: 'component',\n    framework: 'react',\n    componentKey: 'LearningTrackDetail',\n  },\n  targets: ['react', 'markdown', 'application/json'],\n});\n\nexport const LearningTrackProgressWidgetPresentation = definePresentation({\n  meta: {\n    key: 'learning.journey.progress_widget',\n    version: '1.0.0',\n    description: 'Compact widget showing progress for active track.',\n    ...baseMeta,\n  },\n  source: {\n    type: 'component',\n    framework: 'react',\n    componentKey: 'LearningTrackProgressWidget',\n  },\n  targets: ['react'],\n});\n\nexport const learningJourneyPresentations = [\n  LearningTrackListPresentation,\n  LearningTrackDetailPresentation,\n  LearningTrackProgressWidgetPresentation,\n];\n"],"mappings":";;;AAEA,MAAM,WAGF;CACF,QAAQ;CACR,OAAO;CACP,QAAQ,CAAC,iBAAiB;CAC1B,MAAM;EAAC;EAAY;EAAW;EAAa;CAC3C,WAAW,cAAc;CACzB,MAAM;CACN,SAAS;CACV;AAED,MAAa,gCAAgC,mBAAmB;CAC9D,MAAM;EACJ,KAAK;EACL,SAAS;EACT,aAAa;EACb,GAAG;EACJ;CACD,QAAQ;EACN,MAAM;EACN,WAAW;EACX,cAAc;EACf;CACD,SAAS,CAAC,SAAS,WAAW;CAC/B,CAAC;AAEF,MAAa,kCAAkC,mBAAmB;CAChE,MAAM;EACJ,KAAK;EACL,SAAS;EACT,aAAa;EACb,GAAG;EACJ;CACD,QAAQ;EACN,MAAM;EACN,WAAW;EACX,cAAc;EACf;CACD,SAAS;EAAC;EAAS;EAAY;EAAmB;CACnD,CAAC;AAEF,MAAa,0CAA0C,mBAAmB;CACxE,MAAM;EACJ,KAAK;EACL,SAAS;EACT,aAAa;EACb,GAAG;EACJ;CACD,QAAQ;EACN,MAAM;EACN,WAAW;EACX,cAAc;EACf;CACD,SAAS,CAAC,QAAQ;CACnB,CAAC;AAEF,MAAa,+BAA+B;CAC1C;CACA;CACA;CACD"}

package/dist/progress-store.d.ts

@@ -0,0 +1,11 @@
+import { TrackProgress } from "./api-types.js";
+import { LearningJourneyTrackSpec } from "@contractspec/module.learning-journey/track-spec";
+
+//#region src/progress-store.d.ts
+declare const progressStore: Map<string, Map<string, TrackProgress>>;
+declare const getTrackResolver: (tracks: LearningJourneyTrackSpec[]) => (trackId: string) => LearningJourneyTrackSpec | undefined;
+declare const getLearnerTracks: (learnerId: string) => Map<string, TrackProgress>;
+declare const initProgress: (learnerId: string, track: LearningJourneyTrackSpec) => TrackProgress;
+//#endregion
+export { getLearnerTracks, getTrackResolver, initProgress, progressStore };
+//# sourceMappingURL=progress-store.d.ts.map

package/dist/progress-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-store.d.ts","names":[],"sources":["../src/progress-store.ts"],"sourcesContent":[],"mappings":";;;;cAIa,eAAa,YAAA,YAAA;cAEb,2BACF,oDACU;AAJR,cAOA,gBAP6D,EAAA,CAAA,SAAA,EAAA,MAAA,EAAA,GAOxB,GAPwB,CAAA,MAAA,EAOxB,aAPwB,CAAA;AAAhD,cAeb,YAfa,EAAA,CAAA,SAAA,EAAA,MAAA,EAAA,KAAA,EAiBjB,wBAjBiB,EAAA,GAkBvB,aAlBuB"}

package/dist/progress-store.js

@@ -0,0 +1,31 @@
+//#region src/progress-store.ts
+const progressStore = /* @__PURE__ */ new Map();
+const getTrackResolver = (tracks) => (trackId) => tracks.find((t) => t.id === trackId);
+const getLearnerTracks = (learnerId) => {
+	const existing = progressStore.get(learnerId);
+	if (existing) return existing;
+	const map = /* @__PURE__ */ new Map();
+	progressStore.set(learnerId, map);
+	return map;
+};
+const initProgress = (learnerId, track) => ({
+	learnerId,
+	trackId: track.id,
+	progress: 0,
+	isCompleted: false,
+	xpEarned: 0,
+	steps: track.steps.map((step) => ({
+		id: step.id,
+		status: "PENDING",
+		xpEarned: 0,
+		occurrences: 0,
+		masteryCount: 0
+	})),
+	startedAt: void 0,
+	completedAt: void 0,
+	lastActivityAt: void 0
+});
+
+//#endregion
+export { getLearnerTracks, getTrackResolver, initProgress, progressStore };
+//# sourceMappingURL=progress-store.js.map