@contractspec/bundle.marketing 1.12.0

package/dist/libs/email/waitlist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"waitlist.d.ts","names":[],"sources":["../../../src/libs/email/waitlist.ts"],"mappings":";;;cAWa,YAAA,GACX,QAAA,EAAU,QAAA,KACT,OAAA,CAAQ,oBAAA"}

package/dist/libs/email/waitlist.js

@@ -0,0 +1,105 @@
+'use server';
+
+import { getEmailConfig, sendEmail } from "./client.js";
+import { formatMultilineHtml } from "./utils.js";
+
+//#region src/libs/email/waitlist.ts
+const WAITLIST_MISSING_CONFIG = "Waitlist service is not configured. Please try again later.";
+const WAITLIST_SEND_ERROR = "Failed to join waitlist. Please try again later or contact us directly.";
+const joinWaitlist = async (formData) => {
+	const email = (formData.get("email") ?? "").toString().trim();
+	if (!email || !email.includes("@")) return {
+		success: false,
+		text: "Please enter a valid email address."
+	};
+	const configResult = getEmailConfig();
+	if (!configResult.ok || !configResult.config) return {
+		success: false,
+		text: configResult.errorMessage ?? WAITLIST_MISSING_CONFIG
+	};
+	const waitlistText = `
+You're on the waitlist!
+
+Thanks for joining the ContractSpec waitlist. You're now in line for early access to:
+
+• Stabilize your AI-generated code with ContractSpec
+• Multi-surface consistency (API, DB, UI, events)
+• Safe regeneration without breaking changes
+• AI governance and contract enforcement
+
+We'll notify you as soon as early access is available. In the meantime, you can:
+
+• Check out our docs: https://contractspec.io/docs
+• Follow our progress on GitHub
+• Book a demo call to see ContractSpec in action
+
+We're excited to have you on board!
+
+---
+ContractSpec Team
+https://contractspec.io
+
+To remove yourself from the waitlist, reply to this email with "remove"
+  `.trim();
+	if (!(await sendEmail(configResult.config, {
+		to: [{ email }],
+		subject: "You're on the ContractSpec waitlist!",
+		text: waitlistText,
+		html: `
+    <div style="font-family: sans-serif; max-width: 640px; margin: 0 auto;">
+      <h1 style="color: #8b5cf6;">You're on the waitlist!</h1>
+      <p>Thanks for joining the ContractSpec waitlist. You're now in line for early access to:</p>
+      <ul style="line-height: 1.8;">
+        <li>Stabilize your AI-generated code with ContractSpec</li>
+        <li>Multi-surface consistency (API, DB, UI, events)</li>
+        <li>Safe regeneration without breaking changes</li>
+        <li>AI governance and contract enforcement</li>
+      </ul>
+      <p>We'll notify you as soon as early access is available. In the meantime, you can:</p>
+      <ul style="line-height: 1.8;">
+        <li>Check out our <a href="https://contractspec.io/docs" style="color: #8b5cf6;">docs</a></li>
+        <li>Follow our progress on GitHub</li>
+        <li>Book a demo call to see ContractSpec in action</li>
+      </ul>
+      <p>We're excited to have you on board!</p>
+      <hr style="margin: 30px 0; border: none; border-top: 1px solid #e5e7eb;" />
+      <p style="color: #6b7280; font-size: 14px;">
+        ContractSpec Team<br />
+        <a href="https://contractspec.io" style="color: #8b5cf6;">contractspec.io</a>
+      </p>
+      <p style="color: #9ca3af; font-size: 12px;">
+        To remove yourself from the waitlist, reply to this email with "remove"
+      </p>
+    </div>
+  `,
+		context: "waitlist-welcome"
+	})).success) return {
+		success: false,
+		text: WAITLIST_SEND_ERROR
+	};
+	const teamNotificationText = `New waitlist signup from: ${email}`;
+	const teamNotificationHtml = `
+    <div style="font-family: sans-serif; max-width: 640px; margin: 0 auto;">
+      <p style="margin: 0 0 8px;">New waitlist signup</p>
+      <p style="margin: 0;"><strong>Email:</strong> ${formatMultilineHtml(email)}</p>
+    </div>
+  `;
+	if (!(await sendEmail(configResult.config, {
+		to: [configResult.config.teamInbox],
+		subject: `New Waitlist Signup: ${email}`,
+		text: teamNotificationText,
+		html: teamNotificationHtml,
+		context: "waitlist-team-notification"
+	})).success) return {
+		success: false,
+		text: WAITLIST_SEND_ERROR
+	};
+	return {
+		success: true,
+		text: "Successfully joined waitlist!"
+	};
+};
+
+//#endregion
+export { joinWaitlist };
+//# sourceMappingURL=waitlist.js.map

package/dist/libs/email/waitlist.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"waitlist.js","names":[],"sources":["../../../src/libs/email/waitlist.ts"],"sourcesContent":["'use server';\n\nimport { getEmailConfig, sendEmail } from './client';\nimport { formatMultilineHtml } from './utils';\nimport type { SubmitWaitlistResult } from './types';\n\nconst WAITLIST_MISSING_CONFIG =\n  'Waitlist service is not configured. Please try again later.';\nconst WAITLIST_SEND_ERROR =\n  'Failed to join waitlist. Please try again later or contact us directly.';\n\nexport const joinWaitlist = async (\n  formData: FormData\n): Promise<SubmitWaitlistResult> => {\n  const email = (formData.get('email') ?? '').toString().trim();\n\n  if (!email || !email.includes('@')) {\n    return {\n      success: false,\n      text: 'Please enter a valid email address.',\n    };\n  }\n\n  const configResult = getEmailConfig();\n  if (!configResult.ok || !configResult.config) {\n    return {\n      success: false,\n      text: configResult.errorMessage ?? WAITLIST_MISSING_CONFIG,\n    };\n  }\n\n  const waitlistText = `\nYou're on the waitlist!\n\nThanks for joining the ContractSpec waitlist. You're now in line for early access to:\n\n• Stabilize your AI-generated code with ContractSpec\n• Multi-surface consistency (API, DB, UI, events)\n• Safe regeneration without breaking changes\n• AI governance and contract enforcement\n\nWe'll notify you as soon as early access is available. In the meantime, you can:\n\n• Check out our docs: https://contractspec.io/docs\n• Follow our progress on GitHub\n• Book a demo call to see ContractSpec in action\n\nWe're excited to have you on board!\n\n---\nContractSpec Team\nhttps://contractspec.io\n\nTo remove yourself from the waitlist, reply to this email with \"remove\"\n  `.trim();\n\n  const waitlistHtml = `\n    <div style=\"font-family: sans-serif; max-width: 640px; margin: 0 auto;\">\n      <h1 style=\"color: #8b5cf6;\">You're on the waitlist!</h1>\n      <p>Thanks for joining the ContractSpec waitlist. You're now in line for early access to:</p>\n      <ul style=\"line-height: 1.8;\">\n        <li>Stabilize your AI-generated code with ContractSpec</li>\n        <li>Multi-surface consistency (API, DB, UI, events)</li>\n        <li>Safe regeneration without breaking changes</li>\n        <li>AI governance and contract enforcement</li>\n      </ul>\n      <p>We'll notify you as soon as early access is available. In the meantime, you can:</p>\n      <ul style=\"line-height: 1.8;\">\n        <li>Check out our <a href=\"https://contractspec.io/docs\" style=\"color: #8b5cf6;\">docs</a></li>\n        <li>Follow our progress on GitHub</li>\n        <li>Book a demo call to see ContractSpec in action</li>\n      </ul>\n      <p>We're excited to have you on board!</p>\n      <hr style=\"margin: 30px 0; border: none; border-top: 1px solid #e5e7eb;\" />\n      <p style=\"color: #6b7280; font-size: 14px;\">\n        ContractSpec Team<br />\n        <a href=\"https://contractspec.io\" style=\"color: #8b5cf6;\">contractspec.io</a>\n      </p>\n      <p style=\"color: #9ca3af; font-size: 12px;\">\n        To remove yourself from the waitlist, reply to this email with \"remove\"\n      </p>\n    </div>\n  `;\n\n  const userSend = await sendEmail(configResult.config, {\n    to: [{ email }],\n    subject: \"You're on the ContractSpec waitlist!\",\n    text: waitlistText,\n    html: waitlistHtml,\n    context: 'waitlist-welcome',\n  });\n\n  if (!userSend.success) {\n    return { success: false, text: WAITLIST_SEND_ERROR };\n  }\n\n  const teamNotificationText = `New waitlist signup from: ${email}`;\n  const teamNotificationHtml = `\n    <div style=\"font-family: sans-serif; max-width: 640px; margin: 0 auto;\">\n      <p style=\"margin: 0 0 8px;\">New waitlist signup</p>\n      <p style=\"margin: 0;\"><strong>Email:</strong> ${formatMultilineHtml(email)}</p>\n    </div>\n  `;\n\n  const teamSend = await sendEmail(configResult.config, {\n    to: [configResult.config.teamInbox],\n    subject: `New Waitlist Signup: ${email}`,\n    text: teamNotificationText,\n    html: teamNotificationHtml,\n    context: 'waitlist-team-notification',\n  });\n\n  if (!teamSend.success) {\n    return { success: false, text: WAITLIST_SEND_ERROR };\n  }\n\n  return { success: true, text: 'Successfully joined waitlist!' };\n};\n"],"mappings":";;;;;;AAMA,MAAM,0BACJ;AACF,MAAM,sBACJ;AAEF,MAAa,eAAe,OAC1B,aACkC;CAClC,MAAM,SAAS,SAAS,IAAI,QAAQ,IAAI,IAAI,UAAU,CAAC,MAAM;AAE7D,KAAI,CAAC,SAAS,CAAC,MAAM,SAAS,IAAI,CAChC,QAAO;EACL,SAAS;EACT,MAAM;EACP;CAGH,MAAM,eAAe,gBAAgB;AACrC,KAAI,CAAC,aAAa,MAAM,CAAC,aAAa,OACpC,QAAO;EACL,SAAS;EACT,MAAM,aAAa,gBAAgB;EACpC;CAGH,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;IAuBnB,MAAM;AAsCR,KAAI,EARa,MAAM,UAAU,aAAa,QAAQ;EACpD,IAAI,CAAC,EAAE,OAAO,CAAC;EACf,SAAS;EACT,MAAM;EACN,MAhCmB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiCnB,SAAS;EACV,CAAC,EAEY,QACZ,QAAO;EAAE,SAAS;EAAO,MAAM;EAAqB;CAGtD,MAAM,uBAAuB,6BAA6B;CAC1D,MAAM,uBAAuB;;;sDAGuB,oBAAoB,MAAM,CAAC;;;AAY/E,KAAI,EARa,MAAM,UAAU,aAAa,QAAQ;EACpD,IAAI,CAAC,aAAa,OAAO,UAAU;EACnC,SAAS,wBAAwB;EACjC,MAAM;EACN,MAAM;EACN,SAAS;EACV,CAAC,EAEY,QACZ,QAAO;EAAE,SAAS;EAAO,MAAM;EAAqB;AAGtD,QAAO;EAAE,SAAS;EAAM,MAAM;EAAiC"}

package/dist/libs/pricing-examples.d.ts

@@ -0,0 +1,22 @@
+//#region src/libs/pricing-examples.d.ts
+/**
+ * Tentative pricing example values for UI display.
+ * These are examples only and subject to change based on learnings from design partners.
+ */
+declare const PRICING_EXAMPLES: {
+  readonly free: {
+    readonly regenerationsPerMonth: 200;
+    readonly aiActionsPerMonth: 100;
+    readonly projects: 1;
+  };
+  readonly builder: {
+    readonly regenerationsPerMonthHint: "1,000–2,000+";
+    readonly aiActionsPerMonthHint: "1,000+";
+  };
+  readonly team: {
+    readonly description: "Higher limits + cheaper per-regen at scale";
+  };
+};
+//#endregion
+export { PRICING_EXAMPLES };
+//# sourceMappingURL=pricing-examples.d.ts.map

package/dist/libs/pricing-examples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing-examples.d.ts","names":[],"sources":["../../src/libs/pricing-examples.ts"],"mappings":";;AAKA;;;cAAa,gBAAA;EAAA"}

package/dist/libs/pricing-examples.js

@@ -0,0 +1,21 @@
+//#region src/libs/pricing-examples.ts
+/**
+* Tentative pricing example values for UI display.
+* These are examples only and subject to change based on learnings from design partners.
+*/
+const PRICING_EXAMPLES = {
+	free: {
+		regenerationsPerMonth: 200,
+		aiActionsPerMonth: 100,
+		projects: 1
+	},
+	builder: {
+		regenerationsPerMonthHint: "1,000–2,000+",
+		aiActionsPerMonthHint: "1,000+"
+	},
+	team: { description: "Higher limits + cheaper per-regen at scale" }
+};
+
+//#endregion
+export { PRICING_EXAMPLES };
+//# sourceMappingURL=pricing-examples.js.map

package/dist/libs/pricing-examples.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing-examples.js","names":[],"sources":["../../src/libs/pricing-examples.ts"],"sourcesContent":["/**\n * Tentative pricing example values for UI display.\n * These are examples only and subject to change based on learnings from design partners.\n */\n\nexport const PRICING_EXAMPLES = {\n  free: {\n    regenerationsPerMonth: 200,\n    aiActionsPerMonth: 100,\n    projects: 1,\n  },\n  builder: {\n    regenerationsPerMonthHint: '1,000–2,000+',\n    aiActionsPerMonthHint: '1,000+',\n  },\n  team: {\n    description: 'Higher limits + cheaper per-regen at scale',\n  },\n} as const;\n"],"mappings":";;;;;AAKA,MAAa,mBAAmB;CAC9B,MAAM;EACJ,uBAAuB;EACvB,mBAAmB;EACnB,UAAU;EACX;CACD,SAAS;EACP,2BAA2B;EAC3B,uBAAuB;EACxB;CACD,MAAM,EACJ,aAAa,8CACd;CACF"}

package/dist/registry/engine.d.ts

@@ -0,0 +1,17 @@
+import { ComponentMap } from "./types.js";
+import { TransformEngine } from "@contractspec/lib.contracts/presentations";
+
+//#region src/registry/engine.d.ts
+/**
+ * Create and configure the TransformEngine for web-landing presentations.
+ * Includes React and Markdown renderers with component map registration.
+ */
+declare function createPresentationEngine(customComponentMap?: ComponentMap): TransformEngine;
+/**
+ * Singleton engine instance for the app.
+ * Use this for rendering presentations.
+ */
+declare const presentationEngine: TransformEngine;
+//#endregion
+export { createPresentationEngine, presentationEngine };
+//# sourceMappingURL=engine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","names":[],"sources":["../../src/registry/engine.ts"],"mappings":";;;;;;AAcA;;iBAAgB,wBAAA,CACd,kBAAA,GAAqB,YAAA,GACpB,eAAA;;;;;cAqBU,kBAAA,EAAkB,eAAA"}

package/dist/registry/engine.js

@@ -0,0 +1,24 @@
+import { componentMap } from "./registry.js";
+import { createDefaultTransformEngine, registerBasicValidation, registerDefaultReactRenderer, registerReactToMarkdownRenderer } from "@contractspec/lib.contracts/presentations";
+
+//#region src/registry/engine.ts
+/**
+* Create and configure the TransformEngine for web-landing presentations.
+* Includes React and Markdown renderers with component map registration.
+*/
+function createPresentationEngine(customComponentMap) {
+	const engine = createDefaultTransformEngine();
+	registerDefaultReactRenderer(engine);
+	registerBasicValidation(engine);
+	registerReactToMarkdownRenderer(engine, customComponentMap ?? componentMap);
+	return engine;
+}
+/**
+* Singleton engine instance for the app.
+* Use this for rendering presentations.
+*/
+const presentationEngine = createPresentationEngine();
+
+//#endregion
+export { createPresentationEngine, presentationEngine };
+//# sourceMappingURL=engine.js.map

package/dist/registry/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","names":[],"sources":["../../src/registry/engine.ts"],"sourcesContent":["import {\n  createDefaultTransformEngine,\n  registerBasicValidation,\n  registerDefaultReactRenderer,\n  registerReactToMarkdownRenderer,\n  type TransformEngine,\n} from '@contractspec/lib.contracts/presentations';\nimport { componentMap } from './registry';\nimport type { ComponentMap } from './types';\n\n/**\n * Create and configure the TransformEngine for web-landing presentations.\n * Includes React and Markdown renderers with component map registration.\n */\nexport function createPresentationEngine(\n  customComponentMap?: ComponentMap\n): TransformEngine {\n  const engine = createDefaultTransformEngine();\n\n  // Register React renderer\n  registerDefaultReactRenderer(engine);\n\n  // Register basic validation\n  registerBasicValidation(engine);\n\n  // Register React-to-markdown renderer with component map\n  // This enables rendering React components to markdown for LLM consumption\n  const mapToUse = customComponentMap ?? componentMap;\n  registerReactToMarkdownRenderer(engine, mapToUse);\n\n  return engine;\n}\n\n/**\n * Singleton engine instance for the app.\n * Use this for rendering presentations.\n */\nexport const presentationEngine = createPresentationEngine();\n"],"mappings":";;;;;;;;AAcA,SAAgB,yBACd,oBACiB;CACjB,MAAM,SAAS,8BAA8B;AAG7C,8BAA6B,OAAO;AAGpC,yBAAwB,OAAO;AAK/B,iCAAgC,QADf,sBAAsB,aACU;AAEjD,QAAO;;;;;;AAOT,MAAa,qBAAqB,0BAA0B"}

package/dist/registry/factory.d.ts

@@ -0,0 +1,64 @@
+import { PresentationSpec, PresentationTarget } from "@contractspec/lib.contracts/presentations";
+import { Owner, Stability, Tag } from "@contractspec/lib.contracts/ownership";
+
+//#region src/registry/factory.d.ts
+/**
+ * Options for creating a React component presentation.
+ */
+interface CreateComponentPresentationOptions {
+  /** Fully-qualified spec key (e.g., "web-landing.home") */
+  key: string;
+  /** Component key resolved by host componentMap */
+  componentKey: string;
+  /** Short human-friendly summary */
+  description: string;
+  /** Business goal: why this exists */
+  goal: string;
+  /** Background, constraints, scope edges */
+  context: string;
+  /** Breaking changes => bump version @default '1.0.0' */
+  version?: string;
+  /** Lifecycle marker @default StabilityEnum.Stable */
+  stability?: Stability;
+  /** Owners for CODEOWNERS / on-call @default [OwnersEnum.PlatformCore] */
+  owners?: Owner[];
+  /** Search tags, grouping, docs navigation @default [] */
+  tags?: Tag[];
+  /** Render targets @default ['react', 'markdown'] */
+  targets?: PresentationTarget[];
+}
+/**
+ * Creates a PresentationSpec for a React component with all required metadata.
+ *
+ * @param opts - Configuration options for the presentation
+ * @returns A fully-typed PresentationSpec
+ */
+declare function createComponentPresentation(opts: CreateComponentPresentationOptions): PresentationSpec;
+/**
+ * Helper to derive tags from a URL path.
+ * Example: "/docs/libraries/ai-agent" -> ["docs", "libraries", "ai-agent"]
+ */
+declare function tagsFromPath(path: string): Tag[];
+/**
+ * Default goal for documentation pages.
+ */
+declare const DOCS_GOAL = "Educate developers on ContractSpec usage and concepts";
+/**
+ * Default context for documentation pages.
+ */
+declare const DOCS_CONTEXT = "Part of the ContractSpec documentation site, rendered on contractspec.io";
+/**
+ * Default goal for marketing/landing pages.
+ */
+declare const MARKETING_GOAL = "Convert visitors into ContractSpec users and customers";
+/**
+ * Default context for marketing pages.
+ */
+declare const MARKETING_CONTEXT = "Marketing content on contractspec.io, designed for conversion";
+/**
+ * Default tags for documentation pages.
+ */
+declare const DOCS_TAGS: Tag[];
+//#endregion
+export { CreateComponentPresentationOptions, DOCS_CONTEXT, DOCS_GOAL, DOCS_TAGS, MARKETING_CONTEXT, MARKETING_GOAL, createComponentPresentation, tagsFromPath };
+//# sourceMappingURL=factory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","names":[],"sources":["../../src/registry/factory.ts"],"mappings":";;;;;;AAiBA;UAAiB,kCAAA;;EAEf,GAAA;EAcS;EAZT,YAAA;EAgBU;EAdV,WAAA;EAc4B;EAZ5B,IAAA;EAJA;EAMA,OAAA;EAFA;EAIA,OAAA;EAAA;EAEA,SAAA,GAAY,SAAA;EAAA;EAEZ,MAAA,GAAS,KAAA;EAAA;EAET,IAAA,GAAO,GAAA;EAAA;EAEP,OAAA,GAAU,kBAAA;AAAA;;;AASZ;;;;iBAAgB,2BAAA,CACd,IAAA,EAAM,kCAAA,GACL,gBAAA;;;;;iBA2Ba,YAAA,CAAa,IAAA,WAAe,GAAA;;;;cAU/B,SAAA;AAAb;;;AAAA,cAMa,YAAA;;AAAb;;cAMa,cAAA;;;AAAb;cAMa,iBAAA;;;;cAMA,SAAA,EAAW,GAAA"}

package/dist/registry/factory.js

@@ -0,0 +1,61 @@
+import { OwnersEnum, StabilityEnum, TagsEnum } from "@contractspec/lib.contracts/ownership";
+
+//#region src/registry/factory.ts
+/**
+* Creates a PresentationSpec for a React component with all required metadata.
+*
+* @param opts - Configuration options for the presentation
+* @returns A fully-typed PresentationSpec
+*/
+function createComponentPresentation(opts) {
+	const source = {
+		type: "component",
+		framework: "react",
+		componentKey: opts.componentKey
+	};
+	return {
+		meta: {
+			key: opts.key,
+			version: opts.version ?? "1.0.0",
+			description: opts.description,
+			goal: opts.goal,
+			context: opts.context,
+			stability: opts.stability ?? StabilityEnum.Stable,
+			owners: opts.owners ?? [OwnersEnum.PlatformCore],
+			tags: opts.tags ?? []
+		},
+		source,
+		targets: opts.targets ?? ["react", "markdown"]
+	};
+}
+/**
+* Helper to derive tags from a URL path.
+* Example: "/docs/libraries/ai-agent" -> ["docs", "libraries", "ai-agent"]
+*/
+function tagsFromPath(path) {
+	return path.split("/").filter((segment) => segment.length > 0).map((segment) => segment);
+}
+/**
+* Default goal for documentation pages.
+*/
+const DOCS_GOAL = "Educate developers on ContractSpec usage and concepts";
+/**
+* Default context for documentation pages.
+*/
+const DOCS_CONTEXT = "Part of the ContractSpec documentation site, rendered on contractspec.io";
+/**
+* Default goal for marketing/landing pages.
+*/
+const MARKETING_GOAL = "Convert visitors into ContractSpec users and customers";
+/**
+* Default context for marketing pages.
+*/
+const MARKETING_CONTEXT = "Marketing content on contractspec.io, designed for conversion";
+/**
+* Default tags for documentation pages.
+*/
+const DOCS_TAGS = [TagsEnum.Docs];
+
+//#endregion
+export { DOCS_CONTEXT, DOCS_GOAL, DOCS_TAGS, MARKETING_CONTEXT, MARKETING_GOAL, createComponentPresentation, tagsFromPath };
+//# sourceMappingURL=factory.js.map

package/dist/registry/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","names":[],"sources":["../../src/registry/factory.ts"],"sourcesContent":["import {\n  type Owner,\n  OwnersEnum,\n  type Stability,\n  StabilityEnum,\n  type Tag,\n  TagsEnum,\n} from '@contractspec/lib.contracts/ownership';\nimport type {\n  PresentationSourceComponentReact,\n  PresentationSpec,\n  PresentationTarget,\n} from '@contractspec/lib.contracts/presentations';\n\n/**\n * Options for creating a React component presentation.\n */\nexport interface CreateComponentPresentationOptions {\n  /** Fully-qualified spec key (e.g., \"web-landing.home\") */\n  key: string;\n  /** Component key resolved by host componentMap */\n  componentKey: string;\n  /** Short human-friendly summary */\n  description: string;\n  /** Business goal: why this exists */\n  goal: string;\n  /** Background, constraints, scope edges */\n  context: string;\n  /** Breaking changes => bump version @default '1.0.0' */\n  version?: string;\n  /** Lifecycle marker @default StabilityEnum.Stable */\n  stability?: Stability;\n  /** Owners for CODEOWNERS / on-call @default [OwnersEnum.PlatformCore] */\n  owners?: Owner[];\n  /** Search tags, grouping, docs navigation @default [] */\n  tags?: Tag[];\n  /** Render targets @default ['react', 'markdown'] */\n  targets?: PresentationTarget[];\n}\n\n/**\n * Creates a PresentationSpec for a React component with all required metadata.\n *\n * @param opts - Configuration options for the presentation\n * @returns A fully-typed PresentationSpec\n */\nexport function createComponentPresentation(\n  opts: CreateComponentPresentationOptions\n): PresentationSpec {\n  const source: PresentationSourceComponentReact = {\n    type: 'component',\n    framework: 'react',\n    componentKey: opts.componentKey,\n  };\n\n  return {\n    meta: {\n      key: opts.key,\n      version: opts.version ?? '1.0.0',\n      description: opts.description,\n      goal: opts.goal,\n      context: opts.context,\n      stability: opts.stability ?? StabilityEnum.Stable,\n      owners: opts.owners ?? [OwnersEnum.PlatformCore],\n      tags: opts.tags ?? [],\n    },\n    source,\n    targets: opts.targets ?? ['react', 'markdown'],\n  };\n}\n\n/**\n * Helper to derive tags from a URL path.\n * Example: \"/docs/libraries/ai-agent\" -> [\"docs\", \"libraries\", \"ai-agent\"]\n */\nexport function tagsFromPath(path: string): Tag[] {\n  return path\n    .split('/')\n    .filter((segment) => segment.length > 0)\n    .map((segment) => segment as Tag);\n}\n\n/**\n * Default goal for documentation pages.\n */\nexport const DOCS_GOAL =\n  'Educate developers on ContractSpec usage and concepts';\n\n/**\n * Default context for documentation pages.\n */\nexport const DOCS_CONTEXT =\n  'Part of the ContractSpec documentation site, rendered on contractspec.io';\n\n/**\n * Default goal for marketing/landing pages.\n */\nexport const MARKETING_GOAL =\n  'Convert visitors into ContractSpec users and customers';\n\n/**\n * Default context for marketing pages.\n */\nexport const MARKETING_CONTEXT =\n  'Marketing content on contractspec.io, designed for conversion';\n\n/**\n * Default tags for documentation pages.\n */\nexport const DOCS_TAGS: Tag[] = [TagsEnum.Docs];\n"],"mappings":";;;;;;;;;AA8CA,SAAgB,4BACd,MACkB;CAClB,MAAM,SAA2C;EAC/C,MAAM;EACN,WAAW;EACX,cAAc,KAAK;EACpB;AAED,QAAO;EACL,MAAM;GACJ,KAAK,KAAK;GACV,SAAS,KAAK,WAAW;GACzB,aAAa,KAAK;GAClB,MAAM,KAAK;GACX,SAAS,KAAK;GACd,WAAW,KAAK,aAAa,cAAc;GAC3C,QAAQ,KAAK,UAAU,CAAC,WAAW,aAAa;GAChD,MAAM,KAAK,QAAQ,EAAE;GACtB;EACD;EACA,SAAS,KAAK,WAAW,CAAC,SAAS,WAAW;EAC/C;;;;;;AAOH,SAAgB,aAAa,MAAqB;AAChD,QAAO,KACJ,MAAM,IAAI,CACV,QAAQ,YAAY,QAAQ,SAAS,EAAE,CACvC,KAAK,YAAY,QAAe;;;;;AAMrC,MAAa,YACX;;;;AAKF,MAAa,eACX;;;;AAKF,MAAa,iBACX;;;;AAKF,MAAa,oBACX;;;;AAKF,MAAa,YAAmB,CAAC,SAAS,KAAK"}

package/dist/registry/index.d.ts

@@ -0,0 +1,8 @@
+import { ComponentMap, RoutePresentation } from "./types.js";
+import { createPresentationEngine, presentationEngine } from "./engine.js";
+import { CreateComponentPresentationOptions, DOCS_CONTEXT, DOCS_GOAL, DOCS_TAGS, MARKETING_CONTEXT, MARKETING_GOAL, createComponentPresentation, tagsFromPath } from "./factory.js";
+import { componentMap, getAllPresentationRoutes, getPresentationForRoute, hasPresentation, presentationRegistry } from "./registry.js";
+import { docsComponentMap, docsPresentations } from "./registry-docs.js";
+import { landingComponentMap, landingPresentations, learningPresentations } from "./registry-landing.js";
+import { AIChatProvider, aiChatProviders, getMarkdownUrl, renderPresentationToMarkdown, renderPresentationToReact } from "./utils.js";
+export { AIChatProvider, ComponentMap, CreateComponentPresentationOptions, DOCS_CONTEXT, DOCS_GOAL, DOCS_TAGS, MARKETING_CONTEXT, MARKETING_GOAL, RoutePresentation, aiChatProviders, componentMap, createComponentPresentation, createPresentationEngine, docsComponentMap, docsPresentations, getAllPresentationRoutes, getMarkdownUrl, getPresentationForRoute, hasPresentation, landingComponentMap, landingPresentations, learningPresentations, presentationEngine, presentationRegistry, renderPresentationToMarkdown, renderPresentationToReact, tagsFromPath };

package/dist/registry/index.js

@@ -0,0 +1,8 @@
+import { DOCS_CONTEXT, DOCS_GOAL, DOCS_TAGS, MARKETING_CONTEXT, MARKETING_GOAL, createComponentPresentation, tagsFromPath } from "./factory.js";
+import { docsComponentMap, docsPresentations } from "./registry-docs.js";
+import { landingComponentMap, landingPresentations, learningPresentations } from "./registry-landing.js";
+import { componentMap, getAllPresentationRoutes, getPresentationForRoute, hasPresentation, presentationRegistry } from "./registry.js";
+import { createPresentationEngine, presentationEngine } from "./engine.js";
+import { aiChatProviders, getMarkdownUrl, renderPresentationToMarkdown, renderPresentationToReact } from "./utils.js";
+
+export { DOCS_CONTEXT, DOCS_GOAL, DOCS_TAGS, MARKETING_CONTEXT, MARKETING_GOAL, aiChatProviders, componentMap, createComponentPresentation, createPresentationEngine, docsComponentMap, docsPresentations, getAllPresentationRoutes, getMarkdownUrl, getPresentationForRoute, hasPresentation, landingComponentMap, landingPresentations, learningPresentations, presentationEngine, presentationRegistry, renderPresentationToMarkdown, renderPresentationToReact, tagsFromPath };

package/dist/registry/registry-docs.d.ts

@@ -0,0 +1,15 @@
+import { ComponentMap } from "./types.js";
+import { PresentationSpec } from "@contractspec/lib.contracts/presentations";
+
+//#region src/registry/registry-docs.d.ts
+/**
+ * Component map for documentation page React rendering.
+ */
+declare const docsComponentMap: ComponentMap;
+/**
+ * Presentation specs for documentation pages.
+ */
+declare const docsPresentations: [string, PresentationSpec][];
+//#endregion
+export { docsComponentMap, docsPresentations };
+//# sourceMappingURL=registry-docs.d.ts.map

package/dist/registry/registry-docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-docs.d.ts","names":[],"sources":["../../src/registry/registry-docs.ts"],"mappings":";;;;;;AAsIA;cAAa,gBAAA,EAAkB,YAAA;;;;cAkIlB,iBAAA,WAA4B,gBAAA"}