@contractspec/bundle.library 3.8.9 → 3.8.11

package/dist/components/docs/guides/GuidesIndexPage.js

@@ -1,173 +1,6 @@
 // @bun
-// src/components/docs/guides/GuidesIndexPage.tsx
-import { CodeBlock } from "@contractspec/lib.design-system";
-import Link from "@contractspec/lib.ui-link";
-import { ArrowRight, CheckCircle2, GitBranch } from "lucide-react";
-import { jsx, jsxs } from "react/jsx-runtime";
-var guides = [
-  {
-    title: "Adopt one endpoint in Next.js",
-    description: "Start inside a live app with one operation, one generated surface, and one clearly bounded change.",
-    href: "/docs/guides/nextjs-one-endpoint",
-    time: "25 min"
-  },
-  {
-    title: "Import an existing codebase",
-    description: "Stabilize what already exists instead of treating adoption as a rewrite project.",
-    href: "/docs/guides/import-existing-codebases",
-    time: "20 min"
-  },
-  {
-    title: "Validation and typing",
-    description: "Keep runtime validation and TypeScript behavior aligned from the same source definitions.",
-    href: "/docs/guides/spec-validation-and-typing",
-    time: "20 min"
-  },
-  {
-    title: "Generate docs and clients",
-    description: "Publish stable docs, schemas, and client-facing artifacts from the contract layer.",
-    href: "/docs/guides/generate-docs-clients-schemas",
-    time: "20 min"
-  },
-  {
-    title: "Docs pipeline",
-    description: "Feed generated reference material into the docs site without confusing ownership.",
-    href: "/docs/guides/docs-generation-pipeline",
-    time: "20 min"
-  },
-  {
-    title: "CI diff gating",
-    description: "Use deterministic checks to catch drift and risky changes before they ship.",
-    href: "/docs/guides/ci-contract-diff-gating",
-    time: "15 min"
-  }
-];
-function GuidesIndexPage() {
-  return /* @__PURE__ */ jsxs("div", {
-    className: "space-y-10",
-    children: [
-      /* @__PURE__ */ jsxs("div", {
-        className: "space-y-3",
-        children: [
-          /* @__PURE__ */ jsx("p", {
-            className: "editorial-kicker",
-            children: "Build"
-          }),
-          /* @__PURE__ */ jsx("h1", {
-            className: "font-serif text-4xl tracking-[-0.04em] md:text-5xl",
-            children: "Adoption guides for teams that want to keep their code."
-          }),
-          /* @__PURE__ */ jsx("p", {
-            className: "max-w-3xl text-lg text-muted-foreground leading-8",
-            children: "These guides assume you are introducing ContractSpec into a real code base. Start with a narrow surface, verify the generated outputs, and expand only after the contract loop feels trustworthy."
-          })
-        ]
-      }),
-      /* @__PURE__ */ jsx("div", {
-        className: "grid gap-4 md:grid-cols-2",
-        children: guides.map((guide) => /* @__PURE__ */ jsxs(Link, {
-          href: guide.href,
-          className: "editorial-panel",
-          children: [
-            /* @__PURE__ */ jsxs("div", {
-              className: "flex items-start justify-between gap-4",
-              children: [
-                /* @__PURE__ */ jsxs("div", {
-                  children: [
-                    /* @__PURE__ */ jsx("h2", {
-                      className: "font-semibold text-xl",
-                      children: guide.title
-                    }),
-                    /* @__PURE__ */ jsx("p", {
-                      className: "mt-2 text-muted-foreground text-sm leading-7",
-                      children: guide.description
-                    })
-                  ]
-                }),
-                /* @__PURE__ */ jsx(ArrowRight, {
-                  className: "mt-1 shrink-0",
-                  size: 18
-                })
-              ]
-            }),
-            /* @__PURE__ */ jsxs("div", {
-              className: "mt-4 flex items-center gap-2 text-muted-foreground text-xs",
-              children: [
-                /* @__PURE__ */ jsx(CheckCircle2, {
-                  size: 14
-                }),
-                /* @__PURE__ */ jsxs("span", {
-                  children: [
-                    "Target time: ",
-                    guide.time
-                  ]
-                })
-              ]
-            })
-          ]
-        }, guide.href))
-      }),
-      /* @__PURE__ */ jsxs("div", {
-        className: "editorial-panel space-y-4",
-        children: [
-          /* @__PURE__ */ jsxs("div", {
-            className: "flex items-center gap-2 font-semibold text-[color:var(--rust)] text-sm uppercase tracking-[0.2em]",
-            children: [
-              /* @__PURE__ */ jsx(GitBranch, {
-                size: 16
-              }),
-              "Working style"
-            ]
-          }),
-          /* @__PURE__ */ jsxs("ul", {
-            className: "editorial-list",
-            children: [
-              /* @__PURE__ */ jsxs("li", {
-                children: [
-                  /* @__PURE__ */ jsx("span", {
-                    className: "editorial-list-marker"
-                  }),
-                  /* @__PURE__ */ jsx("span", {
-                    children: "Run each guide in a branch or sandboxed workspace."
-                  })
-                ]
-              }),
-              /* @__PURE__ */ jsxs("li", {
-                children: [
-                  /* @__PURE__ */ jsx("span", {
-                    className: "editorial-list-marker"
-                  }),
-                  /* @__PURE__ */ jsx("span", {
-                    children: "Prefer one bounded surface at a time: one endpoint, one workflow, one integration, one unsafe module."
-                  })
-                ]
-              }),
-              /* @__PURE__ */ jsxs("li", {
-                children: [
-                  /* @__PURE__ */ jsx("span", {
-                    className: "editorial-list-marker"
-                  }),
-                  /* @__PURE__ */ jsx("span", {
-                    children: "Use the example and reference outputs to verify what changed, not just the narrative page."
-                  })
-                ]
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsx(CodeBlock, {
-            language: "bash",
-            filename: "guides-quickstart",
-            code: `# list example systems
+import{CodeBlock as a}from"@contractspec/lib.design-system";import n from"@contractspec/lib.ui-link";import{ArrowRight as o,CheckCircle2 as r,GitBranch as s}from"lucide-react";import{jsx as e,jsxs as t}from"react/jsx-runtime";var d=[{title:"Adopt one endpoint in Next.js",description:"Start inside a live app with one operation, one generated surface, and one clearly bounded change.",href:"/docs/guides/nextjs-one-endpoint",time:"25 min"},{title:"Import an existing codebase",description:"Stabilize what already exists instead of treating adoption as a rewrite project.",href:"/docs/guides/import-existing-codebases",time:"20 min"},{title:"Validation and typing",description:"Keep runtime validation and TypeScript behavior aligned from the same source definitions.",href:"/docs/guides/spec-validation-and-typing",time:"20 min"},{title:"Generate docs and clients",description:"Publish stable docs, schemas, and client-facing artifacts from the contract layer.",href:"/docs/guides/generate-docs-clients-schemas",time:"20 min"},{title:"Docs pipeline",description:"Feed generated reference material into the docs site without confusing ownership.",href:"/docs/guides/docs-generation-pipeline",time:"20 min"},{title:"Build a first module bundle",description:"Define one bundle spec, resolve a surface plan, and render it through the React host layer.",href:"/docs/guides/first-module-bundle",time:"20 min"},{title:"Host the Builder workbench",description:"Wire a Builder workspace snapshot, common commands, runtime modes, and mobile review links into the reusable host.",href:"/docs/guides/host-builder-workbench",time:"20 min"},{title:"Use Connect in a repo",description:"Enable Connect, verify agent actions locally, and inspect the resulting review and replay artifacts.",href:"/docs/guides/connect-in-a-repo",time:"15 min"},{title:"CI diff gating",description:"Use deterministic checks to catch drift and risky changes before they ship.",href:"/docs/guides/ci-contract-diff-gating",time:"15 min"}];function p(){return t("div",{className:"space-y-10",children:[t("div",{className:"space-y-3",children:[e("p",{className:"editorial-kicker",children:"Build"}),e("h1",{className:"font-serif text-4xl tracking-[-0.04em] md:text-5xl",children:"Adoption guides for teams that want to keep their code."}),e("p",{className:"max-w-3xl text-lg text-muted-foreground leading-8",children:"These guides assume you are introducing ContractSpec into a real code base. Start with a narrow surface, verify the generated outputs, and expand only after the contract loop feels trustworthy."})]}),e("div",{className:"grid gap-4 md:grid-cols-2",children:d.map((i)=>t(n,{href:i.href,className:"editorial-panel",children:[t("div",{className:"flex items-start justify-between gap-4",children:[t("div",{children:[e("h2",{className:"font-semibold text-xl",children:i.title}),e("p",{className:"mt-2 text-muted-foreground text-sm leading-7",children:i.description})]}),e(o,{className:"mt-1 shrink-0",size:18})]}),t("div",{className:"mt-4 flex items-center gap-2 text-muted-foreground text-xs",children:[e(r,{size:14}),t("span",{children:["Target time: ",i.time]})]})]},i.href))}),t("div",{className:"editorial-panel space-y-4",children:[t("div",{className:"flex items-center gap-2 font-semibold text-[color:var(--rust)] text-sm uppercase tracking-[0.2em]",children:[e(s,{size:16}),"Working style"]}),t("ul",{className:"editorial-list",children:[t("li",{children:[e("span",{className:"editorial-list-marker"}),e("span",{children:"Run each guide in a branch or sandboxed workspace."})]}),t("li",{children:[e("span",{className:"editorial-list-marker"}),e("span",{children:"Prefer one bounded surface at a time: one endpoint, one workflow, one integration, one unsafe module."})]}),t("li",{children:[e("span",{className:"editorial-list-marker"}),e("span",{children:"Use the example and reference outputs to verify what changed, not just the narrative page."})]})]}),e(a,{language:"bash",filename:"guides-quickstart",code:`# list example systems
 contractspec examples list
 
 # validate the examples in this workspace
-contractspec examples validate --repo-root .`
-          })
-        ]
-      })
-    ]
-  });
-}
-export {
-  GuidesIndexPage
-};
+contractspec examples validate --repo-root .`})]})]})}export{p as GuidesIndexPage};

package/dist/components/docs/guides/guides.docblocks.js

@@ -1,52 +1,11 @@
 // @bun
-// src/components/docs/guides/guides.docblocks.ts
-import { registerDocBlocks } from "@contractspec/lib.contracts-spec/docs";
-var guideDocBlocks = [
-  {
-    id: "docs.guides.index",
-    title: "Guides",
-    summary: "Hands-on guides for adopting ContractSpec in real workflows.",
-    kind: "goal",
-    visibility: "public",
-    route: "/docs/guides",
-    tags: ["guides", "adoption"],
-    body: `# Guides
-
-Hands-on, runnable guides that map to real adoption scenarios. Each guide includes commands, expected output, and a CI-verified example package.`
-  },
-  {
-    id: "docs.guides.nextjs-one-endpoint",
-    title: "Next.js one endpoint",
-    summary: "Add ContractSpec to an existing Next.js app with one endpoint.",
-    kind: "usage",
-    visibility: "public",
-    route: "/docs/guides/nextjs-one-endpoint",
-    tags: ["guides", "nextjs", "operations"],
-    body: `# Add ContractSpec to a Next.js app (one endpoint)
-
-Create a single OperationSpec, register it, and expose it through a Next.js App Router handler.`
-  },
-  {
-    id: "docs.guides.spec-validation-typing",
-    title: "Spec validation and typing",
-    summary: "Define an operation spec with validation and types, no rewrites.",
-    kind: "usage",
-    visibility: "public",
-    route: "/docs/guides/spec-validation-and-typing",
-    tags: ["guides", "validation", "typing"],
-    body: `# Spec-driven validation and typing
-
-Define command/query specs that enforce validation and generate types without rewriting your app.`
-  },
-  {
-    id: "docs.guides.docs-clients-schemas",
-    title: "Generate docs, clients, schemas",
-    summary: "Generate docs and OpenAPI for client SDKs from specs.",
-    kind: "usage",
-    visibility: "public",
-    route: "/docs/guides/generate-docs-clients-schemas",
-    tags: ["guides", "docs", "openapi"],
-    body: `# Generate docs and client schemas
+import{registerDocBlocks as f}from"@contractspec/lib.contracts-spec/docs";var h=[{id:"docs.guides.index",title:"Guides",summary:"Hands-on guides for adopting ContractSpec in real workflows.",kind:"goal",visibility:"public",route:"/docs/guides",tags:["guides","adoption"],body:`# Guides
+
+Hands-on, runnable guides that map to real adoption scenarios. Each guide includes commands, expected output, and a CI-verified example package.`},{id:"docs.guides.nextjs-one-endpoint",title:"Next.js one endpoint",summary:"Add ContractSpec to an existing Next.js app with one endpoint.",kind:"usage",visibility:"public",route:"/docs/guides/nextjs-one-endpoint",tags:["guides","nextjs","operations"],body:`# Add ContractSpec to a Next.js app (one endpoint)
+
+Create a single OperationSpec, register it, and expose it through a Next.js App Router handler.`},{id:"docs.guides.spec-validation-typing",title:"Spec validation and typing",summary:"Define an operation spec with validation and types, no rewrites.",kind:"usage",visibility:"public",route:"/docs/guides/spec-validation-and-typing",tags:["guides","validation","typing"],body:`# Spec-driven validation and typing
+
+Define command/query specs that enforce validation and generate types without rewriting your app.`},{id:"docs.guides.docs-clients-schemas",title:"Generate docs, clients, schemas",summary:"Generate docs and OpenAPI for client SDKs from specs.",kind:"usage",visibility:"public",route:"/docs/guides/generate-docs-clients-schemas",tags:["guides","docs","openapi"],body:`# Generate docs and client schemas
 
 Use ContractSpec to generate documentation and OpenAPI exports for client SDKs.
 
@@ -64,17 +23,7 @@ bun contractspec generate
 bun docs:generate
 # or versioned output
 bun docs:generate -- --version v1.0.0
-\`\`\``
-  },
-  {
-    id: "docs.guides.docs-generation-pipeline",
-    title: "Docs generation pipeline",
-    summary: "Wire generated docs into a reference site with chunked indexes.",
-    kind: "usage",
-    visibility: "public",
-    route: "/docs/guides/docs-generation-pipeline",
-    tags: ["guides", "docs", "pipeline"],
-    body: `# Build the docs pipeline
+\`\`\``},{id:"docs.guides.docs-generation-pipeline",title:"Docs generation pipeline",summary:"Wire generated docs into a reference site with chunked indexes.",kind:"usage",visibility:"public",route:"/docs/guides/docs-generation-pipeline",tags:["guides","docs","pipeline"],body:`# Build the docs pipeline
 
 Use ContractSpec to generate reference markdown, build a chunked index, and wire it into your docs routes.
 
@@ -94,19 +43,6 @@ bun docs:generate -- --version v1.0.0
 
 ## Reference wiring
 
-Use the generated manifest and chunks under \`docs-index.manifest.json\` and \`docs-index.*.json\` to load the index at runtime.`
-  },
-  {
-    id: "docs.guides.ci-contract-diff-gating",
-    title: "CI gating for contract diffs",
-    summary: "Gate changes with deterministic diffs and CI checks.",
-    kind: "usage",
-    visibility: "public",
-    route: "/docs/guides/ci-contract-diff-gating",
-    tags: ["guides", "ci", "diff"],
-    body: `# CI gating with deterministic diffs
-
-Run ContractSpec CI checks to detect drift and breaking changes before merge.`
-  }
-];
-registerDocBlocks(guideDocBlocks);
+Use the generated manifest and chunks under \`docs-index.manifest.json\` and \`docs-index.*.json\` to load the index at runtime.`},{id:"docs.guides.ci-contract-diff-gating",title:"CI gating for contract diffs",summary:"Gate changes with deterministic diffs and CI checks.",kind:"usage",visibility:"public",route:"/docs/guides/ci-contract-diff-gating",tags:["guides","ci","diff"],body:`# CI gating with deterministic diffs
+
+Run ContractSpec CI checks to detect drift and breaking changes before merge.`}];f(h);

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

@@ -1,8 +1,11 @@
 import './guides.docblocks';
 export { GuideCIDiffGatingPage } from './GuideCIDiffGatingPage';
+export { GuideConnectInRepoPage } from './GuideConnectInRepoPage';
 export { GuideContractTypesPage } from './GuideContractTypesPage';
 export { GuideDocsPipelinePage } from './GuideDocsPipelinePage';
+export { GuideFirstModuleBundlePage } from './GuideFirstModuleBundlePage';
 export { GuideGenerateDocsClientsSchemasPage } from './GuideGenerateDocsClientsSchemasPage';
+export { GuideHostBuilderWorkbenchPage } from './GuideHostBuilderWorkbenchPage';
 export { GuideImportExistingCodebasesPage } from './GuideImportExistingCodebasesPage';
 export { GuideNextjsOneEndpointPage } from './GuideNextjsOneEndpointPage';
 export { GuideSpecValidationTypingPage } from './GuideSpecValidationTypingPage';