@skmtc/core 0.0.798 → 0.0.799

package/script/oas/string/string-types.d.ts

@@ -1,4 +1,18 @@
 import * as v from 'valibot';
+/**
+ * Union type for OpenAPI string format specifiers.
+ *
+ * Represents the standard string formats defined in OpenAPI v3,
+ * providing semantic meaning for string validation and processing.
+ * Used for generating appropriate validation rules in target languages.
+ */
+export type StringFormat = 'date-time' | 'time' | 'date' | 'duration' | 'email' | 'hostname' | 'ipv4' | 'ipv6' | 'uuid' | 'uri' | 'regex' | 'password' | 'byte' | 'binary';
+/**
+ * Valibot enum schema for valid OpenAPI string format values.
+ *
+ * Defines the standard string formats supported by OpenAPI v3,
+ * including date/time formats, network formats, and encoding formats.
+ */
 export declare const stringFormat: v.EnumSchema<{
     readonly 'date-time': "date-time";
     readonly time: "time";
@@ -15,6 +29,12 @@ export declare const stringFormat: v.EnumSchema<{
     readonly byte: "byte";
     readonly binary: "binary";
 }, undefined>;
+/**
+ * Valibot schema for validating OpenAPI string data objects.
+ *
+ * Validates string schema objects including length constraints,
+ * pattern validation, format specifiers, and enumeration values.
+ */
 export declare const oasStringData: v.ObjectSchema<{
     readonly type: v.LiteralSchema<"string", undefined>;
     readonly title: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
@@ -28,18 +48,35 @@ export declare const oasStringData: v.ObjectSchema<{
     readonly nullable: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
     readonly example: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
 }, undefined>;
-export type StringFormat = 'date-time' | 'time' | 'date' | 'duration' | 'email' | 'hostname' | 'ipv4' | 'ipv6' | 'uuid' | 'uri' | 'regex' | 'password' | 'byte' | 'binary';
+/**
+ * Data type for OpenAPI string schema objects.
+ *
+ * Represents string schemas with validation constraints,
+ * format specifiers, and metadata. Used throughout the
+ * SKMTC pipeline for string type processing and code generation.
+ */
 export type OasStringData = {
+    /** Human-readable title for the string */
     title?: string;
+    /** Detailed description of the string's purpose */
     description?: string;
+    /** Default value for the string */
     default?: string;
+    /** Type identifier (always 'string') */
     type: 'string';
+    /** Maximum allowed length */
     maxLength?: number;
+    /** Minimum required length */
     minLength?: number;
+    /** Regular expression pattern for validation */
     pattern?: string;
+    /** Array of valid enumeration values */
     enum?: string[];
+    /** Format specifier (date-time, email, etc.) */
     format?: string;
+    /** Whether null values are allowed */
     nullable?: boolean;
+    /** Example value for documentation */
     example?: string;
 };
 //# sourceMappingURL=string-types.d.ts.map

package/script/oas/string/string-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"string-types.d.ts","sourceRoot":"","sources":["../../../src/oas/string/string-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;aAevB,CAAA;AAEF,eAAO,MAAM,aAAa;;;;;;;;;;;;aAYxB,CAAA;AAEF,MAAM,MAAM,YAAY,GACpB,WAAW,GACX,MAAM,GACN,MAAM,GACN,UAAU,GACV,OAAO,GACP,UAAU,GACV,MAAM,GACN,MAAM,GACN,MAAM,GACN,KAAK,GACL,OAAO,GACP,UAAU,GACV,MAAM,GACN,QAAQ,CAAA;AAEZ,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,QAAQ,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA"}
+{"version":3,"file":"string-types.d.ts","sourceRoot":"","sources":["../../../src/oas/string/string-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GACpB,WAAW,GACX,MAAM,GACN,MAAM,GACN,UAAU,GACV,OAAO,GACP,UAAU,GACV,MAAM,GACN,MAAM,GACN,MAAM,GACN,KAAK,GACL,OAAO,GACP,UAAU,GACV,MAAM,GACN,QAAQ,CAAA;AAEZ;;;;;GAKG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;aAevB,CAAA;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;aAYxB,CAAA;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,wCAAwC;IACxC,IAAI,EAAE,QAAQ,CAAA;IACd,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,sCAAsC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA"}

package/script/oas/string/string-types.js

@@ -35,6 +35,12 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.oasStringData = exports.stringFormat = void 0;
 const v = __importStar(require("valibot"));
+/**
+ * Valibot enum schema for valid OpenAPI string format values.
+ *
+ * Defines the standard string formats supported by OpenAPI v3,
+ * including date/time formats, network formats, and encoding formats.
+ */
 exports.stringFormat = v.enum({
     'date-time': 'date-time',
     time: 'time',
@@ -51,6 +57,12 @@ exports.stringFormat = v.enum({
     byte: 'byte',
     binary: 'binary'
 });
+/**
+ * Valibot schema for validating OpenAPI string data objects.
+ *
+ * Validates string schema objects including length constraints,
+ * pattern validation, format specifiers, and enumeration values.
+ */
 exports.oasStringData = v.object({
     type: v.literal('string'),
     title: v.optional(v.string()),

package/script/oas/union/union-types.d.ts

@@ -2,14 +2,34 @@ import * as v from 'valibot';
 import { type OasSchemaData } from '../schema/schema-types.js';
 import { type OasSchemaRefData } from '../ref/ref-types.js';
 import { type OasDiscriminatorData } from '../discriminator/discriminator-types.js';
+/**
+ * Data type for OpenAPI union schema objects.
+ *
+ * Represents union types (oneOf/anyOf) that allow values to match
+ * one or more of several possible schemas. Includes support for
+ * discriminator properties for efficient type resolution.
+ */
 export type OasUnionData = {
+    /** Type category identifier for schema objects */
     oasType: 'schema';
+    /** Type identifier (always 'union') */
     type: 'union';
+    /** Human-readable title for the union */
     title?: string;
+    /** Detailed description of the union's purpose */
     description?: string;
+    /** Array of schemas that comprise the union */
     members: (OasSchemaData | OasSchemaRefData)[];
+    /** Optional discriminator for efficient type resolution */
     discriminator?: OasDiscriminatorData;
 };
+/**
+ * Valibot schema for validating OpenAPI union data objects.
+ *
+ * Validates union schemas including member schema arrays and optional
+ * discriminator properties. Uses lazy evaluation to handle recursive
+ * schema references in union members.
+ */
 export declare const oasUnionData: v.ObjectSchema<{
     readonly oasType: v.LiteralSchema<"schema", undefined>;
     readonly type: v.LiteralSchema<"union", undefined>;

package/script/oas/union/union-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"union-types.d.ts","sourceRoot":"","sources":["../../../src/oas/union/union-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAC5B,OAAO,EAAE,KAAK,aAAa,EAAiB,MAAM,2BAA2B,CAAA;AAC7E,OAAO,EAAE,KAAK,gBAAgB,EAAoB,MAAM,qBAAqB,CAAA;AAC7E,OAAO,EACL,KAAK,oBAAoB,EAE1B,MAAM,yCAAyC,CAAA;AAEhD,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,QAAQ,CAAA;IACjB,IAAI,EAAE,OAAO,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,CAAC,aAAa,GAAG,gBAAgB,CAAC,EAAE,CAAA;IAC7C,aAAa,CAAC,EAAE,oBAAoB,CAAA;CACrC,CAAA;AAED,eAAO,MAAM,YAAY;;;;;;;;;;;aAOvB,CAAA"}
+{"version":3,"file":"union-types.d.ts","sourceRoot":"","sources":["../../../src/oas/union/union-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAC5B,OAAO,EAAE,KAAK,aAAa,EAAiB,MAAM,2BAA2B,CAAA;AAC7E,OAAO,EAAE,KAAK,gBAAgB,EAAoB,MAAM,qBAAqB,CAAA;AAC7E,OAAO,EACL,KAAK,oBAAoB,EAE1B,MAAM,yCAAyC,CAAA;AAEhD;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,kDAAkD;IAClD,OAAO,EAAE,QAAQ,CAAA;IACjB,uCAAuC;IACvC,IAAI,EAAE,OAAO,CAAA;IACb,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,+CAA+C;IAC/C,OAAO,EAAE,CAAC,aAAa,GAAG,gBAAgB,CAAC,EAAE,CAAA;IAC7C,2DAA2D;IAC3D,aAAa,CAAC,EAAE,oBAAoB,CAAA;CACrC,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;aAOvB,CAAA"}

package/script/oas/union/union-types.js

@@ -38,6 +38,13 @@ const v = __importStar(require("valibot"));
 const schema_types_js_1 = require("../schema/schema-types.js");
 const ref_types_js_1 = require("../ref/ref-types.js");
 const discriminator_types_js_1 = require("../discriminator/discriminator-types.js");
+/**
+ * Valibot schema for validating OpenAPI union data objects.
+ *
+ * Validates union schemas including member schema arrays and optional
+ * discriminator properties. Uses lazy evaluation to handle recursive
+ * schema references in union members.
+ */
 exports.oasUnionData = v.object({
     oasType: v.literal('schema'),
     type: v.literal('union'),

package/script/oas/unknown/unknown-types.d.ts

@@ -1,4 +1,10 @@
 import * as v from 'valibot';
+/**
+ * Valibot schema for validating OpenAPI unknown data objects.
+ *
+ * Validates unknown/unspecified schemas used as fallbacks when
+ * schema types cannot be determined or for flexible data handling.
+ */
 export declare const oasUnknownData: v.ObjectSchema<{
     readonly oasType: v.LiteralSchema<"schema", undefined>;
     readonly title: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
@@ -6,11 +12,23 @@ export declare const oasUnknownData: v.ObjectSchema<{
     readonly default: v.OptionalSchema<v.UnknownSchema, undefined>;
     readonly type: v.LiteralSchema<"unknown", undefined>;
 }, undefined>;
+/**
+ * Data type for OpenAPI unknown schema objects.
+ *
+ * Represents schemas with unspecified or flexible types, used as
+ * fallbacks when schema types cannot be determined or when maximum
+ * flexibility is required in the API specification.
+ */
 export type OasUnknownData = {
+    /** Type category identifier for schema objects */
     oasType: 'schema';
+    /** Human-readable title for the unknown schema */
     title?: string;
+    /** Detailed description of the schema's purpose */
     description?: string;
+    /** Default value of any type */
     default?: unknown;
+    /** Type identifier (always 'unknown') */
     type: 'unknown';
 };
 //# sourceMappingURL=unknown-types.d.ts.map

package/script/oas/unknown/unknown-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"unknown-types.d.ts","sourceRoot":"","sources":["../../../src/oas/unknown/unknown-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,eAAO,MAAM,cAAc;;;;;;aAMzB,CAAA;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,QAAQ,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,IAAI,EAAE,SAAS,CAAA;CAChB,CAAA"}
+{"version":3,"file":"unknown-types.d.ts","sourceRoot":"","sources":["../../../src/oas/unknown/unknown-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B;;;;;GAKG;AACH,eAAO,MAAM,cAAc;;;;;;aAMzB,CAAA;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,kDAAkD;IAClD,OAAO,EAAE,QAAQ,CAAA;IACjB,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,gCAAgC;IAChC,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,yCAAyC;IACzC,IAAI,EAAE,SAAS,CAAA;CAChB,CAAA"}

package/script/oas/unknown/unknown-types.js

@@ -35,6 +35,12 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.oasUnknownData = void 0;
 const v = __importStar(require("valibot"));
+/**
+ * Valibot schema for validating OpenAPI unknown data objects.
+ *
+ * Validates unknown/unspecified schemas used as fallbacks when
+ * schema types cannot be determined or for flexible data handling.
+ */
 exports.oasUnknownData = v.object({
     oasType: v.literal('schema'),
     title: v.optional(v.string()),