@lssm/example.learning-journey-duo-drills 0.0.0-canary-20251217080011 → 0.0.0-canary-20251219202229

package/dist/libs/contracts/dist/docs/tech-contracts.docs.js

@@ -0,0 +1,97 @@
+import { registerDocBlocks } from "./registry.js";
+
+//#region ../../libs/contracts/dist/docs/tech-contracts.docs.js
+const techContractsDocs = [{
+	id: "docs.tech.contracts.presentations-v2",
+	title: "Presentations V2 — Unified Descriptor & Transform Engine",
+	summary: "How PresentationDescriptorV2 and TransformEngine keep docs/renderers consistent.",
+	visibility: "public",
+	route: "/docs/tech/contracts/presentations-v2",
+	kind: "reference",
+	tags: [
+		"presentations",
+		"docs",
+		"mcp"
+	],
+	body: `## Presentations V2 — Unified Descriptor & Transform Engine
+
+### Purpose
+
+Unify presentations into one descriptor (\`PresentationDescriptorV2\`) that declares a single source (React component key or BlockNote doc) and a list of output targets (react, markdown, application/json, application/xml). A pluggable \`TransformEngine\` renders any target and applies PII redaction.
+
+### Types
+
+\`\`\`ts
+type PresentationTarget =
+  | 'react'
+  | 'markdown'
+  | 'application/json'
+  | 'application/xml';
+
+type PresentationSource =
+  | {
+      type: 'component';
+      framework: 'react';
+      componentKey: string;
+      props?: AnySchemaModel;
+    }
+  | { type: 'blocknotejs'; docJson: unknown; blockConfig?: unknown };
+
+interface PresentationDescriptorV2 {
+  meta: PresentationV2Meta; // includes partial OwnerShipMeta + description
+  policy?: { flags?: string[]; pii?: string[] };
+  source: PresentationSource;
+  targets: PresentationTarget[];
+}
+
+// Shared ownership schema (source of truth in @lssm/lib.contracts/src/ownership.ts)
+interface OwnerShipMeta {
+  title: string;
+  description: string;
+  domain: string;
+  owners: Owner[];
+  tags: Tag[];
+  stability: Stability;
+}
+
+type Stability = 'experimental' | 'beta' | 'stable' | 'deprecated';
+type Owner = string; // curated list available in code (e.g., '@sigil-team', 'team-strit')
+type Tag = string; // curated list available in code (e.g., 'auth', 'spots')
+
+// For V2 presentations, meta is a Partial<OwnerShipMeta> plus description, name, version
+interface PresentationV2Meta extends Partial<OwnerShipMeta> {
+  name: string;
+  version: number;
+  description?: string;
+}
+\`\`\`
+
+### Engine
+
+Use \`createDefaultTransformEngine()\` and register custom renderers as needed (e.g., high-fidelity BlockNote → Markdown). The default engine supports markdown/json/xml; a React renderer returns a serializable descriptor the host app renders via a \`componentMap\` or a BlockNote renderer. The canonical source type string is \`blocknotejs\` (not \`blocknote\`).
+
+PII paths (JSON-like) are redacted from rendered outputs.
+
+### MCP Integration
+
+\`createMcpServer\` accepts \`presentationsV2\`. Each descriptor is exposed under \`presentation://<name>/v<version>\` and negotiated variants (\`.md/.json/.xml\`) are rendered by the engine.
+
+### Migration
+
+- V1 \`PresentationSpec\` remains supported; a back-compat helper converts V1 → V2 when convenient.
+- Prefer V2 for new work.
+
+### Examples (Sigil)
+
+- \`sigil.auth.webauth_tabs_v2\`: component source (\`componentKey: 'sigil.webauth.tabs'\`), targets \`react/json/xml\`.
+- \`sigil.signup.guide_v2\`: BlockNote doc source, targets \`react/markdown/json/xml\`.
+
+### React Rendering
+
+Host apps use a \`componentMap\` (e.g., \`'sigil.webauth.tabs' → WebAuthTabs\`) and a BlockNote renderer to turn the React render descriptor into elements.`
+}];
+registerDocBlocks(techContractsDocs);
+
+//#endregion
+export { techContractsDocs };
+//# sourceMappingURL=tech-contracts.docs.js.map

package/dist/libs/contracts/dist/docs/tech-contracts.docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tech-contracts.docs.js","names":[],"sources":["../../../../../../../libs/contracts/dist/docs/tech-contracts.docs.js"],"sourcesContent":["import { registerDocBlocks } from \"./registry.js\";\n\n//#region src/docs/tech-contracts.docs.ts\nconst techContractsDocs = [{\n\tid: \"docs.tech.contracts.presentations-v2\",\n\ttitle: \"Presentations V2 — Unified Descriptor & Transform Engine\",\n\tsummary: \"How PresentationDescriptorV2 and TransformEngine keep docs/renderers consistent.\",\n\tvisibility: \"public\",\n\troute: \"/docs/tech/contracts/presentations-v2\",\n\tkind: \"reference\",\n\ttags: [\n\t\t\"presentations\",\n\t\t\"docs\",\n\t\t\"mcp\"\n\t],\n\tbody: `## Presentations V2 — Unified Descriptor & Transform Engine\n\n### Purpose\n\nUnify presentations into one descriptor (\\`PresentationDescriptorV2\\`) that declares a single source (React component key or BlockNote doc) and a list of output targets (react, markdown, application/json, application/xml). A pluggable \\`TransformEngine\\` renders any target and applies PII redaction.\n\n### Types\n\n\\`\\`\\`ts\ntype PresentationTarget =\n  | 'react'\n  | 'markdown'\n  | 'application/json'\n  | 'application/xml';\n\ntype PresentationSource =\n  | {\n      type: 'component';\n      framework: 'react';\n      componentKey: string;\n      props?: AnySchemaModel;\n    }\n  | { type: 'blocknotejs'; docJson: unknown; blockConfig?: unknown };\n\ninterface PresentationDescriptorV2 {\n  meta: PresentationV2Meta; // includes partial OwnerShipMeta + description\n  policy?: { flags?: string[]; pii?: string[] };\n  source: PresentationSource;\n  targets: PresentationTarget[];\n}\n\n// Shared ownership schema (source of truth in @lssm/lib.contracts/src/ownership.ts)\ninterface OwnerShipMeta {\n  title: string;\n  description: string;\n  domain: string;\n  owners: Owner[];\n  tags: Tag[];\n  stability: Stability;\n}\n\ntype Stability = 'experimental' | 'beta' | 'stable' | 'deprecated';\ntype Owner = string; // curated list available in code (e.g., '@sigil-team', 'team-strit')\ntype Tag = string; // curated list available in code (e.g., 'auth', 'spots')\n\n// For V2 presentations, meta is a Partial<OwnerShipMeta> plus description, name, version\ninterface PresentationV2Meta extends Partial<OwnerShipMeta> {\n  name: string;\n  version: number;\n  description?: string;\n}\n\\`\\`\\`\n\n### Engine\n\nUse \\`createDefaultTransformEngine()\\` and register custom renderers as needed (e.g., high-fidelity BlockNote → Markdown). The default engine supports markdown/json/xml; a React renderer returns a serializable descriptor the host app renders via a \\`componentMap\\` or a BlockNote renderer. The canonical source type string is \\`blocknotejs\\` (not \\`blocknote\\`).\n\nPII paths (JSON-like) are redacted from rendered outputs.\n\n### MCP Integration\n\n\\`createMcpServer\\` accepts \\`presentationsV2\\`. Each descriptor is exposed under \\`presentation://<name>/v<version>\\` and negotiated variants (\\`.md/.json/.xml\\`) are rendered by the engine.\n\n### Migration\n\n- V1 \\`PresentationSpec\\` remains supported; a back-compat helper converts V1 → V2 when convenient.\n- Prefer V2 for new work.\n\n### Examples (Sigil)\n\n- \\`sigil.auth.webauth_tabs_v2\\`: component source (\\`componentKey: 'sigil.webauth.tabs'\\`), targets \\`react/json/xml\\`.\n- \\`sigil.signup.guide_v2\\`: BlockNote doc source, targets \\`react/markdown/json/xml\\`.\n\n### React Rendering\n\nHost apps use a \\`componentMap\\` (e.g., \\`'sigil.webauth.tabs' → WebAuthTabs\\`) and a BlockNote renderer to turn the React render descriptor into elements.`\n}];\nregisterDocBlocks(techContractsDocs);\n\n//#endregion\nexport { techContractsDocs };\n//# sourceMappingURL=tech-contracts.docs.js.map"],"mappings":";;;AAGA,MAAM,oBAAoB,CAAC;CAC1B,IAAI;CACJ,OAAO;CACP,SAAS;CACT,YAAY;CACZ,OAAO;CACP,MAAM;CACN,MAAM;EACL;EACA;EACA;EACA;CACD,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4EN,CAAC;AACF,kBAAkB,kBAAkB"}

package/dist/{track-PgA6pTIr.d.mts → track.d.ts}

@@ -4,4 +4,5 @@ import { LearningJourneyTrackSpec } from "@lssm/module.learning-journey/track-sp
 declare const drillsLanguageBasicsTrack: LearningJourneyTrackSpec;
 declare const drillTracks: LearningJourneyTrackSpec[];
 //#endregion
-export { drillsLanguageBasicsTrack as n, drillTracks as t };
+export { drillTracks, drillsLanguageBasicsTrack };
+//# sourceMappingURL=track.d.ts.map

package/dist/track.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"track.d.ts","names":[],"sources":["../src/track.ts"],"sourcesContent":[],"mappings":";;;cAEa,2BAA2B;cAyD3B,aAAa"}

package/dist/{track-DuxJHlQ1.mjs → track.js}

@@ -62,4 +62,5 @@ const drillsLanguageBasicsTrack = {
 const drillTracks = [drillsLanguageBasicsTrack];
 
 //#endregion
-export { drillsLanguageBasicsTrack as n, drillTracks as t };
+export { drillTracks, drillsLanguageBasicsTrack };
+//# sourceMappingURL=track.js.map

package/dist/track.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"track.js","names":["drillsLanguageBasicsTrack: LearningJourneyTrackSpec","drillTracks: LearningJourneyTrackSpec[]"],"sources":["../src/track.ts"],"sourcesContent":["import type { LearningJourneyTrackSpec } from '@lssm/module.learning-journey/track-spec';\n\nexport const drillsLanguageBasicsTrack: LearningJourneyTrackSpec = {\n  id: 'drills_language_basics',\n  name: 'Language Basics Drills',\n  description:\n    'Short SRS-driven drills to master a first skill, modeled after Duolingo-style sessions.',\n  targetUserSegment: 'learner',\n  targetRole: 'individual',\n  totalXp: 50,\n  completionRewards: { xpBonus: 25 },\n  steps: [\n    {\n      id: 'complete_first_session',\n      title: 'Complete first drill session',\n      description: 'Finish a drill session to get started.',\n      order: 1,\n      completion: {\n        kind: 'event',\n        eventName: 'drill.session.completed',\n      },\n      xpReward: 20,\n      metadata: { surface: 'drills' },\n    },\n    {\n      id: 'reach_accuracy_threshold',\n      title: 'Hit high accuracy in sessions',\n      description: 'Achieve three high-accuracy sessions to build confidence.',\n      order: 2,\n      completion: {\n        kind: 'count',\n        eventName: 'drill.session.completed',\n        atLeast: 3,\n        payloadFilter: { accuracyBucket: 'high' },\n      },\n      xpReward: 30,\n      metadata: { metric: 'accuracy', target: '>=85%' },\n    },\n    {\n      id: 'unlock_new_skill',\n      title: 'Master core cards in first skill',\n      description:\n        'Reach mastery on at least five cards in the first skill to unlock the next one.',\n      order: 3,\n      completion: {\n        kind: 'srs_mastery',\n        eventName: 'drill.card.mastered',\n        minimumMastery: 0.8,\n        requiredCount: 5,\n        skillIdField: 'skillId',\n        masteryField: 'mastery',\n        payloadFilter: { skillId: 'language_basics' },\n      },\n      xpReward: 40,\n      metadata: { surface: 'srs', skill: 'language_basics' },\n    },\n  ],\n};\n\nexport const drillTracks: LearningJourneyTrackSpec[] = [\n  drillsLanguageBasicsTrack,\n];\n"],"mappings":";AAEA,MAAaA,4BAAsD;CACjE,IAAI;CACJ,MAAM;CACN,aACE;CACF,mBAAmB;CACnB,YAAY;CACZ,SAAS;CACT,mBAAmB,EAAE,SAAS,IAAI;CAClC,OAAO;EACL;GACE,IAAI;GACJ,OAAO;GACP,aAAa;GACb,OAAO;GACP,YAAY;IACV,MAAM;IACN,WAAW;IACZ;GACD,UAAU;GACV,UAAU,EAAE,SAAS,UAAU;GAChC;EACD;GACE,IAAI;GACJ,OAAO;GACP,aAAa;GACb,OAAO;GACP,YAAY;IACV,MAAM;IACN,WAAW;IACX,SAAS;IACT,eAAe,EAAE,gBAAgB,QAAQ;IAC1C;GACD,UAAU;GACV,UAAU;IAAE,QAAQ;IAAY,QAAQ;IAAS;GAClD;EACD;GACE,IAAI;GACJ,OAAO;GACP,aACE;GACF,OAAO;GACP,YAAY;IACV,MAAM;IACN,WAAW;IACX,gBAAgB;IAChB,eAAe;IACf,cAAc;IACd,cAAc;IACd,eAAe,EAAE,SAAS,mBAAmB;IAC9C;GACD,UAAU;GACV,UAAU;IAAE,SAAS;IAAO,OAAO;IAAmB;GACvD;EACF;CACF;AAED,MAAaC,cAA0C,CACrD,0BACD"}

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "@lssm/example.learning-journey-duo-drills",
-  "version": "0.0.0-canary-20251217080011",
+  "version": "0.0.0-canary-20251219202229",
   "description": "Drill-based learning journey example with SRS, XP, and streak hooks.",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
-    ".": "./src/index.ts",
-    "./example": "./src/example.ts",
-    "./track": "./src/track.ts",
-    "./docs": "./src/docs/index.ts",
-    "./docs/duo-drills.docblock": "./src/docs/duo-drills.docblock.ts",
+    ".": "./dist/index.js",
+    "./docs": "./dist/docs/index.js",
+    "./docs/duo-drills.docblock": "./dist/docs/duo-drills.docblock.js",
+    "./example": "./dist/example.js",
+    "./track": "./dist/track.js",
     "./*": "./*"
   },
   "scripts": {
@@ -27,14 +27,14 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@lssm/module.learning-journey": "0.0.0-canary-20251217080011",
-    "@lssm/lib.schema": "0.0.0-canary-20251217080011",
-    "@lssm/lib.contracts": "0.0.0-canary-20251217080011"
+    "@lssm/module.learning-journey": "0.0.0-canary-20251219202229",
+    "@lssm/lib.schema": "0.0.0-canary-20251219202229",
+    "@lssm/lib.contracts": "0.0.0-canary-20251219202229"
   },
   "devDependencies": {
-    "@lssm/tool.tsdown": "0.0.0-canary-20251217080011",
-    "@lssm/tool.typescript": "0.0.0-canary-20251217080011",
-    "tsdown": "^0.17.4",
+    "@lssm/tool.tsdown": "0.0.0-canary-20251219202229",
+    "@lssm/tool.typescript": "0.0.0-canary-20251219202229",
+    "tsdown": "^0.18.1",
     "typescript": "^5.9.3"
   },
   "module": "./dist/index.js",
@@ -47,5 +47,6 @@
       "./docs/duo-drills.docblock": "./dist/docs/duo-drills.docblock.js",
       "./*": "./*"
     }
-  }
+  },
+  "license": "MIT"
 }