@toteat-eng/ds-react 2026.6.10 → 2026.6.18

package/dist/components/UserNotification/__stories__/UserNotification.stories.d.ts

@@ -0,0 +1,15 @@
+import type { Meta, StoryObj } from "@storybook/react-vite";
+import { UserNotification } from "../UserNotification";
+declare const meta: Meta<typeof UserNotification>;
+export default meta;
+type Story = StoryObj<typeof UserNotification>;
+export declare const Info: Story;
+export declare const Success: Story;
+export declare const Warning: Story;
+export declare const Error: Story;
+export declare const Neutral: Story;
+export declare const WithIcon: Story;
+export declare const WithAction: Story;
+export declare const WithAndAction: Story;
+export declare const AllVariants: Story;
+export declare const BothThemes: Story;

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

@@ -0,0 +1,2 @@
+export type { UserNotificationProps, UserNotificationVariant } from "./UserNotification";
+export { UserNotification } from "./UserNotification";

package/dist/hooks/useDropdown.d.ts

@@ -0,0 +1,59 @@
+export interface UseDropdownOptions {
+    /** Number of navigable items. Used to clamp the active index for roving keyboard nav. */
+    itemCount?: number;
+    /** Called when an item is chosen via keyboard (Enter/Space) at the active index. */
+    onSelectIndex?: (index: number) => void;
+    /** Fired after the dropdown opens. */
+    onOpen?: () => void;
+    /** Fired after the dropdown closes (any cause: toggle, Escape, outside-click, select). */
+    onClose?: () => void;
+    /** When true, toggle/open are no-ops. */
+    disabled?: boolean;
+    /**
+     * When false, the document `mousedown` outside-click handler is disabled.
+     * Defaults to true. (Some legacy components historically used `click` instead of
+     * `mousedown`; this option lets a component skip the shared handler if it must.)
+     */
+    closeOnOutsideClick?: boolean;
+}
+export interface UseDropdownReturn {
+    /** Whether the dropdown is currently open. */
+    isOpen: boolean;
+    /** Attach to the dropdown root: scopes outside-click detection. */
+    containerRef: React.RefObject<HTMLDivElement | null>;
+    /** Attach to the trigger: focus is returned here on Escape / close. */
+    triggerRef: React.RefObject<HTMLButtonElement | null>;
+    /** Index of the keyboard-active item (-1 when none). */
+    activeIndex: number;
+    /** Imperatively set the keyboard-active item index. */
+    setActiveIndex: (index: number) => void;
+    /** Open the dropdown (no-op when disabled). Resets active index to -1. */
+    open: () => void;
+    /** Close the dropdown. Resets active index to -1. Does NOT move focus. */
+    close: () => void;
+    /** Close the dropdown AND return focus to the trigger. */
+    closeAndFocusTrigger: () => void;
+    /** Toggle open/closed (no-op when disabled). */
+    toggle: () => void;
+    /**
+     * Roving keyboard handler modeled on DropdownButton's interaction:
+     * - closed: Enter/Space/ArrowDown open and focus the first item
+     * - open: ArrowDown/ArrowUp move the active index (clamped), Home/End jump to ends,
+     *   Enter/Space select the active item, Escape closes + returns focus, Tab closes.
+     * Components that own a different keyboard model can ignore this and use the
+     * primitives (open/close/activeIndex) directly.
+     */
+    handleTriggerKeyDown: (e: React.KeyboardEvent) => void;
+}
+/**
+ * Shared, headless dropdown interaction core. Internal — NOT part of the public API.
+ *
+ * Models the canonical Toteat dropdown UX used by `DropdownButton` (TRM login's
+ * `LanguageSelector`): open/close/toggle, document outside-click-to-close, Escape-to-close,
+ * roving Arrow/Home/End keyboard navigation with an active index, Enter/Space to select,
+ * and focus-return-to-trigger on close.
+ *
+ * Markup, ARIA, and selection semantics stay in the consuming component; this hook owns
+ * only the behaviour that every dropdown shares.
+ */
+export declare function useDropdown(options?: UseDropdownOptions): UseDropdownReturn;

package/dist/hooks/useScrollLock.d.ts

@@ -0,0 +1,19 @@
+export interface UseScrollLockOptions {
+    /**
+     * Locking strategy.
+     * - `"fixed"` (default): pins `document.body` with `position: fixed` and
+     *   restores the scroll position on release. This is Dialog's behavior —
+     *   it prevents the page from jumping when the scrollbar disappears.
+     * - `"overflow"`: only sets `document.body.style.overflow = "hidden"`.
+     *   This is Overlay's lighter behavior.
+     */
+    strategy?: "fixed" | "overflow";
+}
+/**
+ * Locks body scroll while `lock` is true and restores the previous state on
+ * cleanup (release / unmount). Internal hook — not part of the public API.
+ *
+ * Behavior is extracted verbatim from Dialog (`strategy: "fixed"`) and Overlay
+ * (`strategy: "overflow"`) so neither consumer changes visually or behaviorally.
+ */
+export declare function useScrollLock(lock: boolean, options?: UseScrollLockOptions): void;

package/dist/hooks/useToggle.d.ts

@@ -0,0 +1,7 @@
+export type UseToggleReturn = [boolean, () => void, React.Dispatch<React.SetStateAction<boolean>>];
+/**
+ * Minimal boolean toggle state. Returns `[state, toggle, setState]`.
+ * Internal hook — not part of the public API. Used to de-duplicate the
+ * open/close booleans in Accordion and SidebarNavSection.
+ */
+export declare function useToggle(initial?: boolean): UseToggleReturn;

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import "./tokens/base.css";
 import "./tokens/animations.css";
 import "./tokens/theme-angular.css";
-import "./tokens/theme-vue3.css";
+import "./tokens/toteat-react-ds.css";
 export { Accordion } from "./components/Accordion";
 export type { AppleSignInButtonProps } from "./components/AppleSignInButton";
 export { AppleSignInButton } from "./components/AppleSignInButton";
@@ -9,6 +9,8 @@ export type { BackgroundWrapperProps } from "./components/BackgroundWrapper";
 export { BackgroundWrapper } from "./components/BackgroundWrapper";
 export type { BadgeProps, BadgeSize, BadgeVariant } from "./components/Badge";
 export { Badge } from "./components/Badge";
+export type { BannerProps, BannerVariant } from "./components/Banner";
+export { Banner } from "./components/Banner";
 export type { BreadcrumbItem, BreadcrumbProps } from "./components/Breadcrumb";
 export { Breadcrumb } from "./components/Breadcrumb";
 export type { ButtonProps, ButtonSize, ButtonVariant, } from "./components/Button";
@@ -44,6 +46,8 @@ export type { EmptyStateProps } from "./components/EmptyState";
 export { EmptyState } from "./components/EmptyState";
 export type { ErrorBoundaryProps } from "./components/ErrorBoundary";
 export { ErrorBoundary } from "./components/ErrorBoundary";
+export type { ExtrasCategoryType, ExtrasDialogProps, SelectedExtraType, } from "./components/ExtrasDialog";
+export { ExtrasDialog } from "./components/ExtrasDialog";
 export type { FormFieldProps } from "./components/FormField";
 export { FormField } from "./components/FormField";
 export type { GoogleSignInButtonProps } from "./components/GoogleSignInButton";
@@ -70,11 +74,15 @@ export type { OverlayMessageProps, OverlayMessageStatus } from "./components/Ove
 export { OverlayMessage } from "./components/OverlayMessage";
 export type { PageLoadingOverlayProps } from "./components/PageLoadingOverlay";
 export { PageLoadingOverlay } from "./components/PageLoadingOverlay";
+export type { PermissionGateProps } from "./components/PermissionGate";
+export { PermissionGate } from "./components/PermissionGate";
 export type { PinLockOverlayProps } from "./components/PinLockOverlay";
 export { PinLockOverlay } from "./components/PinLockOverlay";
+export type { ProductTileProps, ProductTileType, StockStatusType } from "./components/ProductTile";
+export { ProductTile } from "./components/ProductTile";
 export type { RadioProps } from "./components/Radio";
 export { Radio } from "./components/Radio";
-export type { SearchInputProps } from "./components/SearchInput";
+export type { SearchInputProps, SearchInputSize } from "./components/SearchInput";
 export { SearchInput } from "./components/SearchInput";
 export type { SectionHeaderProps } from "./components/SectionHeader";
 export { SectionHeader } from "./components/SectionHeader";
@@ -92,15 +100,19 @@ export type { SpinnerProps, SpinnerSize } from "./components/Spinner";
 export { Spinner } from "./components/Spinner";
 export type { StatusBadgeProps } from "./components/StatusBadge";
 export { StatusBadge } from "./components/StatusBadge";
+export type { StatusBannerProps, StatusBannerVariant } from "./components/StatusBanner";
+export { StatusBanner } from "./components/StatusBanner";
 export type { StepperProps } from "./components/Stepper";
 export { Stepper } from "./components/Stepper";
+export type { TabItem as SegmentedTabItem, TabProps, TabSelectedColor, TabValue, } from "./components/Tab";
+export { Tab } from "./components/Tab";
 export type { TabBarProps, TabBarVariant } from "./components/TabBar";
 export { TabBar } from "./components/TabBar";
 export type { TabItem, TabsProps } from "./components/Tabs";
 export { Tabs } from "./components/Tabs";
 export type { TextareaProps } from "./components/Textarea";
 export { Textarea } from "./components/Textarea";
-export type { TextInputProps } from "./components/TextInput";
+export type { TextInputProps, TextInputSize, TextInputValidationState, } from "./components/TextInput";
 export { TextInput } from "./components/TextInput";
 export type { ThemeGateProps } from "./components/ThemeGate/ThemeGate";
 export { ThemeGate } from "./components/ThemeGate/ThemeGate";
@@ -115,6 +127,8 @@ export { TreeItem } from "./components/TreeItem";
 export type { TreeItemData } from "./components/TreeItem/treeTypes";
 export type { TreeListProps } from "./components/TreeList";
 export { TreeList } from "./components/TreeList";
+export type { UserNotificationProps, UserNotificationVariant, } from "./components/UserNotification";
+export { UserNotification } from "./components/UserNotification";
 export type { AdminPageHeaderProps } from "./layouts/AdminPageHeader";
 export { AdminPageHeader } from "./layouts/AdminPageHeader";
 export type { AppShellProps } from "./layouts/AppShell";
@@ -132,6 +146,7 @@ export { PageLayout } from "./layouts/PageLayout";
 export type { StackAlign, StackDirection, StackGap, StackJustify, StackProps, } from "./layouts/Stack";
 export { Stack } from "./layouts/Stack";
 export { cn } from "./utils/cn";
+export type { CsvCell } from "./utils/csv";
 export { escapeCell, rowsToCsv } from "./utils/csv";
 export { useFocusTrap } from "./utils/focusTrap";
 export { portal } from "./utils/portal";