ttsc 0.26.2 → 0.28.0

package/lib/launcher/internal/runtimeHooks.d.ts

@@ -14,6 +14,32 @@ export interface OwningModuleOptions {
     module?: string;
     target?: string;
 }
+/**
+ * Runtime manifest written by `runTtsx` (the parent) and read once here. It
+ * describes the already-built entry project so the hooks can serve its emit.
+ */
+export interface RuntimeManifest {
+    /** Project root of the entry's owning tsconfig. */
+    projectRoot: string;
+    /** Source-tree root the emit mirrors (tsgo strips this prefix). */
+    rootDir: string;
+    /** Directory holding the entry project's emitted JavaScript. */
+    emitDir: string;
+    /** Emitted file list from the entry build, for source→output matching. */
+    emittedFiles?: readonly string[];
+    /** Physical TypeScript root whose checked preparation created this manifest. */
+    entrySource?: string;
+    /** Exact JavaScript emitted for `entrySource`. */
+    entryFile?: string;
+    /**
+     * The entry tsconfig's `module` and `target`, deciding emit CJS/ESM per file.
+     * `target` is not decoration: an absent `module` makes tsgo derive the module
+     * kind from it.
+     */
+    moduleOptions?: OwningModuleOptions;
+    /** Root directory for per-dependency build output. */
+    depCacheDir: string;
+}
 /**
  * Lowest Node.js the ttsx source runtime supports. The synchronous
  * `module.registerHooks` (Node 22.15.0) is the highest floor among the runtime
@@ -35,6 +61,10 @@ export declare const TTSX_MINIMUM_NODE_VERSION = "22.15.0";
  * around the floor cannot otherwise be pinned on CI.
  */
 export declare function checkNodeRuntimeSupport(version: string): string | null;
+export interface RuntimeHookOptions {
+    /** Prepare and type-check a TypeScript root discovered after registration. */
+    prepareEntry?: (filename: string) => RuntimeManifest;
+}
 /**
  * Install the source-loading hooks on the current (main) thread. Idempotent:
  * the bootstrap installs them for the entry process, and `NODE_OPTIONS`
@@ -45,10 +75,18 @@ export declare function checkNodeRuntimeSupport(version: string): string | null;
  * `require()` made from inside a CommonJS module that was itself reached
  * through an ESM `import` (the interop translator loads it on the raw CJS
  * path). The ESM graph goes through `registerHooks`; the CommonJS `require`
- * graph goes through `Module._extensions` — the canonical loader extension
- * point `ts-node`/`tsx` use for the same reason.
+ * graph goes through `Module._extensions` and `Module._resolveFilename` — the
+ * canonical loader extension points `ts-node`/`tsx` use for the same reason.
+ *
+ * Both halves of that second graph are required, and they answer different
+ * questions. `_extensions` decides how a file that was _found_ is compiled, and
+ * Node reuses its keys when it probes an extensionless request, so
+ * `require("./x")` reaches `x.ts` for free. Nothing there resolves a request
+ * that already carries an extension: `require("./x.js")` backed only by `x.ts`
+ * is a resolution failure before any compiler is consulted, which is why the
+ * rescue is installed on `_resolveFilename` as well (samchon/ttsc#1280).
  */
-export declare function installRuntimeHooks(): void;
+export declare function installRuntimeHooks(options?: RuntimeHookOptions): void;
 /**
  * The module format of the entry source file, derived from the entry project's
  * compiler options (via the runtime manifest) the same way the served files are
@@ -88,6 +126,11 @@ export declare function projectModuleOptions(compilerOptions: Record<string, unk
  * cannot pin both Windows case-semantics branches on CI.
  */
 export declare function isWithin(real: string, directory: string, identities?: FilesystemPathIdentityContext): boolean;
+/** Derive one dependency cache key; exported for isolation regressions. */
+export declare function dependencyCacheKey(tsconfig: string, options?: {
+    descriptorLoad?: boolean;
+    descriptorNonce?: string;
+}): string;
 /**
  * Reuse a dependency another process (or an earlier import) already built.
  *
@@ -102,6 +145,7 @@ export declare function isWithin(real: string, directory: string, identities?: F
  * Exported for the ttsx dependency-cache regressions.
  */
 export declare function readDependencyCache(cacheDir: string, metaPath: string): BuiltProject | null;
+export declare function dependencyCacheRoot(env?: NodeJS.ProcessEnv): string;
 /** Ownership token returned only to the process that acquired `current`. */
 export type DependencyBuildLockLease = {
     generation: string;