@skmtc/core 0.0.984 → 0.16.2

package/esm/parse/v3-0/boolean/toBoolean.d.ts

@@ -0,0 +1,79 @@
+import type { OpenAPIV3 } from 'openapi-types';
+import type { ParseContextType } from '../../../context/parseTypes.js';
+import { OasBoolean } from '../../../oas/boolean/Boolean.js';
+import type { StackTrail } from '../../../context/StackTrail.js';
+export type ToBooleanArgs = {
+    value: OpenAPIV3.SchemaObject;
+    stackTrail: StackTrail;
+    context: ParseContextType;
+};
+/**
+ * Transforms an OpenAPI v3 boolean schema object into an internal OAS boolean representation.
+ *
+ * This function processes OpenAPI boolean schemas by extracting and parsing nullable values,
+ * examples, enumerations, and default values. It handles the complete transformation from
+ * raw OpenAPI JSON to the SKMTC internal boolean representation with proper validation.
+ *
+ * The transformation follows a pipeline approach:
+ * 1. Parse nullable flag and extract base value
+ * 2. Parse example values with nullable support
+ * 3. Parse enumeration constraints (typically [true], [false], or [true, false])
+ * 4. Parse default values
+ * 5. Create final OasBoolean instance
+ *
+ * @param args - Transformation arguments
+ * @param args.value - The OpenAPI v3 boolean schema object to transform
+ * @param args.context - Parse context providing utilities and tracing
+ * @returns Transformed OAS boolean object with parsed properties
+ *
+ * @example Basic boolean transformation
+ * ```typescript
+ * import { toBoolean } from '@skmtc/core';
+ *
+ * const openApiBoolean = {
+ *   type: 'boolean',
+ *   default: false
+ * };
+ *
+ * const oasBoolean = toBoolean({
+ *   value: openApiBoolean,
+ *   context: parseContext
+ * });
+ *
+ * console.log(oasBoolean.default); // false
+ * ```
+ *
+ * @example Boolean with nullable and enum
+ * ```typescript
+ * const flagBoolean = {
+ *   type: 'boolean',
+ *   nullable: true,
+ *   enum: [true, null],
+ *   default: null,
+ *   example: true,
+ *   title: 'Feature Flag',
+ *   description: 'Whether the feature is enabled'
+ * };
+ *
+ * const oasBoolean = toBoolean({
+ *   value: flagBoolean,
+ *   context: parseContext
+ * });
+ *
+ * console.log(oasBoolean.nullable); // true
+ * console.log(oasBoolean.enums); // [true, null]
+ * ```
+ */
+export declare const toBoolean: ({ value, stackTrail, context }: ToBooleanArgs) => OasBoolean;
+type ToParsedBooleanArgs<Nullable extends boolean | undefined> = {
+    value: Omit<OpenAPIV3.SchemaObject, 'nullable' | 'example' | 'enums'>;
+    context: ParseContextType;
+    nullable: Nullable;
+    example: Nullable extends true ? boolean | null | undefined : boolean | undefined;
+    enums: Nullable extends true ? (boolean | null)[] | undefined : boolean[] | undefined;
+    defaultValue: Nullable extends true ? boolean | null | undefined : boolean | undefined;
+    stackTrail: StackTrail;
+};
+export declare const toParsedBoolean: <Nullable extends boolean | undefined>({ context, nullable, example, enums, defaultValue, value, stackTrail }: ToParsedBooleanArgs<Nullable>) => OasBoolean<Nullable>;
+export {};
+//# sourceMappingURL=toBoolean.d.ts.map

package/esm/parse/v3-0/boolean/toBoolean.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toBoolean.d.ts","sourceRoot":"","sources":["../../../../src/parse/v3-0/boolean/toBoolean.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAA;AAQ5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAEhE,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,SAAS,CAAC,YAAY,CAAA;IAC7B,UAAU,EAAE,UAAU,CAAA;IACtB,OAAO,EAAE,gBAAgB,CAAA;CAC1B,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,eAAO,MAAM,SAAS,GAAI,gCAAgC,aAAa,KAAG,UAoDzE,CAAA;AAED,KAAK,mBAAmB,CAAC,QAAQ,SAAS,OAAO,GAAG,SAAS,IAAI;IAC/D,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC,CAAA;IACrE,OAAO,EAAE,gBAAgB,CAAA;IACzB,QAAQ,EAAE,QAAQ,CAAA;IAClB,OAAO,EAAE,QAAQ,SAAS,IAAI,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAA;IACjF,KAAK,EAAE,QAAQ,SAAS,IAAI,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,GAAG,SAAS,GAAG,OAAO,EAAE,GAAG,SAAS,CAAA;IACrF,YAAY,EAAE,QAAQ,SAAS,IAAI,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAA;IACtF,UAAU,EAAE,UAAU,CAAA;CACvB,CAAA;AAED,eAAO,MAAM,eAAe,GAAI,QAAQ,SAAS,OAAO,GAAG,SAAS,EAAE,wEAQnE,mBAAmB,CAAC,QAAQ,CAAC,KAAG,UAAU,CAAC,QAAQ,CAgCrD,CAAA"}

package/esm/parse/v3-0/boolean/toBoolean.js

@@ -0,0 +1,139 @@
+import { OasBoolean } from '../../../oas/boolean/Boolean.js';
+import { toSpecificationExtensionsV3 } from '../specificationExtensions/toSpecificationExtensionsV3.js';
+import { oasBooleanData } from '../../../oas/boolean/boolean-types.js';
+import { parseNullable } from '../_helpers/parseNullable.js';
+import { parseEnum } from '../_helpers/parseEnum.js';
+import { parseExample } from '../_helpers/parseExample.js';
+import { parseDefault } from '../_helpers/parseDefault.js';
+import * as v from 'valibot';
+/**
+ * Transforms an OpenAPI v3 boolean schema object into an internal OAS boolean representation.
+ *
+ * This function processes OpenAPI boolean schemas by extracting and parsing nullable values,
+ * examples, enumerations, and default values. It handles the complete transformation from
+ * raw OpenAPI JSON to the SKMTC internal boolean representation with proper validation.
+ *
+ * The transformation follows a pipeline approach:
+ * 1. Parse nullable flag and extract base value
+ * 2. Parse example values with nullable support
+ * 3. Parse enumeration constraints (typically [true], [false], or [true, false])
+ * 4. Parse default values
+ * 5. Create final OasBoolean instance
+ *
+ * @param args - Transformation arguments
+ * @param args.value - The OpenAPI v3 boolean schema object to transform
+ * @param args.context - Parse context providing utilities and tracing
+ * @returns Transformed OAS boolean object with parsed properties
+ *
+ * @example Basic boolean transformation
+ * ```typescript
+ * import { toBoolean } from '@skmtc/core';
+ *
+ * const openApiBoolean = {
+ *   type: 'boolean',
+ *   default: false
+ * };
+ *
+ * const oasBoolean = toBoolean({
+ *   value: openApiBoolean,
+ *   context: parseContext
+ * });
+ *
+ * console.log(oasBoolean.default); // false
+ * ```
+ *
+ * @example Boolean with nullable and enum
+ * ```typescript
+ * const flagBoolean = {
+ *   type: 'boolean',
+ *   nullable: true,
+ *   enum: [true, null],
+ *   default: null,
+ *   example: true,
+ *   title: 'Feature Flag',
+ *   description: 'Whether the feature is enabled'
+ * };
+ *
+ * const oasBoolean = toBoolean({
+ *   value: flagBoolean,
+ *   context: parseContext
+ * });
+ *
+ * console.log(oasBoolean.nullable); // true
+ * console.log(oasBoolean.enums); // [true, null]
+ * ```
+ */
+export const toBoolean = ({ value, stackTrail, context }) => {
+    const { nullable, value: valueWithoutNullable } = parseNullable({
+        value,
+        context,
+        stackTrail
+    });
+    const { example: unparsedExample, ...valueWithoutExample } = valueWithoutNullable;
+    const example = parseExample({
+        value: unparsedExample,
+        context,
+        parent: valueWithoutNullable,
+        nullable,
+        check: isBoolean,
+        toMessage: item => `Removed invalid example. Expected "boolean", got: ${item}`,
+        stackTrail
+    });
+    const { enum: unparsedEnums, ...valueWithoutEnums } = valueWithoutExample;
+    const enums = parseEnum({
+        value: unparsedEnums,
+        nullable,
+        parent: valueWithoutExample,
+        stackTrail,
+        context,
+        check: isBoolean,
+        toMessage: item => `Removed invalid enum. Expected "boolean", got: ${item}`
+    });
+    const { default: unparsedDefaultValue, ...valueWithoutDefault } = valueWithoutEnums;
+    const defaultValue = parseDefault({
+        value: unparsedDefaultValue,
+        context,
+        parent: valueWithoutEnums,
+        nullable,
+        check: isBoolean,
+        toMessage: item => `Removed invalid default. Expected "boolean", got: ${item}`,
+        stackTrail
+    });
+    return toParsedBoolean({
+        context,
+        nullable,
+        example,
+        enums,
+        defaultValue,
+        value: valueWithoutDefault,
+        stackTrail
+    });
+};
+export const toParsedBoolean = ({ context, nullable, example, enums, defaultValue, value, stackTrail }) => {
+    if (!v.is(oasBooleanData, value)) {
+        v.parse(oasBooleanData, value);
+    }
+    const { type: _type, title, description, readOnly, writeOnly, deprecated, ...skipped } = value;
+    const extensionFields = toSpecificationExtensionsV3({
+        skipped,
+        parent: value,
+        context,
+        stackTrail,
+        parentType: 'schema:boolean'
+    });
+    return context.withStackTrail(stackTrail, () => new OasBoolean({
+        nullable,
+        title,
+        description,
+        example,
+        enums: enums,
+        default: defaultValue,
+        extensionFields,
+        readOnly,
+        writeOnly,
+        deprecated
+    }, context));
+};
+const isBoolean = (value) => {
+    return typeof value === 'boolean';
+};

package/esm/parse/v3-0/components/toComponentsV3.d.ts

@@ -0,0 +1,11 @@
+import type { OpenAPIV3 } from 'openapi-types';
+import type { ParseContextType } from '../../../context/parseTypes.js';
+import { OasComponents } from '../../../oas/components/Components.js';
+import type { StackTrail } from '../../../context/StackTrail.js';
+export type ToComponentsV3Args = {
+    components: OpenAPIV3.ComponentsObject | undefined;
+    stackTrail: StackTrail;
+    context: ParseContextType;
+};
+export declare const toComponentsV3: ({ components, stackTrail, context }: ToComponentsV3Args) => OasComponents | undefined;
+//# sourceMappingURL=toComponentsV3.d.ts.map

package/esm/parse/v3-0/components/toComponentsV3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toComponentsV3.d.ts","sourceRoot":"","sources":["../../../../src/parse/v3-0/components/toComponentsV3.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AAGtE,OAAO,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAA;AAIrE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAEhE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,UAAU,EAAE,SAAS,CAAC,gBAAgB,GAAG,SAAS,CAAA;IAClD,UAAU,EAAE,UAAU,CAAA;IACtB,OAAO,EAAE,gBAAgB,CAAA;CAC1B,CAAA;AAED,eAAO,MAAM,cAAc,GAAI,qCAI5B,kBAAkB,KAAG,aAAa,GAAG,SAoDvC,CAAA"}

package/esm/parse/v3-0/components/toComponentsV3.js

@@ -0,0 +1,39 @@
+import { toOptionalResponsesV3 } from '../response/toResponseV3.js';
+import { toHeadersV3 } from '../header/toHeadersV3.js';
+import { toOptionalSchemasV3 } from '../schema/toSchemasV3.js';
+import { toOptionalParametersV3 } from '../parameter/toParameterV3.js';
+import { toExamplesV3 } from '../example/toExamplesV3.js';
+import { toRequestBodiesV3 } from '../requestBody/toRequestBodiesV3.js';
+import { OasComponents } from '../../../oas/components/Components.js';
+import { toSpecificationExtensionsV3 } from '../specificationExtensions/toSpecificationExtensionsV3.js';
+import { toSecuritySchemesV3 } from '../securitySchemes/toSecuritySchemes.js';
+export const toComponentsV3 = ({ components, stackTrail, context }) => {
+    if (!components) {
+        return undefined;
+    }
+    const { schemas, responses, parameters, examples, requestBodies, headers, securitySchemes, ...skipped } = components;
+    const extensionFields = toSpecificationExtensionsV3({
+        skipped,
+        parent: components,
+        context,
+        stackTrail,
+        parentType: 'components'
+    });
+    const fields = {
+        schemas: stackTrail.trace('schemas', st => toOptionalSchemasV3({ schemas, stackTrail: st, context })),
+        responses: stackTrail.trace('responses', st => toOptionalResponsesV3({ responses, stackTrail: st, context })),
+        parameters: stackTrail.trace('parameters', st => toOptionalParametersV3({ parameters, stackTrail: st, context })),
+        examples: toExamplesV3({
+            examples,
+            example: undefined,
+            exampleKey: 'TEMP',
+            stackTrail,
+            context
+        }),
+        requestBodies: stackTrail.trace('requestBodies', st => toRequestBodiesV3({ requestBodies, stackTrail: st, context })),
+        headers: stackTrail.trace('headers', st => toHeadersV3({ headers, stackTrail: st, context })),
+        securitySchemes: stackTrail.trace('securitySchemes', st => toSecuritySchemesV3({ securitySchemes, stackTrail: st, context })),
+        extensionFields
+    };
+    return new OasComponents(fields);
+};

package/esm/parse/v3-0/contact/toContactV3.d.ts

@@ -0,0 +1,6 @@
+import type { OpenAPIV3 } from 'openapi-types';
+import type { ParseContextType } from '../../../context/parseTypes.js';
+import { OasContact } from '../../../oas/contact/Contact.js';
+import type { StackTrail } from '../../../context/StackTrail.js';
+export declare const toContactV3: (contact: OpenAPIV3.ContactObject, stackTrail: StackTrail, context: ParseContextType) => OasContact;
+//# sourceMappingURL=toContactV3.d.ts.map

package/esm/parse/v3-0/contact/toContactV3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toContactV3.d.ts","sourceRoot":"","sources":["../../../../src/parse/v3-0/contact/toContactV3.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AAEtE,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAA;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAEhE,eAAO,MAAM,WAAW,GACtB,SAAS,SAAS,CAAC,aAAa,EAChC,YAAY,UAAU,EACtB,SAAS,gBAAgB,KACxB,UAiBF,CAAA"}

package/esm/parse/v3-0/contact/toContactV3.js

@@ -0,0 +1,18 @@
+import { toSpecificationExtensionsV3 } from '../specificationExtensions/toSpecificationExtensionsV3.js';
+import { OasContact } from '../../../oas/contact/Contact.js';
+export const toContactV3 = (contact, stackTrail, context) => {
+    const { name, url, email, ...skipped } = contact;
+    const extensionFields = toSpecificationExtensionsV3({
+        skipped,
+        parent: contact,
+        context,
+        stackTrail,
+        parentType: 'contact'
+    });
+    return new OasContact({
+        name,
+        url,
+        email,
+        extensionFields
+    });
+};

package/esm/parse/v3-0/discriminator/toDiscriminatorV3.d.ts

@@ -0,0 +1,11 @@
+import type { OpenAPIV3 } from 'openapi-types';
+import type { ParseContextType } from '../../../context/parseTypes.js';
+import { OasDiscriminator } from '../../../oas/discriminator/Discriminator.js';
+import type { StackTrail } from '../../../context/StackTrail.js';
+export type ToDiscriminatorV3Args = {
+    discriminator: OpenAPIV3.DiscriminatorObject | undefined;
+    stackTrail: StackTrail;
+    context: ParseContextType;
+};
+export declare const toDiscriminatorV3: ({ discriminator, stackTrail, context }: ToDiscriminatorV3Args) => OasDiscriminator | undefined;
+//# sourceMappingURL=toDiscriminatorV3.d.ts.map

package/esm/parse/v3-0/discriminator/toDiscriminatorV3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toDiscriminatorV3.d.ts","sourceRoot":"","sources":["../../../../src/parse/v3-0/discriminator/toDiscriminatorV3.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6CAA6C,CAAA;AAE9E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAEhE,MAAM,MAAM,qBAAqB,GAAG;IAClC,aAAa,EAAE,SAAS,CAAC,mBAAmB,GAAG,SAAS,CAAA;IACxD,UAAU,EAAE,UAAU,CAAA;IACtB,OAAO,EAAE,gBAAgB,CAAA;CAC1B,CAAA;AAED,eAAO,MAAM,iBAAiB,GAAI,wCAI/B,qBAAqB,KAAG,gBAAgB,GAAG,SAoB7C,CAAA"}

package/esm/parse/v3-0/discriminator/toDiscriminatorV3.js

@@ -0,0 +1,20 @@
+import { OasDiscriminator } from '../../../oas/discriminator/Discriminator.js';
+import { isEmpty } from '../../../helpers/isEmpty.js';
+export const toDiscriminatorV3 = ({ discriminator, stackTrail, context }) => {
+    if (!discriminator) {
+        return undefined;
+    }
+    const { propertyName, mapping, ...skipped } = discriminator;
+    if (!isEmpty(skipped)) {
+        context.logSkippedFields({
+            skipped,
+            parent: discriminator,
+            parentType: 'discriminator',
+            stackTrail
+        });
+    }
+    return new OasDiscriminator({
+        propertyName,
+        mapping
+    });
+};

package/esm/parse/v3-0/document/toDocumentFieldsV3.d.ts

@@ -0,0 +1,14 @@
+import type { OpenAPIV3 } from 'openapi-types';
+import type { ParseContextType } from '../../../context/parseTypes.js';
+import { type WebhooksObject } from '../webhook/toWebhooksV3.js';
+import type { DocumentFields } from '../../../oas/document/Document.js';
+import type { StackTrail } from '../../../context/StackTrail.js';
+export type ToDocumentV3Args = {
+    documentObject: OpenAPIV3.Document & {
+        webhooks?: WebhooksObject;
+    };
+    stackTrail: StackTrail;
+    context: ParseContextType;
+};
+export declare const toDocumentFieldsV3: ({ documentObject, stackTrail, context }: ToDocumentV3Args) => DocumentFields;
+//# sourceMappingURL=toDocumentFieldsV3.d.ts.map

package/esm/parse/v3-0/document/toDocumentFieldsV3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toDocumentFieldsV3.d.ts","sourceRoot":"","sources":["../../../../src/parse/v3-0/document/toDocumentFieldsV3.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AAGtE,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAG9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAA;AAKvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAEhE,MAAM,MAAM,gBAAgB,GAAG;IAI7B,cAAc,EAAE,SAAS,CAAC,QAAQ,GAAG;QAAE,QAAQ,CAAC,EAAE,cAAc,CAAA;KAAE,CAAA;IAClE,UAAU,EAAE,UAAU,CAAA;IACtB,OAAO,EAAE,gBAAgB,CAAA;CAC1B,CAAA;AAED,eAAO,MAAM,kBAAkB,GAAI,yCAIhC,gBAAgB,KAAG,cA4CrB,CAAA"}

package/esm/parse/v3-0/document/toDocumentFieldsV3.js

@@ -0,0 +1,32 @@
+import { toTagsV3 } from '../tag/toTagsV3.js';
+import { toOperationsV3 } from '../operation/toOperationsV3.js';
+import { toWebhooksV3 } from '../webhook/toWebhooksV3.js';
+import { toComponentsV3 } from '../components/toComponentsV3.js';
+import { toInfoV3 } from '../info/toInfoV3.js';
+import { toSpecificationExtensionsV3 } from '../specificationExtensions/toSpecificationExtensionsV3.js';
+import { toOptionalServersV3 } from '../server/toServerV3.js';
+import { toSecurityRequirementsV3 } from '../securityRequirement/toSecurityRequirement.js';
+import { toExternalDocs } from '../externalDocs/toExternalDocs.js';
+export const toDocumentFieldsV3 = ({ documentObject, stackTrail, context }) => {
+    const { openapi, info, paths, components, tags, servers, security, externalDocs, webhooks, ...skipped } = documentObject;
+    const extensionFields = toSpecificationExtensionsV3({
+        skipped,
+        parent: documentObject,
+        context,
+        stackTrail,
+        parentType: 'document'
+    });
+    return {
+        openapi,
+        info: stackTrail.trace('info', st => toInfoV3({ info, stackTrail: st, context })),
+        servers: stackTrail.trace('servers', st => toOptionalServersV3({ servers, stackTrail: st, context })),
+        operations: stackTrail.trace('paths', st => toOperationsV3({ paths, stackTrail: st, context })),
+        webhooks: stackTrail.trace('webhooks', st => toWebhooksV3({ webhooks, stackTrail: st, context })),
+        components: stackTrail.trace('components', st => toComponentsV3({ components, stackTrail: st, context })),
+        tags: stackTrail.trace('tags', st => toTagsV3({ tags, stackTrail: st, context })),
+        security: stackTrail.trace('security', st => toSecurityRequirementsV3({ security, stackTrail: st, context })),
+        extensionFields,
+        externalDocs: stackTrail.trace('externalDocs', st => toExternalDocs({ externalDocs, stackTrail: st, context }))
+    };
+};
+// stackTrail.trace('info', (x) => formatNumber(x))

package/esm/parse/v3-0/example/toExamplesV3.d.ts

@@ -0,0 +1,68 @@
+import type { ParseContextType } from '../../../context/parseTypes.js';
+import type { OpenAPIV3 } from 'openapi-types';
+import { OasExample } from '../../../oas/example/Example.js';
+import type { OasRef } from '../../../oas/ref/Ref.js';
+import type { StackTrail } from '../../../context/StackTrail.js';
+export type ToExampleSimpleV3Args = {
+    example: OpenAPIV3.ExampleObject;
+    /** The stack trail for tracing */
+    stackTrail: StackTrail;
+    /** Parse context for tracing and error handling */
+    context: ParseContextType;
+};
+/**
+ * Creates a simple OAS example from a value.
+ *
+ * Converts a raw example value into an OasExample object with basic
+ * fields. Used for simple example scenarios where only the value matters.
+ *
+ * @param args - Arguments containing the example value
+ * @returns OasExample object with the provided value
+ */
+export declare const toExampleSimpleV3: ({ example }: ToExampleSimpleV3Args) => OasExample | OasRef<"example">;
+/**
+ * Arguments for processing OpenAPI v3 examples into OAS example objects.
+ *
+ * Handles both single example and examples collection scenarios,
+ * with context for tracing and error handling.
+ */
+export type ToExamplesV3Args = {
+    /** Single example object (OpenAPI v3 format) */
+    example: OpenAPIV3.ExampleObject | undefined;
+    /** Collection of named examples (OpenAPI v3 format) */
+    examples: Record<string, OpenAPIV3.ExampleObject | OpenAPIV3.ReferenceObject> | undefined;
+    /** Key name for the example context */
+    exampleKey: string;
+    /** The stack trail for tracing */
+    stackTrail: StackTrail;
+    /** Parse context for tracing and error handling */
+    context: ParseContextType;
+};
+/**
+ * Processes OpenAPI v3 examples into OAS example objects.
+ *
+ * Handles both single example and examples collection scenarios,
+ * converting them to the internal OAS representation. Provides
+ * warnings when both formats are specified simultaneously.
+ *
+ * @param args - Arguments containing example data and context
+ * @returns Record of processed examples, or undefined if no examples
+ */
+export declare const toExamplesV3: ({ example, examples, exampleKey, stackTrail, context }: ToExamplesV3Args) => Record<string, OasExample | OasRef<"example">> | undefined;
+export type ToExampleV3Args = {
+    example: OpenAPIV3.ExampleObject | OpenAPIV3.ReferenceObject;
+    stackTrail: StackTrail;
+    context: ParseContextType;
+};
+/**
+ * Processes a single OpenAPI v3 example into an OAS example object.
+ *
+ * Converts OpenAPI v3 example objects or references into the internal
+ * OAS representation, handling both direct examples and $ref references.
+ * Processes specification extensions and maintains all example metadata.
+ *
+ * @param args - Arguments containing the example and parsing context
+ * @returns OasExample object or reference to an example
+ */
+export declare const toExampleV3: ({ example, stackTrail, context }: ToExampleV3Args) => OasExample | OasRef<"example">;
+//# sourceMappingURL=toExamplesV3.d.ts.map

package/esm/parse/v3-0/example/toExamplesV3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toExamplesV3.d.ts","sourceRoot":"","sources":["../../../../src/parse/v3-0/example/toExamplesV3.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AACtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAG9C,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAA;AAE5D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAErD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAChE,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,SAAS,CAAC,aAAa,CAAA;IAChC,kCAAkC;IAClC,UAAU,EAAE,UAAU,CAAA;IACtB,mDAAmD;IACnD,OAAO,EAAE,gBAAgB,CAAA;CAC1B,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,GAAI,aAE/B,qBAAqB,KAAG,UAAU,GAAG,MAAM,CAAC,SAAS,CASvD,CAAA;AAED;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,gDAAgD;IAChD,OAAO,EAAE,SAAS,CAAC,aAAa,GAAG,SAAS,CAAA;IAC5C,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,aAAa,GAAG,SAAS,CAAC,eAAe,CAAC,GAAG,SAAS,CAAA;IACzF,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAA;IAClB,kCAAkC;IAClC,UAAU,EAAE,UAAU,CAAA;IACtB,mDAAmD;IACnD,OAAO,EAAE,gBAAgB,CAAA;CAC1B,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY,GAAI,wDAM1B,gBAAgB,KAAG,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,SAoCtE,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,SAAS,CAAC,aAAa,GAAG,SAAS,CAAC,eAAe,CAAA;IAC5D,UAAU,EAAE,UAAU,CAAA;IACtB,OAAO,EAAE,gBAAgB,CAAA;CAC1B,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,WAAW,GAAI,kCAIzB,eAAe,KAAG,UAAU,GAAG,MAAM,CAAC,SAAS,CAqBjD,CAAA"}

package/esm/parse/v3-0/example/toExamplesV3.js

@@ -0,0 +1,89 @@
+import { isRef } from '../../../helpers/refFns.js';
+import { toRefV31 } from '../ref/toRefV31.js';
+import { OasExample } from '../../../oas/example/Example.js';
+import { toSpecificationExtensionsV3 } from '../specificationExtensions/toSpecificationExtensionsV3.js';
+/**
+ * Creates a simple OAS example from a value.
+ *
+ * Converts a raw example value into an OasExample object with basic
+ * fields. Used for simple example scenarios where only the value matters.
+ *
+ * @param args - Arguments containing the example value
+ * @returns OasExample object with the provided value
+ */
+export const toExampleSimpleV3 = ({ example }) => {
+    const fields = {
+        value: example.value,
+        summary: example.summary,
+        description: example.description,
+        externalValue: example.externalValue
+    };
+    return new OasExample(fields);
+};
+/**
+ * Processes OpenAPI v3 examples into OAS example objects.
+ *
+ * Handles both single example and examples collection scenarios,
+ * converting them to the internal OAS representation. Provides
+ * warnings when both formats are specified simultaneously.
+ *
+ * @param args - Arguments containing example data and context
+ * @returns Record of processed examples, or undefined if no examples
+ */
+export const toExamplesV3 = ({ example, examples, exampleKey, stackTrail, context }) => {
+    if (example && examples) {
+        context.logIssue({
+            key: 'example',
+            level: 'warning',
+            message: `Both example and examples are defined for ${exampleKey}`,
+            parent: examples,
+            stackTrail,
+            type: 'EXAMPLE_AND_EXAMPLES_DEFINED'
+        });
+    }
+    if (example) {
+        return {
+            [exampleKey]: stackTrail.trace('example', st => toExampleSimpleV3({ example, stackTrail: st, context }))
+        };
+    }
+    if (examples) {
+        return stackTrail.trace('examples', st => {
+            const output = {};
+            const entries = Object.entries(examples);
+            for (const [key, value] of entries) {
+                output[key] = st.trace(key, st2 => toExampleV3({ example: value, stackTrail: st2, context }));
+            }
+            return output;
+        });
+    }
+    return undefined;
+};
+/**
+ * Processes a single OpenAPI v3 example into an OAS example object.
+ *
+ * Converts OpenAPI v3 example objects or references into the internal
+ * OAS representation, handling both direct examples and $ref references.
+ * Processes specification extensions and maintains all example metadata.
+ *
+ * @param args - Arguments containing the example and parsing context
+ * @returns OasExample object or reference to an example
+ */
+export const toExampleV3 = ({ example, stackTrail, context }) => {
+    if (isRef(example)) {
+        return toRefV31({ ref: example, refType: 'example', stackTrail, context });
+    }
+    const { summary, description, value, ...skipped } = example;
+    const extensionFields = toSpecificationExtensionsV3({
+        skipped,
+        parent: example,
+        context,
+        stackTrail,
+        parentType: 'example'
+    });
+    return new OasExample({
+        summary,
+        description,
+        value,
+        extensionFields
+    });
+};

package/esm/parse/v3-0/externalDocs/toExternalDocs.d.ts

@@ -0,0 +1,11 @@
+import { OasExternalDocs } from '../../../oas/externalDocs/ExternalDocs.js';
+import type { OpenAPIV3 } from 'openapi-types';
+import type { ParseContextType } from '../../../context/parseTypes.js';
+import type { StackTrail } from '../../../context/StackTrail.js';
+export type ToExternalDocsArgs = {
+    externalDocs: OpenAPIV3.ExternalDocumentationObject | undefined;
+    stackTrail: StackTrail;
+    context: ParseContextType;
+};
+export declare const toExternalDocs: ({ externalDocs, stackTrail }: ToExternalDocsArgs) => OasExternalDocs | undefined;
+//# sourceMappingURL=toExternalDocs.d.ts.map

package/esm/parse/v3-0/externalDocs/toExternalDocs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toExternalDocs.d.ts","sourceRoot":"","sources":["../../../../src/parse/v3-0/externalDocs/toExternalDocs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,2CAA2C,CAAA;AAG3E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAEhE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,YAAY,EAAE,SAAS,CAAC,2BAA2B,GAAG,SAAS,CAAA;IAC/D,UAAU,EAAE,UAAU,CAAA;IACtB,OAAO,EAAE,gBAAgB,CAAA;CAC1B,CAAA;AAED,eAAO,MAAM,cAAc,GAAI,8BAG5B,kBAAkB,KAAG,eAAe,GAAG,SAazC,CAAA"}

package/esm/parse/v3-0/externalDocs/toExternalDocs.js

@@ -0,0 +1,15 @@
+import { OasExternalDocs } from '../../../oas/externalDocs/ExternalDocs.js';
+import * as v from 'valibot';
+import { oasExternalDocsData } from '../../../oas/externalDocs/externalDocsTypes.js';
+export const toExternalDocs = ({ externalDocs, stackTrail }) => {
+    if (!externalDocs) {
+        return undefined;
+    }
+    if (!v.is(oasExternalDocsData, externalDocs)) {
+        v.parse(oasExternalDocsData, externalDocs);
+    }
+    return new OasExternalDocs({
+        url: externalDocs.url,
+        description: externalDocs.description
+    });
+};

package/esm/parse/v3-0/header/toHeadersV3.d.ts

@@ -0,0 +1,17 @@
+import type { ParseContextType } from '../../../context/parseTypes.js';
+import type { OpenAPIV3 } from 'openapi-types';
+import { OasHeader } from '../../../oas/header/Header.js';
+import type { OasRef } from '../../../oas/ref/Ref.js';
+import type { StackTrail } from '../../../context/StackTrail.js';
+export type ToHeadersV3Args = {
+    headers: Record<string, OpenAPIV3.ReferenceObject | OpenAPIV3.HeaderObject> | undefined;
+    stackTrail: StackTrail;
+    context: ParseContextType;
+};
+export declare const toHeadersV3: ({ headers, stackTrail, context }: ToHeadersV3Args) => Record<string, OasHeader | OasRef<"header">> | undefined;
+export type ToHeaderV3Args = {
+    header: OpenAPIV3.ReferenceObject | OpenAPIV3.HeaderObject;
+    stackTrail: StackTrail;
+    context: ParseContextType;
+};
+//# sourceMappingURL=toHeadersV3.d.ts.map

package/esm/parse/v3-0/header/toHeadersV3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toHeadersV3.d.ts","sourceRoot":"","sources":["../../../../src/parse/v3-0/header/toHeadersV3.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AAEtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAE9C,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAA;AAEzD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAErD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAChE,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,eAAe,GAAG,SAAS,CAAC,YAAY,CAAC,GAAG,SAAS,CAAA;IACvF,UAAU,EAAE,UAAU,CAAA;IACtB,OAAO,EAAE,gBAAgB,CAAA;CAC1B,CAAA;AAED,eAAO,MAAM,WAAW,GAAI,kCAIzB,eAAe,KAAG,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,SAenE,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,SAAS,CAAC,eAAe,GAAG,SAAS,CAAC,YAAY,CAAA;IAC1D,UAAU,EAAE,UAAU,CAAA;IACtB,OAAO,EAAE,gBAAgB,CAAA;CAC1B,CAAA"}