oas 38.7.0 → 39.0.0

package/dist/analyzer/index.cjs

@@ -8,7 +8,7 @@ var _chunkCOHEPMUPcjs = require('../chunk-COHEPMUP.cjs');
 
 
 
-var _chunkNASFWOIScjs = require('../chunk-NASFWOIS.cjs');
+var _chunkXEZRUXJ4cjs = require('../chunk-XEZRUXJ4.cjs');
 require('../chunk-47FD2BIN.cjs');
 
 
@@ -116,7 +116,7 @@ function queryCached(queries, definition) {
 // src/analyzer/scope.ts
 var _jsonpointer = require('jsonpointer'); var _jsonpointer2 = _interopRequireDefault(_jsonpointer);
 function canonicalizeRefPointer($ref) {
-  const pointer = _chunkNASFWOIScjs.toPointer.call(void 0, $ref);
+  const pointer = _chunkXEZRUXJ4cjs.toPointer.call(void 0, $ref);
   try {
     return decodeURIComponent(pointer);
   } catch (e) {
@@ -154,7 +154,7 @@ function resolveKey(keys, target) {
   return keys.find((key) => key === target) || keys.find((key) => key.toLowerCase() === target.toLowerCase());
 }
 function resolvePathItem(raw, definition) {
-  const resolved = _chunkNASFWOIScjs.dereferenceRef.call(void 0, raw, definition);
+  const resolved = _chunkXEZRUXJ4cjs.dereferenceRef.call(void 0, raw, definition);
   if (!resolved || typeof resolved !== "object" || _chunkX7BGCIJNcjs.isRef.call(void 0, resolved)) {
     return void 0;
   }
@@ -162,7 +162,7 @@ function resolvePathItem(raw, definition) {
 }
 function resolveMethodKey(container, method) {
   const methodKey = resolveKey(Object.keys(container), method);
-  if (!methodKey || !_chunkNASFWOIScjs.supportedMethods.includes(methodKey.toLowerCase())) {
+  if (!methodKey || !_chunkXEZRUXJ4cjs.supportedMethods.includes(methodKey.toLowerCase())) {
     return void 0;
   }
   return methodKey;
@@ -178,14 +178,14 @@ function accumulateReachableRefs(definition, seeds) {
     reachable.add(ref);
     let resolved;
     try {
-      resolved = _jsonpointer2.default.get(definition, _chunkNASFWOIScjs.toPointer.call(void 0, ref));
+      resolved = _jsonpointer2.default.get(definition, _chunkXEZRUXJ4cjs.toPointer.call(void 0, ref));
     } catch (e3) {
       continue;
     }
     if (resolved === void 0) {
       continue;
     }
-    _chunkNASFWOIScjs.collectRefsInSchema.call(void 0, resolved).forEach((nestedRef) => {
+    _chunkXEZRUXJ4cjs.collectRefsInSchema.call(void 0, resolved).forEach((nestedRef) => {
       if (!reachable.has(nestedRef)) {
         queue.push(nestedRef);
       }
@@ -195,7 +195,7 @@ function accumulateReachableRefs(definition, seeds) {
 }
 function buildAnchors(rootPointer, extraPointers, reachableRefs) {
   const anchors = [rootPointer, ...extraPointers];
-  reachableRefs.forEach((ref) => anchors.push(_chunkNASFWOIScjs.toPointer.call(void 0, ref)));
+  reachableRefs.forEach((ref) => anchors.push(_chunkXEZRUXJ4cjs.toPointer.call(void 0, ref)));
   return { anchors, anchorPrefixes: anchors.map((anchor) => `${anchor}/`) };
 }
 function collectSecuritySchemeRefs(security) {
@@ -230,16 +230,16 @@ function computeOperationScope(definition, path, method) {
   if (!operation || typeof operation !== "object") {
     throw new Error(`Operation \`${method} ${path}\` not found.`);
   }
-  const rootPointer = `/paths/${_chunkNASFWOIScjs.encodePointer.call(void 0, pathKey)}/${methodKey}`;
+  const rootPointer = `/paths/${_chunkXEZRUXJ4cjs.encodePointer.call(void 0, pathKey)}/${methodKey}`;
   const extraPointers = [];
-  const seeds = new Set(_chunkNASFWOIScjs.collectRefsInSchema.call(void 0, operation));
+  const seeds = new Set(_chunkXEZRUXJ4cjs.collectRefsInSchema.call(void 0, operation));
   const targetPointer = resolvePathItemTargetPointer(rawPathItem, definition);
   if (targetPointer) {
     extraPointers.push(`${targetPointer}/${methodKey}`);
   }
   if (pathItem.parameters) {
-    extraPointers.push(targetPointer ? `${targetPointer}/parameters` : `/paths/${_chunkNASFWOIScjs.encodePointer.call(void 0, pathKey)}/parameters`);
-    _chunkNASFWOIScjs.collectRefsInSchema.call(void 0, pathItem.parameters).forEach((ref) => seeds.add(ref));
+    extraPointers.push(targetPointer ? `${targetPointer}/parameters` : `/paths/${_chunkXEZRUXJ4cjs.encodePointer.call(void 0, pathKey)}/parameters`);
+    _chunkXEZRUXJ4cjs.collectRefsInSchema.call(void 0, pathItem.parameters).forEach((ref) => seeds.add(ref));
   }
   const security = "security" in operation ? operation.security : definition.security;
   collectSecuritySchemeRefs(security).forEach((ref) => seeds.add(ref));
@@ -265,18 +265,18 @@ function computeWebhookScope(definition, webhookName, method) {
   if (!operation || typeof operation !== "object") {
     throw new Error(`Webhook operation \`${method} ${webhookName}\` not found.`);
   }
-  const rootPointer = `/webhooks/${_chunkNASFWOIScjs.encodePointer.call(void 0, webhookKey)}/${methodKey}`;
+  const rootPointer = `/webhooks/${_chunkXEZRUXJ4cjs.encodePointer.call(void 0, webhookKey)}/${methodKey}`;
   const extraPointers = [];
-  const seeds = new Set(_chunkNASFWOIScjs.collectRefsInSchema.call(void 0, operation));
+  const seeds = new Set(_chunkXEZRUXJ4cjs.collectRefsInSchema.call(void 0, operation));
   const targetPointer = resolvePathItemTargetPointer(rawWebhook, definition);
   if (targetPointer) {
     extraPointers.push(`${targetPointer}/${methodKey}`);
   }
   if (webhook.parameters) {
     extraPointers.push(
-      targetPointer ? `${targetPointer}/parameters` : `/webhooks/${_chunkNASFWOIScjs.encodePointer.call(void 0, webhookKey)}/parameters`
+      targetPointer ? `${targetPointer}/parameters` : `/webhooks/${_chunkXEZRUXJ4cjs.encodePointer.call(void 0, webhookKey)}/parameters`
     );
-    _chunkNASFWOIScjs.collectRefsInSchema.call(void 0, webhook.parameters).forEach((ref) => seeds.add(ref));
+    _chunkXEZRUXJ4cjs.collectRefsInSchema.call(void 0, webhook.parameters).forEach((ref) => seeds.add(ref));
   }
   const security = "security" in operation ? operation.security : definition.security;
   collectSecuritySchemeRefs(security).forEach((ref) => seeds.add(ref));
@@ -467,7 +467,7 @@ async function buildAnalysis(definition, query2, scope) {
   }
   if (!query2 || query2.includes("circularRefs")) {
     const { circularRefs: dereferencedCircularRefs } = await dereferenceOasShared(definition);
-    const circularRefs = (scope ? dereferencedCircularRefs.filter((ref) => isPointerInScope(_chunkNASFWOIScjs.toPointer.call(void 0, ref), scope)) : [...dereferencedCircularRefs]).toSorted();
+    const circularRefs = (scope ? dereferencedCircularRefs.filter((ref) => isPointerInScope(_chunkXEZRUXJ4cjs.toPointer.call(void 0, ref), scope)) : [...dereferencedCircularRefs]).toSorted();
     analysis.circularRefs = {
       present: !!circularRefs.length,
       locations: circularRefs

package/dist/analyzer/index.js

@@ -8,7 +8,7 @@ import {
   encodePointer,
   supportedMethods,
   toPointer
-} from "../chunk-S333SATE.js";
+} from "../chunk-E6QPSOEQ.js";
 import "../chunk-JHDEAXSK.js";
 import {
   isOpenAPI31,

package/dist/analyzer/types.d.cts

@@ -28,4 +28,5 @@ interface OASAnalysis {
     webhooks?: OASAnalysisFeature;
 }
 
-export { AnalyzerQueries, type AnalyzerQuery, type OASAnalysis, type OASAnalysisFeature, type OASAnalysisGeneral };
+export { AnalyzerQueries };
+export type { AnalyzerQuery, OASAnalysis, OASAnalysisFeature, OASAnalysisGeneral };

package/dist/analyzer/types.d.ts

@@ -28,4 +28,5 @@ interface OASAnalysis {
     webhooks?: OASAnalysisFeature;
 }
 
-export { AnalyzerQueries, type AnalyzerQuery, type OASAnalysis, type OASAnalysisFeature, type OASAnalysisGeneral };
+export { AnalyzerQueries };
+export type { AnalyzerQuery, OASAnalysis, OASAnalysisFeature, OASAnalysisGeneral };

package/dist/{chunk-I5PRGIKK.cjs → chunk-5ERUEBRH.cjs}

@@ -3,13 +3,13 @@
 var _chunkCOHEPMUPcjs = require('./chunk-COHEPMUP.cjs');
 
 
-var _chunkEUTXEYKFcjs = require('./chunk-EUTXEYKF.cjs');
+var _chunkQRWBDGLRcjs = require('./chunk-QRWBDGLR.cjs');
 
 
 
 
 
-var _chunkNASFWOIScjs = require('./chunk-NASFWOIS.cjs');
+var _chunkXEZRUXJ4cjs = require('./chunk-XEZRUXJ4.cjs');
 
 
 
@@ -156,7 +156,7 @@ var OpenAPITransformer = (_class2 = class {
   constructor(definition, options) {;_class2.prototype.__init2.call(this);_class2.prototype.__init3.call(this);_class2.prototype.__init4.call(this);_class2.prototype.__init5.call(this);_class2.prototype.__init6.call(this);_class2.prototype.__init7.call(this);_class2.prototype.__init8.call(this);_class2.prototype.__init9.call(this);_class2.prototype.__init10.call(this);_class2.prototype.__init11.call(this);_class2.prototype.__init12.call(this);_class2.prototype.__init13.call(this);_class2.prototype.__init14.call(this);_class2.prototype.__init15.call(this);_class2.prototype.__init16.call(this);
     this.definition = structuredClone(definition);
     this.mode = options.mode;
-    const { children, refs } = _chunkNASFWOIScjs.findDiscriminatorChildren.call(void 0, this.definition);
+    const { children, refs } = _chunkXEZRUXJ4cjs.findDiscriminatorChildren.call(void 0, this.definition);
     children.forEach((childNames, parentName) => {
       const parentRef = refs.get(parentName);
       if (parentRef) {
@@ -267,7 +267,7 @@ var OpenAPITransformer = (_class2 = class {
     if ("components" in this.definition) {
       Object.keys(this.definition.components || {}).forEach((componentType) => {
         Object.keys(_optionalChain([this, 'access', _3 => _3.definition, 'access', _4 => _4.components, 'optionalAccess', _5 => _5[componentType]]) || {}).forEach((component) => {
-          const componentPointer = `#/components/${componentType}/${_chunkNASFWOIScjs.encodePointer.call(void 0, component)}`;
+          const componentPointer = `#/components/${componentType}/${_chunkXEZRUXJ4cjs.encodePointer.call(void 0, component)}`;
           const refIsUsed = this.$refs.has(componentPointer) || Array.from(this.$refs).some((ref) => {
             return ref.startsWith(`${componentPointer}/`);
           });
@@ -363,12 +363,12 @@ var OpenAPITransformer = (_class2 = class {
     if (!_optionalChain([match, 'optionalAccess', _19 => _19[1]])) {
       return null;
     }
-    const path = _chunkNASFWOIScjs.decodePointer.call(void 0, match[1]);
+    const path = _chunkXEZRUXJ4cjs.decodePointer.call(void 0, match[1]);
     const segment = match[2];
     if (!segment) {
       return { path, retention: "all" };
     }
-    if (_chunkNASFWOIScjs.supportedMethods.includes(segment.toLowerCase())) {
+    if (_chunkXEZRUXJ4cjs.supportedMethods.includes(segment.toLowerCase())) {
       return { path, method: segment, retention: "operation" };
     }
     return { path, retention: "container" };
@@ -385,12 +385,12 @@ var OpenAPITransformer = (_class2 = class {
     if (!_optionalChain([match, 'optionalAccess', _20 => _20[1]])) {
       return null;
     }
-    const name = _chunkNASFWOIScjs.decodePointer.call(void 0, match[1]);
+    const name = _chunkXEZRUXJ4cjs.decodePointer.call(void 0, match[1]);
     const segment = match[2];
     if (!segment) {
       return { name, retention: "all" };
     }
-    if (_chunkNASFWOIScjs.supportedMethods.includes(segment.toLowerCase())) {
+    if (_chunkXEZRUXJ4cjs.supportedMethods.includes(segment.toLowerCase())) {
       return { name, method: segment, retention: "operation" };
     }
     return { name, retention: "container" };
@@ -413,7 +413,7 @@ var OpenAPITransformer = (_class2 = class {
    * so they match the same form used for authored `$ref`s (`foo/bar` → `foo~1bar`).
    */
   retainSecurityScheme(scheme) {
-    this.$refs.add(`#/components/securitySchemes/${_chunkNASFWOIScjs.encodePointer.call(void 0, scheme)}`);
+    this.$refs.add(`#/components/securitySchemes/${_chunkXEZRUXJ4cjs.encodePointer.call(void 0, scheme)}`);
   }
   /** Record a `#/paths` `$ref` so the target Path Item or operation is not dropped. */
   recordPathRef($ref) {
@@ -478,7 +478,7 @@ var OpenAPITransformer = (_class2 = class {
       return;
     }
     Object.entries(pathItem).forEach(([key, value]) => {
-      if (_chunkNASFWOIScjs.supportedMethods.includes(key.toLowerCase()) || value === void 0) {
+      if (_chunkXEZRUXJ4cjs.supportedMethods.includes(key.toLowerCase()) || value === void 0) {
         return;
       }
       this.queryForRefPointers(value).forEach(({ value: ref }) => {
@@ -534,7 +534,7 @@ var OpenAPITransformer = (_class2 = class {
   shouldRetainOperation(selection, key, method, operation) {
     if (this.mode === "reduce") {
       if (selection.hasSelections && !selection.matches(key, method)) return false;
-      if (this.hasOperationIdSelection && !this.operationIdSelection.has(_chunkEUTXEYKFcjs.Operation.getOperationId(key, method, operation))) {
+      if (this.hasOperationIdSelection && !this.operationIdSelection.has(_chunkQRWBDGLRcjs.Operation.getOperationId(key, method, operation))) {
         return false;
       }
       if (this.hasTagSelection && !(operation.tags || []).some((tag) => this.tagSelection.includes(tag.toLowerCase()))) {
@@ -542,7 +542,7 @@ var OpenAPITransformer = (_class2 = class {
       }
     } else {
       if (selection.hasSelections && selection.matches(key, method)) return false;
-      if (this.hasOperationIdSelection && this.operationIdSelection.has(_chunkEUTXEYKFcjs.Operation.getOperationId(key, method, operation))) {
+      if (this.hasOperationIdSelection && this.operationIdSelection.has(_chunkQRWBDGLRcjs.Operation.getOperationId(key, method, operation))) {
         return false;
       }
       if (this.hasTagSelection && (operation.tags || []).some((tag) => this.tagSelection.includes(tag.toLowerCase()))) {
@@ -553,7 +553,7 @@ var OpenAPITransformer = (_class2 = class {
   }
   /** Determine whether a path item contains at least one HTTP operation. */
   hasOperations(pathItem) {
-    return Boolean(pathItem && _chunkNASFWOIScjs.supportedMethods.some((method) => method in pathItem));
+    return Boolean(pathItem && _chunkXEZRUXJ4cjs.supportedMethods.some((method) => method in pathItem));
   }
   /**
    * Accumulate any `$ref` pointers that are used by common Path Item parameters.
@@ -598,7 +598,7 @@ var OpenAPITransformer = (_class2 = class {
         this.accumulateParameterRefs(_optionalChain([pathItem, 'optionalAccess', _27 => _27.parameters]));
       }
       Object.keys(pathItem || {}).forEach((method) => {
-        if (method === "parameters" || !_chunkNASFWOIScjs.supportedMethods.includes(method.toLowerCase())) {
+        if (method === "parameters" || !_chunkXEZRUXJ4cjs.supportedMethods.includes(method.toLowerCase())) {
           return;
         }
         const operation = _optionalChain([this, 'access', _28 => _28.definition, 'access', _29 => _29.paths, 'optionalAccess', _30 => _30[path], 'optionalAccess', _31 => _31[method]]);
@@ -657,7 +657,7 @@ var OpenAPITransformer = (_class2 = class {
         this.accumulateParameterRefs(webhook.parameters);
       }
       Object.keys(webhook).forEach((method) => {
-        if (method === "parameters" || !_chunkNASFWOIScjs.supportedMethods.includes(method.toLowerCase())) {
+        if (method === "parameters" || !_chunkXEZRUXJ4cjs.supportedMethods.includes(method.toLowerCase())) {
           return;
         }
         const operation = webhook[method];
@@ -715,7 +715,7 @@ var OpenAPITransformer = (_class2 = class {
       let removedOperation = false;
       Object.keys(pathItem || {}).forEach((method) => {
         const methodLC = method.toLowerCase();
-        if (method === "parameters" || !_chunkNASFWOIScjs.supportedMethods.includes(methodLC)) {
+        if (method === "parameters" || !_chunkXEZRUXJ4cjs.supportedMethods.includes(methodLC)) {
           return;
         }
         const retainedByRef = this.isPathOperationRetainedByRef(pathLC, methodLC);
@@ -796,7 +796,7 @@ var OpenAPITransformer = (_class2 = class {
       let removedOperation = false;
       Object.keys(webhook).forEach((method) => {
         const methodLC = method.toLowerCase();
-        if (method === "parameters" || !_chunkNASFWOIScjs.supportedMethods.includes(methodLC)) {
+        if (method === "parameters" || !_chunkXEZRUXJ4cjs.supportedMethods.includes(methodLC)) {
           return;
         }
         const operation = webhookOperations[method];
@@ -839,4 +839,4 @@ var OpenAPITransformer = (_class2 = class {
 
 
 exports.OpenAPITransformer = OpenAPITransformer;
-//# sourceMappingURL=chunk-I5PRGIKK.cjs.map
+//# sourceMappingURL=chunk-5ERUEBRH.cjs.map

package/dist/chunk-5ERUEBRH.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/erunion/code/readme/oas/packages/oas/dist/chunk-5ERUEBRH.cjs","../src/lib/transformer/index.ts","../src/lib/transformer/operation-selection.ts"],"names":[],"mappings":"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","file":"/Users/erunion/code/readme/oas/packages/oas/dist/chunk-5ERUEBRH.cjs","sourcesContent":[null,"import type {\n  ComponentsObject,\n  HttpMethods,\n  OASDocument,\n  OperationObject,\n  PathItemObject,\n  TagObject,\n} from '../../types.js';\nimport type { OpenAPIV3_1 } from 'openapi-types';\n\nimport jsonPointer from 'jsonpointer';\n\nimport { query } from '../../analyzer/util.js';\nimport { Operation } from '../../operation/index.js';\nimport { isOpenAPI31, isRef } from '../../types.js';\nimport { supportedMethods } from '../../utils.js';\nimport { findDiscriminatorChildren } from '../build-discriminator-one-of.js';\nimport { decodePointer, encodePointer } from '../refs.js';\n\nimport { OperationSelection } from './operation-selection.js';\n\ninterface OpenAPITransformerOptions {\n  /** Whether selected paths, operations, and webhooks should be retained or removed. */\n  mode: 'prune' | 'reduce';\n}\n\n/**\n * Internal engine for selecting operations and transforming an OpenAPI definition down to its\n * reachable paths, webhooks, components, and tags. Extended by `OpenAPIPruner` and\n * `OpenAPIReducer`.\n */\nexport class OpenAPITransformer {\n  private definition: OASDocument;\n\n  private readonly mode: 'prune' | 'reduce';\n\n  /**\n   * A collection of `$ref` pointers that are used within our transformed API definition. This is\n   * used to ensure that all referenced schemas are retained in our resulting API definition. Not\n   * retaining them would result in an invalid OpenAPI definition.\n   */\n  private $refs: Set<string> = new Set();\n\n  /** Inheritance dependencies discovered by the same helper used for JSON Schema generation. */\n  private discriminatorChildrenByParentRef = new Map<string, string[]>();\n\n  /**\n   * A collection of OpenAPI tags that are used within the transformed API definition.\n   */\n  private usedTags: Set<string> = new Set();\n\n  /**\n   * A collection of OpenAPI paths and operations that are cross-referenced from any other paths\n   * and operations that we're retaining. This collection is used to ensure that those operations\n   * are retained in our resulting API definition. Not retaining them would result in an invalid\n   * OpenAPI definition.\n   *\n   * A `*` method means the entire Path Item is referenced (e.g. `$ref: '#/paths/~1pets'`).\n   */\n  private retainPathMethods: Set<`${string}|${string}`> = new Set();\n\n  /**\n   * Paths whose Path Item *fields* (parameters, servers, summary, …) are referenced without\n   * targeting a specific operation. The path container must remain even if every HTTP operation is\n   * filtered out.\n   */\n  private retainPathContainers: Set<string> = new Set();\n\n  /**\n   * A collection of OpenAPI webhook names and methods that are cross-referenced from any other\n   * schemas. This collection, like `retainPathMethods`, is used to ensure that those operations are\n   * retained in our resulting API definition. Not retaining them would result in an invalid\n   * OpenAPI definition.\n   *\n   * A `*` method means the entire webhook Path Item is referenced (e.g. `$ref: '#/webhooks/newPet'`).\n   */\n  private retainWebhookMethods: Set<`${string}|${string}`> = new Set();\n\n  /**\n   * Webhooks whose Path Item fields are referenced without targeting a specific operation.\n   */\n  private retainWebhookContainers: Set<string> = new Set();\n\n  /** An array of OpenAPI tags selected for the current transformation. */\n  private tagSelection: string[] = [];\n\n  /** A collection of operation IDs selected for the current transformation. */\n  private operationIdSelection = new Set<string>();\n\n  /** A collection of OpenAPI paths and operations selected for the current transformation. */\n  private pathSelection = new OperationSelection();\n\n  /** A collection of OpenAPI webhooks selected for the current transformation. */\n  private webhookSelection = new OperationSelection();\n\n  private hasTagSelection: boolean = false;\n  private hasOperationIdSelection: boolean = false;\n  private hasPathSelection: boolean = false;\n  private hasWebhookSelection: boolean = false;\n\n  /**\n   * @param definition OpenAPI definition to transform.\n   * @param options Transformation mode.\n   */\n  protected constructor(definition: OASDocument, options: OpenAPITransformerOptions) {\n    this.definition = structuredClone(definition);\n    this.mode = options.mode;\n\n    const { children, refs } = findDiscriminatorChildren(this.definition);\n    children.forEach((childNames, parentName) => {\n      const parentRef = refs.get(parentName);\n      if (parentRef) {\n        this.discriminatorChildrenByParentRef.set(\n          parentRef,\n          childNames.flatMap(name => refs.get(name) ?? []),\n        );\n      }\n    });\n  }\n\n  /**\n   * Select an OpenAPI tag. Operations with this tag are retained when reducing and removed when\n   * pruning. Tag casing does not matter.\n   *\n   * @param tag Tag to select.\n   */\n  protected selectTag(tag: string): void {\n    this.tagSelection.push(tag.toLowerCase());\n  }\n\n  /**\n   * Select an entire OpenAPI path and all operations that it contains. Selected paths are retained\n   * when reducing and removed when pruning. Path casing does not matter.\n   *\n   * @param path Path to select.\n   */\n  protected selectPath(path: string): void {\n    this.pathSelection.addAll(path);\n  }\n\n  /**\n   * Select a single OpenAPI operation. Selected operations are retained when reducing and removed\n   * when pruning. Path and method casing does not matter.\n   *\n   * In reduce mode, selecting an operation after its entire path replaces the all-operation\n   * selection with that operation and any operations selected afterward. Prune mode keeps the\n   * entire path selected.\n   *\n   * @param path Path containing the operation.\n   * @param method HTTP method of the operation to select.\n   */\n  protected selectOperation(path: string, method: string): void {\n    if (this.mode === 'reduce' && this.pathSelection.matchesAll(path)) {\n      this.pathSelection.clear(path);\n    }\n\n    this.pathSelection.addOperation(path, method);\n  }\n\n  /**\n   * Select an OpenAPI operation by its operation ID. IDs are matched exactly and are generated\n   * from the operation path and method when one is not authored in the definition.\n   *\n   * @param operationId Operation ID to select.\n   */\n  protected selectOperationId(operationId: string): void {\n    this.operationIdSelection.add(operationId);\n  }\n\n  /**\n   * Select an OpenAPI webhook or one of its operations. Selected webhooks are retained when\n   * reducing and removed when pruning. Webhook and method casing does not matter.\n   *\n   * @param webhookName Webhook to select.\n   * @param method Optional HTTP method of an individual webhook operation to select.\n   */\n  protected selectWebhook(webhookName: string, method?: string): void {\n    if (!method) {\n      this.webhookSelection.addAll(webhookName);\n      return;\n    }\n\n    if (this.mode === 'reduce' && this.webhookSelection.matchesAll(webhookName)) {\n      this.webhookSelection.clear(webhookName);\n    }\n\n    this.webhookSelection.addOperation(webhookName, method);\n  }\n\n  /** Transform the OpenAPI definition according to the configured mode and selections. */\n  protected transform(): OASDocument {\n    if (!this.definition.openapi) {\n      throw new Error('Sorry, only OpenAPI definitions are supported.');\n    }\n\n    this.hasTagSelection = Boolean(this.tagSelection.length);\n    this.hasOperationIdSelection = this.operationIdSelection.size > 0;\n    this.hasPathSelection = this.pathSelection.hasSelections;\n    this.hasWebhookSelection = this.webhookSelection.hasSelections;\n\n    // Retain any root-level security definitions, regardless if they're used or not on operations\n    // that we're retaining.\n    if ('security' in this.definition) {\n      Object.values(this.definition.security || {}).forEach(sec => {\n        Object.keys(sec).forEach(scheme => {\n          this.retainSecurityScheme(scheme);\n        });\n      });\n    }\n\n    this.walkPaths();\n    this.walkWebhooks();\n\n    // Recursively accumulate any components that are in use.\n    this.$refs.forEach($ref => {\n      this.accumulateUsedRefs(this.definition, this.$refs, $ref);\n    });\n\n    this.$refs.forEach(ref => {\n      this.recordPathRef(ref);\n      this.recordWebhookRef(ref);\n    });\n\n    /**\n     * @fixme Resolve referenced Path Items so their operations can be transformed individually.\n     * Targets of those `$ref`s are already retained (see `retainReferencedPathItem`).\n     */\n    this.transformPaths();\n    this.transformWebhooks();\n\n    // Require at least one path or one webhook in the result.\n    const hasPaths = Boolean(this.definition.paths && Object.keys(this.definition.paths).length);\n    const hasWebhooks = Boolean(\n      'webhooks' in this.definition && this.definition.webhooks && Object.keys(this.definition.webhooks).length,\n    );\n\n    // If we don't have any paths or webhooks left, retain the reducer's no-match error to help catch\n    // invalid selections. An empty definition is valid OpenAPI so we allow it when pruning.\n    if (this.mode === 'reduce' && !hasPaths && !hasWebhooks) {\n      throw new Error(\n        'All paths and webhooks in the API definition were removed. Did you supply the right path, operation, or webhook to reduce by?',\n      );\n    }\n\n    // Remove any unused components.\n    if ('components' in this.definition) {\n      Object.keys(this.definition.components || {}).forEach(componentType => {\n        Object.keys(this.definition.components?.[componentType as keyof ComponentsObject] || {}).forEach(component => {\n          // Authored `$ref`s JSON-Pointer-encode `/` and `~` in the component name\n          // (`foo/bar` → `foo~1bar`). Compare against that encoded form or cleanup\n          // deletes a still-referenced target.\n          const componentPointer = `#/components/${componentType}/${encodePointer(component)}`;\n          const refIsUsed =\n            this.$refs.has(componentPointer) ||\n            Array.from(this.$refs).some(ref => {\n              // Because you can have a `$ref` like `#/components/examples/event-min/value`, which\n              // would be accumulated via our `$refs` query, we want to make sure we account for them.\n              // If we don't look for these then we'll end up removing them from the transformed\n              // definition, resulting in data loss and schema corruption.\n              return ref.startsWith(`${componentPointer}/`);\n            });\n\n          if (!refIsUsed) {\n            delete this.definition.components?.[componentType as keyof ComponentsObject]?.[component];\n          }\n        });\n\n        // If this component group is now empty, delete it.\n        if (!Object.keys(this.definition.components?.[componentType as keyof ComponentsObject] || {}).length) {\n          delete this.definition.components?.[componentType as keyof ComponentsObject];\n        }\n      });\n\n      // If this path no longer has any components, delete it.\n      if (!Object.keys(this.definition.components || {}).length) {\n        delete this.definition.components;\n      }\n    }\n\n    // Remove any unused tags.\n    if ('tags' in this.definition) {\n      this.definition.tags = (this.definition.tags ?? []).filter((tag): tag is TagObject => {\n        return Boolean(tag) && this.usedTags.has(tag.name);\n      });\n\n      if (!this.definition.tags?.length) {\n        delete this.definition.tags;\n      }\n    }\n\n    return this.definition;\n  }\n\n  /**\n   * Recursively process a `$ref` pointer and accumulate any other `$ref` pointers that it or its\n   * children use. This handles circular references by skipping `$ref` pointers we have already seen.\n   * Additionally when a `$ref` points to `#/paths` we record the used path + method so we can\n   * retain cross-operation references within the transformed definition.\n   *\n   * @param schema JSON Schema object to look for and accumulate any `$ref` pointers that it may have.\n   * @param $refs Known set of `$ref` pointers.\n   * @param $ref `$ref` pointer to fetch a schema from out of the supplied schema.\n   */\n  private accumulateUsedRefs(schema: Record<string, unknown>, $refs: Set<string>, $ref: string): void {\n    // Record `$ref` pointers aimed at `#/paths` or `#/webhooks` so we can retain any\n    // cross-operation or Path Item references.\n    this.recordPathRef($ref);\n    this.recordWebhookRef($ref);\n\n    let $refSchema: unknown;\n    if (typeof $ref === 'string') $refSchema = jsonPointer.get(schema, $ref.substring(1));\n    if ($refSchema === undefined) {\n      // If the schema we have wasn't fully dereferenced or bundled for whatever reason and this\n      // `$ref` that we have doesn't exist here we shouldn't try to search for more `$ref` pointers\n      // in a schema that doesn't exist.\n      return;\n    }\n\n    const referencedValues = this.queryForRefPointers($refSchema).map(({ value }) => value);\n    // allOf children point back to their parent, so ordinary forward $ref traversal misses them.\n    referencedValues.push(...(this.discriminatorChildrenByParentRef.get($ref) ?? []));\n\n    referencedValues.forEach(currRef => {\n      // Because it's possible to have a schema property named `$ref` that is not a `$ref` pointer,\n      // which our JSONPath query would pick up as a false positive, we want to exclude that from\n      // `$ref` matching as it's not a reference pointer.\n      const foundRef = this.toRefString(currRef);\n      if (!foundRef) {\n        return;\n      }\n\n      // If we've already processed this `$ref` then don't send us into an infinite loop of processing\n      // circular references.\n      if ($refs.has(foundRef)) {\n        return;\n      }\n\n      $refs.add(foundRef);\n      this.accumulateUsedRefs(schema, $refs, foundRef);\n    });\n  }\n\n  /**\n   * Query a JSON Schema object for any `$ref` pointers using JSONPath and return any pointers that\n   * exist.\n   *\n   * @see {@link https://datatracker.ietf.org/doc/html/rfc9535}\n   * @param schema JSON Schema object to look for any `$ref` pointers within it.\n   */\n  private queryForRefPointers(schema: any) {\n    return query([\"$..['$ref']\"], schema);\n  }\n\n  /**\n   * Normalize a value from a `jsonpath-plus` `$ref` query to a `$ref` pointer because JSONPath\n   * queries may return the property value or the parent.\n   *\n   */\n  private toRefString(value: unknown): string | null {\n    if (typeof value === 'string') {\n      return value;\n    } else if (value && typeof value === 'object' && '$ref' in value && typeof value.$ref === 'string') {\n      return value.$ref;\n    }\n\n    return null;\n  }\n\n  /**\n   * If the given `$ref` points into a path, classify how that path must be retained:\n   *\n   * - `#/paths/~1pets` — the entire Path Item (operations included)\n   * - `#/paths/~1pets/get/...` — a single operation\n   * - `#/paths/~1pets/parameters/...` — a Path Item field, so the container must remain\n   */\n  private parsePathRef(\n    $ref: string,\n  ):\n    | { path: string; retention: 'all' }\n    | { path: string; retention: 'operation'; method: string }\n    | { path: string; retention: 'container' }\n    | null {\n    if (typeof $ref !== 'string' || !$ref.startsWith('#/paths/')) {\n      return null;\n    }\n\n    const match = $ref.match(/^#\\/paths\\/([^/]+)(?:\\/([^/]+))?(?:\\/|$)/);\n    if (!match?.[1]) {\n      return null;\n    }\n\n    const path = decodePointer(match[1]);\n    const segment = match[2];\n    if (!segment) {\n      return { path, retention: 'all' };\n    }\n\n    if (supportedMethods.includes(segment.toLowerCase() as HttpMethods)) {\n      return { path, method: segment, retention: 'operation' };\n    }\n\n    return { path, retention: 'container' };\n  }\n\n  /**\n   * If the given `$ref` points into webhooks, classify how that webhook must be retained. Same\n   * retention rules as {@link parsePathRef}.\n   */\n  private parseWebhookRef(\n    $ref: string,\n  ):\n    | { name: string; retention: 'all' }\n    | { name: string; retention: 'operation'; method: string }\n    | { name: string; retention: 'container' }\n    | null {\n    if (typeof $ref !== 'string' || !$ref.startsWith('#/webhooks/')) {\n      return null;\n    }\n\n    const match = $ref.match(/^#\\/webhooks\\/([^/]+)(?:\\/([^/]+))?(?:\\/|$)/);\n    if (!match?.[1]) {\n      return null;\n    }\n\n    const name = decodePointer(match[1]);\n    const segment = match[2];\n    if (!segment) {\n      return { name, retention: 'all' };\n    }\n\n    if (supportedMethods.includes(segment.toLowerCase() as HttpMethods)) {\n      return { name, method: segment, retention: 'operation' };\n    }\n\n    return { name, retention: 'container' };\n  }\n\n  /**\n   * If a Path Item we must keep is itself a `$ref`, retain that target and walk it for further\n   * `$ref`s. `#/paths/~1foo/get/…` (and the webhook equivalent) do not resolve through a\n   * ref-only `/foo` via JSON Pointer, so without this the component is deleted while `/foo`\n   * remains as a dangling `$ref`.\n   */\n  private retainReferencedPathItem(pathItem: PathItemObject | undefined): void {\n    if (!isRef(pathItem) || this.$refs.has(pathItem.$ref)) {\n      return;\n    }\n\n    this.$refs.add(pathItem.$ref);\n    this.accumulateUsedRefs(this.definition, this.$refs, pathItem.$ref);\n  }\n\n  /**\n   * Record a security scheme so component cleanup keeps it. Scheme names are JSON-Pointer-encoded\n   * so they match the same form used for authored `$ref`s (`foo/bar` → `foo~1bar`).\n   */\n  private retainSecurityScheme(scheme: string): void {\n    this.$refs.add(`#/components/securitySchemes/${encodePointer(scheme)}`);\n  }\n\n  /** Record a `#/paths` `$ref` so the target Path Item or operation is not dropped. */\n  private recordPathRef($ref: string): void {\n    const parsed = this.parsePathRef($ref);\n    if (!parsed) {\n      return;\n    }\n\n    const pathLC = parsed.path.toLowerCase();\n    if (parsed.retention === 'all') {\n      this.retainPathMethods.add(`${pathLC}|*`);\n    } else if (parsed.retention === 'operation') {\n      this.retainPathMethods.add(`${pathLC}|${parsed.method.toLowerCase()}`);\n    } else if (!this.retainPathContainers.has(pathLC)) {\n      // Field-level pointers keep every sibling Path Item field, so walk those fields for\n      // component `$ref`s. Traversing only the pointed-to entry would let component cleanup\n      // delete a sibling's target and leave a dangling pointer.\n      this.retainPathContainers.add(pathLC);\n      this.accumulateContainerFieldRefs(this.findPathItem(parsed.path));\n    }\n\n    this.retainReferencedPathItem(this.findPathItem(parsed.path));\n  }\n\n  /** Record a `#/webhooks` `$ref` so the target webhook Path Item or operation is not dropped. */\n  private recordWebhookRef($ref: string): void {\n    const parsed = this.parseWebhookRef($ref);\n    if (!parsed) {\n      return;\n    }\n\n    const nameLC = parsed.name.toLowerCase();\n    if (parsed.retention === 'all') {\n      this.retainWebhookMethods.add(`${nameLC}|*`);\n    } else if (parsed.retention === 'operation') {\n      this.retainWebhookMethods.add(`${nameLC}|${parsed.method.toLowerCase()}`);\n    } else if (!this.retainWebhookContainers.has(nameLC)) {\n      this.retainWebhookContainers.add(nameLC);\n      this.accumulateContainerFieldRefs(this.findWebhook(parsed.name));\n    }\n\n    this.retainReferencedPathItem(this.findWebhook(parsed.name));\n  }\n\n  /** Look up a Path Item by its path, ignoring key casing. */\n  private findPathItem(path: string): PathItemObject | undefined {\n    const pathLC = path.toLowerCase();\n    const key = Object.keys(this.definition.paths || {}).find(candidate => candidate.toLowerCase() === pathLC);\n    return key ? this.definition.paths?.[key] : undefined;\n  }\n\n  /** Look up a webhook Path Item by name, ignoring key casing. */\n  private findWebhook(name: string): PathItemObject | undefined {\n    if (!isOpenAPI31(this.definition) || !this.definition.webhooks) {\n      return undefined;\n    }\n\n    const nameLC = name.toLowerCase();\n    const key = Object.keys(this.definition.webhooks).find(candidate => candidate.toLowerCase() === nameLC);\n    return key ? (this.definition.webhooks[key] as PathItemObject | undefined) : undefined;\n  }\n\n  /**\n   * Accumulate `$ref` pointers from the Path Item fields we keep when a container is retained\n   * (parameters, servers, summary, … — everything except HTTP operations).\n   */\n  private accumulateContainerFieldRefs(pathItem: PathItemObject | undefined): void {\n    if (!pathItem) {\n      return;\n    }\n\n    if (isRef(pathItem)) {\n      this.$refs.add(pathItem.$ref);\n      this.accumulateUsedRefs(this.definition, this.$refs, pathItem.$ref);\n      return;\n    }\n\n    Object.entries(pathItem).forEach(([key, value]) => {\n      if (supportedMethods.includes(key.toLowerCase() as HttpMethods) || value === undefined) {\n        return;\n      }\n\n      this.queryForRefPointers(value).forEach(({ value: ref }) => {\n        const refStr = this.toRefString(ref);\n        if (!refStr) {\n          return;\n        }\n\n        this.$refs.add(refStr);\n        this.accumulateUsedRefs(this.definition, this.$refs, refStr);\n      });\n    });\n  }\n\n  /** Whether any `$ref` requires this path (or one of its operations) to remain. */\n  private isPathRetainedByRef(pathLC: string): boolean {\n    return (\n      this.retainPathContainers.has(pathLC) ||\n      Array.from(this.retainPathMethods).some(key => key.startsWith(`${pathLC}|`))\n    );\n  }\n\n  /** Whether a `$ref` requires this specific path operation — or the entire Path Item — to remain. */\n  private isPathOperationRetainedByRef(pathLC: string, methodLC: string): boolean {\n    return this.retainPathMethods.has(`${pathLC}|*`) || this.retainPathMethods.has(`${pathLC}|${methodLC}`);\n  }\n\n  /**\n   * Whether the path container must remain after its operations have been filtered. Whole-path\n   * `$ref`s also keep the container (and its operations).\n   */\n  private isPathContainerKept(pathLC: string): boolean {\n    return this.retainPathContainers.has(pathLC) || this.retainPathMethods.has(`${pathLC}|*`);\n  }\n\n  /** Whether any `$ref` requires this webhook (or one of its operations) to remain. */\n  private isWebhookRetainedByRef(nameLC: string): boolean {\n    return (\n      this.retainWebhookContainers.has(nameLC) ||\n      Array.from(this.retainWebhookMethods).some(key => key.startsWith(`${nameLC}|`))\n    );\n  }\n\n  /** Whether a `$ref` requires this specific webhook operation — or the entire webhook — to remain. */\n  private isWebhookOperationRetainedByRef(nameLC: string, methodLC: string): boolean {\n    return this.retainWebhookMethods.has(`${nameLC}|*`) || this.retainWebhookMethods.has(`${nameLC}|${methodLC}`);\n  }\n\n  /**\n   * Whether the webhook container must remain after its operations have been filtered.\n   */\n  private isWebhookContainerKept(nameLC: string): boolean {\n    return this.retainWebhookContainers.has(nameLC) || this.retainWebhookMethods.has(`${nameLC}|*`);\n  }\n\n  /** Determine whether a path or webhook is excluded in the current transformation mode. */\n  private isContainerExcluded(selection: OperationSelection, key: string): boolean {\n    if (this.mode === 'prune') {\n      return selection.matchesAll(key);\n    }\n\n    return !selection.has(key);\n  }\n\n  /**\n   * Determine whether an operation passes the configured filters before cross-operation references\n   * are considered.\n   */\n  private shouldRetainOperation(\n    selection: OperationSelection,\n    key: string,\n    method: string,\n    operation: OperationObject,\n  ): boolean {\n    if (this.mode === 'reduce') {\n      // Reduction filters intersect, so an operation must match every configured filter.\n      if (selection.hasSelections && !selection.matches(key, method)) return false;\n      if (\n        this.hasOperationIdSelection &&\n        !this.operationIdSelection.has(Operation.getOperationId(key, method, operation))\n      ) {\n        return false;\n      }\n      if (this.hasTagSelection && !(operation.tags || []).some(tag => this.tagSelection.includes(tag.toLowerCase()))) {\n        return false;\n      }\n    } else {\n      // Pruning filters are additive, so matching any configured filter removes an operation.\n      if (selection.hasSelections && selection.matches(key, method)) return false;\n      if (\n        this.hasOperationIdSelection &&\n        this.operationIdSelection.has(Operation.getOperationId(key, method, operation))\n      ) {\n        return false;\n      }\n      if (this.hasTagSelection && (operation.tags || []).some(tag => this.tagSelection.includes(tag.toLowerCase()))) {\n        return false;\n      }\n    }\n\n    // No configured filter excluded this operation, so retain it in the transformed definition.\n    return true;\n  }\n\n  /** Determine whether a path item contains at least one HTTP operation. */\n  private hasOperations(pathItem: PathItemObject | undefined): boolean {\n    return Boolean(pathItem && supportedMethods.some(method => method in pathItem));\n  }\n\n  /**\n   * Accumulate any `$ref` pointers that are used by common Path Item parameters.\n   *\n   * @param parameters Common Path Item parameters to inspect for `$ref` pointers.\n   */\n  private accumulateParameterRefs(parameters: PathItemObject['parameters'] | undefined): void {\n    if (!parameters) {\n      return;\n    }\n\n    this.queryForRefPointers(parameters).forEach(({ value: ref }) => {\n      const refStr = this.toRefString(ref);\n      if (!refStr) {\n        return;\n      }\n\n      this.$refs.add(refStr);\n      this.accumulateUsedRefs(this.definition, this.$refs, refStr);\n    });\n  }\n\n  /**\n   * Walk through the `paths` in our OpenAPI definition and determine which operations we want to\n   * retain. Accumulate any `$ref` pointers that they use so their referenced schemas can also be\n   * retained in our resulting API definition.\n   *\n   */\n  private walkPaths(): void {\n    if (!('paths' in this.definition) || !this.definition.paths) {\n      return;\n    }\n\n    Object.keys(this.definition.paths).forEach(path => {\n      // When only webhooks were requested (no path/operation filter), ignore all paths, but don't\n      // delete them yet because a selected webhook may reference one of their operations. We'll\n      // remove any that aren't referenced later.\n      if (this.mode === 'reduce' && this.hasWebhookSelection && !this.hasPathSelection) {\n        return;\n      } else if (this.hasPathSelection && this.isContainerExcluded(this.pathSelection, path)) {\n        return;\n      }\n\n      const pathItem = this.definition.paths?.[path];\n\n      /**\n       * Referenced Path Items that remain in the result are preserved intact rather than partially\n       * transformed. Retain the target and continue walking any local sibling fields so that we\n       * retain their dependencies too.\n       * @fixme Resolve referenced Path Items so their operations can be transformed individually.\n       */\n      if (isRef(pathItem)) {\n        this.$refs.add(pathItem.$ref);\n        this.accumulateUsedRefs(this.definition, this.$refs, pathItem.$ref);\n      }\n\n      // If this Path Item has no operations then it will remain in our resulting API definition,\n      // so we need to retain any components referenced by its common parameters.\n      if (!this.hasOperations(pathItem)) {\n        this.accumulateParameterRefs(pathItem?.parameters);\n      }\n\n      Object.keys(pathItem || {}).forEach(method => {\n        // Only process operations and retain any common path-level common properties like\n        // `parameters`, `servers`, `summary`, etc.\n        if (method === 'parameters' || !supportedMethods.includes(method.toLowerCase() as HttpMethods)) {\n          return;\n        }\n\n        const operation = (this.definition.paths?.[path] as PathItemObject | undefined)?.[\n          method as HttpMethods\n        ] as OperationObject;\n        if (!operation) {\n          throw new Error(`Operation \\`${method} ${path}\\` not found`);\n        }\n\n        // If this operation isn't part of our resulting API definition then ignore it. We'll\n        // remove it later.\n        if (!this.shouldRetainOperation(this.pathSelection, path, method, operation)) {\n          return;\n        }\n\n        (operation.tags || []).forEach((tag: string) => {\n          this.usedTags.add(tag);\n        });\n\n        // Skipped by the `method === 'parameters'` guard above; accumulate here so refs are only\n        // retained when at least one operation on this path passes all filters.\n        this.accumulateParameterRefs(pathItem?.parameters);\n\n        this.queryForRefPointers(operation).forEach(({ value: ref }) => {\n          const refStr = this.toRefString(ref);\n          if (!refStr) {\n            return;\n          }\n\n          this.$refs.add(refStr);\n\n          // Re-run through any `$ref` pointers that we found within this operation and search for\n          // any `$ref` pointers that they also may be using. This also records `#/paths` and\n          // `#/webhooks` targets so they are retained.\n          this.accumulateUsedRefs(this.definition, this.$refs, refStr);\n        });\n\n        Object.values(operation.security || {}).forEach(sec => {\n          Object.keys(sec).forEach(scheme => {\n            this.retainSecurityScheme(scheme);\n          });\n        });\n      });\n    });\n  }\n\n  /**\n   * Walk through the `webhooks` in our OpenAPI definition and determine which operations we want\n   * to retain. Accumulate any `$ref` pointers that they use so their referenced schemas can also be\n   * retained in our resulting API definition.\n   *\n   */\n  private walkWebhooks() {\n    if (!isOpenAPI31(this.definition)) {\n      return;\n    } else if (!('webhooks' in this.definition) || !this.definition.webhooks) {\n      return;\n    }\n\n    const definition = this.definition satisfies OpenAPIV3_1.Document;\n\n    Object.keys(definition.webhooks || {}).forEach(webhookName => {\n      if (this.hasWebhookSelection && this.isContainerExcluded(this.webhookSelection, webhookName)) {\n        return;\n      }\n\n      const webhook: PathItemObject | undefined = definition.webhooks?.[webhookName];\n      if (!webhook || typeof webhook !== 'object') {\n        return;\n      }\n\n      /**\n       * Referenced webhook Path Items that remain in the result are preserved intact rather than\n       * partially transformed. Retain the target and continue walking any local sibling fields so\n       * that we retain their dependencies too.\n       * @fixme Resolve referenced Path Items so their operations can be transformed individually.\n       */\n      if (typeof webhook.$ref === 'string') {\n        this.$refs.add(webhook.$ref);\n        this.accumulateUsedRefs(definition, this.$refs, webhook.$ref);\n      }\n\n      // If this webhook has no operations then it will remain in our resulting API definition, so\n      // we need to retain any components referenced by its common parameters.\n      if (!this.hasOperations(webhook)) {\n        this.accumulateParameterRefs(webhook.parameters);\n      }\n\n      Object.keys(webhook).forEach(method => {\n        // Only process operations and retain any common path-level common properties like\n        // `parameters`, `servers`, `summary`, etc.\n        if (method === 'parameters' || !supportedMethods.includes(method.toLowerCase() as HttpMethods)) {\n          return;\n        }\n\n        const operation = webhook[method as HttpMethods] as OperationObject;\n        if (!operation) {\n          throw new Error(`Webhook operation \\`${method} ${webhookName}\\` not found`);\n        }\n\n        // If this operation isn't part of our resulting API definition then ignore it. We'll\n        // remove it later.\n        if (!this.shouldRetainOperation(this.webhookSelection, webhookName, method, operation)) {\n          return;\n        }\n\n        (operation.tags || []).forEach((tag: string) => {\n          this.usedTags.add(tag);\n        });\n\n        // Skipped by the `method === 'parameters'` guard above; accumulate here so refs are only\n        // retained when at least one operation on this webhook passes all filters.\n        this.accumulateParameterRefs(webhook.parameters);\n\n        this.queryForRefPointers(operation).forEach(({ value: ref }) => {\n          const refStr = this.toRefString(ref);\n          if (!refStr) {\n            return;\n          }\n\n          this.$refs.add(refStr);\n          this.accumulateUsedRefs(definition, this.$refs, refStr);\n        });\n\n        Object.values(operation.security || {}).forEach(sec => {\n          Object.keys(sec).forEach(scheme => {\n            this.retainSecurityScheme(scheme);\n          });\n        });\n      });\n    });\n  }\n\n  /**\n   * Transform our `paths` object according to the paths and operations that we've selected.\n   */\n  private transformPaths(): void {\n    if (!('paths' in this.definition) || !this.definition.paths) {\n      return;\n    }\n\n    Object.keys(this.definition.paths).forEach(path => {\n      const pathLC = path.toLowerCase();\n      const excludePathItem =\n        (this.hasPathSelection && this.isContainerExcluded(this.pathSelection, path)) ||\n        (this.mode === 'reduce' && this.hasWebhookSelection && !this.hasPathSelection);\n\n      if (this.mode === 'prune' && excludePathItem) {\n        if (this.isPathRetainedByRef(pathLC)) {\n          throw new Error(`Cannot remove path \\`${path}\\` because one of its operations is referenced.`);\n        }\n\n        delete this.definition.paths?.[path];\n        return;\n      }\n\n      const pathItem = this.definition.paths?.[path];\n\n      /**\n       * Referenced Path Items are preserved intact during operation-level filtering. If the whole\n       * Path Item is excluded, remove it unless a surviving operation references it.\n       * @fixme Resolve referenced Path Items so their operations can be transformed individually.\n       */\n      if (isRef(pathItem)) {\n        if (excludePathItem && !this.isPathRetainedByRef(pathLC)) {\n          delete this.definition.paths?.[path];\n        }\n\n        return;\n      }\n\n      // `PathItemObject` also describes the OpenAPI 3.2 `query` operation.\n      const pathOperations: PathItemObject | undefined = pathItem;\n      let removedOperation = false;\n      Object.keys(pathItem || {}).forEach(method => {\n        const methodLC = method.toLowerCase();\n\n        // Only process operations and retain any common path-level common properties like\n        // `parameters`, `servers`, `summary`, etc.\n        if (method === 'parameters' || !supportedMethods.includes(methodLC as HttpMethods)) {\n          return;\n        }\n\n        const retainedByRef = this.isPathOperationRetainedByRef(pathLC, methodLC);\n\n        const operation = pathOperations?.[method as HttpMethods];\n        if (!operation) {\n          throw new Error(`Operation \\`${method} ${path}\\` not found`);\n        }\n\n        if (excludePathItem || !this.shouldRetainOperation(this.pathSelection, path, method, operation)) {\n          if (this.mode === 'prune' && retainedByRef) {\n            throw new Error(`Cannot remove operation \\`${method.toUpperCase()} ${path}\\` because it is referenced.`);\n          }\n\n          if (!retainedByRef) {\n            delete pathOperations?.[method as HttpMethods];\n            removedOperation = true;\n            return;\n          }\n        }\n\n        // This operation remains in the transformed definition, so retain any components\n        // referenced by its common Path Item parameters.\n        this.accumulateParameterRefs(pathItem?.parameters);\n\n        // Accumulate a list of used tags so we can filter out any ones that we don't need later.\n        if ('tags' in operation) {\n          operation.tags?.forEach((tag: string) => {\n            this.usedTags.add(tag);\n          });\n        }\n\n        // Accumulate any used operation-level security schemas that we need to retain.\n        if ('security' in operation) {\n          Object.values(operation.security || {}).forEach(sec => {\n            Object.keys(sec).forEach(scheme => {\n              this.retainSecurityScheme(scheme);\n            });\n          });\n        }\n      });\n\n      // If filtering removed every operation from this path then remove its path-level properties\n      // as well. We leave path items that were authored without operations untouched.\n      if (\n        !this.isPathContainerKept(pathLC) &&\n        (((removedOperation || (this.mode === 'reduce' && excludePathItem)) && !this.hasOperations(pathItem)) ||\n          (this.mode === 'reduce' && !Object.keys(this.definition.paths?.[path] || {}).length))\n      ) {\n        delete this.definition.paths?.[path];\n      }\n    });\n\n    // If we don't have any paths left then retain the reducer's no-match error. An empty Paths\n    // Object is valid OpenAPI so we allow it when pruning.\n    if (!Object.keys(this.definition.paths || {}).length) {\n      if (this.mode === 'reduce' && !(this.definition.webhooks && Object.keys(this.definition.webhooks).length)) {\n        throw new Error(\n          'All paths in the API definition were removed. Did you supply the right path name to reduce by?',\n        );\n      }\n\n      if (this.definition.webhooks && Object.keys(this.definition.webhooks).length) {\n        delete this.definition.paths;\n      }\n    }\n  }\n\n  /**\n   * Transform our `webhooks` object according to the webhooks and operations that we've selected.\n   */\n  private transformWebhooks(): void {\n    if (!isOpenAPI31(this.definition)) {\n      return;\n    } else if (!('webhooks' in this.definition) || !this.definition.webhooks) {\n      return;\n    }\n\n    const definition = this.definition satisfies OpenAPIV3_1.Document;\n\n    Object.keys(definition.webhooks || {}).forEach(webhookName => {\n      const nameLC = webhookName.toLowerCase();\n      const excludeWebhook = this.hasWebhookSelection && this.isContainerExcluded(this.webhookSelection, webhookName);\n\n      if (this.mode === 'prune' && excludeWebhook) {\n        if (this.isWebhookRetainedByRef(nameLC)) {\n          throw new Error(`Cannot remove webhook \\`${webhookName}\\` because one of its operations is referenced.`);\n        }\n\n        delete definition.webhooks?.[webhookName];\n        return;\n      }\n\n      const webhook = definition.webhooks?.[webhookName];\n      if (!webhook || typeof webhook !== 'object') {\n        return;\n      }\n\n      /**\n       * Referenced webhook Path Items are preserved intact during operation-level filtering. If\n       * the whole webhook is excluded, remove it unless a surviving operation references it.\n       * @fixme Resolve referenced Path Items so their operations can be transformed individually.\n       */\n      if (isRef(webhook)) {\n        if (excludeWebhook && !this.isWebhookRetainedByRef(nameLC)) {\n          delete definition.webhooks?.[webhookName];\n        }\n\n        return;\n      }\n\n      // `PathItemObject` also describes the OpenAPI 3.2 `query` operation.\n      const webhookOperations: PathItemObject = webhook;\n      let removedOperation = false;\n      Object.keys(webhook).forEach(method => {\n        const methodLC = method.toLowerCase();\n        if (method === 'parameters' || !supportedMethods.includes(methodLC as HttpMethods)) {\n          return;\n        }\n\n        const operation = webhookOperations[method as HttpMethods];\n        if (!operation) {\n          throw new Error(`Webhook operation \\`${method} ${webhookName}\\` not found`);\n        }\n\n        const retainedByRef = this.isWebhookOperationRetainedByRef(nameLC, methodLC);\n        if (excludeWebhook || !this.shouldRetainOperation(this.webhookSelection, webhookName, method, operation)) {\n          if (this.mode === 'prune' && retainedByRef) {\n            throw new Error(\n              `Cannot remove operation \\`${method.toUpperCase()} ${webhookName}\\` because it is referenced.`,\n            );\n          }\n\n          if (!retainedByRef) {\n            delete webhookOperations[method as HttpMethods];\n            removedOperation = true;\n            return;\n          }\n        }\n\n        // This operation remains in the transformed definition, so retain any components\n        // referenced by its common Path Item parameters.\n        this.accumulateParameterRefs(webhook.parameters);\n\n        (operation.tags || []).forEach((tag: string) => {\n          this.usedTags.add(tag);\n        });\n\n        Object.values(operation.security || {}).forEach(sec => {\n          Object.keys(sec).forEach(scheme => {\n            this.retainSecurityScheme(scheme);\n          });\n        });\n      });\n\n      if (\n        !this.isWebhookContainerKept(nameLC) &&\n        (((removedOperation || (this.mode === 'reduce' && excludeWebhook)) && !this.hasOperations(webhook)) ||\n          (this.mode === 'reduce' && !Object.keys(definition.webhooks?.[webhookName] || {}).length))\n      ) {\n        delete definition.webhooks?.[webhookName];\n      }\n    });\n\n    if (definition.webhooks && !Object.keys(definition.webhooks).length) {\n      delete definition.webhooks;\n    }\n  }\n}\n","/**\n * Track selected HTTP operations within OpenAPI paths or webhooks. Container keys and HTTP methods\n * are matched without regard to casing.\n */\nexport class OperationSelection {\n  private selections: Map<string, '*' | Set<string>> = new Map();\n\n  /** Whether any paths or webhooks have been selected. */\n  get hasSelections(): boolean {\n    return this.selections.size > 0;\n  }\n\n  /**\n   * Select every operation within a path or webhook.\n   *\n   * @param key Path or webhook key whose operations should be selected.\n   */\n  addAll(key: string): void {\n    this.selections.set(this.normalize(key), '*');\n  }\n\n  /**\n   * Add an operation to the selection for a path or webhook. If every operation for the key is\n   * already selected, that selection remains unchanged.\n   *\n   * @param key Path or webhook key that contains the operation.\n   * @param method HTTP method of the operation to select.\n   */\n  addOperation(key: string, method: string): void {\n    const normalizedKey = this.normalize(key);\n    const normalizedMethod = this.normalize(method);\n    const selection = this.selections.get(normalizedKey);\n\n    if (selection === '*') {\n      return;\n    }\n\n    if (selection instanceof Set) {\n      selection.add(normalizedMethod);\n      return;\n    }\n\n    this.selections.set(normalizedKey, new Set([normalizedMethod]));\n  }\n\n  /**\n   * Clear every operation selection for a path or webhook.\n   *\n   * @param key Path or webhook key to clear.\n   */\n  clear(key: string): void {\n    this.selections.delete(this.normalize(key));\n  }\n\n  /**\n   * Determine whether a path or webhook has any selected operations.\n   *\n   * @param key Path or webhook key to check.\n   */\n  has(key: string): boolean {\n    return this.selections.has(this.normalize(key));\n  }\n\n  /**\n   * Determine whether every operation within a path or webhook is selected.\n   *\n   * @param key Path or webhook key to check.\n   */\n  matchesAll(key: string): boolean {\n    return this.selections.get(this.normalize(key)) === '*';\n  }\n\n  /**\n   * Determine whether an operation is selected.\n   *\n   * @param key Path or webhook key that contains the operation.\n   * @param method HTTP method of the operation to check.\n   */\n  matches(key: string, method: string): boolean {\n    const selection = this.selections.get(this.normalize(key));\n    return selection === '*' || Boolean(selection?.has(this.normalize(method)));\n  }\n\n  /** Normalize path, webhook, and method casing for comparisons. */\n  private normalize(value: string): string {\n    return value.toLowerCase();\n  }\n}\n"]}

package/dist/{chunk-S333SATE.js → chunk-E6QPSOEQ.js}

@@ -467,7 +467,39 @@ function isPolymorphicSchema(schema) {
 function formatEnumDescription(values) {
   return values.filter((value) => value !== void 0 && (typeof value !== "string" || value.trim() !== "")).map((value) => `\`${value}\``).join(" ");
 }
-function withoutGeneratedEnumDescription(schema) {
+function appendEnumDescription(description, enumValues) {
+  const enums = formatEnumDescription(enumValues);
+  if (!enums.length) {
+    return void 0;
+  }
+  const currentDescription = typeof description === "string" ? description : "";
+  if (!currentDescription) {
+    return enums;
+  }
+  const paragraphs = currentDescription.split(/\n\n+/).map((p) => p.trim());
+  const enumParagraphCount = paragraphs.filter((p) => p === enums).length;
+  if (enumParagraphCount > 1) {
+    const withoutEnum = paragraphs.filter((p) => p !== enums);
+    return withoutEnum.length > 0 ? `${withoutEnum.join("\n\n")}
+
+${enums}` : enums;
+  } else if (enumParagraphCount === 1) {
+    return currentDescription;
+  }
+  return `${currentDescription}
+
+${enums}`;
+}
+function withoutGeneratedEnumDescription(original) {
+  const schema = isObject(original.properties) ? {
+    ...original,
+    properties: Object.fromEntries(
+      Object.entries(original.properties).map(([key, value]) => [
+        key,
+        isObject(value) ? withoutGeneratedEnumDescription(value) : value
+      ])
+    )
+  } : original;
   if (!Array.isArray(schema.enum) || typeof schema.description !== "string") {
     return schema;
   }
@@ -866,6 +898,27 @@ function toJSONSchema(data, opts) {
       const { $ref: _$ref, properties: _propertiesWithRef, ...siblings } = schema;
       if (Object.keys(siblings).length > 0) {
         convertExamples(siblings);
+        if (addEnumsToDescriptions && typeof siblings.description === "string") {
+          let target = isRef(resolved) ? usedSchemas.get(schema.$ref) : resolved;
+          let enumValues = siblings.enum;
+          const followedRefs = /* @__PURE__ */ new Set();
+          while (enumValues === void 0 && target && !isPendingSchema(target)) {
+            if ("enum" in target) {
+              enumValues = target.enum;
+            } else if (isRef(target) && !followedRefs.has(target.$ref)) {
+              followedRefs.add(target.$ref);
+              target = usedSchemas.get(target.$ref);
+              continue;
+            }
+            break;
+          }
+          if (Array.isArray(enumValues)) {
+            const description = appendEnumDescription(siblings.description, enumValues);
+            if (description !== void 0) {
+              siblings.description = description;
+            }
+          }
+        }
         return { ...resolved, ...siblings };
       }
       return resolved;
@@ -949,14 +1002,12 @@ function toJSONSchema(data, opts) {
           }
           return toJSONSchema(item, allOfOptions);
         });
+        const conflictPaths = collectConflictPaths(allOfSchemas, usedSchemas);
+        allOfSchemas = allOfSchemas.map((s) => inlinePropertyRefsForMerge(s, usedSchemas, refLogger, conflictPaths));
         if (addEnumsToDescriptions) {
           allOfSchemas = allOfSchemas.map(withoutGeneratedEnumDescription);
         }
-        const conflictPaths = collectConflictPaths(allOfSchemas, usedSchemas);
-        schema = {
-          ...schema,
-          allOf: allOfSchemas.map((s) => inlinePropertyRefsForMerge(s, usedSchemas, refLogger, conflictPaths))
-        };
+        schema = { ...schema, allOf: allOfSchemas };
       }
       try {
         schema = mergeJSONSchemaAllOf(schema, mergeAllOfSchemasOptions);
@@ -1310,26 +1361,9 @@ function toJSONSchema(data, opts) {
   if (isSchema(schema, isPolymorphicAllOfChild) && "enum" in schema && Array.isArray(schema.enum)) {
     schema.enum = Array.from(new Set(schema.enum));
     if (addEnumsToDescriptions) {
-      const enums = formatEnumDescription(schema.enum);
-      if (enums.length) {
-        const currentDescription = "description" in schema && typeof schema.description === "string" ? schema.description : "";
-        if (!currentDescription) {
-          schema.description = enums;
-        } else {
-          const paragraphs = currentDescription.split(/\n\n+/).map((p) => p.trim());
-          const enumParagraphCount = paragraphs.filter((p) => p === enums).length;
-          if (enumParagraphCount > 1) {
-            const withoutEnum = paragraphs.filter((p) => p !== enums);
-            schema.description = withoutEnum.length > 0 ? `${withoutEnum.join("\n\n")}
-
-${enums}` : enums;
-          } else if (paragraphs.some((p) => p === enums)) {
-          } else {
-            schema.description = `${currentDescription}
-
-${enums}`;
-          }
-        }
+      const description = appendEnumDescription(schema.description, schema.enum);
+      if (description !== void 0) {
+        schema.description = description;
       }
     }
   }
@@ -1583,8 +1617,8 @@ function getParametersAsJSONSchema(operation, api, opts) {
 }
 
 // src/utils.ts
+import { SERVER_VARIABLE_REGEX } from "@readme/openapi-parser/lib/urls";
 var supportedMethods = ["get", "put", "post", "delete", "options", "head", "patch", "trace", "query"];
-var SERVER_VARIABLE_REGEX = /{([-_a-zA-Z0-9:.[\]]+)}/g;
 
 export {
   isObject,
@@ -1610,4 +1644,4 @@ export {
   supportedMethods,
   SERVER_VARIABLE_REGEX
 };
-//# sourceMappingURL=chunk-S333SATE.js.map
+//# sourceMappingURL=chunk-E6QPSOEQ.js.map