@nestia/migrate 12.0.0-dev.20260601.1 → 12.0.0-dev.20260612.2

package/src/programmers/NestiaMigrateSchemaProgrammer.ts

@@ -1,477 +1,477 @@
-import { TypeScriptFactory } from "@nestia/factory";
-import { FormatCheatSheet, TypeFactory } from "@nestia/factory";
-import * as typiaUtils from "@typia/utils";
-import ts from "../internal/ts";
-import type { OpenApi } from "typia";
-
-import { FilePrinter } from "../utils/FilePrinter";
-import { StringUtil } from "../utils/StringUtil";
-import { NestiaMigrateImportProgrammer } from "./NestiaMigrateImportProgrammer";
-
-const { NamingConvention, OpenApiTypeChecker } =
-  (typiaUtils as { default?: typeof typiaUtils }).default ?? typiaUtils;
-
-export namespace NestiaMigrateSchemaProgrammer {
-  /* -----------------------------------------------------------
-    FACADE
-  ----------------------------------------------------------- */
-  export const write = (props: {
-    components: OpenApi.IComponents;
-    importer: NestiaMigrateImportProgrammer;
-    schema: OpenApi.IJsonSchema;
-  }): ts.TypeNode => {
-    // CONSIDER ANY TYPE CASE
-    const union: ts.TypeNode[] = [];
-    if (OpenApiTypeChecker.isUnknown(props.schema))
-      return TypeFactory.keyword("any");
-
-    // ITERATION
-    const type: ts.TypeNode = (() => {
-      // ATOMIC
-      if (OpenApiTypeChecker.isConstant(props.schema))
-        return writeConstant({
-          importer: props.importer,
-          schema: props.schema,
-        });
-      else if (OpenApiTypeChecker.isBoolean(props.schema))
-        return writeBoolean();
-      else if (OpenApiTypeChecker.isInteger(props.schema))
-        return writeInteger({
-          importer: props.importer,
-          schema: props.schema,
-        });
-      else if (OpenApiTypeChecker.isNumber(props.schema))
-        return writeNumber({
-          importer: props.importer,
-          schema: props.schema,
-        });
-      else if (OpenApiTypeChecker.isString(props.schema))
-        return writeString({
-          importer: props.importer,
-          schema: props.schema,
-        });
-      // INSTANCES
-      else if (OpenApiTypeChecker.isArray(props.schema))
-        return writeArray({
-          components: props.components,
-          importer: props.importer,
-          schema: props.schema,
-        });
-      else if (OpenApiTypeChecker.isTuple(props.schema))
-        return writeTuple({
-          components: props.components,
-          importer: props.importer,
-          schema: props.schema,
-        });
-      else if (OpenApiTypeChecker.isObject(props.schema))
-        return writeObject({
-          components: props.components,
-          importer: props.importer,
-          schema: props.schema,
-        });
-      else if (OpenApiTypeChecker.isReference(props.schema))
-        return writeReference({
-          importer: props.importer,
-          schema: props.schema,
-        });
-      // UNION
-      else if (OpenApiTypeChecker.isOneOf(props.schema))
-        return writeUnion({
-          components: props.components,
-          importer: props.importer,
-          elements: props.schema.oneOf,
-        });
-      else if (OpenApiTypeChecker.isNull(props.schema))
-        return createNode("null");
-      else return TypeFactory.keyword("any");
-    })();
-    union.push(type);
-
-    // DETERMINE
-    if (union.length === 0) return TypeFactory.keyword("any");
-    else if (union.length === 1) return union[0]!;
-    return TypeScriptFactory.createUnionTypeNode(union);
-  };
-
-  /* -----------------------------------------------------------
-    ATOMICS
-  ----------------------------------------------------------- */
-  const writeConstant = (props: {
-    importer: NestiaMigrateImportProgrammer;
-    schema: OpenApi.IJsonSchema.IConstant;
-  }): ts.TypeNode => {
-    return TypeScriptFactory.createLiteralTypeNode(
-      typeof props.schema.const === "boolean"
-        ? props.schema.const === true
-          ? TypeScriptFactory.createTrue()
-          : TypeScriptFactory.createFalse()
-        : typeof props.schema.const === "number"
-          ? props.schema.const < 0
-            ? TypeScriptFactory.createPrefixUnaryExpression(
-                ts.SyntaxKind.MinusToken,
-                TypeScriptFactory.createNumericLiteral(-props.schema.const),
-              )
-            : TypeScriptFactory.createNumericLiteral(props.schema.const)
-          : TypeScriptFactory.createStringLiteral(props.schema.const),
-    );
-  };
-
-  const writeBoolean = (): ts.TypeNode => TypeFactory.keyword("boolean");
-
-  const writeInteger = (props: {
-    importer: NestiaMigrateImportProgrammer;
-    schema: OpenApi.IJsonSchema.IInteger;
-  }): ts.TypeNode =>
-    writeNumeric({
-      factory: () => [
-        TypeFactory.keyword("number"),
-        props.importer.tag("Type", "int32"),
-      ],
-      importer: props.importer,
-      schema: props.schema,
-    });
-
-  const writeNumber = (props: {
-    importer: NestiaMigrateImportProgrammer;
-    schema: OpenApi.IJsonSchema.INumber;
-  }): ts.TypeNode =>
-    writeNumeric({
-      factory: () => [TypeFactory.keyword("number")],
-      importer: props.importer,
-      schema: props.schema,
-    });
-
-  const writeNumeric = (props: {
-    factory: () => ts.TypeNode[];
-    importer: NestiaMigrateImportProgrammer;
-    schema: OpenApi.IJsonSchema.IInteger | OpenApi.IJsonSchema.INumber;
-  }): ts.TypeNode => {
-    const intersection: ts.TypeNode[] = props.factory();
-    if (props.schema.default !== undefined)
-      intersection.push(props.importer.tag("Default", props.schema.default));
-    if (props.schema.minimum !== undefined)
-      intersection.push(
-        props.importer.tag(
-          props.schema.exclusiveMinimum ? "ExclusiveMinimum" : "Minimum",
-          props.schema.minimum,
-        ),
-      );
-    if (props.schema.maximum !== undefined)
-      intersection.push(
-        props.importer.tag(
-          props.schema.exclusiveMaximum ? "ExclusiveMaximum" : "Maximum",
-          props.schema.maximum,
-        ),
-      );
-    if (props.schema.multipleOf !== undefined)
-      intersection.push(
-        props.importer.tag("MultipleOf", props.schema.multipleOf),
-      );
-    return intersection.length === 1
-      ? intersection[0]!
-      : TypeScriptFactory.createIntersectionTypeNode(intersection);
-  };
-
-  const writeString = (props: {
-    importer: NestiaMigrateImportProgrammer;
-    schema: OpenApi.IJsonSchema.IString;
-  }): ts.TypeNode => {
-    if (props.schema.format === "binary")
-      return TypeScriptFactory.createTypeReferenceNode("File");
-
-    const intersection: ts.TypeNode[] = [TypeFactory.keyword("string")];
-    if (props.schema.default !== undefined)
-      intersection.push(props.importer.tag("Default", props.schema.default));
-    if (props.schema.minLength !== undefined)
-      intersection.push(
-        props.importer.tag("MinLength", props.schema.minLength),
-      );
-    if (props.schema.maxLength !== undefined)
-      intersection.push(
-        props.importer.tag("MaxLength", props.schema.maxLength),
-      );
-    if (props.schema.pattern !== undefined)
-      intersection.push(props.importer.tag("Pattern", props.schema.pattern));
-    if (
-      props.schema.format !== undefined &&
-      (FormatCheatSheet as Record<string, string>)[props.schema.format] !==
-        undefined
-    )
-      intersection.push(props.importer.tag("Format", props.schema.format));
-    if (props.schema.contentMediaType !== undefined)
-      intersection.push(
-        props.importer.tag("ContentMediaType", props.schema.contentMediaType),
-      );
-    return intersection.length === 1
-      ? intersection[0]!
-      : TypeScriptFactory.createIntersectionTypeNode(intersection);
-  };
-
-  /* -----------------------------------------------------------
-    INSTANCES
-  ----------------------------------------------------------- */
-  const writeArray = (props: {
-    components: OpenApi.IComponents;
-    importer: NestiaMigrateImportProgrammer;
-    schema: OpenApi.IJsonSchema.IArray;
-  }): ts.TypeNode => {
-    const intersection: ts.TypeNode[] = [
-      TypeScriptFactory.createArrayTypeNode(
-        write({
-          components: props.components,
-          importer: props.importer,
-          schema: props.schema.items,
-        }),
-      ),
-    ];
-    if (props.schema.minItems !== undefined)
-      intersection.push(props.importer.tag("MinItems", props.schema.minItems));
-    if (props.schema.maxItems !== undefined)
-      intersection.push(props.importer.tag("MaxItems", props.schema.maxItems));
-    if (props.schema.uniqueItems === true)
-      intersection.push(props.importer.tag("UniqueItems"));
-    return intersection.length === 1
-      ? intersection[0]!
-      : TypeScriptFactory.createIntersectionTypeNode(intersection);
-  };
-
-  const writeTuple = (props: {
-    components: OpenApi.IComponents;
-    importer: NestiaMigrateImportProgrammer;
-    schema: OpenApi.IJsonSchema.ITuple;
-  }): ts.TypeNode =>
-    TypeScriptFactory.createTupleTypeNode([
-      ...props.schema.prefixItems.map((item) =>
-        write({
-          components: props.components,
-          importer: props.importer,
-          schema: item,
-        }),
-      ),
-      ...(typeof props.schema.additionalItems === "object" &&
-      props.schema.additionalItems !== null
-        ? [
-            TypeScriptFactory.createRestTypeNode(
-              write({
-                components: props.components,
-                importer: props.importer,
-                schema: props.schema.additionalItems,
-              }),
-            ),
-          ]
-        : props.schema.additionalItems === true
-          ? [
-              TypeScriptFactory.createRestTypeNode(
-                TypeScriptFactory.createArrayTypeNode(
-                  TypeScriptFactory.createKeywordTypeNode(
-                    ts.SyntaxKind.AnyKeyword,
-                  ),
-                ),
-              ),
-            ]
-          : []),
-    ]);
-
-  const writeObject = (props: {
-    components: OpenApi.IComponents;
-    importer: NestiaMigrateImportProgrammer;
-    schema: OpenApi.IJsonSchema.IObject;
-  }): ts.TypeNode => {
-    const regular = () =>
-      TypeScriptFactory.createTypeLiteralNode(
-        Object.entries(props.schema.properties ?? [])
-          .map(([key, value], index) => [
-            ...(index !== 0 &&
-            (!!value.title?.length || !!value.description?.length)
-              ? [TypeScriptFactory.createIdentifier("\n") as any]
-              : []),
-            writeRegularProperty({
-              components: props.components,
-              importer: props.importer,
-              required: props.schema.required ?? [],
-              key,
-              value,
-            }),
-          ])
-          .flat(),
-      );
-    const dynamic = () =>
-      TypeScriptFactory.createTypeLiteralNode([
-        writeDynamicProperty({
-          components: props.components,
-          importer: props.importer,
-          schema: props.schema.additionalProperties as OpenApi.IJsonSchema,
-        }),
-      ]);
-    return !!props.schema.properties?.length &&
-      typeof props.schema.additionalProperties === "object"
-      ? TypeScriptFactory.createIntersectionTypeNode([regular(), dynamic()])
-      : typeof props.schema.additionalProperties === "object"
-        ? dynamic()
-        : regular();
-  };
-
-  const writeRegularProperty = (props: {
-    components: OpenApi.IComponents;
-    importer: NestiaMigrateImportProgrammer;
-    required: string[];
-    key: string;
-    value: OpenApi.IJsonSchema;
-  }) => {
-    const valueTypeNode: ts.TypeNode = write({
-      components: props.components,
-      importer: props.importer,
-      schema: props.value,
-    });
-    return FilePrinter.description(
-      TypeScriptFactory.createPropertySignature(
-        props.value.readOnly
-          ? [TypeScriptFactory.createToken(ts.SyntaxKind.ReadonlyKeyword)]
-          : undefined,
-        NamingConvention.variable(props.key)
-          ? TypeScriptFactory.createIdentifier(props.key)
-          : TypeScriptFactory.createStringLiteral(props.key),
-        props.required.includes(props.key)
-          ? undefined
-          : TypeScriptFactory.createToken(ts.SyntaxKind.QuestionToken),
-        props.required.includes(props.key)
-          ? valueTypeNode
-          : ts.isUnionTypeNode(valueTypeNode)
-            ? TypeScriptFactory.createUnionTypeNode([
-                ...(valueTypeNode.types ?? []),
-                TypeScriptFactory.createTypeReferenceNode("undefined"),
-              ])
-            : TypeScriptFactory.createUnionTypeNode([
-                valueTypeNode,
-                TypeScriptFactory.createTypeReferenceNode("undefined"),
-              ]),
-      ),
-      writeComment(props.value),
-    );
-  };
-
-  const writeDynamicProperty = (props: {
-    components: OpenApi.IComponents;
-    importer: NestiaMigrateImportProgrammer;
-    schema: OpenApi.IJsonSchema;
-  }) =>
-    FilePrinter.description(
-      TypeScriptFactory.createIndexSignature(
-        undefined,
-        [
-          TypeScriptFactory.createParameterDeclaration(
-            undefined,
-            undefined,
-            TypeScriptFactory.createIdentifier("key"),
-            undefined,
-            TypeFactory.keyword("string"),
-          ),
-        ],
-        write(props),
-      ),
-      writeComment(props.schema),
-    );
-
-  const writeReference = (props: {
-    importer: NestiaMigrateImportProgrammer;
-    schema: OpenApi.IJsonSchema.IReference;
-  }): ts.TypeReferenceNode | ts.KeywordTypeNode => {
-    if (props.schema.$ref.startsWith("#/components/schemas") === false)
-      return TypeFactory.keyword("any");
-    const name: string = props.schema.$ref
-      .split("/")
-      .slice(3)
-      .filter((str) => str.length !== 0)
-      .map(StringUtil.escapeNonVariable)
-      .join("");
-    if (name === "") return TypeFactory.keyword("any");
-    return props.importer.dto(name);
-  };
-
-  /* -----------------------------------------------------------
-    UNIONS
-  ----------------------------------------------------------- */
-  const writeUnion = (props: {
-    components: OpenApi.IComponents;
-    importer: NestiaMigrateImportProgrammer;
-    elements: OpenApi.IJsonSchema[];
-  }): ts.UnionTypeNode =>
-    TypeScriptFactory.createUnionTypeNode(
-      props.elements.map((schema) =>
-        write({
-          components: props.components,
-          importer: props.importer,
-          schema,
-        }),
-      ),
-    );
-}
-const createNode = (text: string) =>
-  TypeScriptFactory.createTypeReferenceNode(text);
-
-const writeComment = (schema: OpenApi.IJsonSchema): string => {
-  interface IPlugin {
-    key: string;
-    value: undefined | string | number | boolean;
-  }
-  const plugins: IPlugin[] = [];
-  if (schema.title !== undefined)
-    plugins.push({
-      key: "title",
-      value: schema.title,
-    });
-  if (schema.deprecated === true)
-    plugins.push({
-      key: "deprecated",
-      value: undefined,
-    });
-  for (const [key, value] of Object.entries(schema))
-    if (key.startsWith("x-") && isExtensionValue(value))
-      plugins.push({
-        key,
-        value,
-      });
-  return [
-    ...(schema.description?.length
-      ? [eraseCommentTags(schema.description)]
-      : []),
-    ...(schema.description?.length && plugins.length !== 0 ? [""] : []),
-    ...plugins.map((p) =>
-      p.value === undefined ? `@${p.key}` : `@${p.key} ${String(p.value)}`,
-    ),
-  ].join("\n");
-};
-
-const isExtensionValue = (value: unknown): value is boolean | number | string =>
-  typeof value === "boolean" ||
-  typeof value === "number" ||
-  typeof value === "string";
-
-const eraseCommentTags = (description: string): string => {
-  const lines: string[] = description.split("\n");
-  return lines
-    .filter((s) => COMMENT_TAGS.every((tag) => !s.includes(tag)))
-    .join("\n");
-};
-
-const COMMENT_TAGS = [
-  // string
-  "@format",
-  "@pattern",
-  "@length",
-  "@minLength",
-  "@maxLength",
-  "@contentMediaType",
-  // number
-  "@type",
-  "@minimum",
-  "@maximum",
-  "@exclusiveMinimum",
-  "@exclusiveMaximum",
-  "@multipleOf",
-  // array
-  "@items",
-  "@minItems",
-  "@maxItems",
-  "@uniqueItems",
-];
+import { TypeScriptFactory } from "@nestia/factory";
+import { FormatCheatSheet, TypeFactory } from "@nestia/factory";
+import * as typiaUtils from "@typia/utils";
+import ts from "../internal/ts";
+import type { OpenApi } from "typia";
+
+import { FilePrinter } from "../utils/FilePrinter";
+import { StringUtil } from "../utils/StringUtil";
+import { NestiaMigrateImportProgrammer } from "./NestiaMigrateImportProgrammer";
+
+const { NamingConvention, OpenApiTypeChecker } =
+  (typiaUtils as { default?: typeof typiaUtils }).default ?? typiaUtils;
+
+export namespace NestiaMigrateSchemaProgrammer {
+  /* -----------------------------------------------------------
+    FACADE
+  ----------------------------------------------------------- */
+  export const write = (props: {
+    components: OpenApi.IComponents;
+    importer: NestiaMigrateImportProgrammer;
+    schema: OpenApi.IJsonSchema;
+  }): ts.TypeNode => {
+    // CONSIDER ANY TYPE CASE
+    const union: ts.TypeNode[] = [];
+    if (OpenApiTypeChecker.isUnknown(props.schema))
+      return TypeFactory.keyword("any");
+
+    // ITERATION
+    const type: ts.TypeNode = (() => {
+      // ATOMIC
+      if (OpenApiTypeChecker.isConstant(props.schema))
+        return writeConstant({
+          importer: props.importer,
+          schema: props.schema,
+        });
+      else if (OpenApiTypeChecker.isBoolean(props.schema))
+        return writeBoolean();
+      else if (OpenApiTypeChecker.isInteger(props.schema))
+        return writeInteger({
+          importer: props.importer,
+          schema: props.schema,
+        });
+      else if (OpenApiTypeChecker.isNumber(props.schema))
+        return writeNumber({
+          importer: props.importer,
+          schema: props.schema,
+        });
+      else if (OpenApiTypeChecker.isString(props.schema))
+        return writeString({
+          importer: props.importer,
+          schema: props.schema,
+        });
+      // INSTANCES
+      else if (OpenApiTypeChecker.isArray(props.schema))
+        return writeArray({
+          components: props.components,
+          importer: props.importer,
+          schema: props.schema,
+        });
+      else if (OpenApiTypeChecker.isTuple(props.schema))
+        return writeTuple({
+          components: props.components,
+          importer: props.importer,
+          schema: props.schema,
+        });
+      else if (OpenApiTypeChecker.isObject(props.schema))
+        return writeObject({
+          components: props.components,
+          importer: props.importer,
+          schema: props.schema,
+        });
+      else if (OpenApiTypeChecker.isReference(props.schema))
+        return writeReference({
+          importer: props.importer,
+          schema: props.schema,
+        });
+      // UNION
+      else if (OpenApiTypeChecker.isOneOf(props.schema))
+        return writeUnion({
+          components: props.components,
+          importer: props.importer,
+          elements: props.schema.oneOf,
+        });
+      else if (OpenApiTypeChecker.isNull(props.schema))
+        return createNode("null");
+      else return TypeFactory.keyword("any");
+    })();
+    union.push(type);
+
+    // DETERMINE
+    if (union.length === 0) return TypeFactory.keyword("any");
+    else if (union.length === 1) return union[0]!;
+    return TypeScriptFactory.createUnionTypeNode(union);
+  };
+
+  /* -----------------------------------------------------------
+    ATOMICS
+  ----------------------------------------------------------- */
+  const writeConstant = (props: {
+    importer: NestiaMigrateImportProgrammer;
+    schema: OpenApi.IJsonSchema.IConstant;
+  }): ts.TypeNode => {
+    return TypeScriptFactory.createLiteralTypeNode(
+      typeof props.schema.const === "boolean"
+        ? props.schema.const === true
+          ? TypeScriptFactory.createTrue()
+          : TypeScriptFactory.createFalse()
+        : typeof props.schema.const === "number"
+          ? props.schema.const < 0
+            ? TypeScriptFactory.createPrefixUnaryExpression(
+                ts.SyntaxKind.MinusToken,
+                TypeScriptFactory.createNumericLiteral(-props.schema.const),
+              )
+            : TypeScriptFactory.createNumericLiteral(props.schema.const)
+          : TypeScriptFactory.createStringLiteral(props.schema.const),
+    );
+  };
+
+  const writeBoolean = (): ts.TypeNode => TypeFactory.keyword("boolean");
+
+  const writeInteger = (props: {
+    importer: NestiaMigrateImportProgrammer;
+    schema: OpenApi.IJsonSchema.IInteger;
+  }): ts.TypeNode =>
+    writeNumeric({
+      factory: () => [
+        TypeFactory.keyword("number"),
+        props.importer.tag("Type", "int32"),
+      ],
+      importer: props.importer,
+      schema: props.schema,
+    });
+
+  const writeNumber = (props: {
+    importer: NestiaMigrateImportProgrammer;
+    schema: OpenApi.IJsonSchema.INumber;
+  }): ts.TypeNode =>
+    writeNumeric({
+      factory: () => [TypeFactory.keyword("number")],
+      importer: props.importer,
+      schema: props.schema,
+    });
+
+  const writeNumeric = (props: {
+    factory: () => ts.TypeNode[];
+    importer: NestiaMigrateImportProgrammer;
+    schema: OpenApi.IJsonSchema.IInteger | OpenApi.IJsonSchema.INumber;
+  }): ts.TypeNode => {
+    const intersection: ts.TypeNode[] = props.factory();
+    if (props.schema.default !== undefined)
+      intersection.push(props.importer.tag("Default", props.schema.default));
+    if (props.schema.minimum !== undefined)
+      intersection.push(
+        props.importer.tag(
+          props.schema.exclusiveMinimum ? "ExclusiveMinimum" : "Minimum",
+          props.schema.minimum,
+        ),
+      );
+    if (props.schema.maximum !== undefined)
+      intersection.push(
+        props.importer.tag(
+          props.schema.exclusiveMaximum ? "ExclusiveMaximum" : "Maximum",
+          props.schema.maximum,
+        ),
+      );
+    if (props.schema.multipleOf !== undefined)
+      intersection.push(
+        props.importer.tag("MultipleOf", props.schema.multipleOf),
+      );
+    return intersection.length === 1
+      ? intersection[0]!
+      : TypeScriptFactory.createIntersectionTypeNode(intersection);
+  };
+
+  const writeString = (props: {
+    importer: NestiaMigrateImportProgrammer;
+    schema: OpenApi.IJsonSchema.IString;
+  }): ts.TypeNode => {
+    if (props.schema.format === "binary")
+      return TypeScriptFactory.createTypeReferenceNode("File");
+
+    const intersection: ts.TypeNode[] = [TypeFactory.keyword("string")];
+    if (props.schema.default !== undefined)
+      intersection.push(props.importer.tag("Default", props.schema.default));
+    if (props.schema.minLength !== undefined)
+      intersection.push(
+        props.importer.tag("MinLength", props.schema.minLength),
+      );
+    if (props.schema.maxLength !== undefined)
+      intersection.push(
+        props.importer.tag("MaxLength", props.schema.maxLength),
+      );
+    if (props.schema.pattern !== undefined)
+      intersection.push(props.importer.tag("Pattern", props.schema.pattern));
+    if (
+      props.schema.format !== undefined &&
+      (FormatCheatSheet as Record<string, string>)[props.schema.format] !==
+        undefined
+    )
+      intersection.push(props.importer.tag("Format", props.schema.format));
+    if (props.schema.contentMediaType !== undefined)
+      intersection.push(
+        props.importer.tag("ContentMediaType", props.schema.contentMediaType),
+      );
+    return intersection.length === 1
+      ? intersection[0]!
+      : TypeScriptFactory.createIntersectionTypeNode(intersection);
+  };
+
+  /* -----------------------------------------------------------
+    INSTANCES
+  ----------------------------------------------------------- */
+  const writeArray = (props: {
+    components: OpenApi.IComponents;
+    importer: NestiaMigrateImportProgrammer;
+    schema: OpenApi.IJsonSchema.IArray;
+  }): ts.TypeNode => {
+    const intersection: ts.TypeNode[] = [
+      TypeScriptFactory.createArrayTypeNode(
+        write({
+          components: props.components,
+          importer: props.importer,
+          schema: props.schema.items,
+        }),
+      ),
+    ];
+    if (props.schema.minItems !== undefined)
+      intersection.push(props.importer.tag("MinItems", props.schema.minItems));
+    if (props.schema.maxItems !== undefined)
+      intersection.push(props.importer.tag("MaxItems", props.schema.maxItems));
+    if (props.schema.uniqueItems === true)
+      intersection.push(props.importer.tag("UniqueItems"));
+    return intersection.length === 1
+      ? intersection[0]!
+      : TypeScriptFactory.createIntersectionTypeNode(intersection);
+  };
+
+  const writeTuple = (props: {
+    components: OpenApi.IComponents;
+    importer: NestiaMigrateImportProgrammer;
+    schema: OpenApi.IJsonSchema.ITuple;
+  }): ts.TypeNode =>
+    TypeScriptFactory.createTupleTypeNode([
+      ...props.schema.prefixItems.map((item) =>
+        write({
+          components: props.components,
+          importer: props.importer,
+          schema: item,
+        }),
+      ),
+      ...(typeof props.schema.additionalItems === "object" &&
+      props.schema.additionalItems !== null
+        ? [
+            TypeScriptFactory.createRestTypeNode(
+              write({
+                components: props.components,
+                importer: props.importer,
+                schema: props.schema.additionalItems,
+              }),
+            ),
+          ]
+        : props.schema.additionalItems === true
+          ? [
+              TypeScriptFactory.createRestTypeNode(
+                TypeScriptFactory.createArrayTypeNode(
+                  TypeScriptFactory.createKeywordTypeNode(
+                    ts.SyntaxKind.AnyKeyword,
+                  ),
+                ),
+              ),
+            ]
+          : []),
+    ]);
+
+  const writeObject = (props: {
+    components: OpenApi.IComponents;
+    importer: NestiaMigrateImportProgrammer;
+    schema: OpenApi.IJsonSchema.IObject;
+  }): ts.TypeNode => {
+    const regular = () =>
+      TypeScriptFactory.createTypeLiteralNode(
+        Object.entries(props.schema.properties ?? [])
+          .map(([key, value], index) => [
+            ...(index !== 0 &&
+            (!!value.title?.length || !!value.description?.length)
+              ? [TypeScriptFactory.createIdentifier("\n") as any]
+              : []),
+            writeRegularProperty({
+              components: props.components,
+              importer: props.importer,
+              required: props.schema.required ?? [],
+              key,
+              value,
+            }),
+          ])
+          .flat(),
+      );
+    const dynamic = () =>
+      TypeScriptFactory.createTypeLiteralNode([
+        writeDynamicProperty({
+          components: props.components,
+          importer: props.importer,
+          schema: props.schema.additionalProperties as OpenApi.IJsonSchema,
+        }),
+      ]);
+    return !!props.schema.properties?.length &&
+      typeof props.schema.additionalProperties === "object"
+      ? TypeScriptFactory.createIntersectionTypeNode([regular(), dynamic()])
+      : typeof props.schema.additionalProperties === "object"
+        ? dynamic()
+        : regular();
+  };
+
+  const writeRegularProperty = (props: {
+    components: OpenApi.IComponents;
+    importer: NestiaMigrateImportProgrammer;
+    required: string[];
+    key: string;
+    value: OpenApi.IJsonSchema;
+  }) => {
+    const valueTypeNode: ts.TypeNode = write({
+      components: props.components,
+      importer: props.importer,
+      schema: props.value,
+    });
+    return FilePrinter.description(
+      TypeScriptFactory.createPropertySignature(
+        props.value.readOnly
+          ? [TypeScriptFactory.createToken(ts.SyntaxKind.ReadonlyKeyword)]
+          : undefined,
+        NamingConvention.variable(props.key)
+          ? TypeScriptFactory.createIdentifier(props.key)
+          : TypeScriptFactory.createStringLiteral(props.key),
+        props.required.includes(props.key)
+          ? undefined
+          : TypeScriptFactory.createToken(ts.SyntaxKind.QuestionToken),
+        props.required.includes(props.key)
+          ? valueTypeNode
+          : ts.isUnionTypeNode(valueTypeNode)
+            ? TypeScriptFactory.createUnionTypeNode([
+                ...(valueTypeNode.types ?? []),
+                TypeScriptFactory.createTypeReferenceNode("undefined"),
+              ])
+            : TypeScriptFactory.createUnionTypeNode([
+                valueTypeNode,
+                TypeScriptFactory.createTypeReferenceNode("undefined"),
+              ]),
+      ),
+      writeComment(props.value),
+    );
+  };
+
+  const writeDynamicProperty = (props: {
+    components: OpenApi.IComponents;
+    importer: NestiaMigrateImportProgrammer;
+    schema: OpenApi.IJsonSchema;
+  }) =>
+    FilePrinter.description(
+      TypeScriptFactory.createIndexSignature(
+        undefined,
+        [
+          TypeScriptFactory.createParameterDeclaration(
+            undefined,
+            undefined,
+            TypeScriptFactory.createIdentifier("key"),
+            undefined,
+            TypeFactory.keyword("string"),
+          ),
+        ],
+        write(props),
+      ),
+      writeComment(props.schema),
+    );
+
+  const writeReference = (props: {
+    importer: NestiaMigrateImportProgrammer;
+    schema: OpenApi.IJsonSchema.IReference;
+  }): ts.TypeReferenceNode | ts.KeywordTypeNode => {
+    if (props.schema.$ref.startsWith("#/components/schemas") === false)
+      return TypeFactory.keyword("any");
+    const name: string = props.schema.$ref
+      .split("/")
+      .slice(3)
+      .filter((str) => str.length !== 0)
+      .map(StringUtil.escapeNonVariable)
+      .join("");
+    if (name === "") return TypeFactory.keyword("any");
+    return props.importer.dto(name);
+  };
+
+  /* -----------------------------------------------------------
+    UNIONS
+  ----------------------------------------------------------- */
+  const writeUnion = (props: {
+    components: OpenApi.IComponents;
+    importer: NestiaMigrateImportProgrammer;
+    elements: OpenApi.IJsonSchema[];
+  }): ts.UnionTypeNode =>
+    TypeScriptFactory.createUnionTypeNode(
+      props.elements.map((schema) =>
+        write({
+          components: props.components,
+          importer: props.importer,
+          schema,
+        }),
+      ),
+    );
+}
+const createNode = (text: string) =>
+  TypeScriptFactory.createTypeReferenceNode(text);
+
+const writeComment = (schema: OpenApi.IJsonSchema): string => {
+  interface IPlugin {
+    key: string;
+    value: undefined | string | number | boolean;
+  }
+  const plugins: IPlugin[] = [];
+  if (schema.title !== undefined)
+    plugins.push({
+      key: "title",
+      value: schema.title,
+    });
+  if (schema.deprecated === true)
+    plugins.push({
+      key: "deprecated",
+      value: undefined,
+    });
+  for (const [key, value] of Object.entries(schema))
+    if (key.startsWith("x-") && isExtensionValue(value))
+      plugins.push({
+        key,
+        value,
+      });
+  return [
+    ...(schema.description?.length
+      ? [eraseCommentTags(schema.description)]
+      : []),
+    ...(schema.description?.length && plugins.length !== 0 ? [""] : []),
+    ...plugins.map((p) =>
+      p.value === undefined ? `@${p.key}` : `@${p.key} ${String(p.value)}`,
+    ),
+  ].join("\n");
+};
+
+const isExtensionValue = (value: unknown): value is boolean | number | string =>
+  typeof value === "boolean" ||
+  typeof value === "number" ||
+  typeof value === "string";
+
+const eraseCommentTags = (description: string): string => {
+  const lines: string[] = description.split("\n");
+  return lines
+    .filter((s) => COMMENT_TAGS.every((tag) => !s.includes(tag)))
+    .join("\n");
+};
+
+const COMMENT_TAGS = [
+  // string
+  "@format",
+  "@pattern",
+  "@length",
+  "@minLength",
+  "@maxLength",
+  "@contentMediaType",
+  // number
+  "@type",
+  "@minimum",
+  "@maximum",
+  "@exclusiveMinimum",
+  "@exclusiveMaximum",
+  "@multipleOf",
+  // array
+  "@items",
+  "@minItems",
+  "@maxItems",
+  "@uniqueItems",
+];