@typia/core 12.0.0-dev.20260225

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 Jeongho Nam
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,18 @@
+# `@typia/core`
+
+[![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/samchon/typia/blob/master/LICENSE)
+[![NPM Version](https://img.shields.io/npm/v/typia.svg)](https://www.npmjs.com/package/typia)
+[![NPM Downloads](https://img.shields.io/npm/dm/typia.svg)](https://www.npmjs.com/package/typia)
+
+Core compile-time code generation logic for [`typia`](https://github.com/samchon/typia).
+
+This is an **internal package** of `typia`. You don't need to install it directly — it is automatically included as a dependency of `typia`.
+
+## Key Modules
+
+| Module | Description |
+|--------|-------------|
+| `programmers/` | Code generators for `assert`, `is`, `validate`, `random`, and more |
+| `factories/` | AST node factory functions for TypeScript code generation |
+| `schemas/` | Metadata and Protocol Buffer schema analyzers |
+| `context/` | Transformer context management (`ITypiaContext`, `ITransformOptions`) |

package/lib/context/IProgrammerProps.d.ts

@@ -0,0 +1,54 @@
+import ts from "typescript";
+import { ITypiaContext } from "./ITypiaContext";
+/**
+ * Properties passed to typia code programmers.
+ *
+ * `IProgrammerProps` contains all the information needed for programmer
+ * functions to generate runtime validation, serialization, or transformation
+ * code. Each programmer receives these props and produces TypeScript AST nodes
+ * that implement the operation for the target type.
+ *
+ * The programmers are internal to typia's transformation system and are invoked
+ * by the TypeScript transformer when processing `typia.*<T>()` function calls.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export interface IProgrammerProps {
+    /**
+     * Typia transformation context.
+     *
+     * Contains TypeScript compiler APIs, transformation context, import manager,
+     * and configuration options. Shared across all programmers.
+     */
+    context: ITypiaContext;
+    /**
+     * Module expression for typia references.
+     *
+     * The expression representing the typia module (typically the identifier
+     * `typia`). Used when generating code that references typia internals.
+     */
+    modulo: ts.LeftHandSideExpression;
+    /**
+     * TypeScript type to generate code for.
+     *
+     * The resolved type from the generic parameter of the typia function call
+     * (e.g., `T` from `typia.is<T>()`). Analyzed to generate appropriate
+     * validation/serialization logic.
+     */
+    type: ts.Type;
+    /**
+     * Optional type name for error messages.
+     *
+     * Human-readable name for the type, used in generated error messages and
+     * debug output. May be `undefined` for anonymous types.
+     */
+    name: string | undefined;
+    /**
+     * Optional initial value expression.
+     *
+     * For functions that take an input value (like `typia.is(value)`), this is
+     * the expression representing that value. Used as the input to the generated
+     * validation code.
+     */
+    init?: ts.Expression | undefined;
+}

package/lib/context/IProgrammerProps.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IProgrammerProps.js.map

package/lib/context/IProgrammerProps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IProgrammerProps.js","sourceRoot":"","sources":["../../src/context/IProgrammerProps.ts"],"names":[],"mappings":""}

package/lib/context/IProgrammerProps.mjs

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=IProgrammerProps.mjs.map

package/lib/context/IProgrammerProps.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"IProgrammerProps.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/lib/context/ITransformOptions.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Typia transformer configuration options.
+ *
+ * `ITransformOptions` controls how typia generates validation code at compile
+ * time. These options affect edge cases in type checking such as special
+ * numeric values (NaN, Infinity), function properties, and undefined handling.
+ *
+ * Configure these options in your `tsconfig.json` under the typia plugin:
+ *
+ * ```json
+ * {
+ *   "compilerOptions": {
+ *     "plugins": [{ "transform": "typia/lib/transform", "finite": true }]
+ *   }
+ * }
+ * ```
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export interface ITransformOptions {
+    /**
+     * Validate that numbers are finite (not NaN or Infinity).
+     *
+     * When `true`, generated validation code includes `Number.isFinite()` checks
+     * for all number types. This catches both `NaN` and `Infinity` values that
+     * might otherwise pass numeric type checks.
+     *
+     * Behavior varies by operation context:
+     *
+     * - **Validation** (`is`, `assert`, `validate`): Follows this setting
+     * - **Marshaling** (`stringify`, `encode`): Always `true` (JSON doesn't support
+     *   NaN/Infinity)
+     * - **Parsing** (`parse`, `decode`): Always `false` (JSON can't produce
+     *   NaN/Infinity)
+     *
+     * @default false
+     */
+    finite?: undefined | boolean;
+    /**
+     * Validate that numbers are not NaN.
+     *
+     * When `true`, generated validation code includes `Number.isNaN()` checks for
+     * all number types. This is less strict than `finite` - it allows `Infinity`
+     * but rejects `NaN`.
+     *
+     * This option is **ignored** if `finite` is `true` (which already rejects
+     * NaN). Same context-dependent behavior as `finite`.
+     *
+     * @default false
+     */
+    numeric?: undefined | boolean;
+    /**
+     * Validate function-typed properties.
+     *
+     * When `true`, generated validation code includes `typeof x === "function"`
+     * checks for function properties. When `false`, function properties are
+     * skipped during validation.
+     *
+     * Always `false` during marshaling/parsing since functions cannot be
+     * serialized to JSON or other formats.
+     *
+     * @default false
+     */
+    functional?: undefined | boolean;
+    /**
+     * Allow `undefined` values in extra/superfluous properties.
+     *
+     * Affects strict equality checking (`equals` functions) behavior when objects
+     * have additional properties beyond the type definition.
+     *
+     * When `true`, extra properties with `undefined` values are tolerated. When
+     * `false`, any extra property (even if `undefined`) fails equality.
+     *
+     * Only affects `equals*` functions; other validation functions always allow
+     * `undefined` in extra properties.
+     *
+     * @default true
+     */
+    undefined?: undefined | boolean;
+}

package/lib/context/ITransformOptions.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ITransformOptions.js.map

package/lib/context/ITransformOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ITransformOptions.js","sourceRoot":"","sources":["../../src/context/ITransformOptions.ts"],"names":[],"mappings":""}

package/lib/context/ITransformOptions.mjs

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=ITransformOptions.mjs.map

package/lib/context/ITransformOptions.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ITransformOptions.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/lib/context/ITypiaContext.d.ts

@@ -0,0 +1,91 @@
+import ts from "typescript";
+import { ImportProgrammer } from "../programmers/ImportProgrammer";
+import { ITransformOptions } from "./ITransformOptions";
+/**
+ * Typia transformation context containing compiler dependencies.
+ *
+ * `ITypiaContext` holds all the dependencies needed during compilation when
+ * transforming `typia.*<T>()` function calls into runtime validation code. This
+ * context is created by the typia transformer and passed to all programmer
+ * functions.
+ *
+ * The context provides access to:
+ *
+ * - TypeScript compiler APIs for type analysis ({@link checker})
+ * - AST manipulation utilities ({@link printer}, {@link transformer})
+ * - Import management ({@link importer})
+ * - Error reporting ({@link extras})
+ * - Configuration ({@link options})
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export interface ITypiaContext {
+    /**
+     * TypeScript program instance.
+     *
+     * The compiled TypeScript program containing all source files and type
+     * information. Used to access the type checker and resolve type definitions
+     * across files.
+     */
+    program: ts.Program;
+    /**
+     * TypeScript compiler options.
+     *
+     * The compiler options from `tsconfig.json`. Affects code generation
+     * decisions like module format and strict mode settings.
+     */
+    compilerOptions: ts.CompilerOptions;
+    /**
+     * TypeScript type checker for type analysis.
+     *
+     * Provides type information for AST nodes. Used extensively to analyze
+     * generic type parameters, resolve type aliases, and extract property
+     * information from types.
+     */
+    checker: ts.TypeChecker;
+    /**
+     * TypeScript AST printer for code generation.
+     *
+     * Converts generated AST nodes back to TypeScript source code. Used for debug
+     * output and error messages.
+     */
+    printer: ts.Printer;
+    /**
+     * Typia-specific transformer options.
+     *
+     * Configuration from the typia plugin in `tsconfig.json`. Controls validation
+     * behavior for edge cases.
+     */
+    options: ITransformOptions;
+    /**
+     * TypeScript transformation context.
+     *
+     * Provides factory functions for creating AST nodes during transformation.
+     * All generated code uses this context's factory.
+     */
+    transformer: ts.TransformationContext;
+    /**
+     * Import statement manager.
+     *
+     * Tracks and generates import statements for runtime dependencies. Ensures
+     * required modules are imported when validation code references external
+     * functions.
+     */
+    importer: ImportProgrammer;
+    /**
+     * Diagnostic utilities for error reporting.
+     *
+     * Provided by ts-patch or ttypescript for reporting compilation errors and
+     * warnings. Used to surface transformation errors in the IDE and build
+     * output.
+     */
+    extras: {
+        /**
+         * Adds a diagnostic message to the compilation output.
+         *
+         * @param diag - The diagnostic to report
+         * @returns The diagnostic ID
+         */
+        addDiagnostic: (diag: ts.Diagnostic) => number;
+    };
+}

package/lib/context/ITypiaContext.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ITypiaContext.js.map

package/lib/context/ITypiaContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ITypiaContext.js","sourceRoot":"","sources":["../../src/context/ITypiaContext.ts"],"names":[],"mappings":""}

package/lib/context/ITypiaContext.mjs

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=ITypiaContext.mjs.map

package/lib/context/ITypiaContext.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ITypiaContext.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/lib/context/TransformerError.d.ts

@@ -0,0 +1,34 @@
+import { MetadataFactory } from "../factories/MetadataFactory";
+/**
+ * Error thrown during typia transformation.
+ *
+ * Thrown when `typia.*<T>()` receives unsupported types (e.g., tuples for some
+ * LLM providers, recursive types without `$ref`, native class types). The error
+ * message lists specific type violations. Use {@link from} to create from
+ * multiple {@link MetadataFactory.IError} instances.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export declare class TransformerError extends Error {
+    /** Error code identifying the error type. */
+    readonly code: string;
+    constructor(props: TransformerError.IProps);
+}
+export declare namespace TransformerError {
+    /** Constructor properties for TransformerError. */
+    interface IProps {
+        /** Error code. */
+        code: string;
+        /** Error message. */
+        message: string;
+    }
+    /**
+     * Create error from metadata factory errors.
+     *
+     * Formats multiple type errors into a single TransformerError.
+     */
+    const from: (props: {
+        code: string;
+        errors: MetadataFactory.IError[];
+    }) => TransformerError;
+}

package/lib/context/TransformerError.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransformerError = void 0;
+const utils_1 = require("@typia/utils");
+/**
+ * Error thrown during typia transformation.
+ *
+ * Thrown when `typia.*<T>()` receives unsupported types (e.g., tuples for some
+ * LLM providers, recursive types without `$ref`, native class types). The error
+ * message lists specific type violations. Use {@link from} to create from
+ * multiple {@link MetadataFactory.IError} instances.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+class TransformerError extends Error {
+    constructor(props) {
+        super(props.message);
+        this.code = props.code;
+        // INHERITANCE POLYFILL
+        const proto = new.target.prototype;
+        if (Object.setPrototypeOf)
+            Object.setPrototypeOf(this, proto);
+        else
+            this.__proto__ = proto;
+    }
+}
+exports.TransformerError = TransformerError;
+(function (TransformerError) {
+    /**
+     * Create error from metadata factory errors.
+     *
+     * Formats multiple type errors into a single TransformerError.
+     */
+    TransformerError.from = (props) => {
+        const body = props.errors
+            .map((e) => {
+            const subject = e.explore.object === null
+                ? ""
+                : join(e.explore.object)(e.explore.property);
+            const middle = e.explore.parameter
+                ? `(parameter: ${JSON.stringify(e.explore.parameter)})`
+                : e.explore.output
+                    ? "(return type)"
+                    : "";
+            const type = `${subject.length ? `${subject}: ` : ""}${e.name}`;
+            return `- ${type}${middle}\n${e.messages
+                .map((msg) => `  - ${msg}`)
+                .join("\n")}`;
+        })
+            .join("\n\n");
+        return new TransformerError({
+            code: props.code,
+            message: `unsupported type detected\n\n${body}`,
+        });
+    };
+    const join = (object) => (key) => {
+        if (key === null)
+            return object.name;
+        else if (typeof key === "object")
+            return `${object.name}[key]`;
+        else if (utils_1.NamingConvention.variable(key))
+            return `${object.name}.${key}`;
+        return `${object.name}[${JSON.stringify(key)}]`;
+    };
+})(TransformerError || (exports.TransformerError = TransformerError = {}));
+//# sourceMappingURL=TransformerError.js.map

package/lib/context/TransformerError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransformerError.js","sourceRoot":"","sources":["../../src/context/TransformerError.ts"],"names":[],"mappings":";;;AAAA,wCAAgD;AAKhD;;;;;;;;;GASG;AACH,MAAa,gBAAiB,SAAQ,KAAK;IAIzC,YAAmB,KAA8B;QAC/C,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QAEvB,uBAAuB;QACvB,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC;QACnC,IAAI,MAAM,CAAC,cAAc;YAAE,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;;YACxD,IAAY,CAAC,SAAS,GAAG,KAAK,CAAC;IACvC,CAAC;CACF;AAbD,4CAaC;AACD,WAAiB,gBAAgB;IAU/B;;;;OAIG;IACU,qBAAI,GAAG,CAAC,KAGpB,EAAoB,EAAE;QACrB,MAAM,IAAI,GAAW,KAAK,CAAC,MAAM;aAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACT,MAAM,OAAO,GACX,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,IAAI;gBACvB,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YACjD,MAAM,MAAM,GAAW,CAAC,CAAC,OAAO,CAAC,SAAS;gBACxC,CAAC,CAAC,eAAe,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG;gBACvD,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM;oBAChB,CAAC,CAAC,eAAe;oBACjB,CAAC,CAAC,EAAE,CAAC;YACT,MAAM,IAAI,GAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;YACxE,OAAO,KAAK,IAAI,GAAG,MAAM,KAAK,CAAC,CAAC,QAAQ;iBACrC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,GAAG,EAAE,CAAC;iBAC1B,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAClB,CAAC,CAAC;aACD,IAAI,CAAC,MAAM,CAAC,CAAC;QAChB,OAAO,IAAI,gBAAgB,CAAC;YAC1B,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,gCAAgC,IAAI,EAAE;SAChD,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,MAAM,IAAI,GACR,CAAC,MAA0B,EAAE,EAAE,CAAC,CAAC,GAA2B,EAAE,EAAE;QAC9D,IAAI,GAAG,KAAK,IAAI;YAAE,OAAO,MAAM,CAAC,IAAI,CAAC;aAChC,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,OAAO,GAAG,MAAM,CAAC,IAAI,OAAO,CAAC;aAC1D,IAAI,wBAAgB,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,OAAO,GAAG,MAAM,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC;QACxE,OAAO,GAAG,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC;IAClD,CAAC,CAAC;AACN,CAAC,EAjDgB,gBAAgB,gCAAhB,gBAAgB,QAiDhC"}

package/lib/context/TransformerError.mjs

@@ -0,0 +1,67 @@
+import { NamingConvention } from '@typia/utils';
+
+/**
+ * Error thrown during typia transformation.
+ *
+ * Thrown when `typia.*<T>()` receives unsupported types (e.g., tuples for some
+ * LLM providers, recursive types without `$ref`, native class types). The error
+ * message lists specific type violations. Use {@link from} to create from
+ * multiple {@link MetadataFactory.IError} instances.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+class TransformerError extends Error {
+    /** Error code identifying the error type. */
+    code;
+    constructor(props) {
+        super(props.message);
+        this.code = props.code;
+        // INHERITANCE POLYFILL
+        const proto = new.target.prototype;
+        if (Object.setPrototypeOf)
+            Object.setPrototypeOf(this, proto);
+        else
+            this.__proto__ = proto;
+    }
+}
+(function (TransformerError) {
+    /**
+     * Create error from metadata factory errors.
+     *
+     * Formats multiple type errors into a single TransformerError.
+     */
+    TransformerError.from = (props) => {
+        const body = props.errors
+            .map((e) => {
+            const subject = e.explore.object === null
+                ? ""
+                : join(e.explore.object)(e.explore.property);
+            const middle = e.explore.parameter
+                ? `(parameter: ${JSON.stringify(e.explore.parameter)})`
+                : e.explore.output
+                    ? "(return type)"
+                    : "";
+            const type = `${subject.length ? `${subject}: ` : ""}${e.name}`;
+            return `- ${type}${middle}\n${e.messages
+                .map((msg) => `  - ${msg}`)
+                .join("\n")}`;
+        })
+            .join("\n\n");
+        return new TransformerError({
+            code: props.code,
+            message: `unsupported type detected\n\n${body}`,
+        });
+    };
+    const join = (object) => (key) => {
+        if (key === null)
+            return object.name;
+        else if (typeof key === "object")
+            return `${object.name}[key]`;
+        else if (NamingConvention.variable(key))
+            return `${object.name}.${key}`;
+        return `${object.name}[${JSON.stringify(key)}]`;
+    };
+})(TransformerError || (TransformerError = {}));
+
+export { TransformerError };
+//# sourceMappingURL=TransformerError.mjs.map

package/lib/context/TransformerError.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransformerError.mjs","sources":["../../src/context/TransformerError.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAKA;;;;;;;;;AASG;AACG,MAAO,gBAAiB,SAAQ,KAAK,CAAA;;AAEzB,IAAA,IAAI;AAEpB,IAAA,WAAA,CAAmB,KAA8B,EAAA;AAC/C,QAAA,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC;AACpB,QAAA,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI;;AAGtB,QAAA,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS;QAClC,IAAI,MAAM,CAAC,cAAc;AAAE,YAAA,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC;;AACvD,YAAA,IAAY,CAAC,SAAS,GAAG,KAAK;IACtC;AACD;AACD,CAAA,UAAiB,gBAAgB,EAAA;AAU/B;;;;AAIG;AACU,IAAA,gBAAA,CAAA,IAAI,GAAG,CAAC,KAGpB,KAAsB;AACrB,QAAA,MAAM,IAAI,GAAW,KAAK,CAAC;AACxB,aAAA,GAAG,CAAC,CAAC,CAAC,KAAI;YACT,MAAM,OAAO,GACX,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK;AACnB,kBAAE;AACF,kBAAE,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;AAChD,YAAA,MAAM,MAAM,GAAW,CAAC,CAAC,OAAO,CAAC;AAC/B,kBAAE,CAAA,YAAA,EAAe,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA,CAAA;AACpD,kBAAE,CAAC,CAAC,OAAO,CAAC;AACV,sBAAE;sBACA,EAAE;YACR,MAAM,IAAI,GAAW,CAAA,EAAG,OAAO,CAAC,MAAM,GAAG,CAAA,EAAG,OAAO,CAAA,EAAA,CAAI,GAAG,EAAE,GAAG,CAAC,CAAC,IAAI,CAAA,CAAE;AACvE,YAAA,OAAO,KAAK,IAAI,CAAA,EAAG,MAAM,CAAA,EAAA,EAAK,CAAC,CAAC;iBAC7B,GAAG,CAAC,CAAC,GAAG,KAAK,CAAA,IAAA,EAAO,GAAG,CAAA,CAAE;AACzB,iBAAA,IAAI,CAAC,IAAI,CAAC,CAAA,CAAE;AACjB,QAAA,CAAC;aACA,IAAI,CAAC,MAAM,CAAC;QACf,OAAO,IAAI,gBAAgB,CAAC;YAC1B,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,CAAA,6BAAA,EAAgC,IAAI,CAAA,CAAE;AAChD,SAAA,CAAC;AACJ,IAAA,CAAC;IAED,MAAM,IAAI,GACR,CAAC,MAA0B,KAAK,CAAC,GAA2B,KAAI;QAC9D,IAAI,GAAG,KAAK,IAAI;YAAE,OAAO,MAAM,CAAC,IAAI;aAC/B,IAAI,OAAO,GAAG,KAAK,QAAQ;AAAE,YAAA,OAAO,CAAA,EAAG,MAAM,CAAC,IAAI,OAAO;AACzD,aAAA,IAAI,gBAAgB,CAAC,QAAQ,CAAC,GAAG,CAAC;AAAE,YAAA,OAAO,GAAG,MAAM,CAAC,IAAI,CAAA,CAAA,EAAI,GAAG,EAAE;AACvE,QAAA,OAAO,CAAA,EAAG,MAAM,CAAC,IAAI,CAAA,CAAA,EAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA,CAAA,CAAG;AACjD,IAAA,CAAC;AACL,CAAC,EAjDgB,gBAAgB,KAAhB,gBAAgB,GAAA,EAAA,CAAA,CAAA;;;;"}

package/lib/context/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./IProgrammerProps";
+export * from "./ITransformOptions";
+export * from "./ITypiaContext";
+export * from "./TransformerError";

package/lib/context/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./IProgrammerProps"), exports);
+__exportStar(require("./ITransformOptions"), exports);
+__exportStar(require("./ITypiaContext"), exports);
+__exportStar(require("./TransformerError"), exports);
+//# sourceMappingURL=index.js.map

package/lib/context/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/context/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qDAAmC;AACnC,sDAAoC;AACpC,kDAAgC;AAChC,qDAAmC"}

package/lib/context/index.mjs

@@ -0,0 +1,2 @@
+export { TransformerError } from './TransformerError.mjs';
+//# sourceMappingURL=index.mjs.map

package/lib/context/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/lib/factories/CommentFactory.d.ts

@@ -0,0 +1,13 @@
+import ts from "typescript";
+/**
+ * Factory for extracting JSDoc comments from TypeScript symbols.
+ *
+ * Extracts documentation comments and JSDoc tags from TypeScript AST symbols.
+ * Handles both legacy (TS < 5.2) and modern TypeScript versions.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export declare namespace CommentFactory {
+    const description: (symbol: ts.Symbol, includeTags?: boolean) => string | undefined;
+    const merge: (comments: ts.SymbolDisplayPart[]) => string;
+}

package/lib/factories/CommentFactory.js

@@ -0,0 +1,81 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommentFactory = void 0;
+const typescript_1 = __importDefault(require("typescript"));
+/**
+ * Factory for extracting JSDoc comments from TypeScript symbols.
+ *
+ * Extracts documentation comments and JSDoc tags from TypeScript AST symbols.
+ * Handles both legacy (TS < 5.2) and modern TypeScript versions.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+var CommentFactory;
+(function (CommentFactory) {
+    CommentFactory.description = (symbol, includeTags = false) => {
+        var _a, _b, _c;
+        const node = (_a = symbol.declarations) === null || _a === void 0 ? void 0 : _a[0];
+        if (!node)
+            return undefined;
+        // FOR LEGACY TS < 5.2
+        const [major, minor] = typescript_1.default.versionMajorMinor.split(".").map(Number);
+        if (major < 5 || (major === 5 && minor < 1)) {
+            const content = [];
+            const main = typescript_1.default.displayPartsToString(symbol.getDocumentationComment(undefined));
+            if (main.length) {
+                content.push(main);
+                if (includeTags && symbol.getJsDocTags().length)
+                    content.push("");
+            }
+            if (includeTags)
+                for (const tag of symbol.getJsDocTags()) {
+                    content.push(tag.text
+                        ? `@${tag.name} ${typescript_1.default.displayPartsToString(tag.text)}`
+                        : `@${tag.name}`);
+                }
+            return content.length
+                ? content.map((line) => line.split("\r\n").join("\n")).join("\n")
+                : undefined;
+        }
+        // NEW FEATURE OF TS 5.2
+        const elements = typescript_1.default.getJSDocCommentsAndTags(node);
+        if (elements.length === 0)
+            return undefined;
+        const content = [];
+        for (const comment of elements) {
+            if (typescript_1.default.isJSDoc(comment)) {
+                const parsed = typescript_1.default.getTextOfJSDocComment(comment.comment);
+                if (parsed === null || parsed === void 0 ? void 0 : parsed.length) {
+                    content.push(parsed);
+                    if (includeTags && ((_b = comment.tags) === null || _b === void 0 ? void 0 : _b.length))
+                        content.push("");
+                }
+                if (includeTags)
+                    for (const tag of (_c = comment.tags) !== null && _c !== void 0 ? _c : [])
+                        content.push(parseJSDocTag(tag));
+            }
+            else if (includeTags)
+                content.push(parseJSDocTag(comment));
+        }
+        const output = content
+            .map((line) => line.split("\r\n").join("\n"))
+            .join("\n");
+        return output.length ? output : undefined;
+    };
+    CommentFactory.merge = (comments) => comments
+        .map((part) => part.text)
+        .map((str) => str.split("\r\n").join("\n"))
+        .join("");
+})(CommentFactory || (exports.CommentFactory = CommentFactory = {}));
+const parseJSDocTag = (tag) => {
+    var _a;
+    const name = (_a = tag.name) === null || _a === void 0 ? void 0 : _a.getText();
+    const parsed = typescript_1.default.getTextOfJSDocComment(tag.comment);
+    return [`@${tag.tagName.text}`, name, parsed]
+        .filter((str) => !!(str === null || str === void 0 ? void 0 : str.length))
+        .join(" ");
+};
+//# sourceMappingURL=CommentFactory.js.map

package/lib/factories/CommentFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommentFactory.js","sourceRoot":"","sources":["../../src/factories/CommentFactory.ts"],"names":[],"mappings":"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"}