@contractspec/bundle.library 0.0.0-canary-20260206014742

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

@@ -0,0 +1 @@
+{"version":3,"file":"HelloWorldPage.js","names":[],"sources":["../../../../src/components/docs/getting-started/HelloWorldPage.tsx"],"sourcesContent":["import Link from '@contractspec/lib.ui-link';\nimport { ChevronRight } from 'lucide-react';\nimport { CodeBlock } from '@contractspec/lib.design-system';\n\nexport function HelloWorldPage() {\n  return (\n    <div className=\"space-y-8\">\n      <div className=\"space-y-2\">\n        <h1 className=\"text-4xl font-bold\">Your First Operation</h1>\n        <p className=\"text-muted-foreground text-lg\">\n          Build a payment capture operation with policy enforcement in under 10\n          minutes.\n        </p>\n      </div>\n\n      <div className=\"space-y-6\">\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">What you'll build</h2>\n          <p className=\"text-muted-foreground\">\n            A real-world payment processing operation that validates input,\n            enforces business rules, integrates with Stripe, and audits every\n            transaction. This is production-ready code, not a toy example.\n          </p>\n        </div>\n\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">1. Define the operation spec</h2>\n          <p className=\"text-muted-foreground\">\n            Create <code>lib/specs/billing/capture-payment.ts</code>:\n          </p>\n          <CodeBlock\n            language=\"typescript\"\n            filename=\"lib/specs/billing/capture-payment.ts\"\n            code={`import { defineCommand } from '@contractspec/lib.contracts';\nimport { SchemaModel, ScalarTypeEnum } from '@contractspec/lib.schema';\n\nconst CapturePaymentInput = new SchemaModel({\n  name: 'CapturePaymentInput',\n  fields: {\n    invoiceId: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },\n    amount: { type: ScalarTypeEnum.PositiveNumber(), isOptional: false },\n    currency: { type: ScalarTypeEnum.String(), isOptional: false },\n    paymentMethodId: { type: ScalarTypeEnum.NonEmptyString(), isOptional: false },\n  },\n});\n\nconst PaymentResult = new SchemaModel({\n  name: 'PaymentResult',\n  fields: {\n    transactionId: { type: ScalarTypeEnum.String(), isOptional: false },\n    status: { type: ScalarTypeEnum.String(), isOptional: false },\n    receiptUrl: { type: ScalarTypeEnum.String(), isOptional: true },\n  },\n});\n\nexport const CapturePayment = defineCommand({\n  meta: {\n    key: 'billing.capturePayment',\n    version: '1.0.0',\n    description: 'Process a payment for an invoice',\n    goal: 'Capture funds from customer payment method',\n    context: 'Called when customer confirms purchase',\n    owners: ['team-billing'],\n    tags: ['payments', 'stripe', 'critical'],\n    stability: 'stable',\n  },\n  io: {\n    input: CapturePaymentInput,\n    output: PaymentResult,\n  },\n  policy: {\n    auth: 'user',\n    rules: [\n      { resource: 'invoice', action: 'pay', condition: 'owner' },\n    ],\n  },\n});`}\n          />\n        </div>\n\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">2. Implement the handler</h2>\n          <p className=\"text-muted-foreground\">\n            Create <code>lib/handlers/billing/capture-payment.ts</code>:\n          </p>\n          <CodeBlock\n            language=\"typescript\"\n            filename=\"lib/handlers/billing/capture-payment.ts\"\n            code={`import { CapturePayment } from '@/lib/specs/billing/capture-payment';\nimport { stripe } from '@/lib/integrations/stripe';\nimport { db } from '@/lib/db';\n\nexport async function handleCapturePayment(input, ctx) {\n  // 1. Verify invoice exists and belongs to user\n  const invoice = await db.invoice.findUnique({\n    where: { id: input.invoiceId, userId: ctx.userId },\n  });\n\n  if (!invoice) throw new Error('Invoice not found');\n  if (invoice.status === 'paid') throw new Error('Already paid');\n\n  // 2. Create Stripe payment intent\n  const paymentIntent = await stripe.paymentIntents.create({\n    amount: Math.round(input.amount * 100),\n    currency: input.currency,\n    payment_method: input.paymentMethodId,\n    confirm: true,\n    metadata: { invoiceId: input.invoiceId },\n  });\n\n  // 3. Update invoice status\n  await db.invoice.update({\n    where: { id: input.invoiceId },\n    data: {\n      status: 'paid',\n      paidAt: new Date(),\n      transactionId: paymentIntent.id,\n    },\n  });\n\n  return {\n    transactionId: paymentIntent.id,\n    status: paymentIntent.status,\n    receiptUrl: paymentIntent.charges.data[0]?.receipt_url,\n  };\n}`}\n          />\n        </div>\n\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">3. Register and serve</h2>\n          <p className=\"text-muted-foreground\">\n            Wire it up in <code>lib/registry.ts</code> and{' '}\n            <code>app/api/ops/[...route]/route.ts</code>:\n          </p>\n          <CodeBlock\n            language=\"typescript\"\n            filename=\"lib/registry.ts\"\n            code={`import { OperationSpecRegistry, installOp } from '@contractspec/lib.contracts';\nimport { CapturePayment } from './specs/billing/capture-payment';\nimport { handleCapturePayment } from './handlers/billing/capture-payment';\n\nexport const registry = new OperationSpecRegistry();\ninstallOp(registry, CapturePayment, handleCapturePayment);`}\n          />\n          <CodeBlock\n            language=\"typescript\"\n            filename=\"app/api/ops/[...route]/route.ts\"\n            code={`import { makeNextAppHandler } from '@contractspec/lib.contracts/server/rest-next-app';\nimport { registry } from '@/lib/registry';\nimport { auth } from '@/lib/auth';\n\nconst handler = makeNextAppHandler(registry, async (req) => {\n  const session = await auth(req);\n  return { actor: 'user', userId: session.userId, tenantId: session.tenantId };\n});\n\nexport { handler as GET, handler as POST };`}\n          />\n        </div>\n\n        <div className=\"card-subtle space-y-4 p-6\">\n          <h3 className=\"font-bold\">What you just built:</h3>\n          <ul className=\"text-muted-foreground space-y-2 text-sm\">\n            <li>\n              Type-safe API endpoint at{' '}\n              <code>/api/ops/billing.capturePayment</code>\n            </li>\n            <li>\n              Automatic input validation (amount must be positive, IDs required)\n            </li>\n            <li>Policy enforcement—only invoice owner can pay</li>\n            <li>Stripe integration with error handling</li>\n            <li>Database transaction with audit trail</li>\n            <li>Same spec works with GraphQL, MCP, or webhooks</li>\n          </ul>\n        </div>\n\n        <div className=\"flex items-center gap-4 pt-4\">\n          <Link href=\"/docs/getting-started/dataviews\" className=\"btn-primary\">\n            Next: Display Data with DataViews <ChevronRight size={16} />\n          </Link>\n        </div>\n      </div>\n    </div>\n  );\n}\n"],"mappings":";;;;;;AAIA,SAAgB,iBAAiB;AAC/B,QACE,qBAAC;EAAI,WAAU;aACb,qBAAC;GAAI,WAAU;cACb,oBAAC;IAAG,WAAU;cAAqB;KAAyB,EAC5D,oBAAC;IAAE,WAAU;cAAgC;KAGzC;IACA,EAEN,qBAAC;GAAI,WAAU;;IACb,qBAAC;KAAI,WAAU;gBACb,oBAAC;MAAG,WAAU;gBAAqB;OAAsB,EACzD,oBAAC;MAAE,WAAU;gBAAwB;OAIjC;MACA;IAEN,qBAAC;KAAI,WAAU;;MACb,oBAAC;OAAG,WAAU;iBAAqB;QAAiC;MACpE,qBAAC;OAAE,WAAU;;QAAwB;QAC5B,oBAAC,oBAAK,yCAA2C;;;QACtD;MACJ,oBAAC;OACC,UAAS;OACT,UAAS;OACT,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QA4CN;;MACE;IAEN,qBAAC;KAAI,WAAU;;MACb,oBAAC;OAAG,WAAU;iBAAqB;QAA6B;MAChE,qBAAC;OAAE,WAAU;;QAAwB;QAC5B,oBAAC,oBAAK,4CAA8C;;;QACzD;MACJ,oBAAC;OACC,UAAS;OACT,UAAS;OACT,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAsCN;;MACE;IAEN,qBAAC;KAAI,WAAU;;MACb,oBAAC;OAAG,WAAU;iBAAqB;QAA0B;MAC7D,qBAAC;OAAE,WAAU;;QAAwB;QACrB,oBAAC,oBAAK,oBAAsB;;QAAK;QAC/C,oBAAC,oBAAK,oCAAsC;;;QAC1C;MACJ,oBAAC;OACC,UAAS;OACT,UAAS;OACT,MAAM;;;;;;QAMN;MACF,oBAAC;OACC,UAAS;OACT,UAAS;OACT,MAAM;;;;;;;;;;QAUN;;MACE;IAEN,qBAAC;KAAI,WAAU;gBACb,oBAAC;MAAG,WAAU;gBAAY;OAAyB,EACnD,qBAAC;MAAG,WAAU;;OACZ,qBAAC;QAAG;QACwB;QAC1B,oBAAC,oBAAK,oCAAsC;WACzC;OACL,oBAAC,kBAAG,uEAEC;OACL,oBAAC,kBAAG,kDAAkD;OACtD,oBAAC,kBAAG,2CAA2C;OAC/C,oBAAC,kBAAG,0CAA0C;OAC9C,oBAAC,kBAAG,mDAAmD;;OACpD;MACD;IAEN,oBAAC;KAAI,WAAU;eACb,qBAAC;MAAK,MAAK;MAAkC,WAAU;iBAAc,sCACjC,oBAAC,gBAAa,MAAM,KAAM;OACvD;MACH;;IACF;GACF"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"InstallationPage.d.ts","names":[],"sources":["../../../../src/components/docs/getting-started/InstallationPage.tsx"],"mappings":";;;iBAIgB,gBAAA,CAAA,GAAgB,kBAAA,CAAA,GAAA,CAAA,OAAA"}

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

@@ -0,0 +1,123 @@
+import { ChevronRight } from "lucide-react";
+import { CodeBlock, InstallCommand } 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/InstallationPage.tsx
+function InstallationPage() {
+	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: "Installation"
+			}), /* @__PURE__ */ jsx("p", {
+				className: "text-muted-foreground text-lg",
+				children: "Add ContractSpec to your existing Next.js or Bun project, or start fresh."
+			})]
+		}), /* @__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: "Prerequisites"
+					}), /* @__PURE__ */ jsxs("ul", {
+						className: "text-muted-foreground space-y-2",
+						children: [
+							/* @__PURE__ */ jsx("li", { children: "Node.js 20+ (or Bun 1.0+)" }),
+							/* @__PURE__ */ jsx("li", { children: "Existing Next.js app or Bun HTTP server" }),
+							/* @__PURE__ */ jsx("li", { children: "PostgreSQL database (for persistence)" })
+						]
+					})]
+				}),
+				/* @__PURE__ */ jsxs("div", {
+					className: "space-y-3",
+					children: [
+						/* @__PURE__ */ jsx("h2", {
+							className: "text-2xl font-bold",
+							children: "Install Core Libraries"
+						}),
+						/* @__PURE__ */ jsx("p", {
+							className: "text-muted-foreground",
+							children: "Add the contracts runtime and your choice of adapter:"
+						}),
+						/* @__PURE__ */ jsx(InstallCommand, { package: ["@contractspec/lib.contracts", "@contractspec/lib.schema"] })
+					]
+				}),
+				/* @__PURE__ */ jsxs("div", {
+					className: "space-y-3",
+					children: [/* @__PURE__ */ jsx("h2", {
+						className: "text-2xl font-bold",
+						children: "For Next.js projects"
+					}), /* @__PURE__ */ jsx(InstallCommand, { package: "@contractspec/lib.contracts" })]
+				}),
+				/* @__PURE__ */ jsxs("div", {
+					className: "space-y-3",
+					children: [/* @__PURE__ */ jsx("h2", {
+						className: "text-2xl font-bold",
+						children: "For database models"
+					}), /* @__PURE__ */ jsx(InstallCommand, { package: [
+						"@contractspec/app.cli-database",
+						"prisma",
+						"@prisma/client"
+					] })]
+				}),
+				/* @__PURE__ */ jsxs("div", {
+					className: "space-y-3",
+					children: [
+						/* @__PURE__ */ jsx("h2", {
+							className: "text-2xl font-bold",
+							children: "Set up your project"
+						}),
+						/* @__PURE__ */ jsx("p", {
+							className: "text-muted-foreground",
+							children: "Initialize a new ContractSpec project structure:"
+						}),
+						/* @__PURE__ */ jsx(CodeBlock, {
+							language: "bash",
+							filename: "installation-init",
+							code: `bunx contractspec init
+# Follow the interactive prompts to configure your project`
+						})
+					]
+				}),
+				/* @__PURE__ */ jsxs("div", {
+					className: "space-y-3",
+					children: [
+						/* @__PURE__ */ jsx("h2", {
+							className: "text-2xl font-bold",
+							children: "Initialize the database"
+						}),
+						/* @__PURE__ */ jsx("p", {
+							className: "text-muted-foreground",
+							children: "If using Prisma, set up your schema and generate the client:"
+						}),
+						/* @__PURE__ */ jsx(CodeBlock, {
+							language: "bash",
+							filename: "installation-prisma",
+							code: `bunx prisma init
+# Edit prisma/schema.prisma with your models
+bunx prisma generate
+bunx prisma migrate dev --name init`
+						})
+					]
+				}),
+				/* @__PURE__ */ jsx("div", {
+					className: "flex items-center gap-4 pt-4",
+					children: /* @__PURE__ */ jsxs(Link, {
+						href: "/docs/getting-started/hello-world",
+						className: "btn-primary",
+						children: ["Next: First Operation ", /* @__PURE__ */ jsx(ChevronRight, { size: 16 })]
+					})
+				})
+			]
+		})]
+	});
+}
+
+//#endregion
+export { InstallationPage };
+//# sourceMappingURL=InstallationPage.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"InstallationPage.js","names":[],"sources":["../../../../src/components/docs/getting-started/InstallationPage.tsx"],"sourcesContent":["import Link from '@contractspec/lib.ui-link';\nimport { ChevronRight } from 'lucide-react';\nimport { CodeBlock, InstallCommand } from '@contractspec/lib.design-system';\n\nexport function InstallationPage() {\n  return (\n    <div className=\"space-y-8\">\n      <div className=\"space-y-2\">\n        <h1 className=\"text-4xl font-bold\">Installation</h1>\n        <p className=\"text-muted-foreground text-lg\">\n          Add ContractSpec to your existing Next.js or Bun project, or start\n          fresh.\n        </p>\n      </div>\n\n      <div className=\"space-y-6\">\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">Prerequisites</h2>\n          <ul className=\"text-muted-foreground space-y-2\">\n            <li>Node.js 20+ (or Bun 1.0+)</li>\n            <li>Existing Next.js app or Bun HTTP server</li>\n            <li>PostgreSQL database (for persistence)</li>\n          </ul>\n        </div>\n\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">Install Core Libraries</h2>\n          <p className=\"text-muted-foreground\">\n            Add the contracts runtime and your choice of adapter:\n          </p>\n          <InstallCommand\n            package={[\n              '@contractspec/lib.contracts',\n              '@contractspec/lib.schema',\n            ]}\n          />\n        </div>\n\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">For Next.js projects</h2>\n          <InstallCommand package=\"@contractspec/lib.contracts\" />\n        </div>\n\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">For database models</h2>\n          <InstallCommand\n            package={[\n              '@contractspec/app.cli-database',\n              'prisma',\n              '@prisma/client',\n            ]}\n          />\n        </div>\n\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">Set up your project</h2>\n          <p className=\"text-muted-foreground\">\n            Initialize a new ContractSpec project structure:\n          </p>\n          <CodeBlock\n            language=\"bash\"\n            filename=\"installation-init\"\n            code={`bunx contractspec init\n# Follow the interactive prompts to configure your project`}\n          />\n        </div>\n\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">Initialize the database</h2>\n          <p className=\"text-muted-foreground\">\n            If using Prisma, set up your schema and generate the client:\n          </p>\n          <CodeBlock\n            language=\"bash\"\n            filename=\"installation-prisma\"\n            code={`bunx prisma init\n# Edit prisma/schema.prisma with your models\nbunx prisma generate\nbunx prisma migrate dev --name init`}\n          />\n        </div>\n\n        <div className=\"flex items-center gap-4 pt-4\">\n          <Link\n            href=\"/docs/getting-started/hello-world\"\n            className=\"btn-primary\"\n          >\n            Next: First Operation <ChevronRight size={16} />\n          </Link>\n        </div>\n      </div>\n    </div>\n  );\n}\n"],"mappings":";;;;;;AAIA,SAAgB,mBAAmB;AACjC,QACE,qBAAC;EAAI,WAAU;aACb,qBAAC;GAAI,WAAU;cACb,oBAAC;IAAG,WAAU;cAAqB;KAAiB,EACpD,oBAAC;IAAE,WAAU;cAAgC;KAGzC;IACA,EAEN,qBAAC;GAAI,WAAU;;IACb,qBAAC;KAAI,WAAU;gBACb,oBAAC;MAAG,WAAU;gBAAqB;OAAkB,EACrD,qBAAC;MAAG,WAAU;;OACZ,oBAAC,kBAAG,8BAA8B;OAClC,oBAAC,kBAAG,4CAA4C;OAChD,oBAAC,kBAAG,0CAA0C;;OAC3C;MACD;IAEN,qBAAC;KAAI,WAAU;;MACb,oBAAC;OAAG,WAAU;iBAAqB;QAA2B;MAC9D,oBAAC;OAAE,WAAU;iBAAwB;QAEjC;MACJ,oBAAC,kBACC,SAAS,CACP,+BACA,2BACD,GACD;;MACE;IAEN,qBAAC;KAAI,WAAU;gBACb,oBAAC;MAAG,WAAU;gBAAqB;OAAyB,EAC5D,oBAAC,kBAAe,SAAQ,gCAAgC;MACpD;IAEN,qBAAC;KAAI,WAAU;gBACb,oBAAC;MAAG,WAAU;gBAAqB;OAAwB,EAC3D,oBAAC,kBACC,SAAS;MACP;MACA;MACA;MACD,GACD;MACE;IAEN,qBAAC;KAAI,WAAU;;MACb,oBAAC;OAAG,WAAU;iBAAqB;QAAwB;MAC3D,oBAAC;OAAE,WAAU;iBAAwB;QAEjC;MACJ,oBAAC;OACC,UAAS;OACT,UAAS;OACT,MAAM;;QAEN;;MACE;IAEN,qBAAC;KAAI,WAAU;;MACb,oBAAC;OAAG,WAAU;iBAAqB;QAA4B;MAC/D,oBAAC;OAAE,WAAU;iBAAwB;QAEjC;MACJ,oBAAC;OACC,UAAS;OACT,UAAS;OACT,MAAM;;;;QAIN;;MACE;IAEN,oBAAC;KAAI,WAAU;eACb,qBAAC;MACC,MAAK;MACL,WAAU;iBACX,0BACuB,oBAAC,gBAAa,MAAM,KAAM;OAC3C;MACH;;IACF;GACF"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"StartHerePage.d.ts","names":[],"sources":["../../../../src/components/docs/getting-started/StartHerePage.tsx"],"mappings":";;;iBAIgB,aAAA,CAAA,GAAa,kBAAA,CAAA,GAAA,CAAA,OAAA"}

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

@@ -0,0 +1,103 @@
+import { ChevronRight } from "lucide-react";
+import { CodeBlock, InstallCommand } 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/StartHerePage.tsx
+function StartHerePage() {
+	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: "Start here"
+				}), /* @__PURE__ */ jsx("p", {
+					className: "text-muted-foreground text-lg",
+					children: "A fast onboarding path from install to your first generated contract."
+				})]
+			}),
+			/* @__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: "Install the CLI"
+						}), /* @__PURE__ */ jsx(InstallCommand, {
+							package: "contractspec",
+							dev: true
+						})]
+					}),
+					/* @__PURE__ */ jsxs("div", {
+						className: "space-y-3",
+						children: [/* @__PURE__ */ jsx("h2", {
+							className: "text-2xl font-bold",
+							children: "Add core libraries"
+						}), /* @__PURE__ */ jsx(InstallCommand, { package: ["@contractspec/lib.contracts", "@contractspec/lib.schema"] })]
+					}),
+					/* @__PURE__ */ jsxs("div", {
+						className: "space-y-3",
+						children: [/* @__PURE__ */ jsx("h2", {
+							className: "text-2xl font-bold",
+							children: "Initialize your project"
+						}), /* @__PURE__ */ jsx(CodeBlock, {
+							language: "bash",
+							filename: "start-here-init",
+							code: `bunx contractspec init`
+						})]
+					}),
+					/* @__PURE__ */ jsxs("div", {
+						className: "space-y-3",
+						children: [/* @__PURE__ */ jsx("h2", {
+							className: "text-2xl font-bold",
+							children: "Create your first contract"
+						}), /* @__PURE__ */ jsx(CodeBlock, {
+							language: "bash",
+							filename: "start-here-create",
+							code: `contractspec create --type operation`
+						})]
+					}),
+					/* @__PURE__ */ jsxs("div", {
+						className: "space-y-3",
+						children: [/* @__PURE__ */ jsx("h2", {
+							className: "text-2xl font-bold",
+							children: "Generate implementation"
+						}), /* @__PURE__ */ jsx(CodeBlock, {
+							language: "bash",
+							filename: "start-here-build",
+							code: `contractspec build src/contracts/mySpec.ts
+contractspec validate src/contracts/mySpec.ts`
+						})]
+					})
+				]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "flex flex-wrap items-center gap-3 pt-2",
+				children: [
+					/* @__PURE__ */ jsxs(Link, {
+						href: "/docs/getting-started/hello-world",
+						className: "btn-primary",
+						children: ["Next: Hello World ", /* @__PURE__ */ jsx(ChevronRight, { size: 16 })]
+					}),
+					/* @__PURE__ */ jsx(Link, {
+						href: "/docs/getting-started/troubleshooting",
+						className: "btn-ghost",
+						children: "Troubleshooting"
+					}),
+					/* @__PURE__ */ jsx(Link, {
+						href: "/docs/getting-started/compatibility",
+						className: "btn-ghost",
+						children: "Compatibility"
+					})
+				]
+			})
+		]
+	});
+}
+
+//#endregion
+export { StartHerePage };
+//# sourceMappingURL=StartHerePage.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"StartHerePage.js","names":[],"sources":["../../../../src/components/docs/getting-started/StartHerePage.tsx"],"sourcesContent":["import Link from '@contractspec/lib.ui-link';\nimport { ChevronRight } from 'lucide-react';\nimport { CodeBlock, InstallCommand } from '@contractspec/lib.design-system';\n\nexport function StartHerePage() {\n  return (\n    <div className=\"space-y-8\">\n      <div className=\"space-y-2\">\n        <h1 className=\"text-4xl font-bold\">Start here</h1>\n        <p className=\"text-muted-foreground text-lg\">\n          A fast onboarding path from install to your first generated contract.\n        </p>\n      </div>\n\n      <div className=\"space-y-6\">\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">Install the CLI</h2>\n          <InstallCommand package=\"contractspec\" dev />\n        </div>\n\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">Add core libraries</h2>\n          <InstallCommand\n            package={[\n              '@contractspec/lib.contracts',\n              '@contractspec/lib.schema',\n            ]}\n          />\n        </div>\n\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">Initialize your project</h2>\n          <CodeBlock\n            language=\"bash\"\n            filename=\"start-here-init\"\n            code={`bunx contractspec init`}\n          />\n        </div>\n\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">Create your first contract</h2>\n          <CodeBlock\n            language=\"bash\"\n            filename=\"start-here-create\"\n            code={`contractspec create --type operation`}\n          />\n        </div>\n\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">Generate implementation</h2>\n          <CodeBlock\n            language=\"bash\"\n            filename=\"start-here-build\"\n            code={`contractspec build src/contracts/mySpec.ts\ncontractspec validate src/contracts/mySpec.ts`}\n          />\n        </div>\n      </div>\n\n      <div className=\"flex flex-wrap items-center gap-3 pt-2\">\n        <Link href=\"/docs/getting-started/hello-world\" className=\"btn-primary\">\n          Next: Hello World <ChevronRight size={16} />\n        </Link>\n        <Link\n          href=\"/docs/getting-started/troubleshooting\"\n          className=\"btn-ghost\"\n        >\n          Troubleshooting\n        </Link>\n        <Link href=\"/docs/getting-started/compatibility\" className=\"btn-ghost\">\n          Compatibility\n        </Link>\n      </div>\n    </div>\n  );\n}\n"],"mappings":";;;;;;AAIA,SAAgB,gBAAgB;AAC9B,QACE,qBAAC;EAAI,WAAU;;GACb,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAe,EAClD,oBAAC;KAAE,WAAU;eAAgC;MAEzC;KACA;GAEN,qBAAC;IAAI,WAAU;;KACb,qBAAC;MAAI,WAAU;iBACb,oBAAC;OAAG,WAAU;iBAAqB;QAAoB,EACvD,oBAAC;OAAe,SAAQ;OAAe;QAAM;OACzC;KAEN,qBAAC;MAAI,WAAU;iBACb,oBAAC;OAAG,WAAU;iBAAqB;QAAuB,EAC1D,oBAAC,kBACC,SAAS,CACP,+BACA,2BACD,GACD;OACE;KAEN,qBAAC;MAAI,WAAU;iBACb,oBAAC;OAAG,WAAU;iBAAqB;QAA4B,EAC/D,oBAAC;OACC,UAAS;OACT,UAAS;OACT,MAAM;QACN;OACE;KAEN,qBAAC;MAAI,WAAU;iBACb,oBAAC;OAAG,WAAU;iBAAqB;QAA+B,EAClE,oBAAC;OACC,UAAS;OACT,UAAS;OACT,MAAM;QACN;OACE;KAEN,qBAAC;MAAI,WAAU;iBACb,oBAAC;OAAG,WAAU;iBAAqB;QAA4B,EAC/D,oBAAC;OACC,UAAS;OACT,UAAS;OACT,MAAM;;QAEN;OACE;;KACF;GAEN,qBAAC;IAAI,WAAU;;KACb,qBAAC;MAAK,MAAK;MAAoC,WAAU;iBAAc,sBACnD,oBAAC,gBAAa,MAAM,KAAM;OACvC;KACP,oBAAC;MACC,MAAK;MACL,WAAU;gBACX;OAEM;KACP,oBAAC;MAAK,MAAK;MAAsC,WAAU;gBAAY;OAEhE;;KACH;;GACF"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"TroubleshootingPage.d.ts","names":[],"sources":["../../../../src/components/docs/getting-started/TroubleshootingPage.tsx"],"mappings":";;;iBAIgB,mBAAA,CAAA,GAAmB,kBAAA,CAAA,GAAA,CAAA,OAAA"}

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

@@ -0,0 +1,117 @@
+import { ChevronRight } 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/TroubleshootingPage.tsx
+function TroubleshootingPage() {
+	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: "Troubleshooting"
+				}), /* @__PURE__ */ jsx("p", {
+					className: "text-muted-foreground text-lg",
+					children: "Common issues and fixes when installing or generating with ContractSpec."
+				})]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "space-y-6",
+				children: [
+					/* @__PURE__ */ jsxs("div", {
+						className: "card-subtle space-y-3 p-6",
+						children: [/* @__PURE__ */ jsx("h2", {
+							className: "text-2xl font-bold",
+							children: "Command not found"
+						}), /* @__PURE__ */ jsxs("ul", {
+							className: "text-muted-foreground space-y-2",
+							children: [/* @__PURE__ */ jsx("li", { children: "Reinstall the CLI and ensure it is in your PATH." }), /* @__PURE__ */ jsx("li", { children: "Confirm Node.js 20+ or Bun 1.0+ is installed." })]
+						})]
+					}),
+					/* @__PURE__ */ jsxs("div", {
+						className: "card-subtle space-y-3 p-6",
+						children: [/* @__PURE__ */ jsx("h2", {
+							className: "text-2xl font-bold",
+							children: "Specs not discovered"
+						}), /* @__PURE__ */ jsxs("ul", {
+							className: "text-muted-foreground space-y-2",
+							children: [/* @__PURE__ */ jsxs("li", { children: [
+								"Run ",
+								/* @__PURE__ */ jsx("code", { children: "contractspec list" }),
+								" to see discovered specs."
+							] }), /* @__PURE__ */ jsx("li", { children: "Verify your spec path conventions in .contractsrc.json." })]
+						})]
+					}),
+					/* @__PURE__ */ jsxs("div", {
+						className: "card-subtle space-y-3 p-6",
+						children: [/* @__PURE__ */ jsx("h2", {
+							className: "text-2xl font-bold",
+							children: "Build or validate fails"
+						}), /* @__PURE__ */ jsxs("ul", {
+							className: "text-muted-foreground space-y-2",
+							children: [/* @__PURE__ */ jsxs("li", { children: [
+								"Run ",
+								/* @__PURE__ */ jsx("code", { children: "contractspec validate" }),
+								" to surface schema errors."
+							] }), /* @__PURE__ */ jsx("li", { children: "Check that generated files were not manually edited." })]
+						})]
+					}),
+					/* @__PURE__ */ jsxs("div", {
+						className: "space-y-3",
+						children: [/* @__PURE__ */ jsx("h2", {
+							className: "text-2xl font-bold",
+							children: "Diagnostics"
+						}), /* @__PURE__ */ jsx(CodeBlock, {
+							language: "bash",
+							filename: "troubleshooting-diagnostics",
+							code: `contractspec --version
+contractspec list
+contractspec validate src/contracts/mySpec.ts`
+						})]
+					}),
+					/* @__PURE__ */ jsxs("div", {
+						className: "card-subtle space-y-3 p-6",
+						children: [/* @__PURE__ */ jsx("h2", {
+							className: "text-2xl font-bold",
+							children: "Still blocked?"
+						}), /* @__PURE__ */ jsxs("ul", {
+							className: "text-muted-foreground space-y-2",
+							children: [
+								/* @__PURE__ */ jsx("li", { children: "Confirm compatibility requirements for runtime and framework." }),
+								/* @__PURE__ */ jsx("li", { children: "Re-run builds on a clean branch to isolate changes." }),
+								/* @__PURE__ */ jsx("li", { children: "Use a new spec and minimal adapter to validate setup." })
+							]
+						})]
+					})
+				]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "flex flex-wrap items-center gap-3 pt-2",
+				children: [
+					/* @__PURE__ */ jsx(Link, {
+						href: "/docs/getting-started/start-here",
+						className: "btn-ghost",
+						children: "Start here"
+					}),
+					/* @__PURE__ */ jsx(Link, {
+						href: "/docs/getting-started/compatibility",
+						className: "btn-ghost",
+						children: "Compatibility"
+					}),
+					/* @__PURE__ */ jsxs(Link, {
+						href: "/docs/getting-started/installation",
+						className: "btn-primary",
+						children: ["Next: Installation ", /* @__PURE__ */ jsx(ChevronRight, { size: 16 })]
+					})
+				]
+			})
+		]
+	});
+}
+
+//#endregion
+export { TroubleshootingPage };
+//# sourceMappingURL=TroubleshootingPage.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TroubleshootingPage.js","names":[],"sources":["../../../../src/components/docs/getting-started/TroubleshootingPage.tsx"],"sourcesContent":["import Link from '@contractspec/lib.ui-link';\nimport { ChevronRight } from 'lucide-react';\nimport { CodeBlock } from '@contractspec/lib.design-system';\n\nexport function TroubleshootingPage() {\n  return (\n    <div className=\"space-y-8\">\n      <div className=\"space-y-2\">\n        <h1 className=\"text-4xl font-bold\">Troubleshooting</h1>\n        <p className=\"text-muted-foreground text-lg\">\n          Common issues and fixes when installing or generating with\n          ContractSpec.\n        </p>\n      </div>\n\n      <div className=\"space-y-6\">\n        <div className=\"card-subtle space-y-3 p-6\">\n          <h2 className=\"text-2xl font-bold\">Command not found</h2>\n          <ul className=\"text-muted-foreground space-y-2\">\n            <li>Reinstall the CLI and ensure it is in your PATH.</li>\n            <li>Confirm Node.js 20+ or Bun 1.0+ is installed.</li>\n          </ul>\n        </div>\n\n        <div className=\"card-subtle space-y-3 p-6\">\n          <h2 className=\"text-2xl font-bold\">Specs not discovered</h2>\n          <ul className=\"text-muted-foreground space-y-2\">\n            <li>\n              Run <code>contractspec list</code> to see discovered specs.\n            </li>\n            <li>Verify your spec path conventions in .contractsrc.json.</li>\n          </ul>\n        </div>\n\n        <div className=\"card-subtle space-y-3 p-6\">\n          <h2 className=\"text-2xl font-bold\">Build or validate fails</h2>\n          <ul className=\"text-muted-foreground space-y-2\">\n            <li>\n              Run <code>contractspec validate</code> to surface schema errors.\n            </li>\n            <li>Check that generated files were not manually edited.</li>\n          </ul>\n        </div>\n\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">Diagnostics</h2>\n          <CodeBlock\n            language=\"bash\"\n            filename=\"troubleshooting-diagnostics\"\n            code={`contractspec --version\ncontractspec list\ncontractspec validate src/contracts/mySpec.ts`}\n          />\n        </div>\n\n        <div className=\"card-subtle space-y-3 p-6\">\n          <h2 className=\"text-2xl font-bold\">Still blocked?</h2>\n          <ul className=\"text-muted-foreground space-y-2\">\n            <li>\n              Confirm compatibility requirements for runtime and framework.\n            </li>\n            <li>Re-run builds on a clean branch to isolate changes.</li>\n            <li>Use a new spec and minimal adapter to validate setup.</li>\n          </ul>\n        </div>\n      </div>\n\n      <div className=\"flex flex-wrap items-center gap-3 pt-2\">\n        <Link href=\"/docs/getting-started/start-here\" className=\"btn-ghost\">\n          Start here\n        </Link>\n        <Link href=\"/docs/getting-started/compatibility\" className=\"btn-ghost\">\n          Compatibility\n        </Link>\n        <Link href=\"/docs/getting-started/installation\" className=\"btn-primary\">\n          Next: Installation <ChevronRight size={16} />\n        </Link>\n      </div>\n    </div>\n  );\n}\n"],"mappings":";;;;;;AAIA,SAAgB,sBAAsB;AACpC,QACE,qBAAC;EAAI,WAAU;;GACb,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAoB,EACvD,oBAAC;KAAE,WAAU;eAAgC;MAGzC;KACA;GAEN,qBAAC;IAAI,WAAU;;KACb,qBAAC;MAAI,WAAU;iBACb,oBAAC;OAAG,WAAU;iBAAqB;QAAsB,EACzD,qBAAC;OAAG,WAAU;kBACZ,oBAAC,kBAAG,qDAAqD,EACzD,oBAAC,kBAAG,kDAAkD;QACnD;OACD;KAEN,qBAAC;MAAI,WAAU;iBACb,oBAAC;OAAG,WAAU;iBAAqB;QAAyB,EAC5D,qBAAC;OAAG,WAAU;kBACZ,qBAAC;QAAG;QACE,oBAAC,oBAAK,sBAAwB;;WAC/B,EACL,oBAAC,kBAAG,4DAA4D;QAC7D;OACD;KAEN,qBAAC;MAAI,WAAU;iBACb,oBAAC;OAAG,WAAU;iBAAqB;QAA4B,EAC/D,qBAAC;OAAG,WAAU;kBACZ,qBAAC;QAAG;QACE,oBAAC,oBAAK,0BAA4B;;WACnC,EACL,oBAAC,kBAAG,yDAAyD;QAC1D;OACD;KAEN,qBAAC;MAAI,WAAU;iBACb,oBAAC;OAAG,WAAU;iBAAqB;QAAgB,EACnD,oBAAC;OACC,UAAS;OACT,UAAS;OACT,MAAM;;;QAGN;OACE;KAEN,qBAAC;MAAI,WAAU;iBACb,oBAAC;OAAG,WAAU;iBAAqB;QAAmB,EACtD,qBAAC;OAAG,WAAU;;QACZ,oBAAC,kBAAG,kEAEC;QACL,oBAAC,kBAAG,wDAAwD;QAC5D,oBAAC,kBAAG,0DAA0D;;QAC3D;OACD;;KACF;GAEN,qBAAC;IAAI,WAAU;;KACb,oBAAC;MAAK,MAAK;MAAmC,WAAU;gBAAY;OAE7D;KACP,oBAAC;MAAK,MAAK;MAAsC,WAAU;gBAAY;OAEhE;KACP,qBAAC;MAAK,MAAK;MAAqC,WAAU;iBAAc,uBACnD,oBAAC,gBAAa,MAAM,KAAM;OACxC;;KACH;;GACF"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"VSCodeExtensionPage.d.ts","names":[],"sources":["../../../../src/components/docs/getting-started/VSCodeExtensionPage.tsx"],"mappings":";;;iBAIgB,mBAAA,CAAA,GAAmB,kBAAA,CAAA,GAAA,CAAA,OAAA"}