@typia/transform 12.0.0-dev.20260225

package/lib/FileTransformer.mjs

@@ -0,0 +1,103 @@
+import { ImportProgrammer } from '@typia/core';
+import { Singleton } from '@typia/utils';
+import ts from 'typescript';
+import { NodeTransformer } from './NodeTransformer.mjs';
+
+/**
+ * TypeScript source file transformer for typia.
+ *
+ * Entry point for typia's compile-time transformation. Traverses AST nodes,
+ * transforms `typia.*` function calls into optimized runtime code, and injects
+ * required imports. Skips declaration files.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+var FileTransformer;
+(function (FileTransformer) {
+    FileTransformer.transform = (environments) => (transformer) => (file) => {
+        if (file.isDeclarationFile)
+            return file;
+        const importer = new ImportProgrammer({
+            internalPrefix: "typia_transform_",
+            runtime: environments.options.runtime,
+        });
+        const context = {
+            ...environments,
+            transformer,
+            importer,
+        };
+        checkJsDocParsingMode.get(context, file);
+        file = ts.visitEachChild(file, (node) => iterate_node({
+            context,
+            node,
+        }), transformer);
+        const index = find_import_injection_index(file);
+        return ts.factory.updateSourceFile(file, [
+            ...file.statements.slice(0, index),
+            ...importer.toStatements(),
+            ...file.statements.slice(index),
+        ], false, file.referencedFiles, file.typeReferenceDirectives, file.hasNoDefaultLib, file.libReferenceDirectives);
+    };
+    const iterate_node = (props) => ts.visitEachChild(try_transform_node(props) ?? props.node, (node) => iterate_node({
+        context: props.context,
+        node,
+    }), props.context.transformer);
+    const try_transform_node = (props) => {
+        try {
+            return NodeTransformer.transform(props);
+        }
+        catch (exp) {
+            // ONLY ACCEPT TRANSFORMER-ERROR
+            if (!isTransformerError(exp))
+                throw exp;
+            // REPORT DIAGNOSTIC
+            const diagnostic = ts.createDiagnosticForNode(props.node, {
+                key: exp.code,
+                category: ts.DiagnosticCategory.Error,
+                message: exp.message,
+                code: `(${exp.code})`,
+            });
+            props.context.extras.addDiagnostic(diagnostic);
+            return null;
+        }
+    };
+    const find_import_injection_index = (file) => {
+        let i = 0;
+        for (; i < file.statements.length; ++i) {
+            const stmt = file.statements[i];
+            if (ts.isExpressionStatement(stmt) &&
+                ts.isStringLiteralLike(stmt.expression) &&
+                stmt.expression.text.startsWith("use "))
+                continue;
+            break;
+        }
+        return i;
+    };
+})(FileTransformer || (FileTransformer = {}));
+const isTransformerError = (error) => typeof error === "object" &&
+    error !== null &&
+    error.constructor.name === "TransformerError" &&
+    typeof error.code === "string" &&
+    typeof error.message === "string";
+const checkJsDocParsingMode = new Singleton((context, file) => {
+    if (typeof file.jsDocParsingMode === "number" &&
+        file.jsDocParsingMode !== 0) {
+        context.extras.addDiagnostic(ts.createDiagnosticForNode(file, {
+            code: `(typia setup)`,
+            key: "jsDocParsingMode",
+            category: ts.DiagnosticCategory.Warning,
+            message: [
+                `Run "npx typia setup" or "npx typia patch" command again.`,
+                ``,
+                `Since TypeScript v5.3 update, "tsc" no more parses JSDoc comments. Therefore, "typia" also cannot utilize those JSDoc comments too, and it damages on some features of "typia" like "comment tags" or "JSON schema" generator.`,
+                ``,
+                `To solve this problem, run "npx typia setup" or "npx typia patch" command to hack the TypeScript compiler to revive the JSDoc parsing feature.`,
+                ``,
+                `  - reference: https://github.com/microsoft/TypeScript/pull/55739`,
+            ].join("\n"),
+        }));
+    }
+});
+
+export { FileTransformer };
+//# sourceMappingURL=FileTransformer.mjs.map

package/lib/FileTransformer.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileTransformer.mjs","sources":["../src/FileTransformer.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/lib/ITransformProps.d.ts

@@ -0,0 +1,17 @@
+import { ITypiaContext } from "@typia/core";
+import ts from "typescript";
+/**
+ * Properties for individual typia function transformation.
+ *
+ * Passed to each transformer handler when processing a `typia.*()` call.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export interface ITransformProps {
+    /** Typia transformation context with type checker and utilities. */
+    context: ITypiaContext;
+    /** Module expression (e.g., `typia` in `typia.is<T>()`). */
+    modulo: ts.LeftHandSideExpression;
+    /** The original `typia.*<T>()` call expression being transformed. */
+    expression: ts.CallExpression;
+}

package/lib/ITransformProps.js

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

package/lib/ITransformProps.js.map

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

package/lib/ITransformProps.mjs

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

package/lib/ITransformProps.mjs.map

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

package/lib/ImportTransformer.d.ts

@@ -0,0 +1,16 @@
+import ts from "typescript";
+/**
+ * Transforms import paths for typia build output.
+ *
+ * Rewrites relative import paths when building typia packages. Also removes
+ * unused typia imports that only contained transformable function calls (since
+ * those are replaced at compile time).
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export declare namespace ImportTransformer {
+    const transform: (props: {
+        from: string;
+        to: string;
+    }) => (context: ts.TransformationContext) => (file: ts.SourceFile) => ts.SourceFile;
+}

package/lib/ImportTransformer.js

@@ -0,0 +1,176 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ImportTransformer = void 0;
+const path_1 = __importDefault(require("path"));
+const typescript_1 = __importDefault(require("typescript"));
+/**
+ * Transforms import paths for typia build output.
+ *
+ * Rewrites relative import paths when building typia packages. Also removes
+ * unused typia imports that only contained transformable function calls (since
+ * those are replaced at compile time).
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+var ImportTransformer;
+(function (ImportTransformer) {
+    ImportTransformer.transform = (props) => (context) => (file) => transform_file({
+        top: props.from,
+        to: props.to,
+        context,
+        file,
+    });
+    const transform_file = (props) => {
+        if (props.file.isDeclarationFile)
+            return props.file;
+        const from = get_directory_path(path_1.default.resolve(props.file.getSourceFile().fileName));
+        const to = from.replace(props.top, props.to);
+        // First pass: transform relative imports
+        let transformedFile = typescript_1.default.visitEachChild(props.file, (node) => transform_node({
+            top: props.top,
+            from,
+            to,
+            node,
+        }), props.context);
+        // Second pass: remove unused typia imports
+        transformedFile = removeUnusedTypiaImports(transformedFile);
+        return transformedFile;
+    };
+    const transform_node = (props) => {
+        if (!typescript_1.default.isImportDeclaration(props.node) ||
+            !typescript_1.default.isStringLiteral(props.node.moduleSpecifier))
+            return props.node;
+        const text = props.node.moduleSpecifier.text;
+        if (text[0] !== ".")
+            return props.node;
+        const location = path_1.default.resolve(props.from, text);
+        if (location.indexOf(props.top) === 0)
+            return props.node;
+        const replaced = (() => {
+            const simple = path_1.default
+                .relative(props.to, location)
+                .split(path_1.default.sep)
+                .join("/");
+            return simple[0] === "." ? simple : `./${simple}`;
+        })();
+        return typescript_1.default.factory.createImportDeclaration(undefined, props.node.importClause, typescript_1.default.factory.createStringLiteral(replaced), props.node.assertClause);
+    };
+})(ImportTransformer || (exports.ImportTransformer = ImportTransformer = {}));
+const get_directory_path = (file) => {
+    const split = path_1.default.resolve(file).split(path_1.default.sep);
+    split.pop();
+    return path_1.default.resolve(split.join(path_1.default.sep));
+};
+/** Remove unused typia imports that are only used in transformable calls */
+const removeUnusedTypiaImports = (file) => {
+    const imports = new Map();
+    for (const stmt of file.statements) {
+        if (typescript_1.default.isImportDeclaration(stmt) === false ||
+            typescript_1.default.isStringLiteral(stmt.moduleSpecifier) === false ||
+            stmt.moduleSpecifier.text !== "typia" ||
+            stmt.importClause === undefined)
+            continue;
+        // Track default import (import typia from 'typia')
+        if (stmt.importClause.name)
+            imports.set(stmt.importClause.name.text, {
+                declaration: stmt,
+                default: true,
+            });
+        // Track named imports (import { tags } from 'typia') - keep these
+        if (stmt.importClause.namedBindings &&
+            typescript_1.default.isNamedImports(stmt.importClause.namedBindings))
+            for (const element of stmt.importClause.namedBindings.elements)
+                imports.set(element.name.text, {
+                    declaration: stmt,
+                    default: false,
+                });
+    }
+    if (imports.size === 0)
+        return file; // No typia imports to check
+    // Find usage of typia identifiers that are NOT transformable calls
+    const nonTransformableUsage = new Set();
+    const checkUsage = (node) => {
+        if (typescript_1.default.isIdentifier(node) && imports.has(node.text)) {
+            const identifier = node.text;
+            // Check if this identifier is being used as part of a property access
+            if (node.parent &&
+                typescript_1.default.isPropertyAccessExpression(node.parent) &&
+                node.parent.expression === node) {
+                // This is typia.something - check if it's a transformable call pattern
+                if (!isLikelyTransformableCall(node.parent))
+                    nonTransformableUsage.add(identifier);
+            }
+            else
+                // Direct usage of the typia identifier (not as property access)
+                // This is definitely non-transformable usage
+                nonTransformableUsage.add(identifier);
+        }
+        typescript_1.default.forEachChild(node, checkUsage);
+    };
+    // Check all statements except import declarations
+    for (const stmt of file.statements)
+        if (!typescript_1.default.isImportDeclaration(stmt) ||
+            !typescript_1.default.isStringLiteral(stmt.moduleSpecifier) ||
+            stmt.moduleSpecifier.text !== "typia")
+            checkUsage(stmt);
+    // Update import statements
+    const newStatements = file.statements
+        .map((stmt) => {
+        if (typescript_1.default.isImportDeclaration(stmt) &&
+            typescript_1.default.isStringLiteral(stmt.moduleSpecifier) &&
+            stmt.moduleSpecifier.text === "typia" &&
+            stmt.importClause) {
+            const newImportClause = filterTypiaImportClause(stmt.importClause, nonTransformableUsage);
+            if (newImportClause)
+                return typescript_1.default.factory.createImportDeclaration(stmt.modifiers, newImportClause, stmt.moduleSpecifier, stmt.attributes);
+            return null; // Skip adding the import if all imports are unused
+        }
+        return stmt;
+    })
+        .filter((stmt) => stmt !== null);
+    return typescript_1.default.factory.updateSourceFile(file, newStatements, file.isDeclarationFile, file.referencedFiles, file.typeReferenceDirectives, file.hasNoDefaultLib, file.libReferenceDirectives);
+};
+/**
+ * Check if a property access expression looks like a transformable typia call
+ * This uses heuristics to detect patterns like typia.xxx(),
+ * typia.namespace.xxx()
+ */
+const isLikelyTransformableCall = (node) => {
+    // Check if this is eventually part of a call expression
+    let current = node;
+    // Walk up the chain to find if this leads to a call expression
+    // Handle patterns like: typia.xxx(), typia.namespace.xxx()
+    while (typescript_1.default.isPropertyAccessExpression(current)) {
+        current = current.parent;
+    }
+    // If the final result is a call expression, this is likely transformable
+    if (typescript_1.default.isCallExpression(current) &&
+        (current.expression === node ||
+            (typescript_1.default.isPropertyAccessExpression(current.expression) &&
+                isTypiaPropertyChain(current.expression)))) {
+        return true;
+    }
+    return false;
+};
+/** Check if a property access expression is part of a typia.xxx.yyy chain */
+const isTypiaPropertyChain = (node) => {
+    let current = node;
+    while (typescript_1.default.isPropertyAccessExpression(current)) {
+        current = current.expression;
+    }
+    return typescript_1.default.isIdentifier(current) && current.text === "typia";
+};
+/** Filter import clause to remove unused default imports */
+const filterTypiaImportClause = (importClause, usedImports) => {
+    const hasDefaultImport = importClause.name && usedImports.has(importClause.name.text);
+    const namedBindings = importClause.namedBindings; // Always keep named bindings like { tags }
+    // Return undefined if no imports are used
+    if (!hasDefaultImport && !namedBindings) {
+        return undefined;
+    }
+    return typescript_1.default.factory.createImportClause(importClause.isTypeOnly, hasDefaultImport ? importClause.name : undefined, namedBindings);
+};
+//# sourceMappingURL=ImportTransformer.js.map

package/lib/ImportTransformer.js.map

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

package/lib/ImportTransformer.mjs

@@ -0,0 +1,173 @@
+import path from 'path';
+import ts from 'typescript';
+
+/**
+ * Transforms import paths for typia build output.
+ *
+ * Rewrites relative import paths when building typia packages. Also removes
+ * unused typia imports that only contained transformable function calls (since
+ * those are replaced at compile time).
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+var ImportTransformer;
+(function (ImportTransformer) {
+    ImportTransformer.transform = (props) => (context) => (file) => transform_file({
+        top: props.from,
+        to: props.to,
+        context,
+        file,
+    });
+    const transform_file = (props) => {
+        if (props.file.isDeclarationFile)
+            return props.file;
+        const from = get_directory_path(path.resolve(props.file.getSourceFile().fileName));
+        const to = from.replace(props.top, props.to);
+        // First pass: transform relative imports
+        let transformedFile = ts.visitEachChild(props.file, (node) => transform_node({
+            top: props.top,
+            from,
+            to,
+            node,
+        }), props.context);
+        // Second pass: remove unused typia imports
+        transformedFile = removeUnusedTypiaImports(transformedFile);
+        return transformedFile;
+    };
+    const transform_node = (props) => {
+        if (!ts.isImportDeclaration(props.node) ||
+            !ts.isStringLiteral(props.node.moduleSpecifier))
+            return props.node;
+        const text = props.node.moduleSpecifier.text;
+        if (text[0] !== ".")
+            return props.node;
+        const location = path.resolve(props.from, text);
+        if (location.indexOf(props.top) === 0)
+            return props.node;
+        const replaced = (() => {
+            const simple = path
+                .relative(props.to, location)
+                .split(path.sep)
+                .join("/");
+            return simple[0] === "." ? simple : `./${simple}`;
+        })();
+        return ts.factory.createImportDeclaration(undefined, props.node.importClause, ts.factory.createStringLiteral(replaced), props.node.assertClause);
+    };
+})(ImportTransformer || (ImportTransformer = {}));
+const get_directory_path = (file) => {
+    const split = path.resolve(file).split(path.sep);
+    split.pop();
+    return path.resolve(split.join(path.sep));
+};
+/** Remove unused typia imports that are only used in transformable calls */
+const removeUnusedTypiaImports = (file) => {
+    const imports = new Map();
+    for (const stmt of file.statements) {
+        if (ts.isImportDeclaration(stmt) === false ||
+            ts.isStringLiteral(stmt.moduleSpecifier) === false ||
+            stmt.moduleSpecifier.text !== "typia" ||
+            stmt.importClause === undefined)
+            continue;
+        // Track default import (import typia from 'typia')
+        if (stmt.importClause.name)
+            imports.set(stmt.importClause.name.text, {
+                declaration: stmt,
+                default: true,
+            });
+        // Track named imports (import { tags } from 'typia') - keep these
+        if (stmt.importClause.namedBindings &&
+            ts.isNamedImports(stmt.importClause.namedBindings))
+            for (const element of stmt.importClause.namedBindings.elements)
+                imports.set(element.name.text, {
+                    declaration: stmt,
+                    default: false,
+                });
+    }
+    if (imports.size === 0)
+        return file; // No typia imports to check
+    // Find usage of typia identifiers that are NOT transformable calls
+    const nonTransformableUsage = new Set();
+    const checkUsage = (node) => {
+        if (ts.isIdentifier(node) && imports.has(node.text)) {
+            const identifier = node.text;
+            // Check if this identifier is being used as part of a property access
+            if (node.parent &&
+                ts.isPropertyAccessExpression(node.parent) &&
+                node.parent.expression === node) {
+                // This is typia.something - check if it's a transformable call pattern
+                if (!isLikelyTransformableCall(node.parent))
+                    nonTransformableUsage.add(identifier);
+            }
+            else
+                // Direct usage of the typia identifier (not as property access)
+                // This is definitely non-transformable usage
+                nonTransformableUsage.add(identifier);
+        }
+        ts.forEachChild(node, checkUsage);
+    };
+    // Check all statements except import declarations
+    for (const stmt of file.statements)
+        if (!ts.isImportDeclaration(stmt) ||
+            !ts.isStringLiteral(stmt.moduleSpecifier) ||
+            stmt.moduleSpecifier.text !== "typia")
+            checkUsage(stmt);
+    // Update import statements
+    const newStatements = file.statements
+        .map((stmt) => {
+        if (ts.isImportDeclaration(stmt) &&
+            ts.isStringLiteral(stmt.moduleSpecifier) &&
+            stmt.moduleSpecifier.text === "typia" &&
+            stmt.importClause) {
+            const newImportClause = filterTypiaImportClause(stmt.importClause, nonTransformableUsage);
+            if (newImportClause)
+                return ts.factory.createImportDeclaration(stmt.modifiers, newImportClause, stmt.moduleSpecifier, stmt.attributes);
+            return null; // Skip adding the import if all imports are unused
+        }
+        return stmt;
+    })
+        .filter((stmt) => stmt !== null);
+    return ts.factory.updateSourceFile(file, newStatements, file.isDeclarationFile, file.referencedFiles, file.typeReferenceDirectives, file.hasNoDefaultLib, file.libReferenceDirectives);
+};
+/**
+ * Check if a property access expression looks like a transformable typia call
+ * This uses heuristics to detect patterns like typia.xxx(),
+ * typia.namespace.xxx()
+ */
+const isLikelyTransformableCall = (node) => {
+    // Check if this is eventually part of a call expression
+    let current = node;
+    // Walk up the chain to find if this leads to a call expression
+    // Handle patterns like: typia.xxx(), typia.namespace.xxx()
+    while (ts.isPropertyAccessExpression(current)) {
+        current = current.parent;
+    }
+    // If the final result is a call expression, this is likely transformable
+    if (ts.isCallExpression(current) &&
+        (current.expression === node ||
+            (ts.isPropertyAccessExpression(current.expression) &&
+                isTypiaPropertyChain(current.expression)))) {
+        return true;
+    }
+    return false;
+};
+/** Check if a property access expression is part of a typia.xxx.yyy chain */
+const isTypiaPropertyChain = (node) => {
+    let current = node;
+    while (ts.isPropertyAccessExpression(current)) {
+        current = current.expression;
+    }
+    return ts.isIdentifier(current) && current.text === "typia";
+};
+/** Filter import clause to remove unused default imports */
+const filterTypiaImportClause = (importClause, usedImports) => {
+    const hasDefaultImport = importClause.name && usedImports.has(importClause.name.text);
+    const namedBindings = importClause.namedBindings; // Always keep named bindings like { tags }
+    // Return undefined if no imports are used
+    if (!hasDefaultImport && !namedBindings) {
+        return undefined;
+    }
+    return ts.factory.createImportClause(importClause.isTypeOnly, hasDefaultImport ? importClause.name : undefined, namedBindings);
+};
+
+export { ImportTransformer };
+//# sourceMappingURL=ImportTransformer.mjs.map

package/lib/ImportTransformer.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImportTransformer.mjs","sources":["../src/ImportTransformer.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/lib/NodeTransformer.d.ts

@@ -0,0 +1,16 @@
+import { ITypiaContext } from "@typia/core";
+import ts from "typescript";
+/**
+ * TypeScript AST node transformer.
+ *
+ * Delegates call expression nodes to {@link CallExpressionTransformer} for
+ * potential `typia.*` function transformation. Non-call nodes pass through.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export declare namespace NodeTransformer {
+    const transform: (props: {
+        context: ITypiaContext;
+        node: ts.Node;
+    }) => ts.Node | null;
+}

package/lib/NodeTransformer.js

@@ -0,0 +1,26 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodeTransformer = void 0;
+const typescript_1 = __importDefault(require("typescript"));
+const CallExpressionTransformer_1 = require("./CallExpressionTransformer");
+/**
+ * TypeScript AST node transformer.
+ *
+ * Delegates call expression nodes to {@link CallExpressionTransformer} for
+ * potential `typia.*` function transformation. Non-call nodes pass through.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+var NodeTransformer;
+(function (NodeTransformer) {
+    NodeTransformer.transform = (props) => typescript_1.default.isCallExpression(props.node) && props.node.parent
+        ? CallExpressionTransformer_1.CallExpressionTransformer.transform({
+            context: props.context,
+            expression: props.node,
+        })
+        : props.node;
+})(NodeTransformer || (exports.NodeTransformer = NodeTransformer = {}));
+//# sourceMappingURL=NodeTransformer.js.map

package/lib/NodeTransformer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeTransformer.js","sourceRoot":"","sources":["../src/NodeTransformer.ts"],"names":[],"mappings":";;;;;;AACA,4DAA4B;AAE5B,2EAAwE;AAExE;;;;;;;GAOG;AACH,IAAiB,eAAe,CAW/B;AAXD,WAAiB,eAAe;IACjB,yBAAS,GAAG,CAAC,KAGzB,EAAkB,EAAE,CACnB,oBAAE,CAAC,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM;QAClD,CAAC,CAAC,qDAAyB,CAAC,SAAS,CAAC;YAClC,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,UAAU,EAAE,KAAK,CAAC,IAAI;SACvB,CAAC;QACJ,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;AACnB,CAAC,EAXgB,eAAe,+BAAf,eAAe,QAW/B"}

package/lib/NodeTransformer.mjs

@@ -0,0 +1,23 @@
+import ts from 'typescript';
+import { CallExpressionTransformer } from './CallExpressionTransformer.mjs';
+
+/**
+ * TypeScript AST node transformer.
+ *
+ * Delegates call expression nodes to {@link CallExpressionTransformer} for
+ * potential `typia.*` function transformation. Non-call nodes pass through.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+var NodeTransformer;
+(function (NodeTransformer) {
+    NodeTransformer.transform = (props) => ts.isCallExpression(props.node) && props.node.parent
+        ? CallExpressionTransformer.transform({
+            context: props.context,
+            expression: props.node,
+        })
+        : props.node;
+})(NodeTransformer || (NodeTransformer = {}));
+
+export { NodeTransformer };
+//# sourceMappingURL=NodeTransformer.mjs.map

package/lib/NodeTransformer.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeTransformer.mjs","sources":["../src/NodeTransformer.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAKA;;;;;;;AAOG;AACG,IAAW;AAAjB,CAAA,UAAiB,eAAe,EAAA;AACjB,IAAA,eAAA,CAAA,SAAS,GAAG,CAAC,KAGzB,KACC,EAAE,CAAC,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC;AAC5C,UAAE,yBAAyB,CAAC,SAAS,CAAC;YAClC,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,UAAU,EAAE,KAAK,CAAC,IAAI;SACvB;AACH,UAAE,KAAK,CAAC,IAAI;AAClB,CAAC,EAXgB,eAAe,KAAf,eAAe,GAAA,EAAA,CAAA,CAAA;;;;"}

package/lib/TransformerError.d.ts

@@ -0,0 +1,42 @@
+import { MetadataFactory } from "@typia/core";
+/**
+ * Error thrown during typia transformation.
+ *
+ * `TransformerError` is thrown when `typia.*<T>()` receives unsupported types
+ * or invalid configurations at compile time. The error message details which
+ * types failed and why.
+ *
+ * Common causes:
+ *
+ * - Tuples in LLM schema (not supported by most LLMs)
+ * - Recursive types without `$ref` support
+ * - `any` types without explicit handling
+ * - Native classes not serializable to JSON
+ *
+ * Use {@link from} to create from {@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 identifying the error type. */
+        code: string;
+        /** Human-readable 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;
+}