import type { PluginContributions } from './types';
/**
 * Identity of a successfully-loaded plugin, for host chrome that must attribute a
 * contribution to its origin (e.g. the shell's provenance badge on plugin nav). The
 * `name` is the same id the registry stamps on every contribution (`pluginId`); the
 * `version` comes from the plugin's manifest.
 */
export interface LoadedPlugin {
    readonly name: string;
    readonly version: string;
}
/**
 * The plugin load pass's public state, mirrored for feature pages to read. It is
 * the shape the app shell's loader store already exposes: `status` gates when the
 * contributions are complete, and the error fields carry the loud failures.
 */
export interface PluginLoaderState {
    /** `idle` before the first pass, `loading` while it runs, `ready` once done. */
    readonly status: 'idle' | 'loading' | 'ready';
    /** Names of plugins whose bundle imported and registered successfully. */
    readonly loaded: readonly string[];
    /**
     * Identity (name + version) of every successfully-loaded plugin, parallel to
     * `loaded`. The host reads it to attribute a contribution to its plugin — e.g. the
     * nav provenance badge's "Plugin: name version". Empty before any plugin loads.
     */
    readonly plugins: readonly LoadedPlugin[];
    /** Plugin name → loud error message (version mismatch / load failure). */
    readonly errors: Readonly<Record<string, string>>;
    /** A registry-listing failure that is NOT a 401 (surfaced loudly, never hidden). */
    readonly registryError: string | null;
}
/**
 * The host loader pushes every load-pass transition here (it stays the single
 * driver); every subscriber is notified so feature pages re-render off it.
 */
export declare function setPluginHostState(state: PluginLoaderState): void;
/** The current mirrored host state — the snapshot {@link usePluginContributions} reads. */
export declare function getPluginHostState(): PluginLoaderState;
/**
 * Subscribe to host-state transitions; returns the unsubscribe function
 * `useSyncExternalStore` requires so a subscriber detaches on unmount.
 */
export declare function subscribePluginHost(listener: () => void): () => void;
/** Tests reset the module-level host state between cases. */
export declare function __resetPluginHostState(): void;
/** What {@link usePluginContributions} returns: the load status and the registry. */
export interface PluginContributionsSnapshot {
    /** The load pass's status; contributions are only complete once it is `'ready'`. */
    readonly status: PluginLoaderState['status'];
    /** The committed contributions, meaningful only when `status === 'ready'`. */
    readonly contributions: PluginContributions;
}
/**
 * Subscribe to the plugin host state and read the committed contributions. The
 * status drives re-renders as the load pass advances; `contributions` is only
 * meaningful once `status === 'ready'` (before then the pass has committed
 * nothing, so callers render their non-plugin content).
 */
export declare function usePluginContributions(): PluginContributionsSnapshot;
//# sourceMappingURL=host-state.d.ts.map