ttsc 0.8.1 → 0.9.0

package/lib/plugin/internal/loadProjectPlugins.js

@@ -4,6 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.loadProjectPlugins = loadProjectPlugins;
+exports.hasProjectPluginEntries = hasProjectPluginEntries;
 const node_module_1 = require("node:module");
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
@@ -13,11 +14,12 @@ function loadProjectPlugins(options) {
     const project = (0, readProjectConfig_1.readProjectConfig)({
         cwd: options.cwd,
         file: options.file,
+        projectRoot: options.projectRoot,
         tsconfig: options.tsconfig,
     });
     const entries = options.entries === false
         ? []
-        : [...(options.entries ?? project.compilerOptions.plugins)].filter((entry) => entry.enabled !== false);
+        : resolvePluginEntries(project, options.entries).filter((entry) => entry.config.enabled !== false);
     if (entries.length === 0) {
         return {
             nativePlugins: [],
@@ -30,7 +32,7 @@ function loadProjectPlugins(options) {
         projectRoot: project.root,
         tsconfig: project.path,
     };
-    const plugins = entries.map((entry) => loadPluginEntry(entry, { ...context, plugin: entry }));
+    const plugins = entries.map((entry) => loadPluginEntry(entry.config, { ...context, plugin: entry.config }, entry.baseDir));
     const nativePlugins = [];
     const ttscVersion = readTtscVersion();
     const tsgoVersion = readTsgoVersion(context.projectRoot);
@@ -47,23 +49,201 @@ function loadProjectPlugins(options) {
         });
         nativePlugins.push({
             binary,
-            config: entries[index],
+            config: entries[index].config,
             name: plugin.name,
             source: plugin.source,
             stage,
         });
     });
     return {
-        nativePlugins,
+        nativePlugins: orderNativePlugins(nativePlugins),
         project,
     };
 }
-function loadPluginEntry(entry, context) {
+function hasProjectPluginEntries(project, entries) {
+    if (entries === false) {
+        return false;
+    }
+    return resolvePluginEntries(project, entries).some((entry) => entry.config.enabled !== false);
+}
+function resolvePluginEntries(project, entries) {
+    if (entries !== undefined) {
+        return entries.map((config) => ({
+            baseDir: project.root,
+            config,
+        }));
+    }
+    const configured = project.compilerOptions.plugins.map((config, index) => ({
+        baseDir: project.pluginBaseDirs[index] ?? project.root,
+        config,
+    }));
+    return [...configured, ...discoverPackagePluginEntries(project, configured)];
+}
+function discoverPackagePluginEntries(project, configured) {
+    const projectPackageJson = findNearestPackageJson(project.root);
+    if (projectPackageJson === undefined) {
+        return [];
+    }
+    const projectPackageRoot = node_path_1.default.dirname(projectPackageJson);
+    const projectManifest = readPackageManifest(projectPackageJson);
+    if (projectManifest === undefined) {
+        return [];
+    }
+    const configuredTransforms = createConfiguredTransformSet(configured);
+    const out = [];
+    for (const name of directDependencyNames(projectManifest)) {
+        const packageJson = resolveDependencyPackageJson(name, projectPackageRoot);
+        if (packageJson === undefined) {
+            continue;
+        }
+        const manifest = readPackageManifest(packageJson);
+        const config = readPackagePluginConfig(name, manifest);
+        if (config === undefined || config.enabled === false) {
+            continue;
+        }
+        const packageRoot = node_path_1.default.dirname(packageJson);
+        const transform = config.transform;
+        if (typeof transform !== "string") {
+            continue;
+        }
+        const baseDir = isRelativePluginSpecifier(transform)
+            ? packageRoot
+            : projectPackageRoot;
+        const resolved = resolvePluginRequest(transform, baseDir);
+        if (hasConfiguredTransform(configuredTransforms, transform, resolved)) {
+            continue;
+        }
+        out.push({
+            baseDir,
+            config,
+        });
+        addConfiguredTransform(configuredTransforms, transform, resolved);
+    }
+    return out;
+}
+function createConfiguredTransformSet(entries) {
+    const raw = new Set();
+    const resolved = new Set();
+    for (const entry of entries) {
+        const transform = entry.config.transform;
+        if (typeof transform !== "string" || transform.length === 0) {
+            continue;
+        }
+        if (!isRelativePluginSpecifier(transform)) {
+            raw.add(transform);
+        }
+        try {
+            resolved.add(resolvePluginRequest(transform, entry.baseDir));
+        }
+        catch {
+            // Keep the normal plugin loading error path for invalid explicit entries.
+        }
+    }
+    return { raw, resolved };
+}
+function hasConfiguredTransform(configuredTransforms, transform, resolved) {
+    return (configuredTransforms.resolved.has(resolved) ||
+        (!isRelativePluginSpecifier(transform) &&
+            configuredTransforms.raw.has(transform)));
+}
+function addConfiguredTransform(configuredTransforms, transform, resolved) {
+    if (!isRelativePluginSpecifier(transform)) {
+        configuredTransforms.raw.add(transform);
+    }
+    configuredTransforms.resolved.add(resolved);
+}
+function directDependencyNames(manifest) {
+    const seen = new Set();
+    const out = [];
+    for (const dependencies of [
+        manifest.dependencies,
+        manifest.devDependencies,
+    ]) {
+        if (!isRecord(dependencies)) {
+            continue;
+        }
+        for (const name of Object.keys(dependencies)) {
+            if (seen.has(name)) {
+                continue;
+            }
+            seen.add(name);
+            out.push(name);
+        }
+    }
+    return out;
+}
+function resolveDependencyPackageJson(name, projectRoot) {
+    const direct = node_path_1.default.join(projectRoot, "node_modules", ...name.split("/"));
+    const directManifest = node_path_1.default.join(direct, "package.json");
+    if (node_fs_1.default.existsSync(directManifest)) {
+        return resolveRealPath(directManifest);
+    }
+    const projectPackage = node_path_1.default.join(projectRoot, "package.json");
+    const projectRequire = (0, node_module_1.createRequire)(projectPackage);
+    try {
+        return resolveRealPath(projectRequire.resolve(`${name}/package.json`));
+    }
+    catch {
+        try {
+            return findNearestPackageJson(projectRequire.resolve(name));
+        }
+        catch {
+            return undefined;
+        }
+    }
+}
+function findNearestPackageJson(location) {
+    let current = node_fs_1.default.statSync(location).isDirectory()
+        ? location
+        : node_path_1.default.dirname(location);
+    while (true) {
+        const manifest = node_path_1.default.join(current, "package.json");
+        if (node_fs_1.default.existsSync(manifest)) {
+            return resolveRealPath(manifest);
+        }
+        const parent = node_path_1.default.dirname(current);
+        if (parent === current) {
+            return undefined;
+        }
+        current = parent;
+    }
+}
+function readPackageManifest(file) {
+    if (!node_fs_1.default.existsSync(file)) {
+        return undefined;
+    }
+    const parsed = JSON.parse(node_fs_1.default.readFileSync(file, "utf8"));
+    return isRecord(parsed) ? parsed : undefined;
+}
+function readPackagePluginConfig(packageName, manifest) {
+    const ttsc = manifest?.ttsc;
+    if (!isRecord(ttsc) || !("plugin" in ttsc)) {
+        return undefined;
+    }
+    const plugin = ttsc.plugin;
+    if (!isRecord(plugin) || Array.isArray(plugin)) {
+        throw new Error(`ttsc: package ${JSON.stringify(packageName)} declares invalid "ttsc.plugin"; expected an object`);
+    }
+    if (typeof plugin.transform !== "string" || plugin.transform.length === 0) {
+        throw new Error(`ttsc: package ${JSON.stringify(packageName)} declares invalid "ttsc.plugin.transform"; expected a non-empty string`);
+    }
+    return { ...plugin };
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function orderNativePlugins(plugins) {
+    return [
+        ...plugins.filter((plugin) => plugin.stage === "check"),
+        ...plugins.filter((plugin) => plugin.stage === "transform"),
+    ];
+}
+function loadPluginEntry(entry, context, baseDir) {
     const specifier = entry.transform;
     if (typeof specifier !== "string" || specifier.length === 0) {
         throw new Error(`ttsc: plugin entry is missing a string "transform" field`);
     }
-    const request = resolvePluginRequest(specifier, context.projectRoot);
+    const request = resolvePluginRequest(specifier, baseDir);
     const mod = require(request);
     const candidate = mod.createTtscPlugin ??
         mod.default ??
@@ -117,12 +297,20 @@ function isPluginStage(value) {
 }
 function resolvePluginRequest(specifier, projectRoot) {
     if (node_path_1.default.isAbsolute(specifier)) {
-        return specifier;
+        return resolveRealPath(specifier);
     }
     if (isRelativePluginSpecifier(specifier)) {
-        return node_path_1.default.resolve(projectRoot, specifier);
+        return resolveRealPath(node_path_1.default.resolve(projectRoot, specifier));
+    }
+    return resolveRealPath(require.resolve(specifier, { paths: [projectRoot] }));
+}
+function resolveRealPath(location) {
+    try {
+        return node_fs_1.default.realpathSync(location);
+    }
+    catch {
+        return location;
     }
-    return require.resolve(specifier, { paths: [projectRoot] });
 }
 function isRelativePluginSpecifier(specifier) {
     return (specifier === "." ||

package/lib/plugin/internal/loadProjectPlugins.js.map

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

package/lib/structures/ITtscCompilerContext.d.ts

@@ -32,6 +32,16 @@ export interface ITtscCompilerContext {
      * `jsconfig.json` from the working directory.
      */
     tsconfig?: string;
+    /**
+     * Project root override for generated config wrappers.
+     *
+     * Most callers should leave this unset so the project root is the directory
+     * containing {@link ITtscCompilerContext.tsconfig}. Embedders that synthesize
+     * a temporary config extending a real project config can set this to keep
+     * plugin resolution, cache paths, and native sidecar `--cwd` anchored to the
+     * real project.
+     */
+    projectRoot?: string;
     /**
      * Explicit TypeScript-Go executable for controlled embedding.
      *
@@ -67,9 +77,12 @@ export interface ITtscCompilerContext {
     /**
      * Plugin entries for this compiler instance.
      *
-     * - `undefined`: read `compilerOptions.plugins` from the project config.
-     * - `false`: ignore project plugins for this compiler instance.
-     * - array: use these plugin entries instead of the project config entries.
+     * - `undefined`: read project plugins from `compilerOptions.plugins` and
+     *   directly installed package markers.
+     * - `false`: ignore project config plugins and package markers for this
+     *   compiler instance.
+     * - array: use these plugin entries instead of project config entries and
+     *   package markers.
      *
      * Plugin entries are resolved once per operation from this instance context.
      * Per-call plugin overrides are intentionally not part of the public API.

package/lib/structures/ITtscCompilerResult.d.ts

@@ -28,6 +28,10 @@ export declare namespace ITtscCompilerResult {
          * Indicates that the compilation was successful.
          */
         type: "success";
+        /**
+         * Non-fatal diagnostics reported during compilation.
+         */
+        diagnostics?: ITtscCompilerDiagnostic[];
         /**
          * The generated compiler output.
          *

package/lib/structures/ITtscCompilerTransformation.d.ts

@@ -13,6 +13,8 @@ export declare namespace ITtscCompilerTransformation {
     interface ISuccess {
         /** Indicates that transformation completed without diagnostics. */
         type: "success";
+        /** Non-fatal diagnostics reported during transformation. */
+        diagnostics?: ITtscCompilerDiagnostic[];
         /** Transformed TypeScript source text keyed by project file path. */
         typescript: Record<string, string>;
     }

package/lib/structures/ITtscPluginFactoryContext.d.ts

@@ -39,10 +39,13 @@ export interface ITtscPluginFactoryContext<T = ITtscProjectPluginConfig> {
      */
     plugin: T;
     /**
-     * Directory containing the resolved tsconfig/jsconfig.
+     * Project root used as the native plugin working directory and package
+     * discovery base.
      *
-     * Relative plugin module specifiers and plugin source paths are resolved from
-     * this directory, matching TypeScript plugin config behavior.
+     * By default this is the directory containing the resolved tsconfig/jsconfig.
+     * Callers may override it when a wrapper config lives outside the project.
+     * Relative `source` paths returned by a plugin descriptor resolve from this
+     * directory.
      */
     projectRoot: string;
     /**

package/lib/structures/ITtscProjectPluginConfig.d.ts

@@ -1,9 +1,10 @@
 /**
- * Raw `compilerOptions.plugins[]` entry read from tsconfig/jsconfig.
+ * Raw plugin entry read from `compilerOptions.plugins[]` or from a directly
+ * installed package's `package.json#ttsc.plugin` marker.
  *
- * This is the project-facing config shape that users write in
- * `tsconfig.json`. ttsc deliberately keeps it open-ended because plugin
- * packages own their own config fields.
+ * This is the project-facing config shape that users write in `tsconfig.json`
+ * or plugin packages expose through `package.json`. ttsc deliberately keeps it
+ * open-ended because plugin packages own their own config fields.
  *
  * ttsc interprets only two properties:
  *
@@ -27,9 +28,9 @@ export interface ITtscProjectPluginConfig {
     /**
      * Plugin module specifier, relative path, or absolute path to load.
      *
-     * Relative paths are resolved from the resolved project root, which is the
-     * directory containing the active tsconfig/jsconfig. Package specifiers are
-     * resolved with Node's package resolution from that same project root.
+     * Relative paths are resolved from the tsconfig/jsconfig file that declared
+     * the plugin entry. Package specifiers are resolved with Node's package
+     * resolution from that same directory.
      *
      * The loaded JavaScript module must export an {@link ITtscPlugin} descriptor
      * or a `createTtscPlugin(context)` factory. The Go implementation itself is

package/lib/structures/internal/ITtscParsedProjectConfig.d.ts

@@ -10,6 +10,8 @@ export interface ITtscParsedProjectConfig {
     } & Record<string, unknown>;
     /** Absolute path to the resolved tsconfig/jsconfig. */
     path: string;
+    /** Directory that declared each inherited plugin entry. */
+    pluginBaseDirs: string[];
     /** Directory containing the resolved tsconfig/jsconfig. */
     root: string;
 }

package/lib/structures/internal/ITtscProjectLocatorOptions.d.ts

@@ -4,6 +4,8 @@ export interface ITtscProjectLocatorOptions {
     cwd?: string;
     /** Source file used as the starting point for nearest-config discovery. */
     file?: string;
+    /** Project root override for generated tsconfig wrappers. */
+    projectRoot?: string;
     /** Explicit tsconfig/jsconfig path. */
     tsconfig?: string;
 }

package/lib/structures/internal/TtscCommonOptions.d.ts

@@ -10,6 +10,8 @@ export interface TtscCommonOptions {
     binary?: string;
     /** Working directory for config discovery and relative file paths. */
     cwd?: string;
+    /** Project root override for generated tsconfig wrappers. */
+    projectRoot?: string;
     /** Environment variables merged over `process.env` for child processes. */
     env?: NodeJS.ProcessEnv;
     /** Explicit root directory for compiled source-plugin cache artifacts. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ttsc",
-  "version": "0.8.1",
+  "version": "0.9.0",
   "description": "General-purpose TypeScript-Go compiler, plugin host, and runtime.",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -27,17 +27,17 @@
   "homepage": "https://github.com/samchon/ttsc",
   "devDependencies": {
     "@types/node": "^25.3.0",
-    "@typescript/native-preview": "7.0.0-dev.20260506.1",
+    "@typescript/native-preview": "7.0.0-dev.20260508.1",
     "rimraf": "^6.1.2"
   },
   "optionalDependencies": {
-    "@ttsc/linux-arm": "0.8.1",
-    "@ttsc/linux-x64": "0.8.1",
-    "@ttsc/linux-arm64": "0.8.1",
-    "@ttsc/darwin-arm64": "0.8.1",
-    "@ttsc/darwin-x64": "0.8.1",
-    "@ttsc/win32-arm64": "0.8.1",
-    "@ttsc/win32-x64": "0.8.1"
+    "@ttsc/linux-x64": "0.9.0",
+    "@ttsc/linux-arm": "0.9.0",
+    "@ttsc/darwin-arm64": "0.9.0",
+    "@ttsc/linux-arm64": "0.9.0",
+    "@ttsc/darwin-x64": "0.9.0",
+    "@ttsc/win32-x64": "0.9.0",
+    "@ttsc/win32-arm64": "0.9.0"
   },
   "sideEffects": false,
   "files": [
@@ -50,7 +50,6 @@
     "lib",
     "shim",
     "src",
-    "test",
     "tools",
     "utility"
   ],
@@ -63,11 +62,7 @@
   ],
   "scripts": {
     "build": "rimraf lib && tsgo && cp ../../README.md README.md",
-    "test": "pnpm run test:ts && pnpm run test:go",
-    "test:ts": "node --test --test-reporter=spec --experimental-strip-types --experimental-specifier-resolution=node test/**/*.test.ts",
-    "test:go": "node ../../scripts/go.cjs test ./...",
     "go:build": "node ../../scripts/go.cjs build-native",
-    "go:test": "node ../../scripts/go.cjs test ./...",
     "go:vet": "node ../../scripts/go.cjs vet ./..."
   }
 }

package/shim/diagnosticwriter/lint.go

@@ -83,6 +83,14 @@ func (d *LintDiagnostic) Localize(_ locale.Locale) string        { return d.mess
 func (d *LintDiagnostic) MessageChain() []inner.Diagnostic       { return nil }
 func (d *LintDiagnostic) RelatedInformation() []inner.Diagnostic { return nil }
 
+// Message returns the already-localized lint message.
+func (d *LintDiagnostic) Message() string {
+  if d == nil {
+    return ""
+  }
+  return d.message
+}
+
 // IsError reports whether the diagnostic should fail the build. Lint plugins
 // use this to compute their exit code separately from the renderer.
 func (d *LintDiagnostic) IsError() bool { return d.category == LintCategoryError }

package/src/TtscCompiler.ts

@@ -1,5 +1,5 @@
-import * as fs from "node:fs";
-import * as path from "node:path";
+import fs from "node:fs";
+import path from "node:path";
 
 import { compileProjectInMemory } from "./compiler/internal/compileProjectInMemory";
 import { resolveProjectConfig } from "./compiler/internal/project/resolveProjectConfig";
@@ -66,6 +66,7 @@ export class TtscCompiler {
       cacheDir: this.resolvePluginCacheDir(),
       cwd: execution.cwd,
       entries: this.context.plugins,
+      projectRoot: execution.projectRoot,
       tsconfig: execution.tsconfig,
     });
     return loaded.nativePlugins.map((plugin) => plugin.binary);
@@ -161,7 +162,9 @@ export class TtscCompiler {
     });
     return {
       cwd,
-      projectRoot: path.dirname(tsconfig),
+      projectRoot: this.context.projectRoot
+        ? path.resolve(cwd, this.context.projectRoot)
+        : path.dirname(tsconfig),
       tsconfig,
     };
   }
@@ -243,8 +246,11 @@ function runTransformation(
 
 function toCompilerResult(project: ProjectResult): ITtscCompilerResult {
   const { output, result } = project;
-  if (result.status === 0 && result.diagnostics.length === 0) {
+  if (result.status === 0 && !hasErrorDiagnostics(result.diagnostics)) {
     return {
+      ...(result.diagnostics.length === 0
+        ? {}
+        : { diagnostics: result.diagnostics }),
       output,
       type: "success",
     };
@@ -277,8 +283,11 @@ function toCompilerTransformation(
   project: ProjectTransformation,
 ): ITtscCompilerTransformation {
   const { result, typescript } = project;
-  if (result.status === 0 && result.diagnostics.length === 0) {
+  if (result.status === 0 && !hasErrorDiagnostics(result.diagnostics)) {
     return {
+      ...(result.diagnostics.length === 0
+        ? {}
+        : { diagnostics: result.diagnostics }),
       type: "success",
       typescript,
     };
@@ -293,6 +302,12 @@ function toCompilerTransformation(
   };
 }
 
+function hasErrorDiagnostics(
+  diagnostics: readonly ITtscCompilerDiagnostic[],
+): boolean {
+  return diagnostics.some((diagnostic) => diagnostic.category === "error");
+}
+
 function normalizeError(error: unknown): unknown {
   if (!(error instanceof Error)) {
     return error;

package/src/compiler/internal/buildNativeCompiler.ts

@@ -1,5 +1,5 @@
-import * as fs from "node:fs";
-import * as path from "node:path";
+import fs from "node:fs";
+import path from "node:path";
 
 import { buildSourcePlugin } from "../../plugin/internal/buildSourcePlugin";
 

package/src/compiler/internal/compileProjectInMemory.ts

@@ -1,11 +1,11 @@
 import { spawnSync } from "node:child_process";
-import * as fs from "node:fs";
-import * as os from "node:os";
-import * as path from "node:path";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
 
+import { hasProjectPluginEntries } from "../../plugin/internal/loadProjectPlugins";
 import type { ITtscCompilerContext } from "../../structures/ITtscCompilerContext";
 import type { ITtscCompilerDiagnostic } from "../../structures/ITtscCompilerDiagnostic";
-import type { ITtscProjectPluginConfig } from "../../structures/ITtscProjectPluginConfig";
 import type { ITtscParsedProjectConfig } from "../../structures/internal/ITtscParsedProjectConfig";
 import type { TtscBuildResult } from "../../structures/internal/TtscBuildResult";
 import { buildNativeCompiler } from "./buildNativeCompiler";
@@ -20,22 +20,23 @@ export function compileProjectInMemory(options: ITtscCompilerContext): {
   const cwd = path.resolve(options.cwd ?? process.cwd());
   const project = readProjectConfig({
     cwd,
+    projectRoot: options.projectRoot,
     tsconfig: options.tsconfig,
   });
-  if (configuredPlugins(options, project).length !== 0) {
+  if (hasConfiguredPlugins(options, project)) {
     return compileProjectWithPlugins(options, cwd, project);
   }
   const tsconfig = project.path;
   const binary = buildNativeCompiler({
-    cacheBaseDir: path.dirname(tsconfig),
+    cacheBaseDir: project.root,
     cacheDir: options.cacheDir,
     packageRoot: packageRootDir(),
   });
   const res = spawnSync(
     binary,
-    ["api-compile", "--cwd", path.dirname(tsconfig), "--tsconfig", tsconfig],
+    ["api-compile", "--cwd", project.root, "--tsconfig", tsconfig],
     {
-      cwd: path.dirname(tsconfig),
+      cwd: project.root,
       encoding: "utf8",
       env: { ...process.env, ...options.env },
       maxBuffer: 1024 * 1024 * 256,
@@ -60,15 +61,11 @@ export function compileProjectInMemory(options: ITtscCompilerContext): {
   };
 }
 
-function configuredPlugins(
+function hasConfiguredPlugins(
   options: ITtscCompilerContext,
   project: ITtscParsedProjectConfig,
-): ITtscProjectPluginConfig[] {
-  if (options.plugins === false) {
-    return [];
-  }
-  const entries = options.plugins ?? project.compilerOptions.plugins;
-  return entries.filter((entry) => entry.enabled !== false);
+): boolean {
+  return hasProjectPluginEntries(project, options.plugins);
 }
 
 function compileProjectWithPlugins(
@@ -109,13 +106,21 @@ function outputKeyMapper(
     return (relativePath) => relativePath;
   }
   const relativeOutDir = path.relative(project.root, outDir);
-  if (relativeOutDir !== "" && !relativeOutDir.startsWith("..")) {
+  if (relativeOutDir !== "" && !isOutsideRelativePath(relativeOutDir)) {
     const prefix = pathToKey(relativeOutDir);
     return (relativePath) => path.posix.join(prefix, relativePath);
   }
   return (relativePath) => pathToKey(path.join(outDir, relativePath));
 }
 
+function isOutsideRelativePath(relative: string): boolean {
+  return (
+    relative === ".." ||
+    relative.startsWith(`..${path.sep}`) ||
+    path.isAbsolute(relative)
+  );
+}
+
 function readOutputDirectory(
   directory: string,
   keyOf: (relativePath: string) => string,