@plasius/learning 0.2.21 → 0.2.23

package/README.md

@@ -7,22 +7,41 @@ The package does **not** provide HTTP handlers, persistence, authentication, Tok
 ## Junior Coder catalog
 
 The initial immutable catalog is exported as
-`JUNIOR_CODER_ROBOT_RESCUE_PATH_V1`. The current uniformly priced pilot
-catalog is exported as `JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1`, with
-`JUNIOR_CODER_ROBOT_RESCUE_PATH_CURRENT` available to adapters that
-intentionally follow published successors. Each contains 19 independently
-sellable, self-contained project modules:
+`JUNIOR_CODER_ROBOT_RESCUE_PATH_V1`, and its uniformly priced successor remains
+available as `JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1`. Path `1.2.0` upgrades Road
+Hopper Rally, path `1.3.0` adds Paddle Pulse `2.0.0`, and path `1.4.0` is
+exported as `JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_4` and selected by
+`JUNIOR_CODER_ROBOT_RESCUE_PATH_CURRENT`. It advances Road Hopper Rally to the
+evidence-led module `2.1.0`; the other eighteen module records retain their
+prior immutable versions. Each path
+contains 19 independently sellable, self-contained project modules:
 
 - 8 original arcade game modules;
 - 5 simulator-backed robotics modules;
 - 3 constrained Vibe Coding modules;
 - 3 web application modules.
 
-Both catalogs remain in `pilot-grant-only` commercial state. The immutable
-`1.1.0` modules each cost 50 Tokens (50,000 subunits), carrying a
+All catalogs remain in `pilot-grant-only` commercial state. The immutable
+`1.1.0` modules, Road Hopper Rally `2.1.0` and Paddle Pulse `2.0.0` each cost 50 Tokens (50,000 subunits), carrying a
 non-redeemable £5 reference value. Price metadata is not authorization to
 enable public checkout.
 
+Road Hopper Rally `2.1.0` is a 450-minute, six-mission catalog record whose
+54 evidence-led activities, starter project, deterministic runtime, original
+assets and assessment definitions live in
+`@plasius/learning-road-hopper-rally@1.1.0`. The catalog pins the exact
+`ROAD_HOPPER_RALLY_COURSE_V3` export, schema `3` and its canonical SHA-256 digest
+through `ExternalLearningContentReferenceV1`; it does not import or bundle the
+executable content package. Road Hopper `2.0.0` and its package `1.0.0`
+reference remain available unchanged for rollback and existing consumers.
+
+Paddle Pulse `2.0.0` is a 360-minute, six-mission catalog record whose 54-stage
+course, declarative program contracts, deterministic 60 Hz engine and protected
+assessment live in `@plasius/learning-paddle-pulse@0.1.0`. The catalog pins the
+exact `PADDLE_PULSE_MODULE_V2` export, schema `2` and canonical SHA-256 digest
+without importing the package. Paddle Pulse `1.1.0` and its mission-authoring
+export remain available unchanged.
+
 ## Install
 
 ```bash
@@ -40,6 +59,20 @@ import {
 assertValidLearningPath(JUNIOR_CODER_ROBOT_RESCUE_PATH_CURRENT);
 ```
 
+Consumers resolving external course content must verify all five reference
+fields before use:
+
+```ts
+import {
+  ROAD_HOPPER_RALLY_EXTERNAL_CONTENT_V2,
+  isExternalLearningContentReferenceV1,
+} from "@plasius/learning";
+
+if (!isExternalLearningContentReferenceV1(ROAD_HOPPER_RALLY_EXTERNAL_CONTENT_V2)) {
+  throw new Error("Invalid external learning content reference");
+}
+```
+
 ## Calculate an assessment
 
 ```ts
@@ -303,6 +336,8 @@ assertValidMissionAuthoringBundle(
 ## Contract rules
 
 - Published IDs and versions are immutable.
+- External course content uses exact package and export names, a stable semantic
+  version and a lower-case canonical SHA-256 digest; version ranges are invalid.
 - Reference prices are product-copy metadata and never create cash redemption
   rights.
 - A module entitlement must bind to an exact module version.

package/dist/index.cjs

@@ -28,18 +28,28 @@ __export(index_exports, {
   CONTEXTUAL_VOICE_SUGGESTED_ACTIONS_V1: () => CONTEXTUAL_VOICE_SUGGESTED_ACTIONS_V1,
   CREATURE_CARE_DASHBOARD_MISSION_ONE_AUTHORING_V1: () => CREATURE_CARE_DASHBOARD_MISSION_ONE_AUTHORING_V1,
   DANCE_ROVER_MISSION_ONE_AUTHORING_V1: () => DANCE_ROVER_MISSION_ONE_AUTHORING_V1,
+  EXTERNAL_LEARNING_CONTENT_REFERENCE_VERSION_V1: () => EXTERNAL_LEARNING_CONTENT_REFERENCE_VERSION_V1,
   JUNIOR_CODER_MISSION_STAGE_ORDER_V1: () => JUNIOR_CODER_MISSION_STAGE_ORDER_V1,
   JUNIOR_CODER_MODULE_PRICE_V1_1: () => JUNIOR_CODER_MODULE_PRICE_V1_1,
+  JUNIOR_CODER_PADDLE_PULSE_V2: () => JUNIOR_CODER_PADDLE_PULSE_V2,
+  JUNIOR_CODER_ROAD_HOPPER_RALLY_V2: () => JUNIOR_CODER_ROAD_HOPPER_RALLY_V2,
+  JUNIOR_CODER_ROAD_HOPPER_RALLY_V2_1: () => JUNIOR_CODER_ROAD_HOPPER_RALLY_V2_1,
   JUNIOR_CODER_ROBOT_RESCUE_PATH_CURRENT: () => JUNIOR_CODER_ROBOT_RESCUE_PATH_CURRENT,
   JUNIOR_CODER_ROBOT_RESCUE_PATH_V1: () => JUNIOR_CODER_ROBOT_RESCUE_PATH_V1,
   JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1: () => JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1,
+  JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_2: () => JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_2,
+  JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_3: () => JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_3,
+  JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_4: () => JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_4,
   METEOR_SHIELD_MISSION_ONE_AUTHORING_V1: () => METEOR_SHIELD_MISSION_ONE_AUTHORING_V1,
   MISSION_AUTHORING_CONTRACT_VERSION_V1: () => MISSION_AUTHORING_CONTRACT_VERSION_V1,
   OBSTACLE_EXPLORER_MISSION_ONE_AUTHORING_V1: () => OBSTACLE_EXPLORER_MISSION_ONE_AUTHORING_V1,
+  PADDLE_PULSE_EXTERNAL_CONTENT_V1: () => PADDLE_PULSE_EXTERNAL_CONTENT_V1,
   PADDLE_PULSE_MISSION_ONE_AUTHORING_V1: () => PADDLE_PULSE_MISSION_ONE_AUTHORING_V1,
   PIXEL_TRAIL_CHALLENGE_MISSION_ONE_AUTHORING_V1: () => PIXEL_TRAIL_CHALLENGE_MISSION_ONE_AUTHORING_V1,
   RAINBOW_RESCUE_ROVER_MISSION_ONE_AUTHORING_V1: () => RAINBOW_RESCUE_ROVER_MISSION_ONE_AUTHORING_V1,
   RESCUE_CREW_COMMANDER_MISSION_ONE_AUTHORING_V1: () => RESCUE_CREW_COMMANDER_MISSION_ONE_AUTHORING_V1,
+  ROAD_HOPPER_RALLY_EXTERNAL_CONTENT_V1: () => ROAD_HOPPER_RALLY_EXTERNAL_CONTENT_V1,
+  ROAD_HOPPER_RALLY_EXTERNAL_CONTENT_V2: () => ROAD_HOPPER_RALLY_EXTERNAL_CONTENT_V2,
   ROAD_HOPPER_RALLY_MISSION_ONE_AUTHORING_V1: () => ROAD_HOPPER_RALLY_MISSION_ONE_AUTHORING_V1,
   ROBOT_MAZE_DASH_MISSION_ONE_AUTHORING_V1: () => ROBOT_MAZE_DASH_MISSION_ONE_AUTHORING_V1,
   ROBOT_MISSION_CONTROL_MISSION_ONE_AUTHORING_V1: () => ROBOT_MISSION_CONTROL_MISSION_ONE_AUTHORING_V1,
@@ -67,6 +77,7 @@ __export(index_exports, {
   assertValidStaticProjectSnapshot: () => assertValidStaticProjectSnapshot,
   assertValidVoiceHelpAvailability: () => assertValidVoiceHelpAvailability,
   calculateAssessment: () => calculateAssessment,
+  isExternalLearningContentReferenceV1: () => isExternalLearningContentReferenceV1,
   validateAssessmentRubric: () => validateAssessmentRubric,
   validateLearningPath: () => validateLearningPath,
   validateMissionAuthoringBundle: () => validateMissionAuthoringBundle,
@@ -644,9 +655,285 @@ var JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1 = {
     }
   }))
 };
-var JUNIOR_CODER_ROBOT_RESCUE_PATH_CURRENT = JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1;
+var ROAD_HOPPER_RALLY_EXTERNAL_CONTENT_V1 = Object.freeze({
+  packageName: "@plasius/learning-road-hopper-rally",
+  packageVersion: "1.0.0",
+  exportName: "ROAD_HOPPER_RALLY_COURSE_V2",
+  schemaVersion: "2",
+  sha256: "1a20741beba028004e0be527d05aae2b2881082d3b578e0d62308a59bf1323f0"
+});
+var ROAD_HOPPER_RALLY_EXTERNAL_CONTENT_V2 = Object.freeze({
+  packageName: "@plasius/learning-road-hopper-rally",
+  packageVersion: "1.1.0",
+  exportName: "ROAD_HOPPER_RALLY_COURSE_V3",
+  schemaVersion: "3",
+  sha256: "f73b90f5f0e483b96724f978f2977435a5e6a1333f5f45fd0fc803b55ad21187"
+});
+var roadHopperV1_1 = JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1.modules.find(
+  (entry) => entry.id === "junior-coder.road-hopper-rally"
+);
+var ROAD_HOPPER_RALLY_V2_MISSIONS = [
+  {
+    id: "board",
+    title: "Build the Rally Board",
+    concepts: ["coordinate grids", "arrays", "entity state", "rendering"],
+    statement: "Create the road, median, river and five distinct home bays in board.js.",
+    sideAdventure: "Design an original high-contrast board palette without changing its mechanics."
+  },
+  {
+    id: "hopper",
+    title: "Move the Hopper",
+    concepts: ["events", "bounded movement", "keyboard input", "touch input", "respawning"],
+    statement: "Implement four-direction tile movement, bounds, equivalent inputs and respawning in hopper.js.",
+    sideAdventure: "Add an accessible movement status phrase for every successful hop."
+  },
+  {
+    id: "traffic",
+    title: "Create Rally Traffic",
+    concepts: ["spawning", "fixed-step updates", "wrapping", "collision detection", "difficulty"],
+    statement: "Implement five deterministic traffic lanes, collisions, lives and difficulty in traffic.js.",
+    sideAdventure: "Invent an original vehicle type while preserving the entity and collision limits."
+  },
+  {
+    id: "river",
+    title: "Cross the Moving River",
+    concepts: ["moving platforms", "carrying", "hazards", "state machines", "off-screen bounds"],
+    statement: "Implement logs, carrying, water deaths, diving platforms and edge hazards in river.js.",
+    sideAdventure: "Create an original visual warning for a platform that is about to dive."
+  },
+  {
+    id: "rules",
+    title: "Add Rally Rules",
+    concepts: ["timers", "lives", "scoring", "bonuses", "levels", "game over"],
+    statement: "Implement homes, occupied and blocked bays, timer, scoring, bonuses and level progression in rules.js.",
+    sideAdventure: "Tune a practice-speed preset that keeps every rule deterministic."
+  },
+  {
+    id: "game",
+    title: "Complete Road Hopper Rally",
+    concepts: ["system assembly", "pause and restart", "alternating players", "audio", "accessibility", "testing"],
+    statement: "Assemble the systems, accessibility modes and alternating-player finale in game.js, then pass the protected challenge.",
+    sideAdventure: "Polish the finished game with original captions, visual cues and reduced-motion feedback."
+  }
+];
+var JUNIOR_CODER_ROAD_HOPPER_RALLY_V2 = {
+  ...roadHopperV1_1,
+  version: "2.0.0",
+  contentRevision: "2026-08-11.1",
+  summary: "Recreate the systems behind a classic road-and-river crossing game using original Road Hopper Rally code, art, audio and presentation.",
+  estimatedMinutes: 450,
+  tools: [
+    "JavaScript",
+    "QuickJS sandbox",
+    "Deterministic 30 Hz engine",
+    "Road Hopper renderer"
+  ],
+  concepts: [
+    "coordinates",
+    "arrays and entity state",
+    "events and input",
+    "fixed-step update and render",
+    "spawning and movement",
+    "collision detection",
+    "state machines",
+    "timers, lives and scoring",
+    "difficulty progression",
+    "audio integration",
+    "debugging",
+    "deterministic testing"
+  ],
+  missions: ROAD_HOPPER_RALLY_V2_MISSIONS.map((missionDefinition, index) => ({
+    id: `road-hopper-rally-mission-${index + 1}-${missionDefinition.id}`,
+    title: missionDefinition.title,
+    estimatedMinutes: 75,
+    concepts: [...missionDefinition.concepts],
+    goals: [
+      {
+        id: `road-hopper-rally-v2-${missionDefinition.id}`,
+        statement: missionDefinition.statement,
+        evidence: "assessment"
+      }
+    ],
+    sideAdventure: missionDefinition.sideAdventure
+  })),
+  assessment: {
+    version: "2.0.0",
+    completionScore: 80,
+    criteria: [
+      { id: "road-hopper-v2-structure", label: "All six bounded JavaScript files compile and assemble.", dimension: "structure", points: 20, mandatory: true, visibility: "visible" },
+      { id: "road-hopper-v2-road", label: "Board, input and traffic behaviours pass deterministic scenarios.", dimension: "behaviour", points: 15, mandatory: true, visibility: "visible" },
+      { id: "road-hopper-v2-river", label: "River platforms, carrying and hazards pass deterministic scenarios.", dimension: "behaviour", points: 15, mandatory: true, visibility: "visible" },
+      { id: "road-hopper-v2-rules", label: "Homes, timer, lives, scoring, bonuses and levels behave correctly.", dimension: "behaviour", points: 20, mandatory: true, visibility: "visible" },
+      { id: "road-hopper-v2-final", label: "The complete game passes the server-only protected final challenge.", dimension: "resilience", points: 20, mandatory: true, visibility: "protected" },
+      { id: "road-hopper-v2-safety", label: "The project stays within the sandbox, resource and privacy boundaries.", dimension: "safety", points: 10, mandatory: true, visibility: "visible" }
+    ]
+  },
+  badges: [
+    {
+      id: "road-hopper-rally-v2-complete",
+      title: "Road Hopper Rally Champion",
+      evidence: "module-score",
+      tradeable: false,
+      tokenConvertible: false
+    }
+  ],
+  externalContent: ROAD_HOPPER_RALLY_EXTERNAL_CONTENT_V1
+};
+var ROAD_HOPPER_RALLY_V2_1_MISSION_TITLES = [
+  "Map the Rally Route",
+  "Move the Hopper",
+  "Build the Traffic Rally",
+  "Ride the Rescue River",
+  "Score the Rescue",
+  "Road Hopper Rally Challenge"
+];
+var JUNIOR_CODER_ROAD_HOPPER_RALLY_V2_1 = {
+  ...JUNIOR_CODER_ROAD_HOPPER_RALLY_V2,
+  version: "2.1.0",
+  contentRevision: "2026-08-24.1",
+  summary: "Build Road Hopper Rally through 54 evidence-led activities: predict, edit, run, inspect, repair, explain and prove each deterministic game system.",
+  missions: JUNIOR_CODER_ROAD_HOPPER_RALLY_V2.missions.map((mission2, index) => ({
+    ...mission2,
+    title: ROAD_HOPPER_RALLY_V2_1_MISSION_TITLES[index]
+  })),
+  assessment: {
+    ...JUNIOR_CODER_ROAD_HOPPER_RALLY_V2.assessment,
+    version: "2.1.0"
+  },
+  externalContent: ROAD_HOPPER_RALLY_EXTERNAL_CONTENT_V2
+};
+var JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_2 = {
+  ...JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1,
+  version: "1.2.0",
+  modules: JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1.modules.map((entry) => entry.id === JUNIOR_CODER_ROAD_HOPPER_RALLY_V2.id ? JUNIOR_CODER_ROAD_HOPPER_RALLY_V2 : entry)
+};
+var PADDLE_PULSE_EXTERNAL_CONTENT_V1 = Object.freeze({
+  packageName: "@plasius/learning-paddle-pulse",
+  packageVersion: "0.1.0",
+  exportName: "PADDLE_PULSE_MODULE_V2",
+  schemaVersion: "2",
+  sha256: "19f3666bdb523a3faf069341b0bc748996b3db282f89171e3c9f0a373a8c8f7e"
+});
+var paddlePulseV1_1 = JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1.modules.find(
+  (entry) => entry.id === "junior-coder.paddle-pulse"
+);
+var PADDLE_PULSE_V2_MISSIONS = [
+  {
+    id: "court-coordinates",
+    title: "Court & Coordinates",
+    concepts: ["coordinates", "canvas primitives", "game loops", "bounds"],
+    statement: "Build a responsive 640 \xD7 480 logical court with a bounded paddle and ball.",
+    sideAdventure: "Create an original high-contrast court palette without changing its geometry."
+  },
+  {
+    id: "paddle-controls",
+    title: "Paddle Controls",
+    concepts: ["input state", "Pointer Events", "keyboard input", "clamping"],
+    statement: "Implement equivalent Arrow/A/D and direct horizontal pointer-drag controls.",
+    sideAdventure: "Add a semantic movement trace that does not rely on animation."
+  },
+  {
+    id: "ball-motion",
+    title: "Ball Motion & Bounces",
+    concepts: ["velocity", "fixed timesteps", "reflection", "contact normals", "paddle angles"],
+    statement: "Implement deterministic ball motion plus controlled wall and paddle reflections.",
+    sideAdventure: "Design a reduced-motion trajectory inspector for one rally."
+  },
+  {
+    id: "bricks-collisions",
+    title: "Bricks & Collisions",
+    concepts: ["arrays", "loops", "brick grids", "AABB collision", "resolution"],
+    statement: "Create an original brick grid whose bricks score once and disappear on impact.",
+    sideAdventure: "Invent a new visual brick pattern using the same bounded collision rules."
+  },
+  {
+    id: "score-lives-states",
+    title: "Score, Lives & States",
+    concepts: ["state machines", "invariants", "scoring", "lives", "HUD state"],
+    statement: "Implement serve, pause, life loss, level clear, game over, score and HUD states.",
+    sideAdventure: "Add a printable state-transition table for a facilitator or screen-reader user."
+  },
+  {
+    id: "levels-final-game",
+    title: "Levels, Sound & Final Game",
+    concepts: ["level data", "difficulty", "responsive rendering", "accessible audio", "testing"],
+    statement: "Assemble multiple original levels, optional generated cues and the integrated final game.",
+    sideAdventure: "After completion, add an optional original power-up without changing core assessment."
+  }
+];
+var JUNIOR_CODER_PADDLE_PULSE_V2 = {
+  ...paddlePulseV1_1,
+  version: "2.0.0",
+  contentRevision: "2026-08-11.1",
+  summary: "Build an original Plasius brick-breaker while learning rendering, equivalent input, deterministic physics, collisions, score, lives, states, levels, accessible sound and testing.",
+  estimatedMinutes: 360,
+  tools: [
+    "JavaScript",
+    "QuickJS sandbox",
+    "Deterministic 60 Hz engine",
+    "Responsive Paddle Pulse renderer"
+  ],
+  concepts: [
+    "coordinates and rendering",
+    "game loops and fixed timesteps",
+    "keyboard and pointer input",
+    "velocity and reflection",
+    "collision detection and resolution",
+    "arrays and brick grids",
+    "scoring, lives and state machines",
+    "level data and difficulty",
+    "accessible generated audio",
+    "debugging and deterministic testing"
+  ],
+  missions: PADDLE_PULSE_V2_MISSIONS.map((missionDefinition, index) => ({
+    id: `paddle-pulse-mission-${index + 1}-${missionDefinition.id}`,
+    title: missionDefinition.title,
+    estimatedMinutes: 60,
+    concepts: [...missionDefinition.concepts],
+    goals: [{
+      id: `paddle-pulse-v2-${missionDefinition.id}`,
+      statement: missionDefinition.statement,
+      evidence: "assessment"
+    }],
+    sideAdventure: missionDefinition.sideAdventure
+  })),
+  assessment: {
+    version: "2.0.0",
+    completionScore: 80,
+    criteria: [
+      { id: "paddle-pulse-v2-court", label: "The logical court, paddle and initial scene are finite, responsive and bounded.", dimension: "structure", points: 20, mandatory: false, visibility: "visible" },
+      { id: "paddle-pulse-v2-controls", label: "Keyboard and pointer paths produce equivalent clamped paddle input.", dimension: "behaviour", points: 15, mandatory: false, visibility: "visible" },
+      { id: "paddle-pulse-v2-motion", label: "Ball motion and wall/paddle reflections pass deterministic trajectories.", dimension: "behaviour", points: 15, mandatory: false, visibility: "visible" },
+      { id: "paddle-pulse-v2-bricks", label: "Brick face, corner and adjacent impacts resolve without double-scoring.", dimension: "behaviour", points: 20, mandatory: false, visibility: "visible" },
+      { id: "paddle-pulse-v2-states", label: "Score, lives, serve, pause, level-clear and game-over transitions preserve invariants.", dimension: "resilience", points: 10, mandatory: false, visibility: "visible" },
+      { id: "paddle-pulse-v2-final", label: "Multiple original levels and the integrated game pass protected deterministic scenarios.", dimension: "resilience", points: 10, mandatory: false, visibility: "protected" },
+      { id: "paddle-pulse-v2-safety", label: "Source, commands, runtime resources and assessment remain inside sandbox limits.", dimension: "safety", points: 10, mandatory: true, visibility: "visible" }
+    ]
+  },
+  badges: [
+    { id: "paddle-pulse-v2-court-builder", title: "Court Builder", evidence: "mission-score", tradeable: false, tokenConvertible: false },
+    { id: "paddle-pulse-v2-paddle-pilot", title: "Paddle Pilot", evidence: "mission-score", tradeable: false, tokenConvertible: false },
+    { id: "paddle-pulse-v2-rally-master", title: "Rally Master", evidence: "mission-score", tradeable: false, tokenConvertible: false },
+    { id: "paddle-pulse-v2-brick-breaker", title: "Brick Breaker", evidence: "mission-score", tradeable: false, tokenConvertible: false },
+    { id: "paddle-pulse-v2-game-keeper", title: "Game Keeper", evidence: "mission-score", tradeable: false, tokenConvertible: false },
+    { id: "paddle-pulse-v2-complete", title: "Paddle Pulse Champion", evidence: "module-score", tradeable: false, tokenConvertible: false }
+  ],
+  externalContent: PADDLE_PULSE_EXTERNAL_CONTENT_V1
+};
+var JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_3 = {
+  ...JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_2,
+  version: "1.3.0",
+  modules: JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_2.modules.map((entry) => entry.id === JUNIOR_CODER_PADDLE_PULSE_V2.id ? JUNIOR_CODER_PADDLE_PULSE_V2 : entry)
+};
+var JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_4 = {
+  ...JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_3,
+  version: "1.4.0",
+  modules: JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_3.modules.map((entry) => entry.id === JUNIOR_CODER_ROAD_HOPPER_RALLY_V2_1.id ? JUNIOR_CODER_ROAD_HOPPER_RALLY_V2_1 : entry)
+};
+var JUNIOR_CODER_ROBOT_RESCUE_PATH_CURRENT = JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_4;
 
 // src/contracts.ts
+var EXTERNAL_LEARNING_CONTENT_REFERENCE_VERSION_V1 = "1";
 var MISSION_AUTHORING_CONTRACT_VERSION_V1 = "1.0.0";
 
 // src/contextual-help.ts
@@ -6838,6 +7125,16 @@ var ROAD_HOPPER_RALLY_MISSION_ONE_AUTHORING_V1 = {
 
 // src/validation.ts
 var CANONICAL_TOKEN_SUBUNITS = /^(0|[1-9][0-9]*)$/u;
+var EXACT_PACKAGE_NAME = /^@plasius\/[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/u;
+var EXACT_SEMVER = /^(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)$/u;
+var EXPORT_NAME = /^[A-Za-z_$][A-Za-z0-9_$]*$/u;
+var CONTENT_SCHEMA_VERSION = /^(0|[1-9][0-9]*)$/u;
+var SHA256 = /^[a-f0-9]{64}$/u;
+function isExternalLearningContentReferenceV1(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const candidate = value;
+  return Object.keys(value).length === 5 && typeof candidate.packageName === "string" && EXACT_PACKAGE_NAME.test(candidate.packageName) && typeof candidate.packageVersion === "string" && EXACT_SEMVER.test(candidate.packageVersion) && typeof candidate.exportName === "string" && EXPORT_NAME.test(candidate.exportName) && typeof candidate.schemaVersion === "string" && CONTENT_SCHEMA_VERSION.test(candidate.schemaVersion) && typeof candidate.sha256 === "string" && SHA256.test(candidate.sha256);
+}
 function issue(code, message, path, moduleId) {
   return { code, message, path, ...moduleId ? { moduleId } : {} };
 }
@@ -6952,6 +7249,17 @@ function validateModule(module3, moduleIndex) {
       )
     );
   }
+  const externalContent = module3.externalContent;
+  if (externalContent && !isExternalLearningContentReferenceV1(externalContent)) {
+    issues.push(
+      issue(
+        "invalid-external-content-reference",
+        "External content must use an exact @plasius package, stable semantic version, named export, schema version and lower-case SHA-256 digest.",
+        `${base}.externalContent`,
+        module3.id
+      )
+    );
+  }
   return issues;
 }
 function validateLearningPath(path) {
@@ -7002,18 +7310,28 @@ ${summary}`);
   CONTEXTUAL_VOICE_SUGGESTED_ACTIONS_V1,
   CREATURE_CARE_DASHBOARD_MISSION_ONE_AUTHORING_V1,
   DANCE_ROVER_MISSION_ONE_AUTHORING_V1,
+  EXTERNAL_LEARNING_CONTENT_REFERENCE_VERSION_V1,
   JUNIOR_CODER_MISSION_STAGE_ORDER_V1,
   JUNIOR_CODER_MODULE_PRICE_V1_1,
+  JUNIOR_CODER_PADDLE_PULSE_V2,
+  JUNIOR_CODER_ROAD_HOPPER_RALLY_V2,
+  JUNIOR_CODER_ROAD_HOPPER_RALLY_V2_1,
   JUNIOR_CODER_ROBOT_RESCUE_PATH_CURRENT,
   JUNIOR_CODER_ROBOT_RESCUE_PATH_V1,
   JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_1,
+  JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_2,
+  JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_3,
+  JUNIOR_CODER_ROBOT_RESCUE_PATH_V1_4,
   METEOR_SHIELD_MISSION_ONE_AUTHORING_V1,
   MISSION_AUTHORING_CONTRACT_VERSION_V1,
   OBSTACLE_EXPLORER_MISSION_ONE_AUTHORING_V1,
+  PADDLE_PULSE_EXTERNAL_CONTENT_V1,
   PADDLE_PULSE_MISSION_ONE_AUTHORING_V1,
   PIXEL_TRAIL_CHALLENGE_MISSION_ONE_AUTHORING_V1,
   RAINBOW_RESCUE_ROVER_MISSION_ONE_AUTHORING_V1,
   RESCUE_CREW_COMMANDER_MISSION_ONE_AUTHORING_V1,
+  ROAD_HOPPER_RALLY_EXTERNAL_CONTENT_V1,
+  ROAD_HOPPER_RALLY_EXTERNAL_CONTENT_V2,
   ROAD_HOPPER_RALLY_MISSION_ONE_AUTHORING_V1,
   ROBOT_MAZE_DASH_MISSION_ONE_AUTHORING_V1,
   ROBOT_MISSION_CONTROL_MISSION_ONE_AUTHORING_V1,
@@ -7041,6 +7359,7 @@ ${summary}`);
   assertValidStaticProjectSnapshot,
   assertValidVoiceHelpAvailability,
   calculateAssessment,
+  isExternalLearningContentReferenceV1,
   validateAssessmentRubric,
   validateLearningPath,
   validateMissionAuthoringBundle,