pixelize-design-library 2.4.2-beta.9 → 3.0.0

package/dist/Components/NoteTextArea/NoteTextArea.js

@@ -1,35 +1,37 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = NoteTextArea;
 const jsx_runtime_1 = require("react/jsx-runtime");
 const react_1 = require("react");
 const react_2 = require("@chakra-ui/react");
 const lucide_react_1 = require("lucide-react");
 const useCustomTheme_1 = require("../../Theme/useCustomTheme");
 const placeholderInk_1 = require("../../Theme/tokens/builders/placeholderInk");
+const accentText_1 = require("../../Theme/tokens/builders/accentText");
+const outlineRung_1 = require("../../Theme/tokens/builders/outlineRung");
+const planeStep_1 = require("../../Theme/tokens/builders/planeStep");
 const fieldStyles_1 = require("../Common/fieldStyles");
+const activationKey_1 = require("../Common/activationKey");
+const motion_1 = require("../../Theme/tokens/primitives/motion");
+const focusRing_styles_1 = require("../../Theme/chakra/focusRing.styles");
 const countWords = (text = "") => {
     const t = text.trim();
     if (!t)
         return 0;
     return t.split(/\s+/).length;
 };
-function NoteTextArea({ width = "100%", handleSubmit, handleCancel, value, title, file, isEditable = false, saveButtonLoading, maxFileSize = 1 * 1024 * 1024, maxFilesSizeError = "Some files are too large. Maximum allowed size is", maxNoteWordCount = 15, onChange, ref: inputRef, customPlaceholder = "Add a note...", cancelButtonHide = false, }) {
+/** Self-contained note composer (optional title + textarea + Save); `ref` forwards to the primary textarea. */
+const NoteTextArea = (0, react_1.forwardRef)(function NoteTextArea({ width = "100%", handleSubmit, handleCancel, value, title, file, isEditable = false, saveButtonLoading, maxFileSize = 1 * 1024 * 1024, maxFilesSizeError = "Some files are too large. Maximum allowed size is", maxNoteWordCount = 15, onChange, customPlaceholder = "Add a note...", cancelButtonHide = false, titleAriaLabel = "Note title", noteAriaLabel = customPlaceholder, }, ref) {
     const theme = (0, useCustomTheme_1.useCustomTheme)();
     const noteAreaRef = (0, react_1.useRef)(null);
+    const fileInputRef = (0, react_1.useRef)(null);
+    const mergedNoteRef = (0, react_2.useMergeRefs)(noteAreaRef, ref);
+    const fileInputId = `note-text-area-file-${(0, react_1.useId)().replace(/:/g, "")}`;
     const [isActive, setIsActive] = (0, react_1.useState)(false);
     const [noteValue, setNoteValue] = (0, react_1.useState)("");
     const [titleValue, setTitleValue] = (0, react_1.useState)("");
     const [titleShow, setTitleShow] = (0, react_1.useState)(false);
     const [files, setFiles] = (0, react_1.useState)([]);
     const [fileError, setFileError] = (0, react_1.useState)("");
-    const [isSaveDisabled, setIsSaveDisabled] = (0, react_1.useState)(false);
-    (0, react_1.useEffect)(() => {
-        setIsSaveDisabled(countWords(titleValue) > maxNoteWordCount);
-    }, [titleValue, maxNoteWordCount]);
-    (0, react_1.useEffect)(() => {
-        setIsSaveDisabled(countWords(noteValue) > maxNoteWordCount);
-    }, [noteValue, maxNoteWordCount]);
     (0, react_1.useEffect)(() => {
         if (isEditable) {
             setIsActive(true);
@@ -79,6 +81,7 @@ function NoteTextArea({ width = "100%", handleSubmit, handleCancel, value, title
             setFiles([]);
         }
     };
+    const openFilePicker = () => { var _a; return (_a = fileInputRef.current) === null || _a === void 0 ? void 0 : _a.click(); };
     const handleCloseTextArea = () => {
         setIsActive(false);
         handleCancel === null || handleCancel === void 0 ? void 0 : handleCancel(!isActive);
@@ -118,17 +121,27 @@ function NoteTextArea({ width = "100%", handleSubmit, handleCancel, value, title
     };
     const noteWordCount = countWords(noteValue);
     const isOverLimit = noteWordCount > maxNoteWordCount;
-    return ((0, jsx_runtime_1.jsxs)(react_2.Box, { w: width, borderRadius: fieldStyles_1.FIELD_RADIUS, overflow: "hidden", border: "1px solid", borderColor: isActive ? theme.colors.primary[500] : theme.colors.boxborder[500], bg: isActive ? theme.colors.gray[50] : theme.colors.background[50], transition: "border-color 0.2s", children: [!isActive && ((0, jsx_runtime_1.jsxs)(react_2.Flex, { px: 3, gap: 2, align: "center", cursor: "text", onClick: handleTextArea, bg: theme.colors.background[50], borderRadius: fieldStyles_1.FIELD_RADIUS, minH: "2.5rem", transition: "background 0.15s", _hover: { bg: theme.colors.gray[50] }, children: [(0, jsx_runtime_1.jsx)(lucide_react_1.SquarePen, { size: 16, color: theme.colors.textMuted }), (0, jsx_runtime_1.jsx)(react_2.Text, { color: theme.colors.textMuted, fontSize: "sm", children: customPlaceholder })] })), isActive && ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsxs)(react_2.Box, { bg: theme.colors.background[50], children: [titleShow && ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)(react_2.Input, { ref: inputRef, value: titleValue, onChange: (e) => {
+    const isSaveDisabled = isOverLimit || countWords(titleValue) > maxNoteWordCount;
+    const activeBandBg = (0, planeStep_1.bandOn)(theme.colors.gray[50], theme.colors.background[50]);
+    const collapsedHoverBg = (0, outlineRung_1.resolveHoverTint)(theme.colors.gray[50], theme.colors.background[50]);
+    const activeControlHoverBg = (0, outlineRung_1.resolveHoverTint)(theme.colors.gray[100], activeBandBg);
+    const chipBg = (0, planeStep_1.bandOn)(theme.colors.gray[100], activeBandBg);
+    const chipInk = (0, outlineRung_1.liftToContrast)(theme.colors.textMuted, chipBg, accentText_1.AA_NORMAL_TEXT);
+    const chipRemoveHoverBg = (0, planeStep_1.bandOn)(theme.colors.gray[200], chipBg);
+    // NOTE: drawn inset because the rounded shell clips overflow.
+    const placeholderFocusRing = {
+        outline: "2px solid transparent",
+        boxShadow: (0, focusRing_styles_1.insetFocusRingShadow)(theme.colors),
+    };
+    return ((0, jsx_runtime_1.jsxs)(react_2.Box, { w: width, borderRadius: fieldStyles_1.FIELD_RADIUS, overflow: "hidden", border: "1px solid", borderColor: isActive ? theme.colors.primary[500] : theme.colors.boxborder[500], bg: isActive ? activeBandBg : theme.colors.background[50], transition: (0, motion_1.transitionFor)(["border-color"]), children: [!isActive && ((0, jsx_runtime_1.jsxs)(react_2.Flex, { px: 3, gap: 2, align: "center", cursor: "text", role: "button", tabIndex: 0, onClick: handleTextArea, onKeyDown: (0, activationKey_1.onActivationKey)(handleTextArea), _focusVisible: placeholderFocusRing, bg: theme.colors.background[50], borderRadius: fieldStyles_1.FIELD_RADIUS, minH: "2.5rem", transition: (0, motion_1.transitionFor)(["background-color"]), _hover: { bg: collapsedHoverBg }, children: [(0, jsx_runtime_1.jsx)(lucide_react_1.SquarePen, { size: 16, color: theme.colors.textMuted }), (0, jsx_runtime_1.jsx)(react_2.Text, { color: theme.colors.textMuted, fontSize: "sm", children: customPlaceholder })] })), isActive && ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsxs)(react_2.Box, { bg: theme.colors.background[50], children: [titleShow && ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)(react_2.Input, { value: titleValue, onChange: (e) => {
                                             if (e.target.value.length === 0)
                                                 setTitleShow(false);
                                             setTitleValue(e.target.value);
-                                        }, placeholder: "Add a title...", variant: "unstyled", px: 3, pt: 2.5, pb: 1.5, fontWeight: 600, fontSize: "0.875rem", color: theme.colors.text[700], _placeholder: {
-                                            fontStyle: "italic",
+                                        }, placeholder: "Add a title...", "aria-label": titleAriaLabel, variant: "unstyled", px: 3, pt: 2.5, pb: 1.5, fontWeight: 600, fontSize: "sm", color: theme.colors.text[700], _placeholder: {
                                             color: (0, placeholderInk_1.placeholderInk)(theme.colors),
-                                        } }), (0, jsx_runtime_1.jsx)(react_2.Divider, { borderColor: theme.colors.gray[200] })] })), (0, jsx_runtime_1.jsx)(react_2.Box, { bg: theme.colors.background[50], minH: "76px", px: 3, pt: 2.5, position: "relative", children: (0, jsx_runtime_1.jsx)(react_2.Textarea, { ref: noteAreaRef, value: noteValue, onChange: handleNoteChange, placeholder: customPlaceholder, variant: "unstyled", resize: "none", minH: "76px", fontSize: "0.75rem", color: theme.colors.text[700], _placeholder: {
-                                        fontStyle: "italic",
+                                        } }), (0, jsx_runtime_1.jsx)(react_2.Divider, { borderColor: theme.colors.gray[200] })] })), (0, jsx_runtime_1.jsx)(react_2.Box, { bg: theme.colors.background[50], minH: "76px", px: 3, pt: 2.5, position: "relative", children: (0, jsx_runtime_1.jsx)(react_2.Textarea, { ref: mergedNoteRef, value: noteValue, onChange: handleNoteChange, placeholder: customPlaceholder, "aria-label": noteAriaLabel, variant: "unstyled", resize: "none", minH: "76px", fontSize: "xs", color: theme.colors.text[700], _placeholder: {
                                         color: (0, placeholderInk_1.placeholderInk)(theme.colors),
-                                    }, style: { overflow: "hidden" }, p: 0 }) })] }), (0, jsx_runtime_1.jsx)(react_2.Divider, { borderColor: theme.colors.gray[200] }), (0, jsx_runtime_1.jsxs)(react_2.Box, { px: 3, py: 2.5, children: [(0, jsx_runtime_1.jsxs)(react_2.Flex, { align: "center", justify: "space-between", w: "100%", gap: 3, children: [(0, jsx_runtime_1.jsxs)(react_2.Flex, { align: "center", gap: 2, minW: 0, children: [(0, jsx_runtime_1.jsx)(react_2.Tooltip, { label: "Attach files", hasArrow: true, placement: "top", children: (0, jsx_runtime_1.jsx)(react_2.Box, { as: "label", htmlFor: "file-upload", cursor: "pointer", display: "flex", alignItems: "center", justifyContent: "center", w: "1.75rem", h: "1.75rem", borderRadius: "md", color: theme.colors.textMuted, transition: "background 0.15s", _hover: { bg: theme.colors.gray[100] }, children: (0, jsx_runtime_1.jsx)(lucide_react_1.Paperclip, { size: 16 }) }) }), (0, jsx_runtime_1.jsx)(react_2.Box, { h: "1rem", w: "1px", bg: theme.colors.gray[200] }), !titleShow ? ((0, jsx_runtime_1.jsx)(react_2.Box, { as: "button", type: "button", onClick: () => setTitleShow(true), px: 2, py: 1, borderRadius: "md", color: theme.colors.textMuted, fontWeight: 500, fontSize: "sm", transition: "background 0.15s", _hover: { bg: theme.colors.gray[100] }, children: "+ Add a title" })) : ((0, jsx_runtime_1.jsx)(react_2.Tooltip, { label: titleValue, hasArrow: true, isDisabled: !titleValue, children: (0, jsx_runtime_1.jsx)(react_2.Text, { color: theme.colors.textMuted, fontSize: "sm", fontWeight: 500, isTruncated: true, maxW: "180px", children: titleValue || "Title" }) }))] }), (0, jsx_runtime_1.jsxs)(react_2.Flex, { gap: 2.5, align: "center", ml: "auto", flexShrink: 0, children: [(0, jsx_runtime_1.jsxs)(react_2.Text, { fontSize: "xs", fontWeight: 500, color: isOverLimit ? theme.colors.semanticText.error : theme.colors.textMuted, whiteSpace: "nowrap", children: [noteWordCount, "/", maxNoteWordCount] }), cancelButtonHide ? null : ((0, jsx_runtime_1.jsx)(react_2.Button, { size: "sm", variant: "ghost", colorScheme: "gray", onClick: handleCloseTextArea, children: "Cancel" })), (0, jsx_runtime_1.jsxs)(react_2.Button, { size: "sm", variant: "solid", isLoading: !!saveButtonLoading, isDisabled: !noteValue || isSaveDisabled, onClick: () => handleSubmit(noteValue, titleValue, files), children: [saveButtonLoading ? ((0, jsx_runtime_1.jsx)(react_2.Spinner, { size: "xs", thickness: "2px", mr: 2 })) : null, "Save"] })] })] }), (0, jsx_runtime_1.jsx)("input", { id: "file-upload", type: "file", style: { display: "none" }, onChange: (e) => {
+                                    }, style: { overflow: "hidden" }, p: 0 }) })] }), (0, jsx_runtime_1.jsx)(react_2.Divider, { borderColor: theme.colors.gray[200] }), (0, jsx_runtime_1.jsxs)(react_2.Box, { px: 3, py: 2.5, children: [(0, jsx_runtime_1.jsxs)(react_2.Flex, { align: "center", justify: "space-between", w: "100%", gap: 3, children: [(0, jsx_runtime_1.jsxs)(react_2.Flex, { align: "center", gap: 2, minW: 0, children: [(0, jsx_runtime_1.jsx)(react_2.Tooltip, { label: "Attach files", hasArrow: true, placement: "top", children: (0, jsx_runtime_1.jsx)(react_2.Box, { as: "span", role: "button", tabIndex: 0, "aria-label": "Attach files", onClick: openFilePicker, onKeyDown: (0, activationKey_1.onActivationKey)(openFilePicker), _focusVisible: (0, focusRing_styles_1.focusVisibleRing)(theme.colors), cursor: "pointer", display: "flex", alignItems: "center", justifyContent: "center", w: "1.75rem", h: "1.75rem", borderRadius: "md", color: theme.colors.textMuted, transition: (0, motion_1.transitionFor)(["background-color"]), _hover: { bg: activeControlHoverBg }, children: (0, jsx_runtime_1.jsx)(lucide_react_1.Paperclip, { size: 16 }) }) }), (0, jsx_runtime_1.jsx)(react_2.Box, { h: "1rem", w: "1px", bg: theme.colors.gray[200] }), !titleShow ? ((0, jsx_runtime_1.jsx)(react_2.Box, { as: "button", type: "button", onClick: () => setTitleShow(true), px: 2, py: 1, borderRadius: "md", color: theme.colors.textMuted, fontWeight: 500, fontSize: "sm", transition: (0, motion_1.transitionFor)(["background-color"]), _hover: { bg: activeControlHoverBg }, children: "+ Add a title" })) : ((0, jsx_runtime_1.jsx)(react_2.Tooltip, { label: titleValue, hasArrow: true, isDisabled: !titleValue, children: (0, jsx_runtime_1.jsx)(react_2.Text, { color: theme.colors.textMuted, fontSize: "sm", fontWeight: 500, isTruncated: true, maxW: "180px", children: titleValue || "Title" }) }))] }), (0, jsx_runtime_1.jsxs)(react_2.Flex, { gap: 2.5, align: "center", ml: "auto", flexShrink: 0, children: [(0, jsx_runtime_1.jsxs)(react_2.Text, { fontSize: "xs", fontWeight: 500, color: isOverLimit ? theme.colors.semanticText.error : theme.colors.textMuted, whiteSpace: "nowrap", children: [noteWordCount, "/", maxNoteWordCount] }), cancelButtonHide ? null : ((0, jsx_runtime_1.jsx)(react_2.Button, { size: "sm", variant: "ghost", colorScheme: "gray", onClick: handleCloseTextArea, children: "Cancel" })), (0, jsx_runtime_1.jsxs)(react_2.Button, { size: "sm", variant: "solid", isLoading: !!saveButtonLoading, isDisabled: !noteValue || isSaveDisabled, onClick: () => handleSubmit(noteValue, titleValue, files), children: [saveButtonLoading ? ((0, jsx_runtime_1.jsx)(react_2.Spinner, { size: "xs", thickness: "2px", mr: 2 })) : null, "Save"] })] })] }), (0, jsx_runtime_1.jsx)("input", { ref: fileInputRef, id: fileInputId, type: "file", style: { display: "none" }, onChange: (e) => {
                                     const newFiles = Array.from(e.target.files || []);
                                     const validFiles = newFiles.filter((f) => f.size <= maxFileSize);
                                     const invalidFiles = newFiles.filter((f) => f.size > maxFileSize);
@@ -141,5 +154,7 @@ function NoteTextArea({ width = "100%", handleSubmit, handleCancel, value, title
                                     if (validFiles.length > 0) {
                                         setFiles((prev) => [...prev, ...validFiles]);
                                     }
-                                }, multiple: true }), fileError && ((0, jsx_runtime_1.jsx)(react_2.Text, { color: theme.colors.semanticText.error, mt: 2, fontSize: "xs", children: fileError })), files.length > 0 && ((0, jsx_runtime_1.jsx)(react_2.Flex, { mt: 3, gap: 2, wrap: "wrap", children: files.map((f, idx) => ((0, jsx_runtime_1.jsxs)(react_2.Flex, { align: "center", gap: 2, pl: 2.5, pr: 1.5, py: 1, borderRadius: "full", bg: theme.colors.gray[100], maxW: "100%", children: [(0, jsx_runtime_1.jsx)(lucide_react_1.File, { size: 13, color: theme.colors.textMuted }), (0, jsx_runtime_1.jsx)(react_2.Text, { fontSize: "xs", color: theme.colors.text[700], isTruncated: true, maxW: "160px", children: shortenFileName(f.name) }), (0, jsx_runtime_1.jsx)(react_2.Text, { fontSize: "xs", color: theme.colors.textMuted, whiteSpace: "nowrap", children: formatBytes(f.size) }), (0, jsx_runtime_1.jsx)(react_2.Box, { as: "button", type: "button", display: "flex", alignItems: "center", justifyContent: "center", borderRadius: "full", p: 0.5, color: theme.colors.textMuted, transition: "all 0.15s", _hover: { bg: theme.colors.gray[200], color: theme.colors.semanticText.error }, onClick: () => setFiles((prev) => prev.filter((fileItem) => fileItem !== f)), children: (0, jsx_runtime_1.jsx)(lucide_react_1.X, { size: 13 }) })] }, idx))) }))] })] }))] }));
-}
+                                }, multiple: true }), fileError && ((0, jsx_runtime_1.jsx)(react_2.Text, { color: theme.colors.semanticText.error, mt: 2, fontSize: "xs", children: fileError })), files.length > 0 && ((0, jsx_runtime_1.jsx)(react_2.Flex, { mt: 3, gap: 2, wrap: "wrap", children: files.map((f, idx) => ((0, jsx_runtime_1.jsxs)(react_2.Flex, { align: "center", gap: 2, pl: 2.5, pr: 1.5, py: 1, borderRadius: "full", bg: chipBg, maxW: "100%", children: [(0, jsx_runtime_1.jsx)(lucide_react_1.File, { size: 13, color: chipInk }), (0, jsx_runtime_1.jsx)(react_2.Text, { fontSize: "xs", color: theme.colors.text[700], isTruncated: true, maxW: "160px", children: shortenFileName(f.name) }), (0, jsx_runtime_1.jsx)(react_2.Text, { fontSize: "xs", color: chipInk, whiteSpace: "nowrap", children: formatBytes(f.size) }), (0, jsx_runtime_1.jsx)(react_2.Box, { as: "button", type: "button", "aria-label": `Remove ${f.name}`, display: "flex", alignItems: "center", justifyContent: "center", borderRadius: "full", p: 0.5, color: chipInk, transition: (0, motion_1.transitionFor)(["background-color", "color"]), _hover: { bg: chipRemoveHoverBg, color: theme.colors.semanticText.error }, onClick: () => setFiles((prev) => prev.filter((fileItem) => fileItem !== f)), children: (0, jsx_runtime_1.jsx)(lucide_react_1.X, { size: 13 }) })] }, idx))) }))] })] }))] }));
+});
+NoteTextArea.displayName = "NoteTextArea";
+exports.default = NoteTextArea;

package/dist/Components/NoteTextArea/NoteTextAreaProps.d.ts

@@ -1,18 +1,37 @@
-import { LegacyRef } from "react";
+/** Plain Chakra Textarea + title + file attach, not a rich text editor — no formatting toolbar despite the "note" naming. Use Editor for HTML content. */
 export type NoteTextAreaProps = {
+    /** Width of the whole composer; a number is px, a string is any CSS length. Defaults to "100%". */
     width?: number | string;
-    handleSubmit: (noteValue: string, titleValue: string, file: File[], resetState: void) => void;
+    /** Save click with note, title and files; `resetState` is never passed. */
+    handleSubmit: (noteValue: string, titleValue: string, file: File[], 
+    /** @deprecated Never passed; remove it from your handler. */
+    resetState: void) => void;
+    /** Seeds the note only while isEditable is true; not a controlled value. */
     value?: string;
+    /** Seeds and reveals the title input only while isEditable is true. */
     title?: string;
+    /** Seeds the attachments only while isEditable is true. */
     file?: File[];
+    /** Edit mode: opens expanded, seeds value/title/file, and keeps them after saving. */
     isEditable?: boolean;
-    handleCancel?: (isActive: boolean) => void;
+    /** Fires on Cancel. */
+    handleCancel?: (/** @deprecated Always false; do not read it. */ isActive: boolean) => void;
+    /** Any transition to false while isEditable is not true clears the note, title and files — including after a failed save, not just success. */
     saveButtonLoading?: boolean;
+    /** Per-file byte limit, default 1 MB; larger files are skipped with an error line. */
     maxFileSize?: number;
+    /** Error prefix; the formatted limit and a full stop are appended. */
     maxFilesSizeError?: string;
+    /** Disables Save when the note or the title exceeds this many words (default 15); the counter shows note words only. */
     maxNoteWordCount?: number;
+    /** Note text after each edit; whitespace-only input is rejected and not reported. */
     onChange?: (value: string) => void;
-    ref?: LegacyRef<HTMLInputElement>;
+    /** Collapsed prompt and textarea placeholder; also the default noteAriaLabel. */
     customPlaceholder?: string;
+    /** Hides Cancel; the composer then collapses only after a save completes. */
     cancelButtonHide?: boolean;
+    /** Accessible name for the title input. Defaults to `"Note title"`. */
+    titleAriaLabel?: string;
+    /** Accessible name for the note textarea. Defaults to `customPlaceholder`. */
+    noteAriaLabel?: string;
 };

package/dist/Components/Notification/Notification.d.ts

@@ -1,3 +1,4 @@
 import { NotificationProps } from "./NotificationProps";
+/** Date-driven countdown card ("due in 3 days" / "overdue by 2 hours"). For inbox-style rows use `NotificationItem`, which cannot render a future date. */
 declare const Notification: ({ notification, onClose, showStatus, onClick, isLoading, colors, }: NotificationProps) => import("react/jsx-runtime").JSX.Element;
 export default Notification;

package/dist/Components/Notification/Notification.js

@@ -1,4 +1,7 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 const jsx_runtime_1 = require("react/jsx-runtime");
 const react_1 = require("react");
@@ -7,6 +10,16 @@ const lucide_react_1 = require("lucide-react");
 const useCustomTheme_1 = require("../../Theme/useCustomTheme");
 const accentText_1 = require("../../Theme/tokens/builders/accentText");
 const statusTone_1 = require("../../Theme/tokens/builders/statusTone");
+const outlineRung_1 = require("../../Theme/tokens/builders/outlineRung");
+const Avatar_1 = __importDefault(require("../Avatar/Avatar"));
+const focusRing_styles_1 = require("../../Theme/chakra/focusRing.styles");
+const motion_1 = require("../../Theme/chakra/motion");
+const motion_2 = require("../../Theme/tokens/primitives/motion");
+const activationKey_1 = require("../Common/activationKey");
+const CARD_TRANSITION = (0, motion_2.transitionFor)(["box-shadow", "background-color", "border-color"], "base");
+const DISMISS_TRANSITION = (0, motion_2.transitionFor)(["background-color", "color", "transform"], "base");
+const TICK_MS = 60000;
+/** Date-driven countdown card ("due in 3 days" / "overdue by 2 hours"). For inbox-style rows use `NotificationItem`, which cannot render a future date. */
 const Notification = ({ notification, onClose, showStatus, onClick, isLoading = false, colors, }) => {
     var _a, _b, _c, _d, _e, _f, _g;
     const theme = (0, useCustomTheme_1.useCustomTheme)();
@@ -15,14 +28,25 @@ const Notification = ({ notification, onClose, showStatus, onClick, isLoading =
     const bgColor = (_a = colors === null || colors === void 0 ? void 0 : colors.bgColor) !== null && _a !== void 0 ? _a : theme.colors.background[50];
     const borderColor = (_b = colors === null || colors === void 0 ? void 0 : colors.borderColor) !== null && _b !== void 0 ? _b : theme.colors.boxborder[200];
     const textColor = (_c = colors === null || colors === void 0 ? void 0 : colors.textColor) !== null && _c !== void 0 ? _c : theme.colors.text[700];
-    const titleColor = (_d = colors === null || colors === void 0 ? void 0 : colors.titleColor) !== null && _d !== void 0 ? _d : theme.colors.text[800];
+    const titleColor = (_d = colors === null || colors === void 0 ? void 0 : colors.titleColor) !== null && _d !== void 0 ? _d : (0, outlineRung_1.liftToContrast)(theme.colors.text[800], bgColor, accentText_1.AA_NORMAL_TEXT);
     // The dot is a graphic on the canvas: `semantic[tone][500]` measures under 3:1 there.
     const warningColor = (_e = colors === null || colors === void 0 ? void 0 : colors.warningColor) !== null && _e !== void 0 ? _e : theme.colors.semanticText.warning;
     const errorColor = (_f = colors === null || colors === void 0 ? void 0 : colors.errorColor) !== null && _f !== void 0 ? _f : theme.colors.semanticText.error;
     const successColor = (_g = colors === null || colors === void 0 ? void 0 : colors.successColor) !== null && _g !== void 0 ? _g : theme.colors.semanticText.success;
+    const dueLabelColor = (0, outlineRung_1.liftToContrast)(theme.colors.orange[500], bgColor, accentText_1.AA_NORMAL_TEXT);
+    const metaColor = (0, outlineRung_1.liftToContrast)(theme.colors.textMuted, bgColor, accentText_1.AA_NORMAL_TEXT);
     const startDate = (0, react_1.useMemo)(() => notification.startDate
         ? new Date(notification.startDate)
         : null, [notification.startDate]);
+    const hasTarget = Boolean(notification.dueDate || notification.endDate);
+    const [now, setNow] = (0, react_1.useState)(() => Date.now());
+    (0, react_1.useEffect)(() => {
+        if (!hasTarget || isLoading)
+            return;
+        setNow(Date.now());
+        const timer = setInterval(() => setNow(Date.now()), TICK_MS);
+        return () => clearInterval(timer);
+    }, [hasTarget, isLoading, notification.dueDate, notification.endDate]);
     const { timeLabel, diffDays } = (0, react_1.useMemo)(() => {
         const targetDate = notification.dueDate
             ? new Date(notification.dueDate)
@@ -31,8 +55,7 @@ const Notification = ({ notification, onClose, showStatus, onClick, isLoading =
                 : null;
         if (!targetDate)
             return { timeLabel: "", diffDays: null };
-        const now = new Date();
-        const diffMs = targetDate.getTime() - now.getTime();
+        const diffMs = targetDate.getTime() - now;
         const diffMinutes = Math.floor(diffMs / (1000 * 60));
         const diffHours = diffMinutes / 60;
         const diffDays = diffHours / 24;
@@ -46,11 +69,11 @@ const Notification = ({ notification, onClose, showStatus, onClick, isLoading =
         if (diffMs < 0) {
             const overdueMinutes = Math.abs(diffMinutes);
             if (overdueMinutes < 60)
-                label = `${typeLabel} overdue by ${overdueMinutes} minute${overdueMinutes === 1 ? "" : "s"} ago`;
+                label = `${typeLabel} overdue by ${overdueMinutes} minute${overdueMinutes === 1 ? "" : "s"}`;
             else if (overdueMinutes < 1440)
-                label = `${typeLabel} overdue by ${Math.floor(overdueMinutes / 60)} hour${Math.floor(overdueMinutes / 60) === 1 ? "" : "s"} ago`;
+                label = `${typeLabel} overdue by ${Math.floor(overdueMinutes / 60)} hour${Math.floor(overdueMinutes / 60) === 1 ? "" : "s"}`;
             else
-                label = `${typeLabel} overdue by ${Math.floor(overdueMinutes / 1440)} day${Math.floor(overdueMinutes / 1440) === 1 ? "" : "s"} ago`;
+                label = `${typeLabel} overdue by ${Math.floor(overdueMinutes / 1440)} day${Math.floor(overdueMinutes / 1440) === 1 ? "" : "s"}`;
         }
         else {
             if (diffMinutes < 60)
@@ -61,7 +84,7 @@ const Notification = ({ notification, onClose, showStatus, onClick, isLoading =
                 label = `${typeLabel} due in ${Math.ceil(diffDays)} day${Math.ceil(diffDays) === 1 ? "" : "s"}`;
         }
         return { timeLabel: label, diffDays };
-    }, [notification.dueDate, notification.endDate, notification.type]);
+    }, [notification.dueDate, notification.endDate, notification.type, now]);
     const getStatusColor = () => {
         if (diffDays === null)
             return theme.colors.textMuted;
@@ -91,20 +114,18 @@ const Notification = ({ notification, onClose, showStatus, onClick, isLoading =
             };
         return startDate.toLocaleString("en-US", options);
     }, [startDate, notification.type]);
-    // 🔄 If loading, show skeleton
     if (isLoading) {
         return ((0, jsx_runtime_1.jsx)(react_2.Box, { bg: bgColor, border: "1px solid", borderColor: borderColor, borderRadius: "xl", p: 4, w: "100%", maxW: "400px", boxShadow: "sm", children: (0, jsx_runtime_1.jsxs)(react_2.VStack, { align: "start", spacing: 3, w: "100%", children: [(0, jsx_runtime_1.jsxs)(react_2.HStack, { spacing: 2, children: [(0, jsx_runtime_1.jsx)(react_2.SkeletonCircle, { size: "4" }), (0, jsx_runtime_1.jsx)(react_2.Skeleton, { height: "14px", width: "60%" })] }), (0, jsx_runtime_1.jsxs)(react_2.HStack, { align: "center", spacing: 3, w: "100%", children: [(0, jsx_runtime_1.jsx)(react_2.SkeletonCircle, { size: "8" }), (0, jsx_runtime_1.jsxs)(react_2.VStack, { align: "start", spacing: 1, flex: "1", children: [(0, jsx_runtime_1.jsx)(react_2.Skeleton, { height: "16px", width: "70%" }), (0, jsx_runtime_1.jsx)(react_2.Skeleton, { height: "12px", width: "50%" })] })] }), (0, jsx_runtime_1.jsx)(react_2.Divider, { borderColor: borderColor }), (0, jsx_runtime_1.jsxs)(react_2.HStack, { justify: "space-between", w: "100%", children: [(0, jsx_runtime_1.jsx)(react_2.Skeleton, { height: "12px", width: "40%" }), (0, jsx_runtime_1.jsx)(react_2.Skeleton, { height: "12px", width: "30%" })] })] }) }));
     }
-    // 🧩 Normal render
-    return ((0, jsx_runtime_1.jsxs)(react_2.Box, { bg: bgColor, border: "1px solid", borderColor: borderColor, borderRadius: "xl", p: 4, w: "100%", maxW: "400px", boxShadow: "sm", _hover: { boxShadow: "md", transform: "translateY(-2px)" }, transition: "all 0.2s ease", position: "relative", children: [onClose && ((0, jsx_runtime_1.jsx)(react_2.Box, { position: "absolute", top: "2", right: "2", cursor: "pointer", onClick: onClose, onKeyDown: (e) => {
-                    if (e.key === "Enter" || e.key === " ") {
-                        e.preventDefault();
-                        onClose();
-                    }
-                }, tabIndex: 0, p: 1, borderRadius: "md", _hover: {
+    return ((0, jsx_runtime_1.jsxs)(react_2.Box, { bg: bgColor, border: "1px solid", borderColor: borderColor, borderRadius: "xl", p: 4, w: "100%", maxW: "400px", boxShadow: "sm", _hover: { boxShadow: "md" }, transition: CARD_TRANSITION, sx: (0, motion_1.reducedMotionSx)(), position: "relative", children: [onClose && ((0, jsx_runtime_1.jsx)(react_2.Box, { position: "absolute", top: "2", right: "2", cursor: "pointer", onClick: onClose, onKeyDown: (0, activationKey_1.onActivationKey)(() => onClose()), role: "button", "aria-label": "Dismiss notification", tabIndex: 0, p: 1, borderRadius: "md", _hover: {
                     bg: closeTone.bg,
                     color: closeTone.fg,
                     transform: "scale(1.1)",
-                }, transition: "all 0.2s ease", children: (0, jsx_runtime_1.jsx)(lucide_react_1.X, { size: 16 }) })), (0, jsx_runtime_1.jsxs)(react_2.VStack, { align: "start", spacing: 3, w: "100%", children: [(0, jsx_runtime_1.jsxs)(react_2.HStack, { spacing: 2, children: [(0, jsx_runtime_1.jsx)(react_2.Icon, { as: TimeIcon, color: (0, accentText_1.accentTextOnCanvas)(theme.colors.orange, bgColor), boxSize: 4 }), (0, jsx_runtime_1.jsx)(react_2.Text, { fontSize: "sm", color: (0, accentText_1.accentTextOnCanvas)(theme.colors.orange, bgColor), fontWeight: "semibold", children: timeLabel })] }), (0, jsx_runtime_1.jsxs)(react_2.HStack, { align: "center", spacing: 3, w: "100%", children: [(0, jsx_runtime_1.jsx)(react_2.Avatar, { size: "sm", name: notification.host || notification.title, src: notification.avatarUrl || "" }), (0, jsx_runtime_1.jsxs)(react_2.VStack, { align: "start", spacing: 0, flex: "1", children: [(0, jsx_runtime_1.jsx)(react_2.Text, { fontWeight: "bold", fontSize: "md", color: titleColor, cursor: "pointer", _hover: { textColor: theme.colors.accentText }, onClick: () => onClick === null || onClick === void 0 ? void 0 : onClick(notification.id, notification.type), children: notification.title }), notification.description && ((0, jsx_runtime_1.jsx)(react_2.Text, { fontSize: "sm", color: textColor, children: notification.description }))] })] }), (0, jsx_runtime_1.jsx)(react_2.Divider, { borderColor: borderColor }), (0, jsx_runtime_1.jsxs)(react_2.HStack, { justify: "space-between", w: "100%", children: [(0, jsx_runtime_1.jsxs)(react_2.HStack, { spacing: 2, children: [(0, jsx_runtime_1.jsx)(react_2.Icon, { as: lucide_react_1.Calendar, color: theme.colors.textMuted, boxSize: 4 }), (0, jsx_runtime_1.jsx)(react_2.Text, { fontSize: "sm", color: theme.colors.textMuted, children: formattedStartDateTime })] }), (0, jsx_runtime_1.jsxs)(react_2.HStack, { spacing: 2, children: [(0, jsx_runtime_1.jsx)(react_2.Icon, { as: lucide_react_1.User, color: theme.colors.textMuted, boxSize: 4 }), notification.host && ((0, jsx_runtime_1.jsx)(react_2.Text, { fontSize: "sm", color: theme.colors.textMuted, children: notification.host }))] }), showStatus && ((0, jsx_runtime_1.jsx)(react_2.Box, { boxSize: "3", bg: getStatusColor(), borderRadius: "full" }))] })] })] }));
+                }, _focusVisible: (0, focusRing_styles_1.focusVisibleRing)(theme.colors), transition: DISMISS_TRANSITION, sx: (0, motion_1.reducedMotionSx)(), children: (0, jsx_runtime_1.jsx)(lucide_react_1.X, { size: 16 }) })), (0, jsx_runtime_1.jsxs)(react_2.VStack, { align: "start", spacing: 3, w: "100%", children: [(0, jsx_runtime_1.jsxs)(react_2.HStack, { spacing: 2, children: [(0, jsx_runtime_1.jsx)(react_2.Icon, { as: TimeIcon, color: dueLabelColor, boxSize: 4 }), (0, jsx_runtime_1.jsx)(react_2.Text, { fontSize: "sm", color: dueLabelColor, fontWeight: 600, children: timeLabel })] }), (0, jsx_runtime_1.jsxs)(react_2.HStack, { align: "center", spacing: 3, w: "100%", children: [(0, jsx_runtime_1.jsx)(Avatar_1.default, { size: "sm", name: notification.host || notification.title, src: notification.avatarUrl || undefined }), (0, jsx_runtime_1.jsxs)(react_2.VStack, { align: "start", spacing: 0, flex: "1", children: [(0, jsx_runtime_1.jsx)(react_2.Text, { fontWeight: 700, fontSize: "md", color: titleColor, cursor: "pointer", _hover: { textColor: theme.colors.accentText }, onClick: () => onClick === null || onClick === void 0 ? void 0 : onClick(notification.id, notification.type), ...(onClick && {
+                                            role: "button",
+                                            tabIndex: 0,
+                                            onKeyDown: (0, activationKey_1.onActivationKey)(() => onClick(notification.id, notification.type)),
+                                            _focusVisible: (0, focusRing_styles_1.focusVisibleRing)(theme.colors),
+                                        }), children: notification.title }), notification.description && ((0, jsx_runtime_1.jsx)(react_2.Text, { fontSize: "sm", color: textColor, children: notification.description }))] })] }), (0, jsx_runtime_1.jsx)(react_2.Divider, { borderColor: borderColor }), (0, jsx_runtime_1.jsxs)(react_2.HStack, { justify: "space-between", w: "100%", children: [(0, jsx_runtime_1.jsxs)(react_2.HStack, { spacing: 2, children: [(0, jsx_runtime_1.jsx)(react_2.Icon, { as: lucide_react_1.Calendar, color: metaColor, boxSize: 4 }), (0, jsx_runtime_1.jsx)(react_2.Text, { fontSize: "sm", color: metaColor, children: formattedStartDateTime })] }), (0, jsx_runtime_1.jsxs)(react_2.HStack, { spacing: 2, children: [(0, jsx_runtime_1.jsx)(react_2.Icon, { as: lucide_react_1.User, color: metaColor, boxSize: 4 }), notification.host && ((0, jsx_runtime_1.jsx)(react_2.Text, { fontSize: "sm", color: metaColor, children: notification.host }))] }), showStatus && ((0, jsx_runtime_1.jsx)(react_2.Box, { boxSize: "3", bg: getStatusColor(), borderRadius: "full" }))] })] })] }));
 };
 exports.default = Notification;

package/dist/Components/Notification/NotificationProps.d.ts

@@ -1,28 +1,50 @@
+/** The event/task/call record a Notification card renders; startDate/dueDate/endDate drive its countdown text. */
 export type NotificationData = {
+    /** Echoed back to onClick together with `type`. */
     id: number;
+    /** Card heading; also the avatar's initials when `host` is empty. */
     title: string;
+    /** Avatar image; initials from `host` or `title` show without it. */
     avatarUrl?: string;
+    /** Date-parsable string shown in en-US; meetings add the time, others the year. */
     startDate: string;
+    /** Countdown target, preferred over endDate; the label refreshes every minute. */
     dueDate?: string;
+    /** Countdown target used only when dueDate is absent. */
     endDate?: string;
+    /** Shown in the footer and used for the avatar's initials. */
     host?: string;
     description?: string;
+    /** @deprecated Never read; the status dot colour comes from dueDate/endDate date math. */
     status?: string;
+    /** Prefixes the countdown label ("Task due in 3 days") and is echoed to onClick. */
     type: "task" | "meeting" | "call";
 };
+/** Props for the `Notification` countdown card. */
 export type NotificationProps = {
     notification: NotificationData;
+    /** Shows a dismiss control (also Enter/Space); the card never hides itself. */
     onClose?: () => void;
+    /** Adds a dot coloured by urgency: overdue, under an hour, under a day, later. */
     showStatus?: boolean;
+    /** Fires only when the title text is clicked — the avatar, description and card body are not clickable. */
     onClick?: (id: number, type: "task" | "meeting" | "call") => void;
+    /** Renders a skeleton card in place of the notification. */
     isLoading?: boolean;
+    /** Per-card colour overrides; raw values here do not follow dark mode. */
     colors?: NotificationColor;
 };
+/** Optional per-card palette override for Notification; any field left unset falls back to theme tokens. */
 export type NotificationColor = {
+    /** Card surface; the default title, due-label and meta inks are contrast-lifted against it. */
     bgColor?: string;
+    /** Card border and both dividers. */
     borderColor?: string;
+    /** Description text only. */
     textColor?: string;
+    /** Replaces the contrast-lifted title ink, so check AA contrast yourself. */
     titleColor?: string;
+    /** warningColor/errorColor/successColor only paint the status dot, and only when showStatus is true — otherwise inert. */
     warningColor?: string;
     errorColor?: string;
     successColor?: string;

package/dist/Components/NotificationBell/NotificationBell.d.ts

@@ -0,0 +1,4 @@
+import type { NotificationBellProps } from "./NotificationBellProps";
+/** Trigger + three-state badge (capped count -> dot -> nothing); pair with a Popover the caller owns. */
+declare const NotificationBell: import("react").ForwardRefExoticComponent<NotificationBellProps & import("react").RefAttributes<HTMLButtonElement>>;
+export default NotificationBell;

package/dist/Components/NotificationBell/NotificationBell.js

@@ -0,0 +1,39 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const lucide_react_1 = require("lucide-react");
+const Primitives_1 = require("../Primitives/Primitives");
+const IconButton_1 = __importDefault(require("../IconButton/IconButton"));
+const useCustomTheme_1 = require("../../Theme/useCustomTheme");
+const filledSurface_1 = require("../../Theme/tokens/builders/filledSurface");
+const tone_1 = require("../../Theme/tokens/builders/tone");
+const notificationHelpers_1 = require("./notificationHelpers");
+const ICON_BOX = {
+    xs: 14,
+    sm: 16,
+    md: 18,
+    lg: 20,
+};
+const BADGE_OFFSET = {
+    xs: "-2px",
+    sm: "-3px",
+    md: "-4px",
+    lg: "-5px",
+};
+/** Trigger + three-state badge (capped count -> dot -> nothing); pair with a Popover the caller owns. */
+const NotificationBell = (0, react_1.forwardRef)(function NotificationBell({ count, showDot = false, max = 99, tone = "warning", dotTone = "info", icon = lucide_react_1.Bell, size = "sm", ringColor, onClick, isOpen, "aria-label": ariaLabel, }, ref) {
+    const theme = (0, useCustomTheme_1.useCustomTheme)();
+    const { colors } = theme;
+    const ring = ringColor !== null && ringColor !== void 0 ? ringColor : colors.backgroundColor.main;
+    const showCount = typeof count === "number" && count > 0;
+    const showFallbackDot = !showCount && showDot;
+    const badgeOffset = BADGE_OFFSET[size];
+    const countSurface = showCount ? (0, filledSurface_1.resolveFilledSurface)((0, tone_1.toneScale)(colors, tone), colors) : null;
+    const dotFill = showFallbackDot ? (0, tone_1.toneInk)(colors, dotTone) : undefined;
+    return ((0, jsx_runtime_1.jsxs)(Primitives_1.Box, { position: "relative", display: "inline-flex", children: [(0, jsx_runtime_1.jsx)(IconButton_1.default, { ref: ref, "aria-label": ariaLabel, "aria-expanded": isOpen, "aria-haspopup": "dialog", icon: (0, jsx_runtime_1.jsx)(Primitives_1.Icon, { as: icon, boxSize: `${ICON_BOX[size]}px` }), variant: "ghost", size: size, onClick: onClick }), showCount && countSurface ? ((0, jsx_runtime_1.jsx)(Primitives_1.Box, { as: "span", "data-testid": "notification-bell-count", position: "absolute", top: badgeOffset, right: badgeOffset, minW: "1.1rem", h: "1.1rem", px: "0.25rem", borderRadius: "full", display: "flex", alignItems: "center", justifyContent: "center", fontSize: "0.625rem", fontWeight: 700, lineHeight: 1, bg: countSurface.fill, color: countSurface.color, boxShadow: `0 0 0 2px ${ring}`, children: (0, notificationHelpers_1.formatCount)(count, max) })) : null, showFallbackDot ? ((0, jsx_runtime_1.jsx)(Primitives_1.Box, { as: "span", "data-testid": "notification-bell-dot", position: "absolute", top: badgeOffset, right: badgeOffset, boxSize: "0.5rem", borderRadius: "full", bg: dotFill, boxShadow: `0 0 0 2px ${ring}` })) : null] }));
+});
+exports.default = NotificationBell;

package/dist/Components/NotificationBell/NotificationBellProps.d.ts

@@ -0,0 +1,174 @@
+import type { ElementType, ReactNode, RefObject } from "react";
+import type { EmptyStateProps } from "../EmptyState/EmptyStateProps";
+import type { Tone } from "../../Theme/tokens/builders/tone";
+import type { DaySectionLabels } from "./notificationHelpers";
+/** Shared tone vocabulary for the badge, row tile and zone/filter buttons — an alias of the theme's Tone. */
+export type NotificationTone = Tone;
+/** Button size scale for the bell trigger. */
+export type NotificationBellSize = "xs" | "sm" | "md" | "lg";
+/** Bell trigger with the three-state badge (capped count -> dot -> nothing); renders no panel itself. */
+export interface NotificationBellProps {
+    /** Renders the capped number pill. 0 or undefined falls through to `showDot`. */
+    count?: number;
+    /** Ambient-activity dot, shown only when `count` renders nothing. */
+    showDot?: boolean;
+    /** Counts above this render as "<max>+". Defaults to 99 (matches MUI/Ant). */
+    max?: number;
+    /** Number-pill tone; defaults to "warning". */
+    tone?: NotificationTone;
+    /** Dot tone; defaults to "info". */
+    dotTone?: NotificationTone;
+    /** Defaults to lucide `Bell`. Pass a component reference, not an element. */
+    icon?: ElementType;
+    /** Defaults to "sm". */
+    size?: NotificationBellSize;
+    /** Badge ring colour so the pill reads on a tinted bar. Defaults to the canvas. */
+    ringColor?: string;
+    /** Fires when the bell button is activated; the bell renders no panel, so toggle your popover here. */
+    onClick?: () => void;
+    /** Reflected as `aria-expanded`; pass the panel's open state when the bell drives a popover. */
+    isOpen?: boolean;
+    /** Required — tickets hardcoded English here; the caller must name the counts (i18n-able). */
+    "aria-label": string;
+}
+/** What the row chassis actually paints. Consumers map their own row type onto this. */
+export interface NotificationItemModel {
+    /** Used as the React key within a list; must be unique among the rows. */
+    id: string;
+    /** Main line; ReactNode so a caller can inject links/bold without the library parsing markup. */
+    title: ReactNode;
+    /** Secondary line, clamped to 2 lines. */
+    body?: ReactNode;
+    /** Epoch ms, an ISO string, or a Date; drives both the relative label and day bucketing. */
+    timestamp: number | string | Date;
+    /** False shows the unread indicator chosen by `unreadIndicator`; true renders the row plain. */
+    isRead: boolean;
+    /** Icon for the 28x28 tile; pass a component reference, not an element. */
+    icon?: ElementType;
+    /** Tints the tile and the unread indicator. */
+    tone?: NotificationTone;
+    /** Avatar overlaid on the tile's corner. */
+    actor?: {
+        name?: string;
+        avatarUrl?: string | null;
+    };
+    /** Small label above the title — tickets' "PT-104", hrms' "LEAVE". */
+    eyebrow?: ReactNode;
+    /** Adjacent rows sharing this key collapse into one expandable run; null/undefined never collapses. */
+    groupKey?: string | null;
+    /** Optional destination; NotificationItem never navigates itself. */
+    href?: string;
+}
+/** How the unread state reads on a row. Defaults to "bar" (the 2px left border both apps use). */
+export type NotificationUnreadIndicator = "bar" | "dot" | "tint" | "none";
+/** One row; exported so a `renderItem` override can still reuse the chassis. */
+export interface NotificationItemProps {
+    /** The mapped row model that this chassis paints. */
+    item: NotificationItemModel;
+    /** Makes the tile and text a focusable button when set; without it the row is non-interactive. */
+    onClick?: () => void;
+    /** Action cluster, hidden until row hover/focus unless `actionsAlwaysVisible`. */
+    actions?: ReactNode;
+    /** hrms' approval rows show Approve/Reject at rest; tickets reveals on hover. */
+    actionsAlwaysVisible?: boolean;
+    /** Extra block under the body: a comment blockquote, a status from-to pair. */
+    preview?: ReactNode;
+    /** Right-hand meta, e.g. hrms' "waiting 3 days". */
+    trailing?: ReactNode;
+    /** Applies only when `item.isRead` is false; `"none"` shows no unread cue. */
+    unreadIndicator?: NotificationUnreadIndicator;
+    /** When this row represents a collapsed run, the number of rows it stands in for. */
+    groupCount?: number;
+    /** Fires when a collapsed run's "Show N updates" affordance is activated. */
+    onExpandGroup?: () => void;
+}
+/** Props shared by NotificationList and NotificationPanel — generic over the caller's own row type. */
+export interface NotificationListProps<T> {
+    /** Rows in display order; each is mapped through `toItem` for rendering and, with `groupBy` "day", bucketed by its timestamp. */
+    items: T[];
+    /** The adapter. The one required piece of consumer glue. */
+    toItem: (row: T) => NotificationItemModel;
+    /** "day" buckets into Today/Yesterday/Earlier; "none" is a flat list. Defaults to "day". */
+    groupBy?: "day" | "none";
+    /** Collapse adjacent rows sharing a `groupKey` behind "Show N updates". Defaults to false. */
+    collapseGroups?: boolean;
+    /** Overrides the three default bucket labels — the i18n hook. */
+    dayLabels?: DaySectionLabels;
+    /** Receives the original row, not the mapped model; setting it makes every default row a button. */
+    onItemClick?: (row: T) => void;
+    /** The hover-revealed, keyboard-reachable action cluster per row. */
+    itemActions?: (row: T) => ReactNode;
+    /** Full row override; receives the mapped model so a caller can decorate, not restart. */
+    renderItem?: (row: T, model: NotificationItemModel) => ReactNode;
+    /** Replaces the sticky day-section header. */
+    renderSectionHeader?: (label: string) => ReactNode;
+    /** Forwarded to each default row; has no effect when `renderItem` replaces the row. */
+    unreadIndicator?: NotificationUnreadIndicator;
+    /** Forwarded to each default row; shows `itemActions` at rest instead of on hover or focus. */
+    actionsAlwaysVisible?: boolean;
+    /** Names the list as a region landmark; no region role is added when omitted. */
+    "aria-label"?: string;
+}
+/** One tab in the zone row; `render` exists so a foreign queue (hrms' "Needs you") can host its own body. */
+export interface NotificationZone {
+    /** Matched against `activeZone` and passed to `onZoneChange` when the tab is clicked. */
+    id: string;
+    /** Tab text; the capped `count` is appended in parentheses. */
+    label: string;
+    /** Rendered as a capped count suffix on the tab; omit for no count. */
+    count?: number;
+    /** Tab tone; defaults to "warning". */
+    tone?: NotificationTone;
+    /** Replaces the whole zone body; when set, `items` for this zone is ignored. */
+    render?: () => ReactNode;
+}
+/** A filter chip rendered next to the zone row; count is suffixed as "(n)", capped like the badge. */
+export interface NotificationFilter {
+    /** Matched against `activeFilter` and passed to `onFilterChange` when the chip is clicked. */
+    id: string;
+    /** Chip text; `count` is appended in parentheses when set. */
+    label: string;
+    /** Shown even when 0, unlike a zone count; capped at 99 like the badge. Omit for no suffix. */
+    count?: number;
+}
+/** The panel shell. Generic over the caller's row type — the library defines no notification shape. */
+export interface NotificationPanelProps<T> extends NotificationListProps<T> {
+    /** Omit for a single-zone panel (crm, spare-cart). Two zones is the tickets/hrms shape. */
+    zones?: NotificationZone[];
+    /** Id of the selected zone; that zone's `render`, if set, replaces the panel body. */
+    activeZone?: string;
+    /** Receives the clicked zone's id; the panel is controlled, so update `activeZone` yourself. */
+    onZoneChange?: (zoneId: string) => void;
+    /** Filter chips under the zone row; the row is omitted when empty or unset. */
+    filters?: NotificationFilter[];
+    /** Id of the selected filter chip; controlled, so update it from `onFilterChange`. */
+    activeFilter?: string;
+    /** Receives the clicked filter's id; update `activeFilter` yourself. */
+    onFilterChange?: (filterId: string) => void;
+    /** Shows four skeleton rows in place of the list; beats the error and empty states, but not a zone's `render`. */
+    isLoading?: boolean;
+    /** Anything non-nullish shows the error state — closes tickets' documented no-error-state gap. */
+    error?: unknown;
+    /** Adds a Retry button to the error state; the button is omitted when unset. */
+    onRetry?: () => void;
+    /** Props for the default EmptyState. */
+    empty?: EmptyStateProps;
+    /** Panel header content; omit for the default title row. */
+    header?: ReactNode;
+    /** Right side of the header, e.g. "Mark all as read". */
+    headerAction?: ReactNode;
+    /** Footer links under the scrollable list. */
+    footer?: ReactNode;
+    /** "popover" is height-bounded and scroll-locked; "page" grows with the document. Defaults to "popover". */
+    variant?: "popover" | "page";
+    /** Fixed max height; when unset the popover variant measures its own anchored height. */
+    maxH?: string | number;
+    /** Fires from the "Load more" button, which renders only while `hasMore` is true. */
+    onLoadMore?: () => void;
+    /** Shows the "Load more" button under the list. Defaults to false. */
+    hasMore?: boolean;
+    /** Puts the "Load more" button into its loading state. Defaults to false. */
+    isLoadingMore?: boolean;
+    /** Receives the panel root element; also the node whose top edge the popover height is measured from. */
+    panelRef?: RefObject<HTMLDivElement>;
+}

package/dist/Components/NotificationBell/NotificationBellProps.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/Components/NotificationBell/NotificationItem.d.ts

@@ -0,0 +1,4 @@
+import type { NotificationItemProps } from "./NotificationBellProps";
+/** One notification row; used by NotificationList and reusable standalone under a `renderItem` override. */
+declare const NotificationItem: ({ item, onClick, actions, actionsAlwaysVisible, preview, trailing, unreadIndicator, groupCount, onExpandGroup, }: NotificationItemProps) => import("react/jsx-runtime").JSX.Element;
+export default NotificationItem;