@plasius/learning 0.6.0 → 0.8.0

package/README.md

@@ -81,6 +81,47 @@ recognition confidence, steering, command identities, heartbeat expiry and
 repeat-safe rescue evidence. Each has 54 activities and 18 formative checks.
 Existing guardian and hardware protections remain separate from course completion.
 
+The three lazy Vibe curricula (`courses/vibe-game-remix-lab`,
+`courses/vibe-bug-detective` and `courses/vibe-idea-studio`) each provide six missions,
+54 activities and 18 concept checks around editable JavaScript projects, bounded
+brief/evidence files and learner-authored replay cases. Their projects respectively
+teach a rescue-game remix with intermediate dash checks, evidence-led repairs of
+an intentionally broken game, and a budgeted mission-board prototype with undo
+and filtering. Idea Studio explicitly distinguishes test-first contract predictions
+from the final requirement that those cases pass against the learner's source.
+
+These entries also export `suggestions` using `LearningCourseSuggestionV1`, which
+reuses `MissionBoundedSuggestionV1`. Authored proposals include incorrect changes
+for learners to reject with evidence; publication is not an endorsement of every
+proposed replacement. No live AI is required. `parseLearningCourseSuggestion`
+validates stage and file references plus bounded proposal fields.
+`applyLearningCourseSuggestion` builds a new validated project using one exact,
+unambiguous literal snippet match. It rejects stale/ambiguous context and rechecks
+project limits after replacement. Hosts must show the actual diff and obtain an
+explicit learner choice before using it. Neither helper executes code, approves
+a change, writes storage or awards evidence; independently assess the saved result.
+
+The web entries `courses/adventure-mission-planner`,
+`courses/creature-care-dashboard` and `courses/robot-mission-control` complete the
+set of seventeen learner curricula. Each exports `course` and `practice`, with
+six authored missions, 54 activities, 18 formative checks and editable
+`index.html`, `app.css` and `app.js` starter files. The planner teaches semantic
+forms, validated records, stable identities, revision and corrupt-snapshot
+recovery. Creature Care teaches resource accounting, deterministic time, rest
+versus pause and bounded history. Mission Control teaches connection, explicit
+arming, bounded motor commands, independent STOP, telemetry expiry and deliberate
+recovery. All include responsive styling, native labels, focus, readable feedback
+and accessibility verification in the authored journey.
+
+Web starters deliberately leave later behaviour for the learner to implement.
+They are HTML fragments with explicit data/action bindings and pure JavaScript
+state functions, not unrestricted browser scripts. The separately released
+runtime's lazy `/web` compiler and isolated JavaScript worker are host facilities;
+this package imports neither. Preview plan storage is simulated state, distinct
+from account source saves. Robot control is virtual and grants no hardware access.
+See [web course design](docs/tdrs/tdr-0014-complete-web-course-journeys.md) for the
+runtime boundary, progressive assessment scope and host acceptance obligations.
+
 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

package/dist/chunk-UNPCTBNK.js

@@ -0,0 +1,43 @@
+// src/courses/web-course-authoring.ts
+var webProjectFiles = [
+  { path: "index.html", language: "html", maximumCharacters: 24e3 },
+  { path: "app.css", language: "css", maximumCharacters: 16e3 },
+  { path: "app.js", language: "javascript", maximumCharacters: 32e3 }
+];
+var webStarterCss = `:root { color: #172a29; background-color: #f5f4ec; font-family: system-ui, sans-serif; line-height: 1.6; }
+* { box-sizing: border-box; }
+main { max-width: 60rem; margin-inline: auto; padding: 1rem; overflow-wrap: anywhere; }
+h1, h2, p { margin-top: 0; }
+section, article, fieldset { border: 1px solid #647874; border-radius: 0.5rem; padding: 1rem; margin-block: 1rem; min-width: 0; }
+label { display: block; font-weight: 700; }
+button, input, select, textarea { font-family: inherit; font-size: 1rem; line-height: 1.6; min-height: 2.75rem; max-width: 100%; border: 2px solid #465e59; border-radius: 0.25rem; padding: 0.5rem; color: inherit; background-color: #ffffff; }
+button { cursor: pointer; }
+button:disabled { cursor: default; border-style: dashed; }
+:focus-visible { outline: 3px solid #075bab; outline-offset: 3px; }
+[aria-invalid="true"] { border-color: #a11c25; }
+.error { color: #a11c25; }
+.actions { display: flex; flex-wrap: wrap; gap: 0.75rem; }
+.cards { display: grid; gap: 1rem; padding: 0; list-style-type: none; }
+progress, meter { width: 100%; }
+@media (min-width: 48rem) { .cards { grid-template-columns: repeat(2, minmax(0, 1fr)); } }
+@media (prefers-reduced-motion: reduce) { * { transition-duration: 0s; } }
+@media (prefers-color-scheme: dark) {
+  :root { color: #edf4ef; background-color: #142623; }
+  button, input, select, textarea { color: #edf4ef; background-color: #203a34; border-color: #b8cec5; }
+  :focus-visible { outline-color: #a8d6ff; }
+  .error { color: #ffb8bf; }
+  [aria-invalid="true"] { border-color: #ffb8bf; }
+}
+`;
+var webReferences = [
+  { name: "editable web files", signature: "index.html + app.css + app.js", description: "Write a semantic HTML fragment beginning with main, scoped responsive CSS and pure JavaScript initialState/update/view functions. The host compiles HTML/CSS and runs JavaScript separately. No document, DOM, imports, network, localStorage, timers, images or external resources are available. Fictional project data stays inside the preview; course source is saved through the bound account.", example: '<main><h1>My project</h1><p role="status" data-text="message"></p></main>' },
+  { name: "bindings", signature: "view(state) \u2192 plain JSON display data", description: "data-text displays scalar text; data-value controls a native field; data-checked, data-disabled, data-pressed, data-invalid and data-if require booleans. data-label supplies a nonempty accessible label. data-repeat repeats its element for records with unique string id, resolving nested bindings within each record. Do not put static HTML IDs in repeated content. Paths use named fields up to four segments, without expressions.", example: '<li data-repeat="missions"><span data-text="title"></span><button type="button" data-action="toggle" data-id="id" data-pressed="done" data-label="toggleLabel">Toggle</button></li>' },
+  { name: "native events", signature: '{ type: "field", name, value } or { type, id? }', description: "A named input, textarea or select emits field with its string value (checkboxes use booleans). A type=button with data-action emits that action and optional bound data-id. A form with data-action owns submission; its submit button has no separate action. Prevent network submission. Preserve native labels, focus and keyboard operation; input text is never executable markup.", example: '<form data-action="add" novalidate><label for="title">Mission</label><input id="title" name="title" data-value="draft.title"><button type="submit">Add mission</button></form>' }
+];
+
+export {
+  webProjectFiles,
+  webStarterCss,
+  webReferences
+};
+//# sourceMappingURL=chunk-UNPCTBNK.js.map

package/dist/chunk-UNPCTBNK.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/courses/web-course-authoring.ts"],"sourcesContent":["import type { LearningCourseV1 } from \"../course-contracts.js\";\n\n/** The web courses share file limits and a readable starting theme, not lesson content. */\nexport const webProjectFiles: LearningCourseV1[\"projectFiles\"] = [\n  { path: \"index.html\", language: \"html\", maximumCharacters: 24000 },\n  { path: \"app.css\", language: \"css\", maximumCharacters: 16000 },\n  { path: \"app.js\", language: \"javascript\", maximumCharacters: 32000 },\n];\n\nexport const webStarterCss = `:root { color: #172a29; background-color: #f5f4ec; font-family: system-ui, sans-serif; line-height: 1.6; }\n* { box-sizing: border-box; }\nmain { max-width: 60rem; margin-inline: auto; padding: 1rem; overflow-wrap: anywhere; }\nh1, h2, p { margin-top: 0; }\nsection, article, fieldset { border: 1px solid #647874; border-radius: 0.5rem; padding: 1rem; margin-block: 1rem; min-width: 0; }\nlabel { display: block; font-weight: 700; }\nbutton, input, select, textarea { font-family: inherit; font-size: 1rem; line-height: 1.6; min-height: 2.75rem; max-width: 100%; border: 2px solid #465e59; border-radius: 0.25rem; padding: 0.5rem; color: inherit; background-color: #ffffff; }\nbutton { cursor: pointer; }\nbutton:disabled { cursor: default; border-style: dashed; }\n:focus-visible { outline: 3px solid #075bab; outline-offset: 3px; }\n[aria-invalid=\"true\"] { border-color: #a11c25; }\n.error { color: #a11c25; }\n.actions { display: flex; flex-wrap: wrap; gap: 0.75rem; }\n.cards { display: grid; gap: 1rem; padding: 0; list-style-type: none; }\nprogress, meter { width: 100%; }\n@media (min-width: 48rem) { .cards { grid-template-columns: repeat(2, minmax(0, 1fr)); } }\n@media (prefers-reduced-motion: reduce) { * { transition-duration: 0s; } }\n@media (prefers-color-scheme: dark) {\n  :root { color: #edf4ef; background-color: #142623; }\n  button, input, select, textarea { color: #edf4ef; background-color: #203a34; border-color: #b8cec5; }\n  :focus-visible { outline-color: #a8d6ff; }\n  .error { color: #ffb8bf; }\n  [aria-invalid=\"true\"] { border-color: #ffb8bf; }\n}\n`;\n\nexport const webReferences: LearningCourseV1[\"reference\"] = [\n  { name: \"editable web files\", signature: \"index.html + app.css + app.js\", description: \"Write a semantic HTML fragment beginning with main, scoped responsive CSS and pure JavaScript initialState/update/view functions. The host compiles HTML/CSS and runs JavaScript separately. No document, DOM, imports, network, localStorage, timers, images or external resources are available. Fictional project data stays inside the preview; course source is saved through the bound account.\", example: '<main><h1>My project</h1><p role=\"status\" data-text=\"message\"></p></main>' },\n  { name: \"bindings\", signature: \"view(state) → plain JSON display data\", description: \"data-text displays scalar text; data-value controls a native field; data-checked, data-disabled, data-pressed, data-invalid and data-if require booleans. data-label supplies a nonempty accessible label. data-repeat repeats its element for records with unique string id, resolving nested bindings within each record. Do not put static HTML IDs in repeated content. Paths use named fields up to four segments, without expressions.\", example: '<li data-repeat=\"missions\"><span data-text=\"title\"></span><button type=\"button\" data-action=\"toggle\" data-id=\"id\" data-pressed=\"done\" data-label=\"toggleLabel\">Toggle</button></li>' },\n  { name: \"native events\", signature: '{ type: \"field\", name, value } or { type, id? }', description: \"A named input, textarea or select emits field with its string value (checkboxes use booleans). A type=button with data-action emits that action and optional bound data-id. A form with data-action owns submission; its submit button has no separate action. Prevent network submission. Preserve native labels, focus and keyboard operation; input text is never executable markup.\", example: '<form data-action=\"add\" novalidate><label for=\"title\">Mission</label><input id=\"title\" name=\"title\" data-value=\"draft.title\"><button type=\"submit\">Add mission</button></form>' },\n];\n"],"mappings":";AAGO,IAAM,kBAAoD;AAAA,EAC/D,EAAE,MAAM,cAAc,UAAU,QAAQ,mBAAmB,KAAM;AAAA,EACjE,EAAE,MAAM,WAAW,UAAU,OAAO,mBAAmB,KAAM;AAAA,EAC7D,EAAE,MAAM,UAAU,UAAU,cAAc,mBAAmB,KAAM;AACrE;AAEO,IAAM,gBAAgB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA0BtB,IAAM,gBAA+C;AAAA,EAC1D,EAAE,MAAM,sBAAsB,WAAW,iCAAiC,aAAa,yYAAyY,SAAS,4EAA4E;AAAA,EACrjB,EAAE,MAAM,YAAY,WAAW,8CAAyC,aAAa,gbAAgb,SAAS,sLAAsL;AAAA,EACpsB,EAAE,MAAM,iBAAiB,WAAW,mDAAmD,aAAa,2XAA2X,SAAS,iLAAiL;AAC3pB;","names":[]}

package/dist/course-suggestions-CBs5swU6.d.ts

@@ -0,0 +1,17 @@
+import { T as MissionBoundedSuggestionV1, L as LearningCourseV1, K as LearningProjectV1 } from './course-authoring-DImvrK5r.js';
+
+/** Learner-safe authored diff; the artifact ID is a declared course project path. */
+interface LearningCourseSuggestionV1 {
+    stageId: string;
+    proposal: MissionBoundedSuggestionV1;
+}
+/** Validate a reviewed proposal without executing, applying or approving it. */
+declare function parseLearningCourseSuggestion(course: LearningCourseV1, value: unknown): LearningCourseSuggestionV1;
+/**
+ * Build the proposed project after an explicit learner choice in the host.
+ * This pure function grants no approval, writes no storage and awards no evidence.
+ * Stale or ambiguous snippets must be reviewed again rather than applied fuzzily.
+ */
+declare function applyLearningCourseSuggestion(course: LearningCourseV1, project: unknown, suggestion: unknown): LearningProjectV1;
+
+export { type LearningCourseSuggestionV1 as L, applyLearningCourseSuggestion as a, parseLearningCourseSuggestion as p };

package/dist/course-suggestions-mK2MPB7e.d.cts

@@ -0,0 +1,17 @@
+import { T as MissionBoundedSuggestionV1, L as LearningCourseV1, K as LearningProjectV1 } from './course-authoring-DImvrK5r.cjs';
+
+/** Learner-safe authored diff; the artifact ID is a declared course project path. */
+interface LearningCourseSuggestionV1 {
+    stageId: string;
+    proposal: MissionBoundedSuggestionV1;
+}
+/** Validate a reviewed proposal without executing, applying or approving it. */
+declare function parseLearningCourseSuggestion(course: LearningCourseV1, value: unknown): LearningCourseSuggestionV1;
+/**
+ * Build the proposed project after an explicit learner choice in the host.
+ * This pure function grants no approval, writes no storage and awards no evidence.
+ * Stale or ambiguous snippets must be reviewed again rather than applied fuzzily.
+ */
+declare function applyLearningCourseSuggestion(course: LearningCourseV1, project: unknown, suggestion: unknown): LearningProjectV1;
+
+export { type LearningCourseSuggestionV1 as L, applyLearningCourseSuggestion as a, parseLearningCourseSuggestion as p };