ttsc 0.7.2 → 0.8.0-dev.20260505

package/cmd/ttsc/build.go

@@ -1,15 +1,22 @@
+// Project-build command support for the native `ttsc` binary.
+//
+// The build lane accepts the same project-oriented shape as the JavaScript
+// launcher: resolve one tsconfig, create a TypeScript-Go program, optionally
+// emit JavaScript, and report diagnostics through the driver package. It does
+// not load project plugins itself; plugin-selected sidecars are invoked by the
+// JavaScript host before this command receives native work.
 package main
 
 import (
-	"encoding/json"
-	"flag"
-	"fmt"
-	"os"
-	"path/filepath"
+  "encoding/json"
+  "flag"
+  "fmt"
+  "os"
+  "path/filepath"
 
-	shimcompiler "github.com/microsoft/typescript-go/shim/compiler"
+  shimcompiler "github.com/microsoft/typescript-go/shim/compiler"
 
-	"github.com/samchon/ttsc/packages/ttsc/driver"
+  "github.com/samchon/ttsc/packages/ttsc/driver"
 )
 
 // runBuild implements the `ttsc` project-build lane. Two modes:
@@ -18,105 +25,111 @@ import (
 //   - --emit: also run tsgo's emit pipeline, patching every recognized native
 //     consumer call in the resulting .js files.
 func runBuild(args []string) int {
-	fs := flag.NewFlagSet("build", flag.ContinueOnError)
-	fs.SetOutput(stderr)
-	tsconfigPath := fs.String("tsconfig", "tsconfig.json", "path to tsconfig.json")
-	cwdOverride := fs.String("cwd", "", "override the working directory (defaults to process cwd)")
-	quiet := fs.Bool("quiet", true, "suppress the per-call diagnostic summary")
-	verbose := fs.Bool("verbose", false, "print the per-call diagnostic summary")
-	emit := fs.Bool("emit", false, "force emitted .js files (runs tsgo + ttsc rewrite)")
-	noEmit := fs.Bool("noEmit", false, "force analysis-only run with no file writes")
-	outDir := fs.String("outDir", "", "override compilerOptions.outDir for this build")
-	manifestPath := fs.String("manifest", "", "write emitted file list as JSON to this path")
-	if err := fs.Parse(args); err != nil {
-		return 2
-	}
-	if *emit && *noEmit {
-		fmt.Fprintln(stderr, "ttsc: --emit and --noEmit are mutually exclusive")
-		return 2
-	}
-	if *verbose {
-		*quiet = false
-	}
+  fs := flag.NewFlagSet("build", flag.ContinueOnError)
+  fs.SetOutput(stderr)
+  tsconfigPath := fs.String("tsconfig", "tsconfig.json", "path to tsconfig.json")
+  cwdOverride := fs.String("cwd", "", "override the working directory (defaults to process cwd)")
+  quiet := fs.Bool("quiet", true, "suppress the per-call diagnostic summary")
+  verbose := fs.Bool("verbose", false, "print the per-call diagnostic summary")
+  emit := fs.Bool("emit", false, "force emitted .js files (runs tsgo + ttsc rewrite)")
+  noEmit := fs.Bool("noEmit", false, "force analysis-only run with no file writes")
+  outDir := fs.String("outDir", "", "override compilerOptions.outDir for this build")
+  manifestPath := fs.String("manifest", "", "write emitted file list as JSON to this path")
+  if err := fs.Parse(args); err != nil {
+    return 2
+  }
+  if *emit && *noEmit {
+    fmt.Fprintln(stderr, "ttsc: --emit and --noEmit are mutually exclusive")
+    return 2
+  }
+  if *verbose {
+    *quiet = false
+  }
 
-	cwd := *cwdOverride
-	if cwd == "" {
-		var err error
-		cwd, err = os.Getwd()
-		if err != nil {
-			fmt.Fprintf(stderr, "ttsc: could not get working directory: %v\n", err)
-			return 2
-		}
-	}
+  cwd := *cwdOverride
+  if cwd == "" {
+    var err error
+    cwd, err = os.Getwd()
+    if err != nil {
+      fmt.Fprintf(stderr, "ttsc: could not get working directory: %v\n", err)
+      return 2
+    }
+  }
 
-	prog, diags, err := driver.LoadProgram(cwd, *tsconfigPath, driver.LoadProgramOptions{
-		ForceEmit:   *emit,
-		ForceNoEmit: *noEmit,
-		OutDir:      *outDir,
-	})
-	if err != nil {
-		fmt.Fprintf(stderr, "ttsc: %v\n", err)
-		return 2
-	}
-	if len(diags) > 0 {
-		driver.WritePrettyDiagnostics(stderr, diags, cwd)
-		return 2
-	}
-	defer prog.Close()
-	if diags := prog.Diagnostics(); len(diags) > 0 {
-		driver.WritePrettyDiagnostics(stderr, diags, cwd)
-		return 2
-	}
+  prog, diags, err := driver.LoadProgram(cwd, *tsconfigPath, driver.LoadProgramOptions{
+    ForceEmit:   *emit,
+    ForceNoEmit: *noEmit,
+    OutDir:      *outDir,
+  })
+  if err != nil {
+    fmt.Fprintf(stderr, "ttsc: %v\n", err)
+    return 2
+  }
+  if len(diags) > 0 {
+    driver.WritePrettyDiagnostics(stderr, diags, cwd)
+    return 2
+  }
+  defer prog.Close()
+  if diags := prog.Diagnostics(); len(diags) > 0 {
+    driver.WritePrettyDiagnostics(stderr, diags, cwd)
+    return 2
+  }
 
-	rewrites := driver.NewRewriteSet()
-	shouldEmit := !prog.ParsedConfig.ParsedConfig.CompilerOptions.NoEmit.IsTrue()
-	if !*quiet {
-		fmt.Fprintf(stdout, "// ttsc: tsconfig=%s cwd=%s sites=%d emit=%v\n", *tsconfigPath, cwd, 0, shouldEmit)
-	}
+  rewrites := driver.NewRewriteSet()
+  shouldEmit := !prog.ParsedConfig.ParsedConfig.CompilerOptions.NoEmit.IsTrue()
+  if !*quiet {
+    fmt.Fprintf(stdout, "// ttsc: tsconfig=%s cwd=%s sites=%d emit=%v\n", *tsconfigPath, cwd, 0, shouldEmit)
+  }
 
-	if shouldEmit {
-		writeFile := shimcompiler.WriteFile(
-			func(fileName, text string, _ *shimcompiler.WriteFileData) error {
-				return driver.DefaultWriteFile(fileName, text)
-			},
-		)
-		res, eDiags, err := prog.EmitAll(rewrites, writeFile)
-		if err != nil {
-			fmt.Fprintf(stderr, "ttsc: emit failed: %v\n", err)
-			return 3
-		}
-		for _, d := range eDiags {
-			fmt.Fprintln(stderr, "  -", d.String())
-		}
-		if !*quiet {
-			fmt.Fprintf(stdout, "// ttsc: emitted=%d files\n", len(res.EmittedFiles))
-			for _, f := range res.EmittedFiles {
-				rel := f
-				if abs, err := filepath.Rel(cwd, f); err == nil {
-					rel = abs
-				}
-				fmt.Fprintln(stdout, "  +", rel)
-			}
-		}
-		if *manifestPath != "" {
-			data, err := json.Marshal(res.EmittedFiles)
-			if err != nil {
-				fmt.Fprintf(stderr, "ttsc: manifest marshal failed: %v\n", err)
-				return 3
-			}
-			if err := os.MkdirAll(filepath.Dir(*manifestPath), 0o755); err != nil {
-				fmt.Fprintf(stderr, "ttsc: manifest mkdir failed: %v\n", err)
-				return 3
-			}
-			if err := os.WriteFile(*manifestPath, data, 0o644); err != nil {
-				fmt.Fprintf(stderr, "ttsc: manifest write failed: %v\n", err)
-				return 3
-			}
-		}
-	}
+  if shouldEmit {
+    // Emit is callback-driven in TypeScript-Go. ttsc keeps that shape and
+    // wraps only the final WriteFile step so native rewrites and custom output
+    // capture share the same path.
+    writeFile := shimcompiler.WriteFile(
+      func(fileName, text string, _ *shimcompiler.WriteFileData) error {
+        return driver.DefaultWriteFile(fileName, text)
+      },
+    )
+    res, eDiags, err := prog.EmitAll(rewrites, writeFile)
+    if err != nil {
+      fmt.Fprintf(stderr, "ttsc: emit failed: %v\n", err)
+      return 3
+    }
+    for _, d := range eDiags {
+      fmt.Fprintln(stderr, "  -", d.String())
+    }
+    if !*quiet {
+      fmt.Fprintf(stdout, "// ttsc: emitted=%d files\n", len(res.EmittedFiles))
+      for _, f := range res.EmittedFiles {
+        rel := f
+        if abs, err := filepath.Rel(cwd, f); err == nil {
+          rel = abs
+        }
+        fmt.Fprintln(stdout, "  +", rel)
+      }
+    }
+    if *manifestPath != "" {
+      // The manifest is intentionally just the emitted file list. Higher
+      // layers already know the project and tsconfig, and tests compare this
+      // array as the build contract.
+      data, err := json.Marshal(res.EmittedFiles)
+      if err != nil {
+        fmt.Fprintf(stderr, "ttsc: manifest marshal failed: %v\n", err)
+        return 3
+      }
+      if err := os.MkdirAll(filepath.Dir(*manifestPath), 0o755); err != nil {
+        fmt.Fprintf(stderr, "ttsc: manifest mkdir failed: %v\n", err)
+        return 3
+      }
+      if err := os.WriteFile(*manifestPath, data, 0o644); err != nil {
+        fmt.Fprintf(stderr, "ttsc: manifest write failed: %v\n", err)
+        return 3
+      }
+    }
+  }
 
-	if !*quiet {
-		fmt.Fprintf(stdout, "// ttsc: recognized=%d total=%d rewrites=%d\n", 0, 0, rewrites.Len())
-	}
-	return 0
+  if !*quiet {
+    fmt.Fprintf(stdout, "// ttsc: recognized=%d total=%d rewrites=%d\n", 0, 0, rewrites.Len())
+  }
+  return 0
 }

package/cmd/ttsc/main.go

@@ -12,121 +12,121 @@
 package main
 
 import (
-	"flag"
-	"fmt"
-	"io"
-	"os"
-	"runtime"
-	"strings"
+  "flag"
+  "fmt"
+  "io"
+  "os"
+  "runtime"
+  "strings"
 )
 
 // These are overridden via `-ldflags "-X main.version=... -X main.commit=..."`
 // in CI. Sensible defaults keep local `go run ./cmd/ttsc` usable.
 var (
-	version = "0.0.0-dev"
-	commit  = "dev"
-	date    = "unknown"
+  version = "0.0.0-dev"
+  commit  = "dev"
+  date    = "unknown"
 )
 
 // stdout / stderr are package-level to keep the CLI testable.
 var (
-	stdout io.Writer = os.Stdout
-	stderr io.Writer = os.Stderr
+  stdout io.Writer = os.Stdout
+  stderr io.Writer = os.Stderr
 )
 
 func main() {
-	os.Exit(run(os.Args[1:]))
+  os.Exit(run(os.Args[1:]))
 }
 
 func run(args []string) int {
-	if len(args) == 0 {
-		return runBuild(nil)
-	}
-
-	switch args[0] {
-	case "-h", "--help", "help":
-		printHelp(stdout)
-		return 0
-	case "-v", "--version", "version":
-		printVersion(stdout)
-		return 0
-	case "demo":
-		return runDemo(args[1:])
-	case "build":
-		return runBuild(args[1:])
-	case "api-compile":
-		return runAPICompile(args[1:])
-	case "api-transform":
-		return runAPITransform(args[1:])
-	case "check":
-		// `ttsc check` runs the analyze pipeline without emitting JS — useful
-		// in CI and pre-commit hooks that only need schema validation.
-		return runBuild(append([]string{"--noEmit"}, args[1:]...))
-	case "-p", "--project":
-		if len(args) < 2 {
-			fmt.Fprintln(stderr, "ttsc: -p/--project requires a path argument")
-			return 2
-		}
-		return runBuild(append([]string{"--tsconfig=" + args[1]}, args[2:]...))
-	default:
-		if isBuildAlias(args[0]) {
-			return runBuild(args)
-		}
-		fmt.Fprintf(stderr, "ttsc: unknown command %q\n", args[0])
-		fmt.Fprintln(stderr, `ttsc: run "ttsc --help" to see supported commands`)
-		return 2
-	}
+  if len(args) == 0 {
+    return runBuild(nil)
+  }
+
+  switch args[0] {
+  case "-h", "--help", "help":
+    printHelp(stdout)
+    return 0
+  case "-v", "--version", "version":
+    printVersion(stdout)
+    return 0
+  case "demo":
+    return runDemo(args[1:])
+  case "build":
+    return runBuild(args[1:])
+  case "api-compile":
+    return runAPICompile(args[1:])
+  case "api-transform":
+    return runAPITransform(args[1:])
+  case "check":
+    // `ttsc check` runs the analyze pipeline without emitting JS — useful
+    // in CI and pre-commit hooks that only need schema validation.
+    return runBuild(append([]string{"--noEmit"}, args[1:]...))
+  case "-p", "--project":
+    if len(args) < 2 {
+      fmt.Fprintln(stderr, "ttsc: -p/--project requires a path argument")
+      return 2
+    }
+    return runBuild(append([]string{"--tsconfig=" + args[1]}, args[2:]...))
+  default:
+    if isBuildAlias(args[0]) {
+      return runBuild(args)
+    }
+    fmt.Fprintf(stderr, "ttsc: unknown command %q\n", args[0])
+    fmt.Fprintln(stderr, `ttsc: run "ttsc --help" to see supported commands`)
+    return 2
+  }
 }
 
 func isBuildAlias(arg string) bool {
-	if strings.HasPrefix(arg, "-") {
-		return true
-	}
-	switch {
-	case strings.HasSuffix(arg, ".json"),
-		strings.HasSuffix(arg, ".ts"),
-		strings.HasSuffix(arg, ".tsx"),
-		strings.HasSuffix(arg, ".mts"),
-		strings.HasSuffix(arg, ".cts"):
-		return true
-	default:
-		return false
-	}
+  if strings.HasPrefix(arg, "-") {
+    return true
+  }
+  switch {
+  case strings.HasSuffix(arg, ".json"),
+    strings.HasSuffix(arg, ".ts"),
+    strings.HasSuffix(arg, ".tsx"),
+    strings.HasSuffix(arg, ".mts"),
+    strings.HasSuffix(arg, ".cts"):
+    return true
+  default:
+    return false
+  }
 }
 
 // appendUnique appends `extra` to `args` only when it's not already present.
 func appendUnique(args []string, extra ...string) []string {
-	out := append([]string{}, args...)
-	for _, e := range extra {
-		seen := false
-		for _, a := range out {
-			if a == e {
-				seen = true
-				break
-			}
-		}
-		if !seen {
-			out = append(out, e)
-		}
-	}
-	return out
+  out := append([]string{}, args...)
+  for _, e := range extra {
+    seen := false
+    for _, a := range out {
+      if a == e {
+        seen = true
+        break
+      }
+    }
+    if !seen {
+      out = append(out, e)
+    }
+  }
+  return out
 }
 
 func printVersion(w io.Writer) {
-	fmt.Fprintf(
-		w,
-		"ttsc %s (commit %s, built %s, %s/%s, go %s)\n",
-		version,
-		commit,
-		date,
-		runtime.GOOS,
-		runtime.GOARCH,
-		runtime.Version(),
-	)
+  fmt.Fprintf(
+    w,
+    "ttsc %s (commit %s, built %s, %s/%s, go %s)\n",
+    version,
+    commit,
+    date,
+    runtime.GOOS,
+    runtime.GOARCH,
+    runtime.Version(),
+  )
 }
 
 func printHelp(w io.Writer) {
-	fmt.Fprintln(w, strings.TrimSpace(`
+  fmt.Fprintln(w, strings.TrimSpace(`
 ttsc — standalone typescript-go host.
 
 Usage:
@@ -172,37 +172,37 @@ Integration guide (bundlers):
 }
 
 func runDemo(args []string) int {
-	fs := flag.NewFlagSet("demo", flag.ContinueOnError)
-	fs.SetOutput(stderr)
-	typ := fs.String("type", "string", "atomic type to simulate")
-	if err := fs.Parse(args); err != nil {
-		return 2
-	}
-
-	arrow, err := demoArrow(*typ)
-	if err != nil {
-		fmt.Fprintf(stderr, "ttsc demo: %v\n", err)
-		return 2
-	}
-
-	fmt.Fprintf(stdout, "// demo<%s> -> emitted by ttsc %s\n", *typ, version)
-	fmt.Fprintln(stdout, arrow)
-	return 0
+  fs := flag.NewFlagSet("demo", flag.ContinueOnError)
+  fs.SetOutput(stderr)
+  typ := fs.String("type", "string", "atomic type to simulate")
+  if err := fs.Parse(args); err != nil {
+    return 2
+  }
+
+  arrow, err := demoArrow(*typ)
+  if err != nil {
+    fmt.Fprintf(stderr, "ttsc demo: %v\n", err)
+    return 2
+  }
+
+  fmt.Fprintf(stdout, "// demo<%s> -> emitted by ttsc %s\n", *typ, version)
+  fmt.Fprintln(stdout, arrow)
+  return 0
 }
 
 func demoArrow(name string) (string, error) {
-	switch strings.ToLower(name) {
-	case "any":
-		return "(input) => true", nil
-	case "boolean":
-		return `(input) => "boolean" === typeof input`, nil
-	case "number":
-		return `(input) => "number" === typeof input`, nil
-	case "bigint":
-		return `(input) => "bigint" === typeof input`, nil
-	case "string", "":
-		return `(input) => "string" === typeof input`, nil
-	default:
-		return "", fmt.Errorf("unknown --type value %q (want: string|number|boolean|bigint|any)", name)
-	}
+  switch strings.ToLower(name) {
+  case "any":
+    return "(input) => true", nil
+  case "boolean":
+    return `(input) => "boolean" === typeof input`, nil
+  case "number":
+    return `(input) => "number" === typeof input`, nil
+  case "bigint":
+    return `(input) => "bigint" === typeof input`, nil
+  case "string", "":
+    return `(input) => "string" === typeof input`, nil
+  default:
+    return "", fmt.Errorf("unknown --type value %q (want: string|number|boolean|bigint|any)", name)
+  }
 }