ttsc 0.6.0 → 0.7.1

package/test/source-build.test.ts

@@ -5,228 +5,41 @@ const path = require("node:path");
 const test = require("node:test");
 
 const {
-  bundledGoPackageRequest,
-  computeCacheKey,
-  goBinaryName,
-  pluginCacheCleanupTargets,
-  resolveDefaultPluginCacheRoot,
-  resolveGoCompiler,
-  resolvePluginCacheRoot,
-  sourceBuildWorkspaceReplacements,
-} = require("../src/source-build.ts");
-
-function withTempSourceDir(files: Record<string, string>): string {
-  const root = fs.mkdtempSync(path.join(os.tmpdir(), "ttsc-cache-key-"));
-  for (const [name, contents] of Object.entries(files)) {
-    const file = path.join(root, name);
-    fs.mkdirSync(path.dirname(file), { recursive: true });
-    fs.writeFileSync(file, contents, "utf8");
-  }
-  return root;
-}
-
-test("computeCacheKey is stable across calls for identical inputs", () => {
-  const dir = withTempSourceDir({
-    "go.mod": "module example\n\ngo 1.26\n",
-    "main.go": "package main\nfunc main() {}\n",
-  });
-  const inputs = { dir, entry: ".", ttscVersion: "1.0.0", tsgoVersion: "7.0.0-dev" };
-  assert.equal(computeCacheKey(inputs), computeCacheKey(inputs));
-});
-
-test("computeCacheKey changes when ttscVersion changes", () => {
-  const dir = withTempSourceDir({
-    "go.mod": "module example\n\ngo 1.26\n",
-    "main.go": "package main\nfunc main() {}\n",
-  });
-  const a = computeCacheKey({ dir, entry: ".", ttscVersion: "1.0.0", tsgoVersion: "7.0.0-dev" });
-  const b = computeCacheKey({ dir, entry: ".", ttscVersion: "1.0.1", tsgoVersion: "7.0.0-dev" });
-  assert.notEqual(a, b);
-});
-
-test("computeCacheKey changes when tsgoVersion changes", () => {
-  const dir = withTempSourceDir({
-    "go.mod": "module example\n\ngo 1.26\n",
-    "main.go": "package main\nfunc main() {}\n",
-  });
-  const a = computeCacheKey({ dir, entry: ".", ttscVersion: "1.0.0", tsgoVersion: "7.0.0-dev.A" });
-  const b = computeCacheKey({ dir, entry: ".", ttscVersion: "1.0.0", tsgoVersion: "7.0.0-dev.B" });
-  assert.notEqual(a, b);
-});
-
-test("computeCacheKey changes when entry changes", () => {
-  const dir = withTempSourceDir({
-    "go.mod": "module example\n\ngo 1.26\n",
-    "main.go": "package main\nfunc main() {}\n",
-    "cmd/foo/main.go": "package main\nfunc main() {}\n",
-  });
-  const a = computeCacheKey({ dir, entry: ".", ttscVersion: "1.0.0", tsgoVersion: "x" });
-  const b = computeCacheKey({ dir, entry: "./cmd/foo", ttscVersion: "1.0.0", tsgoVersion: "x" });
-  assert.notEqual(a, b);
-});
-
-test("computeCacheKey changes when source content changes", () => {
-  const dir = withTempSourceDir({
-    "go.mod": "module example\n\ngo 1.26\n",
-    "main.go": "package main\nfunc main() {}\n",
-  });
-  const before = computeCacheKey({ dir, entry: ".", ttscVersion: "1.0.0", tsgoVersion: "x" });
-  fs.writeFileSync(
-    path.join(dir, "main.go"),
-    "package main\nfunc main() { _ = 1 }\n",
-  );
-  const after = computeCacheKey({ dir, entry: ".", ttscVersion: "1.0.0", tsgoVersion: "x" });
-  assert.notEqual(before, after);
-});
-
-test("computeCacheKey ignores non-Go files (e.g. README.md)", () => {
-  const dir = withTempSourceDir({
-    "go.mod": "module example\n\ngo 1.26\n",
-    "main.go": "package main\nfunc main() {}\n",
-  });
-  const before = computeCacheKey({ dir, entry: ".", ttscVersion: "1.0.0", tsgoVersion: "x" });
-  fs.writeFileSync(path.join(dir, "README.md"), "documentation\n");
-  const after = computeCacheKey({ dir, entry: ".", ttscVersion: "1.0.0", tsgoVersion: "x" });
-  assert.equal(before, after);
-});
-
-test("resolveGoCompiler prefers TTSC_GO_BINARY override", () => {
-  const resolved = resolveGoCompiler({
-    env: { TTSC_GO_BINARY: "/tmp/custom-go" },
-    localGoLookup: () => "/tmp/local-go",
-    resolver: () => {
-      throw new Error("resolver should not be called when TTSC_GO_BINARY is set");
-    },
-  });
-  assert.equal(resolved, "/tmp/custom-go");
-});
-
-test("resolveGoCompiler uses bundled platform package before PATH fallback", () => {
-  const resolved = resolveGoCompiler({
-    arch: "x64",
-    env: {},
-    localGoLookup: () => null,
-    platform: "linux",
-    resolver: (request) => {
-      assert.equal(request, "@ttsc/linux-x64/bin/go/bin/go");
-      return "/node_modules/@ttsc/linux-x64/bin/go/bin/go";
-    },
-  });
-  assert.equal(resolved, "/node_modules/@ttsc/linux-x64/bin/go/bin/go");
-});
-
-test("resolveGoCompiler falls back to package-local bundled Go before PATH", () => {
-  const resolved = resolveGoCompiler({
-    env: {},
-    localGoLookup: () => "/workspace/packages/ttsc/native/go/bin/go",
-    resolver: () => {
-      throw new Error("platform package missing");
-    },
-  });
-  assert.equal(resolved, "/workspace/packages/ttsc/native/go/bin/go");
-});
-
-test("resolveGoCompiler keeps go on PATH as the last development fallback", () => {
-  const resolved = resolveGoCompiler({
-    env: {},
-    localGoLookup: () => null,
-    resolver: () => {
-      throw new Error("platform package missing");
-    },
-  });
-  assert.equal(resolved, "go");
-});
-
-test("bundled Go package request follows platform package layout", () => {
-  assert.equal(goBinaryName({ platform: "win32" }), "go.exe");
-  assert.equal(goBinaryName({ platform: "linux" }), "go");
-  assert.equal(
-    bundledGoPackageRequest({ platform: "darwin", arch: "arm64" }),
-    "@ttsc/darwin-arm64/bin/go/bin/go",
-  );
-  assert.equal(
-    bundledGoPackageRequest({ platform: "win32", arch: "x64" }),
-    "@ttsc/win32-x64/bin/go/bin/go.exe",
+  buildSourcePlugin,
+} = require("../lib/plugin/internal/buildSourcePlugin.js");
+
+test("buildSourcePlugin rejects a source outside a nearby Go module", () => {
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), "ttsc-source-plugin-"));
+  const source = path.join(root, "a", "b", "c", "d", "cmd");
+  fs.mkdirSync(source, { recursive: true });
+
+  assert.throws(
+    () =>
+      buildSourcePlugin({
+        baseDir: root,
+        pluginName: "missing-go-mod",
+        source,
+        ttscVersion: "1.0.0",
+        tsgoVersion: "7.0.0-dev",
+      }),
+    /go\.mod within 3 parent directories/,
   );
 });
 
-test("sourceBuildWorkspaceReplacements pins the ttsc module for source plugins", () => {
-  const ttscRoot = withTempSourceDir({
-    "go.mod": "module github.com/samchon/ttsc/packages/ttsc\n\ngo 1.26\n",
-  });
-  const otherRoot = withTempSourceDir({
-    "go.mod": "module example.com/other\n\ngo 1.26\n",
-  });
-  assert.deepEqual(sourceBuildWorkspaceReplacements([otherRoot, ttscRoot]), [
-    `replace github.com/samchon/ttsc/packages/ttsc v0.0.0 => ${ttscRoot.replace(/\\/g, "/")}`,
-  ]);
-});
-
-test("resolvePluginCacheRoot prefers project node_modules cache", () => {
-  const root = fs.mkdtempSync(path.join(os.tmpdir(), "ttsc-local-cache-"));
-  fs.mkdirSync(path.join(root, "node_modules"));
-  assert.equal(
-    resolvePluginCacheRoot(root),
-    path.join(root, "node_modules", ".ttsc", "plugins"),
+test("buildSourcePlugin rejects non-directory and non-go.mod sources", () => {
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), "ttsc-source-plugin-"));
+  const source = path.join(root, "plugin.txt");
+  fs.writeFileSync(source, "not a Go package\n", "utf8");
+
+  assert.throws(
+    () =>
+      buildSourcePlugin({
+        baseDir: root,
+        pluginName: "bad-source",
+        source,
+        ttscVersion: "1.0.0",
+        tsgoVersion: "7.0.0-dev",
+      }),
+    /Go package directory or go\.mod file/,
   );
 });
-
-test("resolvePluginCacheRoot falls back to project .ttsc without node_modules", () => {
-  const root = fs.mkdtempSync(path.join(os.tmpdir(), "ttsc-local-cache-"));
-  assert.equal(resolvePluginCacheRoot(root), path.join(root, ".ttsc", "plugins"));
-});
-
-test("resolveDefaultPluginCacheRoot ignores TTSC_CACHE_DIR for local clean paths", () => {
-  const previous = process.env.TTSC_CACHE_DIR;
-  const root = fs.mkdtempSync(path.join(os.tmpdir(), "ttsc-local-cache-"));
-  fs.mkdirSync(path.join(root, "node_modules"));
-  try {
-    process.env.TTSC_CACHE_DIR = path.join(root, "override");
-    assert.equal(
-      resolveDefaultPluginCacheRoot(root),
-      path.join(root, "node_modules", ".ttsc", "plugins"),
-    );
-  } finally {
-    if (previous === undefined) {
-      delete process.env.TTSC_CACHE_DIR;
-    } else {
-      process.env.TTSC_CACHE_DIR = previous;
-    }
-  }
-});
-
-test("resolvePluginCacheRoot honors TTSC_CACHE_DIR as an explicit test override", () => {
-  const previous = process.env.TTSC_CACHE_DIR;
-  const root = fs.mkdtempSync(path.join(os.tmpdir(), "ttsc-local-cache-"));
-  const override = path.join(root, "override");
-  try {
-    process.env.TTSC_CACHE_DIR = override;
-    assert.equal(resolvePluginCacheRoot(root), path.join(override, "plugins"));
-  } finally {
-    if (previous === undefined) {
-      delete process.env.TTSC_CACHE_DIR;
-    } else {
-      process.env.TTSC_CACHE_DIR = previous;
-    }
-  }
-});
-
-test("pluginCacheCleanupTargets deletes both local roots and explicit override", () => {
-  const previous = process.env.TTSC_CACHE_DIR;
-  const root = fs.mkdtempSync(path.join(os.tmpdir(), "ttsc-local-cache-"));
-  const override = path.join(root, "override");
-  try {
-    process.env.TTSC_CACHE_DIR = override;
-    assert.deepEqual(pluginCacheCleanupTargets(root), [
-      path.join(root, "node_modules", ".ttsc"),
-      path.join(root, ".ttsc"),
-      path.join(override, "plugins"),
-    ]);
-  } finally {
-    if (previous === undefined) {
-      delete process.env.TTSC_CACHE_DIR;
-    } else {
-      process.env.TTSC_CACHE_DIR = previous;
-    }
-  }
-});

package/test/tsgo.test.ts

@@ -3,10 +3,7 @@ const fs = require("node:fs");
 const os = require("node:os");
 const path = require("node:path");
 const test = require("node:test");
-const {
-  nativePreviewPlatformPackage,
-  resolveTsgo,
-} = require("../src/tsgo.ts");
+const { resolveTsgo } = require("../lib/compiler/internal/resolveTsgo.js");
 
 test("resolveTsgo accepts TTSC_TSGO_BINARY as an explicit compiler", () => {
   const root = fs.mkdtempSync(path.join(os.tmpdir(), "ttsc-tsgo-test-"));
@@ -61,8 +58,4 @@ test("resolveTsgo resolves the consumer native-preview platform package", () =>
   assert.equal(resolved.version, "7.0.0-dev.consumer");
   assert.equal(resolved.gitHead, "abc123");
   assert.equal(resolved.binary, path.join(platformRoot, "lib", "tsgo"));
-  assert.equal(
-    nativePreviewPlatformPackage({ platform: "linux", arch: "x64" }),
-    "@typescript/native-preview-linux-x64",
-  );
 });

package/cmd/ttsc/transform.go

@@ -1,166 +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)")
-	rewriteMode := fs.String("rewrite-mode", "none", "native rewrite backend id")
-	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()
-	if *rewriteMode != "none" {
-		fmt.Fprintf(stderr, "ttsc transform: rewrite backend %q is not built into the standalone ttsc binary\n", *rewriteMode)
-		fmt.Fprintln(stderr, "ttsc transform: run through the JS host with the matching compiler plugin so it can select the consumer-provided native binary")
-		return 2
-	}
-
-	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/api.d.ts

@@ -1,40 +0,0 @@
-import type { ITtscBuildOptions } from "./structures/ITtscBuildOptions";
-import type { ITtscBuildResult } from "./structures/ITtscBuildResult";
-import type { ITtscCheckOptions } from "./structures/ITtscCheckOptions";
-import type { ITtscCommonOptions } from "./structures/ITtscCommonOptions";
-import type { ITtscTransformOptions } from "./structures/ITtscTransformOptions";
-export type { ITtscBuildOptions } from "./structures/ITtscBuildOptions";
-export type { ITtscBuildResult } from "./structures/ITtscBuildResult";
-export type { ITtscCheckOptions } from "./structures/ITtscCheckOptions";
-export type { ITtscCommonOptions } from "./structures/ITtscCommonOptions";
-export type { ITtscTransformOptions } from "./structures/ITtscTransformOptions";
-/**
- * Transform a single .ts file and return the rewritten JS as a string.
- *
- * Intended for bundler per-file transforms (unplugin `transform()`). The caller
- * passes the absolute path; ttsc loads the enclosing tsconfig, compiles with
- * tsgo, and returns the rewritten JS.
- *
- * Throws when the binary exits non-zero — the error includes stderr so bundler
- * error overlays surface the real cause.
- */
-export declare function transform(options: ITtscTransformOptions): string;
-/**
- * Run `ttsc` against a tsconfig. Returns once the binary exits so the caller
- * can decide how to surface diagnostics. Does not throw on non-zero exit —
- * bundler pipelines often want to continue and collect errors.
- */
-export declare function build(options?: ITtscBuildOptions): ITtscBuildResult;
-/**
- * Run `ttsc check` (build without emit) — CI gate / pre-commit hook use.
- * Resolves with an exit-code record; does not throw.
- */
-export declare function check(options?: ITtscCheckOptions): ITtscBuildResult;
-/** Ask the binary for its version banner. Handy for user-agent strings. */
-export declare function version(options?: ITtscCommonOptions): string;
-/**
- * Promise-facing variant of `transform()`. The host path stays synchronous so
- * plugin descriptors can stay dependency-free, but many adapter surfaces still
- * prefer a Promise-returning function.
- */
-export declare function transformAsync(options: ITtscTransformOptions): Promise<string>;