@scriptc/compiler 0.2.4 → 0.2.6

package/dist/frontend/worker-target.js

@@ -0,0 +1,108 @@
+import { isAbsolute, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import * as ts from "./ts7/adapter.js";
+import { isNodeGlobal, isBuiltinMemberImport, isBuiltinNamespaceImport, staticForkString, } from "./fork-target.js";
+import { moduleSourceCandidates } from "./module-source-candidates.js";
+import { canonicalBuiltinModule } from "./builtin-modules.js";
+function workerNamespace(program, expression) {
+    if (ts.isCallExpression(expression) &&
+        ts.isIdentifier(expression.expression) &&
+        expression.expression.text === "require" &&
+        isNodeGlobal(program, expression.expression) &&
+        expression.arguments.length === 1 &&
+        ts.isStringLiteralLike(expression.arguments[0]))
+        return canonicalBuiltinModule(expression.arguments[0].text) === "worker_threads";
+    if (!ts.isIdentifier(expression))
+        return false;
+    if (isBuiltinNamespaceImport(program, expression, "worker_threads"))
+        return true;
+    const checker = program.getTypeChecker(), symbol = checker.getSymbolAtLocation(expression);
+    const declaration = symbol ? checker.declarationsOf(symbol)[0] : undefined;
+    return (declaration !== undefined &&
+        ts.isVariableDeclaration(declaration) &&
+        ts.isVariableDeclarationList(declaration.parent) &&
+        (declaration.parent.flags & ts.NodeFlags.Const) !== 0 &&
+        declaration.initializer !== undefined &&
+        ts.isCallExpression(declaration.initializer) &&
+        workerNamespace(program, declaration.initializer));
+}
+/** Share constructor provenance between root discovery and lowering. Local
+ * classes and shadowed require functions must never add native worker roots. */
+export function isWorkerConstructor(program, expression) {
+    while (ts.isParenthesizedExpression(expression) ||
+        ts.isAsExpression(expression) ||
+        ts.isTypeAssertion(expression) ||
+        ts.isNonNullExpression(expression))
+        expression = expression.expression;
+    if (ts.isPropertyAccessExpression(expression))
+        return expression.name.text === "Worker" && workerNamespace(program, expression.expression);
+    if (!ts.isIdentifier(expression))
+        return false;
+    if (isBuiltinMemberImport(program, expression, "worker_threads", "Worker"))
+        return true;
+    const checker = program.getTypeChecker(), symbol = checker.getSymbolAtLocation(expression);
+    const declaration = symbol ? checker.declarationsOf(symbol)[0] : undefined;
+    if (declaration &&
+        ts.isBindingElement(declaration) &&
+        ts.isObjectBindingPattern(declaration.parent)) {
+        const variable = declaration.parent.parent;
+        const member = declaration.propertyName ?? declaration.name;
+        return (ts.isIdentifier(member) &&
+            member.text === "Worker" &&
+            ts.isVariableDeclaration(variable) &&
+            ts.isVariableDeclarationList(variable.parent) &&
+            (variable.parent.flags & ts.NodeFlags.Const) !== 0 &&
+            variable.initializer !== undefined &&
+            workerNamespace(program, variable.initializer));
+    }
+    return (declaration !== undefined &&
+        ts.isVariableDeclaration(declaration) &&
+        ts.isVariableDeclarationList(declaration.parent) &&
+        (declaration.parent.flags & ts.NodeFlags.Const) !== 0 &&
+        declaration.initializer !== undefined &&
+        ts.isPropertyAccessExpression(declaration.initializer) &&
+        isWorkerConstructor(program, declaration.initializer));
+}
+export function workerModulePath(program, expression) {
+    if (ts.isIdentifier(expression) && expression.text === "__filename") {
+        if (isNodeGlobal(program, expression))
+            return resolve(expression.getSourceFile().fileName);
+    }
+    const value = staticForkString(program, expression);
+    if (value === null)
+        return null;
+    try {
+        if (value.startsWith("file:"))
+            return fileURLToPath(value);
+        // Relative string filenames are resolved against the invocation's cwd in
+        // Node. Only absolute paths and source-relative URLs fix the build graph.
+        return isAbsolute(value) ? resolve(value) : null;
+    }
+    catch {
+        return null;
+    }
+}
+export function workerTargetPaths(program, files) {
+    const targets = new Set();
+    const checker = program.getTypeChecker();
+    for (const source of files) {
+        if (source.isDeclarationFile || source.fileName.endsWith(".json"))
+            continue;
+        const constructions = moduleSourceCandidates(program, source).constructions;
+        checker.prefetchSymbolNodesExact(constructions.flatMap(({ expression }) => ts.isIdentifier(expression)
+            ? [expression]
+            : ts.isPropertyAccessExpression(expression) && ts.isIdentifier(expression.expression)
+                ? [expression.expression]
+                : []));
+        for (const construction of constructions) {
+            const expression = construction.expression;
+            if (!isWorkerConstructor(program, expression) || !construction.arguments?.[0])
+                continue;
+            const path = workerModulePath(program, construction.arguments[0]);
+            if (path !== null)
+                targets.add(path);
+        }
+    }
+    return [...targets];
+}
+//# sourceMappingURL=worker-target.js.map

package/dist/frontend/worker-target.js.map

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

package/dist/frontend/worker-target.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/frontend/worker-target.test.js

@@ -0,0 +1,71 @@
+import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { expect, test } from "vitest";
+import { workerTargetPaths } from "./worker-target.js";
+import { fallbackDtsPath } from "./dts-paths.js";
+import { Ts7Host } from "./ts7/program-host.js";
+import { Ts7Api } from "./ts7/rpc-api.js";
+import { ModuleKind, ModuleResolutionKind } from "./ts7/enums.js";
+function discover(source) {
+    const directory = mkdtempSync(join(tmpdir(), "scriptc-worker-discovery-"));
+    const entry = join(directory, "main.ts");
+    writeFileSync(entry, source);
+    writeFileSync(join(directory, "facade.ts"), 'export { Worker as Task } from "node:worker_threads";');
+    const host = new Ts7Host((options) => new Ts7Api(options), { cwd: directory });
+    const program = host.createProgram([entry, fallbackDtsPath()], {
+        noLib: true,
+        types: [],
+        module: ModuleKind.ESNext,
+        moduleResolution: ModuleResolutionKind.Bundler,
+    });
+    try {
+        return workerTargetPaths(program, [program.getSourceFile(entry)]).map((file) => file.replace(directory + "/", ""));
+    }
+    finally {
+        program.dispose();
+        host.close();
+        rmSync(directory, { recursive: true, force: true });
+    }
+}
+test("worker discovery preserves imports, facades, CommonJS bindings and distinct roots", () => {
+    expect(discover(`
+    import { Worker as Start } from "node:worker_threads";
+    import * as threads from "worker_threads";
+    import workers from "node:worker_threads";
+    import { Task } from "./facade.js";
+    const { Worker: Required } = require("node:worker_threads");
+    const module = require("worker_threads");
+    const Constructor = module.Worker;
+    new Start(new URL("./one.ts", import.meta.url));
+    new threads.Worker(new URL("./two.ts", import.meta.url));
+    new workers.Worker(new URL("./three.ts", import.meta.url));
+    new Task(new URL("./four.ts", import.meta.url));
+    new Required(__filename);
+    new Constructor(new URL(import.meta.url));
+    new (require("worker_threads").Worker)("/absolute/worker.ts");
+    new Start(new URL("./one.ts", import.meta.url));
+  `)).toEqual(["one.ts", "two.ts", "three.ts", "four.ts", "main.ts", "/absolute/worker.ts"]);
+});
+test("worker discovery rejects dynamic roots and shadowed globals or constructors", () => {
+    expect(discover(`
+    import { Worker } from "node:worker_threads";
+    new Worker("./cwd-dependent.ts");
+    let filename = "/mutable.ts";
+    new Worker(filename);
+    function local(Worker: any) { new Worker("/local.ts"); }
+    function loader(require: any) {
+      const { Worker: Local } = require("worker_threads");
+      new Local("/shadowed.ts");
+    }
+    function path(__filename: string) { new Worker(__filename); }
+    function shadowURL(URL: any) { new Worker(new URL("/wrong.ts")); }
+    let { Worker: Mutable } = require("worker_threads");
+    new Mutable("/mutable-constructor.ts");
+    let namespace = require("worker_threads");
+    new namespace.Worker("/mutable-namespace.ts");
+    const unrelated = { Worker: class {} };
+    new unrelated.Worker("/unrelated.ts");
+  `)).toEqual([]);
+});
+//# sourceMappingURL=worker-target.test.js.map

package/dist/frontend/worker-target.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-target.test.js","sourceRoot":"","sources":["../../src/frontend/worker-target.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAElE,SAAS,QAAQ,CAAC,MAAc;IAC9B,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,2BAA2B,CAAC,CAAC,CAAC;IAC3E,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACzC,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC7B,aAAa,CACX,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,EAC5B,uDAAuD,CACxD,CAAC;IACF,MAAM,IAAI,GAAG,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;IAC/E,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC,KAAK,EAAE,eAAe,EAAE,CAAC,EAAE;QAC7D,KAAK,EAAE,IAAI;QACX,KAAK,EAAE,EAAE;QACT,MAAM,EAAE,UAAU,CAAC,MAAM;QACzB,gBAAgB,EAAE,oBAAoB,CAAC,OAAO;KAC/C,CAAC,CAAC;IACH,IAAI,CAAC;QACH,OAAO,iBAAiB,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC,KAAK,CAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAC9E,IAAI,CAAC,OAAO,CAAC,SAAS,GAAG,GAAG,EAAE,EAAE,CAAC,CAClC,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,OAAO,EAAE,CAAC;QAClB,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,MAAM,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;AACH,CAAC;AAED,IAAI,CAAC,mFAAmF,EAAE,GAAG,EAAE;IAC7F,MAAM,CACJ,QAAQ,CAAC;;;;;;;;;;;;;;;;GAgBV,CAAC,CACD,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,qBAAqB,CAAC,CAAC,CAAC;AAC3F,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,6EAA6E,EAAE,GAAG,EAAE;IACvF,MAAM,CACJ,QAAQ,CAAC;;;;;;;;;;;;;;;;;;GAkBV,CAAC,CACD,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AAChB,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import type { CompileOptions, CompileSourceOptions, CompileRequestOptions, CompileSourceResult, CompileExecutableResult, CompileRequestResult, CompileLibraryOptions, CompileLibraryResult, AnalyzeOptions, AnalyzeResult } from "./compile-types.js";
-export type { CompileOutputKind, CompileBaseOptions, CompileOptions, CompileSourceOptions, CompileRequestOptions, CompileArtifact, CompileFailure, CompileSourceResult, CompileResult, CompileExecutableResult, CompileRequestResult, CompileLibraryOptions, CompileLibraryResult, AnalyzeOptions, AnalyzeResult } from "./compile-types.js";
+export type { CompileOutputKind, CompileBaseOptions, CompileOptions, CompileSourceOptions, CompileRequestOptions, CompileArtifact, CompileFailure, CompileSourceResult, CompileResult, CompileExecutableResult, CompileRequestResult, CompileLibraryOptions, CompileLibraryResult, AnalyzeOptions, AnalyzeResult, } from "./compile-types.js";
 export declare const VERSION = "0.0.1";
 export { EXTERNAL_OBJECT_ABI_STABILITY, RUNTIME_ABI_MARKER, RUNTIME_ABI_VERSION, } from "./backend/runtime-abi.js";
 export type { NativeLinkInfo, NativeLinkFeatures } from "./backend/native-link-info.js";
@@ -7,28 +7,29 @@ export type { WindowsSubsystem } from "./backend/targets.js";
 export { InternalCompilerError } from "./errors.js";
 export { compileExternalC as compileC, compileExternalC, runtimeSrcDir, type CcOptions, type NativeCacheWarmProfile, type WarmNativeCachesOptions, type WarmNativeCachesResult, } from "./backend/external-c.js";
 export { warmNativeCaches } from "./backend/warm-cache.js";
-export { ANDROID_MIN_API, IPHONEOS_MIN_VERSION, isAndroidTarget, isIosTarget, isMobileTarget, mobileLibraryTarget, mobileTargetRefusal } from "./backend/external-c.js";
+export { ANDROID_MIN_API, IPHONEOS_MIN_VERSION, isAndroidTarget, isIosTarget, isMobileTarget, mobileLibraryTarget, mobileTargetRefusal, } from "./backend/external-c.js";
 export { emitLlvmModule, type LlvmTargetOptions } from "./backend/llvm/emitter.js";
 export type { ScrDiagnostic } from "./diagnostics/diagnostic.js";
 export { renderDiagnostics, renderDiagnostics as renderAll, renderDiagnostic, } from "./diagnostics/render.js";
 export { renderCoverage, type CoverageInput } from "./coverage/report.js";
 export { generateSurfaceManifest, renderSurfaceManifest, MANIFEST_SCHEMA_VERSION, type SurfaceManifest, type SurfaceManifestEntry, } from "./coverage/surface-manifest.js";
 export { NODE24_FETCH_COMPAT_PROFILE, type FetchCompatEvidence, type FetchCompatFacet, type FetchCompatInventory, type FetchCompatInventoryEntry, type FetchCompatInventoryExclusion, type FetchCompatInventoryPlacement, type FetchCompatInventoryStatus, type FetchCompatOperation, type FetchCompatOption, type FetchCompatProfile, } from "./compat/fetch-profile.js";
-export { LIB_FN_SIGS, validateModule } from "./ir/validate.js";
+export { LIB_FN_SIGS } from "./ir/builtin-signatures.js";
+export { validateModule } from "./ir/validate.js";
 export { deserializeModule, IR_VERSION, serializeModule } from "./ir/serialize.js";
-export { resolveLibraryFences, type LibraryFenceDecl, type ResolvedLibraryFence } from "./library/fence-eval.js";
+export { resolveLibraryFences, type LibraryFenceDecl, type ResolvedLibraryFence, } from "./library/fence-eval.js";
 export { loadLibraryProfile, profileTeaching, profileRemediation, LIB_PARAM_CLASSES, LIB_RETURN_CLASSES, type LibraryProfile, type LibraryExportEntry, type LibrarySidecarConfig, type LibParamClass, type LibReturnClass, } from "./library/library-profile.js";
 export { loadFfiProfile, FFI_CALLBACK_PARAM_CLASSES, FFI_PARAM_CLASSES, FFI_RETURN_CLASSES, type FfiCallbackParam, type FfiCallbackParamClass, type FfiContextParam, type FfiFunction, type FfiParamClass, type FfiProfile, type FfiReturnClass, type FfiValueParamClass, } from "./ffi/ffi-manifest.js";
 export { assembleTrapTeaching, TRAP_TEACHING_MARKER, TRAP_TEACHING_SEP, } from "./library/trap-teaching.js";
 export { abiExportSuffixes, buildSidecar, canonicalModuleGraph, canonicalPath, compilerReleaseVersion, libraryIdentityHashes, SIDECAR_FORMAT, type SidecarDoc, type SidecarBuildInput, type SidecarBuildResult, type TypeRef, type PayloadDescriptor, } from "./library/sidecar.js";
 export { validateSidecar } from "./library/sidecar-validate.js";
-export { BUILD_ID_SEED, SOURCE_HASH_SEED, hex16, lengthPrefixedStream, wyhash64 } from "./library/wyhash.js";
-export { ISLAND_SURFACE, STATIC_MATH_PROPS, type IslandFnEntry } from "./frontend/lowering/surfaces.js";
-export { ambientDtsPath, isExactExternalTypeSpecifier, overridesDtsPath } from "./frontend/program-node.js";
+export { BUILD_ID_SEED, SOURCE_HASH_SEED, hex16, lengthPrefixedStream, wyhash64, } from "./library/wyhash.js";
+export { ISLAND_SURFACE, STATIC_MATH_PROPS, type IslandFnEntry, } from "./frontend/lowering/surfaces.js";
+export { ambientDtsPath, isExactExternalTypeSpecifier, overridesDtsPath, } from "./frontend/program-node.js";
 export { resolveProvenanceSources } from "./frontend/provenance.js";
 export { wasiGuestPath, type HostPathFlavor } from "./wasi-paths.js";
 export { setProvenanceSources, type ProvenancePackageSource, type ProvenanceSources, } from "./frontend/provenance-registry.js";
-export * as ir from "./ir/ir.js";
+export * as ir from "./ir/api.js";
 /** Platform semantics depend on the output target, without compiler discovery. */
 export declare function buildTargetPlatform(env?: NodeJS.ProcessEnv): string;
 /** Target-platform classification without compiler or SDK discovery. Source