@wild-framework/cli 0.1.1 → 0.2.0

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAuBzD"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAUA;;;;GAIG;AACH,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA2DzD"}

package/dist/cli.js

@@ -1,5 +1,12 @@
 import { makeCommand } from "./commands/make.js";
 import { runWizard } from "./wizard.js";
+import { runClient } from "./client/command.js";
+import { runNew } from "./commands/new.js";
+import { runResourceCli } from "./commands/resource.js";
+import { runDb } from "./commands/db.js";
+import { runGraph } from "./commands/graph.js";
+import { runDocker } from "./commands/docker.js";
+import { runCi } from "./commands/ci.js";
 /**
  * Parse and dispatch a CLI command.
  *
@@ -15,15 +22,81 @@ export async function run(argv) {
         console.log("wild 0.1.1");
         return 0;
     }
+    if (command === "new") {
+        return runNew(rest);
+    }
+    if (command === "resource") {
+        return runResourceCli(rest);
+    }
+    if (command === "db:migrate") {
+        return runDb("migrate", rest);
+    }
+    if (command === "db:rollback") {
+        return runDb("rollback", rest);
+    }
+    if (command === "db:status") {
+        return runDb("status", rest);
+    }
+    if (command === "graph") {
+        return runGraph(rest);
+    }
+    if (command === "docker") {
+        return runDocker(rest);
+    }
+    if (command === "ci") {
+        return runCi(rest);
+    }
     if (command === "make" || command === "make:interactive" || command === "--interactive" || command === "-i") {
         return runWizard();
     }
     if (command.startsWith("make:")) {
         return runMake(command.slice("make:".length), rest);
     }
+    if (command === "client") {
+        return (await runClient(parseClientArgs(rest))) ? 0 : 1;
+    }
     console.error(`wild: unknown command "${command}". Run "wild --help" for usage.`);
     return 1;
 }
+function parseClientArgs(args) {
+    const opts = {};
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        const next = args[i + 1];
+        switch (arg) {
+            case "--spec":
+                opts.spec = next;
+                i++;
+                break;
+            case "--output":
+                opts.output = next;
+                i++;
+                break;
+            case "--target":
+                opts.target = next;
+                i++;
+                break;
+            case "--base-url":
+                opts.baseUrl = next;
+                i++;
+                break;
+            case "--resource":
+                opts.resource = next;
+                i++;
+                break;
+            case "--examples":
+                opts.examples = true;
+                break;
+            case "--dry-run":
+                opts.dryRun = true;
+                break;
+            default:
+                // ignore unknown flags
+                break;
+        }
+    }
+    return opts;
+}
 function runMake(piece, args) {
     try {
         const result = makeCommand(piece, args);
@@ -39,13 +112,39 @@ function runMake(piece, args) {
 }
 function printHelp() {
     console.log(`
-Wild Framework CLI — scaffold feature pieces from the documented patterns.
+Wild Framework CLI — generate instead of typing boilerplate.
+
+Project:
+  wild new <name>                    → scaffold a new project (multi-step wizard)
+  wild resource <Name>               → full CRUD feature slice (interactive or --field flags)
+
+Field types: string | text | email | url | uuid | date | datetime | time |
+             int | float | boolean | enum | json
+Rules (inline): required=false | min=0 | max=100 | minLength=2 | maxLength=40 |
+             pattern=^[a-z]+$ | options=a|b|c | default=x | array=true
+Add-ons (more bindings): --with event | listener | job | policy
+
+  wild resource Product --field name:string --field price:float:min=0 --field status:enum:options=draft|published
+  wild resource Product --with listener --with job
 
-Usage:
+Database:
+  wild db:migrate                    → apply pending migrations (env-driven DB)
+  wild db:status                     → list applied vs pending migrations
+  wild db:rollback [steps]           → revert the most recent migration(s)
+  wild make:migration <name>         → migrations/<ts>_<name>.sql (+ .down.sql)
+
+Graph (introspection for visual builders / AI agents):
+  wild graph [--url http://localhost:3000]   → fetch /graph.json from a running app
+
+Infrastructure (containerization + CI/CD):
+  wild docker [--compose]                    → detect + generate Dockerfile, .dockerignore
+  wild ci [--host gcp|aws|ftp|ssh] [--branch main]
+                                             → GitHub Actions workflow (quality gates + deploy)
+
+Pieces (fine-grained):
   wild make                          → interactive wizard (guided prompts)
   wild make:<piece> <Name> [targetDir]
 
-Pieces:
   module      wild make:module users                  → features/users/ (provider + service)
   provider    wild make:provider UserProvider         → user-provider.ts
   service     wild make:service UserService           → user-service.ts
@@ -57,15 +156,20 @@ Pieces:
   policy      wild make:policy PostPolicy             → post-policy.ts
   listener    wild make:listener SendWelcomeEmail     → send-welcome-email.ts
 
+Client generation (integration, never app scaffolding):
+  wild client [--spec ./openapi.json] [--output ./generated] [--target react]
+  wild client --examples --dry-run
+
 Options:
   -i, --interactive   run the guided wizard
-
-targetDir is optional (default: features/<name>). Files are written under ./src.
+  -h, --help          show this help
+  wild client --resource users
 
 Examples:
   wild make:provider OrderProvider features/orders
   wild make:event OrderPlaced features/orders
   wild make:module users
+  wild client --spec http://localhost:3200/openapi.json --output ../my-react-app
 `);
 }
 //# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAkB,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,IAAc;IACpC,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAEhC,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QAC7E,SAAS,EAAE,CAAC;QACZ,OAAO,CAAC,CAAC;IACb,CAAC;IAED,IAAI,OAAO,KAAK,WAAW,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QACvE,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC1B,OAAO,CAAC,CAAC;IACb,CAAC;IAED,IAAI,OAAO,KAAK,MAAM,IAAI,OAAO,KAAK,kBAAkB,IAAI,OAAO,KAAK,eAAe,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QAC1G,OAAO,SAAS,EAAE,CAAC;IACvB,CAAC;IAED,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9B,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAc,EAAE,IAAI,CAAC,CAAC;IACrE,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,0BAA0B,OAAO,iCAAiC,CAAC,CAAC;IAClF,OAAO,CAAC,CAAC;AACb,CAAC;AAED,SAAS,OAAO,CAAC,KAAgB,EAAE,IAAc;IAC7C,IAAI,CAAC;QACD,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACxC,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YAClB,OAAO,CAAC,CAAC,CAAC,wBAAwB;QACtC,CAAC;QACD,OAAO,CAAC,CAAC;IACb,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,SAAS,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACjF,OAAO,CAAC,CAAC;IACb,CAAC;AACL,CAAC;AAED,SAAS,SAAS;IACd,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4Bf,CAAC,CAAC;AACH,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/client/codegen.d.ts

@@ -0,0 +1,32 @@
+import type { ContractField, ContractOperation } from "./contract.js";
+/** PascalCase → camelCase. */
+export declare function camelCase(name: string): string;
+/** Uppercase first char. */
+export declare function capitalize(name: string): string;
+/** kebab → PascalCase ("user-profile" → "UserProfile"). */
+export declare function toPascal(kebab: string): string;
+/**
+ * Derive the plural resource name (best-effort):
+ *   "user" → "users", "person" → "people", "category" → "categories"
+ */
+export declare function pluralize(name: string): string;
+/** kebab → camel ("user-profile" → "userProfile"). */
+export declare function toCamelKebab(kebab: string): string;
+/** Path param keys from a template ("/users/{id}" → ["id"]). */
+export declare function pathParamKeys(path: string): string[];
+/**
+ * Render a path template as a TS template literal expression.
+ *   "/users/{id}" → "`/users/${encodeURIComponent(String(id))}`"
+ */
+export declare function pathToTemplateLiteral(path: string): string;
+/** Given a request-schema name like "CreateUserRequest", derive the entity type. */
+export declare function requestEntityName(requestSchema: string): string;
+/** Map a ContractField to a TS type string. */
+export declare function fieldToTs(field: ContractField, knownTypes: Set<string>, indent?: number): string;
+/** Build the set of known schema type names. */
+export declare function knownTypeNames(schemas: {
+    name: string;
+}[]): Set<string>;
+/** All distinct resources in a contract (kebab). */
+export declare function resourcesInContract(operations: ContractOperation[]): string[];
+//# sourceMappingURL=codegen.d.ts.map

package/dist/client/codegen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.d.ts","sourceRoot":"","sources":["../../src/client/codegen.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEtE,8BAA8B;AAC9B,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,4BAA4B;AAC5B,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,2DAA2D;AAC3D,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK9C;AAED,sDAAsD;AACtD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIlD;AAED,gEAAgE;AAChE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAQpD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG1D;AAED,oFAAoF;AACpF,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAK/D;AAED,+CAA+C;AAC/C,wBAAgB,SAAS,CAAC,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,SAAI,GAAG,MAAM,CAwB3F;AAED,gDAAgD;AAChD,wBAAgB,cAAc,CAAC,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAEvE;AAED,oDAAoD;AACpD,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,iBAAiB,EAAE,GAAG,MAAM,EAAE,CAM7E"}

package/dist/client/codegen.js

@@ -0,0 +1,94 @@
+/** PascalCase → camelCase. */
+export function camelCase(name) {
+    return name.charAt(0).toLowerCase() + name.slice(1);
+}
+/** Uppercase first char. */
+export function capitalize(name) {
+    return name.charAt(0).toUpperCase() + name.slice(1);
+}
+/** kebab → PascalCase ("user-profile" → "UserProfile"). */
+export function toPascal(kebab) {
+    return kebab.split("-").map((s) => s.charAt(0).toUpperCase() + s.slice(1)).join("");
+}
+/**
+ * Derive the plural resource name (best-effort):
+ *   "user" → "users", "person" → "people", "category" → "categories"
+ */
+export function pluralize(name) {
+    if (name.endsWith("y"))
+        return name.slice(0, -1) + "ies";
+    if (name.endsWith("s") || name.endsWith("x") || name.endsWith("z"))
+        return name + "es";
+    if (name.endsWith("ch") || name.endsWith("sh"))
+        return name + "es";
+    return name + "s";
+}
+/** kebab → camel ("user-profile" → "userProfile"). */
+export function toCamelKebab(kebab) {
+    const parts = kebab.split("-");
+    const [first, ...rest] = parts;
+    return (first ?? "") + rest.map((s) => s.charAt(0).toUpperCase() + s.slice(1)).join("");
+}
+/** Path param keys from a template ("/users/{id}" → ["id"]). */
+export function pathParamKeys(path) {
+    const keys = [];
+    const re = /\{([^}]+)\}/g;
+    let m;
+    while ((m = re.exec(path)) !== null) {
+        keys.push(m[1]);
+    }
+    return keys;
+}
+/**
+ * Render a path template as a TS template literal expression.
+ *   "/users/{id}" → "`/users/${encodeURIComponent(String(id))}`"
+ */
+export function pathToTemplateLiteral(path) {
+    const body = path.replace(/\{([^}]+)\}/g, (_, k) => `\${encodeURIComponent(String(${k}))}`);
+    return `\`${body}\``;
+}
+/** Given a request-schema name like "CreateUserRequest", derive the entity type. */
+export function requestEntityName(requestSchema) {
+    // CreateUserRequest → User ; UpdateUserRequest → User
+    return requestSchema
+        .replace(/^(Create|Update|Delete|Post|Put|Patch)/i, "")
+        .replace(/Request$/, "");
+}
+/** Map a ContractField to a TS type string. */
+export function fieldToTs(field, knownTypes, indent = 2) {
+    const pad = " ".repeat(indent);
+    const innerPad = " ".repeat(indent + 2);
+    if (field.type === "array") {
+        // Array of inline objects (e.g. order line items)
+        if (field.itemFields && field.itemFields.length > 0) {
+            const inner = field.itemFields.map((f) => {
+                const opt = f.optional ? "?" : "";
+                return `${innerPad}${f.name}${opt}: ${fieldToTs(f, knownTypes, indent + 2)};`;
+            });
+            return `{\n${inner.join("\n")}\n${pad}}[]`;
+        }
+        const item = field.itemType && knownTypes.has(field.itemType) ? field.itemType : field.itemType ?? "unknown";
+        return `${item}[]`;
+    }
+    if (field.type === "object" && field.fields && field.fields.length > 0) {
+        const lines = field.fields.map((f) => {
+            const opt = f.optional ? "?" : "";
+            return `${innerPad}${f.name}${opt}: ${fieldToTs(f, knownTypes, indent + 2)};`;
+        });
+        return `{\n${lines.join("\n")}\n${pad}}`;
+    }
+    return field.type;
+}
+/** Build the set of known schema type names. */
+export function knownTypeNames(schemas) {
+    return new Set(schemas.map((s) => s.name));
+}
+/** All distinct resources in a contract (kebab). */
+export function resourcesInContract(operations) {
+    const seen = new Set();
+    for (const op of operations) {
+        seen.add(op.resourceKebab);
+    }
+    return [...seen];
+}
+//# sourceMappingURL=codegen.js.map

package/dist/client/codegen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.js","sourceRoot":"","sources":["../../src/client/codegen.ts"],"names":[],"mappings":"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"}

package/dist/client/command.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Options for the `wild client` command.
+ */
+export interface ClientOptions {
+    /** OpenAPI spec source: URL or file path. Default "./openapi.json". */
+    spec?: string;
+    /** Output directory. Default: detected source dir (or cwd). */
+    output?: string;
+    /** Client target adapter. Default "react". */
+    target?: string;
+    /** Base URL the generated client calls. Default "/". */
+    baseUrl?: string;
+    /** Emit example components (target-dependent). Default false. */
+    examples?: boolean;
+    /** Print what would be generated, write nothing. */
+    dryRun?: boolean;
+    /** Restrict generation to one resource (kebab name). Default all. */
+    resource?: string;
+}
+/**
+ * Run the `wild client` generator.
+ *
+ * Philosophy: generate the deterministic integration (clients, types,
+ * validation, query/mutation hooks), never scaffold an application.
+ *
+ * @returns true on success, false on error (error already printed)
+ */
+export declare function runClient(options: ClientOptions): Promise<boolean>;
+//# sourceMappingURL=command.d.ts.map

package/dist/client/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/client/command.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oDAAoD;IACpD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAmFxE"}

package/dist/client/command.js

@@ -0,0 +1,95 @@
+import { resolve } from "node:path";
+import { loadSpec, parseContract } from "./spec.js";
+import { ClientGenerator } from "./core.js";
+import { DiskWriter } from "./fs-writer.js";
+import { targets } from "./targets/index.js";
+import { inspectProject, resolveSourceDir } from "./inspector.js";
+/**
+ * Run the `wild client` generator.
+ *
+ * Philosophy: generate the deterministic integration (clients, types,
+ * validation, query/mutation hooks), never scaffold an application.
+ *
+ * @returns true on success, false on error (error already printed)
+ */
+export async function runClient(options) {
+    const specSource = options.spec ?? "./openapi.json";
+    const targetName = options.target ?? "react";
+    if (!targets[targetName]) {
+        console.error(`wild: unknown client target "${targetName}". Available: ${Object.keys(targets).join(", ")}`);
+        return false;
+    }
+    console.log(`\nLoading OpenAPI spec from ${specSource}...`);
+    let raw;
+    try {
+        raw = await loadSpec(specSource);
+    }
+    catch (error) {
+        console.error(`wild: ${error instanceof Error ? error.message : String(error)}`);
+        console.error("\nHint: start your app (so /openapi.json is served) or pass --spec <file>.");
+        return false;
+    }
+    const contract = parseContract(raw);
+    console.log(`  ${contract.title} v${contract.version} — ${contract.operations.length} operation(s)`);
+    console.log(`  ${contract.schemas.length} schema(s), ${new Set(contract.operations.map((o) => o.resourceKebab)).size} resource(s)`);
+    // Restrict to a single resource if requested
+    if (options.resource) {
+        const before = contract.operations.length;
+        contract.operations = contract.operations.filter((o) => o.resourceKebab === options.resource);
+        if (contract.operations.length === 0) {
+            console.error(`wild: no operations for resource "${options.resource}".`);
+            return false;
+        }
+        console.log(`  restricted to resource "${options.resource}" (${before} → ${contract.operations.length} operation(s))`);
+    }
+    // Detect the destination project
+    const cwd = process.cwd();
+    const detection = inspectProject(cwd);
+    const outRoot = resolve(options.output ?? resolveSourceDir(cwd));
+    const baseUrl = options.baseUrl ?? "/";
+    console.log(`\nDestination: ${outRoot}`);
+    if (detection.packageManager)
+        console.log(`  package manager : ${detection.packageManager}`);
+    if (detection.framework)
+        console.log(`  framework       : ${detection.framework}`);
+    if (detection.typescript)
+        console.log(`  typescript      : yes`);
+    if (detection.tanstackQuery)
+        console.log(`  tanstack query  : yes`);
+    if (!detection.typescript) {
+        console.warn("  ⚠ no tsconfig.json found — generated code assumes TypeScript");
+    }
+    if (detection.framework && detection.framework !== "react") {
+        console.warn(`  ⚠ detected framework "${detection.framework}" — the ${targetName} target may not fit`);
+    }
+    const generator = new ClientGenerator(targets, new DiskWriter());
+    if (options.dryRun) {
+        const files = targets[targetName].generateFiles({
+            contract,
+            baseUrl,
+            examples: options.examples ?? false,
+        });
+        console.log(`\nDry-run — would generate ${files.length} file(s) under ${outRoot}:\n`);
+        for (const f of files) {
+            console.log(`  ${f.path}`);
+        }
+        return true;
+    }
+    console.log(`\nGenerating ${targetName} client under ${outRoot}...\n`);
+    const result = generator.generate(contract, targetName, {
+        outputDir: outRoot,
+        baseUrl,
+        examples: options.examples ?? false,
+    });
+    if (result.filesWritten.length === 0) {
+        console.log("\nNothing to do — all files already exist.");
+    }
+    else {
+        console.log(`\nDone. ${result.filesWritten.length} file(s) generated, ${result.filesSkipped.length} skipped.`);
+        console.log("\nNext steps:");
+        console.log("  Import the generated hooks/clients in your existing app.");
+        console.log("  Ensure these deps exist: @tanstack/react-query, zod (for the react target).");
+    }
+    return true;
+}
+//# sourceMappingURL=command.js.map

package/dist/client/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../src/client/command.ts"],"names":[],"mappings":"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"}

package/dist/client/contract.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Client Generator Core — framework-agnostic contract.
+ *
+ * A "Resource Contract" is a normalized, framework-agnostic description of an
+ * API, derived from an OpenAPI spec. The generator core consumes only this
+ * contract — never the OpenAPI document directly — so the same contract can
+ * drive any client adapter (React, Vue, Svelte, Solid, plain JS, …).
+ *
+ * This module is intentionally free of any frontend-framework vocabulary.
+ */
+/** Supported HTTP methods. */
+export type HttpMethod = "get" | "post" | "put" | "patch" | "delete";
+/** Where a parameter appears in the request. */
+export type ParamLocation = "path" | "query" | "header";
+/** A single request parameter. */
+export interface ContractParam {
+    name: string;
+    location: ParamLocation;
+    type: string;
+    required: boolean;
+}
+/** A single field of a schema. */
+export interface ContractField {
+    name: string;
+    type: string;
+    /** null-able / optional (union with undefined). */
+    optional?: boolean;
+    /** Nested fields for object-typed fields. */
+    fields?: ContractField[];
+    /** Element type for array-typed fields. */
+    itemType?: string;
+    /** Element fields when the array holds inline objects. */
+    itemFields?: ContractField[];
+}
+/** A named schema (from request validators / resources). */
+export interface ContractSchema {
+    name: string;
+    fields: ContractField[];
+}
+/**
+ * The role an operation plays in REST terms. Derived structurally so the
+ * generator never invents endpoints that don't exist in the spec.
+ */
+export type OperationKind = "list" | "detail" | "create" | "update" | "delete" | "action";
+/** An operation (one HTTP endpoint) in the contract. */
+export interface ContractOperation {
+    method: HttpMethod;
+    /** Path template, e.g. "/users/{id}". */
+    path: string;
+    /** PascalCase resource name, e.g. "User". */
+    resource: string;
+    /** kebab-case resource, e.g. "users" (used for file/function names). */
+    resourceKebab: string;
+    /** Structural REST role of this operation. */
+    kind: OperationKind;
+    /** Whether this is a collection (list) operation. */
+    isCollection: boolean;
+    params: ContractParam[];
+    /** Request body schema name, if any. */
+    requestSchema?: string;
+    /** Whether the operation returns a single resource vs a collection. */
+    returnsList?: boolean;
+}
+/** The complete framework-agnostic contract. */
+export interface ResourceContract {
+    title: string;
+    version: string;
+    schemas: ContractSchema[];
+    operations: ContractOperation[];
+}
+/** Options accepted by the core generator. */
+export interface GenerateOptions {
+    /** Destination root directory (absolute). Defaults to process.cwd(). */
+    outputDir?: string;
+    /** Base URL the generated client calls. Defaults to "/". */
+    baseUrl?: string;
+    /** Emit example components (React adapter). Defaults to false. */
+    examples?: boolean;
+}
+/** Result of a generation run. */
+export interface GenerateResult {
+    filesWritten: string[];
+    filesSkipped: string[];
+    target: string;
+}
+//# sourceMappingURL=contract.d.ts.map

package/dist/client/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/client/contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,8BAA8B;AAC9B,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;AAErE,gDAAgD;AAChD,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAExD,kCAAkC;AAClC,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,aAAa,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;CACrB;AAED,kCAAkC;AAClC,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;IACzB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;CAChC;AAED,4DAA4D;AAC5D,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE1F,wDAAwD;AACxD,MAAM,WAAW,iBAAiB;IAC9B,MAAM,EAAE,UAAU,CAAC;IACnB,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,aAAa,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,IAAI,EAAE,aAAa,CAAC;IACpB,qDAAqD;IACrD,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,wCAAwC;IACxC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uEAAuE;IACvE,WAAW,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,gDAAgD;AAChD,MAAM,WAAW,gBAAgB;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,UAAU,EAAE,iBAAiB,EAAE,CAAC;CACnC;AAED,8CAA8C;AAC9C,MAAM,WAAW,eAAe;IAC5B,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,kCAAkC;AAClC,MAAM,WAAW,cAAc;IAC3B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;CAClB"}

package/dist/client/contract.js

@@ -0,0 +1,12 @@
+/**
+ * Client Generator Core — framework-agnostic contract.
+ *
+ * A "Resource Contract" is a normalized, framework-agnostic description of an
+ * API, derived from an OpenAPI spec. The generator core consumes only this
+ * contract — never the OpenAPI document directly — so the same contract can
+ * drive any client adapter (React, Vue, Svelte, Solid, plain JS, …).
+ *
+ * This module is intentionally free of any frontend-framework vocabulary.
+ */
+export {};
+//# sourceMappingURL=contract.js.map

package/dist/client/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../src/client/contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/client/core.d.ts

@@ -0,0 +1,80 @@
+import type { ResourceContract, GenerateOptions, GenerateResult } from "./contract.js";
+/**
+ * A generated file: relative path + content.
+ */
+export interface GeneratedFile {
+    path: string;
+    content: string;
+}
+/**
+ * What the core generator asks a target adapter to produce.
+ */
+export interface TargetRequest {
+    /** The framework-agnostic contract. */
+    contract: ResourceContract;
+    /** Base URL the client should call. */
+    baseUrl: string;
+    /** Whether to emit example components (adapter-defined). */
+    examples: boolean;
+}
+/**
+ * The target-adapter contract.
+ *
+ * Every adapter (react, vue, svelte, solid, plain-js, …) implements this.
+ * The core generator never knows about a specific frontend framework.
+ */
+export interface ClientTarget {
+    /** Stable identifier, e.g. "react". */
+    name: string;
+    /** Human-readable label. */
+    label: string;
+    /**
+     * Produce the full file set for this target from the contract.
+     * The adapter decides structure (e.g. generated/users/api.ts),
+     * naming, and content.
+     */
+    generateFiles(request: TargetRequest): GeneratedFile[];
+}
+/** Placeholder adapter interface (kept for symmetry with other targets). */
+export interface ProjectDetection {
+    /** Detected package manager (npm/pnpm/yarn/bun) or null. */
+    packageManager: string | null;
+    /** Detected source dir, e.g. "src" or null. */
+    sourceDir: string | null;
+    /** Detected framework, e.g. "react" or null. */
+    framework: string | null;
+    /** Whether the project uses TypeScript. */
+    typescript: boolean;
+    /** Whether TanStack Query is present (for react target). */
+    tanstackQuery: boolean;
+}
+/**
+ * Generator core — framework-agnostic.
+ *
+ * Orchestrates: contract → target adapter → file emission, with an
+ * overwrite/update strategy (existing files are skipped unless they're
+ * marked as regenerable).
+ */
+export declare class ClientGenerator {
+    private readonly targets;
+    private readonly writer;
+    constructor(targets: Record<string, ClientTarget>, writer: FileWriter);
+    /** Register a target adapter. */
+    register(target: ClientTarget): void;
+    /** List available target names. */
+    availableTargets(): string[];
+    /**
+     * Generate a client for a target into an output directory.
+     *
+     * The generator only writes files the adapter returns; it never
+     * creates package.json, bundler config, entry points, or UI scaffolding.
+     */
+    generate(contract: ResourceContract, targetName: string, options?: GenerateOptions): GenerateResult;
+}
+/** Result of a single file write. */
+export type WriteOutcome = "written" | "skipped";
+/** Abstraction over the filesystem, injectable for tests. */
+export interface FileWriter {
+    write(file: GeneratedFile, root: string): WriteOutcome;
+}
+//# sourceMappingURL=core.d.ts.map

package/dist/client/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/client/core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEvF;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,uCAAuC;IACvC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,QAAQ,EAAE,OAAO,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IACzB,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,aAAa,EAAE,CAAC;CAC1D;AAED,4EAA4E;AAC5E,MAAM,WAAW,gBAAgB;IAC7B,4DAA4D;IAC5D,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,+CAA+C;IAC/C,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,gDAAgD;IAChD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,2CAA2C;IAC3C,UAAU,EAAE,OAAO,CAAC;IACpB,4DAA4D;IAC5D,aAAa,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,qBAAa,eAAe;IAEpB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,EACrC,MAAM,EAAE,UAAU;IAGvC,iCAAiC;IACjC,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAIpC,mCAAmC;IACnC,gBAAgB,IAAI,MAAM,EAAE;IAI5B;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,cAAc;CAwB1G;AAED,qCAAqC;AACrC,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,SAAS,CAAC;AAEjD,6DAA6D;AAC7D,MAAM,WAAW,UAAU;IACvB,KAAK,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY,CAAC;CAC1D"}