typia 9.0.1 → 9.1.0-dev.20250408

package/src/reflect.ts

@@ -1,57 +1,50 @@
-import { IMetadataApplication } from "./schemas/metadata/IMetadataApplication";
-
-/**
- * > You must configure the generic argument `Types`.
- *
- * Metadata Application.
- *
- * Creates a Metadata application which contains the metadata and components.
- *
- * Note that, all of the collection types like Array, Tuple and Objects are
- * stored in the {@link IMetadataApplication.components} property. Also, alias
- * types are stored in the {@link IMetadataApplication.aliases} property, too.
- *
- * @template Types Tuple of target types
- * @returns Metadata application
- *
- * @author Jeongho Nam - https://github.com/samchon
- */
-export function metadata(): never;
-
-/**
- * Metadata Application.
- *
- * Creates a Metadata application which contains the metadata and components.
- *
- * Note that, all of the collection types like Array, Tuple and Objects are
- * stored in the {@link IMetadataApplication.components} property. Also, alias
- * types are stored in the {@link IMetadataApplication.aliases} property, too.
- *
- * @template Types Tuple of target types
- * @returns Metadata application
- *
- * @author Jeongho Nam - https://github.com/samchon
- */
-export function metadata<Types extends unknown[]>(): IMetadataApplication;
-
-/**
- * @internal
- */
-export function metadata(): never {
-  halt("metadata");
-}
-
-export function name<T, Regular extends boolean = false>(): string;
-export function name(): never;
-export function name(): never {
-  halt("name");
-}
-
-/**
- * @internal
- */
-function halt(name: string): never {
-  throw new Error(
-    `Error on typia.reflect.${name}(): no transform has been configured. Read and follow https://typia.io/docs/setup please.`,
-  );
-}
+import { IMetadataApplication } from "./schemas/metadata/IMetadataApplication";
+
+import { NoTransformConfigurationError } from "./transformers/NoTransformConfigurationError";
+
+/**
+ * > You must configure the generic argument `Types`.
+ *
+ * Metadata Application.
+ *
+ * Creates a Metadata application which contains the metadata and components.
+ *
+ * Note that, all of the collection types like Array, Tuple and Objects are
+ * stored in the {@link IMetadataApplication.components} property. Also, alias
+ * types are stored in the {@link IMetadataApplication.aliases} property, too.
+ *
+ * @template Types Tuple of target types
+ * @returns Metadata application
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export function metadata(): never;
+
+/**
+ * Metadata Application.
+ *
+ * Creates a Metadata application which contains the metadata and components.
+ *
+ * Note that, all of the collection types like Array, Tuple and Objects are
+ * stored in the {@link IMetadataApplication.components} property. Also, alias
+ * types are stored in the {@link IMetadataApplication.aliases} property, too.
+ *
+ * @template Types Tuple of target types
+ * @returns Metadata application
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export function metadata<Types extends unknown[]>(): IMetadataApplication;
+
+/**
+ * @internal
+ */
+export function metadata(): never {
+  NoTransformConfigurationError("reflect.metadata");
+}
+
+export function name<T, Regular extends boolean = false>(): string;
+export function name(): never;
+export function name(): never {
+  NoTransformConfigurationError("reflect.name");
+}

package/src/schemas/json/IJsonApplication.ts

@@ -1,73 +1,73 @@
-import { IJsonSchemaCollection } from "./IJsonSchemaCollection";
-
-/**
- * Collection of JSON schemas.
- *
- * @deprecated Use {@link IJsonSchemaCollection} instead please.
- *             This interface type would be changed to {@link ILlmApplication} like
- *             structure in the future version (maybe next v8 major update).
- * @template Version Version of the OpenAPI specification.
- * @template Types Original TypeScript types used in the JSON schemas.
- * @author Jeongho Nam - https://github.com/samchon
- */
-export import IJsonApplication = IJsonSchemaCollection;
-
-// export interface IJsonApplication<
-//   Version extends "3.0" | "3.1" = "3.1",
-//   App extends any = object,
-// > {
-//   version: Version;
-//   components: IJsonApplication.IComponents<IJsonApplication.Schema<Version>>;
-//   functions: IJsonApplication.IFunction<IJsonApplication.Schema<Version>>[];
-//   __application?: App | undefined;
-// }
-// export namespace IJsonApplication {
-//   export type Schema<Version extends "3.0" | "3.1"> = Version extends "3.1"
-//     ? OpenApi.IJsonSchema
-//     : OpenApiV3.IJsonSchema;
-
-//   export interface IComponents<
-//     Schema extends
-//       | OpenApi.IJsonSchema
-//       | OpenApiV3.IJsonSchema = OpenApi.IJsonSchema,
-//   > {
-//     schemas?: Record<string, Schema>;
-//   }
-
-//   export interface IFunction<
-//     Schema extends
-//       | OpenApi.IJsonSchema
-//       | OpenApiV3.IJsonSchema = OpenApi.IJsonSchema,
-//   > {
-//     async: boolean;
-//     name: string;
-//     parameters: IParameter<Schema>[];
-//     output: IOutput<Schema> | undefined;
-//     summary?: string | undefined;
-//     description?: string | undefined;
-//     deprecated?: boolean;
-//     tags?: string[];
-//   }
-
-//   export interface IParameter<
-//     Schema extends
-//       | OpenApi.IJsonSchema
-//       | OpenApiV3.IJsonSchema = OpenApi.IJsonSchema,
-//   > {
-//     name: string;
-//     required: boolean;
-//     schema: Schema;
-//     title?: string | undefined;
-//     description?: string | undefined;
-//   }
-
-//   export interface IOutput<
-//     Schema extends
-//       | OpenApi.IJsonSchema
-//       | OpenApiV3.IJsonSchema = OpenApi.IJsonSchema,
-//   > {
-//     schema: Schema;
-//     required: boolean;
-//     description?: string | undefined;
-//   }
-// }
+import { IJsonSchemaCollection } from "./IJsonSchemaCollection";
+
+/**
+ * Collection of JSON schemas.
+ *
+ * @deprecated Use {@link IJsonSchemaCollection} instead please.
+ *             This interface type would be changed to {@link ILlmApplication} like
+ *             structure in the future version (maybe next v8 major update).
+ * @template Version Version of the OpenAPI specification.
+ * @template Types Original TypeScript types used in the JSON schemas.
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export import IJsonApplication = IJsonSchemaCollection;
+
+// export interface IJsonApplication<
+//   Version extends "3.0" | "3.1" = "3.1",
+//   App extends any = object,
+// > {
+//   version: Version;
+//   components: IJsonApplication.IComponents<IJsonApplication.Schema<Version>>;
+//   functions: IJsonApplication.IFunction<IJsonApplication.Schema<Version>>[];
+//   __application?: App | undefined;
+// }
+// export namespace IJsonApplication {
+//   export type Schema<Version extends "3.0" | "3.1"> = Version extends "3.1"
+//     ? OpenApi.IJsonSchema
+//     : OpenApiV3.IJsonSchema;
+
+//   export interface IComponents<
+//     Schema extends
+//       | OpenApi.IJsonSchema
+//       | OpenApiV3.IJsonSchema = OpenApi.IJsonSchema,
+//   > {
+//     schemas?: Record<string, Schema>;
+//   }
+
+//   export interface IFunction<
+//     Schema extends
+//       | OpenApi.IJsonSchema
+//       | OpenApiV3.IJsonSchema = OpenApi.IJsonSchema,
+//   > {
+//     async: boolean;
+//     name: string;
+//     parameters: IParameter<Schema>[];
+//     output: IOutput<Schema> | undefined;
+//     summary?: string | undefined;
+//     description?: string | undefined;
+//     deprecated?: boolean;
+//     tags?: string[];
+//   }
+
+//   export interface IParameter<
+//     Schema extends
+//       | OpenApi.IJsonSchema
+//       | OpenApiV3.IJsonSchema = OpenApi.IJsonSchema,
+//   > {
+//     name: string;
+//     required: boolean;
+//     schema: Schema;
+//     title?: string | undefined;
+//     description?: string | undefined;
+//   }
+
+//   export interface IOutput<
+//     Schema extends
+//       | OpenApi.IJsonSchema
+//       | OpenApiV3.IJsonSchema = OpenApi.IJsonSchema,
+//   > {
+//     schema: Schema;
+//     required: boolean;
+//     description?: string | undefined;
+//   }
+// }

package/src/schemas/json/IJsonSchemaCollection.ts

@@ -1,29 +1,29 @@
-import type { OpenApi, OpenApiV3 } from "@samchon/openapi";
-
-/**
- * Collection of JSON schemas.
- *
- * @template Version Version of the OpenAPI specification.
- * @template Types Original TypeScript types used in the JSON schemas.
- * @author Jeongho Nam - https://github.com/samchon
- */
-export type IJsonSchemaCollection<
-  Version extends "3.0" | "3.1" = "3.1",
-  Types = unknown[],
-> = Version extends "3.0"
-  ? IJsonSchemaCollection.IV3_0<Types>
-  : IJsonSchemaCollection.IV3_1<Types>;
-export namespace IJsonSchemaCollection {
-  export interface IV3_0<Types = unknown[]> {
-    version: "3.0";
-    schemas: OpenApiV3.IJsonSchema[];
-    components: OpenApiV3.IComponents;
-    __types?: Types | undefined;
-  }
-  export interface IV3_1<Types = unknown[]> {
-    version: "3.1";
-    components: OpenApi.IComponents;
-    schemas: OpenApi.IJsonSchema[];
-    __types?: Types | undefined;
-  }
-}
+import type { OpenApi, OpenApiV3 } from "@samchon/openapi";
+
+/**
+ * Collection of JSON schemas.
+ *
+ * @template Version Version of the OpenAPI specification.
+ * @template Types Original TypeScript types used in the JSON schemas.
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export type IJsonSchemaCollection<
+  Version extends "3.0" | "3.1" = "3.1",
+  Types = unknown[],
+> = Version extends "3.0"
+  ? IJsonSchemaCollection.IV3_0<Types>
+  : IJsonSchemaCollection.IV3_1<Types>;
+export namespace IJsonSchemaCollection {
+  export interface IV3_0<Types = unknown[]> {
+    version: "3.0";
+    schemas: OpenApiV3.IJsonSchema[];
+    components: OpenApiV3.IComponents;
+    __types?: Types | undefined;
+  }
+  export interface IV3_1<Types = unknown[]> {
+    version: "3.1";
+    components: OpenApi.IComponents;
+    schemas: OpenApi.IJsonSchema[];
+    __types?: Types | undefined;
+  }
+}

package/src/schemas/json/IJsonSchemaUnit.ts

@@ -0,0 +1,32 @@
+import { OpenApi, OpenApiV3 } from "@samchon/openapi";
+
+/**
+ * Unit of JSON schema.
+ *
+ * `IJsonSchemaUnit` is a type that represents a single JSON schema unit
+ * containing the schema and components.
+ *
+ * @template Version Version of the OpenAPI specification
+ * @template Type Original TypeScript type used in the JSON schema
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export type IJsonSchemaUnit<
+  Version extends "3.0" | "3.1" = "3.1",
+  Type = unknown,
+> = Version extends "3.0"
+  ? IJsonSchemaUnit.IV3_0<Type>
+  : IJsonSchemaUnit.IV3_1<Type>;
+export namespace IJsonSchemaUnit {
+  export interface IV3_0<Type> {
+    version: "3.0";
+    schema: OpenApiV3.IJsonSchema;
+    components: OpenApiV3.IComponents;
+    __type?: Type | undefined;
+  }
+  export interface IV3_1<Type> {
+    version: "3.1";
+    schema: OpenApi.IJsonSchema;
+    components: OpenApi.IComponents;
+    __type?: Type | undefined;
+  }
+}

package/src/schemas/json/__IJsonApplication.ts

@@ -1,63 +1,63 @@
-import { OpenApi, OpenApiV3 } from "@samchon/openapi";
-
-export interface __IJsonApplication<
-  Version extends "3.0" | "3.1" = "3.1",
-  App extends any = object,
-> {
-  version: Version;
-  components: __IJsonApplication.IComponents<
-    __IJsonApplication.Schema<Version>
-  >;
-  functions: __IJsonApplication.IFunction<__IJsonApplication.Schema<Version>>[];
-  __application?: App | undefined;
-}
-export namespace __IJsonApplication {
-  export type Schema<Version extends "3.0" | "3.1"> = Version extends "3.1"
-    ? OpenApi.IJsonSchema
-    : OpenApiV3.IJsonSchema;
-
-  export interface IComponents<
-    Schema extends
-      | OpenApi.IJsonSchema
-      | OpenApiV3.IJsonSchema = OpenApi.IJsonSchema,
-  > {
-    schemas?: Record<string, Schema>;
-  }
-
-  export interface IFunction<
-    Schema extends
-      | OpenApi.IJsonSchema
-      | OpenApiV3.IJsonSchema = OpenApi.IJsonSchema,
-  > {
-    async: boolean;
-    name: string;
-    parameters: IParameter<Schema>[];
-    output: IOutput<Schema> | undefined;
-    summary?: string | undefined;
-    description?: string | undefined;
-    deprecated?: boolean;
-    tags?: string[];
-  }
-
-  export interface IParameter<
-    Schema extends
-      | OpenApi.IJsonSchema
-      | OpenApiV3.IJsonSchema = OpenApi.IJsonSchema,
-  > {
-    name: string;
-    required: boolean;
-    schema: Schema;
-    title?: string | undefined;
-    description?: string | undefined;
-  }
-
-  export interface IOutput<
-    Schema extends
-      | OpenApi.IJsonSchema
-      | OpenApiV3.IJsonSchema = OpenApi.IJsonSchema,
-  > {
-    schema: Schema;
-    required: boolean;
-    description?: string | undefined;
-  }
-}
+import { OpenApi, OpenApiV3 } from "@samchon/openapi";
+
+export interface __IJsonApplication<
+  Version extends "3.0" | "3.1" = "3.1",
+  App extends any = object,
+> {
+  version: Version;
+  components: __IJsonApplication.IComponents<
+    __IJsonApplication.Schema<Version>
+  >;
+  functions: __IJsonApplication.IFunction<__IJsonApplication.Schema<Version>>[];
+  __application?: App | undefined;
+}
+export namespace __IJsonApplication {
+  export type Schema<Version extends "3.0" | "3.1"> = Version extends "3.1"
+    ? OpenApi.IJsonSchema
+    : OpenApiV3.IJsonSchema;
+
+  export interface IComponents<
+    Schema extends
+      | OpenApi.IJsonSchema
+      | OpenApiV3.IJsonSchema = OpenApi.IJsonSchema,
+  > {
+    schemas?: Record<string, Schema>;
+  }
+
+  export interface IFunction<
+    Schema extends
+      | OpenApi.IJsonSchema
+      | OpenApiV3.IJsonSchema = OpenApi.IJsonSchema,
+  > {
+    async: boolean;
+    name: string;
+    parameters: IParameter<Schema>[];
+    output: IOutput<Schema> | undefined;
+    summary?: string | undefined;
+    description?: string | undefined;
+    deprecated?: boolean;
+    tags?: string[];
+  }
+
+  export interface IParameter<
+    Schema extends
+      | OpenApi.IJsonSchema
+      | OpenApiV3.IJsonSchema = OpenApi.IJsonSchema,
+  > {
+    name: string;
+    required: boolean;
+    schema: Schema;
+    title?: string | undefined;
+    description?: string | undefined;
+  }
+
+  export interface IOutput<
+    Schema extends
+      | OpenApi.IJsonSchema
+      | OpenApiV3.IJsonSchema = OpenApi.IJsonSchema,
+  > {
+    schema: Schema;
+    required: boolean;
+    description?: string | undefined;
+  }
+}

package/src/schemas/metadata/IJsDocTagInfo.ts

@@ -1,10 +1,10 @@
-export interface IJsDocTagInfo {
-  name: string;
-  text?: IJsDocTagInfo.IText[];
-}
-export namespace IJsDocTagInfo {
-  export interface IText {
-    text: string;
-    kind: string;
-  }
-}
+export interface IJsDocTagInfo {
+  name: string;
+  text?: IJsDocTagInfo.IText[];
+}
+export namespace IJsDocTagInfo {
+  export interface IText {
+    text: string;
+    kind: string;
+  }
+}

package/src/schemas/metadata/IMetadata.ts

@@ -1,35 +1,35 @@
-import { IMetadataAlias } from "./IMetadataAlias";
-import { IMetadataArray } from "./IMetadataArray";
-import { IMetadataAtomic } from "./IMetadataAtomic";
-import { IMetadataConstant } from "./IMetadataConstant";
-import { IMetadataEscaped } from "./IMetadataEscaped";
-import { IMetadataFunction } from "./IMetadataFunction";
-import { IMetadataMap } from "./IMetadataMap";
-import { IMetadataNative } from "./IMetadataNative";
-import { IMetadataObject } from "./IMetadataObject";
-import { IMetadataSet } from "./IMetadataSet";
-import { IMetadataTemplate } from "./IMetadataTemplate";
-import { IMetadataTuple } from "./IMetadataTuple";
-
-export interface IMetadata {
-  any: boolean;
-  required: boolean;
-  optional: boolean;
-  nullable: boolean;
-  functions: IMetadataFunction[];
-
-  atomics: IMetadataAtomic[];
-  constants: IMetadataConstant[];
-  templates: IMetadataTemplate[];
-  escaped: IMetadataEscaped | null;
-
-  rest: IMetadata | null;
-  arrays: IMetadataArray[];
-  tuples: IMetadataTuple[];
-  objects: IMetadataObject[];
-  aliases: IMetadataAlias[];
-
-  natives: IMetadataNative[];
-  sets: IMetadataSet[];
-  maps: IMetadataMap[];
-}
+import { IMetadataAlias } from "./IMetadataAlias";
+import { IMetadataArray } from "./IMetadataArray";
+import { IMetadataAtomic } from "./IMetadataAtomic";
+import { IMetadataConstant } from "./IMetadataConstant";
+import { IMetadataEscaped } from "./IMetadataEscaped";
+import { IMetadataFunction } from "./IMetadataFunction";
+import { IMetadataMap } from "./IMetadataMap";
+import { IMetadataNative } from "./IMetadataNative";
+import { IMetadataObject } from "./IMetadataObject";
+import { IMetadataSet } from "./IMetadataSet";
+import { IMetadataTemplate } from "./IMetadataTemplate";
+import { IMetadataTuple } from "./IMetadataTuple";
+
+export interface IMetadata {
+  any: boolean;
+  required: boolean;
+  optional: boolean;
+  nullable: boolean;
+  functions: IMetadataFunction[];
+
+  atomics: IMetadataAtomic[];
+  constants: IMetadataConstant[];
+  templates: IMetadataTemplate[];
+  escaped: IMetadataEscaped | null;
+
+  rest: IMetadata | null;
+  arrays: IMetadataArray[];
+  tuples: IMetadataTuple[];
+  objects: IMetadataObject[];
+  aliases: IMetadataAlias[];
+
+  natives: IMetadataNative[];
+  sets: IMetadataSet[];
+  maps: IMetadataMap[];
+}

package/src/schemas/metadata/IMetadataAlias.ts

@@ -1,6 +1,6 @@
-import { IMetadataTypeTag } from "./IMetadataTypeTag";
-
-export interface IMetadataAlias {
-  name: string;
-  tags: IMetadataTypeTag[][];
-}
+import { IMetadataTypeTag } from "./IMetadataTypeTag";
+
+export interface IMetadataAlias {
+  name: string;
+  tags: IMetadataTypeTag[][];
+}

package/src/schemas/metadata/IMetadataAliasType.ts

@@ -1,12 +1,12 @@
-import { IJsDocTagInfo } from "./IJsDocTagInfo";
-import { IMetadata } from "./IMetadata";
-
-export interface IMetadataAliasType {
-  name: string;
-  value: IMetadata;
-  nullables: boolean[];
-
-  description: string | null;
-  jsDocTags: IJsDocTagInfo[];
-  recursive: boolean;
-}
+import { IJsDocTagInfo } from "./IJsDocTagInfo";
+import { IMetadata } from "./IMetadata";
+
+export interface IMetadataAliasType {
+  name: string;
+  value: IMetadata;
+  nullables: boolean[];
+
+  description: string | null;
+  jsDocTags: IJsDocTagInfo[];
+  recursive: boolean;
+}

package/src/schemas/metadata/IMetadataApplication.ts

@@ -1,7 +1,7 @@
-import { IMetadata } from "./IMetadata";
-import { IMetadataComponents } from "./IMetadataComponents";
-
-export interface IMetadataApplication {
-  metadatas: IMetadata[];
-  components: IMetadataComponents;
-}
+import { IMetadata } from "./IMetadata";
+import { IMetadataComponents } from "./IMetadataComponents";
+
+export interface IMetadataApplication {
+  metadatas: IMetadata[];
+  components: IMetadataComponents;
+}

package/src/schemas/metadata/IMetadataArray.ts

@@ -1,6 +1,6 @@
-import { IMetadataTypeTag } from "./IMetadataTypeTag";
-
-export interface IMetadataArray {
-  name: string;
-  tags: IMetadataTypeTag[][];
-}
+import { IMetadataTypeTag } from "./IMetadataTypeTag";
+
+export interface IMetadataArray {
+  name: string;
+  tags: IMetadataTypeTag[][];
+}

package/src/schemas/metadata/IMetadataArrayType.ts

@@ -1,10 +1,10 @@
-import { IMetadata } from "./IMetadata";
-
-export interface IMetadataArrayType {
-  name: string;
-  value: IMetadata;
-
-  nullables: boolean[];
-  recursive: boolean;
-  index: number | null;
-}
+import { IMetadata } from "./IMetadata";
+
+export interface IMetadataArrayType {
+  name: string;
+  value: IMetadata;
+
+  nullables: boolean[];
+  recursive: boolean;
+  index: number | null;
+}