@ir-kit/openapi-ts-orpc 0.1.0

package/dist/generators/contract-validator.js

@@ -0,0 +1,250 @@
+/**
+ * Standard validator API contract builders.
+ * Works with any hey-api validator plugin (zod, valibot, arktype)
+ * that exposes the `createRequestSchema` API.
+ */
+import { $ } from "@hey-api/openapi-ts";
+import { operationResponsesMap } from "@hey-api/shared";
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/** Classify the body media-type so callers don't pass loose booleans. */
+export function classifyBody(mediaType) {
+    switch (mediaType) {
+        case "application/json":
+            return "json";
+        case "application/octet-stream":
+            return "raw-file";
+        case "multipart/form-data":
+            return "multipart";
+        default:
+            return "other";
+    }
+}
+/** Build a validator-backed `.input()` expression for a contract. */
+export function buildValidatorInput(plugin, operation, bodyKind) {
+    const validatorName = plugin.config.validator.input;
+    if (!validatorName)
+        return null;
+    const requestSchema = callCreateRequestSchema(plugin, validatorName, operation, bodyKind);
+    // Typia validators are Symbol references to pre-emitted `createValidate<T>()`
+    // calls with the full request shape baked into the TS type argument. Body
+    // kind-specific patching (e.g. replacing a body property with `z.file()`)
+    // doesn't apply — the TS type already models File/Blob where appropriate.
+    if (validatorName === "@ir-kit/openapi-ts-typia") {
+        return requestSchema
+            ? { expr: requestSchema, useDetailedMode: true }
+            : null;
+    }
+    switch (bodyKind) {
+        case "raw-file":
+            return patchRawFileBody(plugin, validatorName, operation, requestSchema);
+        case "multipart":
+            return patchMultipartBody(plugin, validatorName, operation, requestSchema);
+        default:
+            return requestSchema
+                ? { expr: requestSchema, useDetailedMode: true }
+                : null;
+    }
+}
+export function buildValidatorOutput(plugin, operationId) {
+    const validatorName = plugin.config.validator.output;
+    if (!validatorName)
+        return null;
+    // Typia plugin emits a flattened `role: 'response'` symbol per operation.
+    // Zod/valibot/arktype emit the unflattened `role: 'responses'`.
+    const role = validatorName === "@ir-kit/openapi-ts-typia" ? "response" : "responses";
+    return plugin.referenceSymbol({
+        category: "schema",
+        resource: "operation",
+        resourceId: operationId,
+        role,
+        tool: validatorName,
+    });
+}
+export function buildValidatorErrorMap(plugin, operation) {
+    const validatorName = plugin.config.validator.input;
+    if (!validatorName)
+        return null;
+    return validatorName === "@ir-kit/openapi-ts-typia"
+        ? buildTypiaErrorMap(plugin, operation)
+        : buildComponentErrorMap(plugin, validatorName, operation);
+}
+/**
+ * Typia plugin emits one `error-<code>` validator per error status per
+ * operation (no per-$ref symbols). Look up each status's symbol and
+ * assemble `.errors({ 404: { data: tFooError404 }, ... })`.
+ */
+function buildTypiaErrorMap(plugin, operation) {
+    const responses = operation.responses;
+    if (!responses)
+        return null;
+    let errorMapObj = $.object().pretty();
+    let hasErrors = false;
+    for (const statusCode in responses) {
+        const status = Number.parseInt(statusCode, 10);
+        if (!Number.isFinite(status))
+            continue;
+        if (status < 400 || status > 599)
+            continue;
+        const errorSymbol = plugin.querySymbol({
+            category: "schema",
+            resource: "operation",
+            resourceId: operation.id,
+            role: `error-${status}`,
+            tool: "@ir-kit/openapi-ts-typia",
+        });
+        if (!errorSymbol)
+            continue;
+        errorMapObj = errorMapObj.prop(statusCode, $.object().prop("data", $(errorSymbol)));
+        hasErrors = true;
+    }
+    return hasErrors ? errorMapObj : null;
+}
+/**
+ * Standard validators (zod/valibot/arktype) emit per-component symbols
+ * at each `$ref`. Map each error response to its component symbol.
+ */
+function buildComponentErrorMap(plugin, validatorName, operation) {
+    const { errors: errorsSchema } = operationResponsesMap(operation);
+    if (!errorsSchema?.properties)
+        return null;
+    let errorMapObj = $.object().pretty();
+    let hasErrors = false;
+    for (const statusCode in errorsSchema.properties) {
+        const errorResponseSchema = errorsSchema.properties[statusCode];
+        if (!errorResponseSchema?.$ref)
+            continue;
+        const errorSchema = plugin.querySymbol({
+            resource: "definition",
+            resourceId: errorResponseSchema.$ref,
+            tool: validatorName,
+        });
+        if (errorSchema) {
+            errorMapObj = errorMapObj.prop(statusCode, $.object().prop("data", $(errorSchema)));
+            hasErrors = true;
+        }
+    }
+    return hasErrors ? errorMapObj : null;
+}
+// ---------------------------------------------------------------------------
+// createRequestSchema wrapper
+// ---------------------------------------------------------------------------
+/**
+ * Call the validator plugin's `createRequestSchema` API when available.
+ * For raw-file bodies the body layer is skipped (replaced later with z.file()).
+ * For multipart the body layer is kept so field names are preserved.
+ */
+function callCreateRequestSchema(plugin, validatorName, operation, bodyKind) {
+    const validatorPlugin = plugin.getPlugin(validatorName);
+    const api = validatorPlugin?.api;
+    if (!api || !("createRequestSchema" in api))
+        return null;
+    return api.createRequestSchema({
+        layers: {
+            body: bodyKind === "raw-file" ? false : { whenEmpty: "omit" },
+            headers: { whenEmpty: "omit" },
+            path: { whenEmpty: "omit", as: "params" },
+            query: { whenEmpty: "omit" },
+        },
+        operation,
+        plugin: validatorPlugin,
+    });
+}
+// ---------------------------------------------------------------------------
+// File schema helpers
+// ---------------------------------------------------------------------------
+/**
+ * Produce the validator-native file schema expression oRPC can detect.
+ *
+ *   zod v4  → z.file()          (native)
+ *   zod v3  → oz.file()         (@orpc/zod)
+ *   valibot → v.file()          (native)
+ *
+ * Returns null for unknown validators.
+ */
+function fileSchemaExpr(plugin, validatorName) {
+    if (validatorName === "zod") {
+        const zodPlugin = plugin.getPlugin("zod");
+        const compat = zodPlugin?.config?.compatibilityVersion;
+        if (compat === 4) {
+            return $(plugin.external("zod.z")).attr("file").call();
+        }
+        return $(plugin.external("@orpc/zod.oz")).attr("file").call();
+    }
+    if (validatorName === "valibot") {
+        return $(plugin.external("valibot.*")).attr("file").call();
+    }
+    return null;
+}
+/** Wrap a file expression with `.optional()` when the field isn't required. */
+function optionalFile(fileExpr, required) {
+    return required ? fileExpr : fileExpr.attr("optional").call();
+}
+// ---------------------------------------------------------------------------
+// Body patching strategies
+// ---------------------------------------------------------------------------
+/**
+ * application/octet-stream — body IS the file.
+ * Replace the entire body layer with z.file() / oz.file().
+ */
+function patchRawFileBody(plugin, validatorName, operation, requestSchema) {
+    const file = fileSchemaExpr(plugin, validatorName);
+    if (!file)
+        return null;
+    const body = optionalFile(file, !!operation.body?.required);
+    if (requestSchema) {
+        return {
+            expr: $(requestSchema).attr("extend").call($.object().prop("body", body)),
+            useDetailedMode: true,
+        };
+    }
+    // createRequestSchema unavailable — compact mode with just the file.
+    return { expr: body, useDetailedMode: false };
+}
+/**
+ * multipart/form-data — body is an object with named fields.
+ * Only the `format: "binary"` properties are patched to z.file();
+ * every other field and the object wrapper are preserved.
+ */
+function patchMultipartBody(plugin, validatorName, operation, requestSchema) {
+    if (!requestSchema)
+        return null;
+    const bodyProps = operation.body?.schema?.properties;
+    if (!bodyProps)
+        return { expr: requestSchema, useDetailedMode: true };
+    const file = fileSchemaExpr(plugin, validatorName);
+    if (!file)
+        return { expr: requestSchema, useDetailedMode: true };
+    // Build an .extend() object with only the binary fields replaced.
+    const requiredFields = operation.body?.schema?.required;
+    let overrides = $.object();
+    let count = 0;
+    for (const [name, schema] of Object.entries(bodyProps)) {
+        if (schema.format !== "binary")
+            continue;
+        const isRequired = Array.isArray(requiredFields) && requiredFields.includes(name);
+        overrides = overrides.prop(name, optionalFile(file, isRequired));
+        count++;
+    }
+    if (count === 0)
+        return { expr: requestSchema, useDetailedMode: true };
+    // Reference the body schema symbol, then .extend() only the binary fields.
+    const bodySym = plugin.referenceSymbol({
+        category: "schema",
+        resource: "operation",
+        resourceId: operation.id,
+        role: "request-body",
+        tool: validatorName,
+    });
+    if (!bodySym)
+        return { expr: requestSchema, useDetailedMode: true };
+    const patchedBody = $(bodySym).attr("extend").call(overrides);
+    return {
+        expr: $(requestSchema)
+            .attr("extend")
+            .call($.object().prop("body", patchedBody)),
+        useDetailedMode: true,
+    };
+}
+//# sourceMappingURL=contract-validator.js.map

package/dist/generators/contract-validator.js.map

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

package/dist/generators/contract.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Generates oRPC contracts from OpenAPI operations.
+ * Input/output schemas come from the configured validator plugin via its
+ * standard `createRequestSchema` / symbol-lookup API — identical code path
+ * for zod, valibot, arktype, and typia.
+ */
+import type { ContractGeneratorInput, ContractGeneratorOutput } from "./types";
+export declare const generateContracts: ({ contractFile, plugin, }: ContractGeneratorInput) => ContractGeneratorOutput;
+//# sourceMappingURL=contract.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/generators/contract.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAeH,OAAO,KAAK,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAE/E,eAAO,MAAM,iBAAiB,GAAI,2BAG/B,sBAAsB,KAAG,uBA6K3B,CAAC"}

package/dist/generators/contract.js

@@ -0,0 +1,159 @@
+/**
+ * Generates oRPC contracts from OpenAPI operations.
+ * Input/output schemas come from the configured validator plugin via its
+ * standard `createRequestSchema` / symbol-lookup API — identical code path
+ * for zod, valibot, arktype, and typia.
+ */
+import { $ } from "@hey-api/openapi-ts";
+import { escapeComment } from "@hey-api/shared";
+import { getGroupKey } from "../router-organizer";
+import { contractName as toContractName } from "../utils";
+import { buildValidatorErrorMap, buildValidatorInput, buildValidatorOutput, classifyBody, } from "./contract-validator";
+export const generateContracts = ({ contractFile, plugin, }) => {
+    const routerStructure = new Map();
+    const oc = plugin.external("@orpc/contract.oc");
+    const { input: inputValidator, output: outputValidator } = plugin.config.validator;
+    plugin.forEach("operation", (event) => {
+        const { operation } = event;
+        if (!operation.id)
+            return;
+        const operationId = operation.id;
+        const method = operation.method.toUpperCase();
+        const path = operation.path;
+        const contractName = `${toContractName(operationId, plugin.config.naming.contract)}Contract`;
+        const hasInput = !!operation.body || !!operation.parameters;
+        let hasOutput = false;
+        if (operation.responses) {
+            for (const [statusCode, response] of Object.entries(operation.responses)) {
+                const code = Number.parseInt(statusCode, 10);
+                if (code >= 200 &&
+                    code <= 399 &&
+                    response?.mediaType &&
+                    response?.schema) {
+                    hasOutput = true;
+                    break;
+                }
+            }
+        }
+        let successStatus;
+        let successDescription;
+        if (operation.responses) {
+            const pathItem = plugin.context.spec.paths?.[operation.path];
+            const openApiOperation = pathItem?.[operation.method];
+            const responses = openApiOperation?.responses;
+            for (const statusCode in operation.responses) {
+                const numericStatus = Number.parseInt(statusCode, 10);
+                if (numericStatus >= 200 && numericStatus < 300) {
+                    successStatus = numericStatus;
+                    if (responses) {
+                        const response = responses[statusCode];
+                        if (response && "$ref" in response) {
+                            const resolved = plugin.context.resolveRef(response.$ref);
+                            successDescription = resolved?.description;
+                        }
+                        else if (response && "description" in response) {
+                            successDescription = response.description;
+                        }
+                    }
+                }
+            }
+        }
+        const groupMode = plugin.config.group;
+        const groupKey = getGroupKey(operation, groupMode);
+        const contractFilePath = groupMode === "flat"
+            ? contractFile
+            : `${plugin.name}/${groupKey}/contract`;
+        const symbol = plugin.symbol(contractName, {
+            getFilePath: () => contractFilePath,
+            meta: {
+                category: "contract",
+                resource: "operation",
+                resourceId: operationId,
+                tool: "orpc",
+            },
+        });
+        let routeObj = $.object()
+            .pretty()
+            .prop("method", $.literal(method))
+            .prop("path", $.literal(path));
+        if (operation.operationId)
+            routeObj = routeObj.prop("operationId", $.literal(operation.operationId));
+        if (operation.summary)
+            routeObj = routeObj.prop("summary", $.literal(operation.summary));
+        if (operation.description)
+            routeObj = routeObj.prop("description", $.literal(operation.description));
+        if (operation.deprecated)
+            routeObj = routeObj.prop("deprecated", $.literal(true));
+        if (operation.tags)
+            routeObj = routeObj.prop("tags", $.fromValue([...new Set(operation.tags)]));
+        if (successStatus !== undefined)
+            routeObj = routeObj.prop("successStatus", $.literal(successStatus));
+        if (successDescription)
+            routeObj = routeObj.prop("successDescription", $.literal(successDescription));
+        const mode = plugin.config.mode;
+        const isGetOrDelete = operation.method === "get" || operation.method === "delete";
+        const hasBody = !!(operation.body && !isGetOrDelete);
+        const bodyKind = hasBody
+            ? classifyBody(operation.body?.mediaType)
+            : "other";
+        let useDetailedMode = mode === "detailed";
+        let inputExpr;
+        if (hasInput && inputValidator) {
+            const result = buildValidatorInput(plugin, operation, bodyKind);
+            if (result) {
+                inputExpr = result.expr;
+                useDetailedMode = result.useDetailedMode;
+            }
+        }
+        if (useDetailedMode && hasInput) {
+            routeObj = routeObj.prop("inputStructure", $.literal("detailed"));
+        }
+        let contractExpr = $(oc).attr("route").call(routeObj);
+        if (inputExpr)
+            contractExpr = contractExpr.attr("input").call(inputExpr);
+        if (hasOutput && outputValidator) {
+            const outputExpr = buildValidatorOutput(plugin, operationId);
+            if (outputExpr)
+                contractExpr = contractExpr.attr("output").call(outputExpr);
+        }
+        if (inputValidator) {
+            const errorMap = buildValidatorErrorMap(plugin, operation);
+            if (errorMap)
+                contractExpr = contractExpr.attr("errors").call(errorMap);
+        }
+        const comment = plugin.config.comments
+            ? createOperationComment(operation)
+            : undefined;
+        plugin.node($.const(symbol)
+            .export()
+            .$if(comment, (n, v) => n.doc(v))
+            .assign(contractExpr));
+        const operationName = operation.operationId || operationId;
+        if (!routerStructure.has(groupKey))
+            routerStructure.set(groupKey, []);
+        routerStructure.get(groupKey).push({
+            contractName,
+            contractSymbol: symbol,
+            operation,
+            operationName,
+        });
+    }, { order: "declarations" });
+    return { routerStructure };
+};
+function createOperationComment(operation) {
+    const comments = [];
+    if (operation.summary)
+        comments.push(escapeComment(operation.summary));
+    if (operation.description) {
+        if (comments.length)
+            comments.push("");
+        comments.push(escapeComment(operation.description));
+    }
+    if (operation.deprecated) {
+        if (comments.length)
+            comments.push("");
+        comments.push("@deprecated");
+    }
+    return comments.length ? comments : undefined;
+}
+//# sourceMappingURL=contract.js.map

package/dist/generators/contract.js.map

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

package/dist/generators/faker.d.ts

@@ -0,0 +1,15 @@
+import { type ResponseSchemaInfo } from "@ir-kit/openapi-ts-faker/core";
+import type { RouterNode } from "../router-organizer";
+import type { FakerHandlerConfig } from "../types";
+import type { GeneratorContext } from "./types";
+export interface FakerGeneratorInput {
+    plugin: GeneratorContext["plugin"];
+    routerStructure: Map<string, RouterNode[]>;
+    responseSchemas: Map<string, ResponseSchemaInfo>;
+    config?: FakerHandlerConfig;
+}
+export interface FakerGeneratorOutput {
+    factoryNames: Map<string, string>;
+}
+export declare const generateFakerFactories: ({ plugin, routerStructure, responseSchemas, config, }: FakerGeneratorInput) => FakerGeneratorOutput;
+//# sourceMappingURL=faker.d.ts.map

package/dist/generators/faker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"faker.d.ts","sourceRoot":"","sources":["../../src/generators/faker.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAEnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACnC,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;IAC3C,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IACjD,MAAM,CAAC,EAAE,kBAAkB,CAAC;CAC7B;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAmBD,eAAO,MAAM,sBAAsB,GAAI,uDAKpC,mBAAmB,KAAG,oBAgDxB,CAAC"}

package/dist/generators/faker.js

@@ -0,0 +1,61 @@
+import { $ } from "@hey-api/openapi-ts";
+import { buildFakerExpression, } from "@ir-kit/openapi-ts-faker/core";
+import { operationName } from "../utils";
+/**
+ * Match the faker plugin's hint-key normalization (case- and separator-
+ * insensitive) so users can write `firstName`, `first_name`, `FirstName`, etc.
+ * The faker plugin does this in its `resolveConfig` hook; we apply it here
+ * because we feed the lib directly without going through that hook.
+ */
+const normalizeFieldNameHints = (hints) => {
+    if (!hints)
+        return undefined;
+    const out = {};
+    for (const [key, value] of Object.entries(hints)) {
+        out[key.toLowerCase().replace(/[_-]/g, "")] = value;
+    }
+    return out;
+};
+export const generateFakerFactories = ({ plugin, routerStructure, responseSchemas, config, }) => {
+    const faker = plugin.external("@faker-js/faker.faker");
+    const factoryNames = new Map();
+    const buildOpts = {
+        fieldHints: normalizeFieldNameHints(config?.fieldNameHints),
+        formatHints: config?.formatMapping,
+        respectConstraints: config?.respectConstraints ?? true,
+    };
+    for (const [group, nodes] of routerStructure) {
+        const fakerFile = `${plugin.name}/${group}/faker.gen`;
+        for (const node of nodes) {
+            const opName = operationName(node.operationName);
+            const schema = responseSchemas.get(opName);
+            const factoryName = `mock${opName.charAt(0).toUpperCase()}${opName.slice(1)}`;
+            const symbol = plugin.symbol(factoryName, {
+                getFilePath: () => fakerFile,
+                meta: {
+                    category: "faker",
+                    resource: "factory",
+                    resourceId: opName,
+                    tool: "orpc",
+                },
+            });
+            factoryNames.set(opName, factoryName);
+            let bodyExpr;
+            if (schema && Object.keys(schema.properties).length > 0) {
+                let obj = $.object().pretty();
+                for (const [key, info] of Object.entries(schema.properties)) {
+                    obj = obj.prop(key, buildFakerExpression(faker, info, buildOpts));
+                }
+                bodyExpr = obj;
+            }
+            else {
+                bodyExpr = $.object();
+            }
+            const factoryFn = $.func().do($.return(bodyExpr));
+            const statement = $.const(symbol).export().assign(factoryFn);
+            plugin.node(statement);
+        }
+    }
+    return { factoryNames };
+};
+//# sourceMappingURL=faker.js.map

package/dist/generators/faker.js.map

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

package/dist/generators/handlers/ast.d.ts

@@ -0,0 +1,65 @@
+/**
+ * TypeScript AST builders for handler file generation.
+ * Constructs import declarations, handler property assignments, and
+ * complete handler file ASTs using the TypeScript compiler API.
+ */
+import ts from "typescript";
+import type { HandlerMode, ProxyHandlerConfig } from "../../types";
+export type { PropertyInfo, ResponseSchemaInfo, } from "@ir-kit/openapi-ts-faker/core";
+export interface FileGenContext {
+    tag: string;
+    procedures: string[];
+    implementer: {
+        name: string;
+        from: string;
+    };
+    mode: HandlerMode;
+    clientName: string;
+    proxyConfig?: ProxyHandlerConfig;
+    fakerFactoryNames?: Map<string, string>;
+    fakerGenImport?: string;
+}
+/** Returns a safe variable/export name — appends `Handlers` when tag is reserved. */
+export declare function safeVarName(tag: string): string;
+export declare function makeImport(names: string[], from: string): ts.ImportDeclaration;
+interface HandlerPropertyOpts {
+    tag: string;
+    procedure: string;
+    implementerName: string;
+    mode: HandlerMode;
+    clientName: string;
+    factoryName?: string;
+}
+export declare function makeHandlerProperty({ tag, procedure, implementerName, mode, clientName, factoryName, }: HandlerPropertyOpts): ts.PropertyAssignment;
+export declare function getImports(ctx: FileGenContext): ts.ImportDeclaration[];
+/**
+ * Generates a complete handler file.
+ * The full source file is constructed as a TypeScript AST and printed with
+ * `ts.createPrinter` — no template strings involved.
+ */
+export declare function buildFile(ctx: FileGenContext): string;
+export interface HandlerObjectInfo {
+    /** Property names already declared in the handler object. */
+    existingNames: Set<string>;
+    /**
+     * Character position of the closing `}` of the handler object literal.
+     * New properties are inserted just before this position.
+     */
+    closingBracePos: number;
+}
+/**
+ * Parses the source file and locates the top-level handler object
+ * (`const <tag> = { ... }`), returning the existing property names
+ * and the insertion position for new properties.
+ */
+export declare function analyzeHandlerFile(source: string, varName: string): HandlerObjectInfo | null;
+/**
+ * Inserts missing procedure stubs into an existing handler file.
+ *
+ * Detection is AST-based (TypeScript compiler API) — property names are
+ * extracted from the parsed object literal, not by string search.
+ * The original file content is preserved for all existing code; only the
+ * new stubs are spliced in at the exact character position of the closing `}`.
+ */
+export declare function patchFile(source: string, ctx: FileGenContext, missing: string[]): string;
+//# sourceMappingURL=ast.d.ts.map

package/dist/generators/handlers/ast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast.d.ts","sourceRoot":"","sources":["../../../src/generators/handlers/ast.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEnE,YAAY,EACV,YAAY,EACZ,kBAAkB,GACnB,MAAM,+BAA+B,CAAC;AAMvC,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,IAAI,EAAE,WAAW,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,iBAAiB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAuDD,qFAAqF;AACrF,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AAoBD,wBAAgB,UAAU,CACxB,KAAK,EAAE,MAAM,EAAE,EACf,IAAI,EAAE,MAAM,GACX,EAAE,CAAC,iBAAiB,CAmBtB;AAkDD,UAAU,mBAAmB;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,WAAW,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,mBAAmB,CAAC,EAClC,GAAG,EACH,SAAS,EACT,eAAe,EACf,IAAI,EACJ,UAAU,EACV,WAAW,GACZ,EAAE,mBAAmB,GAAG,EAAE,CAAC,kBAAkB,CA8D7C;AAMD,wBAAgB,UAAU,CAAC,GAAG,EAAE,cAAc,GAAG,EAAE,CAAC,iBAAiB,EAAE,CA6BtE;AAMD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,CAuCrD;AAMD,MAAM,WAAW,iBAAiB;IAChC,6DAA6D;IAC7D,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B;;;OAGG;IACH,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,iBAAiB,GAAG,IAAI,CA8B1B;AAgDD;;;;;;;GAOG;AACH,wBAAgB,SAAS,CACvB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,cAAc,EACnB,OAAO,EAAE,MAAM,EAAE,GAChB,MAAM,CAaR"}