@apollo-deploy/tesseract 0.9.1 → 1.0.0

package/dist/adapters/csharp/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * C# (dotnet) language adapter.
+ * Generates an idiomatic C# SDK targeting net8.0 with System.Text.Json.
+ */
+import type { EnrichedSDKIR } from "../../types/ir.js";
+import type { LanguageAdapter, EmitResult } from "../types.js";
+import type { ResolvedConfig } from "../../types/config.js";
+export declare class CSharpAdapter implements LanguageAdapter {
+    readonly language = "csharp";
+    emit(enriched: EnrichedSDKIR, outputDir: string, config?: ResolvedConfig): Promise<EmitResult>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/csharp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/csharp/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAU5D,qBAAa,aAAc,YAAW,eAAe;IACnD,QAAQ,CAAC,QAAQ,YAAY;IAEvB,IAAI,CACR,QAAQ,EAAE,aAAa,EACvB,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC,UAAU,CAAC;CAsHvB"}

package/dist/adapters/csharp/index.js

@@ -0,0 +1,99 @@
+/**
+ * C# (dotnet) language adapter.
+ * Generates an idiomatic C# SDK targeting net8.0 with System.Text.Json.
+ */
+import { join } from "node:path";
+import { getTemplate, registerHelpers, collectImports, } from "../../helpers/handlebars.js";
+import { pascalCase } from "change-case";
+export class CSharpAdapter {
+    language = "csharp";
+    async emit(enriched, outputDir, config) {
+        registerHelpers();
+        const files = [];
+        const warnings = [];
+        const schemaNames = new Set(enriched.schemas.map((s) => s.name));
+        const clientType = config?.clientType ?? "internal";
+        // ── Visibility filtering ───────────────────────────────────────────────
+        const visibleGroups = [];
+        for (const g of enriched.groups) {
+            if (clientType === "public" && g.visibility === "internal")
+                continue;
+            const ops = clientType === "public"
+                ? g.operations.filter((op) => op.visibility !== "internal")
+                : g.operations;
+            if (ops.length === 0)
+                continue;
+            visibleGroups.push(ops === g.operations ? g : { ...g, operations: ops });
+        }
+        const hasSSE = visibleGroups.some((g) => g.operations.some((op) => op.isEventStream));
+        // Derive namespace and project name from package name
+        const ns = enriched.meta.packageName
+            .split("/")
+            .map((s) => pascalCase(s))
+            .join(".");
+        const projectName = enriched.meta.clientName ||
+            enriched.meta.packageName.split("/").pop() ||
+            "sdk";
+        const pascalProjectName = pascalCase(projectName);
+        // ── Emit helper ────────────────────────────────────────────────────────
+        const emit = (relativePath, templateName, ctx) => {
+            try {
+                const tpl = getTemplate("csharp", templateName);
+                files.push({ relativePath, content: tpl(ctx) });
+            }
+            catch (err) {
+                warnings.push(`${relativePath}: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        };
+        // ── Root files ─────────────────────────────────────────────────────────
+        emit(`${pascalProjectName}.csproj`, "csproj", {
+            ...enriched.meta,
+            packageName: enriched.meta.packageName,
+            packageVersion: enriched.meta.packageVersion || enriched.meta.version || "1.0.0",
+            projectName: pascalProjectName,
+        });
+        emit("README.md", "readme", {
+            ...enriched.meta,
+            groups: visibleGroups,
+            schemas: enriched.schemas,
+            securitySchemes: enriched.securitySchemes,
+            hasSSE,
+            namespace: ns,
+            projectName: pascalProjectName,
+        });
+        // ── Core source files ──────────────────────────────────────────────────
+        emit("Client.cs", "client", {
+            ...enriched.meta,
+            groups: visibleGroups,
+            securitySchemes: enriched.securitySchemes,
+            hasSSE,
+            namespace: ns,
+            clientName: enriched.meta.clientName || pascalProjectName,
+        });
+        emit("Transport.cs", "transport", {
+            securitySchemes: enriched.securitySchemes,
+            namespace: ns,
+        });
+        emit("Errors.cs", "errors", {
+            namespace: ns,
+        });
+        emit("Types.cs", "types", {
+            schemas: enriched.schemas,
+            namespace: ns,
+        });
+        // ── Domain files ───────────────────────────────────────────────────────
+        for (const group of visibleGroups) {
+            const imports = collectImports(group.operations, schemaNames);
+            const groupHasSSE = group.operations.some((op) => op.isEventStream);
+            emit(join("Api", `${group.fileName}.cs`), "domain", {
+                ...group,
+                imports,
+                hasSSE: groupHasSSE,
+                securitySchemes: enriched.securitySchemes,
+                namespace: ns,
+            });
+        }
+        return { files, warnings };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/adapters/csharp/index.js.map

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

package/dist/adapters/go/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Go language adapter.
+ * Generates an idiomatic Go SDK package using net/http.
+ */
+import type { EnrichedSDKIR } from "../../types/ir.js";
+import type { LanguageAdapter, EmitResult } from "../types.js";
+import type { ResolvedConfig } from "../../types/config.js";
+export declare class GoAdapter implements LanguageAdapter {
+    readonly language = "go";
+    emit(enriched: EnrichedSDKIR, outputDir: string, config?: ResolvedConfig): Promise<EmitResult>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/go/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/go/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAoD5D,qBAAa,SAAU,YAAW,eAAe;IAC/C,QAAQ,CAAC,QAAQ,QAAQ;IAEnB,IAAI,CACR,QAAQ,EAAE,aAAa,EACvB,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC,UAAU,CAAC;CA+GvB"}

package/dist/adapters/go/index.js

@@ -0,0 +1,135 @@
+/**
+ * Go language adapter.
+ * Generates an idiomatic Go SDK package using net/http.
+ */
+import { getTemplate, registerHelpers, collectImports, } from "../../helpers/handlebars.js";
+import Handlebars from "handlebars";
+function goTypeExpr(tsType) {
+    if (!tsType)
+        return "interface{}";
+    // If it's a simple identifier (alphanumeric), pass through
+    if (/^[A-Za-z_][A-Za-z0-9_]*$/.test(tsType))
+        return "*" + tsType;
+    // If it's a TypeScript inline type with braces, use interface{}
+    return "interface{}";
+}
+function goPropertyType(tsType) {
+    const t = tsType.trim();
+    const MAP = {
+        string: "string",
+        number: "float64",
+        integer: "int",
+        boolean: "bool",
+        any: "interface{}",
+        unknown: "interface{}",
+    };
+    if (MAP[t])
+        return MAP[t];
+    // Array<T>
+    const arr = t.match(/^Array<(.+)>$/);
+    if (arr)
+        return `[]${goPropertyType(arr[1])}`;
+    // Record<K, V>
+    const rec = t.match(/^Record<(.+),\s*(.+)>$/);
+    if (rec)
+        return `map[${goPropertyType(rec[1])}]${goPropertyType(rec[2])}`;
+    // TypeScript union literals → string
+    if (/^["']/.test(t))
+        return "string";
+    return t;
+}
+let goHelpersRegistered = false;
+function registerGoHelpers() {
+    if (goHelpersRegistered)
+        return;
+    goHelpersRegistered = true;
+    Handlebars.registerHelper("goQueryType", (tsType) => goTypeExpr(tsType));
+    Handlebars.registerHelper("goPropertyType", (tsType) => goPropertyType(tsType));
+}
+export class GoAdapter {
+    language = "go";
+    async emit(enriched, outputDir, config) {
+        registerHelpers();
+        registerGoHelpers();
+        const files = [];
+        const warnings = [];
+        const schemaNames = new Set(enriched.schemas.map((s) => s.name));
+        const clientType = config?.clientType ?? "internal";
+        // ── Visibility filtering ───────────────────────────────────────────────
+        const visibleGroups = [];
+        for (const g of enriched.groups) {
+            if (clientType === "public" && g.visibility === "internal")
+                continue;
+            const ops = clientType === "public"
+                ? g.operations.filter((op) => op.visibility !== "internal")
+                : g.operations;
+            if (ops.length === 0)
+                continue;
+            visibleGroups.push(ops === g.operations ? g : { ...g, operations: ops });
+        }
+        const hasSSE = visibleGroups.some((g) => g.operations.some((op) => op.isEventStream));
+        const pkgName = (enriched.meta.packageName.split("/").pop() || "sdk")
+            .replace(/[^a-zA-Z0-9_]/g, "_")
+            .replace(/^[^a-zA-Z_]/, "sdk");
+        // ── Emit helper ────────────────────────────────────────────────────────
+        const emit = (relativePath, templateName, ctx) => {
+            try {
+                const tpl = getTemplate("go", templateName);
+                files.push({ relativePath, content: tpl(ctx) });
+            }
+            catch (err) {
+                warnings.push(`${relativePath}: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        };
+        // ── Root files ─────────────────────────────────────────────────────────
+        emit("go.mod", "go-mod", {
+            ...enriched.meta,
+            pkgName,
+        });
+        emit("README.md", "readme", {
+            ...enriched.meta,
+            groups: visibleGroups,
+            schemas: enriched.schemas,
+            securitySchemes: enriched.securitySchemes,
+            hasSSE,
+            pkgName,
+        });
+        // ── Core package files ─────────────────────────────────────────────────
+        emit("client.go", "client", {
+            ...enriched.meta,
+            groups: visibleGroups,
+            securitySchemes: enriched.securitySchemes,
+            hasSSE,
+            pkgName,
+            clientType,
+        });
+        emit("transport.go", "transport", {
+            securitySchemes: enriched.securitySchemes,
+            pkgName,
+        });
+        emit("errors.go", "errors", {
+            pkgName,
+        });
+        emit("types.go", "types", {
+            schemas: enriched.schemas,
+            pkgName,
+        });
+        emit("utils.go", "utils", {
+            pkgName,
+        });
+        // ── Domain files ───────────────────────────────────────────────────────
+        for (const group of visibleGroups) {
+            const imports = collectImports(group.operations, schemaNames);
+            const groupHasSSE = group.operations.some((op) => op.isEventStream);
+            emit(`${group.fileName}.go`, "domain", {
+                ...group,
+                imports,
+                hasSSE: groupHasSSE,
+                securitySchemes: enriched.securitySchemes,
+                pkgName,
+            });
+        }
+        return { files, warnings };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/adapters/go/index.js.map

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

package/dist/adapters/kotlin/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Kotlin language adapter.
+ * Emits a Gradle-based Kotlin SDK with Ktor HTTP client, kotlinx.serialization,
+ * and coroutines for async operations.
+ */
+import type { EnrichedSDKIR } from "../../types/ir.js";
+import type { LanguageAdapter, EmitResult } from "../types.js";
+import type { ResolvedConfig } from "../../types/config.js";
+export declare class KotlinAdapter implements LanguageAdapter {
+    readonly language = "kotlin";
+    emit(enriched: EnrichedSDKIR, outputDir: string, config?: ResolvedConfig): Promise<EmitResult>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/kotlin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/kotlin/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAyE5D,qBAAa,aAAc,YAAW,eAAe;IACnD,QAAQ,CAAC,QAAQ,YAAY;IAEvB,IAAI,CACR,QAAQ,EAAE,aAAa,EACvB,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC,UAAU,CAAC;CAiJvB"}

package/dist/adapters/kotlin/index.js

@@ -0,0 +1,186 @@
+/**
+ * Kotlin language adapter.
+ * Emits a Gradle-based Kotlin SDK with Ktor HTTP client, kotlinx.serialization,
+ * and coroutines for async operations.
+ */
+import { join } from "node:path";
+import Handlebars from "handlebars";
+import { getTemplate, registerHelpers, collectImports } from "../../helpers/handlebars.js";
+// ─────────────────────────────────────────────────────────────────────────────
+// Kotlin type mapping
+// ─────────────────────────────────────────────────────────────────────────────
+const KOTLIN_TYPE_MAP = {
+    string: "String",
+    number: "Double",
+    integer: "Long",
+    boolean: "Boolean",
+    any: "kotlinx.serialization.json.JsonElement",
+    unknown: "kotlinx.serialization.json.JsonElement",
+    void: "Unit",
+    null: "Nothing?",
+};
+function kotlinType(tsType) {
+    const t = tsType.trim();
+    if (KOTLIN_TYPE_MAP[t]) {
+        return KOTLIN_TYPE_MAP[t];
+    }
+    // Nullable: `T | null` → `T?`
+    const nullMatch = t.match(/^(.+?)\s*\|\s*null$/);
+    if (nullMatch) {
+        return `${kotlinType(nullMatch[1])}?`;
+    }
+    // Array<T> → List<T>
+    const arrMatch = t.match(/^Array<(.+)>$/);
+    if (arrMatch) {
+        return `List<${kotlinType(arrMatch[1])}>`;
+    }
+    // Record<K, V> → Map<K, V>
+    const recMatch = t.match(/^Record<(.+),\s*(.+)>$/);
+    if (recMatch) {
+        return `Map<${kotlinType(recMatch[1])}, ${kotlinType(recMatch[2])}>`;
+    }
+    // Map<T> → Map<String, T>
+    const mapMatch = t.match(/^Map<(.+)>$/);
+    if (mapMatch) {
+        return `Map<String, ${kotlinType(mapMatch[1])}>`;
+    }
+    // Union type `A | B` → approximate with sealed class ref
+    if (t.includes(" | ")) {
+        const parts = t.split(" | ").map((p) => kotlinType(p.trim()));
+        return parts.join("Or").replace(/\s/g, "");
+    }
+    // Intersection type — approximate
+    if (t.includes(" & ")) {
+        return t.replace(/\s*&\s*/g, "And").replace(/\s/g, "");
+    }
+    // Parenthesized
+    if (t.startsWith("(") && t.endsWith(")")) {
+        return kotlinType(t.slice(1, -1));
+    }
+    return t;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Adapter
+// ─────────────────────────────────────────────────────────────────────────────
+export class KotlinAdapter {
+    language = "kotlin";
+    async emit(enriched, outputDir, config) {
+        registerHelpers();
+        // Register Kotlin-specific helpers
+        Handlebars.registerHelper("kotlinType", (tsType) => {
+            return new Handlebars.SafeString(kotlinType(tsType));
+        });
+        const files = [];
+        const warnings = [];
+        const schemaNames = new Set(enriched.schemas.map((s) => s.name));
+        const clientType = config?.clientType ?? "internal";
+        // ── Visibility filtering ────────────────────────────────────────────────
+        const visibleGroups = [];
+        for (const g of enriched.groups) {
+            if (clientType === "public" && g.visibility === "internal")
+                continue;
+            const ops = clientType === "public"
+                ? g.operations.filter((op) => op.visibility !== "internal")
+                : g.operations;
+            if (ops.length === 0)
+                continue;
+            visibleGroups.push(ops === g.operations ? g : { ...g, operations: ops });
+        }
+        const hasSSE = visibleGroups.some((g) => g.operations.some((op) => op.isEventStream));
+        // ── Package name resolution ─────────────────────────────────────────────
+        const pkgName = enriched.meta.packageName
+            .replace(/^@.+\//, "")
+            .replace(/-/g, ".");
+        const pkgPath = pkgName.replace(/\./g, "/");
+        const groupId = enriched.meta.packageName.startsWith("@")
+            ? enriched.meta.packageName.replace(/^@/, "").replace(/\/.+$/, "")
+            : "com.example";
+        const artifactId = enriched.meta.packageName
+            .replace(/^@.+\//, "")
+            .replace(/-/g, "-");
+        // ── Helper ──────────────────────────────────────────────────────────────
+        const emit = (relativePath, tplName, ctx) => {
+            try {
+                files.push({
+                    relativePath,
+                    content: getTemplate("kotlin", tplName)(ctx),
+                });
+            }
+            catch (err) {
+                warnings.push(`${relativePath}: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        };
+        // ── Root files ──────────────────────────────────────────────────────────
+        emit("build.gradle.kts", "build-gradle", {
+            ...enriched.meta,
+            groupId,
+            artifactId,
+        });
+        emit("settings.gradle.kts", "settings-gradle", {
+            artifactId,
+        });
+        emit("gradle.properties", "gradle-properties", {
+            ...enriched.meta,
+            groupId,
+            artifactId,
+        });
+        emit("README.md", "readme", {
+            ...enriched.meta,
+            groups: visibleGroups,
+            schemas: enriched.schemas,
+            securitySchemes: enriched.securitySchemes,
+            hasSSE,
+            groupId,
+            artifactId,
+            packageName: pkgName,
+        });
+        // ── Source files ────────────────────────────────────────────────────────
+        const srcDir = join("src", "main", "kotlin", ...pkgName.split("."));
+        emit(join(srcDir, "Client.kt"), "client", {
+            ...enriched.meta,
+            groups: visibleGroups,
+            securitySchemes: enriched.securitySchemes,
+            hasSSE,
+            packageName: pkgName,
+        });
+        emit(join(srcDir, "Transport.kt"), "transport", {
+            securitySchemes: enriched.securitySchemes,
+            packageName: pkgName,
+        });
+        emit(join(srcDir, "Errors.kt"), "errors", {
+            packageName: pkgName,
+        });
+        emit(join(srcDir, "Types.kt"), "types", {
+            schemas: enriched.schemas,
+            packageName: pkgName,
+        });
+        // ── Domain files ────────────────────────────────────────────────────────
+        for (const group of visibleGroups) {
+            const imports = collectImports(group.operations, schemaNames);
+            const transformedOps = group.operations.map((op) => ({
+                ...op,
+                pathParams: op.pathParams.map((p) => ({
+                    ...p,
+                    kotlinType: kotlinType(p.type),
+                })),
+                requestBody: op.requestBody
+                    ? {
+                        ...op.requestBody,
+                        kotlinType: kotlinType(op.requestBody.type),
+                    }
+                    : undefined,
+                kotlinResponseType: kotlinType(op.responseType),
+                _queryParams: op.queryParams,
+            }));
+            emit(join(srcDir, `${group.interfaceName}.kt`), "domain", {
+                ...group,
+                operations: transformedOps,
+                imports,
+                securitySchemes: enriched.securitySchemes,
+                packageName: pkgName,
+            });
+        }
+        return { files, warnings };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/adapters/kotlin/index.js.map

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

package/dist/adapters/php/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * PHP language adapter.
+ * Generates PHP 8.1+ SDKs using Guzzle for HTTP and Composer for package management.
+ */
+import type { EnrichedSDKIR } from "../../types/ir.js";
+import type { LanguageAdapter, EmitResult } from "../types.js";
+import type { ResolvedConfig } from "../../types/config.js";
+export declare class PHPAdapter implements LanguageAdapter {
+    readonly language = "php";
+    emit(enriched: EnrichedSDKIR, _outputDir: string, config?: ResolvedConfig): Promise<EmitResult>;
+    /**
+     * Derives a PSR-4 namespace from a package name.
+     *
+     * Example:
+     *   @acme/pet-store-api  →  Acme\PetStoreApi
+     *   my-org/my-sdk        →  MyOrg\MySdk
+     */
+    private _deriveNamespace;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/php/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/php/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAS5D,qBAAa,UAAW,YAAW,eAAe;IAChD,QAAQ,CAAC,QAAQ,SAAS;IAEpB,IAAI,CACR,QAAQ,EAAE,aAAa,EACvB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC,UAAU,CAAC;IAiItB;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;CAOzB"}

package/dist/adapters/php/index.js

@@ -0,0 +1,123 @@
+/**
+ * PHP language adapter.
+ * Generates PHP 8.1+ SDKs using Guzzle for HTTP and Composer for package management.
+ */
+import { join } from "node:path";
+import { getTemplate, registerHelpers, collectImports, } from "../../helpers/handlebars.js";
+import { pascalCase } from "change-case";
+export class PHPAdapter {
+    language = "php";
+    async emit(enriched, _outputDir, config) {
+        registerHelpers();
+        const files = [];
+        const warnings = [];
+        const schemaNames = new Set(enriched.schemas.map((s) => s.name));
+        const clientType = config?.clientType ?? "internal";
+        // ── Visibility filter ───────────────────────────────────────────────────
+        const visibleGroups = [];
+        for (const g of enriched.groups) {
+            if (clientType === "public" && g.visibility === "internal")
+                continue;
+            const ops = clientType === "public"
+                ? g.operations.filter((op) => op.visibility !== "internal")
+                : g.operations;
+            if (ops.length === 0)
+                continue;
+            visibleGroups.push(ops === g.operations ? g : { ...g, operations: ops });
+        }
+        const hasSSE = visibleGroups.some((g) => g.operations.some((op) => op.isEventStream));
+        // ── Pre-compute class names for groups ────────────────────────────────
+        const groupClassNames = {};
+        for (const g of visibleGroups) {
+            groupClassNames[g.name] = pascalCase(g.fileName);
+        }
+        // ── Derive namespace from package name ──────────────────────────────────
+        const namespace = this._deriveNamespace(enriched.meta.packageName);
+        const composerName = enriched.meta.packageName;
+        // ── Helper: emit a single file via template ────────────────────────────
+        const emit = (relativePath, templateName, ctx) => {
+            try {
+                const tpl = getTemplate("php", templateName);
+                files.push({
+                    relativePath,
+                    content: tpl(ctx),
+                });
+            }
+            catch (err) {
+                warnings.push(`${relativePath}: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        };
+        // ── Project files ─────────────────────────────────────────────────────
+        emit("composer.json", "composer", {
+            ...enriched.meta,
+            composerName,
+            namespace,
+        });
+        emit("README.md", "readme", {
+            ...enriched.meta,
+            groups: visibleGroups.map((g) => ({
+                ...g,
+                className: groupClassNames[g.name],
+            })),
+            schemas: enriched.schemas,
+            namespace,
+            hasSSE,
+        });
+        // ── Source files ──────────────────────────────────────────────────────
+        const srcDir = "src";
+        emit(join(srcDir, "Client.php"), "client", {
+            ...enriched.meta,
+            groups: visibleGroups.map((g) => ({
+                ...g,
+                className: groupClassNames[g.name],
+            })),
+            securitySchemes: enriched.securitySchemes ?? [],
+            hasSSE,
+            namespace,
+        });
+        emit(join(srcDir, "Transport.php"), "transport", {
+            ...enriched.meta,
+            securitySchemes: enriched.securitySchemes ?? [],
+            namespace,
+        });
+        emit(join(srcDir, "Errors.php"), "errors", {
+            namespace,
+        });
+        emit(join(srcDir, "Types.php"), "types", {
+            schemas: enriched.schemas,
+            namespace,
+        });
+        // ── Domain files ──────────────────────────────────────────────────────
+        for (const group of visibleGroups) {
+            const imports = collectImports(group.operations, schemaNames);
+            const className = pascalCase(group.fileName);
+            emit(join(srcDir, "Api", `${className}.php`), "domain", {
+                ...group,
+                className,
+                imports,
+                securitySchemes: enriched.securitySchemes ?? [],
+                namespace,
+                hasSSE,
+                // Literal brace characters for PHP path template substitution
+                LBRACE: "{",
+                RBRACE: "}",
+            });
+        }
+        return { files, warnings };
+    }
+    /**
+     * Derives a PSR-4 namespace from a package name.
+     *
+     * Example:
+     *   @acme/pet-store-api  →  Acme\PetStoreApi
+     *   my-org/my-sdk        →  MyOrg\MySdk
+     */
+    _deriveNamespace(packageName) {
+        return packageName
+            .replace(/^@/, "")
+            .split(/[/-]/)
+            .map((s) => s.charAt(0).toUpperCase() + s.slice(1))
+            .join("\\");
+    }
+}
+//# sourceMappingURL=index.js.map