@nestia/sdk 12.0.0 → 12.1.0

package/native/sdk/register.go

@@ -13,7 +13,7 @@ import (
 	"github.com/samchon/ttsc/packages/ttsc/driver"
 )
 
-// sdkMetadataNamespace is the import alias the legacy (text/program-mutation)
+// sdkMetadataNamespace is the import alias the ApplyProgram (program-mutation)
 // path references. The emit-context path lets tsgo's module-transform pick the
 // generated alias itself, so it does not use this constant.
 const sdkMetadataNamespace = "__OperationMetadata"
@@ -30,12 +30,11 @@ const sdkMetadataMember = "OperationMetadata"
 // ttsc classifies this package (name != "main") as a linked transform and
 // statically links it into the `@nestia/core` host binary — but only for
 // projects that depend on `@nestia/sdk`. The direct linked-plugin path keeps
-// old plugin plans working, while the contributor collectors let the aggregate
-// core host run SDK metadata rewrites without starting a second native backend.
+// old plugin plans working, while the emit-transform collector lets the
+// aggregate core host run the SDK metadata pass inside the shared emit context
+// without starting a second native backend.
 func init() {
 	driver.RegisterPlugin(linkedPlugin{})
-	transform.RegisterBuildOutputRewriteCollector(collectSDKBuildOutputRewriter)
-	transform.RegisterSourceRewriteCollector(collectSDKSourceRewriteMap)
 	transform.RegisterEmitTransformCollector(collectSDKEmitTransform)
 }
 
@@ -84,8 +83,8 @@ func (linkedPlugin) ApplyProgram(prog *driver.Program, _ driver.PluginContext) e
 // `@<ns>.OperationMetadata("<json>")` decorator plus a namespace import of
 // `@nestia/sdk`, both built with ec.Factory and referenced through
 // NewGeneratedNameForNode(modSpec), so tsgo's builtin module-transform emits the
-// `require("@nestia/sdk")` and aliases the reference itself — no hand-rolled
-// `__OperationMetadata` namespace and no text-splice.
+// `require("@nestia/sdk")` and aliases the reference itself, with no
+// hand-rolled `__OperationMetadata` namespace.
 //
 // Core's build command wires this into `prog.EmitWithPluginTransformers`
 // alongside the typia and core transforms, exactly as the typia build command
@@ -169,34 +168,6 @@ func collectSDKEmitTransform(
 	}
 	return EmitTransform(prog)
 }
-
-func collectSDKBuildOutputRewriter(
-	prog *driver.Program,
-	plan plugin.Plan,
-) (*transform.BuildOutputRewriter, []transform.Diagnostic) {
-	if shouldRunSDKContributorTransform() == false {
-		return nil, nil
-	}
-	plan.SDK = true
-	set, diagnostics := collectNestiaSDKBuildRewrites(prog, plan)
-	return &transform.BuildOutputRewriter{
-		Len:   set.Len,
-		Apply: set.Apply,
-	}, diagnostics
-}
-
-func collectSDKSourceRewriteMap(
-	prog *driver.Program,
-	plan plugin.Plan,
-	onlyFile string,
-) (map[string][]transform.SourceRewrite, []transform.Diagnostic) {
-	if shouldRunSDKContributorTransform() == false {
-		return map[string][]transform.SourceRewrite{}, nil
-	}
-	plan.SDK = true
-	return collectNestiaSDKSourceRewriteMap(prog, plan, onlyFile)
-}
-
 func shouldRunSDKContributorTransform() bool {
 	return os.Getenv("NESTIA_SDK_TRANSFORM") == "1"
 }

package/native/sdk/sdk_transform.go

@@ -12,7 +12,6 @@ import (
 	shimast "github.com/microsoft/typescript-go/shim/ast"
 	shimchecker "github.com/microsoft/typescript-go/shim/checker"
 	shimscanner "github.com/microsoft/typescript-go/shim/scanner"
-	"github.com/samchon/nestia/packages/core/native/plugin"
 	"github.com/samchon/nestia/packages/core/native/transform"
 	"github.com/samchon/ttsc/packages/ttsc/driver"
 	nativecontext "github.com/samchon/typia/packages/typia/native/core/context"
@@ -31,10 +30,6 @@ type nestiaSDKSite struct {
 	Metadata   string
 }
 
-type nestiaSDKBuildRewriteSet struct {
-	byPath map[string][]nestiaSDKSite
-}
-
 type nestiaSDKContext struct {
 	prog          *driver.Program
 	collection    *schemametadata.MetadataCollection
@@ -79,112 +74,6 @@ func (ctx *nestiaSDKContext) imports(file *shimast.SourceFile) []nestiaSDKImport
 	ctx.importsByFile[name] = imports
 	return imports
 }
-
-func newNestiaSDKBuildRewriteSet() *nestiaSDKBuildRewriteSet {
-	return &nestiaSDKBuildRewriteSet{byPath: map[string][]nestiaSDKSite{}}
-}
-
-func (rs *nestiaSDKBuildRewriteSet) Add(site nestiaSDKSite) {
-	if site.FilePath == "" {
-		return
-	}
-	path := filepath.ToSlash(site.FilePath)
-	rs.byPath[path] = append(rs.byPath[path], site)
-}
-
-func (rs *nestiaSDKBuildRewriteSet) Len() int {
-	if rs == nil {
-		return 0
-	}
-	count := 0
-	for _, sites := range rs.byPath {
-		count += len(sites)
-	}
-	return count
-}
-
-func (rs *nestiaSDKBuildRewriteSet) Apply(outputName string, text string) (string, error) {
-	if rs == nil || len(rs.byPath) == 0 {
-		return text, nil
-	}
-	srcPath, ok := rs.findSourceForOutput(outputName)
-	if !ok {
-		return text, nil
-	}
-	out := text
-	out = insertSDKOperationMetadataDecorators(out, rs.byPath[srcPath])
-	return injectSDKOperationMetadataImport(out), nil
-}
-
-func (rs *nestiaSDKBuildRewriteSet) findSourceForOutput(outputName string) (string, bool) {
-	outSlash := strings.TrimSuffix(filepath.ToSlash(outputName), filepath.Ext(outputName))
-	for path := range rs.byPath {
-		srcStem := strings.TrimSuffix(filepath.ToSlash(path), filepath.Ext(path))
-		if transform.OutputMatchesSourceStem(outSlash, srcStem) {
-			return path, true
-		}
-	}
-	return "", false
-}
-
-func collectNestiaSDKSourceRewriteMap(
-	prog *driver.Program,
-	plan plugin.Plan,
-	onlyFile string,
-) (map[string][]transform.SourceRewrite, []transform.Diagnostic) {
-	if plan.SDK == false {
-		return map[string][]transform.SourceRewrite{}, nil
-	}
-	sites, diagnostics := collectNestiaSDKSites(prog)
-	rewrites := map[string][]transform.SourceRewrite{}
-	touched := map[string]bool{}
-	for _, site := range sites {
-		file := filepath.ToSlash(site.FilePath)
-		if onlyFile != "" && file != filepath.ToSlash(onlyFile) {
-			continue
-		}
-		source, ok := transform.SourceFileText(site.File)
-		if !ok {
-			diagnostics = append(diagnostics, nestiaSDKDiagnostic(site, "source text is unavailable"))
-			continue
-		}
-		insert := site.Method.Pos()
-		if decorators := site.Method.Decorators(); len(decorators) != 0 {
-			insert = decorators[0].Pos()
-		}
-		indent := sourceLineIndent(source, insert)
-		rewrites[file] = append(rewrites[file], transform.NewSourceRewrite(
-			insert,
-			insert,
-			"\n"+indent+"@__OperationMetadata.OperationMetadata("+site.Metadata+" as any)\n",
-		))
-		touched[file] = true
-	}
-	for file := range touched {
-		rewrites[file] = append(rewrites[file], transform.NewSourceRewrite(
-			0,
-			0,
-			"import * as __OperationMetadata from \"@nestia/sdk\";\n",
-		))
-	}
-	return rewrites, diagnostics
-}
-
-func collectNestiaSDKBuildRewrites(
-	prog *driver.Program,
-	plan plugin.Plan,
-) (*nestiaSDKBuildRewriteSet, []transform.Diagnostic) {
-	set := newNestiaSDKBuildRewriteSet()
-	if plan.SDK == false {
-		return set, nil
-	}
-	sites, diagnostics := collectNestiaSDKSites(prog)
-	for _, site := range sites {
-		set.Add(site)
-	}
-	return set, diagnostics
-}
-
 func collectNestiaSDKSites(prog *driver.Program) ([]nestiaSDKSite, []transform.Diagnostic) {
 	sites := []nestiaSDKSite{}
 	diagnostics := []transform.Diagnostic{}
@@ -193,7 +82,7 @@ func collectNestiaSDKSites(prog *driver.Program) ([]nestiaSDKSite, []transform.D
 		if file == nil || file.IsDeclarationFile {
 			continue
 		}
-		visited := map[string]bool{}
+		visited := map[int]bool{}
 		file.ForEachChild(func(node *shimast.Node) bool {
 			visitNestiaSDKNode(context, file, node, visited, &sites, &diagnostics)
 			return false
@@ -209,7 +98,7 @@ func visitNestiaSDKNode(
 	context *nestiaSDKContext,
 	file *shimast.SourceFile,
 	node *shimast.Node,
-	visited map[string]bool,
+	visited map[int]bool,
 	sites *[]nestiaSDKSite,
 	diagnostics *[]transform.Diagnostic,
 ) {
@@ -220,7 +109,10 @@ func visitNestiaSDKNode(
 		className := nestiaSDKParentClassName(node)
 		methodName := nestiaSDKMethodName(node)
 		if className != "" && methodName != "" {
-			key := className + "." + methodName
+			// A method's source position is unique in this file. Class and method
+			// names are not: namespaces can legitimately export identically named
+			// controller classes and methods.
+			key := node.Pos()
 			if visited[key] == false {
 				visited[key] = true
 				metadata, err := nestiaSDKMetadataText(context, file, node)
@@ -483,7 +375,12 @@ type nestiaSDKImportInfo struct {
 	File     string
 	Asterisk string
 	Default  string
-	Elements []string
+	Elements []nestiaSDKImportElement
+}
+
+type nestiaSDKImportElement struct {
+	Local    string
+	Imported string
 }
 
 func nestiaSDKAnalyzeImports(file *shimast.SourceFile) []nestiaSDKImportInfo {
@@ -505,7 +402,7 @@ func nestiaSDKAnalyzeImports(file *shimast.SourceFile) []nestiaSDKImportInfo {
 		}
 		info := nestiaSDKImportInfo{
 			File:     nestiaSDKNormalizeImportPath(file.FileName(), decl.ModuleSpecifier.Text()),
-			Elements: []string{},
+			Elements: []nestiaSDKImportElement{},
 		}
 		if name := clause.Name(); name != nil {
 			info.Default = name.Text()
@@ -527,7 +424,14 @@ func nestiaSDKAnalyzeImports(file *shimast.SourceFile) []nestiaSDKImportInfo {
 							continue
 						}
 						if name := spec.Name(); name != nil {
-							info.Elements = append(info.Elements, name.Text())
+							imported := name.Text()
+							if property := spec.PropertyName; property != nil {
+								imported = property.Text()
+							}
+							info.Elements = append(info.Elements, nestiaSDKImportElement{
+								Local:    name.Text(),
+								Imported: imported,
+							})
 						}
 					}
 				}
@@ -596,7 +500,7 @@ func nestiaSDKImportMatches(prefixes map[string]bool, imp nestiaSDKImportInfo) b
 		return true
 	}
 	for _, elem := range imp.Elements {
-		if prefixes[elem] {
+		if prefixes[elem.Local] {
 			return true
 		}
 	}
@@ -605,9 +509,13 @@ func nestiaSDKImportMatches(prefixes map[string]bool, imp nestiaSDKImportInfo) b
 
 func nestiaSDKImportLiteral(imp nestiaSDKImportInfo, prefixes map[string]bool) map[string]any {
 	elements := []string{}
+	aliases := map[string]string{}
 	for _, elem := range imp.Elements {
-		if prefixes[elem] {
-			elements = append(elements, elem)
+		if prefixes[elem.Local] {
+			elements = append(elements, elem.Local)
+			if elem.Imported != elem.Local {
+				aliases[elem.Local] = elem.Imported
+			}
 		}
 	}
 	asterisk := any(nestiaSDKLiteralNull)
@@ -618,12 +526,16 @@ func nestiaSDKImportLiteral(imp nestiaSDKImportInfo, prefixes map[string]bool) m
 	if imp.Default != "" && prefixes[imp.Default] {
 		def = imp.Default
 	}
-	return map[string]any{
+	output := map[string]any{
 		"file":     imp.File,
 		"asterisk": asterisk,
 		"default":  def,
 		"elements": elements,
 	}
+	if len(aliases) != 0 {
+		output["elementAliases"] = aliases
+	}
+	return output
 }
 
 func nestiaSDKResponse(
@@ -1168,24 +1080,58 @@ func nestiaSDKUnionRank(order map[string]int, name string) int {
 }
 
 func nestiaSDKIsTypeGuardError(prog *driver.Program, typ *shimchecker.Type, typeNode *shimast.Node) bool {
-	if typeNode != nil {
-		name := nestiaSDKTypeNodeText(typeNode)
-		if name == "TypeGuardError" || strings.HasPrefix(name, "TypeGuardError<") {
+	if prog == nil || prog.Checker == nil {
+		return false
+	}
+	var symbol *shimast.Symbol
+	if typeNode != nil && typeNode.Kind == shimast.KindTypeReference {
+		ref := typeNode.AsTypeReferenceNode()
+		symbol = prog.Checker.GetSymbolAtLocation(ref.TypeName)
+	}
+	if symbol == nil && typ != nil {
+		symbol = typ.Symbol()
+	}
+	if symbol == nil {
+		return false
+	}
+	if symbol.Flags&shimast.SymbolFlagsAlias != 0 {
+		if aliased := shimchecker.Checker_getAliasedSymbol(prog.Checker, symbol); aliased != nil {
+			symbol = aliased
+		}
+	}
+	if symbol.Name != "TypeGuardError" {
+		return false
+	}
+	for _, declaration := range symbol.Declarations {
+		source := shimast.GetSourceFileOfNode(declaration)
+		if source == nil {
+			continue
+		}
+		if nestiaSDKIsTypiaSourceFile(prog, source) {
 			return true
 		}
-		if typeNode.Kind == shimast.KindTypeReference {
-			ref := typeNode.AsTypeReferenceNode()
-			name = nestiaSDKEntityNameText(ref.TypeName)
-			if name == "TypeGuardError" {
-				return true
+	}
+	return false
+}
+
+func nestiaSDKIsTypiaSourceFile(prog *driver.Program, source *shimast.SourceFile) bool {
+	if prog == nil || prog.FS == nil || source == nil {
+		return false
+	}
+	for directory := filepath.Dir(source.FileName()); ; {
+		contents, ok := prog.FS.ReadFile(filepath.Join(directory, "package.json"))
+		if ok {
+			var pack struct {
+				Name string `json:"name"`
 			}
+			return json.Unmarshal([]byte(contents), &pack) == nil && pack.Name == "typia"
 		}
+		parent := filepath.Dir(directory)
+		if parent == directory {
+			return false
+		}
+		directory = parent
 	}
-	if prog != nil && prog.Checker != nil && typ != nil {
-		name := prog.Checker.TypeToString(typ)
-		return name == "TypeGuardError" || strings.HasPrefix(name, "TypeGuardError<")
-	}
-	return false
 }
 
 func nestiaSDKTypeGuardErrorSchemaPipe() any {
@@ -1572,36 +1518,12 @@ func nestiaSDKParameterName(node *shimast.Node) string {
 	}
 	return strings.Trim(node.Name().Text(), "\"'")
 }
-
-func nestiaSDKParameterTypeName(prog *driver.Program, node *shimast.Node, typ *shimchecker.Type) string {
-	if node != nil && node.AsParameterDeclaration() != nil {
-		if typeNode := node.AsParameterDeclaration().Type; typeNode != nil {
-			return nestiaSDKTypeNodeText(typeNode)
-		}
-	}
-	return nestiaSDKTypeNameFromChecker(prog, typ)
-}
-
 func nestiaSDKParameterTypeNode(node *shimast.Node) *shimast.Node {
 	if node != nil && node.AsParameterDeclaration() != nil {
 		return node.AsParameterDeclaration().Type
 	}
 	return nil
 }
-
-func nestiaSDKMethodReturnTypeName(
-	prog *driver.Program,
-	method *shimast.Node,
-	typ *shimchecker.Type,
-) string {
-	if method != nil && method.FunctionLikeData() != nil {
-		if typeNode := method.FunctionLikeData().Type; typeNode != nil {
-			return nestiaSDKReturnTypeNodeText(prog, typeNode)
-		}
-	}
-	return nestiaSDKTypeNameFromChecker(prog, typ)
-}
-
 func nestiaSDKMethodReturnTypeNode(prog *driver.Program, method *shimast.Node) *shimast.Node {
 	if method != nil && method.FunctionLikeData() != nil {
 		if typeNode := method.FunctionLikeData().Type; typeNode != nil {
@@ -1624,18 +1546,6 @@ func nestiaSDKReturnTypeNode(prog *driver.Program, node *shimast.Node) *shimast.
 func nestiaSDKEntityNameText(node *shimast.Node) string {
 	return nestiaSDKTypeNodeText(node)
 }
-
-func nestiaSDKReturnTypeNodeText(prog *driver.Program, node *shimast.Node) string {
-	text := nestiaSDKTypeNodeText(node)
-	if node != nil && node.Kind == shimast.KindTypeReference {
-		ref := node.AsTypeReferenceNode()
-		if ref != nil && ref.TypeArguments != nil && len(ref.TypeArguments.Nodes) == 1 && nestiaSDKIsAsyncReturnWrapper(prog, ref.TypeName, nestiaSDKEntityNameText(ref.TypeName)) {
-			return nestiaSDKTypeNodeText(ref.TypeArguments.Nodes[0])
-		}
-	}
-	return text
-}
-
 func nestiaSDKIsAsyncReturnWrapper(
 	prog *driver.Program,
 	node *shimast.Node,
@@ -1722,145 +1632,11 @@ func nestiaSDKTypeNodeText(node *shimast.Node) string {
 	return strings.TrimSpace(source[start:end])
 }
 
-func nestiaSDKTypeNameFromChecker(prog *driver.Program, typ *shimchecker.Type) string {
-	if prog != nil && prog.Checker != nil && typ != nil {
-		return prog.Checker.TypeToString(typ)
-	}
-	return "any"
-}
-
-func insertSDKOperationMetadataDecorators(text string, sites []nestiaSDKSite) string {
-	if len(sites) == 0 {
-		return text
-	}
-	cursor := 0
-	out := text
-	for _, site := range sites {
-		next, ok := insertSDKOperationMetadataDecorator(out, site, cursor)
-		if ok {
-			out = next.text
-			cursor = next.cursor
-			continue
-		}
-		next, ok = insertSDKOperationMetadataDecorator(out, site, 0)
-		if ok {
-			out = next.text
-			cursor = next.cursor
-		}
-	}
-	return out
-}
-
 type sdkOperationMetadataInsertResult struct {
 	text   string
 	cursor int
 }
 
-func insertSDKOperationMetadataDecorator(text string, site nestiaSDKSite, offset int) (sdkOperationMetadataInsertResult, bool) {
-	if offset < 0 || offset > len(text) {
-		offset = 0
-	}
-	needle := "], " + site.ClassName + ".prototype, \"" + site.MethodName + "\","
-	relative := strings.Index(text[offset:], needle)
-	idx := -1
-	if relative >= 0 {
-		idx = offset + relative
-	}
-	if idx < 0 {
-		return sdkOperationMetadataInsertResult{text: text, cursor: offset}, false
-	}
-	head := strings.LastIndex(text[:idx], "__decorate([")
-	if head < 0 {
-		return sdkOperationMetadataInsertResult{text: text, cursor: offset}, false
-	}
-	if strings.Contains(text[head:idx], "__OperationMetadata.OperationMetadata") {
-		return sdkOperationMetadataInsertResult{
-			text:   text,
-			cursor: idx + len(needle),
-		}, true
-	}
-	insert := head + len("__decorate([")
-	decorator := "\n    __OperationMetadata.OperationMetadata(" + site.Metadata + "),"
-	next := text[:insert] + decorator + text[insert:]
-	return sdkOperationMetadataInsertResult{
-		text:   next,
-		cursor: idx + len(decorator) + len(needle),
-	}, true
-}
-
-func injectSDKOperationMetadataImport(text string) string {
-	if strings.Contains(text, "__OperationMetadata.OperationMetadata") == false ||
-		strings.Contains(text, "const __OperationMetadata = require(\"@nestia/sdk\")") ||
-		strings.Contains(text, "__OperationMetadata = __importStar(require(\"@nestia/sdk\"))") ||
-		strings.Contains(text, "import * as __OperationMetadata from \"@nestia/sdk\"") {
-		return text
-	}
-	esModule := sdkIsESModuleOutput(text)
-	var stmt string
-	if esModule {
-		stmt = "import * as __OperationMetadata from \"@nestia/sdk\";\n"
-	} else {
-		stmt = "const __OperationMetadata = require(\"@nestia/sdk\");\n"
-	}
-	index := sdkRuntimeImportInsertionIndex(text, esModule)
-	return text[:index] + stmt + text[index:]
-}
-
-func sdkIsESModuleOutput(text string) bool {
-	return regexp.MustCompile(`(?m)^(import\s|import\{|import\*|export\s)`).MatchString(text)
-}
-
-func sdkRuntimeImportInsertionIndex(text string, esModule bool) int {
-	index := 0
-	if strings.HasPrefix(text, "#!") {
-		if next := strings.IndexByte(text, '\n'); next >= 0 {
-			index = next + 1
-		} else {
-			return len(text)
-		}
-	}
-	if esModule {
-		return index
-	}
-	for {
-		next := sdkConsumeRuntimeImportPrefix(text[index:])
-		if next == 0 {
-			return index
-		}
-		index += next
-	}
-}
-
-func sdkConsumeRuntimeImportPrefix(text string) int {
-	for _, prefix := range []string{
-		"\"use strict\";\n",
-		"'use strict';\n",
-		"/* @ttsc-rewritten */\n",
-	} {
-		if strings.HasPrefix(text, prefix) {
-			return len(prefix)
-		}
-	}
-	return 0
-}
-
-func sourceLineIndent(source string, pos int) string {
-	if pos < 0 || pos > len(source) {
-		return ""
-	}
-	start := strings.LastIndex(source[:pos], "\n")
-	if start < 0 {
-		start = 0
-	} else {
-		start++
-	}
-	end := start
-	for end < len(source) && (source[end] == ' ' || source[end] == '\t') {
-		end++
-	}
-	return source[start:end]
-}
-
 func nestiaSDKDiagnostic(site nestiaSDKSite, message string) transform.Diagnostic {
 	line, column := 0, 0
 	if site.File != nil && site.Method != nil {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestia/sdk",
-  "version": "12.0.0",
+  "version": "12.1.0",
   "description": "Nestia SDK and Swagger generator",
   "main": "lib/index.js",
   "bin": {
@@ -45,22 +45,22 @@
   },
   "homepage": "https://nestia.io",
   "dependencies": {
-    "@ttsc/factory": "^0.18.4",
-    "@typia/interface": "^13.0.2",
-    "@typia/utils": "^13.0.2",
+    "@ttsc/factory": "^0.20.0",
+    "@typia/interface": "^13.2.0",
+    "@typia/utils": "^13.2.0",
     "get-function-location": "^2.0.0",
     "glob": "^11.0.3",
     "path-to-regexp": "^6.2.1",
     "prettier": "^3.8.1",
     "tgrid": "^1.2.1",
-    "ttsc": "^0.18.4",
+    "ttsc": "^0.20.0",
     "tstl": "^3.0.0",
-    "typia": "^13.0.2",
-    "@nestia/core": "^12.0.0",
-    "@nestia/fetcher": "^12.0.0"
+    "typia": "^13.2.0",
+    "@nestia/core": "^12.1.0",
+    "@nestia/fetcher": "^12.1.0"
   },
   "peerDependencies": {
-    "@nestia/core": "^12.0.0"
+    "@nestia/core": "^12.1.0"
   },
   "devDependencies": {
     "@modelcontextprotocol/sdk": "^1.18.0",

package/src/NestiaSwaggerComposer.ts

@@ -101,6 +101,8 @@ export namespace NestiaSwaggerComposer {
           }),
         );
       }
+    if (project.errors.length)
+      throw report({ type: "error", errors: project.errors });
     AccessorAnalyzer.analyze(routes);
     return routes;
   };

package/src/analyses/ImportAnalyzer.ts

@@ -4,11 +4,12 @@ import { MapUtil } from "../utils/MapUtil";
 export namespace ImportAnalyzer {
   /**
    * @deprecated Removed in the Go-migration cycle. Import metadata is now
-   * attached by the native transformer in `packages/core/native/cmd/ttsc-nestia`
-   * and consumed via `IOperationMetadata.imports`. Call sites that previously
-   * walked a `ts.SourceFile` to derive imports should read the metadata
-   * delivered through `Reflect.getMetadata("nestia/OperationMetadata", …)`
-   * instead. See `packages/core/MIGRATION.md`.
+   *   attached by the native transformer in
+   *   `packages/core/native/cmd/ttsc-nestia` and consumed via
+   *   `IOperationMetadata.imports`. Call sites that previously walked a
+   *   `ts.SourceFile` to derive imports should read the metadata delivered
+   *   through `Reflect.getMetadata("nestia/OperationMetadata", …)` instead. See
+   *   `packages/core/MIGRATION.md`.
    */
   export const analyze = (): never => {
     throw new Error(
@@ -72,21 +73,29 @@ export namespace ImportAnalyzer {
             asterisk: null,
           }) satisfies IReflectImport,
       );
-    const instances: Set<string> = new Set(
-      imports.map((imp) => imp.elements).flat(),
-    );
+    const instances: Map<string, string> = new Map();
+    for (const imp of imports)
+      for (const local of imp.elements)
+        instances.set(local, imp.elementAliases?.[local] ?? local);
     if (instances.size !== 0) {
-      if (defaultImports.length !== 0)
-        defaultImports[0]!.elements = Array.from(instances).sort();
-      else
-        defaultImports.push({
+      const elements = Array.from(instances.keys()).sort();
+      const elementAliases: Record<string, string> = {};
+      for (const local of elements) {
+        const imported = instances.get(local)!;
+        if (imported !== local) elementAliases[local] = imported;
+      }
+      const target: IReflectImport =
+        defaultImports[0] ?? {
           file,
-          elements: Array.from(instances).sort(),
+          elements: [],
           default: null,
           asterisk: null,
-        });
+        };
+      target.elements = elements;
+      if (Object.keys(elementAliases).length !== 0)
+        target.elementAliases = elementAliases;
+      if (defaultImports.length === 0) defaultImports.push(target);
     }
     return [...allStarImports, ...defaultImports];
   }
-
 }