@decohere/flux 0.0.1-dev.74 → 0.0.1-dev.75

package/es6/src/slice-serve.js

@@ -0,0 +1,107 @@
+/**
+ * Directory-slice helpers for `flux serve <dir>…` — classify Mesh packages as
+ * Flux apps, Nixpacks-style script deferrals, or libraries to skip.
+ */ /** Preferred package scripts for foreign toolchains (Nixpacks-style). */ export const DEFER_SCRIPT_CANDIDATES = [
+    "dev",
+    "serve"
+];
+/**
+ * Normalize a CLI slice token to a `projects/…` prefix without a trailing slash.
+ * `funding` and `projects/funding` both become `projects/funding`.
+ */ export function normalizeSlicePrefix(slice) {
+    const trimmed = slice.replaceAll("\\", "/").replace(/\/+$/, "");
+    if (trimmed === "" || trimmed === ".") {
+        throw new Error("Slice directory must be a non-empty path");
+    }
+    if (trimmed === "projects" || trimmed.startsWith("projects/")) {
+        return trimmed;
+    }
+    return `projects/${trimmed}`;
+}
+/**
+ * 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 function isUnderSlice(projectDirectory, slicePrefix) {
+    const dir = projectDirectory.replaceAll("\\", "/").replace(/\/+$/, "");
+    const prefix = slicePrefix.replaceAll("\\", "/").replace(/\/+$/, "");
+    if (dir === prefix || dir.startsWith(`${prefix}/`)) {
+        return true;
+    }
+    // Flat monorepo packages: projects/<module>.<role>
+    return dir.startsWith(`${prefix}.`);
+}
+export function projectsInSlice(projects, slice) {
+    const prefix = normalizeSlicePrefix(slice);
+    return projects.filter((p)=>isUnderSlice(p.projectDirectory, prefix));
+}
+/** Union of packages under any of the slice tokens (deduped by package name). */ export function projectsInSlices(projects, slices) {
+    const byName = new Map();
+    for (const slice of slices){
+        for (const project of projectsInSlice(projects, slice)){
+            byName.set(project.name, project);
+        }
+    }
+    return [
+        ...byName.values()
+    ];
+}
+/** Script invokes Flux (in-process serve stays on Flux, not deferred). */ export function isFluxOwnedScript(script) {
+    return /\bflux\b/i.test(script);
+}
+/**
+ * First Nixpacks-style serve script that is not Flux-owned.
+ * Prefers `dev`, then `serve`.
+ */ export function resolveDeferScript(scripts) {
+    for (const name of DEFER_SCRIPT_CANDIDATES){
+        const body = scripts[name];
+        if (body != null && body !== "" && !isFluxOwnedScript(body)) {
+            return name;
+        }
+    }
+    return undefined;
+}
+/** Convention: Flux Node apps use `main` ending in `main.ts` / `main.tsx`. */ export function isFluxAppMain(main) {
+    const normalized = main.replaceAll("\\", "/");
+    return /(^|\/)main\.tsx?$/.test(normalized);
+}
+/**
+ * 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 function classifySliceProject(project) {
+    if (resolveDeferScript(project.scripts) != null) {
+        return "defer";
+    }
+    if (isFluxAppMain(project.main)) {
+        return "flux";
+    }
+    return "skip";
+}
+export function classifySliceProjects(projects, slices) {
+    const tokens = typeof slices === "string" ? [
+        slices
+    ] : [
+        ...slices
+    ];
+    const inSlice = projectsInSlices(projects, tokens);
+    const flux = [];
+    const defer = [];
+    const skip = [];
+    for (const project of inSlice){
+        const kind = classifySliceProject(project);
+        if (kind === "flux") flux.push(project);
+        else if (kind === "defer") defer.push(project);
+        else skip.push(project);
+    }
+    return {
+        flux,
+        defer,
+        skip
+    };
+}
+
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi9ob21lL3J1bm5lci93b3JrL2RlY29oZXJlL2RlY29oZXJlL3Byb2plY3RzL2ZsdXgvc3JjL3NsaWNlLXNlcnZlLnRzIl0sInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogRGlyZWN0b3J5LXNsaWNlIGhlbHBlcnMgZm9yIGBmbHV4IHNlcnZlIDxkaXI+4oCmYCDigJQgY2xhc3NpZnkgTWVzaCBwYWNrYWdlcyBhc1xuICogRmx1eCBhcHBzLCBOaXhwYWNrcy1zdHlsZSBzY3JpcHQgZGVmZXJyYWxzLCBvciBsaWJyYXJpZXMgdG8gc2tpcC5cbiAqL1xuXG5leHBvcnQgdHlwZSBTbGljZVByb2plY3RWaWV3ID0ge1xuXHRyZWFkb25seSBuYW1lOiBzdHJpbmc7XG5cdC8qKiBSZWxhdGl2ZSBwcm9qZWN0IGRpciBmcm9tIHdvcmtzcGFjZSByb290IChlLmcuIGBwcm9qZWN0cy9mdW5kaW5nL2FwaWApLiAqL1xuXHRyZWFkb25seSBwcm9qZWN0RGlyZWN0b3J5OiBzdHJpbmc7XG5cdHJlYWRvbmx5IG1haW46IHN0cmluZztcblx0cmVhZG9ubHkgc2NyaXB0czogUmVjb3JkPHN0cmluZywgc3RyaW5nPjtcbn07XG5cbmV4cG9ydCB0eXBlIFNsaWNlS2luZCA9IFwiZmx1eFwiIHwgXCJkZWZlclwiIHwgXCJza2lwXCI7XG5cbmV4cG9ydCB0eXBlIENsYXNzaWZpZWRTbGljZSA9IHtcblx0cmVhZG9ubHkgZmx1eDogU2xpY2VQcm9qZWN0Vmlld1tdO1xuXHRyZWFkb25seSBkZWZlcjogU2xpY2VQcm9qZWN0Vmlld1tdO1xuXHRyZWFkb25seSBza2lwOiBTbGljZVByb2plY3RWaWV3W107XG59O1xuXG4vKiogUHJlZmVycmVkIHBhY2thZ2Ugc2NyaXB0cyBmb3IgZm9yZWlnbiB0b29sY2hhaW5zIChOaXhwYWNrcy1zdHlsZSkuICovXG5leHBvcnQgY29uc3QgREVGRVJfU0NSSVBUX0NBTkRJREFURVMgPSBbXCJkZXZcIiwgXCJzZXJ2ZVwiXSBhcyBjb25zdDtcblxuLyoqXG4gKiBOb3JtYWxpemUgYSBDTEkgc2xpY2UgdG9rZW4gdG8gYSBgcHJvamVjdHMv4oCmYCBwcmVmaXggd2l0aG91dCBhIHRyYWlsaW5nIHNsYXNoLlxuICogYGZ1bmRpbmdgIGFuZCBgcHJvamVjdHMvZnVuZGluZ2AgYm90aCBiZWNvbWUgYHByb2plY3RzL2Z1bmRpbmdgLlxuICovXG5leHBvcnQgZnVuY3Rpb24gbm9ybWFsaXplU2xpY2VQcmVmaXgoc2xpY2U6IHN0cmluZyk6IHN0cmluZyB7XG5cdGNvbnN0IHRyaW1tZWQgPSBzbGljZS5yZXBsYWNlQWxsKFwiXFxcXFwiLCBcIi9cIikucmVwbGFjZSgvXFwvKyQvLCBcIlwiKTtcblx0aWYgKHRyaW1tZWQgPT09IFwiXCIgfHwgdHJpbW1lZCA9PT0gXCIuXCIpIHtcblx0XHR0aHJvdyBuZXcgRXJyb3IoXCJTbGljZSBkaXJlY3RvcnkgbXVzdCBiZSBhIG5vbi1lbXB0eSBwYXRoXCIpO1xuXHR9XG5cdGlmICh0cmltbWVkID09PSBcInByb2plY3RzXCIgfHwgdHJpbW1lZC5zdGFydHNXaXRoKFwicHJvamVjdHMvXCIpKSB7XG5cdFx0cmV0dXJuIHRyaW1tZWQ7XG5cdH1cblx0cmV0dXJuIGBwcm9qZWN0cy8ke3RyaW1tZWR9YDtcbn1cblxuLyoqXG4gKiBUcnVlIHdoZW4gYHByb2plY3REaXJlY3RvcnlgIGJlbG9uZ3MgdG8gdGhlIHNsaWNlIHRva2VuLlxuICpcbiAqIE1hdGNoZXM6XG4gKiAtIG5lc3RlZDogYHByb2plY3RzL2Z1bmRpbmdgLCBgcHJvamVjdHMvZnVuZGluZy9hcGlgXG4gKiAtIGZsYXQgZG90dGVkIHBhY2thZ2UgZGlyczogYHByb2plY3RzL2Z1bmRpbmcud2ViYCBmb3IgdG9rZW4gYGZ1bmRpbmdgXG4gKlxuICogRG9lcyBub3QgbWF0Y2ggc2libGluZ3MgdGhhdCBvbmx5IHNoYXJlIGEgc3RyaW5nIHByZWZpeCAoYGZ1bmRpbmdgIHZzIGBmdW5kaW5nLWZlZS5hcGlgKS5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGlzVW5kZXJTbGljZShwcm9qZWN0RGlyZWN0b3J5OiBzdHJpbmcsIHNsaWNlUHJlZml4OiBzdHJpbmcpOiBib29sZWFuIHtcblx0Y29uc3QgZGlyID0gcHJvamVjdERpcmVjdG9yeS5yZXBsYWNlQWxsKFwiXFxcXFwiLCBcIi9cIikucmVwbGFjZSgvXFwvKyQvLCBcIlwiKTtcblx0Y29uc3QgcHJlZml4ID0gc2xpY2VQcmVmaXgucmVwbGFjZUFsbChcIlxcXFxcIiwgXCIvXCIpLnJlcGxhY2UoL1xcLyskLywgXCJcIik7XG5cdGlmIChkaXIgPT09IHByZWZpeCB8fCBkaXIuc3RhcnRzV2l0aChgJHtwcmVmaXh9L2ApKSB7XG5cdFx0cmV0dXJuIHRydWU7XG5cdH1cblx0Ly8gRmxhdCBtb25vcmVwbyBwYWNrYWdlczogcHJvamVjdHMvPG1vZHVsZT4uPHJvbGU+XG5cdHJldHVybiBkaXIuc3RhcnRzV2l0aChgJHtwcmVmaXh9LmApO1xufVxuXG5leHBvcnQgZnVuY3Rpb24gcHJvamVjdHNJblNsaWNlKFxuXHRwcm9qZWN0czogcmVhZG9ubHkgU2xpY2VQcm9qZWN0Vmlld1tdLFxuXHRzbGljZTogc3RyaW5nLFxuKTogU2xpY2VQcm9qZWN0Vmlld1tdIHtcblx0Y29uc3QgcHJlZml4ID0gbm9ybWFsaXplU2xpY2VQcmVmaXgoc2xpY2UpO1xuXHRyZXR1cm4gcHJvamVjdHMuZmlsdGVyKChwKSA9PiBpc1VuZGVyU2xpY2UocC5wcm9qZWN0RGlyZWN0b3J5LCBwcmVmaXgpKTtcbn1cblxuLyoqIFVuaW9uIG9mIHBhY2thZ2VzIHVuZGVyIGFueSBvZiB0aGUgc2xpY2UgdG9rZW5zIChkZWR1cGVkIGJ5IHBhY2thZ2UgbmFtZSkuICovXG5leHBvcnQgZnVuY3Rpb24gcHJvamVjdHNJblNsaWNlcyhcblx0cHJvamVjdHM6IHJlYWRvbmx5IFNsaWNlUHJvamVjdFZpZXdbXSxcblx0c2xpY2VzOiByZWFkb25seSBzdHJpbmdbXSxcbik6IFNsaWNlUHJvamVjdFZpZXdbXSB7XG5cdGNvbnN0IGJ5TmFtZSA9IG5ldyBNYXA8c3RyaW5nLCBTbGljZVByb2plY3RWaWV3PigpO1xuXHRmb3IgKGNvbnN0IHNsaWNlIG9mIHNsaWNlcykge1xuXHRcdGZvciAoY29uc3QgcHJvamVjdCBvZiBwcm9qZWN0c0luU2xpY2UocHJvamVjdHMsIHNsaWNlKSkge1xuXHRcdFx0YnlOYW1lLnNldChwcm9qZWN0Lm5hbWUsIHByb2plY3QpO1xuXHRcdH1cblx0fVxuXHRyZXR1cm4gWy4uLmJ5TmFtZS52YWx1ZXMoKV07XG59XG5cbi8qKiBTY3JpcHQgaW52b2tlcyBGbHV4IChpbi1wcm9jZXNzIHNlcnZlIHN0YXlzIG9uIEZsdXgsIG5vdCBkZWZlcnJlZCkuICovXG5leHBvcnQgZnVuY3Rpb24gaXNGbHV4T3duZWRTY3JpcHQoc2NyaXB0OiBzdHJpbmcpOiBib29sZWFuIHtcblx0cmV0dXJuIC9cXGJmbHV4XFxiL2kudGVzdChzY3JpcHQpO1xufVxuXG4vKipcbiAqIEZpcnN0IE5peHBhY2tzLXN0eWxlIHNlcnZlIHNjcmlwdCB0aGF0IGlzIG5vdCBGbHV4LW93bmVkLlxuICogUHJlZmVycyBgZGV2YCwgdGhlbiBgc2VydmVgLlxuICovXG5leHBvcnQgZnVuY3Rpb24gcmVzb2x2ZURlZmVyU2NyaXB0KHNjcmlwdHM6IFJlY29yZDxzdHJpbmcsIHN0cmluZz4pOiBzdHJpbmcgfCB1bmRlZmluZWQge1xuXHRmb3IgKGNvbnN0IG5hbWUgb2YgREVGRVJfU0NSSVBUX0NBTkRJREFURVMpIHtcblx0XHRjb25zdCBib2R5ID0gc2NyaXB0c1tuYW1lXTtcblx0XHRpZiAoYm9keSAhPSBudWxsICYmIGJvZHkgIT09IFwiXCIgJiYgIWlzRmx1eE93bmVkU2NyaXB0KGJvZHkpKSB7XG5cdFx0XHRyZXR1cm4gbmFtZTtcblx0XHR9XG5cdH1cblx0cmV0dXJuIHVuZGVmaW5lZDtcbn1cblxuLyoqIENvbnZlbnRpb246IEZsdXggTm9kZSBhcHBzIHVzZSBgbWFpbmAgZW5kaW5nIGluIGBtYWluLnRzYCAvIGBtYWluLnRzeGAuICovXG5leHBvcnQgZnVuY3Rpb24gaXNGbHV4QXBwTWFpbihtYWluOiBzdHJpbmcpOiBib29sZWFuIHtcblx0Y29uc3Qgbm9ybWFsaXplZCA9IG1haW4ucmVwbGFjZUFsbChcIlxcXFxcIiwgXCIvXCIpO1xuXHRyZXR1cm4gLyhefFxcLyltYWluXFwudHN4PyQvLnRlc3Qobm9ybWFsaXplZCk7XG59XG5cbi8qKlxuICogQ2xhc3NpZnkgb25lIHBhY2thZ2UuIEZvcmVpZ24gc2VydmUgc2NyaXB0cyB3aW4gb3ZlciBgbWFpbi50c2AgKFZpdGUgYXBwc1xuICogb2Z0ZW4gaGF2ZSBhIG1haW4gZW50cnkgYnV0IG11c3Qgbm90IGJlIEhNUi1ib290ZWQgYnkgRmx1eCkuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBjbGFzc2lmeVNsaWNlUHJvamVjdChwcm9qZWN0OiBTbGljZVByb2plY3RWaWV3KTogU2xpY2VLaW5kIHtcblx0aWYgKHJlc29sdmVEZWZlclNjcmlwdChwcm9qZWN0LnNjcmlwdHMpICE9IG51bGwpIHtcblx0XHRyZXR1cm4gXCJkZWZlclwiO1xuXHR9XG5cdGlmIChpc0ZsdXhBcHBNYWluKHByb2plY3QubWFpbikpIHtcblx0XHRyZXR1cm4gXCJmbHV4XCI7XG5cdH1cblx0cmV0dXJuIFwic2tpcFwiO1xufVxuXG5leHBvcnQgZnVuY3Rpb24gY2xhc3NpZnlTbGljZVByb2plY3RzKFxuXHRwcm9qZWN0czogcmVhZG9ubHkgU2xpY2VQcm9qZWN0Vmlld1tdLFxuXHRzbGljZXM6IHN0cmluZyB8IHJlYWRvbmx5IHN0cmluZ1tdLFxuKTogQ2xhc3NpZmllZFNsaWNlIHtcblx0Y29uc3QgdG9rZW5zID0gdHlwZW9mIHNsaWNlcyA9PT0gXCJzdHJpbmdcIiA/IFtzbGljZXNdIDogWy4uLnNsaWNlc107XG5cdGNvbnN0IGluU2xpY2UgPSBwcm9qZWN0c0luU2xpY2VzKHByb2plY3RzLCB0b2tlbnMpO1xuXHRjb25zdCBmbHV4OiBTbGljZVByb2plY3RWaWV3W10gPSBbXTtcblx0Y29uc3QgZGVmZXI6IFNsaWNlUHJvamVjdFZpZXdbXSA9IFtdO1xuXHRjb25zdCBza2lwOiBTbGljZVByb2plY3RWaWV3W10gPSBbXTtcblx0Zm9yIChjb25zdCBwcm9qZWN0IG9mIGluU2xpY2UpIHtcblx0XHRjb25zdCBraW5kID0gY2xhc3NpZnlTbGljZVByb2plY3QocHJvamVjdCk7XG5cdFx0aWYgKGtpbmQgPT09IFwiZmx1eFwiKSBmbHV4LnB1c2gocHJvamVjdCk7XG5cdFx0ZWxzZSBpZiAoa2luZCA9PT0gXCJkZWZlclwiKSBkZWZlci5wdXNoKHByb2plY3QpO1xuXHRcdGVsc2Ugc2tpcC5wdXNoKHByb2plY3QpO1xuXHR9XG5cdHJldHVybiB7IGZsdXgsIGRlZmVyLCBza2lwIH07XG59XG4iXSwibmFtZXMiOlsiREVGRVJfU0NSSVBUX0NBTkRJREFURVMiLCJub3JtYWxpemVTbGljZVByZWZpeCIsInNsaWNlIiwidHJpbW1lZCIsInJlcGxhY2VBbGwiLCJyZXBsYWNlIiwiRXJyb3IiLCJzdGFydHNXaXRoIiwiaXNVbmRlclNsaWNlIiwicHJvamVjdERpcmVjdG9yeSIsInNsaWNlUHJlZml4IiwiZGlyIiwicHJlZml4IiwicHJvamVjdHNJblNsaWNlIiwicHJvamVjdHMiLCJmaWx0ZXIiLCJwIiwicHJvamVjdHNJblNsaWNlcyIsInNsaWNlcyIsImJ5TmFtZSIsIk1hcCIsInByb2plY3QiLCJzZXQiLCJuYW1lIiwidmFsdWVzIiwiaXNGbHV4T3duZWRTY3JpcHQiLCJzY3JpcHQiLCJ0ZXN0IiwicmVzb2x2ZURlZmVyU2NyaXB0Iiwic2NyaXB0cyIsImJvZHkiLCJ1bmRlZmluZWQiLCJpc0ZsdXhBcHBNYWluIiwibWFpbiIsIm5vcm1hbGl6ZWQiLCJjbGFzc2lmeVNsaWNlUHJvamVjdCIsImNsYXNzaWZ5U2xpY2VQcm9qZWN0cyIsInRva2VucyIsImluU2xpY2UiLCJmbHV4IiwiZGVmZXIiLCJza2lwIiwia2luZCIsInB1c2giXSwibWFwcGluZ3MiOiJBQUFBOzs7Q0FHQyxHQWtCRCx1RUFBdUUsR0FDdkUsT0FBTyxNQUFNQSwwQkFBMEI7SUFBQztJ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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decohere/flux",
-  "version": "0.0.1-dev.74",
+  "version": "0.0.1-dev.75",
   "description": "Hot module reload server for Node.js ESM applications",
   "keywords": [
     "typescript",
@@ -25,11 +25,12 @@
     "test": "echo \"Error: no test specified\" && exit 1"
   },
   "dependencies": {
-    "@decohere/crucible": "0.0.1-dev.74",
-    "@decohere/forge": "0.0.1-dev.74",
-    "@decohere/mesh": "0.0.1-dev.74",
-    "@decohere/nexus": "0.0.1-dev.74",
-    "@decohere/scribe": "0.0.1-dev.74",
+    "@decohere/crucible": "0.0.1-dev.75",
+    "@decohere/forge": "0.0.1-dev.75",
+    "@decohere/mesh": "0.0.1-dev.75",
+    "@decohere/nexus": "0.0.1-dev.75",
+    "@decohere/scribe": "0.0.1-dev.75",
+    "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/hot-reload-server.d.ts

@@ -12,6 +12,11 @@ export interface HotReloadServerOptions {
     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.
@@ -27,8 +32,9 @@ export declare class HotReloadServer extends EventEmitter<HotReloadServerEvents>
     private readonly logger;
     private disposed;
     private hooksRegistered;
-    private entryModulePath;
-    private entryModule?;
+    /** Absolute entry paths currently served (one or more Flux apps). */
+    private entries;
+    private pendingEntryReboots;
     private workspace?;
     private buildConfig;
     private watchSubscription?;
@@ -49,13 +55,15 @@ export declare class HotReloadServer extends EventEmitter<HotReloadServerEvents>
     start(options: HotReloadServerOptions): Promise<void>;
     dispose(): Promise<void>;
     [Symbol.asyncDispose](): Promise<void>;
+    private bootEntries;
     private bootEntry;
     private bindScheduleReboot;
     private requestReboot;
     private runReboot;
+    private disposeEntries;
     private disposeEntry;
     private resolveWorkspace;
-    private resolveProject;
+    private resolveProjects;
     private buildFileInfoMap;
     private registerHooks;
     private buildAliasPaths;

package/types/src/index.d.ts

@@ -1,4 +1,6 @@
+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 { ServeOptions } from "./serve.action.js";
+export { type ClassifiedSlice, classifySliceProject, classifySliceProjects, normalizeSlicePrefix, projectsInSlice, projectsInSlices, resolveDeferScript, type SliceKind, type SliceProjectView, } from "./slice-serve.js";

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

@@ -1,14 +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 = {
     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;
-    constructor(server: HotReloadServer, workspace: 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

@@ -3,4 +3,9 @@ import { ServeAction } from "./serve.action.js";
 export declare class ServeCommand extends DecohereCommand {
     get actions(): (typeof ServeAction)[];
     constructor(name: string);
+    /**
+     * Commander passes positional args before options when `[slices...]` is declared.
+     * Terminal's 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;