@mgvdev/nestkit-core 0.1.0

package/dist/dev.js

@@ -0,0 +1,210 @@
+import { spawn } from 'node:child_process';
+import { watch as chokidarWatch } from 'chokidar';
+import { createOutput } from './dev-output.js';
+import { resolveProjectName, selectWithDeps, topoSort } from './graph.js';
+import { c, logger, ms } from './logger.js';
+import { buildProject, loadWorkspaceGraph } from './orchestrator.js';
+function debounce(fn, delayMs) {
+    let timer = null;
+    return () => {
+        if (timer)
+            clearTimeout(timer);
+        timer = setTimeout(fn, delayMs);
+    };
+}
+const isRunnable = (p) => p.type === 'app' || p.type === 'app-frontend';
+/**
+ * Resolve the runnable dev targets from a request. `all` selects every managed
+ * app + app-frontend; otherwise each ref is resolved and must be runnable.
+ * Throws on unknown, unmanaged, or non-runnable (lib) targets.
+ */
+export function resolveDevTargets(graph, opts) {
+    const requested = opts.all
+        ? [...graph.nodes.values()].filter((p) => p.managed && isRunnable(p)).map((p) => p.name)
+        : [...(opts.targets ?? []), ...(opts.target ? [opts.target] : [])].map((t) => resolveProjectName(graph, t));
+    const runnables = [];
+    const seen = new Set();
+    for (const name of requested) {
+        if (seen.has(name))
+            continue;
+        seen.add(name);
+        const p = graph.nodes.get(name);
+        if (!p.managed)
+            throw new Error(`Project "${name}" has no nestkit.json`);
+        if (!isRunnable(p)) {
+            throw new Error(`Project "${name}" is a ${p.type ?? 'unknown'} — libs aren't runnable; add it to an app instead.`);
+        }
+        runnables.push(p);
+    }
+    if (runnables.length === 0)
+        throw new Error('No dev targets. Pass project name(s) or --all.');
+    return runnables;
+}
+/** Short, unique labels for runners (unscoped name; full name on collision). */
+function makeLabels(runnables) {
+    const counts = new Map();
+    for (const r of runnables) {
+        const base = r.name.split('/').pop();
+        counts.set(base, (counts.get(base) ?? 0) + 1);
+    }
+    const labels = new Map();
+    for (const r of runnables) {
+        const base = r.name.split('/').pop();
+        labels.set(r.name, (counts.get(base) ?? 0) > 1 ? r.name : base);
+    }
+    return labels;
+}
+/**
+ * Run one or more projects in dev mode in parallel: build the union of their
+ * local-dep closures, start a process per runnable target with labeled output,
+ * and watch every source dir to rebuild + restart the affected targets.
+ */
+export async function dev(opts) {
+    const { graph } = loadWorkspaceGraph(opts.root);
+    const runnables = resolveDevTargets(graph, opts);
+    const labelOf = makeLabels(runnables);
+    // Union of every target's local-dep closure, plus which targets each project feeds.
+    const watched = new Map();
+    const dependents = new Map();
+    for (const r of runnables) {
+        for (const n of selectWithDeps(graph, [r.name])) {
+            const p = graph.nodes.get(n);
+            if (!p.managed)
+                continue;
+            watched.set(n, p);
+            (dependents.get(n) ?? dependents.set(n, []).get(n)).push(r.name);
+        }
+    }
+    const sink = createOutput(runnables.map((r) => labelOf.get(r.name)), opts.tui ?? false);
+    // Build the whole union once, in dependency order.
+    const { order } = topoSort(graph);
+    const buildList = order.filter((n) => watched.has(n)).map((n) => watched.get(n));
+    logger.start(`Building ${buildList.length} project(s) for dev...`);
+    for (const p of buildList) {
+        const r = await buildProject(p, opts.root, opts.env, true);
+        logger.success(`${c.bold(p.name)} ${c.dim(`(${p.type})`)} in ${ms(r.durationMs)}`);
+    }
+    const runners = new Map();
+    for (const r of runnables) {
+        const runner = createRunner(r, labelOf.get(r.name), opts, sink);
+        runners.set(r.name, runner);
+        runner.start();
+    }
+    const rebuild = async (p) => {
+        const t0 = performance.now();
+        try {
+            await buildProject(p, opts.root, opts.env, true);
+            for (const rname of dependents.get(p.name) ?? []) {
+                const runner = runners.get(rname);
+                if (!runner)
+                    continue;
+                runner.note(`${p.name} changed — restarting (${ms(performance.now() - t0)})`);
+                runner.restart();
+                if (opts.typecheck !== false)
+                    runner.typecheckBackground();
+            }
+        }
+        catch (err) {
+            logger.error(`Rebuild of ${p.name} failed: ${err.message}`);
+        }
+    };
+    const watchers = [];
+    for (const p of watched.values()) {
+        const trigger = debounce(() => void rebuild(p), 120);
+        const w = chokidarWatch(p.sourceDir, { ignoreInitial: true, ignored: /(^|[/\\])\../ });
+        w.on('all', trigger);
+        watchers.push(w);
+    }
+    logger.box(`nestkit dev — ${runnables.length} process(es), watching ${watched.size} project(s). Ctrl+C to stop.`);
+    return {
+        async stop() {
+            await Promise.all(watchers.map((w) => w.close()));
+            await Promise.all([...runners.values()].map((r) => r.stop()));
+            sink.close();
+        },
+    };
+}
+/** Manages one runnable target's process (app child process or frontend dev server). */
+function createRunner(target, label, opts, sink) {
+    let child = null;
+    let frontend = null;
+    let typechecking = false;
+    const startApp = () => {
+        if (!target.entryOut)
+            throw new Error(`App "${target.name}" has no entry output`);
+        child = spawn(process.execPath, [target.entryOut], {
+            cwd: target.dir,
+            stdio: ['inherit', 'pipe', 'pipe'],
+            env: process.env,
+        });
+        child.stdout?.on('data', (d) => sink.write(label, 'out', d.toString()));
+        child.stderr?.on('data', (d) => sink.write(label, 'err', d.toString()));
+        child.on('exit', (code, signal) => {
+            if (code !== null && code !== 0 && !signal) {
+                sink.write(label, 'err', `exited with code ${code}`);
+            }
+        });
+    };
+    const stopApp = () => new Promise((resolve) => {
+        if (!child)
+            return resolve();
+        const proc = child;
+        child = null;
+        const timeout = setTimeout(() => proc.kill('SIGKILL'), 3000);
+        proc.once('exit', () => {
+            clearTimeout(timeout);
+            resolve();
+        });
+        proc.kill('SIGTERM');
+    });
+    return {
+        start() {
+            if (target.type === 'app-frontend') {
+                const adapter = opts.env.getFrontendAdapter(target.adapter ?? 'vite');
+                void adapter
+                    .serve({
+                    project: target,
+                    root: opts.root,
+                    watch: true,
+                    emit: (chunk, stream) => sink.write(label, stream, chunk),
+                })
+                    .then((s) => {
+                    frontend = s;
+                    if (s.url)
+                        sink.note(label, `serving at ${s.url}`);
+                });
+                return;
+            }
+            startApp();
+        },
+        restart() {
+            if (target.type === 'app-frontend')
+                return; // Vite has its own HMR.
+            void stopApp().then(startApp);
+        },
+        async stop() {
+            await stopApp();
+            if (frontend)
+                await frontend.close();
+        },
+        note(line) {
+            sink.note(label, line);
+        },
+        typecheckBackground() {
+            if (typechecking)
+                return;
+            typechecking = true;
+            void opts.env
+                .getTypeChecker()
+                .check([target], opts.root)
+                .then((r) => {
+                if (!r.ok)
+                    sink.note(label, `typecheck: ${r.diagnostics.length} error(s)`);
+            })
+                .finally(() => {
+                typechecking = false;
+            });
+        },
+    };
+}
+//# sourceMappingURL=dev.js.map

package/dist/dev.js.map

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

package/dist/graph.d.ts

@@ -0,0 +1,31 @@
+import type { Project } from './types.js';
+export interface ProjectGraph {
+    /** Project name -> Project. */
+    nodes: Map<string, Project>;
+    /** Project name -> names of its local dependencies (edges point at deps). */
+    edges: Map<string, string[]>;
+}
+export declare class CycleError extends Error {
+    readonly cycle: string[];
+    constructor(cycle: string[]);
+}
+/** Build a project graph from resolved projects. Edges are local deps only. */
+export declare function buildGraph(projects: Project[]): ProjectGraph;
+/**
+ * Topologically sort the graph so that dependencies come before dependents.
+ * Groups nodes into levels; nodes in the same level are independent and may
+ * build in parallel. Throws CycleError on cycles.
+ */
+export declare function topoSort(graph: ProjectGraph): {
+    order: string[];
+    levels: string[][];
+};
+/**
+ * Resolve a user-supplied project reference to a graph node name.
+ * Accepts the exact package name, the unscoped name (`api` for `@ex/api`),
+ * or the package directory basename. Throws if nothing (or more than one) matches.
+ */
+export declare function resolveProjectName(graph: ProjectGraph, input: string): string;
+/** Return the dependency closure of `targets` (targets + all transitive local deps). */
+export declare function selectWithDeps(graph: ProjectGraph, targets: string[]): Set<string>;
+//# sourceMappingURL=graph.d.ts.map

package/dist/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../src/graph.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAEzC,MAAM,WAAW,YAAY;IAC3B,+BAA+B;IAC/B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC3B,6EAA6E;IAC7E,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;CAC7B;AAED,qBAAa,UAAW,SAAQ,KAAK;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE;gBAAf,KAAK,EAAE,MAAM,EAAE;CAIrC;AAED,+EAA+E;AAC/E,wBAAgB,UAAU,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,YAAY,CAW5D;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAA;CAAE,CAsCrF;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAU7E;AAED,wFAAwF;AACxF,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAYlF"}

package/dist/graph.js

@@ -0,0 +1,128 @@
+import { basename } from 'node:path';
+export class CycleError extends Error {
+    cycle;
+    constructor(cycle) {
+        super(`Dependency cycle detected: ${cycle.join(' -> ')}`);
+        this.cycle = cycle;
+        this.name = 'CycleError';
+    }
+}
+/** Build a project graph from resolved projects. Edges are local deps only. */
+export function buildGraph(projects) {
+    const nodes = new Map(projects.map((p) => [p.name, p]));
+    const edges = new Map();
+    for (const p of projects) {
+        // Keep only deps that are actually present as nodes.
+        edges.set(p.name, p.localDeps.filter((d) => nodes.has(d)));
+    }
+    return { nodes, edges };
+}
+/**
+ * Topologically sort the graph so that dependencies come before dependents.
+ * Groups nodes into levels; nodes in the same level are independent and may
+ * build in parallel. Throws CycleError on cycles.
+ */
+export function topoSort(graph) {
+    const indegree = new Map();
+    const dependents = new Map();
+    for (const name of graph.nodes.keys()) {
+        indegree.set(name, 0);
+        dependents.set(name, []);
+    }
+    for (const [name, deps] of graph.edges) {
+        indegree.set(name, deps.length);
+        for (const dep of deps)
+            dependents.get(dep)?.push(name);
+    }
+    const order = [];
+    const levels = [];
+    let frontier = [...indegree.entries()]
+        .filter(([, d]) => d === 0)
+        .map(([n]) => n)
+        .sort();
+    while (frontier.length > 0) {
+        levels.push(frontier);
+        const next = [];
+        for (const name of frontier) {
+            order.push(name);
+            for (const dep of dependents.get(name) ?? []) {
+                const d = (indegree.get(dep) ?? 0) - 1;
+                indegree.set(dep, d);
+                if (d === 0)
+                    next.push(dep);
+            }
+        }
+        frontier = next.sort();
+    }
+    if (order.length !== graph.nodes.size) {
+        const remaining = [...graph.nodes.keys()].filter((n) => !order.includes(n));
+        throw new CycleError(findCycle(graph, remaining));
+    }
+    return { order, levels };
+}
+/**
+ * Resolve a user-supplied project reference to a graph node name.
+ * Accepts the exact package name, the unscoped name (`api` for `@ex/api`),
+ * or the package directory basename. Throws if nothing (or more than one) matches.
+ */
+export function resolveProjectName(graph, input) {
+    if (graph.nodes.has(input))
+        return input;
+    const byUnscoped = [...graph.nodes.keys()].filter((n) => n.split('/').pop() === input);
+    if (byUnscoped.length === 1)
+        return byUnscoped[0];
+    const byDir = [...graph.nodes.values()].filter((p) => basename(p.dir) === input);
+    if (byDir.length === 1)
+        return byDir[0].name;
+    if (byUnscoped.length > 1 || byDir.length > 1) {
+        throw new Error(`Ambiguous project reference "${input}" — use the full package name.`);
+    }
+    throw new Error(`Unknown project: ${input}`);
+}
+/** Return the dependency closure of `targets` (targets + all transitive local deps). */
+export function selectWithDeps(graph, targets) {
+    const selected = new Set();
+    const visit = (name) => {
+        if (selected.has(name))
+            return;
+        selected.add(name);
+        for (const dep of graph.edges.get(name) ?? [])
+            visit(dep);
+    };
+    for (const t of targets) {
+        if (!graph.nodes.has(t))
+            throw new Error(`Unknown project: ${t}`);
+        visit(t);
+    }
+    return selected;
+}
+/** Depth-first search to surface a concrete cycle for error messages. */
+function findCycle(graph, candidates) {
+    const stack = [];
+    const onStack = new Set();
+    const visited = new Set();
+    const dfs = (name) => {
+        if (onStack.has(name))
+            return [...stack.slice(stack.indexOf(name)), name];
+        if (visited.has(name))
+            return null;
+        visited.add(name);
+        onStack.add(name);
+        stack.push(name);
+        for (const dep of graph.edges.get(name) ?? []) {
+            const found = dfs(dep);
+            if (found)
+                return found;
+        }
+        stack.pop();
+        onStack.delete(name);
+        return null;
+    };
+    for (const c of candidates) {
+        const found = dfs(c);
+        if (found)
+            return found;
+    }
+    return candidates;
+}
+//# sourceMappingURL=graph.js.map

package/dist/graph.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export * from './types.js';
+export * from './config.js';
+export * from './workspace.js';
+export * from './project.js';
+export * from './graph.js';
+export * from './tsconfig.js';
+export * from './compiler.js';
+export * from './bundler.js';
+export * from './orchestrator.js';
+export * from './dev.js';
+export * from './dev-output.js';
+export { logger, c, ms } from './logger.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,mBAAmB,CAAA;AACjC,cAAc,UAAU,CAAA;AACxB,cAAc,iBAAiB,CAAA;AAC/B,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,aAAa,CAAA"}

package/dist/index.js

@@ -0,0 +1,13 @@
+export * from './types.js';
+export * from './config.js';
+export * from './workspace.js';
+export * from './project.js';
+export * from './graph.js';
+export * from './tsconfig.js';
+export * from './compiler.js';
+export * from './bundler.js';
+export * from './orchestrator.js';
+export * from './dev.js';
+export * from './dev-output.js';
+export { logger, c, ms } from './logger.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,mBAAmB,CAAA;AACjC,cAAc,UAAU,CAAA;AACxB,cAAc,iBAAiB,CAAA;AAC/B,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,aAAa,CAAA"}

package/dist/logger.d.ts

@@ -0,0 +1,7 @@
+export declare const logger: import("consola").ConsolaInstance;
+export declare const c: import("picocolors/types.js").Colors & {
+    createColors: (enabled?: boolean) => import("picocolors/types.js").Colors;
+};
+/** Format a duration in ms as a short human string. */
+export declare function ms(duration: number): string;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,MAAM,mCAA6B,CAAA;AAEhD,eAAO,MAAM,CAAC;0BAFgB,CAAC;CAEZ,CAAA;AAEnB,uDAAuD;AACvD,wBAAgB,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE3C"}

package/dist/logger.js

@@ -0,0 +1,9 @@
+import { consola } from 'consola';
+import pc from 'picocolors';
+export const logger = consola.withTag('nestkit');
+export const c = pc;
+/** Format a duration in ms as a short human string. */
+export function ms(duration) {
+    return duration < 1000 ? `${Math.round(duration)}ms` : `${(duration / 1000).toFixed(2)}s`;
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,MAAM,YAAY,CAAA;AAE3B,MAAM,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;AAEhD,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAA;AAEnB,uDAAuD;AACvD,MAAM,UAAU,EAAE,CAAC,QAAgB;IACjC,OAAO,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAA;AAC3F,CAAC"}

package/dist/orchestrator.d.ts

@@ -0,0 +1,26 @@
+import type { BuildEnv, BuildResult } from './compiler.js';
+import { type ProjectGraph } from './graph.js';
+import type { Project, Workspace } from './types.js';
+export interface LoadedWorkspace {
+    workspace: Workspace;
+    projects: Project[];
+    graph: ProjectGraph;
+}
+/** Discover the workspace and build its project graph. */
+export declare function loadWorkspaceGraph(root: string): LoadedWorkspace;
+export interface BuildOptions {
+    root: string;
+    /** Explicit project targets. Ignored when `all` is true. */
+    targets?: string[];
+    all?: boolean;
+    env: BuildEnv;
+}
+/** Build the requested projects (plus their local-dep closure) in graph order. */
+export declare function buildWorkspace(opts: BuildOptions): Promise<void>;
+/** Build a single project through the right adapter. */
+export declare function buildProject(project: Project, root: string, env: BuildEnv, watch: boolean): Promise<BuildResult>;
+/** Run a whole-graph type check. */
+export declare function typecheckWorkspace(root: string, env: BuildEnv): Promise<boolean>;
+/** Remove build outputs (outDir + tsbuildinfo) for managed projects. */
+export declare function cleanWorkspace(root: string, targets?: string[]): Promise<void>;
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../src/orchestrator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC1D,OAAO,EACL,KAAK,YAAY,EAKlB,MAAM,YAAY,CAAA;AAGnB,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAGpD,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,SAAS,CAAA;IACpB,QAAQ,EAAE,OAAO,EAAE,CAAA;IACnB,KAAK,EAAE,YAAY,CAAA;CACpB;AAED,0DAA0D;AAC1D,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAKhE;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,GAAG,EAAE,QAAQ,CAAA;CACd;AAED,kFAAkF;AAClF,wBAAsB,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BtE;AAED,wDAAwD;AACxD,wBAAsB,YAAY,CAChC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,QAAQ,EACb,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,WAAW,CAAC,CAgBtB;AAED,oCAAoC;AACpC,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAStF;AAED,wEAAwE;AACxE,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAYpF"}

package/dist/orchestrator.js

@@ -0,0 +1,77 @@
+import { rm } from 'node:fs/promises';
+import { join } from 'node:path';
+import { buildGraph, resolveProjectName, selectWithDeps, topoSort, } from './graph.js';
+import { c, logger, ms } from './logger.js';
+import { resolveProjects } from './project.js';
+import { discoverWorkspace } from './workspace.js';
+/** Discover the workspace and build its project graph. */
+export function loadWorkspaceGraph(root) {
+    const workspace = discoverWorkspace(root);
+    const projects = resolveProjects(workspace);
+    const graph = buildGraph(projects);
+    return { workspace, projects, graph };
+}
+/** Build the requested projects (plus their local-dep closure) in graph order. */
+export async function buildWorkspace(opts) {
+    const { graph } = loadWorkspaceGraph(opts.root);
+    const { levels } = topoSort(graph);
+    const selected = opts.all
+        ? new Set(graph.nodes.keys())
+        : selectWithDeps(graph, (opts.targets ?? []).map((t) => resolveProjectName(graph, t)));
+    const managedSelected = [...selected].filter((n) => graph.nodes.get(n)?.managed);
+    if (managedSelected.length === 0) {
+        logger.warn('No managed nestkit projects selected (missing nestkit.json?).');
+        return;
+    }
+    const start = performance.now();
+    for (const level of levels) {
+        const batch = level.filter((n) => selected.has(n) && graph.nodes.get(n)?.managed);
+        await Promise.all(batch.map(async (name) => {
+            const project = graph.nodes.get(name);
+            const result = await buildProject(project, opts.root, opts.env, false);
+            logger.success(`${c.bold(name)} ${c.dim(`(${project.type})`)} built in ${ms(result.durationMs)}`);
+        }));
+    }
+    logger.info(`Done in ${ms(performance.now() - start)}`);
+}
+/** Build a single project through the right adapter. */
+export async function buildProject(project, root, env, watch) {
+    const ctx = { project, root, watch };
+    if (project.type === 'app-frontend') {
+        const adapter = env.getFrontendAdapter(project.adapter ?? 'vite');
+        return adapter.build(ctx);
+    }
+    const compiler = env.getCompiler(project.compiler);
+    const result = await compiler.build(ctx);
+    // Libraries additionally emit declaration files for consumers (skipped in dev).
+    if (project.type === 'lib' && !watch) {
+        await env.getDtsBuilder().emitDts(project, root);
+    }
+    return result;
+}
+/** Run a whole-graph type check. */
+export async function typecheckWorkspace(root, env) {
+    const { projects } = loadWorkspaceGraph(root);
+    // Frontend projects (Vite, etc.) run their own type checking; tsc covers apps and libs.
+    const managed = projects.filter((p) => p.managed && p.type !== 'app-frontend');
+    const result = await env.getTypeChecker().check(managed, root);
+    if (result.output.trim())
+        logger.log(result.output.trimEnd());
+    if (result.ok)
+        logger.success('Typecheck passed');
+    else
+        logger.error(`Typecheck failed (${result.diagnostics.length} error(s))`);
+    return result.ok;
+}
+/** Remove build outputs (outDir + tsbuildinfo) for managed projects. */
+export async function cleanWorkspace(root, targets) {
+    const { projects, graph } = loadWorkspaceGraph(root);
+    const set = targets && targets.length > 0 ? new Set(targets.map((t) => resolveProjectName(graph, t))) : null;
+    const toClean = projects.filter((p) => p.managed && (!set || set.has(p.name)));
+    await Promise.all(toClean.map(async (p) => {
+        await rm(p.outDir, { recursive: true, force: true });
+        await rm(join(p.dir, 'tsconfig.tsbuildinfo'), { force: true });
+        logger.info(`Cleaned ${c.bold(p.name)}`);
+    }));
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/orchestrator.js.map

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

package/dist/project.d.ts

@@ -0,0 +1,8 @@
+import type { PackageJson, Project, Workspace, WorkspacePackage } from './types.js';
+/** All dependency names declared by a package (prod + dev + peer). */
+export declare function allDependencyNames(pkg: PackageJson): string[];
+/** Resolve a discovered package into a Project, applying nestkit.json defaults. */
+export declare function resolveProject(pkg: WorkspacePackage, localNames: Set<string>): Project;
+/** Resolve every package in a workspace into a Project. */
+export declare function resolveProjects(workspace: Workspace): Project[];
+//# sourceMappingURL=project.d.ts.map

package/dist/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAgB,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAEjG,sEAAsE;AACtE,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,EAAE,CAM7D;AAQD,mFAAmF;AACnF,wBAAgB,cAAc,CAAC,GAAG,EAAE,gBAAgB,EAAE,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,OAAO,CAmCtF;AAED,2DAA2D;AAC3D,wBAAgB,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,EAAE,CAG/D"}