@obh/forge 0.2.0

package/dist/project/plan.js

@@ -0,0 +1,251 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Plan = void 0;
+const node_path_1 = __importDefault(require("node:path"));
+const fs_1 = require("../utils/fs");
+const logger_1 = require("../utils/logger");
+const manifest_1 = require("./manifest");
+/**
+ * A Plan accumulates every change a command wants to make, then applies them in
+ * one pass. This is what gives every Forge command uniform dry-run, idempotency,
+ * and safety (see spec §21). Commands never touch the filesystem directly.
+ */
+class Plan {
+    fileOps = [];
+    deps = [];
+    envVars = [];
+    scripts = [];
+    manifestPatch = {};
+    nextSteps = [];
+    /** Create a file only if it does not already exist. */
+    create(p, content, describe) {
+        this.fileOps.push({ kind: "create", path: p, content, describe });
+        return this;
+    }
+    /** Replace a file's contents (needs --force / confirmation if it differs). */
+    overwrite(p, content, describe) {
+        this.fileOps.push({ kind: "overwrite", path: p, content, describe });
+        return this;
+    }
+    /** Insert a clearly-marked, idempotent section into a file (creating it if absent). */
+    append(p, marker, section, describe) {
+        this.fileOps.push({ kind: "append", path: p, marker, section, describe });
+        return this;
+    }
+    addDependency(target, name, version, dev = false) {
+        this.deps.push({ target, name, version, dev });
+        return this;
+    }
+    addEnvVar(v) {
+        this.envVars.push(v);
+        return this;
+    }
+    addScript(name, command) {
+        this.scripts.push({ name, command });
+        return this;
+    }
+    patchManifest(patch) {
+        this.manifestPatch = deepMerge(this.manifestPatch, patch);
+        return this;
+    }
+    nextStep(msg) {
+        this.nextSteps.push(msg);
+        return this;
+    }
+    isEmpty() {
+        return (this.fileOps.length === 0 &&
+            this.deps.length === 0 &&
+            this.envVars.length === 0 &&
+            this.scripts.length === 0 &&
+            Object.keys(this.manifestPatch).length === 0);
+    }
+    /** Human-readable preview of everything this plan would do. */
+    async render(root) {
+        const lines = [];
+        for (const op of this.fileOps) {
+            const status = await this.classify(root, op);
+            lines.push(`  ${labelFor(status)}  ${op.path}  — ${op.describe}`);
+        }
+        for (const d of this.deps) {
+            lines.push(`  dep      ${d.name}@${d.version}${d.dev ? " (dev)" : ""} → ${d.target}/package.json`);
+        }
+        for (const v of this.envVars) {
+            lines.push(`  env      ${v.name}${v.secret ? " (secret)" : ""} → .env.example`);
+        }
+        for (const s of this.scripts) {
+            lines.push(`  script   ${s.name} → package.json`);
+        }
+        if (Object.keys(this.manifestPatch).length > 0) {
+            lines.push(`  manifest updates → forge.json`);
+        }
+        return lines.join("\n");
+    }
+    /** Apply the plan. Returns whether anything was written. */
+    async apply(root, opts) {
+        const applied = [];
+        // 1. Detect conflicts up front so a dry-run/real run reports them cleanly.
+        for (const op of this.fileOps) {
+            const result = await this.classify(root, op);
+            if (result === "conflict" && !opts.force) {
+                logger_1.log.error(`refusing to overwrite ${op.path} (differs from generated output). Re-run with --force to replace it.`);
+                return false;
+            }
+            applied.push({ op, result });
+        }
+        if (opts.dryRun)
+            return false;
+        // 2. Files first (they create the package.json files that deps/scripts patch).
+        for (const { op, result } of applied) {
+            if (result === "skipped")
+                continue;
+            const target = node_path_1.default.join(root, op.path);
+            if (op.kind === "append") {
+                await this.applyAppend(target, op);
+            }
+            else {
+                await (0, fs_1.writeFile)(target, op.content ?? "");
+            }
+        }
+        // 3. Dependencies, grouped by target package.json.
+        await this.applyDeps(root);
+        // 4. Root scripts.
+        await this.applyScripts(root);
+        // 5. Env example.
+        await this.applyEnv(root);
+        // 6. forge.json manifest.
+        if (Object.keys(this.manifestPatch).length > 0) {
+            const existing = await (0, manifest_1.loadManifest)(root);
+            if (existing) {
+                await (0, manifest_1.saveManifest)(root, (0, manifest_1.mergeManifest)(existing, this.manifestPatch));
+            }
+        }
+        // 7. Report.
+        for (const { op, result } of applied) {
+            if (result === "created")
+                logger_1.log.success(`created ${op.path}`);
+            else if (result === "appended")
+                logger_1.log.success(`updated ${op.path}`);
+            else if (result === "overwritten" || result === "conflict")
+                logger_1.log.success(`overwrote ${op.path}`);
+            else
+                logger_1.log.dim(`  skipped ${op.path} (already present)`);
+        }
+        if (this.nextSteps.length > 0) {
+            logger_1.log.plain("");
+            logger_1.log.info("Next steps:");
+            for (const s of this.nextSteps)
+                logger_1.log.plain("    " + s);
+        }
+        return true;
+    }
+    async classify(root, op) {
+        const target = node_path_1.default.join(root, op.path);
+        const current = await (0, fs_1.readFileSafe)(target);
+        if (op.kind === "append") {
+            if (current !== undefined && op.marker && current.includes(op.marker))
+                return "skipped";
+            return current === undefined ? "created" : "appended";
+        }
+        if (current === undefined)
+            return "created";
+        if (current === op.content)
+            return "skipped";
+        return op.kind === "overwrite" ? "overwritten" : "conflict";
+    }
+    async applyAppend(target, op) {
+        const current = (await (0, fs_1.readFileSafe)(target)) ?? "";
+        if (op.marker && current.includes(op.marker))
+            return;
+        const prefix = current.length > 0 && !current.endsWith("\n") ? "\n" : "";
+        const block = `${prefix}${current.length > 0 ? "\n" : ""}${op.marker ?? ""}\n${op.section ?? ""}\n`;
+        await (0, fs_1.writeFile)(target, current + block);
+    }
+    async applyDeps(root) {
+        const byTarget = new Map();
+        for (const d of this.deps) {
+            const list = byTarget.get(d.target) ?? [];
+            list.push(d);
+            byTarget.set(d.target, list);
+        }
+        for (const [targetDir, list] of byTarget) {
+            const pkgPath = node_path_1.default.join(root, targetDir, "package.json");
+            const pkg = (await (0, fs_1.readJson)(pkgPath)) ?? {};
+            for (const d of list) {
+                const key = d.dev ? "devDependencies" : "dependencies";
+                pkg[key] = pkg[key] ?? {};
+                if (!pkg[key][d.name])
+                    pkg[key][d.name] = d.version;
+                pkg[key] = sortObject(pkg[key]);
+            }
+            if (await (0, fs_1.exists)(node_path_1.default.dirname(pkgPath)))
+                await (0, fs_1.writeJson)(pkgPath, pkg);
+        }
+    }
+    async applyScripts(root) {
+        if (this.scripts.length === 0)
+            return;
+        const pkgPath = node_path_1.default.join(root, "package.json");
+        const pkg = (await (0, fs_1.readJson)(pkgPath)) ?? {};
+        pkg.scripts = pkg.scripts ?? {};
+        for (const s of this.scripts) {
+            if (!pkg.scripts[s.name])
+                pkg.scripts[s.name] = s.command;
+        }
+        await (0, fs_1.writeJson)(pkgPath, pkg);
+    }
+    async applyEnv(root) {
+        if (this.envVars.length === 0)
+            return;
+        const envPath = node_path_1.default.join(root, ".env.example");
+        let current = (await (0, fs_1.readFileSafe)(envPath)) ?? "";
+        const additions = [];
+        for (const v of this.envVars) {
+            const hasLine = new RegExp(`^${escapeRegExp(v.name)}=`, "m").test(current);
+            if (hasLine)
+                continue;
+            if (v.comment)
+                additions.push(`# ${v.comment}`);
+            additions.push(`${v.name}=${v.example}`);
+        }
+        if (additions.length === 0)
+            return;
+        const prefix = current.length > 0 && !current.endsWith("\n") ? "\n" : "";
+        await (0, fs_1.writeFile)(envPath, current + prefix + additions.join("\n") + "\n");
+    }
+}
+exports.Plan = Plan;
+function labelFor(r) {
+    switch (r) {
+        case "created":
+            return "create ";
+        case "appended":
+            return "update ";
+        case "overwritten":
+            return "replace";
+        case "conflict":
+            return "CONFLICT";
+        default:
+            return "skip   ";
+    }
+}
+function sortObject(obj) {
+    return Object.fromEntries(Object.entries(obj).sort(([a], [b]) => a.localeCompare(b)));
+}
+function escapeRegExp(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function deepMerge(a, b) {
+    if (b === undefined)
+        return a;
+    if (typeof a !== "object" || a === null || Array.isArray(a))
+        return b;
+    const out = { ...a };
+    for (const [k, v] of Object.entries(b)) {
+        out[k] = k in a ? deepMerge(a[k], v) : v;
+    }
+    return out;
+}
+//# sourceMappingURL=plan.js.map

package/dist/project/plan.js.map

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

package/dist/prompts/index.d.ts

@@ -0,0 +1,24 @@
+import type { ApiFramework, CapabilityName, ExampleDomain, RecipeName, Topology } from "../types";
+export interface NewAnswers {
+    name: string;
+    scope: string;
+    recipe: RecipeName;
+    topology: Topology;
+    apiFramework: ApiFramework;
+    example: ExampleDomain;
+    sdk: boolean;
+    /** Mobile app directory name, or null for none. */
+    mobile: string | null;
+    primitives: CapabilityName[];
+}
+/** Interactive questions for `forge new app`. Only asks where shape truly varies. */
+export declare function askNew(defaults: Partial<NewAnswers> & {
+    sdk?: boolean;
+}): Promise<NewAnswers>;
+/** Ask for a GitHub owner/repo when git detection fails. Empty string = skip. */
+export declare function askRepo(suggested: string): Promise<string>;
+/** Confirm applying a plan when not running with --yes. */
+export declare function confirmApply(): Promise<boolean>;
+/** Yes/no prompt (e.g. adding a missing prerequisite). */
+export declare function confirm(message: string): Promise<boolean>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAGjG,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,UAAU,CAAA;IAClB,QAAQ,EAAE,QAAQ,CAAA;IAClB,YAAY,EAAE,YAAY,CAAA;IAC1B,OAAO,EAAE,aAAa,CAAA;IACtB,GAAG,EAAE,OAAO,CAAA;IACZ,mDAAmD;IACnD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,UAAU,EAAE,cAAc,EAAE,CAAA;CAC7B;AAUD,qFAAqF;AACrF,wBAAsB,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG;IAAE,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CA4EnG;AAED,iFAAiF;AACjF,wBAAsB,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAWhE;AAED,2DAA2D;AAC3D,wBAAsB,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC,CAGrD;AAED,0DAA0D;AAC1D,wBAAsB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAG/D"}

package/dist/prompts/index.js

@@ -0,0 +1,111 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.askNew = askNew;
+exports.askRepo = askRepo;
+exports.confirmApply = confirmApply;
+exports.confirm = confirm;
+const prompts_1 = __importDefault(require("prompts"));
+const capabilities_1 = require("../capabilities");
+function onCancel() {
+    console.log("Cancelled.");
+    process.exit(1);
+}
+const primitiveChoices = () => Object.keys(capabilities_1.CAPABILITIES).map((p) => ({ title: `${p} — ${capabilities_1.CAPABILITIES[p]?.describe ?? ""}`, value: p }));
+/** Interactive questions for `forge new app`. Only asks where shape truly varies. */
+async function askNew(defaults) {
+    const res = await (0, prompts_1.default)([
+        {
+            type: defaults.name ? null : "text",
+            name: "name",
+            message: "Project name",
+            validate: (v) => (/^[a-z][a-z0-9-]*$/.test(v) ? true : "lowercase letters, digits, dashes"),
+        },
+        {
+            type: defaults.recipe ? null : "select",
+            name: "recipe",
+            message: "Recipe",
+            choices: [
+                { title: "full-saas — api + admin + worker + sdk + core primitives", value: "full-saas" },
+                { title: "api-web-worker — api + admin + worker + sdk", value: "api-web-worker" },
+                { title: "api-only — backend + sdk", value: "api-only" },
+                { title: "worker — background worker only", value: "worker" },
+            ],
+            initial: 0,
+        },
+        {
+            type: defaults.apiFramework ? null : "select",
+            name: "apiFramework",
+            message: "API framework",
+            choices: [
+                { title: "hono — light, modern (recommended for greenfield)", value: "hono" },
+                { title: "express — familiar, best for retrofits", value: "express" },
+            ],
+            initial: 0,
+        },
+        {
+            type: defaults.example !== undefined ? null : "confirm",
+            name: "exampleOn",
+            message: "Include a real example domain (notes: CRUD wired end-to-end)?",
+            initial: true,
+        },
+        {
+            type: defaults.mobile !== undefined ? null : "confirm",
+            name: "mobileOn",
+            message: "Include a mobile app (Expo)?",
+            initial: false,
+        },
+        {
+            type: defaults.topology ? null : "select",
+            name: "topology",
+            message: "Deployment topology",
+            choices: [
+                { title: "small — API co-locates Postgres (simplest)", value: "small" },
+                { title: "split — separate api / worker / db apps (scales)", value: "split" },
+            ],
+            initial: 0,
+        },
+        {
+            type: "multiselect",
+            name: "primitives",
+            message: "Platform primitives to install now (space to toggle, prerequisites auto-added)",
+            choices: primitiveChoices(),
+            hint: "- all opt-in",
+        },
+    ], { onCancel });
+    const name = defaults.name ?? res.name;
+    return {
+        name,
+        scope: defaults.scope ?? `@${name}`,
+        recipe: (defaults.recipe ?? res.recipe),
+        topology: (defaults.topology ?? res.topology),
+        apiFramework: (defaults.apiFramework ?? res.apiFramework),
+        example: defaults.example !== undefined ? defaults.example : res.exampleOn ? "notes" : null,
+        sdk: defaults.sdk ?? true,
+        mobile: defaults.mobile !== undefined ? defaults.mobile : res.mobileOn ? "mobile" : null,
+        primitives: (res.primitives ?? []).filter(capabilities_1.isImplemented),
+    };
+}
+/** Ask for a GitHub owner/repo when git detection fails. Empty string = skip. */
+async function askRepo(suggested) {
+    const res = await (0, prompts_1.default)({
+        type: "text",
+        name: "repo",
+        message: "GitHub owner/repo for deploy manifests (blank to fill in later)",
+        initial: suggested,
+    }, { onCancel });
+    return res.repo?.trim() ?? "";
+}
+/** Confirm applying a plan when not running with --yes. */
+async function confirmApply() {
+    const res = await (0, prompts_1.default)({ type: "confirm", name: "ok", message: "Apply these changes?", initial: true }, { onCancel });
+    return res.ok === true;
+}
+/** Yes/no prompt (e.g. adding a missing prerequisite). */
+async function confirm(message) {
+    const res = await (0, prompts_1.default)({ type: "confirm", name: "ok", message, initial: true }, { onCancel });
+    return res.ok === true;
+}
+//# sourceMappingURL=index.js.map

package/dist/prompts/index.js.map

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

package/dist/recipes/index.d.ts

@@ -0,0 +1,25 @@
+import type { ApiFramework, AppRecord, CapabilityName, ExampleDomain, PackageRecord, RecipeName, Topology } from "../types";
+import type { Plan } from "../project/plan";
+export interface RecipeInput {
+    name: string;
+    scope: string;
+    topology: Topology;
+    apiFramework: ApiFramework;
+    example: ExampleDomain;
+    sdk: boolean;
+}
+export interface RecipeShape {
+    apps: AppRecord[];
+    packages: PackageRecord[];
+    /** Primitives the recipe installs automatically (still opt-out-able). */
+    autoPrimitives: CapabilityName[];
+}
+export interface Recipe {
+    name: RecipeName;
+    describe: string;
+    shape(input: RecipeInput): RecipeShape;
+    generate(plan: Plan, input: RecipeInput, shape: RecipeShape): void;
+}
+export declare const RECIPES: Record<RecipeName, Recipe>;
+export declare function getRecipe(name: RecipeName): Recipe;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/recipes/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAC3H,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAO3C,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,QAAQ,CAAA;IAClB,YAAY,EAAE,YAAY,CAAA;IAC1B,OAAO,EAAE,aAAa,CAAA;IACtB,GAAG,EAAE,OAAO,CAAA;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,SAAS,EAAE,CAAA;IACjB,QAAQ,EAAE,aAAa,EAAE,CAAA;IACzB,yEAAyE;IACzE,cAAc,EAAE,cAAc,EAAE,CAAA;CACjC;AAED,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,UAAU,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAAA;IACtC,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAAA;CACnE;AAyBD,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAqC9C,CAAA;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAIlD"}

package/dist/recipes/index.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RECIPES = void 0;
+exports.getRecipe = getRecipe;
+const root_1 = require("../generators/root");
+const api_1 = require("../generators/api");
+const web_1 = require("../generators/web");
+const worker_1 = require("../generators/worker");
+const sdk_1 = require("../generators/sdk");
+const workerApp = { name: "worker", path: "apps/worker", role: "worker" };
+const sdkPkg = { name: "sdk", path: "packages/sdk" };
+function apiApp(input) {
+    return { name: "api", path: "apps/api", framework: input.apiFramework, role: "api" };
+}
+const adminApp = { name: "admin", path: "apps/admin", framework: "vite-react", role: "web" };
+function generateApps(plan, input, shape) {
+    (0, root_1.addProjectSkeleton)(plan, { name: input.name, topology: input.topology });
+    for (const app of shape.apps) {
+        if (app.role === "api")
+            (0, api_1.addApiApp)(plan, { scope: input.scope, framework: input.apiFramework, example: input.example });
+        else if (app.role === "web")
+            (0, web_1.addWebApp)(plan, { scope: input.scope, name: app.name, example: input.example });
+        else if (app.role === "worker")
+            (0, worker_1.addWorkerApp)(plan, { scope: input.scope });
+    }
+    if (shape.packages.some((p) => p.name === "sdk"))
+        (0, sdk_1.addSdkPackage)(plan, { scope: input.scope, example: input.example });
+}
+/** Drop the SDK package from a shape when the project opts out of it. */
+function withSdk(input, packages) {
+    return input.sdk ? packages : packages.filter((p) => p.name !== "sdk");
+}
+exports.RECIPES = {
+    "api-web-worker": {
+        name: "api-web-worker",
+        describe: "API + admin frontend + worker + shared SDK",
+        shape: (input) => ({ apps: [apiApp(input), adminApp, workerApp], packages: withSdk(input, [sdkPkg]), autoPrimitives: [] }),
+        generate: generateApps,
+    },
+    "full-saas": {
+        name: "full-saas",
+        describe: "api-web-worker plus recommended primitives (events, jobs, files, audit)",
+        shape: (input) => ({
+            apps: [apiApp(input), adminApp, workerApp],
+            packages: withSdk(input, [sdkPkg]),
+            autoPrimitives: ["events", "jobs", "files", "audit"],
+        }),
+        generate: generateApps,
+    },
+    "api-only": {
+        name: "api-only",
+        describe: "Backend API + shared SDK",
+        shape: (input) => ({ apps: [apiApp(input)], packages: withSdk(input, [sdkPkg]), autoPrimitives: [] }),
+        generate: generateApps,
+    },
+    worker: {
+        name: "worker",
+        describe: "Background worker only",
+        shape: () => ({ apps: [workerApp], packages: [], autoPrimitives: [] }),
+        generate: generateApps,
+    },
+    "platform-package": {
+        name: "platform-package",
+        describe: "OBH primitive-style package — use `forge new package <name>`",
+        shape: () => ({ apps: [], packages: [], autoPrimitives: [] }),
+        generate: () => {
+            throw new Error("Platform packages are scaffolded with `forge new package <name>`, not a recipe.");
+        },
+    },
+};
+function getRecipe(name) {
+    const r = exports.RECIPES[name];
+    if (!r)
+        throw new Error(`Unknown recipe: ${name}`);
+    return r;
+}
+//# sourceMappingURL=index.js.map

package/dist/recipes/index.js.map

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

package/dist/stack/infer.d.ts

@@ -0,0 +1,4 @@
+import type { StackManifest } from "./types";
+/** Inspect deploy/*.lwd.toml (+ forge.json) and propose a stack manifest. */
+export declare function inferStack(root: string): Promise<StackManifest>;
+//# sourceMappingURL=infer.d.ts.map

package/dist/stack/infer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"infer.d.ts","sourceRoot":"","sources":["../../src/stack/infer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAuD,aAAa,EAAE,MAAM,SAAS,CAAA;AA2BjG,6EAA6E;AAC7E,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAyGrE"}