@contractspec/bundle.library 3.8.9 → 3.8.11

package/dist/node/components/docs/guides/GuideImportExistingCodebasesPage.js

@@ -1,256 +1,11 @@
-// src/components/docs/shared/StudioPrompt.tsx
-import Link from "@contractspec/lib.ui-link";
-import { jsx, jsxs } from "react/jsx-runtime";
-function StudioPrompt({
-  title = "Need the operating layer on top of OSS ContractSpec?",
-  body = "ContractSpec Studio helps teams turn evidence into proposed spec changes, governed delivery loops, and execution-ready task packs while keeping the open contract system as the source of truth.",
-  ctaLabel = "See what Studio adds",
-  href = "https://www.contractspec.studio/docs"
-}) {
-  return /* @__PURE__ */ jsxs("div", {
-    className: "card-subtle space-y-3 p-6",
-    children: [
-      /* @__PURE__ */ jsx("h3", {
-        className: "font-semibold text-lg",
-        children: title
-      }),
-      /* @__PURE__ */ jsx("p", {
-        className: "text-muted-foreground text-sm",
-        children: body
-      }),
-      /* @__PURE__ */ jsx(Link, {
-        href,
-        className: "btn-primary",
-        children: ctaLabel
-      })
-    ]
-  });
-}
-
-// src/components/docs/guides/GuideImportExistingCodebasesPage.tsx
-import { CodeBlock } from "@contractspec/lib.design-system";
-import Link2 from "@contractspec/lib.ui-link";
-import {
-  AlertCircle,
-  ChevronRight,
-  FileCode,
-  Scan,
-  Settings
-} from "lucide-react";
-import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
-var supportedFrameworks = [
-  {
-    name: "NestJS",
-    flag: "nestjs",
-    description: "Controllers, decorators, DTOs"
-  },
-  {
-    name: "Express",
-    flag: "express",
-    description: "Router methods, middleware"
-  },
-  {
-    name: "Fastify",
-    flag: "fastify",
-    description: "Route definitions, schemas"
-  },
-  {
-    name: "Hono",
-    flag: "hono",
-    description: "Route handlers, validators"
-  },
-  {
-    name: "Elysia",
-    flag: "elysia",
-    description: "Type-safe routes, schemas"
-  },
-  {
-    name: "tRPC",
-    flag: "trpc",
-    description: "Procedure definitions"
-  },
-  {
-    name: "Next.js",
-    flag: "next-api",
-    description: "API routes (app/api, pages/api)"
-  }
-];
-function GuideImportExistingCodebasesPage() {
-  return /* @__PURE__ */ jsxs2("div", {
-    className: "space-y-8",
-    children: [
-      /* @__PURE__ */ jsxs2("div", {
-        className: "space-y-3",
-        children: [
-          /* @__PURE__ */ jsx2("h1", {
-            className: "font-bold text-4xl",
-            children: "Import Existing Codebases"
-          }),
-          /* @__PURE__ */ jsx2("p", {
-            className: "text-lg text-muted-foreground",
-            children: "Convert your existing API endpoints into ContractSpec contracts. Auto-detect frameworks, extract schemas, and generate explicit contract definitions from your code."
-          })
-        ]
-      }),
-      /* @__PURE__ */ jsxs2("div", {
-        className: "card-subtle space-y-4 p-6",
-        children: [
-          /* @__PURE__ */ jsx2("h2", {
-            className: "font-bold text-2xl",
-            children: "What you'll learn"
-          }),
-          /* @__PURE__ */ jsxs2("ul", {
-            className: "space-y-2 text-muted-foreground text-sm",
-            children: [
-              /* @__PURE__ */ jsx2("li", {
-                children: "How to import existing API endpoints as ContractSpec contracts."
-              }),
-              /* @__PURE__ */ jsx2("li", {
-                children: "Framework-specific patterns and auto-detection."
-              }),
-              /* @__PURE__ */ jsx2("li", {
-                children: "Customizing imports with scopes, dry-run, and output options."
-              }),
-              /* @__PURE__ */ jsx2("li", {
-                children: "Registering imported contracts and adding handlers."
-              })
-            ]
-          })
-        ]
-      }),
-      /* @__PURE__ */ jsxs2("div", {
-        className: "space-y-6",
-        children: [
-          /* @__PURE__ */ jsxs2("div", {
-            className: "space-y-3",
-            children: [
-              /* @__PURE__ */ jsx2("h2", {
-                className: "font-bold text-2xl",
-                children: "Why import existing code?"
-              }),
-              /* @__PURE__ */ jsx2("p", {
-                className: "text-muted-foreground text-sm",
-                children: "Instead of writing contracts from scratch, the import command extracts endpoint patterns from your existing codebase. This gives you:"
-              }),
-              /* @__PURE__ */ jsxs2("ul", {
-                className: "list-disc space-y-1 pl-5 text-muted-foreground text-sm",
-                children: [
-                  /* @__PURE__ */ jsx2("li", {
-                    children: "Instant spec coverage for existing APIs"
-                  }),
-                  /* @__PURE__ */ jsx2("li", {
-                    children: "Type-safe schemas derived from your existing types"
-                  }),
-                  /* @__PURE__ */ jsx2("li", {
-                    children: "A foundation to iterate and refine contracts"
-                  }),
-                  /* @__PURE__ */ jsx2("li", {
-                    children: "Gradual adoption without rewriting code"
-                  })
-                ]
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsxs2("div", {
-            className: "space-y-3",
-            children: [
-              /* @__PURE__ */ jsx2("h2", {
-                className: "font-bold text-2xl",
-                children: "Supported frameworks"
-              }),
-              /* @__PURE__ */ jsx2("div", {
-                className: "grid gap-3 md:grid-cols-2 lg:grid-cols-3",
-                children: supportedFrameworks.map((fw) => /* @__PURE__ */ jsxs2("div", {
-                  className: "flex items-start gap-3 rounded-lg border border-white/10 p-4",
-                  children: [
-                    /* @__PURE__ */ jsx2(FileCode, {
-                      className: "text-violet-400",
-                      size: 18
-                    }),
-                    /* @__PURE__ */ jsxs2("div", {
-                      className: "space-y-1",
-                      children: [
-                        /* @__PURE__ */ jsx2("h3", {
-                          className: "font-semibold",
-                          children: fw.name
-                        }),
-                        /* @__PURE__ */ jsx2("p", {
-                          className: "text-muted-foreground text-xs",
-                          children: fw.description
-                        }),
-                        /* @__PURE__ */ jsxs2("code", {
-                          className: "text-violet-400 text-xs",
-                          children: [
-                            "--framework ",
-                            fw.flag
-                          ]
-                        })
-                      ]
-                    })
-                  ]
-                }, fw.flag))
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsxs2("div", {
-            className: "space-y-3",
-            children: [
-              /* @__PURE__ */ jsx2("h2", {
-                className: "font-bold text-2xl",
-                children: "1) Quick start"
-              }),
-              /* @__PURE__ */ jsx2("p", {
-                className: "text-muted-foreground text-sm",
-                children: "Run the import command to auto-detect your framework and extract endpoints:"
-              }),
-              /* @__PURE__ */ jsx2(CodeBlock, {
-                language: "bash",
-                filename: "import-quickstart",
-                code: `# Auto-detect framework and import all endpoints
+import y from"@contractspec/lib.ui-link";import{jsx as r,jsxs as g}from"react/jsx-runtime";function d({title:a="Need the operating layer on top of OSS ContractSpec?",body:m="ContractSpec Studio helps teams turn evidence into proposed spec changes, governed delivery loops, and execution-ready task packs while keeping the open contract system as the source of truth.",ctaLabel:u="See what Studio adds",href:o="https://www.contractspec.studio/docs"}){return g("div",{className:"card-subtle space-y-3 p-6",children:[r("h3",{className:"font-semibold text-lg",children:a}),r("p",{className:"text-muted-foreground text-sm",children:m}),r(y,{href:o,className:"btn-primary",children:u})]})}import{CodeBlock as p}from"@contractspec/lib.design-system";import n from"@contractspec/lib.ui-link";import{AlertCircle as i,ChevronRight as v,FileCode as N,Scan as h,Settings as P}from"lucide-react";import{jsx as t,jsxs as e}from"react/jsx-runtime";var b=[{name:"NestJS",flag:"nestjs",description:"Controllers, decorators, DTOs"},{name:"Express",flag:"express",description:"Router methods, middleware"},{name:"Fastify",flag:"fastify",description:"Route definitions, schemas"},{name:"Hono",flag:"hono",description:"Route handlers, validators"},{name:"Elysia",flag:"elysia",description:"Type-safe routes, schemas"},{name:"tRPC",flag:"trpc",description:"Procedure definitions"},{name:"Next.js",flag:"next-api",description:"API routes (app/api, pages/api)"}];function G(){return e("div",{className:"space-y-8",children:[e("div",{className:"space-y-3",children:[t("h1",{className:"font-bold text-4xl",children:"Import Existing Codebases"}),t("p",{className:"text-lg text-muted-foreground",children:"Convert your existing API endpoints into ContractSpec contracts. Auto-detect frameworks, extract schemas, and generate explicit contract definitions from your code."})]}),e("div",{className:"card-subtle space-y-4 p-6",children:[t("h2",{className:"font-bold text-2xl",children:"What you'll learn"}),e("ul",{className:"space-y-2 text-muted-foreground text-sm",children:[t("li",{children:"How to import existing API endpoints as ContractSpec contracts."}),t("li",{children:"Framework-specific patterns and auto-detection."}),t("li",{children:"Customizing imports with scopes, dry-run, and output options."}),t("li",{children:"Registering imported contracts and adding handlers."})]})]}),e("div",{className:"space-y-6",children:[e("div",{className:"space-y-3",children:[t("h2",{className:"font-bold text-2xl",children:"Why import existing code?"}),t("p",{className:"text-muted-foreground text-sm",children:"Instead of writing contracts from scratch, the import command extracts endpoint patterns from your existing codebase. This gives you:"}),e("ul",{className:"list-disc space-y-1 pl-5 text-muted-foreground text-sm",children:[t("li",{children:"Instant spec coverage for existing APIs"}),t("li",{children:"Type-safe schemas derived from your existing types"}),t("li",{children:"A foundation to iterate and refine contracts"}),t("li",{children:"Gradual adoption without rewriting code"})]})]}),e("div",{className:"space-y-3",children:[t("h2",{className:"font-bold text-2xl",children:"Supported frameworks"}),t("div",{className:"grid gap-3 md:grid-cols-2 lg:grid-cols-3",children:b.map((a)=>e("div",{className:"flex items-start gap-3 rounded-lg border border-white/10 p-4",children:[t(N,{className:"text-violet-400",size:18}),e("div",{className:"space-y-1",children:[t("h3",{className:"font-semibold",children:a.name}),t("p",{className:"text-muted-foreground text-xs",children:a.description}),e("code",{className:"text-violet-400 text-xs",children:["--framework ",a.flag]})]})]},a.flag))})]}),e("div",{className:"space-y-3",children:[t("h2",{className:"font-bold text-2xl",children:"1) Quick start"}),t("p",{className:"text-muted-foreground text-sm",children:"Run the import command to auto-detect your framework and extract endpoints:"}),t(p,{language:"bash",filename:"import-quickstart",code:`# Auto-detect framework and import all endpoints
 contractspec import ./src
 
 # Preview what would be imported (dry-run)
 contractspec import ./src --dry-run
 
 # Force a specific framework
-contractspec import ./src --framework nestjs`
-              }),
-              /* @__PURE__ */ jsx2("p", {
-                className: "text-muted-foreground text-sm",
-                children: "Expected output: A summary of endpoints found, schemas extracted, and files generated."
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsxs2("div", {
-            className: "space-y-3",
-            children: [
-              /* @__PURE__ */ jsx2("h2", {
-                className: "font-bold text-2xl",
-                children: "2) Framework-specific patterns"
-              }),
-              /* @__PURE__ */ jsx2("p", {
-                className: "text-muted-foreground text-sm",
-                children: "The import command recognizes these patterns in each framework:"
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsxs2("div", {
-            className: "space-y-3",
-            children: [
-              /* @__PURE__ */ jsxs2("h3", {
-                className: "flex items-center gap-2 font-semibold text-xl",
-                children: [
-                  /* @__PURE__ */ jsx2(Scan, {
-                    size: 18,
-                    className: "text-blue-400"
-                  }),
-                  "NestJS"
-                ]
-              }),
-              /* @__PURE__ */ jsx2(CodeBlock, {
-                language: "typescript",
-                filename: "src/users/users.controller.ts (before)",
-                code: `@Controller('users')
+contractspec import ./src --framework nestjs`}),t("p",{className:"text-muted-foreground text-sm",children:"Expected output: A summary of endpoints found, schemas extracted, and files generated."})]}),e("div",{className:"space-y-3",children:[t("h2",{className:"font-bold text-2xl",children:"2) Framework-specific patterns"}),t("p",{className:"text-muted-foreground text-sm",children:"The import command recognizes these patterns in each framework:"})]}),e("div",{className:"space-y-3",children:[e("h3",{className:"flex items-center gap-2 font-semibold text-xl",children:[t(h,{size:18,className:"text-blue-400"}),"NestJS"]}),t(p,{language:"typescript",filename:"src/users/users.controller.ts (before)",code:`@Controller('users')
 export class UsersController {
   @Get(':id')
   async getUser(@Param('id') id: string): Promise<UserDto> {
@@ -262,59 +17,7 @@ export class UsersController {
   async createUser(@Body() dto: CreateUserDto): Promise<UserDto> {
     return this.usersService.create(dto);
   }
-}`
-              }),
-              /* @__PURE__ */ jsxs2("p", {
-                className: "text-muted-foreground text-sm",
-                children: [
-                  "Detected: ",
-                  /* @__PURE__ */ jsx2("code", {
-                    children: "@Controller"
-                  }),
-                  ", ",
-                  /* @__PURE__ */ jsx2("code", {
-                    children: "@Get"
-                  }),
-                  ",",
-                  " ",
-                  /* @__PURE__ */ jsx2("code", {
-                    children: "@Post"
-                  }),
-                  ", ",
-                  /* @__PURE__ */ jsx2("code", {
-                    children: "@Body"
-                  }),
-                  ", ",
-                  /* @__PURE__ */ jsx2("code", {
-                    children: "@Param"
-                  }),
-                  ",",
-                  " ",
-                  /* @__PURE__ */ jsx2("code", {
-                    children: "@UseGuards"
-                  }),
-                  " decorators."
-                ]
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsxs2("div", {
-            className: "space-y-3",
-            children: [
-              /* @__PURE__ */ jsxs2("h3", {
-                className: "flex items-center gap-2 font-semibold text-xl",
-                children: [
-                  /* @__PURE__ */ jsx2(Scan, {
-                    size: 18,
-                    className: "text-green-400"
-                  }),
-                  "Express"
-                ]
-              }),
-              /* @__PURE__ */ jsx2(CodeBlock, {
-                language: "typescript",
-                filename: "src/routes/users.ts (before)",
-                code: `const router = express.Router();
+}`}),e("p",{className:"text-muted-foreground text-sm",children:["Detected: ",t("code",{children:"@Controller"}),", ",t("code",{children:"@Get"}),","," ",t("code",{children:"@Post"}),", ",t("code",{children:"@Body"}),", ",t("code",{children:"@Param"}),","," ",t("code",{children:"@UseGuards"})," decorators."]})]}),e("div",{className:"space-y-3",children:[e("h3",{className:"flex items-center gap-2 font-semibold text-xl",children:[t(h,{size:18,className:"text-green-400"}),"Express"]}),t(p,{language:"typescript",filename:"src/routes/users.ts (before)",code:`const router = express.Router();
 
 router.get('/users/:id', async (req, res) => {
   const user = await getUserById(req.params.id);
@@ -324,41 +27,7 @@ router.get('/users/:id', async (req, res) => {
 router.post('/users', validateBody(CreateUserSchema), async (req, res) => {
   const user = await createUser(req.body);
   res.status(201).json(user);
-});`
-              }),
-              /* @__PURE__ */ jsxs2("p", {
-                className: "text-muted-foreground text-sm",
-                children: [
-                  "Detected: ",
-                  /* @__PURE__ */ jsx2("code", {
-                    children: "router.get"
-                  }),
-                  ", ",
-                  /* @__PURE__ */ jsx2("code", {
-                    children: "router.post"
-                  }),
-                  ", validation middleware, Zod schemas."
-                ]
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsxs2("div", {
-            className: "space-y-3",
-            children: [
-              /* @__PURE__ */ jsxs2("h3", {
-                className: "flex items-center gap-2 font-semibold text-xl",
-                children: [
-                  /* @__PURE__ */ jsx2(Scan, {
-                    size: 18,
-                    className: "text-purple-400"
-                  }),
-                  "Next.js API Routes"
-                ]
-              }),
-              /* @__PURE__ */ jsx2(CodeBlock, {
-                language: "typescript",
-                filename: "app/api/users/[id]/route.ts (before)",
-                code: `export async function GET(
+});`}),e("p",{className:"text-muted-foreground text-sm",children:["Detected: ",t("code",{children:"router.get"}),", ",t("code",{children:"router.post"}),", validation middleware, Zod schemas."]})]}),e("div",{className:"space-y-3",children:[e("h3",{className:"flex items-center gap-2 font-semibold text-xl",children:[t(h,{size:18,className:"text-purple-400"}),"Next.js API Routes"]}),t(p,{language:"typescript",filename:"app/api/users/[id]/route.ts (before)",code:`export async function GET(
   request: Request,
   { params }: { params: { id: string } }
 ) {
@@ -370,48 +39,7 @@ export async function POST(request: Request) {
   const body = await request.json();
   const user = await createUser(body);
   return Response.json(user, { status: 201 });
-}`
-              }),
-              /* @__PURE__ */ jsxs2("p", {
-                className: "text-muted-foreground text-sm",
-                children: [
-                  "Detected: ",
-                  /* @__PURE__ */ jsx2("code", {
-                    children: "GET"
-                  }),
-                  ", ",
-                  /* @__PURE__ */ jsx2("code", {
-                    children: "POST"
-                  }),
-                  " exports in",
-                  " ",
-                  /* @__PURE__ */ jsx2("code", {
-                    children: "app/api/**/route.ts"
-                  }),
-                  " and ",
-                  /* @__PURE__ */ jsx2("code", {
-                    children: "pages/api/**/*.ts"
-                  }),
-                  "."
-                ]
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsxs2("div", {
-            className: "space-y-3",
-            children: [
-              /* @__PURE__ */ jsx2("h2", {
-                className: "font-bold text-2xl",
-                children: "3) Understanding generated contracts"
-              }),
-              /* @__PURE__ */ jsx2("p", {
-                className: "text-muted-foreground text-sm",
-                children: "The import command generates ContractSpec operations with TODO placeholders for fields it cannot infer:"
-              }),
-              /* @__PURE__ */ jsx2(CodeBlock, {
-                language: "typescript",
-                filename: ".contractspec/generated/users.operation.ts",
-                code: `import { defineQuery, defineCommand } from "@contractspec/lib.contracts-spec";
+}`}),e("p",{className:"text-muted-foreground text-sm",children:["Detected: ",t("code",{children:"GET"}),", ",t("code",{children:"POST"})," exports in"," ",t("code",{children:"app/api/**/route.ts"})," and ",t("code",{children:"pages/api/**/*.ts"}),"."]})]}),e("div",{className:"space-y-3",children:[t("h2",{className:"font-bold text-2xl",children:"3) Understanding generated contracts"}),t("p",{className:"text-muted-foreground text-sm",children:"The import command generates ContractSpec operations with TODO placeholders for fields it cannot infer:"}),t(p,{language:"typescript",filename:".contractspec/generated/users.operation.ts",code:`import { defineQuery, defineCommand } from "@contractspec/lib.contracts-spec";
 import { SchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
 
 export const GetUserQuery = defineQuery({
@@ -471,191 +99,7 @@ export const CreateUserCommand = defineCommand({
   transport: {
     rest: { method: "POST", path: "/users" },
   },
-});`
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsxs2("div", {
-            className: "space-y-3",
-            children: [
-              /* @__PURE__ */ jsx2("h2", {
-                className: "font-bold text-2xl",
-                children: "4) Customizing imports"
-              }),
-              /* @__PURE__ */ jsxs2("div", {
-                className: "flex items-center gap-2",
-                children: [
-                  /* @__PURE__ */ jsx2(Settings, {
-                    size: 18,
-                    className: "text-violet-400"
-                  }),
-                  /* @__PURE__ */ jsx2("h3", {
-                    className: "font-semibold text-lg",
-                    children: "Available options"
-                  })
-                ]
-              }),
-              /* @__PURE__ */ jsx2("div", {
-                className: "overflow-x-auto",
-                children: /* @__PURE__ */ jsxs2("table", {
-                  className: "w-full text-sm",
-                  children: [
-                    /* @__PURE__ */ jsx2("thead", {
-                      children: /* @__PURE__ */ jsxs2("tr", {
-                        className: "border-white/10 border-b",
-                        children: [
-                          /* @__PURE__ */ jsx2("th", {
-                            className: "py-2 pr-4 text-left",
-                            children: "Option"
-                          }),
-                          /* @__PURE__ */ jsx2("th", {
-                            className: "py-2 pr-4 text-left",
-                            children: "Description"
-                          }),
-                          /* @__PURE__ */ jsx2("th", {
-                            className: "py-2 text-left",
-                            children: "Example"
-                          })
-                        ]
-                      })
-                    }),
-                    /* @__PURE__ */ jsxs2("tbody", {
-                      className: "text-muted-foreground",
-                      children: [
-                        /* @__PURE__ */ jsxs2("tr", {
-                          className: "border-white/5 border-b",
-                          children: [
-                            /* @__PURE__ */ jsx2("td", {
-                              className: "py-2 pr-4",
-                              children: /* @__PURE__ */ jsx2("code", {
-                                children: "--scope"
-                              })
-                            }),
-                            /* @__PURE__ */ jsx2("td", {
-                              className: "py-2 pr-4",
-                              children: "Limit to specific directories"
-                            }),
-                            /* @__PURE__ */ jsx2("td", {
-                              className: "py-2",
-                              children: /* @__PURE__ */ jsx2("code", {
-                                children: "--scope src/users src/auth"
-                              })
-                            })
-                          ]
-                        }),
-                        /* @__PURE__ */ jsxs2("tr", {
-                          className: "border-white/5 border-b",
-                          children: [
-                            /* @__PURE__ */ jsx2("td", {
-                              className: "py-2 pr-4",
-                              children: /* @__PURE__ */ jsx2("code", {
-                                children: "--framework"
-                              })
-                            }),
-                            /* @__PURE__ */ jsx2("td", {
-                              className: "py-2 pr-4",
-                              children: "Force a specific framework"
-                            }),
-                            /* @__PURE__ */ jsx2("td", {
-                              className: "py-2",
-                              children: /* @__PURE__ */ jsx2("code", {
-                                children: "--framework express"
-                              })
-                            })
-                          ]
-                        }),
-                        /* @__PURE__ */ jsxs2("tr", {
-                          className: "border-white/5 border-b",
-                          children: [
-                            /* @__PURE__ */ jsx2("td", {
-                              className: "py-2 pr-4",
-                              children: /* @__PURE__ */ jsx2("code", {
-                                children: "--output"
-                              })
-                            }),
-                            /* @__PURE__ */ jsx2("td", {
-                              className: "py-2 pr-4",
-                              children: "Output directory"
-                            }),
-                            /* @__PURE__ */ jsx2("td", {
-                              className: "py-2",
-                              children: /* @__PURE__ */ jsx2("code", {
-                                children: "--output ./contracts"
-                              })
-                            })
-                          ]
-                        }),
-                        /* @__PURE__ */ jsxs2("tr", {
-                          className: "border-white/5 border-b",
-                          children: [
-                            /* @__PURE__ */ jsx2("td", {
-                              className: "py-2 pr-4",
-                              children: /* @__PURE__ */ jsx2("code", {
-                                children: "--dry-run"
-                              })
-                            }),
-                            /* @__PURE__ */ jsx2("td", {
-                              className: "py-2 pr-4",
-                              children: "Preview without writing files"
-                            }),
-                            /* @__PURE__ */ jsx2("td", {
-                              className: "py-2",
-                              children: /* @__PURE__ */ jsx2("code", {
-                                children: "--dry-run"
-                              })
-                            })
-                          ]
-                        }),
-                        /* @__PURE__ */ jsxs2("tr", {
-                          className: "border-white/5 border-b",
-                          children: [
-                            /* @__PURE__ */ jsx2("td", {
-                              className: "py-2 pr-4",
-                              children: /* @__PURE__ */ jsx2("code", {
-                                children: "--analyze"
-                              })
-                            }),
-                            /* @__PURE__ */ jsx2("td", {
-                              className: "py-2 pr-4",
-                              children: "Analysis only, no code generation"
-                            }),
-                            /* @__PURE__ */ jsx2("td", {
-                              className: "py-2",
-                              children: /* @__PURE__ */ jsx2("code", {
-                                children: "--analyze"
-                              })
-                            })
-                          ]
-                        }),
-                        /* @__PURE__ */ jsxs2("tr", {
-                          children: [
-                            /* @__PURE__ */ jsx2("td", {
-                              className: "py-2 pr-4",
-                              children: /* @__PURE__ */ jsx2("code", {
-                                children: "--json"
-                              })
-                            }),
-                            /* @__PURE__ */ jsx2("td", {
-                              className: "py-2 pr-4",
-                              children: "Output as JSON for scripting"
-                            }),
-                            /* @__PURE__ */ jsx2("td", {
-                              className: "py-2",
-                              children: /* @__PURE__ */ jsx2("code", {
-                                children: "--json"
-                              })
-                            })
-                          ]
-                        })
-                      ]
-                    })
-                  ]
-                })
-              }),
-              /* @__PURE__ */ jsx2(CodeBlock, {
-                language: "bash",
-                filename: "import-options",
-                code: `# Import only specific modules
+});`})]}),e("div",{className:"space-y-3",children:[t("h2",{className:"font-bold text-2xl",children:"4) Customizing imports"}),e("div",{className:"flex items-center gap-2",children:[t(P,{size:18,className:"text-violet-400"}),t("h3",{className:"font-semibold text-lg",children:"Available options"})]}),t("div",{className:"overflow-x-auto",children:e("table",{className:"w-full text-sm",children:[t("thead",{children:e("tr",{className:"border-white/10 border-b",children:[t("th",{className:"py-2 pr-4 text-left",children:"Option"}),t("th",{className:"py-2 pr-4 text-left",children:"Description"}),t("th",{className:"py-2 text-left",children:"Example"})]})}),e("tbody",{className:"text-muted-foreground",children:[e("tr",{className:"border-white/5 border-b",children:[t("td",{className:"py-2 pr-4",children:t("code",{children:"--scope"})}),t("td",{className:"py-2 pr-4",children:"Limit to specific directories"}),t("td",{className:"py-2",children:t("code",{children:"--scope src/users src/auth"})})]}),e("tr",{className:"border-white/5 border-b",children:[t("td",{className:"py-2 pr-4",children:t("code",{children:"--framework"})}),t("td",{className:"py-2 pr-4",children:"Force a specific framework"}),t("td",{className:"py-2",children:t("code",{children:"--framework express"})})]}),e("tr",{className:"border-white/5 border-b",children:[t("td",{className:"py-2 pr-4",children:t("code",{children:"--output"})}),t("td",{className:"py-2 pr-4",children:"Output directory"}),t("td",{className:"py-2",children:t("code",{children:"--output ./contracts"})})]}),e("tr",{className:"border-white/5 border-b",children:[t("td",{className:"py-2 pr-4",children:t("code",{children:"--dry-run"})}),t("td",{className:"py-2 pr-4",children:"Preview without writing files"}),t("td",{className:"py-2",children:t("code",{children:"--dry-run"})})]}),e("tr",{className:"border-white/5 border-b",children:[t("td",{className:"py-2 pr-4",children:t("code",{children:"--analyze"})}),t("td",{className:"py-2 pr-4",children:"Analysis only, no code generation"}),t("td",{className:"py-2",children:t("code",{children:"--analyze"})})]}),e("tr",{children:[t("td",{className:"py-2 pr-4",children:t("code",{children:"--json"})}),t("td",{className:"py-2 pr-4",children:"Output as JSON for scripting"}),t("td",{className:"py-2",children:t("code",{children:"--json"})})]})]})]})}),t(p,{language:"bash",filename:"import-options",code:`# Import only specific modules
 contractspec import ./src --scope src/users src/orders
 
 # Preview with analysis
@@ -665,25 +109,7 @@ contractspec import ./src --dry-run --analyze
 contractspec import ./src --output ./src/contracts/generated
 
 # Get JSON for CI/scripting
-contractspec import ./src --json > import-result.json`
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsxs2("div", {
-            className: "space-y-3",
-            children: [
-              /* @__PURE__ */ jsx2("h2", {
-                className: "font-bold text-2xl",
-                children: "5) Registering imported contracts"
-              }),
-              /* @__PURE__ */ jsx2("p", {
-                className: "text-muted-foreground text-sm",
-                children: "After import, register contracts and add handlers:"
-              }),
-              /* @__PURE__ */ jsx2(CodeBlock, {
-                language: "typescript",
-                filename: "src/contracts/registry.ts",
-                code: `import {
+contractspec import ./src --json > import-result.json`})]}),e("div",{className:"space-y-3",children:[t("h2",{className:"font-bold text-2xl",children:"5) Registering imported contracts"}),t("p",{className:"text-muted-foreground text-sm",children:"After import, register contracts and add handlers:"}),t(p,{language:"typescript",filename:"src/contracts/registry.ts",code:`import {
   OperationSpecRegistry,
   installOp,
 } from "@contractspec/lib.contracts-spec/operations";
@@ -703,176 +129,4 @@ installOp(registry, GetUserQuery, async (input) => {
 installOp(registry, CreateUserCommand, async (input) => {
   const user = await db.user.create({ data: input });
   return { id: user.id };
-});`
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsxs2("div", {
-            className: "space-y-3",
-            children: [
-              /* @__PURE__ */ jsx2("h2", {
-                className: "font-bold text-2xl",
-                children: "6) After importing"
-              }),
-              /* @__PURE__ */ jsxs2("ol", {
-                className: "list-decimal space-y-2 pl-5 text-muted-foreground text-sm",
-                children: [
-                  /* @__PURE__ */ jsxs2("li", {
-                    children: [
-                      /* @__PURE__ */ jsx2("strong", {
-                        children: "Review generated contracts"
-                      }),
-                      " — Check the TODO placeholders and fill in descriptions, owners, and tags."
-                    ]
-                  }),
-                  /* @__PURE__ */ jsxs2("li", {
-                    children: [
-                      /* @__PURE__ */ jsx2("strong", {
-                        children: "Refine schemas"
-                      }),
-                      " — Add proper types, validation rules, and error definitions."
-                    ]
-                  }),
-                  /* @__PURE__ */ jsxs2("li", {
-                    children: [
-                      /* @__PURE__ */ jsx2("strong", {
-                        children: "Run validation"
-                      }),
-                      " —",
-                      " ",
-                      /* @__PURE__ */ jsx2("code", {
-                        children: "contractspec validate"
-                      }),
-                      " to ensure contracts are valid."
-                    ]
-                  }),
-                  /* @__PURE__ */ jsxs2("li", {
-                    children: [
-                      /* @__PURE__ */ jsx2("strong", {
-                        children: "Register and wire handlers"
-                      }),
-                      " — Connect contracts to your existing business logic."
-                    ]
-                  }),
-                  /* @__PURE__ */ jsxs2("li", {
-                    children: [
-                      /* @__PURE__ */ jsx2("strong", {
-                        children: "Iterate"
-                      }),
-                      " — The imported contracts are a starting point. Refine them as your spec matures."
-                    ]
-                  })
-                ]
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsxs2("div", {
-            className: "space-y-3",
-            children: [
-              /* @__PURE__ */ jsxs2("h2", {
-                className: "flex items-center gap-2 font-bold text-2xl",
-                children: [
-                  /* @__PURE__ */ jsx2(AlertCircle, {
-                    size: 20,
-                    className: "text-yellow-400"
-                  }),
-                  "Troubleshooting"
-                ]
-              }),
-              /* @__PURE__ */ jsxs2("div", {
-                className: "space-y-4",
-                children: [
-                  /* @__PURE__ */ jsxs2("div", {
-                    className: "card-subtle space-y-2 p-4",
-                    children: [
-                      /* @__PURE__ */ jsx2("h3", {
-                        className: "font-semibold",
-                        children: "Framework not detected"
-                      }),
-                      /* @__PURE__ */ jsxs2("p", {
-                        className: "text-muted-foreground text-sm",
-                        children: [
-                          "Use ",
-                          /* @__PURE__ */ jsx2("code", {
-                            children: "--framework <name>"
-                          }),
-                          " to force a specific framework. Check that your entry files follow standard patterns."
-                        ]
-                      })
-                    ]
-                  }),
-                  /* @__PURE__ */ jsxs2("div", {
-                    className: "card-subtle space-y-2 p-4",
-                    children: [
-                      /* @__PURE__ */ jsx2("h3", {
-                        className: "font-semibold",
-                        children: "Missing schemas"
-                      }),
-                      /* @__PURE__ */ jsxs2("p", {
-                        className: "text-muted-foreground text-sm",
-                        children: [
-                          "Schema inference works best with explicit types. If using",
-                          " ",
-                          /* @__PURE__ */ jsx2("code", {
-                            children: "any"
-                          }),
-                          " or dynamic types, you'll see TODO placeholders. Fill them in manually."
-                        ]
-                      })
-                    ]
-                  }),
-                  /* @__PURE__ */ jsxs2("div", {
-                    className: "card-subtle space-y-2 p-4",
-                    children: [
-                      /* @__PURE__ */ jsx2("h3", {
-                        className: "font-semibold",
-                        children: "Partial imports"
-                      }),
-                      /* @__PURE__ */ jsxs2("p", {
-                        className: "text-muted-foreground text-sm",
-                        children: [
-                          "Some endpoints may not be detected if they use unconventional patterns. Use ",
-                          /* @__PURE__ */ jsx2("code", {
-                            children: "--analyze"
-                          }),
-                          " to see what was found, then add missing contracts manually."
-                        ]
-                      })
-                    ]
-                  })
-                ]
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsx2(StudioPrompt, {
-            title: "Want evidence-driven migration priorities?",
-            body: "Studio clusters product signals into scored patterns, then proposes contract changes and execution-ready work for the highest-impact areas."
-          })
-        ]
-      }),
-      /* @__PURE__ */ jsxs2("div", {
-        className: "flex items-center gap-4 pt-4",
-        children: [
-          /* @__PURE__ */ jsxs2(Link2, {
-            href: "/docs/guides/spec-validation-and-typing",
-            className: "btn-primary",
-            children: [
-              "Next: Spec validation + typing ",
-              /* @__PURE__ */ jsx2(ChevronRight, {
-                size: 16
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsx2(Link2, {
-            href: "/docs/guides",
-            className: "btn-ghost",
-            children: "Back to guides"
-          })
-        ]
-      })
-    ]
-  });
-}
-export {
-  GuideImportExistingCodebasesPage
-};
+});`})]}),e("div",{className:"space-y-3",children:[t("h2",{className:"font-bold text-2xl",children:"6) After importing"}),e("ol",{className:"list-decimal space-y-2 pl-5 text-muted-foreground text-sm",children:[e("li",{children:[t("strong",{children:"Review generated contracts"})," — Check the TODO placeholders and fill in descriptions, owners, and tags."]}),e("li",{children:[t("strong",{children:"Refine schemas"})," — Add proper types, validation rules, and error definitions."]}),e("li",{children:[t("strong",{children:"Run validation"})," —"," ",t("code",{children:"contractspec validate"})," to ensure contracts are valid."]}),e("li",{children:[t("strong",{children:"Register and wire handlers"})," — Connect contracts to your existing business logic."]}),e("li",{children:[t("strong",{children:"Iterate"})," — The imported contracts are a starting point. Refine them as your spec matures."]})]})]}),e("div",{className:"space-y-3",children:[e("h2",{className:"flex items-center gap-2 font-bold text-2xl",children:[t(i,{size:20,className:"text-yellow-400"}),"Troubleshooting"]}),e("div",{className:"space-y-4",children:[e("div",{className:"card-subtle space-y-2 p-4",children:[t("h3",{className:"font-semibold",children:"Framework not detected"}),e("p",{className:"text-muted-foreground text-sm",children:["Use ",t("code",{children:"--framework <name>"})," to force a specific framework. Check that your entry files follow standard patterns."]})]}),e("div",{className:"card-subtle space-y-2 p-4",children:[t("h3",{className:"font-semibold",children:"Missing schemas"}),e("p",{className:"text-muted-foreground text-sm",children:["Schema inference works best with explicit types. If using"," ",t("code",{children:"any"})," or dynamic types, you'll see TODO placeholders. Fill them in manually."]})]}),e("div",{className:"card-subtle space-y-2 p-4",children:[t("h3",{className:"font-semibold",children:"Partial imports"}),e("p",{className:"text-muted-foreground text-sm",children:["Some endpoints may not be detected if they use unconventional patterns. Use ",t("code",{children:"--analyze"})," to see what was found, then add missing contracts manually."]})]})]})]}),t(d,{title:"Want evidence-driven migration priorities?",body:"Studio clusters product signals into scored patterns, then proposes contract changes and execution-ready work for the highest-impact areas."})]}),e("div",{className:"flex items-center gap-4 pt-4",children:[e(n,{href:"/docs/guides/spec-validation-and-typing",className:"btn-primary",children:["Next: Spec validation + typing ",t(v,{size:16})]}),t(n,{href:"/docs/guides",className:"btn-ghost",children:"Back to guides"})]})]})}export{G as GuideImportExistingCodebasesPage};