Optional
__typeType metadata for enhanced compile-time type safety.
This optional property preserves the original TypeScript type information for compile-time type checking and enhanced development experience. It enables type-safe operations and better IDE support without affecting the runtime JSON schema representation.
Enhanced type safety features:
The property remains optional and undefined to maintain clean JSON serialization while preserving valuable compile-time information.
Reusable schema components for OpenAPI v3.1.
Contains reusable schema definitions and components that leverage OpenAPI v3.1's enhanced capabilities. These components provide better type representation and more accurate schema definitions compared to v3.0.
Enhanced component features:
The components structure follows the emended OpenAPI v3.1 specification that simplifies certain patterns while maintaining full expressiveness.
The primary JSON schema definition with v3.1 enhancements.
Contains the main JSON schema that accurately represents the TypeScript type using OpenAPI v3.1's enhanced capabilities. This schema can express complex TypeScript constructs that were not possible or accurate in v3.0.
Enhanced schema features include:
The schema follows the emended OpenAPI v3.1 format used by typia, which removes ambiguous expressions while maintaining full compatibility.
OpenAPI specification version identifier.
Always set to "3.1" to indicate this schema unit uses OpenAPI v3.1 format with enhanced JSON Schema compatibility and modern features.
JSON Schema unit formatted for OpenAPI v3.1 specification.
This interface represents a single JSON schema unit that takes advantage of OpenAPI v3.1's enhanced capabilities and improved JSON Schema compatibility. It provides a more feature-rich and accurate representation of TypeScript types compared to the v3.0 format.
OpenAPI v3.1 advantages for this unit:
Use cases for v3.1: