@contractspec/bundle.library 0.0.0-canary-20260206014742

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

@@ -0,0 +1,216 @@
+import { schemaValidationTypescriptBrief } 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/SchemaValidationTypescriptPage.tsx
+const metadata = new SeoOptimizer().optimize(schemaValidationTypescriptBrief);
+function SchemaValidationTypescriptPage() {
+	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: schemaValidationTypescriptBrief.title
+				}), /* @__PURE__ */ jsx("p", {
+					className: "text-muted-foreground text-lg",
+					children: schemaValidationTypescriptBrief.summary
+				})]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "card-subtle space-y-4 p-6",
+				children: [/* @__PURE__ */ jsx("h2", {
+					className: "text-2xl font-bold",
+					children: "Validation Pain Points"
+				}), /* @__PURE__ */ jsx("ul", {
+					className: "text-muted-foreground space-y-2 text-sm",
+					children: schemaValidationTypescriptBrief.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: "Type-safe Solutions"
+				}), /* @__PURE__ */ jsx("ul", {
+					className: "text-muted-foreground space-y-2 text-sm",
+					children: schemaValidationTypescriptBrief.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 Schema"
+							}),
+							/* @__PURE__ */ jsx("p", {
+								className: "text-muted-foreground text-sm",
+								children: "Define data models with automatic TypeScript generation."
+							}),
+							/* @__PURE__ */ jsx(CodeBlock, {
+								language: "typescript",
+								filename: "src/contracts/user.schema.ts",
+								code: `import { SchemaModel, ScalarTypeEnum } from '@contractspec/lib.schema';
+
+export const UserSchema = new SchemaModel({
+  type: 'object',
+  properties: {
+    id: {
+      type: 'string',
+      format: 'uuid',
+      required: true,
+      description: 'Unique user identifier',
+    },
+    email: {
+      type: 'string',
+      format: 'email',
+      required: true,
+      description: 'User email address',
+    },
+    name: {
+      type: 'string',
+      minLength: 1,
+      maxLength: 100,
+      required: true,
+      description: 'Display name for the user',
+    },
+    role: {
+      type: 'string',
+      enum: ['user', 'admin', 'moderator'],
+      default: 'user',
+      description: 'User role in the system',
+    },
+    createdAt: {
+      type: 'string',
+      format: 'date-time',
+      required: true,
+      description: 'Account creation timestamp',
+    },
+  },
+  required: ['id', 'email', 'name', 'createdAt'],
+  metadata: {
+    name: 'User',
+    description: 'User account information',
+  },
+});`
+							})
+						]
+					}),
+					/* @__PURE__ */ jsxs("div", {
+						className: "space-y-3",
+						children: [
+							/* @__PURE__ */ jsx("h2", {
+								className: "text-2xl font-bold",
+								children: "Generated Types"
+							}),
+							/* @__PURE__ */ jsx("p", {
+								className: "text-muted-foreground text-sm",
+								children: "TypeScript types are automatically generated with proper validation."
+							}),
+							/* @__PURE__ */ jsx(CodeBlock, {
+								language: "typescript",
+								filename: "generated/types/user.ts",
+								code: `// Auto-generated from UserSchema
+export interface User {
+  id: string;
+  email: string;
+  name: string;
+  role: 'user' | 'admin' | 'moderator';
+  createdAt: string;
+}
+
+// Auto-generated Zod schema for runtime validation
+export const UserSchemaZod = z.object({
+  id: z.string().uuid(),
+  email: z.string().email(),
+  name: z.string().min(1).max(100),
+  role: z.enum(['user', 'admin', 'moderator']).default('user'),
+  createdAt: z.string().datetime(),
+});
+
+// Generated validation utilities
+export function validateUser(data: unknown): User {
+  return UserSchemaZod.parse(data);
+}
+
+export function isUser(data: unknown): data is User {
+  return UserSchemaZod.safeParse(data).success;
+}`
+							})
+						]
+					}),
+					/* @__PURE__ */ jsxs("div", {
+						className: "space-y-3",
+						children: [
+							/* @__PURE__ */ jsx("h2", {
+								className: "text-2xl font-bold",
+								children: "Runtime Validation"
+							}),
+							/* @__PURE__ */ jsx("p", {
+								className: "text-muted-foreground text-sm",
+								children: "Use generated validation in your API handlers with zero boilerplate."
+							}),
+							/* @__PURE__ */ jsx(CodeBlock, {
+								language: "typescript",
+								filename: "src/handlers/user-handler.ts",
+								code: `import { validateUser } from '../generated/types/user';
+
+export async function createUserHandler(request: Request) {
+  try {
+    const input = validateUser(await request.json());
+    
+    // input is now fully typed as User
+    const user = await db.users.create({
+      data: {
+        ...input,
+        createdAt: new Date().toISOString(),
+      },
+    });
+    
+    return Response.json({ user });
+  } catch (error) {
+    if (error instanceof z.ZodError) {
+      return Response.json(
+        { 
+          error: 'Validation failed',
+          details: error.errors 
+        },
+        { status: 400 }
+      );
+    }
+    
+    throw error;
+  }
+}`
+							})
+						]
+					})
+				]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "flex items-center gap-4 pt-4",
+				children: [/* @__PURE__ */ jsxs(Link, {
+					href: "/docs/guides/spec-validation-and-typing",
+					className: "btn-primary",
+					children: ["Type Safety Guide ", /* @__PURE__ */ jsx(ChevronRight, { size: 16 })]
+				}), /* @__PURE__ */ jsx(Link, {
+					href: "/docs/intent/generate-client-from-schema",
+					className: "btn-ghost",
+					children: "Client Generation"
+				})]
+			})
+		]
+	});
+}
+
+//#endregion
+export { SchemaValidationTypescriptPage, metadata };
+//# sourceMappingURL=SchemaValidationTypescriptPage.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaValidationTypescriptPage.js","names":[],"sources":["../../../../src/components/docs/intent/SchemaValidationTypescriptPage.tsx"],"sourcesContent":["import type { Metadata } from 'next';\nimport { schemaValidationTypescriptBrief } 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  schemaValidationTypescriptBrief\n);\n\nexport function SchemaValidationTypescriptPage() {\n  return (\n    <div className=\"space-y-8\">\n      <div className=\"space-y-3\">\n        <h1 className=\"text-4xl font-bold\">\n          {schemaValidationTypescriptBrief.title}\n        </h1>\n        <p className=\"text-muted-foreground text-lg\">\n          {schemaValidationTypescriptBrief.summary}\n        </p>\n      </div>\n\n      <div className=\"card-subtle space-y-4 p-6\">\n        <h2 className=\"text-2xl font-bold\">Validation Pain Points</h2>\n        <ul className=\"text-muted-foreground space-y-2 text-sm\">\n          {schemaValidationTypescriptBrief.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\">Type-safe Solutions</h2>\n        <ul className=\"text-muted-foreground space-y-2 text-sm\">\n          {schemaValidationTypescriptBrief.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 Schema</h2>\n          <p className=\"text-muted-foreground text-sm\">\n            Define data models with automatic TypeScript generation.\n          </p>\n          <CodeBlock\n            language=\"typescript\"\n            filename=\"src/contracts/user.schema.ts\"\n            code={`import { SchemaModel, ScalarTypeEnum } from '@contractspec/lib.schema';\n\nexport const UserSchema = new SchemaModel({\n  type: 'object',\n  properties: {\n    id: {\n      type: 'string',\n      format: 'uuid',\n      required: true,\n      description: 'Unique user identifier',\n    },\n    email: {\n      type: 'string',\n      format: 'email',\n      required: true,\n      description: 'User email address',\n    },\n    name: {\n      type: 'string',\n      minLength: 1,\n      maxLength: 100,\n      required: true,\n      description: 'Display name for the user',\n    },\n    role: {\n      type: 'string',\n      enum: ['user', 'admin', 'moderator'],\n      default: 'user',\n      description: 'User role in the system',\n    },\n    createdAt: {\n      type: 'string',\n      format: 'date-time',\n      required: true,\n      description: 'Account creation timestamp',\n    },\n  },\n  required: ['id', 'email', 'name', 'createdAt'],\n  metadata: {\n    name: 'User',\n    description: 'User account information',\n  },\n});`}\n          />\n        </div>\n\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">Generated Types</h2>\n          <p className=\"text-muted-foreground text-sm\">\n            TypeScript types are automatically generated with proper validation.\n          </p>\n          <CodeBlock\n            language=\"typescript\"\n            filename=\"generated/types/user.ts\"\n            code={`// Auto-generated from UserSchema\nexport interface User {\n  id: string;\n  email: string;\n  name: string;\n  role: 'user' | 'admin' | 'moderator';\n  createdAt: string;\n}\n\n// Auto-generated Zod schema for runtime validation\nexport const UserSchemaZod = z.object({\n  id: z.string().uuid(),\n  email: z.string().email(),\n  name: z.string().min(1).max(100),\n  role: z.enum(['user', 'admin', 'moderator']).default('user'),\n  createdAt: z.string().datetime(),\n});\n\n// Generated validation utilities\nexport function validateUser(data: unknown): User {\n  return UserSchemaZod.parse(data);\n}\n\nexport function isUser(data: unknown): data is User {\n  return UserSchemaZod.safeParse(data).success;\n}`}\n          />\n        </div>\n\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">Runtime Validation</h2>\n          <p className=\"text-muted-foreground text-sm\">\n            Use generated validation in your API handlers with zero boilerplate.\n          </p>\n          <CodeBlock\n            language=\"typescript\"\n            filename=\"src/handlers/user-handler.ts\"\n            code={`import { validateUser } from '../generated/types/user';\n\nexport async function createUserHandler(request: Request) {\n  try {\n    const input = validateUser(await request.json());\n    \n    // input is now fully typed as User\n    const user = await db.users.create({\n      data: {\n        ...input,\n        createdAt: new Date().toISOString(),\n      },\n    });\n    \n    return Response.json({ user });\n  } catch (error) {\n    if (error instanceof z.ZodError) {\n      return Response.json(\n        { \n          error: 'Validation failed',\n          details: error.errors \n        },\n        { status: 400 }\n      );\n    }\n    \n    throw error;\n  }\n}`}\n          />\n        </div>\n      </div>\n\n      <div className=\"flex items-center gap-4 pt-4\">\n        <Link\n          href=\"/docs/guides/spec-validation-and-typing\"\n          className=\"btn-primary\"\n        >\n          Type Safety Guide <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,gCACD;AAED,SAAgB,iCAAiC;AAC/C,QACE,qBAAC;EAAI,WAAU;;GACb,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eACX,gCAAgC;MAC9B,EACL,oBAAC;KAAE,WAAU;eACV,gCAAgC;MAC/B;KACA;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAA2B,EAC9D,oBAAC;KAAG,WAAU;eACX,gCAAgC,SAAS,KAAK,SAAS,UACtD,oBAAC,kBAAgB,WAAR,MAAqB,CAC9B;MACC;KACD;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAwB,EAC3D,oBAAC;KAAG,WAAU;eACX,gCAAgC,UAAU,KAAK,UAAU,UACxD,oBAAC,kBAAgB,YAAR,MAAsB,CAC/B;MACC;KACD;GAEN,qBAAC;IAAI,WAAU;;KACb,qBAAC;MAAI,WAAU;;OACb,oBAAC;QAAG,WAAU;kBAAqB;SAAoB;OACvD,oBAAC;QAAE,WAAU;kBAAgC;SAEzC;OACJ,oBAAC;QACC,UAAS;QACT,UAAS;QACT,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;SA2CN;;OACE;KAEN,qBAAC;MAAI,WAAU;;OACb,oBAAC;QAAG,WAAU;kBAAqB;SAAoB;OACvD,oBAAC;QAAE,WAAU;kBAAgC;SAEzC;OACJ,oBAAC;QACC,UAAS;QACT,UAAS;QACT,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;SA0BN;;OACE;KAEN,qBAAC;MAAI,WAAU;;OACb,oBAAC;QAAG,WAAU;kBAAqB;SAAuB;OAC1D,oBAAC;QAAE,WAAU;kBAAgC;SAEzC;OACJ,oBAAC;QACC,UAAS;QACT,UAAS;QACT,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;SA6BN;;OACE;;KACF;GAEN,qBAAC;IAAI,WAAU;eACb,qBAAC;KACC,MAAK;KACL,WAAU;gBACX,sBACmB,oBAAC,gBAAa,MAAM,KAAM;MACvC,EACP,oBAAC;KACC,MAAK;KACL,WAAU;eACX;MAEM;KACH;;GACF"}

package/dist/components/docs/intent/SpecDrivenDevelopmentPage.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/SpecDrivenDevelopmentPage.d.ts
+declare const metadata: Metadata;
+declare function SpecDrivenDevelopmentPage(): react_jsx_runtime0.JSX.Element;
+//#endregion
+export { SpecDrivenDevelopmentPage, metadata };
+//# sourceMappingURL=SpecDrivenDevelopmentPage.d.ts.map

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

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

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

@@ -0,0 +1,174 @@
+import { specDrivenDevelopmentBrief } 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/SpecDrivenDevelopmentPage.tsx
+const metadata = new SeoOptimizer().optimize(specDrivenDevelopmentBrief);
+function SpecDrivenDevelopmentPage() {
+	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: specDrivenDevelopmentBrief.title
+				}), /* @__PURE__ */ jsx("p", {
+					className: "text-muted-foreground text-lg",
+					children: specDrivenDevelopmentBrief.summary
+				})]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "card-subtle space-y-4 p-6",
+				children: [/* @__PURE__ */ jsx("h2", {
+					className: "text-2xl font-bold",
+					children: "Why Spec-driven?"
+				}), /* @__PURE__ */ jsx("ul", {
+					className: "text-muted-foreground space-y-2 text-sm",
+					children: specDrivenDevelopmentBrief.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: "Benefits"
+				}), /* @__PURE__ */ jsx("ul", {
+					className: "text-muted-foreground space-y-2 text-sm",
+					children: specDrivenDevelopmentBrief.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: "Feature Specification Example"
+						}),
+						/* @__PURE__ */ jsx("p", {
+							className: "text-muted-foreground text-sm",
+							children: "Define a complete feature with operations, events, and data models."
+						}),
+						/* @__PURE__ */ jsx(CodeBlock, {
+							language: "typescript",
+							filename: "src/contracts/user-management.feature.ts",
+							code: `import { defineFeature } from '@contractspec/lib.contracts/features';
+import { defineOperation } from '@contractspec/lib.contracts/operations';
+import { defineEvent } from '@contractspec/lib.contracts/events';
+import { SchemaModel, ScalarTypeEnum } from '@contractspec/lib.schema';
+
+export const UserManagementFeature = defineFeature({
+  goal: 'Complete user management system with CRUD operations',
+  context: 'Handles user lifecycle from creation to deletion with proper authorization',
+  operations: {
+    createUser: defineOperation({
+      goal: 'Create a new user account',
+      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 },
+        },
+      }),
+    }),
+    updateUser: defineOperation({
+      goal: 'Update existing user information',
+      input: new SchemaModel({
+        type: 'object',
+        properties: {
+          name: { type: 'string', minLength: 1 },
+        },
+      }),
+      output: new SchemaModel({
+        type: 'object',
+        properties: {
+          id: { type: 'string', required: true },
+          email: { type: 'string', required: true },
+          name: { type: 'string', required: true },
+        },
+      }),
+    }),
+  },
+  events: {
+    userCreated: defineEvent({
+      goal: 'Emit when a new user is created',
+      payload: new SchemaModel({
+        type: 'object',
+        properties: {
+          userId: { type: 'string', required: true },
+          email: { type: 'string', required: true },
+        },
+      }),
+    }),
+    userUpdated: defineEvent({
+      goal: 'Emit when user information changes',
+      payload: new SchemaModel({
+        type: 'object',
+        properties: {
+          userId: { type: 'string', required: true },
+          changes: { type: 'array', items: { type: 'string' }, required: true },
+        },
+      }),
+    }),
+  },
+  metadata: {
+    name: 'user-management',
+    version: '1.0.0',
+    description: 'Complete user management with operations and events',
+  },
+});`
+						})
+					]
+				}), /* @__PURE__ */ jsxs("div", {
+					className: "space-y-3",
+					children: [
+						/* @__PURE__ */ jsx("h2", {
+							className: "text-2xl font-bold",
+							children: "Generate Type-safe Implementations"
+						}),
+						/* @__PURE__ */ jsx("p", {
+							className: "text-muted-foreground text-sm",
+							children: "Generate validation, types, and API handlers from your feature."
+						}),
+						/* @__PURE__ */ jsx(CodeBlock, {
+							language: "bash",
+							filename: "generate-from-feature",
+							code: `contractspec generate \\
+  --input ./src/contracts/user-management.feature.ts \\
+  --output ./generated/user-management`
+						})
+					]
+				})]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "flex items-center gap-4 pt-4",
+				children: [/* @__PURE__ */ jsxs(Link, {
+					href: "/docs/guides/spec-validation-and-typing",
+					className: "btn-primary",
+					children: ["Type Safety Guide ", /* @__PURE__ */ jsx(ChevronRight, { size: 16 })]
+				}), /* @__PURE__ */ jsx(Link, {
+					href: "/docs/intent/deterministic-codegen",
+					className: "btn-ghost",
+					children: "Deterministic Codegen"
+				})]
+			})
+		]
+	});
+}
+
+//#endregion
+export { SpecDrivenDevelopmentPage, metadata };
+//# sourceMappingURL=SpecDrivenDevelopmentPage.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SpecDrivenDevelopmentPage.js","names":[],"sources":["../../../../src/components/docs/intent/SpecDrivenDevelopmentPage.tsx"],"sourcesContent":["import type { Metadata } from 'next';\nimport { specDrivenDevelopmentBrief } 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  specDrivenDevelopmentBrief\n);\n\nexport function SpecDrivenDevelopmentPage() {\n  return (\n    <div className=\"space-y-8\">\n      <div className=\"space-y-3\">\n        <h1 className=\"text-4xl font-bold\">\n          {specDrivenDevelopmentBrief.title}\n        </h1>\n        <p className=\"text-muted-foreground text-lg\">\n          {specDrivenDevelopmentBrief.summary}\n        </p>\n      </div>\n\n      <div className=\"card-subtle space-y-4 p-6\">\n        <h2 className=\"text-2xl font-bold\">Why Spec-driven?</h2>\n        <ul className=\"text-muted-foreground space-y-2 text-sm\">\n          {specDrivenDevelopmentBrief.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\">Benefits</h2>\n        <ul className=\"text-muted-foreground space-y-2 text-sm\">\n          {specDrivenDevelopmentBrief.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\">Feature Specification Example</h2>\n          <p className=\"text-muted-foreground text-sm\">\n            Define a complete feature with operations, events, and data models.\n          </p>\n          <CodeBlock\n            language=\"typescript\"\n            filename=\"src/contracts/user-management.feature.ts\"\n            code={`import { defineFeature } from '@contractspec/lib.contracts/features';\nimport { defineOperation } from '@contractspec/lib.contracts/operations';\nimport { defineEvent } from '@contractspec/lib.contracts/events';\nimport { SchemaModel, ScalarTypeEnum } from '@contractspec/lib.schema';\n\nexport const UserManagementFeature = defineFeature({\n  goal: 'Complete user management system with CRUD operations',\n  context: 'Handles user lifecycle from creation to deletion with proper authorization',\n  operations: {\n    createUser: defineOperation({\n      goal: 'Create a new user account',\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        },\n      }),\n    }),\n    updateUser: defineOperation({\n      goal: 'Update existing user information',\n      input: new SchemaModel({\n        type: 'object',\n        properties: {\n          name: { type: 'string', minLength: 1 },\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        },\n      }),\n    }),\n  },\n  events: {\n    userCreated: defineEvent({\n      goal: 'Emit when a new user is created',\n      payload: new SchemaModel({\n        type: 'object',\n        properties: {\n          userId: { type: 'string', required: true },\n          email: { type: 'string', required: true },\n        },\n      }),\n    }),\n    userUpdated: defineEvent({\n      goal: 'Emit when user information changes',\n      payload: new SchemaModel({\n        type: 'object',\n        properties: {\n          userId: { type: 'string', required: true },\n          changes: { type: 'array', items: { type: 'string' }, required: true },\n        },\n      }),\n    }),\n  },\n  metadata: {\n    name: 'user-management',\n    version: '1.0.0',\n    description: 'Complete user management with operations and events',\n  },\n});`}\n          />\n        </div>\n\n        <div className=\"space-y-3\">\n          <h2 className=\"text-2xl font-bold\">\n            Generate Type-safe Implementations\n          </h2>\n          <p className=\"text-muted-foreground text-sm\">\n            Generate validation, types, and API handlers from your feature.\n          </p>\n          <CodeBlock\n            language=\"bash\"\n            filename=\"generate-from-feature\"\n            code={`contractspec generate \\\\\n  --input ./src/contracts/user-management.feature.ts \\\\\n  --output ./generated/user-management`}\n          />\n        </div>\n      </div>\n\n      <div className=\"flex items-center gap-4 pt-4\">\n        <Link\n          href=\"/docs/guides/spec-validation-and-typing\"\n          className=\"btn-primary\"\n        >\n          Type Safety Guide <ChevronRight size={16} />\n        </Link>\n        <Link href=\"/docs/intent/deterministic-codegen\" className=\"btn-ghost\">\n          Deterministic Codegen\n        </Link>\n      </div>\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;AAOA,MAAa,WAAqB,IAAI,cAAc,CAAC,SACnD,2BACD;AAED,SAAgB,4BAA4B;AAC1C,QACE,qBAAC;EAAI,WAAU;;GACb,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eACX,2BAA2B;MACzB,EACL,oBAAC;KAAE,WAAU;eACV,2BAA2B;MAC1B;KACA;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAqB,EACxD,oBAAC;KAAG,WAAU;eACX,2BAA2B,SAAS,KAAK,SAAS,UACjD,oBAAC,kBAAgB,WAAR,MAAqB,CAC9B;MACC;KACD;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAa,EAChD,oBAAC;KAAG,WAAU;eACX,2BAA2B,UAAU,KAAK,UAAU,UACnD,oBAAC,kBAAgB,YAAR,MAAsB,CAC/B;MACC;KACD;GAEN,qBAAC;IAAI,WAAU;eACb,qBAAC;KAAI,WAAU;;MACb,oBAAC;OAAG,WAAU;iBAAqB;QAAkC;MACrE,oBAAC;OAAE,WAAU;iBAAgC;QAEzC;MACJ,oBAAC;OACC,UAAS;OACT,UAAS;OACT,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAyEN;;MACE,EAEN,qBAAC;KAAI,WAAU;;MACb,oBAAC;OAAG,WAAU;iBAAqB;QAE9B;MACL,oBAAC;OAAE,WAAU;iBAAgC;QAEzC;MACJ,oBAAC;OACC,UAAS;OACT,UAAS;OACT,MAAM;;;QAGN;;MACE;KACF;GAEN,qBAAC;IAAI,WAAU;eACb,qBAAC;KACC,MAAK;KACL,WAAU;gBACX,sBACmB,oBAAC,gBAAa,MAAM,KAAM;MACvC,EACP,oBAAC;KAAK,MAAK;KAAqC,WAAU;eAAY;MAE/D;KACH;;GACF"}

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

@@ -0,0 +1,7 @@
+import { ContractFirstApiPage } from "./ContractFirstApiPage.js";
+import { SpecDrivenDevelopmentPage } from "./SpecDrivenDevelopmentPage.js";
+import { DeterministicCodegenPage } from "./DeterministicCodegenPage.js";
+import { SchemaValidationTypescriptPage } from "./SchemaValidationTypescriptPage.js";
+import { OpenapiAlternativePage } from "./OpenapiAlternativePage.js";
+import { GenerateClientFromSchemaPage } from "./GenerateClientFromSchemaPage.js";
+export { ContractFirstApiPage, DeterministicCodegenPage, GenerateClientFromSchemaPage, OpenapiAlternativePage, SchemaValidationTypescriptPage, SpecDrivenDevelopmentPage };

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

@@ -0,0 +1,8 @@
+import { ContractFirstApiPage } from "./ContractFirstApiPage.js";
+import { SpecDrivenDevelopmentPage } from "./SpecDrivenDevelopmentPage.js";
+import { DeterministicCodegenPage } from "./DeterministicCodegenPage.js";
+import { SchemaValidationTypescriptPage } from "./SchemaValidationTypescriptPage.js";
+import { OpenapiAlternativePage } from "./OpenapiAlternativePage.js";
+import { GenerateClientFromSchemaPage } from "./GenerateClientFromSchemaPage.js";
+
+export { ContractFirstApiPage, DeterministicCodegenPage, GenerateClientFromSchemaPage, OpenapiAlternativePage, SchemaValidationTypescriptPage, SpecDrivenDevelopmentPage };

package/dist/components/docs/intent/intent-pages.docblocks.d.ts

@@ -0,0 +1,12 @@
+import { ContentBrief } from "../../../packages/libs/content-gen/dist/types.js";
+
+//#region src/components/docs/intent/intent-pages.docblocks.d.ts
+declare const contractFirstApiBrief: ContentBrief;
+declare const specDrivenDevelopmentBrief: ContentBrief;
+declare const deterministicCodegenBrief: ContentBrief;
+declare const schemaValidationTypescriptBrief: ContentBrief;
+declare const openapiAlternativeBrief: ContentBrief;
+declare const generateClientFromSchemaBrief: ContentBrief;
+//#endregion
+export { contractFirstApiBrief, deterministicCodegenBrief, generateClientFromSchemaBrief, openapiAlternativeBrief, schemaValidationTypescriptBrief, specDrivenDevelopmentBrief };
+//# sourceMappingURL=intent-pages.docblocks.d.ts.map

package/dist/components/docs/intent/intent-pages.docblocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent-pages.docblocks.d.ts","names":[],"sources":["../../../../src/components/docs/intent/intent-pages.docblocks.ts"],"mappings":";;;cAEa,qBAAA,EAAuB,YAAA;AAAA,cAkCvB,0BAAA,EAA4B,YAAA;AAAA,cAkC5B,yBAAA,EAA2B,YAAA;AAAA,cAkC3B,+BAAA,EAAiC,YAAA;AAAA,cAkCjC,uBAAA,EAAyB,YAAA;AAAA,cAkCzB,6BAAA,EAA+B,YAAA"}

package/dist/components/docs/intent/intent-pages.docblocks.js

@@ -0,0 +1,179 @@
+//#region src/components/docs/intent/intent-pages.docblocks.ts
+const contractFirstApiBrief = {
+	title: "Contract-first API",
+	summary: "Design APIs by writing contracts first, then generate consistent implementations across frameworks.",
+	problems: [
+		"API drift between frontend and backend",
+		"Inconsistent error handling across endpoints",
+		"Documentation becomes outdated quickly",
+		"Manual OpenAPI maintenance is error-prone"
+	],
+	solutions: [
+		"Single source of truth for API contracts",
+		"Generate OpenAPI and SDKs from contracts",
+		"Type-safe request/response validation",
+		"Always-in-sync documentation"
+	],
+	audience: {
+		role: "API developers",
+		industry: "Software development",
+		maturity: "scaleup"
+	},
+	callToAction: "Start with a simple operation contract",
+	references: [{
+		label: "Next.js One Endpoint Guide",
+		url: "/docs/guides/nextjs-one-endpoint"
+	}, {
+		label: "API Reference",
+		url: "/docs/api"
+	}]
+};
+const specDrivenDevelopmentBrief = {
+	title: "Spec-driven development",
+	summary: "Build features by writing specifications first, then generate type-safe implementations.",
+	problems: [
+		"Feature requirements are ambiguous",
+		"Frontend and backend implementations diverge",
+		"Testing lacks clear contract definitions",
+		"Code reviews focus on style instead of behavior"
+	],
+	solutions: [
+		"Executable specifications as single source of truth",
+		"Generate type-safe clients from specs",
+		"Automated contract testing",
+		"Clear behavior contracts for teams"
+	],
+	audience: {
+		role: "Development teams",
+		industry: "Software engineering",
+		maturity: "enterprise"
+	},
+	callToAction: "Define your first feature spec",
+	references: [{
+		label: "Spec Validation + Typing Guide",
+		url: "/docs/guides/spec-validation-and-typing"
+	}, {
+		label: "Core Contracts",
+		url: "/docs/core-contracts"
+	}]
+};
+const deterministicCodegenBrief = {
+	title: "Deterministic codegen",
+	summary: "Regenerate code from contracts without breaking existing functionality or losing customizations.",
+	problems: [
+		"Generated code conflicts with manual changes",
+		"Regeneration loses custom business logic",
+		"Teams avoid regeneration after customization",
+		"Code migration between versions is risky"
+	],
+	solutions: [
+		"Clear separation of generated vs hand-written code",
+		"Incremental regeneration with conflict detection",
+		"Protected zones for custom logic",
+		"Automatic migration paths"
+	],
+	audience: {
+		role: "Platform engineers",
+		industry: "Developer tools",
+		maturity: "scaleup"
+	},
+	callToAction: "Try deterministic regeneration",
+	references: [{
+		label: "Generate Docs + Clients Guide",
+		url: "/docs/guides/generate-docs-clients-schemas"
+	}, {
+		label: "CLI Reference",
+		url: "/docs/getting-started/cli"
+	}]
+};
+const schemaValidationTypescriptBrief = {
+	title: "Schema validation TypeScript",
+	summary: "Generate TypeScript types from contracts and validate data at runtime with zero overhead.",
+	problems: [
+		"Runtime type validation is boilerplate-heavy",
+		"Type definitions drift from schemas",
+		"Validation logic scattered across codebase",
+		"Poor error messages for invalid data"
+	],
+	solutions: [
+		"Auto-generated TypeScript from contracts",
+		"Zod schemas for runtime validation",
+		"Type-safe validation with clear errors",
+		"Single source of schema truth"
+	],
+	audience: {
+		role: "TypeScript developers",
+		industry: "Web development",
+		maturity: "early"
+	},
+	callToAction: "Generate typed contracts now",
+	references: [{
+		label: "Type Safety Guide",
+		url: "/docs/guides/spec-validation-and-typing"
+	}, {
+		label: "Schema Reference",
+		url: "/docs/schemas"
+	}]
+};
+const openapiAlternativeBrief = {
+	title: "OpenAPI alternative",
+	summary: "A spec-first approach that goes beyond OpenAPI with executable contracts and code generation.",
+	problems: [
+		"OpenAPI is documentation-only",
+		"No type safety from OpenAPI specs",
+		"Manual SDK generation is complex",
+		"Cannot validate implementations against OpenAPI"
+	],
+	solutions: [
+		"Executable contracts with validation",
+		"Generate multiple outputs from one spec",
+		"Type-safe by default",
+		"Built-in testing and validation"
+	],
+	audience: {
+		role: "API architects",
+		industry: "Enterprise software",
+		maturity: "enterprise"
+	},
+	callToAction: "Compare with OpenAPI approach",
+	references: [{
+		label: "Generate OpenAPI from Contracts",
+		url: "/docs/guides/generate-docs-clients-schemas"
+	}, {
+		label: "Contract vs OpenAPI",
+		url: "/docs/comparison/openapi"
+	}]
+};
+const generateClientFromSchemaBrief = {
+	title: "Generate client from schema",
+	summary: "Automatically generate type-safe API clients in any language from your contracts.",
+	problems: [
+		"Writing API clients is repetitive",
+		"Manual clients have type mismatches",
+		"Keeping clients in sync with APIs",
+		"Language-specific client maintenance"
+	],
+	solutions: [
+		"Generate clients for multiple languages",
+		"Type-safe request/response handling",
+		"Automatic client updates from contracts",
+		"Consistent error handling across languages"
+	],
+	audience: {
+		role: "Full-stack developers",
+		industry: "Software development",
+		maturity: "scaleup"
+	},
+	callToAction: "Generate your first API client",
+	references: [{
+		label: "Client Generation Guide",
+		url: "/docs/guides/generate-docs-clients-schemas"
+	}, {
+		label: "Supported Languages",
+		url: "/docs/integrations"
+	}]
+};
+
+//#endregion
+export { contractFirstApiBrief, deterministicCodegenBrief, generateClientFromSchemaBrief, openapiAlternativeBrief, schemaValidationTypescriptBrief, specDrivenDevelopmentBrief };
+//# sourceMappingURL=intent-pages.docblocks.js.map