@nivaro/react 0.1.28 → 0.1.30

package/dist/index.d.ts

@@ -60,6 +60,8 @@ export declare interface ApiVersionInfo {
 
 export declare function BooleanField({ field, value, onChange, error, disabled, readOnly, inputId, errorId }: FieldComponentProps): JSX.Element;
 
+export declare function canOpenChatRoom(): boolean;
+
 export declare function canOpenDm(): boolean;
 
 export { CascadeFilterRule }
@@ -158,7 +160,7 @@ export declare interface ChatOnlineUser {
     last_active?: string | null;
 }
 
-export declare function ChatPanel({ open, onClose, renderMessageBody, requestedDm }: {
+export declare function ChatPanel({ open, onClose, renderMessageBody, requestedDm, requestedRoom }: {
     open: boolean;
     onClose: () => void;
     renderMessageBody?: (m: ChatMessage, ctx: {
@@ -171,6 +173,13 @@ export declare function ChatPanel({ open, onClose, renderMessageBody, requestedD
         name?: string;
         nonce: number;
     } | null;
+    /** Open this room directly (a toast click). Nonce-keyed like requestedDm so
+     *  the same room can be re-opened after the reader navigates away. */
+    requestedRoom?: {
+        room: string;
+        label?: string;
+        nonce: number;
+    } | null;
 }): JSX.Element | null;
 
 export declare function ChatProvider({ children, me, onlineUsers, collections, globalRoom, globalLabel, entityPattern, entityUrl, roomLabel, recordUrl, sessionUrl, realtime, subscribeRooms, setTypingRoom, navigate, sound, theme }: ChatProviderProps): JSX.Element;
@@ -668,6 +677,15 @@ declare interface HeaderWidgetInfo {
     inputBindings: InputBinding[];
 }
 
+/** Time without real input before someone counts as idle. */
+export declare const IDLE_AFTER_MS: number;
+
+/** The fields a presence heartbeat should carry. */
+export declare function idleState(): {
+    is_idle: boolean;
+    last_active: string;
+};
+
 export declare function ImportConsole({ realtime, defaultTab, initialJobId, onJobOpen }: ImportConsoleProps): JSX.Element;
 
 export declare interface ImportConsoleProps {
@@ -1056,6 +1074,15 @@ declare interface O2MFieldInfo {
     parentId: string;
 }
 
+/**
+ * Called when idleness CHANGES, not on a timer — a host can push the flip
+ * straight down its socket so coming back is seen in about a second instead of
+ * on the next heartbeat. Returns an unsubscribe.
+ */
+export declare function onIdleChange(fn: (idle: boolean) => void): () => void;
+
+export declare function openChatRoom(room: string, label?: string): void;
+
 export declare function openDmWith(userId: string, displayName?: string): void;
 
 /**
@@ -1304,6 +1331,8 @@ export declare function RecordDrilldownSheet({ collection, itemId, layoutId, roo
 /** Register the host's DM opener. Returns an unregister function. */
 export declare function registerDmOpener(fn: DmOpener): () => void;
 
+export declare function registerRoomOpener(fn: RoomOpener): () => void;
+
 /**
  * Unstyled relation picker.
  *  - m2o: single <select> of related items
@@ -1388,6 +1417,14 @@ export declare interface RoomInfo {
     channel: ChannelMeta | null;
 }
 
+/**
+ * Same idea for a ROOM rather than a person: a new-message toast has to be able
+ * to open the conversation it is about, and that may be a channel or an entity
+ * room, not only a DM. The host's dock registers this; without one the toast
+ * stays a notification instead of pretending to be clickable.
+ */
+declare type RoomOpener = (room: string, label?: string) => void;
+
 export declare type SectionState = {
     isCollapsed: (key: string) => boolean;
     toggle: (key: string) => void;
@@ -1477,6 +1514,9 @@ export declare function TextField({ field, value, onChange, error, disabled, rea
 
 export declare function TipLayer(): ReactPortal | null;
 
+/** Install the listeners. Safe to call more than once. */
+export declare function trackActivity(): void;
+
 /**
  * Translate scope values (target-collection IDS) into a filter's value space.
  * When the filter compares ids (valueField 'id'/undefined) this is identity;