ttsc 0.6.0 → 0.7.0

package/src/runner/register.ts

@@ -1,406 +0,0 @@
-import * as fs from "node:fs";
-import * as path from "node:path";
-
-import type { ITtscPreparedExecution } from "../structures/ITtscPreparedExecution";
-import type { ITtscRegisterOptions } from "../structures/ITtscRegisterOptions";
-import { build, check } from "../api";
-import {
-  defaultCacheDirectory,
-  resolveProjectConfig,
-  resolveProjectRoot,
-} from "../project";
-
-export type { ITtscPreparedExecution } from "../structures/ITtscPreparedExecution";
-export type { ITtscRegisterOptions } from "../structures/ITtscRegisterOptions";
-
-type ITtscRequireExtension = (module: NodeJS.Module, filename: string) => void;
-type ITtscCompilableModule = NodeJS.Module & {
-  _compile(code: string, filename: string): void;
-};
-
-interface ITtscRunnerProjectContext {
-  cacheDir: string;
-  emitDir: string;
-  emittedFiles: string[] | null;
-  diagnosticsChecked: boolean;
-  entryMap: Map<string, string>;
-  root: string;
-  tsconfig: string;
-}
-
-const DEFAULT_EXTENSIONS: readonly string[] = Object.freeze([
-  ".ts",
-  ".tsx",
-  ".cts",
-  ".mts",
-]);
-
-const PROCESS_CACHE_KEY = String(process.pid);
-const preparedContexts = new Map<string, ITtscRunnerProjectContext>();
-
-export function register(options: ITtscRegisterOptions = {}): () => void {
-  const cwd = path.resolve(options.cwd ?? process.cwd());
-  const extensions = [...(options.extensions ?? DEFAULT_EXTENSIONS)];
-  const contextCache = new Map<string, ITtscRunnerProjectContext>();
-  const previous = new Map<string, ITtscRequireExtension | undefined>();
-
-  const getContext = (filename: string): ITtscRunnerProjectContext => {
-    if (options.project) {
-      const key = path.resolve(cwd, options.project);
-      const cached = contextCache.get(key);
-      if (cached) return cached;
-      const tsconfig = resolveProjectConfig({ cwd, tsconfig: key });
-      const root = resolveProjectRoot({ cwd, tsconfig });
-      const cacheDir = options.cacheDir ?? defaultCacheDirectory(root, "ttsx");
-      const prepared = takePreparedContext(tsconfig, cacheDir, options);
-      if (prepared) {
-        contextCache.set(key, prepared);
-        return prepared;
-      }
-      const created = {
-        tsconfig,
-        root,
-        cacheDir,
-        diagnosticsChecked: false,
-        emitDir: path.join(cacheDir, "project", PROCESS_CACHE_KEY),
-        emittedFiles: null,
-        entryMap: new Map<string, string>(),
-      };
-      contextCache.set(key, created);
-      return created;
-    }
-
-    const tsconfig = resolveProjectConfig({ cwd, file: filename });
-    const cached = contextCache.get(tsconfig);
-    if (cached) return cached;
-    const root = resolveProjectRoot({ cwd, tsconfig });
-    const cacheDir = options.cacheDir ?? defaultCacheDirectory(root, "ttsx");
-    const prepared = takePreparedContext(tsconfig, cacheDir, options);
-    if (prepared) {
-      contextCache.set(tsconfig, prepared);
-      return prepared;
-    }
-    const created = {
-      tsconfig,
-      root,
-      cacheDir,
-      diagnosticsChecked: false,
-      emitDir: path.join(cacheDir, "project", PROCESS_CACHE_KEY),
-      emittedFiles: null,
-      entryMap: new Map<string, string>(),
-    };
-    contextCache.set(tsconfig, created);
-    return created;
-  };
-
-  const compile = (filename: string): string => {
-    const context = getContext(filename);
-    ensureProjectDiagnostics(context, options);
-    const output = readCompiledOutput(context, filename, options);
-    if (looksLikeESM(output)) {
-      throw new Error(
-        `ttsx: ESM output is not yet supported by the in-process CJS runner (${filename}).`,
-      );
-    }
-    return output;
-  };
-
-  for (const extension of extensions) {
-    previous.set(extension, require.extensions[extension]);
-    require.extensions[extension] = (module: NodeJS.Module, filename: string) => {
-      const compiled = compile(filename);
-      (module as ITtscCompilableModule)._compile(compiled, filename);
-    };
-  }
-
-  return () => {
-    for (const extension of extensions) {
-      const handler = previous.get(extension);
-      if (handler) {
-        require.extensions[extension] = handler;
-      } else {
-        delete require.extensions[extension];
-      }
-    }
-  };
-}
-
-export function prepareExecution(
-  entryFile: string,
-  options: ITtscRegisterOptions = {},
-): ITtscPreparedExecution {
-  const cwd = path.resolve(options.cwd ?? process.cwd());
-  const context = resolveProjectContext(cwd, entryFile, options);
-  ensureProjectDiagnostics(context, options);
-  const entryOutput = readCompiledOutput(context, entryFile, options);
-  if (!looksLikeESM(entryOutput)) {
-    storePreparedContext(context, options);
-    return {
-      emitDir: context.emitDir,
-      entryFile,
-      moduleKind: "cjs",
-    };
-  }
-  ensureProjectBuild(context, options);
-  const resolvedEntry = resolveEmittedFile(context, entryFile);
-  if (resolvedEntry === null) {
-    throw new Error(`ttsx: emitted entry not found for ${entryFile}`);
-  }
-  const output = fs.readFileSync(resolvedEntry, "utf8");
-  return {
-    emitDir: context.emitDir,
-    entryFile: resolvedEntry,
-    moduleKind: looksLikeESM(output) ? "esm" : "cjs",
-  };
-}
-
-function storePreparedContext(
-  context: ITtscRunnerProjectContext,
-  options: ITtscRegisterOptions,
-): void {
-  preparedContexts.set(preparedContextKey(context.tsconfig, context.cacheDir, options), context);
-}
-
-function takePreparedContext(
-  tsconfig: string,
-  cacheDir: string,
-  options: ITtscRegisterOptions,
-): ITtscRunnerProjectContext | null {
-  const key = preparedContextKey(tsconfig, cacheDir, options);
-  const context = preparedContexts.get(key);
-  if (!context) {
-    return null;
-  }
-  preparedContexts.delete(key);
-  return context;
-}
-
-function preparedContextKey(
-  tsconfig: string,
-  cacheDir: string,
-  options: ITtscRegisterOptions,
-): string {
-  return JSON.stringify([
-    PROCESS_CACHE_KEY,
-    tsconfig,
-    cacheDir,
-    options.binary ?? "",
-    options.rewriteMode ?? "",
-    options.env?.TTSC_TSGO_BINARY ?? "",
-    options.env?.TTSC_BINARY ?? "",
-    options.plugins === false ? false : options.plugins ?? null,
-  ]);
-}
-
-function ensureProjectBuild(context: ITtscRunnerProjectContext, options: ITtscRegisterOptions): void {
-  if (context.emittedFiles !== null) return;
-
-  fs.mkdirSync(context.cacheDir, { recursive: true });
-  fs.rmSync(context.emitDir, { recursive: true, force: true });
-  const result = build({
-    binary: options.binary,
-    cwd: context.root,
-    env: options.env,
-    emit: true,
-    outDir: context.emitDir,
-    plugins: options.plugins,
-    quiet: true,
-    rewriteMode: options.rewriteMode,
-    skipDiagnosticsCheck: context.diagnosticsChecked,
-    tsconfig: context.tsconfig,
-  });
-  if (result.status === 0) {
-    context.emittedFiles = listEmittedFiles(context.emitDir);
-    return;
-  }
-
-  fs.rmSync(context.emitDir, { recursive: true, force: true });
-  const detail = [
-    `ttsx: project build failed for ${context.tsconfig}`,
-    result.stderr || result.stdout,
-  ]
-    .filter((line) => line.trim().length !== 0)
-    .join("\n");
-  throw new Error(detail);
-}
-
-function readCompiledOutput(
-  context: ITtscRunnerProjectContext,
-  filename: string,
-  options: ITtscRegisterOptions,
-): string {
-  ensureProjectBuild(context, options);
-  const emitted = resolveEmittedFile(context, filename);
-  if (!emitted) {
-    throw new Error(`ttsx: emitted file not found for ${filename}`);
-  }
-  return fs.readFileSync(emitted, "utf8");
-}
-
-function resolveProjectContext(
-  cwd: string,
-  filename: string,
-  options: ITtscRegisterOptions,
-): ITtscRunnerProjectContext {
-  if (options.project) {
-    const tsconfig = resolveProjectConfig({
-      cwd,
-      tsconfig: path.resolve(cwd, options.project),
-    });
-    return createProjectContext(cwd, tsconfig, options);
-  }
-  const tsconfig = resolveProjectConfig({ cwd, file: filename });
-  return createProjectContext(cwd, tsconfig, options);
-}
-
-function createProjectContext(
-  cwd: string,
-  tsconfig: string,
-  options: ITtscRegisterOptions,
-): ITtscRunnerProjectContext {
-  const root = resolveProjectRoot({ cwd, tsconfig });
-  const cacheDir = options.cacheDir ?? defaultCacheDirectory(root, "ttsx");
-  return {
-    tsconfig,
-    root,
-    cacheDir,
-    diagnosticsChecked: false,
-    emitDir: path.join(cacheDir, "project", PROCESS_CACHE_KEY),
-    emittedFiles: null,
-    entryMap: new Map<string, string>(),
-  };
-}
-
-function ensureProjectDiagnostics(
-  context: ITtscRunnerProjectContext,
-  options: ITtscRegisterOptions,
-): void {
-  if (context.diagnosticsChecked) {
-    return;
-  }
-  const result = check({
-    binary: options.binary,
-    cwd: context.root,
-    env: options.env,
-    plugins: options.plugins,
-    quiet: true,
-    rewriteMode: options.rewriteMode,
-    tsconfig: context.tsconfig,
-  });
-  if (result.status !== 0) {
-    const detail = [result.stderr.trim(), result.stdout.trim()]
-      .filter(Boolean)
-      .join("\n");
-    throw new Error(
-      `ttsx: project check failed for ${context.tsconfig}` +
-        (detail ? `\n${detail}` : ""),
-    );
-  }
-  context.diagnosticsChecked = true;
-}
-
-function resolveEmittedFile(context: ITtscRunnerProjectContext, filename: string): string | null {
-  const normalized = path.resolve(filename);
-  const cached = context.entryMap.get(normalized);
-  if (cached && fs.existsSync(cached)) return cached;
-
-  const exact = resolveExactEmittedFile(context, normalized);
-  if (exact && fs.existsSync(exact)) {
-    context.entryMap.set(normalized, exact);
-    return exact;
-  }
-
-  const files = context.emittedFiles ?? [];
-  let best: string | null = null;
-  let bestScore = 0;
-  for (const file of files) {
-    const score = sharedSourceStemSegments(file, normalized);
-    if (score > bestScore) {
-      best = file;
-      bestScore = score;
-    }
-  }
-  if (!best || !fs.existsSync(best)) {
-    return null;
-  }
-  context.entryMap.set(normalized, best);
-  return best;
-}
-
-function resolveExactEmittedFile(
-  context: ITtscRunnerProjectContext,
-  filename: string,
-): string | null {
-  const relative = path.relative(context.root, filename);
-  if (relative === "" || relative.startsWith("..") || path.isAbsolute(relative)) {
-    return null;
-  }
-  return path.resolve(
-    context.emitDir,
-    relative.slice(0, relative.length - path.extname(relative).length) +
-      emittedJavaScriptExtension(filename),
-  );
-}
-
-function listEmittedFiles(root: string): string[] {
-  if (!fs.existsSync(root)) return [];
-  const output: string[] = [];
-  const stack = [root];
-  while (stack.length !== 0) {
-    const current = stack.pop()!;
-    for (const entry of fs.readdirSync(current, { withFileTypes: true })) {
-      const next = path.join(current, entry.name);
-      if (entry.isDirectory()) {
-        stack.push(next);
-      } else if (entry.isFile() && isJavaScriptOutput(next)) {
-        output.push(path.resolve(next));
-      }
-    }
-  }
-  return output;
-}
-
-function sharedSourceStemSegments(outPath: string, srcPath: string): number {
-  const trim = (location: string): string[] => {
-    const normalized = location.split(path.sep).join("/");
-    return normalized
-      .slice(0, normalized.length - path.extname(normalized).length)
-      .split("/");
-  };
-  const a = trim(outPath);
-  const b = trim(srcPath);
-  const count = Math.min(a.length, b.length);
-  let shared = 0;
-  for (let i = 1; i <= count; i += 1) {
-    if (a[a.length - i] !== b[b.length - i]) break;
-    shared += 1;
-  }
-  return shared;
-}
-
-function looksLikeESM(output: string): boolean {
-  if (
-    /\bObject\.defineProperty\(exports\b/.test(output) ||
-    /\bmodule\.exports\b/.test(output) ||
-    /\brequire\(/.test(output) ||
-    /\bexports\./.test(output)
-  ) {
-    return false;
-  }
-  return /^\s*(import|export)\s/m.test(output);
-}
-
-function emittedJavaScriptExtension(filename: string): string {
-  switch (path.extname(filename).toLowerCase()) {
-    case ".mts":
-      return ".mjs";
-    case ".cts":
-      return ".cjs";
-    default:
-      return ".js";
-  }
-}
-
-function isJavaScriptOutput(filename: string): boolean {
-  return /\.(?:[cm]?js)$/i.test(filename);
-}

package/src/structures/ITtscBuildOptions.ts

@@ -1,19 +0,0 @@
-import type { ITtscCommonOptions } from "./ITtscCommonOptions";
-
-export interface ITtscBuildOptions extends ITtscCommonOptions {
-  /** Path to tsconfig.json. Default: `tsconfig.json`. */
-  tsconfig?: string;
-  /**
-   * Emit override. `true` forces emit, `false` forces noEmit, `undefined`
-   * follows tsconfig.
-   */
-  emit?: boolean;
-  /** Override compilerOptions.outDir for this invocation. */
-  outDir?: string;
-  /** Suppress the per-call summary banner. Default: `true`. */
-  quiet?: boolean;
-  /** @internal Caller already ran diagnostics and accepts responsibility. */
-  skipDiagnosticsCheck?: boolean;
-  /** @internal Force `tsgo --listEmittedFiles` for caller-side output discovery. */
-  forceListEmittedFiles?: boolean;
-}

package/src/structures/ITtscBuildResult.ts

@@ -1,6 +0,0 @@
-export interface ITtscBuildResult {
-  emittedFiles?: string[];
-  status: number;
-  stdout: string;
-  stderr: string;
-}

package/src/structures/ITtscBuildSourcePluginOptions.ts

@@ -1,9 +0,0 @@
-import type { ITtscNativeSource } from "./ITtscNativeSource";
-
-export interface ITtscBuildSourcePluginOptions {
-  source: ITtscNativeSource;
-  pluginName: string;
-  baseDir: string;
-  ttscVersion: string;
-  tsgoVersion: string;
-}

package/src/structures/ITtscCacheKeyInput.ts

@@ -1,7 +0,0 @@
-export interface ITtscCacheKeyInput {
-  file: string;
-  tsconfig: string;
-  version: string;
-  mode?: string;
-  extra?: readonly string[];
-}

package/src/structures/ITtscCheckOptions.ts

@@ -1,3 +0,0 @@
-import type { ITtscBuildOptions } from "./ITtscBuildOptions";
-
-export type ITtscCheckOptions = Omit<ITtscBuildOptions, "emit">;

package/src/structures/ITtscCommonOptions.ts

@@ -1,23 +0,0 @@
-import type { ITtscProjectPluginConfig } from "./ITtscProjectPluginConfig";
-import type { ITtscResolveOptions } from "./ITtscResolveOptions";
-
-export interface ITtscCommonOptions extends ITtscResolveOptions {
-  /** Absolute path to an already-resolved tsgo binary. Skips package resolution. */
-  binary?: string;
-  /** Working directory passed to the child process. */
-  cwd?: string;
-  /** Extra environment variables; merged onto `process.env`. */
-  env?: NodeJS.ProcessEnv;
-  /**
-   * Override project plugin loading. `false` disables tsconfig plugins; an
-   * array replaces the tsconfig `compilerOptions.plugins` list.
-   */
-  plugins?: readonly ITtscProjectPluginConfig[] | false;
-  /**
-   * Override the native rewrite backend. Defaults to the loaded plugin mode.
-   *
-   * @deprecated Prefer plugin-declared `native.mode`; this override is for
-   *   low-level tests and migration probes.
-   */
-  rewriteMode?: string;
-}

package/src/structures/ITtscLoadPluginsOptions.ts

@@ -1,9 +0,0 @@
-import type { ITtscProjectPluginConfig } from "./ITtscProjectPluginConfig";
-
-export interface ITtscLoadPluginsOptions {
-  binary: string;
-  cwd?: string;
-  entries?: readonly ITtscProjectPluginConfig[] | false;
-  file?: string;
-  tsconfig?: string;
-}

package/src/structures/ITtscLoadedNativePlugin.ts

@@ -1,8 +0,0 @@
-import type { ITtscNativeBackend } from "./ITtscNativeBackend";
-import type { ITtscProjectPluginConfig } from "./ITtscProjectPluginConfig";
-
-export interface ITtscLoadedNativePlugin {
-  backend: ITtscNativeBackend;
-  config: ITtscProjectPluginConfig;
-  name: string;
-}

package/src/structures/ITtscLoadedPlugins.ts

@@ -1,12 +0,0 @@
-import type { ITtscLoadedNativePlugin } from "./ITtscLoadedNativePlugin";
-import type { ITtscParsedProjectConfig } from "./ITtscParsedProjectConfig";
-import type { ITtscPlugin } from "./ITtscPlugin";
-
-export interface ITtscLoadedPlugins {
-  compatibilityFallback: boolean;
-  nativeBinary: string | null;
-  nativeBinaries: string[];
-  nativePlugins: ITtscLoadedNativePlugin[];
-  plugins: ITtscPlugin[];
-  project: ITtscParsedProjectConfig;
-}

package/src/structures/ITtscNativeBackend.ts

@@ -1,11 +0,0 @@
-import type { ITtscNativePluginContractVersion } from "./ITtscNativePluginContractVersion";
-import type { ITtscNativeRewriteMode } from "./ITtscNativeRewriteMode";
-import type { ITtscNativeSource } from "./ITtscNativeSource";
-
-export interface ITtscNativeBackend {
-  mode: ITtscNativeRewriteMode;
-  binary?: string;
-  source?: ITtscNativeSource;
-  contractVersion?: ITtscNativePluginContractVersion;
-  capabilities?: readonly string[];
-}

package/src/structures/ITtscNativePluginContractVersion.ts

@@ -1 +0,0 @@
-export type ITtscNativePluginContractVersion = 1;

package/src/structures/ITtscNativePluginShape.ts

@@ -1,9 +0,0 @@
-import type { ITtscNativeBackend } from "./ITtscNativeBackend";
-import type { ITtscNativeRewriteMode } from "./ITtscNativeRewriteMode";
-
-export interface ITtscNativePluginShape {
-  name: string;
-  native?: ITtscNativeBackend;
-  nativeMode?: ITtscNativeRewriteMode;
-  nativeBinary?: string;
-}

package/src/structures/ITtscNativeRewriteMode.ts

@@ -1 +0,0 @@
-export type ITtscNativeRewriteMode = string;

package/src/structures/ITtscNativeSource.ts

@@ -1,4 +0,0 @@
-export interface ITtscNativeSource {
-  dir: string;
-  entry?: string;
-}

package/src/structures/ITtscParsedProjectConfig.ts

@@ -1,10 +0,0 @@
-import type { ITtscProjectPluginConfig } from "./ITtscProjectPluginConfig";
-
-export interface ITtscParsedProjectConfig {
-  compilerOptions: {
-    outDir?: string;
-    plugins: ITtscProjectPluginConfig[];
-  } & Record<string, unknown>;
-  path: string;
-  root: string;
-}

package/src/structures/ITtscPluginFactory.ts

@@ -1,7 +0,0 @@
-import type { ITtscPlugin } from "./ITtscPlugin";
-import type { ITtscPluginFactoryContext } from "./ITtscPluginFactoryContext";
-import type { ITtscProjectPluginConfig } from "./ITtscProjectPluginConfig";
-
-export type ITtscPluginFactory<T = ITtscProjectPluginConfig> = (
-  context: ITtscPluginFactoryContext<T>,
-) => ITtscPlugin;

package/src/structures/ITtscPluginModule.ts

@@ -1,4 +0,0 @@
-import type { ITtscPlugin } from "./ITtscPlugin";
-import type { ITtscPluginFactory } from "./ITtscPluginFactory";
-
-export type ITtscPluginModule = ITtscPlugin | ITtscPluginFactory;

package/src/structures/ITtscPreparedExecution.ts

@@ -1,5 +0,0 @@
-export interface ITtscPreparedExecution {
-  emitDir: string;
-  entryFile: string;
-  moduleKind: "cjs" | "esm";
-}

package/src/structures/ITtscProjectLocatorOptions.ts

@@ -1,5 +0,0 @@
-export interface ITtscProjectLocatorOptions {
-  cwd?: string;
-  file?: string;
-  tsconfig?: string;
-}

package/src/structures/ITtscRegisterOptions.ts

@@ -1,7 +0,0 @@
-import type { ITtscCommonOptions } from "./ITtscCommonOptions";
-
-export interface ITtscRegisterOptions extends ITtscCommonOptions {
-  cacheDir?: string;
-  project?: string;
-  extensions?: readonly string[];
-}

package/src/structures/ITtscResolveGoBinaryOptions.ts

@@ -1,7 +0,0 @@
-export interface ITtscResolveGoBinaryOptions {
-  arch?: string;
-  env?: NodeJS.ProcessEnv;
-  localGoLookup?: () => string | null;
-  platform?: NodeJS.Platform;
-  resolver?: (request: string) => string;
-}

package/src/structures/ITtscResolveOptions.ts

@@ -1,20 +0,0 @@
-export interface ITtscResolveOptions {
-  /**
-   * Override `require.resolve` for testing. Takes a module request string and
-   * returns an absolute path (or throws).
-   */
-  resolver?: (request: string) => string;
-  /** Override `process.platform` for testing. */
-  platform?: NodeJS.Platform;
-  /** Override `process.arch` for testing. */
-  arch?: string;
-  /** Override `process.env` for testing. */
-  env?: NodeJS.ProcessEnv;
-  /**
-   * Override the package-local scan used for the local `native/ttsc-native`
-   * fallback. Returns an absolute path if present, else null.
-   */
-  localBinaryLookup?: () => string | null;
-  /** Override the module directory used to resolve the package-local binary. */
-  moduleDir?: string;
-}

package/src/structures/ITtscResolvedTsgo.ts

@@ -1,8 +0,0 @@
-export interface ITtscResolvedTsgo {
-  binary: string;
-  gitHead?: string;
-  packageJson: string;
-  packageRoot: string;
-  platformPackageJson?: string;
-  version: string;
-}

package/src/structures/ITtscTransformOptions.ts

@@ -1,13 +0,0 @@
-import type { ITtscCommonOptions } from "./ITtscCommonOptions";
-
-export interface ITtscTransformOptions extends ITtscCommonOptions {
-  /** Path to the .ts file to transform. Absolute or `cwd`-relative. */
-  file: string;
-  /** Path to the tsconfig owning `file`. Default: `tsconfig.json`. */
-  tsconfig?: string;
-  /**
-   * When provided, the binary writes JS directly to this path instead of piping
-   * stdout. Useful when the emitted text is large.
-   */
-  out?: string;
-}

package/src/structures/ITtscTsgoResolveOptions.ts

@@ -1,14 +0,0 @@
-export interface ITtscTsgoResolveOptions {
-  /** Absolute path to an explicit tsgo-compatible binary. */
-  binary?: string;
-  /** Project directory used for node_modules resolution. */
-  cwd?: string;
-  /** Environment variables used for explicit binary overrides. */
-  env?: NodeJS.ProcessEnv;
-  /** Override process.platform for tests. */
-  platform?: NodeJS.Platform;
-  /** Override process.arch for tests. */
-  arch?: string;
-  /** Override package resolution for tests. */
-  resolver?: (request: string) => string;
-}