themelia-react-ui 0.0.0-stage → 1.0.0

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

@@ -0,0 +1,282 @@
+import type { ComponentPropsWithoutRef, HTMLAttributes, MouseEvent, ReactNode } from 'react';
+import type { StringsProp } from '../../../lib/strings';
+import type { ComponentScale } from '../../../lib/component-vocabulary';
+import type { LayoutNavigationAdapter } from '../layout.types';
+import type { AuthFooterLinksStrings, AuthMethodSwitchStrings, AuthShellStrings, AuthSocialProvidersStrings } from './auth.strings';
+/**
+ * `card` frames the form on a surface, `split` pairs it with a panel, and
+ * `bare` drops the chrome so the form sits directly on the page — the shape
+ * shadcn's login screens use, and the one to pick when the auth page is the
+ * whole product rather than a page inside it.
+ */
+export type AuthShellVariant = 'card' | 'split' | 'bare';
+/** Card chrome, or none. */
+export type AuthCardSurface = 'card' | 'bare';
+export type AuthShellSize = ComponentScale;
+export type AuthShellAlign = 'center' | 'start';
+export type AuthSplitSide = 'left' | 'right';
+export type AuthSplitMobile = 'hidden' | 'stacked';
+export type AuthSplitPanelSurface = 'card' | 'muted';
+export type AuthSocialProviderKind = 'google' | 'github' | 'microsoft' | 'apple' | 'sso' | 'custom';
+export type AuthSocialProvidersLayout = 'stack' | 'grid';
+export type AuthMethodSwitchLayout = 'stack' | 'grid' | 'segmented';
+export interface AuthBrandConfig {
+    /** Full product mark, shown when expanded. */
+    logo?: ReactNode;
+    /** Display label. */
+    label?: ReactNode;
+    /** Supporting copy under the title. */
+    description?: ReactNode;
+    /** Destination for the entry, when it navigates. */
+    href?: string;
+    /** Accessible name for the region. */
+    ariaLabel?: string;
+}
+export type AuthBrand = ReactNode | AuthBrandConfig;
+export type AuthFormProps = ComponentPropsWithoutRef<'form'>;
+export type AuthFormRowProps = ComponentPropsWithoutRef<'div'>;
+export interface AuthLink {
+    id?: string;
+    /** Display label. */
+    label: ReactNode;
+    /** Destination for the entry, when it navigates. */
+    href?: string;
+    target?: string;
+    rel?: string;
+    external?: boolean;
+    /** Disables the control. */
+    disabled?: boolean;
+    visible?: boolean;
+    onClick?: (event: MouseEvent<HTMLAnchorElement>) => void;
+}
+export interface AuthSocialProvider {
+    id?: string;
+    provider?: AuthSocialProviderKind;
+    /** Display label. */
+    label: ReactNode;
+    /** Destination for the entry, when it navigates. */
+    href?: string;
+    target?: string;
+    rel?: string;
+    external?: boolean;
+    /** Disables the control. */
+    disabled?: boolean;
+    visible?: boolean;
+    /** Leading glyph. */
+    icon?: ReactNode;
+    onClick?: (event: MouseEvent<HTMLButtonElement> | MouseEvent<HTMLAnchorElement>) => void;
+}
+export interface AuthMethodOption {
+    id: string;
+    /** Display label. */
+    label: ReactNode;
+    /** Supporting copy under the title. */
+    description?: ReactNode;
+    /** Leading glyph. */
+    icon?: ReactNode;
+    /** Disables the control. */
+    disabled?: boolean;
+    visible?: boolean;
+}
+export interface AuthCardProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title'> {
+    /** Drops the border, background and shadow while keeping the header/body rhythm. */
+    surface?: AuthCardSurface;
+    /** Small label above the title. */
+    eyebrow?: ReactNode;
+    /** Surface title. */
+    title?: ReactNode;
+    /** Supporting copy under the title. */
+    description?: ReactNode;
+    /** Content at the end of the header. */
+    headerEnd?: ReactNode;
+    /** Notice above the card body. */
+    banner?: ReactNode;
+    /** Illustration or imagery beside the form. */
+    media?: ReactNode;
+    /** Content below the body. */
+    footer?: ReactNode;
+    children?: ReactNode;
+    /** Merged onto the header region. */
+    headerClassName?: string;
+    mediaClassName?: string;
+    /** Merged onto the content region. */
+    contentClassName?: string;
+    /** Merged onto the footer region. */
+    footerClassName?: string;
+}
+export interface AuthSplitPanelFeature {
+    id?: string;
+    /** Leading glyph. */
+    icon?: ReactNode;
+    /** Surface title. */
+    title: ReactNode;
+    /** Supporting copy under the title. */
+    description?: ReactNode;
+}
+export interface AuthSplitPanelProps extends Omit<HTMLAttributes<HTMLElement>, 'title'> {
+    /** Small label above the title. */
+    eyebrow?: ReactNode;
+    /** Surface title. */
+    title?: ReactNode;
+    /** Supporting copy under the title. */
+    description?: ReactNode;
+    /** Illustration or imagery beside the form. */
+    media?: ReactNode;
+    features?: AuthSplitPanelFeature[];
+    /** Content below the body. */
+    footer?: ReactNode;
+    children?: ReactNode;
+    /** Outer chrome. */
+    surface?: AuthSplitPanelSurface;
+    /** Merged onto the content region. */
+    contentClassName?: string;
+}
+export interface AuthFooterLinksProps extends HTMLAttributes<HTMLElement>, LayoutNavigationAdapter {
+    /** Secondary links shown under the form. */
+    links?: AuthLink[];
+    leadingIcon?: ReactNode;
+    separator?: ReactNode;
+    /** Overrides this surface's own copy. */
+    strings?: StringsProp<AuthFooterLinksStrings>;
+}
+export interface AuthSocialProviderButtonProps extends LayoutNavigationAdapter {
+    provider: AuthSocialProvider;
+    className?: string;
+}
+export interface AuthSocialProvidersProps extends HTMLAttributes<HTMLDivElement>, LayoutNavigationAdapter {
+    providers?: AuthSocialProvider[];
+    layout?: AuthSocialProvidersLayout;
+    /** Overrides this surface's own copy. */
+    strings?: StringsProp<AuthSocialProvidersStrings>;
+}
+export interface AuthMethodSwitchProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange'> {
+    options?: AuthMethodOption[];
+    /** Current value. Controlled. */
+    value?: string | null;
+    defaultValue?: string;
+    onValueChange?: (value: string, option: AuthMethodOption) => void;
+    layout?: AuthMethodSwitchLayout;
+    divider?: ReactNode;
+    /** Overrides this surface's own copy. */
+    strings?: StringsProp<AuthMethodSwitchStrings>;
+}
+export interface AuthShellProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title'>, LayoutNavigationAdapter {
+    children?: ReactNode;
+    /** Shell treatment. */
+    variant?: AuthShellVariant;
+    /** Size preset. */
+    size?: AuthShellSize;
+    /** Alignment of the shell's content. */
+    align?: AuthShellAlign;
+    /** Logo, name, and href for the product mark. */
+    brand?: AuthBrand;
+    /** Small label above the title. */
+    eyebrow?: ReactNode;
+    /** Surface title. */
+    title?: ReactNode;
+    /** Supporting copy under the title. */
+    description?: ReactNode;
+    /** Content at the end of the header. */
+    headerEnd?: ReactNode;
+    /** Notice above the card body. */
+    banner?: ReactNode;
+    /** Illustration or imagery inside the auth card. */
+    cardMedia?: ReactNode;
+    /** Merged onto the card media. */
+    cardMediaClassName?: string;
+    /** Content below the auth card body. */
+    cardFooter?: ReactNode;
+    /** Content rendered after the auth card. */
+    postCard?: ReactNode;
+    /** Content below the body. */
+    footer?: ReactNode;
+    /** Links in the shell footer. */
+    footerLinks?: AuthLink[];
+    /** Legal links shown beside the footer links. */
+    policyLinks?: AuthLink[];
+    /** Locale options offered in the footer. */
+    languageLinks?: AuthLink[];
+    /** Replaces the default locale switcher. */
+    languageSwitcher?: ReactNode;
+    /** 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;
+    splitMobile?: AuthSplitMobile;
+    /** 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>;
+}
+export interface UseAuthMethodSwitchOptions {
+    options?: AuthMethodOption[];
+    /** Current value. Controlled. */
+    value?: string | null;
+    defaultValue?: string;
+    onValueChange?: (value: string, option: AuthMethodOption) => void;
+}
+export interface UseAuthMethodSwitchReturn {
+    /** Current value. Controlled. */
+    value?: string | null;
+    selectedOption?: AuthMethodOption;
+    options: AuthMethodOption[];
+    setValue: (value: string) => void;
+}
+export interface UseAuthLinksOptions extends LayoutNavigationAdapter {
+    /** Secondary links shown under the form. */
+    links?: AuthLink[];
+}
+export interface UseAuthLinksReturn {
+    /** Secondary links shown under the form. */
+    links: AuthLink[];
+    renderLink: NonNullable<LayoutNavigationAdapter['renderLink']>;
+}
+export interface UseAuthShellOptions extends LayoutNavigationAdapter {
+    /** Shell treatment. */
+    variant?: AuthShellVariant;
+    /** Logo, name, and href for the product mark. */
+    brand?: AuthBrand;
+    /** Content below the body. */
+    footer?: ReactNode;
+    /** Links in the shell footer. */
+    footerLinks?: AuthLink[];
+    /** Legal links shown beside the footer links. */
+    policyLinks?: AuthLink[];
+    /** Locale options offered in the footer. */
+    languageLinks?: AuthLink[];
+    /** Replaces the default locale switcher. */
+    languageSwitcher?: ReactNode;
+    /** Content rendered after the auth card. */
+    postCard?: ReactNode;
+    /** Third-party sign-in providers offered. */
+    socialProviders?: AuthSocialProvider[];
+    /** Content for the panel beside the form in the split layout. */
+    splitPanel?: ReactNode | AuthSplitPanelProps;
+}
+export interface UseAuthShellReturn {
+    /** Shell treatment. */
+    variant: AuthShellVariant;
+    hasBrand: boolean;
+    hasAfterCard: boolean;
+    hasSplitPanel: boolean;
+    hasSocialProviders: boolean;
+    renderLink: NonNullable<LayoutNavigationAdapter['renderLink']>;
+    /** Links in the shell footer. */
+    footerLinks: AuthLink[];
+    /** Legal links shown beside the footer links. */
+    policyLinks: AuthLink[];
+    /** Locale options offered in the footer. */
+    languageLinks: AuthLink[];
+    /** Third-party sign-in providers offered. */
+    socialProviders: AuthSocialProvider[];
+}

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

@@ -0,0 +1,10 @@
+export { AuthShell } from './auth-shell';
+export { AuthCard } from './auth-card';
+export { AuthForm, AuthFormRow } from './auth-form';
+export { AuthSplitPanel } from './auth-split-panel';
+export { AuthFooterLinks } from './auth-footer-links';
+export { AuthSocialProviderButton, AuthSocialProviders } from './auth-social-providers';
+export { AuthMethodSwitch, useAuthMethodSwitch } from './auth-method-switch';
+export { isAuthBrandConfig, useAuthLinks, useAuthShell, } from './auth-hooks';
+export { defaultAuthFooterLinksStrings, defaultAuthMethodSwitchStrings, defaultAuthShellStrings, defaultAuthSocialProvidersStrings, type AuthFooterLinksStrings, type AuthMethodSwitchStrings, type AuthShellStrings, type AuthSocialProvidersStrings, } from './auth.strings';
+export type { AuthBrand, AuthBrandConfig, AuthCardProps, AuthCardSurface, AuthFooterLinksProps, AuthFormProps, AuthFormRowProps, AuthLink, AuthMethodOption, AuthMethodSwitchLayout, AuthMethodSwitchProps, AuthSocialProvider, AuthSocialProviderButtonProps, AuthSocialProviderKind, AuthSocialProvidersLayout, AuthSocialProvidersProps, AuthShellAlign, AuthShellProps, AuthShellSize, AuthShellVariant, AuthSplitMobile, AuthSplitPanelFeature, AuthSplitPanelProps, AuthSplitPanelSurface, AuthSplitSide, UseAuthMethodSwitchOptions, UseAuthMethodSwitchReturn, UseAuthLinksOptions, UseAuthLinksReturn, UseAuthShellOptions, UseAuthShellReturn, } from './auth.types';

package/dist/components/layout/containers/container.recipes.d.ts

@@ -0,0 +1,5 @@
+import type { ContainerGutter, ContainerMaxWidth } from './containers.types';
+export declare function containerRecipe({ maxWidth, gutter, }: {
+    maxWidth?: ContainerMaxWidth;
+    gutter?: ContainerGutter;
+}): string[];

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

@@ -0,0 +1,17 @@
+import type { useRender } from '@base-ui/react/use-render';
+import type { ResponsiveValue, StructureGap } from '../../base/structure';
+import type { ComponentScale } from '../../../lib/component-vocabulary';
+export type ContainerMaxWidth = 'sm' | 'md' | 'lg' | 'xl' | '2xl' | 'full';
+export type ContainerGutter = 'none' | ComponentScale;
+export interface ContainerProps extends useRender.ComponentProps<'div'> {
+    /** Maximum readable content width. Defaults to `xl`. */
+    maxWidth?: ContainerMaxWidth;
+    /** Inline page gutter on the surface scale. Defaults to `md`. */
+    gutter?: ContainerGutter;
+}
+export interface PageViewportProps extends useRender.ComponentProps<'div'> {
+}
+export interface SectionProps extends useRender.ComponentProps<'section'> {
+    /** Vertical rhythm between the section's children. Defaults to `xl`. */
+    gap?: ResponsiveValue<StructureGap>;
+}

package/dist/components/layout/containers/content-container.d.ts

@@ -0,0 +1,3 @@
+import type { ContainerProps } from './containers.types';
+/** Container — one centered content-width and inline-gutter owner. */
+export declare const Container: import("react").ForwardRefExoticComponent<Omit<ContainerProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>;

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

@@ -0,0 +1,5 @@
+export { Container } from './content-container';
+export { PageViewport } from './page-viewport';
+export { Section } from './section';
+export { TwoColumnLayout, type TwoColumnLayoutProps, } from './two-column-layout';
+export type { ContainerGutter, ContainerMaxWidth, ContainerProps, PageViewportProps, SectionProps, } from './containers.types';

package/dist/components/layout/containers/page-viewport.d.ts

@@ -0,0 +1,3 @@
+import type { PageViewportProps } from './containers.types';
+/** PageViewport — the single page-scroll and page-container-query owner. */
+export declare const PageViewport: import("react").ForwardRefExoticComponent<Omit<PageViewportProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>;

package/dist/components/layout/containers/section.d.ts

@@ -0,0 +1,3 @@
+import type { SectionProps } from './containers.types';
+/** Section — a semantic vertical-rhythm owner for page content groups. */
+export declare const Section: import("react").ForwardRefExoticComponent<Omit<SectionProps, "ref"> & import("react").RefAttributes<HTMLElement>>;

package/dist/components/layout/containers/two-column-layout.d.ts

@@ -0,0 +1,27 @@
+import { useRender } from '@base-ui/react/use-render';
+import type { ReactNode } from 'react';
+import type { LayoutSlotAttributes } from '../layout.types';
+export interface TwoColumnLayoutSlotProps {
+    header?: LayoutSlotAttributes<HTMLDivElement>;
+    main?: LayoutSlotAttributes<HTMLDivElement>;
+    aside?: LayoutSlotAttributes<HTMLElement>;
+    footer?: LayoutSlotAttributes<HTMLDivElement>;
+}
+export interface TwoColumnLayoutProps extends useRender.ComponentProps<'div'> {
+    /** Optional content spanning both columns before the work regions. */
+    header?: ReactNode;
+    /** Primary detail, form, or index content. */
+    main: ReactNode;
+    /** Secondary summary, support, or action rail. */
+    aside: ReactNode;
+    /** Optional content spanning both columns after the work regions. */
+    footer?: ReactNode;
+    /** Keep the aside visible while the nearest page viewport scrolls. */
+    stickyAside?: boolean;
+    /** Preserve viewport breakpoints by default, or adapt inside Container/PageViewport. */
+    adaptTo?: 'viewport' | 'container';
+    /** Native attributes for each stable region. */
+    slotProps?: TwoColumnLayoutSlotProps;
+}
+/** TwoColumnLayout — one truthful, stable-order main/aside grid. */
+export declare const TwoColumnLayout: import("react").ForwardRefExoticComponent<Omit<TwoColumnLayoutProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>;

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

@@ -0,0 +1,2 @@
+import type { HeaderProps } from './header.types';
+export declare const Header: import("react").ForwardRefExoticComponent<HeaderProps & import("react").RefAttributes<HTMLElement>>;

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

@@ -0,0 +1,198 @@
+/**
+ * Header layout and partial types.
+ *
+ * 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 { StringsProp } from '../../../lib/strings';
+import type { SemanticTone } from '../../../lib/component-vocabulary';
+import type { BreadcrumbItem, LayoutNavigationAdapter, LayoutUser } from '../layout.types';
+export interface HeaderBreadcrumbsProps extends LayoutNavigationAdapter {
+    /** Trail entries, root first. */
+    breadcrumbs?: BreadcrumbItem[];
+    /** Root entry prepended to the trail. */
+    homeBreadcrumb?: BreadcrumbItem | null;
+    /** Renders the sidebar collapse control. */
+    showSidebarTrigger?: boolean;
+    triggerSlot?: ReactNode;
+    className?: string;
+}
+export type NotificationTone = Extract<SemanticTone, 'info' | 'success' | 'warning' | 'destructive'>;
+export interface HeaderNotification {
+    id: string | number;
+    /** Surface title. */
+    title: ReactNode;
+    /** Supporting copy under the title. */
+    description?: ReactNode;
+    time?: ReactNode;
+    read?: boolean;
+    tone?: NotificationTone;
+    /** Destination for the entry, when it navigates. */
+    href?: string;
+}
+export interface HeaderNotificationsStrings {
+    triggerLabel: string;
+    heading: string;
+    markAllRead: string;
+    empty: string;
+    viewAll: string;
+}
+export declare const defaultHeaderNotificationsStrings: HeaderNotificationsStrings;
+export interface HeaderNotificationsProps extends LayoutNavigationAdapter {
+    /** Notifications to list, newest first. */
+    notifications?: HeaderNotification[];
+    /** Unread total shown on the trigger. */
+    unreadCount?: number;
+    onNotificationClick?: (notification: HeaderNotification) => void;
+    onMarkAllRead?: () => void;
+    onViewAll?: () => void;
+    /** Destination for the view-all link. */
+    viewAllHref?: string;
+    /** Alignment of the shell's content. */
+    align?: 'start' | 'center' | 'end';
+    /** Which side of the trigger the surface opens on. */
+    side?: 'top' | 'right' | 'bottom' | 'left';
+    /** Overrides this surface's own copy. */
+    strings?: StringsProp<HeaderNotificationsStrings>;
+    className?: string;
+    /** Merged onto the content region. */
+    contentClassName?: string;
+    /** Replaces the default notification row. */
+    renderNotification?: (notification: HeaderNotification) => ReactNode;
+}
+export interface HeaderSearchStrings {
+    placeholder: string;
+    shortcutMac: string;
+    shortcutPc: string;
+}
+export declare const defaultHeaderSearchStrings: HeaderSearchStrings;
+export interface HeaderSearchProps {
+    onOpen?: () => void;
+    /** Modifier shown in the shortcut hint. Auto-detected when omitted. */
+    shortcutModifier?: 'meta' | 'control';
+    /** Binds the keyboard shortcut that opens search. */
+    enableShortcut?: boolean;
+    /** Overrides this surface's own copy. */
+    strings?: StringsProp<HeaderSearchStrings>;
+    className?: string;
+    /** Merged onto the icon. */
+    iconClassName?: string;
+    /** Replaces the shortcut hint shown in the trigger. */
+    shortcutSlot?: ReactNode;
+}
+export interface HeaderGlobalSearchTriggerProps extends HeaderSearchProps {
+    /** Whether the surface is showing. Controlled. */
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+}
+export interface HeaderToolButtonProps {
+    /** Display label. */
+    label: string;
+    /** Leading glyph. */
+    icon: ComponentType<{
+        className?: string;
+    }>;
+    /** Marks the control as currently engaged. */
+    active?: boolean;
+    /** Disables the control. */
+    disabled?: boolean;
+    /** Chip rendered beside the label. */
+    badge?: ReactNode;
+    onClick?: () => void;
+    className?: string;
+    /** Merged onto the icon. */
+    iconClassName?: string;
+}
+export interface HeaderToolPopoverProps {
+    /** Display label. */
+    label: string;
+    /** Leading glyph. */
+    icon: ComponentType<{
+        className?: string;
+    }>;
+    /** Whether the surface is showing. Controlled. */
+    open?: boolean;
+    /** Whether the surface starts open, for uncontrolled use. */
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    /** Marks the control as currently engaged. */
+    active?: boolean;
+    /** Disables the control. */
+    disabled?: boolean;
+    /** Chip rendered beside the label. */
+    badge?: ReactNode;
+    /** Alignment of the shell's content. */
+    align?: 'start' | 'center' | 'end';
+    /** Which side of the trigger the surface opens on. */
+    side?: 'top' | 'right' | 'bottom' | 'left';
+    sideOffset?: number;
+    className?: string;
+    /** Merged onto the trigger. */
+    triggerClassName?: string;
+    /** Merged onto the content region. */
+    contentClassName?: string;
+    children?: ReactNode;
+}
+export interface HeaderUserMenuProps {
+    /** The signed-in user shown in the menu. */
+    user: LayoutUser;
+    /** Shows the signed-in email under the name. */
+    showEmail?: boolean;
+    /** Extra content appended inside the menu. */
+    customContent?: ReactNode;
+    onProfile?: () => void;
+    onSettings?: () => void;
+    onLogout?: () => void;
+    /** Alignment of the shell's content. */
+    align?: 'start' | 'center' | 'end';
+    /** Which side of the trigger the surface opens on. */
+    side?: 'top' | 'right' | 'bottom' | 'left';
+    /** Overrides this surface's own copy. */
+    strings?: StringsProp<HeaderUserMenuStrings>;
+    /** Merged onto the trigger. */
+    triggerClassName?: string;
+    /** Merged onto the content region. */
+    contentClassName?: string;
+    /** Replaces the default trigger element. */
+    renderTrigger?: (user: LayoutUser) => ReactNode;
+}
+export interface HeaderUserMenuStrings {
+    profile: string;
+    settings: string;
+    logout: string;
+}
+export declare const defaultHeaderUserMenuStrings: HeaderUserMenuStrings;
+export interface HeaderSlots {
+    /** Leading brand/logo region before breadcrumbs. */
+    brand?: ReactNode;
+    /** Replaces the breadcrumb/sidebar-trigger region. */
+    breadcrumbs?: ReactNode;
+    /** Leading content after breadcrumbs. */
+    left?: ReactNode;
+    /** Center content, usually search or a scope switcher. */
+    center?: ReactNode;
+    /** Trailing content, usually notifications/user menu/actions. */
+    right?: ReactNode;
+}
+export interface HeaderProps extends LayoutNavigationAdapter, HTMLAttributes<HTMLElement> {
+    /** Renders the breadcrumb trail. */
+    showBreadcrumbs?: boolean;
+    /** Trail entries, root first. */
+    breadcrumbs?: BreadcrumbItem[];
+    /** Root entry prepended to the trail. */
+    homeBreadcrumb?: BreadcrumbItem | null;
+    /** Renders the sidebar collapse control. */
+    showSidebarTrigger?: boolean;
+    /** Replaces individual regions of the shell. */
+    slots?: HeaderSlots;
+    className?: string;
+    /** Merged onto the content region. */
+    contentClassName?: string;
+    /** Merged onto the leading region. */
+    leftClassName?: string;
+    /** Merged onto the centre region. */
+    centerClassName?: string;
+    rightClassName?: string;
+    breadcrumbsClassName?: string;
+}

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

@@ -0,0 +1,9 @@
+export { Header } from './header';
+export { HeaderBreadcrumbs } from './partials/header-breadcrumbs';
+export { HeaderGlobalSearchTrigger } from './partials/header-global-search-trigger';
+export { HeaderSearch } from './partials/header-search';
+export { HeaderToolButton } from './partials/header-tool-button';
+export { HeaderToolPopover } from './partials/header-tool-popover';
+export { HeaderUserMenu } from './partials/header-user-menu';
+export { HeaderNotifications } from './partials/header-notifications';
+export { defaultHeaderNotificationsStrings, defaultHeaderSearchStrings, defaultHeaderUserMenuStrings, type HeaderProps, type HeaderSlots, type HeaderBreadcrumbsProps, type HeaderGlobalSearchTriggerProps, type HeaderSearchProps, type HeaderSearchStrings, type HeaderToolButtonProps, type HeaderToolPopoverProps, type HeaderNotification, type HeaderNotificationsProps, type HeaderNotificationsStrings, type HeaderUserMenuProps, type HeaderUserMenuStrings, type NotificationTone, } from './header.types';

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

@@ -0,0 +1,4 @@
+/** HeaderBreadcrumbs — breadcrumbs trail with optional sidebar trigger. */
+import * as React from 'react';
+import type { HeaderBreadcrumbsProps } from '../header.types';
+export declare function HeaderBreadcrumbs({ breadcrumbs, homeBreadcrumb, showSidebarTrigger, triggerSlot, renderLink, className, }: HeaderBreadcrumbsProps): React.JSX.Element;

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

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

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

@@ -0,0 +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;

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

@@ -0,0 +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;

package/dist/components/layout/header/partials/header-tool-button.d.ts

@@ -0,0 +1,4 @@
+/** HeaderToolButton — icon control for dense app headers. */
+import * as React from 'react';
+import type { HeaderToolButtonProps } from '../header.types';
+export declare const HeaderToolButton: React.ForwardRefExoticComponent<HeaderToolButtonProps & React.RefAttributes<HTMLButtonElement>>;

package/dist/components/layout/header/partials/header-tool-popover.d.ts

@@ -0,0 +1,2 @@
+import type { HeaderToolPopoverProps } from '../header.types';
+export declare function HeaderToolPopover({ label, icon, open, defaultOpen, onOpenChange, active, disabled, badge, align, side, sideOffset, className, triggerClassName, contentClassName, children, }: HeaderToolPopoverProps): import("react").JSX.Element;

package/dist/components/layout/header/partials/header-user-menu.d.ts

@@ -0,0 +1,2 @@
+import { type HeaderUserMenuProps } from '../header.types';
+export declare function HeaderUserMenu({ user, showEmail, customContent, onProfile, onSettings, onLogout, align, side, strings: stringsProp, triggerClassName, contentClassName, renderTrigger, }: HeaderUserMenuProps): import("react").JSX.Element;

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

@@ -0,0 +1,3 @@
+export { useLayoutLinkRenderer } from './use-layout-link';
+export { useActivePath } from './use-active-path';
+export { useCommandShortcut, type UseCommandShortcutOptions } from './use-command-shortcut';

package/dist/components/layout/hooks/use-active-path.d.ts

@@ -0,0 +1 @@
+export declare function useActivePath(currentUrl?: string): (href?: string) => boolean;

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

@@ -0,0 +1,7 @@
+export interface UseCommandShortcutOptions {
+    key: string;
+    enabled?: boolean;
+    onTrigger?: () => void;
+    preventDefault?: boolean;
+}
+export declare function useCommandShortcut({ key, enabled, onTrigger, preventDefault, }: UseCommandShortcutOptions): void;

package/dist/components/layout/hooks/use-layout-link.d.ts

@@ -0,0 +1,2 @@
+import { type LayoutLinkRenderer, type LayoutNavigationAdapter } from '../layout.types';
+export declare function useLayoutLinkRenderer({ renderLink, }?: LayoutNavigationAdapter): LayoutLinkRenderer;

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

@@ -0,0 +1,24 @@
+/**
+ * Layout — framework-neutral app shell primitives.
+ *
+ * Consumers compose these into app-specific shells and provide framework
+ * navigation through `renderLink`, e.g.:
+ *
+ *   <AppSidebar
+ *     navigationGroups={groups}
+ *     renderLink={({ href, children, className }) => (
+ *       <AppLink href={href ?? '#'} className={className}>{children}</AppLink>
+ *     )}
+ *   />
+ */
+export * from './layout.types';
+export * from './hooks';
+export * from './app-shell';
+export * from './containers';
+export * from './page';
+export * from './settings';
+export * from './header';
+export * from './navigation';
+export * from './sidebar';
+export * from './auth';
+export * from './workspace';