/**
 * @jorvel/types — Plugin system (phase-0 foundation).
 *
 * The goal is to formalize extension points without committing to a complex
 * plugin runtime yet.
 */
import type { FederationConfig } from './federation-config.js';
import type { JorvelWorkspaceConfig } from './jorvel-config.js';
export type JorvelAppMeta = {
    name: string;
    type: 'host' | 'remote';
    port: number;
    dir: string;
};
export type JorvelDevPlan = {
    workspaceDir: string;
    apps: JorvelAppMeta[];
    host?: JorvelAppMeta;
    remotes: JorvelAppMeta[];
    mode: 'parallel' | 'on-demand';
    proxyRemotes: boolean;
    hmrRemotes: boolean;
};
export type JorvelPlugin = {
    name: string;
    /** Inspect/modify resolved workspace config before commands run. */
    configResolved?: (cfg: JorvelWorkspaceConfig) => JorvelWorkspaceConfig | void | Promise<JorvelWorkspaceConfig | void>;
    /**
     * Inspect/modify the federation config right before it is written.
     *
     * This is the first step towards a bundler-agnostic federation abstraction.
     */
    federationConfig?: (args: {
        workspaceDir: string;
        app: JorvelAppMeta;
        config: FederationConfig;
    }) => FederationConfig | void | Promise<FederationConfig | void>;
    /** Inspect/modify the computed dev plan. */
    devPlan?: (plan: JorvelDevPlan) => JorvelDevPlan | void | Promise<JorvelDevPlan | void>;
};
type PluginHookValue = {
    configResolved: JorvelWorkspaceConfig;
    devPlan: JorvelDevPlan;
};
/**
 * Apply a single plugin hook across the plugin chain. Each plugin receives the
 * latest accumulated value; returning `undefined` means "no change", anything
 * else replaces the value. `null` is reserved for future "drop" semantics.
 */
export declare function applyPlugins<H extends 'configResolved' | 'devPlan'>(value: PluginHookValue[H], plugins: JorvelPlugin[], hook: H): Promise<PluginHookValue[H]>;
/**
 * Apply the federation hook for a specific app.
 */
export declare function applyFederationConfigPlugins(args: {
    workspaceDir: string;
    app: JorvelAppMeta;
    config: FederationConfig;
}, plugins: JorvelPlugin[]): Promise<FederationConfig>;
export {};
//# sourceMappingURL=plugins.d.ts.map