@exegia/corpora-ui 0.16.0 → 0.18.0

package/dist-lib/components/blocks/nav/sidebar-block.d.ts

@@ -8,7 +8,7 @@ export type { ISidebarBlockProps as SidebarBlockProps, ISidebarNavItem as Sideba
  * beside your own content. It owns its own sidebar context (⌘B toggles it);
  * pass `open`/`onOpenChange` to drive the rail, and `openMobile`/
  * `onOpenMobileChange` to open the drawer from a header button of your own.
- * Compose the underlying `AnimatedSidebar*` parts directly when a screen
+ * Compose the underlying `AnimatedPanel*` parts directly when a screen
  * needs something this API does not cover.
  */
 export declare function SidebarBlock({ sections, activeId, onNavigate, header, footer, showTrigger, side, variant, collapsible, open, defaultOpen, onOpenChange, openMobile, defaultOpenMobile, onOpenMobileChange, width, iconWidth, mobileWidth, ariaLabel, className, }: ISidebarBlockProps): React.ReactElement;

package/dist-lib/components/blocks/scaffold/__tests__/scaffold.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist-lib/components/blocks/scaffold/constants.d.ts

@@ -0,0 +1,20 @@
+/** Icon-rail width in px (the rail sits directly on the desktop backdrop). */
+export declare const SCAFFOLD_SIDEBAR_WIDTH = 64;
+/** Inspector drawer width in px. */
+export declare const SCAFFOLD_INSPECTOR_WIDTH = 272;
+/** Gap in px between the drawer/actions and the viewport edges. */
+export declare const SCAFFOLD_EDGE_GUTTER = 10;
+/** Vertical room in px reserved above the canvas for the actions cluster. */
+export declare const SCAFFOLD_HEADER_HEIGHT = 52;
+/** Height in px of a panel's secondary strip. */
+export declare const SCAFFOLD_SECONDARY_HEIGHT = 52;
+/** Gap in px between a panel's primary surface and its secondary strip. */
+export declare const SCAFFOLD_PANEL_GAP = 10;
+/** How long the seam menu lingers expanded after the pointer leaves it (ms)
+ * before it collapses back to the compact toggle. The timer keeps counting
+ * even when the pointer leaves the window entirely. */
+export declare const SCAFFOLD_MENU_COLLAPSE_DELAY = 4000;
+/** Morph duration in seconds for drawer slides and panel layout shifts. */
+export declare const SCAFFOLD_MORPH_DURATION = 0.3;
+/** `--ease-smooth-out` as a motion/react easing tuple. */
+export declare const SCAFFOLD_EASE: readonly [0.22, 1, 0.36, 1];

package/dist-lib/components/blocks/scaffold/index.d.ts

@@ -0,0 +1,25 @@
+import { PanelCloseButton } from './panel-close-button';
+import { PanelMenuButton } from './panel-menu-button.tsx';
+import { ScaffoldActions } from './scaffold-actions';
+import { ScaffoldCanvas } from './scaffold-canvas';
+import { ScaffoldInspector } from './scaffold-inspector';
+import { ScaffoldMain } from './scaffold-main';
+import { ScaffoldPanel } from './scaffold-panel';
+import { ScaffoldRoot } from './scaffold-root';
+import { ScaffoldSidebar } from './scaffold-sidebar';
+import { ScaffoldSubPanel } from './scaffold-sub-panel.tsx';
+export { useScaffoldContext } from './scaffold-context';
+export { useScaffold } from './use-scaffold';
+export type * from './type';
+export * from './constants';
+export { PanelCloseButton, PanelMenuButton, ScaffoldActions, ScaffoldCanvas, ScaffoldInspector, ScaffoldMain, ScaffoldPanel, ScaffoldRoot, ScaffoldSidebar, };
+export declare const Scaffold: {
+    Root: typeof ScaffoldRoot;
+    Sidebar: typeof ScaffoldSidebar;
+    Main: typeof ScaffoldMain;
+    Actions: typeof ScaffoldActions;
+    Canvas: typeof ScaffoldCanvas;
+    Panel: typeof ScaffoldPanel;
+    Inspector: typeof ScaffoldInspector;
+    SubPanel: typeof ScaffoldSubPanel;
+};

package/dist-lib/components/blocks/scaffold/panel-close-button.d.ts

@@ -0,0 +1,4 @@
+import { PanelFloatingButtonProps } from './type';
+import * as React from "react";
+/** Floating close affordance in a panel's top-right corner. */
+export declare function PanelCloseButton({ onClick, label, sound, className, }: PanelFloatingButtonProps): React.ReactElement;

package/dist-lib/components/blocks/scaffold/panel-menu-button.d.ts

@@ -0,0 +1,7 @@
+import { PanelMenuButtonProps } from './type';
+import * as React from "react";
+/**
+ * Floating swap affordance centered on the seam between a panel's primary
+ * surface and its secondary strip.
+ */
+export declare function PanelMenuButton({ onClick, onExpand, secondaryExpanded, label, sound, className, }: PanelMenuButtonProps): React.ReactElement;

package/dist-lib/components/blocks/scaffold/scaffold-actions.d.ts

@@ -0,0 +1,9 @@
+import { ScaffoldActionsProps } from './type';
+import * as React from "react";
+/**
+ * The floating pill cluster in the main region's top-right corner — the
+ * design's "Panel Context Menu": an Add segment plus an overflow segment
+ * whose badge counts the non-visible panels. Slides left in step with the
+ * inspector opening.
+ */
+export declare function ScaffoldActions({ onAdd, addLabel, addIcon, overflowCount, onBrowse, browseLabel, sound, className, children, ...rest }: ScaffoldActionsProps): React.ReactElement;

package/dist-lib/components/blocks/scaffold/scaffold-canvas.d.ts

@@ -0,0 +1,7 @@
+import { ScaffoldCanvasProps } from './type';
+import * as React from "react";
+/**
+ * The panel row below the action cluster: 8px gutters, 8px gaps, panels
+ * side by side. Key each `Scaffold.Panel` child so closes animate out.
+ */
+export declare function ScaffoldCanvas({ className, children, ...rest }: ScaffoldCanvasProps): React.ReactElement;

package/dist-lib/components/blocks/scaffold/scaffold-context.d.ts

@@ -0,0 +1,5 @@
+import { ScaffoldContextValue } from './type';
+import * as React from "react";
+export declare const ScaffoldContext: React.Context<ScaffoldContextValue | null>;
+/** Read the scaffold's shared state; must run under `Scaffold.Root`. */
+export declare function useScaffoldContext(): ScaffoldContextValue;

package/dist-lib/components/blocks/scaffold/scaffold-inspector.d.ts

@@ -0,0 +1,9 @@
+import { ScaffoldInspectorProps } from './type';
+import * as React from "react";
+/**
+ * The right-hand drawer: a brighter card that slides in over the canvas,
+ * inset from the viewport edges. Open state lives on `Scaffold.Root` (or
+ * `useScaffold().providerProps`); the drawer stays mounted so it can slide
+ * back out.
+ */
+export declare function ScaffoldInspector({ children, name, className, ...rest }: ScaffoldInspectorProps): React.ReactElement;

package/dist-lib/components/blocks/scaffold/scaffold-main.d.ts

@@ -0,0 +1,8 @@
+import { ScaffoldMainProps } from './type';
+import * as React from "react";
+/**
+ * The region right of the rail. Hosts `Scaffold.Actions` (top-right),
+ * `Scaffold.Canvas` and the `Scaffold.Inspector` overlay — all positioned
+ * against this box.
+ */
+export declare function ScaffoldMain({ className, children, ...rest }: ScaffoldMainProps): React.ReactElement;

package/dist-lib/components/blocks/scaffold/scaffold-panel.d.ts

@@ -0,0 +1,10 @@
+import { ScaffoldPanelProps } from './type';
+import * as React from "react";
+/**
+ * A canvas panel: a primary card plus an optional secondary strip below it,
+ * separated by a slice of the desktop backdrop. Floating close and swap
+ * buttons reveal on hover when their callbacks are provided. Swapping trades
+ * the two cards with a layout morph — the strip glides up and grows into the
+ * primary slot while the primary card shrinks down into the strip.
+ */
+export declare function ScaffoldPanel({ children, SecondaryPanel, onClose, onSwap, name, closeLabel, swapLabel, sound, className, }: ScaffoldPanelProps): React.ReactElement;

package/dist-lib/components/blocks/scaffold/scaffold-root.d.ts

@@ -0,0 +1,8 @@
+import { ScaffoldRootProps } from './type';
+import * as React from "react";
+/**
+ * The scaffold's viewport: desktop backdrop + horizontal row of rail and
+ * main region, and the provider for the shared inspector state. Fills its
+ * container — size it from the outside (e.g. `h-svh` for a full page).
+ */
+export declare function ScaffoldRoot({ inspectorOpen: inspectorOpenProp, defaultInspectorOpen, onInspectorOpenChange, inspectorWidth, className, children, ...rest }: ScaffoldRootProps): React.ReactElement;

package/dist-lib/components/blocks/scaffold/scaffold-sidebar.d.ts

@@ -0,0 +1,7 @@
+import { ScaffoldSidebarProps } from './type';
+import * as React from "react";
+/**
+ * The 64px icon rail on the left edge. Transparent — it sits directly on
+ * the desktop backdrop; fill it with icon buttons.
+ */
+export declare function ScaffoldSidebar({ className, children, ...rest }: ScaffoldSidebarProps): React.ReactElement;

package/dist-lib/components/blocks/scaffold/scaffold-sub-panel.d.ts

@@ -0,0 +1,3 @@
+import { ScaffoldSubPanelProps } from './type';
+import * as React from "react";
+export declare function ScaffoldSubPanel({ className, children, variant, primary, expanded, ...rest }: ScaffoldSubPanelProps): React.ReactElement;

package/dist-lib/components/blocks/scaffold/type.d.ts

@@ -0,0 +1,133 @@
+import { default as React, ComponentProps, ReactElement, ReactNode } from 'react';
+/** Inspector state shared by every scaffold part through ScaffoldContext. */
+export interface ScaffoldContextValue {
+    /** Whether the inspector drawer is currently shown. */
+    inspectorOpen: boolean;
+    /** Drawer width in px — Actions reads it to slide out of the drawer's way. */
+    inspectorWidth: number;
+    setInspectorOpen: (open: boolean) => void;
+    toggleInspector: () => void;
+}
+export interface ScaffoldRootProps extends ComponentProps<"div"> {
+    /** Controlled inspector state — pair with `onInspectorOpenChange`, or
+     * spread `useScaffold().providerProps` instead of wiring by hand. */
+    inspectorOpen?: boolean;
+    /** Initial inspector state when uncontrolled. Closed by default. */
+    defaultInspectorOpen?: boolean;
+    onInspectorOpenChange?: (open: boolean) => void;
+    /** Drawer width in px. Also drives how far Actions slides aside. */
+    inspectorWidth?: number;
+}
+export type ScaffoldSidebarProps = ComponentProps<"nav">;
+export type ScaffoldMainProps = ComponentProps<"div">;
+export type ScaffoldCanvasProps = ComponentProps<"div">;
+/** React's drag/animation DOM handlers collide with motion's gesture props
+ * on `motion.*` elements — strip them from pass-through HTML props. */
+type MotionSafe<T> = Omit<T, "onDrag" | "onDragStart" | "onDragEnd" | "onAnimationStart" | "onAnimationEnd" | "onAnimationIteration">;
+export interface ScaffoldActionsProps extends MotionSafe<Omit<ComponentProps<"div">, "children">> {
+    /** Called when the Add segment is pressed. */
+    onAdd?: () => void;
+    /** Label of the Add segment. */
+    addLabel?: ReactNode;
+    /** Replaces the default add icon. */
+    addIcon?: ReactNode;
+    /** Number of non-visible panels tucked into the overflow dropdown —
+     * the badge on the browse segment. The segment renders when this or
+     * `onBrowse` is present; the badge only when > 0. Per the design
+     * comments the dropdown menu itself is a later iteration; for now the
+     * segment just keeps the count. */
+    overflowCount?: number;
+    /** Called when the overflow (stacked-panels) segment is pressed. */
+    onBrowse?: () => void;
+    /** Accessible name of the overflow segment. */
+    browseLabel?: string;
+    /** Extra segments appended after the built-in ones. */
+    children?: ReactNode;
+    /** Emit interaction-sound attributes (inert until an app binds cuelume). */
+    sound?: boolean;
+}
+export type TScaffoldPanelChild<T extends ScaffoldSubPanelProps = ScaffoldSubPanelProps> = ReactElement<T, React.JSXElementConstructor<T>>;
+export interface ScaffoldPanelProps {
+    /** The panel's content, rendered in a card with a drop shadow. */
+    children: ReactNode;
+    /** The panel's content, rendered in a card with a drop shadow. */
+    SecondaryPanel?: TScaffoldPanelChild;
+    /** Renders the floating close button in the panel's top-right corner. */
+    onClose?: () => void;
+    /** Renders the floating swap button over the primary/secondary gap.
+     * Only shown when `secondary` is present. Clicking it trades the two
+     * cards with a layout morph — flip the slot content here so each card
+     * carries its subject to its new home. */
+    onSwap?: () => void;
+    /** Controlled swap state — while true the strip's card sits in the
+     * primary slot. Omit letting the panel toggle it on swap clicks. */
+    swapped?: boolean;
+    /** Initial swap state when uncontrolled. */
+    defaultSwapped?: boolean;
+    /** Fixed width in px; omitted, the panel flexes to share the canvas. */
+    width?: number;
+    /** Accessible name of the panel region. */
+    name?: string;
+    /** Emit interaction-sound attributes on the floating buttons. */
+    sound?: boolean;
+    /** Accessible name of the close button. */
+    closeLabel?: string;
+    /** Accessible name of the swap button. */
+    swapLabel?: string;
+    /** Extra class names for the panel's root element. */
+    className?: string;
+}
+export type TSubPanelPosition = "bottom" | "top";
+export type TSubPanelVariant = "card" | "subtle" | "inset";
+export interface ScaffoldSubPanelProps extends MotionSafe<Omit<ComponentProps<"div">, "children">> {
+    children?: ReactNode;
+    /** Accessible name of the sub-panel region. */
+    name?: string;
+    /** Whether this is the primary or secondary sub-panel. */
+    primary?: boolean;
+    /** Whether this sub-panel holds the flexible slot. Defaults to `primary` —
+     * the panel flips it when the Expand action trades the slots. */
+    expanded?: boolean;
+    /** Visual style of the sub-panel. */
+    variant?: TSubPanelVariant;
+    /** Fixed width in px; omitted, the sub-panel flexes to share the canvas. */
+    width?: number;
+    /** Emit interaction-sound attributes on the floating buttons. */
+    sound?: boolean;
+    /** Extra class names for the sub-panel's root element. */
+    className?: string;
+}
+export interface ScaffoldInspectorProps extends MotionSafe<Omit<ComponentProps<"aside">, "children">> {
+    children?: ReactNode;
+    /** Accessible name of the drawer region. */
+    name?: string;
+}
+export interface PanelFloatingButtonProps {
+    onClick?: () => void;
+    /** Accessible name — the button is icon-only. */
+    label: string;
+    sound?: boolean;
+    className?: string;
+}
+export interface PanelMenuButtonProps extends PanelFloatingButtonProps {
+    /** Called when the Expand action is pressed — the panel trades which
+     * sub-panel holds the flexible slot. */
+    onExpand?: () => void;
+    /** Whether the secondary strip currently holds the flexible slot —
+     * flips the Expand chevron between down and up. */
+    secondaryExpanded?: boolean;
+}
+export interface UseScaffoldOptions {
+    /** Initial inspector state. Closed by default. */
+    defaultInspectorOpen?: boolean;
+    /** Fires on every inspector open/close. */
+    onInspectorChange?: (open: boolean) => void;
+}
+export interface ScaffoldControls {
+    inspectorOpen: boolean;
+    setInspectorOpen: (open: boolean) => void;
+    toggleInspector: () => void;
+    /** Spread onto Scaffold.Root. */
+    providerProps: Pick<ScaffoldRootProps, "inspectorOpen" | "onInspectorOpenChange">;
+}
+export {};

package/dist-lib/components/blocks/scaffold/use-scaffold.d.ts

@@ -0,0 +1,8 @@
+import { ScaffoldControls, UseScaffoldOptions } from './type';
+/**
+ * Owns the scaffold's inspector state for UI living outside the scaffold
+ * (title-bar buttons, command palette, shortcuts). Spread the returned
+ * `providerProps` onto `Scaffold.Root`; without this hook the root manages
+ * the same state internally via `defaultInspectorOpen`.
+ */
+export declare function useScaffold({ defaultInspectorOpen, onInspectorChange, }?: UseScaffoldOptions): ScaffoldControls;

package/dist-lib/components/blocks/scaffold/utils.d.ts

@@ -0,0 +1,15 @@
+import { ClassNameValue } from 'tailwind-merge';
+import { TSubPanelVariant } from './type.ts';
+/** Desktop backdrop the whole scaffold sits on — a soft warm-gray wash. */
+export declare const scaffoldBackgroundClass: ClassNameValue;
+/** Card surface shared by a panel's primary area and secondary strip. */
+export declare const panelSurfaceClass: ClassNameValue;
+/** Floating icon button hovering over a panel (close, swap). */
+export declare const floatingButtonClass: ClassNameValue;
+/** Hidden until the pointer rests on the panel (always shown for touch and
+ * while focused) — the affordances stay quiet until the panel is engaged. */
+export declare const revealOnPanelHoverClass: ClassNameValue;
+/** Pill segment inside the actions cluster (Add, browse). */
+export declare const actionSegmentClass: ClassNameValue;
+/** Map of sub-panel variants to their corresponding side. */
+export declare const subPanelVariant: Record<TSubPanelVariant, ClassNameValue>;

package/dist-lib/components/blocks/shell/animated-panel-inset.d.ts

@@ -0,0 +1,2 @@
+import { AnimatedSidebarInsetProps } from './type';
+export declare const AnimatedPanelInset: import('react').ForwardRefExoticComponent<Omit<AnimatedSidebarInsetProps, "ref"> & import('react').RefAttributes<HTMLElement>>;

package/dist-lib/components/blocks/shell/animated-panel-provider.d.ts

@@ -0,0 +1,2 @@
+import { AnimatedSidebarProviderProps } from './type';
+export declare function AnimatedPanelProvider({ children, open, defaultOpen, onOpenChange, openMobile, defaultOpenMobile, onOpenMobileChange, className, style, ...props }: AnimatedSidebarProviderProps): import("react").JSX.Element;

package/dist-lib/components/blocks/shell/animated-panel-trigger.d.ts

@@ -0,0 +1,2 @@
+import { AnimatedSidebarTriggerProps } from './type';
+export declare const AnimatedPanelTrigger: import('react').ForwardRefExoticComponent<AnimatedSidebarTriggerProps & import('react').RefAttributes<HTMLButtonElement>>;

package/dist-lib/components/blocks/shell/animated-panel.d.ts

@@ -0,0 +1,2 @@
+import { AnimatedSidebarProps } from './type';
+export declare function AnimatedPanel({ side, variant, collapsible, ariaLabel, children, className, panelClassName, style, ref, ...props }: AnimatedSidebarProps): import("react").JSX.Element;

package/dist-lib/components/blocks/shell/animated-sidebar-content.d.ts

@@ -0,0 +1,2 @@
+import { HTMLAttributes } from 'react';
+export declare const AnimatedSidebarContent: import('react').ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & import('react').RefAttributes<HTMLDivElement>>;

package/dist-lib/components/blocks/shell/animated-sidebar-footer.d.ts

@@ -0,0 +1,2 @@
+import { HTMLAttributes } from 'react';
+export declare const AnimatedSidebarFooter: import('react').ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & import('react').RefAttributes<HTMLDivElement>>;

package/dist-lib/components/blocks/shell/animated-sidebar-group-content.d.ts

@@ -0,0 +1,2 @@
+import { HTMLAttributes } from 'react';
+export declare const AnimatedSidebarGroupContent: import('react').ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & import('react').RefAttributes<HTMLDivElement>>;

package/dist-lib/components/blocks/shell/animated-sidebar-group-label.d.ts

@@ -0,0 +1,2 @@
+import { HTMLAttributes } from 'react';
+export declare const AnimatedSidebarGroupLabel: import('react').ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & import('react').RefAttributes<HTMLDivElement>>;

package/dist-lib/components/blocks/shell/animated-sidebar-group.d.ts

@@ -0,0 +1,2 @@
+import { HTMLAttributes } from 'react';
+export declare const AnimatedSidebarGroup: import('react').ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & import('react').RefAttributes<HTMLDivElement>>;

package/dist-lib/components/blocks/shell/animated-sidebar-header.d.ts

@@ -0,0 +1,2 @@
+import { HTMLAttributes } from 'react';
+export declare const AnimatedSidebarHeader: import('react').ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & import('react').RefAttributes<HTMLDivElement>>;

package/dist-lib/components/blocks/shell/animated-sidebar-menu-button.d.ts

@@ -0,0 +1,3 @@
+import { AnimatedSidebarMenuButtonProps } from './type';
+import type * as React from "react";
+export declare function AnimatedSidebarMenuButton({ children, icon, badge, href, isActive, ariaExpanded, disabled, closeOnSelect, target, rel, onSelect, className, }: AnimatedSidebarMenuButtonProps): React.JSX.Element;

package/dist-lib/components/blocks/shell/animated-sidebar-menu-item.d.ts

@@ -0,0 +1,2 @@
+import { HTMLMotionProps } from 'motion/react';
+export declare const AnimatedSidebarMenuItem: import('react').ForwardRefExoticComponent<Omit<HTMLMotionProps<"li">, "ref"> & import('react').RefAttributes<HTMLLIElement>>;

package/dist-lib/components/blocks/shell/animated-sidebar-menu-sub-button.d.ts

@@ -0,0 +1,3 @@
+import { AnimatedSidebarMenuSubButtonProps } from './type';
+import type * as React from "react";
+export declare function AnimatedSidebarMenuSubButton({ children, icon, href, isActive, disabled, closeOnSelect, target, rel, onSelect, className, }: AnimatedSidebarMenuSubButtonProps): React.JSX.Element;

package/dist-lib/components/blocks/shell/animated-sidebar-menu-sub-item.d.ts

@@ -0,0 +1,2 @@
+import { HTMLMotionProps } from 'motion/react';
+export declare const AnimatedSidebarMenuSubItem: import('react').ForwardRefExoticComponent<Omit<HTMLMotionProps<"li">, "ref"> & import('react').RefAttributes<HTMLLIElement>>;

package/dist-lib/components/blocks/shell/animated-sidebar-menu-sub.d.ts

@@ -0,0 +1,2 @@
+import { AnimatedSidebarMenuSubProps } from './type';
+export declare const AnimatedSidebarMenuSub: import('react').ForwardRefExoticComponent<Omit<AnimatedSidebarMenuSubProps, "ref"> & import('react').RefAttributes<HTMLUListElement>>;

package/dist-lib/components/blocks/shell/animated-sidebar-menu.d.ts

@@ -0,0 +1,2 @@
+import { HTMLAttributes } from 'react';
+export declare const AnimatedSidebarMenu: import('react').ForwardRefExoticComponent<HTMLAttributes<HTMLUListElement> & import('react').RefAttributes<HTMLUListElement>>;

package/dist-lib/components/blocks/shell/index.d.ts

@@ -2,4 +2,20 @@ import { ShellLayout } from './shell-layout';
 export type * from './type';
 export * from './use-shell-panels';
 export * from './utils';
+export * from './animated-panel';
+export * from './animated-panel-inset';
+export * from './animated-panel-provider';
+export * from './animated-panel-trigger';
+export * from './animated-sidebar-header';
+export * from './animated-sidebar-content';
+export * from './animated-sidebar-footer';
+export * from './animated-sidebar-group';
+export * from './animated-sidebar-group-label';
+export * from './animated-sidebar-group-content';
+export * from './animated-sidebar-menu';
+export * from './animated-sidebar-menu-item';
+export * from './animated-sidebar-menu-sub';
+export * from './animated-sidebar-menu-sub-item';
+export * from './animated-sidebar-menu-sub-button';
+export * from './animated-sidebar-menu-button';
 export { ShellLayout as default };

package/dist-lib/components/blocks/shell/shell-layout.d.ts

@@ -1,3 +1,3 @@
 import { ShellLayoutProps } from './type';
 import * as React from "react";
-export declare function ShellLayout({ children, variant, panels, className, defaultOpen, ...panelControlProps }: ShellLayoutProps): React.ReactElement;
+export declare function ShellLayout({ children, variant, panels, className, header, defaultOpen, ...panelControlProps }: ShellLayoutProps): React.ReactElement;

package/dist-lib/components/blocks/shell/type.d.ts

@@ -1,5 +1,5 @@
-import { ReactNode } from 'react';
-import { AnimatedSidebarProviderProps, SidebarSide } from '../../motion/animated-sidebar';
+import { ReactNode, ButtonHTMLAttributes, CSSProperties, HTMLAttributes } from 'react';
+import { HTMLMotionProps } from 'motion/react';
 export interface ShellAction {
     id: string;
     label: string;
@@ -35,7 +35,7 @@ export type TPanelSide = IPanel["side"];
  * wins. */
 export type TPanelMap<Side extends TPanelSide = TPanelSide> = Partial<Record<Side, IPanel>>;
 /** The open/close surface of the shell's panels, lifted straight from
- * AnimatedSidebarProvider — every prop is keyed by side, there are no
+ * AnimatedPanelProvider — every prop is keyed by side, there are no
  * explicit per-side props. `useShellPanels` produces the controlled subset
  * of these as `providerProps`. */
 export type ShellPanelControlProps = Pick<AnimatedSidebarProviderProps, "open" | "defaultOpen" | "onOpenChange" | "openMobile" | "defaultOpenMobile" | "onOpenMobileChange">;
@@ -60,7 +60,7 @@ export interface ShellPanelControls {
     /** Desktop-only convenience — the in-shell triggers already pick the
      * mobile state themselves when the viewport is narrow. */
     toggle: (side: SidebarSide) => void;
-    /** Spread onto ShellLayout (or AnimatedSidebarProvider directly). */
+    /** Spread onto ShellLayout (or AnimatedPanelProvider directly). */
     providerProps: ShellPanelControlProps;
 }
 export interface ShellLayoutProps extends ShellPanelControlProps {
@@ -68,6 +68,93 @@ export interface ShellLayoutProps extends ShellPanelControlProps {
     /** Content for the shell's panels, keyed by the side. The shell renders
      * the `left` rail and the `right` drawer; other sides are reserved. */
     panels?: TPanelMap;
+    header?: ReactNode;
     className?: string;
     variant?: "web" | "desktop";
 }
+export type SidebarSide = "left" | "right";
+/** Open flags keyed by the side. Sides left out stay uncontrolled / at their
+ * default — there is no per-side prop, the record IS the API. */
+export type SidebarOpenState = Partial<Record<SidebarSide, boolean>>;
+export type SidebarVariant = "sidebar" | "floating" | "inset";
+export type SidebarCollapsible = "offcanvas" | "icon" | "none";
+export interface AnimatedSidebarContextValue {
+    isMobile: boolean;
+    layoutId: string;
+    /** Desktop open state, keyed by side. */
+    open: Record<SidebarSide, boolean>;
+    /** Mobile overlay open state, keyed by side. */
+    openMobile: Record<SidebarSide, boolean>;
+    reduce: boolean;
+    setOpen: (open: boolean, side: SidebarSide) => void;
+    setOpenMobile: (open: boolean, side: SidebarSide) => void;
+    /** Mobile-aware: toggles the overlay below md, the docked panel above. */
+    toggleSidebar: (side: SidebarSide) => void;
+    triggerRefs: Record<SidebarSide, React.RefObject<HTMLButtonElement | null>>;
+}
+export interface AnimatedSidebarProviderProps extends HTMLAttributes<HTMLDivElement> {
+    /** Controlled desktop open state, keyed by the side. A side left undefined
+     * stays uncontrolled. */
+    open?: SidebarOpenState;
+    /** Initial desktop open state, merged over `{ left: true, right: false }`. */
+    defaultOpen?: SidebarOpenState;
+    onOpenChange?: (open: boolean, side: SidebarSide) => void;
+    /** Controlled mobile overlay state, keyed by side. */
+    openMobile?: SidebarOpenState;
+    /** Initial mobile overlay state — every side starts closed. */
+    defaultOpenMobile?: SidebarOpenState;
+    onOpenMobileChange?: (open: boolean, side: SidebarSide) => void;
+    style?: SidebarProviderStyle;
+}
+export type SidebarProviderStyle = CSSProperties & {
+    "--sidebar-width"?: string;
+    "--sidebar-width-icon"?: string;
+    "--sidebar-width-mobile"?: string;
+};
+export type AnimatedSidebarInsetProps = HTMLMotionProps<"main">;
+export interface AnimatedSidebarTriggerProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+    side?: SidebarSide;
+}
+export interface AnimatedSidebarPanelContextValue {
+    collapsed: boolean;
+    collapsible: SidebarCollapsible;
+    side: SidebarSide;
+}
+export interface AnimatedSidebarProps extends Omit<HTMLMotionProps<"aside">, "children"> {
+    children?: ReactNode;
+    side?: SidebarSide;
+    variant?: SidebarVariant;
+    collapsible?: SidebarCollapsible;
+    ariaLabel?: string;
+    panelClassName?: string;
+}
+export interface AnimatedSidebarMenuSubProps extends Omit<HTMLMotionProps<"ul">, "children"> {
+    open: boolean;
+    children?: ReactNode;
+}
+export interface AnimatedSidebarMenuSubButtonProps {
+    children: ReactNode;
+    icon?: ReactNode;
+    href?: string;
+    isActive?: boolean;
+    disabled?: boolean;
+    closeOnSelect?: boolean;
+    target?: "_blank" | "_self" | "_parent" | "_top";
+    rel?: string;
+    onSelect?: () => void;
+    className?: string;
+}
+export interface AnimatedSidebarMenuButtonProps {
+    children: ReactNode;
+    icon?: ReactNode;
+    badge?: ReactNode;
+    href?: string;
+    isActive?: boolean;
+    ariaExpanded?: boolean;
+    disabled?: boolean;
+    closeOnSelect?: boolean;
+    target?: "_blank" | "_self" | "_parent" | "_top";
+    rel?: string;
+    onSelect?: () => void;
+    className?: string;
+}

package/dist-lib/components/blocks/shell/utils.d.ts

@@ -1 +1,38 @@
+import { Variants } from 'motion/react';
+import { AnimatedSidebarContextValue, AnimatedSidebarPanelContextValue } from './type';
 export declare const TITLE_BAR_HEIGHT = 48;
+export declare const SIDEBAR_MORPH_TRANSITION: {
+    readonly type: "spring";
+    readonly stiffness: 380;
+    readonly damping: 35;
+    readonly mass: 0.75;
+};
+export declare const LABEL_ENTER_TRANSITION: {
+    readonly duration: 0.2;
+    readonly delay: 0.08;
+    readonly ease: readonly [0.16, 1, 0.3, 1];
+};
+export declare const LABEL_EXIT_TRANSITION: {
+    readonly duration: 0.12;
+    readonly ease: readonly [0.16, 1, 0.3, 1];
+};
+export declare const PANEL_TRANSITION: {
+    readonly duration: 0.36;
+    readonly ease: readonly [0.32, 0.72, 0, 1];
+};
+export declare const REDUCED_TRANSITION: {
+    readonly duration: 0.16;
+    readonly ease: readonly [0.16, 1, 0.3, 1];
+};
+export declare const SUBMENU_VARIANTS: Variants;
+export declare const SUBMENU_ITEM_VARIANTS: Variants;
+export declare const FOCUSABLE_SELECTOR: string;
+export declare const MOBILE_QUERY = "(max-width: 767px)";
+export declare const SIDEBAR_KEYBOARD_SHORTCUT = "b";
+export declare const AnimatedSidebarContext: import('react').Context<AnimatedSidebarContextValue | null>;
+export declare const AnimatedSidebarPanelContext: import('react').Context<AnimatedSidebarPanelContextValue | null>;
+export declare function useAnimatedSidebar(): AnimatedSidebarContextValue;
+export declare function getMobileSnapshot(): boolean;
+export declare function getServerMobileSnapshot(): boolean;
+export declare function useIsMobile(): boolean;
+export declare function useAnimatedSidebarPanel(): AnimatedSidebarPanelContextValue;

package/dist-lib/components/motion/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist-lib/components/motion/overflow-actions.d.ts

@@ -0,0 +1,35 @@
+import { ReactNode } from 'react';
+export type OverflowActionsSize = "sm" | "md";
+export type OverflowActionItem = {
+    id: string;
+    label: ReactNode;
+    icon?: ReactNode;
+    onClick?: () => void;
+    disabled?: boolean;
+    ariaLabel?: string;
+};
+export type OverflowActionsClassNames = {
+    root?: string;
+    track?: string;
+    action?: string;
+    primaryAction?: string;
+    overflowAction?: string;
+    toggle?: string;
+    icon?: string;
+    label?: string;
+};
+export interface OverflowActionsProps {
+    primaryActions: OverflowActionItem[];
+    overflowActions: OverflowActionItem[];
+    expanded?: boolean;
+    defaultExpanded?: boolean;
+    onExpandedChange?: (expanded: boolean) => void;
+    onAction?: (item: OverflowActionItem) => void;
+    collapseOnAction?: boolean;
+    size?: OverflowActionsSize;
+    openLabel?: string;
+    closeLabel?: string;
+    className?: string;
+    classNames?: OverflowActionsClassNames;
+}
+export declare function OverflowActions({ primaryActions, overflowActions, expanded, defaultExpanded, onExpandedChange, onAction, collapseOnAction, size, openLabel, closeLabel, className, classNames, }: OverflowActionsProps): import("react").JSX.Element;

package/dist-lib/components/ui/button-group.d.ts

@@ -0,0 +1,11 @@
+import { useRender } from '@base-ui/react/use-render';
+import { VariantProps } from 'class-variance-authority';
+import { HTMLMotionProps } from 'framer-motion';
+import { Separator } from './separator';
+declare const buttonGroupVariants: (props?: ({
+    orientation?: "horizontal" | "vertical" | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
+declare function ButtonGroup({ className, orientation, ...props }: HTMLMotionProps<"div"> & VariantProps<typeof buttonGroupVariants>): import("react").JSX.Element;
+declare function ButtonGroupText({ className, render, ...props }: useRender.ComponentProps<"div">): import('react').ReactElement<unknown, string | import('react').JSXElementConstructor<any>>;
+declare function ButtonGroupSeparator({ className, orientation, ...props }: React.ComponentProps<typeof Separator>): import("react").JSX.Element;
+export { ButtonGroup, ButtonGroupSeparator, ButtonGroupText, buttonGroupVariants, };