typia 7.0.0-dev.20241010 → 7.0.0-dev.20241011

package/src/factories/internal/metadata/IMetadataIteratorProps.ts

@@ -1,16 +1,16 @@
-import ts from "typescript";
-
-import { Metadata } from "../../../schemas/metadata/Metadata";
-
-import { MetadataCollection } from "../../MetadataCollection";
-import { MetadataFactory } from "../../MetadataFactory";
-
-export interface IMetadataIteratorProps<Type extends ts.Type = ts.Type> {
-  options: MetadataFactory.IOptions;
-  checker: ts.TypeChecker;
-  collection: MetadataCollection;
-  errors: MetadataFactory.IError[];
-  metadata: Metadata;
-  type: Type;
-  explore: MetadataFactory.IExplore;
-}
+import ts from "typescript";
+
+import { Metadata } from "../../../schemas/metadata/Metadata";
+
+import { MetadataCollection } from "../../MetadataCollection";
+import { MetadataFactory } from "../../MetadataFactory";
+
+export interface IMetadataIteratorProps<Type extends ts.Type = ts.Type> {
+  options: MetadataFactory.IOptions;
+  checker: ts.TypeChecker;
+  collection: MetadataCollection;
+  errors: MetadataFactory.IError[];
+  metadata: Metadata;
+  type: Type;
+  explore: MetadataFactory.IExplore;
+}

package/src/factories/internal/metadata/emplace_metadata_object.ts

@@ -1,206 +1,206 @@
-import ts from "typescript";
-
-import { Metadata } from "../../../schemas/metadata/Metadata";
-import { MetadataObject } from "../../../schemas/metadata/MetadataObject";
-import { MetadataProperty } from "../../../schemas/metadata/MetadataProperty";
-
-import { Writable } from "../../../typings/Writable";
-
-import { ArrayUtil } from "../../../utils/ArrayUtil";
-
-import { CommentFactory } from "../../CommentFactory";
-import { IMetadataIteratorProps } from "./IMetadataIteratorProps";
-import { MetadataHelper } from "./MetadataHelper";
-import { explore_metadata } from "./explore_metadata";
-import { iterate_metadata_coalesce } from "./iterate_metadata_coalesce";
-
-export const emplace_metadata_object = (
-  props: IMetadataIteratorProps,
-): MetadataObject => {
-  // EMPLACE OBJECT
-  const [obj, newbie] = props.collection.emplace(props.checker, props.type);
-  ArrayUtil.add(
-    obj.nullables,
-    props.metadata.nullable,
-    (elem) => elem === props.metadata.nullable,
-  );
-
-  if (newbie === false) return obj;
-
-  // PREPARE ASSETS
-  const isClass: boolean = props.type.isClass();
-  const isProperty = significant(!!props.options.functional);
-  const pred: (node: ts.Declaration) => boolean = isClass
-    ? (node) => {
-        const kind: ts.SyntaxKind | undefined = node
-          .getChildren()[0]
-          ?.getChildren()[0]?.kind;
-        return (
-          kind !== ts.SyntaxKind.PrivateKeyword &&
-          kind !== ts.SyntaxKind.ProtectedKeyword &&
-          isProperty(node)
-        );
-      }
-    : (node) => isProperty(node);
-
-  const insert = (props: {
-    key: Metadata;
-    value: Metadata;
-    symbol: ts.Symbol | undefined;
-    filter?: (doc: ts.JSDocTagInfo) => boolean;
-  }): MetadataProperty => {
-    // COMMENTS AND TAGS
-    const description: string | null = props.symbol
-      ? (CommentFactory.description(props.symbol) ?? null)
-      : null;
-    const jsDocTags: ts.JSDocTagInfo[] = (
-      props.symbol?.getJsDocTags() ?? []
-    ).filter(props.filter ?? (() => true));
-
-    // THE PROPERTY
-    const property: MetadataProperty = MetadataProperty.create({
-      key: props.key,
-      value: props.value,
-      description,
-      jsDocTags,
-    });
-    obj.properties.push(property);
-    return property;
-  };
-
-  //----
-  // REGULAR PROPERTIES
-  //----
-  for (const symbol of props.type.getApparentProperties()) {
-    // CHECK INTERNAL TAG
-    if (
-      (symbol.getJsDocTags(props.checker) ?? []).find(
-        (tag) => tag.name === "internal",
-      ) !== undefined
-    )
-      continue;
-
-    // CHECK NODE IS A FORMAL PROPERTY
-    const [node, type] = (() => {
-      const node = symbol.getDeclarations()?.[0] as
-        | ts.PropertyDeclaration
-        | undefined;
-      const type: ts.Type | undefined = node
-        ? props.checker.getTypeOfSymbolAtLocation(symbol, node)
-        : props.checker.getTypeOfPropertyOfType(props.type, symbol.name);
-      return [node, type];
-    })();
-    if ((node && pred(node) === false) || type === undefined) continue;
-
-    // GET EXACT TYPE
-    const key: Metadata = MetadataHelper.literal_to_metadata(symbol.name);
-    const value: Metadata = explore_metadata({
-      ...props,
-      type,
-      explore: {
-        top: false,
-        object: obj,
-        property: symbol.name,
-        parameter: null,
-        nested: null,
-        aliased: false,
-        escaped: false,
-        output: false,
-      },
-    });
-    Writable(value).optional = (symbol.flags & ts.SymbolFlags.Optional) !== 0;
-    insert({
-      key,
-      value,
-      symbol,
-    });
-  }
-
-  //----
-  // DYNAMIC PROPERTIES
-  //----
-  for (const index of props.checker.getIndexInfosOfType(props.type)) {
-    // GET EXACT TYPE
-    const analyzer = (type: ts.Type) => (property: {} | null) =>
-      explore_metadata({
-        ...props,
-        type,
-        explore: {
-          top: false,
-          object: obj,
-          property,
-          parameter: null,
-          nested: null,
-          aliased: false,
-          escaped: false,
-          output: false,
-        },
-      });
-    const key: Metadata = analyzer(index.keyType)(null);
-    const value: Metadata = analyzer(index.type)({});
-
-    if (
-      key.atomics.length +
-        key.constants.map((c) => c.values.length).reduce((a, b) => a + b, 0) +
-        key.templates.length +
-        key.natives.filter(
-          (type) =>
-            type === "Boolean" ||
-            type === "BigInt" ||
-            type === "Number" ||
-            type === "String",
-        ).length !==
-      key.size()
-    )
-      props.errors.push({
-        name: key.getName(),
-        explore: {
-          top: false,
-          object: obj,
-          property: "[key]",
-          parameter: null,
-          nested: null,
-          aliased: false,
-          escaped: false,
-          output: false,
-        },
-        messages: [],
-      });
-
-    // INSERT WITH REQUIRED CONFIGURATION
-    insert({
-      key,
-      value,
-      symbol: index.declaration?.parent
-        ? props.checker.getSymbolAtLocation(index.declaration.parent)
-        : undefined,
-      filter: (doc) => doc.name !== "default",
-    });
-  }
-  return obj;
-};
-
-const significant = (functional: boolean) =>
-  functional
-    ? (node: ts.Declaration) => !ts.isAccessor(node)
-    : (node: ts.Declaration) =>
-        ts.isParameter(node) ||
-        ts.isPropertyDeclaration(node) ||
-        ts.isPropertyAssignment(node) ||
-        ts.isPropertySignature(node) ||
-        ts.isTypeLiteralNode(node) ||
-        ts.isShorthandPropertyAssignment(node);
-
-const iterate_optional_coalesce = (props: {
-  metadata: Metadata;
-  type: ts.Type;
-}): void => {
-  if (props.type.isUnionOrIntersection())
-    props.type.types.forEach((child) =>
-      iterate_optional_coalesce({
-        metadata: props.metadata,
-        type: child,
-      }),
-    );
-  else iterate_metadata_coalesce(props);
-};
+import ts from "typescript";
+
+import { Metadata } from "../../../schemas/metadata/Metadata";
+import { MetadataObject } from "../../../schemas/metadata/MetadataObject";
+import { MetadataProperty } from "../../../schemas/metadata/MetadataProperty";
+
+import { Writable } from "../../../typings/Writable";
+
+import { ArrayUtil } from "../../../utils/ArrayUtil";
+
+import { CommentFactory } from "../../CommentFactory";
+import { IMetadataIteratorProps } from "./IMetadataIteratorProps";
+import { MetadataHelper } from "./MetadataHelper";
+import { explore_metadata } from "./explore_metadata";
+import { iterate_metadata_coalesce } from "./iterate_metadata_coalesce";
+
+export const emplace_metadata_object = (
+  props: IMetadataIteratorProps,
+): MetadataObject => {
+  // EMPLACE OBJECT
+  const [obj, newbie] = props.collection.emplace(props.checker, props.type);
+  ArrayUtil.add(
+    obj.nullables,
+    props.metadata.nullable,
+    (elem) => elem === props.metadata.nullable,
+  );
+
+  if (newbie === false) return obj;
+
+  // PREPARE ASSETS
+  const isClass: boolean = props.type.isClass();
+  const isProperty = significant(!!props.options.functional);
+  const pred: (node: ts.Declaration) => boolean = isClass
+    ? (node) => {
+        const kind: ts.SyntaxKind | undefined = node
+          .getChildren()[0]
+          ?.getChildren()[0]?.kind;
+        return (
+          kind !== ts.SyntaxKind.PrivateKeyword &&
+          kind !== ts.SyntaxKind.ProtectedKeyword &&
+          isProperty(node)
+        );
+      }
+    : (node) => isProperty(node);
+
+  const insert = (props: {
+    key: Metadata;
+    value: Metadata;
+    symbol: ts.Symbol | undefined;
+    filter?: (doc: ts.JSDocTagInfo) => boolean;
+  }): MetadataProperty => {
+    // COMMENTS AND TAGS
+    const description: string | null = props.symbol
+      ? (CommentFactory.description(props.symbol) ?? null)
+      : null;
+    const jsDocTags: ts.JSDocTagInfo[] = (
+      props.symbol?.getJsDocTags() ?? []
+    ).filter(props.filter ?? (() => true));
+
+    // THE PROPERTY
+    const property: MetadataProperty = MetadataProperty.create({
+      key: props.key,
+      value: props.value,
+      description,
+      jsDocTags,
+    });
+    obj.properties.push(property);
+    return property;
+  };
+
+  //----
+  // REGULAR PROPERTIES
+  //----
+  for (const symbol of props.type.getApparentProperties()) {
+    // CHECK INTERNAL TAG
+    if (
+      (symbol.getJsDocTags(props.checker) ?? []).find(
+        (tag) => tag.name === "internal",
+      ) !== undefined
+    )
+      continue;
+
+    // CHECK NODE IS A FORMAL PROPERTY
+    const [node, type] = (() => {
+      const node = symbol.getDeclarations()?.[0] as
+        | ts.PropertyDeclaration
+        | undefined;
+      const type: ts.Type | undefined = node
+        ? props.checker.getTypeOfSymbolAtLocation(symbol, node)
+        : props.checker.getTypeOfPropertyOfType(props.type, symbol.name);
+      return [node, type];
+    })();
+    if ((node && pred(node) === false) || type === undefined) continue;
+
+    // GET EXACT TYPE
+    const key: Metadata = MetadataHelper.literal_to_metadata(symbol.name);
+    const value: Metadata = explore_metadata({
+      ...props,
+      type,
+      explore: {
+        top: false,
+        object: obj,
+        property: symbol.name,
+        parameter: null,
+        nested: null,
+        aliased: false,
+        escaped: false,
+        output: false,
+      },
+    });
+    Writable(value).optional = (symbol.flags & ts.SymbolFlags.Optional) !== 0;
+    insert({
+      key,
+      value,
+      symbol,
+    });
+  }
+
+  //----
+  // DYNAMIC PROPERTIES
+  //----
+  for (const index of props.checker.getIndexInfosOfType(props.type)) {
+    // GET EXACT TYPE
+    const analyzer = (type: ts.Type) => (property: {} | null) =>
+      explore_metadata({
+        ...props,
+        type,
+        explore: {
+          top: false,
+          object: obj,
+          property,
+          parameter: null,
+          nested: null,
+          aliased: false,
+          escaped: false,
+          output: false,
+        },
+      });
+    const key: Metadata = analyzer(index.keyType)(null);
+    const value: Metadata = analyzer(index.type)({});
+
+    if (
+      key.atomics.length +
+        key.constants.map((c) => c.values.length).reduce((a, b) => a + b, 0) +
+        key.templates.length +
+        key.natives.filter(
+          (type) =>
+            type === "Boolean" ||
+            type === "BigInt" ||
+            type === "Number" ||
+            type === "String",
+        ).length !==
+      key.size()
+    )
+      props.errors.push({
+        name: key.getName(),
+        explore: {
+          top: false,
+          object: obj,
+          property: "[key]",
+          parameter: null,
+          nested: null,
+          aliased: false,
+          escaped: false,
+          output: false,
+        },
+        messages: [],
+      });
+
+    // INSERT WITH REQUIRED CONFIGURATION
+    insert({
+      key,
+      value,
+      symbol: index.declaration?.parent
+        ? props.checker.getSymbolAtLocation(index.declaration.parent)
+        : undefined,
+      filter: (doc) => doc.name !== "default",
+    });
+  }
+  return obj;
+};
+
+const significant = (functional: boolean) =>
+  functional
+    ? (node: ts.Declaration) => !ts.isAccessor(node)
+    : (node: ts.Declaration) =>
+        ts.isParameter(node) ||
+        ts.isPropertyDeclaration(node) ||
+        ts.isPropertyAssignment(node) ||
+        ts.isPropertySignature(node) ||
+        ts.isTypeLiteralNode(node) ||
+        ts.isShorthandPropertyAssignment(node);
+
+const iterate_optional_coalesce = (props: {
+  metadata: Metadata;
+  type: ts.Type;
+}): void => {
+  if (props.type.isUnionOrIntersection())
+    props.type.types.forEach((child) =>
+      iterate_optional_coalesce({
+        metadata: props.metadata,
+        type: child,
+      }),
+    );
+  else iterate_metadata_coalesce(props);
+};