typia 3.8.0-dev.20230415 → 3.8.0-dev.20230417

package/src/programmers/helpers/RandomRanger.ts

@@ -1,216 +1,216 @@
-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 (
+                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;
+}

package/src/programmers/internal/application_native.ts

@@ -1,32 +1,32 @@
-import { IJsonComponents } from "../../schemas/IJsonComponents";
-
-import { IJsonSchema } from "../../module";
-import { ApplicationProgrammer } from "../ApplicationProgrammer";
-
-/**
- * @internal
- */
-export const application_native =
-    (options: ApplicationProgrammer.IOptions) =>
-    (components: IJsonComponents) =>
-    (name: string) =>
-    (
-        nullable: boolean,
-        attribute: IJsonSchema.IAttribute,
-    ): IJsonSchema.IReference => {
-        const key: string = name + (nullable ? ".Nullable" : "");
-        if (components.schemas[key] === undefined)
-            components.schemas[key] = {
-                type: "object",
-                $id:
-                    options.purpose === "ajv"
-                        ? options.prefix + "/" + key
-                        : undefined,
-                properties: {},
-                nullable,
-            };
-        return {
-            $ref: `#/components/schemas/${name}`,
-            ...attribute,
-        };
-    };
+import { IJsonComponents } from "../../schemas/IJsonComponents";
+
+import { IJsonSchema } from "../../module";
+import { ApplicationProgrammer } from "../ApplicationProgrammer";
+
+/**
+ * @internal
+ */
+export const application_native =
+    (options: ApplicationProgrammer.IOptions) =>
+    (components: IJsonComponents) =>
+    (name: string) =>
+    (
+        nullable: boolean,
+        attribute: IJsonSchema.IAttribute,
+    ): IJsonSchema.IReference => {
+        const key: string = name + (nullable ? ".Nullable" : "");
+        if (components.schemas[key] === undefined)
+            components.schemas[key] = {
+                type: "object",
+                $id:
+                    options.purpose === "ajv"
+                        ? options.prefix + "/" + key
+                        : undefined,
+                properties: {},
+                nullable,
+            };
+        return {
+            $ref: `#/components/schemas/${name}`,
+            ...attribute,
+        };
+    };

package/src/programmers/internal/check_array.ts

@@ -1,30 +1,30 @@
-import ts from "typescript";
-
-import { ExpressionFactory } from "../../factories/ExpressionFactory";
-import { IdentifierFactory } from "../../factories/IdentifierFactory";
-
-import { IJsDocTagInfo } from "../../metadata/IJsDocTagInfo";
-import { IMetadataTag } from "../../metadata/IMetadataTag";
-
-import { FunctionImporter } from "../helpers/FunctionImporeter";
-import { ICheckEntry } from "../helpers/ICheckEntry";
-import { check_array_length } from "./check_array_length";
-import { check_custom } from "./check_custom";
-
-/**
- * @internal
- */
-export const check_array =
-    (importer: FunctionImporter) =>
-    (metaTags: IMetadataTag[]) =>
-    (jsDocTags: IJsDocTagInfo[]) =>
-    (input: ts.Expression): ICheckEntry => ({
-        expression: ExpressionFactory.isArray(input),
-        tags: [
-            ...check_array_length(metaTags)(
-                IdentifierFactory.join(input, "length"),
-            ),
-            ...check_custom("array", "Array")(importer)(jsDocTags)(input),
-            // check custom array for legacy (3.7.0)
-        ],
-    });
+import ts from "typescript";
+
+import { ExpressionFactory } from "../../factories/ExpressionFactory";
+import { IdentifierFactory } from "../../factories/IdentifierFactory";
+
+import { IJsDocTagInfo } from "../../metadata/IJsDocTagInfo";
+import { IMetadataTag } from "../../metadata/IMetadataTag";
+
+import { FunctionImporter } from "../helpers/FunctionImporeter";
+import { ICheckEntry } from "../helpers/ICheckEntry";
+import { check_array_length } from "./check_array_length";
+import { check_custom } from "./check_custom";
+
+/**
+ * @internal
+ */
+export const check_array =
+    (importer: FunctionImporter) =>
+    (metaTags: IMetadataTag[]) =>
+    (jsDocTags: IJsDocTagInfo[]) =>
+    (input: ts.Expression): ICheckEntry => ({
+        expression: ExpressionFactory.isArray(input),
+        tags: [
+            ...check_array_length(metaTags)(
+                IdentifierFactory.join(input, "length"),
+            ),
+            ...check_custom("array", "Array")(importer)(jsDocTags)(input),
+            // check custom array for legacy (3.7.0)
+        ],
+    });

package/src/programmers/internal/check_array_length.ts

@@ -1,35 +1,35 @@
-import ts from "typescript";
-
-import { IMetadataTag } from "../../metadata/IMetadataTag";
-
-/**
- * @internal
- */
-export const check_array_length =
-    (metaTags: IMetadataTag[]) => (input: ts.Expression) =>
-        metaTags
-            .map((tag) => ({
-                tag,
-                expression:
-                    tag.kind === "items"
-                        ? ts.factory.createStrictEquality(
-                              ts.factory.createNumericLiteral(tag.value),
-                              input,
-                          )
-                        : tag.kind === "minItems"
-                        ? ts.factory.createLessThanEquals(
-                              ts.factory.createNumericLiteral(tag.value),
-                              input,
-                          )
-                        : tag.kind === "maxItems"
-                        ? ts.factory.createGreaterThanEquals(
-                              ts.factory.createNumericLiteral(tag.value),
-                              input,
-                          )
-                        : null!,
-            }))
-            .filter((tuple) => tuple.expression !== null)
-            .map(({ tag, expression }) => ({
-                expected: `Array.length (@${tag.kind} ${tag.value})`,
-                expression,
-            }));
+import ts from "typescript";
+
+import { IMetadataTag } from "../../metadata/IMetadataTag";
+
+/**
+ * @internal
+ */
+export const check_array_length =
+    (metaTags: IMetadataTag[]) => (input: ts.Expression) =>
+        metaTags
+            .map((tag) => ({
+                tag,
+                expression:
+                    tag.kind === "items"
+                        ? ts.factory.createStrictEquality(
+                              ts.factory.createNumericLiteral(tag.value),
+                              input,
+                          )
+                        : tag.kind === "minItems"
+                        ? ts.factory.createLessThanEquals(
+                              ts.factory.createNumericLiteral(tag.value),
+                              input,
+                          )
+                        : tag.kind === "maxItems"
+                        ? ts.factory.createGreaterThanEquals(
+                              ts.factory.createNumericLiteral(tag.value),
+                              input,
+                          )
+                        : null!,
+            }))
+            .filter((tuple) => tuple.expression !== null)
+            .map(({ tag, expression }) => ({
+                expected: `Array.length (@${tag.kind} ${tag.value})`,
+                expression,
+            }));