@foris/avocado-suite 1.12.1 → 1.14.0

package/dist/components/drawer/utils/drawerNavigationInternals.d.ts

@@ -0,0 +1,21 @@
+import type { createDrawerRequestGate } from './drawerRequestGate';
+/** Shell-only connection to a controller store; never exported from the package. */
+export interface DrawerNavigationInternals {
+    /** Stable identity of the navigation context, even when its root visit resets. */
+    readonly contextId: string;
+    /** One pending request shared by navigation and dismissal, including cancellation. */
+    readonly requests: Pick<ReturnType<typeof createDrawerRequestGate>, 'run' | 'block' | 'invalidate'>;
+    /** Resets after close; effect cleanup preserves untouched roots for StrictMode. */
+    endSession(reason: 'close' | 'unmount'): void;
+}
+/** Private details of one published controller snapshot. */
+export interface DrawerNavigationSnapshotDetails {
+    /** Store connection, stable for the lifetime of the navigation context. */
+    internals: DrawerNavigationInternals;
+    /** Operation that produced this snapshot; selects the view transition. */
+    lastAction: 'push' | 'back' | 'replace' | 'reset';
+}
+/** Associates private details with a snapshot without widening the public type. */
+export declare function linkDrawerNavigation(controller: object, details: DrawerNavigationSnapshotDetails): void;
+/** Reads the details of a snapshot created by useDrawerNavigation. */
+export declare function readDrawerNavigation(controller: object | undefined): DrawerNavigationSnapshotDetails | undefined;

package/dist/components/drawer/utils/drawerNavigationState.d.ts

@@ -0,0 +1,21 @@
+import type { DrawerNavigationEntry, DrawerNavigationTarget } from '../types/drawerNavigation.types';
+/** Private history state; domain data and component instances never live here. */
+export interface DrawerNavigationState<Target extends DrawerNavigationTarget> {
+    /** Context identity that produced this history. */
+    navigationKey: string | number;
+    /** Generation used to reject commands retained from a previous session. */
+    session: number;
+    /** Next visit number, never reused by resets. */
+    nextId: number;
+    /** Root-to-current history. */
+    entries: readonly DrawerNavigationEntry<Target>[];
+}
+/** Supported history mutations, independent of rendering and routing. */
+export type DrawerNavigationAction<Target extends DrawerNavigationTarget> = {
+    type: 'push' | 'replace' | 'reset';
+    target: Target;
+} | {
+    type: 'back';
+};
+/** Reduces one command without mutating previous entries or consumer parameters. */
+export declare function reduceDrawerNavigation<Target extends DrawerNavigationTarget>(state: DrawerNavigationState<Target>, action: DrawerNavigationAction<Target>, keyPrefix: string): DrawerNavigationState<Target>;

package/dist/components/drawer/utils/drawerRequestGate.d.ts

@@ -0,0 +1,9 @@
+/** A user confirmation; a thrown error or rejected promise counts as a denial. */
+export type DrawerGuard = () => boolean | Promise<boolean>;
+/** Runs one user request at a time; an approval that arrives after invalidation is ignored. */
+export declare function createDrawerRequestGate(onPendingChange: (isPending: boolean) => void): {
+    readonly isPending: boolean;
+    invalidate: () => void;
+    block(value: boolean): void;
+    run(guard: DrawerGuard | undefined, commit: () => void): Promise<boolean>;
+};

package/dist/components/drawer/utils/drawerStack.d.ts

@@ -0,0 +1,9 @@
+type Listener = () => void;
+/** Open order of floating drawers, shared across React roots without a common provider. */
+export declare const drawerStack: {
+    push(id: string): void;
+    remove(id: string): void;
+    subscribe(listener: Listener): () => void;
+    getSnapshot: () => readonly string[];
+};
+export {};

package/dist/components/drawer/utils/drawerStack.test.d.ts

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

package/dist/components/drawer-layout/DrawerLayout.d.ts

@@ -0,0 +1,17 @@
+import React from 'react';
+/** An application-level host with a stable main area and one contextual panel. */
+export interface DrawerLayoutProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Main application content; receives the space left by a pinned Drawer. */
+    children: React.ReactNode;
+    /** One Drawer, optionally wrapped by a component that owns its state. */
+    drawer: React.ReactNode;
+    /** Minimum usable main-content width in CSS pixels; chosen by the application. */
+    minContentWidth: number;
+}
+/**
+ * Reserves real layout space for a pinned Drawer while keeping both slots mounted.
+ * Give the host a bounded height, and place it outside transformed/clipping ancestors
+ * so its floating panel can use viewport positioning.
+ */
+declare const DrawerLayout: React.FC<DrawerLayoutProps>;
+export default DrawerLayout;

package/dist/components/drawer-layout/DrawerLayout.test.d.ts

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

package/dist/components/drawer-layout/drawerLayoutContext.d.ts

@@ -0,0 +1,20 @@
+/// <reference types="react" />
+/** Requested presentation; insufficient host space temporarily falls back to floating. */
+export type DrawerMode = 'floating' | 'pinned';
+/** @internal Space occupied by the single panel supported by this host. */
+export interface DrawerReservation {
+    /** Measured panel width in CSS pixels. */
+    width: number;
+    /** Physical edge occupied by the panel. */
+    origin: 'left' | 'right';
+}
+/** @internal Measurements and reservation shared only with the drawer slot. */
+export interface DrawerLayoutContextValue {
+    /** Whether both the desktop breakpoint and the caller's content minimum fit. */
+    canPin: boolean;
+    /** Responsive hosted width, independent of the main content's remaining width. */
+    panelWidth: number;
+    /** Reserves or releases the panel column without moving its React subtree. */
+    reserve: (reservation: DrawerReservation | null) => void;
+}
+export declare const DrawerLayoutContext: import("react").Context<DrawerLayoutContextValue | null>;

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

@@ -0,0 +1,3 @@
+export { default } from './DrawerLayout';
+export type { DrawerLayoutProps } from './DrawerLayout';
+export type { DrawerMode } from './drawerLayoutContext';

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

@@ -24,6 +24,14 @@ export interface HeaderProps {
     hasSidebarMenu?: boolean;
     sidebarMenuContent?: React.ReactNode;
     sidebarHeightGap?: number;
+    /** Controls the sidebar from outside; when omitted, the Header owns its state. */
+    sidebarMenuOpen?: boolean;
+    /**
+     * Called with the requested sidebar state from ☰, the sidebar overlay or another menu.
+     * The overlay closes the sidebar itself and reports `false` once its close animation
+     * ends, so update `sidebarMenuOpen` to keep it in sync.
+     */
+    onSidebarMenuToggle?: (open: boolean) => void;
 }
 declare const Header: FC<HeaderProps>;
 export default Header;

package/dist/components/tabs/Tabs.d.ts

@@ -13,6 +13,11 @@ export interface TabsProps {
     items: TabItemProps[];
     /** Callback that will be triggered when one of the tabs is clicked. */
     onClick?: (index: number) => void;
+    /**
+     * Keeps the outgoing panel's height as the incoming panel's `min-height` on every switch,
+     * so the page does not jump. The `min-height` only grows while `Tabs` stays mounted.
+     */
+    preserveHeight?: boolean;
 }
 declare const Tabs: FC<TabsProps>;
 export default Tabs;

package/dist/drawer-types.d.ts

@@ -0,0 +1,2 @@
+/** Public type-only entry point for adapters of the contextual Drawer. */
+export type { DrawerProps, DrawerExpansionConfig, DrawerHeaderConfig, } from './components/drawer';

package/dist/index.d.ts

@@ -56,7 +56,8 @@ import Tooltip from './components/tooltip/Tooltip';
 import Table from './components/table';
 import Weekly from './components/weekly';
 import WeeklyGroup from './components/weekly-group';
-import Drawer from './components/drawer/Drawer';
+import Drawer from './components/drawer';
+import DrawerLayout from './components/drawer-layout';
 import Banner from './components/banner';
 import Beacon from './components/beacon';
 import Hotspot from './components/hotspot';
@@ -72,7 +73,7 @@ import { toast } from 'react-toastify';
  * Hooks
  */
 export { useFloatingPortal } from './hooks/useFloatingPortal';
-export { Banner, Beacon, Header, HeaderNavigation, ContextualNavigation, Hotspot, NavList, Drawer, AccessPanel, AccountMenu, SidebarMenu, Weekly, WeeklyGroup, Accordion, Box, Breadcrumbs, Button, Card, CardAccordion, CardNotification, Checkbox, DataCard, DataTable, DatePicker, Divider, Dropzone, FileUpload, BarChart, Donut, DonutLabels, DonutLegend, DropdownButton, Heading, Link, LineChart, Loading, MatrixTable, Menu, Modal, Pager, Pill, PreviewerMarkdown, Processing, ProgressBar, ProgressBarBase, RadioButton, RoundButton, SegmentedProgress, Select, SelectPagination, SkeletonBase, SkeletonCircle, Stepper, Switch, Tabs, Tag, Text, TextField, Textarea, ThemeProvider, ThemeStore, LocaleStore, Timer, Toaster, Tooltip, Table, toast, };
+export { Banner, Beacon, Header, HeaderNavigation, ContextualNavigation, Hotspot, NavList, Drawer, DrawerLayout, AccessPanel, AccountMenu, SidebarMenu, Weekly, WeeklyGroup, Accordion, Box, Breadcrumbs, Button, Card, CardAccordion, CardNotification, Checkbox, DataCard, DataTable, DatePicker, Divider, Dropzone, FileUpload, BarChart, Donut, DonutLabels, DonutLegend, DropdownButton, Heading, Link, LineChart, Loading, MatrixTable, Menu, Modal, Pager, Pill, PreviewerMarkdown, Processing, ProgressBar, ProgressBarBase, RadioButton, RoundButton, SegmentedProgress, Select, SelectPagination, SkeletonBase, SkeletonCircle, Stepper, Switch, Tabs, Tag, Text, TextField, Textarea, ThemeProvider, ThemeStore, LocaleStore, Timer, Toaster, Tooltip, Table, toast, };
 /**
  * Types
  */
@@ -106,7 +107,10 @@ export type { TabsProps } from './components/tabs/Tabs';
 export type { TimerTime } from './components/timer/Timer';
 export type { ModalProps } from './components/modal/Modal';
 export type { AccountMenuFooterAction, AccountMenuProps, } from './components/account-menu/AccountMenu';
-export type { DrawerProps } from './components/drawer/Drawer';
+export type { DrawerLayoutProps, DrawerMode } from './components/drawer-layout';
+export type { DrawerExpansionConfig } from './components/drawer';
+export { DrawerView, useDrawerNavigation, useDrawerNavigationContext, } from './components/drawer';
+export type { DrawerCloseReason, DrawerHeaderAction, DrawerHeaderConfig, DrawerNavigationBinding, DrawerNavigationController, DrawerNavigationEntry, DrawerNavigationOptions, DrawerNavigationRequest, DrawerNavigationTarget, DrawerProps, DrawerViewProps, } from './components/drawer';
 export type { NavListProps } from './components/nav-list';
 export type { NavListItemData, NavListLeaf } from './components/nav-list/types';
 export type { PagerProps } from './components/pager/Pager';