typia 9.7.1 → 9.7.2

package/src/programmers/FeatureProgrammer.ts

@@ -25,26 +25,18 @@ export namespace FeatureProgrammer {
   export interface IConfig<Output extends ts.ConciseBody = ts.ConciseBody> {
     types: IConfig.ITypes;
 
-    /**
-     * Prefix name of internal functions for specific types.
-     */
+    /** Prefix name of internal functions for specific types. */
     prefix: string;
 
-    /**
-     * Whether to archive access path or not.
-     */
+    /** Whether to archive access path or not. */
     path: boolean;
 
-    /**
-     * Whether to trace exception or not.
-     */
+    /** Whether to trace exception or not. */
     trace: boolean;
 
     addition?: undefined | ((collection: MetadataCollection) => ts.Statement[]);
 
-    /**
-     * Initializer of metadata.
-     */
+    /** Initializer of metadata. */
     initializer: (props: {
       context: ITypiaContext;
       functor: FunctionProgrammer;
@@ -54,23 +46,17 @@ export namespace FeatureProgrammer {
       metadata: Metadata;
     };
 
-    /**
-     * Decoder, station of every types.
-     */
+    /** Decoder, station of every types. */
     decoder: (props: {
       metadata: Metadata;
       input: ts.Expression;
       explore: IExplore;
     }) => Output;
 
-    /**
-     * Object configurator.
-     */
+    /** Object configurator. */
     objector: IConfig.IObjector<Output>;
 
-    /**
-     * Generator of functions for object types.
-     */
+    /** Generator of functions for object types. */
     generator: IConfig.IGenerator;
   }
   export namespace IConfig {
@@ -80,27 +66,21 @@ export namespace FeatureProgrammer {
     }
 
     export interface IObjector<Output extends ts.ConciseBody = ts.ConciseBody> {
-      /**
-       * Type checker when union object type comes.
-       */
+      /** Type checker when union object type comes. */
       checker: (props: {
         metadata: Metadata;
         input: ts.Expression;
         explore: IExplore;
       }) => ts.Expression;
 
-      /**
-       * Decoder, function call expression generator of specific typed objects.
-       */
+      /** Decoder, function call expression generator of specific typed objects. */
       decoder: (props: {
         input: ts.Expression;
         object: MetadataObjectType;
         explore: IExplore;
       }) => ts.Expression;
 
-      /**
-       * Joiner of expressions from properties.
-       */
+      /** Joiner of expressions from properties. */
       joiner(props: {
         entries: IExpressionEntry<Output>[];
         input?: ts.Expression;
@@ -110,8 +90,8 @@ export namespace FeatureProgrammer {
       /**
        * Union type specificator.
        *
-       * Expression of an algorithm specifying object type and calling
-       * the `decoder` function of the specified object type.
+       * Expression of an algorithm specifying object type and calling the
+       * `decoder` function of the specified object type.
        */
       unionizer: (props: {
         objects: MetadataObjectType[];
@@ -135,14 +115,14 @@ export namespace FeatureProgrammer {
        * Transformer of type checking expression by discrimination.
        *
        * When an object type has been specified by a discrimination without full
-       * iteration, the `unionizer` will decode the object instance after
-       * the last type checking.
+       * iteration, the `unionizer` will decode the object instance after the
+       * last type checking.
        *
        * In such circumtance, you can transform the last type checking function.
        *
+       * @deprecated
        * @param exp Current expression about type checking
        * @returns Transformed expression
-       * @deprecated
        */
       is?: undefined | ((exp: ts.Expression) => ts.Expression);
 
@@ -150,16 +130,16 @@ export namespace FeatureProgrammer {
        * Transformer of non-undefined type checking by discrimination.
        *
        * When specifying an union type of objects, `typia` tries to find
-       * discrimination way just by checking only one property type.
-       * If succeeded to find the discrimination way, `typia` will check the target
+       * discrimination way just by checking only one property type. If
+       * succeeded to find the discrimination way, `typia` will check the target
        * property type and in the checking, non-undefined type checking would be
        * done.
        *
        * In such process, you can transform the non-undefined type checking.
        *
+       * @deprecated
        * @param exp
        * @returns Transformed expression
-       * @deprecated
        */
       required?: undefined | ((exp: ts.Expression) => ts.Expression);
 
@@ -182,9 +162,7 @@ export namespace FeatureProgrammer {
             explore: IExplore;
           }) => ts.Expression);
 
-      /**
-       * Return type.
-       */
+      /** Return type. */
       type?: undefined | ts.TypeNode;
     }
     export interface IGenerator {

package/src/programmers/ImportProgrammer.ts

@@ -52,9 +52,7 @@ export class ImportProgrammer {
     );
   }
 
-  /**
-   * @internal
-   */
+  /** @internal */
   public internal(name: string): ts.PropertyAccessExpression {
     if (name.startsWith("_") === false) name = `_${name}`;
     return ts.factory.createPropertyAccessExpression(
@@ -66,9 +64,7 @@ export class ImportProgrammer {
     );
   }
 
-  /**
-   * @internal
-   */
+  /** @internal */
   public getInternalText(name: string): string {
     if (name.startsWith("_") === false) name = `_${name}`;
     const asset: IAsset | undefined = this.take(
@@ -78,9 +74,7 @@ export class ImportProgrammer {
     return `${asset.namespace.name}.${name}`;
   }
 
-  /**
-   * @internal
-   */
+  /** @internal */
   private take(file: string): IAsset {
     return MapUtil.take(this.assets_, file, () => ({
       file,

package/src/programmers/RandomProgrammer.ts

@@ -532,7 +532,12 @@ export namespace RandomProgrammer {
               internal: "randomInteger",
               arguments: [LiteralFactory.write(schema)],
             };
-        }
+        } else if (props.atomic.type === "boolean")
+          return {
+            method: props.atomic.type,
+            internal: "randomBoolean",
+            arguments: [],
+          };
         return {
           method: props.atomic.type,
           internal: `random${StringUtil.capitalize(props.atomic.type)}`,

package/src/programmers/helpers/ProtobufWire.ts

@@ -1,23 +1,23 @@
 export const enum ProtobufWire {
   /**
-   * - integers
-   * - bool
-   * - enum
+   * - Integers
+   * - Bool
+   * - Enum
    */
   VARIANT = 0,
 
   /**
-   * - fixed64
-   * - sfixed64
-   * - double
+   * - Fixed64
+   * - Sfixed64
+   * - Double
    */
   I64 = 1,
 
   /**
-   * - string
-   * - bytes
-   * - mebedded messages
-   * - packed repeated fields
+   * - String
+   * - Bytes
+   * - Mebedded messages
+   * - Packed repeated fields
    */
   LEN = 2,
 
@@ -26,9 +26,9 @@ export const enum ProtobufWire {
   END_GROUP = 4,
 
   /**
-   * - fixed
-   * - sfixed32
-   * - float
+   * - Fixed
+   * - Sfixed32
+   * - Float
    */
   I32 = 5,
 }

package/src/programmers/internal/check_array_length.ts

@@ -8,9 +8,7 @@ import { ITypiaContext } from "../../transformers/ITypiaContext";
 
 import { ICheckEntry } from "../helpers/ICheckEntry";
 
-/**
- * @internal
- */
+/** @internal */
 export const check_array_length = (props: {
   context: ITypiaContext;
   array: MetadataArray;
@@ -24,9 +22,7 @@ export const check_array_length = (props: {
   };
 };
 
-/**
- * @internal
- */
+/** @internal */
 const check_array_type_tags = (props: {
   context: ITypiaContext;
   array: MetadataArray;

package/src/programmers/internal/check_bigint.ts

@@ -8,9 +8,7 @@ import { ITypiaContext } from "../../transformers/ITypiaContext";
 
 import { ICheckEntry } from "../helpers/ICheckEntry";
 
-/**
- * @internal
- */
+/** @internal */
 export const check_bigint = (props: {
   context: ITypiaContext;
   atomic: MetadataAtomic;
@@ -27,9 +25,7 @@ export const check_bigint = (props: {
   };
 };
 
-/**
- * @internal
- */
+/** @internal */
 const check_bigint_type_tags = (props: {
   context: ITypiaContext;
   atomic: MetadataAtomic;

package/src/programmers/internal/check_dynamic_key.ts

@@ -10,9 +10,7 @@ import { check_number } from "./check_number";
 import { check_string } from "./check_string";
 import { check_template } from "./check_template";
 
-/**
- * @internal
- */
+/** @internal */
 export const check_dynamic_key = (props: {
   context: ITypiaContext;
   metadata: Metadata;
@@ -181,9 +179,7 @@ export const check_dynamic_key = (props: {
       : conditions.reduce(ts.factory.createLogicalOr);
 };
 
-/**
- * @internal
- */
+/** @internal */
 const atomist = (entry: ICheckEntry) =>
   [
     ...(entry.expression ? [entry.expression] : []),

package/src/programmers/internal/check_dynamic_properties.ts

@@ -11,9 +11,7 @@ import { check_dynamic_key } from "./check_dynamic_key";
 import { check_everything } from "./check_everything";
 import { check_object } from "./check_object";
 
-/**
- * @internal
- */
+/** @internal */
 export const check_dynamic_properties = (props: {
   config: check_object.IConfig;
   context: ITypiaContext;
@@ -89,9 +87,7 @@ export const check_dynamic_properties = (props: {
     : right;
 };
 
-/**
- * @internal
- */
+/** @internal */
 const check_dynamic_property = (props: {
   config: check_object.IConfig;
   context: ITypiaContext;
@@ -207,9 +203,7 @@ const check_dynamic_property = (props: {
   );
 };
 
-/**
- * @internal
- */
+/** @internal */
 const is_regular_property = (regular: IExpressionEntry[]) =>
   ts.factory.createCallExpression(
     IdentifierFactory.access(

package/src/programmers/internal/check_everything.ts

@@ -3,9 +3,7 @@ import ts from "typescript";
 import { IdentifierFactory } from "../../factories/IdentifierFactory";
 import { TypeFactory } from "../../factories/TypeFactory";
 
-/**
- * @internal
- */
+/** @internal */
 export const check_everything = (array: ts.Expression) =>
   ts.factory.createCallExpression(
     IdentifierFactory.access(array, "every"),

package/src/programmers/internal/check_native.ts

@@ -2,9 +2,7 @@ import ts from "typescript";
 
 import { ExpressionFactory } from "../../factories/ExpressionFactory";
 
-/**
- * @internal
- */
+/** @internal */
 export const check_native = (props: {
   name: string;
   input: ts.Expression;
@@ -21,7 +19,5 @@ export const check_native = (props: {
     : instanceOf;
 };
 
-/**
- * @internal
- */
+/** @internal */
 const ATOMIC_LIKE = new Set(["Boolean", "Number", "String"]);

package/src/programmers/internal/check_number.ts

@@ -9,9 +9,7 @@ import { ITypiaContext } from "../../transformers/ITypiaContext";
 import { ICheckEntry } from "../helpers/ICheckEntry";
 import { OptionPredicator } from "../helpers/OptionPredicator";
 
-/**
- * @internal
- */
+/** @internal */
 export const check_number = (props: {
   numeric: boolean;
   context: ITypiaContext;
@@ -56,9 +54,7 @@ export const check_number = (props: {
   };
 };
 
-/**
- * @internal
- */
+/** @internal */
 const check_numeric_type_tags = (props: {
   context: ITypiaContext;
   atomic: MetadataAtomic;

package/src/programmers/internal/check_object.ts

@@ -6,9 +6,7 @@ import { IExpressionEntry } from "../helpers/IExpressionEntry";
 import { check_dynamic_properties } from "./check_dynamic_properties";
 import { check_everything } from "./check_everything";
 
-/**
- * @internal
- */
+/** @internal */
 export const check_object = (props: {
   config: check_object.IConfig;
   context: ITypiaContext;
@@ -45,9 +43,7 @@ export const check_object = (props: {
   });
 };
 
-/**
- * @internal
- */
+/** @internal */
 export namespace check_object {
   export interface IConfig {
     equals: boolean;
@@ -64,9 +60,7 @@ export namespace check_object {
   }
 }
 
-/**
- * @internal
- */
+/** @internal */
 const reduce = (props: {
   config: check_object.IConfig;
   expressions: ts.Expression[];

package/src/programmers/internal/check_string.ts

@@ -8,9 +8,7 @@ import { ITypiaContext } from "../../transformers/ITypiaContext";
 
 import { ICheckEntry } from "../helpers/ICheckEntry";
 
-/**
- * @internal
- */
+/** @internal */
 export const check_string = (props: {
   context: ITypiaContext;
   atomic: MetadataAtomic;
@@ -27,9 +25,7 @@ export const check_string = (props: {
   };
 };
 
-/**
- * @internal
- */
+/** @internal */
 const check_string_type_tags = (props: {
   context: ITypiaContext;
   atomic: MetadataAtomic;

package/src/programmers/internal/check_template.ts

@@ -5,9 +5,7 @@ import { MetadataTemplate } from "../../schemas/metadata/MetadataTemplate";
 import { ICheckEntry } from "../helpers/ICheckEntry";
 import { template_to_pattern } from "./template_to_pattern";
 
-/**
- * @internal
- */
+/** @internal */
 export const check_template = (props: {
   templates: MetadataTemplate[];
   input: ts.Expression;

package/src/programmers/internal/check_union_array_like.ts

@@ -15,9 +15,7 @@ import { CheckerProgrammer } from "../CheckerProgrammer";
 import { FeatureProgrammer } from "../FeatureProgrammer";
 import { UnionExplorer } from "../helpers/UnionExplorer";
 
-/**
- * @internal
- */
+/** @internal */
 export const check_union_array_like = <
   Origin extends Metadata | MetadataArray | MetadataTuple | MetadataMap,
   Category extends MetadataArray | MetadataTuple,
@@ -296,9 +294,7 @@ export const check_union_array_like = <
   );
 };
 
-/**
- * @internal
- */
+/** @internal */
 export namespace check_union_array_like {
   export interface IConfig<
     Category extends MetadataArray | MetadataTuple,

package/src/programmers/internal/decode_union_object.ts

@@ -4,9 +4,7 @@ import { MetadataObjectType } from "../../schemas/metadata/MetadataObjectType";
 
 import { FeatureProgrammer } from "../FeatureProgrammer";
 
-/**
- * @internal
- */
+/** @internal */
 export const decode_union_object = (props: {
   checker: (next: {
     input: ts.Expression;
@@ -58,9 +56,7 @@ export const decode_union_object = (props: {
     undefined,
   );
 
-/**
- * @internal
- */
+/** @internal */
 const iterate = (props: {
   escaper: (next: { input: ts.Expression; expected: string }) => ts.Statement;
   unions: IUnion[];
@@ -106,9 +102,7 @@ const iterate = (props: {
   return ts.factory.createBlock(statements, true);
 };
 
-/**
- * @internal
- */
+/** @internal */
 interface IUnion {
   type: string;
   is: () => ts.Expression;

package/src/programmers/internal/feature_object_entries.ts

@@ -10,9 +10,7 @@ import { Escaper } from "../../utils/Escaper";
 
 import { FeatureProgrammer } from "../FeatureProgrammer";
 
-/**
- * @internal
- */
+/** @internal */
 export const feature_object_entries = <Output extends ts.ConciseBody>(props: {
   config: Pick<FeatureProgrammer.IConfig<Output>, "decoder" | "path" | "trace">;
   context: ITypiaContext;

package/src/programmers/internal/json_schema_escaped.ts

@@ -5,9 +5,7 @@ import { MetadataEscaped } from "../../schemas/metadata/MetadataEscaped";
 
 import { json_schema_station } from "./json_schema_station";
 
-/**
- * @internal
- */
+/** @internal */
 export const json_schema_escaped = (props: {
   components: OpenApi.IComponents;
   escaped: MetadataEscaped;
@@ -46,9 +44,7 @@ export const json_schema_escaped = (props: {
     : [output];
 };
 
-/**
- * @internal
- */
+/** @internal */
 const is_date = (props: {
   visited: Set<Metadata>;
   metadata: Metadata;

package/src/programmers/internal/json_schema_object.ts

@@ -14,9 +14,7 @@ import { json_schema_station } from "./json_schema_station";
 import { json_schema_title } from "./json_schema_title";
 import { metadata_to_pattern } from "./metadata_to_pattern";
 
-/**
- * @internal
- */
+/** @internal */
 export const json_schema_object = (props: {
   components: OpenApi.IComponents;
   object: MetadataObject;
@@ -44,9 +42,7 @@ const emplace_object = (props: {
   return { $ref };
 };
 
-/**
- * @internal
- */
+/** @internal */
 const create_object_schema = (props: {
   components: OpenApi.IComponents;
   object: MetadataObject;
@@ -117,9 +113,7 @@ const create_object_schema = (props: {
   };
 };
 
-/**
- * @internal
- */
+/** @internal */
 const join = (props: {
   components: OpenApi.IComponents;
   extra: ISuperfluous;
@@ -149,9 +143,7 @@ const join = (props: {
   );
 };
 
-/**
- * @internal
- */
+/** @internal */
 interface ISuperfluous {
   additionalProperties?: undefined | [Metadata, OpenApi.IJsonSchema];
   patternProperties: Record<string, [Metadata, OpenApi.IJsonSchema]>;

package/src/programmers/internal/metadata_to_pattern.ts

@@ -4,9 +4,7 @@ import { PatternUtil } from "../../utils/PatternUtil";
 
 import { template_to_pattern } from "./template_to_pattern";
 
-/**
- * @internal
- */
+/** @internal */
 export const metadata_to_pattern = (props: {
   top: boolean;
   metadata: Metadata;

package/src/programmers/internal/postfix_of_tuple.ts

@@ -1,5 +1,3 @@
-/**
- * @internal
- */
+/** @internal */
 export const postfix_of_tuple = (str: string): string =>
   str.endsWith('"') ? str.slice(0, -1) : `${str} + "`;

package/src/programmers/internal/prune_object_properties.ts

@@ -4,9 +4,7 @@ import { MetadataObjectType } from "../../schemas/metadata/MetadataObjectType";
 
 import { metadata_to_pattern } from "./metadata_to_pattern";
 
-/**
- * @internal
- */
+/** @internal */
 export const prune_object_properties = (object: MetadataObjectType) => {
   const input: ts.Expression = ts.factory.createIdentifier("input");
   const key: ts.Expression = ts.factory.createIdentifier("key");

package/src/programmers/internal/stringify_dynamic_properties.ts

@@ -6,9 +6,7 @@ import { TemplateFactory } from "../../factories/TemplateFactory";
 import { IExpressionEntry } from "../helpers/IExpressionEntry";
 import { metadata_to_pattern } from "./metadata_to_pattern";
 
-/**
- * @internal
- */
+/** @internal */
 export const stringify_dynamic_properties = (
   dynamic: IExpressionEntry<ts.Expression>[],
   regular: string[],
@@ -143,9 +141,7 @@ export const stringify_dynamic_properties = (
   return output();
 };
 
-/**
- * @internal
- */
+/** @internal */
 const stringify = (
   entry: IExpressionEntry<ts.Expression>,
 ): ts.ReturnStatement =>

package/src/programmers/internal/stringify_native.ts

@@ -1,7 +1,5 @@
 import ts from "typescript";
 
-/**
- * @internal
- */
+/** @internal */
 export const stringify_native = (): ts.Expression =>
   ts.factory.createStringLiteral("{}");