@contractspec/module.examples 1.46.1 → 1.47.0

package/dist/builtins.js.map

@@ -1 +1 @@
-{"version":3,"file":"builtins.js","names":["EXAMPLE_REGISTRY: readonly ExampleSpec[]"],"sources":["../src/builtins.ts"],"sourcesContent":["import type { ExampleSpec } from '@contractspec/lib.contracts';\n\n// Import manifests ONLY via the side-effect-free `/example` entrypoints.\nimport AgentConsole from '@contractspec/example.agent-console/example';\nimport AiSupportBot from '@contractspec/example.ai-support-bot/example';\nimport AnalyticsDashboard from '@contractspec/example.analytics-dashboard/example';\nimport ContentGeneration from '@contractspec/example.content-generation/example';\nimport CrmPipeline from '@contractspec/example.crm-pipeline/example';\nimport IntegrationHub from '@contractspec/example.integration-hub/example';\nimport IntegrationStripe from '@contractspec/example.integration-stripe/example';\nimport KbUpdatePipeline from '@contractspec/example.kb-update-pipeline/example';\nimport KnowledgeCanon from '@contractspec/example.knowledge-canon/example';\nimport LearningPatterns from '@contractspec/example.learning-patterns/example';\nimport LearningJourneyAmbientCoach from '@contractspec/example.learning-journey-ambient-coach/example';\nimport LearningJourneyCrmOnboarding from '@contractspec/example.learning-journey-crm-onboarding/example';\nimport LearningJourneyDuoDrills from '@contractspec/example.learning-journey-duo-drills/example';\nimport LearningJourneyPlatformTour from '@contractspec/example.learning-journey-platform-tour/example';\nimport LearningJourneyQuestChallenges from '@contractspec/example.learning-journey-quest-challenges/example';\nimport LearningJourneyRegistry from '@contractspec/example.learning-journey-registry/example';\nimport LearningJourneyStudioOnboarding from '@contractspec/example.learning-journey-studio-onboarding/example';\nimport LearningJourneyUiCoaching from '@contractspec/example.learning-journey-ui-coaching/example';\nimport LearningJourneyUiGamified from '@contractspec/example.learning-journey-ui-gamified/example';\nimport LearningJourneyUiOnboarding from '@contractspec/example.learning-journey-ui-onboarding/example';\nimport LearningJourneyUiShared from '@contractspec/example.learning-journey-ui-shared/example';\nimport LifecycleCli from '@contractspec/example.lifecycle-cli/example';\nimport LifecycleDashboard from '@contractspec/example.lifecycle-dashboard/example';\nimport LocaleJurisdictionGate from '@contractspec/example.locale-jurisdiction-gate/example';\nimport Marketplace from '@contractspec/example.marketplace/example';\nimport OpenbankingPowens from '@contractspec/example.openbanking-powens/example';\nimport Personalization from '@contractspec/example.personalization/example';\nimport PolicySafeKnowledgeAssistant from '@contractspec/example.policy-safe-knowledge-assistant/example';\nimport SaasBoilerplate from '@contractspec/example.saas-boilerplate/example';\nimport ServiceBusinessOs from '@contractspec/example.service-business-os/example';\nimport TeamHub from '@contractspec/example.team-hub/example';\nimport VersionedKnowledgeBase from '@contractspec/example.versioned-knowledge-base/example';\nimport WealthSnapshot from '@contractspec/example.wealth-snapshot/example';\nimport WorkflowSystem from '@contractspec/example.workflow-system/example';\n\nexport const EXAMPLE_REGISTRY: readonly ExampleSpec[] = [\n  AgentConsole,\n  AiSupportBot,\n  AnalyticsDashboard,\n  ContentGeneration,\n  CrmPipeline,\n  IntegrationHub,\n  IntegrationStripe,\n  KbUpdatePipeline,\n  KnowledgeCanon,\n  LearningPatterns,\n  LearningJourneyAmbientCoach,\n  LearningJourneyCrmOnboarding,\n  LearningJourneyDuoDrills,\n  LearningJourneyPlatformTour,\n  LearningJourneyQuestChallenges,\n  LearningJourneyRegistry,\n  LearningJourneyStudioOnboarding,\n  LearningJourneyUiCoaching,\n  LearningJourneyUiGamified,\n  LearningJourneyUiOnboarding,\n  LearningJourneyUiShared,\n  LifecycleCli,\n  LifecycleDashboard,\n  LocaleJurisdictionGate,\n  Marketplace,\n  OpenbankingPowens,\n  Personalization,\n  PolicySafeKnowledgeAssistant,\n  SaasBoilerplate,\n  ServiceBusinessOs,\n  TeamHub,\n  VersionedKnowledgeBase,\n  WealthSnapshot,\n  WorkflowSystem,\n];\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsCA,MAAaA,mBAA2C;CACtD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"builtins.js","names":[],"sources":["../src/builtins.ts"],"sourcesContent":["import type { ExampleSpec } from '@contractspec/lib.contracts';\n\n// Import manifests ONLY via the side-effect-free `/example` entrypoints.\nimport AgentConsole from '@contractspec/example.agent-console/example';\nimport AiSupportBot from '@contractspec/example.ai-support-bot/example';\nimport AnalyticsDashboard from '@contractspec/example.analytics-dashboard/example';\nimport ContentGeneration from '@contractspec/example.content-generation/example';\nimport CrmPipeline from '@contractspec/example.crm-pipeline/example';\nimport IntegrationHub from '@contractspec/example.integration-hub/example';\nimport IntegrationStripe from '@contractspec/example.integration-stripe/example';\nimport KbUpdatePipeline from '@contractspec/example.kb-update-pipeline/example';\nimport KnowledgeCanon from '@contractspec/example.knowledge-canon/example';\nimport LearningPatterns from '@contractspec/example.learning-patterns/example';\nimport LearningJourneyAmbientCoach from '@contractspec/example.learning-journey-ambient-coach/example';\nimport LearningJourneyCrmOnboarding from '@contractspec/example.learning-journey-crm-onboarding/example';\nimport LearningJourneyDuoDrills from '@contractspec/example.learning-journey-duo-drills/example';\nimport LearningJourneyPlatformTour from '@contractspec/example.learning-journey-platform-tour/example';\nimport LearningJourneyQuestChallenges from '@contractspec/example.learning-journey-quest-challenges/example';\nimport LearningJourneyRegistry from '@contractspec/example.learning-journey-registry/example';\nimport LearningJourneyStudioOnboarding from '@contractspec/example.learning-journey-studio-onboarding/example';\nimport LearningJourneyUiCoaching from '@contractspec/example.learning-journey-ui-coaching/example';\nimport LearningJourneyUiGamified from '@contractspec/example.learning-journey-ui-gamified/example';\nimport LearningJourneyUiOnboarding from '@contractspec/example.learning-journey-ui-onboarding/example';\nimport LearningJourneyUiShared from '@contractspec/example.learning-journey-ui-shared/example';\nimport LifecycleCli from '@contractspec/example.lifecycle-cli/example';\nimport LifecycleDashboard from '@contractspec/example.lifecycle-dashboard/example';\nimport LocaleJurisdictionGate from '@contractspec/example.locale-jurisdiction-gate/example';\nimport Marketplace from '@contractspec/example.marketplace/example';\nimport OpenbankingPowens from '@contractspec/example.openbanking-powens/example';\nimport Personalization from '@contractspec/example.personalization/example';\nimport PolicySafeKnowledgeAssistant from '@contractspec/example.policy-safe-knowledge-assistant/example';\nimport SaasBoilerplate from '@contractspec/example.saas-boilerplate/example';\nimport ServiceBusinessOs from '@contractspec/example.service-business-os/example';\nimport TeamHub from '@contractspec/example.team-hub/example';\nimport VersionedKnowledgeBase from '@contractspec/example.versioned-knowledge-base/example';\nimport WealthSnapshot from '@contractspec/example.wealth-snapshot/example';\nimport WorkflowSystem from '@contractspec/example.workflow-system/example';\n\nexport const EXAMPLE_REGISTRY: readonly ExampleSpec[] = [\n  AgentConsole,\n  AiSupportBot,\n  AnalyticsDashboard,\n  ContentGeneration,\n  CrmPipeline,\n  IntegrationHub,\n  IntegrationStripe,\n  KbUpdatePipeline,\n  KnowledgeCanon,\n  LearningPatterns,\n  LearningJourneyAmbientCoach,\n  LearningJourneyCrmOnboarding,\n  LearningJourneyDuoDrills,\n  LearningJourneyPlatformTour,\n  LearningJourneyQuestChallenges,\n  LearningJourneyRegistry,\n  LearningJourneyStudioOnboarding,\n  LearningJourneyUiCoaching,\n  LearningJourneyUiGamified,\n  LearningJourneyUiOnboarding,\n  LearningJourneyUiShared,\n  LifecycleCli,\n  LifecycleDashboard,\n  LocaleJurisdictionGate,\n  Marketplace,\n  OpenbankingPowens,\n  Personalization,\n  PolicySafeKnowledgeAssistant,\n  SaasBoilerplate,\n  ServiceBusinessOs,\n  TeamHub,\n  VersionedKnowledgeBase,\n  WealthSnapshot,\n  WorkflowSystem,\n];\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsCA,MAAa,mBAA2C;CACtD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD"}

package/dist/index.d.ts

@@ -1,2 +1,6 @@
 import { EXAMPLE_REGISTRY, ExampleRegistry, getExample, listExamples, searchExamples } from "./registry.js";
-export { EXAMPLE_REGISTRY, ExampleRegistry, getExample, listExamples, searchExamples };
+import { createTemplateTransformEngine, getTemplateEngine, resetTemplateEngine } from "./runtime/engine.js";
+import { TemplateInstaller, TemplateInstallerOptions } from "./runtime/installer.js";
+import { TEMPLATE_REGISTRY, getClonableTemplates, getTemplate, getTemplatesByModule, listTemplates } from "./runtime/registry.js";
+import { TemplateHandlers, TemplateRuntimeProvider, useAgentHandlers, useAnalyticsHandlers, useCrmHandlers, useIntegrationHandlers, useMarketplaceHandlers, useSaasHandlers, useTemplateEngine, useTemplateHandlers, useWorkflowHandlers } from "./runtime/context.js";
+export { EXAMPLE_REGISTRY, ExampleRegistry, TEMPLATE_REGISTRY, TemplateHandlers, TemplateInstaller, TemplateInstallerOptions, TemplateRuntimeProvider, createTemplateTransformEngine, getClonableTemplates, getExample, getTemplate, getTemplateEngine, getTemplatesByModule, listExamples, listTemplates, resetTemplateEngine, searchExamples, useAgentHandlers, useAnalyticsHandlers, useCrmHandlers, useIntegrationHandlers, useMarketplaceHandlers, useSaasHandlers, useTemplateEngine, useTemplateHandlers, useWorkflowHandlers };

package/dist/index.js

@@ -1,3 +1,7 @@
 import { EXAMPLE_REGISTRY, ExampleRegistry, getExample, listExamples, searchExamples } from "./registry.js";
+import { createTemplateTransformEngine, getTemplateEngine, resetTemplateEngine } from "./runtime/engine.js";
+import { TEMPLATE_REGISTRY, getClonableTemplates, getTemplate, getTemplatesByModule, listTemplates } from "./runtime/registry.js";
+import { TemplateInstaller } from "./runtime/installer.js";
+import { TemplateHandlers, TemplateRuntimeProvider, useAgentHandlers, useAnalyticsHandlers, useCrmHandlers, useIntegrationHandlers, useMarketplaceHandlers, useSaasHandlers, useTemplateEngine, useTemplateHandlers, useWorkflowHandlers } from "./runtime/context.js";
 
-export { EXAMPLE_REGISTRY, ExampleRegistry, getExample, listExamples, searchExamples };
+export { EXAMPLE_REGISTRY, ExampleRegistry, TEMPLATE_REGISTRY, TemplateHandlers, TemplateInstaller, TemplateRuntimeProvider, createTemplateTransformEngine, getClonableTemplates, getExample, getTemplate, getTemplateEngine, getTemplatesByModule, listExamples, listTemplates, resetTemplateEngine, searchExamples, useAgentHandlers, useAnalyticsHandlers, useCrmHandlers, useIntegrationHandlers, useMarketplaceHandlers, useSaasHandlers, useTemplateEngine, useTemplateHandlers, useWorkflowHandlers };

package/dist/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","names":["BUILTIN_EXAMPLES","EXAMPLE_REGISTRY: readonly ExampleSpec[]"],"sources":["../src/registry.ts"],"sourcesContent":["import { ExampleRegistry } from '@contractspec/lib.contracts';\nimport type { ExampleSpec } from '@contractspec/lib.contracts';\nimport { EXAMPLE_REGISTRY as BUILTIN_EXAMPLES } from './builtins';\n\n// Export the ExampleRegistry class from contracts\nexport { ExampleRegistry } from '@contractspec/lib.contracts';\n\n// Create a global registry instance populated with builtins\nconst globalRegistry = new ExampleRegistry();\n\n// Register all builtin examples\nfor (const example of BUILTIN_EXAMPLES) {\n  globalRegistry.register(example);\n}\n\n/**\n * Global registry containing all builtin ContractSpec examples.\n * @deprecated Prefer using ExampleRegistry directly for custom registrations.\n */\nexport const EXAMPLE_REGISTRY: readonly ExampleSpec[] = globalRegistry.list();\n\n/**\n * List all registered examples.\n */\nexport function listExamples(): readonly ExampleSpec[] {\n  return globalRegistry.list();\n}\n\n/**\n * Get an example by its key.\n */\nexport function getExample(key: string): ExampleSpec | undefined {\n  return globalRegistry.get(key);\n}\n\n/**\n * Search examples by query (matches key, title, description, tags).\n */\nexport function searchExamples(query: string): ExampleSpec[] {\n  return globalRegistry.search(query);\n}\n"],"mappings":";;;;AAQA,MAAM,iBAAiB,IAAI,iBAAiB;AAG5C,KAAK,MAAM,WAAWA,mBACpB,gBAAe,SAAS,QAAQ;;;;;AAOlC,MAAaC,mBAA2C,eAAe,MAAM;;;;AAK7E,SAAgB,eAAuC;AACrD,QAAO,eAAe,MAAM;;;;;AAM9B,SAAgB,WAAW,KAAsC;AAC/D,QAAO,eAAe,IAAI,IAAI;;;;;AAMhC,SAAgB,eAAe,OAA8B;AAC3D,QAAO,eAAe,OAAO,MAAM"}
+{"version":3,"file":"registry.js","names":["BUILTIN_EXAMPLES"],"sources":["../src/registry.ts"],"sourcesContent":["import { ExampleRegistry } from '@contractspec/lib.contracts';\nimport type { ExampleSpec } from '@contractspec/lib.contracts';\nimport { EXAMPLE_REGISTRY as BUILTIN_EXAMPLES } from './builtins';\n\n// Export the ExampleRegistry class from contracts\nexport { ExampleRegistry } from '@contractspec/lib.contracts';\n\n// Create a global registry instance populated with builtins\nconst globalRegistry = new ExampleRegistry();\n\n// Register all builtin examples\nfor (const example of BUILTIN_EXAMPLES) {\n  globalRegistry.register(example);\n}\n\n/**\n * Global registry containing all builtin ContractSpec examples.\n * @deprecated Prefer using ExampleRegistry directly for custom registrations.\n */\nexport const EXAMPLE_REGISTRY: readonly ExampleSpec[] = globalRegistry.list();\n\n/**\n * List all registered examples.\n */\nexport function listExamples(): readonly ExampleSpec[] {\n  return globalRegistry.list();\n}\n\n/**\n * Get an example by its key.\n */\nexport function getExample(key: string): ExampleSpec | undefined {\n  return globalRegistry.get(key);\n}\n\n/**\n * Search examples by query (matches key, title, description, tags).\n */\nexport function searchExamples(query: string): ExampleSpec[] {\n  return globalRegistry.search(query);\n}\n"],"mappings":";;;;AAQA,MAAM,iBAAiB,IAAI,iBAAiB;AAG5C,KAAK,MAAM,WAAWA,mBACpB,gBAAe,SAAS,QAAQ;;;;;AAOlC,MAAa,mBAA2C,eAAe,MAAM;;;;AAK7E,SAAgB,eAAuC;AACrD,QAAO,eAAe,MAAM;;;;;AAM9B,SAAgB,WAAW,KAAsC;AAC/D,QAAO,eAAe,IAAI,IAAI;;;;;AAMhC,SAAgB,eAAe,OAA8B;AAC3D,QAAO,eAAe,OAAO,MAAM"}

package/dist/runtime/context.d.ts

@@ -0,0 +1,45 @@
+import { TransformEngine } from "@contractspec/lib.contracts/presentations";
+import { AgentHandlers } from "@contractspec/example.agent-console";
+import { SaasHandlers } from "@contractspec/example.saas-boilerplate";
+import { CrmHandlers } from "@contractspec/example.crm-pipeline";
+import { WorkflowHandlers } from "@contractspec/example.workflow-system";
+import { MarketplaceHandlers } from "@contractspec/example.marketplace";
+import { IntegrationHandlers } from "@contractspec/example.integration-hub";
+import { AnalyticsHandlers } from "@contractspec/example.analytics-dashboard";
+import { PropsWithChildren } from "react";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+import { PolicySafeKnowledgeAssistantHandlers } from "@contractspec/example.policy-safe-knowledge-assistant";
+import { TemplateRuntimeProviderProps } from "@contractspec/lib.example-shared-ui";
+
+//#region src/runtime/context.d.ts
+/**
+ * Template-specific handlers created from the runtime database
+ */
+declare class TemplateHandlers {
+  crm: CrmHandlers;
+  saas: SaasHandlers;
+  agent: AgentHandlers;
+  workflow: WorkflowHandlers;
+  marketplace: MarketplaceHandlers;
+  integration: IntegrationHandlers;
+  analytics: AnalyticsHandlers;
+  policySafeKnowledgeAssistant: PolicySafeKnowledgeAssistantHandlers;
+}
+declare function TemplateRuntimeProvider({
+  templateId,
+  projectId,
+  lazy,
+  children
+}: PropsWithChildren<TemplateRuntimeProviderProps>): react_jsx_runtime0.JSX.Element;
+declare function useTemplateEngine(): TransformEngine;
+declare function useTemplateHandlers(): TemplateHandlers;
+declare function useCrmHandlers(): CrmHandlers;
+declare function useSaasHandlers(): SaasHandlers;
+declare function useAgentHandlers(): AgentHandlers;
+declare function useWorkflowHandlers(): WorkflowHandlers;
+declare function useMarketplaceHandlers(): MarketplaceHandlers;
+declare function useIntegrationHandlers(): IntegrationHandlers;
+declare function useAnalyticsHandlers(): AnalyticsHandlers;
+//#endregion
+export { TemplateHandlers, TemplateRuntimeProvider, useAgentHandlers, useAnalyticsHandlers, useCrmHandlers, useIntegrationHandlers, useMarketplaceHandlers, useSaasHandlers, useTemplateEngine, useTemplateHandlers, useWorkflowHandlers };
+//# sourceMappingURL=context.d.ts.map

package/dist/runtime/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","names":[],"sources":["../../src/runtime/context.tsx"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;AA4Ea,cAAA,gBAAA,CAAgB;EACrB,GAAA,EAAA,WAAA;EACC,IAAA,EAAA,YAAA;EACC,KAAA,EAAA,aAAA;EACG,QAAA,EAAA,gBAAA;EACG,WAAA,EAAA,mBAAA;EACA,WAAA,EAAA,mBAAA;EACF,SAAA,EAAA,iBAAA;EACmB,4BAAA,EAAA,oCAAA;;AAGjB,iBAAA,uBAAA,CAAuB;EAAA,UAAA;EAAA,SAAA;EAAA,IAAA;EAAA;AAAA,CAAA,EAKpC,iBALoC,CAKlB,4BALkB,CAAA,CAAA,EAKW,kBAAA,CAAA,GAAA,CAAA,OALX;AACrC,iBA6Sc,iBAAA,CAAA,CA7Sd,EA6SmC,eA7SnC;AACA,iBAiTc,mBAAA,CAAA,CAjTd,EAiTqC,gBAjTrC;AACA,iBAqTc,cAAA,CAAA,CArTd,EAqTgC,WArThC;AACA,iBAyTc,eAAA,CAAA,CAzTd,EAyTiC,YAzTjC;AACmB,iBA6TL,gBAAA,CAAA,CA7TK,EA6Te,aA7Tf;AAAlB,iBAkUa,mBAAA,CAAA,CAlUb,EAkUoC,gBAlUpC;AAA+C,iBAuUlC,sBAAA,CAAA,CAvUkC,EAuUR,mBAvUQ;AAAA,iBA4UlC,sBAAA,CAAA,CA5UkC,EA4UR,mBA5UQ;AAySlC,iBAwCA,oBAAA,CAAA,CAxCqB,EAwCG,iBAxCY"}

package/dist/runtime/context.js

@@ -0,0 +1,328 @@
+'use client';
+
+import { getTemplateEngine } from "./engine.js";
+import { getTemplate } from "./registry.js";
+import { TemplateInstaller } from "./installer.js";
+import "@contractspec/lib.contracts/presentations";
+import { createAgentHandlers } from "@contractspec/example.agent-console";
+import { createSaasHandlers } from "@contractspec/example.saas-boilerplate";
+import { createCrmHandlers } from "@contractspec/example.crm-pipeline";
+import { createWorkflowHandlers } from "@contractspec/example.workflow-system";
+import { createMarketplaceHandlers } from "@contractspec/example.marketplace";
+import { createIntegrationHandlers } from "@contractspec/example.integration-hub";
+import { createAnalyticsHandlers } from "@contractspec/example.analytics-dashboard";
+import { web } from "@contractspec/lib.runtime-sandbox";
+import { useEffect, useMemo, useState } from "react";
+import { ApolloProvider } from "@apollo/client/react";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { createPolicySafeKnowledgeAssistantHandlers } from "@contractspec/example.policy-safe-knowledge-assistant";
+import { TemplateRuntimeContext, useTemplateComponents, useTemplateRuntime } from "@contractspec/lib.example-shared-ui";
+
+//#region src/runtime/context.tsx
+const { LocalRuntimeServices } = web;
+function logBootstrapFailure(error) {
+	console.error(`
+[TemplateRuntime] Bootstrap Failed
+==================================
+
+The runtime failed to initialize. This usually happens because:
+1. The PostgreSQL Web environment (pglite) failed to load
+2. The schema migration failed
+3. The initial seed data could not be inserted
+
+Check the console for specific database errors.
+    `.trim(), error);
+}
+/**
+* Template-specific handlers created from the runtime database
+*/
+var TemplateHandlers = class {
+	crm;
+	saas;
+	agent;
+	workflow;
+	marketplace;
+	integration;
+	analytics;
+	policySafeKnowledgeAssistant;
+};
+function TemplateRuntimeProvider({ templateId, projectId = "default-project", lazy = false, children }) {
+	const [context, setContext] = useState(null);
+	const [error, setError] = useState(null);
+	useEffect(() => {
+		let mounted = true;
+		async function bootstrap() {
+			try {
+				if (lazy) return;
+				const template = getTemplate(templateId);
+				if (!template) throw new Error(`Template not found: ${templateId}`);
+				const runtime = new LocalRuntimeServices();
+				await runtime.init({});
+				const installer = new TemplateInstaller({ runtime });
+				await installer.install(templateId, { projectId });
+				const client = web.createLocalGraphqlClient(runtime);
+				const engine = await getTemplateEngine();
+				const handlers = new TemplateHandlers();
+				handlers.crm = createCrmHandlers(runtime.db);
+				handlers.saas = createSaasHandlers(runtime.db);
+				handlers.agent = createAgentHandlers(runtime.db);
+				handlers.workflow = createWorkflowHandlers(runtime.db);
+				handlers.marketplace = createMarketplaceHandlers(runtime.db);
+				handlers.integration = createIntegrationHandlers(runtime.db);
+				handlers.analytics = createAnalyticsHandlers(runtime.db);
+				handlers.policySafeKnowledgeAssistant = createPolicySafeKnowledgeAssistantHandlers(runtime.db);
+				const fetchData = async (presentationName) => {
+					if (presentationName === "crm-pipeline.dashboard") {
+						const [dealsResult, stages] = await Promise.all([handlers.crm.listDeals({
+							projectId,
+							pipelineId: "pipeline-1",
+							limit: 50
+						}), handlers.crm.getPipelineStages({ pipelineId: "pipeline-1" })]);
+						return {
+							data: {
+								deals: dealsResult.deals,
+								stages,
+								summary: {
+									total: dealsResult.total,
+									totalValue: dealsResult.totalValue
+								}
+							},
+							metadata: {
+								total: dealsResult.total,
+								timestamp: /* @__PURE__ */ new Date(),
+								source: "crm-pipeline"
+							}
+						};
+					}
+					if (presentationName === "crm-pipeline.deal.pipeline") {
+						const [dealsResult, stages] = await Promise.all([handlers.crm.listDeals({
+							projectId,
+							pipelineId: "pipeline-1",
+							limit: 100
+						}), handlers.crm.getPipelineStages({ pipelineId: "pipeline-1" })]);
+						return {
+							data: {
+								deals: dealsResult.deals,
+								stages,
+								total: dealsResult.total,
+								totalValue: dealsResult.totalValue
+							},
+							metadata: {
+								total: dealsResult.total,
+								timestamp: /* @__PURE__ */ new Date(),
+								source: "crm-pipeline"
+							}
+						};
+					}
+					if (presentationName === "saas-boilerplate.dashboard") {
+						const [projectsResult, subscription] = await Promise.all([handlers.saas.listProjects({
+							projectId,
+							limit: 10
+						}), handlers.saas.getSubscription({ projectId })]);
+						return {
+							data: {
+								projects: projectsResult.items,
+								subscription,
+								summary: { totalProjects: projectsResult.total }
+							},
+							metadata: {
+								total: projectsResult.total,
+								timestamp: /* @__PURE__ */ new Date(),
+								source: "saas-boilerplate"
+							}
+						};
+					}
+					if (presentationName === "saas-boilerplate.project.list") {
+						const result = await handlers.saas.listProjects({
+							projectId,
+							limit: 50
+						});
+						return {
+							data: result.items,
+							metadata: {
+								total: result.total,
+								timestamp: /* @__PURE__ */ new Date(),
+								source: "saas-boilerplate"
+							}
+						};
+					}
+					if (presentationName === "saas-boilerplate.billing.settings") return {
+						data: await handlers.saas.getSubscription({ projectId }),
+						metadata: {
+							timestamp: /* @__PURE__ */ new Date(),
+							source: "saas-boilerplate"
+						}
+					};
+					if (presentationName === "agent-console.dashboard") {
+						const [agentsResult, runsResult, toolsResult] = await Promise.all([
+							handlers.agent.listAgents({
+								projectId,
+								organizationId: "demo-org",
+								limit: 10
+							}),
+							handlers.agent.listRuns({
+								projectId,
+								limit: 10
+							}),
+							handlers.agent.listTools({
+								projectId,
+								organizationId: "demo-org",
+								limit: 10
+							})
+						]);
+						return {
+							data: {
+								agents: agentsResult.items,
+								runs: runsResult.items,
+								tools: toolsResult.items,
+								summary: {
+									totalAgents: agentsResult.total,
+									totalRuns: runsResult.total,
+									totalTools: toolsResult.total
+								}
+							},
+							metadata: {
+								timestamp: /* @__PURE__ */ new Date(),
+								source: "agent-console"
+							}
+						};
+					}
+					if (presentationName === "agent-console.agent.list") {
+						const result = await handlers.agent.listAgents({
+							projectId,
+							organizationId: "demo-org",
+							limit: 50
+						});
+						return {
+							data: result.items,
+							metadata: {
+								total: result.total,
+								timestamp: /* @__PURE__ */ new Date(),
+								source: "agent-console"
+							}
+						};
+					}
+					if (presentationName === "agent-console.run.list") {
+						const result = await handlers.agent.listRuns({
+							projectId,
+							limit: 50
+						});
+						return {
+							data: result.items,
+							metadata: {
+								total: result.total,
+								timestamp: /* @__PURE__ */ new Date(),
+								source: "agent-console"
+							}
+						};
+					}
+					if (presentationName === "agent-console.tool.registry") {
+						const result = await handlers.agent.listTools({
+							projectId,
+							organizationId: "demo-org",
+							limit: 50
+						});
+						return {
+							data: result.items,
+							metadata: {
+								total: result.total,
+								timestamp: /* @__PURE__ */ new Date(),
+								source: "agent-console"
+							}
+						};
+					}
+					console.warn(`No data fetcher found for presentation: ${presentationName}`);
+					return {
+						data: null,
+						metadata: {
+							timestamp: /* @__PURE__ */ new Date(),
+							source: "unknown"
+						}
+					};
+				};
+				if (mounted) setContext({
+					template,
+					runtime,
+					installer,
+					client,
+					templateId,
+					projectId,
+					engine,
+					handlers,
+					fetchData
+				});
+			} catch (err) {
+				logBootstrapFailure(err);
+				if (mounted) setError(err instanceof Error ? err : /* @__PURE__ */ new Error("Unknown runtime error"));
+			}
+		}
+		bootstrap();
+		return () => {
+			mounted = false;
+		};
+	}, [
+		templateId,
+		projectId,
+		lazy
+	]);
+	const components = useTemplateComponents(templateId);
+	const contextValue = useMemo(() => {
+		if (!context) return null;
+		return {
+			...context,
+			components
+		};
+	}, [context, components]);
+	if (error) return /* @__PURE__ */ jsxs("div", {
+		className: "rounded border border-red-200 bg-red-50 p-4 text-red-500",
+		children: [/* @__PURE__ */ jsx("h3", {
+			className: "font-bold",
+			children: "Runtime Error"
+		}), /* @__PURE__ */ jsx("pre", {
+			className: "mt-2 overflow-auto text-xs",
+			children: error.message
+		})]
+	});
+	if (!contextValue) return /* @__PURE__ */ jsx("div", {
+		className: "animate-pulse p-12 text-center text-gray-400",
+		children: "Initializing runtime environment..."
+	});
+	return /* @__PURE__ */ jsx(ApolloProvider, {
+		client: contextValue.client,
+		children: /* @__PURE__ */ jsx(TemplateRuntimeContext.Provider, {
+			value: contextValue,
+			children
+		})
+	});
+}
+function useTemplateEngine() {
+	return useTemplateRuntime().engine;
+}
+function useTemplateHandlers() {
+	return useTemplateRuntime().handlers;
+}
+function useCrmHandlers() {
+	return useTemplateHandlers().crm;
+}
+function useSaasHandlers() {
+	return useTemplateHandlers().saas;
+}
+function useAgentHandlers() {
+	return useTemplateHandlers().agent;
+}
+function useWorkflowHandlers() {
+	return useTemplateHandlers().workflow;
+}
+function useMarketplaceHandlers() {
+	return useTemplateHandlers().marketplace;
+}
+function useIntegrationHandlers() {
+	return useTemplateHandlers().integration;
+}
+function useAnalyticsHandlers() {
+	return useTemplateHandlers().analytics;
+}
+
+//#endregion
+export { TemplateHandlers, TemplateRuntimeProvider, useAgentHandlers, useAnalyticsHandlers, useCrmHandlers, useIntegrationHandlers, useMarketplaceHandlers, useSaasHandlers, useTemplateEngine, useTemplateHandlers, useWorkflowHandlers };
+//# sourceMappingURL=context.js.map

package/dist/runtime/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","names":[],"sources":["../../src/runtime/context.tsx"],"sourcesContent":["'use client';\n\nimport { type PropsWithChildren, useEffect, useMemo, useState } from 'react';\nimport { ApolloProvider } from '@apollo/client/react';\nimport { web } from '@contractspec/lib.runtime-sandbox';\n\nconst { LocalRuntimeServices } = web;\n\nimport { type TransformEngine } from '@contractspec/lib.contracts/presentations';\n\n// Import handlers from example packages\nimport {\n  createCrmHandlers,\n  type CrmHandlers,\n} from '@contractspec/example.crm-pipeline';\nimport {\n  createSaasHandlers,\n  type SaasHandlers,\n} from '@contractspec/example.saas-boilerplate';\nimport {\n  createAgentHandlers,\n  type AgentHandlers,\n} from '@contractspec/example.agent-console';\nimport {\n  createWorkflowHandlers,\n  type WorkflowHandlers,\n} from '@contractspec/example.workflow-system';\nimport {\n  createMarketplaceHandlers,\n  type MarketplaceHandlers,\n} from '@contractspec/example.marketplace';\nimport {\n  createIntegrationHandlers,\n  type IntegrationHandlers,\n} from '@contractspec/example.integration-hub';\nimport {\n  createAnalyticsHandlers,\n  type AnalyticsHandlers,\n} from '@contractspec/example.analytics-dashboard';\nimport {\n  createPolicySafeKnowledgeAssistantHandlers,\n  type PolicySafeKnowledgeAssistantHandlers,\n} from '@contractspec/example.policy-safe-knowledge-assistant';\n\nimport { TemplateInstaller } from './installer';\nimport { getTemplate } from './registry';\nimport { getTemplateEngine } from './engine';\n\nimport {\n  TemplateRuntimeContext,\n  type TemplateRuntimeContextValue,\n  type TemplateRuntimeProviderProps,\n  useTemplateRuntime,\n  useTemplateComponents,\n} from '@contractspec/lib.example-shared-ui';\n\nfunction logBootstrapFailure(error: unknown) {\n  console.error(\n    `\n[TemplateRuntime] Bootstrap Failed\n==================================\n\nThe runtime failed to initialize. This usually happens because:\n1. The PostgreSQL Web environment (pglite) failed to load\n2. The schema migration failed\n3. The initial seed data could not be inserted\n\nCheck the console for specific database errors.\n    `.trim(),\n    error\n  );\n}\n\n/**\n * Template-specific handlers created from the runtime database\n */\nexport class TemplateHandlers {\n  crm!: CrmHandlers;\n  saas!: SaasHandlers;\n  agent!: AgentHandlers;\n  workflow!: WorkflowHandlers;\n  marketplace!: MarketplaceHandlers;\n  integration!: IntegrationHandlers;\n  analytics!: AnalyticsHandlers;\n  policySafeKnowledgeAssistant!: PolicySafeKnowledgeAssistantHandlers;\n}\n\nexport function TemplateRuntimeProvider({\n  templateId,\n  projectId = 'default-project',\n  lazy = false,\n  children,\n}: PropsWithChildren<TemplateRuntimeProviderProps>) {\n  const [context, setContext] = useState<TemplateRuntimeContextValue | null>(\n    null\n  );\n  const [error, setError] = useState<Error | null>(null);\n\n  useEffect(() => {\n    let mounted = true;\n\n    async function bootstrap() {\n      try {\n        if (lazy) return;\n\n        // Load definition\n        const template = getTemplate(templateId);\n        if (!template) {\n          throw new Error(`Template not found: ${templateId}`);\n        }\n\n        // Initialize runtime\n        const runtime = new LocalRuntimeServices();\n        await runtime.init({\n          // In real app, we might persist to IndexedDB\n          // dataDir: projectId // If persistence needed\n        });\n\n        // Initialize installer and run migrations/seeds\n        const installer = new TemplateInstaller({ runtime });\n        await installer.install(templateId, { projectId });\n\n        // Create Apollo Client linked to local schema\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        const client = (web as any).createLocalGraphqlClient(runtime);\n\n        // Get or create transform engine\n        const engine = await getTemplateEngine();\n\n        // Initialize Handlers\n        const handlers = new TemplateHandlers();\n        handlers.crm = createCrmHandlers(runtime.db);\n        handlers.saas = createSaasHandlers(runtime.db);\n        handlers.agent = createAgentHandlers(runtime.db);\n        handlers.workflow = createWorkflowHandlers(runtime.db);\n        handlers.marketplace = createMarketplaceHandlers(runtime.db);\n        handlers.integration = createIntegrationHandlers(runtime.db);\n        handlers.analytics = createAnalyticsHandlers(runtime.db);\n        handlers.policySafeKnowledgeAssistant =\n          createPolicySafeKnowledgeAssistantHandlers(runtime.db);\n\n        // Create data fetcher using the initialized handlers\n        const fetchData = async (presentationName: string) => {\n          // CRM Pipeline\n          if (presentationName === 'crm-pipeline.dashboard') {\n            const [dealsResult, stages] = await Promise.all([\n              handlers.crm.listDeals({\n                projectId,\n                pipelineId: 'pipeline-1',\n                limit: 50,\n              }),\n              handlers.crm.getPipelineStages({ pipelineId: 'pipeline-1' }),\n            ]);\n            return {\n              data: {\n                deals: dealsResult.deals,\n                stages,\n                summary: {\n                  total: dealsResult.total,\n                  totalValue: dealsResult.totalValue,\n                },\n              },\n              metadata: {\n                total: dealsResult.total,\n                timestamp: new Date(),\n                source: 'crm-pipeline',\n              },\n            };\n          }\n          if (presentationName === 'crm-pipeline.deal.pipeline') {\n            const [dealsResult, stages] = await Promise.all([\n              handlers.crm.listDeals({\n                projectId,\n                pipelineId: 'pipeline-1',\n                limit: 100,\n              }),\n              handlers.crm.getPipelineStages({ pipelineId: 'pipeline-1' }),\n            ]);\n            return {\n              data: {\n                deals: dealsResult.deals,\n                stages,\n                total: dealsResult.total,\n                totalValue: dealsResult.totalValue,\n              },\n              metadata: {\n                total: dealsResult.total,\n                timestamp: new Date(),\n                source: 'crm-pipeline',\n              },\n            };\n          }\n\n          // SaaS Boilerplate\n          if (presentationName === 'saas-boilerplate.dashboard') {\n            const [projectsResult, subscription] = await Promise.all([\n              handlers.saas.listProjects({ projectId, limit: 10 }),\n              handlers.saas.getSubscription({ projectId }),\n            ]);\n            return {\n              data: {\n                projects: projectsResult.items,\n                subscription,\n                summary: { totalProjects: projectsResult.total },\n              },\n              metadata: {\n                total: projectsResult.total,\n                timestamp: new Date(),\n                source: 'saas-boilerplate',\n              },\n            };\n          }\n          if (presentationName === 'saas-boilerplate.project.list') {\n            const result = await handlers.saas.listProjects({\n              projectId,\n              limit: 50,\n            });\n            return {\n              data: result.items,\n              metadata: {\n                total: result.total,\n                timestamp: new Date(),\n                source: 'saas-boilerplate',\n              },\n            };\n          }\n          if (presentationName === 'saas-boilerplate.billing.settings') {\n            const subscription = await handlers.saas.getSubscription({\n              projectId,\n            });\n            return {\n              data: subscription,\n              metadata: { timestamp: new Date(), source: 'saas-boilerplate' },\n            };\n          }\n\n          // Agent Console\n          if (presentationName === 'agent-console.dashboard') {\n            const [agentsResult, runsResult, toolsResult] = await Promise.all([\n              handlers.agent.listAgents({\n                projectId,\n                organizationId: 'demo-org',\n                limit: 10,\n              }),\n              handlers.agent.listRuns({ projectId, limit: 10 }),\n              handlers.agent.listTools({\n                projectId,\n                organizationId: 'demo-org',\n                limit: 10,\n              }),\n            ]);\n            return {\n              data: {\n                agents: agentsResult.items,\n                runs: runsResult.items,\n                tools: toolsResult.items,\n                summary: {\n                  totalAgents: agentsResult.total,\n                  totalRuns: runsResult.total,\n                  totalTools: toolsResult.total,\n                },\n              },\n              metadata: { timestamp: new Date(), source: 'agent-console' },\n            };\n          }\n          if (presentationName === 'agent-console.agent.list') {\n            const result = await handlers.agent.listAgents({\n              projectId,\n              organizationId: 'demo-org',\n              limit: 50,\n            });\n            return {\n              data: result.items,\n              metadata: {\n                total: result.total,\n                timestamp: new Date(),\n                source: 'agent-console',\n              },\n            };\n          }\n          if (presentationName === 'agent-console.run.list') {\n            const result = await handlers.agent.listRuns({\n              projectId,\n              limit: 50,\n            });\n            return {\n              data: result.items,\n              metadata: {\n                total: result.total,\n                timestamp: new Date(),\n                source: 'agent-console',\n              },\n            };\n          }\n          if (presentationName === 'agent-console.tool.registry') {\n            const result = await handlers.agent.listTools({\n              projectId,\n              organizationId: 'demo-org',\n              limit: 50,\n            });\n            return {\n              data: result.items,\n              metadata: {\n                total: result.total,\n                timestamp: new Date(),\n                source: 'agent-console',\n              },\n            };\n          }\n\n          // Default fallback\n          console.warn(\n            `No data fetcher found for presentation: ${presentationName}`\n          );\n          return {\n            data: null,\n            metadata: { timestamp: new Date(), source: 'unknown' },\n          };\n        };\n\n        if (mounted) {\n          setContext({\n            template,\n            runtime,\n            installer,\n            client,\n            templateId,\n            projectId,\n            engine,\n            handlers,\n            fetchData,\n          });\n        }\n      } catch (err) {\n        logBootstrapFailure(err);\n        if (mounted) {\n          setError(\n            err instanceof Error ? err : new Error('Unknown runtime error')\n          );\n        }\n      }\n    }\n\n    bootstrap();\n\n    return () => {\n      mounted = false;\n    };\n  }, [templateId, projectId, lazy]);\n\n  // Load registered components\n  const components = useTemplateComponents(templateId);\n\n  // Combine context with components\n  const contextValue = useMemo(() => {\n    if (!context) return null;\n    return {\n      ...context,\n      components,\n    };\n  }, [context, components]);\n\n  if (error) {\n    return (\n      <div className=\"rounded border border-red-200 bg-red-50 p-4 text-red-500\">\n        <h3 className=\"font-bold\">Runtime Error</h3>\n        <pre className=\"mt-2 overflow-auto text-xs\">{error.message}</pre>\n      </div>\n    );\n  }\n\n  if (!contextValue) {\n    return (\n      <div className=\"animate-pulse p-12 text-center text-gray-400\">\n        Initializing runtime environment...\n      </div>\n    );\n  }\n\n  return (\n    <ApolloProvider client={contextValue.client}>\n      <TemplateRuntimeContext.Provider value={contextValue}>\n        {children}\n      </TemplateRuntimeContext.Provider>\n    </ApolloProvider>\n  );\n}\n\n// Hook to access the TransformEngine for rendering presentations\nexport function useTemplateEngine(): TransformEngine {\n  return useTemplateRuntime().engine;\n}\n\n// Hook to access the database-backed template handlers\nexport function useTemplateHandlers(): TemplateHandlers {\n  return useTemplateRuntime<TemplateHandlers>().handlers;\n}\n\n// Hook to access CRM-specific handlers\nexport function useCrmHandlers(): CrmHandlers {\n  return useTemplateHandlers().crm;\n}\n\n// Hook to access SaaS-specific handlers\nexport function useSaasHandlers(): SaasHandlers {\n  return useTemplateHandlers().saas;\n}\n\n// Hook to access Agent Console-specific handlers\nexport function useAgentHandlers(): AgentHandlers {\n  return useTemplateHandlers().agent;\n}\n\n// Hook to access Workflow-specific handlers\nexport function useWorkflowHandlers(): WorkflowHandlers {\n  return useTemplateHandlers().workflow;\n}\n\n// Hook to access Marketplace-specific handlers\nexport function useMarketplaceHandlers(): MarketplaceHandlers {\n  return useTemplateHandlers().marketplace;\n}\n\n// Hook to access Integration Hub-specific handlers\nexport function useIntegrationHandlers(): IntegrationHandlers {\n  return useTemplateHandlers().integration;\n}\n\n// Hook to access Analytics Dashboard-specific handlers\nexport function useAnalyticsHandlers(): AnalyticsHandlers {\n  return useTemplateHandlers().analytics;\n}\n\n// End of file\n"],"mappings":"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"}

package/dist/runtime/engine.d.ts

@@ -0,0 +1,19 @@
+import { TransformEngine } from "@contractspec/lib.contracts/presentations";
+
+//#region src/runtime/engine.d.ts
+
+/**
+ * Create a TransformEngine configured for template rendering
+ */
+declare function createTemplateTransformEngine(): TransformEngine;
+/**
+ * Get or create the shared template engine instance
+ */
+declare function getTemplateEngine(): TransformEngine;
+/**
+ * Reset the shared engine (useful for testing)
+ */
+declare function resetTemplateEngine(): void;
+//#endregion
+export { createTemplateTransformEngine, getTemplateEngine, resetTemplateEngine };
+//# sourceMappingURL=engine.d.ts.map

package/dist/runtime/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","names":[],"sources":["../../src/runtime/engine.ts"],"sourcesContent":[],"mappings":";;;;;;;iBA8DgB,6BAAA,CAAA,GAAiC;;;;iBAqEjC,iBAAA,CAAA,GAAqB;;;;iBAUrB,mBAAA,CAAA"}

package/dist/runtime/engine.js

@@ -0,0 +1,81 @@
+import { createDefaultTransformEngine, registerBasicValidation, registerDefaultReactRenderer } from "@contractspec/lib.contracts/presentations";
+import { agentDashboardMarkdownRenderer, agentListMarkdownRenderer, agentListReactRenderer, runListMarkdownRenderer, toolRegistryMarkdownRenderer } from "@contractspec/example.agent-console";
+import { projectListMarkdownRenderer, projectListReactRenderer, saasBillingMarkdownRenderer, saasDashboardMarkdownRenderer } from "@contractspec/example.saas-boilerplate";
+import { crmDashboardMarkdownRenderer, crmPipelineMarkdownRenderer, crmPipelineReactRenderer } from "@contractspec/example.crm-pipeline";
+import { workflowDashboardMarkdownRenderer, workflowDefinitionListMarkdownRenderer, workflowInstanceDetailMarkdownRenderer } from "@contractspec/example.workflow-system";
+import { marketplaceDashboardMarkdownRenderer, orderListMarkdownRenderer, productCatalogMarkdownRenderer } from "@contractspec/example.marketplace";
+import { connectionListMarkdownRenderer, integrationDashboardMarkdownRenderer, syncConfigMarkdownRenderer } from "@contractspec/example.integration-hub";
+import { analyticsDashboardMarkdownRenderer, dashboardListMarkdownRenderer, queryBuilderMarkdownRenderer } from "@contractspec/example.analytics-dashboard";
+
+//#region src/runtime/engine.ts
+/**
+* Template TransformEngine Setup
+*
+* Creates and configures a TransformEngine instance with all template-specific
+* renderers for React and Markdown targets.
+*/
+/**
+* Create a TransformEngine configured for template rendering
+*/
+function createTemplateTransformEngine() {
+	const engine = createDefaultTransformEngine();
+	registerDefaultReactRenderer(engine);
+	registerBasicValidation(engine);
+	registerTemplateRenderers(engine);
+	return engine;
+}
+/**
+* Register all template-specific renderers
+*
+* Custom markdown renderers are registered here and will be tried AFTER
+* the default schema-driven renderer. Each custom renderer is responsible
+* for checking if it handles the specific presentation (via componentKey)
+* and throwing if not, allowing the next renderer in the chain to try.
+*/
+function registerTemplateRenderers(engine) {
+	engine.register(agentListReactRenderer);
+	engine.register(agentListMarkdownRenderer);
+	engine.register(runListMarkdownRenderer);
+	engine.register(toolRegistryMarkdownRenderer);
+	engine.register(agentDashboardMarkdownRenderer);
+	engine.register(projectListReactRenderer);
+	engine.register(projectListMarkdownRenderer);
+	engine.register(saasDashboardMarkdownRenderer);
+	engine.register(saasBillingMarkdownRenderer);
+	engine.register(crmPipelineReactRenderer);
+	engine.register(crmPipelineMarkdownRenderer);
+	engine.register(crmDashboardMarkdownRenderer);
+	engine.register(workflowDashboardMarkdownRenderer);
+	engine.register(workflowDefinitionListMarkdownRenderer);
+	engine.register(workflowInstanceDetailMarkdownRenderer);
+	engine.register(marketplaceDashboardMarkdownRenderer);
+	engine.register(productCatalogMarkdownRenderer);
+	engine.register(orderListMarkdownRenderer);
+	engine.register(integrationDashboardMarkdownRenderer);
+	engine.register(connectionListMarkdownRenderer);
+	engine.register(syncConfigMarkdownRenderer);
+	engine.register(analyticsDashboardMarkdownRenderer);
+	engine.register(dashboardListMarkdownRenderer);
+	engine.register(queryBuilderMarkdownRenderer);
+}
+/**
+* Singleton instance for shared engine
+*/
+let templateEngine = null;
+/**
+* Get or create the shared template engine instance
+*/
+function getTemplateEngine() {
+	if (!templateEngine) templateEngine = createTemplateTransformEngine();
+	return templateEngine;
+}
+/**
+* Reset the shared engine (useful for testing)
+*/
+function resetTemplateEngine() {
+	templateEngine = null;
+}
+
+//#endregion
+export { createTemplateTransformEngine, getTemplateEngine, resetTemplateEngine };
+//# sourceMappingURL=engine.js.map

package/dist/runtime/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","names":[],"sources":["../../src/runtime/engine.ts"],"sourcesContent":["/**\n * Template TransformEngine Setup\n *\n * Creates and configures a TransformEngine instance with all template-specific\n * renderers for React and Markdown targets.\n */\nimport {\n  createDefaultTransformEngine,\n  registerBasicValidation,\n  registerDefaultReactRenderer,\n  type TransformEngine,\n} from '@contractspec/lib.contracts/presentations';\n\n// Import template renderers from example packages\nimport {\n  agentDashboardMarkdownRenderer,\n  agentListMarkdownRenderer,\n  agentListReactRenderer,\n  runListMarkdownRenderer,\n  toolRegistryMarkdownRenderer,\n} from '@contractspec/example.agent-console';\n\nimport {\n  projectListMarkdownRenderer,\n  projectListReactRenderer,\n  saasBillingMarkdownRenderer,\n  saasDashboardMarkdownRenderer,\n} from '@contractspec/example.saas-boilerplate';\n\nimport {\n  crmDashboardMarkdownRenderer,\n  crmPipelineMarkdownRenderer,\n  crmPipelineReactRenderer,\n} from '@contractspec/example.crm-pipeline';\n\nimport {\n  workflowDashboardMarkdownRenderer,\n  workflowDefinitionListMarkdownRenderer,\n  workflowInstanceDetailMarkdownRenderer,\n} from '@contractspec/example.workflow-system';\n\nimport {\n  marketplaceDashboardMarkdownRenderer,\n  orderListMarkdownRenderer,\n  productCatalogMarkdownRenderer,\n} from '@contractspec/example.marketplace';\n\nimport {\n  connectionListMarkdownRenderer,\n  integrationDashboardMarkdownRenderer,\n  syncConfigMarkdownRenderer,\n} from '@contractspec/example.integration-hub';\n\nimport {\n  analyticsDashboardMarkdownRenderer,\n  dashboardListMarkdownRenderer,\n  queryBuilderMarkdownRenderer,\n} from '@contractspec/example.analytics-dashboard';\n\n/**\n * Create a TransformEngine configured for template rendering\n */\nexport function createTemplateTransformEngine(): TransformEngine {\n  const engine = createDefaultTransformEngine();\n\n  // Register default renderers\n  registerDefaultReactRenderer(engine);\n  registerBasicValidation(engine);\n\n  // Register template-specific renderers\n  registerTemplateRenderers(engine);\n\n  return engine;\n}\n\n/**\n * Register all template-specific renderers\n *\n * Custom markdown renderers are registered here and will be tried AFTER\n * the default schema-driven renderer. Each custom renderer is responsible\n * for checking if it handles the specific presentation (via componentKey)\n * and throwing if not, allowing the next renderer in the chain to try.\n */\nfunction registerTemplateRenderers(engine: TransformEngine): void {\n  // Agent Console renderers\n  engine.register(agentListReactRenderer);\n  engine.register(agentListMarkdownRenderer);\n  engine.register(runListMarkdownRenderer);\n  engine.register(toolRegistryMarkdownRenderer);\n  engine.register(agentDashboardMarkdownRenderer);\n\n  // SaaS Boilerplate renderers\n  engine.register(projectListReactRenderer);\n  engine.register(projectListMarkdownRenderer);\n  engine.register(saasDashboardMarkdownRenderer);\n  engine.register(saasBillingMarkdownRenderer);\n\n  // CRM Pipeline renderers\n  engine.register(crmPipelineReactRenderer);\n  engine.register(crmPipelineMarkdownRenderer);\n  engine.register(crmDashboardMarkdownRenderer);\n\n  // Workflow System renderers\n  engine.register(workflowDashboardMarkdownRenderer);\n  engine.register(workflowDefinitionListMarkdownRenderer);\n  engine.register(workflowInstanceDetailMarkdownRenderer);\n\n  // Marketplace renderers\n  engine.register(marketplaceDashboardMarkdownRenderer);\n  engine.register(productCatalogMarkdownRenderer);\n  engine.register(orderListMarkdownRenderer);\n\n  // Integration Hub renderers\n  engine.register(integrationDashboardMarkdownRenderer);\n  engine.register(connectionListMarkdownRenderer);\n  engine.register(syncConfigMarkdownRenderer);\n\n  // Analytics Dashboard renderers\n  engine.register(analyticsDashboardMarkdownRenderer);\n  engine.register(dashboardListMarkdownRenderer);\n  engine.register(queryBuilderMarkdownRenderer);\n}\n\n/**\n * Singleton instance for shared engine\n */\nlet templateEngine: TransformEngine | null = null;\n\n/**\n * Get or create the shared template engine instance\n */\nexport function getTemplateEngine(): TransformEngine {\n  if (!templateEngine) {\n    templateEngine = createTemplateTransformEngine();\n  }\n  return templateEngine;\n}\n\n/**\n * Reset the shared engine (useful for testing)\n */\nexport function resetTemplateEngine(): void {\n  templateEngine = null;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AA8DA,SAAgB,gCAAiD;CAC/D,MAAM,SAAS,8BAA8B;AAG7C,8BAA6B,OAAO;AACpC,yBAAwB,OAAO;AAG/B,2BAA0B,OAAO;AAEjC,QAAO;;;;;;;;;;AAWT,SAAS,0BAA0B,QAA+B;AAEhE,QAAO,SAAS,uBAAuB;AACvC,QAAO,SAAS,0BAA0B;AAC1C,QAAO,SAAS,wBAAwB;AACxC,QAAO,SAAS,6BAA6B;AAC7C,QAAO,SAAS,+BAA+B;AAG/C,QAAO,SAAS,yBAAyB;AACzC,QAAO,SAAS,4BAA4B;AAC5C,QAAO,SAAS,8BAA8B;AAC9C,QAAO,SAAS,4BAA4B;AAG5C,QAAO,SAAS,yBAAyB;AACzC,QAAO,SAAS,4BAA4B;AAC5C,QAAO,SAAS,6BAA6B;AAG7C,QAAO,SAAS,kCAAkC;AAClD,QAAO,SAAS,uCAAuC;AACvD,QAAO,SAAS,uCAAuC;AAGvD,QAAO,SAAS,qCAAqC;AACrD,QAAO,SAAS,+BAA+B;AAC/C,QAAO,SAAS,0BAA0B;AAG1C,QAAO,SAAS,qCAAqC;AACrD,QAAO,SAAS,+BAA+B;AAC/C,QAAO,SAAS,2BAA2B;AAG3C,QAAO,SAAS,mCAAmC;AACnD,QAAO,SAAS,8BAA8B;AAC9C,QAAO,SAAS,6BAA6B;;;;;AAM/C,IAAI,iBAAyC;;;;AAK7C,SAAgB,oBAAqC;AACnD,KAAI,CAAC,eACH,kBAAiB,+BAA+B;AAElD,QAAO;;;;;AAMT,SAAgB,sBAA4B;AAC1C,kBAAiB"}

package/dist/runtime/installer.d.ts

@@ -0,0 +1,40 @@
+import { RegistryTemplateSummary } from "./registry-client.js";
+import { web } from "@contractspec/lib.runtime-sandbox";
+import { InstallTemplateOptions, SaveTemplateOptions, SaveTemplateResult, TemplateDefinition, TemplateFilter, TemplateId } from "@contractspec/lib.example-shared-ui";
+
+//#region src/runtime/installer.d.ts
+declare const LocalRuntimeServices: typeof web.LocalRuntimeServices;
+type LocalRuntimeServices = InstanceType<typeof LocalRuntimeServices>;
+interface TemplateInstallerOptions {
+  runtime?: LocalRuntimeServices;
+  endpoint?: string;
+  /** Optional registry server base URL (enables listing remote/community templates) */
+  registryUrl?: string;
+  fetchImpl?: typeof fetch;
+}
+declare class TemplateInstaller {
+  private readonly runtime;
+  private readonly endpoint;
+  private readonly registryUrl;
+  private readonly fetchImpl;
+  constructor(options?: TemplateInstallerOptions);
+  init(): Promise<void>;
+  list(filter?: TemplateFilter): TemplateDefinition[];
+  /**
+   * List templates published to the ContractSpec Registry.
+   *
+   * Note: this returns *metadata* only. Installing still requires a local template
+   * implementation unless/until we support seeding templates from registry payloads.
+   */
+  listRemoteTemplates(): Promise<RegistryTemplateSummary[]>;
+  /**
+   * Resolve a registry template id to a local TemplateId if available.
+   */
+  resolveLocalTemplateId(id: string): TemplateId | null;
+  get(templateId: TemplateId): TemplateDefinition | undefined;
+  install(templateId: TemplateId, options?: InstallTemplateOptions): Promise<void>;
+  saveToStudio(options: SaveTemplateOptions): Promise<SaveTemplateResult>;
+}
+//#endregion
+export { TemplateInstaller, TemplateInstallerOptions };
+//# sourceMappingURL=installer.d.ts.map

package/dist/runtime/installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installer.d.ts","names":[],"sources":["../../src/runtime/installer.ts"],"sourcesContent":[],"mappings":";;;;;cAiBQ,6BAAoB,GAAA,CAAA;KACvB,oBAAA,GAAuB,oBAAoB;AADxC,UAYS,wBAAA,CAZW;EACvB,OAAA,CAAA,EAYO,oBAZa;EAWR,QAAA,CAAA,EAAA,MAAA;EAQJ;EAMU,WAAA,CAAA,EAAA,MAAA;EASP,SAAA,CAAA,EAAA,OAlBK,KAkBL;;AAIiB,cAnBpB,iBAAA,CAmBoB;EAuBM,iBAAA,OAAA;EAAR,iBAAA,QAAA;EAYO,iBAAA,WAAA;EAKpB,iBAAA,SAAA;EAAa,WAAA,CAAA,OAAA,CAAA,EArDR,wBAqDQ;EAKf,IAAA,CAAA,CAAA,EAjDA,OAiDA,CAAA,IAAA,CAAA;EACH,IAAA,CAAA,MAAA,CAAA,EA9CG,cA8CH,CAAA,EA9CoB,kBA8CpB,EAAA;EACR;;;;;;yBAxB0B,QAAQ;;;;sCAYD;kBAKpB,aAAa;sBAKf,sBACH,yBACR;wBAQQ,sBACR,QAAQ"}

package/dist/runtime/installer.js

@@ -0,0 +1,103 @@
+'use client';
+
+import { TEMPLATE_REGISTRY, getTemplate } from "./registry.js";
+import { ContractSpecRegistryClient } from "./registry-client.js";
+import { web } from "@contractspec/lib.runtime-sandbox";
+
+//#region src/runtime/installer.ts
+const { LocalRuntimeServices } = web;
+const SAVE_TEMPLATE_MUTATION = `
+  mutation SaveTemplateToStudio($input: SaveTemplateInput!) {
+    saveTemplateToStudio(input: $input) {
+      projectId
+      status
+    }
+  }
+`;
+var TemplateInstaller = class {
+	runtime;
+	endpoint;
+	registryUrl;
+	fetchImpl;
+	constructor(options = {}) {
+		this.runtime = options.runtime ?? new LocalRuntimeServices();
+		this.endpoint = options.endpoint ?? "/api/graphql";
+		this.registryUrl = options.registryUrl ? options.registryUrl.replace(/\/+$/, "") : null;
+		this.fetchImpl = options.fetchImpl ?? fetch;
+	}
+	async init() {
+		await this.runtime.init();
+	}
+	list(filter) {
+		return filter ? TEMPLATE_REGISTRY.filter((template) => {
+			if (filter.category && filter.category !== template.category) return false;
+			if (filter.complexity && filter.complexity !== template.complexity) return false;
+			if (filter.tag && !template.tags.includes(filter.tag)) return false;
+			return true;
+		}) : TEMPLATE_REGISTRY;
+	}
+	/**
+	* List templates published to the ContractSpec Registry.
+	*
+	* Note: this returns *metadata* only. Installing still requires a local template
+	* implementation unless/until we support seeding templates from registry payloads.
+	*/
+	async listRemoteTemplates() {
+		if (!this.registryUrl) return [];
+		return await new ContractSpecRegistryClient({
+			registryUrl: this.registryUrl,
+			fetchImpl: this.fetchImpl
+		}).listTemplateSummaries();
+	}
+	/**
+	* Resolve a registry template id to a local TemplateId if available.
+	*/
+	resolveLocalTemplateId(id) {
+		return getTemplate(id) ? id : null;
+	}
+	get(templateId) {
+		return getTemplate(templateId);
+	}
+	async install(templateId, options = {}) {
+		await this.runtime.seedTemplate({
+			templateId,
+			projectId: options.projectId
+		});
+	}
+	async saveToStudio(options) {
+		const payload = toBase64(await this.runtime.db.export());
+		const response = await this.fetchImpl(options.endpoint ?? this.endpoint, {
+			method: "POST",
+			headers: {
+				"Content-Type": "application/json",
+				...options.token ? { Authorization: `Bearer ${options.token}` } : {}
+			},
+			body: JSON.stringify({
+				query: SAVE_TEMPLATE_MUTATION,
+				variables: { input: {
+					templateId: options.templateId,
+					projectName: options.projectName,
+					organizationId: options.organizationId,
+					payload
+				} }
+			})
+		});
+		if (!response.ok) throw new Error(`Failed to save template: ${response.status} ${response.statusText}`);
+		const json = await response.json();
+		if (json.errors?.length) throw new Error(json.errors[0]?.message ?? "Unknown error");
+		if (!json.data?.saveTemplateToStudio) throw new Error("Invalid response from Studio API");
+		return json.data.saveTemplateToStudio;
+	}
+};
+function toBase64(bytes) {
+	if (typeof Buffer !== "undefined") return Buffer.from(bytes).toString("base64");
+	let binary = "";
+	bytes.forEach((value) => {
+		binary += String.fromCharCode(value);
+	});
+	return btoa(binary);
+}
+
+//#endregion
+export { TemplateInstaller };
+//# sourceMappingURL=installer.js.map

package/dist/runtime/installer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"installer.js","names":[],"sources":["../../src/runtime/installer.ts"],"sourcesContent":["'use client';\n\nimport { getTemplate, TEMPLATE_REGISTRY } from './registry';\nimport type {\n  TemplateDefinition,\n  TemplateFilter,\n  TemplateId,\n  InstallTemplateOptions,\n  SaveTemplateOptions,\n  SaveTemplateResult,\n} from '@contractspec/lib.example-shared-ui';\nimport {\n  ContractSpecRegistryClient,\n  type RegistryTemplateSummary,\n} from './registry-client';\nimport { web } from '@contractspec/lib.runtime-sandbox';\n\nconst { LocalRuntimeServices } = web;\ntype LocalRuntimeServices = InstanceType<typeof LocalRuntimeServices>;\n\nconst SAVE_TEMPLATE_MUTATION = `\n  mutation SaveTemplateToStudio($input: SaveTemplateInput!) {\n    saveTemplateToStudio(input: $input) {\n      projectId\n      status\n    }\n  }\n`;\n\nexport interface TemplateInstallerOptions {\n  runtime?: LocalRuntimeServices;\n  endpoint?: string;\n  /** Optional registry server base URL (enables listing remote/community templates) */\n  registryUrl?: string;\n  fetchImpl?: typeof fetch;\n}\n\nexport class TemplateInstaller {\n  private readonly runtime: LocalRuntimeServices;\n  private readonly endpoint: string;\n  private readonly registryUrl: string | null;\n  private readonly fetchImpl: typeof fetch;\n\n  constructor(options: TemplateInstallerOptions = {}) {\n    this.runtime = options.runtime ?? new LocalRuntimeServices();\n    this.endpoint = options.endpoint ?? '/api/graphql';\n    this.registryUrl = options.registryUrl\n      ? options.registryUrl.replace(/\\/+$/, '')\n      : null;\n    this.fetchImpl = options.fetchImpl ?? fetch;\n  }\n\n  async init(): Promise<void> {\n    await this.runtime.init();\n  }\n\n  list(filter?: TemplateFilter): TemplateDefinition[] {\n    return filter\n      ? TEMPLATE_REGISTRY.filter((template) => {\n          if (filter.category && filter.category !== template.category) {\n            return false;\n          }\n          if (filter.complexity && filter.complexity !== template.complexity) {\n            return false;\n          }\n          if (filter.tag && !template.tags.includes(filter.tag)) {\n            return false;\n          }\n          return true;\n        })\n      : TEMPLATE_REGISTRY;\n  }\n\n  /**\n   * List templates published to the ContractSpec Registry.\n   *\n   * Note: this returns *metadata* only. Installing still requires a local template\n   * implementation unless/until we support seeding templates from registry payloads.\n   */\n  async listRemoteTemplates(): Promise<RegistryTemplateSummary[]> {\n    if (!this.registryUrl) return [];\n    const client = new ContractSpecRegistryClient({\n      registryUrl: this.registryUrl,\n      fetchImpl: this.fetchImpl,\n    });\n    return await client.listTemplateSummaries();\n  }\n\n  /**\n   * Resolve a registry template id to a local TemplateId if available.\n   */\n  resolveLocalTemplateId(id: string): TemplateId | null {\n    const found = getTemplate(id as TemplateId);\n    return found ? (id as TemplateId) : null;\n  }\n\n  get(templateId: TemplateId): TemplateDefinition | undefined {\n    return getTemplate(templateId);\n  }\n\n  async install(\n    templateId: TemplateId,\n    options: InstallTemplateOptions = {}\n  ): Promise<void> {\n    await this.runtime.seedTemplate({\n      templateId,\n      projectId: options.projectId,\n    });\n  }\n\n  async saveToStudio(\n    options: SaveTemplateOptions\n  ): Promise<SaveTemplateResult> {\n    const snapshot = await this.runtime.db.export();\n    const payload = toBase64(snapshot);\n    const response = await this.fetchImpl(options.endpoint ?? this.endpoint, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        ...(options.token ? { Authorization: `Bearer ${options.token}` } : {}),\n      },\n      body: JSON.stringify({\n        query: SAVE_TEMPLATE_MUTATION,\n        variables: {\n          input: {\n            templateId: options.templateId,\n            projectName: options.projectName,\n            organizationId: options.organizationId,\n            payload,\n          },\n        },\n      }),\n    });\n\n    if (!response.ok) {\n      throw new Error(\n        `Failed to save template: ${response.status} ${response.statusText}`\n      );\n    }\n\n    const json = (await response.json()) as {\n      data?: {\n        saveTemplateToStudio: SaveTemplateResult;\n      };\n      errors?: { message: string }[];\n    };\n\n    if (json.errors?.length) {\n      throw new Error(json.errors[0]?.message ?? 'Unknown error');\n    }\n\n    if (!json.data?.saveTemplateToStudio) {\n      throw new Error('Invalid response from Studio API');\n    }\n\n    return json.data.saveTemplateToStudio;\n  }\n}\n\nfunction toBase64(bytes: Uint8Array): string {\n  if (typeof Buffer !== 'undefined') {\n    return Buffer.from(bytes).toString('base64');\n  }\n  let binary = '';\n  bytes.forEach((value) => {\n    binary += String.fromCharCode(value);\n  });\n  return btoa(binary);\n}\n"],"mappings":";;;;;;;AAiBA,MAAM,EAAE,yBAAyB;AAGjC,MAAM,yBAAyB;;;;;;;;AAiB/B,IAAa,oBAAb,MAA+B;CAC7B,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CAEjB,YAAY,UAAoC,EAAE,EAAE;AAClD,OAAK,UAAU,QAAQ,WAAW,IAAI,sBAAsB;AAC5D,OAAK,WAAW,QAAQ,YAAY;AACpC,OAAK,cAAc,QAAQ,cACvB,QAAQ,YAAY,QAAQ,QAAQ,GAAG,GACvC;AACJ,OAAK,YAAY,QAAQ,aAAa;;CAGxC,MAAM,OAAsB;AAC1B,QAAM,KAAK,QAAQ,MAAM;;CAG3B,KAAK,QAA+C;AAClD,SAAO,SACH,kBAAkB,QAAQ,aAAa;AACrC,OAAI,OAAO,YAAY,OAAO,aAAa,SAAS,SAClD,QAAO;AAET,OAAI,OAAO,cAAc,OAAO,eAAe,SAAS,WACtD,QAAO;AAET,OAAI,OAAO,OAAO,CAAC,SAAS,KAAK,SAAS,OAAO,IAAI,CACnD,QAAO;AAET,UAAO;IACP,GACF;;;;;;;;CASN,MAAM,sBAA0D;AAC9D,MAAI,CAAC,KAAK,YAAa,QAAO,EAAE;AAKhC,SAAO,MAJQ,IAAI,2BAA2B;GAC5C,aAAa,KAAK;GAClB,WAAW,KAAK;GACjB,CAAC,CACkB,uBAAuB;;;;;CAM7C,uBAAuB,IAA+B;AAEpD,SADc,YAAY,GAAiB,GAC3B,KAAoB;;CAGtC,IAAI,YAAwD;AAC1D,SAAO,YAAY,WAAW;;CAGhC,MAAM,QACJ,YACA,UAAkC,EAAE,EACrB;AACf,QAAM,KAAK,QAAQ,aAAa;GAC9B;GACA,WAAW,QAAQ;GACpB,CAAC;;CAGJ,MAAM,aACJ,SAC6B;EAE7B,MAAM,UAAU,SADC,MAAM,KAAK,QAAQ,GAAG,QAAQ,CACb;EAClC,MAAM,WAAW,MAAM,KAAK,UAAU,QAAQ,YAAY,KAAK,UAAU;GACvE,QAAQ;GACR,SAAS;IACP,gBAAgB;IAChB,GAAI,QAAQ,QAAQ,EAAE,eAAe,UAAU,QAAQ,SAAS,GAAG,EAAE;IACtE;GACD,MAAM,KAAK,UAAU;IACnB,OAAO;IACP,WAAW,EACT,OAAO;KACL,YAAY,QAAQ;KACpB,aAAa,QAAQ;KACrB,gBAAgB,QAAQ;KACxB;KACD,EACF;IACF,CAAC;GACH,CAAC;AAEF,MAAI,CAAC,SAAS,GACZ,OAAM,IAAI,MACR,4BAA4B,SAAS,OAAO,GAAG,SAAS,aACzD;EAGH,MAAM,OAAQ,MAAM,SAAS,MAAM;AAOnC,MAAI,KAAK,QAAQ,OACf,OAAM,IAAI,MAAM,KAAK,OAAO,IAAI,WAAW,gBAAgB;AAG7D,MAAI,CAAC,KAAK,MAAM,qBACd,OAAM,IAAI,MAAM,mCAAmC;AAGrD,SAAO,KAAK,KAAK;;;AAIrB,SAAS,SAAS,OAA2B;AAC3C,KAAI,OAAO,WAAW,YACpB,QAAO,OAAO,KAAK,MAAM,CAAC,SAAS,SAAS;CAE9C,IAAI,SAAS;AACb,OAAM,SAAS,UAAU;AACvB,YAAU,OAAO,aAAa,MAAM;GACpC;AACF,QAAO,KAAK,OAAO"}

package/dist/runtime/registry-client.d.ts

@@ -0,0 +1,14 @@
+import "@contractspec/lib.contracts";
+
+//#region src/runtime/registry-client.d.ts
+interface RegistryTemplateSummary {
+  id: string;
+  title: string;
+  description: string;
+  version: string;
+  tags: string[];
+  source: 'registry';
+}
+//#endregion
+export { RegistryTemplateSummary };
+//# sourceMappingURL=registry-client.d.ts.map

package/dist/runtime/registry-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-client.d.ts","names":[],"sources":["../../src/runtime/registry-client.ts"],"sourcesContent":[],"mappings":";;;UAMiB,uBAAA;;EAAA,KAAA,EAAA,MAAA"}

package/dist/runtime/registry-client.js

@@ -0,0 +1,42 @@
+//#region src/runtime/registry-client.ts
+var ContractSpecRegistryClient = class {
+	baseUrl;
+	fetchImpl;
+	constructor(options) {
+		this.baseUrl = options.registryUrl.replace(/\/+$/, "");
+		this.fetchImpl = options.fetchImpl ?? fetch;
+	}
+	async getManifest() {
+		const res = await this.fetchImpl(`${this.baseUrl}/r/contractspec.json`, {
+			method: "GET",
+			headers: { Accept: "application/json" }
+		});
+		if (!res.ok) throw new Error(`Registry manifest fetch failed: ${res.status} ${res.statusText}`);
+		return await res.json();
+	}
+	async listByType(type) {
+		return (await this.getManifest()).items.filter((i) => i.type === type);
+	}
+	async listTemplateSummaries() {
+		return (await this.listByType("contractspec:template")).map((t) => ({
+			id: t.key,
+			title: t.title,
+			description: t.description,
+			version: t.version,
+			tags: t.meta.tags,
+			source: "registry"
+		}));
+	}
+	async getItem(typeSegment, name) {
+		const res = await this.fetchImpl(`${this.baseUrl}/r/contractspec/${typeSegment}/${name}.json`, {
+			method: "GET",
+			headers: { Accept: "application/json" }
+		});
+		if (!res.ok) throw new Error(`Registry item fetch failed: ${res.status} ${res.statusText}`);
+		return await res.json();
+	}
+};
+
+//#endregion
+export { ContractSpecRegistryClient };
+//# sourceMappingURL=registry-client.js.map

package/dist/runtime/registry-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-client.js","names":[],"sources":["../../src/runtime/registry-client.ts"],"sourcesContent":["import type {\n  ContractRegistryItem,\n  ContractRegistryItemType,\n  ContractRegistryManifest,\n} from '@contractspec/lib.contracts';\n\nexport interface RegistryTemplateSummary {\n  id: string;\n  title: string;\n  description: string;\n  version: string;\n  tags: string[];\n  source: 'registry';\n}\n\nexport interface RegistryClientOptions {\n  registryUrl: string;\n  fetchImpl?: typeof fetch;\n}\n\nexport class ContractSpecRegistryClient {\n  private readonly baseUrl: string;\n  private readonly fetchImpl: typeof fetch;\n\n  constructor(options: RegistryClientOptions) {\n    this.baseUrl = options.registryUrl.replace(/\\/+$/, '');\n    this.fetchImpl = options.fetchImpl ?? fetch;\n  }\n\n  async getManifest(): Promise<ContractRegistryManifest> {\n    const res = await this.fetchImpl(`${this.baseUrl}/r/contractspec.json`, {\n      method: 'GET',\n      headers: { Accept: 'application/json' },\n    });\n    if (!res.ok) {\n      throw new Error(\n        `Registry manifest fetch failed: ${res.status} ${res.statusText}`\n      );\n    }\n    return (await res.json()) as ContractRegistryManifest;\n  }\n\n  async listByType(\n    type: ContractRegistryItemType\n  ): Promise<ContractRegistryItem[]> {\n    const manifest = await this.getManifest();\n    return manifest.items.filter((i) => i.type === type);\n  }\n\n  async listTemplateSummaries(): Promise<RegistryTemplateSummary[]> {\n    const templates = await this.listByType('contractspec:template');\n    return templates.map((t) => ({\n      id: t.key,\n      title: t.title,\n      description: t.description,\n      version: t.version,\n      tags: t.meta.tags,\n      source: 'registry',\n    }));\n  }\n\n  async getItem(\n    typeSegment: string,\n    name: string\n  ): Promise<ContractRegistryItem> {\n    const res = await this.fetchImpl(\n      `${this.baseUrl}/r/contractspec/${typeSegment}/${name}.json`,\n      {\n        method: 'GET',\n        headers: { Accept: 'application/json' },\n      }\n    );\n    if (!res.ok) {\n      throw new Error(\n        `Registry item fetch failed: ${res.status} ${res.statusText}`\n      );\n    }\n    return (await res.json()) as ContractRegistryItem;\n  }\n}\n"],"mappings":";AAoBA,IAAa,6BAAb,MAAwC;CACtC,AAAiB;CACjB,AAAiB;CAEjB,YAAY,SAAgC;AAC1C,OAAK,UAAU,QAAQ,YAAY,QAAQ,QAAQ,GAAG;AACtD,OAAK,YAAY,QAAQ,aAAa;;CAGxC,MAAM,cAAiD;EACrD,MAAM,MAAM,MAAM,KAAK,UAAU,GAAG,KAAK,QAAQ,uBAAuB;GACtE,QAAQ;GACR,SAAS,EAAE,QAAQ,oBAAoB;GACxC,CAAC;AACF,MAAI,CAAC,IAAI,GACP,OAAM,IAAI,MACR,mCAAmC,IAAI,OAAO,GAAG,IAAI,aACtD;AAEH,SAAQ,MAAM,IAAI,MAAM;;CAG1B,MAAM,WACJ,MACiC;AAEjC,UADiB,MAAM,KAAK,aAAa,EACzB,MAAM,QAAQ,MAAM,EAAE,SAAS,KAAK;;CAGtD,MAAM,wBAA4D;AAEhE,UADkB,MAAM,KAAK,WAAW,wBAAwB,EAC/C,KAAK,OAAO;GAC3B,IAAI,EAAE;GACN,OAAO,EAAE;GACT,aAAa,EAAE;GACf,SAAS,EAAE;GACX,MAAM,EAAE,KAAK;GACb,QAAQ;GACT,EAAE;;CAGL,MAAM,QACJ,aACA,MAC+B;EAC/B,MAAM,MAAM,MAAM,KAAK,UACrB,GAAG,KAAK,QAAQ,kBAAkB,YAAY,GAAG,KAAK,QACtD;GACE,QAAQ;GACR,SAAS,EAAE,QAAQ,oBAAoB;GACxC,CACF;AACD,MAAI,CAAC,IAAI,GACP,OAAM,IAAI,MACR,+BAA+B,IAAI,OAAO,GAAG,IAAI,aAClD;AAEH,SAAQ,MAAM,IAAI,MAAM"}

package/dist/runtime/registry.d.ts

@@ -0,0 +1,17 @@
+import { TemplateDefinition, TemplateFilter, TemplateId } from "@contractspec/lib.example-shared-ui";
+
+//#region src/runtime/registry.d.ts
+declare const TEMPLATE_REGISTRY: TemplateDefinition[];
+declare function listTemplates(filter?: TemplateFilter): TemplateDefinition[];
+declare function getTemplate(id: TemplateId): TemplateDefinition | undefined;
+/**
+ * Get templates that use a specific cross-cutting module
+ */
+declare function getTemplatesByModule(modulePackage: string): TemplateDefinition[];
+/**
+ * Get all templates with external packages (clonable via Git)
+ */
+declare function getClonableTemplates(): TemplateDefinition[];
+//#endregion
+export { TEMPLATE_REGISTRY, getClonableTemplates, getTemplate, getTemplatesByModule, listTemplates };
+//# sourceMappingURL=registry.d.ts.map

package/dist/runtime/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","names":[],"sources":["../../src/runtime/registry.ts"],"sourcesContent":[],"mappings":";;;cA2Ea,mBAAmB;iBA4HhB,aAAA,UAAuB,iBAAiB;AA5H3C,iBAiJG,WAAA,CAjJgB,EAAA,EAiJA,UAjJA,CAAA,EAiJa,kBAjJK,GAAA,SAAA;AA4HlD;AAqBA;AAOA;AAWgB,iBAXA,oBAAA,CAWwB,aAAkB,EAAA,MAAA,CAAA,EATvD,kBASuD,EAAA;;;;iBAA1C,oBAAA,CAAA,GAAwB"}

package/dist/runtime/registry.js

@@ -0,0 +1,225 @@
+import { listExamples } from "../registry.js";
+
+//#region src/runtime/registry.ts
+const PRESENTATIONS_BY_TEMPLATE = {
+	"saas-boilerplate": [
+		"saas-boilerplate.dashboard",
+		"saas-boilerplate.project.list",
+		"saas-boilerplate.billing.settings"
+	],
+	"crm-pipeline": ["crm-pipeline.dashboard", "crm-pipeline.deal.pipeline"],
+	"agent-console": [
+		"agent-console.dashboard",
+		"agent-console.agent.list",
+		"agent-console.run.list",
+		"agent-console.tool.registry"
+	],
+	"workflow-system": [
+		"workflow-system.dashboard",
+		"workflow-system.definition.list",
+		"workflow-system.instance.detail"
+	],
+	marketplace: [
+		"marketplace.dashboard",
+		"marketplace.product.catalog",
+		"marketplace.order.list",
+		"marketplace.store.manage"
+	],
+	"integration-hub": [
+		"integration-hub.dashboard",
+		"integration-hub.connection.list",
+		"integration-hub.sync.config"
+	],
+	"analytics-dashboard": [
+		"analytics-dashboard.dashboard",
+		"analytics-dashboard.list",
+		"analytics-dashboard.query.builder"
+	],
+	"learning-journey-studio-onboarding": [
+		"learning.journey.track_list",
+		"learning.journey.track_detail",
+		"learning.journey.progress_widget"
+	],
+	"learning-journey-platform-tour": [
+		"learning.journey.track_list",
+		"learning.journey.track_detail",
+		"learning.journey.progress_widget"
+	],
+	"learning-journey-crm-onboarding": [
+		"learning.journey.track_list",
+		"learning.journey.track_detail",
+		"learning.journey.progress_widget"
+	],
+	"learning-journey-duo-drills": [
+		"learning.journey.track_list",
+		"learning.journey.track_detail",
+		"learning.journey.progress_widget"
+	],
+	"learning-journey-ambient-coach": [
+		"learning.journey.track_list",
+		"learning.journey.track_detail",
+		"learning.journey.progress_widget"
+	],
+	"learning-journey-quest-challenges": [
+		"learning.journey.track_list",
+		"learning.journey.track_detail",
+		"learning.journey.progress_widget"
+	]
+};
+const TEMPLATE_REGISTRY = [
+	{
+		id: "todos-app",
+		name: "To-dos List App",
+		description: "CRUD flows, filtering, priorities, and ceremonies for handing off work across crews.",
+		category: "productivity",
+		complexity: "beginner",
+		icon: "✅",
+		features: [
+			"CRUD tasks",
+			"Filters",
+			"Categories",
+			"Search",
+			"Priorities"
+		],
+		tags: [
+			"tasks",
+			"ops",
+			"starter"
+		],
+		schema: {
+			models: ["Task", "TaskCategory"],
+			contracts: ["template.todos.crud"]
+		},
+		components: {
+			list: "TaskList",
+			detail: "TaskDetailPanel",
+			form: "TaskForm"
+		},
+		preview: { demoUrl: "/sandbox?template=todos-app" },
+		docs: { quickstart: "/docs/templates/todos-app" }
+	},
+	{
+		id: "messaging-app",
+		name: "Messaging Application",
+		description: "Conversation roster, optimistic sending, typing indicators, and delivery telemetry.",
+		category: "communication",
+		complexity: "intermediate",
+		icon: "💬",
+		features: [
+			"Conversations",
+			"Real-time feed",
+			"Typing indicators",
+			"Read receipts"
+		],
+		tags: [
+			"messaging",
+			"realtime",
+			"ws"
+		],
+		schema: {
+			models: [
+				"Conversation",
+				"ConversationParticipant",
+				"Message"
+			],
+			contracts: ["template.messaging.core"]
+		},
+		components: {
+			list: "ConversationList",
+			detail: "MessageThread",
+			form: "MessageComposer"
+		},
+		preview: { demoUrl: "/sandbox?template=messaging-app" },
+		docs: { quickstart: "/docs/templates/messaging-app" }
+	},
+	{
+		id: "recipe-app-i18n",
+		name: "Recipe App (i18n)",
+		description: "Localized browsing experience with bilingual content, categories, and favorites.",
+		category: "content",
+		complexity: "intermediate",
+		icon: "🍲",
+		features: [
+			"i18n",
+			"Favorites",
+			"Categories",
+			"Search",
+			"RTL-ready"
+		],
+		tags: [
+			"content",
+			"i18n",
+			"localization"
+		],
+		schema: {
+			models: [
+				"RecipeCategory",
+				"Recipe",
+				"RecipeIngredient",
+				"RecipeInstruction"
+			],
+			contracts: ["template.recipes.browse"]
+		},
+		components: {
+			list: "RecipeList",
+			detail: "RecipeDetail",
+			form: "RecipeForm"
+		},
+		preview: { demoUrl: "/sandbox?template=recipe-app-i18n" },
+		docs: { quickstart: "/docs/templates/recipe-app-i18n" }
+	},
+	...listExamples().map((example) => {
+		const tags = example.meta.keywords ?? [];
+		const category = tags.some((t) => t.toLowerCase() === "ai") || tags.some((t) => t.toLowerCase() === "assistant") ? "ai" : "business";
+		return {
+			id: example.meta.key,
+			name: example.meta.title ?? example.meta.key,
+			description: example.meta.description ?? "",
+			category,
+			complexity: "beginner",
+			icon: "📦",
+			features: [],
+			tags: [...tags],
+			schema: {
+				models: [],
+				contracts: []
+			},
+			components: {
+				list: "ExampleList",
+				detail: "ExampleDetail"
+			},
+			preview: { demoUrl: `/sandbox?template=${encodeURIComponent(example.meta.key)}` },
+			package: example.entrypoints.packageName,
+			presentations: PRESENTATIONS_BY_TEMPLATE[example.meta.key] ?? [],
+			renderTargets: ["react", "markdown"]
+		};
+	})
+];
+function listTemplates(filter) {
+	if (!filter) return TEMPLATE_REGISTRY;
+	return TEMPLATE_REGISTRY.filter((template) => {
+		if (filter.category && template.category !== filter.category) return false;
+		if (filter.complexity && template.complexity !== filter.complexity) return false;
+		if (filter.tag && !template.tags.some((tag) => tag.toLowerCase() === filter.tag?.toLowerCase())) return false;
+		return true;
+	});
+}
+function getTemplate(id) {
+	return TEMPLATE_REGISTRY.find((template) => template.id === id);
+}
+/**
+* Get templates that use a specific cross-cutting module
+*/
+function getTemplatesByModule(modulePackage) {
+	return TEMPLATE_REGISTRY.filter((template) => template.usesModules?.includes(modulePackage));
+}
+/**
+* Get all templates with external packages (clonable via Git)
+*/
+function getClonableTemplates() {
+	return TEMPLATE_REGISTRY.filter((template) => !!template.package);
+}
+
+//#endregion
+export { TEMPLATE_REGISTRY, getClonableTemplates, getTemplate, getTemplatesByModule, listTemplates };
+//# sourceMappingURL=registry.js.map

package/dist/runtime/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","names":[],"sources":["../../src/runtime/registry.ts"],"sourcesContent":["import { listExamples } from '../registry';\nimport type {\n  TemplateCategory,\n  TemplateComplexity,\n  TemplateDefinition,\n  TemplateId,\n  TemplateFilter,\n} from '@contractspec/lib.example-shared-ui';\n\nconst PRESENTATIONS_BY_TEMPLATE: Record<string, string[]> = {\n  'saas-boilerplate': [\n    'saas-boilerplate.dashboard',\n    'saas-boilerplate.project.list',\n    'saas-boilerplate.billing.settings',\n  ],\n  'crm-pipeline': ['crm-pipeline.dashboard', 'crm-pipeline.deal.pipeline'],\n  'agent-console': [\n    'agent-console.dashboard',\n    'agent-console.agent.list',\n    'agent-console.run.list',\n    'agent-console.tool.registry',\n  ],\n  'workflow-system': [\n    'workflow-system.dashboard',\n    'workflow-system.definition.list',\n    'workflow-system.instance.detail',\n  ],\n  marketplace: [\n    'marketplace.dashboard',\n    'marketplace.product.catalog',\n    'marketplace.order.list',\n    'marketplace.store.manage',\n  ],\n  'integration-hub': [\n    'integration-hub.dashboard',\n    'integration-hub.connection.list',\n    'integration-hub.sync.config',\n  ],\n  'analytics-dashboard': [\n    'analytics-dashboard.dashboard',\n    'analytics-dashboard.list',\n    'analytics-dashboard.query.builder',\n  ],\n  'learning-journey-studio-onboarding': [\n    'learning.journey.track_list',\n    'learning.journey.track_detail',\n    'learning.journey.progress_widget',\n  ],\n  'learning-journey-platform-tour': [\n    'learning.journey.track_list',\n    'learning.journey.track_detail',\n    'learning.journey.progress_widget',\n  ],\n  'learning-journey-crm-onboarding': [\n    'learning.journey.track_list',\n    'learning.journey.track_detail',\n    'learning.journey.progress_widget',\n  ],\n  'learning-journey-duo-drills': [\n    'learning.journey.track_list',\n    'learning.journey.track_detail',\n    'learning.journey.progress_widget',\n  ],\n  'learning-journey-ambient-coach': [\n    'learning.journey.track_list',\n    'learning.journey.track_detail',\n    'learning.journey.progress_widget',\n  ],\n  'learning-journey-quest-challenges': [\n    'learning.journey.track_list',\n    'learning.journey.track_detail',\n    'learning.journey.progress_widget',\n  ],\n};\n\nexport const TEMPLATE_REGISTRY: TemplateDefinition[] = [\n  {\n    id: 'todos-app',\n    name: 'To-dos List App',\n    description:\n      'CRUD flows, filtering, priorities, and ceremonies for handing off work across crews.',\n    category: 'productivity',\n    complexity: 'beginner',\n    icon: '✅',\n    features: ['CRUD tasks', 'Filters', 'Categories', 'Search', 'Priorities'],\n    tags: ['tasks', 'ops', 'starter'],\n    schema: {\n      models: ['Task', 'TaskCategory'],\n      contracts: ['template.todos.crud'],\n    },\n    components: {\n      list: 'TaskList',\n      detail: 'TaskDetailPanel',\n      form: 'TaskForm',\n    },\n    preview: {\n      demoUrl: '/sandbox?template=todos-app',\n    },\n    docs: {\n      quickstart: '/docs/templates/todos-app',\n    },\n  },\n  {\n    id: 'messaging-app',\n    name: 'Messaging Application',\n    description:\n      'Conversation roster, optimistic sending, typing indicators, and delivery telemetry.',\n    category: 'communication',\n    complexity: 'intermediate',\n    icon: '💬',\n    features: [\n      'Conversations',\n      'Real-time feed',\n      'Typing indicators',\n      'Read receipts',\n    ],\n    tags: ['messaging', 'realtime', 'ws'],\n    schema: {\n      models: ['Conversation', 'ConversationParticipant', 'Message'],\n      contracts: ['template.messaging.core'],\n    },\n    components: {\n      list: 'ConversationList',\n      detail: 'MessageThread',\n      form: 'MessageComposer',\n    },\n    preview: {\n      demoUrl: '/sandbox?template=messaging-app',\n    },\n    docs: {\n      quickstart: '/docs/templates/messaging-app',\n    },\n  },\n  {\n    id: 'recipe-app-i18n',\n    name: 'Recipe App (i18n)',\n    description:\n      'Localized browsing experience with bilingual content, categories, and favorites.',\n    category: 'content',\n    complexity: 'intermediate',\n    icon: '🍲',\n    features: ['i18n', 'Favorites', 'Categories', 'Search', 'RTL-ready'],\n    tags: ['content', 'i18n', 'localization'],\n    schema: {\n      models: [\n        'RecipeCategory',\n        'Recipe',\n        'RecipeIngredient',\n        'RecipeInstruction',\n      ],\n      contracts: ['template.recipes.browse'],\n    },\n    components: {\n      list: 'RecipeList',\n      detail: 'RecipeDetail',\n      form: 'RecipeForm',\n    },\n    preview: {\n      demoUrl: '/sandbox?template=recipe-app-i18n',\n    },\n    docs: {\n      quickstart: '/docs/templates/recipe-app-i18n',\n    },\n  },\n  ...listExamples().map((example) => {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- meta.keywords fallback if tags missing\n    const tags = (example.meta as any).keywords ?? [];\n\n    const category: TemplateCategory =\n      tags.some((t: string) => t.toLowerCase() === 'ai') ||\n      tags.some((t: string) => t.toLowerCase() === 'assistant')\n        ? 'ai'\n        : 'business';\n\n    const complexity: TemplateComplexity = 'beginner';\n\n    const icon = '📦';\n\n    return {\n      id: example.meta.key,\n      name: example.meta.title ?? example.meta.key,\n      description: example.meta.description ?? '',\n      category,\n      complexity,\n      icon,\n      features: [],\n      tags: [...tags],\n      schema: { models: [], contracts: [] },\n      components: { list: 'ExampleList', detail: 'ExampleDetail' },\n      preview: {\n        demoUrl: `/sandbox?template=${encodeURIComponent(example.meta.key)}`,\n      },\n      package: example.entrypoints.packageName,\n      presentations: PRESENTATIONS_BY_TEMPLATE[example.meta.key] ?? [],\n      renderTargets: ['react', 'markdown'],\n    } satisfies TemplateDefinition;\n  }),\n];\n\nexport function listTemplates(filter?: TemplateFilter): TemplateDefinition[] {\n  if (!filter) return TEMPLATE_REGISTRY;\n  return TEMPLATE_REGISTRY.filter((template) => {\n    if (filter.category && template.category !== filter.category) {\n      return false;\n    }\n    if (filter.complexity && template.complexity !== filter.complexity) {\n      return false;\n    }\n    if (\n      filter.tag &&\n      !template.tags.some(\n        (tag: string) => tag.toLowerCase() === filter.tag?.toLowerCase()\n      )\n    ) {\n      return false;\n    }\n    return true;\n  });\n}\n\nexport function getTemplate(id: TemplateId): TemplateDefinition | undefined {\n  return TEMPLATE_REGISTRY.find((template) => template.id === id);\n}\n\n/**\n * Get templates that use a specific cross-cutting module\n */\nexport function getTemplatesByModule(\n  modulePackage: string\n): TemplateDefinition[] {\n  return TEMPLATE_REGISTRY.filter((template) =>\n    template.usesModules?.includes(modulePackage)\n  );\n}\n\n/**\n * Get all templates with external packages (clonable via Git)\n */\nexport function getClonableTemplates(): TemplateDefinition[] {\n  return TEMPLATE_REGISTRY.filter((template) => !!template.package);\n}\n"],"mappings":";;;AASA,MAAM,4BAAsD;CAC1D,oBAAoB;EAClB;EACA;EACA;EACD;CACD,gBAAgB,CAAC,0BAA0B,6BAA6B;CACxE,iBAAiB;EACf;EACA;EACA;EACA;EACD;CACD,mBAAmB;EACjB;EACA;EACA;EACD;CACD,aAAa;EACX;EACA;EACA;EACA;EACD;CACD,mBAAmB;EACjB;EACA;EACA;EACD;CACD,uBAAuB;EACrB;EACA;EACA;EACD;CACD,sCAAsC;EACpC;EACA;EACA;EACD;CACD,kCAAkC;EAChC;EACA;EACA;EACD;CACD,mCAAmC;EACjC;EACA;EACA;EACD;CACD,+BAA+B;EAC7B;EACA;EACA;EACD;CACD,kCAAkC;EAChC;EACA;EACA;EACD;CACD,qCAAqC;EACnC;EACA;EACA;EACD;CACF;AAED,MAAa,oBAA0C;CACrD;EACE,IAAI;EACJ,MAAM;EACN,aACE;EACF,UAAU;EACV,YAAY;EACZ,MAAM;EACN,UAAU;GAAC;GAAc;GAAW;GAAc;GAAU;GAAa;EACzE,MAAM;GAAC;GAAS;GAAO;GAAU;EACjC,QAAQ;GACN,QAAQ,CAAC,QAAQ,eAAe;GAChC,WAAW,CAAC,sBAAsB;GACnC;EACD,YAAY;GACV,MAAM;GACN,QAAQ;GACR,MAAM;GACP;EACD,SAAS,EACP,SAAS,+BACV;EACD,MAAM,EACJ,YAAY,6BACb;EACF;CACD;EACE,IAAI;EACJ,MAAM;EACN,aACE;EACF,UAAU;EACV,YAAY;EACZ,MAAM;EACN,UAAU;GACR;GACA;GACA;GACA;GACD;EACD,MAAM;GAAC;GAAa;GAAY;GAAK;EACrC,QAAQ;GACN,QAAQ;IAAC;IAAgB;IAA2B;IAAU;GAC9D,WAAW,CAAC,0BAA0B;GACvC;EACD,YAAY;GACV,MAAM;GACN,QAAQ;GACR,MAAM;GACP;EACD,SAAS,EACP,SAAS,mCACV;EACD,MAAM,EACJ,YAAY,iCACb;EACF;CACD;EACE,IAAI;EACJ,MAAM;EACN,aACE;EACF,UAAU;EACV,YAAY;EACZ,MAAM;EACN,UAAU;GAAC;GAAQ;GAAa;GAAc;GAAU;GAAY;EACpE,MAAM;GAAC;GAAW;GAAQ;GAAe;EACzC,QAAQ;GACN,QAAQ;IACN;IACA;IACA;IACA;IACD;GACD,WAAW,CAAC,0BAA0B;GACvC;EACD,YAAY;GACV,MAAM;GACN,QAAQ;GACR,MAAM;GACP;EACD,SAAS,EACP,SAAS,qCACV;EACD,MAAM,EACJ,YAAY,mCACb;EACF;CACD,GAAG,cAAc,CAAC,KAAK,YAAY;EAEjC,MAAM,OAAQ,QAAQ,KAAa,YAAY,EAAE;EAEjD,MAAM,WACJ,KAAK,MAAM,MAAc,EAAE,aAAa,KAAK,KAAK,IAClD,KAAK,MAAM,MAAc,EAAE,aAAa,KAAK,YAAY,GACrD,OACA;AAMN,SAAO;GACL,IAAI,QAAQ,KAAK;GACjB,MAAM,QAAQ,KAAK,SAAS,QAAQ,KAAK;GACzC,aAAa,QAAQ,KAAK,eAAe;GACzC;GACA,YATqC;GAUrC,MARW;GASX,UAAU,EAAE;GACZ,MAAM,CAAC,GAAG,KAAK;GACf,QAAQ;IAAE,QAAQ,EAAE;IAAE,WAAW,EAAE;IAAE;GACrC,YAAY;IAAE,MAAM;IAAe,QAAQ;IAAiB;GAC5D,SAAS,EACP,SAAS,qBAAqB,mBAAmB,QAAQ,KAAK,IAAI,IACnE;GACD,SAAS,QAAQ,YAAY;GAC7B,eAAe,0BAA0B,QAAQ,KAAK,QAAQ,EAAE;GAChE,eAAe,CAAC,SAAS,WAAW;GACrC;GACD;CACH;AAED,SAAgB,cAAc,QAA+C;AAC3E,KAAI,CAAC,OAAQ,QAAO;AACpB,QAAO,kBAAkB,QAAQ,aAAa;AAC5C,MAAI,OAAO,YAAY,SAAS,aAAa,OAAO,SAClD,QAAO;AAET,MAAI,OAAO,cAAc,SAAS,eAAe,OAAO,WACtD,QAAO;AAET,MACE,OAAO,OACP,CAAC,SAAS,KAAK,MACZ,QAAgB,IAAI,aAAa,KAAK,OAAO,KAAK,aAAa,CACjE,CAED,QAAO;AAET,SAAO;GACP;;AAGJ,SAAgB,YAAY,IAAgD;AAC1E,QAAO,kBAAkB,MAAM,aAAa,SAAS,OAAO,GAAG;;;;;AAMjE,SAAgB,qBACd,eACsB;AACtB,QAAO,kBAAkB,QAAQ,aAC/B,SAAS,aAAa,SAAS,cAAc,CAC9C;;;;;AAMH,SAAgB,uBAA6C;AAC3D,QAAO,kBAAkB,QAAQ,aAAa,CAAC,CAAC,SAAS,QAAQ"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/module.examples",
-  "version": "1.46.1",
+  "version": "1.47.0",
   "description": "Example contract specifications collection",
   "keywords": [
     "contractspec",
@@ -10,8 +10,6 @@
     "typescript"
   ],
   "type": "module",
-  "main": "./dist/index.js",
-  "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
     "dist",
@@ -28,50 +26,53 @@
     "lint": "bun lint:fix",
     "lint:fix": "eslint src --fix",
     "lint:check": "eslint src",
-    "test": "bun run"
+    "test": "bun test"
   },
   "dependencies": {
-    "@contractspec/lib.contracts": "1.46.1",
-    "@contractspec/example.agent-console": "1.46.1",
-    "@contractspec/example.ai-support-bot": "1.46.1",
-    "@contractspec/example.analytics-dashboard": "1.46.1",
-    "@contractspec/example.content-generation": "1.46.1",
-    "@contractspec/example.crm-pipeline": "1.46.1",
-    "@contractspec/example.integration-hub": "1.46.1",
-    "@contractspec/example.integration-stripe": "1.46.1",
-    "@contractspec/example.kb-update-pipeline": "1.46.1",
-    "@contractspec/example.knowledge-canon": "1.46.1",
-    "@contractspec/example.learning-patterns": "1.46.1",
-    "@contractspec/example.learning-journey-ambient-coach": "1.46.1",
-    "@contractspec/example.learning-journey-crm-onboarding": "1.46.1",
-    "@contractspec/example.learning-journey-duo-drills": "1.46.1",
-    "@contractspec/example.learning-journey-platform-tour": "1.46.1",
-    "@contractspec/example.learning-journey-quest-challenges": "1.46.1",
-    "@contractspec/example.learning-journey-registry": "1.46.1",
-    "@contractspec/example.learning-journey-studio-onboarding": "1.46.1",
-    "@contractspec/example.learning-journey-ui-coaching": "1.46.1",
-    "@contractspec/example.learning-journey-ui-gamified": "1.46.1",
-    "@contractspec/example.learning-journey-ui-onboarding": "1.46.1",
-    "@contractspec/example.learning-journey-ui-shared": "1.46.1",
-    "@contractspec/example.lifecycle-cli": "1.46.1",
-    "@contractspec/example.lifecycle-dashboard": "1.46.1",
-    "@contractspec/example.locale-jurisdiction-gate": "1.46.1",
-    "@contractspec/example.marketplace": "1.46.1",
-    "@contractspec/example.openbanking-powens": "1.46.1",
-    "@contractspec/example.personalization": "1.46.1",
-    "@contractspec/example.policy-safe-knowledge-assistant": "1.46.1",
-    "@contractspec/example.saas-boilerplate": "1.46.1",
-    "@contractspec/example.service-business-os": "1.46.1",
-    "@contractspec/example.versioned-knowledge-base": "1.46.1",
-    "@contractspec/example.team-hub": "1.46.1",
-    "@contractspec/example.wealth-snapshot": "1.46.1",
-    "@contractspec/example.workflow-system": "1.46.1",
-    "zod": "^4.1.13"
+    "@apollo/client": "^4.0.12",
+    "@contractspec/example.agent-console": "1.47.0",
+    "@contractspec/example.ai-support-bot": "1.47.0",
+    "@contractspec/example.analytics-dashboard": "1.47.0",
+    "@contractspec/example.content-generation": "1.47.0",
+    "@contractspec/example.crm-pipeline": "1.47.0",
+    "@contractspec/example.integration-hub": "1.47.0",
+    "@contractspec/example.integration-stripe": "1.47.0",
+    "@contractspec/example.kb-update-pipeline": "1.47.0",
+    "@contractspec/example.knowledge-canon": "1.47.0",
+    "@contractspec/example.learning-journey-ambient-coach": "1.47.0",
+    "@contractspec/example.learning-journey-crm-onboarding": "1.47.0",
+    "@contractspec/example.learning-journey-duo-drills": "1.47.0",
+    "@contractspec/example.learning-journey-platform-tour": "1.47.0",
+    "@contractspec/example.learning-journey-quest-challenges": "1.47.0",
+    "@contractspec/example.learning-journey-registry": "1.47.0",
+    "@contractspec/example.learning-journey-studio-onboarding": "1.47.0",
+    "@contractspec/example.learning-journey-ui-coaching": "1.47.0",
+    "@contractspec/example.learning-journey-ui-gamified": "1.47.0",
+    "@contractspec/example.learning-journey-ui-onboarding": "1.47.0",
+    "@contractspec/example.learning-journey-ui-shared": "1.47.0",
+    "@contractspec/example.learning-patterns": "1.47.0",
+    "@contractspec/example.lifecycle-cli": "1.47.0",
+    "@contractspec/example.lifecycle-dashboard": "1.47.0",
+    "@contractspec/example.locale-jurisdiction-gate": "1.47.0",
+    "@contractspec/example.marketplace": "1.47.0",
+    "@contractspec/example.openbanking-powens": "1.47.0",
+    "@contractspec/example.personalization": "1.47.0",
+    "@contractspec/example.policy-safe-knowledge-assistant": "1.47.0",
+    "@contractspec/example.saas-boilerplate": "1.47.0",
+    "@contractspec/example.service-business-os": "1.47.0",
+    "@contractspec/example.team-hub": "1.47.0",
+    "@contractspec/example.versioned-knowledge-base": "1.47.0",
+    "@contractspec/example.wealth-snapshot": "1.47.0",
+    "@contractspec/example.workflow-system": "1.47.0",
+    "@contractspec/lib.contracts": "1.47.0",
+    "@contractspec/lib.example-shared-ui": "1.1.0",
+    "@contractspec/lib.runtime-sandbox": "0.2.0",
+    "zod": "^4.3.5"
   },
   "devDependencies": {
-    "@contractspec/tool.tsdown": "1.46.1",
-    "@contractspec/tool.typescript": "1.46.1",
-    "tsdown": "^0.18.3",
+    "@contractspec/tool.tsdown": "1.47.0",
+    "@contractspec/tool.typescript": "1.47.0",
+    "tsdown": "^0.19.0",
     "typescript": "^5.9.3"
   },
   "exports": {