typia 7.0.0-dev.20241011 → 7.0.0-dev.20241012

package/src/programmers/helpers/UnionPredicator.ts

@@ -1,77 +1,79 @@
-import { Metadata } from "../../schemas/metadata/Metadata";
-import { MetadataObject } from "../../schemas/metadata/MetadataObject";
-import { MetadataProperty } from "../../schemas/metadata/MetadataProperty";
-
-import { ArrayUtil } from "../../utils/ArrayUtil";
-import { MapUtil } from "../../utils/MapUtil";
-
-export namespace UnionPredicator {
-  export interface ISpecialized {
-    index: number;
-    object: MetadataObject;
-    property: MetadataProperty;
-    neighbour: boolean;
-  }
-
-  export const object = (objects: MetadataObject[]): Array<ISpecialized> => {
-    // PROPERTY MATRIX
-    const matrix: Map<string, Array<MetadataProperty | null>> = new Map();
-    for (const obj of objects)
-      for (const prop of obj.properties) {
-        const key: string | null = prop.key.getSoleLiteral();
-        if (key !== null)
-          MapUtil.take(matrix, key, () =>
-            ArrayUtil.repeat(objects.length, () => null),
-          );
-      }
-    objects.forEach((obj, i) => {
-      for (const prop of obj.properties) {
-        const key: string | null = prop.key.getSoleLiteral();
-        if (key !== null) matrix.get(key)![i] = prop;
-      }
-    });
-
-    // EXPLORE SPECIALIZERS
-    const output: ISpecialized[] = [];
-    objects.forEach((obj, i) => {
-      const children: ISpecializedProperty[] = [];
-      obj.properties.forEach((prop) => {
-        // MUST BE REQUIRED
-        if (prop.value.isRequired() === false) return;
-        const key: string | null = prop.key.getSoleLiteral();
-        if (key === null) return;
-
-        // FIND NEIGHBORHOOD PROPERTIES
-        const neighbors: MetadataProperty[] = matrix
-          .get(key)!
-          .filter((oppo, k) => i !== k && oppo !== null) as MetadataProperty[];
-
-        // NO NEIGHBORHOOD
-        const unique: boolean =
-          neighbors.length === 0 ||
-          neighbors.every((n) => !Metadata.intersects(prop.value, n.value));
-        if (unique === true)
-          children.push({
-            property: prop,
-            neighbour: neighbors.length !== 0,
-          });
-      });
-      if (children.length === 0) return;
-
-      const top: ISpecializedProperty =
-        children.find((child) => child.property.value.isConstant()) ||
-        children[0]!;
-      output.push({
-        index: i,
-        object: obj,
-        ...top,
-      });
-    });
-    return output;
-  };
-}
-
-interface ISpecializedProperty {
-  property: MetadataProperty;
-  neighbour: boolean;
-}
+import { Metadata } from "../../schemas/metadata/Metadata";
+import { MetadataObjectType } from "../../schemas/metadata/MetadataObjectType";
+import { MetadataProperty } from "../../schemas/metadata/MetadataProperty";
+
+import { ArrayUtil } from "../../utils/ArrayUtil";
+import { MapUtil } from "../../utils/MapUtil";
+
+export namespace UnionPredicator {
+  export interface ISpecialized {
+    index: number;
+    object: MetadataObjectType;
+    property: MetadataProperty;
+    neighbour: boolean;
+  }
+
+  export const object = (
+    objects: MetadataObjectType[],
+  ): Array<ISpecialized> => {
+    // PROPERTY MATRIX
+    const matrix: Map<string, Array<MetadataProperty | null>> = new Map();
+    for (const obj of objects)
+      for (const prop of obj.properties) {
+        const key: string | null = prop.key.getSoleLiteral();
+        if (key !== null)
+          MapUtil.take(matrix, key, () =>
+            ArrayUtil.repeat(objects.length, () => null),
+          );
+      }
+    objects.forEach((obj, i) => {
+      for (const prop of obj.properties) {
+        const key: string | null = prop.key.getSoleLiteral();
+        if (key !== null) matrix.get(key)![i] = prop;
+      }
+    });
+
+    // EXPLORE SPECIALIZERS
+    const output: ISpecialized[] = [];
+    objects.forEach((obj, i) => {
+      const children: ISpecializedProperty[] = [];
+      obj.properties.forEach((prop) => {
+        // MUST BE REQUIRED
+        if (prop.value.isRequired() === false) return;
+        const key: string | null = prop.key.getSoleLiteral();
+        if (key === null) return;
+
+        // FIND NEIGHBORHOOD PROPERTIES
+        const neighbors: MetadataProperty[] = matrix
+          .get(key)!
+          .filter((oppo, k) => i !== k && oppo !== null) as MetadataProperty[];
+
+        // NO NEIGHBORHOOD
+        const unique: boolean =
+          neighbors.length === 0 ||
+          neighbors.every((n) => !Metadata.intersects(prop.value, n.value));
+        if (unique === true)
+          children.push({
+            property: prop,
+            neighbour: neighbors.length !== 0,
+          });
+      });
+      if (children.length === 0) return;
+
+      const top: ISpecializedProperty =
+        children.find((child) => child.property.value.isConstant()) ||
+        children[0]!;
+      output.push({
+        index: i,
+        object: obj,
+        ...top,
+      });
+    });
+    return output;
+  };
+}
+
+interface ISpecializedProperty {
+  property: MetadataProperty;
+  neighbour: boolean;
+}

package/src/programmers/http/HttpFormDataProgrammer.ts

@@ -8,7 +8,7 @@ import { TypeFactory } from "../../factories/TypeFactory";
 
 import { Metadata } from "../../schemas/metadata/Metadata";
 import { MetadataArrayType } from "../../schemas/metadata/MetadataArrayType";
-import { MetadataObject } from "../../schemas/metadata/MetadataObject";
+import { MetadataObjectType } from "../../schemas/metadata/MetadataObjectType";
 import { MetadataProperty } from "../../schemas/metadata/MetadataProperty";
 
 import { IProgrammerProps } from "../../transformers/IProgrammerProps";
@@ -52,7 +52,7 @@ export namespace HttpFormDataProgrammer {
       });
 
     // DO TRANSFORM
-    const object: MetadataObject = result.data.objects[0]!;
+    const object: MetadataObjectType = result.data.objects[0]!.type;
     const statements: ts.Statement[] = decode_object({
       context: props.context,
       object,
@@ -160,7 +160,7 @@ export namespace HttpFormDataProgrammer {
 
   const decode_object = (props: {
     context: ITypiaContext;
-    object: MetadataObject;
+    object: MetadataObjectType;
   }): ts.Statement[] => {
     // const input: ts.Identifier = ts.factory.createIdentifier("input");
     const output: ts.Identifier = ts.factory.createIdentifier("output");

package/src/programmers/http/HttpHeadersProgrammer.ts

@@ -9,7 +9,7 @@ import { TypeFactory } from "../../factories/TypeFactory";
 
 import { Metadata } from "../../schemas/metadata/Metadata";
 import { MetadataArrayType } from "../../schemas/metadata/MetadataArrayType";
-import { MetadataObject } from "../../schemas/metadata/MetadataObject";
+import { MetadataObjectType } from "../../schemas/metadata/MetadataObjectType";
 import { MetadataProperty } from "../../schemas/metadata/MetadataProperty";
 
 import { IProgrammerProps } from "../../transformers/IProgrammerProps";
@@ -56,7 +56,7 @@ export namespace HttpHeadersProgrammer {
       });
 
     // DO TRANSFORM
-    const object: MetadataObject = result.data.objects[0]!;
+    const object: MetadataObjectType = result.data.objects[0]!.type;
     const statements: ts.Statement[] = decode_object({
       context: props.context,
       object,
@@ -204,7 +204,7 @@ export namespace HttpHeadersProgrammer {
 
   const decode_object = (props: {
     context: ITypiaContext;
-    object: MetadataObject;
+    object: MetadataObjectType;
   }): ts.Statement[] => {
     const output: ts.Identifier = ts.factory.createIdentifier("output");
     const optionals: string[] = [];

package/src/programmers/http/HttpQueryProgrammer.ts

@@ -8,7 +8,7 @@ import { TypeFactory } from "../../factories/TypeFactory";
 
 import { Metadata } from "../../schemas/metadata/Metadata";
 import { MetadataArrayType } from "../../schemas/metadata/MetadataArrayType";
-import { MetadataObject } from "../../schemas/metadata/MetadataObject";
+import { MetadataObjectType } from "../../schemas/metadata/MetadataObjectType";
 import { MetadataProperty } from "../../schemas/metadata/MetadataProperty";
 
 import { IProgrammerProps } from "../../transformers/IProgrammerProps";
@@ -60,7 +60,7 @@ export namespace HttpQueryProgrammer {
       });
 
     // DO TRANSFORM
-    const object: MetadataObject = result.data.objects[0]!;
+    const object: MetadataObjectType = result.data.objects[0]!.type;
     const statements: ts.Statement[] = decode_object({
       context: props.context,
       object,
@@ -130,7 +130,7 @@ export namespace HttpQueryProgrammer {
           const everyPropertiesAreOptional: boolean =
             meta.size() === 1 &&
             meta.objects.length === 1 &&
-            meta.objects[0]!.properties.every(
+            meta.objects[0]!.type.properties.every(
               (p) => p.value.isRequired() === false,
             );
           if (everyPropertiesAreOptional === false)
@@ -179,7 +179,7 @@ export namespace HttpQueryProgrammer {
 
   const decode_object = (props: {
     context: ITypiaContext;
-    object: MetadataObject;
+    object: MetadataObjectType;
   }): ts.Statement[] => {
     const input: ts.Identifier = ts.factory.createIdentifier("input");
     const output: ts.Identifier = ts.factory.createIdentifier("output");

package/src/programmers/internal/application_array.ts

@@ -1,56 +1,56 @@
-import { OpenApi, OpenApiV3 } from "@samchon/openapi";
-
-import { Metadata } from "../../schemas/metadata/Metadata";
-import { MetadataArray } from "../../schemas/metadata/MetadataArray";
-
-import { application_plugin } from "./application_plugin";
-
-/**
- * @internal
- */
-export const application_array = <Version extends "3.0" | "3.1">(props: {
-  generator: (value: Metadata) => Schema<Version>;
-  components: Version extends "3.0"
-    ? OpenApiV3.IComponents
-    : OpenApi.IComponents;
-  array: MetadataArray;
-}): Array<ArraySchema<Version> | OpenApiV3.IJsonSchema.IReference> => {
-  const factory = (): ArraySchema<Version>[] =>
-    application_plugin<ArraySchema<Version>>({
-      schema: {
-        type: "array",
-        items: props.generator(props.array.type.value),
-      } as ArraySchema<Version>,
-      tags: props.array.tags,
-    });
-  if (props.array.type.recursive === true) {
-    const out = () => [{ $ref }];
-    const $ref: string = `#/components/schemas/${props.array.type.name}`;
-    if (props.components.schemas?.[$ref] !== undefined) return out();
-
-    props.components.schemas ??= {};
-    props.components.schemas[$ref] ??= {};
-
-    const oneOf: ArraySchema<Version>[] = factory();
-    Object.assign(
-      props.components.schemas[$ref]!,
-      oneOf.length === 1 ? oneOf[0] : { oneOf },
-    );
-    return out();
-  }
-  return factory();
-};
-
-/**
- * @internal
- */
-type ArraySchema<Version extends "3.0" | "3.1"> = Version extends "3.0"
-  ? OpenApiV3.IJsonSchema.IArray
-  : OpenApi.IJsonSchema.IArray;
-
-/**
- * @internal
- */
-type Schema<Version extends "3.0" | "3.1"> = Version extends "3.0"
-  ? OpenApiV3.IJsonSchema
-  : OpenApi.IJsonSchema;
+import { OpenApi, OpenApiV3 } from "@samchon/openapi";
+
+import { Metadata } from "../../schemas/metadata/Metadata";
+import { MetadataArray } from "../../schemas/metadata/MetadataArray";
+
+import { application_plugin } from "./application_plugin";
+
+/**
+ * @internal
+ */
+export const application_array = <Version extends "3.0" | "3.1">(props: {
+  generator: (value: Metadata) => Schema<Version>;
+  components: Version extends "3.0"
+    ? OpenApiV3.IComponents
+    : OpenApi.IComponents;
+  array: MetadataArray;
+}): Array<ArraySchema<Version> | OpenApiV3.IJsonSchema.IReference> => {
+  const factory = (): ArraySchema<Version>[] =>
+    application_plugin<ArraySchema<Version>>({
+      schema: {
+        type: "array",
+        items: props.generator(props.array.type.value),
+      } as ArraySchema<Version>,
+      tags: props.array.tags,
+    });
+  if (props.array.type.recursive === true) {
+    const out = () => [{ $ref }];
+    const $ref: string = `#/components/schemas/${props.array.type.name}`;
+    if (props.components.schemas?.[$ref] !== undefined) return out();
+
+    props.components.schemas ??= {};
+    props.components.schemas[$ref] ??= {};
+
+    const oneOf: ArraySchema<Version>[] = factory();
+    Object.assign(
+      props.components.schemas[$ref]!,
+      oneOf.length === 1 ? oneOf[0] : { oneOf },
+    );
+    return out();
+  }
+  return factory();
+};
+
+/**
+ * @internal
+ */
+type ArraySchema<Version extends "3.0" | "3.1"> = Version extends "3.0"
+  ? OpenApiV3.IJsonSchema.IArray
+  : OpenApi.IJsonSchema.IArray;
+
+/**
+ * @internal
+ */
+type Schema<Version extends "3.0" | "3.1"> = Version extends "3.0"
+  ? OpenApiV3.IJsonSchema
+  : OpenApi.IJsonSchema;

package/src/programmers/internal/application_bigint.ts

@@ -1,25 +1,25 @@
-import { OpenApi, OpenApiV3 } from "@samchon/openapi";
-
-import { MetadataAtomic } from "../../schemas/metadata/MetadataAtomic";
-
-import { application_plugin } from "./application_plugin";
-
-/**
- * @internal
- */
-export const application_bigint = <Version extends "3.0" | "3.1">(
-  atomic: MetadataAtomic,
-): Schema<Version>[] =>
-  application_plugin({
-    schema: {
-      type: "integer",
-    } satisfies Schema<Version>,
-    tags: atomic.tags,
-  });
-
-/**
- * @internal
- */
-type Schema<Version extends "3.0" | "3.1"> = Version extends "3.0"
-  ? OpenApiV3.IJsonSchema.IInteger
-  : OpenApi.IJsonSchema.IInteger;
+import { OpenApi, OpenApiV3 } from "@samchon/openapi";
+
+import { MetadataAtomic } from "../../schemas/metadata/MetadataAtomic";
+
+import { application_plugin } from "./application_plugin";
+
+/**
+ * @internal
+ */
+export const application_bigint = <Version extends "3.0" | "3.1">(
+  atomic: MetadataAtomic,
+): Schema<Version>[] =>
+  application_plugin({
+    schema: {
+      type: "integer",
+    } satisfies Schema<Version>,
+    tags: atomic.tags,
+  });
+
+/**
+ * @internal
+ */
+type Schema<Version extends "3.0" | "3.1"> = Version extends "3.0"
+  ? OpenApiV3.IJsonSchema.IInteger
+  : OpenApi.IJsonSchema.IInteger;

package/src/programmers/internal/application_boolean.ts

@@ -1,25 +1,25 @@
-import { OpenApi, OpenApiV3 } from "@samchon/openapi";
-
-import { MetadataAtomic } from "../../schemas/metadata/MetadataAtomic";
-
-import { application_plugin } from "./application_plugin";
-
-/**
- * @internal
- */
-export const application_boolean = <Version extends "3.0" | "3.1">(
-  atomic: MetadataAtomic,
-): Schema<Version>[] =>
-  application_plugin({
-    schema: {
-      type: "boolean",
-    } satisfies Schema<Version>,
-    tags: atomic.tags,
-  });
-
-/**
- * @internal
- */
-type Schema<Version extends "3.0" | "3.1"> = Version extends "3.0"
-  ? OpenApiV3.IJsonSchema.IBoolean
-  : OpenApi.IJsonSchema.IBoolean;
+import { OpenApi, OpenApiV3 } from "@samchon/openapi";
+
+import { MetadataAtomic } from "../../schemas/metadata/MetadataAtomic";
+
+import { application_plugin } from "./application_plugin";
+
+/**
+ * @internal
+ */
+export const application_boolean = <Version extends "3.0" | "3.1">(
+  atomic: MetadataAtomic,
+): Schema<Version>[] =>
+  application_plugin({
+    schema: {
+      type: "boolean",
+    } satisfies Schema<Version>,
+    tags: atomic.tags,
+  });
+
+/**
+ * @internal
+ */
+type Schema<Version extends "3.0" | "3.1"> = Version extends "3.0"
+  ? OpenApiV3.IJsonSchema.IBoolean
+  : OpenApi.IJsonSchema.IBoolean;

package/src/programmers/internal/application_escaped.ts

@@ -1,96 +1,96 @@
-import { OpenApi, OpenApiV3 } from "@samchon/openapi";
-
-import { Metadata } from "../../schemas/metadata/Metadata";
-import { MetadataEscaped } from "../../schemas/metadata/MetadataEscaped";
-
-/**
- * @internal
- */
-export const application_escaped = <Version extends "3.0" | "3.1">(props: {
-  generator: (meta: Metadata) => Schema<Version>;
-  escaped: MetadataEscaped;
-}): Schema<Version>[] => {
-  const output: Schema<Version> | null = props.generator(props.escaped.returns);
-  if (output === null) return [];
-
-  if (
-    is_date({
-      visited: new Set(),
-      metadata: props.escaped.original,
-    })
-  ) {
-    const string: StringSchema<Version> | undefined = is_string(output)
-      ? output
-      : is_one_of(output)
-        ? (output.oneOf.find(is_string) as StringSchema<Version>)
-        : undefined;
-    if (
-      string !== undefined &&
-      string.format !== "date" &&
-      string.format !== "date-time"
-    )
-      string.format = "date-time";
-  }
-  return is_one_of(output) ? (output.oneOf as Schema<Version>[]) : [output];
-};
-
-/**
- * @internal
- */
-const is_string = <Version extends "3.0" | "3.1">(
-  schema: Schema<Version>,
-): schema is StringSchema<Version> =>
-  (schema as StringSchema<Version>).type === "string";
-
-/**
- * @internal
- */
-const is_one_of = <Version extends "3.0" | "3.1">(
-  schema: Schema<Version>,
-): schema is OneOfSchema<Version> =>
-  Array.isArray((schema as OneOfSchema<Version>).oneOf);
-
-/**
- * @internal
- */
-const is_date = (props: {
-  visited: Set<Metadata>;
-  metadata: Metadata;
-}): boolean => {
-  if (props.visited.has(props.metadata)) return false;
-  props.visited.add(props.metadata);
-
-  return (
-    props.metadata.natives.some((name) => name === "Date") ||
-    props.metadata.arrays.some((array) =>
-      is_date({
-        visited: props.visited,
-        metadata: array.type.value,
-      }),
-    ) ||
-    props.metadata.tuples.some((tuple) =>
-      tuple.type.elements.some((e) =>
-        is_date({
-          visited: props.visited,
-          metadata: e,
-        }),
-      ),
-    ) ||
-    props.metadata.aliases.some((alias) =>
-      is_date({
-        visited: props.visited,
-        metadata: alias.value,
-      }),
-    )
-  );
-};
-
-type Schema<Version extends "3.0" | "3.1"> = Version extends "3.0"
-  ? OpenApiV3.IJsonSchema
-  : OpenApi.IJsonSchema;
-type StringSchema<Version extends "3.0" | "3.1"> = Version extends "3.0"
-  ? OpenApiV3.IJsonSchema.IString
-  : OpenApi.IJsonSchema.IString;
-type OneOfSchema<Version extends "3.0" | "3.1"> = Version extends "3.0"
-  ? OpenApiV3.IJsonSchema.IOneOf
-  : OpenApi.IJsonSchema.IOneOf;
+import { OpenApi, OpenApiV3 } from "@samchon/openapi";
+
+import { Metadata } from "../../schemas/metadata/Metadata";
+import { MetadataEscaped } from "../../schemas/metadata/MetadataEscaped";
+
+/**
+ * @internal
+ */
+export const application_escaped = <Version extends "3.0" | "3.1">(props: {
+  generator: (meta: Metadata) => Schema<Version>;
+  escaped: MetadataEscaped;
+}): Schema<Version>[] => {
+  const output: Schema<Version> | null = props.generator(props.escaped.returns);
+  if (output === null) return [];
+
+  if (
+    is_date({
+      visited: new Set(),
+      metadata: props.escaped.original,
+    })
+  ) {
+    const string: StringSchema<Version> | undefined = is_string(output)
+      ? output
+      : is_one_of(output)
+        ? (output.oneOf.find(is_string) as StringSchema<Version>)
+        : undefined;
+    if (
+      string !== undefined &&
+      string.format !== "date" &&
+      string.format !== "date-time"
+    )
+      string.format = "date-time";
+  }
+  return is_one_of(output) ? (output.oneOf as Schema<Version>[]) : [output];
+};
+
+/**
+ * @internal
+ */
+const is_string = <Version extends "3.0" | "3.1">(
+  schema: Schema<Version>,
+): schema is StringSchema<Version> =>
+  (schema as StringSchema<Version>).type === "string";
+
+/**
+ * @internal
+ */
+const is_one_of = <Version extends "3.0" | "3.1">(
+  schema: Schema<Version>,
+): schema is OneOfSchema<Version> =>
+  Array.isArray((schema as OneOfSchema<Version>).oneOf);
+
+/**
+ * @internal
+ */
+const is_date = (props: {
+  visited: Set<Metadata>;
+  metadata: Metadata;
+}): boolean => {
+  if (props.visited.has(props.metadata)) return false;
+  props.visited.add(props.metadata);
+
+  return (
+    props.metadata.natives.some((name) => name === "Date") ||
+    props.metadata.arrays.some((array) =>
+      is_date({
+        visited: props.visited,
+        metadata: array.type.value,
+      }),
+    ) ||
+    props.metadata.tuples.some((tuple) =>
+      tuple.type.elements.some((e) =>
+        is_date({
+          visited: props.visited,
+          metadata: e,
+        }),
+      ),
+    ) ||
+    props.metadata.aliases.some((alias) =>
+      is_date({
+        visited: props.visited,
+        metadata: alias.value,
+      }),
+    )
+  );
+};
+
+type Schema<Version extends "3.0" | "3.1"> = Version extends "3.0"
+  ? OpenApiV3.IJsonSchema
+  : OpenApi.IJsonSchema;
+type StringSchema<Version extends "3.0" | "3.1"> = Version extends "3.0"
+  ? OpenApiV3.IJsonSchema.IString
+  : OpenApi.IJsonSchema.IString;
+type OneOfSchema<Version extends "3.0" | "3.1"> = Version extends "3.0"
+  ? OpenApiV3.IJsonSchema.IOneOf
+  : OpenApi.IJsonSchema.IOneOf;