@typia/interface 12.0.0-dev.20260307-2 → 12.0.0-dev.20260310

package/src/openapi/index.ts

@@ -1,4 +1,4 @@
-export * from "./OpenApi";
-export * from "./OpenApiV3";
-export * from "./OpenApiV3_1";
-export * from "./SwaggerV2";
+export * from "./OpenApi";
+export * from "./OpenApiV3";
+export * from "./OpenApiV3_1";
+export * from "./SwaggerV2";

package/src/protobuf/ProtobufWire.ts

@@ -1,51 +1,51 @@
-/**
- * Protocol Buffers wire types.
- *
- * `ProtobufWire` defines the wire types used in Protocol Buffers binary
- * encoding. Each type determines how the value is serialized on the wire.
- *
- * Wire types:
- *
- * - {@link VARIANT} (0): Varints (int32, int64, uint32, uint64, sint32, sint64,
- *   bool, enum)
- * - {@link I64} (1): 64-bit (fixed64, sfixed64, double)
- * - {@link LEN} (2): Length-delimited (string, bytes, embedded messages, packed
- *   repeated)
- * - {@link I32} (5): 32-bit (fixed32, sfixed32, float)
- *
- * @author Jeongho Nam - https://github.com/samchon
- */
-export const enum ProtobufWire {
-  /**
-   * - Integers
-   * - Bool
-   * - Enum
-   */
-  VARIANT = 0,
-
-  /**
-   * - Fixed64
-   * - Sfixed64
-   * - Double
-   */
-  I64 = 1,
-
-  /**
-   * - String
-   * - Bytes
-   * - Embedded messages
-   * - Packed repeated fields
-   */
-  LEN = 2,
-
-  START_GROUP = 3,
-
-  END_GROUP = 4,
-
-  /**
-   * - Fixed
-   * - Sfixed32
-   * - Float
-   */
-  I32 = 5,
-}
+/**
+ * Protocol Buffers wire types.
+ *
+ * `ProtobufWire` defines the wire types used in Protocol Buffers binary
+ * encoding. Each type determines how the value is serialized on the wire.
+ *
+ * Wire types:
+ *
+ * - {@link VARIANT} (0): Varints (int32, int64, uint32, uint64, sint32, sint64,
+ *   bool, enum)
+ * - {@link I64} (1): 64-bit (fixed64, sfixed64, double)
+ * - {@link LEN} (2): Length-delimited (string, bytes, embedded messages, packed
+ *   repeated)
+ * - {@link I32} (5): 32-bit (fixed32, sfixed32, float)
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export const enum ProtobufWire {
+  /**
+   * - Integers
+   * - Bool
+   * - Enum
+   */
+  VARIANT = 0,
+
+  /**
+   * - Fixed64
+   * - Sfixed64
+   * - Double
+   */
+  I64 = 1,
+
+  /**
+   * - String
+   * - Bytes
+   * - Embedded messages
+   * - Packed repeated fields
+   */
+  LEN = 2,
+
+  START_GROUP = 3,
+
+  END_GROUP = 4,
+
+  /**
+   * - Fixed
+   * - Sfixed32
+   * - Float
+   */
+  I32 = 5,
+}

package/src/protobuf/index.ts

@@ -1 +1 @@
-export * from "./ProtobufWire";
+export * from "./ProtobufWire";

package/src/schema/IJsonParseResult.ts

@@ -1,136 +1,134 @@
-import { DeepPartial } from "../typings/DeepPartial";
-
-/**
- * Result of lenient JSON parsing.
- *
- * `IJsonParseResult<T>` represents the result of parsing JSON that may be
- * incomplete, malformed, or contain non-standard syntax (e.g., unquoted keys,
- * trailing commas, missing quotes).
- *
- * Unlike standard JSON parsing which fails on any syntax error, lenient parsing
- * attempts to recover as much data as possible while reporting issues.
- *
- * Check the {@link IJsonParseResult.success} discriminator:
- *
- * - `true` → {@link IJsonParseResult.ISuccess} with parsed
- *   {@link IJsonParseResult.ISuccess.data}
- * - `false` → {@link IJsonParseResult.IFailure} with partial
- *   {@link IJsonParseResult.IFailure.data} and
- *   {@link IJsonParseResult.IFailure.errors}
- *
- * @author Jeongho Nam - https://github.com/samchon
- * @template T The expected type after successful parsing
- */
-export type IJsonParseResult<T = unknown> =
-  | IJsonParseResult.ISuccess<T>
-  | IJsonParseResult.IFailure<T>;
-
-export namespace IJsonParseResult {
-  /**
-   * Successful parsing result.
-   *
-   * Indicates the JSON was parsed without any errors. The data may still have
-   * been recovered from non-standard syntax (e.g., unquoted keys, trailing
-   * commas), but no information was lost.
-   *
-   * @template T The parsed type
-   */
-  export interface ISuccess<T = unknown> {
-    /**
-     * Success discriminator.
-     *
-     * Always `true` for successful parsing.
-     */
-    success: true;
-
-    /** The parsed data with correct type. */
-    data: T;
-  }
-
-  /**
-   * Failed parsing result with partial data and errors.
-   *
-   * Indicates the JSON had syntax errors that could not be fully recovered. The
-   * {@link data} contains whatever could be parsed, and {@link errors} describes
-   * what went wrong.
-   *
-   * @template T The expected type (data may be partial)
-   */
-  export interface IFailure<T = unknown> {
-    /**
-     * Success discriminator.
-     *
-     * Always `false` for failed parsing.
-     */
-    success: false;
-
-    /**
-     * Partially parsed data.
-     *
-     * Contains whatever could be recovered from the malformed JSON. May be
-     * incomplete or have missing properties.
-     */
-    data: DeepPartial<T>;
-
-    /**
-     * The original input string that was parsed.
-     *
-     * Preserved for debugging or error correction purposes.
-     */
-    input: string;
-
-    /**
-     * Array of parsing errors encountered.
-     *
-     * Each error describes a specific issue found during parsing, with location
-     * and suggested fix.
-     */
-    errors: IError[];
-  }
-
-  /**
-   * Detailed information about a parsing error.
-   */
-  export interface IError {
-    /**
-     * Property path to the error location.
-     *
-     * A dot-notation path from the root to the error location. Uses `$input` as
-     * the root.
-     *
-     * @example
-     *   $input.user.email;
-     *
-     * @example
-     *   $input.items[0].price;
-     */
-    path: string;
-
-    /**
-     * What was expected at this location.
-     *
-     * @example
-     *   JSON value (string, number, boolean, null, object, or array)
-     *
-     * @example
-     *   quoted string
-     *
-     * @example
-     *   ":";
-     */
-    expected: string;
-
-    /**
-     * Description of what was actually found.
-     *
-     * Human/AI-readable message explaining the issue.
-     *
-     * @example
-     *   unquoted string 'abc' - did you forget quotes?
-     *
-     * @example
-     *   missing opening quote for 'hello'
-     */
-    value: unknown;
-  }
-}
+import { DeepPartial } from "../typings/DeepPartial";
+
+/**
+ * Result of lenient JSON parsing.
+ *
+ * `IJsonParseResult<T>` represents the result of parsing JSON that may be
+ * incomplete, malformed, or contain non-standard syntax (e.g., unquoted keys,
+ * trailing commas, missing quotes).
+ *
+ * Unlike standard JSON parsing which fails on any syntax error, lenient parsing
+ * attempts to recover as much data as possible while reporting issues.
+ *
+ * Check the {@link IJsonParseResult.success} discriminator:
+ *
+ * - `true` → {@link IJsonParseResult.ISuccess} with parsed
+ *   {@link IJsonParseResult.ISuccess.data}
+ * - `false` → {@link IJsonParseResult.IFailure} with partial
+ *   {@link IJsonParseResult.IFailure.data} and
+ *   {@link IJsonParseResult.IFailure.errors}
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ * @template T The expected type after successful parsing
+ */
+export type IJsonParseResult<T = unknown> =
+  | IJsonParseResult.ISuccess<T>
+  | IJsonParseResult.IFailure<T>;
+
+export namespace IJsonParseResult {
+  /**
+   * Successful parsing result.
+   *
+   * Indicates the JSON was parsed without any errors. The data may still have
+   * been recovered from non-standard syntax (e.g., unquoted keys, trailing
+   * commas), but no information was lost.
+   *
+   * @template T The parsed type
+   */
+  export interface ISuccess<T = unknown> {
+    /**
+     * Success discriminator.
+     *
+     * Always `true` for successful parsing.
+     */
+    success: true;
+
+    /** The parsed data with correct type. */
+    data: T;
+  }
+
+  /**
+   * Failed parsing result with partial data and errors.
+   *
+   * Indicates the JSON had syntax errors that could not be fully recovered. The
+   * {@link data} contains whatever could be parsed, and {@link errors} describes
+   * what went wrong.
+   *
+   * @template T The expected type (data may be partial)
+   */
+  export interface IFailure<T = unknown> {
+    /**
+     * Success discriminator.
+     *
+     * Always `false` for failed parsing.
+     */
+    success: false;
+
+    /**
+     * Partially parsed data.
+     *
+     * Contains whatever could be recovered from the malformed JSON. May be
+     * incomplete or have missing properties.
+     */
+    data: DeepPartial<T>;
+
+    /**
+     * The original input string that was parsed.
+     *
+     * Preserved for debugging or error correction purposes.
+     */
+    input: string;
+
+    /**
+     * Array of parsing errors encountered.
+     *
+     * Each error describes a specific issue found during parsing, with location
+     * and suggested fix.
+     */
+    errors: IError[];
+  }
+
+  /** Detailed information about a parsing error. */
+  export interface IError {
+    /**
+     * Property path to the error location.
+     *
+     * A dot-notation path from the root to the error location. Uses `$input` as
+     * the root.
+     *
+     * @example
+     *   $input.user.email;
+     *
+     * @example
+     *   $input.items[0].price;
+     */
+    path: string;
+
+    /**
+     * What was expected at this location.
+     *
+     * @example
+     *   JSON value (string, number, boolean, null, object, or array)
+     *
+     * @example
+     *   quoted string
+     *
+     * @example
+     *   ":";
+     */
+    expected: string;
+
+    /**
+     * Description of what was actually found.
+     *
+     * Human/AI-readable message explaining the issue.
+     *
+     * @example
+     *   unquoted string 'abc' - did you forget quotes?
+     *
+     * @example
+     *   missing opening quote for 'hello'
+     */
+    value: unknown;
+  }
+}