pixelize-design-library 3.0.1-beta.1 → 3.1.1

package/dist/Components/Timeline/Timeline.js

@@ -3,168 +3,266 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-var react_1 = __importDefault(require("react"));
-var react_2 = require("@chakra-ui/react");
-var lucide_react_1 = require("lucide-react");
-var useCustomTheme_1 = require("../../Theme/useCustomTheme");
-var functions_1 = require("../../Utils/functions");
-var Timeline = function (_a) {
-    var _b, _c, _d, _e;
-    var timelineEvents = _a.timelineEvents;
-    var theme = (0, useCustomTheme_1.useCustomTheme)();
-    var isMobile = (0, react_2.useBreakpointValue)({ base: true, md: false });
-    var formatTimestamp = function (timestamp, type) {
-        var parsedTimestamp;
-        if (typeof timestamp === 'string' && !timestamp.match(/^\d+$/)) {
-            var date_1 = new Date(timestamp);
-            if (!isNaN(date_1.getTime())) {
-                if (type === "date") {
-                    return date_1.toLocaleDateString("en-US", {
-                        month: "long",
-                        day: "numeric",
-                        year: "numeric",
-                    });
-                }
-                else if (type === "time") {
-                    return date_1.toLocaleTimeString("en-US", {
-                        hour: "numeric",
-                        minute: "2-digit",
-                        hour12: true,
-                    });
-                }
-                return date_1.toLocaleString();
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("@chakra-ui/react");
+const lucide_react_1 = require("lucide-react");
+const react_2 = __importDefault(require("react"));
+const useCustomTheme_1 = require("../../Theme/useCustomTheme");
+const accentText_1 = require("../../Theme/tokens/builders/accentText");
+const planeStep_1 = require("../../Theme/tokens/builders/planeStep");
+const outlineRung_1 = require("../../Theme/tokens/builders/outlineRung");
+const motion_1 = require("../../Theme/tokens/primitives/motion");
+const borderWidths_1 = require("../../Theme/tokens/primitives/borderWidths");
+const typography_1 = require("../../Theme/tokens/primitives/typography");
+const motion_2 = require("../../Theme/chakra/motion");
+const focusRing_styles_1 = require("../../Theme/chakra/focusRing.styles");
+const functions_1 = require("../../Utils/functions");
+const NoteTextArea_1 = __importDefault(require("../NoteTextArea/NoteTextArea"));
+const react_3 = require("react");
+// Building an Intl formatter costs ~50-200µs on a low-end phone; one per format, not per event.
+const DATE_FMT = new Intl.DateTimeFormat("en-US", {
+    month: "long",
+    day: "numeric",
+    year: "numeric",
+});
+const TIME_FMT = new Intl.DateTimeFormat("en-US", {
+    hour: "numeric",
+    minute: "2-digit",
+    hour12: true,
+});
+const formatTimestamp = (timestamp, type) => {
+    if (typeof timestamp === "string" && !timestamp.match(/^\d+$/)) {
+        const date = new Date(timestamp);
+        if (!isNaN(date.getTime())) {
+            if (type === "date") {
+                return DATE_FMT.format(date);
             }
-        }
-        parsedTimestamp = parseInt(timestamp, 10);
-        var date = new Date(parsedTimestamp);
-        if (isNaN(date.getTime())) {
-            console.warn("Invalid timestamp:", timestamp);
-            return "Invalid Date";
-        }
-        if (type === "date") {
-            return date.toLocaleDateString("en-US", {
-                month: "long",
-                day: "numeric",
-                year: "numeric",
-            });
-        }
-        else if (type === "time") {
-            return date.toLocaleTimeString("en-US", {
-                hour: "numeric",
-                minute: "2-digit",
-                hour12: true,
-            });
-        }
-        return date.toLocaleString();
-    };
-    var getIcon = function (event) {
-        switch (event.action_from) {
-            case "Accounts":
-                return react_1.default.createElement(lucide_react_1.IndianRupee, { size: isMobile ? 14 : 17 });
-            case "Notes":
-                return react_1.default.createElement(lucide_react_1.FileText, { size: isMobile ? 14 : 17 });
-            default:
-                return react_1.default.createElement(lucide_react_1.Volleyball, { size: isMobile ? 14 : 17 });
-        }
-    };
-    var groupEventsByDate = function (events) {
-        return events.reduce(function (groups, event) {
-            var date = formatTimestamp(event.created_at, "date");
-            if (date !== "Invalid Date") {
-                if (!groups[date])
-                    groups[date] = [];
-                groups[date].push(event);
-            }
-            return groups;
-        }, {});
-    };
-    var groupedEvents = groupEventsByDate(timelineEvents);
-    var formatChanges = function (changes) {
-        if (!changes || changes === "null")
-            return "No Changes";
-        try {
-            var parsedChanges = JSON.parse(changes);
-            if (typeof parsedChanges !== 'object' || parsedChanges === null) {
-                return "No Changes";
+            else if (type === "time") {
+                return TIME_FMT.format(date);
             }
-            return Object.entries(parsedChanges)
-                .map(function (_a) {
-                var key = _a[0], value = _a[1];
-                var changeRecord = value;
-                if (changeRecord.original === null || changeRecord.original === undefined) {
-                    return "".concat(key, " changed from null to ").concat(changeRecord.updated);
-                }
-                else {
-                    return "".concat(key, " updated from ").concat(changeRecord.original, " to ").concat(changeRecord.updated);
-                }
-            })
-                .join("\n");
+            return date.toLocaleString();
         }
-        catch (error) {
-            console.error("Error parsing changes:", error);
-            return "Error parsing changes";
+    }
+    const parsedTimestamp = parseInt(String(timestamp), 10);
+    const date = new Date(parsedTimestamp);
+    if (isNaN(date.getTime())) {
+        console.warn("Invalid timestamp:", timestamp);
+        return "Invalid Date";
+    }
+    if (type === "date") {
+        return DATE_FMT.format(date);
+    }
+    else if (type === "time") {
+        return TIME_FMT.format(date);
+    }
+    return date.toLocaleString();
+};
+// A semantic color scale chosen by the action title (created / updated / delete).
+const getEventScale = (colors, title) => {
+    switch ((title || "").toLowerCase()) {
+        case "created":
+            return colors.semantic.success;
+        case "updated":
+            return colors.semantic.warning;
+        case "delete":
+        case "deleted":
+            return colors.semantic.error;
+        default:
+            return colors.primary;
+    }
+};
+// Action-title icon (what happened); falls back to the source icon below.
+const getActionIcon = (title, size) => {
+    switch ((title || "").toLowerCase()) {
+        case "created":
+            return (0, jsx_runtime_1.jsx)(lucide_react_1.Plus, { size: size });
+        case "updated":
+            return (0, jsx_runtime_1.jsx)(lucide_react_1.PencilLine, { size: size });
+        case "delete":
+        case "deleted":
+            return (0, jsx_runtime_1.jsx)(lucide_react_1.Trash2, { size: size });
+        default:
+            return null;
+    }
+};
+// Source icon (where it came from) — preserves the original mapping.
+const getSourceIcon = (event, size) => {
+    switch (event.action_from) {
+        case "Accounts":
+            return (0, jsx_runtime_1.jsx)(lucide_react_1.IndianRupee, { size: size });
+        case "Notes":
+            return (0, jsx_runtime_1.jsx)(lucide_react_1.FileText, { size: size });
+        default:
+            return (0, jsx_runtime_1.jsx)(lucide_react_1.Volleyball, { size: size });
+    }
+};
+const getIcon = (event, size) => { var _a, _b; return (_b = (_a = event.icon) !== null && _a !== void 0 ? _a : getActionIcon(event.title, size)) !== null && _b !== void 0 ? _b : getSourceIcon(event, size); };
+const formatName = (name) => name
+    .split("_")
+    .filter(Boolean)
+    .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+    .join(" ");
+const REVEAL_TRANSITION = (0, motion_1.transitionFor)(["opacity"]);
+const MIN_TEXT = "0.6875rem";
+const groupEventsByDate = (events) => events.reduce((groups, event, globalIndex) => {
+    const date = formatTimestamp(event.created_at, "date");
+    if (date !== "Invalid Date") {
+        if (!groups[date])
+            groups[date] = [];
+        groups[date].push({ event, globalIndex });
+    }
+    return groups;
+}, {});
+const parseChanges = (changes) => {
+    if (!changes || changes === "null")
+        return [];
+    try {
+        const parsed = typeof changes === "string" ? JSON.parse(changes) : changes;
+        if (typeof parsed !== "object" || parsed === null)
+            return [];
+        return Object.entries(parsed).map(([key, value]) => {
+            var _a;
+            const record = value;
+            return {
+                field: key,
+                from: (_a = record === null || record === void 0 ? void 0 : record.original) !== null && _a !== void 0 ? _a : null,
+                to: record === null || record === void 0 ? void 0 : record.updated,
+            };
+        });
+    }
+    catch (error) {
+        console.error("Error parsing changes:", error);
+        return [];
+    }
+};
+const initials = (name) => (name || "")
+    .trim()
+    .split(/\s+/)
+    .map((p) => p[0])
+    .slice(0, 2)
+    .join("")
+    .toUpperCase() || "?";
+const CARD_TRANSITION = (0, motion_1.transitionFor)(["border-color", "box-shadow", "transform"]);
+const NODE = "1.875rem"; // 30px node, centered on the spine
+const NODE_RADIUS = "0.9375rem";
+const SPINE_GAP = "1.75rem"; // gap between spine and card edge
+// Cheap alternative to windowing: off-screen cards skip layout and paint.
+const OFFSCREEN_SKIP = {
+    contentVisibility: "auto",
+    containIntrinsicSize: "0 96px",
+};
+// A single manual note attached to a log — read view + edit/delete on hover or focus,
+// swapping to an inline NoteTextArea while editing.
+// Declared at module scope: inside Timeline's body it remounts every note on each render.
+const NoteItem = react_2.default.memo(function NoteItem({ note, event, index, colors, activeEditNoteId, setActiveEditNoteId, editNoteLoading, deletingNoteId, onEditNote, onDeleteNote, }) {
+    var _a, _b;
+    const isEditing = activeEditNoteId === note.log_note_id;
+    const isDeleting = deletingNoteId != null && deletingNoteId === note.log_note_id;
+    const noteBox = (0, planeStep_1.bandOn)(colors.gray[50], colors.background[50]);
+    const noteChip = (0, planeStep_1.bandOn)(colors.primary[50], noteBox);
+    const noteChipInk = (0, accentText_1.accentTextOnCanvas)(colors.primary, noteChip);
+    const chipHover = (0, planeStep_1.bandOn)(colors.primary[100], noteChip);
+    const chipHoverInk = (0, accentText_1.accentTextOnCanvas)(colors.primary, chipHover);
+    if (isEditing) {
+        return ((0, jsx_runtime_1.jsx)(react_1.Box, { children: (0, jsx_runtime_1.jsx)(NoteTextArea_1.default, { isEditable: true, value: (_a = note.note) !== null && _a !== void 0 ? _a : "", title: (_b = note.title) !== null && _b !== void 0 ? _b : "", saveButtonLoading: editNoteLoading, handleSubmit: (n, t, f) => onEditNote === null || onEditNote === void 0 ? void 0 : onEditNote(note.log_note_id, n, t, f, event, index), handleCancel: () => setActiveEditNoteId(null) }) }));
+    }
+    return ((0, jsx_runtime_1.jsxs)(react_1.Box, { position: "relative", zIndex: 1, bg: noteBox, border: `${borderWidths_1.BORDER_WIDTHS.hairline} solid ${(0, planeStep_1.cardRule)(colors)}`, borderRadius: "lg", px: 2.5, py: 2, opacity: isDeleting ? 0.6 : 1, _hover: { ".timeline-note-actions": { opacity: 1 } }, _focusWithin: { ".timeline-note-actions": { opacity: 1 } }, children: [(0, jsx_runtime_1.jsxs)(react_1.Flex, { align: "center", gap: 1.5, mb: note.note ? 1 : 0, children: [(0, jsx_runtime_1.jsx)(react_1.Box, { as: "span", color: (0, accentText_1.accentTextOnCanvas)(colors.primary, noteBox), display: "inline-flex", children: (0, jsx_runtime_1.jsx)(lucide_react_1.StickyNote, { size: 12 }) }), note.title && ((0, jsx_runtime_1.jsx)(react_1.Text, { fontSize: typography_1.fontSizes["xs-minus"], fontWeight: 700, color: colors.text[800], noOfLines: 1, children: note.title })), (onEditNote || onDeleteNote) && ((0, jsx_runtime_1.jsx)(react_1.Flex, { className: "timeline-note-actions", align: "center", gap: 0.5, ml: "auto", flexShrink: 0, opacity: isDeleting ? 1 : 0, transition: REVEAL_TRANSITION, sx: (0, motion_2.reducedMotionSx)(), children: isDeleting ? ((0, jsx_runtime_1.jsx)(react_1.Spinner, { size: "xs", color: colors.textMuted })) : ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [onEditNote && ((0, jsx_runtime_1.jsx)(react_1.Tooltip, { label: "Edit", placement: "top", hasArrow: true, children: (0, jsx_runtime_1.jsx)(react_1.Box, { as: "button", type: "button", "aria-label": "Edit note", sx: (0, focusRing_styles_1.focusVisibleStyles)(colors), display: "inline-flex", alignItems: "center", justifyContent: "center", p: 1, borderRadius: "md", color: colors.textMuted, bg: "transparent", cursor: "pointer", _hover: {
+                                            bg: noteChip,
+                                            color: noteChipInk,
+                                        }, onClick: (e) => {
+                                            e.stopPropagation();
+                                            setActiveEditNoteId(note.log_note_id);
+                                        }, children: (0, jsx_runtime_1.jsx)(lucide_react_1.Pencil, { size: 12 }) }) })), onDeleteNote && ((0, jsx_runtime_1.jsx)(react_1.Tooltip, { label: "Delete", placement: "top", hasArrow: true, children: (0, jsx_runtime_1.jsx)(react_1.Box, { as: "button", type: "button", "aria-label": "Delete note", sx: (0, focusRing_styles_1.focusVisibleStyles)(colors), display: "inline-flex", alignItems: "center", justifyContent: "center", p: 1, borderRadius: "md", color: colors.textMuted, bg: "transparent", cursor: "pointer", _hover: {
+                                            bg: colors.semantic.error[50],
+                                            color: (0, accentText_1.accentTextOnCanvas)(colors.semantic.error, colors.semantic.error[50]),
+                                        }, onClick: (e) => {
+                                            e.stopPropagation();
+                                            onDeleteNote === null || onDeleteNote === void 0 ? void 0 : onDeleteNote(note.log_note_id, event, index);
+                                        }, children: (0, jsx_runtime_1.jsx)(lucide_react_1.Trash2, { size: 12 }) }) }))] })) }))] }), note.note && ((0, jsx_runtime_1.jsx)(react_1.Text, { fontSize: typography_1.fontSizes["xs-minus"], color: colors.text[700], whiteSpace: "pre-wrap", children: note.note })), note.attachments && note.attachments.length > 0 && ((0, jsx_runtime_1.jsx)(react_1.Flex, { wrap: "wrap", gap: 1.5, mt: 1.5, children: note.attachments.map((att, attIndex) => ((0, jsx_runtime_1.jsxs)(react_1.Flex, { as: "a", href: att.url, target: "_blank", rel: "noopener noreferrer", onClick: (e) => e.stopPropagation(), align: "center", gap: 1, px: 1.5, py: 0.5, borderRadius: "full", bg: noteChip, color: noteChipInk, fontSize: MIN_TEXT, maxW: "100%", _hover: { bg: chipHover, color: chipHoverInk }, children: [(0, jsx_runtime_1.jsx)(lucide_react_1.Paperclip, { size: 10 }), (0, jsx_runtime_1.jsx)(react_1.Box, { as: "span", noOfLines: 1, maxW: "9rem", children: att.name || "attachment" })] }, attIndex))) })), (note.created_by || note.created_at) && ((0, jsx_runtime_1.jsxs)(react_1.Text, { fontSize: MIN_TEXT, color: colors.textMuted, mt: 1, children: [note.created_by ? formatName(note.created_by) : "", note.created_by && note.created_at ? " · " : "", note.created_at ? formatTimestamp(note.created_at, "time") : ""] }))] }));
+});
+// The colored event card (shared by both the desktop "tree" and mobile rail).
+// `accent` decides which edge carries the colored bar (pointing toward the spine).
+// Declared at module scope: inside Timeline's body it remounts every card on each render.
+const EventCard = react_2.default.memo(function EventCard({ event, index, accent, colors, isActiveNote, setActiveNoteEventIndex, activeEditNoteId, setActiveEditNoteId, showAddNote, addNoteLoading, editNoteLoading, deletingNoteId, onEventClick, onAddNote, onEditNote, onDeleteNote, }) {
+    const scale = getEventScale(colors, event.title);
+    const changes = (0, react_3.useMemo)(() => parseChanges(event.changes), [event.changes]);
+    const clickable = typeof onEventClick === "function";
+    const actor = formatName(event.action_by);
+    const addNoteHover = (0, planeStep_1.bandOn)(colors.primary[50], colors.background[50]);
+    const changeFromFill = (0, planeStep_1.bandOn)(colors.gray[50], colors.background[50]);
+    return ((0, jsx_runtime_1.jsxs)(react_1.Box, { _hover: { ".timeline-add-note": { opacity: 1 } }, _focusWithin: { ".timeline-add-note": { opacity: 1 } }, children: [(0, jsx_runtime_1.jsxs)(react_1.Box, { position: "relative", zIndex: 1, bg: colors.background[50], border: `${borderWidths_1.BORDER_WIDTHS.hairline} solid ${colors.boxborder[200]}`, borderInlineStartWidth: accent === "left" ? "0.1875rem" : undefined, borderInlineEndWidth: accent === "right" ? "0.1875rem" : undefined, borderInlineStartColor: accent === "left" ? scale[400] : undefined, borderInlineEndColor: accent === "right" ? scale[400] : undefined, borderRadius: "xl", px: 3.5, py: 2.5, ...(clickable && {
+                    transition: CARD_TRANSITION,
+                    _hover: {
+                        borderColor: scale[300],
+                        boxShadow: "md",
+                        transform: "translateY(-1px)",
+                    },
+                    sx: (0, motion_2.reducedMotionSx)({ transform: "none" }),
+                }), children: [clickable && ((0, jsx_runtime_1.jsx)(react_1.Box, { as: "button", type: "button", "aria-label": `View details${event.action_from ? ` for ${event.action_from}` : ""}`, onClick: () => onEventClick(event, index), position: "absolute", inset: 0, w: "100%", h: "100%", p: 0, m: 0, bg: "transparent", border: "none", borderRadius: "inherit", cursor: "pointer", zIndex: 0, sx: (0, focusRing_styles_1.focusVisibleStyles)(colors) })), (0, jsx_runtime_1.jsxs)(react_1.Flex, { align: "center", justify: "space-between", gap: 2, flexWrap: "wrap", children: [(0, jsx_runtime_1.jsxs)(react_1.Flex, { align: "center", gap: 2, minW: 0, children: [(0, jsx_runtime_1.jsx)(react_1.Text, { fontSize: typography_1.fontSizes["xs-plus"], fontWeight: 600, color: colors.text[800], noOfLines: 1, children: event.action_from }), (0, jsx_runtime_1.jsx)(react_1.Box, { as: "span", fontSize: typography_1.fontSizes["xs-minus"], fontWeight: 600, lineHeight: "1", textTransform: "capitalize", color: (0, accentText_1.accentTextOnCanvas)(scale, scale[50]), bg: scale[50], border: `${borderWidths_1.BORDER_WIDTHS.hairline} solid ${scale[200]}`, borderRadius: "full", px: 2, py: 1, children: event.title })] }), (0, jsx_runtime_1.jsx)(react_1.Text, { fontSize: typography_1.fontSizes["xs-minus"], color: colors.textMuted, whiteSpace: "nowrap", children: formatTimestamp(event.created_at, "time") })] }), event.description != null && ((0, jsx_runtime_1.jsx)(react_1.Box, { mt: 1.5, fontSize: typography_1.fontSizes.xs, color: colors.text[700], children: event.description })), changes.length > 0 && ((0, jsx_runtime_1.jsx)(react_1.Flex, { direction: "column", gap: 1, mt: 2, children: changes.map((c, i) => ((0, jsx_runtime_1.jsxs)(react_1.Flex, { align: "center", gap: 1.5, fontSize: typography_1.fontSizes["xs-minus"], lineHeight: "1.4", flexWrap: "wrap", children: [(0, jsx_runtime_1.jsx)(react_1.Text, { fontWeight: 600, color: colors.text[700], children: (0, functions_1.toWords)(c.field) }), c.from !== null && c.from !== undefined && ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)(react_1.Box, { as: "span", color: (0, accentText_1.accentTextOnCanvas)(colors.gray, changeFromFill), bg: changeFromFill, borderRadius: "full", px: 1.5, textDecoration: "line-through", maxW: "10rem", overflow: "hidden", textOverflow: "ellipsis", whiteSpace: "nowrap", children: String(c.from) }), (0, jsx_runtime_1.jsx)(react_1.Box, { as: "span", color: colors.textMuted, display: "inline-flex", children: (0, jsx_runtime_1.jsx)(lucide_react_1.ArrowRight, { size: 11 }) })] })), (0, jsx_runtime_1.jsx)(react_1.Box, { as: "span", color: (0, accentText_1.accentTextOnCanvas)(colors.semantic.success, colors.semantic.success[50]), bg: colors.semantic.success[50], borderRadius: "full", px: 1.5, maxW: "12rem", overflow: "hidden", textOverflow: "ellipsis", whiteSpace: "nowrap", children: String(c.to) })] }, `${c.field}-${i}`))) })), (0, jsx_runtime_1.jsxs)(react_1.Flex, { align: "center", justify: "space-between", gap: 2, mt: 2, children: [(0, jsx_runtime_1.jsxs)(react_1.Flex, { align: "center", gap: 2, children: [(0, jsx_runtime_1.jsx)(react_1.Tooltip, { label: actor, placement: "top", hasArrow: true, children: (0, jsx_runtime_1.jsx)(react_1.Flex, { align: "center", justify: "center", boxSize: "1.5rem", minW: "1.5rem", borderRadius: "full", bg: colors.primary.opacity[16], color: (0, accentText_1.accentTextOnCanvas)(colors.primary, colors.background[50]), fontSize: MIN_TEXT, fontWeight: 700, children: initials(actor) }) }), (0, jsx_runtime_1.jsxs)(react_1.Text, { fontSize: typography_1.fontSizes["xs-minus"], color: colors.textMuted, children: ["by", " ", (0, jsx_runtime_1.jsx)(react_1.Box, { as: "span", color: colors.text[700], fontWeight: 500, children: actor })] })] }), showAddNote && ((0, jsx_runtime_1.jsx)(react_1.Box, { className: "timeline-add-note", as: "button", type: "button", onClick: (e) => {
+                                    e.stopPropagation();
+                                    setActiveNoteEventIndex(isActiveNote ? null : index);
+                                }, position: "relative", zIndex: 1, opacity: isActiveNote ? 1 : 0, transition: REVEAL_TRANSITION, sx: { ...(0, focusRing_styles_1.focusVisibleStyles)(colors), ...(0, motion_2.reducedMotionSx)() }, px: 2, py: 1, borderRadius: "md", fontSize: typography_1.fontSizes.xs, fontWeight: 600, color: (0, accentText_1.accentTextOnCanvas)(colors.primary, colors.background[50]), bg: "transparent", cursor: "pointer", _hover: {
+                                    bg: addNoteHover,
+                                    color: addNoteHover === colors.primary[50]
+                                        ? undefined
+                                        : (0, accentText_1.accentTextOnCanvas)(colors.primary, addNoteHover),
+                                }, children: isActiveNote ? "Hide note" : "Add note" }))] }), event.notes && event.notes.length > 0 && ((0, jsx_runtime_1.jsx)(react_1.Flex, { direction: "column", gap: 2, mt: 2, pt: 2, borderTop: `${borderWidths_1.BORDER_WIDTHS.hairline} solid ${(0, planeStep_1.cardRule)(colors)}`, children: event.notes.map((note, noteIndex) => {
+                            var _a;
+                            return ((0, jsx_runtime_1.jsx)(NoteItem, { note: note, event: event, index: index, colors: colors, activeEditNoteId: activeEditNoteId, setActiveEditNoteId: setActiveEditNoteId, editNoteLoading: editNoteLoading, deletingNoteId: deletingNoteId, onEditNote: onEditNote, onDeleteNote: onDeleteNote }, (_a = note.log_note_id) !== null && _a !== void 0 ? _a : noteIndex));
+                        }) }))] }), isActiveNote && ((0, jsx_runtime_1.jsx)(react_1.Box, { mt: 2, children: (0, jsx_runtime_1.jsx)(NoteTextArea_1.default, { saveButtonLoading: addNoteLoading, handleSubmit: (note, title, files) => {
+                        onAddNote === null || onAddNote === void 0 ? void 0 : onAddNote(note, title, files, event, index);
+                        // When the consumer wires addNoteLoading, the effect closes the
+                        // editor on completion; otherwise close immediately.
+                        if (addNoteLoading === undefined)
+                            setActiveNoteEventIndex(null);
+                    }, handleCancel: () => setActiveNoteEventIndex(null) }) }))] }));
+});
+/** Renders a grouped, alternating two-column desktop / single-rail mobile event feed with inline notes — not a generic list. */
+const Timeline = ({ timelineEvents, onEventClick, onAddNote, onEditNote, onDeleteNote, showAddNote = false, addNoteLoading, editNoteLoading, deletingNoteId, emptyText = "No timeline events to display", }) => {
+    const { colors } = (0, useCustomTheme_1.useCustomTheme)();
+    const isMobile = (0, react_1.useBreakpointValue)({ base: true, md: false });
+    const [activeNoteEventIndex, setActiveNoteEventIndex] = (0, react_3.useState)(null);
+    const [activeEditNoteId, setActiveEditNoteId] = (0, react_3.useState)(null);
+    // Auto-close the add editor once the create request finishes (true -> false).
+    const prevAddLoading = (0, react_3.useRef)(addNoteLoading);
+    (0, react_3.useEffect)(() => {
+        if (prevAddLoading.current && !addNoteLoading) {
+            setActiveNoteEventIndex(null);
         }
-    };
-    var getEventBgColor = function (title) {
-        var _a, _b, _c, _d, _e, _f, _g;
-        switch (title.toLowerCase()) {
-            case "created":
-                return (_b = (_a = theme.colors) === null || _a === void 0 ? void 0 : _a.green) === null || _b === void 0 ? void 0 : _b[50];
-            case "updated":
-                return (_d = (_c = theme.colors) === null || _c === void 0 ? void 0 : _c.yellow) === null || _d === void 0 ? void 0 : _d[50];
-            case "delete":
-                return (_f = (_e = theme.colors) === null || _e === void 0 ? void 0 : _e.red) === null || _f === void 0 ? void 0 : _f[50];
-            default:
-                return (_g = theme.colors) === null || _g === void 0 ? void 0 : _g.white;
+        prevAddLoading.current = addNoteLoading;
+    }, [addNoteLoading]);
+    // Auto-close the edit editor once the update request finishes.
+    const prevEditLoading = (0, react_3.useRef)(editNoteLoading);
+    (0, react_3.useEffect)(() => {
+        if (prevEditLoading.current && !editNoteLoading) {
+            setActiveEditNoteId(null);
         }
-    };
+        prevEditLoading.current = editNoteLoading;
+    }, [editNoteLoading]);
+    const groupedEvents = (0, react_3.useMemo)(() => groupEventsByDate(timelineEvents !== null && timelineEvents !== void 0 ? timelineEvents : []), [timelineEvents]);
     if (!timelineEvents || timelineEvents.length === 0) {
-        return (react_1.default.createElement(react_2.Box, { textAlign: "center", py: 8, color: (_c = (_b = theme.colors) === null || _b === void 0 ? void 0 : _b.gray) === null || _c === void 0 ? void 0 : _c[500] },
-            react_1.default.createElement(react_2.Text, null, "No timeline events to display")));
+        return ((0, jsx_runtime_1.jsxs)(react_1.Flex, { direction: "column", align: "center", justify: "center", py: 12, gap: 2, color: colors.textMuted, children: [(0, jsx_runtime_1.jsx)(react_1.Box, { boxSize: "2.75rem", borderRadius: "full", bg: colors.gray[100], display: "flex", alignItems: "center", justifyContent: "center", color: (0, accentText_1.accentTextOnCanvas)(colors.gray, colors.gray[100]), children: (0, jsx_runtime_1.jsx)(lucide_react_1.Volleyball, { size: 20 }) }), (0, jsx_runtime_1.jsx)(react_1.Text, { fontSize: typography_1.fontSizes.sm, fontWeight: 500, children: emptyText })] }));
+    }
+    // -------------------------------------------------------------------------
+    // Mobile: single left rail (alternating doesn't read well on narrow widths)
+    // -------------------------------------------------------------------------
+    if (isMobile) {
+        return ((0, jsx_runtime_1.jsx)(react_1.Box, { position: "relative", maxW: "100%", px: 2, py: 2, children: Object.keys(groupedEvents).map((date) => ((0, jsx_runtime_1.jsxs)(react_1.Box, { mb: 2, children: [(0, jsx_runtime_1.jsxs)(react_1.Flex, { align: "center", gap: 3, mb: 4, mt: 2, children: [(0, jsx_runtime_1.jsx)(react_1.Text, { fontSize: typography_1.fontSizes.xs, fontWeight: 600, textTransform: "uppercase", letterSpacing: "0.02em", color: (0, accentText_1.accentTextOnCanvas)(colors.gray, colors.gray[50]), bg: colors.gray[50], border: `${borderWidths_1.BORDER_WIDTHS.hairline} solid ${colors.boxborder[200]}`, borderRadius: "full", px: 3, py: 1, whiteSpace: "nowrap", children: date }), (0, jsx_runtime_1.jsx)(react_1.Box, { flex: "1", h: borderWidths_1.BORDER_WIDTHS.hairline, bg: colors.boxborder[200] })] }), (0, jsx_runtime_1.jsxs)(react_1.Box, { position: "relative", children: [(0, jsx_runtime_1.jsx)(react_1.Box, { position: "absolute", left: NODE_RADIUS, top: "0.5rem", bottom: "0.5rem", w: "0.1875rem", borderRadius: "full", bg: (0, outlineRung_1.liftToContrast)(colors.gray[300], colors.backgroundColor.main, outlineRung_1.AA_NON_TEXT), transform: "translateX(-50%)" }), groupedEvents[date].map(({ event, globalIndex }, index) => {
+                                var _a;
+                                const scale = getEventScale(colors, event.title);
+                                return ((0, jsx_runtime_1.jsxs)(react_1.Flex, { align: "flex-start", gap: 3, mb: index === groupedEvents[date].length - 1 ? 0 : 3, sx: OFFSCREEN_SKIP, children: [(0, jsx_runtime_1.jsx)(react_1.Flex, { align: "center", justify: "center", boxSize: NODE, minW: NODE, borderRadius: "full", bg: scale[50], color: (0, accentText_1.accentTextOnCanvas)(scale, scale[50]), border: `0.125rem solid ${colors.background[50]}`, boxShadow: `0 0 0 ${borderWidths_1.BORDER_WIDTHS.hairline} ${scale[200]}`, zIndex: 1, children: getIcon(event, 14) }), (0, jsx_runtime_1.jsx)(react_1.Box, { flex: "1", minW: 0, children: (0, jsx_runtime_1.jsx)(EventCard, { event: event, index: globalIndex, accent: "left", colors: colors, isActiveNote: activeNoteEventIndex === globalIndex, setActiveNoteEventIndex: setActiveNoteEventIndex, activeEditNoteId: activeEditNoteId, setActiveEditNoteId: setActiveEditNoteId, showAddNote: showAddNote, addNoteLoading: addNoteLoading, editNoteLoading: editNoteLoading, deletingNoteId: deletingNoteId, onEventClick: onEventClick, onAddNote: onAddNote, onEditNote: onEditNote, onDeleteNote: onDeleteNote }) })] }, `${(_a = event.logs_id) !== null && _a !== void 0 ? _a : date}-${index}`));
+                            })] })] }, date))) }));
     }
-    return (react_1.default.createElement(react_2.Box, { position: "relative", px: { base: 3, md: 6 }, maxW: { base: "100%", md: "50rem" }, mx: "auto" },
-        react_1.default.createElement(react_2.Box, { position: "absolute", left: { base: "1.5rem", md: "50%" }, top: 0, bottom: 0, w: "0.125rem", bg: (_e = (_d = theme.colors) === null || _d === void 0 ? void 0 : _d.gray) === null || _e === void 0 ? void 0 : _e[300], transform: { md: "translateX(-50%)" } }),
-        Object.keys(groupedEvents).map(function (date) {
-            var _a, _b, _c, _d, _e;
-            return (react_1.default.createElement(react_2.Box, { key: date, mb: 4 },
-                react_1.default.createElement(react_2.Flex, { justify: "center", mb: 4 },
-                    react_1.default.createElement(react_2.Box, { fontSize: { base: "0.875rem", md: "1rem" }, fontWeight: "400", color: (_a = theme.colors) === null || _a === void 0 ? void 0 : _a.black, bg: (_c = (_b = theme.colors) === null || _b === void 0 ? void 0 : _b.gray) === null || _c === void 0 ? void 0 : _c[50], border: "0.063rem solid ".concat((_e = (_d = theme.colors) === null || _d === void 0 ? void 0 : _d.gray) === null || _e === void 0 ? void 0 : _e[300]), borderRadius: "0.313rem", px: { base: 2, md: 6 }, py: 1, textAlign: "center", zIndex: 1 }, date)),
-                groupedEvents[date].map(function (event, index) {
-                    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x;
-                    var isLeft = index % 2 === 0;
-                    return (react_1.default.createElement(react_2.Box, { key: "".concat(date, "-").concat(index), mb: 4, position: "relative" }, isMobile ? (react_1.default.createElement(react_2.Flex, { align: "flex-start", gap: 3 },
-                        react_1.default.createElement(react_2.Box, { w: "1.5rem", h: "1.5rem", bg: (_b = (_a = theme.colors) === null || _a === void 0 ? void 0 : _a.gray) === null || _b === void 0 ? void 0 : _b[50], borderRadius: "full", border: "0.063rem solid ".concat((_d = (_c = theme.colors) === null || _c === void 0 ? void 0 : _c.gray) === null || _d === void 0 ? void 0 : _d[300]), display: "flex", alignItems: "center", justifyContent: "center", flexShrink: 0, mt: 0.5 }, getIcon(event)),
-                        react_1.default.createElement(react_2.Box, { flex: "1" },
-                            react_1.default.createElement(react_2.Flex, { align: "center", gap: 2, mb: 1 },
-                                react_1.default.createElement(react_2.Text, { fontSize: "0.75rem", color: (_f = (_e = theme.colors) === null || _e === void 0 ? void 0 : _e.gray) === null || _f === void 0 ? void 0 : _f[500], minW: "3.5rem" }, formatTimestamp(event.created_at, "time")),
-                                react_1.default.createElement(react_2.Text, { fontSize: "0.75rem", fontWeight: "medium", color: (_h = (_g = theme.colors) === null || _g === void 0 ? void 0 : _g.gray) === null || _h === void 0 ? void 0 : _h[700] },
-                                    event.action_from,
-                                    " ",
-                                    event.title),
-                                react_1.default.createElement(react_2.Tooltip, { label: formatChanges(event.changes), placement: "top", hasArrow: true },
-                                    react_1.default.createElement(react_2.Box, { cursor: "pointer" },
-                                        react_1.default.createElement(lucide_react_1.Info, { size: 12 })))),
-                            react_1.default.createElement(react_2.Text, { fontSize: "0.7rem", color: (_k = (_j = theme.colors) === null || _j === void 0 ? void 0 : _j.gray) === null || _k === void 0 ? void 0 : _k[500] },
-                                "by ",
-                                (0, functions_1.toWords)(event.action_by))))) : (
-                    // Desktop Layout
-                    react_1.default.createElement(react_2.Flex, { justify: isLeft ? "flex-start" : "flex-end", align: "flex-start", position: "relative" },
-                        react_1.default.createElement(react_2.Box, { position: "absolute", left: isLeft ? "auto" : "calc(50% + 0.938rem)", right: isLeft ? "calc(50% + 0.938rem)" : "auto", top: "0.938rem", width: isLeft ? "calc(50% - 4rem)" : "calc(50% - 4rem)", height: "0.125rem", bg: (_m = (_l = theme.colors) === null || _l === void 0 ? void 0 : _l.gray) === null || _m === void 0 ? void 0 : _m[300], zIndex: 0 }),
-                        react_1.default.createElement(react_2.Box, { position: "absolute", left: "50%", transform: "translateX(-50%)", w: "1.875rem", h: "1.875rem", bg: (_p = (_o = theme.colors) === null || _o === void 0 ? void 0 : _o.gray) === null || _p === void 0 ? void 0 : _p[50], borderRadius: "full", border: "0.063rem solid ".concat((_r = (_q = theme.colors) === null || _q === void 0 ? void 0 : _q.gray) === null || _r === void 0 ? void 0 : _r[300]), display: "flex", alignItems: "center", justifyContent: "center", zIndex: 2 }, getIcon(event)),
-                        react_1.default.createElement(react_2.Box, { bg: getEventBgColor(event.title), border: "0.063rem solid ".concat((_t = (_s = theme.colors) === null || _s === void 0 ? void 0 : _s.gray) === null || _t === void 0 ? void 0 : _t[300]), borderRadius: "0.5rem", px: 4, py: 2, maxW: "16rem", boxShadow: "sm", zIndex: 1, ml: isLeft ? 0 : "50%", mr: isLeft ? "50%" : 0, width: "calc(50% - 2rem)", position: "relative" },
-                            react_1.default.createElement(react_2.Flex, { align: "center", justify: "space-between", mb: 1 },
-                                react_1.default.createElement(react_2.Text, { fontSize: "0.875rem", fontWeight: "medium" },
-                                    event.action_from,
-                                    " ",
-                                    event.title),
-                                react_1.default.createElement(react_2.Tooltip, { label: formatChanges(event.changes), placement: "top", hasArrow: true },
-                                    react_1.default.createElement(react_2.Box, { ml: 1, cursor: "pointer" },
-                                        react_1.default.createElement(lucide_react_1.Info, { size: 14 })))),
-                            react_1.default.createElement(react_2.Text, { fontSize: "0.75rem", color: (_v = (_u = theme.colors) === null || _u === void 0 ? void 0 : _u.gray) === null || _v === void 0 ? void 0 : _v[500] },
-                                "by ",
-                                (0, functions_1.toWords)(event.action_by)),
-                            react_1.default.createElement(react_2.Text, { fontSize: "0.75rem", color: (_x = (_w = theme.colors) === null || _w === void 0 ? void 0 : _w.gray) === null || _x === void 0 ? void 0 : _x[500] }, formatTimestamp(event.created_at, "time")))))));
-                })));
-        })));
+    // -------------------------------------------------------------------------
+    // Desktop: center spine with cards alternating left / right (the "tree")
+    // -------------------------------------------------------------------------
+    return ((0, jsx_runtime_1.jsxs)(react_1.Box, { position: "relative", maxW: "60rem", mx: "auto", px: 4, py: 2, children: [(0, jsx_runtime_1.jsx)(react_1.Box, { position: "absolute", left: "50%", top: "0.5rem", bottom: "0.5rem", w: "0.015rem", borderRadius: "full", bg: (0, outlineRung_1.liftToContrast)(colors.gray[300], colors.backgroundColor.main, outlineRung_1.AA_NON_TEXT), transform: "translateX(-50%)" }), Object.keys(groupedEvents).map((date) => ((0, jsx_runtime_1.jsxs)(react_1.Box, { mb: 2, children: [(0, jsx_runtime_1.jsx)(react_1.Flex, { justify: "center", mb: 5, mt: 3, position: "relative", zIndex: 2, children: (0, jsx_runtime_1.jsx)(react_1.Text, { fontSize: typography_1.fontSizes.xs, fontWeight: 600, textTransform: "uppercase", letterSpacing: "0.02em", color: colors.textMuted, bg: colors.background[50], border: `${borderWidths_1.BORDER_WIDTHS.hairline} solid ${colors.boxborder[200]}`, boxShadow: "xs", borderRadius: "full", px: 4, py: 1.5, whiteSpace: "nowrap", children: date }) }), groupedEvents[date].map(({ event, globalIndex }, index) => {
+                        var _a;
+                        const isLeft = index % 2 === 0;
+                        const scale = getEventScale(colors, event.title);
+                        return ((0, jsx_runtime_1.jsxs)(react_1.Box, { position: "relative", mb: index === groupedEvents[date].length - 1 ? 0 : 5, minH: NODE, sx: OFFSCREEN_SKIP, children: [(0, jsx_runtime_1.jsx)(react_1.Box, { position: "absolute", top: "1.375rem", h: "0.125rem", w: "0.8125rem", bg: scale[300], left: isLeft
+                                        ? `calc(50% - ${SPINE_GAP})`
+                                        : `calc(50% + ${NODE_RADIUS})`, zIndex: 0 }), (0, jsx_runtime_1.jsx)(react_1.Flex, { position: "absolute", left: "50%", top: "0.5rem", transform: "translateX(-50%)", align: "center", justify: "center", boxSize: NODE, borderRadius: "full", bg: scale[50], color: (0, accentText_1.accentTextOnCanvas)(scale, scale[50]), border: `0.125rem solid ${colors.background[50]}`, boxShadow: `0 0 0 ${borderWidths_1.BORDER_WIDTHS.hairline} ${scale[200]}`, zIndex: 2, children: getIcon(event, 15) }), (0, jsx_runtime_1.jsx)(react_1.Box, { position: "relative", zIndex: 1, w: `calc(50% - ${SPINE_GAP})`, ml: isLeft ? 0 : `calc(50% + ${SPINE_GAP})`, children: (0, jsx_runtime_1.jsx)(EventCard, { event: event, index: globalIndex, accent: isLeft ? "right" : "left", colors: colors, isActiveNote: activeNoteEventIndex === globalIndex, setActiveNoteEventIndex: setActiveNoteEventIndex, activeEditNoteId: activeEditNoteId, setActiveEditNoteId: setActiveEditNoteId, showAddNote: showAddNote, addNoteLoading: addNoteLoading, editNoteLoading: editNoteLoading, deletingNoteId: deletingNoteId, onEventClick: onEventClick, onAddNote: onAddNote, onEditNote: onEditNote, onDeleteNote: onDeleteNote }) })] }, `${(_a = event.logs_id) !== null && _a !== void 0 ? _a : date}-${index}`));
+                    })] }, date)))] }));
 };
 exports.default = Timeline;

package/dist/Components/Timeline/TimelineProps.d.ts

@@ -1,20 +1,82 @@
+import type { ReactNode } from "react";
+/** Config + event data for Timeline's grouped feed; onEventClick/onAddNote/onEditNote/onDeleteNote are all optional so the feed can be read-only. */
 export interface TimelineProps {
+    /** @deprecated Never read — use `timelineEvents`; passing `events` renders nothing. */
     events?: TimelineEvent[];
+    /** Grouped by `created_at` day in array order — never sorted, so pass it pre-sorted. */
     timelineEvents: TimelineEvents[];
+    /** Makes each card a button with hover lift and focus ring; without it cards are static. */
     onEventClick?: (event: TimelineEvents, index: number) => void;
+    /** `index` is the event's position in `timelineEvents`; editor closes at once unless `addNoteLoading` is wired. */
+    onAddNote?: (note: string, title: string, files: File[], event: TimelineEvents, index: number) => void;
+    /** Unlike onAddNote, the edit editor only auto-closes via editNoteLoading flipping true→false — omit it and Save never closes the form. */
+    onEditNote?: (logNoteId: number, note: string, title: string, files: File[], event: TimelineEvents, index: number) => void;
+    /** Fires immediately on the trash icon — no confirm step; add your own if needed. */
+    onDeleteNote?: (logNoteId: number, event: TimelineEvents, index: number) => void;
+    /** Defaults to false; the "Add note" button only appears on card hover or focus. */
+    showAddNote?: boolean;
+    /** Spinner on the "Add note" editor while the create request is in flight. */
+    addNoteLoading?: boolean;
+    /** Spinner on the open note editor while the update request is in flight. */
+    editNoteLoading?: boolean;
+    /** log_note_id currently being deleted — shows a spinner on that note. */
+    deletingNoteId?: number | string | null;
+    /** Message shown when `timelineEvents` is empty. Defaults to "No timeline events to display". */
+    emptyText?: ReactNode;
 }
+/** @deprecated Shape of the dead `events` prop — Timeline renders `TimelineEvents` (plural). */
 export interface TimelineEvent {
     title: string;
     description: string;
     time: string;
 }
+/** A file attached to a manual timeline note; size is captured but never read or displayed. */
+export interface TimelineNoteAttachment {
+    /** Link target, opened in a new tab; clicks do not trigger the card's `onEventClick`. */
+    url: string;
+    /** Link text; defaults to "attachment". */
+    name?: string;
+    size?: number | null;
+}
+/** One manual note attached to a log entry; log_note_id doubles as the React key and the edit/delete target. */
+export interface TimelineNote {
+    /** Unique note id passed back to `onEditNote` and `onDeleteNote`. */
+    log_note_id: number;
+    /** @deprecated Never read — the parent event already identifies the log. */
+    logs_id?: number;
+    /** Bold note heading; omitted when empty. */
+    title?: string | null;
+    /** Note body, rendered with line breaks preserved; omitted when empty. */
+    note?: string | null;
+    /** Rendered as link chips under the body. */
+    attachments?: TimelineNoteAttachment[] | null;
+    /** Epoch ms (number or digit string) or any `Date`-parseable string. */
+    created_at?: number | string | null;
+    /** Underscores become spaces and each word is capitalised, e.g. `john_doe` → "John Doe". */
+    created_by?: string | null;
+}
+/** One timeline entry (despite the plural name) — the element type of the timelineEvents array Timeline actually renders. */
 export interface TimelineEvents {
+    /** Only used in the React key — duplicates are tolerated. */
     logs_id: number;
+    /** Shown as the capitalised status pill; "created"/"updated"/"delete(d)" (any case) pick the color and icon, anything else uses primary. */
     title: string;
+    /** @deprecated Never read, but required — keep passing it; do not delete. */
     primary_id: number;
+    /** @deprecated Never read, but required — `action_from` is the displayed source. */
     is_from: string;
+    /** Card heading; "Accounts" and "Notes" also select the fallback node icon. */
     action_from: string;
+    /** Shown as "by …" with underscores turned into spaces and words capitalised. */
     action_by: string;
+    /** An unparseable value drops the whole event from every render path — no fallback bucket, no error. */
     created_at: number;
-    changes: any;
+    /** Object or JSON string of `{ field: { original, updated } }`; renders a from→to diff, bad JSON renders none. */
+    changes: unknown;
+    /** Manual notes listed under the card; editable and deletable through `onEditNote` and `onDeleteNote`. */
+    notes?: TimelineNote[] | null;
+    /** Replaces the node icon derived from `title`/`action_from`. */
+    icon?: ReactNode;
+    /** Free text or node shown under the card header, above the changes diff. */
+    description?: ReactNode;
 }

package/dist/Components/Toaster/Toaster.d.ts

@@ -1,4 +1,4 @@
-import React from "react";
 import { ToasterChildren, ToasterContextType } from "./ToasterProps";
-export default function ToasterProvider({ children }: ToasterChildren): React.JSX.Element;
+/** Provides useToaster().showToast() — a transient, self-dismissing notification, not hover-triggered info (ToolTip) or a blocking confirmation (AlertDialog). */
+export default function ToasterProvider({ children }: ToasterChildren): import("react/jsx-runtime").JSX.Element;
 export declare const useToaster: () => ToasterContextType;