/** CSS var names consumed by `ds-panel-nav` / `ds-bar-nav` inside `ds-shell-app`. */
import type { ShellGradientPreset } from './shell-gradient-presets';
export type { ShellGradientPreset } from './shell-gradient-presets';
export { DEFAULT_SHELL_GRADIENT_PRESET, SHELL_GRADIENT_PRESETS, SHELL_GRADIENT_PRESET_LABELS, buildShellRadialGradientForPreset, buildShellRadialGradientFromStops, isShellGradientPreset, shellGradientPresetOpacity, shellGradientPresetRecipe, shellGradientPresetStopToken, } from './shell-gradient-presets';
export declare const SHELL_GRADIENT_IMAGE_VAR = "--ds-shell-gradient-image";
export declare const SHELL_GRADIENT_SIZE_VAR = "--ds-shell-gradient-size";
export declare const SHELL_GRADIENT_POSITION_PANEL_VAR = "--ds-shell-gradient-position-panel";
export declare const SHELL_GRADIENT_POSITION_BAR_VAR = "--ds-shell-gradient-position-bar";
export declare const SHELL_GRADIENT_OPACITY_VAR = "--ds-shell-gradient-opacity";
/** Per chrome-surface background-position — offsets wash + grid to shell row origin. */
export declare const SHELL_CHROME_SURFACE_POSITION_VAR = "--ds-shell-chrome-surface-position";
/** Whether the shared chrome layer (secondary bg + optional wash) should mount. */
export declare function shellChromeLayerActive(preset: ShellGradientPreset): boolean;
/**
 * Shell radial wash — same for panel and bar nav.
 * Tokens follow `data-theme` (light/dark intent stops).
 */
export declare function buildShellRadialGradient(preset?: ShellGradientPreset): string;
/** Built-in radial image for the selected shell preset. */
export declare function shellGradientImage(preset?: ShellGradientPreset): string;
export interface ShellViewportDimensions {
    width: number;
    height: number;
}
/**
 * Viewport size for shell chrome with `background-attachment: fixed`.
 * Must not use the `ds-shell-app` element box — the shell can be shorter or
 * taller than the viewport when host height chains break or content overflows.
 */
export declare function readShellViewportDimensions(win?: Window): ShellViewportDimensions;
export interface ShellGradientLayout {
    width: number;
    height: number;
    panelWidth: number;
}
/** Pixel `background-size` for the fixed-attachment radial wash. */
export declare function shellGradientSize(layout: Pick<ShellGradientLayout, 'width' | 'height'>): string;
export declare function shellGradientPositionPanel(): string;
export declare function shellGradientPositionBar(panelWidth: number): string;
/** Phase-lock a chrome rect to the shell row coordinate system (wash + grid). */
export declare function shellChromeSurfacePosition(leftPx: number, topPx: number): string;
//# sourceMappingURL=shell-gradient.d.ts.map