@cbxss/tack-typecheck 2.0.0 → 2.2.0

package/dist/index.d.ts

@@ -1,3 +1,4 @@
 export { buildAmbientDts } from "./ambient.js";
+export { includeProjectDeclaration } from "./project.js";
 export { createTypeChecker, type CreateTypeCheckerOptions } from "./checker.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,KAAK,wBAAwB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,KAAK,wBAAwB,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -3,5 +3,6 @@
 // it runs. Implements the `TypeChecker` seam from `@cbxss/tack-codemode`; injected
 // into `createExecutionEngine` by the CLI.
 export { buildAmbientDts } from "./ambient.js";
+export { includeProjectDeclaration } from "./project.js";
 export { createTypeChecker } from "./checker.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,+EAA+E;AAC/E,mFAAmF;AACnF,2CAA2C;AAE3C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAiC,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,+EAA+E;AAC/E,mFAAmF;AACnF,2CAA2C;AAE3C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAiC,MAAM,cAAc,CAAC"}

package/dist/project.d.ts

@@ -0,0 +1,3 @@
+/** Include a declaration without replacing compiler options, comments, or inherited source globs. */
+export declare function includeProjectDeclaration(tsconfigPath: string, declarationPath: string): Promise<void>;
+//# sourceMappingURL=project.d.ts.map

package/dist/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":"AAIA,qGAAqG;AACrG,wBAAsB,yBAAyB,CAAC,YAAY,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyD5G"}

package/dist/project.js

@@ -0,0 +1,73 @@
+import { lstat, mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, relative, resolve, sep } from "node:path";
+import ts from "typescript-5";
+/** Include a declaration without replacing compiler options, comments, or inherited source globs. */
+export async function includeProjectDeclaration(tsconfigPath, declarationPath) {
+    const path = resolve(tsconfigPath);
+    const directory = dirname(path);
+    const declaration = relative(directory, resolve(declarationPath)).split(sep).join("/");
+    let text;
+    try {
+        const status = await lstat(path);
+        if (!status.isFile())
+            throw new Error(`Refusing to edit non-file or symlinked tsconfig: ${path}`);
+        text = await readFile(path, "utf8");
+    }
+    catch (cause) {
+        if (typeof cause !== "object" || cause === null || !("code" in cause) || cause.code !== "ENOENT")
+            throw cause;
+        await mkdir(directory, { recursive: true });
+        await writeFile(path, JSON.stringify({
+            compilerOptions: { target: "ES2022", module: "NodeNext", strict: true, lib: ["ES2022", "ESNext.Disposable"], types: ["node"] },
+            include: ["**/*"], exclude: ["node_modules", ".tack/generated"], files: [declaration]
+        }, null, 2) + "\n", { encoding: "utf8", flag: "wx" });
+        return;
+    }
+    const source = ts.parseJsonText(path, text);
+    if (ts.parseConfigFileTextToJson(path, text).error)
+        throw new Error(`Invalid tsconfig JSON: ${path}`);
+    const parsed = ts.getParsedCommandLineOfConfigFile(path, {}, {
+        ...ts.sys,
+        onUnRecoverableConfigFileDiagnostic: diagnostic => { throw new Error(ts.flattenDiagnosticMessageText(diagnostic.messageText, "\n")); }
+    });
+    // Missing listed source files / empty globs do not prevent project setup.
+    const errors = parsed?.errors.filter(error => ![18002, 18003].includes(error.code)) ?? [];
+    if (!parsed || errors.length)
+        throw new Error(`Cannot update tsconfig ${path}: ${errors.map(error => ts.flattenDiagnosticMessageText(error.messageText, "\n")).join("; ")}`);
+    if (parsed.projectReferences?.length && parsed.raw.files?.length === 0 && !parsed.raw.include?.length) {
+        throw new Error(`Choose the tsconfig that owns your scripts, not a references-only project: ${path}`);
+    }
+    const expression = source.statements[0];
+    if (!expression || !ts.isExpressionStatement(expression) || !ts.isObjectLiteralExpression(expression.expression)) {
+        throw new Error(`tsconfig must contain an object: ${path}`);
+    }
+    const object = expression.expression;
+    const fileProperties = object.properties.filter(property => ts.isPropertyAssignment(property) && property.name && ts.isStringLiteral(property.name) && property.name.text === "files");
+    if (fileProperties.length > 1)
+        throw new Error(`Duplicate files entries in tsconfig: ${path}`);
+    const files = fileProperties[0];
+    const inheritedFiles = parsed.raw.files ?? [];
+    if (inheritedFiles.some(file => resolve(directory, file) === resolve(declarationPath)))
+        return;
+    if (files && ts.isPropertyAssignment(files) && ts.isArrayLiteralExpression(files.initializer)) {
+        const array = files.initializer;
+        const prefix = array.elements.length && !array.elements.hasTrailingComma ? "," : "";
+        const position = array.end - 1;
+        text = text.slice(0, position) + `\n${prefix}${JSON.stringify(declaration)}\n` + text.slice(position);
+    }
+    else {
+        const properties = [];
+        // Adding files would otherwise disable TypeScript's implicit **/* inclusion.
+        if (parsed.raw.files === undefined && parsed.raw.include === undefined)
+            properties.push('"include": ["**/*"]');
+        properties.push(`"files": ${JSON.stringify([...inheritedFiles, declaration])}`);
+        const prefix = object.properties.length && !object.properties.hasTrailingComma ? "," : "";
+        const position = object.end - 1;
+        text = text.slice(0, position) + `\n${prefix}${properties.join(",\n")}\n` + text.slice(position);
+    }
+    // No recovery rewrite: if another process changed the config, leave it alone.
+    if (await readFile(path, "utf8") !== source.text || !(await lstat(path)).isFile())
+        throw new Error(`tsconfig changed during SDK setup: ${path}`);
+    await writeFile(path, text, "utf8");
+}
+//# sourceMappingURL=project.js.map

package/dist/project.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cbxss/tack-typecheck",
-  "version": "2.0.0",
+  "version": "2.2.0",
   "type": "module",
   "exports": {
     ".": {
@@ -17,9 +17,9 @@
     "test": "vitest run --passWithNoTests"
   },
   "dependencies": {
-    "@cbxss/tack-codemode": "2.0.0",
-    "@cbxss/tack-core": "2.0.0",
-    "@cbxss/tack-sdk-types": "2.0.0",
+    "@cbxss/tack-codemode": "2.2.0",
+    "@cbxss/tack-core": "2.2.0",
+    "@cbxss/tack-sdk-types": "2.2.0",
     "typescript-5": "npm:typescript@^5.9.3"
   },
   "devDependencies": {