@nice2dev/ui-communication 1.0.8 → 1.0.11

package/dist/communication-controls.d.ts

@@ -0,0 +1,369 @@
+/**
+ * @file Nice2Dev Communication Controls
+ * @description Video conferencing, screen sharing, whiteboard, chat
+ */
+export interface VideoConferenceConfig {
+    /** Room ID */
+    roomId: string;
+    /** User info */
+    user: {
+        id: string;
+        name: string;
+        avatar?: string;
+    };
+    /** ICE servers for WebRTC */
+    iceServers?: RTCIceServer[];
+    /** Signaling server URL */
+    signalingUrl: string;
+    /** Enable audio */
+    audio?: boolean;
+    /** Enable video */
+    video?: boolean;
+    /** Max participants */
+    maxParticipants?: number;
+}
+export interface Participant {
+    id: string;
+    name: string;
+    avatar?: string;
+    stream?: MediaStream;
+    audioEnabled: boolean;
+    videoEnabled: boolean;
+    isScreenSharing: boolean;
+    isSpeaking: boolean;
+}
+export interface VideoConferenceState {
+    isConnected: boolean;
+    participants: Participant[];
+    localStream: MediaStream | null;
+    screenStream: MediaStream | null;
+    audioEnabled: boolean;
+    videoEnabled: boolean;
+    isScreenSharing: boolean;
+}
+/**
+ * Hook for video conferencing
+ */
+export declare function useVideoConference(_config: VideoConferenceConfig): {
+    state: VideoConferenceState;
+    join: () => Promise<void>;
+    leave: () => void;
+    toggleAudio: () => void;
+    toggleVideo: () => void;
+    startScreenShare: () => Promise<void>;
+    stopScreenShare: () => void;
+    onParticipantJoined: (_callback: (participant: Participant) => void) => void;
+    onParticipantLeft: (_callback: (participantId: string) => void) => void;
+    onStreamUpdated: (_callback: (participantId: string, stream: MediaStream) => void) => void;
+};
+export interface ScreenShareConfig {
+    /** Enable audio capture */
+    withAudio?: boolean;
+    /** Video quality */
+    quality?: 'low' | 'medium' | 'high' | 'hd';
+    /** Preferred display surface */
+    displaySurface?: 'monitor' | 'window' | 'application' | 'browser';
+}
+export interface ScreenAnnotation {
+    id: string;
+    type: 'drawing' | 'text' | 'arrow' | 'rectangle' | 'highlight';
+    data: unknown;
+    color: string;
+    userId: string;
+}
+/**
+ * Hook for screen sharing with annotation
+ */
+export declare function useScreenShare(_config?: ScreenShareConfig): {
+    stream: MediaStream | null;
+    isSharing: boolean;
+    annotations: ScreenAnnotation[];
+    startSharing: () => Promise<{
+        stream: MediaStream | null;
+    }>;
+    stopSharing: () => void;
+    addAnnotation: (_annotation: Omit<ScreenAnnotation, "id">) => void;
+    removeAnnotation: (_id: string) => void;
+    clearAnnotations: () => void;
+    enableRemoteControl: () => void;
+    disableRemoteControl: () => void;
+};
+export interface WhiteboardConfig {
+    /** Board ID for collaboration */
+    boardId: string;
+    /** User info */
+    user: {
+        id: string;
+        name: string;
+        color: string;
+    };
+    /** Collaboration server URL */
+    serverUrl?: string;
+    /** Board dimensions */
+    width?: number;
+    height?: number;
+}
+export interface WhiteboardElement {
+    id: string;
+    type: 'path' | 'rectangle' | 'ellipse' | 'line' | 'arrow' | 'text' | 'image' | 'sticky';
+    x: number;
+    y: number;
+    width?: number;
+    height?: number;
+    points?: {
+        x: number;
+        y: number;
+    }[];
+    fill?: string;
+    stroke?: string;
+    strokeWidth?: number;
+    text?: string;
+    fontSize?: number;
+    imageUrl?: string;
+    rotation?: number;
+    opacity?: number;
+    locked?: boolean;
+    userId: string;
+}
+export interface WhiteboardTool {
+    type: 'select' | 'pen' | 'highlighter' | 'eraser' | 'rectangle' | 'ellipse' | 'line' | 'arrow' | 'text' | 'sticky' | 'image' | 'pan' | 'laser';
+    color?: string;
+    strokeWidth?: number;
+    fontSize?: number;
+}
+/**
+ * Hook for collaborative whiteboard
+ */
+export declare function useWhiteboard(_config: WhiteboardConfig): {
+    elements: WhiteboardElement[];
+    selectedIds: string[];
+    currentTool: WhiteboardTool;
+    zoom: number;
+    pan: {
+        x: number;
+        y: number;
+    };
+    collaborators: {
+        id: string;
+        name: string;
+        color: string;
+        cursor?: {
+            x: number;
+            y: number;
+        };
+    }[];
+    addElement: (_element: Omit<WhiteboardElement, "id" | "userId">) => void;
+    updateElement: (_id: string, _updates: Partial<WhiteboardElement>) => void;
+    deleteElements: (_ids: string[]) => void;
+    selectElements: (_ids: string[]) => void;
+    setTool: (_tool: WhiteboardTool) => void;
+    setZoom: (_zoom: number) => void;
+    setPan: (_pan: {
+        x: number;
+        y: number;
+    }) => void;
+    undo: () => void;
+    redo: () => void;
+    canUndo: boolean;
+    canRedo: boolean;
+    exportAsImage: () => Promise<string>;
+    exportAsSvg: () => string;
+    exportAsJson: () => object;
+    importFromJson: (_data: object) => void;
+};
+export interface ChatRoomConfig {
+    /** Room ID */
+    roomId: string;
+    /** User info */
+    user: {
+        id: string;
+        name: string;
+        avatar?: string;
+    };
+    /** Server URL */
+    serverUrl: string;
+    /** Enable file sharing */
+    enableFiles?: boolean;
+    /** Enable threads */
+    enableThreads?: boolean;
+    /** Enable reactions */
+    enableReactions?: boolean;
+}
+export interface ChatMessage {
+    id: string;
+    content: string;
+    type: 'text' | 'file' | 'image' | 'system';
+    userId: string;
+    userName: string;
+    userAvatar?: string;
+    timestamp: Date;
+    threadId?: string;
+    replyTo?: string;
+    reactions?: {
+        emoji: string;
+        userIds: string[];
+    }[];
+    file?: {
+        name: string;
+        url: string;
+        size: number;
+        type: string;
+    };
+    edited?: boolean;
+    deleted?: boolean;
+}
+export interface ChatThread {
+    id: string;
+    parentMessageId: string;
+    messages: ChatMessage[];
+    participantIds: string[];
+}
+/**
+ * Hook for chat room
+ */
+export declare function useChatRoom(_config: ChatRoomConfig): {
+    messages: ChatMessage[];
+    threads: ChatThread[];
+    participants: {
+        id: string;
+        name: string;
+        avatar?: string;
+        isOnline: boolean;
+    }[];
+    isTyping: {
+        userId: string;
+        userName: string;
+    }[];
+    unreadCount: number;
+    sendMessage: (_content: string, _options?: {
+        threadId?: string;
+        replyTo?: string;
+    }) => Promise<void>;
+    editMessage: (_messageId: string, _content: string) => Promise<void>;
+    deleteMessage: (_messageId: string) => Promise<void>;
+    addReaction: (_messageId: string, _emoji: string) => Promise<void>;
+    removeReaction: (_messageId: string, _emoji: string) => Promise<void>;
+    uploadFile: (_file: File) => Promise<{
+        url: string;
+    }>;
+    setTyping: (_isTyping: boolean) => void;
+    markAsRead: () => void;
+    startThread: (_messageId: string) => void;
+    closeThread: () => void;
+    onNewMessage: (_callback: (message: ChatMessage) => void) => () => void;
+    onMessageEdited: (_callback: (message: ChatMessage) => void) => () => void;
+    onMessageDeleted: (_callback: (messageId: string) => void) => () => void;
+    onTypingChange: (_callback: (typing: {
+        userId: string;
+        userName: string;
+    }[]) => void) => () => void;
+};
+export interface NotificationHubConfig {
+    /** User ID */
+    userId: string;
+    /** API base URL */
+    apiUrl: string;
+    /** Enable push notifications */
+    enablePush?: boolean;
+    /** Enable in-app notifications */
+    enableInApp?: boolean;
+    /** Notification preferences */
+    preferences?: NotificationPreferences;
+}
+export interface NotificationPreferences {
+    email: boolean;
+    push: boolean;
+    inApp: boolean;
+    channels: {
+        [channel: string]: {
+            email: boolean;
+            push: boolean;
+            inApp: boolean;
+        };
+    };
+}
+export interface Notification {
+    id: string;
+    type: string;
+    channel: string;
+    title: string;
+    body: string;
+    data?: Record<string, unknown>;
+    read: boolean;
+    timestamp: Date;
+    expiresAt?: Date;
+    actionUrl?: string;
+    imageUrl?: string;
+}
+/**
+ * Hook for unified notification hub
+ */
+export declare function useNotificationHub(_config: NotificationHubConfig): {
+    notifications: Notification[];
+    unreadCount: number;
+    preferences: NotificationPreferences;
+    markAsRead: (_notificationId: string) => Promise<void>;
+    markAllAsRead: () => Promise<void>;
+    deleteNotification: (_notificationId: string) => Promise<void>;
+    clearAll: () => Promise<void>;
+    updatePreferences: (_preferences: Partial<NotificationPreferences>) => Promise<void>;
+    requestPushPermission: () => Promise<boolean>;
+    subscribeToPush: () => Promise<void>;
+    unsubscribeFromPush: () => Promise<void>;
+    subscribe: () => () => void;
+    onNotification: (_callback: (notification: Notification) => void) => () => void;
+};
+export interface CommentConfig {
+    /** Entity type (e.g., 'document', 'task', 'cell') */
+    entityType: string;
+    /** Entity ID */
+    entityId: string;
+    /** User info */
+    user: {
+        id: string;
+        name: string;
+        avatar?: string;
+    };
+    /** API URL */
+    apiUrl: string;
+}
+export interface Comment {
+    id: string;
+    content: string;
+    userId: string;
+    userName: string;
+    userAvatar?: string;
+    timestamp: Date;
+    edited?: boolean;
+    resolved?: boolean;
+    position?: {
+        startOffset?: number;
+        endOffset?: number;
+        x?: number;
+        y?: number;
+        page?: number;
+    };
+    replies?: Comment[];
+    mentions?: string[];
+}
+/**
+ * Hook for commenting/annotation system
+ */
+export declare function useComments(_config: CommentConfig): {
+    comments: Comment[];
+    activeCommentId: string | null;
+    addComment: (_content: string, _position?: Comment["position"]) => Promise<void>;
+    editComment: (_commentId: string, _content: string) => Promise<void>;
+    deleteComment: (_commentId: string) => Promise<void>;
+    replyToComment: (_commentId: string, _content: string) => Promise<void>;
+    resolveComment: (_commentId: string) => Promise<void>;
+    unresolveComment: (_commentId: string) => Promise<void>;
+    setActiveComment: (_commentId: string | null) => void;
+    searchUsers: (_query: string) => Promise<{
+        id: string;
+        name: string;
+    }[]>;
+    onCommentAdded: (_callback: (comment: Comment) => void) => () => void;
+    onCommentUpdated: (_callback: (comment: Comment) => void) => () => void;
+    onCommentDeleted: (_callback: (commentId: string) => void) => () => void;
+};

package/dist/hooks/useCommunication.d.ts

@@ -1,5 +1,5 @@
-import { CallSession, CallType, ChatMessage, CommunicationMode, CommunicationUser, Conversation, IncomingCall, MessageContentType, RTCTransportConfig, TransportType } from '../types/communicationTypes';
 import { ICommunicationTransport } from '../transport/communicationTransport';
+import { CallSession, CallType, ChatMessage, CommunicationMode, CommunicationUser, Conversation, IncomingCall, MessageContentType, RTCTransportConfig, TransportType } from '../types/communicationTypes';
 
 export interface CommunicationState {
     isConnected: boolean;