@exegia/corpora-ui 0.14.0 → 0.16.0

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

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

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

@@ -1,4 +1,5 @@
 import { ShellLayout } from './shell-layout';
 export type * from './type';
+export * from './use-shell-panels';
 export * from './utils';
 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, open, defaultOpen, onOpenChange, rightDrawer, rightOpen, defaultRightOpen, onRightOpenChange, variant, className, }: ShellLayoutProps): React.ReactElement;
+export declare function ShellLayout({ children, variant, panels, className, defaultOpen, ...panelControlProps }: ShellLayoutProps): React.ReactElement;

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

@@ -1,27 +1,73 @@
-import { default as React } from 'react';
+import { ReactNode } from 'react';
+import { AnimatedSidebarProviderProps, SidebarSide } from '../../motion/animated-sidebar';
 export interface ShellAction {
     id: string;
     label: string;
-    icon: React.ReactNode;
-    badge?: React.ReactNode;
+    icon: ReactNode;
+    badge?: ReactNode;
     onSelect?: () => void;
 }
 export interface ShellWorkspace {
     name: string;
-    logo?: React.ReactNode;
-    meta?: React.ReactNode;
+    logo?: ReactNode;
+    meta?: ReactNode;
 }
-export interface ShellLayoutProps {
-    children?: React.ReactNode;
-    open?: boolean;
+export interface IPanel {
+    id: string;
+    name: string;
+    component: ReactNode;
+    /** Replaces the default icon inside the panel's header trigger. The shell
+     * keeps the trigger button itself (toggle wiring, aria-label) — this only
+     * swaps what renders inside it. */
+    trigger?: ReactNode;
+    open: boolean;
     defaultOpen?: boolean;
-    onOpenChange?: (open: boolean) => void;
-    /** Content of the right drawer. It has no icon rail — it is either fully
-     * shown or fully hidden. */
-    rightDrawer?: React.ReactNode;
-    rightOpen?: boolean;
-    defaultRightOpen?: boolean;
-    onRightOpenChange?: (open: boolean) => void;
+    side: "left" | "bottom" | "right" | "sidebar";
+}
+/** The side a panel docks to, as a value union (`IPanel["side"]`).
+ * `Pick<IPanel, "side">` would be the object type `{ side: ... }`, which can
+ * neither key a Record nor travel as a plain callback argument. */
+export type TPanelSide = IPanel["side"];
+/** Panel content keyed by the side it docks to. `Side` narrows the map to
+ * the sides a surface actually renders (the shell renders left and right).
+ * Entries are optional — a shell with no bottom dock simply has no `bottom`
+ * key. Where an entry's own `side` field disagrees with its key, the key
+ * 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
+ * explicit per-side props. `useShellPanels` produces the controlled subset
+ * of these as `providerProps`. */
+export type ShellPanelControlProps = Pick<AnimatedSidebarProviderProps, "open" | "defaultOpen" | "onOpenChange" | "openMobile" | "defaultOpenMobile" | "onOpenMobileChange">;
+export interface UseShellPanelsOptions {
+    /** Initial desktop open state per side, merged over
+     * `{ left: true, right: false }`. */
+    defaultOpen?: AnimatedSidebarProviderProps["defaultOpen"];
+    /** Initial mobile overlay state per side — every side starts closed. */
+    defaultOpenMobile?: AnimatedSidebarProviderProps["defaultOpenMobile"];
+    /** Panel change event returning both the next open state and the side of
+     * the panel the change comes from. Mobile overlay changes report the same
+     * side as their desktop counterpart. */
+    onPanelChange?: (open: boolean, side: TPanelSide) => void;
+}
+export interface ShellPanelControls {
+    /** Live desktop open state, keyed by side. */
+    open: Record<SidebarSide, boolean>;
+    /** Live mobile overlay state, keyed by side. */
+    openMobile: Record<SidebarSide, boolean>;
+    setOpen: (open: boolean, side: SidebarSide) => void;
+    setOpenMobile: (open: boolean, side: SidebarSide) => void;
+    /** 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). */
+    providerProps: ShellPanelControlProps;
+}
+export interface ShellLayoutProps extends ShellPanelControlProps {
+    children?: ReactNode;
+    /** 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;
     className?: string;
-    variant: 'web' | 'desktop';
+    variant?: "web" | "desktop";
 }

package/dist-lib/components/blocks/shell/use-shell-panels.d.ts

@@ -0,0 +1,9 @@
+import { ShellPanelControls, UseShellPanelsOptions } from './type';
+/**
+ * Owns the open/close state of the shell's panels, keyed by side, and
+ * reports every change through a single `onPanelChange(open, side)`
+ * callback. Spread the returned `providerProps` onto ShellLayout; the
+ * setters and `toggle` are for UI that lives outside the shell (title-bar
+ * buttons, command palette, shortcuts).
+ */
+export declare function useShellPanels({ defaultOpen, defaultOpenMobile, onPanelChange, }?: UseShellPanelsOptions): ShellPanelControls;

package/dist-lib/components/motion/animated-sidebar.d.ts

@@ -1,26 +1,24 @@
 import { HTMLMotionProps } from 'motion/react';
 import { ButtonHTMLAttributes, CSSProperties, HTMLAttributes, ReactNode } from 'react';
-type SidebarState = "expanded" | "collapsed";
-type SidebarSide = "left" | "right";
+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>>;
 type SidebarVariant = "sidebar" | "floating" | "inset";
 type SidebarCollapsible = "offcanvas" | "icon" | "none";
 interface AnimatedSidebarContextValue {
     isMobile: boolean;
     layoutId: string;
-    open: boolean;
-    openMobile: boolean;
-    /** The right panel is a single hidden/shown state — no icon rail, no
-     * separate mobile state. */
-    openRight: boolean;
+    /** 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) => void;
-    setOpenMobile: (open: boolean) => void;
-    setOpenRight: (open: boolean) => void;
-    state: SidebarState;
-    toggleSidebar: () => void;
-    toggleRightSidebar: () => void;
-    triggerRef: React.RefObject<HTMLButtonElement | null>;
-    rightTriggerRef: React.RefObject<HTMLButtonElement | null>;
+    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 declare function useAnimatedSidebar(): AnimatedSidebarContextValue;
 type SidebarProviderStyle = CSSProperties & {
@@ -29,18 +27,20 @@ type SidebarProviderStyle = CSSProperties & {
     "--sidebar-width-mobile"?: string;
 };
 export interface AnimatedSidebarProviderProps extends HTMLAttributes<HTMLDivElement> {
-    open?: boolean;
-    defaultOpen?: boolean;
-    onOpenChange?: (open: boolean) => void;
-    openMobile?: boolean;
-    defaultOpenMobile?: boolean;
-    onOpenMobileChange?: (open: boolean) => void;
-    openRight?: boolean;
-    defaultOpenRight?: boolean;
-    onOpenRightChange?: (open: boolean) => void;
+    /** 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 declare function AnimatedSidebarProvider({ children, open, defaultOpen, onOpenChange, openMobile, defaultOpenMobile, onOpenMobileChange, openRight, defaultOpenRight, onOpenRightChange, className, style, ...props }: AnimatedSidebarProviderProps): import("react").JSX.Element;
+export declare function AnimatedSidebarProvider({ children, open, defaultOpen, onOpenChange, openMobile, defaultOpenMobile, onOpenMobileChange, className, style, ...props }: AnimatedSidebarProviderProps): import("react").JSX.Element;
 export interface AnimatedSidebarProps extends Omit<HTMLMotionProps<"aside">, "children"> {
     children?: ReactNode;
     side?: SidebarSide;