@fluxfast/next 0.1.0 → 0.3.0

package/bin/fluxfast.js

@@ -1,14 +1,5 @@
 #!/usr/bin/env node
 
-const { generatePagesRegistry } = require("../dist/generate.js");
-
-const command = process.argv[2];
-
-if (command === "generate" || !command) {
-  generatePagesRegistry();
-} else {
-  console.log(`Unknown command: ${command}`);
-  console.log("Usage: fluxfast generate");
-  process.exit(1);
-}
+const { runCli } = require("../dist/cli/index.js");
 
+process.exitCode = runCli(process.argv.slice(2));

package/dist/cli/apply.d.ts

@@ -0,0 +1,11 @@
+import { type InitPlan } from "./init";
+export interface ApplyInitOptions {
+    logRegistry?: boolean;
+}
+export interface ApplyInitResult {
+    changed: number;
+    registryPath: string;
+}
+/** Apply a validated plan and roll back task-owned writes if any step fails. */
+export declare function applyInitPlan(plan: InitPlan, options?: ApplyInitOptions): ApplyInitResult;
+//# sourceMappingURL=apply.d.ts.map

package/dist/cli/apply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../../src/cli/apply.ts"],"names":[],"mappings":"AAGA,OAAO,EAAyC,KAAK,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAE9E,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;CACtB;AA0GD,gFAAgF;AAChF,wBAAgB,aAAa,CAC3B,IAAI,EAAE,QAAQ,EACd,OAAO,GAAE,gBAAqB,GAC7B,eAAe,CA6FjB"}

package/dist/cli/apply.js

@@ -0,0 +1,189 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyInitPlan = applyInitPlan;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const generate_1 = require("../generate");
+const init_1 = require("./init");
+function exists(target) {
+    try {
+        node_fs_1.default.lstatSync(target);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function isWithin(root, target) {
+    const relative = node_path_1.default.relative(root, target);
+    return (relative === "" ||
+        (!relative.startsWith(`..${node_path_1.default.sep}`) &&
+            relative !== ".." &&
+            !node_path_1.default.isAbsolute(relative)));
+}
+function nearestExistingAncestor(target) {
+    let current = target;
+    while (!exists(current)) {
+        const parent = node_path_1.default.dirname(current);
+        if (parent === current) {
+            return current;
+        }
+        current = parent;
+    }
+    return current;
+}
+function assertSafeTarget(root, realRoot, target) {
+    const resolved = node_path_1.default.resolve(target);
+    if (!isWithin(root, resolved)) {
+        throw new Error(`FluxFast refused to write outside the project root: ${target}`);
+    }
+    const ancestor = nearestExistingAncestor(resolved);
+    const realAncestor = node_fs_1.default.realpathSync(ancestor);
+    if (!isWithin(realRoot, realAncestor)) {
+        throw new Error(`FluxFast refused to follow a path outside the project root: ${target}`);
+    }
+}
+function operationTargets(operation) {
+    if (operation.type === "move") {
+        return [operation.from, operation.to];
+    }
+    if (operation.type === "skip") {
+        return operation.path ? [operation.path] : [];
+    }
+    return [operation.path];
+}
+function assertPlanStillApplies(plan) {
+    if (plan.errors.length > 0) {
+        throw new Error(plan.errors.join("\n"));
+    }
+    const root = node_path_1.default.resolve(plan.project.root);
+    const realRoot = node_fs_1.default.realpathSync(root);
+    for (const operation of plan.operations) {
+        for (const target of operationTargets(operation)) {
+            assertSafeTarget(root, realRoot, target);
+        }
+        if (operation.type === "create" && exists(operation.path)) {
+            throw new Error(`${operation.path} was created after FluxFast analyzed the project.`);
+        }
+        if (operation.type === "modify") {
+            if (!exists(operation.path) ||
+                node_fs_1.default.readFileSync(operation.path, "utf8") !== operation.before) {
+                throw new Error(`${operation.path} changed after FluxFast analyzed it; run fluxfast init again.`);
+            }
+        }
+        if (operation.type === "move") {
+            if (!exists(operation.from) ||
+                node_fs_1.default.readFileSync(operation.from, "utf8") !== operation.before) {
+                throw new Error(`${operation.from} changed after FluxFast analyzed it; run fluxfast init again.`);
+            }
+            if (exists(operation.to)) {
+                throw new Error(`${operation.to} was created after FluxFast analyzed the project.`);
+            }
+        }
+    }
+    assertSafeTarget(root, realRoot, plan.project.fluxPagesDir);
+    assertSafeTarget(root, realRoot, plan.project.registryPath);
+}
+/** Apply a validated plan and roll back task-owned writes if any step fails. */
+function applyInitPlan(plan, options = {}) {
+    assertPlanStillApplies(plan);
+    const rollback = [];
+    const ensureDirectory = (directory) => {
+        if (exists(directory))
+            return;
+        const missing = [];
+        let current = directory;
+        while (!exists(current)) {
+            missing.push(current);
+            current = node_path_1.default.dirname(current);
+        }
+        for (const target of missing.reverse()) {
+            node_fs_1.default.mkdirSync(target);
+            rollback.push(() => {
+                if (exists(target) && node_fs_1.default.readdirSync(target).length === 0) {
+                    node_fs_1.default.rmdirSync(target);
+                }
+            });
+        }
+    };
+    const createFile = (target, content) => {
+        ensureDirectory(node_path_1.default.dirname(target));
+        rollback.push(() => {
+            if (exists(target))
+                node_fs_1.default.unlinkSync(target);
+        });
+        node_fs_1.default.writeFileSync(target, content, "utf8");
+    };
+    try {
+        for (const operation of plan.operations) {
+            if (operation.type === "skip")
+                continue;
+            if (operation.type === "mkdir") {
+                ensureDirectory(operation.path);
+            }
+            else if (operation.type === "create") {
+                createFile(operation.path, operation.content);
+            }
+            else if (operation.type === "modify") {
+                rollback.push(() => node_fs_1.default.writeFileSync(operation.path, operation.before, "utf8"));
+                node_fs_1.default.writeFileSync(operation.path, operation.after, "utf8");
+            }
+            else if (operation.type === "move") {
+                ensureDirectory(node_path_1.default.dirname(operation.to));
+                rollback.push(() => {
+                    node_fs_1.default.writeFileSync(operation.from, operation.before, "utf8");
+                    if (exists(operation.to))
+                        node_fs_1.default.unlinkSync(operation.to);
+                });
+                node_fs_1.default.writeFileSync(operation.to, operation.content, "utf8");
+                if (node_fs_1.default.readFileSync(operation.to, "utf8") !== operation.content) {
+                    throw new Error(`Could not verify migrated page at ${operation.to}.`);
+                }
+                node_fs_1.default.unlinkSync(operation.from);
+            }
+            else if (operation.type === "remove") {
+                const before = node_fs_1.default.readFileSync(operation.path, "utf8");
+                rollback.push(() => node_fs_1.default.writeFileSync(operation.path, before, "utf8"));
+                node_fs_1.default.unlinkSync(operation.path);
+            }
+        }
+        const registryExisted = exists(plan.project.registryPath);
+        const registryBefore = registryExisted
+            ? node_fs_1.default.readFileSync(plan.project.registryPath, "utf8")
+            : undefined;
+        ensureDirectory(plan.project.fluxPagesDir);
+        ensureDirectory(node_path_1.default.dirname(plan.project.registryPath));
+        rollback.push(() => {
+            if (registryExisted && registryBefore !== undefined) {
+                node_fs_1.default.writeFileSync(plan.project.registryPath, registryBefore, "utf8");
+            }
+            else if (exists(plan.project.registryPath)) {
+                node_fs_1.default.unlinkSync(plan.project.registryPath);
+            }
+        });
+        (0, generate_1.generatePagesRegistry)({
+            pagesDir: plan.project.fluxPagesDir,
+            outputFile: plan.project.registryPath,
+            log: options.logRegistry,
+        });
+        return {
+            changed: (0, init_1.changedOperations)(plan).length,
+            registryPath: plan.project.registryPath,
+        };
+    }
+    catch (error) {
+        for (const undo of rollback.reverse()) {
+            try {
+                undo();
+            }
+            catch {
+                // Preserve the original failure. Best-effort rollback has no extra files.
+            }
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=apply.js.map

package/dist/cli/apply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.js","sourceRoot":"","sources":["../../src/cli/apply.ts"],"names":[],"mappings":";;;;;;AAAA,sDAAyB;AACzB,0DAA6B;AAC7B,0CAAoD;AACpD,iCAA8E;AAW9E,SAAS,MAAM,CAAC,MAAc;IAC5B,IAAI,CAAC;QACH,iBAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY,EAAE,MAAc;IAC5C,MAAM,QAAQ,GAAG,mBAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC7C,OAAO,CACL,QAAQ,KAAK,EAAE;QACf,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,mBAAI,CAAC,GAAG,EAAE,CAAC;YACpC,QAAQ,KAAK,IAAI;YACjB,CAAC,mBAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAC9B,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAAC,MAAc;IAC7C,IAAI,OAAO,GAAG,MAAM,CAAC;IACrB,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,mBAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YACvB,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAY,EAAE,QAAgB,EAAE,MAAc;IACtE,MAAM,QAAQ,GAAG,mBAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACtC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,uDAAuD,MAAM,EAAE,CAAC,CAAC;IACnF,CAAC;IAED,MAAM,QAAQ,GAAG,uBAAuB,CAAC,QAAQ,CAAC,CAAC;IACnD,MAAM,YAAY,GAAG,iBAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC/C,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CACb,+DAA+D,MAAM,EAAE,CACxE,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,SAAwB;IAChD,IAAI,SAAS,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC9B,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC;IACxC,CAAC;IACD,IAAI,SAAS,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC9B,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAChD,CAAC;IACD,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,sBAAsB,CAAC,IAAc;IAC5C,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,IAAI,GAAG,mBAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,iBAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IACvC,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACxC,KAAK,MAAM,MAAM,IAAI,gBAAgB,CAAC,SAAS,CAAC,EAAE,CAAC;YACjD,gBAAgB,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC3C,CAAC;QAED,IAAI,SAAS,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1D,MAAM,IAAI,KAAK,CACb,GAAG,SAAS,CAAC,IAAI,mDAAmD,CACrE,CAAC;QACJ,CAAC;QACD,IAAI,SAAS,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAChC,IACE,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC;gBACvB,iBAAE,CAAC,YAAY,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,SAAS,CAAC,MAAM,EAC5D,CAAC;gBACD,MAAM,IAAI,KAAK,CACb,GAAG,SAAS,CAAC,IAAI,+DAA+D,CACjF,CAAC;YACJ,CAAC;QACH,CAAC;QACD,IAAI,SAAS,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC9B,IACE,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC;gBACvB,iBAAE,CAAC,YAAY,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,SAAS,CAAC,MAAM,EAC5D,CAAC;gBACD,MAAM,IAAI,KAAK,CACb,GAAG,SAAS,CAAC,IAAI,+DAA+D,CACjF,CAAC;YACJ,CAAC;YACD,IAAI,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC;gBACzB,MAAM,IAAI,KAAK,CACb,GAAG,SAAS,CAAC,EAAE,mDAAmD,CACnE,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,gBAAgB,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAC5D,gBAAgB,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;AAC9D,CAAC;AAED,gFAAgF;AAChF,uBACE,IAAc,EACd,OAAO,GAAqB,EAAE;IAE9B,sBAAsB,CAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,QAAQ,GAAsB,EAAE,CAAC;IAEvC,MAAM,eAAe,GAAG,CAAC,SAAiB,EAAQ,EAAE;QAClD,IAAI,MAAM,CAAC,SAAS,CAAC;YAAE,OAAO;QAC9B,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,IAAI,OAAO,GAAG,SAAS,CAAC;QACxB,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YACxB,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACtB,OAAO,GAAG,mBAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAClC,CAAC;QACD,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;YACvC,iBAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YACrB,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE;gBACjB,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,iBAAE,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC1D,iBAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;gBACvB,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,UAAU,GAAG,CAAC,MAAc,EAAE,OAAe,EAAQ,EAAE;QAC3D,eAAe,CAAC,mBAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QACtC,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE;YACjB,IAAI,MAAM,CAAC,MAAM,CAAC;gBAAE,iBAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;QACH,iBAAE,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAC5C,CAAC,CAAC;IAEF,IAAI,CAAC;QACH,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACxC,IAAI,SAAS,CAAC,IAAI,KAAK,MAAM;gBAAE,SAAS;YACxC,IAAI,SAAS,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;gBAC/B,eAAe,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAClC,CAAC;iBAAM,IAAI,SAAS,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACvC,UAAU,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;YAChD,CAAC;iBAAM,IAAI,SAAS,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACvC,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,CACjB,iBAAE,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAC3D,CAAC;gBACF,iBAAE,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YAC5D,CAAC;iBAAM,IAAI,SAAS,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBACrC,eAAe,CAAC,mBAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC5C,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE;oBACjB,iBAAE,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;oBAC3D,IAAI,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;wBAAE,iBAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;gBACxD,CAAC,CAAC,CAAC;gBACH,iBAAE,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,EAAE,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;gBAC1D,IAAI,iBAAE,CAAC,YAAY,CAAC,SAAS,CAAC,EAAE,EAAE,MAAM,CAAC,KAAK,SAAS,CAAC,OAAO,EAAE,CAAC;oBAChE,MAAM,IAAI,KAAK,CAAC,qCAAqC,SAAS,CAAC,EAAE,GAAG,CAAC,CAAC;gBACxE,CAAC;gBACD,iBAAE,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAChC,CAAC;iBAAM,IAAI,SAAS,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACvC,MAAM,MAAM,GAAG,iBAAE,CAAC,YAAY,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;gBACvD,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,iBAAE,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;gBACtE,iBAAE,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;QAED,MAAM,eAAe,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAC1D,MAAM,cAAc,GAAG,eAAe;YACpC,CAAC,CAAC,iBAAE,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,MAAM,CAAC;YACpD,CAAC,CAAC,SAAS,CAAC;QACd,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAC3C,eAAe,CAAC,mBAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;QACzD,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE;YACjB,IAAI,eAAe,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;gBACpD,iBAAE,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC;YACtE,CAAC;iBAAM,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;gBAC7C,iBAAE,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC,CAAC,CAAC;QACH,IAAA,gCAAqB,EAAC;YACpB,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY;YACnC,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY;YACrC,GAAG,EAAE,OAAO,CAAC,WAAW;SACzB,CAAC,CAAC;QAEH,OAAO;YACL,OAAO,EAAE,IAAA,wBAAiB,EAAC,IAAI,CAAC,CAAC,MAAM;YACvC,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY;SACxC,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;YACtC,IAAI,CAAC;gBACH,IAAI,EAAE,CAAC;YACT,CAAC;YAAC,MAAM,CAAC;gBACP,0EAA0E;YAC5E,CAAC;QACH,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/cli/diagnostics.d.ts

@@ -0,0 +1,22 @@
+import type { FluxProjectInfo } from "./types";
+export type DiagnosticSection = "Environment" | "Packages" | "Project" | "Configuration" | "Pages" | "Registry";
+export type DiagnosticStatus = "pass" | "warning" | "fail";
+export interface FluxDiagnostic {
+    id: string;
+    section: DiagnosticSection;
+    status: DiagnosticStatus;
+    message: string;
+    blocksCheck?: boolean;
+    fix?: string;
+}
+export interface FluxValidationReport {
+    diagnostics: FluxDiagnostic[];
+    pages: string[];
+    valid: boolean;
+}
+export interface ValidationOptions {
+    nodeVersion?: string;
+}
+export declare function validateInitPrerequisites(project: FluxProjectInfo, options?: ValidationOptions): FluxDiagnostic[];
+export declare function validateFluxProject(project: FluxProjectInfo, options?: ValidationOptions): FluxValidationReport;
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/cli/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/cli/diagnostics.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAGV,eAAe,EAChB,MAAM,SAAS,CAAC;AAEjB,MAAM,MAAM,iBAAiB,GACzB,aAAa,GACb,UAAU,GACV,SAAS,GACT,eAAe,GACf,OAAO,GACP,UAAU,CAAC;AAEf,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AAE3D,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,iBAAiB,CAAC;IAC3B,MAAM,EAAE,gBAAgB,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAqDD,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,eAAe,EACxB,OAAO,GAAE,iBAAsB,GAC9B,cAAc,EAAE,CAyGlB;AA0CD,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,eAAe,EACxB,OAAO,GAAE,iBAAsB,GAC9B,oBAAoB,CA8LtB"}

package/dist/cli/diagnostics.js

@@ -0,0 +1,180 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateInitPrerequisites = validateInitPrerequisites;
+exports.validateFluxProject = validateFluxProject;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const generate_1 = require("../generate");
+const files_1 = require("./files");
+const next_config_1 = require("./next-config");
+function diagnostic(id, section, status, message, options = {}) {
+    return { id, section, status, message, ...options };
+}
+function packageVersion(pkg) {
+    return pkg.installedVersion ?? pkg.declaredVersion ?? "unknown";
+}
+function packageDiagnostic(id, label, pkg, supportedDescription, missingFix) {
+    if (!pkg.effectiveVersion) {
+        return diagnostic(id, "Packages", "fail", `${label} is not installed or declared.`, {
+            fix: missingFix,
+        });
+    }
+    if (pkg.compatibility === "unsupported") {
+        return diagnostic(id, "Packages", "fail", `Unsupported ${label} version: ${packageVersion(pkg)}. Expected ${supportedDescription}.`, { fix: missingFix });
+    }
+    if (pkg.compatibility === "unknown") {
+        return diagnostic(id, "Packages", "warning", `${label} version could not be verified: ${packageVersion(pkg)}.`);
+    }
+    return diagnostic(id, "Packages", "pass", `${label} ${packageVersion(pkg)}${pkg.compatibility === "probably-supported" ? " (declared range)" : ""}`);
+}
+function validateInitPrerequisites(project, options = {}) {
+    const diagnostics = [];
+    const nodeVersion = options.nodeVersion ?? process.versions.node;
+    const nodeMajor = Number(/^v?(\d+)/.exec(nodeVersion)?.[1]);
+    diagnostics.push(nodeMajor === 22 || nodeMajor === 24
+        ? diagnostic("environment.node", "Environment", "pass", `Node ${nodeVersion}`)
+        : diagnostic("environment.node", "Environment", "fail", `Unsupported Node version: ${nodeVersion}. Expected Node 22 or 24.`));
+    diagnostics.push(packageDiagnostic("package.next", "Next.js", project.packages.next, ">=16.3.0 <17.0.0", "npm install next@^16.3.0"), packageDiagnostic("package.react", "React", project.packages.react, ">=19.0.0", "npm install react@^19 react-dom@^19"), packageDiagnostic("package.react-dom", "React DOM", project.packages.reactDom, ">=19.0.0", "npm install react@^19 react-dom@^19"), packageDiagnostic("package.fluxfast-next", "@fluxfast/next", project.packages.fluxfastNext, "an installed FluxFast release", "npm install @fluxfast/next"), packageDiagnostic("package.fluxfast-core", "@fluxfast/core", project.packages.fluxfastCore, "the version installed by @fluxfast/next", "npm install @fluxfast/next"));
+    diagnostics.push(project.hasAppRouter
+        ? diagnostic("project.app-router", "Project", "pass", `App Router at ${node_path_1.default.relative(project.root, project.appDir)}`)
+        : diagnostic("project.app-router", "Project", "fail", project.pagesRouterDir
+            ? `FluxFast requires the Next.js App Router; Pages Router detected at ${node_path_1.default.relative(project.root, project.pagesRouterDir)}.`
+            : "App Router was not found; expected app/ or src/app/.", { fix: "Create a Next.js App Router project" }), diagnostic("project.layout", "Project", "pass", project.usesSrcDirectory ? "src/ layout" : "root layout"), diagnostic("project.language", "Project", "pass", project.language === "typescript" ? "TypeScript" : "JavaScript"));
+    if (project.nextConfigPaths.length > 1) {
+        diagnostics.push(diagnostic("config.next-duplicates", "Configuration", "fail", "Multiple next.config files were detected; keep only the active one."));
+    }
+    if (project.configPaths.length > 1) {
+        diagnostics.push(diagnostic("config.fluxfast-duplicates", "Configuration", "fail", "Multiple fluxfast.config files were detected; keep only the active one."));
+    }
+    return diagnostics;
+}
+function readFile(filePath) {
+    try {
+        return node_fs_1.default.readFileSync(filePath, "utf8");
+    }
+    catch {
+        return undefined;
+    }
+}
+function isBlocking(item) {
+    return item.status === "fail" || item.blocksCheck === true;
+}
+function findAppPageFiles(directory) {
+    if (!node_fs_1.default.existsSync(directory))
+        return [];
+    const pages = [];
+    const scan = (current) => {
+        for (const entry of node_fs_1.default.readdirSync(current, { withFileTypes: true })) {
+            const target = node_path_1.default.join(current, entry.name);
+            if (entry.isDirectory()) {
+                scan(target);
+            }
+            else if (entry.isFile() && /^page\.(?:tsx?|jsx?)$/.test(entry.name)) {
+                pages.push(target);
+            }
+        }
+    };
+    scan(directory);
+    return pages.sort();
+}
+function routeForAppPage(appDir, pageFile) {
+    const directory = node_path_1.default.relative(appDir, node_path_1.default.dirname(pageFile));
+    const segments = directory === "." ? [] : directory.split(node_path_1.default.sep);
+    const routeSegments = segments.filter(segment => !(segment.startsWith("(") && segment.endsWith(")")) &&
+        !segment.startsWith("@"));
+    return routeSegments.length > 0 ? `/${routeSegments.join("/")}` : "/";
+}
+function validateFluxProject(project, options = {}) {
+    const diagnostics = validateInitPrerequisites(project, options);
+    const configContent = readFile(project.configPath);
+    if (!configContent) {
+        diagnostics.push(diagnostic("config.fluxfast", "Configuration", "fail", "FluxFast config is missing.", { fix: "npx fluxfast init" }));
+    }
+    else if (!/\bexport\s+(?:const|let|var)\s+fluxConfig\b|\bexport\s*\{[^}]*\bfluxConfig\b[^}]*\}/s.test(configContent)) {
+        diagnostics.push(diagnostic("config.fluxfast", "Configuration", "fail", "FluxFast config does not export fluxConfig.", { fix: "Export a valid fluxConfig from the detected config file" }));
+    }
+    else {
+        diagnostics.push(diagnostic("config.fluxfast", "Configuration", "pass", `FluxFast config at ${node_path_1.default.relative(project.root, project.configPath)}`));
+    }
+    if (!project.nextConfigPath || !project.nextConfigFormat) {
+        diagnostics.push(diagnostic("config.next", "Configuration", "fail", "Next config is missing.", {
+            fix: "npx fluxfast init",
+        }));
+    }
+    else {
+        const nextContent = readFile(project.nextConfigPath);
+        const transformed = nextContent
+            ? (0, next_config_1.transformNextConfig)(nextContent, project.nextConfigFormat)
+            : undefined;
+        diagnostics.push(transformed?.status === "unchanged"
+            ? diagnostic("config.next", "Configuration", "pass", `${node_path_1.default.relative(project.root, project.nextConfigPath)} uses withFluxFast()`)
+            : diagnostic("config.next", "Configuration", "fail", "Next config does not use withFluxFast().", { fix: "npx fluxfast init" }));
+    }
+    const catchAllPath = (0, files_1.desiredCatchAllPath)(project);
+    const catchAllContent = readFile(catchAllPath);
+    diagnostics.push(catchAllContent && (0, files_1.isFluxCatchAll)(catchAllContent)
+        ? diagnostic("config.catch-all", "Configuration", "pass", `FluxFast catch-all at ${node_path_1.default.relative(project.root, catchAllPath)}`)
+        : diagnostic("config.catch-all", "Configuration", "fail", "FluxFast catch-all is missing or invalid.", {
+            fix: catchAllContent
+                ? "npx fluxfast init --force"
+                : "npx fluxfast init",
+        }));
+    if (project.rootPagePath) {
+        diagnostics.push(diagnostic("routes.shadowing-root", "Pages", "warning", `${node_path_1.default.relative(project.root, project.rootPagePath)} shadows FluxFast route "/".`, {
+            blocksCheck: true,
+            fix: `Move it into ${node_path_1.default.relative(project.root, project.fluxPagesDir)}/home/index and remove the Next route`,
+        }));
+    }
+    else {
+        diagnostics.push(diagnostic("routes.shadowing-root", "Pages", "pass", "No root route conflict"));
+    }
+    const catchAllPathForConflict = node_path_1.default.resolve((0, files_1.desiredCatchAllPath)(project));
+    for (const pageFile of findAppPageFiles(project.appDir)) {
+        if (node_path_1.default.resolve(pageFile) === catchAllPathForConflict ||
+            (project.rootPagePath && node_path_1.default.resolve(pageFile) === node_path_1.default.resolve(project.rootPagePath))) {
+            continue;
+        }
+        const route = routeForAppPage(project.appDir, pageFile);
+        diagnostics.push(diagnostic("routes.shadowing", "Pages", "warning", `${node_path_1.default.relative(project.root, pageFile)} shadows FluxFast route ${JSON.stringify(route)}.`, {
+            blocksCheck: true,
+            fix: `Move the component into ${node_path_1.default.relative(project.root, project.fluxPagesDir)} and remove the Next route`,
+        }));
+    }
+    let pages = [];
+    try {
+        const snapshot = (0, generate_1.createPagesRegistrySnapshot)({
+            pagesDir: project.fluxPagesDir,
+            outputFile: project.registryPath,
+            log: false,
+        });
+        pages = snapshot.identifiers;
+        diagnostics.push(diagnostic("pages.valid", "Pages", pages.length > 0 ? "pass" : "warning", `${pages.length} FluxFast page${pages.length === 1 ? "" : "s"} registered`));
+        const registryContent = readFile(project.registryPath);
+        if (registryContent === undefined) {
+            diagnostics.push(diagnostic("registry.current", "Registry", "fail", "Registry is missing.", {
+                fix: "npx fluxfast generate",
+            }));
+        }
+        else if (registryContent !== snapshot.content) {
+            diagnostics.push(diagnostic("registry.current", "Registry", "fail", "Registry appears stale.", { fix: "npx fluxfast generate" }));
+        }
+        else {
+            diagnostics.push(diagnostic("registry.current", "Registry", "pass", `Registry is up-to-date with ${pages.length} page${pages.length === 1 ? "" : "s"}`));
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        diagnostics.push(diagnostic("pages.valid", "Pages", "fail", message, {
+            fix: "Resolve duplicate or invalid files in flux-pages",
+        }));
+    }
+    return {
+        diagnostics,
+        pages,
+        valid: !diagnostics.some(isBlocking),
+    };
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/cli/diagnostics.js.map

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

package/dist/cli/files.d.ts

@@ -0,0 +1,14 @@
+import path from "node:path";
+import type { FluxProjectInfo } from "./types";
+export declare const FLUXFAST_GENERATED_MARKER = "// GENERATED BY FLUXFAST.";
+export declare function isFluxCatchAll(content: string): boolean;
+type RelativePathApi = Pick<typeof path, "dirname" | "relative">;
+/** Build a portable relative ESM specifier between two source files. */
+export declare function relativeImport(fromFile: string, toFile: string, pathApi?: RelativePathApi): string;
+export declare function desiredCatchAllPath(project: FluxProjectInfo): string;
+export declare function desiredHomePagePath(project: FluxProjectInfo): string;
+export declare function renderCatchAll(project: FluxProjectInfo): string;
+export declare function renderFluxConfig(project: FluxProjectInfo): string;
+export declare function renderStarterPage(): string;
+export {};
+//# sourceMappingURL=files.d.ts.map

package/dist/cli/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/cli/files.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,eAAO,MAAM,yBAAyB,8BAA8B,CAAC;AAErE,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAKvD;AAED,KAAK,eAAe,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,SAAS,GAAG,UAAU,CAAC,CAAC;AAMjE,wEAAwE;AACxE,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,eAAsB,GAC9B,MAAM,CAOR;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAQpE;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAGpE;AAiBD,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAG/D;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAEjE;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C"}

package/dist/cli/files.js

@@ -0,0 +1,60 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FLUXFAST_GENERATED_MARKER = void 0;
+exports.isFluxCatchAll = isFluxCatchAll;
+exports.relativeImport = relativeImport;
+exports.desiredCatchAllPath = desiredCatchAllPath;
+exports.desiredHomePagePath = desiredHomePagePath;
+exports.renderCatchAll = renderCatchAll;
+exports.renderFluxConfig = renderFluxConfig;
+exports.renderStarterPage = renderStarterPage;
+const node_path_1 = __importDefault(require("node:path"));
+exports.FLUXFAST_GENERATED_MARKER = "// GENERATED BY FLUXFAST.";
+function isFluxCatchAll(content) {
+    return (/\bcreateFluxNextPage\s*\(/.test(content) &&
+        /\bfluxConfig\b/.test(content));
+}
+function withoutSourceExtension(filePath) {
+    return filePath.replace(/\.(?:tsx?|jsx?)$/, "");
+}
+/** Build a portable relative ESM specifier between two source files. */
+function relativeImport(fromFile, toFile, pathApi = node_path_1.default) {
+    const relative = pathApi
+        .relative(pathApi.dirname(fromFile), withoutSourceExtension(toFile))
+        .replace(/\\/g, "/");
+    return relative.startsWith("./") || relative.startsWith("../")
+        ? relative
+        : `./${relative}`;
+}
+function desiredCatchAllPath(project) {
+    const extension = project.language === "typescript" ? "tsx" : "jsx";
+    return node_path_1.default.join(project.appDir, "(flux)", "[[...flux]]", `page.${extension}`);
+}
+function desiredHomePagePath(project) {
+    const extension = project.language === "typescript" ? "tsx" : "jsx";
+    return node_path_1.default.join(project.fluxPagesDir, "home", `index.${extension}`);
+}
+function configImportForCatchAll(project, catchAllPath) {
+    return project.usesAtAlias
+        ? "@/fluxfast.config"
+        : relativeImport(catchAllPath, project.configPath);
+}
+function registryImportForConfig(project) {
+    return project.usesAtAlias
+        ? "@/.fluxfast/pages.generated"
+        : relativeImport(project.configPath, project.registryPath);
+}
+function renderCatchAll(project) {
+    const catchAllPath = desiredCatchAllPath(project);
+    return `${exports.FLUXFAST_GENERATED_MARKER}\n// Run \`fluxfast init --force\` to repair this file.\n\nimport { createFluxNextPage } from "@fluxfast/next/server";\nimport { fluxConfig } from ${JSON.stringify(configImportForCatchAll(project, catchAllPath))};\n\nexport const dynamic = "force-dynamic";\n\nexport default createFluxNextPage(fluxConfig);\n`;
+}
+function renderFluxConfig(project) {
+    return `import { defineFluxConfig } from "@fluxfast/next";\nimport { FluxApplication } from ${JSON.stringify(registryImportForConfig(project))};\n\nexport const fluxConfig = defineFluxConfig({\n  application: FluxApplication,\n});\n`;
+}
+function renderStarterPage() {
+    return `"use client";\n\nexport default function HomePage() {\n  return (\n    <main>\n      <h1>FluxFast</h1>\n      <p>Your FluxFast frontend is ready.</p>\n    </main>\n  );\n}\n`;
+}
+//# sourceMappingURL=files.js.map

package/dist/cli/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../src/cli/files.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAAA,0DAA6B;AAGhB,QAAA,yBAAyB,GAAG,2BAA2B,CAAC;AAErE,wBAA+B,OAAe;IAC5C,OAAO,CACL,2BAA2B,CAAC,IAAI,CAAC,OAAO,CAAC;QACzC,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAC/B,CAAC;AACJ,CAAC;AAID,SAAS,sBAAsB,CAAC,QAAgB;IAC9C,OAAO,QAAQ,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC;AAClD,CAAC;AAED,wEAAwE;AACxE,wBACE,QAAgB,EAChB,MAAc,EACd,OAAO,GAAoB,mBAAI;IAE/B,MAAM,QAAQ,GAAG,OAAO;SACrB,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;SACnE,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACvB,OAAO,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC;QAC5D,CAAC,CAAC,QAAQ;QACV,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;AACtB,CAAC;AAED,6BAAoC,OAAwB;IAC1D,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;IACpE,OAAO,mBAAI,CAAC,IAAI,CACd,OAAO,CAAC,MAAM,EACd,QAAQ,EACR,aAAa,EACb,QAAQ,SAAS,EAAE,CACpB,CAAC;AACJ,CAAC;AAED,6BAAoC,OAAwB;IAC1D,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;IACpE,OAAO,mBAAI,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,uBAAuB,CAC9B,OAAwB,EACxB,YAAoB;IAEpB,OAAO,OAAO,CAAC,WAAW;QACxB,CAAC,CAAC,mBAAmB;QACrB,CAAC,CAAC,cAAc,CAAC,YAAY,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;AACvD,CAAC;AAED,SAAS,uBAAuB,CAAC,OAAwB;IACvD,OAAO,OAAO,CAAC,WAAW;QACxB,CAAC,CAAC,6BAA6B;QAC/B,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;AAC/D,CAAC;AAED,wBAA+B,OAAwB;IACrD,MAAM,YAAY,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAClD,OAAO,GAAG,QAAA,yBAAyB,sJAAsJ,IAAI,CAAC,SAAS,CAAC,uBAAuB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,kGAAkG,CAAC;AAC5V,CAAC;AAED,0BAAiC,OAAwB;IACvD,OAAO,uFAAuF,IAAI,CAAC,SAAS,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC,2FAA2F,CAAC;AAC5O,CAAC;AAED;IACE,OAAO,+KAA+K,CAAC;AACzL,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,7 @@
+export interface CliIo {
+    cwd: string;
+    stdout: (message: string) => void;
+    stderr: (message: string) => void;
+}
+export declare function runCli(args: string[], io?: CliIo): number;
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,KAAK;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AA4OD,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,GAAE,KAAiB,GAAG,MAAM,CAuBpE"}