ttsc 0.7.0 → 0.7.2

package/test/compiler.test.ts

@@ -10,7 +10,11 @@ const tsgo = resolveTsgo({ cwd: path.resolve(__dirname, "..") }).binary;
 
 test("TtscCompiler.compile returns output without writing project files", () => {
   const root = createProject();
-  const compiler = new TtscCompiler({ binary: tsgo, cwd: root, plugins: false });
+  const compiler = new TtscCompiler({
+    binary: tsgo,
+    cwd: root,
+    plugins: false,
+  });
 
   const result = compiler.compile();
 
@@ -27,7 +31,11 @@ test("TtscCompiler can disable project plugin loading", () => {
   const root = createProject({
     plugins: [{ transform: "./missing-plugin.cjs" }],
   });
-  const compiler = new TtscCompiler({ binary: tsgo, cwd: root, plugins: false });
+  const compiler = new TtscCompiler({
+    binary: tsgo,
+    cwd: root,
+    plugins: false,
+  });
 
   const result = compiler.compile();
 
@@ -49,11 +57,121 @@ test("TtscCompiler.compile applies configured source plugins without project out
   assert.equal(fs.existsSync(path.join(root, "dist")), false);
 });
 
+test("TtscCompiler.transform returns TypeScript source without project files", () => {
+  const root = createProject();
+  const compiler = new TtscCompiler({
+    binary: tsgo,
+    cwd: root,
+    plugins: false,
+  });
+
+  const result = compiler.transform();
+
+  assert.equal(result.type, "success");
+  assert.match(
+    result.typescript["src/main.ts"],
+    /const message: string = "api-ok"/,
+  );
+  assert.match(
+    result.typescript["src/main.ts"],
+    /console\.log\(\s*message\s*\)/,
+  );
+  assert.equal(result.typescript["dist/main.js"], undefined);
+  assert.equal(result.typescript["dist/main.d.ts"], undefined);
+  assert.equal(fs.existsSync(path.join(root, "dist")), false);
+});
+
+test("TtscCompiler.transform returns every included TypeScript source file", () => {
+  const root = createProject({
+    files: {
+      "src/helpers.ts":
+        "export const helper = (value: string): string => value.toUpperCase();\n",
+      "src/nested/model.ts": "export interface Model { value: string }\n",
+    },
+    source:
+      'import { helper } from "./helpers";\nconst message: string = helper("api-ok");\nconsole.log(message);\n',
+  });
+  const compiler = new TtscCompiler({
+    binary: tsgo,
+    cwd: root,
+    plugins: false,
+  });
+
+  const result = compiler.transform();
+
+  assert.equal(result.type, "success");
+  assert.match(result.typescript["src/main.ts"], /helper\("api-ok"\)/);
+  assert.match(result.typescript["src/helpers.ts"], /toUpperCase/);
+  assert.match(result.typescript["src/nested/model.ts"], /interface Model/);
+  for (const key of Object.keys(result.typescript)) {
+    assert.equal(key.startsWith("dist/"), false);
+    assert.equal(/\.(?:js|cjs|mjs|d\.ts|map)$/.test(key), false);
+  }
+  assert.equal(fs.existsSync(path.join(root, "dist")), false);
+});
+
+test("TtscCompiler.transform applies configured source plugins to TypeScript output", () => {
+  const root = createProject({
+    plugins: [{ transform: "./plugin.cjs" }],
+    source: 'export const value = goUpper("plugin");\nconsole.log(value);\n',
+  });
+  writeCompilerPlugin(root);
+  const compiler = new TtscCompiler({ binary: tsgo, cwd: root });
+
+  const result = compiler.transform();
+
+  assert.equal(result.type, "success");
+  assert.match(
+    result.typescript["src/main.ts"],
+    /export const value = "PLUGIN"/,
+  );
+  assert.match(result.typescript["src/main.ts"], /console\.log\(value\)/);
+  assert.equal(result.typescript["dist/main.js"], undefined);
+  assert.equal(fs.existsSync(path.join(root, "dist")), false);
+});
+
+test("TtscCompiler.transform rejects plugin output that is not TypeScript source", () => {
+  const root = createProject({
+    plugins: [{ transform: "./plugin.cjs" }],
+    source: 'export const value = goUpper("plugin");\nconsole.log(value);\n',
+  });
+  writeBrokenTransformPlugin(root);
+  const compiler = new TtscCompiler({ binary: tsgo, cwd: root });
+
+  const result = compiler.transform();
+
+  assert.equal(result.type, "exception");
+  assert.match(result.error.message, /did not return a TypeScript source map/);
+  assert.equal(fs.existsSync(path.join(root, "dist")), false);
+});
+
+test("TtscCompiler.transform returns failure on compiler diagnostics", () => {
+  const root = createProject({
+    source: 'const value: number = "not-a-number";\nconsole.log(value);\n',
+  });
+  const compiler = new TtscCompiler({
+    binary: tsgo,
+    cwd: root,
+    plugins: false,
+  });
+
+  const result = compiler.transform();
+
+  assert.equal(result.type, "failure");
+  assert.equal(result.diagnostics[0].code, 2322);
+  assert.match(result.typescript["src/main.ts"], /not-a-number/);
+  assert.equal(fs.existsSync(path.join(root, "dist")), false);
+});
+
 test("TtscCompiler.compile returns structured diagnostics", () => {
   const root = createProject({
     source: 'const value: number = "not-a-number";\nconsole.log(value);\n',
   });
-  const compiler = new TtscCompiler({ binary: tsgo, cwd: root, plugins: false });
+  const compiler = new TtscCompiler({
+    binary: tsgo,
+    cwd: root,
+    plugins: false,
+  });
 
   const result = compiler.compile();
 
@@ -76,7 +194,11 @@ test("TtscCompiler.compile does not accept per-call context overrides", () => {
   const other = createProject({
     plugins: [{ transform: "./missing-plugin.cjs" }],
   });
-  const compiler = new TtscCompiler({ binary: tsgo, cwd: root, plugins: false });
+  const compiler = new TtscCompiler({
+    binary: tsgo,
+    cwd: root,
+    plugins: false,
+  });
 
   const result = compiler.compile({
     binary: path.join(other, "missing-tsgo"),
@@ -119,6 +241,11 @@ function createProject(options = {}) {
       'const message: string = "api-ok";\nconsole.log(message);\n',
     "utf8",
   );
+  for (const [file, content] of Object.entries(options.files ?? {})) {
+    const location = path.join(root, file);
+    fs.mkdirSync(path.dirname(location), { recursive: true });
+    fs.writeFileSync(location, content, "utf8");
+  }
   fs.writeFileSync(
     path.join(root, "tsconfig.json"),
     JSON.stringify(
@@ -163,6 +290,40 @@ function writeSourcePlugin(root) {
   );
 }
 
+function writeBrokenTransformPlugin(root) {
+  fs.writeFileSync(
+    path.join(root, "plugin.cjs"),
+    'module.exports = { name: "broken-transform-fixture", source: "./plugin-go" };\n',
+    "utf8",
+  );
+  fs.mkdirSync(path.join(root, "plugin-go"), { recursive: true });
+  fs.writeFileSync(
+    path.join(root, "plugin-go", "go.mod"),
+    "module example.com/brokentransformfixture\n\ngo 1.26\n",
+    "utf8",
+  );
+  fs.writeFileSync(
+    path.join(root, "plugin-go", "main.go"),
+    [
+      "package main",
+      "",
+      "import (",
+      '\t"fmt"',
+      '\t"os"',
+      ")",
+      "",
+      "func main() {",
+      '\tif len(os.Args) > 1 && os.Args[1] == "transform" {',
+      '\t\tfmt.Println(`{"output":{"dist/main.js":"console.log(\\"wrong\\");\\n"}}`)',
+      "\t\treturn",
+      "\t}",
+      "}",
+      "",
+    ].join("\n"),
+    "utf8",
+  );
+}
+
 function writeCompilerPlugin(root) {
   fs.writeFileSync(
     path.join(root, "plugin.cjs"),
@@ -181,6 +342,7 @@ function writeCompilerPlugin(root) {
       "package main",
       "",
       "import (",
+      '\t"encoding/json"',
       '\t"flag"',
       '\t"fmt"',
       '\t"os"',
@@ -195,6 +357,8 @@ function writeCompilerPlugin(root) {
       "\tswitch args[0] {",
       '\tcase "build":',
       "\t\treturn build(args[1:])",
+      '\tcase "transform":',
+      "\t\treturn transformSource(args[1:])",
       '\tcase "check", "version":',
       "\t\treturn 0",
       "\tdefault:",
@@ -204,7 +368,7 @@ function writeCompilerPlugin(root) {
       "",
       "func build(args []string) int {",
       '\tfs := flag.NewFlagSet("build", flag.ContinueOnError)',
-      '\tfs.SetOutput(os.Stderr)',
+      "\tfs.SetOutput(os.Stderr)",
       '\tcwd := fs.String("cwd", "", "")',
       '\toutDir := fs.String("outDir", "dist", "")',
       '\t_ = fs.String("tsconfig", "", "")',
@@ -215,19 +379,43 @@ function writeCompilerPlugin(root) {
       '\t_ = fs.Bool("noEmit", false, "")',
       "\tif err := fs.Parse(args); err != nil { return 2 }",
       "\troot := *cwd",
-      "\tif root == \"\" { root, _ = os.Getwd() }",
+      '\tif root == "" { root, _ = os.Getwd() }',
       '\tinput, err := os.ReadFile(filepath.Join(root, "src", "main.ts"))',
-      '\tif err != nil { fmt.Fprintln(os.Stderr, err); return 2 }',
+      "\tif err != nil { fmt.Fprintln(os.Stderr, err); return 2 }",
       '\tvalue := "PLUGIN"',
       '\tif !strings.Contains(string(input), `goUpper("plugin")`) { value = "UNKNOWN" }',
       '\toutput := fmt.Sprintf("\\"use strict\\";\\nObject.defineProperty(exports, \\"__esModule\\", { value: true });\\nexports.value = void 0;\\nconst value = %q;\\nexports.value = value;\\nconsole.log(value);\\n", value)',
       '\tfile := filepath.Join(*outDir, "main.js")',
-      "\tif !filepath.IsAbs(*outDir) { file = filepath.Join(root, *outDir, \"main.js\") }",
+      '\tif !filepath.IsAbs(*outDir) { file = filepath.Join(root, *outDir, "main.js") }',
       "\tif err := os.MkdirAll(filepath.Dir(file), 0o755); err != nil { fmt.Fprintln(os.Stderr, err); return 2 }",
       "\tif err := os.WriteFile(file, []byte(output), 0o644); err != nil { fmt.Fprintln(os.Stderr, err); return 2 }",
       "\treturn 0",
       "}",
       "",
+      "type transformResult struct {",
+      '\tTypeScript map[string]string `json:"typescript"`',
+      "}",
+      "",
+      "func transformSource(args []string) int {",
+      '\tfs := flag.NewFlagSet("transform", flag.ContinueOnError)',
+      "\tfs.SetOutput(os.Stderr)",
+      '\tcwd := fs.String("cwd", "", "")',
+      '\t_ = fs.String("tsconfig", "", "")',
+      '\t_ = fs.String("plugins-json", "", "")',
+      "\tif err := fs.Parse(args); err != nil { return 2 }",
+      "\troot := *cwd",
+      '\tif root == "" { root, _ = os.Getwd() }',
+      '\tinput, err := os.ReadFile(filepath.Join(root, "src", "main.ts"))',
+      "\tif err != nil { fmt.Fprintln(os.Stderr, err); return 2 }",
+      '\tvalue := "PLUGIN"',
+      '\tif !strings.Contains(string(input), `goUpper("plugin")`) { value = "UNKNOWN" }',
+      '\toutput := fmt.Sprintf("export const value = %q;\\nconsole.log(value);\\n", value)',
+      '\tdata, err := json.Marshal(transformResult{TypeScript: map[string]string{"src/main.ts": output}})',
+      "\tif err != nil { fmt.Fprintln(os.Stderr, err); return 2 }",
+      "\tfmt.Fprintln(os.Stdout, string(data))",
+      "\treturn 0",
+      "}",
+      "",
     ].join("\n"),
     "utf8",
   );

package/cmd/ttsc/transform.go

@@ -1,160 +0,0 @@
-package main
-
-import (
-	"bytes"
-	"flag"
-	"fmt"
-	"os"
-	"path/filepath"
-	"strings"
-
-	shimcompiler "github.com/microsoft/typescript-go/shim/compiler"
-
-	"github.com/samchon/ttsc/packages/ttsc/driver"
-)
-
-// runTransform implements `ttsc transform` — a single-file transform used by
-// bundler plugin adapters (unplugin, vite, webpack, rollup, esbuild, rspack,
-// farm). Behavior:
-//
-//   - Loads the enclosing tsconfig so tsgo resolves imports and types.
-//   - Runs tsgo Emit, filtering WriteFile so only the requested source
-//     file's JS leaves the binary.
-//   - Applies the ttsc rewrite + import cleanup just like `build --emit`.
-//   - Writes the result to stdout (or `--out` when provided).
-//
-// The contract matches a per-file bundler transform hook: bundlers
-// hand the plugin a source file path, the plugin shells out here, and the
-// returned text replaces the file in the bundle graph.
-func runTransform(args []string) int {
-	fs := flag.NewFlagSet("transform", flag.ContinueOnError)
-	fs.SetOutput(stderr)
-	file := fs.String("file", "", "absolute or cwd-relative path of the .ts file to transform")
-	tsconfigPath := fs.String("tsconfig", "tsconfig.json", "tsconfig.json owning --file")
-	cwdOverride := fs.String("cwd", "", "override the working directory")
-	out := fs.String("out", "", "write output JS to PATH (default: stdout)")
-	if err := fs.Parse(args); err != nil {
-		return 2
-	}
-	if *file == "" {
-		fmt.Fprintln(stderr, "ttsc transform: --file is required")
-		return 2
-	}
-
-	cwd := *cwdOverride
-	if cwd == "" {
-		var err error
-		cwd, err = os.Getwd()
-		if err != nil {
-			fmt.Fprintf(stderr, "ttsc transform: cwd: %v\n", err)
-			return 2
-		}
-	}
-
-	prog, diags, err := driver.LoadProgram(cwd, *tsconfigPath, driver.LoadProgramOptions{
-		ForceEmit: true,
-	})
-	if err != nil {
-		fmt.Fprintf(stderr, "ttsc transform: %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
-	}
-
-	absFile := *file
-	if !filepath.IsAbs(absFile) {
-		absFile = filepath.Join(cwd, absFile)
-	}
-	absFile = filepath.ToSlash(absFile)
-
-	rewrites := driver.NewRewriteSet()
-
-	target := prog.SourceFile(absFile)
-	if target == nil {
-		fmt.Fprintf(stderr, "ttsc transform: source file is not in program: %s\n", absFile)
-		return 2
-	}
-
-	// Capture the requested source file's JS output.
-	var captured []byte
-	capture := func(name, text string, _ *shimcompiler.WriteFileData) error {
-		rel := filepath.ToSlash(name)
-		if !isJavaScriptOutput(rel) {
-			return nil
-		}
-		captured = []byte(text)
-		return nil
-	}
-	_, eDiags, err := prog.EmitFile(rewrites, target, capture)
-	if err != nil {
-		fmt.Fprintf(stderr, "ttsc transform: emit: %v\n", err)
-		return 3
-	}
-	for _, d := range eDiags {
-		fmt.Fprintln(stderr, "  -", d.String())
-	}
-	if captured == nil {
-		fmt.Fprintf(stderr, "ttsc transform: no output produced for %s\n", absFile)
-		return 3
-	}
-	if *out == "" {
-		if _, werr := bytes.NewReader(captured).WriteTo(stdout); werr != nil {
-			fmt.Fprintf(stderr, "ttsc transform: write stdout: %v\n", werr)
-			return 3
-		}
-		return 0
-	}
-	if dir := filepath.Dir(*out); dir != "" {
-		if err := os.MkdirAll(dir, 0o755); err != nil {
-			fmt.Fprintf(stderr, "ttsc transform: mkdir: %v\n", err)
-			return 3
-		}
-	}
-	if err := os.WriteFile(*out, captured, 0o644); err != nil {
-		fmt.Fprintf(stderr, "ttsc transform: write %s: %v\n", *out, err)
-		return 3
-	}
-	return 0
-}
-
-// sharedSourceStemSegments counts the shared trailing path segments between the
-// emitted output path and the original source path after stripping extensions.
-// `src/foo/bar.ts` ↔ `dist/foo/bar.js` returns 2, while unrelated paths return
-// 0. `ttsc transform` uses the highest score to pick the emitted JS that
-// belongs to the requested source file even when a project contains multiple
-// `index.ts` files.
-func sharedSourceStemSegments(outPath, srcPath string) int {
-	trim := func(p string) []string {
-		p = strings.TrimSuffix(p, filepath.Ext(p))
-		return strings.Split(p, "/")
-	}
-	a, b := trim(outPath), trim(srcPath)
-	n := len(a)
-	if len(b) < n {
-		n = len(b)
-	}
-	shared := 0
-	for i := 1; i <= n; i++ {
-		if a[len(a)-i] != b[len(b)-i] {
-			break
-		}
-		shared++
-	}
-	return shared
-}
-
-func isJavaScriptOutput(name string) bool {
-	switch strings.ToLower(filepath.Ext(name)) {
-	case ".js", ".mjs", ".cjs":
-		return true
-	default:
-		return false
-	}
-}

package/lib/compiler/internal/runTransform.d.ts

@@ -1,3 +0,0 @@
-import type { TtscTransformOptions } from "../../structures/internal/TtscTransformOptions";
-/** Transform one source file by emitting its project into a temporary directory. */
-export declare function runTransform(options: TtscTransformOptions): string;

package/lib/compiler/internal/runTransform.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"runTransform.js","sourceRoot":"","sources":["../../../src/compiler/internal/runTransform.ts"],"names":[],"mappings":"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"}

package/lib/structures/internal/TtscTransformOptions.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"TtscTransformOptions.js","sourceRoot":"","sources":["../../../src/structures/internal/TtscTransformOptions.ts"],"names":[],"mappings":""}