@ir-kit/kit 0.0.0-stage → 1.0.0

package/dist/spec/convert/converters/typespec-emitter.d.ts

@@ -0,0 +1,6 @@
+import { registerConverter } from "../registry.js";
+type Registration = Parameters<typeof registerConverter>[0];
+/** Register a `typespec → to` converter that runs a TypeSpec emitter and returns the files it writes. */
+export declare function registerTypespecEmitter(to: Registration["to"], emitter: string, extra?: Pick<Registration, "authoredInputOnly">): void;
+export {};
+//# sourceMappingURL=typespec-emitter.d.ts.map

package/dist/spec/convert/converters/typespec-emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typespec-emitter.d.ts","sourceRoot":"","sources":["../../../../src/spec/convert/converters/typespec-emitter.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGnD,KAAK,YAAY,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC;AAE5D,yGAAyG;AACzG,wBAAgB,uBAAuB,CACrC,EAAE,EAAE,YAAY,CAAC,IAAI,CAAC,EACtB,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,IAAI,CAAC,YAAY,EAAE,mBAAmB,CAAM,GAClD,IAAI,CAcN"}

package/dist/spec/convert/converters/typespec-emitter.js

@@ -0,0 +1,16 @@
+import { compileTypespecCapture } from "../../typespec/index.js";
+import { registerConverter } from "../registry.js";
+/** Register a `typespec → to` converter that runs a TypeSpec emitter and returns the files it writes. */
+export function registerTypespecEmitter(to, emitter, extra = {}) {
+    registerConverter({
+        from: "typespec",
+        to,
+        ...extra,
+        input: "file",
+        handler: async (path, options) => {
+            const { files } = await compileTypespecCapture({ path }, { cwd: options.cwd, emitter, emitterOptions: options.upstream });
+            return { kind: "files", files };
+        },
+    });
+}
+//# sourceMappingURL=typespec-emitter.js.map

package/dist/spec/convert/converters/typespec-emitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typespec-emitter.js","sourceRoot":"","sources":["../../../../src/spec/convert/converters/typespec-emitter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAKnD,yGAAyG;AACzG,MAAM,UAAU,uBAAuB,CACrC,EAAsB,EACtB,OAAe,EACf,KAAK,GAA4C,EAAE;IAEnD,iBAAiB,CAAC;QAChB,IAAI,EAAE,UAAU;QAChB,EAAE;QACF,GAAG,KAAK;QACR,KAAK,EAAE,MAAM;QACb,OAAO,EAAE,KAAK,EAAE,IAAY,EAAE,OAAO,EAA0B,EAAE;YAC/D,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,sBAAsB,CAC5C,EAAE,IAAI,EAAE,EACR,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,CAAC,QAAQ,EAAE,CAChE,CAAC;YACF,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAClC,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/spec/convert/converters/typespec-to-json-schema.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=typespec-to-json-schema.d.ts.map

package/dist/spec/convert/converters/typespec-to-json-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typespec-to-json-schema.d.ts","sourceRoot":"","sources":["../../../../src/spec/convert/converters/typespec-to-json-schema.ts"],"names":[],"mappings":""}

package/dist/spec/convert/converters/typespec-to-json-schema.js

@@ -0,0 +1,3 @@
+import { registerTypespecEmitter } from "./typespec-emitter.js";
+registerTypespecEmitter("json-schema", "@typespec/json-schema");
+//# sourceMappingURL=typespec-to-json-schema.js.map

package/dist/spec/convert/converters/typespec-to-json-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typespec-to-json-schema.js","sourceRoot":"","sources":["../../../../src/spec/convert/converters/typespec-to-json-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,uBAAuB,CAAC,aAAa,EAAE,uBAAuB,CAAC,CAAC"}

package/dist/spec/convert/converters/typespec-to-openapi3.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=typespec-to-openapi3.d.ts.map

package/dist/spec/convert/converters/typespec-to-openapi3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typespec-to-openapi3.d.ts","sourceRoot":"","sources":["../../../../src/spec/convert/converters/typespec-to-openapi3.ts"],"names":[],"mappings":""}

package/dist/spec/convert/converters/typespec-to-openapi3.js

@@ -0,0 +1,12 @@
+import { compileTypespec } from "../../typespec/index.js";
+import { registerConverter } from "../registry.js";
+registerConverter({
+    from: "typespec",
+    to: "openapi3",
+    input: "file",
+    handler: async (path, options) => {
+        const { document } = await compileTypespec({ path }, { cwd: options.cwd, openapi: options.upstream });
+        return { kind: "document", document: document };
+    },
+});
+//# sourceMappingURL=typespec-to-openapi3.js.map

package/dist/spec/convert/converters/typespec-to-openapi3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typespec-to-openapi3.js","sourceRoot":"","sources":["../../../../src/spec/convert/converters/typespec-to-openapi3.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGnD,iBAAiB,CAAC;IAChB,IAAI,EAAE,UAAU;IAChB,EAAE,EAAE,UAAU;IACd,KAAK,EAAE,MAAM;IACb,OAAO,EAAE,KAAK,EAAE,IAAY,EAAE,OAAO,EAA0B,EAAE;QAC/D,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,eAAe,CACxC,EAAE,IAAI,EAAE,EACR,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,CAChD,CAAC;QACF,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAmC,EAAE,CAAC;IAC7E,CAAC;CACF,CAAC,CAAC"}

package/dist/spec/convert/converters/typespec-to-proto.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=typespec-to-proto.d.ts.map

package/dist/spec/convert/converters/typespec-to-proto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typespec-to-proto.d.ts","sourceRoot":"","sources":["../../../../src/spec/convert/converters/typespec-to-proto.ts"],"names":[],"mappings":""}

package/dist/spec/convert/converters/typespec-to-proto.js

@@ -0,0 +1,5 @@
+import { registerTypespecEmitter } from "./typespec-emitter.js";
+registerTypespecEmitter("proto", "@typespec/protobuf", {
+    authoredInputOnly: true,
+});
+//# sourceMappingURL=typespec-to-proto.js.map

package/dist/spec/convert/converters/typespec-to-proto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typespec-to-proto.js","sourceRoot":"","sources":["../../../../src/spec/convert/converters/typespec-to-proto.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,uBAAuB,CAAC,OAAO,EAAE,oBAAoB,EAAE;IACrD,iBAAiB,EAAE,IAAI;CACxB,CAAC,CAAC"}

package/dist/spec/convert/index.d.ts

@@ -0,0 +1,36 @@
+import "./converters/openapi3-to-json-schema.js";
+import "./converters/openapi3-to-postman.js";
+import "./converters/openapi3-to-proto.js";
+import "./converters/openapi3-to-typespec.js";
+import "./converters/postman-to-openapi3.js";
+import "./converters/proto-to-openapi3.js";
+import "./converters/typespec-to-json-schema.js";
+import "./converters/typespec-to-openapi3.js";
+import "./converters/typespec-to-proto.js";
+import { listConverters } from "./registry.js";
+import type { ConvertHandlerOptions, ConvertOutput, SpecDocument, SpecFormat } from "./types.js";
+export type { ConvertHandlerOptions, ConvertOutput, SpecDocument, SpecFormat };
+export { listConverters };
+export type ConvertSpecInput = string | SpecDocument;
+export interface ConvertSpecOptions {
+    input: ConvertSpecInput;
+    to: SpecFormat;
+    from?: SpecFormat;
+    cwd?: string;
+    upstream?: Record<string, unknown>;
+}
+export interface ConvertSpecResult {
+    from: SpecFormat;
+    to: SpecFormat;
+    output: ConvertOutput;
+}
+/**
+ * Convert between API spec formats. Detects the input format via
+ * `@ir-kit/kit/spec` (override with `from`). Uses a direct
+ * `(from → to)` converter when one is registered; otherwise BFS-routes
+ * through intermediate formats (chains like `proto → openapi3 → postman`
+ * are discovered automatically). Returns either a parsed document, a
+ * source string, or a multi-file map depending on the target.
+ */
+export declare function convertSpec(opts: ConvertSpecOptions): Promise<ConvertSpecResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/spec/convert/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/spec/convert/index.ts"],"names":[],"mappings":"AAgBA,OAAO,yCAAyC,CAAC;AACjD,OAAO,qCAAqC,CAAC;AAC7C,OAAO,mCAAmC,CAAC;AAC3C,OAAO,sCAAsC,CAAC;AAC9C,OAAO,qCAAqC,CAAC;AAC7C,OAAO,mCAAmC,CAAC;AAC3C,OAAO,yCAAyC,CAAC;AACjD,OAAO,sCAAsC,CAAC;AAC9C,OAAO,mCAAmC,CAAC;AAE3C,OAAO,EAGL,cAAc,EACf,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAEV,qBAAqB,EACrB,aAAa,EACb,YAAY,EACZ,UAAU,EACX,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,qBAAqB,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,CAAC;AAE1B,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,YAAY,CAAC;AAErD,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,gBAAgB,CAAC;IACxB,EAAE,EAAE,UAAU,CAAC;IACf,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,UAAU,CAAC;IACjB,EAAE,EAAE,UAAU,CAAC;IACf,MAAM,EAAE,aAAa,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,iBAAiB,CAAC,CAuD5B"}

package/dist/spec/convert/index.js

@@ -0,0 +1,130 @@
+import { mkdtemp, rm, writeFile } from "node:fs/promises";
+import { createRequire } from "node:module";
+import { dirname, extname, join, resolve } from "node:path";
+import { classifySpecDocument, loadSpec, readSpecDocument, } from "../load/index.js";
+const require = createRequire(import.meta.url);
+/** typespec-loader's package dir hosts the @typespec/* peer deps the
+ *  TypeSpec compiler needs to resolve when chaining converters. */
+const typespecLoaderDir = dirname(require.resolve("@ir-kit/kit/package.json"));
+import "./converters/openapi3-to-json-schema.js";
+import "./converters/openapi3-to-postman.js";
+import "./converters/openapi3-to-proto.js";
+import "./converters/openapi3-to-typespec.js";
+import "./converters/postman-to-openapi3.js";
+import "./converters/proto-to-openapi3.js";
+import "./converters/typespec-to-json-schema.js";
+import "./converters/typespec-to-openapi3.js";
+import "./converters/typespec-to-proto.js";
+import { findConverter, findConverterPath, listConverters, } from "./registry.js";
+export { listConverters };
+/**
+ * Convert between API spec formats. Detects the input format via
+ * `@ir-kit/kit/spec` (override with `from`). Uses a direct
+ * `(from → to)` converter when one is registered; otherwise BFS-routes
+ * through intermediate formats (chains like `proto → openapi3 → postman`
+ * are discovered automatically). Returns either a parsed document, a
+ * source string, or a multi-file map depending on the target.
+ */
+export async function convertSpec(opts) {
+    const from = opts.from ?? (await detectFormat(opts.input, opts.cwd));
+    if (from === opts.to) {
+        const document = from === "postman" && typeof opts.input === "string"
+            ? await readSpecDocument(opts.input, opts.cwd)
+            : await readAsDocument(opts.input, opts.cwd);
+        return { from, to: opts.to, output: { kind: "document", document } };
+    }
+    const direct = findConverter(from, opts.to);
+    const path = direct ? [direct] : findConverterPath(from, opts.to);
+    if (!path || path.length === 0) {
+        throw new Error(`No converter path from ${from} to ${opts.to}. ` +
+            `Available edges: ${listConverters()
+                .map((p) => `${p.from}→${p.to}`)
+                .join(", ") || "<none>"}`);
+    }
+    let input = await materializeInput(opts.input, path[0], opts.cwd);
+    let output;
+    let tempDir;
+    try {
+        for (let i = 0; i < path.length; i++) {
+            const edge = path[i];
+            output = await runEdge(edge, input, {
+                cwd: opts.cwd,
+                upstream: opts.upstream,
+            });
+            if (i < path.length - 1) {
+                if (output.kind === "document") {
+                    input = { kind: "document", document: output.document };
+                }
+                else if (output.kind === "source") {
+                    tempDir ??= await mkdtemp(join(typespecLoaderDir, ".ir-spec-convert-"));
+                    const tempPath = join(tempDir, `intermediate-${i}.${output.ext}`);
+                    await writeFile(tempPath, output.source);
+                    input = { kind: "file", path: tempPath };
+                }
+                else {
+                    throw new Error(`Cannot chain through ${edge.to}: intermediate output is '${output.kind}', cannot bridge to next converter`);
+                }
+            }
+        }
+    }
+    finally {
+        if (tempDir)
+            await rm(tempDir, { recursive: true, force: true });
+    }
+    return { from, to: opts.to, output: output };
+}
+async function detectFormat(input, cwd) {
+    if (typeof input === "string") {
+        const ext = extname(input).toLowerCase();
+        if (ext === ".tsp")
+            return "typespec";
+        if (ext === ".proto")
+            return "proto";
+    }
+    const document = typeof input === "object" ? input : await readSpecDocument(input, cwd);
+    if (isPostmanCollection(document))
+        return "postman";
+    const kind = classifySpecDocument(document);
+    if (kind === "asyncapi")
+        return "asyncapi3";
+    if (kind === "openapi")
+        return "openapi3";
+    const label = typeof input === "string" ? ` ${input}` : "";
+    throw new Error(`Unrecognized spec${label}: expected OpenAPI, AsyncAPI, a Postman collection, a .tsp or a .proto file.`);
+}
+function isPostmanCollection(doc) {
+    const info = doc.info;
+    return (typeof info?.schema === "string" &&
+        info.schema.includes("schema.getpostman.com"));
+}
+function runEdge(edge, input, options) {
+    if (edge.input === "file") {
+        if (input.kind !== "file") {
+            throw new Error(`${edge.from}→${edge.to} needs a file input`);
+        }
+        return edge.handler(input.path, options);
+    }
+    if (input.kind !== "document") {
+        throw new Error(`${edge.from}→${edge.to} needs a parsed document`);
+    }
+    return edge.handler(input.document, options);
+}
+async function materializeInput(input, first, cwd) {
+    if (first.input === "file") {
+        if (typeof input !== "string") {
+            throw new Error(`${first.from} input must be a file path`);
+        }
+        return { kind: "file", path: resolve(cwd ?? process.cwd(), input) };
+    }
+    return { kind: "document", document: await readAsDocument(input, cwd) };
+}
+async function readAsDocument(input, cwd) {
+    if (typeof input === "object")
+        return input;
+    const loaded = await loadSpec({ input, cwd });
+    if (loaded.kind === "asyncapi") {
+        return loaded.document.json();
+    }
+    return loaded.document;
+}
+//# sourceMappingURL=index.js.map

package/dist/spec/convert/index.js.map

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

package/dist/spec/convert/registry.d.ts

@@ -0,0 +1,15 @@
+import type { ConverterPair, SpecFormat } from "./types.js";
+export declare function registerConverter(pair: ConverterPair): void;
+export declare function findConverter(from: SpecFormat, to: SpecFormat): ConverterPair | undefined;
+export declare function listConverters(): ReadonlyArray<{
+    from: SpecFormat;
+    to: SpecFormat;
+}>;
+/**
+ * Shortest converter path from `from` to `to`, including direct pairs.
+ * BFS over the registered converter graph; returns `undefined` if no
+ * path exists. Chains let any new (X → openapi3, openapi3 → X) pair
+ * unlock conversions to every other registered format automatically.
+ */
+export declare function findConverterPath(from: SpecFormat, to: SpecFormat): ConverterPair[] | undefined;
+//# sourceMappingURL=registry.d.ts.map

package/dist/spec/convert/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/spec/convert/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAM5D,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAE3D;AAED,wBAAgB,aAAa,CAC3B,IAAI,EAAE,UAAU,EAChB,EAAE,EAAE,UAAU,GACb,aAAa,GAAG,SAAS,CAE3B;AAED,wBAAgB,cAAc,IAAI,aAAa,CAAC;IAC9C,IAAI,EAAE,UAAU,CAAC;IACjB,EAAE,EAAE,UAAU,CAAC;CAChB,CAAC,CAED;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,UAAU,EAChB,EAAE,EAAE,UAAU,GACb,aAAa,EAAE,GAAG,SAAS,CA0B7B"}

package/dist/spec/convert/registry.js

@@ -0,0 +1,45 @@
+const registry = new Map();
+const key = (from, to) => `${from}->${to}`;
+export function registerConverter(pair) {
+    registry.set(key(pair.from, pair.to), pair);
+}
+export function findConverter(from, to) {
+    return registry.get(key(from, to));
+}
+export function listConverters() {
+    return Array.from(registry.values()).map(({ from, to }) => ({ from, to }));
+}
+/**
+ * Shortest converter path from `from` to `to`, including direct pairs.
+ * BFS over the registered converter graph; returns `undefined` if no
+ * path exists. Chains let any new (X → openapi3, openapi3 → X) pair
+ * unlock conversions to every other registered format automatically.
+ */
+export function findConverterPath(from, to) {
+    if (from === to)
+        return [];
+    const adjacency = new Map();
+    for (const pair of registry.values()) {
+        const edges = adjacency.get(pair.from) ?? [];
+        edges.push(pair);
+        adjacency.set(pair.from, edges);
+    }
+    const queue = [{ node: from, path: [] }];
+    const visited = new Set([from]);
+    while (queue.length > 0) {
+        const { node, path } = queue.shift();
+        for (const edge of adjacency.get(node) ?? []) {
+            if (visited.has(edge.to))
+                continue;
+            if (edge.authoredInputOnly && path.length > 0)
+                continue;
+            const next = [...path, edge];
+            if (edge.to === to)
+                return next;
+            visited.add(edge.to);
+            queue.push({ node: edge.to, path: next });
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=registry.js.map

package/dist/spec/convert/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/spec/convert/registry.ts"],"names":[],"mappings":"AAEA,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAyB,CAAC;AAElD,MAAM,GAAG,GAAG,CAAC,IAAgB,EAAE,EAAc,EAAU,EAAE,CAAC,GAAG,IAAI,KAAK,EAAE,EAAE,CAAC;AAE3E,MAAM,UAAU,iBAAiB,CAAC,IAAmB;IACnD,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,IAAgB,EAChB,EAAc;IAEd,OAAO,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,cAAc;IAI5B,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAgB,EAChB,EAAc;IAEd,IAAI,IAAI,KAAK,EAAE;QAAE,OAAO,EAAE,CAAC;IAE3B,MAAM,SAAS,GAAG,IAAI,GAAG,EAA+B,CAAC;IACzD,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAC7C,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjB,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAClC,CAAC;IAGD,MAAM,KAAK,GAAgB,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAa,CAAC,IAAI,CAAC,CAAC,CAAC;IAE5C,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,KAAK,EAAG,CAAC;QACtC,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YAC7C,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAAE,SAAS;YACnC,IAAI,IAAI,CAAC,iBAAiB,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;gBAAE,SAAS;YACxD,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC,CAAC;YAC7B,IAAI,IAAI,CAAC,EAAE,KAAK,EAAE;gBAAE,OAAO,IAAI,CAAC;YAChC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACrB,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/spec/convert/types.d.ts

@@ -0,0 +1,33 @@
+export type SpecFormat = "openapi3" | "asyncapi3" | "typespec" | "proto" | "postman" | "json-schema";
+export type SpecDocument = Record<string, unknown>;
+export type ConvertOutput = {
+    kind: "document";
+    document: SpecDocument;
+} | {
+    kind: "source";
+    source: string;
+    ext: string;
+} | {
+    kind: "files";
+    files: Record<string, string>;
+};
+export interface ConvertHandlerOptions {
+    cwd?: string;
+    upstream?: Record<string, unknown>;
+}
+interface ConverterEdge {
+    from: SpecFormat;
+    to: SpecFormat;
+    /** The edge only accepts input written for it (e.g. TypeSpec using the protobuf library), so routes may start with it but never pass through it. */
+    authoredInputOnly?: boolean;
+}
+/** A converter reads either a parsed document or, for source formats like `.tsp` and `.proto`, a file path. */
+export type ConverterPair = ConverterEdge & ({
+    input?: "document";
+    handler: (document: SpecDocument, options: ConvertHandlerOptions) => Promise<ConvertOutput>;
+} | {
+    input: "file";
+    handler: (path: string, options: ConvertHandlerOptions) => Promise<ConvertOutput>;
+});
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/spec/convert/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/spec/convert/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAClB,UAAU,GACV,WAAW,GACX,UAAU,GACV,OAAO,GACP,SAAS,GACT,aAAa,CAAC;AAElB,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEnD,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,YAAY,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC;AAErD,MAAM,WAAW,qBAAqB;IACpC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,UAAU,aAAa;IACrB,IAAI,EAAE,UAAU,CAAC;IACjB,EAAE,EAAE,UAAU,CAAC;IACf,oJAAoJ;IACpJ,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,+GAA+G;AAC/G,MAAM,MAAM,aAAa,GAAG,aAAa,GACvC,CACI;IACE,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,CACP,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,qBAAqB,KAC3B,OAAO,CAAC,aAAa,CAAC,CAAC;CAC7B,GACD;IACE,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,CACP,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,qBAAqB,KAC3B,OAAO,CAAC,aAAa,CAAC,CAAC;CAC7B,CACJ,CAAC"}

package/dist/spec/convert/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/spec/convert/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/spec/convert/types.ts"],"names":[],"mappings":""}

package/dist/spec/diff/index.d.ts

@@ -0,0 +1,38 @@
+import { type Diff } from "api-smart-diff";
+import type { ConvertSpecInput, SpecDocument, SpecFormat } from "../convert/index.js";
+export type { Diff };
+export type DiffType = "breaking" | "non-breaking" | "annotation" | "unclassified" | "deprecated";
+export interface DiffSummary {
+    total: number;
+    breaking: number;
+    nonBreaking: number;
+    annotation: number;
+    unclassified: number;
+    deprecated: number;
+}
+export interface DiffSpecsOptions {
+    before: ConvertSpecInput;
+    after: ConvertSpecInput;
+    fromBefore?: SpecFormat;
+    fromAfter?: SpecFormat;
+    cwd?: string;
+}
+export interface DiffSpecsResult {
+    diffs: Diff[];
+    summary: DiffSummary;
+    before: {
+        from: SpecFormat;
+        openapi: SpecDocument;
+    };
+    after: {
+        from: SpecFormat;
+        openapi: SpecDocument;
+    };
+}
+/**
+ * Cross-family API spec diff. Converts both inputs to OpenAPI 3 via
+ * `@ir-kit/kit/spec`, then runs `api-smart-diff`'s `compareOpenApi`.
+ * Returns the raw diff list plus a breaking/non-breaking summary.
+ */
+export declare function diffSpecs(opts: DiffSpecsOptions): Promise<DiffSpecsResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/spec/diff/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/spec/diff/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,EACV,gBAAgB,EAChB,YAAY,EACZ,UAAU,EACX,MAAM,qBAAqB,CAAC;AAG7B,YAAY,EAAE,IAAI,EAAE,CAAC;AAErB,MAAM,MAAM,QAAQ,GAChB,UAAU,GACV,cAAc,GACd,YAAY,GACZ,cAAc,GACd,YAAY,CAAC;AAEjB,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,gBAAgB,CAAC;IACzB,KAAK,EAAE,gBAAgB,CAAC;IACxB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,SAAS,CAAC,EAAE,UAAU,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,OAAO,EAAE,WAAW,CAAC;IACrB,MAAM,EAAE;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,OAAO,EAAE,YAAY,CAAA;KAAE,CAAC;IACpD,KAAK,EAAE;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,OAAO,EAAE,YAAY,CAAA;KAAE,CAAC;CACpD;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAC7B,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,eAAe,CAAC,CAc1B"}

package/dist/spec/diff/index.js

@@ -0,0 +1,58 @@
+import { compareOpenApi } from "api-smart-diff";
+import { convertSpec } from "../convert/index.js";
+/**
+ * Cross-family API spec diff. Converts both inputs to OpenAPI 3 via
+ * `@ir-kit/kit/spec`, then runs `api-smart-diff`'s `compareOpenApi`.
+ * Returns the raw diff list plus a breaking/non-breaking summary.
+ */
+export async function diffSpecs(opts) {
+    const [before, after] = await Promise.all([
+        normalizeToOpenApi(opts.before, opts.fromBefore, opts.cwd),
+        normalizeToOpenApi(opts.after, opts.fromAfter, opts.cwd),
+    ]);
+    const { diffs } = compareOpenApi(before.openapi, after.openapi);
+    return {
+        diffs,
+        summary: summarize(diffs),
+        before,
+        after,
+    };
+}
+async function normalizeToOpenApi(input, from, cwd) {
+    const result = await convertSpec({ input, from, to: "openapi3", cwd });
+    if (result.output.kind !== "document") {
+        throw new Error(`Unexpected converter output kind '${result.output.kind}' for openapi3 target`);
+    }
+    return { from: result.from, openapi: result.output.document };
+}
+function summarize(diffs) {
+    const summary = {
+        total: diffs.length,
+        breaking: 0,
+        nonBreaking: 0,
+        annotation: 0,
+        unclassified: 0,
+        deprecated: 0,
+    };
+    for (const diff of diffs) {
+        switch (diff.type) {
+            case "breaking":
+                summary.breaking++;
+                break;
+            case "non-breaking":
+                summary.nonBreaking++;
+                break;
+            case "annotation":
+                summary.annotation++;
+                break;
+            case "unclassified":
+                summary.unclassified++;
+                break;
+            case "deprecated":
+                summary.deprecated++;
+                break;
+        }
+    }
+    return summary;
+}
+//# sourceMappingURL=index.js.map

package/dist/spec/diff/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/spec/diff/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAa,MAAM,gBAAgB,CAAC;AAM3D,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAmClD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,IAAsB;IAEtB,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACxC,kBAAkB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC;QAC1D,kBAAkB,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC;KACzD,CAAC,CAAC;IAEH,MAAM,EAAE,KAAK,EAAE,GAAG,cAAc,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAEhE,OAAO;QACL,KAAK;QACL,OAAO,EAAE,SAAS,CAAC,KAAK,CAAC;QACzB,MAAM;QACN,KAAK;KACN,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,kBAAkB,CAC/B,KAAuB,EACvB,IAA4B,EAC5B,GAAuB;IAEvB,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;IACvE,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CACb,qCAAqC,MAAM,CAAC,MAAM,CAAC,IAAI,uBAAuB,CAC/E,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;AAChE,CAAC;AAED,SAAS,SAAS,CAAC,KAAa;IAC9B,MAAM,OAAO,GAAgB;QAC3B,KAAK,EAAE,KAAK,CAAC,MAAM;QACnB,QAAQ,EAAE,CAAC;QACX,WAAW,EAAE,CAAC;QACd,UAAU,EAAE,CAAC;QACb,YAAY,EAAE,CAAC;QACf,UAAU,EAAE,CAAC;KACd,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,KAAK,UAAU;gBACb,OAAO,CAAC,QAAQ,EAAE,CAAC;gBACnB,MAAM;YACR,KAAK,cAAc;gBACjB,OAAO,CAAC,WAAW,EAAE,CAAC;gBACtB,MAAM;YACR,KAAK,YAAY;gBACf,OAAO,CAAC,UAAU,EAAE,CAAC;gBACrB,MAAM;YACR,KAAK,cAAc;gBACjB,OAAO,CAAC,YAAY,EAAE,CAAC;gBACvB,MAAM;YACR,KAAK,YAAY;gBACf,OAAO,CAAC,UAAU,EAAE,CAAC;gBACrB,MAAM;QACV,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/spec/docs/index.d.ts

@@ -0,0 +1,23 @@
+import type { ConvertSpecInput, SpecDocument, SpecFormat } from "../convert/index.js";
+export type DocsTheme = "default" | "alternate" | "moon" | "purple" | "solarized" | "bluePlanet" | "saturn" | "kepler" | "mars" | "deepSpace" | "none";
+export interface RenderDocsOptions {
+    input: ConvertSpecInput;
+    from?: SpecFormat;
+    cwd?: string;
+    theme?: DocsTheme;
+    /** Extra Scalar configuration merged into the HTML render. */
+    scalar?: Record<string, unknown>;
+}
+export interface RenderDocsResult {
+    html: string;
+    openapi: SpecDocument;
+    from: SpecFormat;
+}
+/**
+ * Render any supported spec format as a standalone HTML page via
+ * Scalar API Reference. Converts to OpenAPI 3 first (if needed), then
+ * delegates HTML emission to `@scalar/core` — same renderer used by
+ * the official Express/Hono/Fastify integrations.
+ */
+export declare function renderDocs(opts: RenderDocsOptions): Promise<RenderDocsResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/spec/docs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/spec/docs/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAChB,YAAY,EACZ,UAAU,EACX,MAAM,qBAAqB,CAAC;AAG7B,MAAM,MAAM,SAAS,GACjB,SAAS,GACT,WAAW,GACX,MAAM,GACN,QAAQ,GACR,WAAW,GACX,YAAY,GACZ,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,WAAW,GACX,MAAM,CAAC;AAEX,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,gBAAgB,CAAC;IACxB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;IACtB,IAAI,EAAE,UAAU,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,gBAAgB,CAAC,CAmB3B"}

package/dist/spec/docs/index.js

@@ -0,0 +1,27 @@
+import { getHtmlDocument } from "@scalar/core/libs/html-rendering";
+import { convertSpec } from "../convert/index.js";
+/**
+ * Render any supported spec format as a standalone HTML page via
+ * Scalar API Reference. Converts to OpenAPI 3 first (if needed), then
+ * delegates HTML emission to `@scalar/core` — same renderer used by
+ * the official Express/Hono/Fastify integrations.
+ */
+export async function renderDocs(opts) {
+    const result = await convertSpec({
+        input: opts.input,
+        from: opts.from,
+        to: "openapi3",
+        cwd: opts.cwd,
+    });
+    if (result.output.kind !== "document") {
+        throw new Error(`Unexpected converter output kind '${result.output.kind}' for openapi3 target`);
+    }
+    const openapi = result.output.document;
+    const html = getHtmlDocument({
+        content: openapi,
+        ...(opts.theme ? { theme: opts.theme } : {}),
+        ...opts.scalar,
+    });
+    return { html, openapi, from: result.from };
+}
+//# sourceMappingURL=index.js.map

package/dist/spec/docs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/spec/docs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAMnE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AA8BlD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,IAAuB;IAEvB,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC;QAC/B,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,EAAE,EAAE,UAAU;QACd,GAAG,EAAE,IAAI,CAAC,GAAG;KACd,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CACb,qCAAqC,MAAM,CAAC,MAAM,CAAC,IAAI,uBAAuB,CAC/E,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC;IACvC,MAAM,IAAI,GAAG,eAAe,CAAC;QAC3B,OAAO,EAAE,OAAO;QAChB,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5C,GAAG,IAAI,CAAC,MAAM;KACf,CAAC,CAAC;IACH,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;AAC9C,CAAC"}

package/dist/spec/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./convert/index.js";
+export * from "./diff/index.js";
+export * from "./docs/index.js";
+export * from "./load/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/spec/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/spec/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC"}

package/dist/spec/index.js

@@ -0,0 +1,5 @@
+export * from "./convert/index.js";
+export * from "./diff/index.js";
+export * from "./docs/index.js";
+export * from "./load/index.js";
+//# sourceMappingURL=index.js.map

package/dist/spec/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/spec/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC"}

package/dist/spec/load/index.d.ts

@@ -0,0 +1,33 @@
+import type { AsyncAPIDocumentInterface } from "@asyncapi/parser";
+import { type AsyncAPIInput, type LoadAsyncAPIOptions, loadAsyncAPI } from "../asyncapi/index.js";
+import { type LoadOpenAPIOptions, loadOpenAPI, type OpenAPIInput, readSpecDocument, resolveOpenAPIInput } from "../openapi/index.js";
+import { type CompileTypespecOptions, compileTypespec, isTypespecPath } from "../typespec/index.js";
+export type { AsyncAPIInput, LoadAsyncAPIOptions, LoadOpenAPIOptions, OpenAPIInput, };
+export { compileTypespec, isTypespecPath, loadAsyncAPI, loadOpenAPI, readSpecDocument, resolveOpenAPIInput, };
+export type SpecKind = "openapi" | "asyncapi" | "typespec";
+export type SpecInput = string | Record<string, unknown> | AsyncAPIDocumentInterface;
+export interface LoadSpecOptions extends CompileTypespecOptions {
+    input: SpecInput;
+    /** Force the spec kind, skipping detection. Useful when the file
+     *  extension is ambiguous (e.g. `api.json` that's actually AsyncAPI). */
+    kind?: SpecKind;
+    /** Forwarded to `loadOpenAPI` (and to TypeSpec after compile). */
+    normalize?: LoadOpenAPIOptions["normalize"];
+}
+export type LoadSpecResult = {
+    kind: "openapi";
+    document: Record<string, unknown>;
+} | {
+    kind: "asyncapi";
+    document: AsyncAPIDocumentInterface;
+};
+/**
+ * Detect the spec format and dispatch to the matching per-format loader.
+ * TypeSpec inputs compile to OpenAPI 3 in-memory and return as
+ * `{ kind: "openapi" }`. Pre-parsed objects are kept as-is and
+ * classified by the `asyncapi` / `openapi` / `swagger` top-level key.
+ */
+export declare function loadSpec(opts: LoadSpecOptions): Promise<LoadSpecResult>;
+/** Classify a parsed document by its root version field. */
+export declare function classifySpecDocument(document: Record<string, unknown>): "openapi" | "asyncapi" | undefined;
+//# sourceMappingURL=index.d.ts.map