@nestia/core 12.0.0-dev.20260520.1 → 12.0.0-dev.20260521.1

package/lib/transform.d.ts

@@ -1,2 +1,10 @@
+/**
+ * `@nestia/core` ttsc plugin descriptor.
+ *
+ * `@nestia/sdk` is not a standalone plugin: its Go transform is declared here
+ * as a `contributor` that ttsc statically links into this host binary, and
+ * only when `@nestia/sdk` is actually resolvable from the project. A project
+ * depending on `@nestia/core` alone never compiles any SDK transform code.
+ */
 export declare function createTtscPlugin(context: ITtscPluginFactoryContext): ITtscPlugin;
 export default createTtscPlugin;

package/lib/transform.js

@@ -4,34 +4,50 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createTtscPlugin = createTtscPlugin;
+const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const node_url_1 = require("node:url");
 const filename = currentFilename();
 const dirname = node_path_1.default.dirname(filename);
+/**
+ * `@nestia/core` ttsc plugin descriptor.
+ *
+ * `@nestia/sdk` is not a standalone plugin: its Go transform is declared here
+ * as a `contributor` that ttsc statically links into this host binary, and
+ * only when `@nestia/sdk` is actually resolvable from the project. A project
+ * depending on `@nestia/core` alone never compiles any SDK transform code.
+ */
 function createTtscPlugin(context) {
-    var _a;
-    const root = (_a = resolvePackageRoot("@nestia/core/package.json", context.projectRoot)) !== null && _a !== void 0 ? _a : inferPackageRoot();
-    return {
+    const plugin = {
         name: "@nestia/core",
-        source: node_path_1.default.resolve(root, "native", "cmd", "ttsc-nestia"),
-        composes: [
-            "typia/lib/transform",
-            "@nestia/sdk/lib/transform",
-        ],
+        source: node_path_1.default.resolve(root(context), "native", "cmd", "ttsc-nestia"),
+        composes: ["typia/lib/transform"],
     };
+    const sdk = resolveSdkContributorSource(context);
+    if (sdk !== null)
+        plugin.contributors = [{ name: "sdk", source: sdk }];
+    return plugin;
 }
 exports.default = createTtscPlugin;
+function root(context) {
+    var _a;
+    return ((_a = resolvePackageRoot("@nestia/core/package.json", context.projectRoot)) !== null && _a !== void 0 ? _a : node_path_1.default.resolve(dirname, ".."));
+}
+function resolveSdkContributorSource(context) {
+    const manifest = resolvePackageRoot("@nestia/sdk/package.json", context.projectRoot);
+    if (manifest === null)
+        return null;
+    const source = node_path_1.default.resolve(manifest, "native", "sdk");
+    return node_fs_1.default.existsSync(source) ? source : null;
+}
 function resolvePackageRoot(packageJson, projectRoot) {
     try {
-        return node_path_1.default.dirname(require.resolve(packageJson, { paths: [projectRoot] }));
+        return node_path_1.default.dirname(require.resolve(packageJson, { paths: [dirname, projectRoot] }));
     }
     catch (_a) {
         return null;
     }
 }
-function inferPackageRoot() {
-    return node_path_1.default.resolve(dirname, "..");
-}
 function currentFilename() {
     var _a;
     var _b, _c;

package/lib/transform.js.map

@@ -1 +1 @@
-{"version":3,"file":"transform.js","sourceRoot":"","sources":["../src/transform.ts"],"names":[],"mappings":";;;;;;AAAA,0DAA6B;AAC7B,uCAAyC;AAmBzC,MAAM,QAAQ,GAAW,eAAe,EAAE,CAAC;AAC3C,MAAM,OAAO,GAAW,mBAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;AAE/C,0BACE,OAAkC;;IAElC,MAAM,IAAI,SACR,kBAAkB,CAAC,2BAA2B,EAAE,OAAO,CAAC,WAAW,CAAC,mCACpE,gBAAgB,EAAE,CAAC;IACrB,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,MAAM,EAAE,mBAAI,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,CAAC;QAC1D,QAAQ,EAAE;YACR,qBAAqB;YACrB,2BAA2B;SAC5B;KACF,CAAC;AACJ,CAAC;kBACc,gBAAgB;AAE/B,SAAS,kBAAkB,CACzB,WAAmB,EACnB,WAAmB;IAEnB,IAAI,CAAC;QACH,OAAO,mBAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9E,CAAC;eAAO,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB;IACvB,OAAO,mBAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AACrC,CAAC;AAED,SAAS,eAAe;;;IACtB,IACE,OAAO,UAAU,KAAK,QAAQ;QAC9B,UAAU,KAAK,SAAS;QACxB,UAAU,CAAC,MAAM,KAAK,CAAC;QAEvB,OAAO,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAEvC,MAAM,IAAI,GAAuB,MAAA,IAAI,KAAK,EAAE,CAAC,KAAK,0CAC9C,KAAK,CAAC,IAAI,EACX,IAAI,CACH,CAAC,KAAK,EAAE,EAAE,CACR,KAAK,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QACnC,KAAK,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QACnC,KAAK,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CACvC,CAAC;IACJ,MAAM,OAAO,GAAwC,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,KAAK,CAC9D,4CAA4C,CAC7C,CAAC;IACF,MAAM,QAAQ,GAAW,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1E,OAAO,iBAAiB,aAAC,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAG,CAAC,CAAC,mCAAI,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAG,CAAC,CAAC,mCAAI,QAAQ,CAAC,CAAC;AACrE,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAa;IACtC,IAAI,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,IAAA,wBAAa,EAAC,KAAK,CAAC,CAAC;IAC3D,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"transform.js","sourceRoot":"","sources":["../src/transform.ts"],"names":[],"mappings":"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"}

package/native/cmd/ttsc-nestia/main.go

@@ -1,72 +1,11 @@
 package main
 
 import (
-	"fmt"
-	"io"
 	"os"
-	"runtime/debug"
-)
 
-var (
-	stdout io.Writer = os.Stdout
-	stderr io.Writer = os.Stderr
+	"github.com/samchon/nestia/packages/core/native/transform"
 )
 
 func main() {
-	os.Exit(runSafe(os.Args[1:]))
-}
-
-// runSafe wraps run() in a panic recovery envelope so that any unexpected
-// panic surfaces as a one-line transform-diagnostic on stderr instead of
-// a multi-line raw Go stack trace. The diagnostic uses the same `<file> -
-// error TS(code): message` shape as every other nestia / typia diagnostic;
-// ttsc reads it via `error.stderr` (`RuntimeCompiler.compile` at
-// `ConfigAnalyzer.ts:170-174`) rather than its structured-diagnostic regex,
-// which is a pre-existing protocol shared by all `nestia.*` codes. The
-// full stack is preserved behind NESTIA_NATIVE_DEBUG_STACK for triage.
-func runSafe(args []string) (code int) {
-	defer func() {
-		if exp := recover(); exp != nil {
-			diag := typiaTransformDiagnostic{
-				Code:    "nestia.internal.panic",
-				Message: fmt.Sprintf("ttsc-nestia panicked: %v", exp),
-			}
-			writeTypiaTransformDiagnostics(stderr, []typiaTransformDiagnostic{diag}, "")
-			if os.Getenv("NESTIA_NATIVE_DEBUG_STACK") != "" {
-				fmt.Fprintln(stderr, string(debug.Stack()))
-			}
-			code = 3
-		}
-	}()
-	return run(args)
-}
-
-func run(args []string) int {
-	if len(args) == 0 {
-		return runHelp(nil)
-	}
-	command := args[0]
-	rest := args[1:]
-	switch command {
-	case "build":
-		return runBuild(rest)
-	case "check":
-		return runCheck(rest)
-	case "transform":
-		return runTransform(rest)
-	case "version":
-		fmt.Fprintln(stdout, "ttsc-nestia 0.1.0")
-		return 0
-	case "help", "-h", "--help":
-		return runHelp(rest)
-	default:
-		fmt.Fprintf(stderr, "ttsc-nestia: unknown command %q\n", command)
-		return 2
-	}
-}
-
-func runHelp(args []string) int {
-	_ = args
-	fmt.Fprintln(stdout, "usage: ttsc-nestia <build|check|transform|version>")
-	return 0
+	os.Exit(transform.Run(os.Args[1:]))
 }

package/native/go.mod

@@ -9,7 +9,7 @@ require (
 	github.com/microsoft/typescript-go/shim/printer v0.0.0
 	github.com/microsoft/typescript-go/shim/scanner v0.0.0
 	github.com/samchon/ttsc/packages/ttsc v0.0.0
-	github.com/samchon/typia/packages/typia/native v0.0.0-20260510181336-5a7ad21c4d6f
+	github.com/samchon/typia/packages/typia/native v0.0.0-20260520144235-368b47d0ea16
 )
 
 require (

package/native/transform/ast.go

@@ -0,0 +1,32 @@
+package transform
+
+import (
+	"strings"
+
+	shimast "github.com/microsoft/typescript-go/shim/ast"
+)
+
+// NodeName returns the trimmed identifier text of a named AST node
+// (method, parameter, ...). Empty when the node has no name.
+func NodeName(node *shimast.Node) string {
+	if node == nil || node.Name() == nil {
+		return ""
+	}
+	return strings.Trim(node.Name().Text(), "\"'")
+}
+
+// NodeText returns the verbatim source slice spanned by a node.
+func NodeText(node *shimast.Node) string {
+	if node == nil {
+		return ""
+	}
+	source, ok := SourceFileText(shimast.GetSourceFileOfNode(node))
+	if ok == false {
+		return ""
+	}
+	start, end := node.Pos(), node.End()
+	if start < 0 || end > len(source) || start >= end {
+		return ""
+	}
+	return strings.TrimSpace(source[start:end])
+}

package/native/{cmd/ttsc-nestia → transform}/build.go

@@ -1,4 +1,4 @@
-package main
+package transform
 
 import (
 	"encoding/json"
@@ -116,7 +116,7 @@ func runBuild(args []string) int {
 	)
 	profileBuildStepCount(profile, "typia-rewrites", started, rewrites.Len())
 	if len(transformDiags) > 0 {
-		writeTypiaTransformDiagnostics(stderr, transformDiags, cwd)
+		WriteTypiaTransformDiagnostics(stderr, transformDiags, cwd)
 		return 3
 	}
 	beforeCore := rewrites.Len()
@@ -126,16 +126,7 @@ func runBuild(args []string) int {
 	coreDiags := collectNestiaCoreBuildRewrites(prog, plan, rewrites)
 	profileBuildStepCount(profile, "core-rewrites", started, rewrites.Len()-beforeCore)
 	if len(coreDiags) > 0 {
-		writeTypiaTransformDiagnostics(stderr, coreDiags, cwd)
-		return 3
-	}
-	if profile {
-		started = time.Now()
-	}
-	sdkRewrites, sdkDiags := collectNestiaSDKBuildRewrites(prog, plan)
-	profileBuildStepCount(profile, "sdk-rewrites", started, sdkRewrites.Len())
-	if len(sdkDiags) > 0 {
-		writeTypiaTransformDiagnostics(stderr, sdkDiags, cwd)
+		WriteTypiaTransformDiagnostics(stderr, coreDiags, cwd)
 		return 3
 	}
 	if profile {
@@ -146,7 +137,6 @@ func runBuild(args []string) int {
 
 	cursors := map[string]int{}
 	var nativePatchElapsed time.Duration
-	var sdkPatchElapsed time.Duration
 	var cleanupElapsed time.Duration
 	var writeElapsed time.Duration
 	writeFile := shimcompiler.WriteFile(func(fileName, text string, data *shimcompiler.WriteFileData) error {
@@ -165,16 +155,6 @@ func runBuild(args []string) int {
 		if profile {
 			patchStarted = time.Now()
 		}
-		patched, err = sdkRewrites.Apply(fileName, patched)
-		if profile {
-			sdkPatchElapsed += time.Since(patchStarted)
-		}
-		if err != nil {
-			return err
-		}
-		if profile {
-			patchStarted = time.Now()
-		}
 		patched = cleanupTransformedTextWithRuntimeAliases(patched, rewrites.RuntimeAliasesForOutput(fileName))
 		if profile {
 			cleanupElapsed += time.Since(patchStarted)
@@ -191,7 +171,6 @@ func runBuild(args []string) int {
 	res, eDiags, err := prog.EmitAllRaw(writeFile)
 	profileBuildStep(profile, "emit-total", started)
 	profileBuildDuration(profile, "emit-native-patch", nativePatchElapsed)
-	profileBuildDuration(profile, "emit-sdk-patch", sdkPatchElapsed)
 	profileBuildDuration(profile, "emit-cleanup", cleanupElapsed)
 	profileBuildDuration(profile, "emit-write", writeElapsed)
 	if err != nil {
@@ -266,7 +245,7 @@ func runCheck(args []string) int {
 	return 0
 }
 
-type typiaTransformDiagnostic struct {
+type Diagnostic struct {
 	File    string
 	Line    int
 	Column  int
@@ -274,7 +253,7 @@ type typiaTransformDiagnostic struct {
 	Message string
 }
 
-func (d typiaTransformDiagnostic) String(cwd string) string {
+func (d Diagnostic) String(cwd string) string {
 	file := d.File
 	if rel, err := filepath.Rel(cwd, file); err == nil {
 		file = rel
@@ -285,7 +264,7 @@ func (d typiaTransformDiagnostic) String(cwd string) string {
 	return fmt.Sprintf("%s - error TS(%s): %s", file, d.Code, d.Message)
 }
 
-func writeTypiaTransformDiagnostics(out io.Writer, diagnostics []typiaTransformDiagnostic, cwd string) {
+func WriteTypiaTransformDiagnostics(out io.Writer, diagnostics []Diagnostic, cwd string) {
 	for _, diag := range diagnostics {
 		fmt.Fprintln(out, diag.String(cwd))
 	}
@@ -309,7 +288,7 @@ func profileBuildDuration(enabled bool, name string, elapsed time.Duration) {
 	}
 }
 
-func newTypiaTransformDiagnostic(site typiaadapter.CallSite, message string) typiaTransformDiagnostic {
+func NewDiagnostic(site typiaadapter.CallSite, message string) Diagnostic {
 	line, column := 0, 0
 	if site.File != nil && site.Call != nil {
 		pos := site.Call.AsNode().Pos()
@@ -318,7 +297,7 @@ func newTypiaTransformDiagnostic(site typiaadapter.CallSite, message string) typ
 			line, column = l+1, c+1
 		}
 	}
-	return typiaTransformDiagnostic{
+	return Diagnostic{
 		File:    site.FilePath,
 		Line:    line,
 		Column:  column,
@@ -335,10 +314,10 @@ func collectTypiaRewrites(
 	onlyFile string,
 	rewrites *nativeRewriteSet,
 	pluginOptions typiaadapter.PluginOptions,
-) (int, int, []typiaTransformDiagnostic) {
+) (int, int, []Diagnostic) {
 	sites := collectNestiaTypiaCallSites(prog.SourceFiles(), prog.Checker)
 	recognized := 0
-	diagnostics := []typiaTransformDiagnostic{}
+	diagnostics := []Diagnostic{}
 	for _, site := range sites {
 		if onlyFile != "" && filepath.ToSlash(site.FilePath) != filepath.ToSlash(onlyFile) {
 			continue
@@ -348,16 +327,16 @@ func collectTypiaRewrites(
 			rel = abs
 		}
 		if reason := typiaadapter.UnsupportedReason(site); reason != "" {
-			diagnostics = append(diagnostics, newTypiaTransformDiagnostic(site, reason))
+			diagnostics = append(diagnostics, NewDiagnostic(site, reason))
 			continue
 		}
 		expr, handled, err := typiaadapter.EmitCallWithOptions(prog, site, pluginOptions)
 		if !handled {
-			diagnostics = append(diagnostics, newTypiaTransformDiagnostic(site, "method not covered"))
+			diagnostics = append(diagnostics, NewDiagnostic(site, "method not covered"))
 			continue
 		}
 		if err != nil {
-			diagnostics = append(diagnostics, newTypiaTransformDiagnostic(site, err.Error()))
+			diagnostics = append(diagnostics, NewDiagnostic(site, err.Error()))
 			continue
 		}
 		expr = parenthesizeTypiaReplacement(site, expr)
@@ -386,7 +365,7 @@ func typiaBuildRewriteSortKey(site typiaadapter.CallSite) int {
 	insideDecorator := false
 	classEnd := 0
 	for current := node.Parent; current != nil; current = current.Parent {
-		if current.Kind == nestiaCoreKindDecorator {
+		if current.Kind == NestiaCoreKindDecorator {
 			insideDecorator = true
 		}
 		if current.Kind == shimast.KindClassDeclaration || current.Kind == shimast.KindClassExpression {

package/native/{cmd/ttsc-nestia → transform}/cleanup.go

@@ -1,4 +1,4 @@
-package main
+package transform
 
 import (
 	"fmt"

package/native/transform/cleanup_test.go

@@ -0,0 +1,76 @@
+package transform
+
+import (
+	"strings"
+	"testing"
+)
+
+func TestCleanupTransformedTextWithRuntimeAliases(t *testing.T) {
+	input := strings.Join([]string{
+		`"use strict";`,
+		`const typia_1 = require("typia");`,
+		`const value = __typia_transform__isTypeInt32(input);`,
+		``,
+	}, "\n")
+
+	output := cleanupTransformedTextWithRuntimeAliases(
+		input,
+		[]string{"__typia_transform__isTypeInt32"},
+	)
+
+	if strings.Contains(output, `require("typia");`) {
+		t.Fatalf("unused typia import was not removed:\n%s", output)
+	}
+	expected := `const { _isTypeInt32: __typia_transform__isTypeInt32 } = require("typia/lib/internal/_isTypeInt32");`
+	if strings.Contains(output, expected) == false {
+		t.Fatalf("runtime import was not injected:\n%s", output)
+	}
+	if strings.Index(output, expected) >= strings.Index(output, "const value") {
+		t.Fatalf("runtime import was inserted after usage:\n%s", output)
+	}
+}
+
+func TestCleanupTransformedTextKeepsReferencedTypiaImport(t *testing.T) {
+	input := strings.Join([]string{
+		`"use strict";`,
+		`const typia_1 = require("typia");`,
+		`const value = typia_1.default.assert(input);`,
+		``,
+	}, "\n")
+
+	output := cleanupTransformedTextWithRuntimeAliases(input, []string{})
+	if strings.Contains(output, `const typia_1 = require("typia");`) == false {
+		t.Fatalf("referenced typia import was removed:\n%s", output)
+	}
+}
+
+func TestCleanupTransformedTextDoesNotDuplicateRuntimeImport(t *testing.T) {
+	existing := `const { _isTypeInt32: __typia_transform__isTypeInt32 } = require("typia/lib/internal/_isTypeInt32");`
+	input := strings.Join([]string{
+		`"use strict";`,
+		existing,
+		`const value = __typia_transform__isTypeInt32(input);`,
+		``,
+	}, "\n")
+
+	output := cleanupTransformedTextWithRuntimeAliases(
+		input,
+		[]string{"__typia_transform__isTypeInt32"},
+	)
+	if strings.Count(output, existing) != 1 {
+		t.Fatalf("runtime import was duplicated:\n%s", output)
+	}
+}
+
+func TestNativeRewriteSetCollectsRuntimeAliasesFromAppendArguments(t *testing.T) {
+	rewrites := newNativeRewriteSet()
+	rewrites.Add(nativeRewrite{
+		FilePath:        "/project/src/controller.ts",
+		AppendArguments: []string{`__typia_transform__httpQueryParseURLSearchParams(input)`},
+	})
+
+	aliases := rewrites.RuntimeAliasesForOutput("/project/lib/controller.js")
+	if len(aliases) != 1 || aliases[0] != "__typia_transform__httpQueryParseURLSearchParams" {
+		t.Fatalf("unexpected aliases: %#v", aliases)
+	}
+}

package/native/transform/commonjs_import_alias_test.go

@@ -0,0 +1,49 @@
+package transform
+
+import "testing"
+
+// Verifies commonJSImportAliasBase produces a valid JS identifier base
+// for every module specifier the CommonJS substitution table feeds it.
+//
+// Output forms the `<base>_N.default` substitution map that the native
+// rewrite scan looks up against tsgo's CJS emit. Any input that produces
+// a non-identifier base (leading digit, contains `-`, empty after
+// extension strip) would generate a substitution that never matches
+// tsgo's emit and silently break the rewrite for that import. The
+// reverted P-8 sat on top of this helper — locking the branches now
+// guards the rewrite contract against future emit-side changes.
+//
+//  1. Letters / digits / `_` / `$` survive verbatim.
+//  2. Non-identifier characters (dashes, dots, slashes) become `_`.
+//  3. Empty or pathological bases (`.`, `/`) fall back to `mod`.
+//  4. Leading digits are prefixed with `_` so the base is identifier-safe.
+//  5. Unicode letters survive (Go's `unicode.IsLetter`).
+//  6. File extensions are stripped before sanitization.
+func TestCommonJSImportAliasBaseProducesIdentifierSafeName(t *testing.T) {
+	cases := []struct {
+		name   string
+		module string
+		want   string
+	}{
+		{"plain package", "typia", "typia"},
+		{"scoped package", "@nestia/core", "core"},
+		{"dotted package", "lodash.merge", "lodash"},
+		{"path with slashes", "@nestia/core/lib/transform", "transform"},
+		{"dashes become underscores", "kebab-case-lib", "kebab_case_lib"},
+		{"trailing extension stripped", "module.mjs", "module"},
+		{"empty becomes mod", "", "mod"},
+		{"dot becomes mod", ".", "mod"},
+		{"leading digit prefixed with underscore", "1abc", "_1abc"},
+		{"underscore start preserved", "_internal", "_internal"},
+		{"dollar start preserved", "$jq", "$jq"},
+		{"unicode letter preserved", "한글", "한글"},
+		{"mixed special chars sanitized", "foo.bar-baz", "foo"},
+	}
+	for _, tc := range cases {
+		t.Run(tc.name, func(t *testing.T) {
+			if got := commonJSImportAliasBase(tc.module); got != tc.want {
+				t.Fatalf("commonJSImportAliasBase(%q) = %q, want %q", tc.module, got, tc.want)
+			}
+		})
+	}
+}

package/native/transform/core_dispatch_test.go

@@ -0,0 +1,127 @@
+package transform
+
+import "testing"
+
+// Verifies nestiaCoreParameterKind maps every supported decorator suffix
+// to the programmer kind that drives validator generation.
+//
+// The suffix table is the single source of truth for parameter-decorator
+// dispatch — a silent typo or a missing entry would silently route the
+// affected decorator to the no-op path and emit no validator. The
+// `WebSocketRoute.Header`-as-`TypedBody` and `EncryptedBody`-as-`TypedBody`
+// rows are non-obvious: WebSocket header and encrypted body re-use the
+// TypedBody programmer because their on-the-wire payload shape matches.
+//
+//  1. Every documented suffix returns the matching kind.
+//  2. Multi-segment suffixes (`TypedQuery.Body`, `WebSocketRoute.Param`)
+//     resolve only when both tail segments line up.
+//  3. Unknown suffixes return the empty string (the no-op signal).
+func TestNestiaCoreParameterKindDispatch(t *testing.T) {
+	cases := []struct {
+		name     string
+		segments []string
+		want     string
+	}{
+		{"bare TypedBody", []string{"TypedBody"}, "TypedBody"},
+		{"imported core.TypedBody", []string{"core", "TypedBody"}, "TypedBody"},
+		{"EncryptedBody maps to TypedBody", []string{"EncryptedBody"}, "TypedBody"},
+		{"TypedHeaders", []string{"TypedHeaders"}, "TypedHeaders"},
+		{"TypedParam", []string{"TypedParam"}, "TypedParam"},
+		{"TypedQuery solo", []string{"TypedQuery"}, "TypedQuery"},
+		{"PlainBody", []string{"PlainBody"}, "PlainBody"},
+		{"TypedQuery.Body", []string{"TypedQuery", "Body"}, "TypedQueryBody"},
+		{"TypedFormData.Body", []string{"TypedFormData", "Body"}, "TypedFormDataBody"},
+		{"WebSocketRoute.Header maps to TypedBody", []string{"WebSocketRoute", "Header"}, "TypedBody"},
+		{"WebSocketRoute.Param maps to TypedParam", []string{"WebSocketRoute", "Param"}, "TypedParam"},
+		{"WebSocketRoute.Query maps to TypedQuery", []string{"WebSocketRoute", "Query"}, "TypedQuery"},
+		{"unknown decorator", []string{"TypedSomethingElse"}, ""},
+		{"empty segments", []string{}, ""},
+		{"TypedQuery.Other is not TypedQueryBody", []string{"TypedQuery", "Other"}, ""},
+		{"WebSocketRoute alone is not a parameter", []string{"WebSocketRoute"}, ""},
+	}
+	for _, tc := range cases {
+		t.Run(tc.name, func(t *testing.T) {
+			if got := nestiaCoreParameterKind(tc.segments); got != tc.want {
+				t.Fatalf("nestiaCoreParameterKind(%v) = %q, want %q", tc.segments, got, tc.want)
+			}
+		})
+	}
+}
+
+// Verifies nestiaCoreMethodKind dispatches HTTP-method decorators to the
+// correct route programmer kind.
+//
+// The two-position lookup (`[..., ROOT, VERB]`) keeps `EncryptedRoute.Post`
+// distinct from `TypedQuery.Body` — both have two tail segments but only
+// the former is a route. The verb whitelist (Get/Post/Patch/Put/Delete)
+// pins the contract: any new HTTP verb would have to be added explicitly,
+// preventing accidental dispatch on a typo like `Posts`.
+//
+//  1. Each HTTP verb under `TypedRoute` or `EncryptedRoute` returns `TypedRoute`.
+//  2. Each HTTP verb under `TypedQuery` returns `TypedQueryRoute`.
+//  3. Unknown roots or unknown verbs return the empty string.
+//  4. Single-segment or empty segment lists return the empty string.
+func TestNestiaCoreMethodKindDispatch(t *testing.T) {
+	cases := []struct {
+		name     string
+		segments []string
+		want     string
+	}{
+		{"TypedRoute.Get", []string{"TypedRoute", "Get"}, "TypedRoute"},
+		{"TypedRoute.Post", []string{"TypedRoute", "Post"}, "TypedRoute"},
+		{"TypedRoute.Patch", []string{"TypedRoute", "Patch"}, "TypedRoute"},
+		{"TypedRoute.Put", []string{"TypedRoute", "Put"}, "TypedRoute"},
+		{"TypedRoute.Delete", []string{"TypedRoute", "Delete"}, "TypedRoute"},
+		{"EncryptedRoute.Post", []string{"EncryptedRoute", "Post"}, "TypedRoute"},
+		{"TypedQuery.Get", []string{"TypedQuery", "Get"}, "TypedQueryRoute"},
+		{"imported core.TypedRoute.Get", []string{"core", "TypedRoute", "Get"}, "TypedRoute"},
+		{"unknown verb", []string{"TypedRoute", "Head"}, ""},
+		{"unknown root", []string{"SomethingElse", "Get"}, ""},
+		{"single segment", []string{"Get"}, ""},
+		{"empty segments", []string{}, ""},
+		{"verb-only suffix", []string{"TypedQuery", "Body"}, ""},
+	}
+	for _, tc := range cases {
+		t.Run(tc.name, func(t *testing.T) {
+			if got := nestiaCoreMethodKind(tc.segments); got != tc.want {
+				t.Fatalf("nestiaCoreMethodKind(%v) = %q, want %q", tc.segments, got, tc.want)
+			}
+		})
+	}
+}
+
+// Verifies nestiaCoreSegmentsHaveSuffix matches the suffix slice against
+// the trailing positions of the segment slice.
+//
+// The helper underpins every decorator-dispatch lookup. Off-by-one or
+// length-clamping bugs would silently mismatch `core.TypedQuery.Body`
+// against the suffix `["TypedQuery"]` — a regression flagged by the
+// existing decorator routing tests, but cheap to anchor at the helper
+// level too.
+//
+//  1. Exact length match returns true.
+//  2. Shorter segments than the suffix never match.
+//  3. Suffix tail of a longer segment list matches; prefix tail does not.
+func TestNestiaCoreSegmentsHaveSuffix(t *testing.T) {
+	cases := []struct {
+		name     string
+		segments []string
+		suffix   []string
+		want     bool
+	}{
+		{"exact match", []string{"TypedBody"}, []string{"TypedBody"}, true},
+		{"suffix of longer", []string{"core", "TypedBody"}, []string{"TypedBody"}, true},
+		{"two-segment suffix", []string{"core", "TypedQuery", "Body"}, []string{"TypedQuery", "Body"}, true},
+		{"suffix longer than segments", []string{"TypedBody"}, []string{"core", "TypedBody"}, false},
+		{"mismatched tail", []string{"core", "TypedBody"}, []string{"TypedRoute"}, false},
+		{"empty suffix", []string{"core", "TypedBody"}, []string{}, true},
+		{"both empty", []string{}, []string{}, true},
+	}
+	for _, tc := range cases {
+		t.Run(tc.name, func(t *testing.T) {
+			if got := nestiaCoreSegmentsHaveSuffix(tc.segments, tc.suffix); got != tc.want {
+				t.Fatalf("nestiaCoreSegmentsHaveSuffix(%v, %v) = %v, want %v", tc.segments, tc.suffix, got, tc.want)
+			}
+		})
+	}
+}

package/native/{cmd/ttsc-nestia → transform}/core_querify.go

@@ -1,4 +1,4 @@
-package main
+package transform
 
 import (
 	"fmt"