@fluojs/cli 1.1.0 → 3.0.0

package/dist/commands/typegen-watch.d.ts

@@ -0,0 +1,46 @@
+/** Scheduler used to debounce typegen filesystem bursts deterministically. */
+export type TypegenWatchScheduler = {
+    readonly clear: (handle: number) => void;
+    readonly set: (callback: () => void, delayMs: number) => number;
+};
+/** Signal registration boundary owned by one typegen watch invocation. */
+export type TypegenWatchSignalTarget = {
+    readonly off: (signal: 'SIGINT' | 'SIGTERM', listener: () => void) => unknown;
+    readonly once: (signal: 'SIGINT' | 'SIGTERM', listener: () => void) => unknown;
+};
+/** Minimal watcher resource acquired by typegen watch mode. */
+export type TypegenWatcher = {
+    close(): void;
+    on(event: 'error', listener: (error: Error) => void): TypegenWatcher;
+};
+/** One child generation owned by a typegen watch coordinator. */
+export type TypegenWatchGeneration = {
+    cancel(): void;
+    readonly result: Promise<string>;
+};
+type TypegenWatchTarget = (target: string, options: {
+    readonly persistent: boolean;
+    readonly recursive: boolean;
+}, listener: (event: string, filename: string | Buffer | null) => void) => TypegenWatcher;
+/** Dependencies and callbacks for one bounded typegen watch lifecycle. */
+export type TypegenWatchOptions = {
+    readonly commit: (source: string, signal: AbortSignal) => Promise<void>;
+    readonly debounceMs?: number;
+    readonly modulePath: string;
+    readonly onError?: (error: unknown) => void;
+    readonly onReady?: (watchRoot: string) => void;
+    readonly outputPath: string;
+    readonly scheduler?: TypegenWatchScheduler;
+    readonly signalTarget?: TypegenWatchSignalTarget;
+    readonly startGeneration: () => TypegenWatchGeneration;
+    readonly watchTarget?: TypegenWatchTarget;
+};
+/**
+ * Watches the application module directory while generating an initial current artifact.
+ *
+ * @param options Generation, watcher, scheduler, and signal lifecycle dependencies.
+ * @returns Exit code `0` after signal shutdown or `1` after an asynchronous watcher failure.
+ */
+export declare function runTypegenWatch(options: TypegenWatchOptions): Promise<number>;
+export {};
+//# sourceMappingURL=typegen-watch.d.ts.map

package/dist/commands/typegen-watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typegen-watch.d.ts","sourceRoot":"","sources":["../../src/commands/typegen-watch.ts"],"names":[],"mappings":"AAGA,8EAA8E;AAC9E,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,QAAQ,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;CACjE,CAAC;AAEF,0EAA0E;AAC1E,MAAM,MAAM,wBAAwB,GAAG;IACrC,QAAQ,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,IAAI,KAAK,OAAO,CAAC;IAC9E,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,IAAI,KAAK,OAAO,CAAC;CAChF,CAAC;AAEF,+DAA+D;AAC/D,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,IAAI,IAAI,CAAC;IACd,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,cAAc,CAAC;CACtE,CAAC;AAEF,iEAAiE;AACjE,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,IAAI,IAAI,CAAC;IACf,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;CAClC,CAAC;AAEF,KAAK,kBAAkB,GAAG,CACxB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;IAAE,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAAE,EACtE,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,KAAK,IAAI,KAChE,cAAc,CAAC;AAEpB,0EAA0E;AAC1E,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC5C,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAC3C,QAAQ,CAAC,YAAY,CAAC,EAAE,wBAAwB,CAAC;IACjD,QAAQ,CAAC,eAAe,EAAE,MAAM,sBAAsB,CAAC;IACvD,QAAQ,CAAC,WAAW,CAAC,EAAE,kBAAkB,CAAC;CAC3C,CAAC;AAwCF;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CA0KnF"}

package/dist/commands/typegen-watch.js

@@ -0,0 +1,212 @@
+import { watch } from 'node:fs';
+import { basename, dirname, resolve } from 'node:path';
+
+/** Scheduler used to debounce typegen filesystem bursts deterministically. */
+
+/** Signal registration boundary owned by one typegen watch invocation. */
+
+/** Minimal watcher resource acquired by typegen watch mode. */
+
+/** One child generation owned by a typegen watch coordinator. */
+
+/** Dependencies and callbacks for one bounded typegen watch lifecycle. */
+
+const DEFAULT_DEBOUNCE_MS = 100;
+function createDefaultScheduler() {
+  let sequence = 0;
+  const timers = new Map();
+  return {
+    clear(handle) {
+      const timer = timers.get(handle);
+      if (timer !== undefined) {
+        clearTimeout(timer);
+        timers.delete(handle);
+      }
+    },
+    set(callback, delayMs) {
+      sequence += 1;
+      const handle = sequence;
+      const timer = setTimeout(() => {
+        timers.delete(handle);
+        callback();
+      }, delayMs);
+      timers.set(handle, timer);
+      return handle;
+    }
+  };
+}
+const defaultWatchTarget = (target, options, listener) => watch(target, options, listener);
+function isOwnArtifactEvent(changedPath, outputPath) {
+  if (changedPath === outputPath) {
+    return true;
+  }
+  const changedName = basename(changedPath);
+  const outputName = basename(outputPath);
+  return changedName.startsWith(`.${outputName}.`) && changedName.endsWith('.tmp');
+}
+
+/**
+ * Watches the application module directory while generating an initial current artifact.
+ *
+ * @param options Generation, watcher, scheduler, and signal lifecycle dependencies.
+ * @returns Exit code `0` after signal shutdown or `1` after an asynchronous watcher failure.
+ */
+export async function runTypegenWatch(options) {
+  const debounceMs = options.debounceMs ?? DEFAULT_DEBOUNCE_MS;
+  const onError = options.onError ?? (() => undefined);
+  const scheduler = options.scheduler ?? createDefaultScheduler();
+  const signalTarget = options.signalTarget ?? process;
+  const watchTarget = options.watchTarget ?? defaultWatchTarget;
+  const watchRoot = dirname(options.modulePath);
+  let activeCommit;
+  let activeGeneration;
+  let cleanedUp = false;
+  let rerunRequested = false;
+  let resolved = false;
+  let restartTimer;
+  let stopping = false;
+  let stopCode = 0;
+  let watcher;
+  let startupComplete = false;
+  let resolveResult = () => undefined;
+  const result = new Promise(resolvePromise => {
+    resolveResult = resolvePromise;
+  });
+  const cleanup = () => {
+    if (cleanedUp) {
+      return;
+    }
+    cleanedUp = true;
+    if (restartTimer !== undefined) {
+      scheduler.clear(restartTimer);
+      restartTimer = undefined;
+    }
+    watcher?.close();
+    signalTarget.off('SIGINT', stopForSignal);
+    signalTarget.off('SIGTERM', stopForSignal);
+  };
+  const settleIfIdle = () => {
+    if (!stopping || activeGeneration !== undefined || resolved) {
+      return;
+    }
+    resolved = true;
+    resolveResult(stopCode);
+  };
+  const stop = code => {
+    stopCode = Math.max(stopCode, code);
+    if (!stopping) {
+      stopping = true;
+      cleanup();
+      activeCommit?.abort();
+      activeGeneration?.cancel();
+    }
+    settleIfIdle();
+  };
+  function stopForSignal() {
+    stop(0);
+  }
+  const runGeneration = async reportError => {
+    let generation;
+    try {
+      generation = options.startGeneration();
+      activeGeneration = generation;
+      const source = await generation.result;
+      if (!stopping && !rerunRequested) {
+        const commit = new AbortController();
+        activeCommit = commit;
+        try {
+          await options.commit(source, commit.signal);
+        } finally {
+          if (activeCommit === commit) {
+            activeCommit = undefined;
+          }
+        }
+      }
+    } catch (error) {
+      if (stopping || rerunRequested) {
+        return;
+      }
+      if (reportError) {
+        onError(error);
+        return;
+      }
+      throw error;
+    } finally {
+      if (activeGeneration === generation) {
+        activeGeneration = undefined;
+        settleIfIdle();
+      }
+    }
+  };
+  const regenerate = () => {
+    if (stopping) {
+      return;
+    }
+    if (activeGeneration !== undefined) {
+      rerunRequested = true;
+      return;
+    }
+    void (async () => {
+      do {
+        rerunRequested = false;
+        await runGeneration(true);
+      } while (rerunRequested && !stopping);
+    })();
+  };
+  const scheduleRegeneration = changedPath => {
+    if (stopping || isOwnArtifactEvent(changedPath, options.outputPath)) {
+      return;
+    }
+    if (activeGeneration !== undefined) {
+      rerunRequested = true;
+      activeCommit?.abort();
+      return;
+    }
+    if (!startupComplete) {
+      rerunRequested = true;
+      return;
+    }
+    if (restartTimer !== undefined) {
+      scheduler.clear(restartTimer);
+    }
+    restartTimer = scheduler.set(() => {
+      restartTimer = undefined;
+      regenerate();
+    }, debounceMs);
+  };
+  try {
+    watcher = watchTarget(watchRoot, {
+      persistent: true,
+      recursive: true
+    }, (_event, filename) => {
+      const changedPath = filename === null ? watchRoot : resolve(watchRoot, String(filename));
+      scheduleRegeneration(changedPath);
+    });
+    watcher.on('error', error => {
+      onError(error);
+      stop(1);
+    });
+  } catch (error) {
+    watcher?.close();
+    throw error;
+  }
+  try {
+    signalTarget.once('SIGINT', stopForSignal);
+    signalTarget.once('SIGTERM', stopForSignal);
+    await (async () => {
+      do {
+        rerunRequested = false;
+        await runGeneration(false);
+      } while (rerunRequested && !stopping);
+    })();
+    startupComplete = true;
+    if (stopping) {
+      return result;
+    }
+    options.onReady?.(watchRoot);
+  } catch (error) {
+    cleanup();
+    throw error;
+  }
+  return result;
+}

package/dist/commands/typegen.d.ts

@@ -0,0 +1,29 @@
+import { type ReactTypegenModules } from './typegen-source.js';
+type CliStream = {
+    write(message: string): unknown;
+};
+/** Runtime options for the React page typegen command. */
+export interface TypegenCommandRuntimeOptions {
+    /** Current working directory for module and output path resolution. */
+    readonly cwd?: string;
+    /**
+     * Optional build-tooling module loader override for tests and editor integrations.
+     * Supplying it keeps application evaluation in the caller process and uses the returned
+     * namespaces for TypeScript and native modules; omitting it uses isolated generation children.
+     */
+    readonly loadReactTypegenModules?: (cwd: string) => Promise<ReactTypegenModules>;
+    /** Custom stream for error output. */
+    readonly stderr?: CliStream;
+    /** Custom stream for standard output. */
+    readonly stdout?: CliStream;
+}
+/**
+ * Generates, checks, or watches one application-owned React page type artifact.
+ *
+ * @param argv Command arguments after `typegen`.
+ * @param runtime Runtime overrides for module loading and output streams.
+ * @returns Process-style command exit code.
+ */
+export declare function runTypegenCommand(argv: readonly string[], runtime?: TypegenCommandRuntimeOptions): Promise<number>;
+export {};
+//# sourceMappingURL=typegen.d.ts.map

package/dist/commands/typegen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typegen.d.ts","sourceRoot":"","sources":["../../src/commands/typegen.ts"],"names":[],"mappings":"AAcA,OAAO,EAIL,KAAK,mBAAmB,EACzB,MAAM,qBAAqB,CAAC;AAI7B,KAAK,SAAS,GAAG;IACf,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC,CAAC;AAEF,0DAA0D;AAC1D,MAAM,WAAW,4BAA4B;IAC3C,uEAAuE;IACvE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,QAAQ,CAAC,uBAAuB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACjF,sCAAsC;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC;IAC5B,yCAAyC;IACzC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC;CAC7B;AA+BD;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,GAAE,4BAAiC,GACzC,OAAO,CAAC,MAAM,CAAC,CA2EjB"}

package/dist/commands/typegen.js

@@ -0,0 +1,119 @@
+import { resolve } from 'node:path';
+import { TYPEGEN_EXIT_CODES } from '../typegen-contract.js';
+import { typegenUsage } from '../usage.js';
+import { checkTypegenArtifact, writeTypegenArtifact } from './typegen-artifact.js';
+import { runTypegenGenerationProcess, startTypegenGenerationProcess } from './typegen-generation-process.js';
+import { parseTypegenArgs, TypegenCommandError } from './typegen-options.js';
+import { createTypegenSource, inspectReactTypegenArtifact, loadReactTypegenModules } from './typegen-source.js';
+import { runTypegenWatch } from './typegen-watch.js';
+import { assertOutputDoesNotAliasModule } from './output-path-safety.js';
+
+/** Runtime options for the React page typegen command. */
+
+function reportCheckResult(check, outputPath, stdout, stderr) {
+  switch (check.status) {
+    case 'UNCHANGED':
+      stdout.write(`UNCHANGED ${outputPath}\n`);
+      return TYPEGEN_EXIT_CODES.SUCCESS;
+    case 'MISSING':
+      stderr.write(`MISSING ${outputPath}: run fluo typegen without --check to create the artifact.\n`);
+      return TYPEGEN_EXIT_CODES.MISSING;
+    case 'STALE':
+      stderr.write(`STALE ${outputPath}: generated React page types differ from the authoritative compiled catalog.\n`);
+      return TYPEGEN_EXIT_CODES.STALE;
+    case 'MALFORMED':
+      stderr.write(`MALFORMED ${outputPath}: the target is not a complete React page typegen artifact.\n`);
+      return TYPEGEN_EXIT_CODES.MALFORMED;
+    case 'UNSUPPORTED_VERSION':
+      stderr.write(`UNSUPPORTED_VERSION ${outputPath}: artifact version ${String(check.version)} is not supported by this CLI.\n`);
+      return TYPEGEN_EXIT_CODES.UNSUPPORTED_VERSION;
+    default:
+      {
+        const unreachable = check;
+        throw new TypegenCommandError(`Unexpected typegen check result: ${String(unreachable)}`);
+      }
+  }
+}
+
+/**
+ * Generates, checks, or watches one application-owned React page type artifact.
+ *
+ * @param argv Command arguments after `typegen`.
+ * @param runtime Runtime overrides for module loading and output streams.
+ * @returns Process-style command exit code.
+ */
+export async function runTypegenCommand(argv, runtime = {}) {
+  const cwd = runtime.cwd ?? process.cwd();
+  const stdout = runtime.stdout ?? process.stdout;
+  const stderr = runtime.stderr ?? process.stderr;
+  try {
+    if (argv.some(argument => argument === '--help' || argument === '-h')) {
+      stdout.write(`${typegenUsage()}\n`);
+      return 0;
+    }
+    const parsed = parseTypegenArgs(argv);
+    const modulePath = resolve(cwd, parsed.modulePath);
+    const outputPath = resolve(cwd, parsed.outputPath);
+    await assertOutputDoesNotAliasModule(modulePath, outputPath);
+    const customModules = runtime.loadReactTypegenModules?.(cwd);
+    const generateSource = async () => customModules === undefined ? runTypegenGenerationProcess({
+      cwd,
+      exportName: parsed.exportName,
+      modulePath: parsed.modulePath
+    }) : createTypegenSource({
+      cwd,
+      modules: await customModules,
+      parsed
+    });
+    if (parsed.watch) {
+      return await runTypegenWatch({
+        async commit(source, signal) {
+          const action = await writeTypegenArtifact(outputPath, source, undefined, signal);
+          stdout.write(`${action} ${outputPath}\n`);
+        },
+        modulePath,
+        onError(error) {
+          stderr.write(`ERROR ${outputPath}: ${error instanceof Error ? error.message : String(error)}\n`);
+        },
+        onReady(watchRoot) {
+          stdout.write(`WATCHING ${watchRoot}\n`);
+        },
+        outputPath,
+        startGeneration: customModules === undefined ? () => startTypegenGenerationProcess({
+          cwd,
+          exportName: parsed.exportName,
+          modulePath: parsed.modulePath
+        }) : () => {
+          let cancelled = false;
+          const result = generateSource().then(source => {
+            if (cancelled) {
+              throw new TypegenCommandError('Typegen generation was cancelled.');
+            }
+            return source;
+          });
+          return {
+            cancel() {
+              if (cancelled) {
+                return;
+              }
+              cancelled = true;
+            },
+            result
+          };
+        }
+      });
+    }
+    const source = await generateSource();
+    if (parsed.check) {
+      const modules = customModules === undefined ? await loadReactTypegenModules(cwd) : await customModules;
+      const check = await checkTypegenArtifact(outputPath, source, existingSource => inspectReactTypegenArtifact(modules, existingSource));
+      return reportCheckResult(check, outputPath, stdout, stderr);
+    }
+    const action = await writeTypegenArtifact(outputPath, source);
+    stdout.write(`${action} ${outputPath}\n`);
+    return TYPEGEN_EXIT_CODES.SUCCESS;
+  } catch (error) {
+    stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+    return TYPEGEN_EXIT_CODES.ERROR;
+  }
+}

package/dist/dev-runner/node-restart-runner.d.ts

@@ -19,6 +19,11 @@ type RestartSignalTarget = {
 type RestartWatcherFactory = (target: string, optionsOrListener: {
     recursive: boolean;
 } | ((event: string, filename: string | Buffer | null) => void), listener?: (event: string, filename: string | Buffer | null) => void) => FSWatcher;
+type RestartSchedulerHandle = ReturnType<typeof setTimeout> | number;
+type RestartScheduler = {
+    clear(handle: RestartSchedulerHandle): void;
+    set(callback: () => void, delayMs: number): RestartSchedulerHandle;
+};
 type ContentChangeGate = {
     commitBaseline(paths: Iterable<string>): void;
     hasMeaningfulChange(paths: Iterable<string>): boolean;
@@ -33,6 +38,7 @@ export type NodeRestartRunnerOptions = {
     signalTarget?: RestartSignalTarget;
     spawnChild?: RestartChildSpawner;
     stderr?: RestartRunnerStream;
+    restartScheduler?: RestartScheduler;
     stdout?: RestartRunnerStream;
     watchTarget?: RestartWatcherFactory;
 };

package/dist/dev-runner/node-restart-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node-restart-runner.d.ts","sourceRoot":"","sources":["../../src/dev-runner/node-restart-runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE9D,OAAO,EAA0D,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AAKjG,KAAK,mBAAmB,GAAG;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC,CAAC;AAEF,KAAK,mBAAmB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,KAAK,YAAY,CAAC;AACjJ,2EAA2E;AAC3E,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,oBAAoB,GAAG,MAAM,GAAG,MAAM,CAAC;AAE9E,KAAK,aAAa,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE1C,KAAK,mBAAmB,GAAG;IACzB,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC;IAC1D,IAAI,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC;CAC5D,CAAC;AAEF,KAAK,qBAAqB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE;IAAE,SAAS,EAAE,OAAO,CAAA;CAAE,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,KAAK,IAAI,KAAK,SAAS,CAAC;AAE1O,KAAK,iBAAiB,GAAG;IACvB,cAAc,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAC9C,mBAAmB,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC;CACvD,CAAC;AAEF,uFAAuF;AACvF,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,YAAY,CAAC,EAAE,mBAAmB,CAAC;IACnC,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,WAAW,CAAC,EAAE,qBAAqB,CAAC;CACrC,CAAC;AA6NF;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,gBAAgB,EAAE,MAAM,EAAE,cAAc,GAAE,MAAM,EAAoB,GAAG,iBAAiB,CAuB/H;AAkFD;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmP7F"}
+{"version":3,"file":"node-restart-runner.d.ts","sourceRoot":"","sources":["../../src/dev-runner/node-restart-runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAS,MAAM,oBAAoB,CAAC;AAE9D,OAAO,EAAc,KAAK,SAAS,EAA8C,MAAM,SAAS,CAAC;AAKjG,KAAK,mBAAmB,GAAG;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC,CAAC;AAEF,KAAK,mBAAmB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,KAAK,YAAY,CAAC;AACjJ,2EAA2E;AAC3E,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,oBAAoB,GAAG,MAAM,GAAG,MAAM,CAAC;AAE9E,KAAK,aAAa,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE1C,KAAK,mBAAmB,GAAG;IACzB,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC;IAC1D,IAAI,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC;CAC5D,CAAC;AAEF,KAAK,qBAAqB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE;IAAE,SAAS,EAAE,OAAO,CAAA;CAAE,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,KAAK,IAAI,KAAK,SAAS,CAAC;AAE1O,KAAK,sBAAsB,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,GAAG,MAAM,CAAC;AAErE,KAAK,gBAAgB,GAAG;IACtB,KAAK,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAC5C,GAAG,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,sBAAsB,CAAC;CACpE,CAAC;AAEF,KAAK,iBAAiB,GAAG;IACvB,cAAc,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAC9C,mBAAmB,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC;CACvD,CAAC;AAEF,uFAAuF;AACvF,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,YAAY,CAAC,EAAE,mBAAmB,CAAC;IACnC,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,WAAW,CAAC,EAAE,qBAAqB,CAAC;CACrC,CAAC;AA6NF;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,gBAAgB,EAAE,MAAM,EAAE,cAAc,GAAE,MAAM,EAAoB,GAAG,iBAAiB,CAuB/H;AAkFD;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CAwS7F"}

package/dist/dev-runner/node-restart-runner.js

@@ -100,7 +100,7 @@ function parseIgnorePatterns(env) {
   return normalizeIgnorePatterns([...DEFAULT_IGNORES, ...configured]);
 }
 function matchesSegmentPattern(segment, pattern) {
-  if (pattern.startsWith('*.')) {
+  if (pattern.startsWith('*')) {
     return segment.endsWith(pattern.slice(1));
   }
   if (pattern.endsWith('*')) {
@@ -205,7 +205,7 @@ export function createContentChangeGate(projectDirectory, ignorePatterns = DEFAU
   };
 }
 function getWatchTargets(projectDirectory) {
-  return [join(projectDirectory, 'src'), ...WATCH_FILES.map(fileName => join(projectDirectory, fileName))].filter(target => existsSync(target));
+  return [join(projectDirectory, 'src'), ...WATCH_FILES.map(fileName => join(projectDirectory, fileName)).filter(target => existsSync(target))];
 }
 function stopChild(child, shutdownTimeoutMs = DEFAULT_CHILD_SHUTDOWN_TIMEOUT_MS) {
   if (child && child.exitCode === null) {
@@ -293,12 +293,17 @@ export async function runNodeRestartRunner(options) {
   const spawnChild = options.spawnChild ?? spawn;
   const stdout = options.stdout ?? process.stdout;
   const stderr = options.stderr ?? process.stderr;
+  const restartScheduler = options.restartScheduler ?? {
+    clear: clearTimeout,
+    set: setTimeout
+  };
   const watchTarget = options.watchTarget ?? watch;
   const appArgs = options.appArgs ?? [];
   const debounceMs = options.debounceMs ?? Number(env.FLUO_DEV_RELOAD_DEBOUNCE_MS ?? DEFAULT_DEBOUNCE_MS);
   const childShutdownTimeoutMs = Number(env.FLUO_DEV_CHILD_SHUTDOWN_TIMEOUT_MS ?? DEFAULT_CHILD_SHUTDOWN_TIMEOUT_MS);
   const ignorePatterns = parseIgnorePatterns(env);
   const gate = createContentChangeGate(projectDirectory, ignorePatterns);
+  const sourceDirectory = join(projectDirectory, 'src');
   const watchTargets = getWatchTargets(projectDirectory);
   let child;
   const pendingRestartPaths = new Set();
@@ -306,6 +311,7 @@ export async function runNodeRestartRunner(options) {
   let restartTimer;
   let restarting = false;
   let stopping = false;
+  let terminalExitCode;
   const startChild = (resolveExitCode, cleanup) => {
     ensureStudioEpoch(env);
     const appCommand = buildAppCommand(runnerRuntime, env, appArgs);
@@ -346,7 +352,7 @@ export async function runNodeRestartRunner(options) {
           reason: 'fluo dev runner stopped'
         });
         cleanup();
-        resolveExitCode(code ?? 0);
+        resolveExitCode(terminalExitCode ?? code ?? 0);
         return;
       }
       publishStudioLifecycleEvent(env, runnerRuntime, 'disconnect', {
@@ -358,10 +364,10 @@ export async function runNodeRestartRunner(options) {
   };
   const scheduleRestart = (filePath, resolveExitCode, cleanup) => {
     pendingRestartPaths.add(filePath);
-    if (restartTimer) {
-      clearTimeout(restartTimer);
+    if (restartTimer !== undefined) {
+      restartScheduler.clear(restartTimer);
     }
-    restartTimer = setTimeout(() => {
+    restartTimer = restartScheduler.set(() => {
       const restartPaths = [...pendingRestartPaths];
       pendingRestartPaths.clear();
       restartTimer = undefined;
@@ -445,8 +451,8 @@ export async function runNodeRestartRunner(options) {
         return;
       }
       cleanedUp = true;
-      if (restartTimer) {
-        clearTimeout(restartTimer);
+      if (restartTimer !== undefined) {
+        restartScheduler.clear(restartTimer);
         restartTimer = undefined;
       }
       pendingRestartPaths.clear();
@@ -457,11 +463,33 @@ export async function runNodeRestartRunner(options) {
       signalTarget.off('SIGINT', stop);
       signalTarget.off('SIGTERM', stop);
     };
+    const failFromWatcher = (target, error) => {
+      if (stopping || resolved) {
+        return;
+      }
+      terminalExitCode = 1;
+      stopping = true;
+      stderr.write(`[fluo] watcher failed for ${target}: ${error.message}\n`);
+      cleanup();
+      const stoppingChild = child;
+      if (!stoppingChild || stoppingChild.exitCode !== null) {
+        resolveOnce(terminalExitCode);
+        return;
+      }
+      stoppingChild.once('close', () => resolveOnce(1));
+      if (!restarting) {
+        stopChild(stoppingChild, childShutdownTimeoutMs);
+      }
+    };
+    const registerWatcher = (target, watcher) => {
+      watchers.push(watcher);
+      watcher.on?.('error', error => failFromWatcher(target, error));
+    };
     startChild(resolveExitCode, cleanup);
     const watchedFallbackDirectories = new Set();
     const watchFallbackDirectory = directoryPath => {
       if (watchedFallbackDirectories.has(directoryPath) || shouldIgnorePath(directoryPath, projectDirectory, ignorePatterns)) {
-        return;
+        return false;
       }
       watchedFallbackDirectories.add(directoryPath);
       const listener = (_event, filename) => {
@@ -469,14 +497,22 @@ export async function runNodeRestartRunner(options) {
         const changedPath = filename ? join(directoryPath, fileName) : directoryPath;
         scheduleRestart(changedPath, resolveExitCode, cleanup);
         for (const nextDirectoryPath of getFallbackWatchDirectories(changedPath, projectDirectory, ignorePatterns)) {
-          watchFallbackDirectory(nextDirectoryPath);
+          if (watchedFallbackDirectories.has(nextDirectoryPath) || shouldIgnorePath(nextDirectoryPath, projectDirectory, ignorePatterns)) {
+            continue;
+          }
+          if (!watchFallbackDirectory(nextDirectoryPath)) {
+            failFromWatcher(nextDirectoryPath, new Error('required fallback watcher could not be acquired'));
+            return;
+          }
         }
       };
       try {
-        watchers.push(watchTarget(directoryPath, listener));
+        registerWatcher(directoryPath, watchTarget(directoryPath, listener));
+        return true;
       } catch (error) {
         watchedFallbackDirectories.delete(directoryPath);
         stderr.write(`[fluo] unable to watch ${directoryPath}: ${error instanceof Error ? error.message : String(error)}\n`);
+        return false;
       }
     };
     for (const target of watchTargets) {
@@ -490,16 +526,31 @@ export async function runNodeRestartRunner(options) {
           scheduleRestart(stats.isDirectory() ? join(target, fileName) : target, resolveExitCode, cleanup);
         };
         try {
-          watchers.push(watchTarget(target, watchOptions, listener));
+          registerWatcher(target, watchTarget(target, watchOptions, listener));
         } catch (error) {
           if (!stats.isDirectory()) {
             throw error;
           }
+          let sourceCoverageAcquired = false;
           for (const directoryPath of getFallbackWatchDirectories(target, projectDirectory, ignorePatterns)) {
-            watchFallbackDirectory(directoryPath);
+            if (!watchFallbackDirectory(directoryPath)) {
+              const message = error instanceof Error ? error.message : String(error);
+              failFromWatcher(target, new Error(`${message}; required fallback watcher could not be acquired`));
+              return;
+            }
+            sourceCoverageAcquired ||= directoryPath === target;
+          }
+          if (!sourceCoverageAcquired) {
+            const message = error instanceof Error ? error.message : String(error);
+            failFromWatcher(target, new Error(`${message}; required fallback watcher could not be acquired`));
+            return;
           }
         }
       } catch (error) {
+        if (target === sourceDirectory) {
+          failFromWatcher(target, error instanceof Error ? error : new Error(String(error)));
+          return;
+        }
         stderr.write(`[fluo] unable to watch ${target}: ${error instanceof Error ? error.message : String(error)}\n`);
       }
     }

package/dist/fixtures/inspect-react-app.module.d.ts

@@ -0,0 +1,4 @@
+/** Fixture application module used by build-less React route inspection tests. */
+export declare class AppModule {
+}
+//# sourceMappingURL=inspect-react-app.module.d.ts.map

package/dist/fixtures/inspect-react-app.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect-react-app.module.d.ts","sourceRoot":"","sources":["../../src/fixtures/inspect-react-app.module.ts"],"names":[],"mappings":"AASA,kFAAkF;AAClF,qBAAa,SAAS;CAAG"}

package/dist/fixtures/inspect-react-app.module.js

@@ -0,0 +1,32 @@
+let _initProto, _initClass;
+function _applyDecs(e, t, n, r, o, i) { var a, c, u, s, f, l, p, d = Symbol.metadata || Symbol.for("Symbol.metadata"), m = Object.defineProperty, h = Object.create, y = [h(null), h(null)], v = t.length; function g(t, n, r) { return function (o, i) { n && (i = o, o = e); for (var a = 0; a < t.length; a++) i = t[a].apply(o, r ? [i] : []); return r ? i : o; }; } function b(e, t, n, r) { if ("function" != typeof e && (r || void 0 !== e)) throw new TypeError(t + " must " + (n || "be") + " a function" + (r ? "" : " or undefined")); return e; } function applyDec(e, t, n, r, o, i, u, s, f, l, p) { function d(e) { if (!p(e)) throw new TypeError("Attempted to access private element on non-instance"); } var h = [].concat(t[0]), v = t[3], w = !u, D = 1 === o, S = 3 === o, j = 4 === o, E = 2 === o; function I(t, n, r) { return function (o, i) { return n && (i = o, o = e), r && r(o), P[t].call(o, i); }; } if (!w) { var P = {}, k = [], F = S ? "get" : j || D ? "set" : "value"; if (f ? (l || D ? P = { get: _setFunctionName(function () { return v(this); }, r, "get"), set: function (e) { t[4](this, e); } } : P[F] = v, l || _setFunctionName(P[F], r, E ? "" : F)) : l || (P = Object.getOwnPropertyDescriptor(e, r)), !l && !f) { if ((c = y[+s][r]) && 7 !== (c ^ o)) throw Error("Decorating two elements with the same name (" + P[F].name + ") is not supported yet"); y[+s][r] = o < 3 ? 1 : o; } } for (var N = e, O = h.length - 1; O >= 0; O -= n ? 2 : 1) { var T = b(h[O], "A decorator", "be", !0), z = n ? h[O - 1] : void 0, A = {}, H = { kind: ["field", "accessor", "method", "getter", "setter", "class"][o], name: r, metadata: a, addInitializer: function (e, t) { if (e.v) throw new TypeError("attempted to call addInitializer after decoration was finished"); b(t, "An initializer", "be", !0), i.push(t); }.bind(null, A) }; if (w) c = T.call(z, N, H), A.v = 1, b(c, "class decorators", "return") && (N = c);else if (H.static = s, H.private = f, c = H.access = { has: f ? p.bind() : function (e) { return r in e; } }, j || (c.get = f ? E ? function (e) { return d(e), P.value; } : I("get", 0, d) : function (e) { return e[r]; }), E || S || (c.set = f ? I("set", 0, d) : function (e, t) { e[r] = t; }), N = T.call(z, D ? { get: P.get, set: P.set } : P[F], H), A.v = 1, D) { if ("object" == typeof N && N) (c = b(N.get, "accessor.get")) && (P.get = c), (c = b(N.set, "accessor.set")) && (P.set = c), (c = b(N.init, "accessor.init")) && k.unshift(c);else if (void 0 !== N) throw new TypeError("accessor decorators must return an object with get, set, or init properties or undefined"); } else b(N, (l ? "field" : "method") + " decorators", "return") && (l ? k.unshift(N) : P[F] = N); } return o < 2 && u.push(g(k, s, 1), g(i, s, 0)), l || w || (f ? D ? u.splice(-1, 0, I("get", s), I("set", s)) : u.push(E ? P[F] : b.call.bind(P[F])) : m(e, r, P)), N; } function w(e) { return m(e, d, { configurable: !0, enumerable: !0, value: a }); } return void 0 !== i && (a = i[d]), a = h(null == a ? null : a), f = [], l = function (e) { e && f.push(g(e)); }, p = function (t, r) { for (var i = 0; i < n.length; i++) { var a = n[i], c = a[1], l = 7 & c; if ((8 & c) == t && !l == r) { var p = a[2], d = !!a[3], m = 16 & c; applyDec(t ? e : e.prototype, a, m, d ? "#" + p : _toPropertyKey(p), l, l < 2 ? [] : t ? s = s || [] : u = u || [], f, !!t, d, r, t && d ? function (t) { return _checkInRHS(t) === e; } : o); } } }, p(8, 0), p(0, 0), p(8, 1), p(0, 1), l(u), l(s), c = f, v || w(e), { e: c, get c() { var n = []; return v && [w(e = applyDec(e, [t], r, e.name, 5, n)), g(n, 1)]; } }; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+function _setFunctionName(e, t, n) { "symbol" == typeof t && (t = (t = t.description) ? "[" + t + "]" : ""); try { Object.defineProperty(e, "name", { configurable: !0, value: n ? n + " " + t : t }); } catch (e) {} return e; }
+function _checkInRHS(e) { if (Object(e) !== e) throw TypeError("right-hand side of 'in' should be an object, got " + (null !== e ? typeof e : "null")); return e; }
+import { defineModule } from '@fluojs/runtime';
+import { Path, ReactModule, Router } from '@fluojs/react';
+let _ProductRouter;
+class ProductRouter {
+  static {
+    ({
+      e: [_initProto],
+      c: [_ProductRouter, _initClass]
+    } = _applyDecs(this, [Router('/products')], [[Path('/:productId'), 2, "show"]]));
+  }
+  constructor() {
+    _initProto(this);
+  }
+  show() {}
+  static {
+    _initClass();
+  }
+}
+
+/** Fixture application module used by build-less React route inspection tests. */
+export class AppModule {}
+defineModule(AppModule, {
+  imports: [ReactModule.forRoot({
+    controllers: [_ProductRouter]
+  })]
+});

package/dist/fixtures/typegen-react-app.module.d.ts

@@ -0,0 +1,4 @@
+/** Fixture root module used by CLI React page typegen tests. */
+export declare class AppModule {
+}
+//# sourceMappingURL=typegen-react-app.module.d.ts.map