@lssm/example.learning-journey-quest-challenges 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-B4IVSL73.d.mts → track.d.ts}

@@ -4,4 +4,5 @@ import { LearningJourneyTrackSpec } from "@lssm/module.learning-journey/track-sp
 declare const moneyResetQuestTrack: LearningJourneyTrackSpec;
 declare const questTracks: LearningJourneyTrackSpec[];
 //#endregion
-export { questTracks as n, moneyResetQuestTrack as t };
+export { moneyResetQuestTrack, questTracks };
+//# 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":";;;cAqBa,sBAAsB;cAsDtB,aAAa"}

package/dist/{track-UnyS-rkK.mjs → track.js}

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

package/dist/track.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"track.js","names":["moneyResetQuestTrack: LearningJourneyTrackSpec","questTracks: LearningJourneyTrackSpec[]"],"sources":["../src/track.ts"],"sourcesContent":["import type { LearningJourneyTrackSpec } from '@lssm/module.learning-journey/track-spec';\n\nconst dayStep = (\n  id: string,\n  day: number,\n  eventName: string,\n  description: string\n): LearningJourneyTrackSpec['steps'][number] => ({\n  id,\n  title: `Day ${day}`,\n  description,\n  availability: { unlockOnDay: day },\n  completion: {\n    kind: 'time_window',\n    eventName,\n    withinHoursOfStart: (day + 1) * 24, // allow grace through next day\n  },\n  xpReward: 15,\n  metadata: { day },\n});\n\nexport const moneyResetQuestTrack: LearningJourneyTrackSpec = {\n  id: 'money_reset_7day',\n  name: '7-day Money Reset',\n  description:\n    'Time-bound quest to reset personal finances over a focused week.',\n  targetUserSegment: 'money_user',\n  totalXp: 105,\n  completionRewards: { xpBonus: 30 },\n  steps: [\n    dayStep(\n      'day1_map_accounts',\n      1,\n      'accounts.mapped',\n      'Map bank and card accounts.'\n    ),\n    dayStep(\n      'day2_categorize_transactions',\n      2,\n      'transactions.categorized',\n      'Categorize recent transactions.'\n    ),\n    dayStep(\n      'day3_define_goals',\n      3,\n      'goals.created',\n      'Define at least one savings goal.'\n    ),\n    dayStep(\n      'day4_setup_recurring_savings',\n      4,\n      'recurring_rule.created',\n      'Set a recurring savings rule.'\n    ),\n    dayStep(\n      'day5_review_subscriptions',\n      5,\n      'subscription.flagged_or_cancelled',\n      'Review subscriptions and flag or cancel wasteful ones.'\n    ),\n    dayStep(\n      'day6_plan_emergency',\n      6,\n      'emergency_plan.completed',\n      'Draft an emergency plan and target buffer.'\n    ),\n    dayStep(\n      'day7_review_commit',\n      7,\n      'quest.review.completed',\n      'Review week outcomes and commit to the next month.'\n    ),\n  ],\n};\n\nexport const questTracks: LearningJourneyTrackSpec[] = [moneyResetQuestTrack];\n"],"mappings":";AAEA,MAAM,WACJ,IACA,KACA,WACA,iBAC+C;CAC/C;CACA,OAAO,OAAO;CACd;CACA,cAAc,EAAE,aAAa,KAAK;CAClC,YAAY;EACV,MAAM;EACN;EACA,qBAAqB,MAAM,KAAK;EACjC;CACD,UAAU;CACV,UAAU,EAAE,KAAK;CAClB;AAED,MAAaA,uBAAiD;CAC5D,IAAI;CACJ,MAAM;CACN,aACE;CACF,mBAAmB;CACnB,SAAS;CACT,mBAAmB,EAAE,SAAS,IAAI;CAClC,OAAO;EACL,QACE,qBACA,GACA,mBACA,8BACD;EACD,QACE,gCACA,GACA,4BACA,kCACD;EACD,QACE,qBACA,GACA,iBACA,oCACD;EACD,QACE,gCACA,GACA,0BACA,gCACD;EACD,QACE,6BACA,GACA,qCACA,yDACD;EACD,QACE,uBACA,GACA,4BACA,6CACD;EACD,QACE,sBACA,GACA,0BACA,qDACD;EACF;CACF;AAED,MAAaC,cAA0C,CAAC,qBAAqB"}

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "@lssm/example.learning-journey-quest-challenges",
-  "version": "0.0.0-canary-20251217080011",
+  "version": "0.0.0-canary-20251219202229",
   "description": "Time-bound quest/challenge learning journey example.",
   "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/quest-challenges.docblock": "./src/docs/quest-challenges.docblock.ts",
+    ".": "./dist/index.js",
+    "./docs": "./dist/docs/index.js",
+    "./docs/quest-challenges.docblock": "./dist/docs/quest-challenges.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/quest-challenges.docblock": "./dist/docs/quest-challenges.docblock.js",
       "./*": "./*"
     }
-  }
+  },
+  "license": "MIT"
 }