@fairgarden/design 0.1.0-alpha.0 → 0.1.0-alpha.1

package/feedback/tag/Tag.d.ts

@@ -0,0 +1,40 @@
+import * as React from 'react';
+import { useRender } from '@base-ui/react/use-render';
+import { type VariantProps } from 'class-variance-authority';
+import { type IconName } from '../../foundations/icon';
+export declare const tag: (props?: ({
+    primary?: "ruby" | "brown" | "crimson" | "gold" | "gray" | "indigo" | "olive" | "pink" | "plum" | "purple" | "red" | "tomato" | "violet" | "bronze" | "iris" | "mauve" | "sage" | "sand" | "slate" | null | undefined;
+    secondary?: "ruby" | "blue" | "brown" | "crimson" | "cyan" | "gold" | "gray" | "green" | "indigo" | "lime" | "olive" | "orange" | "pink" | "plum" | "purple" | "red" | "teal" | "tomato" | "violet" | "yellow" | "amber" | "bronze" | "grass" | "iris" | "jade" | "mauve" | "mint" | "sage" | "sand" | "sky" | "slate" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+type TagVariants = VariantProps<typeof tag>;
+/** Props for Tag: `span` props, `render`, the link target, the icon and the color axes. */
+export type TagProps = useRender.ComponentProps<'span'> & {
+    /** Makes the tag a link to its topic; it renders an `<a>` and gains the link states. */
+    href?: string;
+    /**
+     * The topic's subject symbol, Material Symbols Rounded at the tag tier
+     * (20 px, FILL 0): an inventory name, or a registered subject symbol's
+     * SVG element, which the tag sizes and fills in `currentColor` [D166].
+     * It carries the tag's only color, `--role-accent`.
+     */
+    icon?: IconName | React.ReactElement;
+    /**
+     * Primary Radix scale: the label ink and focus ring. Never defaulted;
+     * omitted, it inherits the scope [D133].
+     */
+    primary?: TagVariants['primary'];
+    /**
+     * Secondary Radix scale: the taxonomy scale, which colors the icon
+     * through `--role-accent`. Omitted, it inherits the scope.
+     */
+    secondary?: TagVariants['secondary'];
+};
+/**
+ * A topic tag: an icon plus a caps label (`type-label` at weight 700,
+ * authored in sentence case; topic tags keep caps [D160]), with no
+ * container. Color sits on the icon only, never on the small label text.
+ * Pass `href` to link it to its topic.
+ */
+export declare function Tag(props: TagProps): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>;
+export {};
+//# sourceMappingURL=Tag.d.ts.map

package/feedback/tag/Tag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tag.d.ts","sourceRoot":"","sources":["../../src/feedback/tag/Tag.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAErD,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAEjE,OAAO,EAAQ,KAAK,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AAoB5D,eAAO,MAAM,GAAG;;;8EAMd,CAAA;AAEF,KAAK,WAAW,GAAG,YAAY,CAAC,OAAO,GAAG,CAAC,CAAA;AAE3C,2FAA2F;AAC3F,MAAM,MAAM,QAAQ,GAAG,SAAS,CAAC,cAAc,CAAC,MAAM,CAAC,GAAG;IACxD,wFAAwF;IACxF,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;;;OAKG;IACH,IAAI,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC,YAAY,CAAA;IACpC;;;OAGG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC,SAAS,CAAC,CAAA;IAChC;;;OAGG;IACH,SAAS,CAAC,EAAE,WAAW,CAAC,WAAW,CAAC,CAAA;CACrC,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,GAAG,CAAC,KAAK,EAAE,QAAQ,0EAgClC"}

package/feedback/tag/Tag.js

@@ -0,0 +1,56 @@
+'use client';
+import * as React from 'react';
+import { useRender } from '@base-ui/react/use-render';
+import { mergeProps } from '@base-ui/react/merge-props';
+import { cva } from 'class-variance-authority';
+import { Icon } from '../../foundations/icon';
+import { primaryScaleVariants, secondaryScaleVariants } from '../../utils/scales';
+import { useScopeAttributes } from '../../utils/scope';
+import styles from './tag.module.css';
+/*
+ * Tag (§10.11): the topic tag, taxonomy with no container.
+ *
+ * Implementation (CSS Modules + CVA)
+ * - Module: tag.module.css; CVA function `tag`.
+ * - Axes: `primary`, `secondary` → scales module classes.
+ * - Compound variants: none. Defaults: none; color axes: none.
+ * - Color fallback: the taxonomy scale, passed as `secondary`; omitted, it
+ *   inherits the scope.
+ * - States (linked tags only): `:hover` → the bare-text underline on the
+ *   label, --role-accent at --border-size-2, offset --size-px-1 [D181];
+ *   `:focus-visible` → ring around icon and label.
+ * - Parts: base, icon, label.
+ * - Scope: none. Container: none; inherits its context.
+ */
+export const tag = cva(styles.base, {
+    variants: {
+        // Color axes: never defaulted, so an omitted prop inherits the scope [D133].
+        primary: primaryScaleVariants,
+        secondary: secondaryScaleVariants,
+    },
+});
+/**
+ * A topic tag: an icon plus a caps label (`type-label` at weight 700,
+ * authored in sentence case; topic tags keep caps [D160]), with no
+ * container. Color sits on the icon only, never on the small label text.
+ * Pass `href` to link it to its topic.
+ */
+export function Tag(props) {
+    const { render, ref, className, href, icon, primary, secondary, children, ...rest } = props;
+    const scope = useScopeAttributes();
+    const glyph = icon == null ? null : typeof icon === 'string' ? (React.createElement(Icon, { name: icon, size: "tag", className: styles.icon })) : (React.createElement("span", { className: styles.icon, "aria-hidden": "true" }, icon));
+    return useRender({
+        defaultTagName: href == null ? 'span' : 'a',
+        render,
+        ref,
+        props: mergeProps({
+            ...scope,
+            ...(href == null ? null : { href }),
+            className: tag({ primary, secondary, className }),
+            children: (React.createElement(React.Fragment, null,
+                glyph,
+                React.createElement("span", { className: styles.label }, children))),
+        }, rest),
+    });
+}
+//# sourceMappingURL=Tag.js.map

package/feedback/tag/Tag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tag.js","sourceRoot":"","sources":["../../src/feedback/tag/Tag.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAEZ,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAA;AACvD,OAAO,EAAE,GAAG,EAAqB,MAAM,0BAA0B,CAAA;AAEjE,OAAO,EAAE,IAAI,EAAiB,MAAM,wBAAwB,CAAA;AAC5D,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AACjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,MAAM,MAAM,kBAAkB,CAAA;AAErC;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE;IAClC,QAAQ,EAAE;QACR,6EAA6E;QAC7E,OAAO,EAAE,oBAAoB;QAC7B,SAAS,EAAE,sBAAsB;KAClC;CACF,CAAC,CAAA;AA2BF;;;;;GAKG;AACH,MAAM,UAAU,GAAG,CAAC,KAAe;IACjC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAA;IAC3F,MAAM,KAAK,GAAG,kBAAkB,EAAE,CAAA;IAElC,MAAM,KAAK,GACT,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAC/C,oBAAC,IAAI,IAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAC,KAAK,EAAC,SAAS,EAAE,MAAM,CAAC,IAAI,GAAI,CACxD,CAAC,CAAC,CAAC,CACF,8BAAM,SAAS,EAAE,MAAM,CAAC,IAAI,iBAAc,MAAM,IAC7C,IAAI,CACA,CACR,CAAA;IAEH,OAAO,SAAS,CAAC;QACf,cAAc,EAAE,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG;QAC3C,MAAM;QACN,GAAG;QACH,KAAK,EAAE,UAAU,CACf;YACE,GAAG,KAAK;YACR,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAE,EAAE,IAAI,EAAmC,CAAC;YACrE,SAAS,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;YACjD,QAAQ,EAAE,CACR;gBACG,KAAK;gBACN,8BAAM,SAAS,EAAE,MAAM,CAAC,KAAK,IAAG,QAAQ,CAAQ,CAC/C,CACJ;SACF,EACD,IAAI,CACL;KACF,CAAC,CAAA;AACJ,CAAC"}

package/feedback/tag/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/feedback/tag/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAA"}

package/feedback/tag/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/feedback/tag/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAA"}

package/feedback/toast/Toast.d.ts

@@ -0,0 +1,96 @@
+import * as React from 'react';
+import { Toast as BaseToast } from '@base-ui/react/toast';
+import { type Status } from '../../utils/StatusGlyph';
+import { type PrimaryScale, type RadixScale } from '../../utils/scales';
+export declare const toast: (props?: import("class-variance-authority/types").ClassProp | undefined) => string;
+export type ToastStatus = Status;
+/** An action cell's button props: its label (`children`, title case), `onClick`, `aria-busy` … */
+export type ToastAction = Omit<React.ComponentPropsWithoutRef<'button'>, 'className' | 'style'> & {
+    /**
+     * A destructive action ("Discard Notes"): the label takes the danger ink,
+     * --role-danger-text [D192]. Default `false`.
+     */
+    destructive?: boolean;
+};
+/** What the system keeps on each toast's `data`. */
+export interface ToastData {
+    actions?: ToastAction[];
+}
+/** Options for a toast. */
+export interface ToastOptions {
+    /** Reuse an id to replace a showing toast. */
+    id?: string;
+    /** The message's lead, in `type-body-ui` at --font-weight-6 ("3 items removed"). */
+    title?: React.ReactNode;
+    /** The rest of the message, in `type-body-ui`; up to 3 lines at base. */
+    description?: React.ReactNode;
+    /**
+     * `info` ○, `success` ●, `warning` ▲ or `danger` ◆, each with its inner
+     * mark in the status scale. Omitted: the neutral toast, no glyph.
+     * Warning and danger persist; danger is announced assertively.
+     */
+    status?: ToastStatus;
+    /**
+     * Action cells: full-height `type-button` text cells with title-case
+     * labels ("Undo", "View Order"). A toast with actions persists. While an
+     * action runs, update it with `aria-busy` and an "-ing…" label ("Undoing…").
+     * A destructive action sets `destructive`, which draws its label red [D192].
+     */
+    actions?: ToastAction[];
+    /**
+     * Auto-dismiss time in ms for a neutral, info or success toast without
+     * actions: at least 6000 (--ds-duration-toast); `0` persists.
+     */
+    timeout?: number;
+    /** Called when the toast starts closing. */
+    onClose?: () => void;
+    /** Called when the toast has left the DOM. */
+    onRemove?: () => void;
+}
+type BaseToastObject = BaseToast.Root.ToastObject<ToastData>;
+/** The toast manager with the §10.17 rules applied. */
+export interface ToastManager {
+    /** The toasts, newest first. */
+    toasts: BaseToastObject[];
+    /** Shows a toast and returns its id. Only one shows at a time; the rest queue. */
+    add: (options: ToastOptions) => string;
+    /** Changes a toast, such as an action's busy label; persistence is recomputed. */
+    update: (id: string, options: Omit<Partial<ToastOptions>, 'id'>) => void;
+    /** Closes one toast, or all of them without an id. */
+    close: (id?: string) => void;
+}
+/**
+ * Adds, updates and closes toasts from inside a ToastProvider, with the
+ * §10.17 rules applied: warning, danger and action toasts persist, the
+ * rest stay at least 6 s, and danger is announced assertively.
+ */
+export declare function useToastManager(): ToastManager;
+/** Props for ToastProvider. */
+export interface ToastProviderProps {
+    children?: React.ReactNode;
+    /**
+     * Default auto-dismiss time in ms, at least 6000 (--ds-duration-toast).
+     * Timers pause on hover, on focus and while the tab is hidden.
+     */
+    timeout?: number;
+    /** A manager from `Toast.createToastManager()` in @base-ui/react, to add toasts from outside React. */
+    toastManager?: BaseToast.Provider.Props['toastManager'];
+    /** Primary Radix scale inside the bar's `white` scope. Omitted, the white preset's default [D133]. */
+    primary?: PrimaryScale;
+    /** Secondary Radix scale inside the bar. Omitted, the white preset's default. */
+    secondary?: RadixScale;
+    /** The bar region's accessible name. Default "Notifications". */
+    label?: string;
+    /** The element the bar's portal renders into. Default: `document.body`. */
+    container?: BaseToast.Portal.Props['container'];
+}
+/**
+ * Provides toasts to its children and renders the docked bar: full width
+ * at the bottom viewport edge on --layer-5, a `white` scope with a
+ * --border-size-2 --primary12 top rule, content aligned to
+ * --ds-container-content. One toast shows at a time; a queue count
+ * ("1 of 3") shows while more wait. The page reserves no space for it.
+ */
+export declare function ToastProvider(props: ToastProviderProps): React.JSX.Element;
+export {};
+//# sourceMappingURL=Toast.d.ts.map

package/feedback/toast/Toast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Toast.d.ts","sourceRoot":"","sources":["../../src/feedback/toast/Toast.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAKzD,OAAO,EAA2C,KAAK,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAQ9F,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,UAAU,EAChB,MAAM,oBAAoB,CAAA;AAqC3B,eAAO,MAAM,KAAK,oFAAmB,CAAA;AAErC,MAAM,MAAM,WAAW,GAAG,MAAM,CAAA;AAKhC,kGAAkG;AAClG,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,QAAQ,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,GAAG;IAChG;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB,CAAA;AAED,oDAAoD;AACpD,MAAM,WAAW,SAAS;IACxB,OAAO,CAAC,EAAE,WAAW,EAAE,CAAA;CACxB;AAED,2BAA2B;AAC3B,MAAM,WAAW,YAAY;IAC3B,8CAA8C;IAC9C,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,oFAAoF;IACpF,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACvB,yEAAyE;IACzE,WAAW,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC7B;;;;OAIG;IACH,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,WAAW,EAAE,CAAA;IACvB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;CACtB;AAED,KAAK,eAAe,GAAG,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAA;AAqC5D,uDAAuD;AACvD,MAAM,WAAW,YAAY;IAC3B,gCAAgC;IAChC,MAAM,EAAE,eAAe,EAAE,CAAA;IACzB,kFAAkF;IAClF,GAAG,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,MAAM,CAAA;IACtC,kFAAkF;IAClF,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,IAAI,CAAC,KAAK,IAAI,CAAA;IACxE,sDAAsD;IACtD,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CAC7B;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAa9C;AAED,+BAA+B;AAC/B,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC1B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,uGAAuG;IACvG,YAAY,CAAC,EAAE,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,CAAA;IACvD,sGAAsG;IACtG,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB,iFAAiF;IACjF,SAAS,CAAC,EAAE,UAAU,CAAA;IACtB,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,2EAA2E;IAC3E,SAAS,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAA;CAChD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,qBAYtD"}

package/feedback/toast/Toast.js

@@ -0,0 +1,173 @@
+'use client';
+import * as React from 'react';
+import { Toast as BaseToast } from '@base-ui/react/toast';
+import { Button as BaseButton } from '@base-ui/react/button';
+import { cva } from 'class-variance-authority';
+import { Button } from '../../actions/button';
+import { StatusGlyph, statusLabels, statusScales } from '../../utils/StatusGlyph';
+import { cx } from '../../utils/className';
+import { OverlayScope, overlayActionClassName, overlayAttributes, overlayScales, } from '../../utils/overlay';
+import { primaryScaleVariants, secondaryScaleVariants, } from '../../utils/scales';
+import styles from './toast.module.css';
+/*
+ * Toast (§10.17): a brief confirmation or a non-blocking notice, docked as
+ * a full-width bar, never a floating card [D25].
+ *
+ * Implementation (CSS Modules + CVA)
+ * - Module: toast.module.css; CVA function `toast` (one toast in the bar).
+ * - Axes: `status` → info | success | warning | danger (selects the glyph
+ *   and its scale; it carries no class; omitted for the neutral toast);
+ *   `primary`, `secondary` → scales module classes on the bar's scope
+ *   (ToastProvider).
+ * - Compound variants: none. Defaults: no `status`; color axes: none.
+ * - Color fallback: the glyph takes the status scale [D129]; the bar takes
+ *   the `white` preset's defaults.
+ * - States: Root data-starting-style / data-ending-style → the clip reveal
+ *   from the bottom edge, instant under --motionNotOK [D91]; data-limited →
+ *   hidden beyond the one visible toast (the queue count shows); Base UI's
+ *   data-type is not styled. Action :hover → label --role-link-hover, as
+ *   the §9.2 `text` Button (underlined where that is --primary12) [D181],
+ *   :focus-visible → ring inside the cell, :active → the inverse pair,
+ *   aria-busy → "Undoing…" at rest width; a `destructive` action's label
+ *   is --role-danger-text, underlined on hover [D192]. Close is an
+ *   icon-only Button.
+ * - Parts: viewport (the docked bar's host), base (a toast, the bar), glyph,
+ *   message, title, description, queue, actions, action, close.
+ * - Scope: the viewport renders in its Base UI Portal and declares a nested
+ *   `white` scope (`page` scheme, no data-theme); its rule is the
+ *   --border-size-2 --primary12 overlay frame on the content side only
+ *   [D23, D89, D139, D156].
+ * - Container: none; the bar is page frame and uses the viewport media.
+ *
+ * Timing: auto-dismissing toasts stay at least --ds-duration-toast (6 s)
+ * and pause on hover, on focus and while the tab is hidden; warning,
+ * danger and action toasts persist until acted on or dismissed.
+ */
+export const toast = cva(styles.base);
+/** --ds-duration-toast, restated in ms for Base UI's timers. */
+const TOAST_DURATION = 6000;
+function isStatus(type) {
+    return type === 'info' || type === 'success' || type === 'warning' || type === 'danger';
+}
+/** Base UI's promise toasts report `error`; the system calls it danger. */
+function toStatus(type) {
+    if (type === 'error')
+        return 'danger';
+    return isStatus(type) ? type : undefined;
+}
+/** At least --ds-duration-toast; 0 persists; undefined keeps the provider's. */
+function clampTimeout(timeout) {
+    if (timeout === undefined)
+        return undefined;
+    return timeout <= 0 ? 0 : Math.max(timeout, TOAST_DURATION);
+}
+/** Applies the §10.17 rules: persistence, the minimum time and assertive danger. */
+function toBaseOptions(options, previous) {
+    const { status: statusOption, actions: actionsOption, timeout: timeoutOption, ...rest } = options;
+    const status = 'status' in options ? statusOption : toStatus(previous?.type);
+    const actions = 'actions' in options ? actionsOption : previous?.data?.actions;
+    const persists = status === 'warning' || status === 'danger' || (actions?.length ?? 0) > 0;
+    const timeout = persists
+        ? 0
+        : clampTimeout('timeout' in options ? timeoutOption : previous?.timeout);
+    return {
+        ...rest,
+        type: status,
+        timeout,
+        priority: status === 'danger' ? 'high' : 'low',
+        data: { ...previous?.data, actions },
+    };
+}
+/**
+ * Adds, updates and closes toasts from inside a ToastProvider, with the
+ * §10.17 rules applied: warning, danger and action toasts persist, the
+ * rest stay at least 6 s, and danger is announced assertively.
+ */
+export function useToastManager() {
+    const manager = BaseToast.useToastManager();
+    const { toasts, add, update, close } = manager;
+    return React.useMemo(() => ({
+        toasts,
+        add: ({ id, ...options }) => add({ id, ...toBaseOptions(options) }),
+        update: (id, options) => update(id, (previous) => toBaseOptions(options, previous)),
+        close,
+    }), [toasts, add, update, close]);
+}
+/**
+ * Provides toasts to its children and renders the docked bar: full width
+ * at the bottom viewport edge on --layer-5, a `white` scope with a
+ * --border-size-2 --primary12 top rule, content aligned to
+ * --ds-container-content. One toast shows at a time; a queue count
+ * ("1 of 3") shows while more wait. The page reserves no space for it.
+ */
+export function ToastProvider(props) {
+    const { children, timeout, toastManager, primary, secondary, label, container } = props;
+    return (React.createElement(BaseToast.Provider, { timeout: clampTimeout(timeout) ?? TOAST_DURATION, limit: 1, toastManager: toastManager },
+        children,
+        React.createElement(ToastViewport, { primary: primary, secondary: secondary, label: label, container: container })));
+}
+function ToastViewport(props) {
+    const { primary, secondary, label, container } = props;
+    const { toasts } = BaseToast.useToastManager();
+    const scales = overlayScales(primary, secondary);
+    const hasToasts = toasts.length > 0;
+    // A hidden tab pauses the timers. Base UI pauses on window blur, which
+    // switching tabs fires, but a page loaded or updated in a background tab
+    // never received one; send it while hidden. This effect runs after the
+    // viewport's own, which attach the listeners once a toast exists.
+    React.useEffect(() => {
+        if (!hasToasts)
+            return undefined;
+        const pauseWhileHidden = () => {
+            if (document.visibilityState === 'hidden') {
+                window.dispatchEvent(new FocusEvent('blur'));
+            }
+        };
+        pauseWhileHidden();
+        document.addEventListener('visibilitychange', pauseWhileHidden);
+        return () => document.removeEventListener('visibilitychange', pauseWhileHidden);
+    }, [hasToasts]);
+    const queued = toasts.filter((item) => item.transitionStatus !== 'ending');
+    return (React.createElement(BaseToast.Portal, { container: container },
+        React.createElement(BaseToast.Viewport, { ...overlayAttributes, "aria-label": label, className: cx(styles.viewport, primaryScaleVariants[scales.primary], secondaryScaleVariants[scales.secondary], overlayActionClassName) },
+            React.createElement(OverlayScope, null, toasts.map((item) => (React.createElement(ToastItem, { key: item.id, toast: item, position: queued.indexOf(item) + 1, total: queued.length })))))));
+}
+function ToastItem(props) {
+    const { toast: item, position, total } = props;
+    const status = toStatus(item.type);
+    const actions = item.data?.actions ?? [];
+    return (React.createElement(BaseToast.Root, { toast: item, className: toast() },
+        status ? (React.createElement(StatusGlyph, { ...overlayAttributes, status: status, label: statusLabels[status], className: cx(styles.glyph, secondaryScaleVariants[statusScales[status]]) })) : null,
+        React.createElement("div", { className: styles.message },
+            React.createElement(BaseToast.Title, { className: styles.title }),
+            React.createElement(BaseToast.Description, { className: styles.description })),
+        total > 1 && position > 0 ? (React.createElement("span", { className: styles.queue },
+            position,
+            " of ",
+            total)) : null,
+        actions.length > 0 ? (React.createElement("div", { className: styles.actions }, actions.map((action, index) => (React.createElement(ToastActionCell, { key: index, ...action }))))) : null,
+        React.createElement(BaseToast.Close, { className: styles.close, render: React.createElement(Button, { variant: "outline", iconOnly: true, icon: "close" }, "Close") })));
+}
+/** An action cell: holds its rest width while busy and ignores presses then [D84]. */
+function ToastActionCell(props) {
+    const { onClick, disabled, destructive, ...rest } = props;
+    const busy = rest['aria-busy'] === true || rest['aria-busy'] === 'true';
+    const element = React.useRef(null);
+    const restWidth = React.useRef(null);
+    React.useLayoutEffect(() => {
+        if (!busy && element.current) {
+            restWidth.current = element.current.getBoundingClientRect().width;
+        }
+    });
+    React.useLayoutEffect(() => {
+        const node = element.current;
+        if (!busy || !node || restWidth.current === null)
+            return undefined;
+        node.style.setProperty('--toast-action-rest-width', `${restWidth.current}px`);
+        return () => {
+            node.style.removeProperty('--toast-action-rest-width');
+        };
+    }, [busy]);
+    return (React.createElement(BaseButton, { ...rest, ref: element, disabled: disabled, className: cx(styles.action, destructive ? styles.actionDestructive : undefined), onClick: busy ? undefined : onClick }));
+}
+//# sourceMappingURL=Toast.js.map

package/feedback/toast/Toast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Toast.js","sourceRoot":"","sources":["../../src/feedback/toast/Toast.tsx"],"names":[],"mappings":"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"}

package/feedback/toast/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/feedback/toast/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAA"}

package/feedback/toast/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/feedback/toast/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAA"}