@lionden/core 0.1.0

package/dist/leo-preflight.js

@@ -0,0 +1,93 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+const LEO_VERSION_RE = /\b(\d+)\.(\d+)\.(\d+)(?![-+.\w])/;
+const CONFIG_VERSION_RE = /^(\d+)\.(\d+)\.(\d+)$/;
+const memoizedPreflights = new Map();
+export function parseLeoVersionOutput(output) {
+    const match = LEO_VERSION_RE.exec(output);
+    if (!match)
+        return null;
+    return {
+        major: Number(match[1]),
+        minor: Number(match[2]),
+        patch: Number(match[3]),
+        text: `${match[1]}.${match[2]}.${match[3]}`,
+    };
+}
+export async function preflightLeo(config) {
+    const expected = parseConfigLeoVersion(config.leoVersion);
+    const expectedLine = expected ? `${expected.major}.${expected.minor}` : config.leoVersion;
+    const skip = config.skipLeoVersionCheck;
+    const key = `${config.leoBinary}\0${expectedLine}\0${skip ? "skip" : "check"}`;
+    const memoized = memoizedPreflights.get(key);
+    if (memoized)
+        return memoized;
+    const promise = runLeoPreflight(config, expected);
+    memoizedPreflights.set(key, promise);
+    return promise;
+}
+export function clearLeoPreflightMemoForTests() {
+    memoizedPreflights.clear();
+}
+async function runLeoPreflight(config, expected) {
+    const binary = config.leoBinary;
+    let stdout = "";
+    let stderr = "";
+    try {
+        const result = await execFileAsync(binary, ["--disable-update-check", "--version"], {
+            timeout: 30_000,
+        });
+        stdout = String(result.stdout);
+        stderr = String(result.stderr);
+    }
+    catch (err) {
+        const e = err;
+        const output = formatVersionOutput(e.stdout, e.stderr);
+        const reason = [e.code ? `code ${String(e.code)}` : "", e.message ?? "unknown error"]
+            .filter(Boolean)
+            .join(": ");
+        throw new Error(`Leo preflight failed for "${binary}": unable to execute ` +
+            `"${binary} --disable-update-check --version" (${reason}).` +
+            (output ? `\nOutput:\n${output}` : ""));
+    }
+    if (config.skipLeoVersionCheck)
+        return;
+    if (!expected) {
+        throw new Error(`Leo preflight failed for "${binary}": configured leoVersion ` +
+            `"${config.leoVersion}" is not a stable major.minor.patch version.`);
+    }
+    const output = `${stdout}\n${stderr}`;
+    const actual = parseLeoVersionOutput(output);
+    if (!actual) {
+        const formattedOutput = formatVersionOutput(stdout, stderr);
+        throw new Error(`Leo preflight failed for "${binary}": could not parse a stable ` +
+            `major.minor.patch version from "${binary} --disable-update-check --version".` +
+            (formattedOutput ? `\nOutput:\n${formattedOutput}` : ""));
+    }
+    if (actual.major !== expected.major || actual.minor !== expected.minor) {
+        throw new Error(`Leo preflight failed for "${binary}": leoBinary reports ${actual.text}, ` +
+            `but leoVersion "${config.leoVersion}" requires ${expected.major}.${expected.minor}.x. ` +
+            `Set leoBinary to a compatible Leo CLI or set skipLeoVersionCheck: true.`);
+    }
+}
+function parseConfigLeoVersion(version) {
+    const match = CONFIG_VERSION_RE.exec(version);
+    if (!match)
+        return null;
+    return {
+        major: Number(match[1]),
+        minor: Number(match[2]),
+        patch: Number(match[3]),
+        text: version,
+    };
+}
+function formatVersionOutput(stdout, stderr) {
+    const output = [stdout, stderr]
+        .map((value) => (value === undefined ? "" : String(value).trim()))
+        .filter(Boolean)
+        .join("\n")
+        .trim();
+    return output.slice(0, 1_000);
+}
+//# sourceMappingURL=leo-preflight.js.map

package/dist/leo-preflight.js.map

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

package/dist/log-style.d.ts

@@ -0,0 +1,22 @@
+declare const LOG_COLOR_CODES: {
+    readonly cyan: "\u001B[36m";
+    readonly dim: "\u001B[2m";
+    readonly green: "\u001B[32m";
+    readonly red: "\u001B[31m";
+    readonly yellow: "\u001B[33m";
+};
+type LogColor = keyof typeof LOG_COLOR_CODES;
+export type LogStyleRole = "action" | "success" | "warning" | "error" | "metadata" | "divider";
+export declare function shouldColorLogs(): boolean;
+export declare function shouldRenderDivider(): boolean;
+export declare function colorLogText(text: string, color: LogColor): string;
+export declare function styleLogRole(text: string, role: LogStyleRole): string;
+export declare function logAction(text: string): string;
+export declare function logSuccess(text: string): string;
+export declare function logWarning(text: string): string;
+export declare function logError(text: string): string;
+export declare function logMetadata(text: string): string;
+export declare function logDivider(text?: string): string;
+export declare function pluralize(word: string, count: number): string;
+export {};
+//# sourceMappingURL=log-style.d.ts.map

package/dist/log-style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-style.d.ts","sourceRoot":"","sources":["../src/log-style.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,eAAe;;;;;;CAMX,CAAC;AAIX,KAAK,QAAQ,GAAG,MAAM,OAAO,eAAe,CAAC;AAC7C,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;AAe/F,wBAAgB,eAAe,IAAI,OAAO,CAKzC;AAED,wBAAgB,mBAAmB,IAAI,OAAO,CAE7C;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,MAAM,CAGlE;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM,CAcrE;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wBAAgB,UAAU,CAAC,IAAI,SAA6C,GAAG,MAAM,CAEpF;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7D"}

package/dist/log-style.js

@@ -0,0 +1,67 @@
+const LOG_COLOR_CODES = {
+    cyan: "\x1b[36m",
+    dim: "\x1b[2m",
+    green: "\x1b[32m",
+    red: "\x1b[31m",
+    yellow: "\x1b[33m",
+};
+const LOG_COLOR_RESET = "\x1b[0m";
+function logProcess() {
+    return globalThis.process;
+}
+function logEnv(name) {
+    return logProcess()?.env?.[name];
+}
+export function shouldColorLogs() {
+    if (logEnv("NO_COLOR") !== undefined)
+        return false;
+    const forceColor = logEnv("FORCE_COLOR");
+    if (forceColor !== undefined && forceColor !== "0")
+        return true;
+    return logProcess()?.stdout?.isTTY === true;
+}
+export function shouldRenderDivider() {
+    return !logEnv("VITEST") && !logEnv("LIONDEN_MANAGED_TEST");
+}
+export function colorLogText(text, color) {
+    if (!shouldColorLogs())
+        return text;
+    return LOG_COLOR_CODES[color] + text + LOG_COLOR_RESET;
+}
+export function styleLogRole(text, role) {
+    switch (role) {
+        case "action":
+            return colorLogText(text, "cyan");
+        case "success":
+            return colorLogText(text, "green");
+        case "warning":
+            return colorLogText(text, "yellow");
+        case "error":
+            return colorLogText(text, "red");
+        case "metadata":
+        case "divider":
+            return colorLogText(text, "dim");
+    }
+}
+export function logAction(text) {
+    return styleLogRole(text, "action");
+}
+export function logSuccess(text) {
+    return styleLogRole(text, "success");
+}
+export function logWarning(text) {
+    return styleLogRole(text, "warning");
+}
+export function logError(text) {
+    return styleLogRole(text, "error");
+}
+export function logMetadata(text) {
+    return styleLogRole(text, "metadata");
+}
+export function logDivider(text = "----------------------------------------") {
+    return styleLogRole(text, "divider");
+}
+export function pluralize(word, count) {
+    return count === 1 ? word : word + "s";
+}
+//# sourceMappingURL=log-style.js.map

package/dist/log-style.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-style.js","sourceRoot":"","sources":["../src/log-style.ts"],"names":[],"mappings":"AAAA,MAAM,eAAe,GAAG;IACtB,IAAI,EAAE,UAAU;IAChB,GAAG,EAAE,SAAS;IACd,KAAK,EAAE,UAAU;IACjB,GAAG,EAAE,UAAU;IACf,MAAM,EAAE,UAAU;CACV,CAAC;AAEX,MAAM,eAAe,GAAG,SAAS,CAAC;AAUlC,SAAS,UAAU;IACjB,OAAQ,UAAwE,CAAC,OAAO,CAAC;AAC3F,CAAC;AAED,SAAS,MAAM,CAAC,IAAY;IAC1B,OAAO,UAAU,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,IAAI,MAAM,CAAC,UAAU,CAAC,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACnD,MAAM,UAAU,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;IACzC,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IAChE,OAAO,UAAU,EAAE,EAAE,MAAM,EAAE,KAAK,KAAK,IAAI,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,KAAe;IACxD,IAAI,CAAC,eAAe,EAAE;QAAE,OAAO,IAAI,CAAC;IACpC,OAAO,eAAe,CAAC,KAAK,CAAC,GAAG,IAAI,GAAG,eAAe,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,IAAkB;IAC3D,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,QAAQ;YACX,OAAO,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACpC,KAAK,SAAS;YACZ,OAAO,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACrC,KAAK,SAAS;YACZ,OAAO,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACtC,KAAK,OAAO;YACV,OAAO,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACnC,KAAK,UAAU,CAAC;QAChB,KAAK,SAAS;YACZ,OAAO,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACrC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,YAAY,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,YAAY,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,YAAY,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAI,GAAG,0CAA0C;IAC1E,OAAO,YAAY,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,KAAa;IACnD,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC;AACzC,CAAC"}

package/dist/lre.d.ts

@@ -0,0 +1,14 @@
+import type { LionDenResolvedConfig } from "@lionden/config";
+import type { LionDenPlugin, LionDenRuntimeEnvironment, TaskDefinition } from "./types.js";
+export interface CreateLreOptions {
+    config: LionDenResolvedConfig;
+    plugins: readonly LionDenPlugin[];
+    globalOptions?: Record<string, unknown>;
+    /** Tasks registered at the config level (via defineConfig({ tasks })) */
+    configTasks?: readonly TaskDefinition[];
+}
+/**
+ * Construct the LionDen Runtime Environment.
+ */
+export declare function createLre(options: CreateLreOptions): LionDenRuntimeEnvironment;
+//# sourceMappingURL=lre.d.ts.map

package/dist/lre.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lre.d.ts","sourceRoot":"","sources":["../src/lre.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAG7D,OAAO,KAAK,EAEV,aAAa,EACb,yBAAyB,EACzB,cAAc,EACf,MAAM,YAAY,CAAC;AA8EpB,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,qBAAqB,CAAC;IAC9B,OAAO,EAAE,SAAS,aAAa,EAAE,CAAC;IAClC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,yEAAyE;IACzE,WAAW,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;CACzC;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,yBAAyB,CAkD9E"}

package/dist/lre.js

@@ -0,0 +1,113 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { HookDispatcherImpl } from "./hook-system.js";
+import { TaskRunnerImpl } from "./task-runner.js";
+/**
+ * Artifact store backed by in-memory writes with lazy fallback to disk.
+ *
+ * Fresh LRE instances are created inside test workers and CLI subprocesses.
+ * They need to be able to observe artifacts produced by an earlier compile
+ * step in a different process.
+ */
+class ArtifactStoreImpl {
+    artifactsDir;
+    abis = new Map();
+    sources = new Map();
+    constructor(artifactsDir) {
+        this.artifactsDir = artifactsDir;
+    }
+    setAbi(programId, abi) {
+        this.abis.set(programId, abi);
+    }
+    setAleoSource(programId, source) {
+        this.sources.set(programId, source);
+    }
+    getAbi(programId) {
+        const cached = this.abis.get(programId);
+        if (cached !== undefined) {
+            return cached;
+        }
+        const abiPath = path.join(this.artifactsDir, programId, "abi.json");
+        if (!fs.existsSync(abiPath)) {
+            return undefined;
+        }
+        const abi = JSON.parse(fs.readFileSync(abiPath, "utf8"));
+        this.abis.set(programId, abi);
+        return abi;
+    }
+    getAleoSource(programId) {
+        const cached = this.sources.get(programId);
+        if (cached !== undefined) {
+            return cached;
+        }
+        const sourcePath = path.join(this.artifactsDir, programId, "main.aleo");
+        if (!fs.existsSync(sourcePath)) {
+            return undefined;
+        }
+        const source = fs.readFileSync(sourcePath, "utf8");
+        this.sources.set(programId, source);
+        return source;
+    }
+    getProgramIds() {
+        const programIds = new Set(this.abis.keys());
+        if (fs.existsSync(this.artifactsDir)) {
+            for (const entry of fs.readdirSync(this.artifactsDir, { withFileTypes: true })) {
+                if (!entry.isDirectory() || entry.name.startsWith(".")) {
+                    continue;
+                }
+                const abiPath = path.join(this.artifactsDir, entry.name, "abi.json");
+                if (fs.existsSync(abiPath)) {
+                    programIds.add(entry.name);
+                }
+            }
+        }
+        return [...programIds];
+    }
+}
+/**
+ * Construct the LionDen Runtime Environment.
+ */
+export function createLre(options) {
+    const { config, plugins, globalOptions = {}, configTasks = [] } = options;
+    // Build hook dispatcher
+    const hooks = new HookDispatcherImpl();
+    hooks.registerPlugins(plugins);
+    // Build task runner
+    const tasks = new TaskRunnerImpl();
+    // Register tasks from all plugins, then config-level tasks
+    const allTaskDefs = plugins.flatMap((p) => p.tasks ?? []);
+    tasks.registerTasks(allTaskDefs);
+    if (configTasks.length > 0) {
+        tasks.registerTasks(configTasks);
+    }
+    // Build artifact store
+    const artifacts = new ArtifactStoreImpl(config.paths.artifacts);
+    const lre = {
+        config,
+        network: null, // Set by @lionden/plugin-network via extendLre
+        deployments: null, // Set by @lionden/plugin-deploy via extendLre
+        tasks,
+        hooks,
+        artifacts,
+        plugins,
+        globalOptions,
+        namedAccounts: {}, // Overridden by @lionden/plugin-network via extendLre getter
+    };
+    // Allow plugins to inject services (e.g., network manager).
+    //
+    // NOTE: `globalOptions` may not be populated yet at this point. The CLI boot
+    // path (packages/cli/src/index.ts) constructs the LRE with an empty
+    // globalOptions object and fills it (by reference) only after a task-aware
+    // argv parse — so the parse can route named args after task definitions are
+    // known. Plugins must therefore read CLI global option values lazily during
+    // task execution, not synchronously here in extendLre.
+    for (const plugin of plugins) {
+        if (plugin.extendLre) {
+            plugin.extendLre(lre);
+        }
+    }
+    // Bind LRE to task runner
+    tasks.setLre(lre);
+    return lre;
+}
+//# sourceMappingURL=lre.js.map

package/dist/lre.js.map

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

package/dist/plugin-loader.d.ts

@@ -0,0 +1,20 @@
+import type { GlobalOptionDefinition, LionDenPlugin } from "./types.js";
+export declare class PluginLoadError extends Error {
+    constructor(message: string);
+}
+/**
+ * Resolves plugin load order using topological sort.
+ *
+ * @param plugins - The user-provided plugin list
+ * @returns Plugins in dependency-first order
+ */
+export declare function resolvePluginOrder(plugins: readonly LionDenPlugin[]): LionDenPlugin[];
+/**
+ * Collect all global options from the resolved plugin list.
+ * Validates there are no name collisions.
+ */
+export declare function collectGlobalOptions(plugins: readonly LionDenPlugin[]): Map<string, {
+    pluginId: string;
+    definition: GlobalOptionDefinition;
+}>;
+//# sourceMappingURL=plugin-loader.d.ts.map

package/dist/plugin-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-loader.d.ts","sourceRoot":"","sources":["../src/plugin-loader.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAExE,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,GAAG,aAAa,EAAE,CA2DrF;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,SAAS,aAAa,EAAE,GAChC,GAAG,CAAC,MAAM,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,sBAAsB,CAAA;CAAE,CAAC,CA4BvE"}

package/dist/plugin-loader.js

@@ -0,0 +1,91 @@
+import { argumentFlagName, getPublicArgumentNames, getReservedBuiltInGlobalArgumentNames, } from "./arg-names.js";
+export class PluginLoadError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "PluginLoadError";
+    }
+}
+/**
+ * Resolves plugin load order using topological sort.
+ *
+ * @param plugins - The user-provided plugin list
+ * @returns Plugins in dependency-first order
+ */
+export function resolvePluginOrder(plugins) {
+    const allPlugins = new Map();
+    // Reverse once so LIFO pop() seeds the plugin map in declared order. Only the
+    // relative order of independent roots depends on this — the DFS below already
+    // places every dependency before its dependents regardless of insertion order.
+    const toVisit = [...plugins].reverse();
+    // Collect all plugins including transitive dependencies
+    while (toVisit.length > 0) {
+        const plugin = toVisit.pop();
+        if (allPlugins.has(plugin.id)) {
+            const existing = allPlugins.get(plugin.id);
+            if (existing !== plugin) {
+                throw new PluginLoadError(`Duplicate plugin ID "${plugin.id}" with different instances`);
+            }
+            continue;
+        }
+        allPlugins.set(plugin.id, plugin);
+        // Hard dependencies must all be included
+        for (const dep of plugin.dependencies ?? []) {
+            toVisit.push(dep);
+        }
+    }
+    // Topological sort via DFS
+    const sorted = [];
+    const visited = new Set();
+    const visiting = new Set(); // cycle detection
+    function visit(plugin) {
+        if (visited.has(plugin.id))
+            return;
+        if (visiting.has(plugin.id)) {
+            throw new PluginLoadError(`Circular plugin dependency detected involving "${plugin.id}"`);
+        }
+        visiting.add(plugin.id);
+        // Visit hard dependencies
+        for (const dep of plugin.dependencies ?? []) {
+            const resolved = allPlugins.get(dep.id);
+            if (!resolved) {
+                throw new PluginLoadError(`Plugin "${plugin.id}" depends on "${dep.id}" which is not available`);
+            }
+            visit(resolved);
+        }
+        visiting.delete(plugin.id);
+        visited.add(plugin.id);
+        sorted.push(plugin);
+    }
+    for (const plugin of allPlugins.values()) {
+        visit(plugin);
+    }
+    return sorted;
+}
+/**
+ * Collect all global options from the resolved plugin list.
+ * Validates there are no name collisions.
+ */
+export function collectGlobalOptions(plugins) {
+    const options = new Map();
+    const publicNames = new Map();
+    const reservedBuiltInNames = getReservedBuiltInGlobalArgumentNames();
+    for (const plugin of plugins) {
+        for (const opt of plugin.globalOptions ?? []) {
+            for (const publicName of getPublicArgumentNames(opt.name)) {
+                if (reservedBuiltInNames.has(publicName)) {
+                    throw new PluginLoadError(`Global option "${argumentFlagName(opt.name)}" registered by "${plugin.id}" conflicts with built-in global option "${argumentFlagName(publicName)}"`);
+                }
+                const existingPluginId = publicNames.get(publicName);
+                if (existingPluginId) {
+                    throw new PluginLoadError(`Global option "${argumentFlagName(opt.name)}" registered by both "${existingPluginId}" and "${plugin.id}"`);
+                }
+            }
+            options.set(opt.name, { pluginId: plugin.id, definition: opt });
+            for (const publicName of getPublicArgumentNames(opt.name)) {
+                publicNames.set(publicName, plugin.id);
+            }
+        }
+    }
+    return options;
+}
+//# sourceMappingURL=plugin-loader.js.map

package/dist/plugin-loader.js.map

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

package/dist/task-builder.d.ts

@@ -0,0 +1,49 @@
+import { ArgumentType, type TaskAction, type TaskActionWithSuper, type TaskDefinition, type TaskFlag, type TaskOption, type TaskPositionalArgument } from "./types.js";
+export { ArgumentType };
+/**
+ * Fluent builder for creating task definitions.
+ *
+ * @example
+ * ```ts
+ * const compileTask = task("compile", "Compile Leo programs")
+ *   .addFlag({ name: "force", description: "Force recompile" })
+ *   .addFlag({ name: "noTypechain", description: "Skip TypeScript binding generation" })
+ *   .setAction(async (args, lre) => { ... })
+ *   .build();
+ * ```
+ */
+export declare class TaskBuilder {
+    private readonly _id;
+    private readonly _description;
+    private _action;
+    private readonly _options;
+    private readonly _flags;
+    private readonly _positionalArguments;
+    private readonly _argumentNames;
+    private readonly _reservedBuiltInGlobalNames;
+    constructor(id: string, description: string);
+    addOption(option: TaskOption): this;
+    addFlag(flag: TaskFlag): this;
+    addPositionalArgument(arg: TaskPositionalArgument): this;
+    /** Set an inline action function */
+    setAction(action: TaskAction): this;
+    build(): TaskDefinition;
+    private registerArgumentName;
+    private validateReservedBuiltInGlobalName;
+}
+/**
+ * Builder for overriding an existing task. Cannot add/remove parameters.
+ * The action receives `runSuper` as a third argument.
+ */
+export declare class OverrideTaskBuilder {
+    private readonly _id;
+    private _action;
+    constructor(id: string);
+    setAction(action: TaskActionWithSuper): this;
+    build(): TaskDefinition;
+}
+/** Create a new task definition */
+export declare function task(id: string, description: string): TaskBuilder;
+/** Create a task override */
+export declare function overrideTask(id: string): OverrideTaskBuilder;
+//# sourceMappingURL=task-builder.d.ts.map

package/dist/task-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-builder.d.ts","sourceRoot":"","sources":["../src/task-builder.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,YAAY,EACZ,KAAK,UAAU,EACf,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,sBAAsB,EAC5B,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,YAAY,EAAE,CAAC;AAExB;;;;;;;;;;;GAWG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoB;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAgC;IACrE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAG3B;IACJ,OAAO,CAAC,QAAQ,CAAC,2BAA2B,CAA2C;gBAE3E,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAK3C,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAYnC,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI;IAO7B,qBAAqB,CAAC,GAAG,EAAE,sBAAsB,GAAG,IAAI;IAMxD,oCAAoC;IACpC,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAKnC,KAAK,IAAI,cAAc;IAgBvB,OAAO,CAAC,oBAAoB;IAoB5B,OAAO,CAAC,iCAAiC;CAS1C;AAED;;;GAGG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,OAAO,CAAoC;gBAEvC,EAAE,EAAE,MAAM;IAItB,SAAS,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI;IAK5C,KAAK,IAAI,cAAc;CAaxB;AAED,mCAAmC;AACnC,wBAAgB,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,WAAW,CAEjE;AAED,6BAA6B;AAC7B,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,mBAAmB,CAE5D"}

package/dist/task-builder.js

@@ -0,0 +1,123 @@
+import { argumentFlagName, getPublicArgumentNames, getReservedBuiltInGlobalArgumentNames, } from "./arg-names.js";
+import { ArgumentType, } from "./types.js";
+export { ArgumentType };
+/**
+ * Fluent builder for creating task definitions.
+ *
+ * @example
+ * ```ts
+ * const compileTask = task("compile", "Compile Leo programs")
+ *   .addFlag({ name: "force", description: "Force recompile" })
+ *   .addFlag({ name: "noTypechain", description: "Skip TypeScript binding generation" })
+ *   .setAction(async (args, lre) => { ... })
+ *   .build();
+ * ```
+ */
+export class TaskBuilder {
+    _id;
+    _description;
+    _action = null;
+    _options = [];
+    _flags = [];
+    _positionalArguments = [];
+    _argumentNames = new Map();
+    _reservedBuiltInGlobalNames = getReservedBuiltInGlobalArgumentNames();
+    constructor(id, description) {
+        this._id = id;
+        this._description = description;
+    }
+    addOption(option) {
+        if (option.type === "boolean") {
+            throw new Error(`Task "${this._id}" option "${option.name}" uses boolean type. Boolean task arguments must be registered with addFlag().`);
+        }
+        this.validateReservedBuiltInGlobalName("option", option.name);
+        this.registerArgumentName("option", option.name);
+        this._options.push(option);
+        return this;
+    }
+    addFlag(flag) {
+        this.validateReservedBuiltInGlobalName("flag", flag.name);
+        this.registerArgumentName("flag", flag.name);
+        this._flags.push(flag);
+        return this;
+    }
+    addPositionalArgument(arg) {
+        this.registerArgumentName("positional argument", arg.name);
+        this._positionalArguments.push(arg);
+        return this;
+    }
+    /** Set an inline action function */
+    setAction(action) {
+        this._action = action;
+        return this;
+    }
+    build() {
+        if (!this._action) {
+            throw new Error(`Task "${this._id}" has no action set`);
+        }
+        return {
+            id: this._id,
+            description: this._description,
+            action: this._action,
+            options: this._options.length > 0 ? [...this._options] : undefined,
+            flags: this._flags.length > 0 ? [...this._flags] : undefined,
+            positionalArguments: this._positionalArguments.length > 0 ? [...this._positionalArguments] : undefined,
+        };
+    }
+    registerArgumentName(kind, name) {
+        // Validate all aliases before committing any, so a conflict on a later
+        // alias never leaves an earlier alias half-registered.
+        for (const publicName of getPublicArgumentNames(name)) {
+            const existing = this._argumentNames.get(publicName);
+            if (existing) {
+                throw new Error(`Task "${this._id}" ${kind} "${name}" conflicts with existing ${existing.kind} "${existing.name}"`);
+            }
+        }
+        for (const publicName of getPublicArgumentNames(name)) {
+            this._argumentNames.set(publicName, { kind, name });
+        }
+    }
+    validateReservedBuiltInGlobalName(kind, name) {
+        for (const publicName of getPublicArgumentNames(name)) {
+            if (this._reservedBuiltInGlobalNames.has(publicName)) {
+                throw new Error(`Task "${this._id}" ${kind} "${name}" conflicts with built-in global option "${argumentFlagName(publicName)}"`);
+            }
+        }
+    }
+}
+/**
+ * Builder for overriding an existing task. Cannot add/remove parameters.
+ * The action receives `runSuper` as a third argument.
+ */
+export class OverrideTaskBuilder {
+    _id;
+    _action = null;
+    constructor(id) {
+        this._id = id;
+    }
+    setAction(action) {
+        this._action = action;
+        return this;
+    }
+    build() {
+        if (!this._action) {
+            throw new Error(`Override for task "${this._id}" has no action set`);
+        }
+        const capturedAction = this._action;
+        return {
+            id: this._id,
+            description: "", // overrides inherit the original description
+            overrides: this._id,
+            action: capturedAction, // runSuper is injected at dispatch time
+        };
+    }
+}
+/** Create a new task definition */
+export function task(id, description) {
+    return new TaskBuilder(id, description);
+}
+/** Create a task override */
+export function overrideTask(id) {
+    return new OverrideTaskBuilder(id);
+}
+//# sourceMappingURL=task-builder.js.map

package/dist/task-builder.js.map

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