themelia-react-ui 2.0.5 → 3.0.0

package/dist/components/layout/auth/auth.types.d.ts

@@ -201,7 +201,6 @@ export interface AuthShellProps extends Omit<HTMLAttributes<HTMLDivElement>, 'ti
     /** Third-party sign-in providers offered. */
     socialProviders?: AuthSocialProvider[];
     socialProvidersLayout?: AuthSocialProvidersLayout;
-    socialDivider?: ReactNode;
     /** Content for the panel beside the form in the split layout. */
     splitPanel?: ReactNode | AuthSplitPanelProps;
     splitSide?: AuthSplitSide;
@@ -210,12 +209,8 @@ export interface AuthShellProps extends Omit<HTMLAttributes<HTMLDivElement>, 'ti
     /** Merged onto the main region. */
     mainClassName?: string;
     stackClassName?: string;
-    cardClassName?: string;
-    cardContentClassName?: string;
     splitGridClassName?: string;
     splitPanelClassName?: string;
-    /** Merged onto the footer region. */
-    footerClassName?: string;
     /** Overrides this surface's own copy. */
     strings?: StringsProp<AuthShellStrings>;
 }

package/dist/components/layout/containers/inline-gutter-context.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Whether an ancestor measure already draws the page's inline gutter. A shell's
+ * contained measure provides it; Page reads it so the same inline space has one
+ * owner. An explicit `gutter` on Page still wins.
+ */
+export declare const InlineGutterContext: import("react").Context<boolean>;
+export declare function useInlineGutterOwned(): boolean;

package/dist/components/layout/containers/main-landmark-context.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Whether an ancestor already renders the page's `main` landmark. PageViewport
+ * provides it; nested layout owners read it so a page keeps a single main.
+ */
+export declare const MainLandmarkContext: import("react").Context<boolean>;
+export declare function useInsideMainLandmark(): boolean;

package/dist/components/layout/header/header.types.d.ts

@@ -4,7 +4,7 @@
  * This layer is intentionally framework-neutral: links and route state enter
  * through `renderLink`, and app-specific content enters through slots.
  */
-import type { ComponentType, HTMLAttributes, ReactNode } from 'react';
+import type { AriaAttributes, ComponentType, HTMLAttributes, ReactNode } from 'react';
 import type { StringsProp } from '../../../lib/strings';
 import type { SemanticTone } from '../../../lib/component-vocabulary';
 import type { BreadcrumbItem, LayoutNavigationAdapter, LayoutUser } from '../layout.types';
@@ -13,8 +13,9 @@ export interface HeaderBreadcrumbsProps extends LayoutNavigationAdapter {
     breadcrumbs?: BreadcrumbItem[];
     /** Root entry prepended to the trail. */
     homeBreadcrumb?: BreadcrumbItem | null;
-    /** Renders the sidebar collapse control. */
+    /** Renders the sidebar control when a provider or a trigger slot is present. @default true */
     showSidebarTrigger?: boolean;
+    /** Custom trigger content. Can be used without a sidebar provider. */
     triggerSlot?: ReactNode;
     className?: string;
 }
@@ -33,6 +34,12 @@ export interface HeaderNotification {
 }
 export interface HeaderNotificationsStrings {
     triggerLabel: string;
+    /**
+     * Names the trigger while notifications are unread; receives the count and
+     * `triggerLabel`. The default reads "Notifications, 2 unread", or
+     * "{triggerLabel} (2)" for a `triggerLabel` the consumer replaced.
+     */
+    triggerLabelUnread: (count: number, label: string) => string;
     heading: string;
     markAllRead: string;
     empty: string;
@@ -42,7 +49,7 @@ export declare const defaultHeaderNotificationsStrings: HeaderNotificationsStrin
 export interface HeaderNotificationsProps extends LayoutNavigationAdapter {
     /** Notifications to list, newest first. */
     notifications?: HeaderNotification[];
-    /** Unread total shown on the trigger. */
+    /** Unread total shown on the trigger and in its accessible name. Defaults to the notifications not marked `read`. */
     unreadCount?: number;
     onNotificationClick?: (notification: HeaderNotification) => void;
     onMarkAllRead?: () => void;
@@ -67,11 +74,15 @@ export interface HeaderSearchStrings {
     shortcutPc: string;
 }
 export declare const defaultHeaderSearchStrings: HeaderSearchStrings;
-export interface HeaderSearchProps {
+export interface HeaderSearchProps extends Pick<AriaAttributes, 'aria-expanded' | 'aria-haspopup' | 'aria-controls'> {
     onOpen?: () => void;
-    /** Modifier shown in the shortcut hint. Auto-detected when omitted. */
+    /**
+     * Modifier shown in the hint. Omitted, the hint follows the platform (⌘ on
+     * Apple platforms, Ctrl elsewhere) and either modifier opens search. Set, it
+     * is the only modifier the shortcut listens for.
+     */
     shortcutModifier?: 'meta' | 'control';
-    /** Binds the keyboard shortcut that opens search. */
+    /** Binds the keyboard shortcut that opens search. It does not fire while focus is in a field, an editor or an open menu or dialog. */
     enableShortcut?: boolean;
     /** Overrides this surface's own copy. */
     strings?: StringsProp<HeaderSearchStrings>;
@@ -82,7 +93,7 @@ export interface HeaderSearchProps {
     shortcutSlot?: ReactNode;
 }
 export interface HeaderGlobalSearchTriggerProps extends HeaderSearchProps {
-    /** Whether the surface is showing. Controlled. */
+    /** Whether the search surface is showing. Reported on the trigger as `aria-expanded` with `aria-haspopup="dialog"`; the consumer owns the surface. */
     open?: boolean;
     onOpenChange?: (open: boolean) => void;
 }
@@ -182,7 +193,7 @@ export interface HeaderProps extends LayoutNavigationAdapter, HTMLAttributes<HTM
     breadcrumbs?: BreadcrumbItem[];
     /** Root entry prepended to the trail. */
     homeBreadcrumb?: BreadcrumbItem | null;
-    /** Renders the sidebar collapse control. */
+    /** Renders the sidebar control when a sidebar provider is present. @default true */
     showSidebarTrigger?: boolean;
     /** Composes shell regions by container width: brand appears from 2xl/app-header (42rem default), center from 3xl/app-header (48rem default); left and right are always rendered when supplied. Keep essential narrow-width identity/navigation in left or right and supply compact/overflow behavior. */
     slots?: HeaderSlots;

package/dist/components/layout/header/partials/header-global-search-trigger.d.ts

@@ -1,2 +1,2 @@
 import type { HeaderGlobalSearchTriggerProps } from '../header.types';
-export declare function HeaderGlobalSearchTrigger({ onOpen, onOpenChange, ...props }: HeaderGlobalSearchTriggerProps): import("react").JSX.Element;
+export declare function HeaderGlobalSearchTrigger({ onOpen, open, onOpenChange, ...props }: HeaderGlobalSearchTriggerProps): import("react").JSX.Element;

package/dist/components/layout/header/partials/header-notifications.d.ts

@@ -1,2 +1,2 @@
 import { type HeaderNotificationsProps } from '../header.types';
-export declare function HeaderNotifications({ notifications, unreadCount, onNotificationClick, onMarkAllRead, onViewAll, viewAllHref, renderLink, align, side, strings: stringsProp, className, contentClassName, renderNotification, }: HeaderNotificationsProps): import("react").JSX.Element;
+export declare function HeaderNotifications({ notifications, unreadCount: unreadCountProp, onNotificationClick, onMarkAllRead, onViewAll, viewAllHref, renderLink, align, side, strings: stringsProp, className, contentClassName, renderNotification, }: HeaderNotificationsProps): import("react").JSX.Element;

package/dist/components/layout/header/partials/header-search.d.ts

@@ -1,2 +1,2 @@
 import { type HeaderSearchProps } from '../header.types';
-export declare function HeaderSearch({ onOpen, shortcutModifier, enableShortcut, strings: stringsProp, className, iconClassName, shortcutSlot, }: HeaderSearchProps): import("react").JSX.Element;
+export declare function HeaderSearch({ onOpen, shortcutModifier, enableShortcut, strings: stringsProp, className, iconClassName, shortcutSlot, 'aria-expanded': ariaExpanded, 'aria-haspopup': ariaHasPopup, 'aria-controls': ariaControls, }: HeaderSearchProps): import("react").JSX.Element;

package/dist/components/layout/hooks/use-command-shortcut.d.ts

@@ -3,5 +3,14 @@ export interface UseCommandShortcutOptions {
     enabled?: boolean;
     onTrigger?: () => void;
     preventDefault?: boolean;
+    /** Modifier that must be held: `mod` accepts Meta or Control. @default 'mod' */
+    modifier?: 'mod' | 'meta' | 'control';
+    /** Also fires while focus is in a field, an editor or an open menu, listbox or dialog. @default false */
+    allowInEditable?: boolean;
 }
-export declare function useCommandShortcut({ key, enabled, onTrigger, preventDefault, }: UseCommandShortcutOptions): void;
+/**
+ * Binds one Meta/Control shortcut on the document. It stays out of the way of
+ * typing: fields, editors and open menus keep the key, and so do key repeats,
+ * Shift/Alt chords and events another handler already took.
+ */
+export declare function useCommandShortcut({ key, enabled, onTrigger, preventDefault, modifier, allowInEditable, }: UseCommandShortcutOptions): void;

package/dist/components/layout/layout.types.d.ts

@@ -5,13 +5,13 @@
  * router package. Navigation is delegated to the consumer through
  * `renderLink`.
  */
-import type { ComponentType, HTMLAttributes, MouseEvent, ReactNode } from 'react';
+import type { AriaAttributes, ComponentType, HTMLAttributes, MouseEvent, ReactNode } from 'react';
 /** Native region props, including strongly typed consumer `data-*` hooks. */
 export type LayoutSlotAttributes<ElementType extends HTMLElement> = HTMLAttributes<ElementType> & {
     [Key in `data-${string}`]?: string | number | boolean | undefined;
 };
 export interface LayoutLinkRenderProps {
-    /** Destination URL. When omitted, render non-interactive content. */
+    /** Destination URL. Without a URL, the default renders a button when onClick is supplied. */
     href?: string;
     children: ReactNode;
     className?: string;
@@ -19,7 +19,9 @@ export interface LayoutLinkRenderProps {
     rel?: string;
     onClick?: (event: MouseEvent<HTMLAnchorElement>) => void;
     'aria-label'?: string;
-    /** Consumer hint for active styling; renderers may ignore it. */
+    /** Current-page state supplied by a navigation owner, ready to spread onto the link. */
+    'aria-current'?: AriaAttributes['aria-current'];
+    /** Consumer hint for active styling. The default renderer states it as `aria-current="page"` unless `aria-current` is given. */
     active?: boolean;
     /** Consumer hint to render as muted/non-interactive. */
     disabled?: boolean;
@@ -40,7 +42,7 @@ export interface LayoutNavigationAdapter {
     /** Renderer for framework-native links. */
     renderLink?: LayoutLinkRenderer;
 }
-/** Default link renderer — native anchor with disabled fallback. */
+/** Renders native links, callback buttons and inert entries. */
 export declare const defaultRenderLink: LayoutLinkRenderer;
 /** Resolve the consumer renderer or the native-anchor default. */
 export declare function resolveLayoutLinkRenderer({ renderLink, }?: LayoutNavigationAdapter): LayoutLinkRenderer;

package/dist/components/layout/navigation/breadcrumb-progress/breadcrumb-progress.d.ts

@@ -1,5 +1,5 @@
 import { type BreadcrumbProgressProps } from './types';
-export declare function BreadcrumbProgress({ steps, currentIndex, onStepClick, className, strings: stringsProp }: BreadcrumbProgressProps): import("react").JSX.Element;
+export declare function BreadcrumbProgress({ steps, currentIndex, onStepClick, className, strings: stringsProp }: BreadcrumbProgressProps): import("react").JSX.Element | null;
 export declare namespace BreadcrumbProgress {
     var displayName: string;
 }

package/dist/components/layout/navigation/breadcrumb-progress/types.d.ts

@@ -10,6 +10,14 @@ export interface BreadcrumbProgressStep {
 export interface BreadcrumbProgressStrings {
     stepLabel: string;
     ofLabel: string;
+    /** State named after a completed step for assistive technology. */
+    completedLabel: string;
+    /** State named after a step that is not reachable yet. */
+    upcomingLabel: string;
+    /** Formats the position line. Defaults to `{stepLabel} {current} {ofLabel} {total}`; supply it where that word order does not fit. */
+    formatProgress?: (current: number, total: number) => string;
+    /** Formats one step's accessible name. Defaults to `{stepLabel} {position}: {label}`. */
+    formatStepLabel?: (position: number, label: string) => string;
 }
 export declare const defaultBreadcrumbProgressStrings: BreadcrumbProgressStrings;
 export interface BreadcrumbProgressProps {
@@ -17,6 +25,7 @@ export interface BreadcrumbProgressProps {
     steps: BreadcrumbProgressStep[];
     /** Zero-based position of the active step. */
     currentIndex: number;
+    /** Makes completed and current steps buttons. Without it the trail is display-only text. */
     onStepClick?: (id: string, index: number) => void;
     className?: string;
     /** Overrides this surface's own copy. */

package/dist/components/layout/navigation/section-nav/section-nav.d.ts

@@ -1,7 +1,8 @@
 /**
  * SectionNav — sticky in-page anchor nav. Pass a list of section ids; the active one
  * is tracked via IntersectionObserver and the matching item is highlighted. Click to
- * scroll to that section. Pure JS — no router required.
+ * scroll to that section and move focus into it. Pure JS — no router required.
+ * Where IntersectionObserver does not exist, the current entry follows clicks only.
  *
  * A click owns the current state: the clicked section stays current while the smooth
  * scroll it started passes other sections, after that scroll settles (including when
@@ -28,6 +29,12 @@ export interface SectionNavProps extends Omit<ComponentPropsWithoutRef<'nav'>, '
     items: SectionNavItem[];
     rootMargin?: string;
     onSelect?: (id: string) => void;
+    /**
+     * Records the activated section in the URL hash with `history.replaceState`,
+     * so the position can be shared and restored. Leave it off under a hash
+     * router, where the hash is the route. @default false
+     */
+    updateHash?: boolean;
     /** Overrides this surface's own copy. */
     strings?: StringsProp<SectionNavStrings>;
 }

package/dist/components/layout/navigation/side-nav.d.ts

@@ -10,6 +10,7 @@
 import { type LucideIcon } from 'lucide-react';
 import { type ComponentPropsWithoutRef, type ReactNode } from 'react';
 import { type StringsProp } from '../../../lib/strings';
+import type { LayoutNavigationAdapter } from '../layout.types';
 export interface SideNavStrings {
     navigationLabel: string;
 }
@@ -36,8 +37,8 @@ export interface SideNavGroup {
     defaultCollapsed?: boolean;
     collapsible?: boolean;
 }
-interface SideNavSharedProps extends Omit<ComponentPropsWithoutRef<'nav'>, 'children'> {
-    /** Path of the active route, used to mark the current entry. */
+interface SideNavSharedProps extends Omit<ComponentPropsWithoutRef<'nav'>, 'children'>, LayoutNavigationAdapter {
+    /** Path supplied by the app. Omit it to leave every entry unmarked. */
     currentPath?: string;
     itemClassName?: string;
     activeItemClassName?: string;

package/dist/components/layout/normalize-layout-path.d.ts

@@ -0,0 +1 @@
+export declare function normalizeLayoutPath(rawUrl: string): string;

package/dist/components/layout/page/index.d.ts

@@ -1,5 +1,4 @@
 export { Page } from './page';
 export { PageHeader } from './partials/page-header';
-export { PageActions } from './partials/page-actions';
-export { defaultPageActionsStrings, type PageHeaderAction, type PageHeaderProps, type PageHeaderSlots, type PageHeaderRenderContext, type PageHeaderRenderSlot, type PageHeaderTabs, type PageActionsProps, type PageActionsDisplay, type PageAction, type PageActionContext, type PageActionsStrings, type PageProps, type PageSlotProps, type PageSlots, } from './page.types';
-export { defaultPageStrings, type PageStrings } from './page.strings';
+export type { PageHeaderAction, PageHeaderProps, PageHeaderSlots, PageHeaderRenderContext, PageHeaderRenderSlot, PageHeaderTabs, PageProps, PageSlotProps, PageSlots, } from './page.types';
+export { defaultPageHeaderStrings, defaultPageStrings, type PageHeaderStrings, type PageStrings } from './page.strings';

package/dist/components/layout/page/page.strings.d.ts

@@ -1,3 +1,15 @@
+/** Copy for PageHeader's own controls. */
+export interface PageHeaderStrings {
+    /** Accessible name of the back control. */
+    back: string;
+    /** Accessible name of the More actions menu trigger. */
+    moreActions: string;
+    /** Accessible name of the section tab list. */
+    sections: string;
+    /** Label of the trigger that holds section tabs which do not fit. */
+    moreSections: string;
+}
+export declare const defaultPageHeaderStrings: PageHeaderStrings;
 /** Copy for Page's primary-body lifecycle states. */
 export interface PageStrings {
     loadingLabel: string;

package/dist/components/layout/page/page.types.d.ts

@@ -1,27 +1,16 @@
 /**
- * Page-level types for `Page`, `PageHeader`, `PageActions`, and exported
- * partials. All navigation is framework-neutral via `renderLink`.
+ * Page-level types for `Page`, `PageHeader` and exported partials. All navigation is framework-neutral via `renderLink`.
  */
-import type { ComponentType, JSX, Key, ReactNode } from 'react';
+import type { ReactNode } from 'react';
 import type { LayoutLinkRenderer, LayoutNavigationAdapter, LayoutSlotAttributes } from '../layout.types';
 import type { TextGap } from '../../base/structure';
-import type { ButtonSize } from '../../base/buttons';
 import type { HeadingTag } from '../../typography';
 import type { ContainerGutter, ContainerMaxWidth, ContainerProps } from '../containers/containers.types';
 import type { StringsProp } from '../../../lib/strings';
-import type { BadgeTone } from '../../base/badge';
-import type { ActionPresentation } from '../../../lib/action-presentation';
 import type { PageHeaderAction } from '../../base/navigation/page-header';
 import type { OverflowTabItem } from '../../base/navigation';
 import type { TwoColumnLayoutProps } from '../containers';
-import type { PageStrings } from './page.strings';
-export interface PageTitleBadge {
-    /** Display label. */
-    label: ReactNode;
-    /** Semantic color intent. */
-    tone?: BadgeTone;
-    key?: Key;
-}
+import type { PageHeaderStrings, PageStrings } from './page.strings';
 export type { PageHeaderAction } from '../../base/navigation/page-header';
 /** Section tabs under a record's header. */
 export interface PageHeaderTabs {
@@ -34,10 +23,6 @@ export interface PageHeaderTabs {
      * an item `href` renders a native link.
      */
     onValueChange?: (id: string) => void;
-    /** Accessible name of the tab list. Default: `'Sections'`. */
-    label?: string;
-    /** Label of the trigger that holds tabs which do not fit. Default: `'More'`. */
-    moreLabel?: string;
 }
 export interface PageHeaderRenderContext {
     /** The framework-neutral link renderer used by this header. */
@@ -48,8 +33,6 @@ export interface PageHeaderRenderContext {
 /** A content node, or a render callback that can keep or replace its default content. */
 export type PageHeaderRenderSlot = ReactNode | ((context: PageHeaderRenderContext) => ReactNode);
 export interface PageHeaderSlots {
-    /** @deprecated Use backHref/onBack for navigation. Retained as a custom back-control escape hatch. */
-    back?: ReactNode;
     /** Context above the title, such as breadcrumbs. */
     beforeTitle?: PageHeaderRenderSlot;
     /** Content beside the title, such as a status or count. */
@@ -68,23 +51,9 @@ export interface PageHeaderProps extends LayoutNavigationAdapter {
     textGap?: TextGap;
     /** Semantic heading level for the title. Defaults to `h1`, the route's main heading; use `h2` when the page sits inside another titled page. */
     headingTag?: HeadingTag;
-    /** @deprecated Compose custom title content with slots.titleSuffix or a React-node title. */
-    titleIcon?: ComponentType<{
-        className?: string;
-    }>;
-    /** @deprecated Compose a linked item in a render slot using its renderLink context. */
-    titleIconHref?: string;
-    /** @deprecated Compose a command in slots.actions or describe it with primaryAction/secondaryActions. */
-    onTitleIconClick?: () => void;
-    /** @deprecated Accessible name for the compatibility title-icon control. */
-    titleIconLabel?: string;
     /** Destination for the back control. */
     backHref?: string;
     onBack?: () => void;
-    /** Copy for the back control. */
-    backLabel?: string;
-    /** @deprecated Render title content with slots.titleSuffix. Retained for existing badge definitions. */
-    titleBadges?: PageTitleBadge[];
     /**
      * The page's one main command: a solid primary button after the secondary
      * commands. Compact headers place it first in the More actions menu.
@@ -104,90 +73,23 @@ export interface PageHeaderProps extends LayoutNavigationAdapter {
      * keeps every routine command inline. @default 2
      */
     maxVisibleSecondaryActions?: number;
-    /** Accessible name of the More actions menu trigger. */
-    moreActionsLabel?: string;
     /**
      * Section tabs under the header, for a record split into sections such as
      * documents and history. Tabs that do not fit move into a More menu, and
      * the active tab stays visible.
      */
     tabs?: PageHeaderTabs;
-    /**
-     * @deprecated Customize commands with slots.actions; put other controls in Page toolbar.
-     */
-    actions?: ReactNode;
     /** Replaces individual regions of the shell. */
     slots?: PageHeaderSlots;
+    /** Copy for the header's own controls: the back control, the More actions menu and the section tabs. */
+    strings?: StringsProp<PageHeaderStrings>;
     className?: string;
     /** Merged onto the content region. */
     contentClassName?: string;
     actionsClassName?: string;
     titleClassName?: string;
-    titleIconClassName?: string;
     descriptionClassName?: string;
 }
-export interface PageActionContext {
-    index: number;
-    isInline: boolean;
-    renderLink: LayoutLinkRenderer;
-}
-/** @deprecated Use PageHeaderAction with `primaryAction` and `secondaryActions`. */
-export interface PageAction extends ActionPresentation {
-    id?: string;
-    /** Display label. */
-    label: ReactNode;
-    onClick?: () => void;
-    /** Destination for the entry, when it navigates. */
-    href?: string;
-    target?: string;
-    rel?: string;
-    external?: boolean;
-    /** Shows the pending indicator. */
-    loading?: boolean;
-    /** Leading glyph. */
-    icon?: ComponentType<{
-        className?: string;
-    }>;
-    /** Optional inline button size. Defaults to the PageActions `size` prop. */
-    size?: ButtonSize;
-    group?: string;
-    placement?: 'auto' | 'inline' | 'menu';
-    /** Escape hatch for one action only. Prefer `renderAction` for consistent customization. */
-    element?: ReactNode | JSX.Element;
-}
-export type PageActionsDisplay = 'flat' | 'dropdown' | 'auto';
-export interface PageActionsStrings {
-    menuLabel: string;
-}
-export declare const defaultPageActionsStrings: PageActionsStrings;
-export interface PageActionsProps extends LayoutNavigationAdapter {
-    /** Controls offered on the surface. */
-    actions?: PageAction[];
-    /** How actions are presented — inline, menu, or responsive. */
-    display?: PageActionsDisplay;
-    /**
-     * Inline action button scale, which the More actions square beside them
-     * matches. Defaults to `sm`; set `md` for normal page-header buttons. A
-     * menu-only ribbon follows the provider scale.
-     */
-    size?: ButtonSize;
-    /** Width at which responsive actions collapse into a menu. */
-    breakpoint?: number;
-    /**
-     * Maximum non-menu actions rendered inline before overflow moves them into
-     * the dropdown menu. Defaults to 4 for admin header density.
-     */
-    maxInlineActions?: number;
-    /** Overrides this surface's own copy. */
-    strings?: StringsProp<PageActionsStrings>;
-    className?: string;
-    /** Merged onto the inline action row. */
-    inlineClassName?: string;
-    /** Merged onto the action menu. */
-    menuClassName?: string;
-    /** Replaces the default action rendering. */
-    renderAction?: (action: PageAction, context: PageActionContext) => ReactNode;
-}
 export interface PageSlotProps {
     /** Native attributes merged onto the page body region. */
     body?: LayoutSlotAttributes<HTMLDivElement>;
@@ -198,12 +100,9 @@ export interface PageSlotProps {
 export interface PageSlots {
     /** Replaces the generated PageHeader. */
     header?: ReactNode;
-    toolbar?: ReactNode;
-    aside?: ReactNode;
     footer?: ReactNode;
     loading?: ReactNode;
     error?: ReactNode;
-    empty?: ReactNode;
 }
 export interface PageProps extends LayoutNavigationAdapter, Omit<ContainerProps, 'children'> {
     /** Header region of the shell. */
@@ -212,7 +111,7 @@ export interface PageProps extends LayoutNavigationAdapter, Omit<ContainerProps,
     maxWidth?: ContainerMaxWidth;
     /** Center one resource or form at the existing `md` content measure. */
     narrow?: boolean;
-    /** Inline page gutters. Defaults to `lg`; none requires an existing padded parent. */
+    /** Inline page gutters. Defaults to `lg`, or to `none` inside StackedLayout's contained measure, which already draws the gutter. An explicit value always wins; none requires an existing padded parent. */
     gutter?: ContainerGutter;
     /** Block padding around the whole page. Defaults to `lg`, independent of gutter. */
     padding?: ContainerGutter;
@@ -225,15 +124,13 @@ export interface PageProps extends LayoutNavigationAdapter, Omit<ContainerProps,
     toolbar?: ReactNode;
     /** Content above the header. */
     beforeHeader?: ReactNode;
-    /** Compatible toolbar fallback when toolbar and slots.toolbar are omitted. */
-    afterHeader?: ReactNode;
     /** Replaces only the primary body; header, toolbar and aside remain mounted. */
     loading?: boolean;
     error?: ReactNode | Error;
     onRetry?: () => void;
     empty?: boolean;
     emptySlot?: ReactNode;
-    /** Region overrides take precedence over direct props. */
+    /** Regions with no direct prop: a replacement header, a footer, and custom loading and error bodies. */
     slots?: PageSlots;
     /** Copy for the default loading, error and empty states. */
     strings?: StringsProp<PageStrings>;

package/dist/components/layout/page/partials/page-header.d.ts

@@ -1,2 +1,2 @@
 import type { PageHeaderProps } from '../page.types';
-export declare function PageHeader({ title, description, textGap, headingTag, titleIcon: TitleIcon, titleIconHref, onTitleIconClick, titleIconLabel, backHref, onBack, backLabel, titleBadges, primaryAction, secondaryActions, maxVisibleSecondaryActions, moreActionsLabel, tabs, actions, slots, renderLink, className, contentClassName, actionsClassName, titleClassName, titleIconClassName, descriptionClassName, }: PageHeaderProps): import("react").JSX.Element;
+export declare function PageHeader({ title, description, textGap, headingTag, backHref, onBack, primaryAction, secondaryActions, maxVisibleSecondaryActions, tabs, slots, strings: stringsProp, renderLink, className, contentClassName, actionsClassName, titleClassName, descriptionClassName, }: PageHeaderProps): import("react").JSX.Element;

package/dist/components/layout/settings/index.d.ts

@@ -1 +1 @@
-export { AsideNavShell, SettingsShell, defaultAsideNavShellStrings, type AsideNavGroup, type AsideNavItem, type AsideNavShellProps, type AsideNavShellStrings, type SettingsShellProps, } from './settings';
+export { AsideNavShell, defaultAsideNavShellStrings, type AsideNavGroup, type AsideNavItem, type AsideNavShellProps, type AsideNavShellStrings, } from './settings';

package/dist/components/layout/settings/settings.d.ts

@@ -1,9 +1,11 @@
-import type { ComponentType, ReactNode } from 'react';
+import { type ComponentType, type ReactNode } from 'react';
 import { type PageHeaderAction } from '../../base/navigation/page-header/page-header-commands';
 import { type StringsProp } from '../../../lib/strings';
 import { type LayoutNavigationAdapter } from '../layout.types';
 export interface AsideNavShellStrings {
     navigationAriaLabel: string;
+    /** Accessible name of the More actions menu trigger. */
+    moreActionsLabel: string;
 }
 export declare const defaultAsideNavShellStrings: AsideNavShellStrings;
 export interface AsideNavItem {
@@ -66,8 +68,6 @@ export interface AsideNavShellProps extends LayoutNavigationAdapter {
      * keeps every routine command inline. @default 2
      */
     maxVisibleSecondaryActions?: number;
-    /** Accessible name of the More actions menu trigger. Default: `'More actions'`. */
-    moreActionsLabel?: string;
     /** Content below the body. */
     footer?: ReactNode;
     className?: string;
@@ -78,9 +78,7 @@ export interface AsideNavShellProps extends LayoutNavigationAdapter {
     /** Overrides this surface's own copy. */
     strings?: StringsProp<AsideNavShellStrings>;
 }
-export type SettingsShellProps = AsideNavShellProps;
-export declare function AsideNavShell({ title, description, groups, currentId, currentPath, children, aside, actions, primaryAction, secondaryActions, maxVisibleSecondaryActions, moreActionsLabel, footer, className, navClassName, contentClassName, renderLink, strings: stringsProp, }: AsideNavShellProps): import("react").JSX.Element;
+export declare function AsideNavShell({ title, description, groups, currentId, currentPath, children, aside, actions, primaryAction, secondaryActions, maxVisibleSecondaryActions, footer, className, navClassName, contentClassName, renderLink, strings: stringsProp, }: AsideNavShellProps): import("react").JSX.Element;
 export declare namespace AsideNavShell {
     var displayName: string;
 }
-export declare const SettingsShell: typeof AsideNavShell;

package/dist/components/layout/sidebar/app-sidebar.d.ts

@@ -4,4 +4,4 @@
  */
 import * as React from 'react';
 import type { AppSidebarProps } from './sidebar.types';
-export declare function AppSidebar({ navigationGroups, 'aria-label': navigationLabel, footerNavItems, footerLabel, logo, collapsedLogo, workspaceLinks, workspaceStrings, workspaceContentClassName, headerClassName, logoClassName, iconMap, currentUrl, liveBadges, showBadges, menuDensity, renderLink, loading, collapsible, panelId, surface, variant, side, className, surfaceClassName, contentClassName, slots, renderItem, renderItemContent, searchable, searchValue, defaultSearchValue, onSearchValueChange, strings: stringsProp, expandedItems, defaultExpandedItems, onExpandedItemsChange, }: AppSidebarProps): React.JSX.Element;
+export declare function AppSidebar({ navigationGroups, 'aria-label': navigationLabel, footerNavItems, footerLabel, logo, collapsedLogo, workspaceLinks, workspaceStrings, workspaceContentClassName, headerClassName, iconMap, currentUrl, closeDrawerOnNavigate, liveBadges, menuDensity, renderLink, loading, collapsible, panelId, surface, variant, side, className, surfaceClassName, contentClassName, slots, renderItem, renderItemContent, searchable, searchValue, defaultSearchValue, onSearchValueChange, strings: stringsProp, expandedItems, defaultExpandedItems, onExpandedItemsChange, }: AppSidebarProps): React.JSX.Element;

package/dist/components/layout/sidebar/components/sidebar-grouped-navigation.d.ts

@@ -1,4 +1,4 @@
 /** Grouped navigation uses public disclosure and sidebar anatomy; routing stays app-owned. */
 import * as React from 'react';
 import { type SidebarGroupedNavigationProps } from '../sidebar.types';
-export declare function SidebarGroupedNavigation({ navigationByGroups, currentUrl, iconMap, liveBadges, showBadges, renderLink, emptySlot, renderItem, renderItemContent, className, menuDensity, expandedItems, defaultExpandedItems, onExpandedItemsChange, searchValue, strings: stringsProp, }: SidebarGroupedNavigationProps): string | number | bigint | boolean | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | React.JSX.Element | null;
+export declare function SidebarGroupedNavigation({ navigationByGroups, currentUrl, iconMap, liveBadges, renderLink, emptySlot, renderItem, renderItemContent, className, menuDensity, expandedItems, defaultExpandedItems, onExpandedItemsChange, searchValue, strings: stringsProp, }: SidebarGroupedNavigationProps): string | number | bigint | boolean | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | React.JSX.Element | null;

package/dist/components/layout/sidebar/components/sidebar-navigation-footer.d.ts

@@ -1,2 +1,2 @@
 import type { SidebarNavigationFooterProps } from '../sidebar.types';
-export declare function SidebarNavigationFooter({ items, label, currentUrl, iconMap, liveBadges, showBadges, renderLink, className, menuDensity, }: SidebarNavigationFooterProps): import("react").JSX.Element;
+export declare function SidebarNavigationFooter({ items, label, currentUrl, iconMap, liveBadges, renderLink, className, menuDensity, }: SidebarNavigationFooterProps): import("react").JSX.Element;

package/dist/components/layout/sidebar/components/sidebar-navigation.d.ts

@@ -1,4 +1,4 @@
 /** SidebarNavigation — flat, framework-neutral sidebar nav list. */
 import * as React from 'react';
 import type { SidebarFlatNavigationProps } from '../sidebar.types';
-export declare function SidebarNavigation({ items, label, currentUrl, iconMap, liveBadges, showBadges, renderLink, renderItem, renderItemContent, className, menuDensity, }: SidebarFlatNavigationProps): React.JSX.Element;
+export declare function SidebarNavigation({ items, label, currentUrl, iconMap, liveBadges, renderLink, renderItem, renderItemContent, className, menuDensity, }: SidebarFlatNavigationProps): React.JSX.Element;

package/dist/components/layout/sidebar/index.d.ts

@@ -1,7 +1,7 @@
 export { LayoutSidebar, type LayoutSidebarProps } from './sidebar';
 export { LayoutSidebarProvider, useLayoutSidebar, type LayoutSidebarContext, type LayoutSidebarProviderProps, } from './sidebar.context';
 export { AppSidebar } from './app-sidebar';
-export { SidebarNavigationRail, type SidebarNavigationRailItem, type SidebarNavigationRailProps } from './sidebar-navigation-rail';
+export { SidebarNavigationRail, defaultSidebarNavigationRailStrings, type SidebarNavigationRailItem, type SidebarNavigationRailProps, type SidebarNavigationRailStrings, } from './sidebar-navigation-rail';
 export { SidebarLogo, type SidebarLogoProps } from './components/sidebar-logo';
 export { SidebarWorkspaceDropdown } from './components/sidebar-workspace-dropdown';
 export { SidebarNavigation } from './components/sidebar-navigation';

package/dist/components/layout/sidebar/sidebar-navigation-rail.d.ts

@@ -1,23 +1,31 @@
 /** Primary area navigation, distinct from SidebarRail's collapse affordance. */
 import type { ComponentType } from 'react';
+import { type SidebarStrings } from '../../base/sidebar';
+import type { StringsProp } from '../../../lib/strings';
 import type { LayoutIconSource, LayoutNavigationAdapter } from '../layout.types';
 import { type LayoutSidebarProps } from './sidebar';
 import type { SidebarFlatNavItem, SidebarSlot } from './sidebar.types';
 export type SidebarNavigationRailItem = SidebarFlatNavItem & {
     /** Informative area icon; the full label remains accessible. */
     icon: LayoutIconSource;
-} & ({
+    /** Stable identity: the value reported by `onValueChange` and matched by `value`. */
     id: string;
-} | {
-    handle: string;
-});
+};
+/** The rail's own copy. The drawer copy of `SidebarStrings` shares the `strings` prop and passes through to the sidebar. */
+export interface SidebarNavigationRailStrings {
+    /** Name of the rail's navigation landmark. An `aria-label` on the rail wins. */
+    navigationLabel: string;
+}
+export declare const defaultSidebarNavigationRailStrings: SidebarNavigationRailStrings;
 export interface SidebarNavigationRailProps extends Omit<LayoutSidebarProps, 'children' | 'collapsible'>, LayoutNavigationAdapter {
     items: readonly SidebarNavigationRailItem[];
-    /** Selected item id (or its legacy handle). Controlled. */
+    /** Selected item id. Controlled. */
     value?: string;
     onValueChange?: (id: string) => void;
     /** Used for native current-route indication when value is omitted. */
     currentUrl?: string;
+    /** Close this already-open drawer when currentUrl, or the fallback value, changes. @default true */
+    closeDrawerOnNavigate?: boolean;
     iconMap?: Record<string, ComponentType<{
         className?: string;
     }>>;
@@ -30,7 +38,9 @@ export interface SidebarNavigationRailProps extends Omit<LayoutSidebarProps, 'ch
     };
     /** The rail stays visible by default; offcanvas makes the entire rail hideable. */
     collapsible?: 'none' | 'offcanvas';
-    /** Accessible name for this navigation region. @default 'Primary navigation' */
+    /** Accessible name for this navigation region. Defaults to `strings.navigationLabel` ('Primary navigation'). */
     'aria-label'?: string;
+    /** Overrides the sidebar's drawer copy and the rail's landmark name. */
+    strings?: StringsProp<SidebarStrings & SidebarNavigationRailStrings>;
 }
-export declare function SidebarNavigationRail({ items, value, onValueChange, currentUrl, renderLink, iconMap, slots, collapsible, 'aria-label': ariaLabel, className, surface, surfaceClassName, style, side, panelId, ...props }: SidebarNavigationRailProps): import("react").JSX.Element;
+export declare function SidebarNavigationRail({ items, value, onValueChange, currentUrl, closeDrawerOnNavigate, renderLink, iconMap, slots, collapsible, 'aria-label': ariaLabelProp, strings: stringsProp, className, surface, surfaceClassName, style, side, panelId, ...props }: SidebarNavigationRailProps): import("react").JSX.Element;