@decohere/flux 0.0.1-dev.8 → 0.0.1-dev.81

package/es6/src/source-module-loader.js

@@ -0,0 +1,160 @@
+function _ts_decorate(decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for(var i = decorators.length - 1; i >= 0; i--)if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+import { registerHooks } from "node:module";
+import path from "node:path";
+import { injectable } from "@decohere/crucible/decorators";
+import { BuildTargets, SwcTranspiler, WorkspaceDefaults } from "@decohere/forge";
+import { packageAliases, WorkspaceFactory } from "@decohere/mesh";
+import { FileEx, io } from "@decohere/nexus/io";
+import { scribe } from "@decohere/scribe";
+import { rewriteServeSpecifier } from "./rewrite-serve-specifier.js";
+export class SourceModuleLoader {
+    logger = scribe.logger(SourceModuleLoader.name);
+    transpiler = new SwcTranspiler();
+    disposed = false;
+    hooksRegistered = false;
+    workspace;
+    buildConfig = "debug";
+    fileInfoMap = new Map();
+    transpileCache = new Map();
+    aliasPaths = {};
+    aliasBaseUrl = path.resolve(".");
+    versionFileUrl = (fileUrl)=>fileUrl;
+    onResolved;
+    getWorkspace() {
+        return this.workspace;
+    }
+    getBuildConfig() {
+        return this.buildConfig;
+    }
+    hasSourceFile(absolutePath) {
+        return this.fileInfoMap.has(absolutePath);
+    }
+    sourceFilePaths() {
+        return this.fileInfoMap.keys();
+    }
+    setSourceFile(absolutePath, project) {
+        this.fileInfoMap.set(absolutePath, {
+            project
+        });
+    }
+    async configure(options) {
+        this.disposed = false;
+        this.transpileCache.clear();
+        this.buildConfig = options.buildConfig;
+        this.workspace = options.workspace ?? await WorkspaceFactory.create({
+            ...WorkspaceDefaults,
+            rootDir: process.cwd()
+        });
+        this.versionFileUrl = options.versionFileUrl ?? ((fileUrl)=>fileUrl);
+        this.onResolved = options.onResolved;
+        this.fileInfoMap = await this.buildFileInfoMap(this.buildConfig);
+        const aliases = this.workspace.getPackageAliases(this.buildConfig);
+        this.aliasBaseUrl = aliases.baseUrl;
+        this.aliasPaths = aliases.paths;
+    }
+    registerHooks() {
+        if (this.hooksRegistered) return;
+        this.hooksRegistered = true;
+        registerHooks({
+            resolve: (specifier, context, next)=>{
+                if (this.disposed) return next(specifier, context);
+                const parentUrl = context.parentURL ?? "";
+                const rewritten = rewriteServeSpecifier({
+                    specifier,
+                    parentUrl,
+                    isWatchedTs: (filePath)=>this.fileInfoMap.has(filePath),
+                    resolveBare: (bare)=>packageAliases.resolvePath(bare, this.aliasPaths, this.aliasBaseUrl),
+                    versionFileUrl: this.versionFileUrl
+                }) ?? specifier;
+                const result = next(rewritten, context);
+                this.onResolved?.(result, parentUrl);
+                return result;
+            },
+            load: (url, context, next)=>{
+                if (this.disposed) return next(url, context);
+                const result = this.loadTs(url);
+                if (result != null) {
+                    return {
+                        format: "module",
+                        source: result.source,
+                        shortCircuit: true
+                    };
+                }
+                return next(url, context);
+            }
+        });
+    }
+    async importEntry(absolutePath) {
+        const url = this.versionFileUrl(io.pathToFileUrl(path.resolve(absolutePath)));
+        return import(url);
+    }
+    invalidateTranspile(...absolutePaths) {
+        for (const fullPath of absolutePaths){
+            this.transpileCache.delete(fullPath);
+            this.transpiler.invalidateContentCache(new FileEx({
+                fullPath
+            }));
+        }
+    }
+    dispose() {
+        this.disposed = true;
+        this.transpileCache.clear();
+        this.fileInfoMap.clear();
+        this.workspace?.[Symbol.dispose]();
+        this.workspace = undefined;
+    }
+    async buildFileInfoMap(buildConfig) {
+        const projects = this.workspace?.getProjects(buildConfig) ?? [];
+        const entries = await Promise.all(projects.map(async (project)=>{
+            const files = await project.getAllFiles();
+            return files.map((file)=>[
+                    file.fullPath,
+                    {
+                        project
+                    }
+                ]);
+        }));
+        return new Map(entries.flat());
+    }
+    loadTs(url) {
+        if (!url.startsWith("file:")) return null;
+        const cleanPath = new URL(url).pathname;
+        const fileInfo = this.fileInfoMap.get(cleanPath);
+        if (fileInfo == null) return null;
+        const cached = this.transpileCache.get(cleanPath);
+        if (cached != null) return {
+            source: cached
+        };
+        const { project } = fileInfo;
+        const tsConfig = project.getTsConfigSync();
+        const userConfig = project.getSwcConfigSync();
+        const file = new FileEx({
+            fullPath: cleanPath
+        });
+        const response = this.transpiler.transformFileSync(file, BuildTargets.es6, {
+            tsConfig,
+            aliasPaths: true,
+            userConfig,
+            workspace: this.workspace,
+            projects: this.workspace?.getProjects(this.buildConfig)
+        });
+        if (response.outcome !== "success") {
+            this.logger.error(`Failed to transpile ${cleanPath}`, response);
+            throw new Error(`Failed to transpile ${cleanPath}`);
+        }
+        this.transpileCache.set(cleanPath, response.code);
+        return {
+            source: response.code
+        };
+    }
+}
+SourceModuleLoader = _ts_decorate([
+    injectable()
+], SourceModuleLoader);
+
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi9ob21lL3J1bm5lci93b3JrL2RlY29oZXJlL2RlY29oZXJlL3Byb2plY3RzL2ZsdXgvc3JjL3NvdXJjZS1tb2R1bGUtbG9hZGVyLnRzIl0sInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB0eXBlIHtcblx0TG9hZEZuT3V0cHV0LFxuXHRMb2FkSG9va0NvbnRleHQsXG5cdFJlc29sdmVGbk91dHB1dCxcblx0UmVzb2x2ZUhvb2tDb250ZXh0LFxufSBmcm9tIFwibm9kZTptb2R1bGVcIjtcbmltcG9ydCB7IHJlZ2lzdGVySG9va3MgfSBmcm9tIFwibm9kZTptb2R1bGVcIjtcbmltcG9ydCBwYXRoIGZyb20gXCJub2RlOnBhdGhcIjtcbmltcG9ydCB7IGluamVjdGFibGUgfSBmcm9tIFwiQGRlY29oZXJlL2NydWNpYmxlL2RlY29yYXRvcnNcIjtcbmltcG9ydCB7IEJ1aWxkVGFyZ2V0cywgU3djVHJhbnNwaWxlciwgV29ya3NwYWNlRGVmYXVsdHMgfSBmcm9tIFwiQGRlY29oZXJlL2ZvcmdlXCI7XG5pbXBvcnQgdHlwZSB7IFByb2plY3QsIFdvcmtzcGFjZSB9IGZyb20gXCJAZGVjb2hlcmUvbWVzaFwiO1xuaW1wb3J0IHsgcGFja2FnZUFsaWFzZXMsIFdvcmtzcGFjZUZhY3RvcnkgfSBmcm9tIFwiQGRlY29oZXJlL21lc2hcIjtcbmltcG9ydCB7IEZpbGVFeCwgaW8gfSBmcm9tIFwiQGRlY29oZXJlL25leHVzL2lvXCI7XG5pbXBvcnQgeyB0eXBlIExvZ2dlciwgc2NyaWJlIH0gZnJvbSBcIkBkZWNvaGVyZS9zY3JpYmVcIjtcbmltcG9ydCB7IHJld3JpdGVTZXJ2ZVNwZWNpZmllciB9IGZyb20gXCIuL3Jld3JpdGUtc2VydmUtc3BlY2lmaWVyLmpzXCI7XG5cbnR5cGUgRmlsZUluZm8gPSB7IHByb2plY3Q6IFByb2plY3QgfTtcblxuZXhwb3J0IGludGVyZmFjZSBTb3VyY2VNb2R1bGVMb2FkZXJPcHRpb25zIHtcblx0LyoqIEJ1aWxkIGNvbmZpZ3VyYXRpb24gbmFtZS4gKi9cblx0YnVpbGRDb25maWc6IHN0cmluZztcblx0LyoqXG5cdCAqIFByZS1idWlsdCBXb3Jrc3BhY2UgaW5zdGFuY2UgdG8gdXNlIGluc3RlYWQgb2YgcnVubmluZyBXb3Jrc3BhY2VGYWN0b3J5LlxuXHQgKiBVc2VmdWwgaW4gdGVzdHMgdG8gYnlwYXNzIGZpbGVzeXN0ZW0tYmFzZWQgd29ya3NwYWNlIGRpc2NvdmVyeS5cblx0ICovXG5cdHdvcmtzcGFjZT86IFdvcmtzcGFjZTtcblx0LyoqXG5cdCAqIE1hcCBhIHdhdGNoZWQgYC50c2AgZmlsZSBVUkwgZm9yIEVTTSByZXNvbHV0aW9uLlxuXHQgKiBIb3QgcmVsb2FkIHBhc3NlcyBhIGA/dmVyc2lvbj1gIGJ1c3Q7IG9uZS1zaG90IHJ1biB1c2VzIGlkZW50aXR5LlxuXHQgKi9cblx0dmVyc2lvbkZpbGVVcmw/OiAoZmlsZVVybDogc3RyaW5nKSA9PiBzdHJpbmc7XG5cdC8qKiBPcHRpb25hbCBwb3N0LXJlc29sdmUgaG9vayAoZS5nLiBkZXBlbmRlbmN5IHRyYWNraW5nIGZvciBITVIpLiAqL1xuXHRvblJlc29sdmVkPzogKHJlc3VsdDogUmVzb2x2ZUZuT3V0cHV0LCBwYXJlbnRVcmw6IHN0cmluZykgPT4gdm9pZDtcbn1cblxuLyoqXG4gKiBSZWdpc3RlcnMgTm9kZSBFU00gcmVzb2x2ZS9sb2FkIGhvb2tzIGFuZCBTV0MtdHJhbnNwaWxlcyB3b3Jrc3BhY2UgYC50c2BcbiAqIG9uIHRoZSBmbHkuIE5vIGZpbGUgd2F0Y2hpbmcgYW5kIG5vIGVudHJ5IHJlYm9vdCDigJQgdGhhdCBiZWxvbmdzIHRvXG4gKiB7QGxpbmsgSG90UmVsb2FkU2VydmVyfS5cbiAqL1xuQGluamVjdGFibGUoKVxuZXhwb3J0IGNsYXNzIFNvdXJjZU1vZHVsZUxvYWRlciB7XG5cdHByaXZhdGUgcmVhZG9ubHkgbG9nZ2VyOiBMb2dnZXIgPSBzY3JpYmUubG9nZ2VyKFNvdXJjZU1vZHVsZUxvYWRlci5uYW1lKTtcblx0cHJpdmF0ZSByZWFkb25seSB0cmFuc3BpbGVyID0gbmV3IFN3Y1RyYW5zcGlsZXIoKTtcblx0cHJpdmF0ZSBkaXNwb3NlZCA9IGZhbHNlO1xuXHRwcml2YXRlIGhvb2tzUmVnaXN0ZXJlZCA9IGZhbHNlO1xuXHRwcml2YXRlIHdvcmtzcGFjZT86IFdvcmtzcGFjZTtcblx0cHJpdmF0ZSBidWlsZENvbmZpZyA9IFwiZGVidWdcIjtcblx0cHJpdmF0ZSBmaWxlSW5mb01hcCA9IG5ldyBNYXA8c3RyaW5nLCBGaWxlSW5mbz4oKTtcblx0cHJpdmF0ZSB0cmFuc3BpbGVDYWNoZSA9IG5ldyBNYXA8c3RyaW5nLCBzdHJpbmc+KCk7XG5cdHByaXZhdGUgYWxpYXNQYXRoczogUmVjb3JkPHN0cmluZywgc3RyaW5nW10+ID0ge307XG5cdHByaXZhdGUgYWxpYXNCYXNlVXJsID0gcGF0aC5yZXNvbHZlKFwiLlwiKTtcblx0cHJpdmF0ZSB2ZXJzaW9uRmlsZVVybDogKGZpbGVVcmw6IHN0cmluZykgPT4gc3RyaW5nID0gKGZpbGVVcmwpID0+IGZpbGVVcmw7XG5cdHByaXZhdGUgb25SZXNvbHZlZD86IChyZXN1bHQ6IFJlc29sdmVGbk91dHB1dCwgcGFyZW50VXJsOiBzdHJpbmcpID0+IHZvaWQ7XG5cblx0cHVibGljIGdldFdvcmtzcGFjZSgpOiBXb3Jrc3BhY2UgfCB1bmRlZmluZWQge1xuXHRcdHJldHVybiB0aGlzLndvcmtzcGFjZTtcblx0fVxuXG5cdHB1YmxpYyBnZXRCdWlsZENvbmZpZygpOiBzdHJpbmcge1xuXHRcdHJldHVybiB0aGlzLmJ1aWxkQ29uZmlnO1xuXHR9XG5cblx0cHVibGljIGhhc1NvdXJjZUZpbGUoYWJzb2x1dGVQYXRoOiBzdHJpbmcpOiBib29sZWFuIHtcblx0XHRyZXR1cm4gdGhpcy5maWxlSW5mb01hcC5oYXMoYWJzb2x1dGVQYXRoKTtcblx0fVxuXG5cdHB1YmxpYyBzb3VyY2VGaWxlUGF0aHMoKTogSXRlcmFibGVJdGVyYXRvcjxzdHJpbmc+IHtcblx0XHRyZXR1cm4gdGhpcy5maWxlSW5mb01hcC5rZXlzKCk7XG5cdH1cblxuXHRwdWJsaWMgc2V0U291cmNlRmlsZShhYnNvbHV0ZVBhdGg6IHN0cmluZywgcHJvamVjdDogUHJvamVjdCk6IHZvaWQge1xuXHRcdHRoaXMuZmlsZUluZm9NYXAuc2V0KGFic29sdXRlUGF0aCwgeyBwcm9qZWN0IH0pO1xuXHR9XG5cblx0cHVibGljIGFzeW5jIGNvbmZpZ3VyZShvcHRpb25zOiBTb3VyY2VNb2R1bGVMb2FkZXJPcHRpb25zKTogUHJvbWlzZTx2b2lkPiB7XG5cdFx0dGhpcy5kaXNwb3NlZCA9IGZhbHNlO1xuXHRcdHRoaXMudHJhbnNwaWxlQ2FjaGUuY2xlYXIoKTtcblx0XHR0aGlzLmJ1aWxkQ29uZmlnID0gb3B0aW9ucy5idWlsZENvbmZpZztcblx0XHR0aGlzLndvcmtzcGFjZSA9XG5cdFx0XHRvcHRpb25zLndvcmtzcGFjZSA/P1xuXHRcdFx0KGF3YWl0IFdvcmtzcGFjZUZhY3RvcnkuY3JlYXRlKHsgLi4uV29ya3NwYWNlRGVmYXVsdHMsIHJvb3REaXI6IHByb2Nlc3MuY3dkKCkgfSkpO1xuXHRcdHRoaXMudmVyc2lvbkZpbGVVcmwgPSBvcHRpb25zLnZlcnNpb25GaWxlVXJsID8/ICgoZmlsZVVybCkgPT4gZmlsZVVybCk7XG5cdFx0dGhpcy5vblJlc29sdmVkID0gb3B0aW9ucy5vblJlc29sdmVkO1xuXHRcdHRoaXMuZmlsZUluZm9NYXAgPSBhd2FpdCB0aGlzLmJ1aWxkRmlsZUluZm9NYXAodGhpcy5idWlsZENvbmZpZyk7XG5cdFx0Y29uc3QgYWxpYXNlcyA9IHRoaXMud29ya3NwYWNlLmdldFBhY2thZ2VBbGlhc2VzKHRoaXMuYnVpbGRDb25maWcpO1xuXHRcdHRoaXMuYWxpYXNCYXNlVXJsID0gYWxpYXNlcy5iYXNlVXJsO1xuXHRcdHRoaXMuYWxpYXNQYXRocyA9IGFsaWFzZXMucGF0aHM7XG5cdH1cblxuXHRwdWJsaWMgcmVnaXN0ZXJIb29rcygpOiB2b2lkIHtcblx0XHRpZiAodGhpcy5ob29rc1JlZ2lzdGVyZWQpIHJldHVybjtcblx0XHR0aGlzLmhvb2tzUmVnaXN0ZXJlZCA9IHRydWU7XG5cdFx0cmVnaXN0ZXJIb29rcyh7XG5cdFx0XHRyZXNvbHZlOiAoXG5cdFx0XHRcdHNwZWNpZmllcjogc3RyaW5nLFxuXHRcdFx0XHRjb250ZXh0OiBSZXNvbHZlSG9va0NvbnRleHQsXG5cdFx0XHRcdG5leHQ6IChzcGVjaWZpZXI6IHN0cmluZywgY29udGV4dD86IFBhcnRpYWw8UmVzb2x2ZUhvb2tDb250ZXh0PikgPT4gUmVzb2x2ZUZuT3V0cHV0LFxuXHRcdFx0KSA9PiB7XG5cdFx0XHRcdGlmICh0aGlzLmRpc3Bvc2VkKSByZXR1cm4gbmV4dChzcGVjaWZpZXIsIGNvbnRleHQpO1xuXHRcdFx0XHRjb25zdCBwYXJlbnRVcmwgPSBjb250ZXh0LnBhcmVudFVSTCA/PyBcIlwiO1xuXHRcdFx0XHRjb25zdCByZXdyaXR0ZW4gPVxuXHRcdFx0XHRcdHJld3JpdGVTZXJ2ZVNwZWNpZmllcih7XG5cdFx0XHRcdFx0XHRzcGVjaWZpZXIsXG5cdFx0XHRcdFx0XHRwYXJlbnRVcmwsXG5cdFx0XHRcdFx0XHRpc1dhdGNoZWRUczogKGZpbGVQYXRoKSA9PiB0aGlzLmZpbGVJbmZvTWFwLmhhcyhmaWxlUGF0aCksXG5cdFx0XHRcdFx0XHRyZXNvbHZlQmFyZTogKGJhcmUpID0+XG5cdFx0XHRcdFx0XHRcdHBhY2thZ2VBbGlhc2VzLnJlc29sdmVQYXRoKGJhcmUsIHRoaXMuYWxpYXNQYXRocywgdGhpcy5hbGlhc0Jhc2VVcmwpLFxuXHRcdFx0XHRcdFx0dmVyc2lvbkZpbGVVcmw6IHRoaXMudmVyc2lvbkZpbGVVcmwsXG5cdFx0XHRcdFx0fSkgPz8gc3BlY2lmaWVyO1xuXHRcdFx0XHRjb25zdCByZXN1bHQgPSBuZXh0KHJld3JpdHRlbiwgY29udGV4dCkgYXMgUmVzb2x2ZUZuT3V0cHV0O1xuXHRcdFx0XHR0aGlzLm9uUmVzb2x2ZWQ/LihyZXN1bHQsIHBhcmVudFVybCk7XG5cdFx0XHRcdHJldHVybiByZXN1bHQ7XG5cdFx0XHR9LFxuXHRcdFx0bG9hZDogKFxuXHRcdFx0XHR1cmw6IHN0cmluZyxcblx0XHRcdFx0Y29udGV4dDogTG9hZEhvb2tDb250ZXh0LFxuXHRcdFx0XHRuZXh0OiAodXJsOiBzdHJpbmcsIGNvbnRleHQ/OiBQYXJ0aWFsPExvYWRIb29rQ29udGV4dD4pID0+IExvYWRGbk91dHB1dCxcblx0XHRcdCk6IExvYWRGbk91dHB1dCA9PiB7XG5cdFx0XHRcdGlmICh0aGlzLmRpc3Bvc2VkKSByZXR1cm4gbmV4dCh1cmwsIGNvbnRleHQpO1xuXHRcdFx0XHRjb25zdCByZXN1bHQgPSB0aGlzLmxvYWRUcyh1cmwpO1xuXHRcdFx0XHRpZiAocmVzdWx0ICE9IG51bGwpIHtcblx0XHRcdFx0XHRyZXR1cm4geyBmb3JtYXQ6IFwibW9kdWxlXCIsIHNvdXJjZTogcmVzdWx0LnNvdXJjZSwgc2hvcnRDaXJjdWl0OiB0cnVlIH07XG5cdFx0XHRcdH1cblx0XHRcdFx0cmV0dXJuIG5leHQodXJsLCBjb250ZXh0KTtcblx0XHRcdH0sXG5cdFx0fSk7XG5cdH1cblxuXHRwdWJsaWMgYXN5bmMgaW1wb3J0RW50cnkoYWJzb2x1dGVQYXRoOiBzdHJpbmcpOiBQcm9taXNlPHVua25vd24+IHtcblx0XHRjb25zdCB1cmwgPSB0aGlzLnZlcnNpb25GaWxlVXJsKGlvLnBhdGhUb0ZpbGVVcmwocGF0aC5yZXNvbHZlKGFic29sdXRlUGF0aCkpKTtcblx0XHRyZXR1cm4gaW1wb3J0KHVybCk7XG5cdH1cblxuXHRwdWJsaWMgaW52YWxpZGF0ZVRyYW5zcGlsZSguLi5hYnNvbHV0ZVBhdGhzOiBzdHJpbmdbXSk6IHZvaWQge1xuXHRcdGZvciAoY29uc3QgZnVsbFBhdGggb2YgYWJzb2x1dGVQYXRocykge1xuXHRcdFx0dGhpcy50cmFuc3BpbGVDYWNoZS5kZWxldGUoZnVsbFBhdGgpO1xuXHRcdFx0dGhpcy50cmFuc3BpbGVyLmludmFsaWRhdGVDb250ZW50Q2FjaGUobmV3IEZpbGVFeCh7IGZ1bGxQYXRoIH0pKTtcblx0XHR9XG5cdH1cblxuXHRwdWJsaWMgZGlzcG9zZSgpOiB2b2lkIHtcblx0XHR0aGlzLmRpc3Bvc2VkID0gdHJ1ZTtcblx0XHR0aGlzLnRyYW5zcGlsZUNhY2hlLmNsZWFyKCk7XG5cdFx0dGhpcy5maWxlSW5mb01hcC5jbGVhcigpO1xuXHRcdHRoaXMud29ya3NwYWNlPy5bU3ltYm9sLmRpc3Bvc2VdKCk7XG5cdFx0dGhpcy53b3Jrc3BhY2UgPSB1bmRlZmluZWQ7XG5cdH1cblxuXHRwcml2YXRlIGFzeW5jIGJ1aWxkRmlsZUluZm9NYXAoYnVpbGRDb25maWc6IHN0cmluZyk6IFByb21pc2U8TWFwPHN0cmluZywgRmlsZUluZm8+PiB7XG5cdFx0Y29uc3QgcHJvamVjdHMgPSB0aGlzLndvcmtzcGFjZT8uZ2V0UHJvamVjdHMoYnVpbGRDb25maWcpID8/IFtdO1xuXHRcdGNvbnN0IGVudHJpZXMgPSBhd2FpdCBQcm9taXNlLmFsbChcblx0XHRcdHByb2plY3RzLm1hcChhc3luYyAocHJvamVjdCkgPT4ge1xuXHRcdFx0XHRjb25zdCBmaWxlcyA9IGF3YWl0IHByb2plY3QuZ2V0QWxsRmlsZXMoKTtcblx0XHRcdFx0cmV0dXJuIGZpbGVzLm1hcCgoZmlsZSk6IFtzdHJpbmcsIEZpbGVJbmZvXSA9PiBbZmlsZS5mdWxsUGF0aCwgeyBwcm9qZWN0IH1dKTtcblx0XHRcdH0pLFxuXHRcdCk7XG5cdFx0cmV0dXJuIG5ldyBNYXAoZW50cmllcy5mbGF0KCkpO1xuXHR9XG5cblx0cHJpdmF0ZSBsb2FkVHModXJsOiBzdHJpbmcpOiB7IHNvdXJjZTogc3RyaW5nIH0gfCBudWxsIHtcblx0XHRpZiAoIXVybC5zdGFydHNXaXRoKFwiZmlsZTpcIikpIHJldHVybiBudWxsO1xuXG5cdFx0Y29uc3QgY2xlYW5QYXRoID0gbmV3IFVSTCh1cmwpLnBhdGhuYW1lO1xuXHRcdGNvbnN0IGZpbGVJbmZvID0gdGhpcy5maWxlSW5mb01hcC5nZXQoY2xlYW5QYXRoKTtcblx0XHRpZiAoZmlsZUluZm8gPT0gbnVsbCkgcmV0dXJuIG51bGw7XG5cblx0XHRjb25zdCBjYWNoZWQgPSB0aGlzLnRyYW5zcGlsZUNhY2hlLmdldChjbGVhblBhdGgpO1xuXHRcdGlmIChjYWNoZWQgIT0gbnVsbCkgcmV0dXJuIHsgc291cmNlOiBjYWNoZWQgfTtcblxuXHRcdGNvbnN0IHsgcHJvamVjdCB9ID0gZmlsZUluZm87XG5cdFx0Y29uc3QgdHNDb25maWcgPSBwcm9qZWN0LmdldFRzQ29uZmlnU3luYygpO1xuXHRcdGNvbnN0IHVzZXJDb25maWcgPSBwcm9qZWN0LmdldFN3Y0NvbmZpZ1N5bmMoKTtcblxuXHRcdGNvbnN0IGZpbGUgPSBuZXcgRmlsZUV4KHsgZnVsbFBhdGg6IGNsZWFuUGF0aCB9KTtcblx0XHRjb25zdCByZXNwb25zZSA9IHRoaXMudHJhbnNwaWxlci50cmFuc2Zvcm1GaWxlU3luYyhmaWxlLCBCdWlsZFRhcmdldHMuZXM2LCB7XG5cdFx0XHR0c0NvbmZpZyxcblx0XHRcdGFsaWFzUGF0aHM6IHRydWUsXG5cdFx0XHR1c2VyQ29uZmlnLFxuXHRcdFx0d29ya3NwYWNlOiB0aGlzLndvcmtzcGFjZSxcblx0XHRcdHByb2plY3RzOiB0aGlzLndvcmtzcGFjZT8uZ2V0UHJvamVjdHModGhpcy5idWlsZENvbmZpZyksXG5cdFx0fSk7XG5cblx0XHRpZiAocmVzcG9uc2Uub3V0Y29tZSAhPT0gXCJzdWNjZXNzXCIpIHtcblx0XHRcdHRoaXMubG9nZ2VyLmVycm9yKGBGYWlsZWQgdG8gdHJhbnNwaWxlICR7Y2xlYW5QYXRofWAsIHJlc3BvbnNlKTtcblx0XHRcdHRocm93IG5ldyBFcnJvcihgRmFpbGVkIHRvIHRyYW5zcGlsZSAke2NsZWFuUGF0aH1gKTtcblx0XHR9XG5cblx0XHR0aGlzLnRyYW5zcGlsZUNhY2hlLnNldChjbGVhblBhdGgsIHJlc3BvbnNlLmNvZGUpO1xuXHRcdHJldHVybiB7IHNvdXJjZTogcmVzcG9uc2UuY29kZSB9O1xuXHR9XG59XG4iXSwibmFtZXMiOlsicmVnaXN0ZXJIb29rcyIsInBhdGgiLCJpbmplY3RhYmxlIiwiQnVpbGRUYXJnZXRzIiwiU3djVHJhbnNwaWxlciIsIldvcmtzcGFjZURlZmF1bHRzIiwicGFja2FnZUFsaWFzZXMiLCJXb3Jrc3BhY2VGYWN0b3J5IiwiRmlsZUV4IiwiaW8iLCJzY3JpYmUiLCJyZXdyaXRlU2VydmVTcGVjaWZpZXIiLCJTb3VyY2VNb2R1bGVMb2FkZXIiLCJsb2dnZXIiLCJuYW1lIiwidHJhbnNwaWxlciIsImRpc3Bvc2VkIiwiaG9va3NSZWdpc3RlcmVkIiwid29ya3NwYWNlIiwiYnVpbGRDb25maWciLCJmaWxlSW5mb01hcCIsIk1hcCIsInRyYW5zcGlsZUNhY2hlIiwiYWxpYXNQYXRocyIsImFsaWFzQmFzZVVybCIsInJlc29sdmUiLCJ2ZXJzaW9uRmlsZVVybCIsImZpbGVVcmwiLCJvblJlc29sdmVkIiwiZ2V0V29ya3NwYWNlIiwiZ2V0QnVpbGRDb25maWciLCJoYXNTb3VyY2VGaWxlIiwiYWJzb2x1dGVQYXRoIiwiaGFzIiwic291cmNlRmlsZVBhdGhzIiwia2V5cyIsInNldFNvdXJjZUZpbGUiLCJwcm9qZWN0Iiwic2V0IiwiY29uZmlndXJlIiwib3B0aW9ucyIsImNsZWFyIiwiY3JlYXRlIiwicm9vdERpciIsInByb2Nlc3MiLCJjd2QiLCJidWlsZEZpbGVJbmZvTWFwIiwiYWxpYXNlcyIsImdldFBhY2thZ2VBbGlhc2VzIiwiYmFzZVVybCIsInBhdGhzIiwic3BlY2lmaWVyIiwiY29udGV4dCIsIm5leHQiLCJwYXJlbnRVcmwiLCJwYXJlbnRVUkwiLCJyZXdyaXR0ZW4iLCJpc1dhdGNoZWRUcyIsImZpbGVQYXRoIiwicmVzb2x2ZUJhcmUiLCJiYXJlIiwicmVzb2x2ZVBhdGgiLCJyZXN1bHQiLCJsb2FkIiwidXJsIiwibG9hZFRzIiwiZm9ybWF0Iiwic291cmNlIiwic2hvcnRDaXJjdWl0IiwiaW1wb3J0RW50cnkiLCJwYXRoVG9GaWxlVXJsIiwiaW52YWxpZGF0ZVRyYW5zcGlsZSIsImFic29sdXRlUGF0aHMiLCJmdWxsUGF0aCIsImRlbGV0ZSIsImludmFsaWRhdGVDb250ZW50Q2FjaGUiLCJkaXNwb3NlIiwiU3ltYm9sIiwidW5kZWZpbmVkIiwicHJvamVjdHMiLCJnZXRQcm9qZWN0cyIsImVudHJpZXMiLCJQcm9taXNlIiwiYWxsIiwibWFwIiwiZmlsZXMiLCJnZXRBbGxGaWxlcyIsImZpbGUiLCJmbGF0Iiwic3RhcnRzV2l0aCIsImNsZWFuUGF0aCIsIlVSTCIsInBhdGhuYW1lIiwiZmlsZUluZm8iLCJnZXQiLCJjYWNoZWQiLCJ0c0NvbmZpZyIsImdldFRzQ29uZmlnU3luYyIsInVzZXJDb25maWciLCJnZXRTd2NDb25maWdTeW5jIiwicmVzcG9uc2UiLCJ0cmFuc2Zvcm1GaWxlU3luYyIsImVzNiIsIm91dGNvbWUiLCJlcnJvciIsIkVycm9yIiwiY29kZSJdLCJtYXBwaW5ncyI6Ijs7Ozs7O0FBTUEsU0FBU0EsYUFBYSxRQUFRLGNBQWM7QUFDNUMsT0FBT0MsVUFBVSxZQUFZO0FBQzdCLFNBQVNDLFVBQVUsUUFBUSxnQ0FBZ0M7QUFDM0QsU0FBU0MsWUFBWSxFQUFFQyxhQUFhLEVBQUVDLGlCQUFpQixRQUFRLGtCQUFrQjtBQUVqRixTQUFTQyxjQUFjLEVBQUVDLGdCQUFnQixRQUFRLGlCQUFpQjtBQUNsRSxTQUFTQyxNQUFNLEVBQUVDLEVBQUUsUUFBUSxxQkFBcUI7QUFDaEQsU0FBc0JDLE1BQU0sUUFBUSxtQkFBbUI7QUFDdkQsU0FBU0MscUJBQXFCLFFBQVEsK0JBQStCO0FBMkJyRSxPQUFPLE1BQU1DO0lBQ0tDLFNBQWlCSCxPQUFPRyxNQUFNLENBQUNELG1CQUFtQkUsSUFBSSxFQUFFO0lBQ3hEQyxhQUFhLElBQUlYLGdCQUFnQjtJQUMxQ1ksV0FBVyxNQUFNO0lBQ2pCQyxrQkFBa0IsTUFBTTtJQUN4QkMsVUFBc0I7SUFDdEJDLGNBQWMsUUFBUTtJQUN0QkMsY0FBYyxJQUFJQyxNQUF3QjtJQUMxQ0MsaUJBQWlCLElBQUlELE1BQXNCO0lBQzNDRSxhQUF1QyxDQUFDLEVBQUU7SUFDMUNDLGVBQWV2QixLQUFLd0IsT0FBTyxDQUFDLEtBQUs7SUFDakNDLGlCQUE4QyxDQUFDQyxVQUFZQSxRQUFRO0lB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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decohere/flux",
-  "version": "0.0.1-dev.8",
+  "version": "0.0.1-dev.81",
   "description": "Hot module reload server for Node.js ESM applications",
   "keywords": [
     "typescript",
@@ -19,23 +19,19 @@
       "types": "./types/src/index.d.ts",
       "import": "./es6/src/index.js",
       "require": "./commonjs/src/index.js"
-    },
-    "./serve": {
-      "types": "./types/src/serve.d.ts",
-      "import": "./es6/src/serve.js"
     }
   },
-  "bin": {
-    "ember": "./es6/src/serve.js"
-  },
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"
   },
   "dependencies": {
-    "@decohere/crucible": "0.0.1-dev.8",
-    "@decohere/mesh": "0.0.1-dev.8",
-    "@decohere/nexus": "0.0.1-dev.8",
-    "@decohere/scribe": "0.0.1-dev.8"
+    "@decohere/crucible": "0.0.1-dev.81",
+    "@decohere/forge": "0.0.1-dev.81",
+    "@decohere/mesh": "0.0.1-dev.81",
+    "@decohere/nexus": "0.0.1-dev.81",
+    "@decohere/scribe": "0.0.1-dev.81",
+    "commander": "^13.1.0",
+    "rxjs": "^7.8.2"
   },
   "devDependencies": {}
 }

package/types/src/deferred-script-runner.d.ts

@@ -0,0 +1,18 @@
+import { type ChildProcess } from "node:child_process";
+export type DeferredScriptStart = {
+    readonly label: string;
+    readonly cwd: string;
+    readonly script: string;
+    /** Workspace root used to detect pnpm/npm/yarn. */
+    readonly workspaceRoot: string;
+};
+/**
+ * Nixpacks-style child processes for foreign packages in a flux serve slice.
+ * Killed when the Flux container disposes (SIGINT → RootModule teardown).
+ */
+export declare class DeferredScriptRunner implements AsyncDisposable {
+    private readonly logger;
+    private readonly children;
+    start(options: DeferredScriptStart): ChildProcess;
+    [Symbol.asyncDispose](): Promise<void>;
+}

package/types/src/{ember.command.d.ts → flux.command.d.ts}

@@ -1,6 +1,6 @@
 import type { Actions } from "@decohere/nexus/cli";
 import { type CommandHandler, type CommandResponse, type CommandType, DecohereCommand } from "@decohere/nexus/cli";
-export declare class EmberCommand extends DecohereCommand {
+export declare class FluxCommand extends DecohereCommand {
     constructor(commands: Record<string, CommandType>, handler: CommandHandler);
     run(_actions: Actions, _options: never): Promise<CommandResponse>;
 }

package/types/src/flux.module.d.ts

@@ -0,0 +1,16 @@
+import type { WorkspaceFactoryOptions } from "@decohere/nexus/cli";
+import { ModuleManifest } from "@decohere/nexus/cli";
+import type { ContainerBuilder } from "@decohere/nexus/composition";
+import { FluxCommand } from "./flux.command.js";
+import { RunAction } from "./run.action.js";
+import { ServeAction } from "./serve.action.js";
+export declare class FluxModule extends ModuleManifest {
+    readonly id = "flux";
+    readonly command: typeof FluxCommand;
+    readonly actions: {
+        serve: typeof ServeAction;
+        run: typeof RunAction;
+    };
+    registerServices(builder: ContainerBuilder): void;
+    createWorkspace(options: WorkspaceFactoryOptions): Promise<import("@decohere/mesh").Workspace>;
+}

package/types/src/hot-reload-server.d.ts

@@ -1,38 +1,78 @@
 import { EventEmitter } from "node:events";
-import type { Logger } from "@decohere/scribe";
+import type { Workspace } from "@decohere/mesh";
+/** Default quiet window before a file-change reboot. */
+export declare const DEFAULT_REBOOT_DEBOUNCE_MS = 250;
+export declare function resolveRebootDebounceMs(value: number | undefined): number;
 export interface HotReloadServerEvents {
+    start: [];
     reboot: [];
 }
+export interface HotReloadServerOptions {
+    /** Build configuration name. */
+    buildConfig: string;
+    /** Name of the project to serve. Defaults to the first project in the workspace. */
+    project?: string;
+    /**
+     * Multiple Flux app package names to boot in one process (directory slice).
+     * When set, takes precedence over {@link project}.
+     */
+    projects?: readonly string[];
+    /**
+     * Pre-built Workspace instance to use instead of running WorkspaceFactory.
+     * Useful in tests to bypass filesystem-based workspace discovery.
+     */
+    workspace?: Workspace;
+    /**
+     * Quiet window in milliseconds after the last affecting save before a reboot.
+     * Defaults to {@link DEFAULT_REBOOT_DEBOUNCE_MS}. Raise this for agent save trains.
+     */
+    rebootDebounceMs?: number;
+}
 export declare class HotReloadServer extends EventEmitter<HotReloadServerEvents> {
     private readonly logger;
+    private readonly loader;
     private disposed;
-    private entryModule;
-    private entry;
-    private sourceFiles;
+    /** Absolute entry paths currently served (one or more Flux apps). */
+    private entries;
+    private pendingEntryReboots;
+    private watchSubscription?;
     private moduleCache;
     private dependencies;
-    private watchers;
-    constructor(logger: Logger);
-    start(entry: string, ...watchDirs: string[]): Promise<void>;
+    private rebootTail;
+    private rebootDebounceGen;
+    private rebootInFlight;
+    private rebootFollowUp;
+    private rebootQueued;
+    /** Modules whose reverse-graph edges are pruned at reboot, not on schedule. */
+    private pendingGraphPrune;
+    private scheduleReboot;
+    start(options: HotReloadServerOptions): Promise<void>;
     dispose(): Promise<void>;
-    private removeSourceFiles;
-    private getSourceFiles;
-    private configureModuleHooks;
-    private onResolve;
-    private isSourceModule;
+    [Symbol.asyncDispose](): Promise<void>;
+    private bootEntries;
+    private bootEntry;
+    private bindScheduleReboot;
+    private requestReboot;
+    private runReboot;
+    private disposeEntries;
+    private disposeEntry;
+    private requireWorkspace;
+    private resolveProjects;
+    /**
+     * Post-next dependency tracker: records which source files import which
+     * other source files so that reloadIfAffected can traverse the graph.
+     */
+    private onPostResolve;
+    private onFileChange;
+    private reloadIfAffected;
     private getDependencyGraph;
     private trackDependency;
     private getCachedOrNew;
     private versionModule;
-    private watch;
-    private onFileAdded;
-    private onSourceFileChanged;
-    private onFileDeleted;
-    private reloadIfAffected;
-    private isSelf;
-    private invlidateModule;
+    private invalidateModuleCaches;
+    private prunePendingDependencyEdges;
+    /** Remove these modules as parents so boot can rebuild edges without stale importers. */
+    private pruneDependencyParents;
     private invalidateAllSourceFiles;
-    private disposeAndBoot;
-    private disposeEntry;
-    private bootEntry;
+    private isSelf;
 }

package/types/src/index.d.ts

@@ -1,9 +1,9 @@
-export { EmberCommand } from "./ember.command.js";
-export type { EmberModuleContext, EmberModuleResult } from "./ember.module.js";
-export { EmberActions, EmberModule } from "./ember.module.js";
-export * from "./hot-reload-server.js";
+export { DeferredScriptRunner } from "./deferred-script-runner.js";
+export { FluxModule } from "./flux.module.js";
+export type { HotReloadServerOptions } from "./hot-reload-server.js";
+export { DEFAULT_REBOOT_DEBOUNCE_MS, HotReloadServer } from "./hot-reload-server.js";
+export type { RunOptions } from "./run.action.js";
 export type { ServeOptions } from "./serve.action.js";
-export { ServeAction } from "./serve.action.js";
-export { ServeCommand } from "./serve.command.js";
-export type { WorkspaceServeOptions } from "./workspace-serve.action.js";
-export { WorkspaceServeAction } from "./workspace-serve.action.js";
+export { type ClassifiedSlice, classifySliceProject, classifySliceProjects, normalizeSlicePrefix, projectsInSlice, projectsInSlices, resolveDeferScript, type SliceKind, type SliceProjectView, } from "./slice-serve.js";
+export type { SourceModuleLoaderOptions } from "./source-module-loader.js";
+export { SourceModuleLoader } from "./source-module-loader.js";

package/types/src/rewrite-serve-specifier.d.ts

@@ -0,0 +1,13 @@
+export type RewriteServeSpecifierOptions = {
+    specifier: string;
+    parentUrl: string;
+    isWatchedTs: (absolutePath: string) => boolean;
+    resolveBare: (specifier: string) => string | null;
+    versionFileUrl: (fileUrl: string) => string;
+};
+/**
+ * Map a resolve-hook specifier to a versioned watched `.ts` file URL.
+ * Covers relative `.js` / `.ts` / extensionless imports and bare workspace
+ * package names (dynamic `import()` never goes through SWC path rewrite).
+ */
+export declare function rewriteServeSpecifier(options: RewriteServeSpecifierOptions): string | null;

package/types/src/run.action.d.ts

@@ -0,0 +1,17 @@
+import { Workspace } from "@decohere/mesh";
+import { type Action, ActionResponse } from "@decohere/nexus/cli";
+import { SourceModuleLoader } from "./source-module-loader.js";
+export type RunOptions = {
+    /** Absolute or cwd-relative path to a `.ts` entry file. */
+    entry: string;
+    configuration: string;
+    /** Arguments forwarded to the entry (bin-style `process.argv.slice(2)`). */
+    args?: string[];
+};
+export declare class RunAction implements Action<RunOptions> {
+    private readonly loader;
+    private readonly workspace;
+    private readonly logger;
+    constructor(loader: SourceModuleLoader, workspace: Workspace);
+    run(options: RunOptions): Promise<ActionResponse>;
+}

package/types/src/run.command.d.ts

@@ -0,0 +1,11 @@
+import { DecohereCommand } from "@decohere/nexus/cli";
+import { RunAction } from "./run.action.js";
+export declare class RunCommand extends DecohereCommand {
+    get actions(): (typeof RunAction)[];
+    constructor(name: string);
+    /**
+     * Commander passes positionals before options when `<entry> [args...]` is declared.
+     * The CLI host ModuleFactory expects `(opts, cmd)` — normalize and stash entry/args on opts.
+     */
+    action(fn: (...args: any[]) => void | Promise<void>): this;
+}

package/types/src/serve.action.d.ts

@@ -1,8 +1,23 @@
+import { Workspace } from "@decohere/mesh";
 import { type Action, ActionResponse } from "@decohere/nexus/cli";
+import { DeferredScriptRunner } from "./deferred-script-runner.js";
+import { HotReloadServer } from "./hot-reload-server.js";
 export type ServeOptions = {
-    entry: string;
-    watchDir: string;
+    configuration: string;
+    project?: string;
+    /** One or more module directory tokens (`funding`, `shell`, `projects/funding`). */
+    slices?: string[];
+    rebootDebounceMs?: number;
 };
 export declare class ServeAction implements Action<ServeOptions> {
+    private readonly server;
+    private readonly workspace;
+    private readonly deferredScripts;
+    private readonly logger;
+    constructor(server: HotReloadServer, workspace: Workspace, deferredScripts: DeferredScriptRunner);
     run(options: ServeOptions): Promise<ActionResponse>;
+    private runSlices;
+    private toSliceViews;
+    private toSliceView;
+    private findProject;
 }

package/types/src/serve.command.d.ts

@@ -1,6 +1,11 @@
 import { DecohereCommand } from "@decohere/nexus/cli";
-import { WorkspaceServeAction } from "./workspace-serve.action.js";
+import { ServeAction } from "./serve.action.js";
 export declare class ServeCommand extends DecohereCommand {
-    get actions(): (typeof WorkspaceServeAction)[];
+    get actions(): (typeof ServeAction)[];
     constructor(name: string);
+    /**
+     * Commander passes positional args before options when `[slices...]` is declared.
+     * The CLI host ModuleFactory expects `(opts, cmd)` — normalize here.
+     */
+    action(fn: (...args: any[]) => void | Promise<void>): this;
 }

package/types/src/slice-serve.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Directory-slice helpers for `flux serve <dir>…` — classify Mesh packages as
+ * Flux apps, Nixpacks-style script deferrals, or libraries to skip.
+ */
+export type SliceProjectView = {
+    readonly name: string;
+    /** Relative project dir from workspace root (e.g. `projects/funding/api`). */
+    readonly projectDirectory: string;
+    readonly main: string;
+    readonly scripts: Record<string, string>;
+};
+export type SliceKind = "flux" | "defer" | "skip";
+export type ClassifiedSlice = {
+    readonly flux: SliceProjectView[];
+    readonly defer: SliceProjectView[];
+    readonly skip: SliceProjectView[];
+};
+/** Preferred package scripts for foreign toolchains (Nixpacks-style). */
+export declare const DEFER_SCRIPT_CANDIDATES: readonly ["dev", "serve"];
+/**
+ * Normalize a CLI slice token to a `projects/…` prefix without a trailing slash.
+ * `funding` and `projects/funding` both become `projects/funding`.
+ */
+export declare function normalizeSlicePrefix(slice: string): string;
+/**
+ * True when `projectDirectory` belongs to the slice token.
+ *
+ * Matches:
+ * - nested: `projects/funding`, `projects/funding/api`
+ * - flat dotted package dirs: `projects/funding.web` for token `funding`
+ *
+ * Does not match siblings that only share a string prefix (`funding` vs `funding-fee.api`).
+ */
+export declare function isUnderSlice(projectDirectory: string, slicePrefix: string): boolean;
+export declare function projectsInSlice(projects: readonly SliceProjectView[], slice: string): SliceProjectView[];
+/** Union of packages under any of the slice tokens (deduped by package name). */
+export declare function projectsInSlices(projects: readonly SliceProjectView[], slices: readonly string[]): SliceProjectView[];
+/** Script invokes Flux (in-process serve stays on Flux, not deferred). */
+export declare function isFluxOwnedScript(script: string): boolean;
+/**
+ * First Nixpacks-style serve script that is not Flux-owned.
+ * Prefers `dev`, then `serve`.
+ */
+export declare function resolveDeferScript(scripts: Record<string, string>): string | undefined;
+/** Convention: Flux Node apps use `main` ending in `main.ts` / `main.tsx`. */
+export declare function isFluxAppMain(main: string): boolean;
+/**
+ * Classify one package. Foreign serve scripts win over `main.ts` (Vite apps
+ * often have a main entry but must not be HMR-booted by Flux).
+ */
+export declare function classifySliceProject(project: SliceProjectView): SliceKind;
+export declare function classifySliceProjects(projects: readonly SliceProjectView[], slices: string | readonly string[]): ClassifiedSlice;

package/types/src/source-module-loader.d.ts

@@ -0,0 +1,49 @@
+import type { ResolveFnOutput } from "node:module";
+import type { Project, Workspace } from "@decohere/mesh";
+export interface SourceModuleLoaderOptions {
+    /** Build configuration name. */
+    buildConfig: string;
+    /**
+     * Pre-built Workspace instance to use instead of running WorkspaceFactory.
+     * Useful in tests to bypass filesystem-based workspace discovery.
+     */
+    workspace?: Workspace;
+    /**
+     * Map a watched `.ts` file URL for ESM resolution.
+     * Hot reload passes a `?version=` bust; one-shot run uses identity.
+     */
+    versionFileUrl?: (fileUrl: string) => string;
+    /** Optional post-resolve hook (e.g. dependency tracking for HMR). */
+    onResolved?: (result: ResolveFnOutput, parentUrl: string) => void;
+}
+/**
+ * Registers Node ESM resolve/load hooks and SWC-transpiles workspace `.ts`
+ * on the fly. No file watching and no entry reboot — that belongs to
+ * {@link HotReloadServer}.
+ */
+export declare class SourceModuleLoader {
+    private readonly logger;
+    private readonly transpiler;
+    private disposed;
+    private hooksRegistered;
+    private workspace?;
+    private buildConfig;
+    private fileInfoMap;
+    private transpileCache;
+    private aliasPaths;
+    private aliasBaseUrl;
+    private versionFileUrl;
+    private onResolved?;
+    getWorkspace(): Workspace | undefined;
+    getBuildConfig(): string;
+    hasSourceFile(absolutePath: string): boolean;
+    sourceFilePaths(): IterableIterator<string>;
+    setSourceFile(absolutePath: string, project: Project): void;
+    configure(options: SourceModuleLoaderOptions): Promise<void>;
+    registerHooks(): void;
+    importEntry(absolutePath: string): Promise<unknown>;
+    invalidateTranspile(...absolutePaths: string[]): void;
+    dispose(): void;
+    private buildFileInfoMap;
+    private loadTs;
+}

package/commonjs/src/ember.command.js

@@ -1,27 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "EmberCommand", {
-    enumerable: true,
-    get: function() {
-        return EmberCommand;
-    }
-});
-const _cli = require("@decohere/nexus/cli");
-const _servecommand = require("./serve.command.js");
-class EmberCommand extends _cli.DecohereCommand {
-    constructor(commands, handler){
-        super(EmberCommand);
-        this.exitOverride();
-        this.registerSubcommand({
-            serve: _servecommand.ServeCommand,
-            ...commands
-        }, handler);
-    }
-    run(_actions, _options) {
-        return this.help();
-    }
-}
-
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi9ob21lL3J1bm5lci93b3JrL2RlY29oZXJlL2RlY29oZXJlL3Byb2plY3RzL2ZsdXgvc3JjL2VtYmVyLmNvbW1hbmQudHMiXSwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHR5cGUgeyBBY3Rpb25zIH0gZnJvbSBcIkBkZWNvaGVyZS9uZXh1cy9jbGlcIjtcbmltcG9ydCB7XG5cdHR5cGUgQ29tbWFuZEhhbmRsZXIsXG5cdHR5cGUgQ29tbWFuZFJlc3BvbnNlLFxuXHR0eXBlIENvbW1hbmRUeXBlLFxuXHREZWNvaGVyZUNvbW1hbmQsXG59IGZyb20gXCJAZGVjb2hlcmUvbmV4dXMvY2xpXCI7XG5pbXBvcnQgeyBTZXJ2ZUNvbW1hbmQgfSBmcm9tIFwiLi9zZXJ2ZS5jb21tYW5kLmpzXCI7XG5cbmV4cG9ydCBjbGFzcyBFbWJlckNvbW1hbmQgZXh0ZW5kcyBEZWNvaGVyZUNvbW1hbmQge1xuXHRwdWJsaWMgY29uc3RydWN0b3IoY29tbWFuZHM6IFJlY29yZDxzdHJpbmcsIENvbW1hbmRUeXBlPiwgaGFuZGxlcjogQ29tbWFuZEhhbmRsZXIpIHtcblx0XHRzdXBlcihFbWJlckNvbW1hbmQpO1xuXHRcdHRoaXMuZXhpdE92ZXJyaWRlKCk7XG5cdFx0dGhpcy5yZWdpc3RlclN1YmNvbW1hbmQoeyBzZXJ2ZTogU2VydmVDb21tYW5kLCAuLi5jb21tYW5kcyB9LCBoYW5kbGVyKTtcblx0fVxuXG5cdHB1YmxpYyBydW4oX2FjdGlvbnM6IEFjdGlvbnMsIF9vcHRpb25zOiBuZXZlcik6IFByb21pc2U8Q29tbWFuZFJlc3BvbnNlPiB7XG5cdFx0cmV0dXJuIHRoaXMuaGVscCgpO1xuXHR9XG59XG4iXSwibmFtZXMiOlsiRW1iZXJDb21tYW5kIiwiRGVjb2hlcmVDb21tYW5kIiwiY29tbWFuZHMiLCJoYW5kbGVyIiwiZXhpdE92ZXJyaWRlIiwicmVnaXN0ZXJTdWJjb21tYW5kIiwic2VydmUiLCJTZXJ2ZUNvbW1hbmQiLCJydW4iLCJfYWN0aW9ucyIsIl9vcHRpb25zIiwiaGVscCJdLCJtYXBwaW5ncyI6Ijs7OzsrQkFTYUE7OztlQUFBQTs7O3FCQUhOOzhCQUNzQjtBQUV0QixNQUFNQSxxQkFBcUJDLG9CQUFlO0lBQ2hELFlBQW1CQyxRQUFxQyxFQUFFQyxPQUF1QixDQUFFO1FBQ2xGLEtBQUssQ0FBQ0g7UUFDTixJQUFJLENBQUNJLFlBQVk7UUFDakIsSUFBSSxDQUFDQyxrQkFBa0IsQ0FBQztZQUFFQyxPQUFPQywwQkFBWTtZQUFFLEdBQUdMLFFBQVE7UUFBQyxHQUFHQztJQUMvRDtJQUVPSyxJQUFJQyxRQUFpQixFQUFFQyxRQUFlLEVBQTRCO1FBQ3hFLE9BQU8sSUFBSSxDQUFDQyxJQUFJO0lBQ2pCO0FBQ0QifQ==