@contractspec/bundle.library 0.0.0-canary-20260206014742

package/dist/components/docs/intent/GenerateClientFromSchemaPage.js

@@ -0,0 +1,369 @@
+import { generateClientFromSchemaBrief } from "./intent-pages.docblocks.js";
+import { SeoOptimizer } from "../../../packages/libs/content-gen/dist/seo/optimizer.js";
+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/intent/GenerateClientFromSchemaPage.tsx
+const metadata = new SeoOptimizer().optimize(generateClientFromSchemaBrief);
+function GenerateClientFromSchemaPage() {
+	return /* @__PURE__ */ jsxs("div", {
+		className: "space-y-8",
+		children: [
+			/* @__PURE__ */ jsxs("div", {
+				className: "space-y-3",
+				children: [/* @__PURE__ */ jsx("h1", {
+					className: "text-4xl font-bold",
+					children: generateClientFromSchemaBrief.title
+				}), /* @__PURE__ */ jsx("p", {
+					className: "text-muted-foreground text-lg",
+					children: generateClientFromSchemaBrief.summary
+				})]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "card-subtle space-y-4 p-6",
+				children: [/* @__PURE__ */ jsx("h2", {
+					className: "text-2xl font-bold",
+					children: "Client Development Problems"
+				}), /* @__PURE__ */ jsx("ul", {
+					className: "text-muted-foreground space-y-2 text-sm",
+					children: generateClientFromSchemaBrief.problems.map((problem, index) => /* @__PURE__ */ jsx("li", { children: problem }, index))
+				})]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "card-subtle space-y-4 p-6",
+				children: [/* @__PURE__ */ jsx("h2", {
+					className: "text-2xl font-bold",
+					children: "Automated Solutions"
+				}), /* @__PURE__ */ jsx("ul", {
+					className: "text-muted-foreground space-y-2 text-sm",
+					children: generateClientFromSchemaBrief.solutions.map((solution, index) => /* @__PURE__ */ jsx("li", { children: solution }, index))
+				})]
+			}),
+			/* @__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: "Contract Definition"
+							}),
+							/* @__PURE__ */ jsx("p", {
+								className: "text-muted-foreground text-sm",
+								children: "Define your API contract once, generate clients for any language."
+							}),
+							/* @__PURE__ */ jsx(CodeBlock, {
+								language: "typescript",
+								filename: "src/contracts/api.contract.ts",
+								code: `import { defineContract } from '@contractspec/lib.contracts';
+import { SchemaModel, ScalarTypeEnum } from '@contractspec/lib.schema';
+
+export const ApiContract = defineContract({
+  name: 'MyAPI',
+  version: '1.0.0',
+  baseUrl: 'https://api.example.com',
+  operations: {
+    getUsers: {
+      goal: 'Retrieve paginated list of users',
+      method: 'GET',
+      path: '/users',
+      input: new SchemaModel({
+        type: 'object',
+        properties: {
+          page: { type: 'integer', minimum: 1, default: 1 },
+          limit: { type: 'integer', minimum: 1, maximum: 100, default: 20 },
+        },
+      }),
+      output: new SchemaModel({
+        type: 'object',
+        properties: {
+          users: {
+            type: 'array',
+            items: {
+              type: 'object',
+              properties: {
+                id: { type: 'string', required: true },
+                email: { type: 'string', required: true },
+                name: { type: 'string', required: true },
+              },
+            },
+          },
+          pagination: {
+            type: 'object',
+            properties: {
+              page: { type: 'integer', required: true },
+              limit: { type: 'integer', required: true },
+              total: { type: 'integer', required: true },
+            },
+          },
+        },
+      }),
+    },
+    createUser: {
+      goal: 'Create a new user account',
+      method: 'POST',
+      path: '/users',
+      input: new SchemaModel({
+        type: 'object',
+        properties: {
+          email: { type: 'string', format: 'email', required: true },
+          name: { type: 'string', minLength: 1, required: true },
+        },
+      }),
+      output: new SchemaModel({
+        type: 'object',
+        properties: {
+          id: { type: 'string', required: true },
+          email: { type: 'string', required: true },
+          name: { type: 'string', required: true },
+          createdAt: { type: 'string', format: 'date-time', required: true },
+        },
+      }),
+    },
+  },
+  metadata: {
+    description: 'User management API with authentication',
+    tags: ['users', 'authentication'],
+  },
+});`
+							})
+						]
+					}),
+					/* @__PURE__ */ jsxs("div", {
+						className: "space-y-3",
+						children: [
+							/* @__PURE__ */ jsx("h2", {
+								className: "text-2xl font-bold",
+								children: "Generate Multiple Clients"
+							}),
+							/* @__PURE__ */ jsx("p", {
+								className: "text-muted-foreground text-sm",
+								children: "Generate type-safe clients for any language from the same contract."
+							}),
+							/* @__PURE__ */ jsx(CodeBlock, {
+								language: "bash",
+								filename: "generate-clients",
+								code: `# Generate all supported language clients
+contractspec generate clients \\
+  --contract ./src/contracts/api.contract.ts \\
+  --output ./generated/clients \\
+  --languages typescript,python,go,java,csharp
+
+# Generate specific language client
+contractspec generate clients \\
+  --contract ./src/contracts/api.contract.ts \\
+  --output ./generated/clients \\
+  --languages typescript \\
+  --format npm-package
+
+# Options
+# --with-types: Include TypeScript definitions
+# --with-tests: Generate client test suites
+# --with-docs: Include client documentation
+# --framework: Use specific HTTP client framework`
+							})
+						]
+					}),
+					/* @__PURE__ */ jsxs("div", {
+						className: "space-y-3",
+						children: [
+							/* @__PURE__ */ jsx("h2", {
+								className: "text-2xl font-bold",
+								children: "Generated Client Examples"
+							}),
+							/* @__PURE__ */ jsx("p", {
+								className: "text-muted-foreground text-sm",
+								children: "Each generated client is fully type-safe and idiomatic."
+							}),
+							/* @__PURE__ */ jsxs("div", {
+								className: "space-y-4",
+								children: [
+									/* @__PURE__ */ jsxs("div", {
+										className: "card-subtle p-4",
+										children: [/* @__PURE__ */ jsx("h4", {
+											className: "text-lg font-semibold",
+											children: "TypeScript Client"
+										}), /* @__PURE__ */ jsx(CodeBlock, {
+											language: "typescript",
+											filename: "generated/clients/typescript/index.ts",
+											code: `import { MyAPIClient } from './client';
+
+const client = new MyAPIClient({
+  baseUrl: 'https://api.example.com',
+  apiKey: process.env.API_KEY,
+});
+
+// Type-safe method calls
+const users = await client.getUsers({
+  page: 1,
+  limit: 10,
+});
+
+const newUser = await client.createUser({
+  email: 'user@example.com',
+  name: 'John Doe',
+});
+
+// Full type inference
+// users: GetUsersResponse
+// newUser: CreateUserResponse`
+										})]
+									}),
+									/* @__PURE__ */ jsxs("div", {
+										className: "card-subtle p-4",
+										children: [/* @__PURE__ */ jsx("h4", {
+											className: "text-lg font-semibold",
+											children: "Python Client"
+										}), /* @__PURE__ */ jsx(CodeBlock, {
+											language: "python",
+											filename: "generated/clients/python/index.py",
+											code: `from myapi_client import MyAPIClient
+
+client = MyAPIClient(
+    base_url='https://api.example.com',
+    api_key=os.getenv('API_KEY')
+)
+
+# Type-safe method calls
+users = await client.get_users(
+    page=1,
+    limit=10
+)
+
+new_user = await client.create_user(
+    email='user@example.com',
+    name='John Doe'
+)
+
+# Full type hints
+# users: GetUsersResponse
+# new_user: CreateUserResponse`
+										})]
+									}),
+									/* @__PURE__ */ jsxs("div", {
+										className: "card-subtle p-4",
+										children: [/* @__PURE__ */ jsx("h4", {
+											className: "text-lg font-semibold",
+											children: "Go Client"
+										}), /* @__PURE__ */ jsx(CodeBlock, {
+											language: "go",
+											filename: "generated/clients/go/client.go",
+											code: `package main
+
+import (
+    "context"
+    "myapi_client"
+)
+
+func main() {
+    client := myapi_client.NewMyAPIClient(
+        myapi_client.WithBaseURL("https://api.example.com"),
+        myapi_client.WithAPIKey(os.Getenv("API_KEY")),
+    )
+    
+    // Type-safe method calls
+    users, err := client.GetUsers(&myapi_client.GetUsersParams{
+        Page: 1,
+        Limit: 10,
+    })
+    
+    newUser, err := client.CreateUser(&myapi_client.CreateUserParams{
+        Email: "user@example.com",
+        Name:  "John Doe",
+    })
+    
+    // Full type checking at compile time
+    // users: *GetUsersResponse
+    // newUser: *CreateUserResponse
+}`
+										})]
+									})
+								]
+							})
+						]
+					}),
+					/* @__PURE__ */ jsxs("div", {
+						className: "space-y-3",
+						children: [
+							/* @__PURE__ */ jsx("h2", {
+								className: "text-2xl font-bold",
+								children: "Advanced Features"
+							}),
+							/* @__PURE__ */ jsx("p", {
+								className: "text-muted-foreground text-sm",
+								children: "Generated clients include enterprise-grade features out of the box."
+							}),
+							/* @__PURE__ */ jsx(CodeBlock, {
+								language: "typescript",
+								filename: "client-features.ts",
+								code: `// Advanced client features
+const client = new MyAPIClient({
+  baseUrl: 'https://api.example.com',
+  apiKey: 'your-api-key',
+  
+  // Retry configuration
+  retryConfig: {
+    maxRetries: 3,
+    backoffMultiplier: 2,
+    maxDelay: 30000,
+  },
+  
+  // Request/Response interceptors
+  interceptors: {
+    request: [(config) => {
+      // Add authentication headers
+      config.headers.Authorization = \`Bearer \${await getAuthToken()}\`;
+      return config;
+    }],
+    response: [(response) => {
+      // Log API calls
+      console.log(\`API Call: \${response.config.method} \${response.config.url}\`);
+      return response;
+    }],
+  },
+  
+  // Error handling
+  errorHandler: (error) => {
+    if (error.status === 401) {
+      // Refresh token and retry
+      return refreshTokenAndRetry(error.originalRequest);
+    }
+    throw error;
+  },
+});
+
+// Automatic request deduplication
+const user1 = client.getUser({ id: '123' });
+const user2 = client.getUser({ id: '123' }); // Uses cached result
+
+// Request cancellation
+const controller = new AbortController();
+const promise = client.getUsers({ page: 1, signal: controller.signal });
+controller.abort(); // Cancels the request`
+							})
+						]
+					})
+				]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "flex items-center gap-4 pt-4",
+				children: [/* @__PURE__ */ jsxs(Link, {
+					href: "/docs/guides/generate-docs-clients-schemas",
+					className: "btn-primary",
+					children: ["Client Generation Guide ", /* @__PURE__ */ jsx(ChevronRight, { size: 16 })]
+				}), /* @__PURE__ */ jsx(Link, {
+					href: "/docs/intent/contract-first-api",
+					className: "btn-ghost",
+					children: "Contract-first API"
+				})]
+			})
+		]
+	});
+}
+
+//#endregion
+export { GenerateClientFromSchemaPage, metadata };
+//# sourceMappingURL=GenerateClientFromSchemaPage.js.map

package/dist/components/docs/intent/GenerateClientFromSchemaPage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GenerateClientFromSchemaPage.js","names":[],"sources":["../../../../src/components/docs/intent/GenerateClientFromSchemaPage.tsx"],"sourcesContent":["import type { Metadata } from 'next';\nimport { generateClientFromSchemaBrief } from '@contractspec/bundle.library/components/docs/intent/intent-pages.docblocks';\nimport { SeoOptimizer } from '@contractspec/lib.content-gen/seo';\nimport { CodeBlock } from '@contractspec/lib.design-system';\nimport Link from '@contractspec/lib.ui-link';\nimport { ChevronRight } from 'lucide-react';\n\nexport const metadata: Metadata = new SeoOptimizer().optimize(\n  generateClientFromSchemaBrief\n);\n\nexport function GenerateClientFromSchemaPage() {\n  return (\n    <div className=\"space-y-8\">\n      <div className=\"space-y-3\">\n        <h1 className=\"text-4xl font-bold\">\n          {generateClientFromSchemaBrief.title}\n        </h1>\n        <p className=\"text-muted-foreground text-lg\">\n          {generateClientFromSchemaBrief.summary}\n        </p>\n      </div>\n\n      <div className=\"card-subtle space-y-4 p-6\">\n        <h2 className=\"text-2xl font-bold\">Client Development Problems</h2>\n        <ul className=\"text-muted-foreground space-y-2 text-sm\">\n          {generateClientFromSchemaBrief.problems.map((problem, index) => (\n            <li key={index}>{problem}</li>\n          ))}\n        </ul>\n      </div>\n\n      <div className=\"card-subtle space-y-4 p-6\">\n        <h2 className=\"text-2xl font-bold\">Automated Solutions</h2>\n        <ul className=\"text-muted-foreground space-y-2 text-sm\">\n          {generateClientFromSchemaBrief.solutions.map((solution, index) => (\n            <li key={index}>{solution}</li>\n          ))}\n        </ul>\n      </div>\n\n      <div className=\"space-y-6\">\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">Contract Definition</h2>\n          <p className=\"text-muted-foreground text-sm\">\n            Define your API contract once, generate clients for any language.\n          </p>\n          <CodeBlock\n            language=\"typescript\"\n            filename=\"src/contracts/api.contract.ts\"\n            code={`import { defineContract } from '@contractspec/lib.contracts';\nimport { SchemaModel, ScalarTypeEnum } from '@contractspec/lib.schema';\n\nexport const ApiContract = defineContract({\n  name: 'MyAPI',\n  version: '1.0.0',\n  baseUrl: 'https://api.example.com',\n  operations: {\n    getUsers: {\n      goal: 'Retrieve paginated list of users',\n      method: 'GET',\n      path: '/users',\n      input: new SchemaModel({\n        type: 'object',\n        properties: {\n          page: { type: 'integer', minimum: 1, default: 1 },\n          limit: { type: 'integer', minimum: 1, maximum: 100, default: 20 },\n        },\n      }),\n      output: new SchemaModel({\n        type: 'object',\n        properties: {\n          users: {\n            type: 'array',\n            items: {\n              type: 'object',\n              properties: {\n                id: { type: 'string', required: true },\n                email: { type: 'string', required: true },\n                name: { type: 'string', required: true },\n              },\n            },\n          },\n          pagination: {\n            type: 'object',\n            properties: {\n              page: { type: 'integer', required: true },\n              limit: { type: 'integer', required: true },\n              total: { type: 'integer', required: true },\n            },\n          },\n        },\n      }),\n    },\n    createUser: {\n      goal: 'Create a new user account',\n      method: 'POST',\n      path: '/users',\n      input: new SchemaModel({\n        type: 'object',\n        properties: {\n          email: { type: 'string', format: 'email', required: true },\n          name: { type: 'string', minLength: 1, required: true },\n        },\n      }),\n      output: new SchemaModel({\n        type: 'object',\n        properties: {\n          id: { type: 'string', required: true },\n          email: { type: 'string', required: true },\n          name: { type: 'string', required: true },\n          createdAt: { type: 'string', format: 'date-time', required: true },\n        },\n      }),\n    },\n  },\n  metadata: {\n    description: 'User management API with authentication',\n    tags: ['users', 'authentication'],\n  },\n});`}\n          />\n        </div>\n\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">Generate Multiple Clients</h2>\n          <p className=\"text-muted-foreground text-sm\">\n            Generate type-safe clients for any language from the same contract.\n          </p>\n          <CodeBlock\n            language=\"bash\"\n            filename=\"generate-clients\"\n            code={`# Generate all supported language clients\ncontractspec generate clients \\\\\n  --contract ./src/contracts/api.contract.ts \\\\\n  --output ./generated/clients \\\\\n  --languages typescript,python,go,java,csharp\n\n# Generate specific language client\ncontractspec generate clients \\\\\n  --contract ./src/contracts/api.contract.ts \\\\\n  --output ./generated/clients \\\\\n  --languages typescript \\\\\n  --format npm-package\n\n# Options\n# --with-types: Include TypeScript definitions\n# --with-tests: Generate client test suites\n# --with-docs: Include client documentation\n# --framework: Use specific HTTP client framework`}\n          />\n        </div>\n\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">Generated Client Examples</h2>\n          <p className=\"text-muted-foreground text-sm\">\n            Each generated client is fully type-safe and idiomatic.\n          </p>\n\n          <div className=\"space-y-4\">\n            <div className=\"card-subtle p-4\">\n              <h4 className=\"text-lg font-semibold\">TypeScript Client</h4>\n              <CodeBlock\n                language=\"typescript\"\n                filename=\"generated/clients/typescript/index.ts\"\n                code={`import { MyAPIClient } from './client';\n\nconst client = new MyAPIClient({\n  baseUrl: 'https://api.example.com',\n  apiKey: process.env.API_KEY,\n});\n\n// Type-safe method calls\nconst users = await client.getUsers({\n  page: 1,\n  limit: 10,\n});\n\nconst newUser = await client.createUser({\n  email: 'user@example.com',\n  name: 'John Doe',\n});\n\n// Full type inference\n// users: GetUsersResponse\n// newUser: CreateUserResponse`}\n              />\n            </div>\n\n            <div className=\"card-subtle p-4\">\n              <h4 className=\"text-lg font-semibold\">Python Client</h4>\n              <CodeBlock\n                language=\"python\"\n                filename=\"generated/clients/python/index.py\"\n                code={`from myapi_client import MyAPIClient\n\nclient = MyAPIClient(\n    base_url='https://api.example.com',\n    api_key=os.getenv('API_KEY')\n)\n\n# Type-safe method calls\nusers = await client.get_users(\n    page=1,\n    limit=10\n)\n\nnew_user = await client.create_user(\n    email='user@example.com',\n    name='John Doe'\n)\n\n# Full type hints\n# users: GetUsersResponse\n# new_user: CreateUserResponse`}\n              />\n            </div>\n\n            <div className=\"card-subtle p-4\">\n              <h4 className=\"text-lg font-semibold\">Go Client</h4>\n              <CodeBlock\n                language=\"go\"\n                filename=\"generated/clients/go/client.go\"\n                code={`package main\n\nimport (\n    \"context\"\n    \"myapi_client\"\n)\n\nfunc main() {\n    client := myapi_client.NewMyAPIClient(\n        myapi_client.WithBaseURL(\"https://api.example.com\"),\n        myapi_client.WithAPIKey(os.Getenv(\"API_KEY\")),\n    )\n    \n    // Type-safe method calls\n    users, err := client.GetUsers(&myapi_client.GetUsersParams{\n        Page: 1,\n        Limit: 10,\n    })\n    \n    newUser, err := client.CreateUser(&myapi_client.CreateUserParams{\n        Email: \"user@example.com\",\n        Name:  \"John Doe\",\n    })\n    \n    // Full type checking at compile time\n    // users: *GetUsersResponse\n    // newUser: *CreateUserResponse\n}`}\n              />\n            </div>\n          </div>\n        </div>\n\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">Advanced Features</h2>\n          <p className=\"text-muted-foreground text-sm\">\n            Generated clients include enterprise-grade features out of the box.\n          </p>\n          <CodeBlock\n            language=\"typescript\"\n            filename=\"client-features.ts\"\n            code={`// Advanced client features\nconst client = new MyAPIClient({\n  baseUrl: 'https://api.example.com',\n  apiKey: 'your-api-key',\n  \n  // Retry configuration\n  retryConfig: {\n    maxRetries: 3,\n    backoffMultiplier: 2,\n    maxDelay: 30000,\n  },\n  \n  // Request/Response interceptors\n  interceptors: {\n    request: [(config) => {\n      // Add authentication headers\n      config.headers.Authorization = \\`Bearer \\${await getAuthToken()}\\`;\n      return config;\n    }],\n    response: [(response) => {\n      // Log API calls\n      console.log(\\`API Call: \\${response.config.method} \\${response.config.url}\\`);\n      return response;\n    }],\n  },\n  \n  // Error handling\n  errorHandler: (error) => {\n    if (error.status === 401) {\n      // Refresh token and retry\n      return refreshTokenAndRetry(error.originalRequest);\n    }\n    throw error;\n  },\n});\n\n// Automatic request deduplication\nconst user1 = client.getUser({ id: '123' });\nconst user2 = client.getUser({ id: '123' }); // Uses cached result\n\n// Request cancellation\nconst controller = new AbortController();\nconst promise = client.getUsers({ page: 1, signal: controller.signal });\ncontroller.abort(); // Cancels the request`}\n          />\n        </div>\n      </div>\n\n      <div className=\"flex items-center gap-4 pt-4\">\n        <Link\n          href=\"/docs/guides/generate-docs-clients-schemas\"\n          className=\"btn-primary\"\n        >\n          Client Generation Guide <ChevronRight size={16} />\n        </Link>\n        <Link href=\"/docs/intent/contract-first-api\" className=\"btn-ghost\">\n          Contract-first API\n        </Link>\n      </div>\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;AAOA,MAAa,WAAqB,IAAI,cAAc,CAAC,SACnD,8BACD;AAED,SAAgB,+BAA+B;AAC7C,QACE,qBAAC;EAAI,WAAU;;GACb,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eACX,8BAA8B;MAC5B,EACL,oBAAC;KAAE,WAAU;eACV,8BAA8B;MAC7B;KACA;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAgC,EACnE,oBAAC;KAAG,WAAU;eACX,8BAA8B,SAAS,KAAK,SAAS,UACpD,oBAAC,kBAAgB,WAAR,MAAqB,CAC9B;MACC;KACD;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAwB,EAC3D,oBAAC;KAAG,WAAU;eACX,8BAA8B,UAAU,KAAK,UAAU,UACtD,oBAAC,kBAAgB,YAAR,MAAsB,CAC/B;MACC;KACD;GAEN,qBAAC;IAAI,WAAU;;KACb,qBAAC;MAAI,WAAU;;OACb,oBAAC;QAAG,WAAU;kBAAqB;SAAwB;OAC3D,oBAAC;QAAE,WAAU;kBAAgC;SAEzC;OACJ,oBAAC;QACC,UAAS;QACT,UAAS;QACT,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;SAuEN;;OACE;KAEN,qBAAC;MAAI,WAAU;;OACb,oBAAC;QAAG,WAAU;kBAAqB;SAA8B;OACjE,oBAAC;QAAE,WAAU;kBAAgC;SAEzC;OACJ,oBAAC;QACC,UAAS;QACT,UAAS;QACT,MAAM;;;;;;;;;;;;;;;;;;SAkBN;;OACE;KAEN,qBAAC;MAAI,WAAU;;OACb,oBAAC;QAAG,WAAU;kBAAqB;SAA8B;OACjE,oBAAC;QAAE,WAAU;kBAAgC;SAEzC;OAEJ,qBAAC;QAAI,WAAU;;SACb,qBAAC;UAAI,WAAU;qBACb,oBAAC;WAAG,WAAU;qBAAwB;YAAsB,EAC5D,oBAAC;WACC,UAAS;WACT,UAAS;WACT,MAAM;;;;;;;;;;;;;;;;;;;;;YAqBN;WACE;SAEN,qBAAC;UAAI,WAAU;qBACb,oBAAC;WAAG,WAAU;qBAAwB;YAAkB,EACxD,oBAAC;WACC,UAAS;WACT,UAAS;WACT,MAAM;;;;;;;;;;;;;;;;;;;;;YAqBN;WACE;SAEN,qBAAC;UAAI,WAAU;qBACb,oBAAC;WAAG,WAAU;qBAAwB;YAAc,EACpD,oBAAC;WACC,UAAS;WACT,UAAS;WACT,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;YA4BN;WACE;;SACF;;OACF;KAEN,qBAAC;MAAI,WAAU;;OACb,oBAAC;QAAG,WAAU;kBAAqB;SAAsB;OACzD,oBAAC;QAAE,WAAU;kBAAgC;SAEzC;OACJ,oBAAC;QACC,UAAS;QACT,UAAS;QACT,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;SA4CN;;OACE;;KACF;GAEN,qBAAC;IAAI,WAAU;eACb,qBAAC;KACC,MAAK;KACL,WAAU;gBACX,4BACyB,oBAAC,gBAAa,MAAM,KAAM;MAC7C,EACP,oBAAC;KAAK,MAAK;KAAkC,WAAU;eAAY;MAE5D;KACH;;GACF"}

package/dist/components/docs/intent/OpenapiAlternativePage.d.ts

@@ -0,0 +1,10 @@
+import { Metadata } from "../../../node_modules/next/dist/lib/metadata/types/metadata-interface.js";
+import "../../../node_modules/next/index.js";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/components/docs/intent/OpenapiAlternativePage.d.ts
+declare const metadata: Metadata;
+declare function OpenapiAlternativePage(): react_jsx_runtime0.JSX.Element;
+//#endregion
+export { OpenapiAlternativePage, metadata };
+//# sourceMappingURL=OpenapiAlternativePage.d.ts.map

package/dist/components/docs/intent/OpenapiAlternativePage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenapiAlternativePage.d.ts","names":[],"sources":["../../../../src/components/docs/intent/OpenapiAlternativePage.tsx"],"mappings":";;;;;cAOa,QAAA,EAAU,QAAA;AAAA,iBAIP,sBAAA,CAAA,GAAsB,kBAAA,CAAA,GAAA,CAAA,OAAA"}

package/dist/components/docs/intent/OpenapiAlternativePage.js

@@ -0,0 +1,188 @@
+import { openapiAlternativeBrief } from "./intent-pages.docblocks.js";
+import { SeoOptimizer } from "../../../packages/libs/content-gen/dist/seo/optimizer.js";
+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/intent/OpenapiAlternativePage.tsx
+const metadata = new SeoOptimizer().optimize(openapiAlternativeBrief);
+function OpenapiAlternativePage() {
+	return /* @__PURE__ */ jsxs("div", {
+		className: "space-y-8",
+		children: [
+			/* @__PURE__ */ jsxs("div", {
+				className: "space-y-3",
+				children: [/* @__PURE__ */ jsx("h1", {
+					className: "text-4xl font-bold",
+					children: openapiAlternativeBrief.title
+				}), /* @__PURE__ */ jsx("p", {
+					className: "text-muted-foreground text-lg",
+					children: openapiAlternativeBrief.summary
+				})]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "card-subtle space-y-4 p-6",
+				children: [/* @__PURE__ */ jsx("h2", {
+					className: "text-2xl font-bold",
+					children: "OpenAPI Limitations"
+				}), /* @__PURE__ */ jsx("ul", {
+					className: "text-muted-foreground space-y-2 text-sm",
+					children: openapiAlternativeBrief.problems.map((problem, index) => /* @__PURE__ */ jsx("li", { children: problem }, index))
+				})]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "card-subtle space-y-4 p-6",
+				children: [/* @__PURE__ */ jsx("h2", {
+					className: "text-2xl font-bold",
+					children: "ContractSpec Advantages"
+				}), /* @__PURE__ */ jsx("ul", {
+					className: "text-muted-foreground space-y-2 text-sm",
+					children: openapiAlternativeBrief.solutions.map((solution, index) => /* @__PURE__ */ jsx("li", { children: solution }, index))
+				})]
+			}),
+			/* @__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: "Comparison: OpenAPI vs ContractSpec"
+							}),
+							/* @__PURE__ */ jsx("p", {
+								className: "text-muted-foreground text-sm",
+								children: "Key differences between OpenAPI documentation and ContractSpec executable contracts."
+							}),
+							/* @__PURE__ */ jsxs("div", {
+								className: "grid gap-6 md:grid-cols-2",
+								children: [/* @__PURE__ */ jsxs("div", {
+									className: "card-subtle space-y-3 p-4",
+									children: [/* @__PURE__ */ jsx("h3", {
+										className: "text-lg font-semibold",
+										children: "OpenAPI"
+									}), /* @__PURE__ */ jsxs("ul", {
+										className: "text-muted-foreground space-y-1 text-sm",
+										children: [
+											/* @__PURE__ */ jsx("li", { children: "• Documentation specification only" }),
+											/* @__PURE__ */ jsx("li", { children: "• No runtime validation" }),
+											/* @__PURE__ */ jsx("li", { children: "• Manual code generation" }),
+											/* @__PURE__ */ jsx("li", { children: "• Type safety requires tools" }),
+											/* @__PURE__ */ jsx("li", { children: "• Separate schemas from documentation" })
+										]
+									})]
+								}), /* @__PURE__ */ jsxs("div", {
+									className: "card-subtle space-y-3 p-4",
+									children: [/* @__PURE__ */ jsx("h3", {
+										className: "text-lg font-semibold",
+										children: "ContractSpec"
+									}), /* @__PURE__ */ jsxs("ul", {
+										className: "text-muted-foreground space-y-1 text-sm",
+										children: [
+											/* @__PURE__ */ jsx("li", { children: "• Executable contracts" }),
+											/* @__PURE__ */ jsx("li", { children: "• Built-in runtime validation" }),
+											/* @__PURE__ */ jsx("li", { children: "• Automatic code generation" }),
+											/* @__PURE__ */ jsx("li", { children: "• Type-safe by default" }),
+											/* @__PURE__ */ jsx("li", { children: "• Unified spec and implementation" })
+										]
+									})]
+								})]
+							})
+						]
+					}),
+					/* @__PURE__ */ jsxs("div", {
+						className: "space-y-3",
+						children: [
+							/* @__PURE__ */ jsx("h2", {
+								className: "text-2xl font-bold",
+								children: "Export from Contracts"
+							}),
+							/* @__PURE__ */ jsx("p", {
+								className: "text-muted-foreground text-sm",
+								children: "Generate OpenAPI documentation from ContractSpec for existing tooling."
+							}),
+							/* @__PURE__ */ jsx(CodeBlock, {
+								language: "bash",
+								filename: "export-openapi",
+								code: `# From ContractSpec contracts
+contractspec openapi export \\
+  --registry ./src/contracts/registry.ts \\
+  --format yaml \\
+  --out ./openapi.yaml
+
+# Compare: Manual OpenAPI vs Generated
+# Manual: Write OpenAPI by hand, maintain separately
+# Generated: Single source of truth, always in sync`
+							})
+						]
+					}),
+					/* @__PURE__ */ jsxs("div", {
+						className: "space-y-3",
+						children: [
+							/* @__PURE__ */ jsx("h2", {
+								className: "text-2xl font-bold",
+								children: "Beyond Documentation"
+							}),
+							/* @__PURE__ */ jsx("p", {
+								className: "text-muted-foreground text-sm",
+								children: "ContractSpec provides more than just API documentation."
+							}),
+							/* @__PURE__ */ jsx(CodeBlock, {
+								language: "typescript",
+								filename: "multi-output-example.ts",
+								code: `// One contract, multiple outputs
+import { UserApiContract } from './contracts/user-api.contract';
+
+// Generated outputs
+export const outputs = {
+  // API documentation (OpenAPI)
+  openapi: UserApiContract.toOpenAPI(),
+  
+  // Client SDKs (TypeScript, Python, etc.)
+  clients: UserApiContract.generateClients({
+    languages: ['typescript', 'python', 'go'],
+  }),
+  
+  // Database schemas (Prisma, Drizzle)
+  database: UserApiContract.toDatabase({
+    adapter: 'prisma',
+  }),
+  
+  // API handlers (Express, Fastify, Next.js)
+  handlers: UserApiContract.toHandlers({
+    framework: 'express',
+  }),
+  
+  // Validation middleware
+  validation: UserApiContract.toValidation({
+    library: 'zod',
+  }),
+  
+  // Type definitions
+  types: UserApiContract.toTypescript(),
+};`
+							})
+						]
+					})
+				]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "flex items-center gap-4 pt-4",
+				children: [/* @__PURE__ */ jsxs(Link, {
+					href: "/docs/guides/generate-docs-clients-schemas",
+					className: "btn-primary",
+					children: ["Generate from Contracts ", /* @__PURE__ */ jsx(ChevronRight, { size: 16 })]
+				}), /* @__PURE__ */ jsx(Link, {
+					href: "/docs/intent/generate-client-from-schema",
+					className: "btn-ghost",
+					children: "Client Generation"
+				})]
+			})
+		]
+	});
+}
+
+//#endregion
+export { OpenapiAlternativePage, metadata };
+//# sourceMappingURL=OpenapiAlternativePage.js.map

package/dist/components/docs/intent/OpenapiAlternativePage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenapiAlternativePage.js","names":[],"sources":["../../../../src/components/docs/intent/OpenapiAlternativePage.tsx"],"sourcesContent":["import type { Metadata } from 'next';\nimport { openapiAlternativeBrief } from '@contractspec/bundle.library/components/docs/intent/intent-pages.docblocks';\nimport { SeoOptimizer } from '@contractspec/lib.content-gen/seo';\nimport { CodeBlock } from '@contractspec/lib.design-system';\nimport Link from '@contractspec/lib.ui-link';\nimport { ChevronRight } from 'lucide-react';\n\nexport const metadata: Metadata = new SeoOptimizer().optimize(\n  openapiAlternativeBrief\n);\n\nexport function OpenapiAlternativePage() {\n  return (\n    <div className=\"space-y-8\">\n      <div className=\"space-y-3\">\n        <h1 className=\"text-4xl font-bold\">{openapiAlternativeBrief.title}</h1>\n        <p className=\"text-muted-foreground text-lg\">\n          {openapiAlternativeBrief.summary}\n        </p>\n      </div>\n\n      <div className=\"card-subtle space-y-4 p-6\">\n        <h2 className=\"text-2xl font-bold\">OpenAPI Limitations</h2>\n        <ul className=\"text-muted-foreground space-y-2 text-sm\">\n          {openapiAlternativeBrief.problems.map((problem, index) => (\n            <li key={index}>{problem}</li>\n          ))}\n        </ul>\n      </div>\n\n      <div className=\"card-subtle space-y-4 p-6\">\n        <h2 className=\"text-2xl font-bold\">ContractSpec Advantages</h2>\n        <ul className=\"text-muted-foreground space-y-2 text-sm\">\n          {openapiAlternativeBrief.solutions.map((solution, index) => (\n            <li key={index}>{solution}</li>\n          ))}\n        </ul>\n      </div>\n\n      <div className=\"space-y-6\">\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">\n            Comparison: OpenAPI vs ContractSpec\n          </h2>\n          <p className=\"text-muted-foreground text-sm\">\n            Key differences between OpenAPI documentation and ContractSpec\n            executable contracts.\n          </p>\n\n          <div className=\"grid gap-6 md:grid-cols-2\">\n            <div className=\"card-subtle space-y-3 p-4\">\n              <h3 className=\"text-lg font-semibold\">OpenAPI</h3>\n              <ul className=\"text-muted-foreground space-y-1 text-sm\">\n                <li>• Documentation specification only</li>\n                <li>• No runtime validation</li>\n                <li>• Manual code generation</li>\n                <li>• Type safety requires tools</li>\n                <li>• Separate schemas from documentation</li>\n              </ul>\n            </div>\n\n            <div className=\"card-subtle space-y-3 p-4\">\n              <h3 className=\"text-lg font-semibold\">ContractSpec</h3>\n              <ul className=\"text-muted-foreground space-y-1 text-sm\">\n                <li>• Executable contracts</li>\n                <li>• Built-in runtime validation</li>\n                <li>• Automatic code generation</li>\n                <li>• Type-safe by default</li>\n                <li>• Unified spec and implementation</li>\n              </ul>\n            </div>\n          </div>\n        </div>\n\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">Export from Contracts</h2>\n          <p className=\"text-muted-foreground text-sm\">\n            Generate OpenAPI documentation from ContractSpec for existing\n            tooling.\n          </p>\n          <CodeBlock\n            language=\"bash\"\n            filename=\"export-openapi\"\n            code={`# From ContractSpec contracts\ncontractspec openapi export \\\\\n  --registry ./src/contracts/registry.ts \\\\\n  --format yaml \\\\\n  --out ./openapi.yaml\n\n# Compare: Manual OpenAPI vs Generated\n# Manual: Write OpenAPI by hand, maintain separately\n# Generated: Single source of truth, always in sync`}\n          />\n        </div>\n\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">Beyond Documentation</h2>\n          <p className=\"text-muted-foreground text-sm\">\n            ContractSpec provides more than just API documentation.\n          </p>\n          <CodeBlock\n            language=\"typescript\"\n            filename=\"multi-output-example.ts\"\n            code={`// One contract, multiple outputs\nimport { UserApiContract } from './contracts/user-api.contract';\n\n// Generated outputs\nexport const outputs = {\n  // API documentation (OpenAPI)\n  openapi: UserApiContract.toOpenAPI(),\n  \n  // Client SDKs (TypeScript, Python, etc.)\n  clients: UserApiContract.generateClients({\n    languages: ['typescript', 'python', 'go'],\n  }),\n  \n  // Database schemas (Prisma, Drizzle)\n  database: UserApiContract.toDatabase({\n    adapter: 'prisma',\n  }),\n  \n  // API handlers (Express, Fastify, Next.js)\n  handlers: UserApiContract.toHandlers({\n    framework: 'express',\n  }),\n  \n  // Validation middleware\n  validation: UserApiContract.toValidation({\n    library: 'zod',\n  }),\n  \n  // Type definitions\n  types: UserApiContract.toTypescript(),\n};`}\n          />\n        </div>\n      </div>\n\n      <div className=\"flex items-center gap-4 pt-4\">\n        <Link\n          href=\"/docs/guides/generate-docs-clients-schemas\"\n          className=\"btn-primary\"\n        >\n          Generate from Contracts <ChevronRight size={16} />\n        </Link>\n        <Link\n          href=\"/docs/intent/generate-client-from-schema\"\n          className=\"btn-ghost\"\n        >\n          Client Generation\n        </Link>\n      </div>\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;AAOA,MAAa,WAAqB,IAAI,cAAc,CAAC,SACnD,wBACD;AAED,SAAgB,yBAAyB;AACvC,QACE,qBAAC;EAAI,WAAU;;GACb,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAsB,wBAAwB;MAAW,EACvE,oBAAC;KAAE,WAAU;eACV,wBAAwB;MACvB;KACA;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAwB,EAC3D,oBAAC;KAAG,WAAU;eACX,wBAAwB,SAAS,KAAK,SAAS,UAC9C,oBAAC,kBAAgB,WAAR,MAAqB,CAC9B;MACC;KACD;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAA4B,EAC/D,oBAAC;KAAG,WAAU;eACX,wBAAwB,UAAU,KAAK,UAAU,UAChD,oBAAC,kBAAgB,YAAR,MAAsB,CAC/B;MACC;KACD;GAEN,qBAAC;IAAI,WAAU;;KACb,qBAAC;MAAI,WAAU;;OACb,oBAAC;QAAG,WAAU;kBAAqB;SAE9B;OACL,oBAAC;QAAE,WAAU;kBAAgC;SAGzC;OAEJ,qBAAC;QAAI,WAAU;mBACb,qBAAC;SAAI,WAAU;oBACb,oBAAC;UAAG,WAAU;oBAAwB;WAAY,EAClD,qBAAC;UAAG,WAAU;;WACZ,oBAAC,kBAAG,uCAAuC;WAC3C,oBAAC,kBAAG,4BAA4B;WAChC,oBAAC,kBAAG,6BAA6B;WACjC,oBAAC,kBAAG,iCAAiC;WACrC,oBAAC,kBAAG,0CAA0C;;WAC3C;UACD,EAEN,qBAAC;SAAI,WAAU;oBACb,oBAAC;UAAG,WAAU;oBAAwB;WAAiB,EACvD,qBAAC;UAAG,WAAU;;WACZ,oBAAC,kBAAG,2BAA2B;WAC/B,oBAAC,kBAAG,kCAAkC;WACtC,oBAAC,kBAAG,gCAAgC;WACpC,oBAAC,kBAAG,2BAA2B;WAC/B,oBAAC,kBAAG,sCAAsC;;WACvC;UACD;SACF;;OACF;KAEN,qBAAC;MAAI,WAAU;;OACb,oBAAC;QAAG,WAAU;kBAAqB;SAA0B;OAC7D,oBAAC;QAAE,WAAU;kBAAgC;SAGzC;OACJ,oBAAC;QACC,UAAS;QACT,UAAS;QACT,MAAM;;;;;;;;;SASN;;OACE;KAEN,qBAAC;MAAI,WAAU;;OACb,oBAAC;QAAG,WAAU;kBAAqB;SAAyB;OAC5D,oBAAC;QAAE,WAAU;kBAAgC;SAEzC;OACJ,oBAAC;QACC,UAAS;QACT,UAAS;QACT,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;SA+BN;;OACE;;KACF;GAEN,qBAAC;IAAI,WAAU;eACb,qBAAC;KACC,MAAK;KACL,WAAU;gBACX,4BACyB,oBAAC,gBAAa,MAAM,KAAM;MAC7C,EACP,oBAAC;KACC,MAAK;KACL,WAAU;eACX;MAEM;KACH;;GACF"}

package/dist/components/docs/intent/SchemaValidationTypescriptPage.d.ts

@@ -0,0 +1,10 @@
+import { Metadata } from "../../../node_modules/next/dist/lib/metadata/types/metadata-interface.js";
+import "../../../node_modules/next/index.js";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/components/docs/intent/SchemaValidationTypescriptPage.d.ts
+declare const metadata: Metadata;
+declare function SchemaValidationTypescriptPage(): react_jsx_runtime0.JSX.Element;
+//#endregion
+export { SchemaValidationTypescriptPage, metadata };
+//# sourceMappingURL=SchemaValidationTypescriptPage.d.ts.map

package/dist/components/docs/intent/SchemaValidationTypescriptPage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaValidationTypescriptPage.d.ts","names":[],"sources":["../../../../src/components/docs/intent/SchemaValidationTypescriptPage.tsx"],"mappings":";;;;;cAOa,QAAA,EAAU,QAAA;AAAA,iBAIP,8BAAA,CAAA,GAA8B,kBAAA,CAAA,GAAA,CAAA,OAAA"}