/**
 * Find the nearest `<pie-theme>` that owns `from`'s scheme, walking out
 * across shadow-root boundaries. `Element.closest()` alone stops at a
 * shadow root: a caller mounted inside its own `shadow: "open"` root would
 * never find a `<pie-theme>` ancestor that lives in the light DOM outside
 * it, so this repeats the search from each shadow root's host until it
 * either finds one or reaches the document.
 *
 * Falls back to a document-scoped `<pie-theme>` anywhere in the page, then
 * any `<pie-theme>` at all, matching how a page with exactly one theme host
 * is normally set up.
 */
export declare function resolvePieThemeHost(from?: Node | null): HTMLElement | null;
export interface ApplyPieColorSchemeOptions {
    /** Search from this node outward for the nearest `<pie-theme>` ancestor. */
    from?: Node | null;
    /** localStorage key to persist the requested scheme under. Pass `null` to skip persistence. */
    persistenceKey?: string | null;
}
/**
 * Apply a requested color scheme and persist it, the one canonical way —
 * shared by every caller that offers scheme selection outside `<pie-theme>`
 * itself (a picker tool, a demo host's own theme controls).
 */
export declare function applyPieColorScheme(schemeId: string, options?: ApplyPieColorSchemeOptions): void;