/**
 * Leo ambience prefs — idle dots, thinking wash, composer veil.
 * Shell-global (same rationale as `shell:ask-leo-dock`).
 */
declare const LEO_AMBIENCE_KEY = "shell:leo-ambience";
declare const LEO_AMBIENCE_WINDOW_RECT_KEY = "shell:leo-ambience-window-rect";
declare const LEO_AMBIENCE_WINDOW_OPEN_KEY = "shell:leo-ambience-window-open";
type LeoBlobIntensity = "low" | "normal" | "high";
/**
 * The chip's lobe fills. Two levels, not three, because two is what the blob
 * field actually paints: `AnimatedBlobBackground` has `normal` and `high`, and
 * every other surface folds `low` into `normal`. Quieter than normal is the
 * strength slider's job, so the control offers what it can deliver.
 */
type LeoLauncherWashIntensity = "normal" | "high";
type LeoComposerVeil = "off" | "soft" | "strong";
type LeoBlobAnimationSpeed = "slow" | "normal" | "fast";
/** Leo Library / mode-switch search bar wash relative to the pill. */
type LeoSearchBarWashMode = "inside" | "outside";
/**
 * Thinking chrome on the Ask Leo panel / window.
 * `blobs` — gradient wash. `pulse` — breathing brand perimeter (Beam Pulse IA).
 * Search bar stays on bar blobs either way.
 */
type LeoThinkingAnimationStyle = "blobs" | "pulse";
interface LeoAmbiencePrefs {
    /** Soft cursor spotlight dots while Leo is idle. */
    idleDots: boolean;
    /** Relative density for idle dots (0.5 sparse → 3 dense). */
    idleDensity: number;
    /** Spotlight radius in px for idle dots. */
    idleGlowRadius: number;
    /** Gradient blob wash while Leo is thinking (and idle wash when enabled). */
    thinkingBlob: boolean;
    /** Panel thinking look — blobs wash or pulse border. */
    thinkingAnimationStyle: LeoThinkingAnimationStyle;
    thinkingBlobIntensity: LeoBlobIntensity;
    /** Layer opacity for thinking / idle blobs (0.05–1). Also pulse strength. */
    thinkingBlobOpacity: number;
    /** Cursor-spotlight dots while thinking (same field as idle). */
    thinkingOverlayDots: boolean;
    /** Opacity for thinking cursor dots (0.05–1). */
    thinkingOverlayDotsOpacity: number;
    /** Blob float / think keyframe animations. */
    blobAnimations: boolean;
    /** Multiplier on blob keyframe durations. */
    blobAnimationSpeed: LeoBlobAnimationSpeed;
    /** Blur veil under the composer. */
    composerVeil: LeoComposerVeil;
    /** Thinking wash on the Leo search / mode-switch bar. */
    searchBarWash: boolean;
    /** Paint wash inside the pill or around it (halo). */
    searchBarWashMode: LeoSearchBarWashMode;
    /**
     * Free offset of the search-bar wash in px (no snap presets).
     * Positive X → right, positive Y → down.
     */
    searchBarOffsetX: number;
    searchBarOffsetY: number;
    /** Soft brand sheen sweep while the search bar is thinking. */
    searchBarSheen: boolean;
    /** Thinking-dot overlay on the Leo search bar. */
    searchBarDots: boolean;
    /**
     * Blob field inside the utility bar's Ask Leo chip (`AskLeoLauncherWash`).
     *
     * Its own switch rather than a slice of `searchBarWash`: the chip is on every
     * page of the shell, the Leo search bar only exists inside Leo, so a reader
     * who finds the chip busy has no reason to lose the composer's wash too.
     */
    launcherWash: boolean;
    /** Lobe fills for the chip. `high` applies only while Leo is working. */
    launcherWashIntensity: LeoLauncherWashIntensity;
    /**
     * Scales the chip's contrast budget (`--ask-leo-chip-blob-opacity`), rather
     * than replacing it: the budget is a different number per theme and per
     * high-contrast mode, and a flat opacity here would strand the label's ink on
     * one of them. 1 is the shipped field.
     */
    launcherWashStrength: number;
    /** Sheen sweep across the chip while Leo is working. */
    launcherWashSheen: boolean;
    /**
     * Free offset of the chip's lobes in px. Its own range rather than the search
     * bar's: the composer pad moves the wash by up to 120px, which is more than a
     * chip is wide, so the same numbers would only ever park the field off it.
     */
    launcherWashOffsetX: number;
    launcherWashOffsetY: number;
    /**
     * Blob wash on the products-home greeting cover banner (`HomeGreetingShelfCard`).
     *
     * Its own switch: the banner only appears on campus / launcher / spotlight
     * homes, and tuning it should not require touching the Ask Leo panel wash.
     */
    greetingBannerWash: boolean;
    /**
     * Scales wash opacity on the greeting banner (same range as the Ask Leo chip).
     */
    greetingBannerWashStrength: number;
    /**
     * Free offset of the greeting-banner lobes in px. Sized like the search bar:
     * the cover is full width, so the chip's ±14px pad would barely move the field.
     */
    greetingBannerOffsetX: number;
    greetingBannerOffsetY: number;
}
/** Tuned from the Ask Leo appearance panel (dogfood). */
declare const LEO_AMBIENCE_DEFAULTS: LeoAmbiencePrefs;
/** Max |offset| for the free search-bar wash pad (px). */
declare const LEO_SEARCH_BAR_OFFSET_MAX = 120;
/**
 * Range for `launcherWashStrength`. The floor is a field you can still see
 * (below ~0.4 of the budget the chip reads as flat, at which point the switch is
 * the honest control); the ceiling is the point past which the brand fills start
 * to compete with the label they sit behind.
 */
declare const LEO_LAUNCHER_WASH_STRENGTH_MIN = 0.4;
declare const LEO_LAUNCHER_WASH_STRENGTH_MAX = 1.5;
/**
 * Max |offset| for the chip's placement pad (px). Sized against the control, not
 * the composer: the chip is 32px tall, so ±14 is the most that still leaves a
 * lobe overlapping the box it is meant to fill. Past that the pad would only
 * offer ways to empty the chip.
 */
declare const LEO_LAUNCHER_OFFSET_MAX = 14;
/** CSS `--leo-blob-anim-rate` multipliers (higher = slower). */
declare const LEO_BLOB_ANIM_RATE: Record<LeoBlobAnimationSpeed, number>;
declare function mergeLeoAmbiencePrefs(partial: Partial<LeoAmbiencePrefs> | null | undefined): LeoAmbiencePrefs;
declare function clampIdleDensity(value: number): number;
declare function clampIdleGlowRadius(value: number): number;
declare function clampThinkingBlobOpacity(value: number): number;
declare function clampThinkingOverlayDotsOpacity(value: number): number;
declare function clampLauncherWashStrength(value: number): number;
declare function clampSearchBarOffset(value: number): number;
declare function clampLauncherWashOffset(value: number): number;
/** Max |offset| for the greeting-banner placement pad (px). */
declare const LEO_GREETING_BANNER_OFFSET_MAX = 120;
declare function clampGreetingBannerOffset(value: number): number;
declare function clampGreetingBannerWashStrength(value: number): number;

export { LEO_AMBIENCE_DEFAULTS, LEO_AMBIENCE_KEY, LEO_AMBIENCE_WINDOW_OPEN_KEY, LEO_AMBIENCE_WINDOW_RECT_KEY, LEO_BLOB_ANIM_RATE, LEO_GREETING_BANNER_OFFSET_MAX, LEO_LAUNCHER_OFFSET_MAX, LEO_LAUNCHER_WASH_STRENGTH_MAX, LEO_LAUNCHER_WASH_STRENGTH_MIN, LEO_SEARCH_BAR_OFFSET_MAX, type LeoAmbiencePrefs, type LeoBlobAnimationSpeed, type LeoBlobIntensity, type LeoComposerVeil, type LeoLauncherWashIntensity, type LeoSearchBarWashMode, type LeoThinkingAnimationStyle, clampGreetingBannerOffset, clampGreetingBannerWashStrength, clampIdleDensity, clampIdleGlowRadius, clampLauncherWashOffset, clampLauncherWashStrength, clampSearchBarOffset, clampThinkingBlobOpacity, clampThinkingOverlayDotsOpacity, mergeLeoAmbiencePrefs };