@salt-ds/lab 1.0.0-alpha.97 → 1.0.0-alpha.99

package/dist-types/mega-menu/MegaMenuAside.d.ts

@@ -1,9 +0,0 @@
-import { type ComponentPropsWithoutRef, type ReactNode } from "react";
-export interface MegaMenuAsideProps extends ComponentPropsWithoutRef<"aside"> {
-    /**
-     * The content. Renders to the left of `MegaMenuContent` when placed before
-     * it, and to the right when placed after.
-     */
-    children?: ReactNode;
-}
-export declare const MegaMenuAside: import("react").ForwardRefExoticComponent<MegaMenuAsideProps & import("react").RefAttributes<HTMLElement>>;

package/dist-types/mega-menu/MegaMenuContent.d.ts

@@ -1,9 +0,0 @@
-import { type ComponentPropsWithoutRef, type ReactNode } from "react";
-export interface MegaMenuContentProps extends ComponentPropsWithoutRef<"div"> {
-    /**
-     * The content of the mega menu navigation area, typically a `MegaMenuGroups`
-     * and an optional `MegaMenuActions`.
-     */
-    children?: ReactNode;
-}
-export declare const MegaMenuContent: import("react").ForwardRefExoticComponent<MegaMenuContentProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist-types/mega-menu/MegaMenuContext.d.ts

@@ -1,28 +0,0 @@
-import type { FloatingRootContext } from "@floating-ui/react";
-import type { Dispatch, HTMLProps, MutableRefObject, SetStateAction } from "react";
-import type { MegaMenuPlacement } from "./MegaMenu";
-export interface MegaMenuContextValue {
-    /** Whether the mega menu is currently open. */
-    openState: boolean;
-    /** Toggle or set the open state of the mega menu. */
-    setOpen: (open: boolean) => void;
-    /** The floating-ui root context for coordinating interactions. */
-    floatingRootContext: FloatingRootContext;
-    /** The placement of the mega menu panel relative to the trigger. */
-    placement: MegaMenuPlacement;
-    /** Props getter for the trigger (reference) element. Merges floating-ui interaction props with user props. */
-    getReferenceProps: (userProps?: HTMLProps<Element> | undefined) => Record<string, unknown>;
-    /** Props getter for the floating panel element. Merges floating-ui interaction props with user props. */
-    getFloatingProps: (userProps?: HTMLProps<HTMLElement> | undefined) => Record<string, unknown>;
-    /** Ref setter for the floating panel element. */
-    setFloating: Dispatch<SetStateAction<HTMLElement | null>>;
-    /** Ref setter for the trigger (reference) element. */
-    setReference: Dispatch<SetStateAction<HTMLElement | null>>;
-    /** Whether the first item should receive focus when the panel opens. */
-    focusFirstItemOnOpenRef: MutableRefObject<boolean>;
-    /** The id of the mega menu panel, used for aria-controls on the trigger. */
-    panelId: string | undefined;
-    /** Registers the panel's id so the trigger's aria-controls stays in sync. */
-    setPanelId: Dispatch<SetStateAction<string | undefined>>;
-}
-export declare const MegaMenuContext: import("react").Context<MegaMenuContextValue | undefined>;

package/dist-types/mega-menu/MegaMenuGroup.d.ts

@@ -1,9 +0,0 @@
-import { type ComponentPropsWithoutRef, type ReactNode } from "react";
-export interface MegaMenuGroupProps extends ComponentPropsWithoutRef<"div"> {
-    /**
-     * The content of the mega menu group: a `MegaMenuGroupHeading` and a
-     * `MegaMenuList` of `MegaMenuListItem`s.
-     */
-    children?: ReactNode;
-}
-export declare const MegaMenuGroup: import("react").ForwardRefExoticComponent<MegaMenuGroupProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist-types/mega-menu/MegaMenuGroupContext.d.ts

@@ -1,12 +0,0 @@
-export interface MegaMenuGroupContextValue {
-    /**
-     * The rendered heading's id, used to label the item list via `aria-labelledby`.
-     * `undefined` when the group has no `MegaMenuGroupHeading`.
-     */
-    headingId: string | undefined;
-    /** Register (or clear, with `undefined`) the heading's id. */
-    setHeadingId: (id: string | undefined) => void;
-}
-export declare const MegaMenuGroupContext: import("react").Context<MegaMenuGroupContextValue>;
-/** Access the nearest `MegaMenuGroup` context. */
-export declare function useMegaMenuGroup(): MegaMenuGroupContextValue;

package/dist-types/mega-menu/MegaMenuGroupHeading.d.ts

@@ -1,13 +0,0 @@
-import { type ComponentPropsWithoutRef, type ReactNode } from "react";
-export interface MegaMenuGroupHeadingProps extends ComponentPropsWithoutRef<"h2"> {
-    /**
-     * The content of the mega menu group heading.
-     */
-    children?: ReactNode;
-    /**
-     * The heading element to render.
-     * @default "h3"
-     */
-    as?: "h1" | "h2" | "h3" | "h4" | "h5" | "h6";
-}
-export declare const MegaMenuGroupHeading: import("react").ForwardRefExoticComponent<MegaMenuGroupHeadingProps & import("react").RefAttributes<HTMLHeadingElement>>;

package/dist-types/mega-menu/MegaMenuGroups.d.ts

@@ -1,8 +0,0 @@
-import { type ComponentPropsWithoutRef, type ReactNode } from "react";
-export interface MegaMenuGroupsProps extends ComponentPropsWithoutRef<"div"> {
-    /**
-     * The `MegaMenuGroup` columns of the mega menu.
-     */
-    children?: ReactNode;
-}
-export declare const MegaMenuGroups: import("react").ForwardRefExoticComponent<MegaMenuGroupsProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist-types/mega-menu/MegaMenuList.d.ts

@@ -1,16 +0,0 @@
-import { type PolymorphicComponentPropWithRef } from "@salt-ds/core";
-import { type ElementType, type FunctionComponent, type ReactNode } from "react";
-export type MegaMenuListProps<T extends ElementType = "ul"> = PolymorphicComponentPropWithRef<T, {
-    /**
-     * The items of the group, typically `MegaMenuListItem` components. Each
-     * `MegaMenuListItem` renders its own `<li>`.
-     */
-    children?: ReactNode;
-}>;
-type MegaMenuListComponent = <T extends ElementType = "ul">(props: MegaMenuListProps<T>) => ReturnType<FunctionComponent>;
-/**
- * The list of a group's `MegaMenuListItem`s. Renders a `<ul>` by default; pass
- * `as="ol"` for an ordered list.
- */
-export declare const MegaMenuList: MegaMenuListComponent;
-export {};

package/dist-types/mega-menu/MegaMenuListItem.d.ts

@@ -1,25 +0,0 @@
-import { type RenderPropsType } from "@salt-ds/core";
-import { type ComponentPropsWithoutRef, type MouseEventHandler, type ReactNode } from "react";
-export interface MegaMenuListItemProps extends Omit<ComponentPropsWithoutRef<"li">, "onClick"> {
-    /**
-     * The content of the mega menu item.
-     */
-    children?: ReactNode;
-    /**
-     * Whether the item is the current page. Sets `aria-current="page"`
-     */
-    current?: boolean;
-    /**
-     * Href passed to the link action element.
-     */
-    href?: string;
-    /**
-     * Called when the item's action is activated, before the menu closes.
-     */
-    onClick?: MouseEventHandler<HTMLAnchorElement>;
-    /**
-     * Render prop to enable customization of the underlying action element (e.g. a router `Link`).
-     */
-    render?: RenderPropsType["render"];
-}
-export declare const MegaMenuListItem: import("react").ForwardRefExoticComponent<MegaMenuListItemProps & import("react").RefAttributes<HTMLLIElement>>;

package/dist-types/mega-menu/MegaMenuPanel.d.ts

@@ -1,8 +0,0 @@
-import { type ComponentPropsWithoutRef, type ReactNode } from "react";
-export interface MegaMenuPanelProps extends ComponentPropsWithoutRef<"div"> {
-    /**
-     * The content of the mega menu panel.
-     */
-    children?: ReactNode;
-}
-export declare const MegaMenuPanel: import("react").ForwardRefExoticComponent<MegaMenuPanelProps & import("react").RefAttributes<HTMLDivElement>>;

package/dist-types/mega-menu/MegaMenuTrigger.d.ts

@@ -1,9 +0,0 @@
-import { type ReactNode } from "react";
-export interface MegaMenuTriggerProps {
-    /**
-     * The trigger element for the mega menu, typically a `NavigationItem` or `Button`.
-     * Wrap each mega menu in its own `<li>` — arrow-key navigation between triggers depends on it.
-     */
-    children?: ReactNode;
-}
-export declare const MegaMenuTrigger: import("react").ForwardRefExoticComponent<MegaMenuTriggerProps & import("react").RefAttributes<HTMLElement>>;

package/dist-types/mega-menu/index.d.ts

@@ -1,11 +0,0 @@
-export * from "./MegaMenu";
-export * from "./MegaMenuActions";
-export * from "./MegaMenuAside";
-export * from "./MegaMenuContent";
-export * from "./MegaMenuGroup";
-export * from "./MegaMenuGroupHeading";
-export * from "./MegaMenuGroups";
-export * from "./MegaMenuList";
-export * from "./MegaMenuListItem";
-export * from "./MegaMenuPanel";
-export * from "./MegaMenuTrigger";

package/dist-types/mega-menu/useMegaMenu.d.ts

@@ -1,6 +0,0 @@
-import { type MegaMenuContextValue } from "./MegaMenuContext";
-/**
- * Access the nearest MegaMenu context.
- * Must be used within a `MegaMenu` provider.
- */
-export declare function useMegaMenu(): MegaMenuContextValue;

package/dist-types/mega-menu/useMegaMenuNavigation.d.ts

@@ -1,16 +0,0 @@
-import type { ElementProps, FloatingRootContext } from "@floating-ui/react";
-export declare const FOCUSABLE_SELECTOR = "a[href], button:not([disabled]), [tabindex]:not([tabindex=\"-1\"])";
-export interface UseMegaMenuNavigationProps {
-    /**
-     * Whether the interaction is enabled.
-     * @default true
-     */
-    enabled?: boolean;
-}
-/**
- * Floating-ui interaction hook for mega menu keyboard navigation. Handles keys
- * on the panel only; the trigger keys are owned by `MegaMenuTrigger`.
- */
-export declare function useMegaMenuNavigation(context: FloatingRootContext, props?: UseMegaMenuNavigationProps): ElementProps;
-/** Focus the first navigable item inside a mega menu panel, retrying until rendered. */
-export declare function focusFirstItem(panel: HTMLElement, attempt?: number): void;

package/dist-types/mega-menu/usePageMargin.d.ts

@@ -1,6 +0,0 @@
-/**
- * Resolves the panel's page-margin token to pixels for floating-ui padding, to
- * handle token (`--saltMegaMenuPanel-pageMargin`) override by consumers
- * (edge to edge example).
- */
-export declare function usePageMargin(referenceEl: HTMLElement | null | undefined): number;