@contractspec/module.examples 1.44.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Chaman Ventures, SASU
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,21 @@
+# @contractspec/module.examples
+
+Website: https://contractspec.io/
+
+
+Pure, deterministic types and registries for ContractSpec Examples.
+
+## Purpose
+
+This module defines the canonical “Example” shape (metadata + entrypoints) and exposes:
+
+- A registry API to list/search examples
+- Pure validators to enforce minimum required metadata across examples
+
+## Design principles
+
+- No I/O (no filesystem, no network)
+- Deterministic outputs from explicit inputs
+- Strong typing (no `any`)
+
+

package/dist/builtins.d.ts

@@ -0,0 +1,7 @@
+import { ExampleDefinition } from "./types.js";
+
+//#region src/builtins.d.ts
+declare const EXAMPLE_REGISTRY: readonly ExampleDefinition[];
+//#endregion
+export { EXAMPLE_REGISTRY };
+//# sourceMappingURL=builtins.d.ts.map

package/dist/builtins.d.ts.map

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

package/dist/builtins.js

@@ -0,0 +1,76 @@
+import AgentConsole from "@contractspec/example.agent-console/example";
+import AiSupportBot from "@contractspec/example.ai-support-bot/example";
+import AnalyticsDashboard from "@contractspec/example.analytics-dashboard/example";
+import ContentGeneration from "@contractspec/example.content-generation/example";
+import CrmPipeline from "@contractspec/example.crm-pipeline/example";
+import IntegrationHub from "@contractspec/example.integration-hub/example";
+import IntegrationStripe from "@contractspec/example.integration-stripe/example";
+import KbUpdatePipeline from "@contractspec/example.kb-update-pipeline/example";
+import KnowledgeCanon from "@contractspec/example.knowledge-canon/example";
+import LearningPatterns from "@contractspec/example.learning-patterns/example";
+import LearningJourneyAmbientCoach from "@contractspec/example.learning-journey-ambient-coach/example";
+import LearningJourneyCrmOnboarding from "@contractspec/example.learning-journey-crm-onboarding/example";
+import LearningJourneyDuoDrills from "@contractspec/example.learning-journey-duo-drills/example";
+import LearningJourneyPlatformTour from "@contractspec/example.learning-journey-platform-tour/example";
+import LearningJourneyQuestChallenges from "@contractspec/example.learning-journey-quest-challenges/example";
+import LearningJourneyRegistry from "@contractspec/example.learning-journey-registry/example";
+import LearningJourneyStudioOnboarding from "@contractspec/example.learning-journey-studio-onboarding/example";
+import LearningJourneyUiCoaching from "@contractspec/example.learning-journey-ui-coaching/example";
+import LearningJourneyUiGamified from "@contractspec/example.learning-journey-ui-gamified/example";
+import LearningJourneyUiOnboarding from "@contractspec/example.learning-journey-ui-onboarding/example";
+import LearningJourneyUiShared from "@contractspec/example.learning-journey-ui-shared/example";
+import LifecycleCli from "@contractspec/example.lifecycle-cli/example";
+import LifecycleDashboard from "@contractspec/example.lifecycle-dashboard/example";
+import LocaleJurisdictionGate from "@contractspec/example.locale-jurisdiction-gate/example";
+import Marketplace from "@contractspec/example.marketplace/example";
+import OpenbankingPowens from "@contractspec/example.openbanking-powens/example";
+import Personalization from "@contractspec/example.personalization/example";
+import PolicySafeKnowledgeAssistant from "@contractspec/example.policy-safe-knowledge-assistant/example";
+import SaasBoilerplate from "@contractspec/example.saas-boilerplate/example";
+import ServiceBusinessOs from "@contractspec/example.service-business-os/example";
+import TeamHub from "@contractspec/example.team-hub/example";
+import VersionedKnowledgeBase from "@contractspec/example.versioned-knowledge-base/example";
+import WealthSnapshot from "@contractspec/example.wealth-snapshot/example";
+import WorkflowSystem from "@contractspec/example.workflow-system/example";
+
+//#region src/builtins.ts
+const EXAMPLE_REGISTRY = [
+	AgentConsole,
+	AiSupportBot,
+	AnalyticsDashboard,
+	ContentGeneration,
+	CrmPipeline,
+	IntegrationHub,
+	IntegrationStripe,
+	KbUpdatePipeline,
+	KnowledgeCanon,
+	LearningPatterns,
+	LearningJourneyAmbientCoach,
+	LearningJourneyCrmOnboarding,
+	LearningJourneyDuoDrills,
+	LearningJourneyPlatformTour,
+	LearningJourneyQuestChallenges,
+	LearningJourneyRegistry,
+	LearningJourneyStudioOnboarding,
+	LearningJourneyUiCoaching,
+	LearningJourneyUiGamified,
+	LearningJourneyUiOnboarding,
+	LearningJourneyUiShared,
+	LifecycleCli,
+	LifecycleDashboard,
+	LocaleJurisdictionGate,
+	Marketplace,
+	OpenbankingPowens,
+	Personalization,
+	PolicySafeKnowledgeAssistant,
+	SaasBoilerplate,
+	ServiceBusinessOs,
+	TeamHub,
+	VersionedKnowledgeBase,
+	WealthSnapshot,
+	WorkflowSystem
+];
+
+//#endregion
+export { EXAMPLE_REGISTRY };
+//# sourceMappingURL=builtins.js.map

package/dist/builtins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtins.js","names":["EXAMPLE_REGISTRY: readonly ExampleDefinition[]"],"sources":["../src/builtins.ts"],"sourcesContent":["import type { ExampleDefinition } from './types';\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 ExampleDefinition[] = [\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,mBAAiD;CAC5D;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

@@ -0,0 +1,5 @@
+import { ExampleDefinition, ExampleDocRefs, ExampleEntrypoints, ExampleId, ExampleKind, ExampleSandboxMode, ExampleSurfacesSupport, ExampleVisibility } from "./types.js";
+import { EXAMPLE_REGISTRY } from "./builtins.js";
+import { getExample, listExamples, searchExamples } from "./registry.js";
+import { ExampleValidationError, ValidateExamplesResult, validateExamples } from "./validate.js";
+export { EXAMPLE_REGISTRY, ExampleDefinition, ExampleDocRefs, ExampleEntrypoints, ExampleId, ExampleKind, ExampleSandboxMode, ExampleSurfacesSupport, ExampleValidationError, ExampleVisibility, ValidateExamplesResult, getExample, listExamples, searchExamples, validateExamples };

package/dist/index.js

@@ -0,0 +1,5 @@
+import { EXAMPLE_REGISTRY } from "./builtins.js";
+import { getExample, listExamples, searchExamples } from "./registry.js";
+import { validateExamples } from "./validate.js";
+
+export { EXAMPLE_REGISTRY, getExample, listExamples, searchExamples, validateExamples };

package/dist/registry.d.ts

@@ -0,0 +1,10 @@
+import { ExampleDefinition, ExampleId } from "./types.js";
+import { EXAMPLE_REGISTRY } from "./builtins.js";
+
+//#region src/registry.d.ts
+declare function listExamples(): readonly ExampleDefinition[];
+declare function getExample(id: ExampleId): ExampleDefinition | undefined;
+declare function searchExamples(query: string): ExampleDefinition[];
+//#endregion
+export { getExample, listExamples, searchExamples };
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","names":[],"sources":["../src/registry.ts"],"sourcesContent":[],"mappings":";;;;iBAKgB,YAAA,CAAA,YAAyB;AAAzB,iBAIA,UAAA,CAJyB,EAAA,EAIV,SAJU,CAAiB,EAIf,iBAJe,GAAA,SAAA;AAI1C,iBAIA,cAAA,CAJe,KAAY,EAAA,MAAA,CAAA,EAII,iBAJa,EAAA"}

package/dist/registry.js

@@ -0,0 +1,20 @@
+import { EXAMPLE_REGISTRY } from "./builtins.js";
+
+//#region src/registry.ts
+function listExamples() {
+	return EXAMPLE_REGISTRY.slice().sort((a, b) => a.id.localeCompare(b.id));
+}
+function getExample(id) {
+	return EXAMPLE_REGISTRY.find((ex) => ex.id === id);
+}
+function searchExamples(query) {
+	const q = query.toLowerCase().trim();
+	if (!q) return [...listExamples()];
+	return listExamples().filter((ex) => {
+		return `${ex.id} ${ex.title} ${ex.summary} ${ex.tags.join(" ")}`.toLowerCase().includes(q);
+	});
+}
+
+//#endregion
+export { getExample, listExamples, searchExamples };
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","names":[],"sources":["../src/registry.ts"],"sourcesContent":["import type { ExampleDefinition, ExampleId } from './types';\nimport { EXAMPLE_REGISTRY } from './builtins';\n\nexport { EXAMPLE_REGISTRY };\n\nexport function listExamples(): readonly ExampleDefinition[] {\n  return EXAMPLE_REGISTRY.slice().sort((a, b) => a.id.localeCompare(b.id));\n}\n\nexport function getExample(id: ExampleId): ExampleDefinition | undefined {\n  return EXAMPLE_REGISTRY.find((ex) => ex.id === id);\n}\n\nexport function searchExamples(query: string): ExampleDefinition[] {\n  const q = query.toLowerCase().trim();\n  if (!q) return [...listExamples()];\n  return listExamples().filter((ex) => {\n    const hay =\n      `${ex.id} ${ex.title} ${ex.summary} ${ex.tags.join(' ')}`.toLowerCase();\n    return hay.includes(q);\n  });\n}\n"],"mappings":";;;AAKA,SAAgB,eAA6C;AAC3D,QAAO,iBAAiB,OAAO,CAAC,MAAM,GAAG,MAAM,EAAE,GAAG,cAAc,EAAE,GAAG,CAAC;;AAG1E,SAAgB,WAAW,IAA8C;AACvE,QAAO,iBAAiB,MAAM,OAAO,GAAG,OAAO,GAAG;;AAGpD,SAAgB,eAAe,OAAoC;CACjE,MAAM,IAAI,MAAM,aAAa,CAAC,MAAM;AACpC,KAAI,CAAC,EAAG,QAAO,CAAC,GAAG,cAAc,CAAC;AAClC,QAAO,cAAc,CAAC,QAAQ,OAAO;AAGnC,SADE,GAAG,GAAG,GAAG,GAAG,GAAG,MAAM,GAAG,GAAG,QAAQ,GAAG,GAAG,KAAK,KAAK,IAAI,GAAG,aAAa,CAC9D,SAAS,EAAE;GACtB"}

package/dist/types.d.ts

@@ -0,0 +1,53 @@
+//#region src/types.d.ts
+type ExampleId = string;
+type ExampleKind = 'template' | 'workflow' | 'integration' | 'knowledge' | 'blueprint' | 'ui' | 'script' | 'library';
+type ExampleVisibility = 'public' | 'internal' | 'mixed';
+type ExampleSandboxMode = 'playground' | 'specs' | 'builder' | 'markdown' | 'evolution';
+interface ExampleDocRefs {
+  /** Canonical doc route id(s) in DocBlocks registry */
+  rootDocId?: string;
+  goalDocId?: string;
+  usageDocId?: string;
+  referenceDocId?: string;
+  constraintsDocId?: string;
+}
+interface ExampleSurfacesSupport {
+  templates: boolean;
+  sandbox: {
+    enabled: boolean;
+    modes: readonly ExampleSandboxMode[];
+  };
+  studio: {
+    enabled: boolean;
+    /** If true, Studio can create a real project from this example via API. */
+    installable: boolean;
+  };
+  mcp: {
+    enabled: boolean;
+  };
+}
+interface ExampleEntrypoints {
+  /** Package name in the monorepo (workspace) */
+  packageName: string;
+  /** Optional exports from the example package (strings are subpath exports). */
+  feature?: string;
+  presentations?: string;
+  contracts?: string;
+  handlers?: string;
+  ui?: string;
+  docs?: string;
+}
+interface ExampleDefinition {
+  id: ExampleId;
+  title: string;
+  summary: string;
+  tags: readonly string[];
+  kind: ExampleKind;
+  visibility: ExampleVisibility;
+  docs?: ExampleDocRefs;
+  entrypoints: ExampleEntrypoints;
+  surfaces: ExampleSurfacesSupport;
+}
+//#endregion
+export { ExampleDefinition, ExampleDocRefs, ExampleEntrypoints, ExampleId, ExampleKind, ExampleSandboxMode, ExampleSurfacesSupport, ExampleVisibility };
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../src/types.ts"],"sourcesContent":[],"mappings":";KAAY,SAAA;AAAA,KAEA,WAAA,GAFS,UAAA,GAAA,UAAA,GAAA,aAAA,GAAA,WAAA,GAAA,WAAA,GAAA,IAAA,GAAA,QAAA,GAAA,SAAA;AAET,KAUA,iBAAA,GAVW,QAAA,GAAA,UAAA,GAAA,OAAA;AAUX,KAEA,kBAAA,GAFiB,YAAA,GAAA,OAAA,GAAA,SAAA,GAAA,UAAA,GAAA,WAAA;AAEjB,UAOK,cAAA,CAPa;EAOb;EASA,SAAA,CAAA,EAAA,MAAA;EAgBA,SAAA,CAAA,EAAA,MAAA;EAYA,UAAA,CAAA,EAAA,MAAA;EACX,cAAA,CAAA,EAAA,MAAA;EAIE,gBAAA,CAAA,EAAA,MAAA;;AAEC,UAnCQ,sBAAA,CAmCR;EACM,SAAA,EAAA,OAAA;EACH,OAAA,EAAA;IAAsB,OAAA,EAAA,OAAA;oBAjCd;;;;;;;;;;;UAYH,kBAAA;;;;;;;;;;;UAYA,iBAAA;MACX;;;;QAIE;cACM;SACL;eACM;YACH"}

package/dist/validate.d.ts

@@ -0,0 +1,19 @@
+import { ExampleDefinition } from "./types.js";
+
+//#region src/validate.d.ts
+interface ExampleValidationError {
+  exampleId?: string;
+  message: string;
+  path?: string;
+}
+type ValidateExamplesResult = {
+  ok: true;
+  examples: ExampleDefinition[];
+} | {
+  ok: false;
+  errors: ExampleValidationError[];
+};
+declare function validateExamples(examples: ExampleDefinition[]): ValidateExamplesResult;
+//#endregion
+export { ExampleValidationError, ValidateExamplesResult, validateExamples };
+//# sourceMappingURL=validate.d.ts.map

package/dist/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","names":[],"sources":["../src/validate.ts"],"sourcesContent":[],"mappings":";;;UAuDiB,sBAAA;;EAAA,OAAA,EAAA,MAAA;EAML,IAAA,CAAA,EAAA,MAAA;AAIZ;KAJY,sBAAA;;YACc;;;UACD;;iBAET,gBAAA,WACJ,sBACT"}

package/dist/validate.js

@@ -0,0 +1,90 @@
+import { z } from "zod";
+
+//#region src/validate.ts
+const ExampleDefinitionSchema = z.object({
+	id: z.string().min(1),
+	title: z.string().min(1),
+	summary: z.string().min(1),
+	tags: z.array(z.string()).default([]),
+	kind: z.enum([
+		"template",
+		"workflow",
+		"integration",
+		"knowledge",
+		"blueprint",
+		"ui",
+		"script",
+		"library"
+	]),
+	visibility: z.enum([
+		"public",
+		"internal",
+		"mixed"
+	]),
+	docs: z.object({
+		rootDocId: z.string().optional(),
+		goalDocId: z.string().optional(),
+		usageDocId: z.string().optional(),
+		referenceDocId: z.string().optional(),
+		constraintsDocId: z.string().optional()
+	}).optional(),
+	entrypoints: z.object({
+		packageName: z.string().min(1),
+		feature: z.string().optional(),
+		presentations: z.string().optional(),
+		contracts: z.string().optional(),
+		handlers: z.string().optional(),
+		ui: z.string().optional(),
+		docs: z.string().optional()
+	}),
+	surfaces: z.object({
+		templates: z.boolean(),
+		sandbox: z.object({
+			enabled: z.boolean(),
+			modes: z.array(z.enum([
+				"playground",
+				"specs",
+				"builder",
+				"markdown",
+				"evolution"
+			]))
+		}),
+		studio: z.object({
+			enabled: z.boolean(),
+			installable: z.boolean()
+		}),
+		mcp: z.object({ enabled: z.boolean() })
+	})
+});
+function validateExamples(examples) {
+	const errors = [];
+	const seen = /* @__PURE__ */ new Set();
+	for (const example of examples) {
+		if (seen.has(example.id)) {
+			errors.push({
+				exampleId: example.id,
+				message: `Duplicate example id: ${example.id}`
+			});
+			continue;
+		}
+		seen.add(example.id);
+		const parsed = ExampleDefinitionSchema.safeParse(example);
+		if (!parsed.success) for (const issue of parsed.error.issues) errors.push({
+			exampleId: example.id,
+			message: issue.message,
+			path: issue.path.join(".")
+		});
+	}
+	if (errors.length) return {
+		ok: false,
+		errors
+	};
+	return {
+		ok: true,
+		examples
+	};
+}
+
+//#endregion
+export { validateExamples };
+//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","names":["errors: ExampleValidationError[]"],"sources":["../src/validate.ts"],"sourcesContent":["import { z } from 'zod';\nimport type { ExampleDefinition } from './types';\n\nconst ExampleDefinitionSchema = z.object({\n  id: z.string().min(1),\n  title: z.string().min(1),\n  summary: z.string().min(1),\n  tags: z.array(z.string()).default([]),\n  kind: z.enum([\n    'template',\n    'workflow',\n    'integration',\n    'knowledge',\n    'blueprint',\n    'ui',\n    'script',\n    'library',\n  ]),\n  visibility: z.enum(['public', 'internal', 'mixed']),\n  docs: z\n    .object({\n      rootDocId: z.string().optional(),\n      goalDocId: z.string().optional(),\n      usageDocId: z.string().optional(),\n      referenceDocId: z.string().optional(),\n      constraintsDocId: z.string().optional(),\n    })\n    .optional(),\n  entrypoints: z.object({\n    packageName: z.string().min(1),\n    feature: z.string().optional(),\n    presentations: z.string().optional(),\n    contracts: z.string().optional(),\n    handlers: z.string().optional(),\n    ui: z.string().optional(),\n    docs: z.string().optional(),\n  }),\n  surfaces: z.object({\n    templates: z.boolean(),\n    sandbox: z.object({\n      enabled: z.boolean(),\n      modes: z.array(\n        z.enum(['playground', 'specs', 'builder', 'markdown', 'evolution'])\n      ),\n    }),\n    studio: z.object({\n      enabled: z.boolean(),\n      installable: z.boolean(),\n    }),\n    mcp: z.object({\n      enabled: z.boolean(),\n    }),\n  }),\n});\n\nexport interface ExampleValidationError {\n  exampleId?: string;\n  message: string;\n  path?: string;\n}\n\nexport type ValidateExamplesResult =\n  | { ok: true; examples: ExampleDefinition[] }\n  | { ok: false; errors: ExampleValidationError[] };\n\nexport function validateExamples(\n  examples: ExampleDefinition[]\n): ValidateExamplesResult {\n  const errors: ExampleValidationError[] = [];\n\n  const seen = new Set<string>();\n  for (const example of examples) {\n    if (seen.has(example.id)) {\n      errors.push({\n        exampleId: example.id,\n        message: `Duplicate example id: ${example.id}`,\n      });\n      continue;\n    }\n    seen.add(example.id);\n\n    const parsed = ExampleDefinitionSchema.safeParse(example);\n    if (!parsed.success) {\n      for (const issue of parsed.error.issues) {\n        errors.push({\n          exampleId: example.id,\n          message: issue.message,\n          path: issue.path.join('.'),\n        });\n      }\n    }\n  }\n\n  if (errors.length) return { ok: false, errors };\n  return { ok: true, examples };\n}\n"],"mappings":";;;AAGA,MAAM,0BAA0B,EAAE,OAAO;CACvC,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE;CACrB,OAAO,EAAE,QAAQ,CAAC,IAAI,EAAE;CACxB,SAAS,EAAE,QAAQ,CAAC,IAAI,EAAE;CAC1B,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC;CACrC,MAAM,EAAE,KAAK;EACX;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD,CAAC;CACF,YAAY,EAAE,KAAK;EAAC;EAAU;EAAY;EAAQ,CAAC;CACnD,MAAM,EACH,OAAO;EACN,WAAW,EAAE,QAAQ,CAAC,UAAU;EAChC,WAAW,EAAE,QAAQ,CAAC,UAAU;EAChC,YAAY,EAAE,QAAQ,CAAC,UAAU;EACjC,gBAAgB,EAAE,QAAQ,CAAC,UAAU;EACrC,kBAAkB,EAAE,QAAQ,CAAC,UAAU;EACxC,CAAC,CACD,UAAU;CACb,aAAa,EAAE,OAAO;EACpB,aAAa,EAAE,QAAQ,CAAC,IAAI,EAAE;EAC9B,SAAS,EAAE,QAAQ,CAAC,UAAU;EAC9B,eAAe,EAAE,QAAQ,CAAC,UAAU;EACpC,WAAW,EAAE,QAAQ,CAAC,UAAU;EAChC,UAAU,EAAE,QAAQ,CAAC,UAAU;EAC/B,IAAI,EAAE,QAAQ,CAAC,UAAU;EACzB,MAAM,EAAE,QAAQ,CAAC,UAAU;EAC5B,CAAC;CACF,UAAU,EAAE,OAAO;EACjB,WAAW,EAAE,SAAS;EACtB,SAAS,EAAE,OAAO;GAChB,SAAS,EAAE,SAAS;GACpB,OAAO,EAAE,MACP,EAAE,KAAK;IAAC;IAAc;IAAS;IAAW;IAAY;IAAY,CAAC,CACpE;GACF,CAAC;EACF,QAAQ,EAAE,OAAO;GACf,SAAS,EAAE,SAAS;GACpB,aAAa,EAAE,SAAS;GACzB,CAAC;EACF,KAAK,EAAE,OAAO,EACZ,SAAS,EAAE,SAAS,EACrB,CAAC;EACH,CAAC;CACH,CAAC;AAYF,SAAgB,iBACd,UACwB;CACxB,MAAMA,SAAmC,EAAE;CAE3C,MAAM,uBAAO,IAAI,KAAa;AAC9B,MAAK,MAAM,WAAW,UAAU;AAC9B,MAAI,KAAK,IAAI,QAAQ,GAAG,EAAE;AACxB,UAAO,KAAK;IACV,WAAW,QAAQ;IACnB,SAAS,yBAAyB,QAAQ;IAC3C,CAAC;AACF;;AAEF,OAAK,IAAI,QAAQ,GAAG;EAEpB,MAAM,SAAS,wBAAwB,UAAU,QAAQ;AACzD,MAAI,CAAC,OAAO,QACV,MAAK,MAAM,SAAS,OAAO,MAAM,OAC/B,QAAO,KAAK;GACV,WAAW,QAAQ;GACnB,SAAS,MAAM;GACf,MAAM,MAAM,KAAK,KAAK,IAAI;GAC3B,CAAC;;AAKR,KAAI,OAAO,OAAQ,QAAO;EAAE,IAAI;EAAO;EAAQ;AAC/C,QAAO;EAAE,IAAI;EAAM;EAAU"}

package/package.json

@@ -0,0 +1,87 @@
+{
+  "name": "@contractspec/module.examples",
+  "version": "1.44.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
+    "publish:pkg:canary": "bun publish:pkg --tag canary",
+    "build": "bun build:types && bun build:bundle",
+    "build:bundle": "tsdown",
+    "build:types": "tsc --noEmit",
+    "dev": "bun build:bundle --watch",
+    "clean": "rimraf dist .turbo",
+    "lint": "bun lint:fix",
+    "lint:fix": "eslint src --fix",
+    "lint:check": "eslint src",
+    "test": "bun run"
+  },
+  "dependencies": {
+    "@contractspec/example.agent-console": "1.44.0",
+    "@contractspec/example.ai-support-bot": "1.44.0",
+    "@contractspec/example.analytics-dashboard": "1.44.0",
+    "@contractspec/example.content-generation": "1.44.0",
+    "@contractspec/example.crm-pipeline": "1.44.0",
+    "@contractspec/example.integration-hub": "1.44.0",
+    "@contractspec/example.integration-stripe": "1.44.0",
+    "@contractspec/example.kb-update-pipeline": "1.44.0",
+    "@contractspec/example.knowledge-canon": "1.44.0",
+    "@contractspec/example.learning-patterns": "1.44.0",
+    "@contractspec/example.learning-journey-ambient-coach": "1.44.0",
+    "@contractspec/example.learning-journey-crm-onboarding": "1.44.0",
+    "@contractspec/example.learning-journey-duo-drills": "1.44.0",
+    "@contractspec/example.learning-journey-platform-tour": "1.44.0",
+    "@contractspec/example.learning-journey-quest-challenges": "1.44.0",
+    "@contractspec/example.learning-journey-registry": "1.44.0",
+    "@contractspec/example.learning-journey-studio-onboarding": "1.44.0",
+    "@contractspec/example.learning-journey-ui-coaching": "1.44.0",
+    "@contractspec/example.learning-journey-ui-gamified": "1.44.0",
+    "@contractspec/example.learning-journey-ui-onboarding": "1.44.0",
+    "@contractspec/example.learning-journey-ui-shared": "1.44.0",
+    "@contractspec/example.lifecycle-cli": "1.44.0",
+    "@contractspec/example.lifecycle-dashboard": "1.44.0",
+    "@contractspec/example.locale-jurisdiction-gate": "1.44.0",
+    "@contractspec/example.marketplace": "1.44.0",
+    "@contractspec/example.openbanking-powens": "1.44.0",
+    "@contractspec/example.personalization": "1.44.0",
+    "@contractspec/example.policy-safe-knowledge-assistant": "1.44.0",
+    "@contractspec/example.saas-boilerplate": "1.44.0",
+    "@contractspec/example.service-business-os": "1.44.0",
+    "@contractspec/example.versioned-knowledge-base": "1.44.0",
+    "@contractspec/example.team-hub": "1.44.0",
+    "@contractspec/example.wealth-snapshot": "1.44.0",
+    "@contractspec/example.workflow-system": "1.44.0",
+    "zod": "^4.1.13"
+  },
+  "devDependencies": {
+    "@contractspec/tool.tsdown": "1.44.0",
+    "@contractspec/tool.typescript": "1.44.0",
+    "tsdown": "^0.18.3",
+    "typescript": "^5.9.3"
+  },
+  "exports": {
+    ".": "./dist/index.js",
+    "./*": "./*"
+  },
+  "publishConfig": {
+    "access": "public",
+    "exports": {
+      ".": "./dist/index.js",
+      "./*": "./*"
+    },
+    "registry": "https://registry.npmjs.org/"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lssm-tech/contractspec.git",
+    "directory": "packages/modules/contractspec-examples"
+  },
+  "homepage": "https://contractspec.io"
+}