/** * Shared TopBar stack heights and content-offset helpers. * * Use these to clear a fixed TopBar from page content, accounting for * expanded/collapsed chrome and whether Acesso Rápido (QuickActions) is shown. * * @remarks * For fixed-chrome pages (e.g. HomePage), prefer **measured** clearance via * `MeasuredLayoutProvider` + `useContentClearance` so padding tracks live * TopBar/BottomNav height (Acesso Rápido hide/show, grid vs horizontal, scroll * collapse). Keep these helpers as **fallback** before the first ResizeObserver * paint and for non-measured callers. */ /** QuickActionsBar layout mode — affects expanded TopBar height on xs. */ export type QuickActionsLayout = "grid" | "horizontal"; /** Responsive pixel heights for xs / sm / md breakpoints. */ export type ResponsivePx = { xs: number; sm: number; md: number; }; /** * Canonical TopBar-related heights (px) used for layout clearance. * * @remarks * - `collapsed` — TopBar chrome when the greeting section is collapsed * - `expanded` — legacy aggregate expanded height (prefer {@link getTopBarExpandedHeight}) * - `quickActionsCompact` — compact Acesso Rápido strip while collapsed * - `primaryOnly` — greeting/avatar row when QuickActions are hidden * (avatar 40px + CARD_PADDING vertical: xs 32 / sm+ 48, stepped for md) */ export declare const TOP_BAR_HEIGHTS: { readonly collapsed: { readonly xs: 56; readonly sm: 64; readonly md: 72; }; readonly expanded: { readonly xs: 180; readonly sm: 200; readonly md: 220; }; readonly quickActionsCompact: { readonly xs: 60; readonly sm: 64; }; readonly primaryOnly: { readonly xs: 72; readonly sm: 88; readonly md: 104; }; }; export type ContentOffsetParams = { /** Whether the TopBar greeting / full QuickActions section is expanded. */ isExpanded: boolean; /** * When false, offset clears primary TopBar only (no QuickActions strip). * @default true */ showQuickActions?: boolean; /** * QuickActionsBar layout; only affects expanded height when QuickActions are shown. * @default "horizontal" */ layout?: QuickActionsLayout; /** Extra px added after the stack height (breathing room under the bar). */ additionalOffset?: number; }; /** * Expanded TopBar height including full QuickActions, by layout. * * @param layout - QuickActionsBar layout (`grid` needs more xs height than `horizontal`) */ export declare const getTopBarExpandedHeight: (layout?: QuickActionsLayout) => ResponsivePx; /** * TopBar height for simple expanded/collapsed toggles (ignores QuickActions layout). * * @param isExpanded - Whether the TopBar is expanded */ export declare const getTopBarHeight: (isExpanded: boolean) => ResponsivePx; /** * Fixed TopBar stack height that page content must clear. * * - QuickActions hidden → primary greeting only * - Expanded + QuickActions → layout-aware expanded height * - Collapsed + QuickActions → collapsed chrome + compact QuickActions */ export declare const getTopBarStackHeight: ({ isExpanded, showQuickActions, layout, }: Pick) => ResponsivePx; /** * `padding-top` for page content under a fixed TopBar. * * @example * ```ts * getContentPaddingTop({ * isExpanded: true, * showQuickActions: false, * additionalOffset: 8, * }) * ``` */ export declare const getContentPaddingTop: ({ isExpanded, showQuickActions, layout, additionalOffset, }: ContentOffsetParams) => ResponsivePx; /** * Companion `margin-top` for content under a fixed TopBar. * * Uses full padding when expanded or when QuickActions are hidden * (TopBar does not collapse without QuickActions). Halves when collapsed * with QuickActions visible for a tighter scroll layout. */ export declare const getContentMarginTop: ({ isExpanded, showQuickActions, layout, additionalOffset, }: ContentOffsetParams) => ResponsivePx;