@typia/interface 12.0.0-dev.20260312-4 → 12.0.0-dev.20260313

package/lib/schema/IJsonParseResult.d.ts

@@ -63,7 +63,7 @@ export declare namespace IJsonParseResult {
          * Contains whatever could be recovered from the malformed JSON. May be
          * incomplete or have missing properties.
          */
-        data: DeepPartial<T>;
+        data: DeepPartial<T> | undefined;
         /**
          * The original input string that was parsed.
          *
@@ -117,6 +117,6 @@ export declare namespace IJsonParseResult {
          * @example
          *   missing opening quote for 'hello'
          */
-        value: unknown;
+        description: unknown;
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@typia/interface",
-  "version": "12.0.0-dev.20260312-4",
+  "version": "12.0.0-dev.20260313",
   "description": "Superfast runtime validators with only one line",
   "main": "lib/index.js",
   "exports": {

package/src/schema/IJsonParseResult.ts

@@ -1,134 +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> | undefined;
+
+    /**
+     * 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'
+     */
+    description: unknown;
+  }
+}

package/src/schema/ILlmApplication.ts

@@ -1,98 +1,98 @@
-import { ILlmFunction } from "./ILlmFunction";
-import { ILlmSchema } from "./ILlmSchema";
-import { IValidation } from "./IValidation";
-
-/**
- * LLM function calling application.
- *
- * `ILlmApplication` is a collection of {@link ILlmFunction} schemas generated
- * from a TypeScript class or interface by `typia.llm.application<App>()`. Each
- * public method becomes an {@link ILlmFunction} that LLM agents can invoke.
- *
- * Configure behavior via {@link ILlmApplication.IConfig}:
- *
- * - {@link ILlmApplication.IConfig.validate}: Custom validation per method
- * - {@link ILlmSchema.IConfig.strict}: OpenAI structured output mode
- *
- * @author Jeongho Nam - https://github.com/samchon
- * @template Class Source class/interface type
- */
-export interface ILlmApplication<Class extends object = any> {
-  /**
-   * Array of callable function schemas.
-   *
-   * Each function represents a method from the source class that the LLM can
-   * invoke. Functions include parameter schemas, descriptions, and validation
-   * logic for type-safe function calling.
-   */
-  functions: ILlmFunction[];
-
-  /**
-   * Configuration used to generate this application.
-   *
-   * Contains the settings that were applied during schema generation, including
-   * strict mode and any custom validation hooks.
-   */
-  config: ILlmApplication.IConfig<Class>;
-
-  /**
-   * Phantom property for TypeScript generic type preservation.
-   *
-   * This property exists only in the type system to preserve the `Class`
-   * generic parameter at compile time. It is always `undefined` at runtime and
-   * should not be accessed or used in application code.
-   *
-   * This pattern enables type inference to recover the original class type from
-   * an `ILlmApplication` instance, useful for type-safe function routing.
-   */
-  __class?: Class | undefined;
-}
-export namespace ILlmApplication {
-  /**
-   * Configuration for LLM application generation.
-   *
-   * Extends {@link ILlmSchema.IConfig} with application-specific options for
-   * custom validation. These settings control how the application schema is
-   * generated from the source class.
-   */
-  export interface IConfig<Class extends object = any>
-    extends ILlmSchema.IConfig {
-    /**
-     * Custom validation functions per method name.
-     *
-     * Allows overriding the default type-based validation with custom business
-     * logic. Useful for complex validation rules that cannot be expressed in
-     * JSON Schema.
-     *
-     * @default null (use default type validation)
-     */
-    validate: null | Partial<ILlmApplication.IValidationHook<Class>>;
-  }
-
-  /**
-   * Type-safe mapping of method names to custom validators.
-   *
-   * Maps each method name to a validation function that receives the raw input
-   * and returns a validation result. The type inference ensures validators
-   * match the expected argument types.
-   *
-   * @template Class - The source class type for type inference
-   */
-  export type IValidationHook<Class extends object> = {
-    [K in keyof Class]?: Class[K] extends (args: infer Argument) => unknown
-      ? (input: unknown) => IValidation<Argument>
-      : never;
-  };
-
-  /**
-   * Internal type for typia transformer.
-   *
-   * @ignore
-   */
-  export interface __IPrimitive<Class extends object = any> extends Omit<
-    ILlmApplication<Class>,
-    "config" | "functions"
-  > {
-    functions: Omit<ILlmFunction, "parse" | "coerce">[];
-  }
-}
+import { ILlmFunction } from "./ILlmFunction";
+import { ILlmSchema } from "./ILlmSchema";
+import { IValidation } from "./IValidation";
+
+/**
+ * LLM function calling application.
+ *
+ * `ILlmApplication` is a collection of {@link ILlmFunction} schemas generated
+ * from a TypeScript class or interface by `typia.llm.application<App>()`. Each
+ * public method becomes an {@link ILlmFunction} that LLM agents can invoke.
+ *
+ * Configure behavior via {@link ILlmApplication.IConfig}:
+ *
+ * - {@link ILlmApplication.IConfig.validate}: Custom validation per method
+ * - {@link ILlmSchema.IConfig.strict}: OpenAI structured output mode
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ * @template Class Source class/interface type
+ */
+export interface ILlmApplication<Class extends object = any> {
+  /**
+   * Array of callable function schemas.
+   *
+   * Each function represents a method from the source class that the LLM can
+   * invoke. Functions include parameter schemas, descriptions, and validation
+   * logic for type-safe function calling.
+   */
+  functions: ILlmFunction[];
+
+  /**
+   * Configuration used to generate this application.
+   *
+   * Contains the settings that were applied during schema generation, including
+   * strict mode and any custom validation hooks.
+   */
+  config: ILlmApplication.IConfig<Class>;
+
+  /**
+   * Phantom property for TypeScript generic type preservation.
+   *
+   * This property exists only in the type system to preserve the `Class`
+   * generic parameter at compile time. It is always `undefined` at runtime and
+   * should not be accessed or used in application code.
+   *
+   * This pattern enables type inference to recover the original class type from
+   * an `ILlmApplication` instance, useful for type-safe function routing.
+   */
+  __class?: Class | undefined;
+}
+export namespace ILlmApplication {
+  /**
+   * Configuration for LLM application generation.
+   *
+   * Extends {@link ILlmSchema.IConfig} with application-specific options for
+   * custom validation. These settings control how the application schema is
+   * generated from the source class.
+   */
+  export interface IConfig<Class extends object = any>
+    extends ILlmSchema.IConfig {
+    /**
+     * Custom validation functions per method name.
+     *
+     * Allows overriding the default type-based validation with custom business
+     * logic. Useful for complex validation rules that cannot be expressed in
+     * JSON Schema.
+     *
+     * @default null (use default type validation)
+     */
+    validate: null | Partial<ILlmApplication.IValidationHook<Class>>;
+  }
+
+  /**
+   * Type-safe mapping of method names to custom validators.
+   *
+   * Maps each method name to a validation function that receives the raw input
+   * and returns a validation result. The type inference ensures validators
+   * match the expected argument types.
+   *
+   * @template Class - The source class type for type inference
+   */
+  export type IValidationHook<Class extends object> = {
+    [K in keyof Class]?: Class[K] extends (args: infer Argument) => unknown
+      ? (input: unknown) => IValidation<Argument>
+      : never;
+  };
+
+  /**
+   * Internal type for typia transformer.
+   *
+   * @ignore
+   */
+  export interface __IPrimitive<Class extends object = any> extends Omit<
+    ILlmApplication<Class>,
+    "config" | "functions"
+  > {
+    functions: Omit<ILlmFunction, "parse" | "coerce">[];
+  }
+}