import type { CSSTransitionElementProps } from "../transition/types.js";
import type { CssPosition, UseStateInitializer } from "../types.js";
import type { LayoutNavProps } from "./LayoutNav.js";
import type { HorizontalLayoutTransitionOptions } from "./useHorizontalLayoutTransition.js";
import type { ProvidedTemporaryLayoutAppBarProps, ProvidedTemporaryLayoutMainProps, TemporaryLayoutImplementation, TemporaryLayoutOptions } from "./useTemporaryLayout.js";
/**
 * @remarks \@since 6.0.0
 */
export interface ExpandableLayoutOptions extends TemporaryLayoutOptions {
    /** @defaultValue `"fixed"` */
    appBarPosition?: CssPosition;
    /** @defaultValue `false` */
    defaultExpanded?: UseStateInitializer<boolean>;
    /**
     * Set this to `true` if the expandable navigation should be the full height
     * of the screen. This will also update the app bar so that it is not covered
     * by the navigation. The default behavior is to place the navigation below
     * the fixed header.
     *
     * @defaultValue `false`
     */
    fullHeightNav?: boolean;
    /** @see {@link HorizontalLayoutTransitionOptions} */
    transitionProps?: Omit<HorizontalLayoutTransitionOptions, "transitionIn">;
    /**
     * Set this to `"desktop"` if you want to use the temporary navigation until
     * the viewport is at least desktop width instead of tablet.
     *
     * @defaultValue `"tablet"`
     */
    temporaryUntil?: "tablet" | "desktop";
}
/**
 * @remarks \@since 6.0.0
 */
export interface ProvidedLayoutMainProps extends ProvidedTemporaryLayoutMainProps, CSSTransitionElementProps<HTMLElement> {
}
/**
 * @remarks \@since 6.0.0
 */
export type ProvidedLayoutNavProps = Pick<LayoutNavProps, "expanded" | "appBarOffset">;
/**
 * @remarks \@since 6.0.0
 */
export type ProvidedLayoutAppBarProps = ProvidedTemporaryLayoutAppBarProps & Partial<CSSTransitionElementProps<HTMLElement>>;
/**
 * @remarks \@since 6.0.0
 */
export interface ExpandableLayoutImplementation extends TemporaryLayoutImplementation {
    temporary: boolean;
    expanded: boolean;
    expandNavigation(): void;
    collapseNavigation(): void;
    toggleNavigation(): void;
    appBarProps: ProvidedLayoutAppBarProps;
    mainProps: ProvidedLayoutMainProps;
    expandableNavProps: ProvidedLayoutNavProps;
}
/**
 * @example
 * Main USage
 * ```tsx
 * import {
 *   AppBarTitle,
 *   Button,
 *   LayoutAppBar,
 *   LayoutNav,
 *   Main,
 *   Sheet,
 *   useExpandableLayout,
 * } from "@react-md/core";
 * import type { ReactElement, ReactNode } from "react";
 *
 * import { CustomNavigation } from "./CustomNavigation";
 *
 * export interface LayoutProps {
 *   children: ReactNode;
 * }
 *
 * export function Layout(props: LayoutProps): ReactElement {
 *   const { children } = props;
 *
 *   // choose whichever one for your app
 *   // nextjs app dir
 *   const pathname = usePathname();
 *   // nextjs pages
 *   const { pathname } = useRouter();
 *   // react router
 *   const { pathname } = useHistory();
 *
 *   const {
 *     temporary,
 *     appBarProps,
 *     expandableNavProps,
 *     mainProps,
 *     navToggleProps,
 *     temporaryNavProps,
 *     windowSplitterProps,
 *   } = useExpandableLayout({ pathname });
 *
 *   return {
 *     <>
 *       <LayoutAppBar {...appBarProps}>
 *         <Button {...navToggleProps} />
 *         <AppBarTitle>Hello, world!</AppBarTitle>
 *       </LayoutAppBar>
 *       <LayoutNav {...expandableNavProps}>
 *         <CustomNavigation />
 *       </LayoutNav>
 *       {temporary && (
 *         <Sheet {...temporaryNavProps}>
 *           <CustomNavigation />
 *         </Sheet>
 *       )}
 *       <Main {...mainProps}>{children}</Main>
 *     </>
 *   }
 * }
 * ```
 *
 * @remarks \@since 6.0.0
 * @see {@link useResizableLayout}
 */
export declare function useExpandableLayout(options: ExpandableLayoutOptions): ExpandableLayoutImplementation;
