@skmtc/core 0.0.595 → 0.0.596

package/esm/context/ParseContext.d.ts

@@ -2,7 +2,7 @@ import "../_dnt.polyfills.js";
 import type { OpenAPIV3 } from 'openapi-types';
 import { OasDocument } from '../oas/document/Document.js';
 import type * as log from '../deps/jsr.io/@std/log/0.224.8/mod.js';
-import type { StackTrail } from './StackTrail.js';
+import type { StackTrail, TraceOptions } from './StackTrail.js';
 type ConstructorArgs = {
     documentObject: OpenAPIV3.Document;
     logger: log.Logger;
@@ -18,7 +18,7 @@ export declare class ParseContext {
     stackTrail: StackTrail;
     constructor({ documentObject, logger, stackTrail }: ConstructorArgs);
     parse(): OasDocument;
-    trace<T>(token: string | string[], fn: () => T): T;
+    trace<T>(token: string | string[], fn: () => T, options?: TraceOptions): T;
     logSkippedFields(skipped: Record<string, unknown>): void;
 }
 export declare const parseSchema: (schema: string) => OpenAPIV3.Document<{}>;

package/esm/context/ParseContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ParseContext.d.ts","sourceRoot":"","sources":["../../src/context/ParseContext.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAG9C,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AACzD,OAAO,KAAK,KAAK,GAAG,MAAM,wCAAwC,CAAA;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAGjD,KAAK,eAAe,GAAG;IACrB,cAAc,EAAE,SAAS,CAAC,QAAQ,CAAA;IAClC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAA;IAClB,UAAU,EAAE,UAAU,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,WAAW,EAAE,WAAW,CAAA;CACzB,CAAA;AAED,qBAAa,YAAY;IACvB,cAAc,EAAE,SAAS,CAAC,QAAQ,CAAA;IAClC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAA;IAClB,WAAW,EAAE,WAAW,CAAA;IACxB,UAAU,EAAE,UAAU,CAAA;gBAEV,EAAE,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,eAAe;IAOnE,KAAK;IASL,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IAIlD,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAUlD;AAED,eAAO,MAAM,WAAW,WAAY,MAAM,2BAMzC,CAAA"}
+{"version":3,"file":"ParseContext.d.ts","sourceRoot":"","sources":["../../src/context/ParseContext.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAG9C,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AACzD,OAAO,KAAK,KAAK,GAAG,MAAM,wCAAwC,CAAA;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAG/D,KAAK,eAAe,GAAG;IACrB,cAAc,EAAE,SAAS,CAAC,QAAQ,CAAA;IAClC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAA;IAClB,UAAU,EAAE,UAAU,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,WAAW,EAAE,WAAW,CAAA;CACzB,CAAA;AAED,qBAAa,YAAY;IACvB,cAAc,EAAE,SAAS,CAAC,QAAQ,CAAA;IAClC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAA;IAClB,WAAW,EAAE,WAAW,CAAA;IACxB,UAAU,EAAE,UAAU,CAAA;gBAEV,EAAE,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,eAAe;IAOnE,KAAK;IASL,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,CAAC;IAI1E,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAUlD;AAED,eAAO,MAAM,WAAW,WAAY,MAAM,2BAMzC,CAAA"}

package/esm/context/ParseContext.js

@@ -41,8 +41,8 @@ export class ParseContext {
         });
         return this.oasDocument;
     }
-    trace(token, fn) {
-        return tracer(this.stackTrail, token, fn);
+    trace(token, fn, options) {
+        return tracer(this.stackTrail, token, fn, options);
     }
     logSkippedFields(skipped) {
         Object.entries(skipped).forEach(([key, value]) => {

package/esm/context/StackTrail.d.ts

@@ -1,11 +1,16 @@
 import "../_dnt.polyfills.js";
+export type TraceOptions = {
+    checkCycles?: boolean;
+};
 export declare class StackTrail {
     #private;
     constructor(stack?: (string | number)[]);
     clone(): StackTrail;
     slice(start: number, end?: number): StackTrail;
     get stackTrail(): (string | number)[];
-    append(frame: string | string[]): StackTrail;
+    append(frame: string | string[], options?: TraceOptions): StackTrail;
+    checkCycles(frame: string | string[]): boolean;
+    checkCyclesArray(frames: string[]): boolean;
     getParentOf(frame: string): string | undefined;
     remove(frame: string | string[]): StackTrail;
     static join(...stacks: (StackTrail | string)[]): string;

package/esm/context/StackTrail.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StackTrail.d.ts","sourceRoot":"","sources":["../../src/context/StackTrail.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAC9B,qBAAa,UAAU;;gBAGT,KAAK,GAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAO;IAI3C,KAAK;IAIL,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM;IAIjC,IAAI,UAAU,wBAEb;IAED,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,UAAU;IAgB5C,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAW9C,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,UAAU;IAsB5C,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,EAAE,CAAC,UAAU,GAAG,MAAM,CAAC,EAAE,GAAG,MAAM;IAIvD,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU;IAYvC,QAAQ;CAOT"}
+{"version":3,"file":"StackTrail.d.ts","sourceRoot":"","sources":["../../src/context/StackTrail.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAC9B,MAAM,MAAM,YAAY,GAAG;IACzB,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB,CAAA;AAED,qBAAa,UAAU;;gBAGT,KAAK,GAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAO;IAI3C,KAAK;IAIL,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM;IAIjC,IAAI,UAAU,wBAEb;IAED,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,UAAU;IAoBpE,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO;IAQ9C,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO;IAkB3C,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAW9C,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,UAAU;IAsB5C,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,EAAE,CAAC,UAAU,GAAG,MAAM,CAAC,EAAE,GAAG,MAAM;IAIvD,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU;IAYvC,QAAQ;CAOT"}

package/esm/context/StackTrail.js

@@ -25,7 +25,10 @@ export class StackTrail {
     get stackTrail() {
         return __classPrivateFieldGet(this, _StackTrail_stack, "f");
     }
-    append(frame) {
+    append(frame, options) {
+        if (options?.checkCycles && this.checkCycles(frame)) {
+            throw new Error(`Cycle detected in stack trail: ${this}`);
+        }
         if (typeof frame === 'string') {
             __classPrivateFieldGet(this, _StackTrail_stack, "f").push(frame);
             return this;
@@ -36,6 +39,25 @@ export class StackTrail {
         }
         throw new Error(`Unexpected stack frame: ${frame}`);
     }
+    checkCycles(frame) {
+        if (typeof frame === 'string') {
+            return __classPrivateFieldGet(this, _StackTrail_stack, "f").includes(frame);
+        }
+        return this.checkCyclesArray(frame);
+    }
+    checkCyclesArray(frames) {
+        if (frames.length === 0) {
+            return false;
+        }
+        const lastFrame = frames[frames.length - 1];
+        const indexOfLastFrame = __classPrivateFieldGet(this, _StackTrail_stack, "f").indexOf(lastFrame);
+        if (indexOfLastFrame === -1) {
+            return false;
+        }
+        return frames.toReversed().every((frame, index) => {
+            return frame === __classPrivateFieldGet(this, _StackTrail_stack, "f")[indexOfLastFrame - index];
+        });
+    }
     getParentOf(frame) {
         const lastItemIndex = this.stackTrail.length - 1;
         if (this.stackTrail?.[lastItemIndex] === frame &&

package/esm/helpers/tracer.d.ts

@@ -1,3 +1,3 @@
-import type { StackTrail } from '../context/StackTrail.js';
-export declare const tracer: <T>(stackTrail: StackTrail, token: string | string[], fn: () => T) => T;
+import type { StackTrail, TraceOptions } from '../context/StackTrail.js';
+export declare const tracer: <T>(stackTrail: StackTrail, token: string | string[], fn: () => T, options?: TraceOptions) => T;
 //# sourceMappingURL=tracer.d.ts.map

package/esm/helpers/tracer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tracer.d.ts","sourceRoot":"","sources":["../../src/helpers/tracer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAE1D,eAAO,MAAM,MAAM,GAAI,CAAC,cACV,UAAU,SACf,MAAM,GAAG,MAAM,EAAE,MACpB,MAAM,CAAC,MASZ,CAAA"}
+{"version":3,"file":"tracer.d.ts","sourceRoot":"","sources":["../../src/helpers/tracer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAExE,eAAO,MAAM,MAAM,GAAI,CAAC,cACV,UAAU,SACf,MAAM,GAAG,MAAM,EAAE,MACpB,MAAM,CAAC,YACD,YAAY,MASvB,CAAA"}

package/esm/helpers/tracer.js

@@ -1,5 +1,5 @@
-export const tracer = (stackTrail, token, fn) => {
-    stackTrail.append(token);
+export const tracer = (stackTrail, token, fn, options) => {
+    stackTrail.append(token, options);
     const result = fn();
     stackTrail.remove(token);
     return result;

package/esm/oas/components/toComponentsV3.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toComponentsV3.d.ts","sourceRoot":"","sources":["../../../src/oas/components/toComponentsV3.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AAGjE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAI/C,KAAK,kBAAkB,GAAG;IACxB,UAAU,EAAE,SAAS,CAAC,gBAAgB,GAAG,SAAS,CAAA;IAClD,OAAO,EAAE,YAAY,CAAA;CACtB,CAAA;AAED,eAAO,MAAM,cAAc,4BAGxB,kBAAkB,KAAG,aAAa,GAAG,SAgCvC,CAAA"}
+{"version":3,"file":"toComponentsV3.d.ts","sourceRoot":"","sources":["../../../src/oas/components/toComponentsV3.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AAGjE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAI/C,KAAK,kBAAkB,GAAG;IACxB,UAAU,EAAE,SAAS,CAAC,gBAAgB,GAAG,SAAS,CAAA;IAClD,OAAO,EAAE,YAAY,CAAA;CACtB,CAAA;AAED,eAAO,MAAM,cAAc,4BAGxB,kBAAkB,KAAG,aAAa,GAAG,SAsDvC,CAAA"}

package/esm/oas/components/toComponentsV3.js

@@ -13,20 +13,33 @@ export const toComponentsV3 = ({ components, context }) => {
     const { schemas, responses, parameters, examples, requestBodies, headers, ...skipped } = components;
     const extensionFields = toSpecificationExtensionsV3({ skipped, context });
     const fields = {
-        schemas: context.trace('schemas', () => toOptionalSchemasV3({ schemas, context })),
-        responses: context.trace('responses', () => toOptionalResponsesV3({ responses, context })),
+        schemas: context.trace('schemas', () => toOptionalSchemasV3({ schemas, context }), {
+            checkCycles: true
+        }),
+        responses: context.trace('responses', () => toOptionalResponsesV3({ responses, context }), {
+            checkCycles: true
+        }),
         parameters: context.trace('parameters', () => toOptionalParametersV3({
             parameters,
             context
-        })),
+        }), {
+            checkCycles: true
+        }),
         examples: toExamplesV3({
             examples,
             example: undefined,
             exampleKey: 'TEMP',
-            context
+            context,
+            options: {
+                checkCycles: true
+            }
+        }),
+        requestBodies: context.trace('requestBodies', () => toRequestBodiesV3({ requestBodies, context }), {
+            checkCycles: true
+        }),
+        headers: context.trace('headers', () => toHeadersV3({ headers, context }), {
+            checkCycles: true
         }),
-        requestBodies: context.trace('requestBodies', () => toRequestBodiesV3({ requestBodies, context })),
-        headers: context.trace('headers', () => toHeadersV3({ headers, context })),
         extensionFields
     };
     return new OasComponents(fields);

package/esm/oas/example/toExamplesV3.d.ts

@@ -2,6 +2,7 @@ import type { ParseContext } from '../../context/ParseContext.js';
 import type { OpenAPIV3 } from 'openapi-types';
 import { OasExample } from './Example.js';
 import type { OasRef } from '../ref/Ref.js';
+import type { TraceOptions } from '../../context/StackTrail.js';
 type ToExampleSimpleV3Args = {
     example: unknown;
 };
@@ -11,8 +12,9 @@ export type ToExamplesV3Args = {
     examples: Record<string, OpenAPIV3.ExampleObject | OpenAPIV3.ReferenceObject> | undefined;
     exampleKey: string;
     context: ParseContext;
+    options?: TraceOptions;
 };
-export declare const toExamplesV3: ({ example, examples, exampleKey, context }: ToExamplesV3Args) => Record<string, OasExample | OasRef<"example">> | undefined;
+export declare const toExamplesV3: ({ example, examples, exampleKey, context, options }: ToExamplesV3Args) => Record<string, OasExample | OasRef<"example">> | undefined;
 type ToExampleV3Args = {
     example: OpenAPIV3.ExampleObject | OpenAPIV3.ReferenceObject;
     context: ParseContext;

package/esm/oas/example/toExamplesV3.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toExamplesV3.d.ts","sourceRoot":"","sources":["../../../src/oas/example/toExamplesV3.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAG9C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAG3C,KAAK,qBAAqB,GAAG;IAC3B,OAAO,EAAE,OAAO,CAAA;CACjB,CAAA;AAED,eAAO,MAAM,iBAAiB,gBAE3B,qBAAqB,KAAG,UAAU,GAAG,MAAM,CAAC,SAAS,CAQvD,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,SAAS,CAAC,aAAa,GAAG,SAAS,CAAA;IAC5C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,aAAa,GAAG,SAAS,CAAC,eAAe,CAAC,GAAG,SAAS,CAAA;IACzF,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,YAAY,CAAA;CACtB,CAAA;AAED,eAAO,MAAM,YAAY,+CAKtB,gBAAgB,KAAG,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,SAsBtE,CAAA;AAED,KAAK,eAAe,GAAG;IACrB,OAAO,EAAE,SAAS,CAAC,aAAa,GAAG,SAAS,CAAC,eAAe,CAAA;IAC5D,OAAO,EAAE,YAAY,CAAA;CACtB,CAAA;AAED,eAAO,MAAM,WAAW,yBAGrB,eAAe,KAAG,UAAU,GAAG,MAAM,CAAC,SAAS,CAejD,CAAA"}
+{"version":3,"file":"toExamplesV3.d.ts","sourceRoot":"","sources":["../../../src/oas/example/toExamplesV3.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAG9C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAE3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC/D,KAAK,qBAAqB,GAAG;IAC3B,OAAO,EAAE,OAAO,CAAA;CACjB,CAAA;AAED,eAAO,MAAM,iBAAiB,gBAE3B,qBAAqB,KAAG,UAAU,GAAG,MAAM,CAAC,SAAS,CAQvD,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,SAAS,CAAC,aAAa,GAAG,SAAS,CAAA;IAC5C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,aAAa,GAAG,SAAS,CAAC,eAAe,CAAC,GAAG,SAAS,CAAA;IACzF,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,YAAY,CAAA;IACrB,OAAO,CAAC,EAAE,YAAY,CAAA;CACvB,CAAA;AAED,eAAO,MAAM,YAAY,wDAMtB,gBAAgB,KAAG,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,SA0BtE,CAAA;AAED,KAAK,eAAe,GAAG;IACrB,OAAO,EAAE,SAAS,CAAC,aAAa,GAAG,SAAS,CAAC,eAAe,CAAA;IAC5D,OAAO,EAAE,YAAY,CAAA;CACtB,CAAA;AAED,eAAO,MAAM,WAAW,yBAGrB,eAAe,KAAG,UAAU,GAAG,MAAM,CAAC,SAAS,CAejD,CAAA"}

package/esm/oas/example/toExamplesV3.js

@@ -10,13 +10,13 @@ export const toExampleSimpleV3 = ({ example }) => {
     };
     return new OasExample(fields);
 };
-export const toExamplesV3 = ({ example, examples, exampleKey, context }) => {
+export const toExamplesV3 = ({ example, examples, exampleKey, context, options }) => {
     if (example && examples) {
         context.logger.warn(`Both example and examples are defined for ${exampleKey}`);
     }
     if (example) {
         return {
-            [exampleKey]: context.trace('example', () => toExampleSimpleV3({ example }))
+            [exampleKey]: context.trace('example', () => toExampleSimpleV3({ example }), options)
         };
     }
     if (examples) {
@@ -24,7 +24,7 @@ export const toExamplesV3 = ({ example, examples, exampleKey, context }) => {
             return Object.fromEntries(Object.entries(examples).map(([key, value]) => {
                 return [key, context.trace(key, () => toExampleV3({ example: value, context }))];
             }));
-        });
+        }, options);
     }
     return undefined;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skmtc/core",
-  "version": "0.0.595",
+  "version": "0.0.596",
   "main": "./script/mod.js",
   "module": "./esm/mod.js",
   "exports": {

package/script/context/ParseContext.d.ts

@@ -2,7 +2,7 @@ import "../_dnt.polyfills.js";
 import type { OpenAPIV3 } from 'openapi-types';
 import { OasDocument } from '../oas/document/Document.js';
 import type * as log from '../deps/jsr.io/@std/log/0.224.8/mod.js';
-import type { StackTrail } from './StackTrail.js';
+import type { StackTrail, TraceOptions } from './StackTrail.js';
 type ConstructorArgs = {
     documentObject: OpenAPIV3.Document;
     logger: log.Logger;
@@ -18,7 +18,7 @@ export declare class ParseContext {
     stackTrail: StackTrail;
     constructor({ documentObject, logger, stackTrail }: ConstructorArgs);
     parse(): OasDocument;
-    trace<T>(token: string | string[], fn: () => T): T;
+    trace<T>(token: string | string[], fn: () => T, options?: TraceOptions): T;
     logSkippedFields(skipped: Record<string, unknown>): void;
 }
 export declare const parseSchema: (schema: string) => OpenAPIV3.Document<{}>;

package/script/context/ParseContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ParseContext.d.ts","sourceRoot":"","sources":["../../src/context/ParseContext.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAG9C,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AACzD,OAAO,KAAK,KAAK,GAAG,MAAM,wCAAwC,CAAA;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAGjD,KAAK,eAAe,GAAG;IACrB,cAAc,EAAE,SAAS,CAAC,QAAQ,CAAA;IAClC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAA;IAClB,UAAU,EAAE,UAAU,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,WAAW,EAAE,WAAW,CAAA;CACzB,CAAA;AAED,qBAAa,YAAY;IACvB,cAAc,EAAE,SAAS,CAAC,QAAQ,CAAA;IAClC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAA;IAClB,WAAW,EAAE,WAAW,CAAA;IACxB,UAAU,EAAE,UAAU,CAAA;gBAEV,EAAE,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,eAAe;IAOnE,KAAK;IASL,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IAIlD,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAUlD;AAED,eAAO,MAAM,WAAW,WAAY,MAAM,2BAMzC,CAAA"}
+{"version":3,"file":"ParseContext.d.ts","sourceRoot":"","sources":["../../src/context/ParseContext.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAG9C,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AACzD,OAAO,KAAK,KAAK,GAAG,MAAM,wCAAwC,CAAA;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAG/D,KAAK,eAAe,GAAG;IACrB,cAAc,EAAE,SAAS,CAAC,QAAQ,CAAA;IAClC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAA;IAClB,UAAU,EAAE,UAAU,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,WAAW,EAAE,WAAW,CAAA;CACzB,CAAA;AAED,qBAAa,YAAY;IACvB,cAAc,EAAE,SAAS,CAAC,QAAQ,CAAA;IAClC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAA;IAClB,WAAW,EAAE,WAAW,CAAA;IACxB,UAAU,EAAE,UAAU,CAAA;gBAEV,EAAE,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,eAAe;IAOnE,KAAK;IASL,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,CAAC;IAI1E,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAUlD;AAED,eAAO,MAAM,WAAW,WAAY,MAAM,2BAMzC,CAAA"}

package/script/context/ParseContext.js

@@ -44,8 +44,8 @@ class ParseContext {
         });
         return this.oasDocument;
     }
-    trace(token, fn) {
-        return (0, tracer_js_1.tracer)(this.stackTrail, token, fn);
+    trace(token, fn, options) {
+        return (0, tracer_js_1.tracer)(this.stackTrail, token, fn, options);
     }
     logSkippedFields(skipped) {
         Object.entries(skipped).forEach(([key, value]) => {

package/script/context/StackTrail.d.ts

@@ -1,11 +1,16 @@
 import "../_dnt.polyfills.js";
+export type TraceOptions = {
+    checkCycles?: boolean;
+};
 export declare class StackTrail {
     #private;
     constructor(stack?: (string | number)[]);
     clone(): StackTrail;
     slice(start: number, end?: number): StackTrail;
     get stackTrail(): (string | number)[];
-    append(frame: string | string[]): StackTrail;
+    append(frame: string | string[], options?: TraceOptions): StackTrail;
+    checkCycles(frame: string | string[]): boolean;
+    checkCyclesArray(frames: string[]): boolean;
     getParentOf(frame: string): string | undefined;
     remove(frame: string | string[]): StackTrail;
     static join(...stacks: (StackTrail | string)[]): string;

package/script/context/StackTrail.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StackTrail.d.ts","sourceRoot":"","sources":["../../src/context/StackTrail.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAC9B,qBAAa,UAAU;;gBAGT,KAAK,GAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAO;IAI3C,KAAK;IAIL,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM;IAIjC,IAAI,UAAU,wBAEb;IAED,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,UAAU;IAgB5C,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAW9C,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,UAAU;IAsB5C,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,EAAE,CAAC,UAAU,GAAG,MAAM,CAAC,EAAE,GAAG,MAAM;IAIvD,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU;IAYvC,QAAQ;CAOT"}
+{"version":3,"file":"StackTrail.d.ts","sourceRoot":"","sources":["../../src/context/StackTrail.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAC9B,MAAM,MAAM,YAAY,GAAG;IACzB,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB,CAAA;AAED,qBAAa,UAAU;;gBAGT,KAAK,GAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAO;IAI3C,KAAK;IAIL,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM;IAIjC,IAAI,UAAU,wBAEb;IAED,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,UAAU;IAoBpE,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO;IAQ9C,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO;IAkB3C,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAW9C,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,UAAU;IAsB5C,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,EAAE,CAAC,UAAU,GAAG,MAAM,CAAC,EAAE,GAAG,MAAM;IAIvD,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU;IAYvC,QAAQ;CAOT"}

package/script/context/StackTrail.js

@@ -28,7 +28,10 @@ class StackTrail {
     get stackTrail() {
         return __classPrivateFieldGet(this, _StackTrail_stack, "f");
     }
-    append(frame) {
+    append(frame, options) {
+        if (options?.checkCycles && this.checkCycles(frame)) {
+            throw new Error(`Cycle detected in stack trail: ${this}`);
+        }
         if (typeof frame === 'string') {
             __classPrivateFieldGet(this, _StackTrail_stack, "f").push(frame);
             return this;
@@ -39,6 +42,25 @@ class StackTrail {
         }
         throw new Error(`Unexpected stack frame: ${frame}`);
     }
+    checkCycles(frame) {
+        if (typeof frame === 'string') {
+            return __classPrivateFieldGet(this, _StackTrail_stack, "f").includes(frame);
+        }
+        return this.checkCyclesArray(frame);
+    }
+    checkCyclesArray(frames) {
+        if (frames.length === 0) {
+            return false;
+        }
+        const lastFrame = frames[frames.length - 1];
+        const indexOfLastFrame = __classPrivateFieldGet(this, _StackTrail_stack, "f").indexOf(lastFrame);
+        if (indexOfLastFrame === -1) {
+            return false;
+        }
+        return frames.toReversed().every((frame, index) => {
+            return frame === __classPrivateFieldGet(this, _StackTrail_stack, "f")[indexOfLastFrame - index];
+        });
+    }
     getParentOf(frame) {
         const lastItemIndex = this.stackTrail.length - 1;
         if (this.stackTrail?.[lastItemIndex] === frame &&

package/script/helpers/tracer.d.ts

@@ -1,3 +1,3 @@
-import type { StackTrail } from '../context/StackTrail.js';
-export declare const tracer: <T>(stackTrail: StackTrail, token: string | string[], fn: () => T) => T;
+import type { StackTrail, TraceOptions } from '../context/StackTrail.js';
+export declare const tracer: <T>(stackTrail: StackTrail, token: string | string[], fn: () => T, options?: TraceOptions) => T;
 //# sourceMappingURL=tracer.d.ts.map

package/script/helpers/tracer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tracer.d.ts","sourceRoot":"","sources":["../../src/helpers/tracer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAE1D,eAAO,MAAM,MAAM,GAAI,CAAC,cACV,UAAU,SACf,MAAM,GAAG,MAAM,EAAE,MACpB,MAAM,CAAC,MASZ,CAAA"}
+{"version":3,"file":"tracer.d.ts","sourceRoot":"","sources":["../../src/helpers/tracer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAExE,eAAO,MAAM,MAAM,GAAI,CAAC,cACV,UAAU,SACf,MAAM,GAAG,MAAM,EAAE,MACpB,MAAM,CAAC,YACD,YAAY,MASvB,CAAA"}

package/script/helpers/tracer.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.tracer = void 0;
-const tracer = (stackTrail, token, fn) => {
-    stackTrail.append(token);
+const tracer = (stackTrail, token, fn, options) => {
+    stackTrail.append(token, options);
     const result = fn();
     stackTrail.remove(token);
     return result;

package/script/oas/components/toComponentsV3.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toComponentsV3.d.ts","sourceRoot":"","sources":["../../../src/oas/components/toComponentsV3.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AAGjE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAI/C,KAAK,kBAAkB,GAAG;IACxB,UAAU,EAAE,SAAS,CAAC,gBAAgB,GAAG,SAAS,CAAA;IAClD,OAAO,EAAE,YAAY,CAAA;CACtB,CAAA;AAED,eAAO,MAAM,cAAc,4BAGxB,kBAAkB,KAAG,aAAa,GAAG,SAgCvC,CAAA"}
+{"version":3,"file":"toComponentsV3.d.ts","sourceRoot":"","sources":["../../../src/oas/components/toComponentsV3.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AAGjE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAI/C,KAAK,kBAAkB,GAAG;IACxB,UAAU,EAAE,SAAS,CAAC,gBAAgB,GAAG,SAAS,CAAA;IAClD,OAAO,EAAE,YAAY,CAAA;CACtB,CAAA;AAED,eAAO,MAAM,cAAc,4BAGxB,kBAAkB,KAAG,aAAa,GAAG,SAsDvC,CAAA"}

package/script/oas/components/toComponentsV3.js

@@ -16,20 +16,33 @@ const toComponentsV3 = ({ components, context }) => {
     const { schemas, responses, parameters, examples, requestBodies, headers, ...skipped } = components;
     const extensionFields = (0, toSpecificationExtensionsV3_js_1.toSpecificationExtensionsV3)({ skipped, context });
     const fields = {
-        schemas: context.trace('schemas', () => (0, toSchemasV3_js_1.toOptionalSchemasV3)({ schemas, context })),
-        responses: context.trace('responses', () => (0, toResponseV3_js_1.toOptionalResponsesV3)({ responses, context })),
+        schemas: context.trace('schemas', () => (0, toSchemasV3_js_1.toOptionalSchemasV3)({ schemas, context }), {
+            checkCycles: true
+        }),
+        responses: context.trace('responses', () => (0, toResponseV3_js_1.toOptionalResponsesV3)({ responses, context }), {
+            checkCycles: true
+        }),
         parameters: context.trace('parameters', () => (0, toParameterV3_js_1.toOptionalParametersV3)({
             parameters,
             context
-        })),
+        }), {
+            checkCycles: true
+        }),
         examples: (0, toExamplesV3_js_1.toExamplesV3)({
             examples,
             example: undefined,
             exampleKey: 'TEMP',
-            context
+            context,
+            options: {
+                checkCycles: true
+            }
+        }),
+        requestBodies: context.trace('requestBodies', () => (0, toRequestBodiesV3_js_1.toRequestBodiesV3)({ requestBodies, context }), {
+            checkCycles: true
+        }),
+        headers: context.trace('headers', () => (0, toHeadersV3_js_1.toHeadersV3)({ headers, context }), {
+            checkCycles: true
         }),
-        requestBodies: context.trace('requestBodies', () => (0, toRequestBodiesV3_js_1.toRequestBodiesV3)({ requestBodies, context })),
-        headers: context.trace('headers', () => (0, toHeadersV3_js_1.toHeadersV3)({ headers, context })),
         extensionFields
     };
     return new Components_js_1.OasComponents(fields);

package/script/oas/example/toExamplesV3.d.ts

@@ -2,6 +2,7 @@ import type { ParseContext } from '../../context/ParseContext.js';
 import type { OpenAPIV3 } from 'openapi-types';
 import { OasExample } from './Example.js';
 import type { OasRef } from '../ref/Ref.js';
+import type { TraceOptions } from '../../context/StackTrail.js';
 type ToExampleSimpleV3Args = {
     example: unknown;
 };
@@ -11,8 +12,9 @@ export type ToExamplesV3Args = {
     examples: Record<string, OpenAPIV3.ExampleObject | OpenAPIV3.ReferenceObject> | undefined;
     exampleKey: string;
     context: ParseContext;
+    options?: TraceOptions;
 };
-export declare const toExamplesV3: ({ example, examples, exampleKey, context }: ToExamplesV3Args) => Record<string, OasExample | OasRef<"example">> | undefined;
+export declare const toExamplesV3: ({ example, examples, exampleKey, context, options }: ToExamplesV3Args) => Record<string, OasExample | OasRef<"example">> | undefined;
 type ToExampleV3Args = {
     example: OpenAPIV3.ExampleObject | OpenAPIV3.ReferenceObject;
     context: ParseContext;

package/script/oas/example/toExamplesV3.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toExamplesV3.d.ts","sourceRoot":"","sources":["../../../src/oas/example/toExamplesV3.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAG9C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAG3C,KAAK,qBAAqB,GAAG;IAC3B,OAAO,EAAE,OAAO,CAAA;CACjB,CAAA;AAED,eAAO,MAAM,iBAAiB,gBAE3B,qBAAqB,KAAG,UAAU,GAAG,MAAM,CAAC,SAAS,CAQvD,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,SAAS,CAAC,aAAa,GAAG,SAAS,CAAA;IAC5C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,aAAa,GAAG,SAAS,CAAC,eAAe,CAAC,GAAG,SAAS,CAAA;IACzF,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,YAAY,CAAA;CACtB,CAAA;AAED,eAAO,MAAM,YAAY,+CAKtB,gBAAgB,KAAG,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,SAsBtE,CAAA;AAED,KAAK,eAAe,GAAG;IACrB,OAAO,EAAE,SAAS,CAAC,aAAa,GAAG,SAAS,CAAC,eAAe,CAAA;IAC5D,OAAO,EAAE,YAAY,CAAA;CACtB,CAAA;AAED,eAAO,MAAM,WAAW,yBAGrB,eAAe,KAAG,UAAU,GAAG,MAAM,CAAC,SAAS,CAejD,CAAA"}
+{"version":3,"file":"toExamplesV3.d.ts","sourceRoot":"","sources":["../../../src/oas/example/toExamplesV3.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAG9C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAE3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC/D,KAAK,qBAAqB,GAAG;IAC3B,OAAO,EAAE,OAAO,CAAA;CACjB,CAAA;AAED,eAAO,MAAM,iBAAiB,gBAE3B,qBAAqB,KAAG,UAAU,GAAG,MAAM,CAAC,SAAS,CAQvD,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,SAAS,CAAC,aAAa,GAAG,SAAS,CAAA;IAC5C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,aAAa,GAAG,SAAS,CAAC,eAAe,CAAC,GAAG,SAAS,CAAA;IACzF,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,YAAY,CAAA;IACrB,OAAO,CAAC,EAAE,YAAY,CAAA;CACvB,CAAA;AAED,eAAO,MAAM,YAAY,wDAMtB,gBAAgB,KAAG,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,SA0BtE,CAAA;AAED,KAAK,eAAe,GAAG;IACrB,OAAO,EAAE,SAAS,CAAC,aAAa,GAAG,SAAS,CAAC,eAAe,CAAA;IAC5D,OAAO,EAAE,YAAY,CAAA;CACtB,CAAA;AAED,eAAO,MAAM,WAAW,yBAGrB,eAAe,KAAG,UAAU,GAAG,MAAM,CAAC,SAAS,CAejD,CAAA"}

package/script/oas/example/toExamplesV3.js

@@ -14,13 +14,13 @@ const toExampleSimpleV3 = ({ example }) => {
     return new Example_js_1.OasExample(fields);
 };
 exports.toExampleSimpleV3 = toExampleSimpleV3;
-const toExamplesV3 = ({ example, examples, exampleKey, context }) => {
+const toExamplesV3 = ({ example, examples, exampleKey, context, options }) => {
     if (example && examples) {
         context.logger.warn(`Both example and examples are defined for ${exampleKey}`);
     }
     if (example) {
         return {
-            [exampleKey]: context.trace('example', () => (0, exports.toExampleSimpleV3)({ example }))
+            [exampleKey]: context.trace('example', () => (0, exports.toExampleSimpleV3)({ example }), options)
         };
     }
     if (examples) {
@@ -28,7 +28,7 @@ const toExamplesV3 = ({ example, examples, exampleKey, context }) => {
             return Object.fromEntries(Object.entries(examples).map(([key, value]) => {
                 return [key, context.trace(key, () => (0, exports.toExampleV3)({ example: value, context }))];
             }));
-        });
+        }, options);
     }
     return undefined;
 };