@toteat-eng/ds-react 2026.6.9 → 2026.6.10-2

package/dist/components/Banner/Banner.d.ts

@@ -0,0 +1,14 @@
+import type React from "react";
+import type { IconNameType } from "../Icon";
+export type BannerVariant = "info" | "success" | "warning" | "error" | "neutral";
+export interface BannerProps {
+    variant?: BannerVariant;
+    icon?: IconNameType;
+    onDismiss?: () => void;
+    dismissLabel?: string;
+    action?: React.ReactNode;
+    children: React.ReactNode;
+    className?: string;
+    "data-testid"?: string;
+}
+export declare function Banner({ variant, icon, onDismiss, dismissLabel, action, children, className, "data-testid": testId, }: BannerProps): React.ReactElement;

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

@@ -0,0 +1,16 @@
+import type { Meta, StoryObj } from "@storybook/react-vite";
+import { Banner } from "../Banner";
+declare const meta: Meta<typeof Banner>;
+export default meta;
+type Story = StoryObj<typeof Banner>;
+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 WithDismiss: Story;
+export declare const WithAction: Story;
+export declare const WithDismissAndAction: Story;
+export declare const AllVariants: Story;
+export declare const BothThemes: Story;

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

@@ -0,0 +1,2 @@
+export type { BannerProps, BannerVariant } from "./Banner";
+export { Banner } from "./Banner";

package/dist/components/Breadcrumb/Breadcrumb.d.ts

@@ -0,0 +1,14 @@
+export interface BreadcrumbItem {
+    id: string;
+    label: string;
+    href?: string;
+}
+export interface BreadcrumbProps {
+    items: BreadcrumbItem[];
+    onBack?: () => void;
+    backLabel?: string;
+    label?: string;
+    className?: string;
+    "data-testid"?: string;
+}
+export declare function Breadcrumb({ items, onBack, backLabel, label, className, "data-testid": testId, }: BreadcrumbProps): import("react/jsx-runtime").JSX.Element | null;

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

@@ -0,0 +1,14 @@
+import type { Meta, StoryObj } from "@storybook/react-vite";
+import { Breadcrumb } from "../Breadcrumb";
+declare const meta: Meta<typeof Breadcrumb>;
+export default meta;
+type Story = StoryObj<typeof Breadcrumb>;
+export declare const SingleItem: Story;
+export declare const MultipleItems: Story;
+export declare const WithBackButton: Story;
+export declare const WithoutBackButton: Story;
+export declare const ItemsWithHref: Story;
+export declare const ItemsWithHrefAndBack: Story;
+export declare const ThemeToteatReactDs: Story;
+export declare const ThemeAngularLegacy: Story;
+export declare const BothThemes: Story;

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

@@ -0,0 +1,2 @@
+export type { BreadcrumbItem, BreadcrumbProps } from "./Breadcrumb";
+export { Breadcrumb } from "./Breadcrumb";

package/dist/components/CloseButton/CloseButton.d.ts

@@ -0,0 +1,18 @@
+export interface CloseButtonProps {
+    onClick?: () => void;
+    /** Accessible name for the dismiss button. */
+    label?: string;
+    /** Icon size in px (also drives the rendered close glyph size). */
+    size?: number;
+    /** Consumer class applied alongside the zero-specificity baseline, so the
+     * host component's exact look is preserved. */
+    className?: string;
+    "data-testid"?: string;
+}
+/**
+ * Internal dismiss-button primitive. NOT part of the public API — used to
+ * de-duplicate the bespoke close buttons across Dialog, Toast, Banner and
+ * OverlayMessage. Renders a single native `<button>` containing the canonical
+ * `close-outline` icon.
+ */
+export declare function CloseButton({ onClick, label, size, className, "data-testid": testId, }: CloseButtonProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,2 @@
+export type { CloseButtonProps } from "./CloseButton";
+export { CloseButton } from "./CloseButton";

package/dist/components/ErrorBoundary/ErrorBoundary.d.ts

@@ -15,6 +15,6 @@ export declare class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBo
     static getDerivedStateFromError(error: Error): ErrorBoundaryState;
     componentDidCatch(error: Error, info: ErrorInfo): void;
     handleRetry: () => void;
-    render(): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | import("react/jsx-runtime").JSX.Element | null | undefined;
+    render(): string | number | bigint | boolean | import("react/jsx-runtime").JSX.Element | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | null | undefined;
 }
 export {};

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

@@ -1,2 +1,2 @@
-export type { ExtrasDialogProps } from "./ExtrasDialog";
+export type { ExtrasCategoryType, ExtrasDialogProps, SelectedExtraType } from "./ExtrasDialog";
 export { ExtrasDialog } from "./ExtrasDialog";

package/dist/components/PermissionGate/PermissionGate.d.ts

@@ -0,0 +1,30 @@
+import type { ReactNode } from "react";
+export interface PermissionGateProps {
+    /** Permission decision resolved by the consumer app. When false, renders fallback. */
+    granted: boolean;
+    /** Rendered when granted is true. */
+    children: ReactNode;
+    /** Rendered when granted is false. @default null */
+    fallback?: ReactNode;
+    /**
+     * Accepted to satisfy the DS `data-testid` convention and to let consumers spread
+     * a testid coming from a parent without a TypeScript error. It is intentionally
+     * UNUSED: this component renders a React fragment with no DOM root to attach it to
+     * (identical to `React.Fragment`, which also ignores `data-testid`). If you need a
+     * testable DOM node, put it on the children you pass in.
+     */
+    "data-testid"?: string;
+}
+/**
+ * PermissionGate — a purely PRESENTATIONAL / STRUCTURAL primitive.
+ *
+ * It contains NO RBAC logic: no scopes, no bitwise actions, no hooks, no stores.
+ * Each consumer app computes the permission decision and passes it in as the
+ * `granted` boolean. When `granted` is true the `children` are rendered, otherwise
+ * the `fallback` (default `null`) is rendered.
+ *
+ * It renders a React fragment with NO DOM wrapper, so it never injects an anonymous
+ * layout node into a flex/grid container. There is no `.module.css` for this
+ * component because it has no visual surface of its own.
+ */
+export declare function PermissionGate({ granted, children, fallback }: PermissionGateProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,10 @@
+import type { Meta, StoryObj } from "@storybook/react-vite";
+import { PermissionGate } from "../PermissionGate";
+declare const meta: Meta<typeof PermissionGate>;
+export default meta;
+type Story = StoryObj<typeof PermissionGate>;
+export declare const Granted: Story;
+export declare const Denied_: Story;
+export declare const DeniedNoFallback: Story;
+export declare const DynamicToggle: Story;
+export declare const BothThemes: Story;

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

@@ -0,0 +1,2 @@
+export type { PermissionGateProps } from "./PermissionGate";
+export { PermissionGate } from "./PermissionGate";

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

@@ -1,2 +1,2 @@
-export type { ProductTileProps } from "./ProductTile";
+export type { ProductTileProps, ProductTileType, StockStatusType } from "./ProductTile";
 export { ProductTile } from "./ProductTile";

package/dist/components/SearchInput/SearchInput.d.ts

@@ -0,0 +1,21 @@
+import { type InputHTMLAttributes } from "react";
+export interface SearchInputProps {
+    value: string;
+    onChange: (value: string) => void;
+    onClear?: () => void;
+    placeholder?: string;
+    label: string;
+    id?: string;
+    disabled?: boolean;
+    clearLabel?: string;
+    className?: string;
+    /**
+     * Native attributes/handlers forwarded to the underlying `<input type="search">`
+     * (e.g. `name`, `autoComplete`, `onBlur`, `onKeyDown`, `aria-describedby`).
+     * The component-controlled props (`value`, `onChange`, `id`, `type`, `disabled`,
+     * `placeholder`, `className`) remain the source of truth and cannot be overridden here.
+     */
+    inputProps?: Omit<InputHTMLAttributes<HTMLInputElement>, "value" | "onChange" | "id" | "type" | "disabled" | "placeholder" | "className">;
+    "data-testid"?: string;
+}
+export declare function SearchInput({ value, onChange, onClear, placeholder, label, id: idProp, disabled, clearLabel, className, inputProps, "data-testid": testId, }: SearchInputProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,11 @@
+import type { Meta, StoryObj } from "@storybook/react-vite";
+import { SearchInput } from "../SearchInput";
+declare const meta: Meta<typeof SearchInput>;
+export default meta;
+type Story = StoryObj<typeof SearchInput>;
+export declare const Empty: Story;
+export declare const WithValue: Story;
+export declare const Disabled: Story;
+export declare const DisabledWithValue: Story;
+export declare const CustomPlaceholder: Story;
+export declare const BothThemes: Story;

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

@@ -0,0 +1,2 @@
+export type { SearchInputProps } from "./SearchInput";
+export { SearchInput } from "./SearchInput";

package/dist/components/Stepper/Stepper.d.ts

@@ -0,0 +1,18 @@
+export interface StepperProps {
+    value: number;
+    onChange: (value: number) => void;
+    /** Lower bound (inclusive). Must be ≤ `max`. @default 0 */
+    min?: number;
+    /** Upper bound (inclusive). Must be ≥ `min`. @default Number.MAX_SAFE_INTEGER */
+    max?: number;
+    /** Increment size. Must be > 0. @default 1 */
+    step?: number;
+    disabled?: boolean;
+    /** Accessible name for the `role="group"` container. Required — an unnamed group is an a11y violation. */
+    "aria-label": string;
+    decrementLabel?: string;
+    incrementLabel?: string;
+    className?: string;
+    "data-testid"?: string;
+}
+export declare function Stepper({ value, onChange, min, max, step, disabled, "aria-label": ariaLabel, decrementLabel, incrementLabel, className, "data-testid": testId, }: StepperProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,11 @@
+import type { Meta, StoryObj } from "@storybook/react-vite";
+import { Stepper } from "../Stepper";
+declare const meta: Meta<typeof Stepper>;
+export default meta;
+type Story = StoryObj<typeof Stepper>;
+export declare const Default: Story;
+export declare const AtMin: Story;
+export declare const AtMax: Story;
+export declare const FullyDisabled: Story;
+export declare const CustomStep: Story;
+export declare const BothThemes: Story;

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

@@ -0,0 +1,2 @@
+export type { StepperProps } from "./Stepper";
+export { Stepper } from "./Stepper";

package/dist/components/TextInput/TextInput.d.ts

@@ -1,5 +1,5 @@
 import { type InputHTMLAttributes } from "react";
-export type TextInputSize = "small" | "medium";
+export type TextInputSize = "small" | "medium" | "large";
 export interface TextInputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, "size"> {
     error?: boolean;
     showPasswordToggle?: boolean;

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,10 @@ 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";
 export { Button } from "./components/Button";
 export type { CardElevation, CardPadding, CardProps } from "./components/Card";
@@ -42,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";
@@ -68,10 +74,16 @@ 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 { SearchInput } from "./components/SearchInput";
 export type { SectionHeaderProps } from "./components/SectionHeader";
 export { SectionHeader } from "./components/SectionHeader";
 export type { SelectOption, SelectProps } from "./components/Select";
@@ -88,6 +100,8 @@ 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 { StepperProps } from "./components/Stepper";
+export { Stepper } from "./components/Stepper";
 export type { TabBarProps, TabBarVariant } from "./components/TabBar";
 export { TabBar } from "./components/TabBar";
 export type { TabItem, TabsProps } from "./components/Tabs";
@@ -126,5 +140,6 @@ 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 { escapeCell, rowsToCsv } from "./utils/csv";
 export { useFocusTrap } from "./utils/focusTrap";
 export { portal } from "./utils/portal";