@skmtc/core 0.0.368 → 0.0.370

package/script/oas/object/Object.d.ts

@@ -9,28 +9,72 @@ export type OasObjectFields = {
     additionalProperties?: boolean | OasSchema | OasRef<'schema'> | undefined;
     nullable?: boolean | undefined;
 };
-export type RemovePropertyArgs = {
-    name: string;
-};
 export type AddPropertyArgs = {
     name: string;
     schema: OasSchema | OasRef<'schema'> | CustomValue | undefined;
     required?: boolean;
 };
+/**
+ * Object representing an object and/or a record in the OpenAPI Specification.
+ *
+ * Objects have fixed, named fields. Records have any number of fields that do not have predefined names.
+ */
 export declare class OasObject {
-    oasType: 'schema';
-    type: 'object';
-    title?: string;
-    description?: string;
-    properties?: Record<string, OasSchema | OasRef<'schema'> | CustomValue> | undefined;
-    required?: string[] | undefined;
-    additionalProperties?: boolean | OasSchema | OasRef<'schema'> | undefined;
-    nullable?: boolean | undefined;
+    /**
+     * Object is part the 'schema' set which is used
+     * to define data types in an OpenAPI document.
+     */
+    oasType: "schema";
+    /**
+     * Constant value 'object' useful for type narrowing and tagged unions.
+     */
+    type: "object";
+    /**
+     * A short summary of the object.
+     */
+    title: string | undefined;
+    /**
+     * A description of the object.
+     */
+    description: string | undefined;
+    /**
+     * Indicates whether value can be null.
+     */
+    nullable: boolean | undefined;
+    /**
+     * A record which maps property names of the object to their schemas.
+     */
+    properties: Record<string, OasSchema | OasRef<'schema'> | CustomValue> | undefined;
+    /**
+     * An array of required property names.
+     */
+    required: string[] | undefined;
+    /**
+     * Indicates whether additional properties are allowed.
+     *
+     * This is equivalent to a Record type in TypeScript.
+     */
+    additionalProperties: boolean | OasSchema | OasRef<'schema'> | undefined;
     constructor(fields: OasObjectFields);
     /** Creates new empty OasObject */
     static empty(): OasObject;
+    /**
+     * Adds a new property to the object.
+     *
+     * @param {AddPropertyArgs} args - The arguments for adding a property.
+     * @param {string} args.name - The name of the property to add.
+     * @param {OasSchema | OasRef<'schema'> | CustomValue | undefined} args.schema - The schema of the property to add.
+     * @param {boolean} args.required - Whether the property is required.
+     * @returns {OasObject} A new OasObject with the added property.
+     */
     addProperty({ name, schema, required }: AddPropertyArgs): OasObject;
-    removeProperty({ name }: RemovePropertyArgs): OasObject;
+    /**
+     * Removes a property from the object.
+     *
+     * @param {string} name - The name of the property to remove.
+     * @returns {OasObject} A new OasObject with the removed property.
+     */
+    removeProperty(name: string): OasObject;
     isRef(): this is OasRef<'schema'>;
     resolve(): OasObject;
     resolveOnce(): OasObject;

package/script/oas/object/Object.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Object.d.ts","sourceRoot":"","sources":["../../../src/oas/object/Object.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAE7D,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EACP,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,WAAW,CAAC,GAC1D,SAAS,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAA;IAC/B,oBAAoB,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAA;IACzE,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CAC/B,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,WAAW,GAAG,SAAS,CAAA;IAC9D,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED,qBAAa,SAAS;IACpB,OAAO,EAAE,QAAQ,CAAW;IAC5B,IAAI,EAAE,QAAQ,CAAW;IACzB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EACP,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,WAAW,CAAC,GAC1D,SAAS,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAA;IAC/B,oBAAoB,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAA;IACzE,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;gBAElB,MAAM,EAAE,eAAe;IASnC,kCAAkC;IAClC,MAAM,CAAC,KAAK,IAAI,SAAS;IAOzB,WAAW,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,eAAe,GAAG,SAAS;IAkBnE,cAAc,CAAC,EAAE,IAAI,EAAE,EAAE,kBAAkB,GAAG,SAAS;IAiBvD,KAAK,IAAI,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC;IAIjC,OAAO,IAAI,SAAS;IAIpB,WAAW,IAAI,SAAS;CAGzB"}
+{"version":3,"file":"Object.d.ts","sourceRoot":"","sources":["../../../src/oas/object/Object.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAE7D,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EACP,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,WAAW,CAAC,GAC1D,SAAS,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAA;IAC/B,oBAAoB,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAA;IACzE,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CAC/B,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,WAAW,GAAG,SAAS,CAAA;IAC9D,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED;;;;GAIG;AACH,qBAAa,SAAS;IACpB;;;OAGG;IACH,OAAO,WAAoB;IAC3B;;OAEG;IACH,IAAI,WAAoB;IACxB;;OAEG;IACH,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB;;OAEG;IACH,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;IAC/B;;OAEG;IACH,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAA;IAC7B;;OAEG;IACH,UAAU,EACN,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,WAAW,CAAC,GAC1D,SAAS,CAAA;IACb;;OAEG;IACH,QAAQ,EAAE,MAAM,EAAE,GAAG,SAAS,CAAA;IAC9B;;;;OAIG;IACH,oBAAoB,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAA;gBAE5D,MAAM,EAAE,eAAe;IASnC,kCAAkC;IAClC,MAAM,CAAC,KAAK,IAAI,SAAS;IAOzB;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,eAAe,GAAG,SAAS;IAkBnE;;;;;OAKG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS;IAiBvC,KAAK,IAAI,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC;IAIjC,OAAO,IAAI,SAAS;IAIpB,WAAW,IAAI,SAAS;CAGzB"}

package/script/oas/object/Object.js

@@ -1,51 +1,83 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OasObject = void 0;
+/**
+ * Object representing an object and/or a record in the OpenAPI Specification.
+ *
+ * Objects have fixed, named fields. Records have any number of fields that do not have predefined names.
+ */
 class OasObject {
     constructor(fields) {
+        /**
+         * Object is part the 'schema' set which is used
+         * to define data types in an OpenAPI document.
+         */
         Object.defineProperty(this, "oasType", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: 'schema'
         });
+        /**
+         * Constant value 'object' useful for type narrowing and tagged unions.
+         */
         Object.defineProperty(this, "type", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: 'object'
         });
+        /**
+         * A short summary of the object.
+         */
         Object.defineProperty(this, "title", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: void 0
         });
+        /**
+         * A description of the object.
+         */
         Object.defineProperty(this, "description", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: void 0
         });
-        Object.defineProperty(this, "properties", {
+        /**
+         * Indicates whether value can be null.
+         */
+        Object.defineProperty(this, "nullable", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: void 0
         });
-        Object.defineProperty(this, "required", {
+        /**
+         * A record which maps property names of the object to their schemas.
+         */
+        Object.defineProperty(this, "properties", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: void 0
         });
-        Object.defineProperty(this, "additionalProperties", {
+        /**
+         * An array of required property names.
+         */
+        Object.defineProperty(this, "required", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: void 0
         });
-        Object.defineProperty(this, "nullable", {
+        /**
+         * Indicates whether additional properties are allowed.
+         *
+         * This is equivalent to a Record type in TypeScript.
+         */
+        Object.defineProperty(this, "additionalProperties", {
             enumerable: true,
             configurable: true,
             writable: true,
@@ -65,6 +97,15 @@ class OasObject {
             required: []
         });
     }
+    /**
+     * Adds a new property to the object.
+     *
+     * @param {AddPropertyArgs} args - The arguments for adding a property.
+     * @param {string} args.name - The name of the property to add.
+     * @param {OasSchema | OasRef<'schema'> | CustomValue | undefined} args.schema - The schema of the property to add.
+     * @param {boolean} args.required - Whether the property is required.
+     * @returns {OasObject} A new OasObject with the added property.
+     */
     addProperty({ name, schema, required }) {
         if (!schema) {
             return this;
@@ -81,7 +122,13 @@ class OasObject {
             nullable: this.nullable
         });
     }
-    removeProperty({ name }) {
+    /**
+     * Removes a property from the object.
+     *
+     * @param {string} name - The name of the property to remove.
+     * @returns {OasObject} A new OasObject with the removed property.
+     */
+    removeProperty(name) {
         if (!this.properties?.[name]) {
             return this;
         }

package/script/oas/string/String.d.ts

@@ -6,18 +6,42 @@ export type StringFields = {
     enums?: string[];
     nullable?: boolean;
 };
+/**
+ * Object representing a string in the OpenAPI Specification.
+ */
 export declare class OasString {
-    #private;
-    oasType: 'schema';
-    type: 'string';
+    /**
+     * Object is part the 'schema' set which is used
+     * to define data types in an OpenAPI document.
+     */
+    oasType: "schema";
+    /**
+     * Constant value 'string' useful for type narrowing and tagged unions.
+     */
+    type: "string";
+    /**
+     * A short summary of the string.
+     */
+    title: string | undefined;
+    /**
+     * A description of the string.
+     */
+    description: string | undefined;
+    /**
+     * The format of the string.
+     */
+    format: string | undefined;
+    /**
+     * An array of allowed values for the string.
+     */
+    enums: string[] | undefined;
+    /**
+     * Indicates whether value can be null.
+     */
+    nullable: boolean | undefined;
     constructor(fields: StringFields);
-    get title(): string | undefined;
-    get description(): string | undefined;
-    get nullable(): boolean | undefined;
     isRef(): this is OasRef<'schema'>;
     resolve(): OasString;
     resolveOnce(): OasString;
-    get format(): string | undefined;
-    get enums(): string[] | undefined;
 }
 //# sourceMappingURL=String.d.ts.map

package/script/oas/string/String.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"String.d.ts","sourceRoot":"","sources":["../../../src/oas/string/String.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAE3C,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED,qBAAa,SAAS;;IACpB,OAAO,EAAE,QAAQ,CAAW;IAC5B,IAAI,EAAE,QAAQ,CAAW;gBAGb,MAAM,EAAE,YAAY;IAIhC,IAAI,KAAK,IAAI,MAAM,GAAG,SAAS,CAE9B;IAED,IAAI,WAAW,IAAI,MAAM,GAAG,SAAS,CAEpC;IAED,IAAI,QAAQ,IAAI,OAAO,GAAG,SAAS,CAElC;IAED,KAAK,IAAI,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC;IAIjC,OAAO,IAAI,SAAS;IAIpB,WAAW,IAAI,SAAS;IAIxB,IAAI,MAAM,IAAI,MAAM,GAAG,SAAS,CAE/B;IAMD,IAAI,KAAK,IAAI,MAAM,EAAE,GAAG,SAAS,CAEhC;CACF"}
+{"version":3,"file":"String.d.ts","sourceRoot":"","sources":["../../../src/oas/string/String.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAE3C,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED;;GAEG;AACH,qBAAa,SAAS;IACpB;;;OAGG;IACH,OAAO,WAAoB;IAC3B;;OAEG;IACH,IAAI,WAAoB;IACxB;;OAEG;IACH,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB;;OAEG;IACH,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;IAC/B;;OAEG;IACH,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B;;OAEG;IACH,KAAK,EAAE,MAAM,EAAE,GAAG,SAAS,CAAA;IAC3B;;OAEG;IACH,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAA;gBAEjB,MAAM,EAAE,YAAY;IAYhC,KAAK,IAAI,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC;IAIjC,OAAO,IAAI,SAAS;IAIpB,WAAW,IAAI,SAAS;CAGzB"}

package/script/oas/string/String.js

@@ -1,44 +1,84 @@
 "use strict";
-var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
-    if (kind === "m") throw new TypeError("Private method is not writable");
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
-    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
-};
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
-var _OasString_fields;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OasString = void 0;
+/**
+ * Object representing a string in the OpenAPI Specification.
+ */
 class OasString {
     constructor(fields) {
+        /**
+         * Object is part the 'schema' set which is used
+         * to define data types in an OpenAPI document.
+         */
         Object.defineProperty(this, "oasType", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: 'schema'
         });
+        /**
+         * Constant value 'string' useful for type narrowing and tagged unions.
+         */
         Object.defineProperty(this, "type", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: 'string'
         });
-        _OasString_fields.set(this, void 0);
-        __classPrivateFieldSet(this, _OasString_fields, fields, "f");
-    }
-    get title() {
-        return __classPrivateFieldGet(this, _OasString_fields, "f").title;
-    }
-    get description() {
-        return __classPrivateFieldGet(this, _OasString_fields, "f").description;
-    }
-    get nullable() {
-        return __classPrivateFieldGet(this, _OasString_fields, "f").nullable;
+        /**
+         * A short summary of the string.
+         */
+        Object.defineProperty(this, "title", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /**
+         * A description of the string.
+         */
+        Object.defineProperty(this, "description", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /**
+         * The format of the string.
+         */
+        Object.defineProperty(this, "format", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /**
+         * An array of allowed values for the string.
+         */
+        Object.defineProperty(this, "enums", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /**
+         * Indicates whether value can be null.
+         */
+        Object.defineProperty(this, "nullable", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.title = fields.title;
+        this.description = fields.description;
+        this.format = fields.format;
+        this.enums = fields.enums;
+        this.nullable = fields.nullable;
     }
+    // get pattern() {
+    //   return this.fields.pattern
+    // }
     isRef() {
         return false;
     }
@@ -48,15 +88,5 @@ class OasString {
     resolveOnce() {
         return this;
     }
-    get format() {
-        return __classPrivateFieldGet(this, _OasString_fields, "f").format;
-    }
-    // get pattern() {
-    //   return this.fields.pattern
-    // }
-    get enums() {
-        return __classPrivateFieldGet(this, _OasString_fields, "f").enums;
-    }
 }
 exports.OasString = OasString;
-_OasString_fields = new WeakMap();

package/script/oas/union/Union.d.ts

@@ -8,16 +8,46 @@ export type UnionFields = {
     discriminator?: OasDiscriminator;
     members: (OasSchema | OasRef<'schema'>)[];
 };
+/**
+ * Object representing a 'oneOf' or 'anyOf' in the OpenAPI Specification.
+ *
+ * In the context of TypeScript 'anyOf' is not helpful since it implies
+ * a union that consists of all possible combinations of member types.
+ *
+ * Generating such combination types would not be useful and we map both
+ * 'oneOf' and 'anyOf' to a TypeScript union type.
+ */
 export declare class OasUnion {
-    #private;
-    oasType: 'schema';
-    type: 'union';
+    /**
+     * Object is part the 'schema' set which is used
+     * to define data types in an OpenAPI document.
+     */
+    oasType: "schema";
+    /**
+     * Constant value 'union' useful for type narrowing and tagged unions.
+     */
+    type: "union";
+    /**
+     * A short summary of the union.
+     */
+    title: string | undefined;
+    /**
+     * A description of the union.
+     */
+    description: string | undefined;
+    /**
+     * Indicates whether value can be null.
+     */
+    nullable: boolean | undefined;
+    /**
+     * Discriminator object used to tag member types and make the union a tagged union.
+     */
+    discriminator: OasDiscriminator | undefined;
+    /**
+     * Array of schemas or references to schemas that are part of the union.
+     */
+    members: (OasSchema | OasRef<'schema'>)[];
     constructor(fields: UnionFields);
-    get title(): string | undefined;
-    get description(): string | undefined;
-    get discriminator(): OasDiscriminator | undefined;
-    get members(): (OasSchema | OasRef<'schema'>)[];
-    get nullable(): boolean | undefined;
     isRef(): this is OasRef<'schema'>;
     resolve(): OasUnion;
     resolveOnce(): OasUnion;

package/script/oas/union/Union.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Union.d.ts","sourceRoot":"","sources":["../../../src/oas/union/Union.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAA;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAE3C,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,aAAa,CAAC,EAAE,gBAAgB,CAAA;IAChC,OAAO,EAAE,CAAC,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAA;CAC1C,CAAA;AAED,qBAAa,QAAQ;;IACnB,OAAO,EAAE,QAAQ,CAAW;IAC5B,IAAI,EAAE,OAAO,CAAU;gBAGX,MAAM,EAAE,WAAW;IAI/B,IAAI,KAAK,IAAI,MAAM,GAAG,SAAS,CAE9B;IAED,IAAI,WAAW,IAAI,MAAM,GAAG,SAAS,CAEpC;IAED,IAAI,aAAa,IAAI,gBAAgB,GAAG,SAAS,CAEhD;IAED,IAAI,OAAO,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,CAE9C;IAED,IAAI,QAAQ,IAAI,OAAO,GAAG,SAAS,CAElC;IAED,KAAK,IAAI,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC;IAIjC,OAAO,IAAI,QAAQ;IAInB,WAAW,IAAI,QAAQ;CAGxB"}
+{"version":3,"file":"Union.d.ts","sourceRoot":"","sources":["../../../src/oas/union/Union.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAA;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAE3C,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,aAAa,CAAC,EAAE,gBAAgB,CAAA;IAChC,OAAO,EAAE,CAAC,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAA;CAC1C,CAAA;AAED;;;;;;;;GAQG;AACH,qBAAa,QAAQ;IACnB;;;OAGG;IACH,OAAO,WAAoB;IAC3B;;OAEG;IACH,IAAI,UAAmB;IACvB;;OAEG;IACH,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB;;OAEG;IACH,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;IAC/B;;OAEG;IACH,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAA;IAC7B;;OAEG;IACH,aAAa,EAAE,gBAAgB,GAAG,SAAS,CAAA;IAC3C;;OAEG;IACH,OAAO,EAAE,CAAC,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAA;gBAE7B,MAAM,EAAE,WAAW;IAQ/B,KAAK,IAAI,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC;IAIjC,OAAO,IAAI,QAAQ;IAInB,WAAW,IAAI,QAAQ;CAGxB"}

package/script/oas/union/Union.js

@@ -1,49 +1,86 @@
 "use strict";
-var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
-    if (kind === "m") throw new TypeError("Private method is not writable");
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
-    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
-};
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
-var _OasUnion_fields;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OasUnion = void 0;
+/**
+ * Object representing a 'oneOf' or 'anyOf' in the OpenAPI Specification.
+ *
+ * In the context of TypeScript 'anyOf' is not helpful since it implies
+ * a union that consists of all possible combinations of member types.
+ *
+ * Generating such combination types would not be useful and we map both
+ * 'oneOf' and 'anyOf' to a TypeScript union type.
+ */
 class OasUnion {
     constructor(fields) {
+        /**
+         * Object is part the 'schema' set which is used
+         * to define data types in an OpenAPI document.
+         */
         Object.defineProperty(this, "oasType", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: 'schema'
         });
+        /**
+         * Constant value 'union' useful for type narrowing and tagged unions.
+         */
         Object.defineProperty(this, "type", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: 'union'
         });
-        _OasUnion_fields.set(this, void 0);
-        __classPrivateFieldSet(this, _OasUnion_fields, fields, "f");
-    }
-    get title() {
-        return __classPrivateFieldGet(this, _OasUnion_fields, "f").title;
-    }
-    get description() {
-        return __classPrivateFieldGet(this, _OasUnion_fields, "f").description;
-    }
-    get discriminator() {
-        return __classPrivateFieldGet(this, _OasUnion_fields, "f").discriminator;
-    }
-    get members() {
-        return __classPrivateFieldGet(this, _OasUnion_fields, "f").members;
-    }
-    get nullable() {
-        return __classPrivateFieldGet(this, _OasUnion_fields, "f").nullable;
+        /**
+         * A short summary of the union.
+         */
+        Object.defineProperty(this, "title", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /**
+         * A description of the union.
+         */
+        Object.defineProperty(this, "description", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /**
+         * Indicates whether value can be null.
+         */
+        Object.defineProperty(this, "nullable", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /**
+         * Discriminator object used to tag member types and make the union a tagged union.
+         */
+        Object.defineProperty(this, "discriminator", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        /**
+         * Array of schemas or references to schemas that are part of the union.
+         */
+        Object.defineProperty(this, "members", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.title = fields.title;
+        this.description = fields.description;
+        this.nullable = fields.nullable;
+        this.discriminator = fields.discriminator;
+        this.members = fields.members;
     }
     isRef() {
         return false;
@@ -56,4 +93,3 @@ class OasUnion {
     }
 }
 exports.OasUnion = OasUnion;
-_OasUnion_fields = new WeakMap();

package/script/oas/unknown/Unknown.d.ts

@@ -3,13 +3,32 @@ export type UnknownFields = {
     title?: string;
     description?: string;
 };
+/**
+ * Object representing an unknown type in the OpenAPI Specification.
+ *
+ * JSON schema treats a definition without any type information as 'any'.
+ * Since this is not useful in an API context, we use OasUnknown to
+ * represent types that are not specified.
+ */
 export declare class OasUnknown {
-    #private;
-    oasType: 'schema';
-    type: 'unknown';
+    /**
+     * Object is part the 'schema' set which is used
+     * to define data types in an OpenAPI document.
+     */
+    oasType: "schema";
+    /**
+     * Constant value 'unknown' useful for type narrowing and tagged unions.
+     */
+    type: "unknown";
+    /**
+     * A short summary of the unknown type.
+     */
+    title: string | undefined;
+    /**
+     * A description of the unknown type.
+     */
+    description: string | undefined;
     constructor(fields: UnknownFields);
-    get title(): string | undefined;
-    get description(): string | undefined;
     isRef(): this is OasRef<'schema'>;
     resolve(): OasUnknown;
     resolveOnce(): OasUnknown;

package/script/oas/unknown/Unknown.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Unknown.d.ts","sourceRoot":"","sources":["../../../src/oas/unknown/Unknown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAE3C,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,qBAAa,UAAU;;IACrB,OAAO,EAAE,QAAQ,CAAW;IAC5B,IAAI,EAAE,SAAS,CAAY;gBAGf,MAAM,EAAE,aAAa;IAIjC,IAAI,KAAK,IAAI,MAAM,GAAG,SAAS,CAE9B;IAED,IAAI,WAAW,IAAI,MAAM,GAAG,SAAS,CAEpC;IAED,KAAK,IAAI,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC;IAIjC,OAAO,IAAI,UAAU;IAIrB,WAAW,IAAI,UAAU;CAG1B"}
+{"version":3,"file":"Unknown.d.ts","sourceRoot":"","sources":["../../../src/oas/unknown/Unknown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAE3C,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED;;;;;;GAMG;AACH,qBAAa,UAAU;IACrB;;;OAGG;IACH,OAAO,WAAoB;IAC3B;;OAEG;IACH,IAAI,YAAqB;IACzB;;OAEG;IACH,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB;;OAEG;IACH,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;gBAEnB,MAAM,EAAE,aAAa;IAKjC,KAAK,IAAI,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC;IAIjC,OAAO,IAAI,UAAU;IAIrB,WAAW,IAAI,UAAU;CAG1B"}