@contractspec/example.personalization 1.44.1 → 1.45.1

package/dist/example.js.map

@@ -1 +1 @@
-{"version":3,"file":"example.js","names":[],"sources":["../src/example.ts"],"sourcesContent":["const example = {\n  id: 'personalization',\n  title: 'Personalization Patterns',\n  summary:\n    'Small examples for behavior tracking, overlay-based UI customization, and tenant workflow extension.',\n  tags: ['personalization', 'overlays', 'behavior', 'workflows'],\n  kind: 'library',\n  visibility: 'public',\n  docs: {\n    rootDocId: 'docs.examples.personalization',\n    usageDocId: 'docs.examples.personalization.usage',\n  },\n  entrypoints: {\n    packageName: '@contractspec/example.personalization',\n    docs: './docs',\n  },\n  surfaces: {\n    templates: true,\n    sandbox: { enabled: true, modes: ['markdown', 'specs'] },\n    studio: { enabled: true, installable: true },\n    mcp: { enabled: true },\n  },\n} as const;\n\nexport default example;\n"],"mappings":";AAAA,MAAM,UAAU;CACd,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;EAAC;EAAmB;EAAY;EAAY;EAAY;CAC9D,MAAM;CACN,YAAY;CACZ,MAAM;EACJ,WAAW;EACX,YAAY;EACb;CACD,aAAa;EACX,aAAa;EACb,MAAM;EACP;CACD,UAAU;EACR,WAAW;EACX,SAAS;GAAE,SAAS;GAAM,OAAO,CAAC,YAAY,QAAQ;GAAE;EACxD,QAAQ;GAAE,SAAS;GAAM,aAAa;GAAM;EAC5C,KAAK,EAAE,SAAS,MAAM;EACvB;CACF;AAED,sBAAe"}
+{"version":3,"file":"example.js","names":["example: ExampleSpec"],"sources":["../src/example.ts"],"sourcesContent":["import type { ExampleSpec } from '@contractspec/lib.contracts';\n\nconst example: ExampleSpec = {\n  meta: {\n    key: 'personalization',\n    version: '1.0.0',\n    title: 'Personalization Patterns',\n    description:\n      'Small examples for behavior tracking, overlay-based UI customization, and tenant workflow extension.',\n    kind: 'library',\n    visibility: 'public',\n    stability: 'experimental',\n    owners: ['@platform.core'],\n    tags: ['personalization', 'overlays', 'behavior', 'workflows'],\n  },\n  docs: {\n    rootDocId: 'docs.examples.personalization',\n    usageDocId: 'docs.examples.personalization.usage',\n  },\n  entrypoints: {\n    packageName: '@contractspec/example.personalization',\n    docs: './docs',\n  },\n  surfaces: {\n    templates: true,\n    sandbox: { enabled: true, modes: ['markdown', 'specs'] },\n    studio: { enabled: true, installable: true },\n    mcp: { enabled: true },\n  },\n};\n\nexport default example;\n"],"mappings":";AAEA,MAAMA,UAAuB;CAC3B,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aACE;EACF,MAAM;EACN,YAAY;EACZ,WAAW;EACX,QAAQ,CAAC,iBAAiB;EAC1B,MAAM;GAAC;GAAmB;GAAY;GAAY;GAAY;EAC/D;CACD,MAAM;EACJ,WAAW;EACX,YAAY;EACb;CACD,aAAa;EACX,aAAa;EACb,MAAM;EACP;CACD,UAAU;EACR,WAAW;EACX,SAAS;GAAE,SAAS;GAAM,OAAO,CAAC,YAAY,QAAQ;GAAE;EACxD,QAAQ;GAAE,SAAS;GAAM,aAAa;GAAM;EAC5C,KAAK,EAAE,SAAS,MAAM;EACvB;CACF;AAED,sBAAe"}

package/dist/libs/contracts/src/app-config/branding.d.ts

@@ -0,0 +1,20 @@
+//#region ../../libs/contracts/src/app-config/branding.d.ts
+interface BrandingAssetRef {
+  type: 'logo' | 'logo-dark' | 'favicon' | 'og-image';
+  url?: string;
+  dimensions?: {
+    width: number;
+    height: number;
+  };
+}
+interface BrandingDefaults {
+  appNameKey: string;
+  assets?: BrandingAssetRef[];
+  colorTokens?: {
+    primary?: string;
+    secondary?: string;
+  };
+}
+//#endregion
+export { BrandingDefaults };
+//# sourceMappingURL=branding.d.ts.map

package/dist/libs/contracts/src/app-config/branding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branding.d.ts","names":[],"sources":["../../../../../../../libs/contracts/src/app-config/branding.ts"],"sourcesContent":[],"mappings":";UAAiB,gBAAA;EAAA,IAAA,EAAA,MAAA,GAAA,WAAgB,GAAA,SAAA,GAAA,UAAA;EAMhB,GAAA,CAAA,EAAA,MAAA;;;;;;UAAA,gBAAA;;WAEN"}

package/dist/libs/contracts/src/app-config/lifecycle.d.ts

@@ -0,0 +1 @@
+import "./spec.js";

package/dist/libs/contracts/src/app-config/runtime.d.ts

@@ -0,0 +1,13 @@
+import "../policy/spec.js";
+import "../telemetry/spec.js";
+import "../capabilities/index.js";
+import "../experiments/spec.js";
+import "../features/index.js";
+import "../data-views/index.js";
+import "../workflow/spec.js";
+import "../policy/registry.js";
+import "../themes.js";
+import "../integrations/spec.js";
+import "../integrations/connection.js";
+import "../knowledge/spec.js";
+import "./spec.js";

package/dist/libs/contracts/src/app-config/spec.d.ts

@@ -0,0 +1,93 @@
+import { OwnerShipMeta } from "../ownership.js";
+import { PolicyRef } from "../policy/spec.js";
+import { CapabilityRef } from "../capabilities/capabilities.js";
+import "../capabilities/index.js";
+import { ExperimentRef } from "../experiments/spec.js";
+import { FeatureRef } from "../features/types.js";
+import "../features/index.js";
+import { ThemeRef } from "../themes.js";
+import { IntegrationCategory, IntegrationOwnershipMode } from "../integrations/spec.js";
+import { BrandingDefaults } from "./branding.js";
+import "./lifecycle.js";
+import "../registry.js";
+
+//#region ../../libs/contracts/src/app-config/spec.d.ts
+interface SpecPointer {
+  key: string;
+  version?: string;
+}
+interface AppRouteConfig {
+  path: string;
+  label?: string;
+  dataView?: string;
+  workflow?: string;
+  guard?: PolicyRef;
+  featureFlag?: string;
+  experiment?: ExperimentRef;
+}
+interface TranslationCatalogPointer {
+  key: string;
+  version: string;
+}
+interface AppIntegrationSlot {
+  /** Slot identifier unique within the blueprint (e.g., "primaryPayments"). */
+  slotId: string;
+  /** Integration category required to satisfy this slot. */
+  requiredCategory: IntegrationCategory;
+  /** Ownership modes allowed for this slot (defaults to any supported mode). */
+  allowedModes?: IntegrationOwnershipMode[];
+  /** Capabilities that must be provided by the integration spec. */
+  requiredCapabilities?: CapabilityRef[];
+  /** Whether this slot must be satisfied for the app to function. */
+  required?: boolean;
+  /** Description for App Studio UX. */
+  description?: string;
+}
+interface FeatureFlagState {
+  key: string;
+  enabled: boolean;
+  variant?: string;
+  description?: string;
+}
+interface TelemetryBinding {
+  spec?: SpecPointer;
+  disabledEvents?: string[];
+  samplingOverrides?: Record<string, number>;
+}
+interface AppThemeBinding {
+  primary: ThemeRef;
+  fallbacks?: ThemeRef[];
+}
+interface AppBlueprintMeta extends OwnerShipMeta {
+  /** Logical application id (e.g. "artisan"). */
+  appId: string;
+}
+interface AppBlueprintSpec {
+  meta: AppBlueprintMeta;
+  capabilities?: {
+    enabled?: CapabilityRef[];
+    disabled?: CapabilityRef[];
+  };
+  features?: {
+    include?: FeatureRef[];
+    exclude?: FeatureRef[];
+  };
+  integrationSlots?: AppIntegrationSlot[];
+  branding?: BrandingDefaults;
+  translationCatalog?: TranslationCatalogPointer;
+  dataViews?: Record<string, SpecPointer>;
+  workflows?: Record<string, SpecPointer>;
+  policies?: PolicyRef[];
+  theme?: AppThemeBinding;
+  telemetry?: TelemetryBinding;
+  experiments?: {
+    active?: ExperimentRef[];
+    paused?: ExperimentRef[];
+  };
+  featureFlags?: FeatureFlagState[];
+  routes?: AppRouteConfig[];
+  notes?: string;
+}
+//#endregion
+export { AppBlueprintMeta, AppBlueprintSpec, AppIntegrationSlot, AppRouteConfig, AppThemeBinding, FeatureFlagState, SpecPointer, TelemetryBinding, TranslationCatalogPointer };
+//# sourceMappingURL=spec.d.ts.map

package/dist/libs/contracts/src/app-config/spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.d.ts","names":[],"sources":["../../../../../../../libs/contracts/src/app-config/spec.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;UAiBiB,WAAA;EAAA,GAAA,EAAA,MAAA;EAKA,OAAA,CAAA,EAAA,MAAA;AAUjB;AAKiB,UAfA,cAAA,CAekB;EAIf,IAAA,EAAA,MAAA;EAEH,KAAA,CAAA,EAAA,MAAA;EAEQ,QAAA,CAAA,EAAA,MAAA;EAAa,QAAA,CAAA,EAAA,MAAA;EAOrB,KAAA,CAAA,EAzBP,SAyBO;EAOA,WAAA,CAAA,EAAA,MAAgB;EAMhB,UAAA,CAAA,EApCF,aAoCiB;AAKhC;AAKiB,UA3CA,yBAAA,CA2CgB;EACzB,GAAA,EAAA,MAAA;EAEM,OAAA,EAAA,MAAA;;AAIA,UA7CG,kBAAA,CA6CH;EACA;EAEO,MAAA,EAAA,MAAA;EACR;EACU,gBAAA,EA9CH,mBA8CG;EACM;EAAf,YAAA,CAAA,EA7CG,wBA6CH,EAAA;EACe;EAAf,oBAAA,CAAA,EA5CW,aA4CX,EAAA;EACD;EACH,QAAA,CAAA,EAAA,OAAA;EACI;EAED,WAAA,CAAA,EAAA,MAAA;;AAGI,UA7CA,gBAAA,CA6CA;EACN,GAAA,EAAA,MAAA;EAAc,OAAA,EAAA,OAAA;;;;UAvCR,gBAAA;SACR;;sBAEa;;UAGL,eAAA;WACN;cACG;;UAGG,gBAAA,SAAyB;;;;UAKzB,gBAAA;QACT;;cAEM;eACC;;;cAGD;cACA;;qBAEO;aACR;uBACU;cACT,eAAe;cACf,eAAe;aAChB;UACH;cACI;;aAED;aACA;;iBAEI;WACN"}

package/dist/libs/contracts/src/app-config/validation.d.ts

@@ -0,0 +1,8 @@
+import "../capabilities/index.js";
+import "../data-views/index.js";
+import "../workflow/spec.js";
+import "../integrations/spec.js";
+import "../integrations/connection.js";
+import "../knowledge/spec.js";
+import "./spec.js";
+import "./runtime.js";

package/dist/libs/contracts/src/capabilities/capabilities.d.ts

@@ -1,9 +1,18 @@
-//#region ../../libs/contracts/src/capabilities/capabilities.d.ts
+import "../ownership.js";
 
+//#region ../../libs/contracts/src/capabilities/capabilities.d.ts
+type CapabilityKind = 'api' | 'event' | 'data' | 'ui' | 'integration';
+interface CapabilityRequirement {
+  key: string;
+  version?: string;
+  kind?: CapabilityKind;
+  optional?: boolean;
+  reason?: string;
+}
 interface CapabilityRef {
   key: string;
-  version: number;
+  version: string;
 }
 //#endregion
-export { CapabilityRef };
+export { CapabilityKind, CapabilityRef, CapabilityRequirement };
 //# sourceMappingURL=capabilities.d.ts.map

package/dist/libs/contracts/src/capabilities/capabilities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capabilities.d.ts","names":[],"sources":["../../../../../../../libs/contracts/src/capabilities/capabilities.ts"],"sourcesContent":[],"mappings":";;UAqCiB,aAAA"}
+{"version":3,"file":"capabilities.d.ts","names":[],"sources":["../../../../../../../libs/contracts/src/capabilities/capabilities.ts"],"sourcesContent":[],"mappings":";;;KAGY,cAAA;UAoBK,qBAAA;;;SAGR;;;;UAKQ,aAAA"}

package/dist/libs/contracts/src/capabilities/index.d.ts

@@ -0,0 +1,2 @@
+import { CapabilityKind, CapabilityRef, CapabilityRequirement } from "./capabilities.js";
+import "./openbanking.js";

package/dist/libs/contracts/src/capabilities/openbanking.d.ts

@@ -0,0 +1 @@
+import "./index.js";

package/dist/libs/contracts/src/client/index.d.ts

@@ -0,0 +1 @@
+import "./react/index.js";

package/dist/libs/contracts/src/client/react/drivers/rn-reusables.d.ts

@@ -0,0 +1 @@
+import "../form-render.js";

package/dist/libs/contracts/src/client/react/drivers/shadcn.d.ts

@@ -0,0 +1 @@
+import "../form-render.js";

package/dist/libs/contracts/src/client/react/feature-render.d.ts

@@ -0,0 +1,3 @@
+import "../../presentations/index.js";
+import "../../features/index.js";
+import "react";

package/dist/libs/contracts/src/client/react/form-render.d.ts

@@ -0,0 +1,4 @@
+import "../../forms/index.js";
+import "@contractspec/lib.schema";
+import "react";
+import "react/jsx-runtime";

package/dist/libs/contracts/src/client/react/index.d.ts

@@ -0,0 +1,4 @@
+import "./feature-render.js";
+import "./form-render.js";
+import "./drivers/shadcn.js";
+import "./drivers/rn-reusables.js";

package/dist/libs/contracts/src/contract-registry/index.d.ts

@@ -0,0 +1,2 @@
+import "./types.js";
+import "./schemas.js";

package/dist/libs/contracts/src/contract-registry/schemas.d.ts

@@ -0,0 +1,2 @@
+import "./types.js";
+import "zod";

package/dist/libs/contracts/src/contract-registry/types.d.ts

@@ -0,0 +1 @@
+import "../ownership.js";

package/dist/libs/contracts/src/data-views/index.d.ts

@@ -0,0 +1,3 @@
+import "./types.js";
+import "./spec.js";
+import "./registry.js";

package/dist/libs/contracts/src/data-views/registry.d.ts

@@ -0,0 +1,2 @@
+import "./spec.js";
+import "../registry.js";

package/dist/libs/contracts/src/data-views/spec.d.ts

@@ -0,0 +1,2 @@
+import "../experiments/spec.js";
+import "./types.js";

package/dist/libs/contracts/src/data-views/types.d.ts

@@ -0,0 +1,2 @@
+import "../ownership.js";
+import "../features/index.js";

package/dist/libs/contracts/src/docs/accessibility_wcag_compliance_specs.docblock.d.ts

@@ -0,0 +1 @@
+import "./index.js";

package/dist/libs/contracts/src/docs/index.d.ts

@@ -0,0 +1,25 @@
+import "./presentations.js";
+import { DocId } from "./registry.js";
+import "./accessibility_wcag_compliance_specs.docblock.js";
+import "./tech/lifecycle-stage-system.docblock.js";
+import "./tech/presentation-runtime.docblock.js";
+import "./tech/auth/better-auth-nextjs.docblock.js";
+import "./tech/schema/README.docblock.js";
+import "./tech/templates/runtime.docblock.js";
+import "../workflow/overview.docblock.js";
+import "./tech/mcp-endpoints.docblock.js";
+import "./tech/vscode-extension.docblock.js";
+import "./tech/telemetry-ingest.docblock.js";
+import "./tech/contracts/openapi-export.docblock.js";
+import "./tech/contracts/openapi-import.docblock.js";
+import "../workspace-config/workspace-config.docblock.js";
+import "./tech/studio/workspaces.docblock.js";
+import "./tech/studio/sandbox-unlogged.docblock.js";
+import "./tech/studio/workspace-ops.docblock.js";
+import "./tech/studio/project-routing.docblock.js";
+import "./tech/studio/platform-admin-panel.docblock.js";
+import "./tech/studio/learning-events.docblock.js";
+import "./tech/studio/learning-journeys.docblock.js";
+import "./tech/studio/project-access-teams.docblock.js";
+import "./tech/studio/team-invitations.docblock.js";
+import "./tech/llm/llm-integration.docblock.js";

package/dist/libs/contracts/src/docs/presentations.d.ts

@@ -0,0 +1,2 @@
+import "../presentations/presentations.js";
+import "../ownership.js";

package/dist/libs/contracts/src/docs/registry.d.ts

@@ -1,5 +1,7 @@
-//#region ../../libs/contracts/src/docs/registry.d.ts
+import "../presentations/presentations.js";
+import "./presentations.js";
 
+//#region ../../libs/contracts/src/docs/registry.d.ts
 type DocId = string & {
   __docId: true;
 };

package/dist/libs/contracts/src/docs/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","names":[],"sources":["../../../../../../../libs/contracts/src/docs/registry.ts"],"sourcesContent":[],"mappings":";;KASY,KAAA"}
+{"version":3,"file":"registry.d.ts","names":[],"sources":["../../../../../../../libs/contracts/src/docs/registry.ts"],"sourcesContent":[],"mappings":";;;;KASY,KAAA;EAAA,OAAA,EAAK,IAAA"}

package/dist/libs/contracts/src/docs/tech/auth/better-auth-nextjs.docblock.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/libs/contracts/src/docs/tech/contracts/openapi-export.docblock.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/libs/contracts/src/docs/tech/contracts/openapi-import.docblock.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/libs/contracts/src/docs/tech/lifecycle-stage-system.docblock.d.ts

@@ -0,0 +1 @@
+import "../index.js";

package/dist/libs/contracts/src/docs/tech/llm/llm-integration.docblock.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/libs/contracts/src/docs/tech/mcp-endpoints.docblock.d.ts

@@ -0,0 +1 @@
+import "../index.js";

package/dist/libs/contracts/src/docs/tech/presentation-runtime.docblock.d.ts

@@ -0,0 +1 @@
+import "../index.js";

package/dist/libs/contracts/src/docs/tech/schema/README.docblock.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/libs/contracts/src/docs/tech/studio/learning-events.docblock.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/libs/contracts/src/docs/tech/studio/learning-journeys.docblock.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/libs/contracts/src/docs/tech/studio/platform-admin-panel.docblock.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/libs/contracts/src/docs/tech/studio/project-access-teams.docblock.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/libs/contracts/src/docs/tech/studio/project-routing.docblock.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/libs/contracts/src/docs/tech/studio/sandbox-unlogged.docblock.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/libs/contracts/src/docs/tech/studio/team-invitations.docblock.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/libs/contracts/src/docs/tech/studio/workspace-ops.docblock.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/libs/contracts/src/docs/tech/studio/workspaces.docblock.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/libs/contracts/src/docs/tech/telemetry-ingest.docblock.d.ts

@@ -0,0 +1 @@
+import "../index.js";

package/dist/libs/contracts/src/docs/tech/templates/runtime.docblock.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/libs/contracts/src/docs/tech/vscode-extension.docblock.d.ts

@@ -0,0 +1 @@
+import "../index.js";

package/dist/libs/contracts/src/events.d.ts

@@ -1 +1,4 @@
-import "./registry.js";
+import "./docs/registry.js";
+import "./ownership.js";
+import "./registry.js";
+import "@contractspec/lib.schema";

package/dist/libs/contracts/src/examples/index.d.ts

@@ -0,0 +1,4 @@
+import { ExampleDocumentation, ExampleEntrypoints, ExampleKind, ExampleMcpSupport, ExampleMeta, ExampleSandboxMode, ExampleSandboxSupport, ExampleSpec, ExampleStudioSupport, ExampleSurfaces, ExampleVisibility } from "./types.js";
+import "./schema.js";
+import "./registry.js";
+import "./validation.js";

package/dist/libs/contracts/src/examples/registry.d.ts

@@ -0,0 +1,2 @@
+import "../registry-utils.js";
+import "./types.js";

package/dist/libs/contracts/src/examples/schema.d.ts

@@ -0,0 +1,2 @@
+import "./types.js";
+import "zod";

package/dist/libs/contracts/src/examples/types.d.ts

@@ -0,0 +1,138 @@
+import { OwnerShipMeta } from "../ownership.js";
+import { FeatureModuleSpec, FeatureRef } from "../features/types.js";
+import "../features/index.js";
+import { AppBlueprintSpec, SpecPointer } from "../app-config/spec.js";
+
+//#region ../../libs/contracts/src/examples/types.d.ts
+/** Kind of example - determines how it's presented in catalogs */
+type ExampleKind = 'template' | 'workflow' | 'integration' | 'knowledge' | 'blueprint' | 'ui' | 'script' | 'library';
+/** Visibility level for examples */
+type ExampleVisibility = 'public' | 'internal' | 'experimental';
+/** Sandbox modes supported by examples */
+type ExampleSandboxMode = 'playground' | 'specs' | 'builder' | 'markdown' | 'evolution';
+/** Documentation references for the example */
+interface ExampleDocumentation {
+  /** Root documentation block ID */
+  rootDocId?: string;
+  /** Goal/purpose documentation */
+  goalDocId?: string;
+  /** Usage/quickstart documentation */
+  usageDocId?: string;
+  /** API/reference documentation */
+  referenceDocId?: string;
+  /** Constraints/limitations documentation */
+  constraintsDocId?: string;
+}
+/** Surface support configuration for sandbox */
+interface ExampleSandboxSupport {
+  enabled: boolean;
+  modes: readonly ExampleSandboxMode[];
+}
+/** Surface support configuration for Studio */
+interface ExampleStudioSupport {
+  enabled: boolean;
+  /** If true, Studio can create a real project from this example via API. */
+  installable: boolean;
+}
+/** Surface support configuration for MCP */
+interface ExampleMcpSupport {
+  enabled: boolean;
+}
+/** Surface support configuration - where the example can be used */
+interface ExampleSurfaces {
+  /** Available as a template for new projects */
+  templates: boolean;
+  /** Sandbox/playground support */
+  sandbox: ExampleSandboxSupport;
+  /** ContractSpec Studio support */
+  studio: ExampleStudioSupport;
+  /** MCP (Model Context Protocol) support */
+  mcp: ExampleMcpSupport;
+}
+/** Package entrypoints for the example - maps to package.json exports */
+interface ExampleEntrypoints {
+  /** Package name in the workspace (e.g., @contractspec/example.saas-boilerplate) */
+  packageName: string;
+  /** Feature module entrypoint (e.g., ./saas-boilerplate.feature) */
+  feature?: string;
+  /** Blueprint entrypoint (e.g., ./blueprint) */
+  blueprint?: string;
+  /** Presentations entrypoint (e.g., ./presentations) */
+  presentations?: string;
+  /** Contracts/operations entrypoint (e.g., ./contracts) */
+  contracts?: string;
+  /** Handlers entrypoint (e.g., ./handlers) */
+  handlers?: string;
+  /** UI components entrypoint (e.g., ./ui) */
+  ui?: string;
+  /** Documentation entrypoint (e.g., ./docs) */
+  docs?: string;
+}
+/**
+ * Example metadata extending OwnerShipMeta.
+ * Provides standard spec identification plus example-specific fields.
+ */
+interface ExampleMeta extends OwnerShipMeta {
+  /** Example kind for categorization */
+  kind: ExampleKind;
+  /** Visibility level */
+  visibility: ExampleVisibility;
+  /** Short marketing summary (distinct from technical description) */
+  summary?: string;
+}
+/**
+ * ExampleSpec - Complete specification for a ContractSpec example.
+ *
+ * Integrates with AppBlueprintSpec for app configuration and
+ * FeatureModuleSpec for feature definitions.
+ *
+ * @example
+ * ```typescript
+ * const example: ExampleSpec = {
+ *   meta: {
+ *     key: 'saas-boilerplate',
+ *     version: '1.0.0',
+ *     title: 'SaaS Boilerplate',
+ *     description: 'Multi-tenant SaaS foundation.',
+ *     kind: 'template',
+ *     visibility: 'public',
+ *     stability: 'experimental',
+ *     owners: ['@saas-team'],
+ *     tags: ['saas', 'multi-tenant'],
+ *   },
+ *   surfaces: {
+ *     templates: true,
+ *     sandbox: { enabled: true, modes: ['playground', 'specs'] },
+ *     studio: { enabled: true, installable: true },
+ *     mcp: { enabled: true },
+ *   },
+ *   entrypoints: {
+ *     packageName: '@contractspec/example.saas-boilerplate',
+ *     feature: './saas-boilerplate.feature',
+ *   },
+ * };
+ * ```
+ */
+interface ExampleSpec {
+  /** Example metadata (identification, ownership, categorization) */
+  meta: ExampleMeta;
+  /** Documentation references */
+  docs?: ExampleDocumentation;
+  /** Surface support configuration */
+  surfaces: ExampleSurfaces;
+  /** Package entrypoints */
+  entrypoints: ExampleEntrypoints;
+  /**
+   * Inline or referenced AppBlueprintSpec.
+   * Use SpecPointer for external reference to a registered blueprint.
+   */
+  blueprint?: AppBlueprintSpec | SpecPointer;
+  /**
+   * Features included in this example.
+   * Can be inline FeatureModuleSpec objects or FeatureRef references.
+   */
+  features?: (FeatureModuleSpec | FeatureRef)[];
+}
+//#endregion
+export { ExampleDocumentation, ExampleEntrypoints, ExampleKind, ExampleMcpSupport, ExampleMeta, ExampleSandboxMode, ExampleSandboxSupport, ExampleSpec, ExampleStudioSupport, ExampleSurfaces, ExampleVisibility };
+//# sourceMappingURL=types.d.ts.map

package/dist/libs/contracts/src/examples/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../../../../../../libs/contracts/src/examples/types.ts"],"sourcesContent":[],"mappings":";;;;;;;KASY,WAAA;;AA+FL,KAzEK,iBAAA,GAyEL,QAAA,GAAA,UAAA,GAAA,cAAA;;AAmC2C,KAnGtC,kBAAA,GAmGsC,YAAA,GAAA,OAAA,GAAA,SAAA,GAAA,UAAA,GAAA,WAAA;;AAqEhB,UApJjB,oBAAA,CAoJiB;EAAU;;;;;;;;;;;;UAlI3B,qBAAA;;kBAEC;;;UAID,oBAAA;;;;;;UAOA,iBAAA;;;;UAKA,eAAA;;;;WAIN;;UAED;;OAEH;;;UAQU,kBAAA;;;;;;;;;;;;;;;;;;;;;;UA2BA,WAAA,SAAoB;;QAE7B;;cAEM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UA0CG,WAAA;;QAET;;SAGC;;YAGG;;eAGG;;;;;cAMD,mBAAmB;;;;;cAMnB,oBAAoB"}

package/dist/libs/contracts/src/examples/validation.d.ts

@@ -0,0 +1 @@
+import "./types.js";

package/dist/libs/contracts/src/experiments/evaluator.d.ts

@@ -0,0 +1,2 @@
+import "../policy/spec.js";
+import "./spec.js";

package/dist/libs/contracts/src/experiments/spec-resolver.d.ts

@@ -1,3 +1,4 @@
 import "../resources.js";
+import "../operations/index.js";
 import "../types.js";
-import "../operations/index.js";
+import "@contractspec/lib.schema";

package/dist/libs/contracts/src/experiments/spec.d.ts

@@ -1,8 +1,12 @@
-//#region ../../libs/contracts/src/experiments/spec.d.ts
+import "../ownership.js";
+import "../policy/spec.js";
+import "../telemetry/spec.js";
+import "../registry.js";
 
+//#region ../../libs/contracts/src/experiments/spec.d.ts
 interface ExperimentRef {
   key: string;
-  version?: number;
+  version?: string;
 }
 //#endregion
 export { ExperimentRef };

package/dist/libs/contracts/src/experiments/spec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spec.d.ts","names":[],"sources":["../../../../../../../libs/contracts/src/experiments/spec.ts"],"sourcesContent":[],"mappings":";;UAMiB,aAAA"}
+{"version":3,"file":"spec.d.ts","names":[],"sources":["../../../../../../../libs/contracts/src/experiments/spec.ts"],"sourcesContent":[],"mappings":";;;;;;UAOiB,aAAA;EAAA,GAAA,EAAA,MAAA"}

package/dist/libs/contracts/src/features/index.d.ts

@@ -1,4 +1,4 @@
-import { OpRef } from "./types.js";
+import { EventRef, FeatureModuleMeta, FeatureModuleSpec, FeatureRef, OpRef, PresentationRef } from "./types.js";
 import "./registry.js";
 import "./install.js";
 import "./validation.js";

package/dist/libs/contracts/src/features/install.d.ts

@@ -1,3 +1,5 @@
+import "../presentations/presentations.js";
+import "../capabilities/index.js";
 import "../operations/registry.js";
 import "./types.js";
 import "./registry.js";

package/dist/libs/contracts/src/features/registry.d.ts

@@ -1 +1,2 @@
+import "../registry-utils.js";
 import "./types.js";