@toteat-eng/ds-react 2026.6.10-3 → 2026.6.10-4

package/dist/components/StatusBanner/StatusBanner.d.ts

@@ -0,0 +1,18 @@
+import type React from "react";
+import type { IconNameType } from "../Icon";
+export type StatusBannerVariant = "info" | "success" | "warning" | "error" | "neutral";
+export interface StatusBannerProps {
+    variant?: StatusBannerVariant;
+    icon?: IconNameType;
+    action?: React.ReactNode;
+    children: React.ReactNode;
+    className?: string;
+    "data-testid"?: string;
+}
+/**
+ * Persistent, non-dismissable status surface (e.g. POS connectivity).
+ * Shares the notification surface with UserNotification but never renders a
+ * dismiss control. Uses `aria-atomic="true"` so assistive tech re-announces the
+ * full message when its content changes.
+ */
+export declare function StatusBanner({ variant, icon, action, children, className, "data-testid": testId, }: StatusBannerProps): React.ReactElement;

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

@@ -0,0 +1,23 @@
+import type { Meta, StoryObj } from "@storybook/react-vite";
+import { StatusBanner } from "../StatusBanner";
+/**
+ * Persistent, non-dismissable status surface (e.g. POS connectivity).
+ *
+ * a11y note: when `variant="error"` the root is `role="alert"` /
+ * `aria-live="assertive"` / `aria-atomic="true"`. Do NOT mutate `children` on
+ * every render in an error/alert banner — each change re-announces the full
+ * message and floods screen-reader users. Update the text only when the
+ * underlying status actually changes.
+ */
+declare const meta: Meta<typeof StatusBanner>;
+export default meta;
+type Story = StoryObj<typeof StatusBanner>;
+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 AllVariants: Story;
+export declare const BothThemes: Story;

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

@@ -0,0 +1,2 @@
+export type { StatusBannerProps, StatusBannerVariant } from "./StatusBanner";
+export { StatusBanner } from "./StatusBanner";

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

@@ -0,0 +1,41 @@
+import type React from "react";
+import type { IconNameType } from "../Icon";
+/**
+ * Shared presentational/ARIA shell for notification-surface primitives
+ * (UserNotification, StatusBanner). INTERNAL — never exported from any index.ts.
+ *
+ * Owns only structure + ARIA. Each caller supplies its own CSS-module root
+ * class (`rootClassName`) so visual variance (e.g. enter animation, inline-flex
+ * vs flex) lives entirely in the caller's module.css.
+ */
+export type NotificationVariant = "info" | "success" | "warning" | "error" | "neutral";
+export interface NotificationBaseProps {
+    variant: NotificationVariant;
+    /**
+     * Caller's CSS-module root class (e.g. styles.notification / styles.statusBanner).
+     * Typed loosely because CSS-module lookups widen to `string | undefined` under
+     * `noUncheckedIndexedAccess`.
+     */
+    rootClassName: string | undefined;
+    /** Caller's content span class. */
+    contentClassName: string | undefined;
+    /** Caller's action span class. */
+    actionClassName: string | undefined;
+    icon?: IconNameType;
+    action?: React.ReactNode;
+    children: React.ReactNode;
+    /** Extra consumer-supplied className, merged after the module root class. */
+    className?: string;
+    "data-testid"?: string;
+    /**
+     * Trailing control (e.g. UserNotification passes <CloseButton/>).
+     * StatusBanner omits it — no element is rendered when undefined.
+     */
+    dismissSlot?: React.ReactNode;
+    /**
+     * Adds aria-atomic="true" to the root. Opt-in so callers that must keep a
+     * frozen DOM (UserNotification) are unaffected.
+     */
+    ariaAtomic?: boolean;
+}
+export declare function NotificationBase({ variant, rootClassName, contentClassName, actionClassName, icon, action, children, className, "data-testid": testId, dismissSlot, ariaAtomic, }: NotificationBaseProps): React.ReactElement;

package/dist/index.d.ts

@@ -98,6 +98,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 { 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";