@doriandev/devcc 0.1.2

package/bin/devcc.mjs

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+/**
+ * Runtime-selecting launcher for `devcc`.
+ *
+ * OpenTUI renders through a native Zig library over FFI, which needs either
+ * Bun 1.3+ or Node 26.4+ started with `--experimental-ffi`. This shim runs the
+ * dashboard directly when the current runtime already qualifies, and otherwise
+ * re-execs into one that does rather than failing with an FFI error.
+ */
+import { spawnSync } from "node:child_process"
+import { existsSync } from "node:fs"
+import { dirname, join, resolve } from "node:path"
+import { fileURLToPath } from "node:url"
+
+const here = dirname(fileURLToPath(import.meta.url))
+const packageRoot = resolve(here, "..")
+const distEntry = join(packageRoot, "dist", "devcc", "cli.js")
+const sourceEntry = join(packageRoot, "src", "devcc", "cli.ts")
+
+const isBun = typeof globalThis.Bun !== "undefined"
+const nodeSupportsFfi =
+  supportsNodeFfi(process.versions.node) && process.execArgv.includes("--experimental-ffi")
+
+if (isBun || nodeSupportsFfi) {
+  const entry = existsSync(distEntry) ? distEntry : sourceEntry
+  const { main } = await import(entry)
+  const code = await main(process.argv.slice(2))
+  process.exit(code ?? 0)
+}
+
+// Prefer a built bundle; fall back to the TypeScript entry (Bun runs it directly).
+const entry = existsSync(distEntry) ? distEntry : sourceEntry
+const args = process.argv.slice(2)
+
+if (hasCommand("bun")) {
+  exec("bun", ["run", entry, ...args])
+} else if (supportsNodeFfi(process.versions.node)) {
+  exec(process.execPath, ["--experimental-ffi", entry, ...args])
+} else {
+  process.stderr.write(
+    [
+      "devcc needs a runtime with FFI support.",
+      "",
+      `  current: node ${process.versions.node}`,
+      "  required: bun >= 1.3.0, or node >= 26.4.0 (run with --experimental-ffi)",
+      "",
+      "Install Bun from https://bun.sh, or upgrade Node.",
+      "",
+    ].join("\n"),
+  )
+  process.exit(1)
+}
+
+function exec(command, argv) {
+  const result = spawnSync(command, argv, { stdio: "inherit" })
+  process.exit(result.status ?? 1)
+}
+
+function hasCommand(command) {
+  return spawnSync(command, ["--version"], { stdio: "ignore" }).status === 0
+}
+
+function supportsNodeFfi(version) {
+  const [major = 0, minor = 0] = version.split(".").map((part) => Number.parseInt(part, 10) || 0)
+  return major > 26 || (major === 26 && minor >= 4)
+}

package/dist/devcc/app/App.d.ts

@@ -0,0 +1,178 @@
+import { type CliRenderer } from "@opentui/core";
+import { Store, type AppState } from "../core/state.js";
+import { LogStore } from "../logs/LogBuffer.js";
+export interface AppOptions {
+    /** Directory to treat as the project. Defaults to the detected project root. */
+    cwd?: string;
+    /** Injected by tests; production creates its own renderer. */
+    renderer?: CliRenderer;
+}
+export declare class App {
+    private readonly options;
+    private renderer;
+    /** Torn down only when the app exits. */
+    private readonly subscriptions;
+    /** App-level timers (clock, uptime tick). */
+    private timers;
+    private readonly views;
+    private store;
+    /** Every open project, keyed by root directory. All keep their processes alive. */
+    private readonly sessions;
+    /** The project the views are showing. */
+    private session;
+    /** Stable across project switches; repopulated per session. */
+    private readonly commands;
+    private context;
+    private get logger();
+    private get logs();
+    private get processes();
+    private get services();
+    private get git();
+    private get system();
+    private get deps();
+    private get config();
+    private header;
+    private footer;
+    private sidebar;
+    private contentBox;
+    private bodyBox;
+    private palette;
+    private projectPicker;
+    private confirmDialog;
+    private promptDialog;
+    private helpOverlay;
+    private activeView;
+    private viewDirty;
+    private logUpdateTimer;
+    private notificationSeq;
+    private switching;
+    private shuttingDown;
+    private exitResolver;
+    constructor(options?: AppOptions);
+    /**
+     * Bootstrap services, build the UI and start background polling.
+     * Returns as soon as the first frame is ready; slower work continues behind it.
+     */
+    start(): Promise<void>;
+    /** Boot the dashboard and resolve when the user quits. */
+    run(): Promise<void>;
+    private bootstrap;
+    /**
+     * Build every project-scoped service for `rootDir`.
+     *
+     * Nothing here touches the renderer or the store, which is what makes it
+     * reusable for switching projects at runtime.
+     */
+    private createSession;
+    /** Rebuild the command registry for the current session. */
+    private registerSessionCommands;
+    private reportConfigIssues;
+    private mount;
+    private wireEvents;
+    /**
+     * Subscribe to one session's backends.
+     *
+     * Every open project is wired, so background projects keep tracking their
+     * processes and capturing logs. Only the *active* project mirrors its state
+     * into the store; the others surface nothing but notifications, prefixed
+     * with the project name so you know where a crash happened.
+     */
+    private wireSession;
+    /** Store -> UI watchers. App-level: they outlive any single project. */
+    private wireStoreToUi;
+    /**
+     * Kick off background work after the first frame.
+     * Nothing here blocks the UI: the dashboard is usable while it runs.
+     */
+    private startAppTimers;
+    /**
+     * Pollers for one project. Only the active project polls git, services and
+     * system metrics - background projects merely keep their processes alive.
+     */
+    private startSessionBackground;
+    private stopSessionBackground;
+    private renderAll;
+    private markViewDirty;
+    /** Log output can arrive in bursts; coalesce redraws. */
+    private scheduleLogUpdate;
+    private setView;
+    private updateFooterHints;
+    private overlays;
+    /** Stop every app-level timer and every session's pollers. */
+    private stopBackground;
+    private handleResize;
+    private handleKey;
+    private handleConfirmKey;
+    private handlePromptKey;
+    private handlePaletteKey;
+    private handleProjectPickerKey;
+    private cycleView;
+    private moveSelection;
+    private openPalette;
+    /** Scanning the filesystem is quick but not free, so do it on open. */
+    private openProjectPicker;
+    private refreshProjectPicker;
+    private openHelp;
+    private refreshPalette;
+    private closeOverlays;
+    private runCommand;
+    private pushNotification;
+    private showNotification;
+    /**
+     * The context handed to commands and views.
+     *
+     * Built once and kept stable: session services are read through getters, so a
+     * project switch swaps the backends underneath every existing view without
+     * rebuilding the UI.
+     */
+    private createCommandContext;
+    private askConfirm;
+    private askPrompt;
+    /** Run a package.json script as a managed one-shot process. */
+    private runScript;
+    private finishScriptRun;
+    private runConfigCommand;
+    /** Current project first, then recents, config entries and sibling directories. */
+    private listProjects;
+    /** Open projects in the order they were opened. */
+    private openProjects;
+    /**
+     * Open a project, or bring an already-open one to the front.
+     *
+     * Opening never stops anything: the previous project keeps running in the
+     * background with its processes and log capture intact. The renderer, views
+     * and store are shared; only the session behind them changes.
+     */
+    private openProject;
+    /** Point the views at `session` and mirror its current state into the store. */
+    private activateSession;
+    /**
+     * Close a project, stopping anything devcc started there (confirmed).
+     * The last open project cannot be closed - quit instead.
+     */
+    private closeProject;
+    /** `ctrl+o`: bring the next open project to the front. */
+    private cycleProject;
+    /** Feed the rail the per-project running counts. */
+    private refreshSidebarProjects;
+    /** Update a single package, gated by a confirmation (it rewrites the lockfile). */
+    private updateDependency;
+    /**
+     * Graceful shutdown: stop timers and listeners, stop the processes devcc
+     * launched (never anything merely detected), then hand the terminal back.
+     */
+    quit(): Promise<void>;
+    /** Test hook: the store the UI is bound to. */
+    getStore(): Store<AppState>;
+    /** Test hook: open/activate a project without driving the picker overlay. */
+    switchProjectForTest(path: string): Promise<void>;
+    /** Test hook: close a project without the confirmation dialog when nothing runs. */
+    closeProjectForTest(path: string): Promise<void>;
+    /** Test hook: dependency-ordered start of the active project's processes. */
+    startAllForTest(ids?: string[]): Promise<void>;
+    /** Test hook: root directories of every open project. */
+    openProjectPaths(): string[];
+    /** Test hook: the log store backing the Logs view. */
+    getLogs(): LogStore;
+}
+//# sourceMappingURL=App.d.ts.map

package/dist/devcc/app/App.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"App.d.ts","sourceRoot":"","sources":["../../../src/devcc/app/App.ts"],"names":[],"mappings":"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"}