@contractspec/lib.contracts 1.44.1 → 1.45.0

package/dist/examples/docs/examples.docblock.d.ts

@@ -0,0 +1,6 @@
+import { DocBlock } from "@contractspec/lib.contracts/docs";
+
+//#region src/examples/docs/examples.docblock.d.ts
+declare const tech_contracts_examples_DocBlocks: DocBlock[];
+//#endregion
+export { tech_contracts_examples_DocBlocks };

package/dist/examples/docs/examples.docblock.js

@@ -0,0 +1,165 @@
+import { registerDocBlocks } from "../../docs/registry.js";
+
+//#region src/examples/docs/examples.docblock.ts
+const tech_contracts_examples_DocBlocks = [{
+	id: "docs.tech.contracts.examples",
+	title: "Example Specifications",
+	summary: "ExampleSpec defines complete, demonstrable ContractSpec applications.",
+	kind: "reference",
+	visibility: "public",
+	route: "/docs/tech/contracts/examples",
+	tags: [
+		"tech",
+		"contracts",
+		"examples",
+		"templates"
+	],
+	body: `## Example Specifications
+
+ExampleSpec is a contract for defining complete, demonstrable ContractSpec applications. Examples integrate with AppBlueprintSpec and FeatureModuleSpec to provide a full application specification.
+
+### Overview
+
+An \`ExampleSpec\` captures:
+- **Metadata** (via \`ExampleMeta\` extending \`OwnerShipMeta\`): key, version, title, description, ownership, tags, stability
+- **Example-specific fields**: kind, visibility, summary
+- **Surfaces**: where the example can be used (templates, sandbox, studio, MCP)
+- **Entrypoints**: package exports mapping
+- **Blueprint**: optional AppBlueprintSpec or reference
+- **Features**: optional FeatureModuleSpec array or references
+
+### Usage
+
+\`\`\`typescript
+import type { ExampleSpec } from '@contractspec/lib.contracts';
+import { ExampleRegistry, validateExample } from '@contractspec/lib.contracts';
+
+const example: ExampleSpec = {
+  meta: {
+    key: 'saas-boilerplate',
+    version: '1.0.0',
+    title: 'SaaS Boilerplate',
+    description: 'Multi-tenant SaaS foundation with billing and RBAC.',
+    kind: 'template',
+    visibility: 'public',
+    stability: 'experimental',
+    owners: ['@saas-team'],
+    tags: ['saas', 'multi-tenant', 'billing'],
+    summary: 'Complete SaaS starter.',
+  },
+  surfaces: {
+    templates: true,
+    sandbox: { enabled: true, modes: ['playground', 'specs', 'builder'] },
+    studio: { enabled: true, installable: true },
+    mcp: { enabled: true },
+  },
+  entrypoints: {
+    packageName: '@contractspec/example.saas-boilerplate',
+    feature: './saas-boilerplate.feature',
+    contracts: './contracts',
+  },
+  features: [SaasBoilerplateFeature],
+};
+\`\`\`
+
+### ExampleRegistry
+
+Use \`ExampleRegistry\` to manage examples:
+
+\`\`\`typescript
+const registry = new ExampleRegistry();
+registry.register(example);
+
+// Query examples
+registry.listByKind('template');
+registry.listByVisibility('public');
+registry.listBySurface('studio');
+registry.listInstallable();
+registry.search('billing');
+\`\`\`
+
+### ExampleMeta
+
+\`ExampleMeta\` extends \`OwnerShipMeta\` with example-specific fields:
+
+| Field | Type | Description |
+|-------|------|-------------|
+| key | string | Unique identifier |
+| version | number | Spec version |
+| title | string? | Human-readable title |
+| description | string | Technical description |
+| kind | ExampleKind | template, workflow, integration, etc. |
+| visibility | ExampleVisibility | public, internal, experimental |
+| stability | Stability | idea, experimental, beta, stable, deprecated |
+| owners | string[] | Owner identifiers |
+| tags | string[] | Discovery tags |
+| summary | string? | Marketing summary |
+
+### ExampleKind
+
+| Kind | Use Case |
+|------|----------|
+| template | Full application template |
+| workflow | Workflow automation example |
+| integration | Integration showcase |
+| knowledge | Knowledge base example |
+| blueprint | App blueprint example |
+| ui | UI component showcase |
+| script | CLI/script example |
+| library | Library/SDK example |
+
+### Surfaces
+
+| Surface | Purpose |
+|---------|---------|
+| templates | Available as new project template |
+| sandbox | Interactive playground support |
+| studio | ContractSpec Studio support |
+| mcp | Model Context Protocol support |
+
+### Validation
+
+\`\`\`typescript
+import { validateExample, validateExamples } from '@contractspec/lib.contracts';
+
+const result = validateExample(example);
+if (!result.valid) {
+  console.error(result.errors);
+}
+
+// Batch validation with duplicate detection
+const batchResult = validateExamples([example1, example2]);
+\`\`\`
+
+### Integration with Blueprints and Features
+
+Examples can reference or embed blueprints and features:
+
+\`\`\`typescript
+const example: ExampleSpec = {
+  // ... meta, surfaces, entrypoints
+  
+  // Inline blueprint
+  blueprint: myAppBlueprint,
+  
+  // Or reference by pointer
+  blueprint: { key: 'core.app', version: '1.0.0' },
+  
+  // Inline features
+  features: [MyFeature],
+  
+  // Or reference
+  features: [{ key: 'my-feature' }],
+};
+\`\`\`
+
+### Related
+
+- [App Configuration](file:///docs/tech/contracts/app-config) - AppBlueprintSpec
+- [Features](file:///docs/tech/contracts/features) - FeatureModuleSpec
+`
+}];
+registerDocBlocks(tech_contracts_examples_DocBlocks);
+
+//#endregion
+export { tech_contracts_examples_DocBlocks };

package/dist/examples/index.d.ts

@@ -0,0 +1,5 @@
+import { ExampleDocumentation, ExampleEntrypoints, ExampleKind, ExampleKindEnum, ExampleMcpSupport, ExampleMeta, ExampleSandboxMode, ExampleSandboxModeEnum, ExampleSandboxSupport, ExampleSpec, ExampleStudioSupport, ExampleSurfaces, ExampleVisibility, ExampleVisibilityEnum, isExampleKind, isExampleVisibility, isFeatureRef, isSpecPointer } from "./types.js";
+import { ExampleDocumentationSchema, ExampleEntrypointsSchema, ExampleKindSchema, ExampleMetaSchema, ExampleSandboxModeSchema, ExampleSpecSchema, ExampleSurfacesSchema, ExampleVisibilitySchema, parseExampleDocumentation, parseExampleEntrypoints, parseExampleMeta, parseExampleSpec, parseExampleSurfaces, safeParseExampleSpec } from "./schema.js";
+import { ExampleRegistry } from "./registry.js";
+import { CrossValidationContext, ExampleValidationError, ExampleValidationWarning, ValidateExampleResult, ValidateExamplesResult, validateExample, validateExampleReferences, validateExamples } from "./validation.js";
+export { type CrossValidationContext, type ExampleDocumentation, ExampleDocumentationSchema, type ExampleEntrypoints, ExampleEntrypointsSchema, type ExampleKind, ExampleKindEnum, ExampleKindSchema, type ExampleMcpSupport, type ExampleMeta, ExampleMetaSchema, ExampleRegistry, type ExampleSandboxMode, ExampleSandboxModeEnum, ExampleSandboxModeSchema, type ExampleSandboxSupport, type ExampleSpec, ExampleSpecSchema, type ExampleStudioSupport, type ExampleSurfaces, ExampleSurfacesSchema, type ExampleValidationError, type ExampleValidationWarning, type ExampleVisibility, ExampleVisibilityEnum, ExampleVisibilitySchema, type ValidateExampleResult, type ValidateExamplesResult, isExampleKind, isExampleVisibility, isFeatureRef, isSpecPointer, parseExampleDocumentation, parseExampleEntrypoints, parseExampleMeta, parseExampleSpec, parseExampleSurfaces, safeParseExampleSpec, validateExample, validateExampleReferences, validateExamples };

package/dist/examples/index.js

@@ -0,0 +1,6 @@
+import { ExampleKindEnum, ExampleSandboxModeEnum, ExampleVisibilityEnum, isExampleKind, isExampleVisibility, isFeatureRef, isSpecPointer } from "./types.js";
+import { ExampleDocumentationSchema, ExampleEntrypointsSchema, ExampleKindSchema, ExampleMetaSchema, ExampleSandboxModeSchema, ExampleSpecSchema, ExampleSurfacesSchema, ExampleVisibilitySchema, parseExampleDocumentation, parseExampleEntrypoints, parseExampleMeta, parseExampleSpec, parseExampleSurfaces, safeParseExampleSpec } from "./schema.js";
+import { ExampleRegistry } from "./registry.js";
+import { validateExample, validateExampleReferences, validateExamples } from "./validation.js";
+
+export { ExampleDocumentationSchema, ExampleEntrypointsSchema, ExampleKindEnum, ExampleKindSchema, ExampleMetaSchema, ExampleRegistry, ExampleSandboxModeEnum, ExampleSandboxModeSchema, ExampleSpecSchema, ExampleSurfacesSchema, ExampleVisibilityEnum, ExampleVisibilitySchema, isExampleKind, isExampleVisibility, isFeatureRef, isSpecPointer, parseExampleDocumentation, parseExampleEntrypoints, parseExampleMeta, parseExampleSpec, parseExampleSurfaces, safeParseExampleSpec, validateExample, validateExampleReferences, validateExamples };

package/dist/examples/registry.d.ts

@@ -0,0 +1,65 @@
+import { GroupKeyFn, RegistryFilter } from "../registry-utils.js";
+import { ExampleKind, ExampleSpec, ExampleVisibility } from "./types.js";
+
+//#region src/examples/registry.d.ts
+
+/**
+ * In-memory registry for ExampleSpec.
+ *
+ * Provides methods for registering, querying, and filtering examples.
+ *
+ * @example
+ * ```typescript
+ * const registry = new ExampleRegistry();
+ * registry.register(saasBoilerplateExample);
+ * registry.register(workflowSystemExample);
+ *
+ * const templates = registry.listByKind('template');
+ * const publicExamples = registry.listByVisibility('public');
+ * ```
+ */
+declare class ExampleRegistry {
+  private items;
+  /** Register an example. Throws when the key already exists. */
+  register(spec: ExampleSpec): this;
+  /** List all registered examples. */
+  list(): ExampleSpec[];
+  /** Get an example by its key. */
+  get(key: string, version?: string): ExampleSpec | undefined;
+  /** Check if an example with the given key exists. */
+  has(key: string, version?: string): boolean;
+  /** Get the number of registered examples. */
+  get size(): number;
+  /** Clear all registered examples. */
+  clear(): void;
+  /** Filter examples by criteria. */
+  filter(criteria: RegistryFilter): ExampleSpec[];
+  /** List examples by kind. */
+  listByKind(kind: ExampleKind): ExampleSpec[];
+  /** List examples by visibility. */
+  listByVisibility(visibility: ExampleVisibility): ExampleSpec[];
+  /** List examples with specific tag. */
+  listByTag(tag: string): ExampleSpec[];
+  /** List examples by owner. */
+  listByOwner(owner: string): ExampleSpec[];
+  /** List examples by domain. */
+  listByDomain(domain: string): ExampleSpec[];
+  /** List examples that support a specific surface. */
+  listBySurface(surface: 'templates' | 'sandbox' | 'studio' | 'mcp'): ExampleSpec[];
+  /** List examples that are installable via Studio. */
+  listInstallable(): ExampleSpec[];
+  /** Group examples by key function. */
+  groupBy(keyFn: GroupKeyFn<ExampleSpec>): Map<string, ExampleSpec[]>;
+  /** Group examples by kind. */
+  groupByKind(): Map<ExampleKind, ExampleSpec[]>;
+  /** Get unique tags from all examples. */
+  getUniqueTags(): string[];
+  /** Get unique kinds from all examples. */
+  getUniqueKinds(): ExampleKind[];
+  /** Get unique domains from all examples. */
+  getUniqueDomains(): string[];
+  /** Search examples by query (matches key, title, description, tags). */
+  search(query: string): ExampleSpec[];
+}
+//#endregion
+export { ExampleRegistry };

package/dist/examples/registry.js

@@ -0,0 +1,144 @@
+import { filterBy, getUniqueTags, groupBy, init_registry_utils } from "../registry-utils.js";
+import { compareVersions } from "compare-versions";
+
+//#region src/examples/registry.ts
+init_registry_utils();
+function exampleKey(meta) {
+	return `${meta.key}.v${meta.version}`;
+}
+/**
+* In-memory registry for ExampleSpec.
+*
+* Provides methods for registering, querying, and filtering examples.
+*
+* @example
+* ```typescript
+* const registry = new ExampleRegistry();
+* registry.register(saasBoilerplateExample);
+* registry.register(workflowSystemExample);
+*
+* const templates = registry.listByKind('template');
+* const publicExamples = registry.listByVisibility('public');
+* ```
+*/
+var ExampleRegistry = class {
+	items = /* @__PURE__ */ new Map();
+	/** Register an example. Throws when the key already exists. */
+	register(spec) {
+		const key = exampleKey(spec.meta);
+		if (this.items.has(key)) throw new Error(`Duplicate example: ${key}`);
+		this.items.set(key, spec);
+		return this;
+	}
+	/** List all registered examples. */
+	list() {
+		return [...this.items.values()];
+	}
+	/** Get an example by its key. */
+	get(key, version) {
+		if (version != null) return this.items.get(`${key}.v${version}`);
+		let candidate;
+		for (const [_k, v] of this.items.entries()) {
+			if (v.meta.key !== key) continue;
+			if (!candidate || compareVersions(v.meta.version, candidate.meta.version) > 0) candidate = v;
+		}
+		return candidate;
+	}
+	/** Check if an example with the given key exists. */
+	has(key, version) {
+		return !!this.get(key, version);
+	}
+	/** Get the number of registered examples. */
+	get size() {
+		return this.items.size;
+	}
+	/** Clear all registered examples. */
+	clear() {
+		this.items.clear();
+	}
+	/** Filter examples by criteria. */
+	filter(criteria) {
+		return filterBy(this.list(), criteria);
+	}
+	/** List examples by kind. */
+	listByKind(kind) {
+		return this.list().filter((spec) => spec.meta.kind === kind);
+	}
+	/** List examples by visibility. */
+	listByVisibility(visibility) {
+		return this.list().filter((spec) => spec.meta.visibility === visibility);
+	}
+	/** List examples with specific tag. */
+	listByTag(tag) {
+		return this.list().filter((spec) => spec.meta.tags.includes(tag));
+	}
+	/** List examples by owner. */
+	listByOwner(owner) {
+		return this.list().filter((spec) => spec.meta.owners.includes(owner));
+	}
+	/** List examples by domain. */
+	listByDomain(domain) {
+		return this.list().filter((spec) => spec.meta.domain === domain);
+	}
+	/** List examples that support a specific surface. */
+	listBySurface(surface) {
+		return this.list().filter((spec) => {
+			if (surface === "templates") return spec.surfaces.templates;
+			if (surface === "sandbox") return spec.surfaces.sandbox.enabled;
+			if (surface === "studio") return spec.surfaces.studio.enabled;
+			if (surface === "mcp") return spec.surfaces.mcp.enabled;
+			return false;
+		});
+	}
+	/** List examples that are installable via Studio. */
+	listInstallable() {
+		return this.list().filter((spec) => spec.surfaces.studio.installable);
+	}
+	/** Group examples by key function. */
+	groupBy(keyFn) {
+		return groupBy(this.list(), keyFn);
+	}
+	/** Group examples by kind. */
+	groupByKind() {
+		const result = /* @__PURE__ */ new Map();
+		for (const spec of this.list()) {
+			const existing = result.get(spec.meta.kind) ?? [];
+			existing.push(spec);
+			result.set(spec.meta.kind, existing);
+		}
+		return result;
+	}
+	/** Get unique tags from all examples. */
+	getUniqueTags() {
+		return getUniqueTags(this.list());
+	}
+	/** Get unique kinds from all examples. */
+	getUniqueKinds() {
+		const kinds = /* @__PURE__ */ new Set();
+		for (const spec of this.list()) kinds.add(spec.meta.kind);
+		return [...kinds];
+	}
+	/** Get unique domains from all examples. */
+	getUniqueDomains() {
+		const domains = /* @__PURE__ */ new Set();
+		for (const spec of this.list()) if (spec.meta.domain) domains.add(spec.meta.domain);
+		return [...domains];
+	}
+	/** Search examples by query (matches key, title, description, tags). */
+	search(query) {
+		const q = query.toLowerCase().trim();
+		if (!q) return this.list();
+		return this.list().filter((spec) => {
+			return [
+				spec.meta.key,
+				spec.meta.title ?? "",
+				spec.meta.description,
+				spec.meta.summary ?? "",
+				...spec.meta.tags
+			].join(" ").toLowerCase().includes(q);
+		});
+	}
+};
+
+//#endregion
+export { ExampleRegistry };

package/dist/examples/schema.d.ts

@@ -0,0 +1,282 @@
+import { ExampleDocumentation, ExampleEntrypoints, ExampleMeta, ExampleSpec, ExampleSurfaces } from "./types.js";
+import { z as z$1 } from "zod";
+
+//#region src/examples/schema.d.ts
+declare const ExampleKindSchema: z$1.ZodEnum<{
+  template: "template";
+  workflow: "workflow";
+  integration: "integration";
+  knowledge: "knowledge";
+  blueprint: "blueprint";
+  ui: "ui";
+  script: "script";
+  library: "library";
+}>;
+declare const ExampleVisibilitySchema: z$1.ZodEnum<{
+  experimental: "experimental";
+  public: "public";
+  internal: "internal";
+}>;
+declare const ExampleSandboxModeSchema: z$1.ZodEnum<{
+  playground: "playground";
+  specs: "specs";
+  builder: "builder";
+  markdown: "markdown";
+  evolution: "evolution";
+}>;
+declare const StabilitySchema: z$1.ZodEnum<{
+  deprecated: "deprecated";
+  idea: "idea";
+  in_creation: "in_creation";
+  experimental: "experimental";
+  beta: "beta";
+  stable: "stable";
+}>;
+declare const ExampleDocumentationSchema: z$1.ZodObject<{
+  rootDocId: z$1.ZodOptional<z$1.ZodString>;
+  goalDocId: z$1.ZodOptional<z$1.ZodString>;
+  usageDocId: z$1.ZodOptional<z$1.ZodString>;
+  referenceDocId: z$1.ZodOptional<z$1.ZodString>;
+  constraintsDocId: z$1.ZodOptional<z$1.ZodString>;
+}, z$1.core.$strip>;
+declare const ExampleSandboxSupportSchema: z$1.ZodObject<{
+  enabled: z$1.ZodBoolean;
+  modes: z$1.ZodArray<z$1.ZodEnum<{
+    playground: "playground";
+    specs: "specs";
+    builder: "builder";
+    markdown: "markdown";
+    evolution: "evolution";
+  }>>;
+}, z$1.core.$strip>;
+declare const ExampleStudioSupportSchema: z$1.ZodObject<{
+  enabled: z$1.ZodBoolean;
+  installable: z$1.ZodBoolean;
+}, z$1.core.$strip>;
+declare const ExampleMcpSupportSchema: z$1.ZodObject<{
+  enabled: z$1.ZodBoolean;
+}, z$1.core.$strip>;
+declare const ExampleSurfacesSchema: z$1.ZodObject<{
+  templates: z$1.ZodBoolean;
+  sandbox: z$1.ZodObject<{
+    enabled: z$1.ZodBoolean;
+    modes: z$1.ZodArray<z$1.ZodEnum<{
+      playground: "playground";
+      specs: "specs";
+      builder: "builder";
+      markdown: "markdown";
+      evolution: "evolution";
+    }>>;
+  }, z$1.core.$strip>;
+  studio: z$1.ZodObject<{
+    enabled: z$1.ZodBoolean;
+    installable: z$1.ZodBoolean;
+  }, z$1.core.$strip>;
+  mcp: z$1.ZodObject<{
+    enabled: z$1.ZodBoolean;
+  }, z$1.core.$strip>;
+}, z$1.core.$strip>;
+declare const ExampleEntrypointsSchema: z$1.ZodObject<{
+  packageName: z$1.ZodString;
+  feature: z$1.ZodOptional<z$1.ZodString>;
+  blueprint: z$1.ZodOptional<z$1.ZodString>;
+  presentations: z$1.ZodOptional<z$1.ZodString>;
+  contracts: z$1.ZodOptional<z$1.ZodString>;
+  handlers: z$1.ZodOptional<z$1.ZodString>;
+  ui: z$1.ZodOptional<z$1.ZodString>;
+  docs: z$1.ZodOptional<z$1.ZodString>;
+}, z$1.core.$strip>;
+declare const ExampleMetaSchema: z$1.ZodObject<{
+  version: z$1.ZodString;
+  key: z$1.ZodString;
+  title: z$1.ZodOptional<z$1.ZodString>;
+  description: z$1.ZodString;
+  domain: z$1.ZodOptional<z$1.ZodString>;
+  stability: z$1.ZodEnum<{
+    deprecated: "deprecated";
+    idea: "idea";
+    in_creation: "in_creation";
+    experimental: "experimental";
+    beta: "beta";
+    stable: "stable";
+  }>;
+  owners: z$1.ZodArray<z$1.ZodString>;
+  tags: z$1.ZodArray<z$1.ZodString>;
+  docId: z$1.ZodOptional<z$1.ZodArray<z$1.ZodString>>;
+  kind: z$1.ZodEnum<{
+    template: "template";
+    workflow: "workflow";
+    integration: "integration";
+    knowledge: "knowledge";
+    blueprint: "blueprint";
+    ui: "ui";
+    script: "script";
+    library: "library";
+  }>;
+  visibility: z$1.ZodEnum<{
+    experimental: "experimental";
+    public: "public";
+    internal: "internal";
+  }>;
+  summary: z$1.ZodOptional<z$1.ZodString>;
+}, z$1.core.$strip>;
+declare const SpecPointerSchema: z$1.ZodObject<{
+  key: z$1.ZodString;
+  version: z$1.ZodOptional<z$1.ZodString>;
+}, z$1.core.$strip>;
+declare const FeatureRefSchema: z$1.ZodObject<{
+  key: z$1.ZodString;
+}, z$1.core.$strip>;
+/**
+ * Zod schema for validating ExampleSpec objects.
+ *
+ * Note: blueprint and features are loosely validated since they can be
+ * inline specs or references. Full validation requires registry lookups.
+ */
+declare const ExampleSpecSchema: z$1.ZodObject<{
+  meta: z$1.ZodObject<{
+    version: z$1.ZodString;
+    key: z$1.ZodString;
+    title: z$1.ZodOptional<z$1.ZodString>;
+    description: z$1.ZodString;
+    domain: z$1.ZodOptional<z$1.ZodString>;
+    stability: z$1.ZodEnum<{
+      deprecated: "deprecated";
+      idea: "idea";
+      in_creation: "in_creation";
+      experimental: "experimental";
+      beta: "beta";
+      stable: "stable";
+    }>;
+    owners: z$1.ZodArray<z$1.ZodString>;
+    tags: z$1.ZodArray<z$1.ZodString>;
+    docId: z$1.ZodOptional<z$1.ZodArray<z$1.ZodString>>;
+    kind: z$1.ZodEnum<{
+      template: "template";
+      workflow: "workflow";
+      integration: "integration";
+      knowledge: "knowledge";
+      blueprint: "blueprint";
+      ui: "ui";
+      script: "script";
+      library: "library";
+    }>;
+    visibility: z$1.ZodEnum<{
+      experimental: "experimental";
+      public: "public";
+      internal: "internal";
+    }>;
+    summary: z$1.ZodOptional<z$1.ZodString>;
+  }, z$1.core.$strip>;
+  docs: z$1.ZodOptional<z$1.ZodObject<{
+    rootDocId: z$1.ZodOptional<z$1.ZodString>;
+    goalDocId: z$1.ZodOptional<z$1.ZodString>;
+    usageDocId: z$1.ZodOptional<z$1.ZodString>;
+    referenceDocId: z$1.ZodOptional<z$1.ZodString>;
+    constraintsDocId: z$1.ZodOptional<z$1.ZodString>;
+  }, z$1.core.$strip>>;
+  surfaces: z$1.ZodObject<{
+    templates: z$1.ZodBoolean;
+    sandbox: z$1.ZodObject<{
+      enabled: z$1.ZodBoolean;
+      modes: z$1.ZodArray<z$1.ZodEnum<{
+        playground: "playground";
+        specs: "specs";
+        builder: "builder";
+        markdown: "markdown";
+        evolution: "evolution";
+      }>>;
+    }, z$1.core.$strip>;
+    studio: z$1.ZodObject<{
+      enabled: z$1.ZodBoolean;
+      installable: z$1.ZodBoolean;
+    }, z$1.core.$strip>;
+    mcp: z$1.ZodObject<{
+      enabled: z$1.ZodBoolean;
+    }, z$1.core.$strip>;
+  }, z$1.core.$strip>;
+  entrypoints: z$1.ZodObject<{
+    packageName: z$1.ZodString;
+    feature: z$1.ZodOptional<z$1.ZodString>;
+    blueprint: z$1.ZodOptional<z$1.ZodString>;
+    presentations: z$1.ZodOptional<z$1.ZodString>;
+    contracts: z$1.ZodOptional<z$1.ZodString>;
+    handlers: z$1.ZodOptional<z$1.ZodString>;
+    ui: z$1.ZodOptional<z$1.ZodString>;
+    docs: z$1.ZodOptional<z$1.ZodString>;
+  }, z$1.core.$strip>;
+  blueprint: z$1.ZodOptional<z$1.ZodUnion<readonly [z$1.ZodRecord<z$1.ZodString, z$1.ZodUnknown>, z$1.ZodObject<{
+    key: z$1.ZodString;
+    version: z$1.ZodOptional<z$1.ZodString>;
+  }, z$1.core.$strip>]>>;
+  features: z$1.ZodOptional<z$1.ZodArray<z$1.ZodUnion<readonly [z$1.ZodRecord<z$1.ZodString, z$1.ZodUnknown>, z$1.ZodObject<{
+    key: z$1.ZodString;
+  }, z$1.core.$strip>]>>>;
+}, z$1.core.$strip>;
+/** Parse and validate an ExampleSpec, throwing on failure */
+declare function parseExampleSpec(data: unknown): ExampleSpec;
+/** Safely parse an ExampleSpec, returning result object */
+declare function safeParseExampleSpec(data: unknown): z$1.ZodSafeParseResult<{
+  meta: {
+    version: string;
+    key: string;
+    description: string;
+    stability: "deprecated" | "idea" | "in_creation" | "experimental" | "beta" | "stable";
+    owners: string[];
+    tags: string[];
+    kind: "template" | "workflow" | "integration" | "knowledge" | "blueprint" | "ui" | "script" | "library";
+    visibility: "experimental" | "public" | "internal";
+    title?: string | undefined;
+    domain?: string | undefined;
+    docId?: string[] | undefined;
+    summary?: string | undefined;
+  };
+  surfaces: {
+    templates: boolean;
+    sandbox: {
+      enabled: boolean;
+      modes: ("playground" | "specs" | "builder" | "markdown" | "evolution")[];
+    };
+    studio: {
+      enabled: boolean;
+      installable: boolean;
+    };
+    mcp: {
+      enabled: boolean;
+    };
+  };
+  entrypoints: {
+    packageName: string;
+    feature?: string | undefined;
+    blueprint?: string | undefined;
+    presentations?: string | undefined;
+    contracts?: string | undefined;
+    handlers?: string | undefined;
+    ui?: string | undefined;
+    docs?: string | undefined;
+  };
+  docs?: {
+    rootDocId?: string | undefined;
+    goalDocId?: string | undefined;
+    usageDocId?: string | undefined;
+    referenceDocId?: string | undefined;
+    constraintsDocId?: string | undefined;
+  } | undefined;
+  blueprint?: Record<string, unknown> | {
+    key: string;
+    version?: string | undefined;
+  } | undefined;
+  features?: (Record<string, unknown> | {
+    key: string;
+  })[] | undefined;
+}>;
+/** Parse and validate ExampleMeta */
+declare function parseExampleMeta(data: unknown): ExampleMeta;
+/** Parse and validate ExampleSurfaces */
+declare function parseExampleSurfaces(data: unknown): ExampleSurfaces;
+/** Parse and validate ExampleEntrypoints */
+declare function parseExampleEntrypoints(data: unknown): ExampleEntrypoints;
+/** Parse and validate ExampleDocumentation */
+declare function parseExampleDocumentation(data: unknown): ExampleDocumentation;
+//#endregion
+export { ExampleDocumentationSchema, ExampleEntrypointsSchema, ExampleKindSchema, ExampleMcpSupportSchema, ExampleMetaSchema, ExampleSandboxModeSchema, ExampleSandboxSupportSchema, ExampleSpecSchema, ExampleStudioSupportSchema, ExampleSurfacesSchema, ExampleVisibilitySchema, FeatureRefSchema, SpecPointerSchema, StabilitySchema, parseExampleDocumentation, parseExampleEntrypoints, parseExampleMeta, parseExampleSpec, parseExampleSurfaces, safeParseExampleSpec };