neatkit 0.8.0 → 0.10.0

package/dist/components/Progress/Progress.d.ts

@@ -0,0 +1,38 @@
+import { type HTMLAttributes } from "react";
+import "./styles/progress.css";
+/** A type representing the semantic color treatment applied to a Progress. */
+export type ProgressTone = "accent" | "info" | "success" | "warning" | "danger";
+/** A type representing properties for the Progress component. */
+export type ProgressProps = Omit<HTMLAttributes<HTMLDivElement>, "children"> & {
+    /** The completed value, or omitted while the completion is unknown. */
+    value?: number;
+    /** The maximum the completed value is measured against. */
+    max?: number;
+    /** The semantic color treatment applied to the completed portion. */
+    tone?: ProgressTone;
+};
+/**
+ * Renders a determinate or indeterminate progress indicator.
+ *
+ * Omitting `value` reports an indeterminate task, which animates instead of
+ * publishing a completion the consumer cannot yet calculate.
+ *
+ * Progress carries no accessible name of its own, because only the consumer
+ * knows which task is being measured. Name it with `aria-label` or
+ * `aria-labelledby` so the task is announced alongside its completion, and
+ * describe an unconventional scale with `aria-valuetext`.
+ *
+ * @param props - The properties that configure the Progress.
+ * @param forwardedReference - The reference assigned to the rendered element.
+ *
+ * @returns The rendered Progress indicator.
+ */
+declare const Progress: import("react").ForwardRefExoticComponent<Omit<HTMLAttributes<HTMLDivElement>, "children"> & {
+    /** The completed value, or omitted while the completion is unknown. */
+    value?: number;
+    /** The maximum the completed value is measured against. */
+    max?: number;
+    /** The semantic color treatment applied to the completed portion. */
+    tone?: ProgressTone;
+} & import("react").RefAttributes<HTMLDivElement>>;
+export default Progress;

package/dist/components/Progress/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from "./Progress";
+export type { ProgressProps, ProgressTone } from "./Progress";

package/dist/components/Progress/utils/value.d.ts

@@ -0,0 +1,25 @@
+/** The maximum a Progress value is measured against when none is given. */
+export declare const DEFAULT_PROGRESS_MAX = 100;
+/** A type representing the completion reported by a determinate Progress. */
+export type ProgressMeasurement = {
+    /** The maximum the completed value is measured against. */
+    max: number;
+    /** The completed value, clamped to the resolved range. */
+    value: number;
+    /** The completed portion of the range, as a percentage. */
+    percentage: number;
+};
+/**
+ * Resolves the completion a determinate Progress reports.
+ *
+ * Values outside the range are clamped rather than rejected, because progress
+ * computed from live totals overshoots on rounding often enough that failing
+ * would cost consumers a guard on every update.
+ *
+ * @param value - The completed value, or undefined while it is unknown.
+ * @param max - The maximum the completed value is measured against.
+ *
+ * @returns The resolved completion, or undefined when Progress is
+ * indeterminate.
+ */
+export declare function resolveProgressMeasurement(value: number | undefined, max: number): ProgressMeasurement | undefined;

package/dist/components/Select/Select.d.ts

@@ -1,78 +1,10 @@
-import { type ButtonHTMLAttributes, type CSSProperties, type ReactElement, type ReactNode, type RefAttributes, type SelectHTMLAttributes } from "react";
-import { type IconType } from "../Icon";
+import { type ReactElement, type RefAttributes } from "react";
+import { type CustomSelectProps } from "./components/CustomSelect";
+import { type NativeSelectProps } from "./components/NativeSelect";
 import "./styles/select.css";
-/** A type representing one option in a custom Select. */
-export type SelectOption = {
-    /** Whether the option is unavailable for selection. */
-    disabled?: boolean;
-    /** The optional icon displayed beside the option label. */
-    icon?: IconType;
-    /** The visible and accessible option label. */
-    label: string;
-    /** The form value represented by the option. */
-    value: string;
-};
-/** A type representing custom trigger content independent of selection. */
-export type SelectDisplayOverride = {
-    /** The optional icon displayed beside the trigger label. */
-    icon?: IconType;
-    /** The label displayed by the trigger. */
-    label: string;
-};
-/** A type representing the existing native Select mode properties. */
-export type NativeSelectProps = Omit<SelectHTMLAttributes<HTMLSelectElement>, "children" | "className" | "multiple" | "size" | "style"> & {
-    /** The native option and optgroup content displayed by the Select. */
-    children: ReactNode;
-    /** The additional class name applied to the composite Select root. */
-    className?: string;
-    /** Whether the Select exposes an invalid semantic and visual state. */
-    invalid?: boolean;
-    /** The disabled empty-value guidance displayed before selection. */
-    placeholder?: string;
-    /** The inline styles applied to the composite Select root. */
-    style?: CSSProperties;
-    /** Custom options select portal mode and cannot accompany children. */
-    options?: never;
-};
-/** A type representing the portal-backed custom Select mode properties. */
-export type CustomSelectProps = Omit<ButtonHTMLAttributes<HTMLButtonElement>, "children" | "className" | "defaultValue" | "onChange" | "style" | "value"> & {
-    /** Whether an outside pointer interaction closes the listbox. */
-    closeOnOutsideInteraction?: boolean;
-    /** Whether the Escape key closes the listbox. */
-    closeOnEscape?: boolean;
-    /** The additional class name applied to the composite Select root. */
-    className?: string;
-    /** The initially selected value for uncontrolled usage. */
-    defaultValue?: string;
-    /** The optional content displayed independently from the selected option. */
-    displayOverride?: SelectDisplayOverride;
-    /** Whether the Select exposes an invalid semantic and visual state. */
-    invalid?: boolean;
-    /** The native form name submitted through the custom Select. */
-    name?: string;
-    /** The callback invoked with a newly selected option value. */
-    onChange?: (value: string) => void;
-    /** The callback invoked whenever the listbox opens or closes. */
-    onOpenChange?: (open: boolean) => void;
-    /** The callback receiving Escape before its default closing behavior. */
-    onEscapeKeyDown?: (event: KeyboardEvent) => void;
-    /** The callback receiving an outside press before default behavior. */
-    onPointerDownOutside?: (event: PointerEvent) => void;
-    /** The options rendered by the portal-backed listbox. */
-    options: readonly SelectOption[];
-    /** The guidance displayed when no option is selected. */
-    placeholder?: string;
-    /** The inline styles applied to the composite Select root. */
-    style?: CSSProperties;
-    /** Whether the custom Select communicates that a value is required. */
-    required?: boolean;
-    /** The selected value for controlled usage. */
-    value?: string;
-    /** The width applied to the composite Select root. */
-    width?: CSSProperties["width"];
-    /** Native children belong to native mode and cannot accompany options. */
-    children?: never;
-};
+export type { CustomSelectProps, SelectDisplayOverride, } from "./components/CustomSelect";
+export type { NativeSelectProps } from "./components/NativeSelect";
+export type { SelectOption } from "./utils/options";
 /** A type representing properties accepted by either Select mode. */
 export type SelectProps = NativeSelectProps | CustomSelectProps;
 /** A type representing the public Select component overloads. */

package/dist/components/Select/components/CustomSelect.d.ts

@@ -0,0 +1,59 @@
+import { type ButtonHTMLAttributes, type CSSProperties, type ForwardedRef } from "react";
+import { type IconType } from "../../Icon";
+import { type SelectOption } from "../utils/options";
+/** A type representing custom trigger content independent of selection. */
+export type SelectDisplayOverride = {
+    /** The optional icon displayed beside the trigger label. */
+    icon?: IconType;
+    /** The label displayed by the trigger. */
+    label: string;
+};
+/** A type representing the portal-backed custom Select mode properties. */
+export type CustomSelectProps = Omit<ButtonHTMLAttributes<HTMLButtonElement>, "children" | "className" | "defaultValue" | "onChange" | "style" | "value"> & {
+    /** Whether an outside pointer interaction closes the listbox. */
+    closeOnOutsideInteraction?: boolean;
+    /** Whether the Escape key closes the listbox. */
+    closeOnEscape?: boolean;
+    /** The additional class name applied to the composite Select root. */
+    className?: string;
+    /** The initially selected value for uncontrolled usage. */
+    defaultValue?: string;
+    /** The optional content displayed independently from the selected option. */
+    displayOverride?: SelectDisplayOverride;
+    /** Whether the Select exposes an invalid semantic and visual state. */
+    invalid?: boolean;
+    /** The native form name submitted through the custom Select. */
+    name?: string;
+    /** The callback invoked with a newly selected option value. */
+    onChange?: (value: string) => void;
+    /** The callback invoked whenever the listbox opens or closes. */
+    onOpenChange?: (open: boolean) => void;
+    /** The callback receiving Escape before its default closing behavior. */
+    onEscapeKeyDown?: (event: KeyboardEvent) => void;
+    /** The callback receiving an outside press before default behavior. */
+    onPointerDownOutside?: (event: PointerEvent) => void;
+    /** The options rendered by the portal-backed listbox. */
+    options: readonly SelectOption[];
+    /** The guidance displayed when no option is selected. */
+    placeholder?: string;
+    /** The inline styles applied to the composite Select root. */
+    style?: CSSProperties;
+    /** Whether the custom Select communicates that a value is required. */
+    required?: boolean;
+    /** The selected value for controlled usage. */
+    value?: string;
+    /** The width applied to the composite Select root. */
+    width?: CSSProperties["width"];
+    /** Native children belong to native mode and cannot accompany options. */
+    children?: never;
+};
+/**
+ * Renders the options-driven, portal-backed Select mode.
+ *
+ * @param props - The custom Select properties and forwarded reference.
+ *
+ * @returns The rendered custom Select trigger and listbox portal.
+ */
+export default function CustomSelect(props: CustomSelectProps & {
+    forwardedReference: ForwardedRef<HTMLButtonElement>;
+}): import("react").JSX.Element;

package/dist/components/Select/components/NativeSelect.d.ts

@@ -0,0 +1,26 @@
+import type { CSSProperties, ForwardedRef, ReactNode, SelectHTMLAttributes } from "react";
+/** A type representing the existing native Select mode properties. */
+export type NativeSelectProps = Omit<SelectHTMLAttributes<HTMLSelectElement>, "children" | "className" | "multiple" | "size" | "style"> & {
+    /** The native option and optgroup content displayed by the Select. */
+    children: ReactNode;
+    /** The additional class name applied to the composite Select root. */
+    className?: string;
+    /** Whether the Select exposes an invalid semantic and visual state. */
+    invalid?: boolean;
+    /** The disabled empty-value guidance displayed before selection. */
+    placeholder?: string;
+    /** The inline styles applied to the composite Select root. */
+    style?: CSSProperties;
+    /** Custom options select portal mode and cannot accompany children. */
+    options?: never;
+};
+/**
+ * Renders a themed native single-selection control.
+ *
+ * @param props - The native Select properties and forwarded reference.
+ *
+ * @returns The rendered native Select control.
+ */
+export default function NativeSelect(props: NativeSelectProps & {
+    forwardedReference: ForwardedRef<HTMLSelectElement>;
+}): import("react").JSX.Element;

package/dist/components/Select/components/SelectListbox.d.ts

@@ -0,0 +1,50 @@
+import { type RefObject } from "react";
+import type { ListboxPosition } from "../utils/listbox-position";
+import type { SelectOption } from "../utils/options";
+/** A type representing properties used by a mounted custom listbox. */
+export type SelectListboxProps = {
+    /** Whether the listbox remains interactively open. */
+    active: boolean;
+    /** Whether Escape closes the listbox. */
+    closeOnEscape: boolean;
+    /** Whether outside pointer interaction closes the listbox. */
+    closeOnOutsideInteraction: boolean;
+    /** The highlighted option index. */
+    highlightedIndex: number;
+    /** The identifier assigned to the listbox. */
+    id: string;
+    /** The reference receiving the mounted listbox. */
+    listboxReference: (element: HTMLDivElement | null) => void;
+    /** The callback closing the listbox because of Escape. */
+    onEscapeDismiss: () => void;
+    /** The callback receiving Escape before default closing behavior. */
+    onEscapeKeyDown?: (event: KeyboardEvent) => void;
+    /** The callback updating the highlighted option. */
+    onHighlight: (index: number) => void;
+    /** The callback closing the listbox because of an outside press. */
+    onOutsideDismiss: () => void;
+    /** The callback receiving an outside press before default behavior. */
+    onPointerDownOutside?: (event: PointerEvent) => void;
+    /** The callback selecting an enabled option. */
+    onSelect: (option: SelectOption) => void;
+    /** The options displayed by the listbox. */
+    options: readonly SelectOption[];
+    /** The document owning the listbox layer. */
+    ownerDocument: Document;
+    /** The boundary-relative position fitted for the listbox. */
+    position: ListboxPosition | null;
+    /** The selected option value. */
+    selectedValue: string;
+    /** The visual phase exposed to transition styles. */
+    state: "closing" | "open";
+    /** The reference containing the Select trigger. */
+    triggerReference: RefObject<HTMLButtonElement | null>;
+};
+/**
+ * Renders one mounted custom Select listbox and its shared layer behavior.
+ *
+ * @param props - The listbox options, position, state, and callbacks.
+ *
+ * @returns The active or exiting custom listbox.
+ */
+export default function SelectListbox(props: SelectListboxProps): import("react").JSX.Element;

package/dist/components/Select/hooks/useSelectFormReset.d.ts

@@ -0,0 +1,27 @@
+import { type MutableRefObject, type RefObject } from "react";
+/** A type representing options accepted by the form reset hook. */
+export type SelectFormResetOptions = {
+    /**
+     * The form the Select is associated with.
+     *
+     * Observed rather than read, so the listener follows a reassociated form.
+     */
+    form?: string;
+    /** The callback restoring Select state alongside the proxied control. */
+    onReset: () => void;
+    /** The option value the proxied control defaults back to. */
+    resetValue: string;
+    /** The reference containing the Select trigger. */
+    triggerReference: RefObject<HTMLButtonElement | null>;
+};
+/**
+ * Restores the proxied form control and the Select on a native form reset.
+ *
+ * The listener follows the trigger's form rather than the proxied control's,
+ * because a Select submitting no value still restores what it displays.
+ *
+ * @param options - The reset value, form association, and restoration.
+ *
+ * @returns The reference assigned to the proxied form control.
+ */
+export declare function useSelectFormReset(options: SelectFormResetOptions): MutableRefObject<HTMLSelectElement | null>;

package/dist/components/Select/hooks/useSelectPosition.d.ts

@@ -0,0 +1,12 @@
+import { type ListboxPosition } from "../utils/listbox-position";
+/**
+ * Keeps a custom listbox aligned to its trigger and inside its boundary.
+ *
+ * @param active - Whether positioning observers should remain active.
+ * @param trigger - The trigger anchoring the listbox.
+ * @param listbox - The mounted listbox being positioned.
+ * @param boundary - The Boundary that constrains the listbox position.
+ *
+ * @returns The boundary-relative coordinates and size constraints.
+ */
+export declare function useSelectPosition(active: boolean, trigger: HTMLButtonElement | null, listbox: HTMLDivElement | null, boundary: HTMLElement | null): ListboxPosition | null;

package/dist/components/Select/hooks/useTypeahead.d.ts

@@ -0,0 +1,14 @@
+import { type RefObject } from "react";
+/**
+ * Accumulates typed characters into a query for incremental search.
+ *
+ * A run of one repeated character narrows to that single character, so
+ * pressing a key repeatedly cycles the entries beginning with it rather
+ * than searching for a query nothing can match.
+ *
+ * @param elementReference - The element whose realm owns the reset timer.
+ *
+ * @returns Records one character and returns the query to search for, or
+ * null when the element has no realm to schedule a reset in.
+ */
+export declare function useTypeahead(elementReference: RefObject<HTMLElement | null>): (character: string) => string | null;

package/dist/components/Select/utils/options.d.ts

@@ -0,0 +1,38 @@
+import type { IconType } from "../../Icon";
+/** A type representing one option in a custom Select. */
+export type SelectOption = {
+    /** Whether the option is unavailable for selection. */
+    disabled?: boolean;
+    /** The optional icon displayed beside the option label. */
+    icon?: IconType;
+    /** The visible and accessible option label. */
+    label: string;
+    /** The form value represented by the option. */
+    value: string;
+};
+/**
+ * Returns the next enabled option index in a requested direction.
+ *
+ * @param options - The options inspected for availability.
+ * @param currentIndex - The index from which navigation begins.
+ * @param direction - The movement direction through the options.
+ *
+ * @returns The next enabled index, or -1 when no enabled option exists.
+ */
+export declare function findEnabledOptionIndex(options: readonly SelectOption[], currentIndex: number, direction: 1 | -1): number;
+/**
+ * Returns the next enabled option whose label starts with a query.
+ *
+ * @param options - The options inspected for a matching label.
+ * @param query - The normalized typeahead query.
+ * @param currentIndex - The index after which matching begins.
+ *
+ * @returns The next matching index, or -1 when no option matches.
+ */
+export declare function findMatchingOptionIndex(options: readonly SelectOption[], query: string, currentIndex: number): number;
+/**
+ * Validates that option values identify exactly one custom Select option.
+ *
+ * @param options - The options whose values are inspected.
+ */
+export declare function validateSelectOptions(options: readonly SelectOption[]): void;

package/dist/components/Sidebar/Sidebar.d.ts

@@ -1,6 +1,7 @@
 import { type HTMLAttributes, type ReactNode, type RefObject } from "react";
 import SidebarFooter from "./components/SidebarFooter";
 import SidebarGroup from "./components/SidebarGroup";
+import SidebarHeader from "./components/SidebarHeader";
 import SidebarItem from "./components/SidebarItem";
 import { type SidebarSide, type SidebarStyle } from "./components/SidebarPanel";
 import SidebarTrigger from "./components/SidebarTrigger";
@@ -8,11 +9,13 @@ import SidebarUser from "./components/SidebarUser";
 import { type SidebarOpenChangeReason, type SidebarVariant } from "./utils/state";
 import "./styles/sidebar.css";
 export type { SidebarFooterProps } from "./components/SidebarFooter";
-export type { SidebarGroupPresentation, SidebarGroupProps, } from "./components/SidebarGroup";
+export type { SidebarGroupProps } from "./components/SidebarGroup";
+export type { SidebarHeaderProps } from "./components/SidebarHeader";
 export type { SidebarItemProps } from "./components/SidebarItem";
 export type { SidebarSide } from "./components/SidebarPanel";
 export type { SidebarTriggerProps } from "./components/SidebarTrigger";
 export type { SidebarUserAction, SidebarUserProps, } from "./components/SidebarUser";
+export type { SidebarPresentation } from "./utils/presentation";
 export type { SidebarOpenChangeReason, SidebarVariant } from "./utils/state";
 /** A type representing the complete compound Sidebar component. */
 type SidebarComponent = typeof SidebarRoot & {
@@ -20,6 +23,8 @@ type SidebarComponent = typeof SidebarRoot & {
     Footer: typeof SidebarFooter;
     /** A related set of Sidebar items forming one navigation region. */
     Group: typeof SidebarGroup;
+    /** The region rendered at the top of the Sidebar. */
+    Header: typeof SidebarHeader;
     /** One navigation destination or action inside a group. */
     Item: typeof SidebarItem;
     /** The control disclosing an overlay Sidebar. */
@@ -31,26 +36,29 @@ type SidebarComponent = typeof SidebarRoot & {
 export type SidebarProps = Omit<HTMLAttributes<HTMLElement>, "children" | "id" | "role" | "style" | "tabIndex"> & {
     /** The regions and groups composing the Sidebar. */
     children?: ReactNode;
+    /**
+     * Whether the Sidebar renders inline, as an overlay, or responsively. Where a
+     * responsive Sidebar switches at the medium breakpoint of its Boundary.
+     */
+    variant?: SidebarVariant;
+    /** The edge the overlay Sidebar occupies. */
+    side?: SidebarSide;
+    /** The width of the Sidebar in both presentations, as a CSS length. */
+    width?: string;
+    /** The height of the Sidebar in inline presentation, as a CSS length. */
+    height?: string;
+    /** The styles applied to the Sidebar panel. */
+    style?: SidebarStyle;
     /** Whether an uncontrolled overlay Sidebar is initially open. */
     defaultOpen?: boolean;
+    /** The controlled open state of the overlay Sidebar. */
+    open?: boolean;
     /** The preferred element focused when the overlay Sidebar opens. */
     initialFocusReference?: RefObject<HTMLElement | null>;
-    /** The distance the inline Sidebar is pinned below its scroll container. */
-    top?: string;
     /** Whether document scrolling is locked while the overlay is open. */
     lockScroll?: boolean;
-    /** The controlled open state of the overlay Sidebar. */
-    open?: boolean;
     /** Whether focus returns to the Trigger after the overlay closes. */
     restoreFocus?: boolean;
-    /** The edge the overlay Sidebar occupies. */
-    side?: SidebarSide;
-    /** The styles applied to the Sidebar panel. */
-    style?: SidebarStyle;
-    /** The responsive behavior selecting the Sidebar presentation. */
-    variant?: SidebarVariant;
-    /** The width of the Sidebar as a valid CSS length. */
-    width?: string;
     /** The callback invoked when an interaction requests a changed state. */
     onOpenChange?: (open: boolean, reason: SidebarOpenChangeReason) => void;
 };
@@ -80,26 +88,29 @@ export type SidebarProps = Omit<HTMLAttributes<HTMLElement>, "children" | "id" |
 declare const SidebarRoot: import("react").ForwardRefExoticComponent<Omit<HTMLAttributes<HTMLElement>, "id" | "style" | "tabIndex" | "role" | "children"> & {
     /** The regions and groups composing the Sidebar. */
     children?: ReactNode;
+    /**
+     * Whether the Sidebar renders inline, as an overlay, or responsively. Where a
+     * responsive Sidebar switches at the medium breakpoint of its Boundary.
+     */
+    variant?: SidebarVariant;
+    /** The edge the overlay Sidebar occupies. */
+    side?: SidebarSide;
+    /** The width of the Sidebar in both presentations, as a CSS length. */
+    width?: string;
+    /** The height of the Sidebar in inline presentation, as a CSS length. */
+    height?: string;
+    /** The styles applied to the Sidebar panel. */
+    style?: SidebarStyle;
     /** Whether an uncontrolled overlay Sidebar is initially open. */
     defaultOpen?: boolean;
+    /** The controlled open state of the overlay Sidebar. */
+    open?: boolean;
     /** The preferred element focused when the overlay Sidebar opens. */
     initialFocusReference?: RefObject<HTMLElement | null>;
-    /** The distance the inline Sidebar is pinned below its scroll container. */
-    top?: string;
     /** Whether document scrolling is locked while the overlay is open. */
     lockScroll?: boolean;
-    /** The controlled open state of the overlay Sidebar. */
-    open?: boolean;
     /** Whether focus returns to the Trigger after the overlay closes. */
     restoreFocus?: boolean;
-    /** The edge the overlay Sidebar occupies. */
-    side?: SidebarSide;
-    /** The styles applied to the Sidebar panel. */
-    style?: SidebarStyle;
-    /** The responsive behavior selecting the Sidebar presentation. */
-    variant?: SidebarVariant;
-    /** The width of the Sidebar as a valid CSS length. */
-    width?: string;
     /** The callback invoked when an interaction requests a changed state. */
     onOpenChange?: (open: boolean, reason: SidebarOpenChangeReason) => void;
 } & import("react").RefAttributes<HTMLElement>>;

package/dist/components/Sidebar/components/SidebarFooter.d.ts

@@ -1,8 +1,11 @@
 import { type HTMLAttributes, type ReactNode } from "react";
+import { type SidebarPresentation } from "../utils/presentation";
 /** A type representing properties for the Sidebar.Footer component. */
 export type SidebarFooterProps = HTMLAttributes<HTMLDivElement> & {
     /** The content pinned to the bottom of the Sidebar. */
     children?: ReactNode;
+    /** The presentations the footer is rendered in. */
+    presentation?: SidebarPresentation;
 };
 /**
  * Renders the region pinned to the bottom of a Sidebar.
@@ -15,5 +18,7 @@ export type SidebarFooterProps = HTMLAttributes<HTMLDivElement> & {
 declare const SidebarFooter: import("react").ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & {
     /** The content pinned to the bottom of the Sidebar. */
     children?: ReactNode;
+    /** The presentations the footer is rendered in. */
+    presentation?: SidebarPresentation;
 } & import("react").RefAttributes<HTMLDivElement>>;
 export default SidebarFooter;

package/dist/components/Sidebar/components/SidebarGroup.d.ts

@@ -1,19 +1,13 @@
 import { type HTMLAttributes, type ReactNode } from "react";
-/** A type representing the presentations that render a Sidebar group. */
-export type SidebarGroupPresentation = "both" | "inline" | "overlay";
+import { type SidebarPresentation } from "../utils/presentation";
 /** A type representing properties for the Sidebar.Group component. */
 export type SidebarGroupProps = Omit<HTMLAttributes<HTMLDivElement>, "children"> & {
     /** The Sidebar items rendered inside the group. */
     children?: ReactNode;
     /** The visible heading naming the group's navigation region. */
     label?: ReactNode;
-    /**
-     * The Sidebar presentations that render the group.
-     *
-     * Restricting a group suits navigation duplicated elsewhere in a wide
-     * layout, such as links an application bar already provides.
-     */
-    presentation?: SidebarGroupPresentation;
+    /** The presentations the group is rendered in. */
+    presentation?: SidebarPresentation;
 };
 /**
  * Renders a related set of Sidebar items as one navigation region.
@@ -31,12 +25,7 @@ declare const SidebarGroup: import("react").ForwardRefExoticComponent<Omit<HTMLA
     children?: ReactNode;
     /** The visible heading naming the group's navigation region. */
     label?: ReactNode;
-    /**
-     * The Sidebar presentations that render the group.
-     *
-     * Restricting a group suits navigation duplicated elsewhere in a wide
-     * layout, such as links an application bar already provides.
-     */
-    presentation?: SidebarGroupPresentation;
+    /** The presentations the group is rendered in. */
+    presentation?: SidebarPresentation;
 } & import("react").RefAttributes<HTMLElement>>;
 export default SidebarGroup;

package/dist/components/Sidebar/components/SidebarHeader.d.ts

@@ -0,0 +1,29 @@
+import { type HTMLAttributes, type ReactNode } from "react";
+import { type SidebarPresentation } from "../utils/presentation";
+/** A type representing properties for the Sidebar.Header component. */
+export type SidebarHeaderProps = HTMLAttributes<HTMLDivElement> & {
+    /** The content rendered at the top of the Sidebar. */
+    children?: ReactNode;
+    /** The presentations the header is rendered in. */
+    presentation?: SidebarPresentation;
+};
+/**
+ * Renders the region at the top of a Sidebar.
+ *
+ * The region holds whatever identifies the interface, such as a logo or a
+ * workspace switcher, and scrolls away with the navigation rather than
+ * pinning like the footer. Giving it an `id` and passing that to the
+ * Sidebar's `aria-labelledby` names the panel after the content shown here.
+ *
+ * @param props - The native properties that configure the header.
+ * @param forwardedReference - The reference assigned to the header element.
+ *
+ * @returns The rendered Sidebar header.
+ */
+declare const SidebarHeader: import("react").ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & {
+    /** The content rendered at the top of the Sidebar. */
+    children?: ReactNode;
+    /** The presentations the header is rendered in. */
+    presentation?: SidebarPresentation;
+} & import("react").RefAttributes<HTMLDivElement>>;
+export default SidebarHeader;

package/dist/components/Sidebar/components/SidebarItem.d.ts

@@ -1,5 +1,6 @@
 import { type ComponentPropsWithRef, type ComponentPropsWithoutRef, type ElementType, type ReactElement, type ReactNode } from "react";
 import { type IconType } from "../../Icon";
+import { type SidebarPresentation } from "../utils/presentation";
 /** A type representing properties owned by the Sidebar.Item component. */
 type SidebarItemOwnProps = {
     /** Whether the item represents the current page or view. */
@@ -10,6 +11,8 @@ type SidebarItemOwnProps = {
     disabled?: boolean;
     /** The icon displayed before the item label. */
     icon?: IconType;
+    /** The presentations the item is rendered in. */
+    presentation?: SidebarPresentation;
 };
 /** A type representing the reference accepted by a polymorphic element. */
 type SidebarItemReference<Component extends ElementType> = ComponentPropsWithRef<Component>["ref"];

package/dist/components/Sidebar/components/SidebarOverlay.d.ts

@@ -5,11 +5,10 @@ import { type SidebarPanelProps } from "./SidebarPanel";
  * A type representing properties for the mounted Sidebar overlay layer.
  *
  * The forwarded panel properties are derived rather than restated, so the
- * consumer attributes the root spreads through here stay described by one
- * declaration. The overlay supplies the presentation, open state, and
- * identifier itself, and a top offset applies to no overlay.
+ * consumer attributes that the root spreads through here, stay described by
+ * one declaration.
  */
-type SidebarOverlayProps = Omit<SidebarPanelProps, "top" | "open" | "panelId" | "panelReference" | "presentation" | "state"> & {
+type SidebarOverlayProps = Omit<SidebarPanelProps, "height" | "open" | "panelId" | "panelReference" | "presentation" | "state"> & {
     /** The elements treated as part of the overlay dismissal layer. */
     boundaries: readonly RefObject<HTMLElement | null>[];
     /** The preferred element focused when the Sidebar opens. */