@contractspec/bundle.library 0.0.0-canary-20260206014742

package/dist/components/docs/getting-started/VSCodeExtensionPage.js

@@ -0,0 +1,357 @@
+import { ChevronRight, ExternalLink } from "lucide-react";
+import { CodeBlock } from "@contractspec/lib.design-system";
+import { jsx, jsxs } from "react/jsx-runtime";
+import Link from "@contractspec/lib.ui-link";
+
+//#region src/components/docs/getting-started/VSCodeExtensionPage.tsx
+function VSCodeExtensionPage() {
+	return /* @__PURE__ */ jsxs("div", {
+		className: "space-y-8",
+		children: [
+			/* @__PURE__ */ jsxs("div", {
+				className: "space-y-2",
+				children: [/* @__PURE__ */ jsx("h1", {
+					className: "text-4xl font-bold",
+					children: "VS Code Extension"
+				}), /* @__PURE__ */ jsx("p", {
+					className: "text-muted-foreground text-lg",
+					children: "Spec-first development directly in VS Code. Validate, scaffold, and explore your contract specifications with real-time feedback."
+				})]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "flex flex-wrap gap-3",
+				children: [/* @__PURE__ */ jsxs("a", {
+					href: "https://marketplace.visualstudio.com/items?itemName=lssm.vscode-contractspec",
+					target: "_blank",
+					rel: "noopener noreferrer",
+					className: "btn-primary inline-flex items-center gap-2",
+					children: ["Install Extension ", /* @__PURE__ */ jsx(ExternalLink, { size: 16 })]
+				}), /* @__PURE__ */ jsx("a", {
+					href: "vscode:extension/lssm.vscode-contractspec",
+					className: "btn-ghost inline-flex items-center gap-2",
+					children: "Open in VS Code"
+				})]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "space-y-6",
+				children: [
+					/* @__PURE__ */ jsxs("div", {
+						className: "space-y-3",
+						children: [/* @__PURE__ */ jsx("h2", {
+							className: "text-2xl font-bold",
+							children: "Installation"
+						}), /* @__PURE__ */ jsxs("div", {
+							className: "space-y-2",
+							children: [
+								/* @__PURE__ */ jsxs("p", {
+									className: "text-muted-foreground text-sm",
+									children: [/* @__PURE__ */ jsx("strong", { children: "Option 1:" }), " Install from VS Code Marketplace"]
+								}),
+								/* @__PURE__ */ jsx(CodeBlock, {
+									language: "bash",
+									code: "code --install-extension lssm.vscode-contractspec"
+								}),
+								/* @__PURE__ */ jsxs("p", {
+									className: "text-muted-foreground mt-4 text-sm",
+									children: [/* @__PURE__ */ jsx("strong", { children: "Option 2:" }), " Search for \"ContractSpec\" in VS Code Extensions (Ctrl/Cmd+Shift+X)"]
+								})
+							]
+						})]
+					}),
+					/* @__PURE__ */ jsxs("div", {
+						className: "space-y-4",
+						children: [/* @__PURE__ */ jsx("h2", {
+							className: "text-2xl font-bold",
+							children: "Features"
+						}), /* @__PURE__ */ jsx("div", {
+							className: "grid gap-4 md:grid-cols-3",
+							children: [
+								{
+									category: "Core Functionality",
+									items: [
+										"Real-time validation with instant feedback on spec errors",
+										"Build/Scaffold handlers and components from specs",
+										"Interactive spec creation wizard",
+										"Watch mode for auto-rebuild on changes",
+										"Sync all specs in workspace with one command"
+									]
+								},
+								{
+									category: "Visual Navigation",
+									items: [
+										"Specs Explorer sidebar with organized tree view",
+										"Dependencies view to visualize spec relationships",
+										"Build Results tracking with history",
+										"Circular dependency detection"
+									]
+								},
+								{
+									category: "Comparison & Export",
+									items: [
+										"Semantic and text diff between specs",
+										"Git comparison with baseline branches",
+										"OpenAPI 3.1 specification export"
+									]
+								}
+							].map((section) => /* @__PURE__ */ jsxs("div", {
+								className: "card-subtle space-y-3 p-4",
+								children: [/* @__PURE__ */ jsx("h3", {
+									className: "font-bold text-violet-400",
+									children: section.category
+								}), /* @__PURE__ */ jsx("ul", {
+									className: "space-y-2",
+									children: section.items.map((item) => /* @__PURE__ */ jsxs("li", {
+										className: "text-muted-foreground flex items-start gap-2 text-sm",
+										children: [/* @__PURE__ */ jsx("span", {
+											className: "mt-1 text-violet-400",
+											children: "-"
+										}), /* @__PURE__ */ jsx("span", { children: item })]
+									}, item))
+								})]
+							}, section.category))
+						})]
+					}),
+					/* @__PURE__ */ jsxs("div", {
+						className: "space-y-4",
+						children: [
+							/* @__PURE__ */ jsx("h2", {
+								className: "text-2xl font-bold",
+								children: "Commands"
+							}),
+							/* @__PURE__ */ jsxs("p", {
+								className: "text-muted-foreground",
+								children: [
+									"Access commands via Command Palette (Ctrl/Cmd+Shift+P) with prefix",
+									" ",
+									/* @__PURE__ */ jsx("code", { children: "ContractSpec:" })
+								]
+							}),
+							/* @__PURE__ */ jsx("div", {
+								className: "grid gap-3 md:grid-cols-2",
+								children: [
+									{
+										name: "Create New Spec",
+										description: "Interactive wizard to create specs"
+									},
+									{
+										name: "Validate Current Spec",
+										description: "Validate the currently open spec"
+									},
+									{
+										name: "Build/Scaffold from Current Spec",
+										description: "Generate handler/component"
+									},
+									{
+										name: "Toggle Watch Mode",
+										description: "Auto-rebuild on changes"
+									},
+									{
+										name: "Sync All Specs",
+										description: "Build all specs in workspace"
+									},
+									{
+										name: "Analyze Spec Dependencies",
+										description: "Visualize spec dependencies"
+									},
+									{
+										name: "Compare Specs",
+										description: "Semantic or text diff between specs"
+									},
+									{
+										name: "Export to OpenAPI",
+										description: "Generate OpenAPI specification"
+									}
+								].map((cmd) => /* @__PURE__ */ jsx("div", {
+									className: "card-subtle flex items-center gap-3 p-3",
+									children: /* @__PURE__ */ jsxs("div", {
+										className: "flex-1",
+										children: [/* @__PURE__ */ jsx("p", {
+											className: "font-mono text-sm font-medium",
+											children: cmd.name
+										}), /* @__PURE__ */ jsx("p", {
+											className: "text-muted-foreground text-xs",
+											children: cmd.description
+										})]
+									})
+								}, cmd.name))
+							})
+						]
+					}),
+					/* @__PURE__ */ jsxs("div", {
+						className: "space-y-3",
+						children: [
+							/* @__PURE__ */ jsx("h2", {
+								className: "text-2xl font-bold",
+								children: "Sidebar Views"
+							}),
+							/* @__PURE__ */ jsx("p", {
+								className: "text-muted-foreground",
+								children: "The extension adds a ContractSpec activity bar (icon in sidebar) with three views:"
+							}),
+							/* @__PURE__ */ jsxs("div", {
+								className: "grid gap-4 md:grid-cols-3",
+								children: [
+									/* @__PURE__ */ jsxs("div", {
+										className: "card-subtle space-y-2 p-4",
+										children: [/* @__PURE__ */ jsx("h4", {
+											className: "font-bold",
+											children: "Specs Explorer"
+										}), /* @__PURE__ */ jsx("p", {
+											className: "text-muted-foreground text-sm",
+											children: "Browse all specs organized by type. Shows name, version, and stability. Click to open, right-click for actions."
+										})]
+									}),
+									/* @__PURE__ */ jsxs("div", {
+										className: "card-subtle space-y-2 p-4",
+										children: [/* @__PURE__ */ jsx("h4", {
+											className: "font-bold",
+											children: "Dependencies"
+										}), /* @__PURE__ */ jsx("p", {
+											className: "text-muted-foreground text-sm",
+											children: "Visualize spec relationships. Detect circular dependencies. Navigate to referenced specs."
+										})]
+									}),
+									/* @__PURE__ */ jsxs("div", {
+										className: "card-subtle space-y-2 p-4",
+										children: [/* @__PURE__ */ jsx("h4", {
+											className: "font-bold",
+											children: "Build Results"
+										}), /* @__PURE__ */ jsx("p", {
+											className: "text-muted-foreground text-sm",
+											children: "Track build history (last 20). Success/failure indicators. Click to open generated files."
+										})]
+									})
+								]
+							})
+						]
+					}),
+					/* @__PURE__ */ jsxs("div", {
+						className: "space-y-3",
+						children: [/* @__PURE__ */ jsx("h2", {
+							className: "text-2xl font-bold",
+							children: "Getting Started"
+						}), /* @__PURE__ */ jsxs("ol", {
+							className: "text-muted-foreground list-inside list-decimal space-y-2",
+							children: [
+								/* @__PURE__ */ jsx("li", { children: "Install the extension from VS Code Marketplace" }),
+								/* @__PURE__ */ jsx("li", { children: "Open a workspace with ContractSpec files (or create one)" }),
+								/* @__PURE__ */ jsx("li", { children: "Start the walkthrough: Help - Welcome - ContractSpec" }),
+								/* @__PURE__ */ jsxs("li", { children: [
+									"Create your first spec: Click ",
+									/* @__PURE__ */ jsx("strong", { children: "+" }),
+									" in Specs Explorer or run ",
+									/* @__PURE__ */ jsx("code", { children: "ContractSpec: Create New Spec" })
+								] }),
+								/* @__PURE__ */ jsx("li", { children: "Build from it: Click the build icon in the editor title bar" })
+							]
+						})]
+					}),
+					/* @__PURE__ */ jsxs("div", {
+						className: "card-subtle space-y-4 p-6",
+						children: [
+							/* @__PURE__ */ jsx("h3", {
+								className: "font-bold",
+								children: "Configuration"
+							}),
+							/* @__PURE__ */ jsx("p", {
+								className: "text-muted-foreground text-sm",
+								children: "Configure the extension in VS Code Settings:"
+							}),
+							/* @__PURE__ */ jsx("div", {
+								className: "overflow-x-auto",
+								children: /* @__PURE__ */ jsxs("table", {
+									className: "text-muted-foreground w-full text-sm",
+									children: [/* @__PURE__ */ jsx("thead", { children: /* @__PURE__ */ jsxs("tr", {
+										className: "border-border border-b",
+										children: [
+											/* @__PURE__ */ jsx("th", {
+												className: "p-2 text-left font-medium",
+												children: "Setting"
+											}),
+											/* @__PURE__ */ jsx("th", {
+												className: "p-2 text-left font-medium",
+												children: "Description"
+											}),
+											/* @__PURE__ */ jsx("th", {
+												className: "p-2 text-left font-medium",
+												children: "Default"
+											})
+										]
+									}) }), /* @__PURE__ */ jsxs("tbody", { children: [
+										/* @__PURE__ */ jsxs("tr", {
+											className: "border-border border-b",
+											children: [
+												/* @__PURE__ */ jsx("td", {
+													className: "p-2 font-mono text-xs",
+													children: "validation.onSave"
+												}),
+												/* @__PURE__ */ jsx("td", {
+													className: "p-2",
+													children: "Run validation on save"
+												}),
+												/* @__PURE__ */ jsx("td", {
+													className: "p-2",
+													children: "true"
+												})
+											]
+										}),
+										/* @__PURE__ */ jsxs("tr", {
+											className: "border-border border-b",
+											children: [
+												/* @__PURE__ */ jsx("td", {
+													className: "p-2 font-mono text-xs",
+													children: "validation.onOpen"
+												}),
+												/* @__PURE__ */ jsx("td", {
+													className: "p-2",
+													children: "Run validation on open"
+												}),
+												/* @__PURE__ */ jsx("td", {
+													className: "p-2",
+													children: "true"
+												})
+											]
+										}),
+										/* @__PURE__ */ jsxs("tr", {
+											className: "border-border border-b",
+											children: [
+												/* @__PURE__ */ jsx("td", {
+													className: "p-2 font-mono text-xs",
+													children: "api.baseUrl"
+												}),
+												/* @__PURE__ */ jsx("td", {
+													className: "p-2",
+													children: "Base URL for ContractSpec API"
+												}),
+												/* @__PURE__ */ jsx("td", {
+													className: "p-2",
+													children: "(empty)"
+												})
+											]
+										})
+									] })]
+								})
+							})
+						]
+					})
+				]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "flex items-center gap-4 pt-4",
+				children: [/* @__PURE__ */ jsx(Link, {
+					href: "/docs/getting-started/tools/cli",
+					className: "btn-ghost",
+					children: "Back: CLI"
+				}), /* @__PURE__ */ jsxs(Link, {
+					href: "/docs/specs",
+					className: "btn-primary",
+					children: ["Next: Core Concepts ", /* @__PURE__ */ jsx(ChevronRight, { size: 16 })]
+				})]
+			})
+		]
+	});
+}
+
+//#endregion
+export { VSCodeExtensionPage };
+//# sourceMappingURL=VSCodeExtensionPage.js.map

package/dist/components/docs/getting-started/VSCodeExtensionPage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VSCodeExtensionPage.js","names":[],"sources":["../../../../src/components/docs/getting-started/VSCodeExtensionPage.tsx"],"sourcesContent":["import Link from '@contractspec/lib.ui-link';\nimport { ChevronRight, ExternalLink } from 'lucide-react';\nimport { CodeBlock } from '@contractspec/lib.design-system';\n\nexport function VSCodeExtensionPage() {\n  const features = [\n    {\n      category: 'Core Functionality',\n      items: [\n        'Real-time validation with instant feedback on spec errors',\n        'Build/Scaffold handlers and components from specs',\n        'Interactive spec creation wizard',\n        'Watch mode for auto-rebuild on changes',\n        'Sync all specs in workspace with one command',\n      ],\n    },\n    {\n      category: 'Visual Navigation',\n      items: [\n        'Specs Explorer sidebar with organized tree view',\n        'Dependencies view to visualize spec relationships',\n        'Build Results tracking with history',\n        'Circular dependency detection',\n      ],\n    },\n    {\n      category: 'Comparison & Export',\n      items: [\n        'Semantic and text diff between specs',\n        'Git comparison with baseline branches',\n        'OpenAPI 3.1 specification export',\n      ],\n    },\n  ];\n\n  const commands = [\n    {\n      name: 'Create New Spec',\n      description: 'Interactive wizard to create specs',\n    },\n    {\n      name: 'Validate Current Spec',\n      description: 'Validate the currently open spec',\n    },\n    {\n      name: 'Build/Scaffold from Current Spec',\n      description: 'Generate handler/component',\n    },\n    { name: 'Toggle Watch Mode', description: 'Auto-rebuild on changes' },\n    { name: 'Sync All Specs', description: 'Build all specs in workspace' },\n    {\n      name: 'Analyze Spec Dependencies',\n      description: 'Visualize spec dependencies',\n    },\n    {\n      name: 'Compare Specs',\n      description: 'Semantic or text diff between specs',\n    },\n    {\n      name: 'Export to OpenAPI',\n      description: 'Generate OpenAPI specification',\n    },\n  ];\n\n  return (\n    <div className=\"space-y-8\">\n      <div className=\"space-y-2\">\n        <h1 className=\"text-4xl font-bold\">VS Code Extension</h1>\n        <p className=\"text-muted-foreground text-lg\">\n          Spec-first development directly in VS Code. Validate, scaffold, and\n          explore your contract specifications with real-time feedback.\n        </p>\n      </div>\n\n      <div className=\"flex flex-wrap gap-3\">\n        <a\n          href=\"https://marketplace.visualstudio.com/items?itemName=lssm.vscode-contractspec\"\n          target=\"_blank\"\n          rel=\"noopener noreferrer\"\n          className=\"btn-primary inline-flex items-center gap-2\"\n        >\n          Install Extension <ExternalLink size={16} />\n        </a>\n        <a\n          href=\"vscode:extension/lssm.vscode-contractspec\"\n          className=\"btn-ghost inline-flex items-center gap-2\"\n        >\n          Open in VS Code\n        </a>\n      </div>\n\n      <div className=\"space-y-6\">\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">Installation</h2>\n          <div className=\"space-y-2\">\n            <p className=\"text-muted-foreground text-sm\">\n              <strong>Option 1:</strong> Install from VS Code Marketplace\n            </p>\n            <CodeBlock\n              language=\"bash\"\n              code=\"code --install-extension lssm.vscode-contractspec\"\n            />\n            <p className=\"text-muted-foreground mt-4 text-sm\">\n              <strong>Option 2:</strong> Search for &quot;ContractSpec&quot; in\n              VS Code Extensions (Ctrl/Cmd+Shift+X)\n            </p>\n          </div>\n        </div>\n\n        <div className=\"space-y-4\">\n          <h2 className=\"text-2xl font-bold\">Features</h2>\n          <div className=\"grid gap-4 md:grid-cols-3\">\n            {features.map((section) => (\n              <div key={section.category} className=\"card-subtle space-y-3 p-4\">\n                <h3 className=\"font-bold text-violet-400\">\n                  {section.category}\n                </h3>\n                <ul className=\"space-y-2\">\n                  {section.items.map((item) => (\n                    <li\n                      key={item}\n                      className=\"text-muted-foreground flex items-start gap-2 text-sm\"\n                    >\n                      <span className=\"mt-1 text-violet-400\">-</span>\n                      <span>{item}</span>\n                    </li>\n                  ))}\n                </ul>\n              </div>\n            ))}\n          </div>\n        </div>\n\n        <div className=\"space-y-4\">\n          <h2 className=\"text-2xl font-bold\">Commands</h2>\n          <p className=\"text-muted-foreground\">\n            Access commands via Command Palette (Ctrl/Cmd+Shift+P) with prefix{' '}\n            <code>ContractSpec:</code>\n          </p>\n          <div className=\"grid gap-3 md:grid-cols-2\">\n            {commands.map((cmd) => (\n              <div\n                key={cmd.name}\n                className=\"card-subtle flex items-center gap-3 p-3\"\n              >\n                <div className=\"flex-1\">\n                  <p className=\"font-mono text-sm font-medium\">{cmd.name}</p>\n                  <p className=\"text-muted-foreground text-xs\">\n                    {cmd.description}\n                  </p>\n                </div>\n              </div>\n            ))}\n          </div>\n        </div>\n\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">Sidebar Views</h2>\n          <p className=\"text-muted-foreground\">\n            The extension adds a ContractSpec activity bar (icon in sidebar)\n            with three views:\n          </p>\n          <div className=\"grid gap-4 md:grid-cols-3\">\n            <div className=\"card-subtle space-y-2 p-4\">\n              <h4 className=\"font-bold\">Specs Explorer</h4>\n              <p className=\"text-muted-foreground text-sm\">\n                Browse all specs organized by type. Shows name, version, and\n                stability. Click to open, right-click for actions.\n              </p>\n            </div>\n            <div className=\"card-subtle space-y-2 p-4\">\n              <h4 className=\"font-bold\">Dependencies</h4>\n              <p className=\"text-muted-foreground text-sm\">\n                Visualize spec relationships. Detect circular dependencies.\n                Navigate to referenced specs.\n              </p>\n            </div>\n            <div className=\"card-subtle space-y-2 p-4\">\n              <h4 className=\"font-bold\">Build Results</h4>\n              <p className=\"text-muted-foreground text-sm\">\n                Track build history (last 20). Success/failure indicators. Click\n                to open generated files.\n              </p>\n            </div>\n          </div>\n        </div>\n\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">Getting Started</h2>\n          <ol className=\"text-muted-foreground list-inside list-decimal space-y-2\">\n            <li>Install the extension from VS Code Marketplace</li>\n            <li>Open a workspace with ContractSpec files (or create one)</li>\n            <li>Start the walkthrough: Help - Welcome - ContractSpec</li>\n            <li>\n              Create your first spec: Click <strong>+</strong> in Specs Explorer\n              or run <code>ContractSpec: Create New Spec</code>\n            </li>\n            <li>Build from it: Click the build icon in the editor title bar</li>\n          </ol>\n        </div>\n\n        <div className=\"card-subtle space-y-4 p-6\">\n          <h3 className=\"font-bold\">Configuration</h3>\n          <p className=\"text-muted-foreground text-sm\">\n            Configure the extension in VS Code Settings:\n          </p>\n          <div className=\"overflow-x-auto\">\n            <table className=\"text-muted-foreground w-full text-sm\">\n              <thead>\n                <tr className=\"border-border border-b\">\n                  <th className=\"p-2 text-left font-medium\">Setting</th>\n                  <th className=\"p-2 text-left font-medium\">Description</th>\n                  <th className=\"p-2 text-left font-medium\">Default</th>\n                </tr>\n              </thead>\n              <tbody>\n                <tr className=\"border-border border-b\">\n                  <td className=\"p-2 font-mono text-xs\">validation.onSave</td>\n                  <td className=\"p-2\">Run validation on save</td>\n                  <td className=\"p-2\">true</td>\n                </tr>\n                <tr className=\"border-border border-b\">\n                  <td className=\"p-2 font-mono text-xs\">validation.onOpen</td>\n                  <td className=\"p-2\">Run validation on open</td>\n                  <td className=\"p-2\">true</td>\n                </tr>\n                <tr className=\"border-border border-b\">\n                  <td className=\"p-2 font-mono text-xs\">api.baseUrl</td>\n                  <td className=\"p-2\">Base URL for ContractSpec API</td>\n                  <td className=\"p-2\">(empty)</td>\n                </tr>\n              </tbody>\n            </table>\n          </div>\n        </div>\n      </div>\n\n      <div className=\"flex items-center gap-4 pt-4\">\n        <Link href=\"/docs/getting-started/tools/cli\" className=\"btn-ghost\">\n          Back: CLI\n        </Link>\n        <Link href=\"/docs/specs\" className=\"btn-primary\">\n          Next: Core Concepts <ChevronRight size={16} />\n        </Link>\n      </div>\n    </div>\n  );\n}\n"],"mappings":"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"}

package/dist/components/docs/getting-started/getting-started.docblocks.d.ts

@@ -0,0 +1,7 @@
+import { DocBlock } from "@contractspec/lib.contracts/docs";
+
+//#region src/components/docs/getting-started/getting-started.docblocks.d.ts
+declare const gettingStartedDocBlocks: DocBlock[];
+//#endregion
+export { gettingStartedDocBlocks };
+//# sourceMappingURL=getting-started.docblocks.d.ts.map

package/dist/components/docs/getting-started/getting-started.docblocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getting-started.docblocks.d.ts","names":[],"sources":["../../../../src/components/docs/getting-started/getting-started.docblocks.ts"],"mappings":";;;cAGa,uBAAA,EAAyB,QAAA"}

package/dist/components/docs/getting-started/getting-started.docblocks.js

@@ -0,0 +1,139 @@
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+
+//#region src/components/docs/getting-started/getting-started.docblocks.ts
+const gettingStartedDocBlocks = [
+	{
+		id: "docs.getting-started.start-here",
+		title: "Start here",
+		summary: "Fast onboarding path from install to first generated contract.",
+		kind: "usage",
+		visibility: "public",
+		route: "/docs/getting-started/start-here",
+		tags: ["getting-started", "onboarding"],
+		body: `# Start Here
+
+Get ContractSpec running quickly and generate your first contract-backed code.
+
+## 1. Install the CLI
+
+\`\`\`bash
+bun add -D contractspec
+bun add @contractspec/lib.contracts @contractspec/lib.schema
+\`\`\`
+
+## 2. Initialize your project
+
+\`\`\`bash
+bunx contractspec init
+\`\`\`
+
+## 3. Create your first contract
+
+\`\`\`bash
+contractspec create --type operation
+\`\`\`
+
+## 4. Generate implementation
+
+\`\`\`bash
+contractspec build src/contracts/mySpec.ts
+contractspec validate src/contracts/mySpec.ts
+\`\`\`
+
+## Next steps
+
+- Follow the Hello World tutorial for a full walkthrough.
+- Install the VS Code extension for inline validation.
+- Review compatibility notes before deploying to production.
+`
+	},
+	{
+		id: "docs.getting-started.troubleshooting",
+		title: "Troubleshooting",
+		summary: "Resolve common install, spec discovery, and build issues.",
+		kind: "faq",
+		visibility: "public",
+		route: "/docs/getting-started/troubleshooting",
+		tags: ["getting-started", "troubleshooting"],
+		body: `# Troubleshooting
+
+Common issues and quick fixes when getting started with ContractSpec.
+
+## Command not found
+
+- Reinstall the CLI and ensure it is in your PATH.
+- Confirm Node.js 20+ or Bun 1.0+ is installed.
+
+## Specs not discovered
+
+- Run \`contractspec list\` to see discovered specs.
+- Verify your spec path conventions in \`.contractsrc.json\`.
+
+## Build or validate fails
+
+- Run \`contractspec validate\` to surface schema errors.
+- Check that generated files were not manually edited.
+
+## Diagnostics
+
+\`\`\`bash
+contractspec --version
+contractspec list
+contractspec validate src/contracts/mySpec.ts
+\`\`\`
+
+## Still blocked?
+
+- Confirm compatibility requirements (runtime, framework, package manager).
+- Re-run \`contractspec build\` with a clean working tree.
+`
+	},
+	{
+		id: "docs.getting-started.compatibility",
+		title: "Compatibility",
+		summary: "Supported runtimes, frameworks, package managers, and AI modes.",
+		kind: "reference",
+		visibility: "public",
+		route: "/docs/getting-started/compatibility",
+		tags: ["getting-started", "compatibility"],
+		body: `# Compatibility
+
+ContractSpec supports modern TypeScript stacks with spec-first workflows.
+
+## Runtimes
+
+- Node.js 20+
+- Bun 1.0+
+
+## Frameworks
+
+- Next.js 14+ (App Router preferred)
+- Bun + Elysia or other HTTP servers
+
+## Package managers
+
+- bun (recommended)
+- npm
+- yarn
+- pnpm
+
+## AI agent modes
+
+- claude-code
+- openai-codex
+- cursor
+- opencode
+- simple (direct LLM)
+
+## Datastores
+
+- PostgreSQL via Prisma
+- Bring your own adapter for other databases
+`
+	}
+];
+registerDocBlocks(gettingStartedDocBlocks);
+
+//#endregion
+export { gettingStartedDocBlocks };
+//# sourceMappingURL=getting-started.docblocks.js.map

package/dist/components/docs/getting-started/getting-started.docblocks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getting-started.docblocks.js","names":[],"sources":["../../../../src/components/docs/getting-started/getting-started.docblocks.ts"],"sourcesContent":["import type { DocBlock } from '@contractspec/lib.contracts/docs';\nimport { registerDocBlocks } from '@contractspec/lib.contracts/docs';\n\nexport const gettingStartedDocBlocks: DocBlock[] = [\n  {\n    id: 'docs.getting-started.start-here',\n    title: 'Start here',\n    summary: 'Fast onboarding path from install to first generated contract.',\n    kind: 'usage',\n    visibility: 'public',\n    route: '/docs/getting-started/start-here',\n    tags: ['getting-started', 'onboarding'],\n    body: `# Start Here\n\nGet ContractSpec running quickly and generate your first contract-backed code.\n\n## 1. Install the CLI\n\n\\`\\`\\`bash\nbun add -D contractspec\nbun add @contractspec/lib.contracts @contractspec/lib.schema\n\\`\\`\\`\n\n## 2. Initialize your project\n\n\\`\\`\\`bash\nbunx contractspec init\n\\`\\`\\`\n\n## 3. Create your first contract\n\n\\`\\`\\`bash\ncontractspec create --type operation\n\\`\\`\\`\n\n## 4. Generate implementation\n\n\\`\\`\\`bash\ncontractspec build src/contracts/mySpec.ts\ncontractspec validate src/contracts/mySpec.ts\n\\`\\`\\`\n\n## Next steps\n\n- Follow the Hello World tutorial for a full walkthrough.\n- Install the VS Code extension for inline validation.\n- Review compatibility notes before deploying to production.\n`,\n  },\n  {\n    id: 'docs.getting-started.troubleshooting',\n    title: 'Troubleshooting',\n    summary: 'Resolve common install, spec discovery, and build issues.',\n    kind: 'faq',\n    visibility: 'public',\n    route: '/docs/getting-started/troubleshooting',\n    tags: ['getting-started', 'troubleshooting'],\n    body: `# Troubleshooting\n\nCommon issues and quick fixes when getting started with ContractSpec.\n\n## Command not found\n\n- Reinstall the CLI and ensure it is in your PATH.\n- Confirm Node.js 20+ or Bun 1.0+ is installed.\n\n## Specs not discovered\n\n- Run \\`contractspec list\\` to see discovered specs.\n- Verify your spec path conventions in \\`.contractsrc.json\\`.\n\n## Build or validate fails\n\n- Run \\`contractspec validate\\` to surface schema errors.\n- Check that generated files were not manually edited.\n\n## Diagnostics\n\n\\`\\`\\`bash\ncontractspec --version\ncontractspec list\ncontractspec validate src/contracts/mySpec.ts\n\\`\\`\\`\n\n## Still blocked?\n\n- Confirm compatibility requirements (runtime, framework, package manager).\n- Re-run \\`contractspec build\\` with a clean working tree.\n`,\n  },\n  {\n    id: 'docs.getting-started.compatibility',\n    title: 'Compatibility',\n    summary: 'Supported runtimes, frameworks, package managers, and AI modes.',\n    kind: 'reference',\n    visibility: 'public',\n    route: '/docs/getting-started/compatibility',\n    tags: ['getting-started', 'compatibility'],\n    body: `# Compatibility\n\nContractSpec supports modern TypeScript stacks with spec-first workflows.\n\n## Runtimes\n\n- Node.js 20+\n- Bun 1.0+\n\n## Frameworks\n\n- Next.js 14+ (App Router preferred)\n- Bun + Elysia or other HTTP servers\n\n## Package managers\n\n- bun (recommended)\n- npm\n- yarn\n- pnpm\n\n## AI agent modes\n\n- claude-code\n- openai-codex\n- cursor\n- opencode\n- simple (direct LLM)\n\n## Datastores\n\n- PostgreSQL via Prisma\n- Bring your own adapter for other databases\n`,\n  },\n];\n\nregisterDocBlocks(gettingStartedDocBlocks);\n"],"mappings":";;;AAGA,MAAa,0BAAsC;CACjD;EACE,IAAI;EACJ,OAAO;EACP,SAAS;EACT,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM,CAAC,mBAAmB,aAAa;EACvC,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoCP;CACD;EACE,IAAI;EACJ,OAAO;EACP,SAAS;EACT,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM,CAAC,mBAAmB,kBAAkB;EAC5C,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgCP;CACD;EACE,IAAI;EACJ,OAAO;EACP,SAAS;EACT,MAAM;EACN,YAAY;EACZ,OAAO;EACP,MAAM,CAAC,mBAAmB,gBAAgB;EAC1C,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkCP;CACF;AAED,kBAAkB,wBAAwB"}

package/dist/components/docs/getting-started/index.d.ts

@@ -0,0 +1,11 @@
+import { CLIPage } from "./CLIPage.js";
+import { CompatibilityPage } from "./CompatibilityPage.js";
+import { DataViewTutorialPage } from "./DataViewTutorialPage.js";
+import { DeveloperToolsPage } from "./DeveloperToolsPage.js";
+import { HelloWorldPage } from "./HelloWorldPage.js";
+import { InstallationPage } from "./InstallationPage.js";
+import { StartHerePage } from "./StartHerePage.js";
+import { TroubleshootingPage } from "./TroubleshootingPage.js";
+import { VSCodeExtensionPage } from "./VSCodeExtensionPage.js";
+import "./getting-started.docblocks.js";
+export { CLIPage, CompatibilityPage, DataViewTutorialPage, DeveloperToolsPage, HelloWorldPage, InstallationPage, StartHerePage, TroubleshootingPage, VSCodeExtensionPage };

package/dist/components/docs/getting-started/index.js

@@ -0,0 +1,12 @@
+import "./getting-started.docblocks.js";
+import { InstallationPage } from "./InstallationPage.js";
+import { HelloWorldPage } from "./HelloWorldPage.js";
+import { CLIPage } from "./CLIPage.js";
+import { VSCodeExtensionPage } from "./VSCodeExtensionPage.js";
+import { DeveloperToolsPage } from "./DeveloperToolsPage.js";
+import { DataViewTutorialPage } from "./DataViewTutorialPage.js";
+import { StartHerePage } from "./StartHerePage.js";
+import { TroubleshootingPage } from "./TroubleshootingPage.js";
+import { CompatibilityPage } from "./CompatibilityPage.js";
+
+export { CLIPage, CompatibilityPage, DataViewTutorialPage, DeveloperToolsPage, HelloWorldPage, InstallationPage, StartHerePage, TroubleshootingPage, VSCodeExtensionPage };

package/dist/components/docs/guides/GuideCIDiffGatingPage.d.ts

@@ -0,0 +1,7 @@
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/components/docs/guides/GuideCIDiffGatingPage.d.ts
+declare function GuideCIDiffGatingPage(): react_jsx_runtime0.JSX.Element;
+//#endregion
+export { GuideCIDiffGatingPage };
+//# sourceMappingURL=GuideCIDiffGatingPage.d.ts.map

package/dist/components/docs/guides/GuideCIDiffGatingPage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GuideCIDiffGatingPage.d.ts","names":[],"sources":["../../../../src/components/docs/guides/GuideCIDiffGatingPage.tsx"],"mappings":";;;iBAKgB,qBAAA,CAAA,GAAqB,kBAAA,CAAA,GAAA,CAAA,OAAA"}