ttsc 0.12.3 → 0.12.4

package/cmd/platform/main.go

@@ -34,6 +34,9 @@ func main() {
   os.Exit(run(os.Args[1:]))
 }
 
+// run dispatches CLI arguments for the platform helper binary. With no
+// arguments it prints the help text. build/check print an explanatory error
+// directing users to the JavaScript launcher instead of failing silently.
 func run(args []string) int {
   if len(args) == 0 {
     printHelp(stdout)
@@ -91,6 +94,9 @@ Usage:
 `))
 }
 
+// runDemo implements the demo sub-command, printing a synthetic JavaScript
+// arrow function for the requested atomic type. Smoke tests in CI invoke this
+// to verify the binary executes correctly.
 func runDemo(args []string) int {
   fs := flag.NewFlagSet("demo", flag.ContinueOnError)
   fs.SetOutput(stderr)
@@ -110,6 +116,9 @@ func runDemo(args []string) int {
   return 0
 }
 
+// demoArrow returns a JavaScript arrow-function expression for the named
+// atomic TypeScript type. It is the platform-helper counterpart of the same
+// function in cmd/ttsc, kept separate to avoid a shared-binary dependency.
 func demoArrow(name string) (string, error) {
   switch strings.ToLower(name) {
   case "any":

package/cmd/ttsc/api_compile.go

@@ -7,24 +7,24 @@
 package main
 
 import (
-	"encoding/json"
-	"flag"
-	"fmt"
-	"path/filepath"
-	"strings"
+  "encoding/json"
+  "flag"
+  "fmt"
+  "path/filepath"
+  "strings"
 
-	shimcompiler "github.com/microsoft/typescript-go/shim/compiler"
+  shimcompiler "github.com/microsoft/typescript-go/shim/compiler"
 
-	"github.com/samchon/ttsc/packages/ttsc/driver"
-	cwdutil "github.com/samchon/ttsc/packages/ttsc/internal/cwd"
+  "github.com/samchon/ttsc/packages/ttsc/driver"
+  cwdutil "github.com/samchon/ttsc/packages/ttsc/internal/cwd"
 )
 
 type apiCompileResult struct {
-	// Diagnostics is omitted only when the compiler produced no diagnostics.
-	// Output is still returned in diagnostic cases because TypeScript-Go may
-	// produce partial emit text before a build-failing error is reported.
-	Diagnostics []apiCompileDiagnostic `json:"diagnostics,omitempty"`
-	Output      map[string]string      `json:"output"`
+  // Diagnostics is omitted only when the compiler produced no diagnostics.
+  // Output is still returned in diagnostic cases because TypeScript-Go may
+  // produce partial emit text before a build-failing error is reported.
+  Diagnostics []apiCompileDiagnostic `json:"diagnostics,omitempty"`
+  Output      map[string]string      `json:"output"`
 }
 
 // apiCompileDiagnostic mirrors the public TypeScript-side diagnostic DTO.
@@ -32,109 +32,117 @@ type apiCompileResult struct {
 // `character`) instead of Go naming so callers can pass the data through
 // without remapping.
 type apiCompileDiagnostic struct {
-	File        *string `json:"file"`
-	Category    string  `json:"category"`
-	Code        int32   `json:"code"`
-	Start       *int    `json:"start,omitempty"`
-	Length      *int    `json:"length,omitempty"`
-	Line        int     `json:"line,omitempty"`
-	Character   int     `json:"character,omitempty"`
-	MessageText string  `json:"messageText"`
+  File        *string `json:"file"`
+  Category    string  `json:"category"`
+  Code        int32   `json:"code"`
+  Start       *int    `json:"start,omitempty"`
+  Length      *int    `json:"length,omitempty"`
+  Line        int     `json:"line,omitempty"`
+  Character   int     `json:"character,omitempty"`
+  MessageText string  `json:"messageText"`
 }
 
 func runAPICompile(args []string) int {
-	fs := flag.NewFlagSet("api-compile", flag.ContinueOnError)
-	fs.SetOutput(stderr)
-	tsconfigPath := fs.String("tsconfig", "tsconfig.json", "path to tsconfig.json")
-	cwdOverride := fs.String("cwd", "", "override the working directory")
-	if err := fs.Parse(args); err != nil {
-		return 2
-	}
+  fs := flag.NewFlagSet("api-compile", flag.ContinueOnError)
+  fs.SetOutput(stderr)
+  tsconfigPath := fs.String("tsconfig", "tsconfig.json", "path to tsconfig.json")
+  cwdOverride := fs.String("cwd", "", "override the working directory")
+  if err := fs.Parse(args); err != nil {
+    return 2
+  }
 
-	cwd, err := cwdutil.Resolve(*cwdOverride, getwd)
-	if err != nil {
-		fmt.Fprintf(stderr, "ttsc: %v\n", err)
-		return 2
-	}
+  cwd, err := cwdutil.Resolve(*cwdOverride, getwd)
+  if err != nil {
+    fmt.Fprintf(stderr, "ttsc: %v\n", err)
+    return 2
+  }
 
-	prog, diags, err := driver.LoadProgram(cwd, *tsconfigPath, driver.LoadProgramOptions{
-		ForceEmit: true,
-	})
-	if err != nil {
-		fmt.Fprintf(stderr, "ttsc api-compile: %v\n", err)
-		return 2
-	}
-	if prog != nil {
-		defer prog.Close()
-		diags = append(diags, prog.Diagnostics()...)
-	}
+  prog, diags, err := driver.LoadProgram(cwd, *tsconfigPath, driver.LoadProgramOptions{
+    ForceEmit: true,
+  })
+  if err != nil {
+    fmt.Fprintf(stderr, "ttsc api-compile: %v\n", err)
+    return 2
+  }
+  if prog != nil {
+    defer prog.Close()
+    diags = append(diags, prog.Diagnostics()...)
+  }
 
-	output := map[string]string{}
-	if prog != nil {
-		rewrites := driver.NewRewriteSet()
-		// Capture WriteFile output in a map keyed by project-relative paths. This
-		// gives the JS API a deterministic object and avoids touching outDir.
-		writeFile := shimcompiler.WriteFile(
-			func(fileName, text string, _ *shimcompiler.WriteFileData) error {
-				output[apiOutputKey(cwd, fileName)] = text
-				return nil
-			},
-		)
-		_, emitDiags, err := prog.EmitAll(rewrites, writeFile)
-		if err != nil {
-			fmt.Fprintf(stderr, "ttsc api-compile: emit failed: %v\n", err)
-			return 3
-		}
-		diags = append(diags, emitDiags...)
-	}
+  output := map[string]string{}
+  if prog != nil {
+    rewrites := driver.NewRewriteSet()
+    // Capture WriteFile output in a map keyed by project-relative paths. This
+    // gives the JS API a deterministic object and avoids touching outDir.
+    writeFile := shimcompiler.WriteFile(
+      func(fileName, text string, _ *shimcompiler.WriteFileData) error {
+        output[apiOutputKey(cwd, fileName)] = text
+        return nil
+      },
+    )
+    _, emitDiags, err := prog.EmitAll(rewrites, writeFile)
+    if err != nil {
+      fmt.Fprintf(stderr, "ttsc api-compile: emit failed: %v\n", err)
+      return 3
+    }
+    diags = append(diags, emitDiags...)
+  }
 
-	result := apiCompileResult{
-		Diagnostics: make([]apiCompileDiagnostic, 0, len(diags)),
-		Output:      output,
-	}
-	for _, diag := range diags {
-		result.Diagnostics = append(result.Diagnostics, toAPICompileDiagnostic(diag))
-	}
+  result := apiCompileResult{
+    Diagnostics: make([]apiCompileDiagnostic, 0, len(diags)),
+    Output:      output,
+  }
+  for _, diag := range diags {
+    result.Diagnostics = append(result.Diagnostics, toAPICompileDiagnostic(diag))
+  }
 
-	data, _ := json.Marshal(result)
-	fmt.Fprintln(stdout, string(data))
-	if driver.CountErrors(diags) > 0 {
-		return 2
-	}
-	return 0
+  data, _ := json.Marshal(result)
+  fmt.Fprintln(stdout, string(data))
+  if driver.CountErrors(diags) > 0 {
+    return 2
+  }
+  return 0
 }
 
+// toAPICompileDiagnostic converts an internal driver.Diagnostic into the
+// JSON-serialisable form returned by the api-compile command. Category is
+// lowercased to match the TypeScript Language Service convention.
 func toAPICompileDiagnostic(diag driver.Diagnostic) apiCompileDiagnostic {
-	var file *string
-	if diag.File != "" {
-		value := diag.File
-		file = &value
-	}
-	category := "error"
-	if diag.Severity == driver.SeverityWarning {
-		category = "warning"
-	}
-	return apiCompileDiagnostic{
-		File:        file,
-		Category:    category,
-		Code:        diag.Code,
-		Start:       diag.Start,
-		Length:      diag.Length,
-		Line:        diag.Line,
-		Character:   diag.Column,
-		MessageText: diag.Message,
-	}
+  var file *string
+  if diag.File != "" {
+    value := diag.File
+    file = &value
+  }
+  category := "error"
+  if diag.Severity == driver.SeverityWarning {
+    category = "warning"
+  }
+  return apiCompileDiagnostic{
+    File:        file,
+    Category:    category,
+    Code:        diag.Code,
+    Start:       diag.Start,
+    Length:      diag.Length,
+    Line:        diag.Line,
+    Character:   diag.Column,
+    MessageText: diag.Message,
+  }
 }
 
+// apiOutputKey returns the map key used in the api-compile result for a
+// generated file. Files inside cwd use a slash-separated relative path (the
+// API contract). Files outside cwd — rare, e.g. a monorepo output rooted
+// above the project — are returned as an absolute slash path instead.
 func apiOutputKey(cwd, fileName string) string {
-	// Relative keys are the API contract for files inside the project. Absolute
-	// keys are preserved for uncommon compiler outputs outside cwd.
-	if rel, err := filepath.Rel(cwd, fileName); err == nil && !isOutsideRelativePath(rel) {
-		return filepath.ToSlash(rel)
-	}
-	return filepath.ToSlash(fileName)
+  if rel, err := filepath.Rel(cwd, fileName); err == nil && !isOutsideRelativePath(rel) {
+    return filepath.ToSlash(rel)
+  }
+  return filepath.ToSlash(fileName)
 }
 
+// isOutsideRelativePath reports whether the result of filepath.Rel points
+// above the base directory (starts with ".."), meaning the file lives outside
+// the project root and cannot safely be expressed as a project-relative path.
 func isOutsideRelativePath(rel string) bool {
-	return rel == ".." || strings.HasPrefix(rel, ".."+string(filepath.Separator))
+  return rel == ".." || strings.HasPrefix(rel, ".."+string(filepath.Separator))
 }

package/cmd/ttsc/api_compile_branches_test.go

@@ -1,81 +1,79 @@
 package main
 
 import (
-	"errors"
-	"strings"
-	"testing"
+  "errors"
+  "strings"
+  "testing"
 
-	"github.com/samchon/ttsc/packages/ttsc/driver"
+  "github.com/samchon/ttsc/packages/ttsc/driver"
 )
 
 type apiCompileApplyErrorPlugin struct{}
 
 func (apiCompileApplyErrorPlugin) ApplyProgram(*driver.Program, driver.PluginContext) error {
-	return errors.New("api compile apply boom")
+  return errors.New("api compile apply boom")
 }
 
-/**
- * Verifies api-compile handles parse, cwd, diagnostic, and emit failures.
- *
- * The JSON API path is used by the JS wrapper, so its command entrypoint must
- * return stable status codes for wrapper misuse, project diagnostics, and
- * linked transform failures.
- *
- * 1. Exercise bad flags and a failing cwd resolver.
- * 2. Compile missing and type-invalid projects.
- * 3. Assert linked ApplyProgram errors surface through the emit branch.
- */
+// TestAPICompileBranches verifies api-compile handles parse, cwd, diagnostic, and emit failures.
+//
+// The JSON API path is used by the JS wrapper, so its command entrypoint must
+// return stable status codes for wrapper misuse, project diagnostics, and
+// linked transform failures.
+//
+// 1. Exercise bad flags and a failing cwd resolver.
+// 2. Compile missing and type-invalid projects.
+// 3. Assert linked ApplyProgram errors surface through the emit branch.
 func TestAPICompileBranches(t *testing.T) {
-	code, _, _ := captureCommand(t, func() int {
-		return runAPICompile([]string{"--cwd"})
-	})
-	if code != 2 {
-		t.Fatalf("bad flag status mismatch: %d", code)
-	}
+  code, _, _ := captureCommand(t, func() int {
+    return runAPICompile([]string{"--cwd"})
+  })
+  if code != 2 {
+    t.Fatalf("bad flag status mismatch: %d", code)
+  }
 
-	code, _, errText := captureCommand(t, func() int {
-		getwd = failGetwd
-		return runAPICompile(nil)
-	})
-	if code != 2 || !strings.Contains(errText, "cwd boom") {
-		t.Fatalf("cwd error mismatch: code=%d stderr=%q", code, errText)
-	}
+  code, _, errText := captureCommand(t, func() int {
+    getwd = failGetwd
+    return runAPICompile(nil)
+  })
+  if code != 2 || !strings.Contains(errText, "cwd boom") {
+    t.Fatalf("cwd error mismatch: code=%d stderr=%q", code, errText)
+  }
 
-	root := t.TempDir()
-	code, _, errText = captureCommand(t, func() int {
-		return runAPICompile([]string{"--cwd", root, "--tsconfig", "missing.json"})
-	})
-	if code != 2 || !strings.Contains(errText, "tsconfig not found") {
-		t.Fatalf("missing config mismatch: code=%d stderr=%q", code, errText)
-	}
+  root := t.TempDir()
+  code, _, errText = captureCommand(t, func() int {
+    return runAPICompile([]string{"--cwd", root, "--tsconfig", "missing.json"})
+  })
+  if code != 2 || !strings.Contains(errText, "tsconfig not found") {
+    t.Fatalf("missing config mismatch: code=%d stderr=%q", code, errText)
+  }
 
-	writeCommandProjectFile(t, root, "tsconfig.json", `{
+  writeCommandProjectFile(t, root, "tsconfig.json", `{
   "compilerOptions": { "module": "commonjs", "target": "es2020", "strict": true },
   "files": ["index.ts"]
 }
 `)
-	writeCommandProjectFile(t, root, "index.ts", `const value: number = "text";
+  writeCommandProjectFile(t, root, "index.ts", `const value: number = "text";
 export { value };
 `)
-	code, out, _ := captureCommand(t, func() int {
-		return runAPICompile([]string{"--cwd", root, "--tsconfig", "tsconfig.json"})
-	})
-	if code != 2 || !strings.Contains(out, `"diagnostics"`) {
-		t.Fatalf("diagnostic compile mismatch: code=%d stdout=%q", code, out)
-	}
-	if got := toAPICompileDiagnostic(driver.Diagnostic{Severity: driver.SeverityWarning}).Category; got != "warning" {
-		t.Fatalf("warning category mismatch: %q", got)
-	}
+  code, out, _ := captureCommand(t, func() int {
+    return runAPICompile([]string{"--cwd", root, "--tsconfig", "tsconfig.json"})
+  })
+  if code != 2 || !strings.Contains(out, `"diagnostics"`) {
+    t.Fatalf("diagnostic compile mismatch: code=%d stdout=%q", code, out)
+  }
+  if got := toAPICompileDiagnostic(driver.Diagnostic{Severity: driver.SeverityWarning}).Category; got != "warning" {
+    t.Fatalf("warning category mismatch: %q", got)
+  }
 
-	resetCommandLinkedPluginRegistry()
-	driver.RegisterPlugin(apiCompileApplyErrorPlugin{})
-	t.Setenv(driver.LinkedPluginsEnv, `[{"name":"error","stage":"transform","config":{}}]`)
-	writeCommandProjectFile(t, root, "index.ts", `export const value = 1;
+  resetCommandLinkedPluginRegistry()
+  driver.RegisterPlugin(apiCompileApplyErrorPlugin{})
+  t.Setenv(driver.LinkedPluginsEnv, `[{"name":"error","stage":"transform","config":{}}]`)
+  writeCommandProjectFile(t, root, "index.ts", `export const value = 1;
 `)
-	code, _, errText = captureCommand(t, func() int {
-		return runAPICompile([]string{"--cwd", root, "--tsconfig", "tsconfig.json"})
-	})
-	if code != 3 || !strings.Contains(errText, "api compile apply boom") {
-		t.Fatalf("emit error mismatch: code=%d stderr=%q", code, errText)
-	}
+  code, _, errText = captureCommand(t, func() int {
+    return runAPICompile([]string{"--cwd", root, "--tsconfig", "tsconfig.json"})
+  })
+  if code != 3 || !strings.Contains(errText, "api compile apply boom") {
+    t.Fatalf("emit error mismatch: code=%d stderr=%q", code, errText)
+  }
 }

package/cmd/ttsc/api_transform.go

@@ -7,64 +7,69 @@
 package main
 
 import (
-	"encoding/json"
-	"flag"
-	"fmt"
+  "encoding/json"
+  "flag"
+  "fmt"
 
-	"github.com/samchon/ttsc/packages/ttsc/driver"
-	cwdutil "github.com/samchon/ttsc/packages/ttsc/internal/cwd"
+  "github.com/samchon/ttsc/packages/ttsc/driver"
+  cwdutil "github.com/samchon/ttsc/packages/ttsc/internal/cwd"
 )
 
 type apiTransformResult struct {
-	// TypeScript contains every non-library source file visible through the
-	// Program facade, keyed the same way api-compile keys emitted files.
-	Diagnostics []apiCompileDiagnostic `json:"diagnostics,omitempty"`
-	TypeScript  map[string]string      `json:"typescript"`
+  // TypeScript contains every non-library source file visible through the
+  // Program facade, keyed the same way api-compile keys emitted files.
+  Diagnostics []apiCompileDiagnostic `json:"diagnostics,omitempty"`
+  TypeScript  map[string]string      `json:"typescript"`
 }
 
+// runAPITransform implements the `api-transform` sub-command. It loads the
+// TypeScript program in no-emit mode and returns the source text of every
+// non-library file as a JSON object, keyed by the same relative-path
+// convention as api-compile. Diagnostics are included; partial results are
+// returned even when diagnostics are present.
 func runAPITransform(args []string) int {
-	fs := flag.NewFlagSet("api-transform", flag.ContinueOnError)
-	fs.SetOutput(stderr)
-	tsconfigPath := fs.String("tsconfig", "tsconfig.json", "path to tsconfig.json")
-	cwdOverride := fs.String("cwd", "", "override the working directory")
-	if err := fs.Parse(args); err != nil {
-		return 2
-	}
+  fs := flag.NewFlagSet("api-transform", flag.ContinueOnError)
+  fs.SetOutput(stderr)
+  tsconfigPath := fs.String("tsconfig", "tsconfig.json", "path to tsconfig.json")
+  cwdOverride := fs.String("cwd", "", "override the working directory")
+  if err := fs.Parse(args); err != nil {
+    return 2
+  }
 
-	cwd, err := cwdutil.Resolve(*cwdOverride, getwd)
-	if err != nil {
-		fmt.Fprintf(stderr, "ttsc: %v\n", err)
-		return 2
-	}
+  cwd, err := cwdutil.Resolve(*cwdOverride, getwd)
+  if err != nil {
+    fmt.Fprintf(stderr, "ttsc: %v\n", err)
+    return 2
+  }
 
-	prog, diags, err := driver.LoadProgram(cwd, *tsconfigPath, driver.LoadProgramOptions{
-		ForceNoEmit: true,
-	})
-	if err != nil {
-		fmt.Fprintf(stderr, "ttsc api-transform: %v\n", err)
-		return 2
-	}
-	typescript := map[string]string{}
-	if prog != nil {
-		defer prog.Close()
-		for _, file := range prog.SourceFiles() {
-			typescript[apiOutputKey(cwd, file.FileName())] = file.Text()
-		}
-		diags = append(diags, prog.Diagnostics()...)
-	}
+  prog, diags, err := driver.LoadProgram(cwd, *tsconfigPath, driver.LoadProgramOptions{
+    ForceNoEmit: true,
+  })
+  if err != nil {
+    fmt.Fprintf(stderr, "ttsc api-transform: %v\n", err)
+    return 2
+  }
+  typescript := map[string]string{}
+  if prog != nil {
+    defer prog.Close()
+    for _, file := range prog.SourceFiles() {
+      typescript[apiOutputKey(cwd, file.FileName())] = file.Text()
+    }
+    diags = append(diags, prog.Diagnostics()...)
+  }
 
-	result := apiTransformResult{
-		Diagnostics: make([]apiCompileDiagnostic, 0, len(diags)),
-		TypeScript:  typescript,
-	}
-	for _, diag := range diags {
-		result.Diagnostics = append(result.Diagnostics, toAPICompileDiagnostic(diag))
-	}
+  result := apiTransformResult{
+    Diagnostics: make([]apiCompileDiagnostic, 0, len(diags)),
+    TypeScript:  typescript,
+  }
+  for _, diag := range diags {
+    result.Diagnostics = append(result.Diagnostics, toAPICompileDiagnostic(diag))
+  }
 
-	data, _ := json.Marshal(result)
-	fmt.Fprintln(stdout, string(data))
-	if driver.CountErrors(diags) > 0 {
-		return 2
-	}
-	return 0
+  data, _ := json.Marshal(result)
+  fmt.Fprintln(stdout, string(data))
+  if driver.CountErrors(diags) > 0 {
+    return 2
+  }
+  return 0
 }

package/cmd/ttsc/api_transform_branches_test.go

@@ -1,41 +1,39 @@
 package main
 
 import (
-	"strings"
-	"testing"
+  "strings"
+  "testing"
 )
 
-/**
- * Verifies api-transform rejects invalid command and project setup.
- *
- * Source-to-source API callers need the same stable wrapper diagnostics as the
- * compile API, but without touching emit. These branches are command-frontdoor
- * behavior rather than TypeScript-Go internals.
- *
- * 1. Pass an incomplete flag.
- * 2. Force cwd resolution to fail.
- * 3. Point the API at a missing tsconfig.
- */
+// TestAPITransformBranches verifies api-transform rejects invalid command and project setup.
+//
+// Source-to-source API callers need the same stable wrapper diagnostics as the
+// compile API, but without touching emit. These branches are command-frontdoor
+// behavior rather than TypeScript-Go internals.
+//
+// 1. Pass an incomplete flag.
+// 2. Force cwd resolution to fail.
+// 3. Point the API at a missing tsconfig.
 func TestAPITransformBranches(t *testing.T) {
-	code, _, _ := captureCommand(t, func() int {
-		return runAPITransform([]string{"--cwd"})
-	})
-	if code != 2 {
-		t.Fatalf("bad flag status mismatch: %d", code)
-	}
+  code, _, _ := captureCommand(t, func() int {
+    return runAPITransform([]string{"--cwd"})
+  })
+  if code != 2 {
+    t.Fatalf("bad flag status mismatch: %d", code)
+  }
 
-	code, _, errText := captureCommand(t, func() int {
-		getwd = failGetwd
-		return runAPITransform(nil)
-	})
-	if code != 2 || !strings.Contains(errText, "cwd boom") {
-		t.Fatalf("cwd error mismatch: code=%d stderr=%q", code, errText)
-	}
+  code, _, errText := captureCommand(t, func() int {
+    getwd = failGetwd
+    return runAPITransform(nil)
+  })
+  if code != 2 || !strings.Contains(errText, "cwd boom") {
+    t.Fatalf("cwd error mismatch: code=%d stderr=%q", code, errText)
+  }
 
-	code, _, errText = captureCommand(t, func() int {
-		return runAPITransform([]string{"--cwd", t.TempDir(), "--tsconfig", "missing.json"})
-	})
-	if code != 2 || !strings.Contains(errText, "tsconfig not found") {
-		t.Fatalf("missing config mismatch: code=%d stderr=%q", code, errText)
-	}
+  code, _, errText = captureCommand(t, func() int {
+    return runAPITransform([]string{"--cwd", t.TempDir(), "--tsconfig", "missing.json"})
+  })
+  if code != 2 || !strings.Contains(errText, "tsconfig not found") {
+    t.Fatalf("missing config mismatch: code=%d stderr=%q", code, errText)
+  }
 }