@plasius/learning 0.3.0 → 0.5.0

package/README.md

@@ -44,6 +44,38 @@ export remain available unchanged.
 
 ## Complete course and account-save contracts
 
+Complete learner curricula are separate lazy entry points. Import
+`{ course, practice }` from `@plasius/learning/courses/robot-maze-dash` for the
+Robot Maze `2.0.0` course: six distinct missions, 54 guided activities, a bounded
+visual starter project, function references, formative concept checks, debugging
+guidance and extensions. Formative answers are learner-safe teaching material;
+they are not protected runtime assessments or completion authority. Hosts verify
+responses, run protected checks and persist evidence independently.
+The root exports `CoursePracticeQuestion` as a type without importing lesson data.
+
+The same lazy course boundary also provides `courses/skywing-sprint`,
+`courses/meteor-shield` and `courses/pixel-trail-challenge`. Each has six authored
+missions and 54 activities, 18 formative questions, a real editable `game.js`
+starter and explicit state/input references. Their respective sequences teach
+flight and input timing; vector defence, timed shields and resource accounting;
+and ordered grid movement, bounded placement and moving-tail collisions. Hosts
+must implement and verify each documented game contract before exposing its
+course; lesson publication alone is not evidence of a working playable module.
+
+`courses/rescue-crew-commander` adds shared-job ownership, bounded breadth-first
+routes, deterministic dispatch, round-trip energy, delivery conservation and
+recoverable route changes. `courses/star-defender-squadron` adds input/formation
+control, single-hit projectiles, damage grace periods, timed shields and complete
+wave outcomes. Both follow the same six-mission/54-activity contract with authored
+questions, starter projects and references, and require their own host validation.
+
+The runtime is supplied separately by `@plasius/learning-runtime`; this package
+does not execute the project or declare host readiness. The seventeen-course
+programme remains in development. This additive content does not alter immutable
+catalogue/pricing records or enable a public host rollout. New hosts compose
+their existing access controls with an independently disabled complete-course
+flag and must validate the full learner journey before enabling it.
+
 `LearningCourseV1` defines six missions with nine activities each, editable project
 files, learner guidance and a capstone assessment identifier. Use
 `validateLearningCourse` or `parseLearningCourse` for publication and loading.

package/dist/chunk-2UIOBMJZ.js

@@ -0,0 +1,44 @@
+import {
+  LEARNING_COURSE_STAGE_ORDER,
+  parseLearningCourse
+} from "./chunk-OXWMIHYI.js";
+
+// src/courses/course-authoring.ts
+function authorCourse(header, missions) {
+  const course = parseLearningCourse({
+    ...header,
+    schemaVersion: "1",
+    moduleVersion: "2.0.0",
+    moduleId: `junior-coder.${header.slug}`,
+    runtimeId: `${header.slug}.v2`,
+    estimatedMinutes: missions.length * 60,
+    completionAssessmentId: `${header.slug}.final`,
+    completionBadge: { id: `${header.slug}.completed`, title: `${header.title} creator` },
+    missions: missions.map((mission, index) => ({
+      id: `${header.slug}.m${index + 1}`,
+      title: mission.title,
+      concepts: mission.concepts,
+      goals: mission.goals,
+      estimatedMinutes: 60,
+      assessmentId: `${header.slug}.m${index + 1}.assessment`,
+      extension: mission.extension,
+      stages: LEARNING_COURSE_STAGE_ORDER.map((kind) => ({
+        id: `${header.slug}.m${index + 1}.${kind}`,
+        kind,
+        title: `${kind.charAt(0).toUpperCase()}${kind.slice(1)}: ${mission.title}`,
+        instruction: mission.activities[kind][0],
+        help: mission.activities[kind][1]
+      }))
+    }))
+  });
+  const practice = structuredClone(missions.flatMap((mission, index) => ["learn", "predict", "explain"].map((kind) => ({ ...mission.questions[kind], stageId: `${header.slug}.m${index + 1}.${kind}` }))));
+  for (const question of practice) {
+    if (question.question.trim().length < 20 || question.feedback.trim().length < 40 || question.choices.length !== 3 || question.choices.some((choice) => choice.trim().length < 2) || new Set(question.choices).size !== 3 || !Number.isInteger(question.correctChoice) || question.correctChoice < 0 || question.correctChoice > 2) throw new Error("Invalid course practice question.");
+  }
+  return { course, practice };
+}
+
+export {
+  authorCourse
+};
+//# sourceMappingURL=chunk-2UIOBMJZ.js.map

package/dist/chunk-2UIOBMJZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/courses/course-authoring.ts"],"sourcesContent":["import { LEARNING_COURSE_STAGE_ORDER, parseLearningCourse, type LearningCourseV1 } from \"../course-contracts.js\";\nimport type { MissionStageKindV1 } from \"../contracts.js\";\n\n/** Formative checks are learner-visible teaching material, not protected assessments. */\nexport interface CoursePracticeQuestion {\n  stageId: string;\n  question: string;\n  choices: [string, string, string];\n  correctChoice: 0 | 1 | 2;\n  feedback: string;\n}\nexport type PracticeDraft = Omit<CoursePracticeQuestion, \"stageId\">;\nexport interface CourseMissionDraft {\n  title: string;\n  concepts: string[];\n  goals: string[];\n  extension: string;\n  activities: Record<MissionStageKindV1, [instruction: string, help: string]>;\n  questions: Record<\"learn\" | \"predict\" | \"explain\", PracticeDraft>;\n}\ntype CourseHeader = Omit<LearningCourseV1, \"schemaVersion\" | \"moduleVersion\" | \"moduleId\" | \"runtimeId\" | \"estimatedMinutes\" | \"completionAssessmentId\" | \"completionBadge\" | \"missions\">;\n\n/** Only identifiers and activity framing are shared; each lesson is independently authored. */\nexport function authorCourse(header: CourseHeader, missions: CourseMissionDraft[]): { course: LearningCourseV1; practice: CoursePracticeQuestion[] } {\n  const course = parseLearningCourse({ ...header, schemaVersion: \"1\", moduleVersion: \"2.0.0\", moduleId: `junior-coder.${header.slug}`,\n    runtimeId: `${header.slug}.v2`, estimatedMinutes: missions.length * 60,\n    completionAssessmentId: `${header.slug}.final`, completionBadge: { id: `${header.slug}.completed`, title: `${header.title} creator` },\n    missions: missions.map((mission, index) => ({\n      id: `${header.slug}.m${index + 1}`, title: mission.title, concepts: mission.concepts, goals: mission.goals,\n      estimatedMinutes: 60, assessmentId: `${header.slug}.m${index + 1}.assessment`, extension: mission.extension,\n      stages: LEARNING_COURSE_STAGE_ORDER.map(kind => ({ id: `${header.slug}.m${index + 1}.${kind}`, kind,\n        title: `${kind.charAt(0).toUpperCase()}${kind.slice(1)}: ${mission.title}`,\n        instruction: mission.activities[kind][0], help: mission.activities[kind][1] })),\n    })),\n  });\n  const practice = structuredClone(missions.flatMap((mission, index) => ([\"learn\", \"predict\", \"explain\"] as const)\n    .map(kind => ({ ...mission.questions[kind], stageId: `${header.slug}.m${index + 1}.${kind}` }))));\n  for (const question of practice) {\n    if (question.question.trim().length < 20 || question.feedback.trim().length < 40\n      || question.choices.length !== 3 || question.choices.some(choice => choice.trim().length < 2) || new Set(question.choices).size !== 3\n      || !Number.isInteger(question.correctChoice) || question.correctChoice < 0 || question.correctChoice > 2) throw new Error(\"Invalid course practice question.\");\n  }\n  return { course, practice };\n}\n"],"mappings":";;;;;;AAuBO,SAAS,aAAa,QAAsB,UAAkG;AACnJ,QAAM,SAAS,oBAAoB;AAAA,IAAE,GAAG;AAAA,IAAQ,eAAe;AAAA,IAAK,eAAe;AAAA,IAAS,UAAU,gBAAgB,OAAO,IAAI;AAAA,IAC/H,WAAW,GAAG,OAAO,IAAI;AAAA,IAAO,kBAAkB,SAAS,SAAS;AAAA,IACpE,wBAAwB,GAAG,OAAO,IAAI;AAAA,IAAU,iBAAiB,EAAE,IAAI,GAAG,OAAO,IAAI,cAAc,OAAO,GAAG,OAAO,KAAK,WAAW;AAAA,IACpI,UAAU,SAAS,IAAI,CAAC,SAAS,WAAW;AAAA,MAC1C,IAAI,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC;AAAA,MAAI,OAAO,QAAQ;AAAA,MAAO,UAAU,QAAQ;AAAA,MAAU,OAAO,QAAQ;AAAA,MACrG,kBAAkB;AAAA,MAAI,cAAc,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC;AAAA,MAAe,WAAW,QAAQ;AAAA,MAClG,QAAQ,4BAA4B,IAAI,WAAS;AAAA,QAAE,IAAI,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,IAAI,IAAI;AAAA,QAAI;AAAA,QAC7F,OAAO,GAAG,KAAK,OAAO,CAAC,EAAE,YAAY,CAAC,GAAG,KAAK,MAAM,CAAC,CAAC,KAAK,QAAQ,KAAK;AAAA,QACxE,aAAa,QAAQ,WAAW,IAAI,EAAE,CAAC;AAAA,QAAG,MAAM,QAAQ,WAAW,IAAI,EAAE,CAAC;AAAA,MAAE,EAAE;AAAA,IAClF,EAAE;AAAA,EACJ,CAAC;AACD,QAAM,WAAW,gBAAgB,SAAS,QAAQ,CAAC,SAAS,UAAW,CAAC,SAAS,WAAW,SAAS,EAClG,IAAI,WAAS,EAAE,GAAG,QAAQ,UAAU,IAAI,GAAG,SAAS,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC,CAAC;AAClG,aAAW,YAAY,UAAU;AAC/B,QAAI,SAAS,SAAS,KAAK,EAAE,SAAS,MAAM,SAAS,SAAS,KAAK,EAAE,SAAS,MACzE,SAAS,QAAQ,WAAW,KAAK,SAAS,QAAQ,KAAK,YAAU,OAAO,KAAK,EAAE,SAAS,CAAC,KAAK,IAAI,IAAI,SAAS,OAAO,EAAE,SAAS,KACjI,CAAC,OAAO,UAAU,SAAS,aAAa,KAAK,SAAS,gBAAgB,KAAK,SAAS,gBAAgB,EAAG,OAAM,IAAI,MAAM,mCAAmC;AAAA,EACjK;AACA,SAAO,EAAE,QAAQ,SAAS;AAC5B;","names":[]}