typia 13.1.1 → 13.2.0

package/native/cmd/ttsc-typia/project_dependencies_local_reexport_transform_test.go

@@ -0,0 +1,122 @@
+package main
+
+import (
+  "encoding/json"
+  "os"
+  "path/filepath"
+  "testing"
+)
+
+// TestProjectDependenciesLocalReexportTransform verifies a barrel that imports
+// a name before re-exporting it still reports the module it imported from.
+//
+// `export { Alpha } from "./mid"` carries its module on the export declaration,
+// but the equivalent `import { Alpha } from "./mid"; export { Alpha };` carries
+// none: the export specifier re-publishes a LOCAL binding. A walk that reads
+// only export declarations therefore loses `mid.ts` — while re-pointing that
+// import still changes the generated validator, which is the same missing-edge
+// defect in a second syntactic form (samchon/typia#2126).
+//
+//  1. Build a project where `a.ts` validates `Alpha` from `barrel.ts`, which
+//     imports it from `mid.ts` and re-exports the local binding; `mid.ts` in
+//     turn re-exports it from `real.ts`.
+//  2. Run project transform mode and decode the JSON envelope.
+//  3. Assert `dependencies["src/a.ts"]` contains `barrel.ts`, the intermediate
+//     `mid.ts`, and the concrete `real.ts`.
+//  4. Assert it does NOT contain `beta.ts`, which `barrel.ts` also imports but
+//     no consulted type reaches.
+func TestProjectDependenciesLocalReexportTransform(t *testing.T) {
+  project := projectDependenciesLocalReexportProject(t)
+  out, errText, code := ttscTypiaTestCapture(func() int {
+    return runTransform([]string{
+      "--cwd", project,
+      "--tsconfig", "tsconfig.json",
+      "--output", "ts",
+    })
+  })
+  if code != 0 {
+    t.Fatalf("project transform failed: code=%d stderr=\n%s", code, errText)
+  }
+  var envelope struct {
+    Dependencies map[string][]string `json:"dependencies"`
+  }
+  if err := json.Unmarshal([]byte(out), &envelope); err != nil {
+    t.Fatalf("decode envelope: %v\n%s", err, out)
+  }
+  entries := envelope.Dependencies["src/a.ts"]
+  found := map[string]bool{}
+  for _, entry := range entries {
+    found[entry] = true
+  }
+  if !found["src/barrel.ts"] {
+    t.Fatalf("dependencies of src/a.ts must contain the barrel src/barrel.ts: %v", entries)
+  }
+  if !found["src/mid.ts"] {
+    t.Fatalf("dependencies of src/a.ts must contain the locally re-exported module src/mid.ts: %v", entries)
+  }
+  if !found["src/real.ts"] {
+    t.Fatalf("dependencies of src/a.ts must contain the concrete module src/real.ts: %v", entries)
+  }
+  if found["src/beta.ts"] {
+    t.Fatalf("dependencies of src/a.ts must not contain src/beta.ts, which the barrel imports but no consulted type reaches: %v", entries)
+  }
+}
+
+func projectDependenciesLocalReexportProject(t *testing.T) string {
+  t.Helper()
+  root := ttscTypiaTestRepoRoot(t)
+  base := filepath.Join(root, "packages", "typia", "native", ".tmp-ttsc-typia-tests")
+  if err := os.MkdirAll(base, 0o755); err != nil {
+    t.Fatalf("mkdir temp base: %v", err)
+  }
+  dir, err := os.MkdirTemp(base, "project-dependencies-local-reexport-")
+  if err != nil {
+    t.Fatalf("create temp fixture: %v", err)
+  }
+  t.Cleanup(func() { _ = os.RemoveAll(dir) })
+  src := filepath.Join(dir, "src")
+  if err := os.MkdirAll(src, 0o755); err != nil {
+    t.Fatalf("mkdir fixture src: %v", err)
+  }
+  if err := os.WriteFile(filepath.Join(dir, "tsconfig.json"), []byte(projectDependenciesEnvelopeTSConfig), 0o644); err != nil {
+    t.Fatalf("write tsconfig: %v", err)
+  }
+  for name, body := range map[string]string{
+    "a.ts":      projectDependenciesLocalReexportSourceA,
+    "barrel.ts": projectDependenciesLocalReexportSourceBarrel,
+    "mid.ts":    projectDependenciesLocalReexportSourceMid,
+    "real.ts":   projectDependenciesLocalReexportSourceReal,
+    "beta.ts":   projectDependenciesLocalReexportSourceBeta,
+  } {
+    if err := os.WriteFile(filepath.Join(src, name), []byte(body), 0o644); err != nil {
+      t.Fatalf("write %s: %v", name, err)
+    }
+  }
+  return dir
+}
+
+const projectDependenciesLocalReexportSourceA = `import typia from "typia";
+
+import { Alpha } from "./barrel";
+
+export const validateAlpha = (input: unknown) => typia.validate<Alpha>(input);
+`
+
+const projectDependenciesLocalReexportSourceBarrel = `import { Alpha } from "./mid";
+import { Beta } from "./beta";
+
+export { Alpha, Beta };
+`
+
+const projectDependenciesLocalReexportSourceMid = `export { Alpha } from "./real";
+`
+
+const projectDependenciesLocalReexportSourceReal = `export interface Alpha {
+  id: string;
+}
+`
+
+const projectDependenciesLocalReexportSourceBeta = `export interface Beta {
+  flag: boolean;
+}
+`

package/native/cmd/ttsc-typia/project_dependencies_signature_alias_transform_test.go

@@ -0,0 +1,125 @@
+package main
+
+import (
+  "encoding/json"
+  "os"
+  "path/filepath"
+  "testing"
+)
+
+// TestProjectDependenciesSignatureAliasTransform verifies call- and
+// construct-signature types stay OUT of the reported dependencies.
+//
+// `dependencies` must name every file whose edit can change the generated
+// output — and only those. Typia validates a callable as `typeof x ===
+// "function"` and never inspects its parameter or return types, so editing
+// them provably cannot change the emitted validator; reporting them would
+// invalidate consumers on edits that cannot affect them. This is the negative
+// half of samchon/typia#2126, whose positive half adds the barrel and
+// index-signature edges: the two were confirmed by the same probe, which showed
+// the generated output is unchanged across these edits.
+//
+//  1. Build a project where `a.ts` validates `Target` from `model.ts`, whose
+//     call signature returns `CallRet` (`callret.ts`) and whose construct
+//     signature returns `NewRet` (`newret.ts`), while an ordinary property
+//     references `Kept` (`kept.ts`).
+//  2. Run project transform mode and decode the JSON envelope.
+//  3. Assert `dependencies["src/a.ts"]` contains `model.ts` and `kept.ts`, so
+//     the fixture is genuinely analyzed.
+//  4. Assert it contains neither `callret.ts` nor `newret.ts`.
+func TestProjectDependenciesSignatureAliasTransform(t *testing.T) {
+  project := projectDependenciesSignatureAliasProject(t)
+  out, errText, code := ttscTypiaTestCapture(func() int {
+    return runTransform([]string{
+      "--cwd", project,
+      "--tsconfig", "tsconfig.json",
+      "--output", "ts",
+    })
+  })
+  if code != 0 {
+    t.Fatalf("project transform failed: code=%d stderr=\n%s", code, errText)
+  }
+  var envelope struct {
+    Dependencies map[string][]string `json:"dependencies"`
+  }
+  if err := json.Unmarshal([]byte(out), &envelope); err != nil {
+    t.Fatalf("decode envelope: %v\n%s", err, out)
+  }
+  entries := envelope.Dependencies["src/a.ts"]
+  found := map[string]bool{}
+  for _, entry := range entries {
+    found[entry] = true
+  }
+  if !found["src/model.ts"] {
+    t.Fatalf("dependencies of src/a.ts must contain the declaring file src/model.ts: %v", entries)
+  }
+  if !found["src/kept.ts"] {
+    t.Fatalf("dependencies of src/a.ts must contain the consulted property alias file src/kept.ts: %v", entries)
+  }
+  if found["src/callret.ts"] {
+    t.Fatalf("dependencies of src/a.ts must not contain src/callret.ts: a call signature's return type cannot change the generated validator: %v", entries)
+  }
+  if found["src/newret.ts"] {
+    t.Fatalf("dependencies of src/a.ts must not contain src/newret.ts: a construct signature's return type cannot change the generated validator: %v", entries)
+  }
+}
+
+func projectDependenciesSignatureAliasProject(t *testing.T) string {
+  t.Helper()
+  root := ttscTypiaTestRepoRoot(t)
+  base := filepath.Join(root, "packages", "typia", "native", ".tmp-ttsc-typia-tests")
+  if err := os.MkdirAll(base, 0o755); err != nil {
+    t.Fatalf("mkdir temp base: %v", err)
+  }
+  dir, err := os.MkdirTemp(base, "project-dependencies-signature-alias-")
+  if err != nil {
+    t.Fatalf("create temp fixture: %v", err)
+  }
+  t.Cleanup(func() { _ = os.RemoveAll(dir) })
+  src := filepath.Join(dir, "src")
+  if err := os.MkdirAll(src, 0o755); err != nil {
+    t.Fatalf("mkdir fixture src: %v", err)
+  }
+  if err := os.WriteFile(filepath.Join(dir, "tsconfig.json"), []byte(projectDependenciesEnvelopeTSConfig), 0o644); err != nil {
+    t.Fatalf("write tsconfig: %v", err)
+  }
+  for name, body := range map[string]string{
+    "a.ts":       projectDependenciesSignatureAliasSourceA,
+    "model.ts":   projectDependenciesSignatureAliasSourceModel,
+    "callret.ts": projectDependenciesSignatureAliasSourceCallRet,
+    "newret.ts":  projectDependenciesSignatureAliasSourceNewRet,
+    "kept.ts":    projectDependenciesSignatureAliasSourceKept,
+  } {
+    if err := os.WriteFile(filepath.Join(src, name), []byte(body), 0o644); err != nil {
+      t.Fatalf("write %s: %v", name, err)
+    }
+  }
+  return dir
+}
+
+const projectDependenciesSignatureAliasSourceA = `import typia from "typia";
+
+import { Target } from "./model";
+
+export const validateTarget = (input: unknown) => typia.validate<Target>(input);
+`
+
+const projectDependenciesSignatureAliasSourceModel = `import { CallRet } from "./callret";
+import { Kept } from "./kept";
+import { NewRet } from "./newret";
+
+export interface Target {
+  kept: Kept;
+  (arg: string): CallRet;
+  new (arg: string): NewRet;
+}
+`
+
+const projectDependenciesSignatureAliasSourceCallRet = `export type CallRet = string;
+`
+
+const projectDependenciesSignatureAliasSourceNewRet = `export type NewRet = string;
+`
+
+const projectDependenciesSignatureAliasSourceKept = `export type Kept = number;
+`

package/native/cmd/ttsc-typia/project_dependencies_star_barrel_transform_test.go

@@ -0,0 +1,112 @@
+package main
+
+import (
+  "encoding/json"
+  "os"
+  "path/filepath"
+  "testing"
+)
+
+// TestProjectDependenciesStarBarrelTransform verifies a barrel reached through
+// `export *` registers, even though no local specifier names the type.
+//
+// A named re-export publishes an export specifier the alias walk can step
+// through hop by hop; `export * from "./alpha"` publishes none, so that walk
+// has nothing to follow and would stop before reporting the barrel — while
+// re-pointing the star at another module still changes the generated validator
+// (samchon/typia#2126). The walk therefore reports each module specifier's
+// resolved file directly, which is what keeps this shape covered.
+//
+//  1. Build a project where `a.ts` validates `Alpha` imported from `barrel.ts`,
+//     which reaches it only through `export * from "./alpha"`.
+//  2. Run project transform mode and decode the JSON envelope.
+//  3. Assert `dependencies["src/a.ts"]` contains the star barrel `barrel.ts`
+//     and the concrete module `alpha.ts`.
+//  4. Assert it does NOT contain `beta.ts`, a module the same barrel also stars
+//     in but no consulted type reaches.
+func TestProjectDependenciesStarBarrelTransform(t *testing.T) {
+  project := projectDependenciesStarBarrelProject(t)
+  out, errText, code := ttscTypiaTestCapture(func() int {
+    return runTransform([]string{
+      "--cwd", project,
+      "--tsconfig", "tsconfig.json",
+      "--output", "ts",
+    })
+  })
+  if code != 0 {
+    t.Fatalf("project transform failed: code=%d stderr=\n%s", code, errText)
+  }
+  var envelope struct {
+    Dependencies map[string][]string `json:"dependencies"`
+  }
+  if err := json.Unmarshal([]byte(out), &envelope); err != nil {
+    t.Fatalf("decode envelope: %v\n%s", err, out)
+  }
+  entries := envelope.Dependencies["src/a.ts"]
+  found := map[string]bool{}
+  for _, entry := range entries {
+    found[entry] = true
+  }
+  if !found["src/barrel.ts"] {
+    t.Fatalf("dependencies of src/a.ts must contain the star barrel src/barrel.ts: %v", entries)
+  }
+  if !found["src/alpha.ts"] {
+    t.Fatalf("dependencies of src/a.ts must contain the concrete module src/alpha.ts: %v", entries)
+  }
+  if found["src/beta.ts"] {
+    t.Fatalf("dependencies of src/a.ts must not contain src/beta.ts, which the barrel stars in but no consulted type reaches: %v", entries)
+  }
+}
+
+func projectDependenciesStarBarrelProject(t *testing.T) string {
+  t.Helper()
+  root := ttscTypiaTestRepoRoot(t)
+  base := filepath.Join(root, "packages", "typia", "native", ".tmp-ttsc-typia-tests")
+  if err := os.MkdirAll(base, 0o755); err != nil {
+    t.Fatalf("mkdir temp base: %v", err)
+  }
+  dir, err := os.MkdirTemp(base, "project-dependencies-star-barrel-")
+  if err != nil {
+    t.Fatalf("create temp fixture: %v", err)
+  }
+  t.Cleanup(func() { _ = os.RemoveAll(dir) })
+  src := filepath.Join(dir, "src")
+  if err := os.MkdirAll(src, 0o755); err != nil {
+    t.Fatalf("mkdir fixture src: %v", err)
+  }
+  if err := os.WriteFile(filepath.Join(dir, "tsconfig.json"), []byte(projectDependenciesEnvelopeTSConfig), 0o644); err != nil {
+    t.Fatalf("write tsconfig: %v", err)
+  }
+  for name, body := range map[string]string{
+    "a.ts":      projectDependenciesStarBarrelSourceA,
+    "barrel.ts": projectDependenciesStarBarrelSourceBarrel,
+    "alpha.ts":  projectDependenciesStarBarrelSourceAlpha,
+    "beta.ts":   projectDependenciesStarBarrelSourceBeta,
+  } {
+    if err := os.WriteFile(filepath.Join(src, name), []byte(body), 0o644); err != nil {
+      t.Fatalf("write %s: %v", name, err)
+    }
+  }
+  return dir
+}
+
+const projectDependenciesStarBarrelSourceA = `import typia from "typia";
+
+import { Alpha } from "./barrel";
+
+export const validateAlpha = (input: unknown) => typia.validate<Alpha>(input);
+`
+
+const projectDependenciesStarBarrelSourceBarrel = `export * from "./alpha";
+export * from "./beta";
+`
+
+const projectDependenciesStarBarrelSourceAlpha = `export interface Alpha {
+  id: string;
+}
+`
+
+const projectDependenciesStarBarrelSourceBeta = `export interface Beta {
+  flag: boolean;
+}
+`

package/native/cmd/ttsc-typia/project_reference_graph_envelope_transform_test.go

@@ -0,0 +1,190 @@
+package main
+
+import (
+  "encoding/json"
+  "os"
+  "path/filepath"
+  "testing"
+)
+
+// TestProjectReferenceGraphEnvelopeTransform verifies the project transform
+// envelope carries the ttsc driver SDK's host-owned reference `graph` section
+// alongside typia's precise `dependencies`.
+//
+// `graph` is the plugin-agnostic sound invalidation baseline: the ttsc consumer
+// registers reach(edges, F) ∪ globals ∪ configs ∪ dependencies[F], so a
+// consulted file the precise `dependencies` collection might not attribute is
+// still guarded by the host baseline (samchon/typia#2107). This pins that
+// typia's hand-rolled envelope now routes through driver.NewTransformGraph:
+// direct reference edges (type-only included), ambient global-scope files, and
+// the tsconfig `extends` chain, all keyed by the same driver.TransformOutputKey
+// convention as the `typescript`/`dependencies` sections so a consumer joins
+// them by key.
+//
+//  1. Build a project where `a.ts` imports `Bee` from `b.ts` (and calls
+//     `typia.validate<Bee>()`), `b.ts` imports type-only `Cee` from `c.ts`, an
+//     ambient `globals.d.ts` contributes a global augmentation, and
+//     `tsconfig.json` extends `tsconfig.base.json`.
+//  2. Run project transform mode and decode the JSON envelope's `graph`.
+//  3. Assert the `a.ts -> b.ts` and the type-only `b.ts -> c.ts` edges, the
+//     `globals.d.ts` global entry, and the `tsconfig.json` + `tsconfig.base.json`
+//     configs chain, all under keys that join with the `typescript` section.
+//  4. Assert `dependencies` is still emitted next to `graph`, and that a
+//     non-global source is not misreported as a global.
+func TestProjectReferenceGraphEnvelopeTransform(t *testing.T) {
+  project := projectReferenceGraphEnvelopeProject(t)
+  out, errText, code := ttscTypiaTestCapture(func() int {
+    return runTransform([]string{
+      "--cwd", project,
+      "--tsconfig", "tsconfig.json",
+      "--output", "ts",
+    })
+  })
+  if code != 0 {
+    t.Fatalf("project transform failed: code=%d stderr=\n%s", code, errText)
+  }
+  var envelope struct {
+    TypeScript map[string]string `json:"typescript"`
+    Graph      *struct {
+      Edges   map[string][]string `json:"edges"`
+      Globals []string            `json:"globals"`
+      Configs []string            `json:"configs"`
+    } `json:"graph"`
+    Dependencies map[string][]string `json:"dependencies"`
+  }
+  if err := json.Unmarshal([]byte(out), &envelope); err != nil {
+    t.Fatalf("decode envelope: %v\n%s", err, out)
+  }
+  if envelope.Graph == nil {
+    t.Fatalf("envelope must carry a graph section:\n%s", out)
+  }
+  if _, ok := envelope.TypeScript["src/a.ts"]; !ok {
+    t.Fatalf("typescript map must contain src/a.ts (graph keys join with it):\n%s", out)
+  }
+
+  contains := func(values []string, want string) bool {
+    for _, value := range values {
+      if value == want {
+        return true
+      }
+    }
+    return false
+  }
+
+  // Direct resolved edge from the transformed file to its import.
+  if !contains(envelope.Graph.Edges["src/a.ts"], "src/b.ts") {
+    t.Fatalf("graph edges of src/a.ts must contain src/b.ts: %v", envelope.Graph.Edges["src/a.ts"])
+  }
+  // Type-only edges must be included: b.ts imports Cee with `import type`.
+  if !contains(envelope.Graph.Edges["src/b.ts"], "src/c.ts") {
+    t.Fatalf("graph edges of src/b.ts must contain the type-only edge src/c.ts: %v", envelope.Graph.Edges["src/b.ts"])
+  }
+  // Ambient global-scope file appears in globals.
+  if !contains(envelope.Graph.Globals, "src/globals.d.ts") {
+    t.Fatalf("graph globals must contain src/globals.d.ts: %v", envelope.Graph.Globals)
+  }
+  // A plain module source is not a global-scope contributor.
+  if contains(envelope.Graph.Globals, "src/c.ts") {
+    t.Fatalf("graph globals must not contain the module source src/c.ts: %v", envelope.Graph.Globals)
+  }
+  // tsconfig extends chain: project config followed by its base.
+  if !contains(envelope.Graph.Configs, "tsconfig.json") {
+    t.Fatalf("graph configs must contain tsconfig.json: %v", envelope.Graph.Configs)
+  }
+  if !contains(envelope.Graph.Configs, "tsconfig.base.json") {
+    t.Fatalf("graph configs must contain the extended tsconfig.base.json: %v", envelope.Graph.Configs)
+  }
+
+  // The precise dependencies channel remains emitted alongside graph.
+  if !contains(envelope.Dependencies["src/a.ts"], "src/b.ts") {
+    t.Fatalf("dependencies of src/a.ts must still be emitted alongside graph: %v", envelope.Dependencies["src/a.ts"])
+  }
+}
+
+func projectReferenceGraphEnvelopeProject(t *testing.T) string {
+  t.Helper()
+  root := ttscTypiaTestRepoRoot(t)
+  base := filepath.Join(root, "packages", "typia", "native", ".tmp-ttsc-typia-tests")
+  if err := os.MkdirAll(base, 0o755); err != nil {
+    t.Fatalf("mkdir temp base: %v", err)
+  }
+  dir, err := os.MkdirTemp(base, "project-reference-graph-envelope-")
+  if err != nil {
+    t.Fatalf("create temp fixture: %v", err)
+  }
+  t.Cleanup(func() { _ = os.RemoveAll(dir) })
+  src := filepath.Join(dir, "src")
+  if err := os.MkdirAll(src, 0o755); err != nil {
+    t.Fatalf("mkdir fixture src: %v", err)
+  }
+  files := map[string]string{
+    "tsconfig.json":      projectReferenceGraphEnvelopeTSConfig,
+    "tsconfig.base.json": projectReferenceGraphEnvelopeTSConfigBase,
+  }
+  for name, body := range files {
+    if err := os.WriteFile(filepath.Join(dir, name), []byte(body), 0o644); err != nil {
+      t.Fatalf("write %s: %v", name, err)
+    }
+  }
+  for name, body := range map[string]string{
+    "a.ts":         projectReferenceGraphEnvelopeSourceA,
+    "b.ts":         projectReferenceGraphEnvelopeSourceB,
+    "c.ts":         projectReferenceGraphEnvelopeSourceC,
+    "globals.d.ts": projectReferenceGraphEnvelopeGlobals,
+  } {
+    if err := os.WriteFile(filepath.Join(src, name), []byte(body), 0o644); err != nil {
+      t.Fatalf("write %s: %v", name, err)
+    }
+  }
+  return dir
+}
+
+const projectReferenceGraphEnvelopeTSConfig = `{
+  "extends": "./tsconfig.base.json",
+  "compilerOptions": {
+    "rootDir": "src",
+    "outDir": "dist"
+  },
+  "include": ["src"]
+}
+`
+
+const projectReferenceGraphEnvelopeTSConfigBase = `{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "commonjs",
+    "moduleResolution": "bundler",
+    "ignoreDeprecations": "6.0",
+    "esModuleInterop": true,
+    "strict": true,
+    "skipLibCheck": true
+  }
+}
+`
+
+const projectReferenceGraphEnvelopeSourceA = `import typia from "typia";
+
+import { Bee } from "./b";
+
+export const validateBee = (input: unknown) => typia.validate<Bee>(input);
+`
+
+const projectReferenceGraphEnvelopeSourceB = `import type { Cee } from "./c";
+
+export interface Bee {
+  id: string;
+  nested: Cee;
+}
+`
+
+const projectReferenceGraphEnvelopeSourceC = `export interface Cee {
+  value: number;
+}
+`
+
+// A pure ambient declaration file (no import/export) is a script file, so it
+// contributes to the global scope and must appear in graph.globals.
+const projectReferenceGraphEnvelopeGlobals = `declare interface TypiaGraphGlobal {
+  tag: string;
+}
+`