typia 9.7.1 → 9.7.2

package/src/transformers/ITransformOptions.ts

@@ -2,16 +2,20 @@ export interface ITransformOptions {
   /**
    * Whether to validate finite number or not.
    *
-   * If configured true, number typed values would be validated by Number.isNaN().
+   * If configured true, number typed values would be validated by
+   * Number.isNaN().
    *
-   * However, whatever you configure, it would be ignored when marshaling or parsing.
+   * However, whatever you configure, it would be ignored when marshaling or
+   * parsing.
    *
-   *   - when marshaling, always be true
-   *     - assertStringify()
-   *     - validateEncode()
-   *   - when parsing, always be false
-   *     - assertParse()
-   *     - isDecode()
+   * - When marshaling, always be true
+   *
+   *   - AssertStringify()
+   *   - ValidateEncode()
+   * - When parsing, always be false
+   *
+   *   - AssertParse()
+   *   - IsDecode()
    *
    * @default false
    */
@@ -20,17 +24,20 @@ export interface ITransformOptions {
   /**
    * Whether to validate finite number or not.
    *
-   * If configured true, number typed values would be validated by Number.isFinite().
+   * If configured true, number typed values would be validated by
+   * Number.isFinite().
    *
    * However, whatever you configure, it can be ignored in below case.
    *
-   *   - when `finite` option is true, this option would be ignored
-   *   - when marshaling, always be true
-   *     - assertStringify()
-   *     - validateEncode()
-   *   - when parsing, always be false
-   *     - assertParse()
-   *     - isDecode()
+   * - When `finite` option is true, this option would be ignored
+   * - When marshaling, always be true
+   *
+   *   - AssertStringify()
+   *   - ValidateEncode()
+   * - When parsing, always be false
+   *
+   *   - AssertParse()
+   *   - IsDecode()
    *
    * @default false
    */
@@ -39,7 +46,8 @@ export interface ITransformOptions {
   /**
    * Whether to validate functional type or not.
    *
-   * However, whatever you configure, it becomes false when marshaling or parsing.
+   * However, whatever you configure, it becomes false when marshaling or
+   * parsing.
    *
    * @default false
    */
@@ -49,8 +57,8 @@ export interface ITransformOptions {
    * Whether to check undefined value or not.
    *
    * JavaScript can assign `undefined` value to a specific property and it is an
-   * issue when validating without allowing superfluous properties. Should undefined
-   * value assigned superfluous property be allowed or not?
+   * issue when validating without allowing superfluous properties. Should
+   * undefined value assigned superfluous property be allowed or not?
    *
    * Note that, this option only works on {@link equals} function. Other function
    * like {@link assertEquals} or {@link validateEquals} would ignore this option

package/src/transformers/ImportTransformer.ts

@@ -86,9 +86,7 @@ const get_directory_path = (file: string): string => {
   return path.resolve(split.join(path.sep));
 };
 
-/**
- * Remove unused typia imports that are only used in transformable calls
- */
+/** Remove unused typia imports that are only used in transformable calls */
 const removeUnusedTypiaImports = (file: ts.SourceFile): ts.SourceFile => {
   // Find typia imports and collect all identifiers
   interface ImportMetadata {
@@ -194,7 +192,8 @@ const removeUnusedTypiaImports = (file: ts.SourceFile): ts.SourceFile => {
 
 /**
  * Check if a property access expression looks like a transformable typia call
- * This uses heuristics to detect patterns like typia.xxx(), typia.namespace.xxx()
+ * This uses heuristics to detect patterns like typia.xxx(),
+ * typia.namespace.xxx()
  */
 const isLikelyTransformableCall = (
   node: ts.PropertyAccessExpression,
@@ -221,9 +220,7 @@ const isLikelyTransformableCall = (
   return false;
 };
 
-/**
- * Check if a property access expression is part of a typia.xxx.yyy chain
- */
+/** Check if a property access expression is part of a typia.xxx.yyy chain */
 const isTypiaPropertyChain = (node: ts.PropertyAccessExpression): boolean => {
   let current: ts.Expression = node;
 
@@ -234,9 +231,7 @@ const isTypiaPropertyChain = (node: ts.PropertyAccessExpression): boolean => {
   return ts.isIdentifier(current) && current.text === "typia";
 };
 
-/**
- * Filter import clause to remove unused default imports
- */
+/** Filter import clause to remove unused default imports */
 const filterTypiaImportClause = (
   importClause: ts.ImportClause,
   usedImports: Set<string>,

package/src/transformers/NoTransformConfigurationError.ts

@@ -1,6 +1,4 @@
-/**
- * @internal
- */
+/** @internal */
 export function NoTransformConfigurationError(name: string): never {
   throw new Error(
     [

package/src/transformers/features/llm/LlmApplicationTransformer.ts

@@ -61,9 +61,7 @@ export namespace LlmApplicationTransformer {
     );
   };
 
-  /**
-   * @internal
-   */
+  /** @internal */
   export const decompose = (
     method: string,
     props: ITransformProps,

package/src/typings/Equal.ts

@@ -1,16 +1,16 @@
 /**
  * Compare the equivalence of the two types X and Y.
  *
- * The two types X and Y refer to any type that can be expressed in the type script, such as the union type and the object type.
+ * The two types X and Y refer to any type that can be expressed in the
+ * TypeScript, such as the union type and the object type.
  *
+ * @author Kyungsu Kang - https://github.com/kakasoo
  * @template X One of the types to compare
  * @template Y One of the types to compare
  *
- * ```ts
- * type Answer = Equal<1 | 2, 1 | 2>; // true
- * ```
- *
- * @author Kyungsu Kang - https://github.com/kakasoo
+ *   ```ts
+ *   type Answer = Equal<1 | 2, 1 | 2>; // true
+ *   ```
  */
 export type Equal<X, Y> =
   (<T>() => T extends X ? 1 : 2) extends <T>() => T extends Y ? 1 : 2