@hey-api/shared 0.4.3 → 0.4.5

package/dist/index.mjs

@@ -968,17 +968,13 @@ function deduplicateSchema({ detectFormat = true, schema }) {
 		}
 		uniqueItems.push(item);
 	}
-	let result = { ...schema };
-	result.items = uniqueItems;
-	if (result.items.length <= 1 && result.type !== "array" && result.type !== "enum" && result.type !== "tuple") {
-		const liftedSchema = result.items[0];
-		delete result.logicalOperator;
-		delete result.items;
-		result = {
-			...result,
-			...liftedSchema
-		};
-	}
+	const result = { ...schema };
+	if (uniqueItems.length <= 1 && result.type !== "array" && result.type !== "enum" && result.type !== "tuple") {
+		const liftedSchema = uniqueItems[0];
+		result.items = void 0;
+		result.logicalOperator = void 0;
+		Object.assign(result, liftedSchema);
+	} else result.items = uniqueItems;
 	if (result.type === "unknown") return {};
 	return result;
 }
@@ -1000,10 +996,7 @@ function addItemsToSchema({ items, logicalOperator = "or", mutateSchemaOneItem =
 		return schema;
 	}
 	if (mutateSchemaOneItem) {
-		schema = {
-			...schema,
-			...items[0]
-		};
+		Object.assign(schema, items[0]);
 		return schema;
 	}
 	schema.items = items;
@@ -1694,6 +1687,14 @@ const irTopLevelKinds = [
 	"server",
 	"webhook"
 ];
+const irPatterns = {
+	operation: /^#\/paths\/[^/]+\/(get|put|post|delete|options|head|patch|trace)$/,
+	parameter: /^#\/components\/parameters\/[^/]+$/,
+	requestBody: /^#\/components\/requestBodies\/[^/]+$/,
+	schema: /^#\/components\/schemas\/[^/]+$/,
+	server: /^#\/servers\/(\d+|[^/]+)$/,
+	webhook: /^#\/webhooks\/[^/]+\/(get|put|post|delete|options|head|patch|trace)$/
+};
 /**
 * Checks if a pointer matches a known top-level IR component (schema, parameter, etc) and returns match info.
 *
@@ -1702,25 +1703,14 @@ const irTopLevelKinds = [
 * @returns { matched: true, kind: IrTopLevelKind } | { matched: false } - Whether it matched, and the matched kind if so
 */
 const matchIrPointerToGroup = (pointer, kind) => {
-	const patterns = {
-		operation: /^#\/paths\/[^/]+\/(get|put|post|delete|options|head|patch|trace)$/,
-		parameter: /^#\/components\/parameters\/[^/]+$/,
-		requestBody: /^#\/components\/requestBodies\/[^/]+$/,
-		schema: /^#\/components\/schemas\/[^/]+$/,
-		server: /^#\/servers\/(\d+|[^/]+)$/,
-		webhook: /^#\/webhooks\/[^/]+\/(get|put|post|delete|options|head|patch|trace)$/
-	};
-	if (kind) return patterns[kind].test(pointer) ? {
+	if (kind) return irPatterns[kind].test(pointer) ? {
 		kind,
 		matched: true
 	} : { matched: false };
-	for (const key of Object.keys(patterns)) {
-		const kind = key;
-		if (patterns[kind].test(pointer)) return {
-			kind,
-			matched: true
-		};
-	}
+	for (const key of irTopLevelKinds) if (irPatterns[key].test(pointer)) return {
+		kind: key,
+		matched: true
+	};
 	return { matched: false };
 };
 const preferGroups = [
@@ -1786,6 +1776,7 @@ function jsonPointerToPath(pointer) {
 	if (clean.startsWith("#")) clean = clean.slice(1);
 	if (clean.startsWith("/")) clean = clean.slice(1);
 	if (!clean) return [];
+	if (!clean.includes("~")) return clean.split("/");
 	return clean.split("/").map((part) => part.replaceAll("~1", "/").replaceAll("~0", "~"));
 }
 /**
@@ -1830,9 +1821,21 @@ function pathToJsonPointer(path) {
 * @returns true if the ref points to a top-level component, false otherwise
 */
 function isTopLevelComponent(refOrPath) {
-	const path = refOrPath instanceof Array ? refOrPath : jsonPointerToPath(refOrPath);
-	if (path[0] === "components") return path.length === 3;
-	if (path[0] === "definitions") return path.length === 2;
+	if (typeof refOrPath !== "string") {
+		if (refOrPath[0] === "components") return refOrPath.length === 3;
+		if (refOrPath[0] === "definitions") return refOrPath.length === 2;
+		return false;
+	}
+	if (refOrPath.startsWith("#/components/")) {
+		const typeEnd = refOrPath.indexOf("/", 13);
+		if (typeEnd === -1) return false;
+		const nameStart = typeEnd + 1;
+		return nameStart < refOrPath.length && refOrPath.indexOf("/", nameStart) === -1;
+	}
+	if (refOrPath.startsWith("#/definitions/")) {
+		const nameStart = 14;
+		return nameStart < refOrPath.length && refOrPath.indexOf("/", nameStart) === -1;
+	}
 	return false;
 }
 function resolveRef({ $ref, spec }) {
@@ -1988,6 +1991,15 @@ var PluginInstance = class {
 			}
 		}, options);
 	}
+	getHooks(selector, ...customHooks) {
+		const result = [];
+		for (const hook of customHooks) if (hook) result.push(hook);
+		const local = selector(this.config["~hooks"] ?? {});
+		if (local) result.push(local);
+		const global = selector(this.context.config.parser.hooks);
+		if (global) result.push(global);
+		return result;
+	}
 	/**
 	* Retrieves a registered plugin instance by its name from the context. This
 	* allows plugins to access other plugins that have been registered in the
@@ -2048,7 +2060,10 @@ var PluginInstance = class {
 		return result;
 	}
 	querySymbol(filter) {
-		return this.gen.symbols.query(filter)[0];
+		return this.querySymbols(filter)[0];
+	}
+	querySymbols(filter) {
+		return this.gen.symbols.query(filter);
 	}
 	referenceSymbol(meta) {
 		return this.gen.symbols.reference(meta);
@@ -2072,7 +2087,7 @@ var PluginInstance = class {
 		if (symbol.external) {
 			if (!meta.category) meta.category = "external";
 			if (!meta.resource) meta.resource = `${symbol.external}.${name}`;
-			const existing = this.gen.symbols.query(meta).find((s) => s.name === name);
+			const existing = this.querySymbols(meta).find((s) => s.name === name);
 			if (existing) return existing;
 		}
 		const symbolIn = {
@@ -2104,7 +2119,7 @@ var PluginInstance = class {
 	symbolOnce(name, symbol = {}) {
 		if (symbol.external) return this.symbol(name, symbol);
 		if (symbol.meta) {
-			const existing = this.gen.symbols.query(symbol.meta).find((s) => s.name === name);
+			const existing = this.querySymbols(symbol.meta).find((s) => s.name === name);
 			if (existing) return existing;
 		}
 		return this.symbol(name, symbol);
@@ -2136,9 +2151,8 @@ var PluginInstance = class {
 		});
 	}
 	getSymbolExportFromFilePath(symbol) {
-		const hooks = [this.config["~hooks"]?.symbols, this.context.config.parser.hooks.symbols];
-		for (const hook of hooks) {
-			const result = hook?.getExportFromFilePath?.(symbol);
+		for (const hook of this.getHooks((hooks) => hooks.symbols?.getExportFromFilePath)) {
+			const result = hook(symbol);
 			if (result !== void 0) return result;
 		}
 		const entryFile = this.context.config.output.indexFile ?? this.context.config.output.entryFile;
@@ -2152,9 +2166,8 @@ var PluginInstance = class {
 		return [moduleEntryName];
 	}
 	getSymbolFilePath(symbol) {
-		const hooks = [this.config["~hooks"]?.symbols, this.context.config.parser.hooks.symbols];
-		for (const hook of hooks) {
-			const result = hook?.getFilePath?.(symbol);
+		for (const hook of this.getHooks((hooks) => hooks.symbols?.getFilePath)) {
+			const result = hook(symbol);
 			if (result !== void 0) return result;
 		}
 		return defaultGetFilePath(symbol);
@@ -2404,8 +2417,8 @@ function visitTyped(schema, ctx, visitor, walk) {
 */
 function childContext(ctx, ...segments) {
 	return {
-		...ctx,
-		path: ref([...fromRef(ctx.path), ...segments])
+		path: ref([...fromRef(ctx.path), ...segments]),
+		plugin: ctx.plugin
 	};
 }
 //#endregion
@@ -3332,42 +3345,37 @@ const annotateChildScopes = (nodes) => {
 * Recursively collects all $ref dependencies in the subtree rooted at `pointer`.
 */
 const collectPointerDependencies = ({ cache, graph, pointer, visited }) => {
-	const cached = cache.transitiveDependencies.get(pointer);
-	if (cached) return {
-		subtreeDependencies: cache.subtreeDependencies.get(pointer),
-		transitiveDependencies: cached
+	if (cache.transitiveDependencies.has(pointer)) return {
+		subtreeDependencies: cache.subtreeDependencies.get(pointer) ?? null,
+		transitiveDependencies: cache.transitiveDependencies.get(pointer) ?? null
 	};
 	if (visited.has(pointer)) return {
-		subtreeDependencies: /* @__PURE__ */ new Set(),
-		transitiveDependencies: /* @__PURE__ */ new Set()
+		subtreeDependencies: null,
+		transitiveDependencies: null
 	};
 	visited.add(pointer);
 	if (!graph.nodes.get(pointer)) return {
-		subtreeDependencies: /* @__PURE__ */ new Set(),
-		transitiveDependencies: /* @__PURE__ */ new Set()
+		subtreeDependencies: null,
+		transitiveDependencies: null
 	};
-	const transitiveDependencies = /* @__PURE__ */ new Set();
-	const subtreeDependencies = /* @__PURE__ */ new Set();
+	let transitiveDependencies = null;
+	let subtreeDependencies = null;
 	const nodeDependencies = graph.nodeDependencies.get(pointer);
 	if (nodeDependencies) for (const depPointer of nodeDependencies) {
-		transitiveDependencies.add(depPointer);
-		subtreeDependencies.add(depPointer);
+		(transitiveDependencies ??= /* @__PURE__ */ new Set()).add(depPointer);
+		(subtreeDependencies ??= /* @__PURE__ */ new Set()).add(depPointer);
 		const depResult = collectPointerDependencies({
 			cache,
 			graph,
 			pointer: depPointer,
 			visited
 		});
-		for (const dependency of depResult.transitiveDependencies) transitiveDependencies.add(dependency);
+		if (depResult.transitiveDependencies) for (const dependency of depResult.transitiveDependencies) transitiveDependencies.add(dependency);
 	}
 	const children = cache.parentToChildren.get(pointer) ?? [];
 	for (const childPointer of children) {
-		let childResult = {
-			subtreeDependencies: cache.subtreeDependencies.get(childPointer),
-			transitiveDependencies: cache.transitiveDependencies.get(childPointer)
-		};
-		if (!childResult.subtreeDependencies || !childResult.transitiveDependencies) {
-			childResult = collectPointerDependencies({
+		if (!cache.transitiveDependencies.has(childPointer)) {
+			const childResult = collectPointerDependencies({
 				cache,
 				graph,
 				pointer: childPointer,
@@ -3376,8 +3384,10 @@ const collectPointerDependencies = ({ cache, graph, pointer, visited }) => {
 			cache.transitiveDependencies.set(childPointer, childResult.transitiveDependencies);
 			cache.subtreeDependencies.set(childPointer, childResult.subtreeDependencies);
 		}
-		for (const dependency of childResult.transitiveDependencies) transitiveDependencies.add(dependency);
-		for (const dependency of childResult.subtreeDependencies) subtreeDependencies.add(dependency);
+		const childTransitive = cache.transitiveDependencies.get(childPointer) ?? null;
+		const childSubtree = cache.subtreeDependencies.get(childPointer) ?? null;
+		if (childTransitive) for (const dependency of childTransitive) (transitiveDependencies ??= /* @__PURE__ */ new Set()).add(dependency);
+		if (childSubtree) for (const dependency of childSubtree) (subtreeDependencies ??= /* @__PURE__ */ new Set()).add(dependency);
 	}
 	cache.transitiveDependencies.set(pointer, transitiveDependencies);
 	cache.subtreeDependencies.set(pointer, subtreeDependencies);
@@ -3535,8 +3545,8 @@ function buildGraph(root, logger) {
 			pointer,
 			visited: /* @__PURE__ */ new Set()
 		});
-		graph.transitiveDependencies.set(pointer, result.transitiveDependencies);
-		graph.subtreeDependencies.set(pointer, result.subtreeDependencies);
+		if (result.transitiveDependencies) graph.transitiveDependencies.set(pointer, result.transitiveDependencies);
+		if (result.subtreeDependencies) graph.subtreeDependencies.set(pointer, result.subtreeDependencies);
 	}
 	eventBuildGraph.timeEnd();
 	return { graph };
@@ -4302,7 +4312,7 @@ const convertDiscriminatorValue = (value, propertyType) => {
 			};
 		}
 		case "integer": {
-			const parsed = parseInt(value, 10);
+			const parsed = Number.parseInt(value, 10);
 			if (Number.isNaN(parsed)) {
 				console.warn("🚨", `non-numeric discriminator mapping value "${value}" for integer property, falling back to string`);
 				return {
@@ -4343,7 +4353,7 @@ const discriminatorValues = ($ref, mapping, shouldUseRefAsValue) => {
 };
 //#endregion
 //#region src/openApi/2.0.x/parser/schema.ts
-function getSchemaType$1({ schema }) {
+function getSchemaType$1(schema) {
 	if (schema.type) return schema.type;
 	if (schema.properties) return "object";
 }
@@ -4382,10 +4392,7 @@ function parseArray$2({ context, irSchema = {}, schema, state }) {
 		else if ("$ref" in schema.items) schemaItems.push(irItemsSchema);
 		else {
 			const ofArray = schema.items.allOf;
-			if (ofArray && ofArray.length > 1 && !schema.items["x-nullable"]) irSchema = {
-				...irSchema,
-				...irItemsSchema
-			};
+			if (ofArray && ofArray.length > 1 && !schema.items["x-nullable"]) Object.assign(irSchema, irItemsSchema);
 			else schemaItems.push(irItemsSchema);
 		}
 	}
@@ -4405,20 +4412,24 @@ function parseNumber$2({ irSchema = {}, schema }) {
 }
 function parseObject$2({ context, irSchema = {}, schema, state }) {
 	irSchema.type = "object";
-	const schemaProperties = {};
-	for (const name in schema.properties) {
-		const property = schema.properties[name];
-		if (typeof property === "boolean") {} else schemaProperties[name] = schemaToIrSchema$2({
-			context,
-			schema: property,
-			state
-		});
+	let isSchemaPropertiesEmpty = true;
+	if (schema.properties) {
+		const schemaProperties = {};
+		for (const name in schema.properties) {
+			isSchemaPropertiesEmpty = false;
+			const property = schema.properties[name];
+			if (typeof property === "boolean") {} else schemaProperties[name] = schemaToIrSchema$2({
+				context,
+				schema: property,
+				state
+			});
+		}
+		if (!isSchemaPropertiesEmpty) irSchema.properties = schemaProperties;
 	}
-	if (Object.keys(schemaProperties).length) irSchema.properties = schemaProperties;
 	if (schema.additionalProperties === void 0) {
 		if (!irSchema.properties) irSchema.additionalProperties = { type: "unknown" };
 	} else if (typeof schema.additionalProperties === "boolean") {
-		if (!(state.inAllOf && schema.additionalProperties === false && (!schema.properties || !Object.keys(schema.properties).length))) irSchema.additionalProperties = { type: schema.additionalProperties ? "unknown" : "never" };
+		if (!(state.inAllOf && schema.additionalProperties === false && (!schema.properties || isSchemaPropertiesEmpty))) irSchema.additionalProperties = { type: schema.additionalProperties ? "unknown" : "never" };
 	} else irSchema.additionalProperties = schemaToIrSchema$2({
 		context,
 		schema: schema.additionalProperties,
@@ -4449,7 +4460,7 @@ function initIrSchema$2({ schema }) {
 function parseAllOf$2({ context, schema, state }) {
 	let irSchema = initIrSchema$2({ schema });
 	const schemaItems = [];
-	const schemaType = getSchemaType$1({ schema });
+	const schemaType = getSchemaType$1(schema);
 	const compositionSchemas = schema.allOf;
 	for (const compositionSchema of compositionSchemas) {
 		const originalInAllOf = state.inAllOf;
@@ -4460,8 +4471,7 @@ function parseAllOf$2({ context, schema, state }) {
 			state
 		});
 		state.inAllOf = originalInAllOf;
-		if (state.inAllOf === void 0) delete state.inAllOf;
-		if (schema.required) if (irCompositionSchema.required) irCompositionSchema.required = [...irCompositionSchema.required, ...schema.required];
+		if (schema.required) if (irCompositionSchema.required) irCompositionSchema.required.push(...schema.required);
 		else irCompositionSchema.required = schema.required;
 		schemaItems.push(irCompositionSchema);
 		if (compositionSchema.$ref) {
@@ -4495,7 +4505,7 @@ function parseAllOf$2({ context, schema, state }) {
 		if (irObjectSchema.properties) {
 			for (const requiredProperty of irObjectSchema.required ?? []) if (!irObjectSchema.properties[requiredProperty]) for (const compositionSchema of compositionSchemas) {
 				const finalCompositionSchema = compositionSchema.$ref ? context.resolveRef(compositionSchema.$ref) : compositionSchema;
-				if (getSchemaType$1({ schema: finalCompositionSchema }) === "object") {
+				if (getSchemaType$1(finalCompositionSchema) === "object") {
 					const irCompositionSchema = parseOneType$2({
 						context,
 						schema: {
@@ -4539,7 +4549,11 @@ function parseEnum$2({ context, schema, state }) {
 	});
 	irSchema.type = "enum";
 	const schemaItems = [];
-	for (const [index, enumValue] of schema.enum.entries()) {
+	const xEnumDescriptions = schema["x-enum-descriptions"];
+	const xEnumVarnames = schema["x-enum-varnames"];
+	const xEnumNames = schema["x-enumNames"];
+	for (let index = 0, len = schema.enum.length; index < len; index++) {
+		const enumValue = schema.enum[index];
 		const typeOfEnumValue = typeof enumValue;
 		let enumType;
 		if (typeOfEnumValue === "string" || typeOfEnumValue === "number" || typeOfEnumValue === "boolean") enumType = typeOfEnumValue;
@@ -4551,8 +4565,8 @@ function parseEnum$2({ context, schema, state }) {
 		const irTypeSchema = parseOneType$2({
 			context,
 			schema: {
-				description: schema["x-enum-descriptions"]?.[index],
-				title: schema["x-enum-varnames"]?.[index] ?? schema["x-enumNames"]?.[index],
+				description: xEnumDescriptions?.[index],
+				title: xEnumVarnames?.[index] ?? xEnumNames?.[index],
 				type: enumType === "null" ? "string" : enumType
 			},
 			state
@@ -4624,7 +4638,7 @@ function parseType$2({ context, schema, state }) {
 		irSchema,
 		schema
 	});
-	const type = getSchemaType$1({ schema });
+	const type = getSchemaType$1(schema);
 	if (!type) return irSchema;
 	if (schema["x-nullable"]) return parseNullableType$1({
 		context,
@@ -4776,7 +4790,7 @@ const paginationField$2 = ({ context, name, schema }) => {
 	for (const name in schema.properties) if (getPaginationKeywordsRegExp(context.config.parser.pagination).test(name)) {
 		const property = schema.properties[name];
 		if (typeof property !== "boolean" && !("$ref" in property)) {
-			if (isPaginationType$2(getSchemaType$1({ schema: property }))) return name;
+			if (isPaginationType$2(getSchemaType$1(property))) return name;
 		}
 	}
 	for (const allOf of schema.allOf ?? []) {
@@ -5193,7 +5207,7 @@ const parseV2_0_X = (context) => {
 		securitySchemesMap.set(name, securitySchemeObject);
 	}
 	if (context.spec.definitions) for (const name in context.spec.definitions) {
-		const $ref = `#/definitions/${name}`;
+		const $ref = pathToJsonPointer(["definitions", name]);
 		const schema = context.spec.definitions[name];
 		parseSchema$2({
 			$ref,
@@ -5461,7 +5475,7 @@ const mediaTypeObjects$1 = ({ content }) => {
 };
 //#endregion
 //#region src/openApi/3.0.x/parser/schema.ts
-function getSchemaType({ schema }) {
+function getSchemaType(schema) {
 	if (schema.type) return schema.type;
 	if (schema.properties) return "object";
 }
@@ -5516,7 +5530,7 @@ function findDiscriminatorsInSchema$1({ context, discriminators = [], schema })
 */
 function getAllDiscriminatorValues$1({ discriminator, schemaRef }) {
 	const values = [];
-	for (const [value, mappedSchemaRef] of Object.entries(discriminator.mapping || {})) if (mappedSchemaRef === schemaRef) values.push(value);
+	for (const value in discriminator.mapping) if (discriminator.mapping[value] === schemaRef) values.push(value);
 	return values;
 }
 function parseSchemaJsDoc$1({ irSchema, schema }) {
@@ -5556,10 +5570,7 @@ function parseArray$1({ context, irSchema = {}, schema, state }) {
 		else if ("$ref" in schema.items) schemaItems.push(irItemsSchema);
 		else {
 			const ofArray = schema.items.allOf || schema.items.anyOf || schema.items.oneOf;
-			if (ofArray && ofArray.length > 1 && !schema.items.nullable) irSchema = {
-				...irSchema,
-				...irItemsSchema
-			};
+			if (ofArray && ofArray.length > 1 && !schema.items.nullable) Object.assign(irSchema, irItemsSchema);
 			else schemaItems.push(irItemsSchema);
 		}
 	}
@@ -5579,20 +5590,24 @@ function parseNumber$1({ irSchema = {}, schema }) {
 }
 function parseObject$1({ context, irSchema = {}, schema, state }) {
 	irSchema.type = "object";
-	const schemaProperties = {};
-	for (const name in schema.properties) {
-		const property = schema.properties[name];
-		if (typeof property === "boolean") {} else schemaProperties[name] = schemaToIrSchema$1({
-			context,
-			schema: property,
-			state
-		});
+	let isSchemaPropertiesEmpty = true;
+	if (schema.properties) {
+		const schemaProperties = {};
+		for (const name in schema.properties) {
+			isSchemaPropertiesEmpty = false;
+			const property = schema.properties[name];
+			if (typeof property === "boolean") {} else schemaProperties[name] = schemaToIrSchema$1({
+				context,
+				schema: property,
+				state
+			});
+		}
+		if (!isSchemaPropertiesEmpty) irSchema.properties = schemaProperties;
 	}
-	if (Object.keys(schemaProperties).length) irSchema.properties = schemaProperties;
 	if (schema.additionalProperties === void 0) {
 		if (!irSchema.properties) irSchema.additionalProperties = { type: "unknown" };
 	} else if (typeof schema.additionalProperties === "boolean") {
-		if (!(state.inAllOf && schema.additionalProperties === false && (!schema.properties || !Object.keys(schema.properties).length))) irSchema.additionalProperties = { type: schema.additionalProperties ? "unknown" : "never" };
+		if (!(state.inAllOf && schema.additionalProperties === false && (!schema.properties || isSchemaPropertiesEmpty))) irSchema.additionalProperties = { type: schema.additionalProperties ? "unknown" : "never" };
 	} else irSchema.additionalProperties = schemaToIrSchema$1({
 		context,
 		schema: schema.additionalProperties,
@@ -5642,7 +5657,7 @@ function initIrSchema$1({ schema }) {
 function parseAllOf$1({ context, schema, state }) {
 	let irSchema = initIrSchema$1({ schema });
 	const schemaItems = [];
-	const schemaType = getSchemaType({ schema });
+	const schemaType = getSchemaType(schema);
 	const compositionSchemas = schema.allOf;
 	const discriminatorsToAdd = [];
 	for (const compositionSchema of compositionSchemas) {
@@ -5654,8 +5669,7 @@ function parseAllOf$1({ context, schema, state }) {
 			state
 		});
 		state.inAllOf = originalInAllOf;
-		if (state.inAllOf === void 0) delete state.inAllOf;
-		if (schema.required) if (irCompositionSchema.required) irCompositionSchema.required = [...irCompositionSchema.required, ...schema.required];
+		if (schema.required) if (irCompositionSchema.required) irCompositionSchema.required.push(...schema.required);
 		else irCompositionSchema.required = schema.required;
 		schemaItems.push(irCompositionSchema);
 		if ("$ref" in compositionSchema) {
@@ -5730,7 +5744,7 @@ function parseAllOf$1({ context, schema, state }) {
 			inlineSchema.properties[discriminator.propertyName] = discriminatorProperty;
 			if (isRequired) {
 				if (!inlineSchema.required) inlineSchema.required = [];
-				if (!inlineSchema.required.includes(discriminator.propertyName)) inlineSchema.required = [...inlineSchema.required, discriminator.propertyName];
+				if (!inlineSchema.required.includes(discriminator.propertyName)) inlineSchema.required.push(discriminator.propertyName);
 			}
 		} else {
 			const irDiscriminatorSchema = {
@@ -5753,7 +5767,7 @@ function parseAllOf$1({ context, schema, state }) {
 		if (irObjectSchema.properties) {
 			for (const requiredProperty of irObjectSchema.required ?? []) if (!irObjectSchema.properties[requiredProperty]) for (const compositionSchema of compositionSchemas) {
 				const finalCompositionSchema = "$ref" in compositionSchema ? context.resolveRef(compositionSchema.$ref) : compositionSchema;
-				if (getSchemaType({ schema: finalCompositionSchema }) === "object") {
+				if (getSchemaType(finalCompositionSchema) === "object") {
 					const irCompositionSchema = parseOneType$1({
 						context,
 						schema: {
@@ -5792,7 +5806,7 @@ function parseAllOf$1({ context, schema, state }) {
 function parseAnyOf$1({ context, schema, state }) {
 	let irSchema = initIrSchema$1({ schema });
 	const schemaItems = [];
-	const schemaType = getSchemaType({ schema });
+	const schemaType = getSchemaType(schema);
 	const compositionSchemas = schema.anyOf;
 	const discriminatorPropertyType = schema.discriminator ? findDiscriminatorPropertyType$1({
 		context,
@@ -5851,7 +5865,11 @@ function parseEnum$1({ context, schema, state }) {
 	});
 	irSchema.type = "enum";
 	const schemaItems = [];
-	for (const [index, enumValue] of schema.enum.entries()) {
+	const xEnumDescriptions = schema["x-enum-descriptions"];
+	const xEnumVarnames = schema["x-enum-varnames"];
+	const xEnumNames = schema["x-enumNames"];
+	for (let index = 0, len = schema.enum.length; index < len; index++) {
+		const enumValue = schema.enum[index];
 		const typeOfEnumValue = typeof enumValue;
 		let enumType;
 		if (typeOfEnumValue === "string" || typeOfEnumValue === "number" || typeOfEnumValue === "boolean") enumType = typeOfEnumValue;
@@ -5863,8 +5881,8 @@ function parseEnum$1({ context, schema, state }) {
 		const irTypeSchema = parseOneType$1({
 			context,
 			schema: {
-				description: schema["x-enum-descriptions"]?.[index],
-				title: schema["x-enum-varnames"]?.[index] ?? schema["x-enumNames"]?.[index],
+				description: xEnumDescriptions?.[index],
+				title: xEnumVarnames?.[index] ?? xEnumNames?.[index],
 				type: enumType === "null" ? "string" : enumType
 			},
 			state
@@ -5883,7 +5901,7 @@ function parseEnum$1({ context, schema, state }) {
 function parseOneOf$1({ context, schema, state }) {
 	let irSchema = initIrSchema$1({ schema });
 	let schemaItems = [];
-	const schemaType = getSchemaType({ schema });
+	const schemaType = getSchemaType(schema);
 	const compositionSchemas = schema.oneOf;
 	const discriminatorPropertyType = schema.discriminator ? findDiscriminatorPropertyType$1({
 		context,
@@ -5991,7 +6009,7 @@ function parseType$1({ context, schema, state }) {
 		irSchema,
 		schema
 	});
-	const type = getSchemaType({ schema });
+	const type = getSchemaType(schema);
 	if (!type) return irSchema;
 	if (!schema.nullable) return parseOneType$1({
 		context,
@@ -6149,7 +6167,7 @@ const paginationField$1 = ({ context, name, schema }) => {
 	for (const name in schema.properties) if (getPaginationKeywordsRegExp(context.config.parser.pagination).test(name)) {
 		const property = schema.properties[name];
 		if (typeof property !== "boolean" && !("$ref" in property)) {
-			if (isPaginationType$1(getSchemaType({ schema: property }))) return name;
+			if (isPaginationType$1(getSchemaType(property))) return name;
 		}
 	}
 	for (const allOf of schema.allOf ?? []) {
@@ -6533,7 +6551,11 @@ const parseV3_0_X = (context) => {
 			securitySchemesMap.set(name, securitySchemeObject);
 		}
 		for (const name in context.spec.components.parameters) {
-			const $ref = `#/components/parameters/${name}`;
+			const $ref = pathToJsonPointer([
+				"components",
+				"parameters",
+				name
+			]);
 			const parameterOrReference = context.spec.components.parameters[name];
 			parseParameter$1({
 				$ref,
@@ -6542,7 +6564,11 @@ const parseV3_0_X = (context) => {
 			});
 		}
 		for (const name in context.spec.components.requestBodies) {
-			const $ref = `#/components/requestBodies/${name}`;
+			const $ref = pathToJsonPointer([
+				"components",
+				"requestBodies",
+				name
+			]);
 			const requestBodyOrReference = context.spec.components.requestBodies[name];
 			parseRequestBody$1({
 				$ref,
@@ -6551,7 +6577,11 @@ const parseV3_0_X = (context) => {
 			});
 		}
 		for (const name in context.spec.components.schemas) {
-			const $ref = `#/components/schemas/${name}`;
+			const $ref = pathToJsonPointer([
+				"components",
+				"schemas",
+				name
+			]);
 			const schema = context.spec.components.schemas[name];
 			parseSchema$1({
 				$ref,
@@ -6802,7 +6832,7 @@ const mediaTypeObjects = ({ content }) => {
 };
 //#endregion
 //#region src/openApi/3.1.x/parser/schema.ts
-function getSchemaTypes({ schema }) {
+function getSchemaTypes(schema) {
 	if (typeof schema.type === "string") return [schema.type];
 	if (schema.type) return schema.type;
 	if (schema.properties) return ["object"];
@@ -6861,7 +6891,7 @@ function findDiscriminatorsInSchema({ context, discriminators = [], schema }) {
 */
 function getAllDiscriminatorValues({ discriminator, schemaRef }) {
 	const values = [];
-	for (const [value, mappedSchemaRef] of Object.entries(discriminator.mapping || {})) if (mappedSchemaRef === schemaRef) values.push(value);
+	for (const value in discriminator.mapping) if (discriminator.mapping[value] === schemaRef) values.push(value);
 	return values;
 }
 function parseSchemaJsDoc({ irSchema, schema }) {
@@ -6923,10 +6953,7 @@ function parseArray({ context, irSchema = {}, schema, state }) {
 		if (!schemaItems.length && schema.maxItems && schema.maxItems === schema.minItems) schemaItems = Array(schema.maxItems).fill(irItemsSchema);
 		else {
 			const ofArray = schema.items.allOf || schema.items.anyOf || schema.items.oneOf;
-			if (ofArray && ofArray.length > 1 && !getSchemaTypes({ schema: schema.items }).includes("null")) irSchema = {
-				...irSchema,
-				...irItemsSchema
-			};
+			if (ofArray && ofArray.length > 1 && !getSchemaTypes(schema.items).includes("null")) Object.assign(irSchema, irItemsSchema);
 			else schemaItems.push(irItemsSchema);
 		}
 	}
@@ -6950,25 +6977,21 @@ function parseNumber({ irSchema = {}, schema }) {
 }
 function parseObject({ context, irSchema = {}, schema, state }) {
 	irSchema.type = "object";
-	const schemaProperties = {};
-	for (const name in schema.properties) {
-		const property = schema.properties[name];
-		if (typeof property === "boolean") {} else schemaProperties[name] = schemaToIrSchema({
-			context,
-			schema: property,
-			state
-		});
+	let isSchemaPropertiesEmpty = true;
+	if (schema.properties) {
+		const schemaProperties = {};
+		for (const name in schema.properties) {
+			isSchemaPropertiesEmpty = false;
+			const property = schema.properties[name];
+			if (typeof property === "boolean") {} else schemaProperties[name] = schemaToIrSchema({
+				context,
+				schema: property,
+				state
+			});
+		}
+		if (!isSchemaPropertiesEmpty) irSchema.properties = schemaProperties;
 	}
-	if (Object.keys(schemaProperties).length) irSchema.properties = schemaProperties;
-	if (schema.additionalProperties === void 0) {
-		if (!irSchema.properties) irSchema.additionalProperties = { type: "unknown" };
-	} else if (typeof schema.additionalProperties === "boolean") {
-		if (!(state.inAllOf && schema.additionalProperties === false && (!schema.properties || !Object.keys(schema.properties).length) && (!schema.patternProperties || !Object.keys(schema.patternProperties).length))) irSchema.additionalProperties = { type: schema.additionalProperties ? "unknown" : "never" };
-	} else irSchema.additionalProperties = schemaToIrSchema({
-		context,
-		schema: schema.additionalProperties,
-		state
-	});
+	let isPatternPropertiesEmpty = true;
 	if (schema.patternProperties) {
 		const patternProperties = {};
 		for (const pattern in schema.patternProperties) {
@@ -6978,9 +7001,19 @@ function parseObject({ context, irSchema = {}, schema, state }) {
 				schema: patternSchema,
 				state
 			});
+			isPatternPropertiesEmpty = false;
 		}
-		if (Object.keys(patternProperties).length) irSchema.patternProperties = patternProperties;
+		if (!isPatternPropertiesEmpty) irSchema.patternProperties = patternProperties;
 	}
+	if (schema.additionalProperties === void 0) {
+		if (!irSchema.properties) irSchema.additionalProperties = { type: "unknown" };
+	} else if (typeof schema.additionalProperties === "boolean") {
+		if (!(state.inAllOf && schema.additionalProperties === false && (!schema.properties || isSchemaPropertiesEmpty) && (!schema.patternProperties || isPatternPropertiesEmpty))) irSchema.additionalProperties = { type: schema.additionalProperties ? "unknown" : "never" };
+	} else irSchema.additionalProperties = schemaToIrSchema({
+		context,
+		schema: schema.additionalProperties,
+		state
+	});
 	if (schema.propertyNames) irSchema.propertyNames = schemaToIrSchema({
 		context,
 		schema: schema.propertyNames,
@@ -7034,7 +7067,7 @@ function parseAllOf({ context, schema, state }) {
 		schema
 	});
 	const schemaItems = [];
-	const schemaTypes = getSchemaTypes({ schema });
+	const schemaTypes = getSchemaTypes(schema);
 	const compositionSchemas = schema.allOf;
 	const discriminatorsToAdd = [];
 	for (const compositionSchema of compositionSchemas) {
@@ -7046,8 +7079,7 @@ function parseAllOf({ context, schema, state }) {
 			state
 		});
 		state.inAllOf = originalInAllOf;
-		if (state.inAllOf === void 0) delete state.inAllOf;
-		if (schema.required) if (irCompositionSchema.required) irCompositionSchema.required = [...irCompositionSchema.required, ...schema.required];
+		if (schema.required) if (irCompositionSchema.required) irCompositionSchema.required.push(...schema.required);
 		else irCompositionSchema.required = schema.required;
 		schemaItems.push(irCompositionSchema);
 		if (compositionSchema.$ref) {
@@ -7122,7 +7154,7 @@ function parseAllOf({ context, schema, state }) {
 			inlineSchema.properties[discriminator.propertyName] = discriminatorProperty;
 			if (isRequired) {
 				if (!inlineSchema.required) inlineSchema.required = [];
-				if (!inlineSchema.required.includes(discriminator.propertyName)) inlineSchema.required = [...inlineSchema.required, discriminator.propertyName];
+				if (!inlineSchema.required.includes(discriminator.propertyName)) inlineSchema.required.push(discriminator.propertyName);
 			}
 		} else {
 			const irDiscriminatorSchema = {
@@ -7145,7 +7177,7 @@ function parseAllOf({ context, schema, state }) {
 		if (irObjectSchema.properties) {
 			for (const requiredProperty of irObjectSchema.required ?? []) if (!irObjectSchema.properties[requiredProperty]) for (const compositionSchema of compositionSchemas) {
 				const finalCompositionSchema = compositionSchema.$ref ? context.resolveRef(compositionSchema.$ref) : compositionSchema;
-				if (getSchemaTypes({ schema: finalCompositionSchema }).includes("object")) {
+				if (getSchemaTypes(finalCompositionSchema).includes("object")) {
 					const irCompositionSchema = parseOneType({
 						context,
 						schema: {
@@ -7186,7 +7218,7 @@ function parseAnyOf({ context, schema, state }) {
 		schema
 	});
 	const schemaItems = [];
-	const schemaTypes = getSchemaTypes({ schema });
+	const schemaTypes = getSchemaTypes(schema);
 	const compositionSchemas = schema.anyOf;
 	const discriminatorPropertyType = schema.discriminator ? findDiscriminatorPropertyType({
 		context,
@@ -7245,8 +7277,12 @@ function parseEnum({ context, schema, state }) {
 	});
 	irSchema.type = "enum";
 	const schemaItems = [];
-	const schemaTypes = getSchemaTypes({ schema });
-	for (const [index, enumValue] of schema.enum.entries()) {
+	const schemaTypes = getSchemaTypes(schema);
+	const xEnumDescriptions = schema["x-enum-descriptions"];
+	const xEnumVarnames = schema["x-enum-varnames"];
+	const xEnumNames = schema["x-enumNames"];
+	for (let index = 0, len = schema.enum.length; index < len; index++) {
+		const enumValue = schema.enum[index];
 		const typeOfEnumValue = typeof enumValue;
 		let enumType;
 		if (typeOfEnumValue === "string" || typeOfEnumValue === "number" || typeOfEnumValue === "boolean") enumType = typeOfEnumValue;
@@ -7259,8 +7295,8 @@ function parseEnum({ context, schema, state }) {
 			context,
 			schema: {
 				const: enumValue,
-				description: schema["x-enum-descriptions"]?.[index],
-				title: schema["x-enum-varnames"]?.[index] ?? schema["x-enumNames"]?.[index],
+				description: xEnumDescriptions?.[index],
+				title: xEnumVarnames?.[index] ?? xEnumNames?.[index],
 				type: enumType
 			},
 			state
@@ -7280,7 +7316,7 @@ function parseOneOf({ context, schema, state }) {
 		schema
 	});
 	let schemaItems = [];
-	const schemaTypes = getSchemaTypes({ schema });
+	const schemaTypes = getSchemaTypes(schema);
 	const compositionSchemas = schema.oneOf;
 	const discriminatorPropertyType = schema.discriminator ? findDiscriminatorPropertyType({
 		context,
@@ -7461,7 +7497,7 @@ function parseType({ context, schema, state }) {
 		irSchema,
 		schema
 	});
-	const schemaTypes = getSchemaTypes({ schema });
+	const schemaTypes = getSchemaTypes(schema);
 	if (schemaTypes.length === 1) return parseOneType({
 		context,
 		irSchema,
@@ -7579,11 +7615,11 @@ const paginationField = ({ context, name, schema }) => {
 	for (const name in schema.properties) if (getPaginationKeywordsRegExp(context.config.parser.pagination).test(name)) {
 		const property = schema.properties[name];
 		if (typeof property !== "boolean") {
-			const schemaTypes = getSchemaTypes({ schema: property });
+			const schemaTypes = getSchemaTypes(property);
 			if (!schemaTypes.length) {
 				const nonNullCompositionSchemas = (property.anyOf ?? property.oneOf ?? []).filter((schema) => schema.type !== "null");
 				if (nonNullCompositionSchemas.length === 1) {
-					if (isPaginationType(getSchemaTypes({ schema: nonNullCompositionSchemas[0] }))) return name;
+					if (isPaginationType(getSchemaTypes(nonNullCompositionSchemas[0]))) return name;
 				}
 			}
 			if (isPaginationType(schemaTypes)) return name;
@@ -8125,7 +8161,11 @@ const parseV3_1_X = (context) => {
 			securitySchemesMap.set(name, securitySchemeObject);
 		}
 		for (const name in context.spec.components.parameters) {
-			const $ref = `#/components/parameters/${name}`;
+			const $ref = pathToJsonPointer([
+				"components",
+				"parameters",
+				name
+			]);
 			const parameterOrReference = context.spec.components.parameters[name];
 			parseParameter({
 				$ref,
@@ -8134,7 +8174,11 @@ const parseV3_1_X = (context) => {
 			});
 		}
 		for (const name in context.spec.components.requestBodies) {
-			const $ref = `#/components/requestBodies/${name}`;
+			const $ref = pathToJsonPointer([
+				"components",
+				"requestBodies",
+				name
+			]);
 			const requestBodyOrReference = context.spec.components.requestBodies[name];
 			parseRequestBody({
 				$ref,
@@ -8143,7 +8187,11 @@ const parseV3_1_X = (context) => {
 			});
 		}
 		for (const name in context.spec.components.schemas) {
-			const $ref = `#/components/schemas/${name}`;
+			const $ref = pathToJsonPointer([
+				"components",
+				"schemas",
+				name
+			]);
 			const schema = context.spec.components.schemas[name];
 			parseSchema({
 				$ref,
@@ -8523,8 +8571,18 @@ const definePluginConfig = (defaultConfig) => (userConfig) => ({
 */
 const mappers = {
 	boolean: (enabled) => ({ enabled }),
-	function: (name) => ({ name }),
-	string: (name) => ({ name })
+	function: (name) => ({
+		enabled: true,
+		name
+	}),
+	object: (fields) => ({
+		enabled: true,
+		...fields
+	}),
+	string: (name) => ({
+		enabled: true,
+		name
+	})
 };
 //#endregion
 //#region src/plugins/symbol.ts
@@ -8532,9 +8590,8 @@ const mappers = {
 * Helper function to build the input for symbol registration, applying naming hooks if provided.
 */
 function buildSymbolIn({ plugin, ...ctx }) {
-	const hooks = [plugin.config["~hooks"]?.symbols?.getName, plugin.context.config.parser.hooks.symbols?.getName];
+	const hooks = plugin.getHooks((hooks) => hooks.symbols?.getName);
 	for (const hook of hooks) {
-		if (!hook) continue;
 		const result = hook(ctx);
 		if (typeof result === "function") {
 			const name = result(ctx);