@nestia/sdk 12.0.0-dev.20260601.1 → 12.0.0-dev.20260612.2

package/lib/generates/internal/SwaggerReadonlyArrayEmender.js

@@ -0,0 +1,174 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SwaggerReadonlyArrayEmender = void 0;
+var SwaggerReadonlyArrayEmender;
+(function (SwaggerReadonlyArrayEmender) {
+    SwaggerReadonlyArrayEmender.emend = (props) => {
+        const visited = {
+            aliases: new WeakSet(),
+            arrays: new WeakSet(),
+            objects: new WeakSet(),
+            schemas: new WeakSet(),
+            tuples: new WeakSet(),
+        };
+        visitMetadata({
+            components: props.components,
+            schema: props.schema,
+            metadata: props.metadata,
+            visited,
+        });
+    };
+})(SwaggerReadonlyArrayEmender || (exports.SwaggerReadonlyArrayEmender = SwaggerReadonlyArrayEmender = {}));
+const visitMetadata = (props) => {
+    if (props.schema !== undefined && isReadonlyArrayLike(props.metadata))
+        setReadonlyArray(props.schema);
+    if (props.visited.schemas.has(props.metadata))
+        return;
+    props.visited.schemas.add(props.metadata);
+    for (const array of props.metadata.arrays) {
+        const type = array.type;
+        if (type !== undefined)
+            visitArrayType({
+                components: props.components,
+                schema: arraySchema(props.schema),
+                type,
+                visited: props.visited,
+            });
+    }
+    for (const tuple of props.metadata.tuples) {
+        const type = tuple.type;
+        if (type !== undefined)
+            visitTupleType({
+                components: props.components,
+                schema: props.schema,
+                type,
+                visited: props.visited,
+            });
+    }
+    for (const alias of props.metadata.aliases) {
+        const type = alias.type;
+        if (type !== undefined)
+            visitAliasType({
+                components: props.components,
+                schema: componentSchema(props.components, type.name),
+                type,
+                visited: props.visited,
+            });
+    }
+    for (const object of props.metadata.objects) {
+        const type = object.type;
+        if (type !== undefined)
+            visitObjectType({
+                components: props.components,
+                type,
+                visited: props.visited,
+            });
+    }
+};
+const visitAliasType = (props) => {
+    if (props.visited.aliases.has(props.type))
+        return;
+    props.visited.aliases.add(props.type);
+    if (props.schema !== undefined && isReadonlyArrayLike(props.type.value))
+        setReadonlyArray(props.schema);
+    visitMetadata({
+        components: props.components,
+        schema: props.schema,
+        metadata: props.type.value,
+        visited: props.visited,
+    });
+};
+const visitArrayType = (props) => {
+    var _a;
+    if (props.visited.arrays.has(props.type))
+        return;
+    props.visited.arrays.add(props.type);
+    const component = componentSchema(props.components, props.type.name);
+    if (component !== undefined && isReadonlyArrayName(props.type.name))
+        setReadonlyArray(component);
+    visitMetadata({
+        components: props.components,
+        schema: arraySchema((_a = props.schema) !== null && _a !== void 0 ? _a : component),
+        metadata: props.type.value,
+        visited: props.visited,
+    });
+};
+const visitTupleType = (props) => {
+    var _a;
+    if (props.visited.tuples.has(props.type))
+        return;
+    props.visited.tuples.add(props.type);
+    const component = componentSchema(props.components, props.type.name);
+    if (component !== undefined && isReadonlyArrayName(props.type.name))
+        setReadonlyArray(component);
+    const schema = objectSchema((_a = props.schema) !== null && _a !== void 0 ? _a : component);
+    props.type.elements.forEach((metadata, index) => visitMetadata({
+        components: props.components,
+        schema: Array.isArray(schema === null || schema === void 0 ? void 0 : schema.prefixItems)
+            ? schema.prefixItems[index]
+            : undefined,
+        metadata,
+        visited: props.visited,
+    }));
+};
+const visitObjectType = (props) => {
+    if (props.visited.objects.has(props.type))
+        return;
+    props.visited.objects.add(props.type);
+    const schema = objectSchema(componentSchema(props.components, props.type.name));
+    const properties = schema === null || schema === void 0 ? void 0 : schema.properties;
+    for (const property of props.type.properties) {
+        const key = propertyKey(property.key);
+        const child = key === undefined ? undefined : properties === null || properties === void 0 ? void 0 : properties[key];
+        visitMetadata({
+            components: props.components,
+            schema: child,
+            metadata: property.value,
+            visited: props.visited,
+        });
+    }
+};
+const isReadonlyArrayLike = (metadata, visited = new WeakSet()) => {
+    if (visited.has(metadata))
+        return false;
+    visited.add(metadata);
+    const name = metadata.name;
+    return ((typeof name === "string" && isReadonlyArrayName(name)) ||
+        metadata.arrays.some((array) => isReadonlyArrayName(array.name)) ||
+        metadata.tuples.some((tuple) => isReadonlyArrayName(tuple.name)) ||
+        metadata.aliases.some((alias) => {
+            const type = alias.type;
+            return type !== undefined && isReadonlyArrayLike(type.value, visited);
+        }));
+};
+const isReadonlyArrayName = (name) => {
+    const trimmed = name.trim();
+    const compact = name.replace(/\s+/g, "");
+    return (compact === "ReadonlyArray" ||
+        compact.startsWith("ReadonlyArray<") ||
+        compact.startsWith("readonly[") ||
+        trimmed.startsWith("readonly "));
+};
+const componentSchema = (components, name) => { var _a; return ((_a = components.schemas) !== null && _a !== void 0 ? _a : {})[name]; };
+const arraySchema = (schema) => {
+    const obj = objectSchema(schema);
+    return obj === null || obj === void 0 ? void 0 : obj.items;
+};
+const objectSchema = (schema) => typeof schema === "object" && schema !== null
+    ? schema
+    : undefined;
+const propertyKey = (metadata) => {
+    var _a, _b;
+    const value = (_b = (_a = metadata.constants[0]) === null || _a === void 0 ? void 0 : _a.values[0]) === null || _b === void 0 ? void 0 : _b.value;
+    return typeof value === "string"
+        ? value
+        : typeof value === "number"
+            ? String(value)
+            : undefined;
+};
+const setReadonlyArray = (schema) => {
+    const obj = objectSchema(schema);
+    if (obj !== undefined)
+        obj["x-readonly-array"] = true;
+};
+//# sourceMappingURL=SwaggerReadonlyArrayEmender.js.map

package/lib/generates/internal/SwaggerReadonlyArrayEmender.js.map

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

package/lib/structures/INestiaSdkInput.d.ts

@@ -1,9 +1,10 @@
-import { RouteInfo, VersionValue } from "@nestjs/common/interfaces";
+import { RequestMethod } from "@nestjs/common";
+import { VersionValue } from "@nestjs/common/interfaces";
 export interface INestiaSdkInput {
     controllers: INestiaSdkInput.IController[];
     globalPrefix?: {
         prefix: string;
-        exclude?: Array<string | RouteInfo>;
+        exclude?: INestiaSdkInput.IGlobalPrefixExclude[];
     };
     versioning?: {
         prefix: string;
@@ -16,4 +17,10 @@ export declare namespace INestiaSdkInput {
         location: string;
         prefixes: string[];
     }
+    interface IGlobalPrefixExclude {
+        path: string;
+        method?: RequestMethod;
+        requestMethod?: RequestMethod;
+        pathRegex?: RegExp;
+    }
 }

package/lib/structures/IReflectController.d.ts

@@ -1,5 +1,6 @@
 import type { VERSION_NEUTRAL } from "@nestjs/common/interfaces";
 import { IReflectHttpOperation } from "./IReflectHttpOperation";
+import { IReflectMcpOperation } from "./IReflectMcpOperation";
 import { IReflectWebSocketOperation } from "./IReflectWebSocketOperation";
 export interface IReflectController {
     class: Function;
@@ -7,7 +8,7 @@ export interface IReflectController {
     paths: string[];
     file: string;
     versions: Array<string | typeof VERSION_NEUTRAL> | undefined;
-    operations: Array<IReflectHttpOperation | IReflectWebSocketOperation>;
+    operations: Array<IReflectHttpOperation | IReflectWebSocketOperation | IReflectMcpOperation>;
     security: Record<string, string[]>[];
     tags: string[];
 }

package/lib/structures/IReflectHttpOperationSuccess.d.ts

@@ -1,10 +1,12 @@
-import { MetadataFactory } from "../internal/legacy";
 import { IMetadataComponents, IMetadataSchema } from "@typia/interface";
+import { MetadataFactory } from "../internal/legacy";
+import { HttpResponseContentTypeUtil } from "../utils/HttpResponseContentTypeUtil";
 import { IReflectType } from "./IReflectType";
 export interface IReflectHttpOperationSuccess {
     type: IReflectType;
     status: number;
-    contentType: "application/json" | "text/plain" | "application/x-www-form-urlencoded" | "application/json" | null;
+    contentType: HttpResponseContentTypeUtil.Response;
+    binary: boolean;
     encrypted: boolean;
     components: IMetadataComponents;
     metadata: IMetadataSchema;

package/lib/structures/IReflectMcpOperation.d.ts

@@ -0,0 +1,35 @@
+import ts from "typescript";
+import { IReflectImport } from "./IReflectImport";
+import { IReflectMcpOperationParameter } from "./IReflectMcpOperationParameter";
+import { IReflectType } from "./IReflectType";
+/**
+ * Reflected operation metadata for a method decorated with `@McpRoute`.
+ *
+ * Produced by {@link ReflectMcpOperationAnalyzer.analyze}; consumed by
+ * {@link TypedMcpRouteAnalyzer.analyze} to produce the final
+ * {@link ITypedMcpRoute}.
+ */
+export interface IReflectMcpOperation {
+    protocol: "mcp";
+    name: string;
+    toolName: string;
+    title: string | null;
+    toolDescription: string | null;
+    inputSchema: object;
+    outputSchema: object | null;
+    annotations: IReflectMcpOperation.IAnnotations | null;
+    function: Function;
+    parameters: IReflectMcpOperationParameter[];
+    returnType: IReflectType | null;
+    imports: IReflectImport[];
+    description: string | null;
+    jsDocTags: ts.JSDocTagInfo[];
+}
+export declare namespace IReflectMcpOperation {
+    interface IAnnotations {
+        readOnlyHint?: boolean;
+        destructiveHint?: boolean;
+        idempotentHint?: boolean;
+        openWorldHint?: boolean;
+    }
+}

package/lib/structures/IReflectMcpOperation.js

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

package/lib/structures/IReflectMcpOperation.js.map

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

package/lib/structures/IReflectMcpOperationParameter.d.ts

@@ -0,0 +1,19 @@
+import { IJsDocTagInfo } from "typia";
+import { IReflectImport } from "./IReflectImport";
+import { IReflectType } from "./IReflectType";
+/**
+ * Parameter descriptor for an MCP tool method. Reflected from
+ * `"nestia/McpRoute/Parameters"` metadata plus compile-time type information
+ * collected by the nestia transformer.
+ */
+export interface IReflectMcpOperationParameter {
+    category: "params";
+    name: string;
+    index: number;
+    type: IReflectType;
+    imports: IReflectImport[];
+    description: string | null;
+    jsDocTags: IJsDocTagInfo[];
+}
+export declare namespace IReflectMcpOperationParameter {
+}

package/lib/structures/IReflectMcpOperationParameter.js

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

package/lib/structures/IReflectMcpOperationParameter.js.map

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

package/lib/structures/ITypedApplication.d.ts

@@ -1,9 +1,10 @@
 import { IMetadataDictionary } from "../internal/legacy";
 import { INestiaProject } from "./INestiaProject";
 import { ITypedHttpRoute } from "./ITypedHttpRoute";
+import { ITypedMcpRoute } from "./ITypedMcpRoute";
 import { ITypedWebSocketRoute } from "./ITypedWebSocketRoute";
 export interface ITypedApplication {
     project: INestiaProject;
     collection: IMetadataDictionary;
-    routes: Array<ITypedHttpRoute | ITypedWebSocketRoute>;
+    routes: Array<ITypedHttpRoute | ITypedWebSocketRoute | ITypedMcpRoute>;
 }

package/lib/structures/ITypedHttpRouteSuccess.d.ts

@@ -1,9 +1,11 @@
 import { MetadataSchema } from "../internal/legacy";
+import { HttpResponseContentTypeUtil } from "../utils/HttpResponseContentTypeUtil";
 import { IReflectType } from "./IReflectType";
 export interface ITypedHttpRouteSuccess {
     type: IReflectType;
     status: number | null;
-    contentType: "application/json" | "text/plain" | "application/x-www-form-urlencoded" | "application/json" | null;
+    contentType: HttpResponseContentTypeUtil.Response;
+    binary: boolean;
     encrypted: boolean;
     metadata: MetadataSchema;
     example?: any;

package/lib/structures/ITypedMcpRoute.d.ts

@@ -0,0 +1,31 @@
+import ts from "typescript";
+import { IReflectController } from "./IReflectController";
+import { IReflectImport } from "./IReflectImport";
+import { IReflectMcpOperation } from "./IReflectMcpOperation";
+import { IReflectMcpOperationParameter } from "./IReflectMcpOperationParameter";
+import { IReflectType } from "./IReflectType";
+/**
+ * Final typed representation of an MCP tool route.
+ *
+ * Carries everything the SDK generator needs to emit a typed client function:
+ * the controller reference, accessor path, typia-derived input schema, and
+ * input/output type info.
+ */
+export interface ITypedMcpRoute {
+    protocol: "mcp";
+    controller: IReflectController;
+    name: string;
+    toolName: string;
+    title: string | null;
+    toolDescription: string | null;
+    accessor: string[];
+    function: Function;
+    input: IReflectMcpOperationParameter | null;
+    returnType: IReflectType | null;
+    inputSchema: object;
+    outputSchema: object | null;
+    annotations: IReflectMcpOperation.IAnnotations | null;
+    imports: IReflectImport[];
+    description: string | null;
+    jsDocTags: ts.JSDocTagInfo[];
+}

package/lib/structures/ITypedMcpRoute.js

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

package/lib/structures/ITypedMcpRoute.js.map

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

package/lib/utils/HttpResponseContentTypeUtil.d.ts

@@ -0,0 +1,5 @@
+export declare namespace HttpResponseContentTypeUtil {
+    type Response = "application/json" | "text/plain" | "application/x-www-form-urlencoded" | (string & {}) | null;
+    const isSupported: (input: string | null) => input is Response;
+    const isBinary: (input: string | null | undefined) => input is string;
+}

package/lib/utils/HttpResponseContentTypeUtil.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpResponseContentTypeUtil = void 0;
+var HttpResponseContentTypeUtil;
+(function (HttpResponseContentTypeUtil) {
+    HttpResponseContentTypeUtil.isSupported = (input) => input === null ||
+        input === "application/json" ||
+        input === "text/plain" ||
+        input === "application/x-www-form-urlencoded" ||
+        HttpResponseContentTypeUtil.isBinary(input);
+    HttpResponseContentTypeUtil.isBinary = (input) => {
+        if (typeof input !== "string")
+            return false;
+        const value = input.split(";")[0].trim().toLowerCase();
+        return (value.startsWith("image/") ||
+            value.startsWith("video/") ||
+            value.startsWith("audio/") ||
+            value === "application/octet-stream" ||
+            value === "application/pdf");
+    };
+})(HttpResponseContentTypeUtil || (exports.HttpResponseContentTypeUtil = HttpResponseContentTypeUtil = {}));
+//# sourceMappingURL=HttpResponseContentTypeUtil.js.map

package/lib/utils/HttpResponseContentTypeUtil.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpResponseContentTypeUtil.js","sourceRoot":"","sources":["../../src/utils/HttpResponseContentTypeUtil.ts"],"names":[],"mappings":";;;AAAA,IAAiB,2BAA2B,CA6B3C;AA7BD,WAAiB,2BAA2B;IAQ7B,uCAAW,GAAG,CAAC,KAAoB,EAAqB,EAAE,CACrE,KAAK,KAAK,IAAI;QACd,KAAK,KAAK,kBAAkB;QAC5B,KAAK,KAAK,YAAY;QACtB,KAAK,KAAK,mCAAmC;QAC7C,oCAAQ,CAAC,KAAK,CAAC,CAAC;IAEL,oCAAQ,GAAG,CACtB,KAAgC,EACf,EAAE;QACnB,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QAE5C,MAAM,KAAK,GAAW,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAChE,OAAO,CACL,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC;YAC1B,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC;YAC1B,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC;YAC1B,KAAK,KAAK,0BAA0B;YACpC,KAAK,KAAK,iBAAiB,CAC5B,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC,EA7BgB,2BAA2B,aAA3B,2BAA2B,GAA3B,2BAA2B,QA6B3C"}

package/native/go.mod

@@ -1,52 +1,52 @@
-module github.com/samchon/nestia/packages/sdk/native
-
-go 1.26
-
-require (
-	github.com/microsoft/typescript-go/shim/ast v0.0.0
-	github.com/microsoft/typescript-go/shim/checker v0.0.0
-	github.com/microsoft/typescript-go/shim/scanner v0.0.0
-	github.com/samchon/nestia/packages/core/native v0.0.0
-	github.com/samchon/ttsc/packages/ttsc v0.0.0
-	github.com/samchon/typia/packages/typia/native v0.0.0-20260520144235-368b47d0ea16
-)
-
-require (
-	github.com/go-json-experiment/json v0.0.0-20260214004413-d219187c3433 // indirect
-	github.com/klauspost/cpuid/v2 v2.2.10 // indirect
-	github.com/microsoft/typescript-go v0.0.0-20260429010842-56ab4af42157 // indirect
-	github.com/microsoft/typescript-go/shim/bundled v0.0.0 // indirect
-	github.com/microsoft/typescript-go/shim/compiler v0.0.0 // indirect
-	github.com/microsoft/typescript-go/shim/core v0.0.0 // indirect
-	github.com/microsoft/typescript-go/shim/diagnosticwriter v0.0.0 // indirect
-	github.com/microsoft/typescript-go/shim/parser v0.0.0 // indirect
-	github.com/microsoft/typescript-go/shim/printer v0.0.0 // indirect
-	github.com/microsoft/typescript-go/shim/tsoptions v0.0.0 // indirect
-	github.com/microsoft/typescript-go/shim/tspath v0.0.0 // indirect
-	github.com/microsoft/typescript-go/shim/vfs v0.0.0 // indirect
-	github.com/microsoft/typescript-go/shim/vfs/cachedvfs v0.0.0 // indirect
-	github.com/microsoft/typescript-go/shim/vfs/osvfs v0.0.0 // indirect
-	github.com/zeebo/xxh3 v1.1.0 // indirect
-	golang.org/x/sync v0.20.0 // indirect
-	golang.org/x/sys v0.43.0 // indirect
-	golang.org/x/text v0.36.0 // indirect
-)
-
-replace (
-	github.com/microsoft/typescript-go/shim/ast => github.com/samchon/ttsc/packages/ttsc/shim/ast v0.0.0-20260519112110-ec1cdf69c509
-	github.com/microsoft/typescript-go/shim/bundled => github.com/samchon/ttsc/packages/ttsc/shim/bundled v0.0.0-20260519112110-ec1cdf69c509
-	github.com/microsoft/typescript-go/shim/checker => github.com/samchon/ttsc/packages/ttsc/shim/checker v0.0.0-20260519112110-ec1cdf69c509
-	github.com/microsoft/typescript-go/shim/compiler => github.com/samchon/ttsc/packages/ttsc/shim/compiler v0.0.0-20260519112110-ec1cdf69c509
-	github.com/microsoft/typescript-go/shim/core => github.com/samchon/ttsc/packages/ttsc/shim/core v0.0.0-20260519112110-ec1cdf69c509
-	github.com/microsoft/typescript-go/shim/diagnosticwriter => github.com/samchon/ttsc/packages/ttsc/shim/diagnosticwriter v0.0.0-20260519112110-ec1cdf69c509
-	github.com/microsoft/typescript-go/shim/parser => github.com/samchon/ttsc/packages/ttsc/shim/parser v0.0.0-20260519112110-ec1cdf69c509
-	github.com/microsoft/typescript-go/shim/printer => github.com/samchon/ttsc/packages/ttsc/shim/printer v0.0.0-20260519112110-ec1cdf69c509
-	github.com/microsoft/typescript-go/shim/scanner => github.com/samchon/ttsc/packages/ttsc/shim/scanner v0.0.0-20260519112110-ec1cdf69c509
-	github.com/microsoft/typescript-go/shim/tsoptions => github.com/samchon/ttsc/packages/ttsc/shim/tsoptions v0.0.0-20260519112110-ec1cdf69c509
-	github.com/microsoft/typescript-go/shim/tspath => github.com/samchon/ttsc/packages/ttsc/shim/tspath v0.0.0-20260519112110-ec1cdf69c509
-	github.com/microsoft/typescript-go/shim/vfs => github.com/samchon/ttsc/packages/ttsc/shim/vfs v0.0.0-20260519112110-ec1cdf69c509
-	github.com/microsoft/typescript-go/shim/vfs/cachedvfs => github.com/samchon/ttsc/packages/ttsc/shim/vfs/cachedvfs v0.0.0-20260519112110-ec1cdf69c509
-	github.com/microsoft/typescript-go/shim/vfs/osvfs => github.com/samchon/ttsc/packages/ttsc/shim/vfs/osvfs v0.0.0-20260519112110-ec1cdf69c509
-	github.com/samchon/nestia/packages/core/native => ../../core/native
-	github.com/samchon/ttsc/packages/ttsc v0.0.0 => github.com/samchon/ttsc/packages/ttsc v0.0.0-20260519112110-ec1cdf69c509
-)
+module github.com/samchon/nestia/packages/sdk/native
+
+go 1.26
+
+require (
+	github.com/microsoft/typescript-go/shim/ast v0.0.0
+	github.com/microsoft/typescript-go/shim/checker v0.0.0
+	github.com/microsoft/typescript-go/shim/printer v0.0.0
+	github.com/microsoft/typescript-go/shim/scanner v0.0.0
+	github.com/samchon/nestia/packages/core/native v0.0.0
+	github.com/samchon/ttsc/packages/ttsc v0.0.0
+	github.com/samchon/typia/packages/typia/native v0.0.0-20260605060028-1dfa7ca6193e
+)
+
+require (
+	github.com/go-json-experiment/json v0.0.0-20260214004413-d219187c3433 // indirect
+	github.com/klauspost/cpuid/v2 v2.2.10 // indirect
+	github.com/microsoft/typescript-go v0.0.0-20260429010842-56ab4af42157 // indirect
+	github.com/microsoft/typescript-go/shim/bundled v0.0.0 // indirect
+	github.com/microsoft/typescript-go/shim/compiler v0.0.0 // indirect
+	github.com/microsoft/typescript-go/shim/core v0.0.0 // indirect
+	github.com/microsoft/typescript-go/shim/diagnosticwriter v0.0.0 // indirect
+	github.com/microsoft/typescript-go/shim/parser v0.0.0 // indirect
+	github.com/microsoft/typescript-go/shim/tsoptions v0.0.0 // indirect
+	github.com/microsoft/typescript-go/shim/tspath v0.0.0 // indirect
+	github.com/microsoft/typescript-go/shim/vfs v0.0.0 // indirect
+	github.com/microsoft/typescript-go/shim/vfs/cachedvfs v0.0.0 // indirect
+	github.com/microsoft/typescript-go/shim/vfs/osvfs v0.0.0 // indirect
+	github.com/zeebo/xxh3 v1.1.0 // indirect
+	golang.org/x/sync v0.20.0 // indirect
+	golang.org/x/sys v0.43.0 // indirect
+	golang.org/x/text v0.36.0 // indirect
+)
+
+replace (
+	github.com/microsoft/typescript-go/shim/ast => github.com/samchon/ttsc/packages/ttsc/shim/ast v0.0.0-20260605102019-02361f943e18
+	github.com/microsoft/typescript-go/shim/bundled => github.com/samchon/ttsc/packages/ttsc/shim/bundled v0.0.0-20260605102019-02361f943e18
+	github.com/microsoft/typescript-go/shim/checker => github.com/samchon/ttsc/packages/ttsc/shim/checker v0.0.0-20260605102019-02361f943e18
+	github.com/microsoft/typescript-go/shim/compiler => github.com/samchon/ttsc/packages/ttsc/shim/compiler v0.0.0-20260605102019-02361f943e18
+	github.com/microsoft/typescript-go/shim/core => github.com/samchon/ttsc/packages/ttsc/shim/core v0.0.0-20260605102019-02361f943e18
+	github.com/microsoft/typescript-go/shim/diagnosticwriter => github.com/samchon/ttsc/packages/ttsc/shim/diagnosticwriter v0.0.0-20260605102019-02361f943e18
+	github.com/microsoft/typescript-go/shim/parser => github.com/samchon/ttsc/packages/ttsc/shim/parser v0.0.0-20260605102019-02361f943e18
+	github.com/microsoft/typescript-go/shim/printer => github.com/samchon/ttsc/packages/ttsc/shim/printer v0.0.0-20260605102019-02361f943e18
+	github.com/microsoft/typescript-go/shim/scanner => github.com/samchon/ttsc/packages/ttsc/shim/scanner v0.0.0-20260605102019-02361f943e18
+	github.com/microsoft/typescript-go/shim/tsoptions => github.com/samchon/ttsc/packages/ttsc/shim/tsoptions v0.0.0-20260605102019-02361f943e18
+	github.com/microsoft/typescript-go/shim/tspath => github.com/samchon/ttsc/packages/ttsc/shim/tspath v0.0.0-20260605102019-02361f943e18
+	github.com/microsoft/typescript-go/shim/vfs => github.com/samchon/ttsc/packages/ttsc/shim/vfs v0.0.0-20260605102019-02361f943e18
+	github.com/microsoft/typescript-go/shim/vfs/cachedvfs => github.com/samchon/ttsc/packages/ttsc/shim/vfs/cachedvfs v0.0.0-20260605102019-02361f943e18
+	github.com/microsoft/typescript-go/shim/vfs/osvfs => github.com/samchon/ttsc/packages/ttsc/shim/vfs/osvfs v0.0.0-20260605102019-02361f943e18
+	github.com/samchon/nestia/packages/core/native => ../../core/native
+	github.com/samchon/ttsc/packages/ttsc v0.0.0 => github.com/samchon/ttsc/packages/ttsc v0.0.0-20260605102019-02361f943e18
+)