@contractspec/bundle.marketing 1.12.0

package/src/registry/registry-landing.ts

@@ -0,0 +1,118 @@
+import { TagsEnum } from '@contractspec/lib.contracts/ownership';
+import type { PresentationSpec } from '@contractspec/lib.contracts/presentations';
+import {
+  createComponentPresentation,
+  MARKETING_CONTEXT,
+  MARKETING_GOAL,
+} from './factory';
+import type { ComponentMap } from './types';
+
+// Import page components - Root/Marketing pages
+import {
+  ChangelogPage,
+  ContactClient,
+  LandingPage,
+  PricingClient,
+  ProductClientPage,
+} from '../components/marketing';
+
+/**
+ * Component map for landing/marketing page React rendering.
+ */
+export const landingComponentMap: ComponentMap = {
+  LandingPage,
+  PricingPage: PricingClient,
+  ProductPage: ProductClientPage,
+  ContactPage: ContactClient,
+  ChangelogPage,
+};
+
+/**
+ * Presentation specs for landing/marketing pages.
+ */
+export const landingPresentations: [string, PresentationSpec][] = [
+  [
+    '/',
+    createComponentPresentation({
+      key: 'web-landing.home',
+      componentKey: 'LandingPage',
+      description:
+        'ContractSpec landing page - Stabilize your AI-generated code',
+      goal: MARKETING_GOAL,
+      context: MARKETING_CONTEXT,
+      tags: ['landing', 'home'],
+    }),
+  ],
+  [
+    '/pricing',
+    createComponentPresentation({
+      key: 'web-landing.pricing',
+      componentKey: 'PricingPage',
+      description: 'ContractSpec pricing information',
+      goal: 'Help visitors understand pricing and choose a plan',
+      context: MARKETING_CONTEXT,
+      tags: ['pricing', 'plans'],
+    }),
+  ],
+  [
+    '/product',
+    createComponentPresentation({
+      key: 'web-landing.product',
+      componentKey: 'ProductPage',
+      description: 'ContractSpec product overview',
+      goal: 'Explain product features and benefits',
+      context: MARKETING_CONTEXT,
+      tags: ['product', 'features'],
+    }),
+  ],
+  [
+    '/contact',
+    createComponentPresentation({
+      key: 'web-landing.contact',
+      componentKey: 'ContactPage',
+      description: 'Contact ContractSpec team',
+      goal: 'Enable visitors to reach the ContractSpec team',
+      context: MARKETING_CONTEXT,
+      tags: ['contact', 'support'],
+    }),
+  ],
+  [
+    '/changelog',
+    createComponentPresentation({
+      key: 'web-landing.changelog',
+      componentKey: 'ChangelogPage',
+      description: 'ContractSpec changelog and release notes',
+      goal: 'Keep users informed about changes and updates',
+      context: MARKETING_CONTEXT,
+      tags: ['changelog', 'releases'],
+    }),
+  ],
+];
+
+/**
+ * Presentation specs for learning journey pages.
+ */
+export const learningPresentations: [string, PresentationSpec][] = [
+  [
+    '/learning',
+    createComponentPresentation({
+      key: 'web-landing.learning.tracks',
+      componentKey: 'LearningTrackList',
+      description: 'Learning tracks list',
+      goal: 'Guide users through ContractSpec learning paths',
+      context: 'Part of the onboarding and education experience',
+      tags: [TagsEnum.Guide, 'learning', 'onboarding'],
+    }),
+  ],
+  [
+    '/learning/:trackId',
+    createComponentPresentation({
+      key: 'web-landing.learning.track-detail',
+      componentKey: 'LearningTrackDetail',
+      description: 'Learning track detail view',
+      goal: 'Show progress and content for a specific learning track',
+      context: 'Part of the onboarding and education experience',
+      tags: [TagsEnum.Guide, 'learning', 'onboarding'],
+    }),
+  ],
+];

package/src/registry/registry.ts

@@ -0,0 +1,85 @@
+import {
+  docBlocksToPresentationRoutes,
+  type DocPresentationRoute,
+  listRegisteredDocBlocks,
+  metaDocs,
+  techContractsDocs,
+} from '@contractspec/lib.contracts/docs';
+import type { PresentationSpec } from '@contractspec/lib.contracts/presentations';
+import { opsDocBlocks } from '@contractspec/bundle.library/components/docs/ops/ops.docs';
+import { productDocs } from '@contractspec/bundle.library/components/docs/product/product.docblocks';
+import { techContractsDocBlocks } from '@contractspec/bundle.library/components/docs/tech/contracts/tech-docs.docblocks';
+import type { ComponentMap } from './types';
+
+// Import sub-registries
+import { docsComponentMap, docsPresentations } from './registry-docs';
+import {
+  landingComponentMap,
+  landingPresentations,
+  learningPresentations,
+} from './registry-landing';
+
+/**
+ * Merged component map for React rendering.
+ * Maps componentKey to actual React components.
+ */
+export const componentMap: ComponentMap = {
+  ...landingComponentMap,
+  ...docsComponentMap,
+};
+
+/**
+ * Presentation registry for all static pages.
+ * Maps route paths to PresentationSpec definitions.
+ */
+export const presentationRegistry = new Map<string, PresentationSpec>([
+  ...landingPresentations,
+  ...learningPresentations,
+  ...docsPresentations,
+]);
+
+// Add docBlocks-based presentations
+const docRoutes: DocPresentationRoute[] = docBlocksToPresentationRoutes(
+  [
+    ...opsDocBlocks,
+    ...productDocs,
+    ...techContractsDocBlocks,
+    ...techContractsDocs,
+    ...metaDocs,
+    ...listRegisteredDocBlocks(),
+  ],
+  {
+    namespace: 'web-landing.docs',
+    routePrefix: '/docs',
+  }
+);
+
+for (const { route, descriptor } of docRoutes) {
+  presentationRegistry.set(route, descriptor);
+}
+
+/**
+ * Get presentation descriptor for a given route.
+ * Returns undefined if no presentation exists for the route.
+ */
+export function getPresentationForRoute(
+  route: string
+): PresentationSpec | undefined {
+  // Normalize route (remove trailing slash, handle root)
+  const normalizedRoute = route === '/' ? '/' : route.replace(/\/$/, '');
+  return presentationRegistry.get(normalizedRoute);
+}
+
+/**
+ * Check if a route has a presentation descriptor.
+ */
+export function hasPresentation(route: string): boolean {
+  return getPresentationForRoute(route) !== undefined;
+}
+
+/**
+ * Get all registered routes with presentations.
+ */
+export function getAllPresentationRoutes(): string[] {
+  return Array.from(presentationRegistry.keys());
+}

package/src/registry/types.ts

@@ -0,0 +1,17 @@
+import type { PresentationSpec } from '@contractspec/lib.contracts/presentations';
+import type React from 'react';
+
+/**
+ * Component map for React rendering.
+ * Maps componentKey to actual React components.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Generic component map
+export type ComponentMap = Record<string, React.ComponentType<any>>;
+
+/**
+ * Route-to-presentation mapping.
+ */
+export interface RoutePresentation {
+  route: string;
+  descriptor: PresentationSpec;
+}

package/src/registry/utils.ts

@@ -0,0 +1,99 @@
+import { renderFeaturePresentation } from '@contractspec/lib.contracts/client/react/feature-render';
+import type { PresentationSpec } from '@contractspec/lib.contracts/presentations';
+import type React from 'react';
+import { presentationEngine } from './engine';
+import { componentMap } from './registry';
+import type { ComponentMap } from './types';
+
+/**
+ * Render a presentation descriptor to markdown.
+ * Returns the markdown content as a string.
+ */
+export async function renderPresentationToMarkdown(
+  descriptor: PresentationSpec
+): Promise<string> {
+  const result = await presentationEngine.render<{
+    mimeType: string;
+    body: string;
+  }>('markdown', descriptor);
+
+  return result.body;
+}
+
+/**
+ * Render a presentation descriptor to React element.
+ * Returns the React element or null if component not found.
+ */
+export async function renderPresentationToReact(
+  descriptor: PresentationSpec,
+  customComponentMap?: ComponentMap
+): Promise<React.ReactElement | null> {
+  const map = customComponentMap ?? componentMap;
+  const element = await renderFeaturePresentation(
+    presentationEngine,
+    'react',
+    descriptor,
+    {
+      componentMap: map,
+    }
+  );
+
+  if (element && typeof element === 'object' && 'type' in element) {
+    return element as React.ReactElement;
+  }
+
+  return null;
+}
+
+/**
+ * Get markdown URL for a given route.
+ * Uses llms. subdomain and .md extension.
+ */
+export function getMarkdownUrl(route: string, baseUrl?: string): string {
+  const base = baseUrl ?? 'https://contractspec.io/mdx';
+  const llmsBase = base.replace('contractspec.io', 'llms.contractspec.io');
+
+  // Normalize route
+  const normalizedRoute = route === '/' ? '/' : route.replace(/\/$/, '');
+  return `${llmsBase}${normalizedRoute}`;
+
+  // Add .md extension if not root
+  // const path = normalizedRoute === '/' ? '/index.md' : `${normalizedRoute}.md`;
+  // return `${llmsBase}${path}`;
+}
+
+/**
+ * Get AI chat URLs for various providers.
+ */
+export interface AIChatProvider {
+  name: string;
+  getUrl: (url: string) => string;
+}
+
+export const aiChatProviders: AIChatProvider[] = [
+  {
+    name: 'ChatGPT',
+    getUrl: (url: string) =>
+      `https://chatgpt.com/?q=${encodeURIComponent(url)}`,
+  },
+  {
+    name: 'Claude',
+    getUrl: (url: string) =>
+      `https://claude.ai/new?url=${encodeURIComponent(url)}`,
+  },
+  {
+    name: 'Grok',
+    getUrl: (url: string) =>
+      `https://x.com/i/grok?url=${encodeURIComponent(url)}`,
+  },
+  {
+    name: 'Mistral',
+    getUrl: (url: string) =>
+      `https://mistral.ai/chat?url=${encodeURIComponent(url)}`,
+  },
+  {
+    name: 'Perplexity',
+    getUrl: (url: string) =>
+      `https://www.perplexity.ai/?q=${encodeURIComponent(url)}`,
+  },
+];

package/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "extends": "@contractspec/tool.typescript/react-library.json",
+  "include": ["src/**/*"],
+  "compilerOptions": {
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "jsx": "react-jsx",
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  }
+}