@lionden/core 0.1.0

package/dist/config-resolution.js

@@ -0,0 +1,570 @@
+import * as os from "node:os";
+import * as path from "node:path";
+import { checkRuntimeImportRefExists, classifyRuntimeImportRef, isConfigVariable, isValidAleoAddress, isValidExecutionImportsMapKey, normalizeProgramId, normalizeRuntimeImportRef, resolveConfigVariable, SDK_LOG_LEVELS, } from "@lionden/config";
+import { HookDispatcherImpl } from "./hook-system.js";
+export class ConfigResolutionError extends Error {
+    errors;
+    constructor(message, errors) {
+        super(message);
+        this.errors = errors;
+        this.name = "ConfigResolutionError";
+    }
+}
+export async function resolveConfig(userConfig, plugins, projectRoot) {
+    // Route config hooks through the shared dispatcher. This boots a standalone
+    // instance — the LRE does not exist yet at this phase of CLI startup. Lazy
+    // hook factories resolve once (single-flight in resolveCategory) and the
+    // resolved handlers are reused across all four stages below.
+    const hooks = new HookDispatcherImpl();
+    hooks.registerPlugins(plugins);
+    // 1. Extend user config (waterfall — an undefined return keeps the prior value)
+    const config = await hooks.waterfall("config", "extendUserConfig", userConfig);
+    // 2. Validate user config (built-in core passes first, then plugin handlers)
+    const userErrors = [
+        ...validateSdkUserConfig(config),
+        ...validateExecutionUserConfig(config),
+        ...(await hooks.collect("config", "validateUserConfig", config))
+            .flat()
+            // drop undefined returns from handlers that break the ConfigValidationError[] contract
+            .filter(Boolean),
+    ];
+    if (userErrors.length > 0) {
+        throw new ConfigResolutionError(`Config validation failed:\n${formatErrors(userErrors)}`, userErrors);
+    }
+    // 3. Resolve: build the resolved config from defaults + plugin partials
+    const resolvedVariable = async (v) => {
+        return resolveConfigVariable(v);
+    };
+    // Start with defaults, then merge plugin partials in plugin order.
+    let resolved = buildDefaults(config, projectRoot);
+    const partials = await hooks.collect("config", "resolveConfig", config, resolvedVariable);
+    for (const partial of partials) {
+        resolved = mergePartial(resolved, partial);
+    }
+    // 4. Validate resolved config (built-in core passes first, then plugin handlers)
+    const resolvedErrors = [
+        ...validateExecutionResolvedConfig(resolved),
+        ...(await hooks.collect("config", "validateResolvedConfig", resolved))
+            .flat()
+            // drop undefined returns from handlers that break the ConfigValidationError[] contract
+            .filter(Boolean),
+    ];
+    if (resolvedErrors.length > 0) {
+        throw new ConfigResolutionError(`Resolved config validation failed:\n${formatErrors(resolvedErrors)}`, resolvedErrors);
+    }
+    return { resolved, extendedUserConfig: config };
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function formatErrors(errors) {
+    return errors.map((e) => `  - ${e.path}: ${e.message}`).join("\n");
+}
+function buildDefaults(config, projectRoot) {
+    const programsDir = config.programsDir ?? "programs";
+    const artifactsDir = config.artifactsDir ?? "artifacts";
+    const typechainDir = config.typechainDir ?? "typechain";
+    // codegen.outDir takes precedence over typechainDir when explicitly set
+    const codegenOutDir = config.codegen?.outDir ?? typechainDir;
+    const deploymentsDir = config.deploy?.deploymentsDir ?? "deployments";
+    const paths = {
+        root: projectRoot,
+        programs: path.resolve(projectRoot, programsDir),
+        artifacts: path.resolve(projectRoot, artifactsDir),
+        typechain: path.resolve(projectRoot, codegenOutDir),
+        cache: path.resolve(projectRoot, artifactsDir, ".cache"),
+        deployments: path.resolve(projectRoot, deploymentsDir),
+    };
+    const compiler = {
+        enableDce: config.compiler?.enableDce ?? true,
+        conditionalBlockMaxDepth: config.compiler?.conditionalBlockMaxDepth ?? 10,
+        buildTests: config.compiler?.buildTests ?? false,
+        extraFlags: config.compiler?.extraFlags ?? [],
+    };
+    const codegen = {
+        enabled: config.codegen?.enabled ?? true,
+        outDir: codegenOutDir,
+        dynamicRecords: normalizeDynamicRecords(config.codegen?.dynamicRecords),
+    };
+    const testing = {
+        framework: config.testing?.framework ?? "vitest",
+        timeout: config.testing?.timeout ?? 120_000,
+        autoStartDevnode: config.testing?.autoStartDevnode ?? true,
+    };
+    const deploy = {
+        defaultPriorityFee: config.deploy?.defaultPriorityFee ?? 0,
+        privateFee: config.deploy?.privateFee ?? false,
+        confirmTransactions: config.deploy?.confirmTransactions ?? true,
+        confirmationTimeout: config.deploy?.confirmationTimeout ?? 60_000,
+        deploymentsDir: deploymentsDir,
+        skipDeployed: config.deploy?.skipDeployed ?? true,
+        interDeploymentDelay: config.deploy?.interDeploymentDelay,
+        autoExport: config.deploy?.autoExport ?? false,
+    };
+    const sdk = resolveSdkConfig(config, projectRoot, paths.artifacts);
+    const execution = resolveExecutionConfig(config, projectRoot);
+    // Resolve networks
+    const networks = {};
+    const userNetworks = config.networks ?? {};
+    const deployEphemeral = config.deploy?.ephemeral;
+    // Always provide a default devnode network if none specified
+    if (Object.keys(userNetworks).length === 0) {
+        networks["devnode"] = {
+            type: "devnode",
+            socketAddr: "127.0.0.1:3030",
+            autoBlock: true,
+            verbosity: 0,
+            accounts: [],
+            network: "testnet",
+            ephemeral: deployEphemeral ?? true,
+        };
+    }
+    else {
+        for (const [name, netConfig] of Object.entries(userNetworks)) {
+            networks[name] = resolveNetworkConfig(name, netConfig, deployEphemeral);
+        }
+    }
+    const defaultNetwork = config.defaultNetwork ?? "devnode";
+    const namedAccounts = resolveNamedAccountsConfig(config.namedAccounts ?? {});
+    return {
+        leoVersion: config.leoVersion ?? "4.3.2",
+        skipLeoVersionCheck: config.skipLeoVersionCheck ?? false,
+        leoBinary: expandTilde(config.leoBinary ?? "leo"),
+        paths,
+        networks,
+        defaultNetwork,
+        compiler,
+        codegen,
+        testing,
+        deploy,
+        sdk,
+        execution,
+        namedAccounts,
+    };
+}
+function resolveSdkConfig(config, projectRoot, artifactsPath) {
+    const keyCache = config.sdk?.keyCache;
+    const logLevel = config.sdk?.logLevel ?? "warn";
+    const storage = keyCache?.storage ?? "filesystem";
+    const egress = resolveSdkEgressConfig(config);
+    if (storage === "memory") {
+        return egress === undefined
+            ? { logLevel, keyCache: { storage } }
+            : { logLevel, keyCache: { storage }, egress };
+    }
+    const rawPath = keyCache?.path ?? path.join(artifactsPath, ".cache", "provable-keys");
+    const expandedPath = expandTilde(rawPath);
+    const absolutePath = path.isAbsolute(expandedPath)
+        ? expandedPath
+        : path.resolve(projectRoot, expandedPath);
+    return egress === undefined
+        ? {
+            logLevel,
+            keyCache: {
+                storage,
+                path: normalizeAleoKeyCachePath(absolutePath),
+            },
+        }
+        : {
+            logLevel,
+            keyCache: {
+                storage,
+                path: normalizeAleoKeyCachePath(absolutePath),
+            },
+            egress,
+        };
+}
+function resolveSdkEgressConfig(config) {
+    const egress = config.sdk?.egress;
+    if (!egress)
+        return undefined;
+    const resolved = {};
+    if (egress.networkHosts)
+        resolved.networkHosts = [...egress.networkHosts];
+    if (egress.violation)
+        resolved.violation = egress.violation;
+    return resolved;
+}
+function normalizeAleoKeyCachePath(p) {
+    return path.basename(p) === ".aleo" ? p : path.join(p, ".aleo");
+}
+/**
+ * Normalize the user-provided `dynamicRecords` map into the resolved form by
+ * attaching each map key as `helperName`. Defensive against malformed input
+ * (non-object map, non-object entries) — entries that don't look like helper
+ * configs are dropped silently so the resolved shape stays stable. The
+ * plugin-leo `validateUserConfig` hook is responsible for surfacing those
+ * malformed entries as `ConfigValidationError` to the user before this
+ * normalization is consumed by codegen.
+ */
+function normalizeDynamicRecords(raw) {
+    if (raw == null || typeof raw !== "object" || Array.isArray(raw))
+        return {};
+    const entries = [];
+    for (const [helperName, value] of Object.entries(raw)) {
+        if (value == null || typeof value !== "object" || Array.isArray(value))
+            continue;
+        const helper = value;
+        const sourceRecord = helper["sourceRecord"];
+        const schema = helper["schema"];
+        if (typeof sourceRecord !== "string" ||
+            schema == null ||
+            typeof schema !== "object" ||
+            Array.isArray(schema)) {
+            continue;
+        }
+        const normalizedSchema = {};
+        for (const [k, v] of Object.entries(schema)) {
+            if (typeof v !== "string")
+                continue;
+            normalizedSchema[k] = v;
+        }
+        const sourceProgram = helper["sourceProgram"];
+        entries.push([
+            helperName,
+            {
+                helperName,
+                sourceRecord,
+                ...(typeof sourceProgram === "string" ? { sourceProgram } : {}),
+                schema: normalizedSchema,
+            },
+        ]);
+    }
+    return Object.fromEntries(entries);
+}
+function resolveNetworkConfig(networkName, config, deployEphemeral) {
+    switch (config.type) {
+        case "devnode":
+            return {
+                type: "devnode",
+                socketAddr: config.socketAddr ?? "127.0.0.1:3030",
+                autoBlock: config.autoBlock ?? true,
+                verbosity: config.verbosity ?? 0,
+                accounts: (config.accounts ?? []).map((a, i) => {
+                    const key = resolveStringOrVariable(a.privateKey);
+                    if (!key) {
+                        const err = {
+                            path: `networks.${networkName}.accounts[${i}].privateKey`,
+                            message: "Account private key must be a non-empty string or a resolvable ConfigVariable",
+                        };
+                        throw new ConfigResolutionError(err.message, [err]);
+                    }
+                    return { privateKey: key, name: a.name };
+                }),
+                genesisPath: config.genesisPath,
+                network: config.network ?? "testnet",
+                privateKey: resolveStringOrVariable(config.privateKey),
+                consensusHeights: config.consensusHeights,
+                // provider/binary stay undefined unless the user set them — auto-detect
+                // (which can fall back to leo) keys off their absence at start time.
+                ...(config.provider !== undefined ? { provider: config.provider } : {}),
+                ...(config.binary !== undefined ? { binary: expandTilde(config.binary) } : {}),
+                ...(config.storagePath !== undefined
+                    ? { storagePath: expandTilde(config.storagePath) }
+                    : {}),
+                ...(config.clearStorageOnStart !== undefined
+                    ? { clearStorageOnStart: config.clearStorageOnStart }
+                    : {}),
+                ephemeral: config.ephemeral ?? deployEphemeral ?? true,
+            };
+        case "http":
+            return {
+                type: "http",
+                endpoint: config.endpoint,
+                network: config.network,
+                privateKey: resolveStringOrVariable(config.privateKey),
+                apiKey: resolveStringOrVariable(config.apiKey),
+                ephemeral: config.ephemeral ?? deployEphemeral ?? false,
+            };
+        default: {
+            const unknownType = config.type;
+            throw new ConfigResolutionError(`Unknown network type "${unknownType}" for network "${networkName}". Supported types are "devnode" and "http".`, [
+                {
+                    path: `networks.${networkName}.type`,
+                    message: `Unknown network type "${unknownType}". Supported types are "devnode" and "http".`,
+                },
+            ]);
+        }
+    }
+}
+function resolveStringOrVariable(value) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value === "string")
+        return value;
+    if (isConfigVariable(value))
+        return resolveConfigVariable(value);
+    return undefined;
+}
+// ---------------------------------------------------------------------------
+// Named accounts resolution
+// ---------------------------------------------------------------------------
+/**
+ * Resolve user-provided namedAccounts config to the fully classified form.
+ * This is synchronous — ConfigVariable values are resolved eagerly (existing
+ * convention). Address derivation from private keys is deferred to runtime.
+ *
+ * Validation:
+ * - Numeric index: must be a finite non-negative integer
+ * - String starting with "aleo1": must pass full address shape validation
+ * - String starting with "APrivateKey1": accepted as-is (private key)
+ * - Other strings: config error
+ */
+function resolveNamedAccountsConfig(userNamedAccounts) {
+    const resolved = {};
+    for (const [accountName, accountConfig] of Object.entries(userNamedAccounts)) {
+        const networks = {};
+        for (const [key, value] of Object.entries(accountConfig)) {
+            if (value === undefined)
+                continue;
+            const resolvedValue = resolveNamedAccountValue(accountName, key, value);
+            if (key === "default") {
+                // handled below via accountConfig.default
+                continue;
+            }
+            networks[key] = resolvedValue;
+        }
+        const defaultValue = accountConfig.default !== undefined
+            ? resolveNamedAccountValue(accountName, "default", accountConfig.default)
+            : undefined;
+        resolved[accountName] = { networks, default: defaultValue };
+    }
+    return resolved;
+}
+function resolveNamedAccountValue(accountName, keyName, value) {
+    // Resolve ConfigVariable first
+    let raw;
+    if (typeof value === "number") {
+        raw = value;
+    }
+    else if (typeof value === "string") {
+        raw = value;
+    }
+    else if (isConfigVariable(value)) {
+        const resolved = resolveConfigVariable(value);
+        // After variable resolution, treat as string
+        raw = resolved;
+    }
+    else {
+        throw new ConfigResolutionError(`Named account "${accountName}" (${keyName}): unsupported value type.`, [
+            {
+                path: `namedAccounts.${accountName}.${keyName}`,
+                message: "Value must be a number, string, or ConfigVariable.",
+            },
+        ]);
+    }
+    if (typeof raw === "number") {
+        // Validate: finite non-negative integer
+        if (!Number.isFinite(raw) || !Number.isInteger(raw) || raw < 0) {
+            throw new ConfigResolutionError(`Named account "${accountName}" (${keyName}): index must be a non-negative integer, got ${raw}.`, [
+                {
+                    path: `namedAccounts.${accountName}.${keyName}`,
+                    message: `Index must be a non-negative integer, got ${raw}.`,
+                },
+            ]);
+        }
+        return { type: "index", index: raw };
+    }
+    // raw is a string
+    if (raw.startsWith("aleo1")) {
+        if (!isValidAleoAddress(raw)) {
+            throw new ConfigResolutionError(`Named account "${accountName}" (${keyName}): "${raw}" looks like an Aleo address but has an invalid format. ` +
+                `Expected "aleo1" followed by exactly 58 lowercase alphanumeric characters.`, [
+                {
+                    path: `namedAccounts.${accountName}.${keyName}`,
+                    message: `Invalid Aleo address format. Expected "aleo1" + 58 lowercase alphanumeric chars.`,
+                },
+            ]);
+        }
+        return { type: "address", address: raw };
+    }
+    if (raw.startsWith("APrivateKey1")) {
+        return { type: "privateKey", privateKey: raw };
+    }
+    throw new ConfigResolutionError(`Named account "${accountName}" (${keyName}): string "${raw}" is not a recognized Aleo address (aleo1...) or private key (APrivateKey1...).`, [
+        {
+            path: `namedAccounts.${accountName}.${keyName}`,
+            message: `Must be an Aleo address (aleo1...), a private key (APrivateKey1...), or a devnode account index (number).`,
+        },
+    ]);
+}
+function expandTilde(p) {
+    if (p.startsWith("~/")) {
+        return path.join(os.homedir(), p.slice(2));
+    }
+    return p;
+}
+function mergePartial(base, partial) {
+    return {
+        ...base,
+        ...partial,
+        paths: { ...base.paths, ...(partial.paths ?? {}) },
+        compiler: {
+            ...base.compiler,
+            ...(partial.compiler ?? {}),
+        },
+        codegen: { ...base.codegen, ...(partial.codegen ?? {}) },
+        testing: { ...base.testing, ...(partial.testing ?? {}) },
+        deploy: { ...base.deploy, ...(partial.deploy ?? {}) },
+        sdk: mergeSdkConfig(base.sdk, partial.sdk),
+        execution: {
+            imports: {
+                ...base.execution.imports,
+                ...(partial.execution?.imports ?? {}),
+            },
+        },
+        networks: { ...base.networks, ...(partial.networks ?? {}) },
+        namedAccounts: { ...base.namedAccounts, ...(partial.namedAccounts ?? {}) },
+    };
+}
+// ---------------------------------------------------------------------------
+// Execution config (runtime imports for dynamic dispatch)
+// ---------------------------------------------------------------------------
+/**
+ * Resolve `execution.imports` into normalized `RuntimeImportRef[]` keyed by
+ * canonical `.aleo` program id. Invalid refs are skipped here — they would
+ * have surfaced in `validateExecutionUserConfig`. Map keys collide-merge
+ * after normalization (e.g. `governance` + `governance.aleo` → one entry).
+ */
+function resolveExecutionConfig(config, projectRoot) {
+    const raw = config.execution?.imports;
+    if (!raw || typeof raw !== "object") {
+        return { imports: {} };
+    }
+    const byKey = new Map();
+    for (const [rawKey, refs] of Object.entries(raw)) {
+        if (!isValidExecutionImportsMapKey(rawKey))
+            continue;
+        if (!Array.isArray(refs))
+            continue;
+        const canonicalKey = normalizeProgramId(rawKey);
+        const refList = byKey.get(canonicalKey) ?? [];
+        for (const raw of refs) {
+            if (typeof raw !== "string" || raw.length === 0)
+                continue;
+            if (classifyRuntimeImportRef(raw) === "invalid")
+                continue;
+            try {
+                refList.push(normalizeRuntimeImportRef(raw, projectRoot));
+            }
+            catch {
+                // Ignore — already filtered by classify above; defense in depth.
+            }
+        }
+        byKey.set(canonicalKey, refList);
+    }
+    // Dedup and sort each list deterministically for cache identity stability.
+    const result = {};
+    for (const [key, refs] of byKey) {
+        result[key] = dedupAndSortRuntimeImports(refs);
+    }
+    return { imports: result };
+}
+function dedupAndSortRuntimeImports(refs) {
+    const seen = new Set();
+    const out = [];
+    for (const ref of refs) {
+        const key = ref.kind === "programId" ? `id:${ref.programId}` : `path:${ref.absolutePath}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        out.push(ref);
+    }
+    out.sort((a, b) => {
+        const aKey = a.kind === "programId" ? a.programId : a.absolutePath;
+        const bKey = b.kind === "programId" ? b.programId : b.absolutePath;
+        if (aKey === bKey)
+            return 0;
+        return aKey < bKey ? -1 : 1;
+    });
+    return out;
+}
+function validateExecutionUserConfig(config) {
+    const errors = [];
+    const imports = config.execution?.imports;
+    if (imports === undefined)
+        return errors;
+    if (typeof imports !== "object" || imports === null || Array.isArray(imports)) {
+        errors.push({
+            path: "execution.imports",
+            message: "Must be an object mapping program ids to import-ref arrays.",
+        });
+        return errors;
+    }
+    for (const [key, refs] of Object.entries(imports)) {
+        if (!isValidExecutionImportsMapKey(key)) {
+            errors.push({
+                path: `execution.imports[${JSON.stringify(key)}]`,
+                message: `Map keys must be Leo program ids (bare or .aleo). Got ${JSON.stringify(key)}.`,
+            });
+            continue;
+        }
+        if (!Array.isArray(refs)) {
+            errors.push({
+                path: `execution.imports[${JSON.stringify(key)}]`,
+                message: "Value must be an array of program-id or path refs.",
+            });
+            continue;
+        }
+        if (refs.length === 0) {
+            errors.push({
+                path: `execution.imports[${JSON.stringify(key)}]`,
+                message: "Array must be non-empty (omit the key instead of providing []).",
+            });
+            continue;
+        }
+        refs.forEach((raw, i) => {
+            if (typeof raw !== "string") {
+                errors.push({
+                    path: `execution.imports[${JSON.stringify(key)}][${i}]`,
+                    message: `Ref must be a string, got ${typeof raw}.`,
+                });
+                return;
+            }
+            if (classifyRuntimeImportRef(raw) === "invalid") {
+                errors.push({
+                    path: `execution.imports[${JSON.stringify(key)}][${i}]`,
+                    message: `Ref ${JSON.stringify(raw)} is neither a Leo program id (bare or .aleo) nor a path (contains \`/\`, \`\\\\\`, or starts with \`~\`).`,
+                });
+            }
+        });
+    }
+    return errors;
+}
+const SDK_LOG_LEVEL_SET = new Set(SDK_LOG_LEVELS);
+function validateSdkUserConfig(config) {
+    const errors = [];
+    const logLevel = config.sdk?.logLevel;
+    if (logLevel !== undefined && !SDK_LOG_LEVEL_SET.has(logLevel)) {
+        errors.push({
+            path: "sdk.logLevel",
+            message: `sdk.logLevel must be one of: ${SDK_LOG_LEVELS.join(", ")}`,
+        });
+    }
+    return errors;
+}
+function validateExecutionResolvedConfig(resolved) {
+    const errors = [];
+    for (const [key, refs] of Object.entries(resolved.execution.imports)) {
+        refs.forEach((ref, i) => {
+            const diagnostic = checkRuntimeImportRefExists(ref, `execution.imports[${JSON.stringify(key)}][${i}]`);
+            if (diagnostic) {
+                errors.push({ path: diagnostic.path, message: diagnostic.message });
+            }
+        });
+    }
+    return errors;
+}
+function mergeSdkConfig(base, partial) {
+    const mergedKeyCache = {
+        ...base.keyCache,
+        ...(partial?.keyCache ?? {}),
+    };
+    return {
+        ...base,
+        ...(partial ?? {}),
+        logLevel: partial?.logLevel ?? base.logLevel,
+        keyCache: mergedKeyCache.storage === "memory" ? { storage: "memory" } : mergedKeyCache,
+    };
+}
+//# sourceMappingURL=config-resolution.js.map

package/dist/config-resolution.js.map

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

package/dist/hook-system.d.ts

@@ -0,0 +1,51 @@
+import type { HookCategory, HookDispatcher, LionDenPlugin } from "./types.js";
+/**
+ * The hook dispatcher manages all hook registrations and executions.
+ * Hook handlers are lazy-loaded by category on first invocation.
+ */
+export declare class HookDispatcherImpl implements HookDispatcher {
+    /**
+     * category -> plugin ID -> resolved handlers (or a factory for lazy loading)
+     */
+    private readonly registry;
+    /** Track which categories have been fully resolved */
+    private readonly resolved;
+    /**
+     * Track in-flight category resolution so concurrent dispatches share work.
+     * A factory must not dispatch its own category while resolving — that would
+     * await the very promise it is inside and deadlock.
+     */
+    private readonly resolving;
+    /**
+     * Register all hook handlers from a list of plugins (already in load order).
+     */
+    registerPlugins(plugins: readonly LionDenPlugin[]): void;
+    /**
+     * Ensure all handlers for a category are resolved (lazy factories called).
+     */
+    private resolveCategory;
+    /**
+     * Get all resolved handler functions for a specific hook point,
+     * in plugin dependency order.
+     */
+    private getHandlers;
+    /**
+     * Serial dispatch: handlers execute sequentially in plugin order.
+     * Each receives the context; return values are ignored.
+     */
+    serial<TContext>(category: HookCategory, hookName: string, context: TContext): Promise<void>;
+    /**
+     * Waterfall dispatch: each handler receives the previous handler's return
+     * value. The final value is returned.
+     */
+    waterfall<TValue>(category: HookCategory, hookName: string, initialValue: TValue, ...extraArgs: unknown[]): Promise<TValue>;
+    /**
+     * Collect dispatch: handlers execute sequentially in plugin order and each
+     * handler's return value is gathered into the result array (in the same
+     * order). Extra args are forwarded to every handler after the context.
+     * Used by the config lifecycle to aggregate validation errors and partial
+     * config resolutions.
+     */
+    collect<TResult>(category: HookCategory, hookName: string, context: unknown, ...extraArgs: unknown[]): Promise<TResult[]>;
+}
+//# sourceMappingURL=hook-system.d.ts.map

package/dist/hook-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-system.d.ts","sourceRoot":"","sources":["../src/hook-system.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAkB,aAAa,EAAE,MAAM,YAAY,CAAC;AAK9F;;;GAGG;AACH,qBAAa,kBAAmB,YAAW,cAAc;IACvD;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAOrB;IAEJ,sDAAsD;IACtD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2B;IAEpD;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0C;IAEpE;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,GAAG,IAAI;IAkCxD;;OAEG;YACW,eAAe;IAmC7B;;;OAGG;YACW,WAAW;IAkBzB;;;OAGG;IACG,MAAM,CAAC,QAAQ,EACnB,QAAQ,EAAE,YAAY,EACtB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,QAAQ,GAChB,OAAO,CAAC,IAAI,CAAC;IAOhB;;;OAGG;IACG,SAAS,CAAC,MAAM,EACpB,QAAQ,EAAE,YAAY,EACtB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,GAAG,SAAS,EAAE,OAAO,EAAE,GACtB,OAAO,CAAC,MAAM,CAAC;IAYlB;;;;;;OAMG;IACG,OAAO,CAAC,OAAO,EACnB,QAAQ,EAAE,YAAY,EACtB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,OAAO,EAChB,GAAG,SAAS,EAAE,OAAO,EAAE,GACtB,OAAO,CAAC,OAAO,EAAE,CAAC;CAQtB"}