@object-ui/collaboration 3.0.3 → 3.1.0

package/dist/CommentThread.d.ts

@@ -46,6 +46,10 @@ export interface CommentThreadProps {
     onDeleteComment?: (commentId: string) => void;
     /** Callback when thread is resolved/reopened */
     onResolve?: (resolved: boolean) => void;
+    /** Callback when a reaction is toggled */
+    onReaction?: (commentId: string, emoji: string) => void;
+    /** Callback when @mentions are detected — for notification delivery (email/push) */
+    onMentionNotify?: (mentionedUserIds: string[], commentContent: string) => void;
     /** Whether the thread is resolved */
     resolved?: boolean;
     /** Additional className */
@@ -57,5 +61,5 @@ export interface CommentThreadProps {
  * Renders a list of comments with author avatars, timestamps,
  * reply functionality, and an @mention suggestions popup.
  */
-export declare function CommentThread({ threadId, comments, currentUser, mentionableUsers, onAddComment, onEditComment, onDeleteComment, onResolve, resolved, className, }: CommentThreadProps): React.ReactElement;
+export declare function CommentThread({ threadId, comments, currentUser, mentionableUsers, onAddComment, onEditComment, onDeleteComment, onResolve, onReaction, onMentionNotify, resolved, className, }: CommentThreadProps): React.ReactElement;
 //# sourceMappingURL=CommentThread.d.ts.map

package/dist/CommentThread.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CommentThread.d.ts","sourceRoot":"","sources":["../src/CommentThread.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAA4D,MAAM,OAAO,CAAC;AAEjF,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,kBAAkB;IACjC,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,mBAAmB;IACnB,WAAW,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,oCAAoC;IACpC,gBAAgB,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACnE,4CAA4C;IAC5C,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAChF,wCAAwC;IACxC,aAAa,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7D,yCAAyC;IACzC,eAAe,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,gDAAgD;IAChD,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;IACxC,qCAAqC;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2BAA2B;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAiOD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,gBAAqB,EACrB,YAAY,EACZ,aAAa,EACb,eAAe,EACf,SAAS,EACT,QAAgB,EAChB,SAAS,GACV,EAAE,kBAAkB,GAAG,KAAK,CAAC,YAAY,CAuQzC"}
+{"version":3,"file":"CommentThread.d.ts","sourceRoot":"","sources":["../src/CommentThread.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAA4D,MAAM,OAAO,CAAC;AAEjF,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,kBAAkB;IACjC,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,mBAAmB;IACnB,WAAW,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,oCAAoC;IACpC,gBAAgB,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACnE,4CAA4C;IAC5C,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAChF,wCAAwC;IACxC,aAAa,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7D,yCAAyC;IACzC,eAAe,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,gDAAgD;IAChD,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;IACxC,0CAA0C;IAC1C,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxD,oFAAoF;IACpF,eAAe,CAAC,EAAE,CAAC,gBAAgB,EAAE,MAAM,EAAE,EAAE,cAAc,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/E,qCAAqC;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2BAA2B;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA2QD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,gBAAqB,EACrB,YAAY,EACZ,aAAa,EACb,eAAe,EACf,SAAS,EACT,UAAU,EACV,eAAe,EACf,QAAgB,EAChB,SAAS,GACV,EAAE,kBAAkB,GAAG,KAAK,CAAC,YAAY,CA0TzC"}

package/dist/CommentThread.js

@@ -152,6 +152,48 @@ const styles = {
         cursor: 'pointer',
         padding: 0,
     },
+    sortSelect: {
+        background: 'none',
+        border: '1px solid #e2e8f0',
+        borderRadius: '4px',
+        padding: '2px 6px',
+        fontSize: '11px',
+        color: '#64748b',
+        cursor: 'pointer',
+        outline: 'none',
+    },
+    reactionBar: {
+        display: 'flex',
+        gap: '4px',
+        marginTop: '4px',
+        flexWrap: 'wrap',
+    },
+    reactionBtn: {
+        background: 'none',
+        border: '1px solid #e2e8f0',
+        borderRadius: '12px',
+        padding: '1px 6px',
+        fontSize: '12px',
+        cursor: 'pointer',
+        display: 'inline-flex',
+        alignItems: 'center',
+        gap: '2px',
+        lineHeight: '1.5',
+    },
+    reactionBtnActive: {
+        backgroundColor: '#eff6ff',
+        borderColor: '#93c5fd',
+    },
+    reactionPicker: {
+        background: 'none',
+        border: '1px solid #e2e8f0',
+        borderRadius: '12px',
+        padding: '1px 6px',
+        fontSize: '12px',
+        cursor: 'pointer',
+        color: '#94a3b8',
+        lineHeight: '1.5',
+    },
     inputArea: {
         display: 'flex',
         gap: '8px',
@@ -230,13 +272,14 @@ function renderContent(content) {
  * Renders a list of comments with author avatars, timestamps,
  * reply functionality, and an @mention suggestions popup.
  */
-export function CommentThread({ threadId, comments, currentUser, mentionableUsers = [], onAddComment, onEditComment, onDeleteComment, onResolve, resolved = false, className, }) {
+export function CommentThread({ threadId, comments, currentUser, mentionableUsers = [], onAddComment, onEditComment, onDeleteComment, onResolve, onReaction, onMentionNotify, resolved = false, className, }) {
     const [inputValue, setInputValue] = useState('');
     const [replyTo, setReplyTo] = useState(null);
     const [editingId, setEditingId] = useState(null);
     const [editValue, setEditValue] = useState('');
     const [mentionQuery, setMentionQuery] = useState(null);
     const [mentionIndex, setMentionIndex] = useState(0);
+    const [sortOrder, setSortOrder] = useState('oldest');
     const inputRef = useRef(null);
     const filteredMentions = useMemo(() => {
         if (mentionQuery === null)
@@ -280,10 +323,14 @@ export function CommentThread({ threadId, comments, currentUser, mentionableUser
             return;
         const mentions = parseMentions(trimmed, mentionableUsers);
         onAddComment(trimmed, mentions, replyTo ?? undefined);
+        // Trigger notification delivery for mentioned users
+        if (mentions.length > 0 && onMentionNotify) {
+            onMentionNotify(mentions, trimmed);
+        }
         setInputValue('');
         setReplyTo(null);
         setMentionQuery(null);
-    }, [inputValue, onAddComment, mentionableUsers, replyTo]);
+    }, [inputValue, onAddComment, mentionableUsers, replyTo, onMentionNotify]);
     const handleKeyDown = useCallback((e) => {
         if (mentionQuery !== null && filteredMentions.length > 0) {
             if (e.key === 'ArrowDown') {
@@ -328,7 +375,13 @@ export function CommentThread({ threadId, comments, currentUser, mentionableUser
             setMentionIndex(Math.max(0, filteredMentions.length - 1));
         }
     }, [filteredMentions.length, mentionIndex]);
-    const rootComments = useMemo(() => comments.filter(c => !c.parentId), [comments]);
+    const rootComments = useMemo(() => {
+        const roots = comments.filter(c => !c.parentId);
+        if (sortOrder === 'newest') {
+            return [...roots].sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
+        }
+        return roots;
+    }, [comments, sortOrder]);
     const replies = useMemo(() => comments.filter(c => c.parentId), [comments]);
     const renderComment = (comment, isReply = false) => {
         const isEditing = editingId === comment.id;
@@ -367,11 +420,31 @@ export function CommentThread({ threadId, comments, currentUser, mentionableUser
                 style: { ...styles.actionBtn },
             }, 'Cancel'))
             : React.createElement('div', { style: styles.content }, renderContent(comment.content)), 
+        // Reactions display
+        !isEditing && comment.reactions && Object.keys(comment.reactions).length > 0 && React.createElement('div', { style: styles.reactionBar }, Object.entries(comment.reactions).map(([emoji, userIds]) => React.createElement('button', {
+            key: emoji,
+            style: {
+                ...styles.reactionBtn,
+                ...(userIds.includes(currentUser.id) ? styles.reactionBtnActive : {}),
+            },
+            onClick: () => onReaction?.(comment.id, emoji),
+            title: userIds.length === 1 ? '1 reaction' : `${userIds.length} reactions`,
+        }, `${emoji} ${userIds.length}`)), onReaction && React.createElement('button', {
+            style: styles.reactionPicker,
+            onClick: () => onReaction(comment.id, '👍'),
+            title: 'Add thumbs up',
+        }, '+')), 
         // Actions
         !isEditing && React.createElement('div', { style: styles.actions }, React.createElement('button', {
             style: styles.actionBtn,
             onClick: () => setReplyTo(comment.id),
-        }, 'Reply'), isOwner && onEditComment && React.createElement('button', {
+        }, 'Reply'), onReaction && React.createElement('button', {
+            style: styles.actionBtn,
+            onClick: () => onReaction(comment.id, '👍'),
+        }, '👍'), onReaction && React.createElement('button', {
+            style: styles.actionBtn,
+            onClick: () => onReaction(comment.id, '❤️'),
+        }, '❤️'), isOwner && onEditComment && React.createElement('button', {
             style: styles.actionBtn,
             onClick: () => handleEdit(comment.id),
         }, 'Edit'), isOwner && onDeleteComment && React.createElement('button', {
@@ -385,10 +458,15 @@ export function CommentThread({ threadId, comments, currentUser, mentionableUser
         'data-thread-id': threadId,
     }, 
     // Header
-    React.createElement('div', { style: styles.header }, React.createElement('span', null, `${comments.length} comment${comments.length !== 1 ? 's' : ''}`, resolved ? ' · Resolved' : ''), onResolve && React.createElement('button', {
+    React.createElement('div', { style: styles.header }, React.createElement('span', null, `${comments.length} comment${comments.length !== 1 ? 's' : ''}`, resolved ? ' · Resolved' : ''), React.createElement('div', { style: { display: 'flex', gap: '6px', alignItems: 'center' } }, React.createElement('select', {
+        value: sortOrder,
+        onChange: (e) => setSortOrder(e.target.value),
+        style: styles.sortSelect,
+        'aria-label': 'Sort comments',
+    }, React.createElement('option', { value: 'oldest' }, 'Oldest'), React.createElement('option', { value: 'newest' }, 'Newest')), onResolve && React.createElement('button', {
         style: styles.resolveBtn,
         onClick: () => onResolve(!resolved),
-    }, resolved ? 'Reopen' : 'Resolve')), 
+    }, resolved ? 'Reopen' : 'Resolve'))), 
     // Comments list
     React.createElement('div', { style: styles.commentList }, rootComments.map(comment => React.createElement(React.Fragment, { key: comment.id }, renderComment(comment), replies
         .filter(r => r.parentId === comment.id)

package/dist/index.d.ts

@@ -22,6 +22,8 @@ export { useRealtimeSubscription, type RealtimeConfig, type ConnectionState, typ
 export { usePresence, createPresenceUpdater, type PresenceUser, type PresenceConfig, type PresenceResult, } from './usePresence';
 export { useConflictResolution, type VersionEntry, type ConflictInfo, type ConflictResolutionResult, } from './useConflictResolution';
 export { CommentThread, type Comment, type CommentThreadProps, } from './CommentThread';
+export { useMentionNotifications, type MentionNotificationsConfig, type MentionNotificationsResult, } from './useMentionNotifications';
+export { useCommentSearch, type CommentSearchConfig, type CommentSearchReturn, } from './useCommentSearch';
 export { LiveCursors, type LiveCursorsProps, } from './LiveCursors';
 export { PresenceAvatars, type PresenceAvatarsProps, } from './PresenceAvatars';
 export type { CollaborationPresence, CollaborationOperation, CollaborationConfig, } from '@object-ui/types';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;;GAYG;AAEH,OAAO,EACL,uBAAuB,EACvB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,cAAc,GACpB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,WAAW,EACX,qBAAqB,EACrB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,cAAc,GACpB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,qBAAqB,EACrB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,wBAAwB,GAC9B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,aAAa,EACb,KAAK,OAAO,EACZ,KAAK,kBAAkB,GACxB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,WAAW,EACX,KAAK,gBAAgB,GACtB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,eAAe,EACf,KAAK,oBAAoB,GAC1B,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EACV,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;;GAYG;AAEH,OAAO,EACL,uBAAuB,EACvB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,cAAc,GACpB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,WAAW,EACX,qBAAqB,EACrB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,cAAc,GACpB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,qBAAqB,EACrB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,wBAAwB,GAC9B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,aAAa,EACb,KAAK,OAAO,EACZ,KAAK,kBAAkB,GACxB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,uBAAuB,EACvB,KAAK,0BAA0B,EAC/B,KAAK,0BAA0B,GAChC,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,gBAAgB,EAChB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,GACzB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,WAAW,EACX,KAAK,gBAAgB,GACtB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,eAAe,EACf,KAAK,oBAAoB,GAC1B,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EACV,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -22,5 +22,7 @@ export { useRealtimeSubscription, } from './useRealtimeSubscription';
 export { usePresence, createPresenceUpdater, } from './usePresence';
 export { useConflictResolution, } from './useConflictResolution';
 export { CommentThread, } from './CommentThread';
+export { useMentionNotifications, } from './useMentionNotifications';
+export { useCommentSearch, } from './useCommentSearch';
 export { LiveCursors, } from './LiveCursors';
 export { PresenceAvatars, } from './PresenceAvatars';

package/dist/useCommentSearch.d.ts

@@ -0,0 +1,33 @@
+/**
+ * ObjectUI
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import type { CommentEntry, CommentSearchResult } from '@object-ui/types';
+export interface CommentSearchConfig {
+    /** All comments across records, each must have objectName and recordId set */
+    comments: CommentEntry[];
+}
+export interface CommentSearchReturn {
+    /** Current search query */
+    query: string;
+    /** Update the search query */
+    setQuery: (query: string) => void;
+    /** Filtered/matched results */
+    results: CommentSearchResult[];
+    /** Whether a search is active */
+    isSearching: boolean;
+    /** Clear the search */
+    clearSearch: () => void;
+}
+/**
+ * Hook for searching comments across all records.
+ *
+ * Accepts a flat list of CommentEntry items (each should have objectName
+ * and recordId set) and provides a search interface that returns matching
+ * results with highlighted snippets.
+ */
+export declare function useCommentSearch({ comments }: CommentSearchConfig): CommentSearchReturn;
+//# sourceMappingURL=useCommentSearch.d.ts.map

package/dist/useCommentSearch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCommentSearch.d.ts","sourceRoot":"","sources":["../src/useCommentSearch.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE1E,MAAM,WAAW,mBAAmB;IAClC,8EAA8E;IAC9E,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,+BAA+B;IAC/B,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,iCAAiC;IACjC,WAAW,EAAE,OAAO,CAAC;IACrB,uBAAuB;IACvB,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB;AAiBD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,QAAQ,EAAE,EAAE,mBAAmB,GAAG,mBAAmB,CAkCvF"}

package/dist/useCommentSearch.js

@@ -0,0 +1,62 @@
+/**
+ * ObjectUI
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { useState, useCallback, useMemo } from 'react';
+/**
+ * Build a highlighted snippet around the first match of `query` in `text`.
+ * Returns the match wrapped in <mark> tags for display.
+ */
+function buildHighlight(text, query) {
+    if (!query)
+        return text;
+    const idx = text.toLowerCase().indexOf(query.toLowerCase());
+    if (idx === -1)
+        return text;
+    const start = Math.max(0, idx - 30);
+    const end = Math.min(text.length, idx + query.length + 30);
+    const before = start > 0 ? '…' : '';
+    const after = end < text.length ? '…' : '';
+    return `${before}${text.slice(start, end)}${after}`;
+}
+/**
+ * Hook for searching comments across all records.
+ *
+ * Accepts a flat list of CommentEntry items (each should have objectName
+ * and recordId set) and provides a search interface that returns matching
+ * results with highlighted snippets.
+ */
+export function useCommentSearch({ comments }) {
+    const [query, setQuery] = useState('');
+    const isSearching = query.trim().length > 0;
+    const results = useMemo(() => {
+        const trimmed = query.trim().toLowerCase();
+        if (!trimmed)
+            return [];
+        return comments
+            .filter(c => {
+            const textMatch = c.text.toLowerCase().includes(trimmed);
+            const authorMatch = c.author.toLowerCase().includes(trimmed);
+            return textMatch || authorMatch;
+        })
+            .map(c => ({
+            comment: c,
+            objectName: c.objectName ?? '',
+            recordId: c.recordId ?? '',
+            highlight: buildHighlight(c.text, trimmed),
+        }));
+    }, [query, comments]);
+    const clearSearch = useCallback(() => {
+        setQuery('');
+    }, []);
+    return {
+        query,
+        setQuery,
+        results,
+        isSearching,
+        clearSearch,
+    };
+}

package/dist/useMentionNotifications.d.ts

@@ -0,0 +1,40 @@
+/**
+ * ObjectUI
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import type { MentionNotification } from '@object-ui/types';
+export interface MentionNotificationsConfig {
+    /** Current user ID to filter notifications for */
+    currentUserId: string;
+    /** Initial notifications */
+    initialNotifications?: MentionNotification[];
+    /** Callback when a notification should be delivered (email/push) */
+    onDeliver?: (notification: MentionNotification) => void | Promise<void>;
+}
+export interface MentionNotificationsResult {
+    /** All notifications for the current user */
+    notifications: MentionNotification[];
+    /** Unread notifications count */
+    unreadCount: number;
+    /** Add a new mention notification (triggered when @mention is detected) */
+    addNotification: (notification: MentionNotification) => void;
+    /** Mark a notification as read */
+    markAsRead: (notificationId: string) => void;
+    /** Mark all notifications as read */
+    markAllAsRead: () => void;
+    /** Dismiss/remove a notification */
+    dismiss: (notificationId: string) => void;
+    /** Clear all notifications */
+    clearAll: () => void;
+}
+/**
+ * Hook for managing @mention notifications with delivery support.
+ *
+ * Tracks mention notifications for the current user and provides
+ * callbacks for delivery via email/push channels.
+ */
+export declare function useMentionNotifications({ currentUserId, initialNotifications, onDeliver, }: MentionNotificationsConfig): MentionNotificationsResult;
+//# sourceMappingURL=useMentionNotifications.d.ts.map

package/dist/useMentionNotifications.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMentionNotifications.d.ts","sourceRoot":"","sources":["../src/useMentionNotifications.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,MAAM,WAAW,0BAA0B;IACzC,kDAAkD;IAClD,aAAa,EAAE,MAAM,CAAC;IACtB,4BAA4B;IAC5B,oBAAoB,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAC7C,oEAAoE;IACpE,SAAS,CAAC,EAAE,CAAC,YAAY,EAAE,mBAAmB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzE;AAED,MAAM,WAAW,0BAA0B;IACzC,6CAA6C;IAC7C,aAAa,EAAE,mBAAmB,EAAE,CAAC;IACrC,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,eAAe,EAAE,CAAC,YAAY,EAAE,mBAAmB,KAAK,IAAI,CAAC;IAC7D,kCAAkC;IAClC,UAAU,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,qCAAqC;IACrC,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,oCAAoC;IACpC,OAAO,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,aAAa,EACb,oBAAyB,EACzB,SAAS,GACV,EAAE,0BAA0B,GAAG,0BAA0B,CAiDzD"}

package/dist/useMentionNotifications.js

@@ -0,0 +1,49 @@
+/**
+ * ObjectUI
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { useState, useCallback, useMemo } from 'react';
+/**
+ * Hook for managing @mention notifications with delivery support.
+ *
+ * Tracks mention notifications for the current user and provides
+ * callbacks for delivery via email/push channels.
+ */
+export function useMentionNotifications({ currentUserId, initialNotifications = [], onDeliver, }) {
+    const [notifications, setNotifications] = useState(initialNotifications.filter(n => n.recipientId === currentUserId));
+    const unreadCount = useMemo(() => notifications.filter(n => !n.read).length, [notifications]);
+    const addNotification = useCallback((notification) => {
+        if (notification.recipientId !== currentUserId)
+            return;
+        setNotifications(prev => {
+            if (prev.some(n => n.id === notification.id))
+                return prev;
+            return [notification, ...prev];
+        });
+        onDeliver?.(notification);
+    }, [currentUserId, onDeliver]);
+    const markAsRead = useCallback((notificationId) => {
+        setNotifications(prev => prev.map(n => (n.id === notificationId ? { ...n, read: true } : n)));
+    }, []);
+    const markAllAsRead = useCallback(() => {
+        setNotifications(prev => prev.map(n => ({ ...n, read: true })));
+    }, []);
+    const dismiss = useCallback((notificationId) => {
+        setNotifications(prev => prev.filter(n => n.id !== notificationId));
+    }, []);
+    const clearAll = useCallback(() => {
+        setNotifications([]);
+    }, []);
+    return {
+        notifications,
+        unreadCount,
+        addNotification,
+        markAsRead,
+        markAllAsRead,
+        dismiss,
+        clearAll,
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@object-ui/collaboration",
-  "version": "3.0.3",
+  "version": "3.1.0",
   "type": "module",
   "license": "MIT",
   "description": "Real-time collaboration for Object UI with presence tracking, live cursors, conflict resolution, and comment threads.",
@@ -26,10 +26,10 @@
     "react": "^18.0.0 || ^19.0.0"
   },
   "dependencies": {
-    "@object-ui/types": "3.0.3"
+    "@object-ui/types": "3.1.0"
   },
   "devDependencies": {
-    "@types/react": "19.2.13",
+    "@types/react": "19.2.14",
     "react": "19.2.4",
     "typescript": "^5.9.3",
     "vitest": "^4.0.18"