@cratis/components 3.6.1 → 4.1.0

package/dist/esm/Filter/useFilterState.js

@@ -1,26 +1,14 @@
 import { useState, useMemo, useRef, useEffect, useCallback } from 'react';
 import { buildFilterValues, buildRangeValues } from './utils.js';
 
-// Copyright (c) Cratis. All rights reserved.
-// Licensed under the MIT license. See LICENSE file in the project root for full license information.
-/**
- * State management hook for the standalone FilterPanel.
- *
- * Tracks selected options, numeric ranges, and custom values for every
- * filter in the provided `filters` array. Pass the returned values and
- * handlers directly to <FilterPanel>.
- */
 function useFilterState(filters) {
     const [filterValues, setFilterValues] = useState(() => buildFilterValues(filters));
     const [rangeValues, setRangeValues] = useState(() => buildRangeValues(filters));
     const [customValues, setCustomValues] = useState({});
     const [expandedFilterKey, setExpandedFilterKey] = useState(filters?.[0]?.key ?? null);
-    // Serialize filter keys to avoid infinite loops from reference changes
-    const filterKeys = useMemo(() => filters?.map(f => f.key).join(',') ?? '', [filters]);
+    const filterKeys = useMemo(() => filters?.map((f) => f.key).join(',') ?? '', [filters]);
     const prevFilterKeysRef = useRef(filterKeys);
-    // Sync state when the filter definitions change (only when keys actually change)
     useEffect(() => {
-        // Only update if the filter keys have actually changed
         if (filterKeys === prevFilterKeysRef.current)
             return;
         prevFilterKeysRef.current = filterKeys;

package/dist/esm/Filter/useFilterState.js.map

@@ -1 +1 @@
-{"version":3,"file":"useFilterState.js","sources":["../../../Filter/useFilterState.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}
+{"version":3,"file":"useFilterState.js","sources":["../../../Filter/useFilterState.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/Filter/utils.d.ts

@@ -1,8 +1,45 @@
-import type { FilterDefinition, FilterValues, HistogramBucket, RangeValues } from './types';
+import type { FilterDefinition, FilterValues, HistogramBucket, RangeValues } from './types.js';
+/** A histogram bucket with the tallest count in its set, so a bar can size itself. */
 export interface RenderedHistogramBucket extends HistogramBucket {
     maxCount: number;
 }
+/** The anchor edges the filter dropdown is positioned against, in viewport coordinates. */
+export interface DropdownAnchorRect {
+    top: number;
+    bottom: number;
+    left: number;
+}
+/** The visible viewport the filter dropdown must stay inside. */
+export interface DropdownViewport {
+    width: number;
+    height: number;
+}
+/** Fixed-position coordinates and bounds for the filter dropdown. */
+export interface DropdownPosition {
+    left: number;
+    top?: number;
+    bottom?: number;
+    maxHeight: number;
+}
+/**
+ * Place the filter dropdown against its anchor without letting it leave the viewport.
+ *
+ * The panel is `position: fixed`, so an anchor near the right edge would otherwise push it
+ * off-screen, and an anchor near the bottom would open a panel that cannot be reached. The
+ * horizontal placement is clamped into the available gutter. When the panel flips above its
+ * anchor it uses `bottom`, rather than guessing its rendered height, so short content remains
+ * attached to the trigger. The selected side also supplies an explicit maximum height.
+ */
+export declare function resolveDropdownPosition(anchor: DropdownAnchorRect, viewport: DropdownViewport): DropdownPosition;
+/** Initialise the string/option selection map for all string/date filters. */
 export declare function buildFilterValues(filters: FilterDefinition[] | undefined): FilterValues;
+/** Initialise the numeric range map for all number filters. */
 export declare function buildRangeValues(filters: FilterDefinition[] | undefined): RangeValues;
+/**
+ * Build the bars a range filter renders.
+ *
+ * Pre-counted buckets are rendered as given - they come from a source that saw more data than the
+ * browser holds, so recounting them against the loaded values would understate the real totals.
+ * Otherwise the raw values are counted into `bucketCount` evenly sized buckets across the range.
+ */
 export declare function buildHistogram(values: number[], min: number, max: number, bucketCount: number, provided?: HistogramBucket[]): RenderedHistogramBucket[];
-//# sourceMappingURL=utils.d.ts.map

package/dist/esm/Filter/utils.js

@@ -1,6 +1,36 @@
-// Copyright (c) Cratis. All rights reserved.
-// Licensed under the MIT license. See LICENSE file in the project root for full license information.
-/** Initialise the string/option selection map for all string/date filters. */
+const DROPDOWN_MAX_WIDTH = 320;
+const DROPDOWN_MAX_HEIGHT_INSET = 128;
+const DROPDOWN_GUTTER = 16;
+const DROPDOWN_ANCHOR_GAP = 8;
+const clamp = (value, minimum, maximum) => Math.min(Math.max(value, minimum), maximum);
+function resolveDropdownPosition(anchor, viewport) {
+    const viewportWidth = Math.max(0, viewport.width);
+    const viewportHeight = Math.max(0, viewport.height);
+    const horizontalGutter = Math.min(DROPDOWN_GUTTER, viewportWidth / 2);
+    const verticalGutter = Math.min(DROPDOWN_GUTTER, viewportHeight / 2);
+    const width = Math.max(0, Math.min(DROPDOWN_MAX_WIDTH, viewportWidth - horizontalGutter * 2));
+    const left = clamp(anchor.left, horizontalGutter, Math.max(horizontalGutter, viewportWidth - width - horizontalGutter));
+    const top = clamp(anchor.bottom + DROPDOWN_ANCHOR_GAP, verticalGutter, Math.max(verticalGutter, viewportHeight - verticalGutter));
+    const bottom = clamp(viewportHeight - anchor.top + DROPDOWN_ANCHOR_GAP, verticalGutter, Math.max(verticalGutter, viewportHeight - verticalGutter));
+    const roomBelow = Math.max(0, viewportHeight - verticalGutter - top);
+    const roomAbove = Math.max(0, viewportHeight - verticalGutter - bottom);
+    const configuredMaxHeight = Math.max(0, viewportHeight -
+        (viewportHeight > DROPDOWN_MAX_HEIGHT_INSET
+            ? DROPDOWN_MAX_HEIGHT_INSET
+            : verticalGutter * 2));
+    if (roomBelow >= roomAbove) {
+        return {
+            top,
+            left,
+            maxHeight: Math.min(roomBelow, configuredMaxHeight),
+        };
+    }
+    return {
+        bottom,
+        left,
+        maxHeight: Math.min(roomAbove, configuredMaxHeight),
+    };
+}
 function buildFilterValues(filters) {
     const state = {};
     filters?.forEach((filter) => {
@@ -10,7 +40,6 @@ function buildFilterValues(filters) {
     });
     return state;
 }
-/** Initialise the numeric range map for all number filters. */
 function buildRangeValues(filters) {
     const state = {};
     filters?.forEach((filter) => {
@@ -20,13 +49,6 @@ function buildRangeValues(filters) {
     });
     return state;
 }
-/**
- * Build the bars a range filter renders.
- *
- * Pre-counted buckets are rendered as given - they come from a source that saw more data than the
- * browser holds, so recounting them against the loaded values would understate the real totals.
- * Otherwise the raw values are counted into `bucketCount` evenly sized buckets across the range.
- */
 function buildHistogram(values, min, max, bucketCount, provided) {
     if (provided !== undefined) {
         if (provided.length === 0)
@@ -53,5 +75,5 @@ function buildHistogram(values, min, max, bucketCount, provided) {
     }));
 }
 
-export { buildFilterValues, buildHistogram, buildRangeValues };
+export { buildFilterValues, buildHistogram, buildRangeValues, resolveDropdownPosition };
 //# sourceMappingURL=utils.js.map

package/dist/esm/Filter/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sources":["../../../Filter/utils.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;AACA;AASA;AACM,SAAU,iBAAiB,CAAC,OAAuC,EAAA;IACrE,MAAM,KAAK,GAAiB,EAAE;AAC9B,IAAA,OAAO,EAAE,OAAO,CAAC,CAAC,MAAM,KAAI;AACxB,QAAA,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE;YACpE,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,EAAU;QACzC;AACJ,IAAA,CAAC,CAAC;AACF,IAAA,OAAO,KAAK;AAChB;AAEA;AACM,SAAU,gBAAgB,CAAC,OAAuC,EAAA;IACpE,MAAM,KAAK,GAAgB,EAAE;AAC7B,IAAA,OAAO,EAAE,OAAO,CAAC,CAAC,MAAM,KAAI;AACxB,QAAA,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE;AAC1B,YAAA,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI;QAC5B;AACJ,IAAA,CAAC,CAAC;AACF,IAAA,OAAO,KAAK;AAChB;AAEA;;;;;;AAMG;AACG,SAAU,cAAc,CAC1B,MAAgB,EAChB,GAAW,EACX,GAAW,EACX,WAAmB,EACnB,QAA4B,EAAA;AAE5B,IAAA,IAAI,QAAQ,KAAK,SAAS,EAAE;AACxB,QAAA,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;AAAE,YAAA,OAAO,EAAE;QACpC,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC1E,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,MAAM,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC;IAC3E;AAEA,IAAA,MAAM,KAAK,GAAG,GAAG,GAAG,GAAG;IACvB,IAAI,KAAK,IAAI,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;AAAE,QAAA,OAAO,EAAE;AAEhD,IAAA,MAAM,UAAU,GAAG,KAAK,GAAG,WAAW;IACtC,MAAM,MAAM,GAAa,KAAK,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAEnD,IAAA,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,KAAI;QACrB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,GAAG,IAAI,UAAU,CAAC,EAAE,WAAW,GAAG,CAAC,CAAC;AAC/E,QAAA,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,GAAG,WAAW;AAAE,YAAA,MAAM,CAAC,KAAK,CAAC,EAAE;AAC1D,IAAA,CAAC,CAAC;IAEF,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,EAAE,CAAC,CAAC;IAEvC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,MAAM;AACjC,QAAA,KAAK,EAAE,GAAG,GAAG,KAAK,GAAG,UAAU;QAC/B,GAAG,EAAE,GAAG,GAAG,CAAC,KAAK,GAAG,CAAC,IAAI,UAAU;QACnC,KAAK;QACL,QAAQ;AACX,KAAA,CAAC,CAAC;AACP;;"}
+{"version":3,"file":"utils.js","sources":["../../../Filter/utils.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/Notifications/Toaster.d.ts

@@ -1,16 +1,40 @@
-import type { ToastRootProps } from '@primereact/types/primitive/toast';
-import type { ToasterRegionProps } from '@primereact/types/primitive/toaster';
-import type { ToasterPosition } from '@primereact/types/headless/toaster';
+import { type ButtonHTMLAttributes, type HTMLAttributes } from 'react';
+/** Supported viewport positions for the global toast region. */
+export type ToasterPosition = 'top-left' | 'top-center' | 'top-right' | 'bottom-left' | 'bottom-center' | 'bottom-right';
+/** Stable part attributes for {@link Toaster}. */
 export interface ToasterPassThrough {
-    region?: ToasterRegionProps['pt'];
-    toast?: ToastRootProps['pt'];
+    /** Accessible toast region. */
+    region?: HTMLAttributes<HTMLDivElement>;
+    /** One toast article. */
+    toast?: HTMLAttributes<HTMLElement>;
+    /** Severity/custom icon wrapper. */
+    icon?: HTMLAttributes<HTMLSpanElement>;
+    /** Toast content wrapper. */
+    content?: HTMLAttributes<HTMLDivElement>;
+    /** Toast title. */
+    title?: HTMLAttributes<HTMLDivElement>;
+    /** Toast description. */
+    description?: HTMLAttributes<HTMLDivElement>;
+    /** Dismiss button. */
+    close?: ButtonHTMLAttributes<HTMLButtonElement>;
+    /** Optional toast action button. */
+    action?: ButtonHTMLAttributes<HTMLButtonElement>;
 }
+/** Props for the global accessible toast region. */
 export interface ToasterProps {
+    /** Viewport position. */
     position?: ToasterPosition;
+    /** Maximum visible toast count. */
     limit?: number;
+    /** Default timeout in milliseconds. */
     timeout?: number;
+    /** Accessible label for dismiss buttons. Falls back to the provider's `notifications.dismiss` message, then `'Dismiss'`. */
     dismissAriaLabel?: string;
+    /** Accessible name for the toast region. Falls back to the provider's `notifications.region` message, then `'Notifications'`. */
+    regionAriaLabel?: string;
+    /** Stable part attributes. */
     pt?: ToasterPassThrough;
 }
-export declare const Toaster: ({ position, limit, timeout, dismissAriaLabel, pt, }: ToasterProps) => import("react").JSX.Element;
+/** App-wide accessible toast region backed by the Cratis-owned toast queue. */
+export declare const Toaster: ({ position, limit, timeout, dismissAriaLabel, regionAriaLabel, pt, }: ToasterProps) => import("react").ReactPortal | null;
 //# sourceMappingURL=Toaster.d.ts.map

package/dist/esm/Notifications/Toaster.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Toaster.d.ts","sourceRoot":"","sources":["../../../Notifications/Toaster.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,KAAK,EACR,kBAAkB,EAErB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAuF1E,MAAM,WAAW,kBAAkB;IAE/B,MAAM,CAAC,EAAE,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAElC,KAAK,CAAC,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC;CAChC;AAGD,MAAM,WAAW,YAAY;IAEzB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAE3B,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,EAAE,CAAC,EAAE,kBAAkB,CAAC;CAC3B;AA0BD,eAAO,MAAM,OAAO,GAAI,qDAMrB,YAAY,gCAQd,CAAC"}
+{"version":3,"file":"Toaster.d.ts","sourceRoot":"","sources":["../../../Notifications/Toaster.tsx"],"names":[],"mappings":"AAGA,OAAO,EAIH,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACtB,MAAM,OAAO,CAAC;AAaf,gEAAgE;AAChE,MAAM,MAAM,eAAe,GACrB,UAAU,GACV,YAAY,GACZ,WAAW,GACX,aAAa,GACb,eAAe,GACf,cAAc,CAAC;AAErB,kDAAkD;AAClD,MAAM,WAAW,kBAAkB;IAC/B,+BAA+B;IAC/B,MAAM,CAAC,EAAE,cAAc,CAAC,cAAc,CAAC,CAAC;IACxC,yBAAyB;IACzB,KAAK,CAAC,EAAE,cAAc,CAAC,WAAW,CAAC,CAAC;IACpC,oCAAoC;IACpC,IAAI,CAAC,EAAE,cAAc,CAAC,eAAe,CAAC,CAAC;IACvC,6BAA6B;IAC7B,OAAO,CAAC,EAAE,cAAc,CAAC,cAAc,CAAC,CAAC;IACzC,mBAAmB;IACnB,KAAK,CAAC,EAAE,cAAc,CAAC,cAAc,CAAC,CAAC;IACvC,yBAAyB;IACzB,WAAW,CAAC,EAAE,cAAc,CAAC,cAAc,CAAC,CAAC;IAC7C,sBAAsB;IACtB,KAAK,CAAC,EAAE,oBAAoB,CAAC,iBAAiB,CAAC,CAAC;IAChD,oCAAoC;IACpC,MAAM,CAAC,EAAE,oBAAoB,CAAC,iBAAiB,CAAC,CAAC;CACpD;AAQD,oDAAoD;AACpD,MAAM,WAAW,YAAY;IACzB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4HAA4H;IAC5H,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iIAAiI;IACjI,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,8BAA8B;IAC9B,EAAE,CAAC,EAAE,kBAAkB,CAAC;CAC3B;AAgID,+EAA+E;AAC/E,eAAO,MAAM,OAAO,GAAI,sEAOrB,YAAY,uCAoCd,CAAC"}

package/dist/esm/Notifications/Toaster.js

@@ -1,49 +1,49 @@
-import { jsx, Fragment, jsxs } from 'react/jsx-runtime';
-import { useMemo } from 'react';
-import { Toaster as Toaster$1, useToasterContext } from 'primereact/toaster';
-import { Toast } from 'primereact/toast';
+import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
+import { useSyncExternalStore, useState, useEffect } from 'react';
+import { createPortal } from 'react-dom';
+import { useCratisComponentsConfig } from '../Common/CratisComponentsContext.js';
+import { subscribeToToasts, getToastSnapshot, toast } from './toast.js';
 
-const FramedToast = ({ item, dismissAriaLabel, pt }) => {
-    const customBody = item.render;
-    const framedToast = useMemo(() => ({
-        ...item,
-        render: undefined,
-        onDismiss: item.onDismiss ? () => item.onDismiss?.(item) : undefined,
-        onTimeout: item.onTimeout ? () => item.onTimeout?.(item) : undefined,
-    }), [item]);
-    return (jsxs(Toast.Root, { toast: framedToast, "data-severity": item.severity, className: 'cratis-toast', pt: pt, children: [jsx(Toast.Icon, { match: 'success', children: jsx("i", { className: 'pi pi-check-circle' }) }), jsx(Toast.Icon, { match: 'info', children: jsx("i", { className: 'pi pi-info-circle' }) }), jsx(Toast.Icon, { match: 'warn', children: jsx("i", { className: 'pi pi-exclamation-triangle' }) }), jsx(Toast.Icon, { match: 'error', children: jsx("i", { className: 'pi pi-times-circle' }) }), jsx(Toast.Icon, { children: jsx("i", { className: 'pi pi-bell' }) }), jsx(Toast.Content, { children: customBody ?? (jsxs(Fragment, { children: [jsx(Toast.Title, {}), jsx(Toast.Description, {})] })) }), jsx(Toast.Close, { "aria-label": dismissAriaLabel, children: jsx("i", { className: 'pi pi-times' }) })] }));
+const severitySymbol = {
+    normal: '●',
+    success: '✓',
+    info: 'ⓘ',
+    warn: '⚠',
+    error: '⨯',
+    secondary: '●',
+    contrast: '●',
 };
-const ToastList = ({ dismissAriaLabel, pt }) => {
-    const toaster = useToasterContext();
-    if (!toaster)
+const emptyToasts = [];
+const classNames = (...values) => values.filter(Boolean).join(' ');
+const ToastFrame = ({ item, timeout, dismissAriaLabel, pt }) => {
+    const [paused, setPaused] = useState(false);
+    useEffect(() => {
+        if (paused || item.loading || item.duration === 0)
+            return;
+        const duration = item.duration ?? timeout;
+        const timer = window.setTimeout(() => {
+            item.onTimeout?.(item);
+            toast.dismiss(item.id);
+        }, Math.max(duration, 5000));
+        return () => window.clearTimeout(timer);
+    }, [item, paused, timeout]);
+    const severity = item.severity ?? 'normal';
+    const content = item.render ?? (jsxs(Fragment, { children: [item.title && (jsx("div", { ...pt?.title, className: classNames('cratis-toast__title', pt?.title?.className), "data-cratis-part": 'title', children: item.title })), item.description && (jsx("div", { ...pt?.description, className: classNames('cratis-toast__description', pt?.description?.className), "data-cratis-part": 'description', children: item.description })), item.action && (jsx("button", { ...item.action, ...pt?.action, type: 'button', className: classNames('cratis-toast__action', item.action.className, pt?.action?.className), "data-cratis-part": 'action' }))] }));
+    return (jsxs("article", { ...pt?.toast, className: classNames('cratis-toast', pt?.toast?.className), "data-cratis-part": 'toast', "data-severity": severity, "data-loading": item.loading || undefined, "data-busy": item.loading || undefined, role: severity === 'error' ? 'alert' : 'status', onMouseEnter: () => setPaused(true), onMouseLeave: () => setPaused(false), onFocusCapture: () => setPaused(true), onBlurCapture: (event) => {
+            if (!event.currentTarget.contains(event.relatedTarget))
+                setPaused(false);
+        }, children: [jsx("span", { ...pt?.icon, className: classNames('cratis-toast__icon', pt?.icon?.className), "data-cratis-part": 'icon', "aria-hidden": 'true', children: item.loading ? '◌' : (item.icon ?? severitySymbol[severity]) }), jsx("div", { ...pt?.content, className: classNames('cratis-toast__content', pt?.content?.className), "data-cratis-part": 'content', "data-loading": item.loading || undefined, "data-busy": item.loading || undefined, children: content }), item.dismissible !== false && (jsx("button", { ...pt?.close, type: 'button', className: classNames('cratis-toast__close', pt?.close?.className), "data-cratis-part": 'close', "aria-label": pt?.close?.['aria-label'] ?? dismissAriaLabel, onClick: () => toast.dismiss(item.id), children: jsx("span", { "aria-hidden": 'true', children: "\u00D7" }) }))] }));
+};
+const Toaster = ({ position = 'top-right', limit = 3, timeout = 6000, dismissAriaLabel, regionAriaLabel, pt, }) => {
+    const { messages } = useCratisComponentsConfig();
+    const notificationsMessages = messages?.notifications;
+    const resolvedDismissAriaLabel = dismissAriaLabel ?? notificationsMessages?.dismiss ?? 'Dismiss';
+    const resolvedRegionAriaLabel = regionAriaLabel ?? notificationsMessages?.region ?? 'Notifications';
+    const items = useSyncExternalStore(subscribeToToasts, getToastSnapshot, () => emptyToasts);
+    if (typeof document === 'undefined')
         return null;
-    return (jsx(Fragment, { children: toaster.toasts.map((item) => (jsx(FramedToast, { item: item, dismissAriaLabel: dismissAriaLabel, pt: pt }, item.id))) }));
+    return createPortal(jsx("div", { ...pt?.region, className: classNames('cratis-toaster', pt?.region?.className), "data-cratis-part": 'region', "data-position": position, role: 'region', "aria-label": resolvedRegionAriaLabel, "aria-live": 'polite', children: items.slice(-limit).map((item) => (jsx(ToastFrame, { item: item, timeout: timeout, dismissAriaLabel: resolvedDismissAriaLabel, pt: pt }, item.id))) }), document.body);
 };
-/**
- * The single, app-wide toast host. Mount one `<Toaster />` near your app root;
- * then call the imperative {@link toast} (`toast.success(...)`, `toast.error(...)`,
- * …) from anywhere — including outside React — and the notification appears
- * here and auto-dismisses.
- *
- * Built on PrimeReact 11's headless Toaster/Toast: a module-level store backs
- * the imperative API, and this region subscribes to it. Icons are chosen per
- * severity, close/dismiss and the auto-dismiss timer are wired by the
- * primitives, and severity is surfaced as `data-severity` on each toast for
- * styling. A toast's custom `render` element replaces only the content body;
- * the severity icon and dismiss control remain in the Components-owned frame.
- *
- * ```tsx
- * // once, near the app root:
- * <Toaster position="top-right" />
- *
- * // anywhere:
- * import { toast } from '@cratis/components/Notifications';
- * toast.success({ title: 'Saved', description: 'Your changes were saved.' });
- * ```
- *
- * To surface an Arc command result automatically, see {@link toastCommandResult}.
- */
-const Toaster = ({ position = 'top-right', limit = 3, timeout = 6000, dismissAriaLabel = 'Dismiss', pt, }) => (jsx(Toaster$1.Root, { position: position, limit: limit, timeout: timeout, children: jsx(Toaster$1.Portal, { children: jsx(Toaster$1.Region, { pt: pt?.region, children: jsx(ToastList, { dismissAriaLabel: dismissAriaLabel, pt: pt?.toast }) }) }) }));
 
 export { Toaster };
 //# sourceMappingURL=Toaster.js.map

package/dist/esm/Notifications/Toaster.js.map

@@ -1 +1 @@
-{"version":3,"file":"Toaster.js","sources":["../../../Notifications/Toaster.tsx"],"sourcesContent":[null],"names":["_jsxs","_jsx","_Fragment","PrimeToaster"],"mappings":"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"}
+{"version":3,"file":"Toaster.js","sources":["../../../Notifications/Toaster.tsx"],"sourcesContent":[null],"names":["_jsxs","_Fragment","_jsx"],"mappings":"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"}

package/dist/esm/Notifications/index.d.ts

@@ -1,4 +1,3 @@
-export * from './Toaster';
-export * from './toast';
-export * from './toastCommandResult';
-//# sourceMappingURL=index.d.ts.map
+export * from './Toaster.js';
+export * from './toast.js';
+export * from './toastCommandResult.js';

package/dist/esm/Notifications/index.js

@@ -1,7 +1,4 @@
 export { Toaster } from './Toaster.js';
-export { setToastDispatch, toast } from './toast.js';
+export { getToastSnapshot, setToastDispatch, subscribeToToasts, toast } from './toast.js';
 export { toastCommandResult } from './toastCommandResult.js';
-
-// Copyright (c) Cratis. All rights reserved.
-// Licensed under the MIT license. See LICENSE file in the project root for full license information.
 //# sourceMappingURL=index.js.map

package/dist/esm/Notifications/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../Notifications/index.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAAA;AACA"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/esm/Notifications/toast.d.ts

@@ -1,53 +1,155 @@
 import type { ButtonHTMLAttributes, ReactElement, ReactNode } from 'react';
+/**
+ * Visual severity level for a toast notification.
+ * Determines the default styling and icon treatment when rendered by the Toaster component.
+ */
 export type ToastSeverity = 'normal' | 'success' | 'info' | 'warn' | 'error' | 'secondary' | 'contrast';
+/**
+ * Unique identifier for a toast notification.
+ * Can be explicitly provided via {@link ToastOptions.id} or auto-generated.
+ */
 export type ToastId = string | number;
+/**
+ * Configuration options accepted by every toast notification call.
+ * Merged with severity-specific defaults when using helpers like {@link toast.success}.
+ */
 export interface ToastOptions {
+    /** Unique identifier for this toast. Auto-generated if omitted. */
     id?: ToastId;
+    /** Primary heading text or element. Rendered prominently in the toast UI. */
     title?: ReactNode | string;
+    /** Secondary body text or element. Rendered below the title. */
     description?: ReactNode | string;
+    /** Action button props. Rendered as a clickable button in the toast. */
     action?: ButtonHTMLAttributes<HTMLButtonElement>;
+    /** Whether the user can manually dismiss the toast. Defaults to true. */
     dismissible?: boolean;
+    /** Visual severity level. Determines styling and default icon. */
     severity?: ToastSeverity;
+    /** Whether to show a loading spinner. Typically used with {@link toast.promise}. */
     loading?: boolean;
+    /** Custom icon element. Overrides the default severity-based icon. */
     icon?: ReactNode;
+    /** Custom renderer. Fully replaces the default toast UI when provided. */
     render?: ReactElement;
+    /** Auto-dismiss timeout in milliseconds. No auto-dismiss if omitted or zero. */
     duration?: number;
+    /** Grouping key. Used to logically associate related toasts. */
     group?: string;
+    /** The promise being tracked (internal, set automatically by {@link toast.promise}). */
     promise?: unknown;
+    /** Arbitrary metadata. Available to custom renderers and lifecycle callbacks. */
     data?: Record<string, unknown>;
+    /** Callback invoked when the toast is dismissed (manually or programmatically). */
     onDismiss?: (toast: ToastOptions) => void;
+    /** Callback invoked when the toast auto-dismisses via duration timeout. */
     onTimeout?: (toast: ToastOptions) => void;
 }
+/**
+ * Legacy alias for {@link ToastOptions}.
+ * Preserved for source compatibility with earlier versions.
+ */
 export type ToastType = ToastOptions;
+/**
+ * Options for {@link toast.promise}, which shows a loading toast and updates it based on promise outcome.
+ * @typeParam T - The promise resolution type.
+ */
 export interface ToastPromiseOptions<T = unknown> {
+    /** Toast shown immediately while the promise is pending. Automatically receives `loading: true`. */
     loading: ToastOptions;
+    /** Toast shown on success. Can be a static config or a function receiving the resolved value. Returns void to dismiss instead of updating. */
     success?: ToastOptions | ((data: T) => ToastOptions | void);
+    /** Toast shown on rejection. Can be a static config or a function receiving the error. Returns void to dismiss instead of updating. */
     error?: ToastOptions | ((error: unknown) => ToastOptions | void);
 }
+/**
+ * Dispatch interface for toast operations.
+ * Custom implementations can be installed via {@link setToastDispatch} to intercept all toast calls—
+ * useful for testing, logging, or routing toasts to a different rendering surface.
+ * The default implementation writes to an in-memory queue consumed by the mounted Toaster component.
+ */
 export interface ToastDispatch {
+    /** Shows a toast with the provided options. Returns the toast ID. */
     show(options: ToastOptions): ToastId;
+    /** Updates an existing toast by ID. Returns the toast ID. */
     update(id: ToastId, updates: Partial<ToastOptions>): ToastId;
+    /** Dismisses one toast by ID, or all toasts if ID is omitted. */
     dismiss(id?: ToastId): void;
+    /** Tracks a promise with loading/success/error toasts. Returns the original promise (passthrough). */
     promise<T>(promise: Promise<T>, options: ToastPromiseOptions<T>): Promise<T>;
+    /** Shows a success-severity toast. Shorthand for `show({ ...options, severity: 'success' })`. */
     success(options: ToastOptions): ToastId;
+    /** Shows an info-severity toast. Shorthand for `show({ ...options, severity: 'info' })`. */
     info(options: ToastOptions): ToastId;
+    /** Shows a warn-severity toast. Shorthand for `show({ ...options, severity: 'warn' })`. */
     warn(options: ToastOptions): ToastId;
+    /** Shows an error-severity toast. Shorthand for `show({ ...options, severity: 'error' })`. */
     error(options: ToastOptions): ToastId;
+    /** Shows a secondary-severity toast. Shorthand for `show({ ...options, severity: 'secondary' })`. */
     secondary(options: ToastOptions): ToastId;
+    /** Shows a contrast-severity toast. Shorthand for `show({ ...options, severity: 'contrast' })`. */
     contrast(options: ToastOptions): ToastId;
 }
+/**
+ * The callable signature and helper methods of the {@link toast} export.
+ * All methods delegate to the currently active {@link ToastDispatch} (default queue-backed or custom override).
+ */
 export interface ToastFunction {
+    /** Call signature: shows a toast with the provided options. Equivalent to `toast.show(options)`. */
     (options: ToastOptions): ToastId;
+    /** Updates an existing toast by ID. Returns the toast ID. */
     update(id: ToastId, updates: Partial<ToastOptions>): ToastId;
+    /** Dismisses one toast by ID, or all toasts if ID is omitted. */
     dismiss(id?: ToastId): void;
+    /** Tracks a promise with loading/success/error toasts. Returns the original promise (passthrough). */
     promise<T>(promise: Promise<T>, options: ToastPromiseOptions<T>): Promise<T>;
+    /** Shows a success-severity toast. Shorthand for `show({ ...options, severity: 'success' })`. */
     success(options: ToastOptions): ToastId;
+    /** Shows an info-severity toast. Shorthand for `show({ ...options, severity: 'info' })`. */
     info(options: ToastOptions): ToastId;
+    /** Shows a warn-severity toast. Shorthand for `show({ ...options, severity: 'warn' })`. */
     warn(options: ToastOptions): ToastId;
+    /** Shows an error-severity toast. Shorthand for `show({ ...options, severity: 'error' })`. */
     error(options: ToastOptions): ToastId;
+    /** Shows a secondary-severity toast. Shorthand for `show({ ...options, severity: 'secondary' })`. */
     secondary(options: ToastOptions): ToastId;
+    /** Shows a contrast-severity toast. Shorthand for `show({ ...options, severity: 'contrast' })`. */
     contrast(options: ToastOptions): ToastId;
 }
+/**
+ * The complete shape of a toast notification stored in the global queue.
+ * Extends {@link ToastOptions} with a guaranteed `id` property.
+ * Custom rendering surfaces can access the queue via {@link subscribeToToasts} and {@link getToastSnapshot}
+ * without importing the default Toaster component.
+ */
+export interface ToastRecord extends ToastOptions {
+    /** Unique identifier for this toast. Always present on stored records (auto-generated if not provided). */
+    id: ToastId;
+}
+/** Subscribes a mounted toaster to the app-wide queue. */
+export declare const subscribeToToasts: (listener: () => void) => (() => void);
+/** Returns the current immutable queue snapshot. */
+export declare const getToastSnapshot: () => ToastRecord[];
+/**
+ * Installs a custom {@link ToastDispatch} implementation that shadows the default queue-backed dispatch.
+ * All subsequent `toast(...)` calls route through the provided dispatch until the returned cleanup function is invoked.
+ * Dispatch frames are stack-based: nested calls compose, and removing a frame restores the previous one.
+ * Useful for testing (intercept/assert toast calls), logging, or routing toasts to an alternative UI.
+ *
+ * @param dispatch - The custom dispatch implementation to install.
+ * @returns A cleanup function that removes this dispatch frame and restores the previous active dispatch.
+ *
+ * @example
+ * ```ts
+ * const cleanup = setToastDispatch({
+ *   show: (opts) => { console.log('toast:', opts); return 'test-id'; },
+ *   // ... other ToastDispatch methods
+ * });
+ * toast({ title: 'Hello' }); // logs instead of queuing
+ * cleanup(); // restores default behavior
+ * ```
+ */
 export declare const setToastDispatch: (dispatch: ToastDispatch) => (() => void);
+/** Cratis-owned imperative toast API. Mount one {@link Toaster} in the application root. */
 export declare const toast: ToastFunction;
 //# sourceMappingURL=toast.d.ts.map

package/dist/esm/Notifications/toast.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toast.d.ts","sourceRoot":"","sources":["../../../Notifications/toast.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"toast.d.ts","sourceRoot":"","sources":["../../../Notifications/toast.ts"],"names":[],"mappings":"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"}