typia 4.2.3-dev.20230814 → 4.3.0-dev.20230821

package/src/programmers/helpers/RandomRanger.ts

@@ -1,216 +1,208 @@
-import ts from "typescript";
-
-import { IMetadataTag } from "../../metadata/IMetadataTag";
-
-export namespace RandomRanger {
-    export interface IDefaults {
-        minimum: number;
-        maximum: number;
-        gap: number;
-    }
-
-    export const length =
-        (coalesce: (method: string) => ts.Expression) =>
-        (defs: IDefaults) =>
-        (acc: length.IAccessors) =>
-        (tags: IMetadataTag[]): ts.Expression | undefined => {
-            const props = {
-                fixed: getter(tags)(acc.fixed),
-                minimum: getter(tags)(acc.minimum),
-                maximum: getter(tags)(acc.maximum),
-            };
-            if (props.fixed !== undefined)
-                return ts.factory.createNumericLiteral(props.fixed);
-            else if (props.minimum === undefined && props.maximum === undefined)
-                return undefined;
-
-            props.minimum ??= defs.minimum;
-            props.maximum ??= defs.maximum;
-            if (props.maximum < props.minimum)
-                (props.maximum as number) += defs.gap;
-
-            return ts.factory.createCallExpression(
-                coalesce("integer"),
-                undefined,
-                [
-                    ts.factory.createNumericLiteral(props.minimum),
-                    ts.factory.createNumericLiteral(props.maximum),
-                ],
-            );
-        };
-    export namespace length {
-        export interface IAccessors {
-            minimum: IMetadataTag["kind"];
-            maximum: IMetadataTag["kind"];
-            fixed: IMetadataTag["kind"];
-        }
-    }
-
-    export const number =
-        (config: number.IConfig) =>
-        (defs: IDefaults) =>
-        (tags: IMetadataTag[]): ts.Expression => {
-            const range = {
-                minimum: {
-                    value:
-                        getter(tags)("minimum") ??
-                        getter(tags)("exclusiveMinimum"),
-                    exclusive: getter(tags)("exclusiveMinimum") !== undefined,
-                },
-                maximum: {
-                    value:
-                        getter(tags)("maximum") ??
-                        getter(tags)("exclusiveMaximum"),
-                    exclusive: getter(tags)("exclusiveMaximum") !== undefined,
-                },
-                step: getter(tags)("step"),
-                multiply: getter(tags)("multipleOf"),
-            };
-            if (Object.values(range).every((v) => v !== undefined))
-                return config.setter([]);
-
-            //----
-            // MULTIPLIERS
-            //----
-            // STEP
-            if (range.step !== undefined) {
-                const { intercept, minimum, maximum } = stepper(defs.gap)(
-                    range,
-                )(range.step);
-                return ts.factory.createAdd(
-                    config.transform(intercept),
-                    ts.factory.createMultiply(
-                        config.transform(range.step),
-                        config.setter([minimum, maximum]),
-                    ),
-                );
-            }
-            // MULTIPLE-OF
-            else if (range.multiply !== undefined) {
-                const { minimum, maximum } = multiplier(defs.gap)(range)(
-                    range.multiply,
-                );
-                return ts.factory.createMultiply(
-                    config.transform(range.multiply),
-                    config.setter([minimum, maximum]),
-                );
-            }
-
-            //----
-            // RANGE
-            //----
-            // INT
-            const integer = (value: number) => value === Math.floor(value);
-            if (
-                tags.find(
-                    (t) => t.kind === "type" && t.value.indexOf("int") !== -1,
-                ) !== undefined
-            ) {
-                if (range.minimum.value !== undefined) {
-                    if (range.minimum.exclusive) {
-                        range.minimum.exclusive = false;
-                        if (integer(range.minimum.value))
-                            range.minimum.value += 1;
-                    }
-                    range.minimum.value = Math.ceil(range.minimum.value);
-                }
-                if (range.maximum.value !== undefined) {
-                    if (range.maximum.exclusive) {
-                        range.maximum.exclusive = false;
-                        if (integer(range.maximum.value))
-                            range.maximum.value -= 1;
-                    }
-                    range.maximum.value = Math.floor(range.maximum.value);
-                }
-            }
-
-            // UNSIGNED INT
-            if (
-                tags.find(
-                    (t) => t.kind === "type" && t.value.indexOf("uint") === 0,
-                ) !== undefined
-            ) {
-                if (range.minimum.value === undefined) range.minimum.value = 0;
-                else if (range.minimum.value <= 0) {
-                    range.minimum.value = 0;
-                    range.minimum.exclusive = false;
-                }
-            }
-
-            const minimum =
-                range.minimum.value ??
-                (range.maximum.value !== undefined
-                    ? range.maximum.value - defs.gap
-                    : defs.minimum);
-            const maximum =
-                range.maximum.value ??
-                (range.minimum.value !== undefined
-                    ? range.minimum.value + defs.gap
-                    : defs.maximum);
-            return config.setter([minimum, maximum]);
-        };
-    export namespace number {
-        export interface IConfig {
-            setter: (args: number[]) => ts.Expression;
-            transform: (value: number) => ts.Expression;
-            type: "int" | "uint" | "double";
-        }
-    }
-}
-
-const getter =
-    (tags: IMetadataTag[]) =>
-    (kind: IMetadataTag["kind"]): number | undefined =>
-        tags.find((t) => t.kind === kind)?.value as number | undefined;
-
-const stepper = (gap: number) => (range: IRange) => (s: number) => {
-    const intercept: number = range.minimum.value!;
-    const minimum: number = range.minimum.exclusive ? 1 : 0;
-    if (range.maximum.value === undefined)
-        return {
-            intercept,
-            minimum,
-            maximum: gap,
-        };
-
-    const y: number = Math.floor(range.maximum.value - intercept) / s;
-    return {
-        intercept,
-        minimum,
-        maximum:
-            range.maximum.exclusive && intercept + y * s === range.maximum.value
-                ? y - 1
-                : y,
-    };
-};
-
-const multiplier = (gap: number) => (range: IRange) => (m: number) => {
-    const minimum: number =
-        range.minimum.value === undefined
-            ? 0
-            : (() => {
-                  const x: number = m * Math.ceil(range.minimum.value / m);
-                  return range.minimum.exclusive && x === range.minimum.value
-                      ? x + m
-                      : x;
-              })() / m;
-    const maximum: number =
-        range.maximum.value === undefined
-            ? gap
-            : (() => {
-                  const y: number = m * Math.floor(range.maximum.value / m);
-                  return range.maximum.exclusive && y === range.maximum.value
-                      ? y - m
-                      : y;
-              })() / m;
-    return { minimum, maximum };
-};
-
-interface IRange {
-    minimum: IScalar;
-    maximum: IScalar;
-}
-interface IScalar {
-    value?: number;
-    exclusive: boolean;
-}
+import ts from "typescript";
+
+import { IMetadataTag } from "../../metadata/IMetadataTag";
+
+export namespace RandomRanger {
+    export interface IDefaults {
+        minimum: number;
+        maximum: number;
+        gap: number;
+    }
+
+    export const length =
+        (coalesce: (method: string) => ts.Expression) =>
+        (defs: IDefaults) =>
+        (acc: length.IAccessors) =>
+        (tags: IMetadataTag[]): ts.Expression | undefined => {
+            const props = {
+                fixed: getter(tags)(acc.fixed),
+                minimum: getter(tags)(acc.minimum),
+                maximum: getter(tags)(acc.maximum),
+            };
+            if (props.fixed !== undefined)
+                return ts.factory.createNumericLiteral(props.fixed);
+            else if (props.minimum === undefined && props.maximum === undefined)
+                return undefined;
+
+            props.minimum ??= defs.minimum;
+            props.maximum ??= defs.maximum;
+            if (props.maximum < props.minimum)
+                (props.maximum as number) += defs.gap;
+
+            return ts.factory.createCallExpression(
+                coalesce("integer"),
+                undefined,
+                [
+                    ts.factory.createNumericLiteral(props.minimum),
+                    ts.factory.createNumericLiteral(props.maximum),
+                ],
+            );
+        };
+    export namespace length {
+        export interface IAccessors {
+            minimum: IMetadataTag["kind"];
+            maximum: IMetadataTag["kind"];
+            fixed: IMetadataTag["kind"];
+        }
+    }
+
+    export const number =
+        (config: number.IConfig) =>
+        (defs: IDefaults) =>
+        (tags: IMetadataTag[]): ts.Expression => {
+            const range = {
+                minimum: {
+                    value:
+                        getter(tags)("minimum") ??
+                        getter(tags)("exclusiveMinimum"),
+                    exclusive: getter(tags)("exclusiveMinimum") !== undefined,
+                },
+                maximum: {
+                    value:
+                        getter(tags)("maximum") ??
+                        getter(tags)("exclusiveMaximum"),
+                    exclusive: getter(tags)("exclusiveMaximum") !== undefined,
+                },
+                step: getter(tags)("step"),
+                multiply: getter(tags)("multipleOf"),
+            };
+            if (Object.values(range).every((v) => v !== undefined))
+                return config.setter([]);
+
+            //----
+            // MULTIPLIERS
+            //----
+            // STEP
+            if (range.step !== undefined) {
+                const { intercept, minimum, maximum } = stepper(defs.gap)(
+                    range,
+                )(range.step);
+                return ts.factory.createAdd(
+                    config.transform(intercept),
+                    ts.factory.createMultiply(
+                        config.transform(range.step),
+                        config.setter([minimum, maximum]),
+                    ),
+                );
+            }
+            // MULTIPLE-OF
+            else if (range.multiply !== undefined) {
+                const { minimum, maximum } = multiplier(defs.gap)(range)(
+                    range.multiply,
+                );
+                return ts.factory.createMultiply(
+                    config.transform(range.multiply),
+                    config.setter([minimum, maximum]),
+                );
+            }
+
+            //----
+            // RANGE
+            //----
+            // INT
+            const integer = (value: number) => value === Math.floor(value);
+            if (config.type === "int") {
+                if (range.minimum.value !== undefined) {
+                    if (range.minimum.exclusive) {
+                        range.minimum.exclusive = false;
+                        if (integer(range.minimum.value))
+                            range.minimum.value += 1;
+                    }
+                    range.minimum.value = Math.ceil(range.minimum.value);
+                }
+                if (range.maximum.value !== undefined) {
+                    if (range.maximum.exclusive) {
+                        range.maximum.exclusive = false;
+                        if (integer(range.maximum.value))
+                            range.maximum.value -= 1;
+                    }
+                    range.maximum.value = Math.floor(range.maximum.value);
+                }
+            }
+
+            // UNSIGNED INT
+            if (config.type === "uint") {
+                if (range.minimum.value === undefined) range.minimum.value = 0;
+                else if (range.minimum.value <= 0) {
+                    range.minimum.value = 0;
+                    range.minimum.exclusive = false;
+                }
+            }
+
+            const minimum =
+                range.minimum.value ??
+                (range.maximum.value !== undefined
+                    ? range.maximum.value - defs.gap
+                    : defs.minimum);
+            const maximum =
+                range.maximum.value ??
+                (range.minimum.value !== undefined
+                    ? range.minimum.value + defs.gap
+                    : defs.maximum);
+            return config.setter([minimum, maximum]);
+        };
+    export namespace number {
+        export interface IConfig {
+            setter: (args: number[]) => ts.Expression;
+            transform: (value: number) => ts.Expression;
+            type: "int" | "uint" | "double";
+        }
+    }
+}
+
+const getter =
+    (tags: IMetadataTag[]) =>
+    (kind: IMetadataTag["kind"]): number | undefined =>
+        tags.find((t) => t.kind === kind)?.value as number | undefined;
+
+const stepper = (gap: number) => (range: IRange) => (s: number) => {
+    const intercept: number = range.minimum.value!;
+    const minimum: number = range.minimum.exclusive ? 1 : 0;
+    if (range.maximum.value === undefined)
+        return {
+            intercept,
+            minimum,
+            maximum: gap,
+        };
+
+    const y: number = Math.floor(range.maximum.value - intercept) / s;
+    return {
+        intercept,
+        minimum,
+        maximum:
+            range.maximum.exclusive && intercept + y * s === range.maximum.value
+                ? y - 1
+                : y,
+    };
+};
+
+const multiplier = (gap: number) => (range: IRange) => (m: number) => {
+    const minimum: number =
+        range.minimum.value === undefined
+            ? 0
+            : (() => {
+                  const x: number = m * Math.ceil(range.minimum.value / m);
+                  return range.minimum.exclusive && x === range.minimum.value
+                      ? x + m
+                      : x;
+              })() / m;
+    const maximum: number =
+        range.maximum.value === undefined
+            ? gap
+            : (() => {
+                  const y: number = m * Math.floor(range.maximum.value / m);
+                  return range.maximum.exclusive && y === range.maximum.value
+                      ? y - m
+                      : y;
+              })() / m;
+    return { minimum, maximum };
+};
+
+interface IRange {
+    minimum: IScalar;
+    maximum: IScalar;
+}
+interface IScalar {
+    value?: number;
+    exclusive: boolean;
+}

package/src/programmers/helpers/StringifyJoinder.ts

@@ -1,113 +1,113 @@
-import ts from "typescript";
-
-import { IdentifierFactory } from "../../factories/IdentifierFactory";
-import { TemplateFactory } from "../../factories/TemplateFactory";
-
-import { stringify_dynamic_properties } from "../internal/stringify_dynamic_properties";
-import { stringify_regular_properties } from "../internal/stringify_regular_properties";
-import { FunctionImporter } from "./FunctionImporeter";
-import { IExpressionEntry } from "./IExpressionEntry";
-
-export namespace StringifyJoiner {
-    export const object =
-        (importer: FunctionImporter) =>
-        (
-            _input: ts.Expression,
-            entries: IExpressionEntry<ts.Expression>[],
-        ): ts.Expression => {
-            // CHECK AND SORT ENTRIES
-            if (entries.length === 0)
-                return ts.factory.createStringLiteral("{}");
-
-            // PROPERTIES
-            const regular: IExpressionEntry<ts.Expression>[] = entries.filter(
-                (entry) => entry.key.isSoleLiteral(),
-            );
-            const dynamic: IExpressionEntry<ts.Expression>[] = entries.filter(
-                (entry) => !entry.key.isSoleLiteral(),
-            );
-            const expressions: ts.Expression[] = [
-                ...stringify_regular_properties(regular, dynamic),
-                ...(dynamic.length
-                    ? [
-                          stringify_dynamic_properties(
-                              dynamic,
-                              regular.map((r) => r.key.getSoleLiteral()!),
-                          ),
-                      ]
-                    : []),
-            ];
-
-            // POP LAST COMMA, IF REQUIRED
-            const filtered: ts.Expression[] =
-                (regular.length &&
-                    regular[regular.length - 1]!.meta.isRequired() &&
-                    dynamic.length === 0) ||
-                (regular.length === 0 && dynamic.length)
-                    ? expressions
-                    : [
-                          ts.factory.createCallExpression(
-                              importer.use("tail"),
-                              undefined,
-                              [TemplateFactory.generate(expressions)],
-                          ),
-                      ];
-
-            // RETURNS WITH OBJECT BRACKET
-            return TemplateFactory.generate([
-                ts.factory.createStringLiteral(`{`),
-                ...filtered,
-                ts.factory.createStringLiteral(`}`),
-            ]);
-        };
-
-    export const array = (
-        input: ts.Expression,
-        arrow: ts.ArrowFunction,
-    ): ts.Expression =>
-        TemplateFactory.generate([
-            ts.factory.createStringLiteral(`[`),
-            ts.factory.createCallExpression(
-                ts.factory.createPropertyAccessExpression(
-                    ts.factory.createCallExpression(
-                        IdentifierFactory.access(input)("map"),
-                        undefined,
-                        [arrow],
-                    ),
-                    ts.factory.createIdentifier("join"),
-                ),
-                undefined,
-                [ts.factory.createStringLiteral(`,`)],
-            ),
-            ts.factory.createStringLiteral(`]`),
-        ]);
-
-    export const tuple = (
-        children: ts.Expression[],
-        rest: ts.Expression | null,
-    ): ts.Expression => {
-        if (children.length === 0) return ts.factory.createStringLiteral("[]");
-        if (
-            rest === null &&
-            children.every((child) => ts.isStringLiteral(child))
-        )
-            return ts.factory.createStringLiteral(
-                "[" +
-                    children
-                        .map((child) => (child as ts.StringLiteral).text)
-                        .join(",") +
-                    "]",
-            );
-
-        const elements: ts.Expression[] = [ts.factory.createStringLiteral(`[`)];
-        children.forEach((child, i) => {
-            elements.push(child);
-            if (i !== children.length - 1)
-                elements.push(ts.factory.createStringLiteral(`,`));
-        });
-        if (rest !== null) elements.push(rest);
-
-        elements.push(ts.factory.createStringLiteral(`]`));
-        return TemplateFactory.generate(elements);
-    };
-}
+import ts from "typescript";
+
+import { IdentifierFactory } from "../../factories/IdentifierFactory";
+import { TemplateFactory } from "../../factories/TemplateFactory";
+
+import { stringify_dynamic_properties } from "../internal/stringify_dynamic_properties";
+import { stringify_regular_properties } from "../internal/stringify_regular_properties";
+import { FunctionImporter } from "./FunctionImporeter";
+import { IExpressionEntry } from "./IExpressionEntry";
+
+export namespace StringifyJoiner {
+    export const object =
+        (importer: FunctionImporter) =>
+        (
+            _input: ts.Expression,
+            entries: IExpressionEntry<ts.Expression>[],
+        ): ts.Expression => {
+            // CHECK AND SORT ENTRIES
+            if (entries.length === 0)
+                return ts.factory.createStringLiteral("{}");
+
+            // PROPERTIES
+            const regular: IExpressionEntry<ts.Expression>[] = entries.filter(
+                (entry) => entry.key.isSoleLiteral(),
+            );
+            const dynamic: IExpressionEntry<ts.Expression>[] = entries.filter(
+                (entry) => !entry.key.isSoleLiteral(),
+            );
+            const expressions: ts.Expression[] = [
+                ...stringify_regular_properties(regular, dynamic),
+                ...(dynamic.length
+                    ? [
+                          stringify_dynamic_properties(
+                              dynamic,
+                              regular.map((r) => r.key.getSoleLiteral()!),
+                          ),
+                      ]
+                    : []),
+            ];
+
+            // POP LAST COMMA, IF REQUIRED
+            const filtered: ts.Expression[] =
+                (regular.length &&
+                    regular[regular.length - 1]!.meta.isRequired() &&
+                    dynamic.length === 0) ||
+                (regular.length === 0 && dynamic.length)
+                    ? expressions
+                    : [
+                          ts.factory.createCallExpression(
+                              importer.use("tail"),
+                              undefined,
+                              [TemplateFactory.generate(expressions)],
+                          ),
+                      ];
+
+            // RETURNS WITH OBJECT BRACKET
+            return TemplateFactory.generate([
+                ts.factory.createStringLiteral(`{`),
+                ...filtered,
+                ts.factory.createStringLiteral(`}`),
+            ]);
+        };
+
+    export const array = (
+        input: ts.Expression,
+        arrow: ts.ArrowFunction,
+    ): ts.Expression =>
+        TemplateFactory.generate([
+            ts.factory.createStringLiteral(`[`),
+            ts.factory.createCallExpression(
+                ts.factory.createPropertyAccessExpression(
+                    ts.factory.createCallExpression(
+                        IdentifierFactory.access(input)("map"),
+                        undefined,
+                        [arrow],
+                    ),
+                    ts.factory.createIdentifier("join"),
+                ),
+                undefined,
+                [ts.factory.createStringLiteral(`,`)],
+            ),
+            ts.factory.createStringLiteral(`]`),
+        ]);
+
+    export const tuple = (
+        children: ts.Expression[],
+        rest: ts.Expression | null,
+    ): ts.Expression => {
+        if (children.length === 0) return ts.factory.createStringLiteral("[]");
+        if (
+            rest === null &&
+            children.every((child) => ts.isStringLiteral(child))
+        )
+            return ts.factory.createStringLiteral(
+                "[" +
+                    children
+                        .map((child) => (child as ts.StringLiteral).text)
+                        .join(",") +
+                    "]",
+            );
+
+        const elements: ts.Expression[] = [ts.factory.createStringLiteral(`[`)];
+        children.forEach((child, i) => {
+            elements.push(child);
+            if (i !== children.length - 1)
+                elements.push(ts.factory.createStringLiteral(`,`));
+        });
+        if (rest !== null) elements.push(rest);
+
+        elements.push(ts.factory.createStringLiteral(`]`));
+        return TemplateFactory.generate(elements);
+    };
+}