@nice2dev/ui-communication 1.3.13 → 1.3.14

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nice2dev/ui-communication",
-  "version": "1.3.13",
+  "version": "1.3.14",
   "description": "NiceCommunication — full-spectrum communication suite: chat bubble, messenger, voice/video calls, multi-party conference, and Teams-style workspace. Provider-agnostic RTC transport.",
   "type": "module",
   "main": "dist/index.cjs",
@@ -35,7 +35,7 @@
     "react-dom": ">=17.0.0"
   },
   "devDependencies": {
-    "@nice2dev/ui": "^1.3.13",
+    "@nice2dev/ui": "^1.3.14",
     "@testing-library/jest-dom": "^7.0.1",
     "@testing-library/react": "^16.3.3",
     "@types/react": "^19.2.18",

package/dist/collaboration/collaborative-datagrid.d.ts

@@ -1,95 +0,0 @@
-import { CollaborationConfig } from './yjs-integration';
-/**
- * @file Collaborative DataGrid with CRDT
- * @description Real-time collaborative data grid editing
- */
-import * as Y from 'yjs';
-export interface CollaborativeDataGridConfig<T> extends CollaborationConfig {
-    /** Initial rows data */
-    initialData?: T[];
-    /** Column definitions */
-    columns: CollaborativeColumnDef<T>[];
-    /** Row ID field */
-    rowIdField: keyof T;
-}
-export interface CollaborativeColumnDef<T> {
-    field: keyof T;
-    header: string;
-    editable?: boolean;
-    width?: number;
-    type?: 'text' | 'number' | 'boolean' | 'date' | 'select';
-    options?: {
-        value: string;
-        label: string;
-    }[];
-}
-export interface CellEdit<T> {
-    rowId: string;
-    field: keyof T;
-    value: unknown;
-    userId: string;
-    timestamp: number;
-}
-export interface ActiveEdit {
-    rowId: string;
-    field: string;
-    user: {
-        id: string;
-        name: string;
-        color: string;
-    };
-}
-/**
- * Hook for collaborative DataGrid editing
- */
-export declare function useCollaborativeDataGrid<T extends Record<string, unknown>>(config: CollaborativeDataGridConfig<T>): {
-    rows: T[];
-    columns: CollaborativeColumnDef<T>[];
-    collaborators: import('./yjs-integration').CollaborationUser[];
-    isConnected: boolean;
-    isSynced: boolean;
-    activeEdits: ActiveEdit[];
-    startCellEdit: (rowId: string, field: keyof T) => void;
-    endCellEdit: () => void;
-    updateCell: (rowIndex: number, field: keyof T, value: unknown) => void;
-    addRow: (row: T) => void;
-    removeRow: (rowIndex: number) => void;
-    isCellLocked: (rowId: string, field: keyof T) => ActiveEdit | undefined;
-    getRowById: (id: string) => {
-        row: T;
-        index: number;
-    } | undefined;
-};
-export interface ConflictResolution<T> {
-    strategy: 'lastWriteWins' | 'firstWriteWins' | 'merge' | 'custom';
-    mergeFunction?: (local: T, remote: T) => T;
-}
-/**
- * Hook for conflict resolution in collaborative editing
- */
-export declare function useConflictResolution<T>(resolution: ConflictResolution<T>): {
-    resolve: (local: T, remote: T, timestamp: {
-        local: number;
-        remote: number;
-    }) => T;
-};
-export interface ChangeHistoryEntry<T> {
-    id: string;
-    type: 'insert' | 'update' | 'delete';
-    rowId: string;
-    field?: keyof T;
-    oldValue?: unknown;
-    newValue?: unknown;
-    user: {
-        id: string;
-        name: string;
-    };
-    timestamp: number;
-}
-/**
- * Hook for tracking change history
- */
-export declare function useChangeHistory<T>(ydoc: Y.Doc | null, rowIdField: keyof T): {
-    history: ChangeHistoryEntry<T>[];
-    clearHistory: () => void;
-};

package/dist/collaboration/collaborative-form.d.ts

@@ -1,74 +0,0 @@
-import { CollaborationConfig, CollaborationUser } from './yjs-integration';
-export interface CollaborativeFormConfig<T extends Record<string, unknown>> extends CollaborationConfig {
-    /** Initial form values */
-    initialValues?: Partial<T>;
-    /** Field validation rules */
-    validation?: FormValidation<T>;
-    /** Debounce delay for syncing (ms) */
-    syncDelay?: number;
-}
-export type FormValidation<T> = {
-    [K in keyof T]?: (value: T[K], formValues: Partial<T>) => string | undefined;
-};
-export interface FieldFocus {
-    fieldName: string;
-    user: CollaborationUser;
-}
-export interface FormState<T> {
-    values: Partial<T>;
-    errors: Partial<Record<keyof T, string>>;
-    touched: Partial<Record<keyof T, boolean>>;
-    isDirty: boolean;
-    isValid: boolean;
-    focusedFields: FieldFocus[];
-}
-/**
- * Hook for collaborative form editing
- */
-export declare function useCollaborativeForm<T extends Record<string, unknown>>(config: CollaborativeFormConfig<T>): {
-    values: Partial<T>;
-    errors: Partial<Record<keyof T, string>>;
-    touched: Partial<Record<keyof T, boolean>>;
-    isDirty: boolean;
-    isValid: boolean;
-    focusedFields: FieldFocus[];
-    collaborators: CollaborationUser[];
-    isConnected: boolean;
-    isSynced: boolean;
-    setFieldValue: <K extends keyof T>(fieldName: K, value: T[K]) => void;
-    setFieldTouched: (fieldName: keyof T, isTouched?: boolean) => void;
-    handleFieldFocus: (fieldName: keyof T) => void;
-    handleFieldBlur: (fieldName: keyof T) => void;
-    isFieldFocused: (fieldName: keyof T) => FieldFocus | undefined;
-    validateField: (fieldName: keyof T, value: T[typeof fieldName]) => string | undefined;
-    validateForm: () => boolean;
-    resetForm: () => void;
-    handleSubmit: (onSubmit: (values: Partial<T>) => void | Promise<void>) => (e?: React.FormEvent) => Promise<void>;
-};
-export interface CollaborativeFieldProps {
-    name: string;
-    focusedBy?: FieldFocus;
-    children: React.ReactNode;
-}
-/**
- * Wrapper component showing collaborative field state
- */
-export declare function CollaborativeFieldWrapper({ name: _name, focusedBy, children, }: CollaborativeFieldProps): import("react").JSX.Element;
-/**
- * Convenience hook for individual form field
- */
-export declare function useCollaborativeField<T extends Record<string, unknown>, K extends keyof T>(form: ReturnType<typeof useCollaborativeForm<T>>, fieldName: K): {
-    value: Partial<T>[K];
-    error: Partial<Record<keyof T, string>>[K] | undefined;
-    touched: Partial<Record<keyof T, boolean>>[K];
-    focusedBy: FieldFocus | undefined;
-    onChange: (newValue: T[K]) => void;
-    onFocus: () => void;
-    onBlur: () => void;
-    inputProps: {
-        value: string | NonNullable<Partial<T>[K]>;
-        onFocus: () => void;
-        onBlur: () => void;
-        onChange: (e: React.ChangeEvent<HTMLInputElement>) => void;
-    };
-};

package/dist/collaboration/yjs-integration.d.ts

@@ -1,135 +0,0 @@
-/**
- * @file Nice2Dev Real-time Collaboration - Yjs/CRDT Integration
- * @description Real-time collaborative editing using Yjs CRDTs
- * @packageDocumentation
- */
-import * as Y from 'yjs';
-export interface CollaborationConfig {
-    /** Document ID */
-    documentId: string;
-    /** User information */
-    user: CollaborationUser;
-    /** Server URL for WebSocket */
-    serverUrl?: string;
-    /** Enable WebRTC for peer-to-peer */
-    useWebRTC?: boolean;
-    /** Enable offline persistence */
-    persistence?: boolean;
-    /** Awareness features */
-    awareness?: AwarenessConfig;
-}
-export interface CollaborationUser {
-    id: string;
-    name: string;
-    color: string;
-    avatar?: string;
-}
-export interface AwarenessConfig {
-    /** Update interval in ms */
-    updateInterval?: number;
-    /** Show cursors */
-    showCursors?: boolean;
-    /** Show selections */
-    showSelections?: boolean;
-    /** Show user presence */
-    showPresence?: boolean;
-}
-export interface AwarenessState {
-    user: CollaborationUser;
-    cursor?: {
-        x: number;
-        y: number;
-    };
-    selection?: {
-        start: number;
-        end: number;
-    };
-    field?: string;
-    lastActive: number;
-}
-export interface CollaborationState {
-    isConnected: boolean;
-    isSynced: boolean;
-    users: CollaborationUser[];
-    awareness: Map<number, AwarenessState>;
-}
-/**
- * Main collaboration hook - creates and manages a Yjs document
- */
-export declare function useCollaboration(config: CollaborationConfig): {
-    ydoc: Y.Doc | null;
-    state: CollaborationState;
-    updateAwareness: (update: Partial<AwarenessState>) => void;
-};
-/**
- * Hook for collaborative text editing
- */
-export declare function useCollaborativeText(ydoc: Y.Doc | null, fieldName: string): {
-    value: string;
-    insert: (index: number, text: string) => void;
-    delete: (index: number, length: number) => void;
-    replace: (newValue: string) => void;
-    ytext: Y.Text | null;
-};
-/**
- * Hook for collaborative arrays (e.g., table rows, list items)
- */
-export declare function useCollaborativeArray<T>(ydoc: Y.Doc | null, arrayName: string): {
-    items: T[];
-    push: (...newItems: T[]) => void;
-    insert: (index: number, ...newItems: T[]) => void;
-    delete: (index: number, length?: number) => void;
-    update: (index: number, value: T) => void;
-    move: (fromIndex: number, toIndex: number) => void;
-    yarray: Y.Array<T> | null;
-};
-/**
- * Hook for collaborative maps (e.g., form fields)
- */
-export declare function useCollaborativeMap<T extends Record<string, unknown>>(ydoc: Y.Doc | null, mapName: string): {
-    data: Partial<T>;
-    set: <K extends keyof T>(key: K, value: T[K]) => void;
-    get: <K extends keyof T>(key: K) => T[K] | undefined;
-    delete: (key: keyof T) => void;
-    setMultiple: (updates: Partial<T>) => void;
-    ymap: Y.Map<unknown> | null;
-};
-/**
- * Hook for tracking and displaying user cursors
- */
-export declare function useCursorTracking(updateAwareness: (update: Partial<AwarenessState>) => void, enabled?: boolean): void;
-/**
- * Hook for tracking text selection
- */
-export declare function useSelectionTracking(updateAwareness: (update: Partial<AwarenessState>) => void, fieldName: string, enabled?: boolean): void;
-/**
- * Hook for collaborative undo/redo
- */
-export declare function useCollaborativeHistory(ydoc: Y.Doc | null): {
-    undo: () => void;
-    redo: () => void;
-    canUndo: boolean;
-    canRedo: boolean;
-};
-export interface PresenceAvatarsProps {
-    users: CollaborationUser[];
-    maxDisplay?: number;
-    size?: 'sm' | 'md' | 'lg';
-    className?: string;
-}
-/**
- * Component displaying active collaborators
- */
-export declare function PresenceAvatars({ users, maxDisplay, size, className, }: PresenceAvatarsProps): import("react").JSX.Element;
-export interface CursorOverlayProps {
-    awareness: Map<number, AwarenessState>;
-    localClientId: number;
-}
-/**
- * Component displaying other users' cursors
- */
-export declare function CursorOverlay({ awareness, localClientId }: CursorOverlayProps): import("react").JSX.Element;
-export * from 'yjs';
-export { WebsocketProvider } from 'y-websocket';
-export { WebrtcProvider } from 'y-webrtc';
-export { IndexeddbPersistence } from 'y-indexeddb';

package/dist/communication-controls.d.ts

@@ -1,369 +0,0 @@
-/**
- * @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;
-};