@kubb/adapter-oas 5.14.5 → 5.15.0

package/dist/index.d.cts

@@ -1,5 +1,4 @@
 import { AdapterFactoryOptions, ast } from "@kubb/kit";
-//#region ../../node_modules/.pnpm/@types+json-schema@7.0.15/node_modules/@types/json-schema/index.d.ts
 // ==================================================================================================
 // JSON Schema Draft 04
 // ==================================================================================================
@@ -596,8 +595,6 @@ interface JSONSchema7 {
   writeOnly?: boolean | undefined;
   examples?: JSONSchema7Type | undefined;
 }
-//#endregion
-//#region ../../node_modules/.pnpm/openapi-types@12.1.3/node_modules/openapi-types/dist/index.d.ts
 declare namespace OpenAPIV3_1 {
   type Modify<T, R> = Omit<T, keyof R> & R;
   type PathsWebhooksComponents<T extends {} = {}> = {
@@ -1053,8 +1050,6 @@ declare namespace OpenAPIV3 {
     externalDocs?: ExternalDocumentationObject;
   }
 }
-//#endregion
-//#region src/types.d.ts
 /**
  * Media type used to pick a schema from an operation's request or response.
  *
@@ -1254,8 +1249,6 @@ type AdapterOasResolvedOptions = {
  * `@kubb/core` adapter factory type for the OpenAPI adapter.
  */
 type AdapterOas = AdapterFactoryOptions<'oas', AdapterOasOptions, AdapterOasResolvedOptions, Document>;
-//#endregion
-//#region src/adapter.d.ts
 /**
  * The `name` of `@kubb/adapter-oas`, used to identify this adapter in a Kubb config.
  */
@@ -1288,8 +1281,6 @@ export declare const adapterOasName = "oas";
  * ```
  */
 export declare const adapterOas: import("@kubb/core").AdapterFactory<AdapterOas>;
-//#endregion
-//#region src/operation.d.ts
 /**
  * A single OpenAPI operation: its path, method, raw operation object and resolved path item.
  */
@@ -1299,6 +1290,5 @@ type Operation = {
   schema: OperationObject$1;
   pathItem: PathItemObject$1;
 };
-//#endregion
 export type { AdapterOas, AdapterOasOptions, AdapterOasResolvedOptions, ContentType, DiscriminatorObject$1 as DiscriminatorObject, Document, MediaTypeObject$1 as MediaTypeObject, Operation, ReferenceObject$1 as ReferenceObject, ResponseObject$1 as ResponseObject, SchemaObject$1 as SchemaObject };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.ts

@@ -1,5 +1,4 @@
 import { AdapterFactoryOptions, ast } from "@kubb/kit";
-//#region ../../node_modules/.pnpm/@types+json-schema@7.0.15/node_modules/@types/json-schema/index.d.ts
 // ==================================================================================================
 // JSON Schema Draft 04
 // ==================================================================================================
@@ -596,8 +595,6 @@ interface JSONSchema7 {
   writeOnly?: boolean | undefined;
   examples?: JSONSchema7Type | undefined;
 }
-//#endregion
-//#region ../../node_modules/.pnpm/openapi-types@12.1.3/node_modules/openapi-types/dist/index.d.ts
 declare namespace OpenAPIV3_1 {
   type Modify<T, R> = Omit<T, keyof R> & R;
   type PathsWebhooksComponents<T extends {} = {}> = {
@@ -1053,8 +1050,6 @@ declare namespace OpenAPIV3 {
     externalDocs?: ExternalDocumentationObject;
   }
 }
-//#endregion
-//#region src/types.d.ts
 /**
  * Media type used to pick a schema from an operation's request or response.
  *
@@ -1254,8 +1249,6 @@ type AdapterOasResolvedOptions = {
  * `@kubb/core` adapter factory type for the OpenAPI adapter.
  */
 type AdapterOas = AdapterFactoryOptions<'oas', AdapterOasOptions, AdapterOasResolvedOptions, Document>;
-//#endregion
-//#region src/adapter.d.ts
 /**
  * The `name` of `@kubb/adapter-oas`, used to identify this adapter in a Kubb config.
  */
@@ -1288,8 +1281,6 @@ export declare const adapterOasName = "oas";
  * ```
  */
 export declare const adapterOas: import("@kubb/core").AdapterFactory<AdapterOas>;
-//#endregion
-//#region src/operation.d.ts
 /**
  * A single OpenAPI operation: its path, method, raw operation object and resolved path item.
  */
@@ -1299,6 +1290,5 @@ type Operation = {
   schema: OperationObject$1;
   pathItem: PathItemObject$1;
 };
-//#endregion
 export type { AdapterOas, AdapterOasOptions, AdapterOasResolvedOptions, ContentType, DiscriminatorObject$1 as DiscriminatorObject, Document, MediaTypeObject$1 as MediaTypeObject, Operation, ReferenceObject$1 as ReferenceObject, ResponseObject$1 as ResponseObject, SchemaObject$1 as SchemaObject };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -7,23 +7,20 @@ import { bundle } from "api-ref-bundler";
 import { CORE_SCHEMA, load } from "js-yaml";
 import * as yaml from "yaml";
 import { parse } from "yaml";
-//#region \0rolldown/runtime.js
+// \0rolldown/runtime.js
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", {
 	value,
 	configurable: true
 });
-//#endregion
-//#region kubb-extension.json
+// kubb-extension.json
 var compatibility = {
 	"kubb": ">=5.8.3",
 	"node": ">=22.22"
 };
-//#endregion
-//#region package.json
-var version = "5.14.5";
-//#endregion
-//#region src/constants.ts
+// package.json
+var version = "5.15.0";
+// src/constants.ts
 /**
 * Default parser options applied when no explicit options are provided.
 */
@@ -147,8 +144,7 @@ const enumExtensionKeys = ["x-enumNames", "x-enum-varnames"];
 * Vendor extension keys that attach human-readable descriptions to enum values, checked in priority order.
 */
 const enumDescriptionKeys = ["x-enumDescriptions", "x-enum-descriptions"];
-//#endregion
-//#region src/emit/discriminator/propagate.ts
+// src/emit/discriminator/propagate.ts
 /**
 * Maps each child schema name to its discriminator patch data by scanning the given
 * top-level AST schema nodes for union schemas that carry a `discriminatorPropertyName`.
@@ -231,8 +227,7 @@ function patchDiscriminatorNode(node, entry) {
 		members: newMembers
 	};
 }
-//#endregion
-//#region ../../internals/utils/src/casing.ts
+// ../../internals/utils/src/casing.ts
 /**
 * Shared implementation for camelCase and PascalCase conversion.
 * Splits on common word boundaries (spaces, hyphens, underscores, dots, slashes, colons)
@@ -247,7 +242,7 @@ function convert(text, pascal) {
 	}).join("").replace(/[^a-zA-Z0-9]/g, "");
 }
 const cache = /* @__PURE__ */ new Map();
-const cacheLimit = 1e4;
+const cacheLimit = 1e5;
 function toCamelOrPascal(text, pascal) {
 	const key = `${pascal ? "P" : "c"}${text}`;
 	const cached = cache.get(key);
@@ -269,8 +264,7 @@ function toCamelOrPascal(text, pascal) {
 function pascalCase(text, { prefix = "", suffix = "" } = {}) {
 	return toCamelOrPascal(`${prefix} ${text} ${suffix}`, true);
 }
-//#endregion
-//#region ../../internals/utils/src/errors.ts
+// ../../internals/utils/src/errors.ts
 /**
 * Coerces an unknown thrown value to an `Error` instance.
 * Returns the value as-is when it is already an `Error`; otherwise wraps it with `String(value)`.
@@ -297,8 +291,7 @@ function toError(value) {
 function getErrorMessage(value) {
 	return value instanceof Error ? value.message : String(value);
 }
-//#endregion
-//#region ../../internals/utils/src/jsonPointer.ts
+// ../../internals/utils/src/jsonPointer.ts
 /**
 * Escapes a single JSON pointer reference token per RFC 6901 (`~` → `~0`, `/` → `~1`), so a
 * name holding those characters maps to a distinct pointer.
@@ -311,8 +304,7 @@ function getErrorMessage(value) {
 function escapePointerToken(token) {
 	return token.replaceAll("~", "~0").replaceAll("/", "~1");
 }
-//#endregion
-//#region ../../internals/utils/src/runtime.ts
+// ../../internals/utils/src/runtime.ts
 const isBun = typeof Bun !== "undefined";
 const isDeno = "Deno" in globalThis;
 /**
@@ -341,8 +333,7 @@ function detect() {
 		version: process.versions?.node ?? ""
 	};
 }
-//#endregion
-//#region ../../internals/utils/src/fs.ts
+// ../../internals/utils/src/fs.ts
 /**
 * Resolves to `true` when the file or directory at `path` exists.
 * Uses `Bun.file().exists()` when running under Bun, `fs.access` otherwise.
@@ -371,8 +362,7 @@ async function read(path) {
 	if (runtime.isBun) return Bun.file(path).text();
 	return readFile(path, { encoding: "utf8" });
 }
-//#endregion
-//#region src/oas.ts
+// src/oas.ts
 /**
 * Returns `true` when a schema should be treated as nullable.
 *
@@ -455,8 +445,7 @@ const jsonMimeFragments = [
 function isJsonMimeType(mimeType) {
 	return jsonMimeFragments.some((fragment) => mimeType.includes(fragment));
 }
-//#endregion
-//#region src/refs.ts
+// src/refs.ts
 /**
 * Creates the `$ref` resolution service for one document. One pointer walk backs every method.
 *
@@ -563,8 +552,7 @@ function createRefs(document) {
 		derefKeepingRef
 	};
 }
-//#endregion
-//#region src/load/source.ts
+// src/load/source.ts
 const urlRegExp = /^https?:\/+/i;
 /**
 * Node reports every connection failure as `TypeError: fetch failed` and keeps the useful part
@@ -668,8 +656,7 @@ async function assertInputExists(input) {
 		location: { kind: "config" }
 	});
 }
-//#endregion
-//#region src/load/normalize.ts
+// src/load/normalize.ts
 /**
 * True when `node` contains a `$ref` pointing outside the current document (a relative path,
 * absolute path, or URL). An internal `#/...` fragment does not count.
@@ -699,6 +686,30 @@ function inlinePathRefs(node, resolve, visiting = []) {
 	for (const [key, value] of Object.entries(node)) node[key] = inlinePathRefs(value, resolve, visiting);
 	return node;
 }
+const namedEntryKeys = /* @__PURE__ */ new Set([
+	"properties",
+	"patternProperties",
+	"headers",
+	"schemas",
+	"responses",
+	"parameters",
+	"requestBodies",
+	"examples",
+	"links",
+	"callbacks",
+	"securitySchemes",
+	"securityDefinitions",
+	"pathItems",
+	"definitions",
+	"$defs"
+]);
+/**
+* True when `path` runs through an `x-` vendor extension. Kubb never reads an extension, so a `$ref`
+* Kubb cannot read inside one cannot change the output.
+*/
+function isExtensionPath(path) {
+	return path.some((token, index) => String(token).startsWith("x-") && !namedEntryKeys.has(String(path[index - 1])));
+}
 /**
 * Bundles a multi-file OpenAPI document into a single document via `api-ref-bundler`.
 *
@@ -714,7 +725,7 @@ function inlinePathRefs(node, resolve, visiting = []) {
 *
 * `document` stands in for the file at `pathOrUrl`, such as inline input. Every other file or URL
 * read, including one that fails, lands in `sources`. A `$ref` that cannot be read reports
-* `KUBB_REF_NOT_FOUND` at the key that holds it.
+* `KUBB_REF_NOT_FOUND` at the key that holds it, as a warning when it sits inside an `x-` extension.
 *
 * @example Local file
 * `const document = await bundleDocument('./openapi.yaml')`
@@ -741,7 +752,7 @@ async function bundleDocument(pathOrUrl, { document, sources = [] } = {}) {
 		const pointer = toKey(state.baseFile) === toKey(pathOrUrl) ? `#/${path.map((token) => escapePointerToken(String(token))).join("/")}` : void 0;
 		const diagnostic = {
 			code: Diagnostics.code.refNotFound,
-			severity: "error",
+			severity: isExtensionPath(path) ? "warning" : "error",
 			message: `Could not bundle an external \`$ref\`. ${message}.`,
 			help: "Check that the file or URL the `$ref` points at exists and is readable, or fix the `$ref`.",
 			...pointer && { location: {
@@ -749,7 +760,7 @@ async function bundleDocument(pathOrUrl, { document, sources = [] } = {}) {
 				pointer
 			} }
 		};
-		if (!Diagnostics.report(diagnostic)) throw new Diagnostics.Error(diagnostic);
+		if (!Diagnostics.report(diagnostic) && diagnostic.severity === "error") throw new Diagnostics.Error(diagnostic);
 	} } });
 }
 const inlineInputName = "<inline input>";
@@ -891,8 +902,7 @@ async function validateDocumentInWorker(document) {
 	if ("thrown" in message) return reportInvalidSpec(message.thrown);
 	if (!message.valid) reportValidationErrors(message);
 }
-//#endregion
-//#region src/model/components.ts
+// src/model/components.ts
 /**
 * Extracts the inline schema from a media-type `content` map, with the media type it sits under.
 *
@@ -1094,8 +1104,7 @@ function getSchemas(document, { contentType }, refs) {
 		pointers
 	};
 }
-//#endregion
-//#region src/model/server.ts
+// src/model/server.ts
 /**
 * Reads the server URL from the document's `servers` array at `server.index`,
 * interpolating any `server.variables` into the URL template.
@@ -1147,8 +1156,7 @@ function resolveServerUrl(server, overrides) {
 	}
 	return url;
 }
-//#endregion
-//#region src/emit/schemaShape.ts
+// src/emit/schemaShape.ts
 /**
 * Whether `format` maps to a dedicated type; `false` is what `KUBB_UNSUPPORTED_FORMAT` flags.
 */
@@ -1201,8 +1209,7 @@ function flattenSchema(schema) {
 	for (const fragment of allOfFragments) for (const [key, value] of Object.entries(fragment)) merged[key] ??= value;
 	return merged;
 }
-//#endregion
-//#region src/schemaDiagnostics.ts
+// src/schemaDiagnostics.ts
 /**
 * Links one freshly converted schema and its nested schemas to their RFC 6901 pointers
 * (`#/components/schemas/Pet/properties/owner/properties/name`), and reports the advisory
@@ -1256,8 +1263,7 @@ function visit(node, pointer) {
 		for (const [index, member] of (node.members ?? []).entries()) visit(member, `${pointer}/${keyword}/${index}`);
 	}
 }
-//#endregion
-//#region src/operation.ts
+// src/operation.ts
 function slugify(value) {
 	return value.replace(/[^a-zA-Z0-9]/g, "-").replace(/-{2,}/g, "-").replace(/^-|-$/g, "");
 }
@@ -1526,8 +1532,7 @@ function parseOperation({ operation, ...ctx }) {
 		extensions: pickExtensions(operation.schema)
 	});
 }
-//#endregion
-//#region src/emit/createNode.ts
+// src/emit/createNode.ts
 /**
 * Builds a schema node from a converter's base context plus its type-specific fields. Every
 * converter needs the same metadata fields (`title`, `description`, `examples`, ...) alongside
@@ -1548,8 +1553,7 @@ function createNode({ schema, name, nullable, defaultValue }, extras) {
 		...extras
 	});
 }
-//#endregion
-//#region src/emit/discriminator/preserve.ts
+// src/emit/discriminator/preserve.ts
 /**
 * Turns string mapping keys into the discriminator property's type when they parse cleanly.
 */
@@ -1785,8 +1789,7 @@ function extractDiscriminatedAllOfMembers({ allOfMembers, name, refs }) {
 		discriminantValues
 	};
 }
-//#endregion
-//#region src/emit/converters/annotatedEnum.ts
+// src/emit/converters/annotatedEnum.ts
 const ANNOTATIONS = /* @__PURE__ */ new Set([
 	"title",
 	"description",
@@ -1852,8 +1855,7 @@ function convertAnnotatedEnum(context) {
 		namedEnumValues
 	});
 }
-//#endregion
-//#region src/emit/converters/composition.ts
+// src/emit/converters/composition.ts
 /**
 * Collects property schemas from all `allOf` members and outer schema properties,
 * recursively resolving `$ref` pointers.
@@ -2189,8 +2191,7 @@ function convertMultiType({ schema, name, nullable, defaultValue, parse }) {
 		})
 	});
 }
-//#endregion
-//#region src/emit/converters/scalar.ts
+// src/emit/converters/scalar.ts
 /**
 * Normalizes malformed `{ type: 'array', enum: [...] }` schemas by moving enum values into items.
 *
@@ -2366,8 +2367,7 @@ function convertNumeric(context, type) {
 		...getNumericConstraints(context.schema)
 	});
 }
-//#endregion
-//#region src/emit/converters/structural.ts
+// src/emit/converters/structural.ts
 /**
 * Resolves a `true` or empty-object map schema (`additionalProperties`/`patternProperties`) to
 * `options.unknownType`, otherwise parses it as a regular schema.
@@ -2398,8 +2398,9 @@ function nameEnums(node, options) {
 * Converts an object-like schema into an `ObjectSchemaNode`.
 */
 function convertObject({ schema, name, nullable, defaultValue, options, parse, refs }) {
+	const requiredNames = Array.isArray(schema.required) ? new Set(schema.required) : void 0;
 	const properties = schema.properties ? Object.entries(schema.properties).map(([propName, propSchema]) => {
-		const required = Array.isArray(schema.required) ? schema.required.includes(propName) : !!schema.required;
+		const required = requiredNames ? requiredNames.has(propName) : !!schema.required;
 		const resolvedPropSchema = propSchema;
 		const propNullable = isNullable(resolvedPropSchema);
 		const schemaNode = nameEnums(parse({
@@ -2518,8 +2519,7 @@ function convertArray({ schema, name, nullable, defaultValue, options, parse })
 		unique: schema.uniqueItems ?? void 0
 	});
 }
-//#endregion
-//#region src/emit/parseSchema.ts
+// src/emit/parseSchema.ts
 /**
 * Ordered schema rule table. Order is significant: composition keywords (`not`, `$ref`, `allOf`,
 * `oneOf`/`anyOf`) take precedence over `const` (except a `$ref` with a sibling `const`, where the
@@ -2620,8 +2620,7 @@ const schemaRules = [
 		convert: ({ schema, name, nullable }) => createNullNode(schema, name, nullable)
 	}
 ];
-//#endregion
-//#region src/parser.ts
+// src/parser.ts
 /**
 * Creates the schema converter bound to one OpenAPI document: `parseSchema` dispatches each
 * schema through the ordered `schemaRules` table, with the parser options merged once.
@@ -2658,8 +2657,7 @@ function createSchemaParser(ctx) {
 	}
 	return parseSchema;
 }
-//#endregion
-//#region src/promoteEnums.ts
+// src/promoteEnums.ts
 /**
 * Collects inline enums to lift to the top level, keyed by the name the parser derived for them
 * (e.g. `PetStatusEnum`). An enum already defined as a top-level component is left as-is, and a
@@ -2705,8 +2703,7 @@ function refPromotedEnums(node, promoted) {
 		});
 	} });
 }
-//#endregion
-//#region src/sourceLocator.ts
+// src/sourceLocator.ts
 let cached;
 const toRange = ([start, end]) => ({
 	start,
@@ -2864,8 +2861,7 @@ const locate = (source, location) => {
 	const { document } = cached;
 	return findPointer(document, location.pointer) ?? (ref ? findRefUsage(document, ref) : void 0);
 };
-//#endregion
-//#region src/adapter.ts
+// src/adapter.ts
 /**
 * The `name` of `@kubb/adapter-oas`, used to identify this adapter in a Kubb config.
 */
@@ -3110,7 +3106,6 @@ const adapterOas = defineExtension({
 		};
 	}
 });
-//#endregion
 export { adapterOas, adapterOasName };
 
 //# sourceMappingURL=index.js.map