@decohere/flux 0.0.1-dev.109 → 0.0.1-dev.11

package/es6/src/slice-serve.js

@@ -1,105 +0,0 @@
-/**
- * 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
-    };
-}

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

@@ -1,181 +0,0 @@
-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 { fileURLToPath } from "node:url";
-import { injectable } from "@decohere/crucible/decorators";
-import { BuildTargets, createWorkspace, SwcTranspiler } from "@decohere/forge";
-import { packageAliases } 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();
-    /** SWC options per project, built on first use and kept until the next `configure()`. */ swcConfigs = 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.swcConfigs.clear();
-        this.buildConfig = options.buildConfig;
-        this.workspace = options.workspace ?? await createWorkspace();
-        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;
-        // Compiled code carries inline source maps; Node only applies them to stack traces when
-        // this is on. Without it, errors point at compiled line numbers (#506).
-        process.setSourceMapsEnabled(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.swcConfigs.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;
-        // fileURLToPath, not URL.pathname: decodes %20 and gives Windows paths, so files
-        // whose path has a space still match Mesh's list (#511).
-        const cleanPath = fileURLToPath(url);
-        const fileInfo = this.fileInfoMap.get(cleanPath);
-        if (fileInfo == null) return null;
-        const cached = this.transpileCache.get(cleanPath);
-        if (cached != null) return {
-            source: cached
-        };
-        const file = new FileEx({
-            fullPath: cleanPath
-        });
-        const response = this.transpiler.transformFileSync(file, BuildTargets.es6, {}, this.swcConfigFor(fileInfo.project));
-        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
-        };
-    }
-    /**
-	 * The project's SWC options, built once: rebuilding them for every file was about a quarter
-	 * of load time (#513). Import specifiers are left as written, without `jsc.paths` or
-	 * `resolveFully`: the resolve hook maps them to source files (aliases, `.js` to `.ts`,
-	 * directory indexes), so SWC does not resolve them a second time against the disk.
-	 */ swcConfigFor(project) {
-        const cached = this.swcConfigs.get(project);
-        if (cached != null) return cached;
-        const base = this.transpiler.createBaseConfig(BuildTargets.es6, {
-            tsConfig: project.getTsConfigSync(),
-            userConfig: project.getSwcConfigSync(),
-            aliasPaths: false,
-            workspace: this.workspace
-        });
-        // `module` is the ES module config (`type: "es6"` above); the spread loses the narrowing.
-        const module = {
-            ...base.module,
-            resolveFully: false
-        };
-        const config = {
-            ...base,
-            module
-        };
-        this.swcConfigs.set(project, config);
-        return config;
-    }
-}
-SourceModuleLoader = _ts_decorate([
-    injectable()
-], SourceModuleLoader);

package/types/bench/load.bench.d.ts

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

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

@@ -1,18 +0,0 @@
-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/flux.d.ts

@@ -1,43 +0,0 @@
-import type { Workspace } from "@decohere/mesh";
-import { HotReloadServer } from "./hot-reload-server.js";
-export type FluxRunOptions = {
-    /** Mesh/Forge configuration name. Defaults to `debug` (`--configuration`). */
-    configuration?: string;
-    /** Arguments forwarded to the entry (bin-style `process.argv.slice(2)`). */
-    args?: string[];
-    /**
-     * Pre-built Workspace instead of `WorkspaceFactory`.
-     * Useful in tests to skip filesystem discovery.
-     */
-    workspace?: Workspace;
-};
-export type FluxServeOptions = {
-    /** Mesh/Forge configuration name. Defaults to `debug` (`--configuration`). */
-    configuration?: 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 instead of `WorkspaceFactory`.
-     * Useful in tests to skip filesystem discovery.
-     */
-    workspace?: Workspace;
-    /**
-     * Quiet window in milliseconds after the last affecting save before a reboot.
-     * Raise this for agent save trains.
-     */
-    rebootDebounceMs?: number;
-};
-declare function run(entry: string, options?: FluxRunOptions): Promise<unknown>;
-declare function serve(options?: FluxServeOptions): Promise<HotReloadServer>;
-declare function dispose(): void;
-export declare const flux: {
-    run: typeof run;
-    serve: typeof serve;
-    dispose: typeof dispose;
-};
-export {};

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

@@ -1,14 +0,0 @@
-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, directory imports (`./models` is
- * `./models/index.ts`), and bare workspace package names and subpaths. Flux compiles without
- * SWC's own path resolution, so this is the only place imports are mapped to sources (#513).
- */
-export declare function rewriteServeSpecifier(options: RewriteServeSpecifierOptions): string | null;

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

@@ -1,15 +0,0 @@
-import { Workspace } from "@decohere/mesh";
-import { type Action, ActionResponse } from "@decohere/nexus/cli";
-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 workspace;
-    private readonly logger;
-    constructor(workspace: Workspace);
-    run(options: RunOptions): Promise<ActionResponse>;
-}

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

@@ -1,11 +0,0 @@
-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/slice-serve.d.ts

@@ -1,52 +0,0 @@
-/**
- * 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

@@ -1,58 +0,0 @@
-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;
-    /** SWC options per project, built on first use and kept until the next `configure()`. */
-    private swcConfigs;
-    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;
-    /**
-     * The project's SWC options, built once: rebuilding them for every file was about a quarter
-     * of load time (#513). Import specifiers are left as written, without `jsc.paths` or
-     * `resolveFully`: the resolve hook maps them to source files (aliases, `.js` to `.ts`,
-     * directory indexes), so SWC does not resolve them a second time against the disk.
-     */
-    private swcConfigFor;
-}