ttsc 0.6.0 → 0.7.1

package/lib/TtscCompiler.js

@@ -0,0 +1,294 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TtscCompiler = void 0;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const compileProjectInMemory_1 = require("./compiler/internal/compileProjectInMemory");
+const resolveProjectConfig_1 = require("./compiler/internal/project/resolveProjectConfig");
+const resolveBinary_1 = require("./compiler/internal/resolveBinary");
+const transformProjectInMemory_1 = require("./compiler/internal/transformProjectInMemory");
+const loadProjectPlugins_1 = require("./plugin/internal/loadProjectPlugins");
+/**
+ * Programmatic compiler host for the `ttsc` TypeScript-Go pipeline.
+ *
+ * `TtscCompiler` is the root JavaScript API exported by the `ttsc` package.
+ * It represents one resolved project context: a working directory, an optional
+ * project config path, an optional native toolchain override, an environment,
+ * a cache root, and a plugin list. Those values are captured by the
+ * constructor and are intentionally not replaceable per method call.
+ *
+ * The class exposes only the operations that make sense for an embedded
+ * compiler host:
+ *
+ * - {@link TtscCompiler.prepare}: build configured Go source plugins into the
+ *   cache before a later compile.
+ * - {@link TtscCompiler.clean}: remove the cache owned by this compiler
+ *   context.
+ * - {@link TtscCompiler.compile}: compile the configured project and return a
+ *   structured result instead of terminal text.
+ * - {@link TtscCompiler.transform}: transform the configured project and
+ *   return an embed-style transformation result.
+ */
+class TtscCompiler {
+    context;
+    constructor(context = {}) {
+        this.context = {
+            ...context,
+            env: context.env ? { ...context.env } : undefined,
+            plugins: Array.isArray(context.plugins)
+                ? [...context.plugins]
+                : context.plugins,
+        };
+    }
+    /**
+     * Build every configured source plugin into the instance cache.
+     *
+     * This method loads the project plugin descriptors, resolves their
+     * {@link ITtscPlugin.source} paths, and compiles those Go command packages
+     * into the ttsc cache. It is useful when a host application wants to pay the
+     * lazy build cost before the first compile call.
+     *
+     * `prepare()` is not a project check. It does not create a TypeScript-Go
+     * Program, does not run diagnostics, and does not emit output files.
+     *
+     * @returns Compiled native plugin binary paths.
+     */
+    prepare() {
+        const execution = this.resolveProjectExecution();
+        const loaded = (0, loadProjectPlugins_1.loadProjectPlugins)({
+            binary: (0, resolveBinary_1.resolveBinary)(this.compilerContext()) ?? "",
+            cacheDir: this.resolvePluginCacheDir(),
+            cwd: execution.cwd,
+            entries: this.context.plugins,
+            tsconfig: execution.tsconfig,
+        });
+        return loaded.nativePlugins.map((plugin) => plugin.binary);
+    }
+    /**
+     * Remove compiled cache artifacts for this compiler instance.
+     *
+     * When the constructor received `cacheDir`, this method removes exactly that
+     * directory. Otherwise it removes the default ttsc cache locations for the
+     * resolved project root, plus the `TTSC_CACHE_DIR/plugins` cache when that
+     * environment variable is active.
+     *
+     * The cache target comes from the constructor context. Create another
+     * `TtscCompiler` instance to clean another project or another cache root.
+     *
+     * @returns Cache directories that were removed.
+     */
+    clean() {
+        const cacheDir = this.resolveCacheDir();
+        if (cacheDir !== undefined) {
+            return removeExistingDirectories([cacheDir]);
+        }
+        const envCacheDir = this.context.env?.TTSC_CACHE_DIR ?? process.env.TTSC_CACHE_DIR;
+        const projectRoot = this.resolveCleanProjectRoot();
+        return removeExistingDirectories([
+            ...(envCacheDir ? [path.resolve(envCacheDir, "plugins")] : []),
+            path.join(projectRoot, "node_modules", ".ttsc"),
+            path.join(projectRoot, ".ttsc"),
+        ]);
+    }
+    /**
+     * Compile the configured project.
+     *
+     * The public API does not write emitted files into the caller's project tree.
+     * For projects without plugins, ttsc uses its native TypeScript-Go host's
+     * `WriteFile` callback to capture output in memory. For projects with
+     * native plugins, ttsc runs the plugin pipeline against a temporary output
+     * directory, reads the generated text artifacts, and removes the temporary
+     * directory before returning.
+     *
+     * The result uses an `embed-typescript`-style discriminated union:
+     * `success` for clean compiles, `failure` for normal compiler diagnostics,
+     * and `exception` for host setup or process failures.
+     *
+     * @returns Structured compilation result containing diagnostics or output.
+     */
+    compile() {
+        return runProject(() => (0, compileProjectInMemory_1.compileProjectInMemory)(this.compilerContext()));
+    }
+    /**
+     * Transform the configured project and return TypeScript text by file path.
+     *
+     * This is the source-to-source API for plugin authors. It must not return
+     * JavaScript emit, declaration files, or source maps; those artifacts belong
+     * to {@link TtscCompiler.compile}. A transform sidecar is expected to write
+     * JSON shaped as `{ "typescript": { "src/file.ts": "..." } }` to stdout.
+     * When no transform sidecar is configured, ttsc returns the TypeScript files
+     * loaded by the TypeScript-Go Program together with normal diagnostics.
+     *
+     * The returned shape mirrors `embed-typescript`'s transformation API:
+     * `success` and `failure` carry a `typescript` map, while unexpected host
+     * errors return `exception`.
+     *
+     * @returns Transformation result containing TypeScript text or diagnostics.
+     */
+    transform() {
+        return runTransformation(() => (0, transformProjectInMemory_1.transformProjectInMemory)(this.compilerContext()));
+    }
+    compilerContext() {
+        return {
+            ...this.context,
+            cacheDir: this.resolveCacheDir(),
+        };
+    }
+    resolveProjectExecution() {
+        const cwd = this.resolveCwd();
+        const tsconfig = (0, resolveProjectConfig_1.resolveProjectConfig)({
+            cwd,
+            tsconfig: this.context.tsconfig,
+        });
+        return {
+            cwd,
+            projectRoot: path.dirname(tsconfig),
+            tsconfig,
+        };
+    }
+    resolveCleanProjectRoot() {
+        try {
+            return this.resolveProjectExecution().projectRoot;
+        }
+        catch (error) {
+            if (this.context.tsconfig) {
+                throw error;
+            }
+            return this.resolveCwd();
+        }
+    }
+    resolveCwd() {
+        return path.resolve(this.context.cwd ?? process.cwd());
+    }
+    resolveCacheDir() {
+        if (!this.context.cacheDir) {
+            return undefined;
+        }
+        return path.isAbsolute(this.context.cacheDir)
+            ? this.context.cacheDir
+            : path.resolve(this.resolveCwd(), this.context.cacheDir);
+    }
+    resolvePluginCacheDir() {
+        return this.resolveCacheDir() ?? this.context.env?.TTSC_CACHE_DIR;
+    }
+}
+exports.TtscCompiler = TtscCompiler;
+function removeExistingDirectories(directories) {
+    const removed = [];
+    for (const directory of [...new Set(directories)]) {
+        if (!fs.existsSync(directory)) {
+            continue;
+        }
+        fs.rmSync(directory, { recursive: true, force: true });
+        removed.push(directory);
+    }
+    return removed;
+}
+function runProject(task) {
+    try {
+        return toCompilerResult(task());
+    }
+    catch (error) {
+        return {
+            error: normalizeError(error),
+            type: "exception",
+        };
+    }
+}
+function runTransformation(task) {
+    try {
+        return toCompilerTransformation(task());
+    }
+    catch (error) {
+        return {
+            error: normalizeError(error),
+            type: "exception",
+        };
+    }
+}
+function toCompilerResult(project) {
+    const { output, result } = project;
+    if (result.status === 0 && result.diagnostics.length === 0) {
+        return {
+            output,
+            type: "success",
+        };
+    }
+    return {
+        diagnostics: result.diagnostics.length === 0
+            ? [createProcessDiagnostic(result)]
+            : result.diagnostics,
+        output,
+        type: "failure",
+    };
+}
+function createProcessDiagnostic(result) {
+    const messageText = (result.stderr || result.stdout).trim() ||
+        `ttsc exited with status ${result.status}`;
+    return {
+        category: "error",
+        code: "TTSC_PROCESS",
+        file: null,
+        messageText,
+    };
+}
+function toCompilerTransformation(project) {
+    const { result, typescript } = project;
+    if (result.status === 0 && result.diagnostics.length === 0) {
+        return {
+            type: "success",
+            typescript,
+        };
+    }
+    return {
+        diagnostics: result.diagnostics.length === 0
+            ? [createProcessDiagnostic(result)]
+            : result.diagnostics,
+        type: "failure",
+        typescript,
+    };
+}
+function normalizeError(error) {
+    if (!(error instanceof Error)) {
+        return error;
+    }
+    return {
+        message: error.message,
+        name: error.name,
+        stack: error.stack,
+    };
+}
+//# sourceMappingURL=TtscCompiler.js.map

package/lib/TtscCompiler.js.map

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

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

@@ -0,0 +1,6 @@
+/** Build the native ttsc compiler host used by in-memory API compilation. */
+export declare function buildNativeCompiler(options: {
+    cacheBaseDir: string;
+    cacheDir?: string;
+    packageRoot: string;
+}): string;

package/lib/compiler/internal/buildNativeCompiler.js

@@ -0,0 +1,72 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildNativeCompiler = buildNativeCompiler;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const buildSourcePlugin_1 = require("../../plugin/internal/buildSourcePlugin");
+/** Build the native ttsc compiler host used by in-memory API compilation. */
+function buildNativeCompiler(options) {
+    return (0, buildSourcePlugin_1.buildSourcePlugin)({
+        baseDir: options.cacheBaseDir,
+        cacheDir: options.cacheDir,
+        label: "compiler host",
+        overlayDirs: [],
+        pluginName: "ttsc",
+        quiet: true,
+        source: path.join(options.packageRoot, "cmd", "ttsc"),
+        ttscVersion: readOwnPackageVersion(options.packageRoot),
+        tsgoVersion: readGoModuleVersion(options.packageRoot),
+    });
+}
+function readOwnPackageVersion(packageRoot) {
+    try {
+        const pkg = JSON.parse(fs.readFileSync(path.join(packageRoot, "package.json"), "utf8"));
+        return typeof pkg.version === "string" ? pkg.version : "0.0.0";
+    }
+    catch {
+        return "0.0.0";
+    }
+}
+function readGoModuleVersion(packageRoot) {
+    try {
+        const goMod = fs.readFileSync(path.join(packageRoot, "go.mod"), "utf8");
+        return goMod;
+    }
+    catch {
+        return "unknown";
+    }
+}
+//# sourceMappingURL=buildNativeCompiler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"buildNativeCompiler.js","sourceRoot":"","sources":["../../../src/compiler/internal/buildNativeCompiler.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,MAAY,EAAE,oCAAgB;AAC9B,MAAY,IAAI,sCAAkB;AAElC,+EAA4E;AAE5E,6EAA6E;AAC7E,6BAAoC,OAInC;IACC,OAAO,IAAA,qCAAiB,EAAC;QACvB,OAAO,EAAE,OAAO,CAAC,YAAY;QAC7B,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,EAAE;QACf,UAAU,EAAE,MAAM;QAClB,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,EAAE,MAAM,CAAC;QACrD,WAAW,EAAE,qBAAqB,CAAC,OAAO,CAAC,WAAW,CAAC;QACvD,WAAW,EAAE,mBAAmB,CAAC,OAAO,CAAC,WAAW,CAAC;KACtD,CAAC,CAAC;AACL,CAAC;AAED,SAAS,qBAAqB,CAAC,WAAmB;IAChD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CACpB,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CACvC,CAAC;QAC3B,OAAO,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;IACjE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED,SAAS,mBAAmB,CAAC,WAAmB;IAC9C,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;QACxE,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,7 @@
+import type { ITtscCompilerContext } from "../../structures/ITtscCompilerContext";
+import type { TtscBuildResult } from "../../structures/internal/TtscBuildResult";
+/** Compile a project and capture emitted files without writing to the project tree. */
+export declare function compileProjectInMemory(options: ITtscCompilerContext): {
+    output: Record<string, string>;
+    result: TtscBuildResult;
+};

package/lib/compiler/internal/compileProjectInMemory.js

@@ -0,0 +1,176 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compileProjectInMemory = compileProjectInMemory;
+const node_child_process_1 = require("node:child_process");
+const fs = __importStar(require("node:fs"));
+const os = __importStar(require("node:os"));
+const path = __importStar(require("node:path"));
+const buildNativeCompiler_1 = require("./buildNativeCompiler");
+const readProjectConfig_1 = require("./project/readProjectConfig");
+const runBuild_1 = require("./runBuild");
+/** Compile a project and capture emitted files without writing to the project tree. */
+function compileProjectInMemory(options) {
+    const cwd = path.resolve(options.cwd ?? process.cwd());
+    const project = (0, readProjectConfig_1.readProjectConfig)({
+        cwd,
+        tsconfig: options.tsconfig,
+    });
+    if (configuredPlugins(options, project).length !== 0) {
+        return compileProjectWithPlugins(options, cwd, project);
+    }
+    const tsconfig = project.path;
+    const binary = (0, buildNativeCompiler_1.buildNativeCompiler)({
+        cacheBaseDir: path.dirname(tsconfig),
+        cacheDir: options.cacheDir,
+        packageRoot: packageRootDir(),
+    });
+    const res = (0, node_child_process_1.spawnSync)(binary, ["api-compile", "--cwd", path.dirname(tsconfig), "--tsconfig", tsconfig], {
+        cwd: path.dirname(tsconfig),
+        encoding: "utf8",
+        env: { ...process.env, ...options.env },
+        maxBuffer: 1024 * 1024 * 256,
+        windowsHide: true,
+    });
+    if (res.error) {
+        throw new Error(`ttsc: failed to spawn native compiler host ${binary}: ${res.error.message}`);
+    }
+    const output = parseNativeCompileOutput(res.stdout, res.stderr);
+    return {
+        output: output.output,
+        result: {
+            diagnostics: output.diagnostics,
+            status: res.status ?? 1,
+            stdout: "",
+            stderr: res.stderr,
+        },
+    };
+}
+function configuredPlugins(options, project) {
+    if (options.plugins === false) {
+        return [];
+    }
+    const entries = options.plugins ?? project.compilerOptions.plugins;
+    return entries.filter((entry) => entry.enabled !== false);
+}
+function compileProjectWithPlugins(options, cwd, project) {
+    const tempRoot = fs.mkdtempSync(path.join(os.tmpdir(), "ttsc-api-output-"));
+    const tempOutDir = path.join(tempRoot, "out");
+    try {
+        const result = (0, runBuild_1.runBuild)({
+            ...options,
+            cwd,
+            emit: true,
+            forceListEmittedFiles: true,
+            outDir: tempOutDir,
+            quiet: true,
+            structuredDiagnostics: true,
+            tsconfig: project.path,
+        });
+        return {
+            output: readOutputDirectory(tempOutDir, outputKeyMapper(project)),
+            result,
+        };
+    }
+    finally {
+        fs.rmSync(tempRoot, { force: true, recursive: true });
+    }
+}
+function outputKeyMapper(project) {
+    const outDir = project.compilerOptions.outDir;
+    if (!outDir) {
+        return (relativePath) => relativePath;
+    }
+    const relativeOutDir = path.relative(project.root, outDir);
+    if (relativeOutDir !== "" && !relativeOutDir.startsWith("..")) {
+        const prefix = pathToKey(relativeOutDir);
+        return (relativePath) => path.posix.join(prefix, relativePath);
+    }
+    return (relativePath) => pathToKey(path.join(outDir, relativePath));
+}
+function readOutputDirectory(directory, keyOf) {
+    const output = {};
+    if (!fs.existsSync(directory)) {
+        return output;
+    }
+    for (const file of listFiles(directory)) {
+        output[keyOf(pathToKey(path.relative(directory, file)))] =
+            fs.readFileSync(file, "utf8");
+    }
+    return output;
+}
+function listFiles(directory) {
+    const out = [];
+    for (const entry of fs.readdirSync(directory, { withFileTypes: true })) {
+        const location = path.join(directory, entry.name);
+        if (entry.isDirectory()) {
+            out.push(...listFiles(location));
+        }
+        else if (entry.isFile()) {
+            out.push(location);
+        }
+    }
+    return out.sort();
+}
+function pathToKey(file) {
+    return file.replace(/\\/g, "/");
+}
+function parseNativeCompileOutput(stdout, stderr) {
+    try {
+        const parsed = JSON.parse(stdout);
+        return {
+            diagnostics: parsed.diagnostics ?? [],
+            output: parsed.output ?? {},
+        };
+    }
+    catch {
+        throw new Error((stderr || stdout).trim() || "ttsc: native compiler host returned no output");
+    }
+}
+function packageRootDir() {
+    let current = path.resolve(__dirname);
+    while (true) {
+        if (fs.existsSync(path.join(current, "package.json")) &&
+            fs.existsSync(path.join(current, "go.mod"))) {
+            return fs.realpathSync.native?.(current) ?? fs.realpathSync(current);
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            throw new Error("ttsc: package root not found for native compiler build");
+        }
+        current = parent;
+    }
+}
+//# sourceMappingURL=compileProjectInMemory.js.map

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

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

package/lib/compiler/internal/project/readProjectConfig.d.ts

@@ -0,0 +1,4 @@
+import type { ITtscParsedProjectConfig } from "../../../structures/internal/ITtscParsedProjectConfig";
+import type { ITtscProjectLocatorOptions } from "../../../structures/internal/ITtscProjectLocatorOptions";
+/** Read the resolved project config subset used by ttsc. */
+export declare function readProjectConfig(opts?: ITtscProjectLocatorOptions): ITtscParsedProjectConfig;