@contractspec/bundle.library 1.12.0 → 1.13.0

package/dist/node/components/docs/ecosystem/index.js

@@ -0,0 +1,614 @@
+// src/components/docs/ecosystem/IntegrationsPage.tsx
+import { CodeBlock } from "@contractspec/lib.design-system";
+import Link from "@contractspec/lib.ui-link";
+import { ChevronRight } from "lucide-react";
+import { jsxDEV } from "react/jsx-dev-runtime";
+function EcosystemIntegrationsPage() {
+  return /* @__PURE__ */ jsxDEV("div", {
+    className: "space-y-8",
+    children: [
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "space-y-3",
+        children: [
+          /* @__PURE__ */ jsxDEV("h1", {
+            className: "text-4xl font-bold",
+            children: "Integrations"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV("p", {
+            className: "text-muted-foreground text-lg",
+            children: "Reference integrations show how to extend ContractSpec with real-world adapters and generators."
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "card-subtle space-y-4 p-6",
+        children: [
+          /* @__PURE__ */ jsxDEV("h2", {
+            className: "text-2xl font-bold",
+            children: "Reference plugin"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV("p", {
+            className: "text-muted-foreground text-sm",
+            children: "The example markdown generator plugin ships as a working reference implementation."
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(CodeBlock, {
+            language: "bash",
+            filename: "install-example",
+            code: `bun add @contractspec/lib.plugin.example-generator
+
+# Or in a workspace
+bun add -D @contractspec/lib.plugin.example-generator`
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "card-subtle space-y-4 p-6",
+        children: [
+          /* @__PURE__ */ jsxDEV("h2", {
+            className: "text-2xl font-bold",
+            children: "Providers and adapters"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV("ul", {
+            className: "text-muted-foreground space-y-2 text-sm",
+            children: [
+              /* @__PURE__ */ jsxDEV("li", {
+                children: "Payments: Stripe"
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV("li", {
+                children: "Email: Postmark, Gmail"
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV("li", {
+                children: "Voice: ElevenLabs"
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV("li", {
+                children: "Vector DB: Qdrant"
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV("li", {
+                children: "Storage: GCS"
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this),
+          /* @__PURE__ */ jsxDEV("p", {
+            className: "text-muted-foreground text-sm",
+            children: "Use provider modules as inspiration for adapter plugins."
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "flex items-center gap-4 pt-4",
+        children: [
+          /* @__PURE__ */ jsxDEV(Link, {
+            href: "/docs/ecosystem/registry",
+            className: "btn-primary",
+            children: [
+              "Registry resolution ",
+              /* @__PURE__ */ jsxDEV(ChevronRight, {
+                size: 16
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this),
+          /* @__PURE__ */ jsxDEV(Link, {
+            href: "/docs/ecosystem/templates",
+            className: "btn-ghost",
+            children: "Plugin templates"
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+
+// src/components/docs/ecosystem/PluginsPage.tsx
+import { CodeBlock as CodeBlock2 } from "@contractspec/lib.design-system";
+import Link2 from "@contractspec/lib.ui-link";
+import { ChevronRight as ChevronRight2 } from "lucide-react";
+import { jsxDEV as jsxDEV2 } from "react/jsx-dev-runtime";
+function EcosystemPluginsPage() {
+  return /* @__PURE__ */ jsxDEV2("div", {
+    className: "space-y-8",
+    children: [
+      /* @__PURE__ */ jsxDEV2("div", {
+        className: "space-y-3",
+        children: [
+          /* @__PURE__ */ jsxDEV2("h1", {
+            className: "text-4xl font-bold",
+            children: "Plugin API"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV2("p", {
+            className: "text-muted-foreground text-lg",
+            children: "Extend ContractSpec with generators, validators, adapters, formatters, and registry resolvers."
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV2("div", {
+        className: "card-subtle space-y-4 p-6",
+        children: [
+          /* @__PURE__ */ jsxDEV2("h2", {
+            className: "text-2xl font-bold",
+            children: "Core capabilities"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV2("ul", {
+            className: "text-muted-foreground space-y-2 text-sm",
+            children: [
+              /* @__PURE__ */ jsxDEV2("li", {
+                children: "Generators for code, docs, and schemas."
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV2("li", {
+                children: "Validators for policy checks and compliance gates."
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV2("li", {
+                children: "Adapters for framework and runtime integration."
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV2("li", {
+                children: "Formatters and diff renderers for deterministic output."
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV2("li", {
+                children: "Registry resolvers for local and remote plugin discovery."
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV2("div", {
+        className: "space-y-6",
+        children: [
+          /* @__PURE__ */ jsxDEV2("div", {
+            className: "space-y-3",
+            children: [
+              /* @__PURE__ */ jsxDEV2("h2", {
+                className: "text-2xl font-bold",
+                children: "Plugin interface"
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV2("p", {
+                className: "text-muted-foreground text-sm",
+                children: "Define capabilities and lifecycle hooks in a single plugin entrypoint."
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV2(CodeBlock2, {
+                language: "typescript",
+                filename: "plugin.ts",
+                code: `import type {
+  ContractSpecPlugin,
+  PluginContext,
+  GeneratorCapability,
+} from "@contractspec/lib.plugins";
+
+export const MarkdownGeneratorPlugin: ContractSpecPlugin = {
+  meta: {
+    id: "markdown-generator",
+    version: "1.0.0",
+    type: "generator",
+    provides: ["docs"],
+  },
+  register(context: PluginContext) {
+    const generator: GeneratorCapability = {
+      id: "markdown",
+      description: "Generate Markdown docs",
+      generate: async (specs) => {
+        // Implementation...
+      },
+    };
+
+    context.generators.register(generator);
+  },
+};`
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this),
+          /* @__PURE__ */ jsxDEV2("div", {
+            className: "space-y-3",
+            children: [
+              /* @__PURE__ */ jsxDEV2("h2", {
+                className: "text-2xl font-bold",
+                children: "Lifecycle hooks"
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV2("p", {
+                className: "text-muted-foreground text-sm",
+                children: "Use lifecycle hooks to configure, validate, and dispose resources."
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV2(CodeBlock2, {
+                language: "typescript",
+                filename: "lifecycle.ts",
+                code: `export const MarkdownGeneratorPlugin: ContractSpecPlugin = {
+  meta: {
+    id: "markdown-generator",
+    version: "1.0.0",
+    type: "generator",
+    provides: ["docs"],
+  },
+  register(context) {
+    // Register capabilities
+  },
+  configure(options, context) {
+    // Optional: apply workspace configuration
+  },
+  validate(specs, context) {
+    // Optional: add validation checks
+  },
+  generate(specs, context) {
+    // Required: emit outputs
+  },
+  dispose() {
+    // Optional: cleanup
+  },
+};`
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this),
+          /* @__PURE__ */ jsxDEV2("div", {
+            className: "space-y-3",
+            children: [
+              /* @__PURE__ */ jsxDEV2("h2", {
+                className: "text-2xl font-bold",
+                children: "Register a plugin"
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV2("p", {
+                className: "text-muted-foreground text-sm",
+                children: [
+                  "Configure plugins in ",
+                  /* @__PURE__ */ jsxDEV2("code", {
+                    children: ".contractsrc.json"
+                  }, undefined, false, undefined, this),
+                  " to load them in the CLI and runtime."
+                ]
+              }, undefined, true, undefined, this),
+              /* @__PURE__ */ jsxDEV2(CodeBlock2, {
+                language: "json",
+                filename: ".contractsrc.json",
+                code: `{
+  "plugins": [
+    {
+      "id": "markdown-generator",
+      "package": "@contractspec/plugin.markdown",
+      "capabilities": ["generator"],
+      "options": {
+        "outputDir": "./docs/generated",
+        "format": "table"
+      }
+    }
+  ]
+}`
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV2("div", {
+        className: "flex items-center gap-4 pt-4",
+        children: [
+          /* @__PURE__ */ jsxDEV2(Link2, {
+            href: "/docs/ecosystem/templates",
+            className: "btn-primary",
+            children: [
+              "Plugin templates ",
+              /* @__PURE__ */ jsxDEV2(ChevronRight2, {
+                size: 16
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this),
+          /* @__PURE__ */ jsxDEV2(Link2, {
+            href: "/docs/ecosystem/integrations",
+            className: "btn-ghost",
+            children: "Integrations"
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+
+// src/components/docs/ecosystem/RegistryPage.tsx
+import { CodeBlock as CodeBlock3 } from "@contractspec/lib.design-system";
+import Link3 from "@contractspec/lib.ui-link";
+import { ChevronRight as ChevronRight3 } from "lucide-react";
+import { jsxDEV as jsxDEV3 } from "react/jsx-dev-runtime";
+function EcosystemRegistryPage() {
+  return /* @__PURE__ */ jsxDEV3("div", {
+    className: "space-y-8",
+    children: [
+      /* @__PURE__ */ jsxDEV3("div", {
+        className: "space-y-3",
+        children: [
+          /* @__PURE__ */ jsxDEV3("h1", {
+            className: "text-4xl font-bold",
+            children: "Registry resolution"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV3("p", {
+            className: "text-muted-foreground text-lg",
+            children: "Resolve plugins from local workspaces, npm packages, or remote registries."
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV3("div", {
+        className: "card-subtle space-y-4 p-6",
+        children: [
+          /* @__PURE__ */ jsxDEV3("h2", {
+            className: "text-2xl font-bold",
+            children: "Resolution order"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV3("p", {
+            className: "text-muted-foreground text-sm",
+            children: "Control where ContractSpec loads plugins and how versions are resolved."
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV3(CodeBlock3, {
+            language: "json",
+            filename: ".contractsrc.json",
+            code: `{
+  "plugins": [
+    {
+      "id": "markdown-generator",
+      "package": "@contractspec/plugin.markdown-generator",
+      "capabilities": ["generator"],
+      "options": {
+        "outputDir": "./docs/generated",
+        "format": "table"
+      }
+    }
+  ],
+  "pluginRegistry": {
+    "resolutionOrder": ["workspace", "npm", "remote"],
+    "allowPrerelease": false,
+    "sources": {
+      "remote": "https://registry.contractspec.io"
+    }
+  }
+}`
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV3("div", {
+        className: "card-subtle space-y-4 p-6",
+        children: [
+          /* @__PURE__ */ jsxDEV3("h2", {
+            className: "text-2xl font-bold",
+            children: "Custom registry resolvers"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV3("p", {
+            className: "text-muted-foreground text-sm",
+            children: "Register resolver plugins to load plugins from private registries."
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV3(CodeBlock3, {
+            language: "typescript",
+            filename: "registry-resolver.ts",
+            code: `import type { RegistryResolverPlugin } from "@contractspec/lib.plugins";
+
+export const PrivateRegistryResolver: RegistryResolverPlugin = {
+  meta: {
+    id: "private-registry",
+    version: "1.0.0",
+    type: "registryResolver",
+    provides: ["private-registry"],
+  },
+  resolve: async (request) => {
+    // Fetch plugin package metadata from private registry
+    const result = await fetch(
+      "https://registry.acme.io/" + request.package
+    );
+    return result.json();
+  },
+};`
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV3("div", {
+        className: "flex items-center gap-4 pt-4",
+        children: [
+          /* @__PURE__ */ jsxDEV3(Link3, {
+            href: "/docs/ecosystem/integrations",
+            className: "btn-primary",
+            children: [
+              "Integrations ",
+              /* @__PURE__ */ jsxDEV3(ChevronRight3, {
+                size: 16
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this),
+          /* @__PURE__ */ jsxDEV3(Link3, {
+            href: "/docs/ecosystem/templates",
+            className: "btn-ghost",
+            children: "Plugin templates"
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+
+// src/components/docs/shared/StudioPrompt.tsx
+import Link4 from "@contractspec/lib.ui-link";
+import { jsxDEV as jsxDEV4 } from "react/jsx-dev-runtime";
+function StudioPrompt({
+  title = "Need managed policy gates and approvals?",
+  body = "ContractSpec Studio adds policy gates, remote registry workflows, and audit trails when you are ready to scale adoption.",
+  ctaLabel = "Join Studio waitlist",
+  href = "/contact#waitlist"
+}) {
+  return /* @__PURE__ */ jsxDEV4("div", {
+    className: "card-subtle space-y-3 p-6",
+    children: [
+      /* @__PURE__ */ jsxDEV4("h3", {
+        className: "text-lg font-semibold",
+        children: title
+      }, undefined, false, undefined, this),
+      /* @__PURE__ */ jsxDEV4("p", {
+        className: "text-muted-foreground text-sm",
+        children: body
+      }, undefined, false, undefined, this),
+      /* @__PURE__ */ jsxDEV4(Link4, {
+        href,
+        className: "btn-primary",
+        children: ctaLabel
+      }, undefined, false, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+
+// src/components/docs/ecosystem/TemplatesPage.tsx
+import { CodeBlock as CodeBlock4 } from "@contractspec/lib.design-system";
+import Link5 from "@contractspec/lib.ui-link";
+import { ChevronRight as ChevronRight4 } from "lucide-react";
+import { jsxDEV as jsxDEV5 } from "react/jsx-dev-runtime";
+function EcosystemTemplatesPage() {
+  return /* @__PURE__ */ jsxDEV5("div", {
+    className: "space-y-8",
+    children: [
+      /* @__PURE__ */ jsxDEV5("div", {
+        className: "space-y-3",
+        children: [
+          /* @__PURE__ */ jsxDEV5("h1", {
+            className: "text-4xl font-bold",
+            children: "Plugin templates"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV5("p", {
+            className: "text-muted-foreground text-lg",
+            children: "Scaffold new plugins with create-contractspec-plugin."
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV5("div", {
+        className: "card-subtle space-y-4 p-6",
+        children: [
+          /* @__PURE__ */ jsxDEV5("h2", {
+            className: "text-2xl font-bold",
+            children: "Create a new plugin"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV5("p", {
+            className: "text-muted-foreground text-sm",
+            children: "Generate a plugin scaffold with tests, documentation, and CI wiring."
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV5(CodeBlock4, {
+            language: "bash",
+            filename: "create-plugin",
+            code: `bunx create-contractspec-plugin create \\
+  --name markdown-generator \\
+  --description "Markdown docs generator" \\
+  --author "Your name"`
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV5("div", {
+        className: "card-subtle space-y-4 p-6",
+        children: [
+          /* @__PURE__ */ jsxDEV5("h2", {
+            className: "text-2xl font-bold",
+            children: "Template outputs"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV5("ul", {
+            className: "text-muted-foreground space-y-2 text-sm",
+            children: [
+              /* @__PURE__ */ jsxDEV5("li", {
+                children: "src/generator.ts, src/types.ts, src/config.ts"
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV5("li", {
+                children: "tests/ with sample fixtures"
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV5("li", {
+                children: ".github/workflows/ci.yml"
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV5("li", {
+                children: "README.md with usage instructions"
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV5("div", {
+        className: "card-subtle space-y-4 p-6",
+        children: [
+          /* @__PURE__ */ jsxDEV5("h2", {
+            className: "text-2xl font-bold",
+            children: "Publish and install"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV5(CodeBlock4, {
+            language: "bash",
+            filename: "publish-plugin",
+            code: `bun run build
+bun publish
+
+# install in a ContractSpec workspace
+bun add @contractspec/integration.markdown-generator`
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV5(StudioPrompt, {
+        title: "Need managed plugin distribution?",
+        body: "Studio can host private plugin registries, approvals, and policy gates for teams."
+      }, undefined, false, undefined, this),
+      /* @__PURE__ */ jsxDEV5("div", {
+        className: "flex items-center gap-4 pt-4",
+        children: [
+          /* @__PURE__ */ jsxDEV5(Link5, {
+            href: "/docs/ecosystem/plugins",
+            className: "btn-primary",
+            children: [
+              "Plugin API ",
+              /* @__PURE__ */ jsxDEV5(ChevronRight4, {
+                size: 16
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this),
+          /* @__PURE__ */ jsxDEV5(Link5, {
+            href: "/docs/ecosystem/registry",
+            className: "btn-ghost",
+            children: "Registry resolution"
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+
+// src/components/docs/ecosystem/ecosystem.docblocks.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var ecosystemDocBlocks = [
+  {
+    id: "docs.ecosystem.plugins",
+    title: "Plugin API",
+    summary: "Build generators, validators, adapters, and registry resolvers.",
+    kind: "usage",
+    visibility: "public",
+    route: "/docs/ecosystem/plugins",
+    tags: ["ecosystem", "plugins", "extensions"],
+    body: `# Plugin API
+
+ContractSpec plugins extend the platform with generators, validators, adapters, formatters, and registry resolvers. Define capabilities in code, register them through configuration, and ship reusable packages.`
+  },
+  {
+    id: "docs.ecosystem.integrations",
+    title: "Integrations",
+    summary: "Reference plugins and integrations you can extend.",
+    kind: "usage",
+    visibility: "public",
+    route: "/docs/ecosystem/integrations",
+    tags: ["ecosystem", "integrations"],
+    body: `# Integrations
+
+Reference integrations demonstrate how to extend ContractSpec with real-world plugins. Use them as starting points for your own adapters and generators.`
+  },
+  {
+    id: "docs.ecosystem.templates",
+    title: "Plugin templates",
+    summary: "Scaffold new plugins with create-contractspec-plugin.",
+    kind: "usage",
+    visibility: "public",
+    route: "/docs/ecosystem/templates",
+    tags: ["ecosystem", "templates"],
+    body: "# Plugin templates\n\nUse `create-contractspec-plugin` to scaffold a new plugin package with tests, documentation, and CI wiring."
+  },
+  {
+    id: "docs.ecosystem.registry",
+    title: "Registry resolution",
+    summary: "Discover plugins locally or from remote registries.",
+    kind: "usage",
+    visibility: "public",
+    route: "/docs/ecosystem/registry",
+    tags: ["ecosystem", "registry"],
+    body: "# Registry resolution\n\nPlugins can be resolved from local workspaces, npm packages, or remote registries. Configure resolution order in `.contractsrc.json` and use registry resolver plugins for custom sources."
+  }
+];
+registerDocBlocks(ecosystemDocBlocks);
+export {
+  EcosystemTemplatesPage,
+  EcosystemRegistryPage,
+  EcosystemPluginsPage,
+  EcosystemIntegrationsPage
+};