typia 3.6.10 → 3.7.0-dev.20230331

package/src/programmers/internal/check_array_length.ts

@@ -1,44 +1,44 @@
-import ts from "typescript";
-
-import { IdentifierFactory } from "../../factories/IdentifierFactory";
-
-import { IMetadataTag } from "../../metadata/IMetadataTag";
-
-/**
- * @internal
- */
-export function check_array_length(
-    input: ts.Expression,
-    tagList: IMetadataTag[],
-): ts.Expression | null {
-    const conditions: ts.Expression[] = [];
-
-    // CHECK TAGS
-    for (const tag of tagList)
-        if (tag.kind === "items")
-            conditions.push(
-                ts.factory.createStrictEquality(
-                    ts.factory.createNumericLiteral(tag.value),
-                    IdentifierFactory.join(input, "length"),
-                ),
-            );
-        else if (tag.kind === "minItems")
-            conditions.push(
-                ts.factory.createLessThanEquals(
-                    ts.factory.createNumericLiteral(tag.value),
-                    IdentifierFactory.join(input, "length"),
-                ),
-            );
-        else if (tag.kind === "maxItems")
-            conditions.push(
-                ts.factory.createGreaterThanEquals(
-                    ts.factory.createNumericLiteral(tag.value),
-                    IdentifierFactory.join(input, "length"),
-                ),
-            );
-
-    // COMBINATION
-    return conditions.length
-        ? conditions.reduce((x, y) => ts.factory.createLogicalAnd(x, y))
-        : null;
-}
+import ts from "typescript";
+
+import { IdentifierFactory } from "../../factories/IdentifierFactory";
+
+import { IMetadataTag } from "../../metadata/IMetadataTag";
+
+/**
+ * @internal
+ */
+export function check_array_length(
+    input: ts.Expression,
+    tagList: IMetadataTag[],
+): ts.Expression | null {
+    const conditions: ts.Expression[] = [];
+
+    // CHECK TAGS
+    for (const tag of tagList)
+        if (tag.kind === "items")
+            conditions.push(
+                ts.factory.createStrictEquality(
+                    ts.factory.createNumericLiteral(tag.value),
+                    IdentifierFactory.join(input, "length"),
+                ),
+            );
+        else if (tag.kind === "minItems")
+            conditions.push(
+                ts.factory.createLessThanEquals(
+                    ts.factory.createNumericLiteral(tag.value),
+                    IdentifierFactory.join(input, "length"),
+                ),
+            );
+        else if (tag.kind === "maxItems")
+            conditions.push(
+                ts.factory.createGreaterThanEquals(
+                    ts.factory.createNumericLiteral(tag.value),
+                    IdentifierFactory.join(input, "length"),
+                ),
+            );
+
+    // COMBINATION
+    return conditions.length
+        ? conditions.reduce((x, y) => ts.factory.createLogicalAnd(x, y))
+        : null;
+}

package/src/programmers/internal/check_bigint.ts

@@ -1,64 +1,84 @@
-import ts from "typescript";
-
-import { IMetadataTag } from "../../metadata/IMetadataTag";
-
-export function check_bigint(input: ts.Expression, tagList: IMetadataTag[]) {
-    const caster = (value: number) =>
-        ts.factory.createIdentifier(`${Math.floor(value)}n`);
-
-    // TYPEOF STATEMENT
-    const conditions: ts.Expression[] = [
-        ts.factory.createStrictEquality(
-            ts.factory.createStringLiteral("bigint"),
-            ts.factory.createTypeOfExpression(input),
-        ),
-    ];
-
-    // TAG (RANGE)
-    for (const tag of tagList)
-        if (tag.kind === "multipleOf")
-            conditions.push(
-                ts.factory.createStrictEquality(
-                    caster(0),
-                    ts.factory.createModulo(input, caster(tag.value)),
-                ),
-            );
-        else if (tag.kind === "step") {
-            const modulo = () =>
-                ts.factory.createModulo(input, caster(tag.value));
-            const minimum = (() => {
-                for (const tag of tagList)
-                    if (tag.kind === "minimum") return tag.value;
-                    else if (tag.kind === "exclusiveMinimum") return tag.value;
-                return undefined;
-            })();
-            conditions.push(
-                ts.factory.createStrictEquality(
-                    caster(0),
-                    minimum !== undefined
-                        ? ts.factory.createSubtract(modulo(), caster(minimum))
-                        : modulo(),
-                ),
-            );
-        } else if (tag.kind === "minimum")
-            conditions.push(
-                ts.factory.createLessThanEquals(caster(tag.value), input),
-            );
-        else if (tag.kind === "maximum")
-            conditions.push(
-                ts.factory.createGreaterThanEquals(caster(tag.value), input),
-            );
-        else if (tag.kind === "exclusiveMinimum")
-            conditions.push(
-                ts.factory.createLessThan(caster(tag.value), input),
-            );
-        else if (tag.kind === "exclusiveMaximum")
-            conditions.push(
-                ts.factory.createGreaterThan(caster(tag.value), input),
-            );
-
-    // COMBINATION
-    return conditions.length === 1
-        ? conditions[0]!
-        : conditions.reduce((x, y) => ts.factory.createLogicalAnd(x, y));
-}
+import ts from "typescript";
+
+import { IJsDocTagInfo } from "../../metadata/IJsDocTagInfo";
+import { IMetadataTag } from "../../metadata/IMetadataTag";
+
+import { FunctionImporter } from "../helpers/FunctionImporeter";
+import { check_custom } from "./check_custom";
+
+export const check_bigint =
+    (importer: FunctionImporter) =>
+    (
+        input: ts.Expression,
+        metaTags: IMetadataTag[],
+        jsDocTags: IJsDocTagInfo[],
+    ): ts.Expression => {
+        const caster = (value: number) =>
+            ts.factory.createIdentifier(`${Math.floor(value)}n`);
+
+        // TYPEOF STATEMENT
+        const conditions: ts.Expression[] = [
+            ts.factory.createStrictEquality(
+                ts.factory.createStringLiteral("bigint"),
+                ts.factory.createTypeOfExpression(input),
+            ),
+        ];
+
+        // TAG (RANGE)
+        for (const tag of metaTags)
+            if (tag.kind === "multipleOf")
+                conditions.push(
+                    ts.factory.createStrictEquality(
+                        caster(0),
+                        ts.factory.createModulo(input, caster(tag.value)),
+                    ),
+                );
+            else if (tag.kind === "step") {
+                const modulo = () =>
+                    ts.factory.createModulo(input, caster(tag.value));
+                const minimum = (() => {
+                    for (const tag of metaTags)
+                        if (tag.kind === "minimum") return tag.value;
+                        else if (tag.kind === "exclusiveMinimum")
+                            return tag.value;
+                    return undefined;
+                })();
+                conditions.push(
+                    ts.factory.createStrictEquality(
+                        caster(0),
+                        minimum !== undefined
+                            ? ts.factory.createSubtract(
+                                  modulo(),
+                                  caster(minimum),
+                              )
+                            : modulo(),
+                    ),
+                );
+            } else if (tag.kind === "minimum")
+                conditions.push(
+                    ts.factory.createLessThanEquals(caster(tag.value), input),
+                );
+            else if (tag.kind === "maximum")
+                conditions.push(
+                    ts.factory.createGreaterThanEquals(
+                        caster(tag.value),
+                        input,
+                    ),
+                );
+            else if (tag.kind === "exclusiveMinimum")
+                conditions.push(
+                    ts.factory.createLessThan(caster(tag.value), input),
+                );
+            else if (tag.kind === "exclusiveMaximum")
+                conditions.push(
+                    ts.factory.createGreaterThan(caster(tag.value), input),
+                );
+
+        // CUSTOM TAGS
+        conditions.push(...check_custom("bigint")(importer)(input, jsDocTags));
+
+        // COMBINATION
+        return conditions.length === 1
+            ? conditions[0]!
+            : conditions.reduce((x, y) => ts.factory.createLogicalAnd(x, y));
+    };

package/src/programmers/internal/check_custom.ts

@@ -0,0 +1,32 @@
+import ts from "typescript";
+
+import { MetadataTagFactory } from "../../factories/MetadataTagFactory";
+
+import { IJsDocTagInfo } from "../../metadata/IJsDocTagInfo";
+
+import { FunctionImporter } from "../helpers/FunctionImporeter";
+
+export const check_custom =
+    (type: string) =>
+    (importer: FunctionImporter) =>
+    (input: ts.Expression, jsDocTags: IJsDocTagInfo[]) =>
+        jsDocTags
+            .filter(
+                (tag) =>
+                    tag.name !== "random" &&
+                    MetadataTagFactory._PARSER[tag.name] === undefined,
+            )
+            .map((tag) =>
+                ts.factory.createCallExpression(
+                    importer.use("is_custom"),
+                    undefined,
+                    [
+                        ts.factory.createStringLiteral(tag.name),
+                        ts.factory.createStringLiteral(type),
+                        ts.factory.createStringLiteral(
+                            tag.text?.[0]?.text ?? "",
+                        ),
+                        input,
+                    ],
+                ),
+            );

package/src/programmers/internal/check_dynamic_properties.ts

@@ -1,197 +1,197 @@
-import ts from "typescript";
-
-import { IdentifierFactory } from "../../factories/IdentifierFactory";
-import { StatementFactory } from "../../factories/StatementFactory";
-
-import { FunctionImporter } from "../helpers/FunctionImporeter";
-import { IExpressionEntry } from "../helpers/IExpressionEntry";
-import { check_everything } from "./check_everything";
-import { check_object } from "./check_object";
-import { metadata_to_pattern } from "./metadata_to_pattern";
-
-/**
- * @internal
- */
-export const check_dynamic_properties =
-    (props: check_object.IProps) =>
-    (importer: FunctionImporter) =>
-    (
-        input: ts.Expression,
-        regular: IExpressionEntry<ts.Expression>[],
-        dynamic: IExpressionEntry<ts.Expression>[],
-    ): ts.Expression => {
-        const length = IdentifierFactory.join(
-            ts.factory.createCallExpression(
-                ts.factory.createIdentifier("Object.keys"),
-                undefined,
-                [input],
-            ),
-            "length",
-        );
-        const left: ts.Expression | null =
-            props.equals === true && dynamic.length === 0
-                ? props.undefined === true ||
-                  regular.every((r) => r.meta.required)
-                    ? ts.factory.createStrictEquality(
-                          ts.factory.createNumericLiteral(
-                              regular.filter((r) => r.meta.required).length,
-                          ),
-                          length,
-                      )
-                    : ts.factory.createCallExpression(
-                          importer.use("is_between"),
-                          [],
-                          [
-                              length,
-                              ts.factory.createNumericLiteral(
-                                  regular.filter((r) => r.meta.required).length,
-                              ),
-                              ts.factory.createNumericLiteral(regular.length),
-                          ],
-                      )
-                : null;
-        if (
-            props.undefined === false &&
-            left !== null &&
-            regular.every((r) => r.meta.required)
-        )
-            return left;
-
-        const criteria = props.entries
-            ? ts.factory.createCallExpression(props.entries, undefined, [
-                  ts.factory.createCallExpression(
-                      ts.factory.createIdentifier("Object.keys"),
-                      undefined,
-                      [input],
-                  ),
-                  check_dynamic_property(props)(input, regular, dynamic),
-              ])
-            : ts.factory.createCallExpression(
-                  IdentifierFactory.join(
-                      ts.factory.createCallExpression(
-                          ts.factory.createIdentifier("Object.keys"),
-                          undefined,
-                          [input],
-                      ),
-                      props.assert ? "every" : "map",
-                  ),
-                  undefined,
-                  [check_dynamic_property(props)(input, regular, dynamic)],
-              );
-        const right: ts.Expression = (props.halt || ((elem) => elem))(
-            props.assert ? criteria : check_everything(criteria),
-        );
-        return left
-            ? (props.undefined
-                  ? ts.factory.createLogicalOr
-                  : ts.factory.createLogicalAnd)(left, right)
-            : right;
-    };
-
-const check_dynamic_property =
-    (props: check_object.IProps) =>
-    (
-        input: ts.Expression,
-        regular: IExpressionEntry<ts.Expression>[],
-        dynamic: IExpressionEntry<ts.Expression>[],
-    ) => {
-        //----
-        // IF CONDITIONS
-        //----
-        // PREPARE ASSETS
-        const key = ts.factory.createIdentifier("key");
-        const value = ts.factory.createIdentifier("value");
-
-        const statements: ts.Statement[] = [];
-        const add = (exp: ts.Expression, output: ts.Expression) =>
-            statements.push(
-                ts.factory.createIfStatement(
-                    exp,
-                    ts.factory.createReturnStatement(output),
-                ),
-            );
-
-        // GATHER CONDITIONS
-        if (props.equals === true && regular.length)
-            add(is_regular_property(regular), props.positive);
-        statements.push(
-            StatementFactory.constant(
-                "value",
-                ts.factory.createElementAccessExpression(input, key),
-            ),
-        );
-        if (props.undefined === true)
-            add(
-                ts.factory.createStrictEquality(
-                    ts.factory.createIdentifier("undefined"),
-                    value,
-                ),
-                props.positive,
-            );
-
-        for (const entry of dynamic)
-            add(
-                ts.factory.createCallExpression(
-                    ts.factory.createIdentifier(
-                        `RegExp(/${metadata_to_pattern(true)(
-                            entry.key,
-                        )}/).test`,
-                    ),
-                    undefined,
-                    [key],
-                ),
-                entry.expression,
-            );
-
-        //----
-        // FUNCTION BODY
-        //----
-        // CLOSURE BLOCK
-        const block: ts.Block = ts.factory.createBlock(
-            [
-                ...statements,
-                ts.factory.createReturnStatement(
-                    props.equals === true
-                        ? props.superfluous(value)
-                        : props.positive,
-                ),
-            ],
-            true,
-        );
-
-        // RETURNS
-        return ts.factory.createArrowFunction(
-            undefined,
-            undefined,
-            [IdentifierFactory.parameter("key")],
-            undefined,
-            undefined,
-            block,
-        );
-    };
-
-const is_regular_property = (regular: IExpressionEntry[]) =>
-    ts.factory.createCallExpression(
-        IdentifierFactory.join(
-            ts.factory.createArrayLiteralExpression(
-                regular.map((entry) =>
-                    ts.factory.createStringLiteral(entry.key.getSoleLiteral()!),
-                ),
-            ),
-            "some",
-        ),
-        undefined,
-        [
-            ts.factory.createArrowFunction(
-                undefined,
-                undefined,
-                [IdentifierFactory.parameter("prop")],
-                undefined,
-                undefined,
-                ts.factory.createStrictEquality(
-                    ts.factory.createIdentifier("key"),
-                    ts.factory.createIdentifier("prop"),
-                ),
-            ),
-        ],
-    );
+import ts from "typescript";
+
+import { IdentifierFactory } from "../../factories/IdentifierFactory";
+import { StatementFactory } from "../../factories/StatementFactory";
+
+import { FunctionImporter } from "../helpers/FunctionImporeter";
+import { IExpressionEntry } from "../helpers/IExpressionEntry";
+import { check_everything } from "./check_everything";
+import { check_object } from "./check_object";
+import { metadata_to_pattern } from "./metadata_to_pattern";
+
+/**
+ * @internal
+ */
+export const check_dynamic_properties =
+    (props: check_object.IProps) =>
+    (importer: FunctionImporter) =>
+    (
+        input: ts.Expression,
+        regular: IExpressionEntry<ts.Expression>[],
+        dynamic: IExpressionEntry<ts.Expression>[],
+    ): ts.Expression => {
+        const length = IdentifierFactory.join(
+            ts.factory.createCallExpression(
+                ts.factory.createIdentifier("Object.keys"),
+                undefined,
+                [input],
+            ),
+            "length",
+        );
+        const left: ts.Expression | null =
+            props.equals === true && dynamic.length === 0
+                ? props.undefined === true ||
+                  regular.every((r) => r.meta.required)
+                    ? ts.factory.createStrictEquality(
+                          ts.factory.createNumericLiteral(
+                              regular.filter((r) => r.meta.required).length,
+                          ),
+                          length,
+                      )
+                    : ts.factory.createCallExpression(
+                          importer.use("is_between"),
+                          [],
+                          [
+                              length,
+                              ts.factory.createNumericLiteral(
+                                  regular.filter((r) => r.meta.required).length,
+                              ),
+                              ts.factory.createNumericLiteral(regular.length),
+                          ],
+                      )
+                : null;
+        if (
+            props.undefined === false &&
+            left !== null &&
+            regular.every((r) => r.meta.required)
+        )
+            return left;
+
+        const criteria = props.entries
+            ? ts.factory.createCallExpression(props.entries, undefined, [
+                  ts.factory.createCallExpression(
+                      ts.factory.createIdentifier("Object.keys"),
+                      undefined,
+                      [input],
+                  ),
+                  check_dynamic_property(props)(input, regular, dynamic),
+              ])
+            : ts.factory.createCallExpression(
+                  IdentifierFactory.join(
+                      ts.factory.createCallExpression(
+                          ts.factory.createIdentifier("Object.keys"),
+                          undefined,
+                          [input],
+                      ),
+                      props.assert ? "every" : "map",
+                  ),
+                  undefined,
+                  [check_dynamic_property(props)(input, regular, dynamic)],
+              );
+        const right: ts.Expression = (props.halt || ((elem) => elem))(
+            props.assert ? criteria : check_everything(criteria),
+        );
+        return left
+            ? (props.undefined
+                  ? ts.factory.createLogicalOr
+                  : ts.factory.createLogicalAnd)(left, right)
+            : right;
+    };
+
+const check_dynamic_property =
+    (props: check_object.IProps) =>
+    (
+        input: ts.Expression,
+        regular: IExpressionEntry<ts.Expression>[],
+        dynamic: IExpressionEntry<ts.Expression>[],
+    ) => {
+        //----
+        // IF CONDITIONS
+        //----
+        // PREPARE ASSETS
+        const key = ts.factory.createIdentifier("key");
+        const value = ts.factory.createIdentifier("value");
+
+        const statements: ts.Statement[] = [];
+        const add = (exp: ts.Expression, output: ts.Expression) =>
+            statements.push(
+                ts.factory.createIfStatement(
+                    exp,
+                    ts.factory.createReturnStatement(output),
+                ),
+            );
+
+        // GATHER CONDITIONS
+        if (props.equals === true && regular.length)
+            add(is_regular_property(regular), props.positive);
+        statements.push(
+            StatementFactory.constant(
+                "value",
+                ts.factory.createElementAccessExpression(input, key),
+            ),
+        );
+        if (props.undefined === true)
+            add(
+                ts.factory.createStrictEquality(
+                    ts.factory.createIdentifier("undefined"),
+                    value,
+                ),
+                props.positive,
+            );
+
+        for (const entry of dynamic)
+            add(
+                ts.factory.createCallExpression(
+                    ts.factory.createIdentifier(
+                        `RegExp(/${metadata_to_pattern(true)(
+                            entry.key,
+                        )}/).test`,
+                    ),
+                    undefined,
+                    [key],
+                ),
+                entry.expression,
+            );
+
+        //----
+        // FUNCTION BODY
+        //----
+        // CLOSURE BLOCK
+        const block: ts.Block = ts.factory.createBlock(
+            [
+                ...statements,
+                ts.factory.createReturnStatement(
+                    props.equals === true
+                        ? props.superfluous(value)
+                        : props.positive,
+                ),
+            ],
+            true,
+        );
+
+        // RETURNS
+        return ts.factory.createArrowFunction(
+            undefined,
+            undefined,
+            [IdentifierFactory.parameter("key")],
+            undefined,
+            undefined,
+            block,
+        );
+    };
+
+const is_regular_property = (regular: IExpressionEntry[]) =>
+    ts.factory.createCallExpression(
+        IdentifierFactory.join(
+            ts.factory.createArrayLiteralExpression(
+                regular.map((entry) =>
+                    ts.factory.createStringLiteral(entry.key.getSoleLiteral()!),
+                ),
+            ),
+            "some",
+        ),
+        undefined,
+        [
+            ts.factory.createArrowFunction(
+                undefined,
+                undefined,
+                [IdentifierFactory.parameter("prop")],
+                undefined,
+                undefined,
+                ts.factory.createStrictEquality(
+                    ts.factory.createIdentifier("key"),
+                    ts.factory.createIdentifier("prop"),
+                ),
+            ),
+        ],
+    );