@fileverse-dev/dsheet 2.1.2 → 2.1.3-package-cleanup-1

package/dist/editor/components/api-key-modal/api-key-input.d.ts

@@ -0,0 +1,5 @@
+export declare const ApiKeyInput: ({ name, onSave, onCancel, }: {
+    name: string;
+    onSave: (value: string) => void;
+    onCancel: () => void;
+}) => import("react/jsx-runtime").JSX.Element;

package/dist/editor/components/api-key-modal/api-key-modal.d.ts

@@ -0,0 +1,7 @@
+export interface ApiKeyModalProps {
+    open: boolean;
+    apiKeyName: string;
+    onSave: (key: string) => void;
+    onClose: () => void;
+}
+export declare const ApiKeyModal: ({ open, apiKeyName, onSave, onClose, }: ApiKeyModalProps) => import("react/jsx-runtime").JSX.Element;

package/dist/editor/components/api-key-modal/rate-limit-info.d.ts

@@ -0,0 +1,4 @@
+export declare const RateLimitInfo: ({ onInsertKey, name, }: {
+    onInsertKey: () => void;
+    name: string;
+}) => import("react/jsx-runtime").JSX.Element;

package/dist/editor/components/comments/comment-actions-dropdown.d.ts

@@ -0,0 +1,19 @@
+import { default as React } from 'react';
+import { CommentThread, CommentReply, CommentActionParams } from '../../types/comments';
+
+interface CommentActionsDropdownProps {
+    comment: CommentThread | CommentReply;
+    onAction: (action: CommentActionParams) => void;
+    isReply?: boolean;
+    parentCommentId?: string;
+    ownerAddress?: string;
+    currentUserName?: string;
+    currentUserAddress?: string;
+    isOwner?: boolean;
+    dsheetId?: string;
+    commentKey?: string;
+    row: number;
+    col: number;
+}
+export declare const CommentActionsDropdown: React.FC<CommentActionsDropdownProps>;
+export {};

package/dist/editor/components/comments/comment-cell-popup.d.ts

@@ -0,0 +1,4 @@
+import { default as React } from 'react';
+import { CommentCellUIProps } from '../../types/comments';
+
+export declare const CommentCellUI: React.FC<CommentCellUIProps>;

package/dist/editor/components/comments/comment-input.d.ts

@@ -0,0 +1,4 @@
+import { default as React } from 'react';
+import { CommentInputProps } from '../../types/comments';
+
+export declare const CommentInput: React.FC<CommentInputProps>;

package/dist/editor/components/comments/comment-item.d.ts

@@ -0,0 +1,4 @@
+import { default as React } from 'react';
+import { CommentItemProps } from '../../types/comments';
+
+export declare const CommentItem: React.FC<CommentItemProps>;

package/dist/editor/components/comments/comment-sidebar-empty.d.ts

@@ -0,0 +1,4 @@
+declare const CommentSidebarEmpty: ({ setShowComment, }: {
+    setShowComment: React.Dispatch<React.SetStateAction<boolean>>;
+}) => import("react/jsx-runtime").JSX.Element;
+export { CommentSidebarEmpty };

package/dist/editor/components/comments/comment-sidebar.d.ts

@@ -0,0 +1,4 @@
+import { default as React } from 'react';
+import { CommentsContentProps } from '../../types/comments';
+
+export declare const CommentsContent: React.FC<CommentsContentProps>;

package/dist/editor/components/comments/ens/ens-cache.d.ts

@@ -0,0 +1,10 @@
+export interface EnsStatus {
+    name: string;
+    isEns: boolean;
+}
+/** Push the host-provided RPC URL into the singleton (called from EditorContent). */
+export declare const setEnsResolutionUrl: (url: string | undefined) => void;
+export declare const subscribeEns: (cb: () => void) => () => boolean;
+export declare const getCachedEns: (username: string) => EnsStatus | undefined;
+/** Resolve `username` to an EnsStatus, deduped + cached. No-op if already cached/in-flight. */
+export declare const resolveEns: (username: string) => Promise<void>;

package/dist/editor/components/comments/ens/use-ens-status.d.ts

@@ -0,0 +1,10 @@
+import { EnsStatus } from './ens-cache';
+
+/**
+ * Resolve a comment username to a display name + ENS flag.
+ * - Empty → "Anonymous".
+ * - Cache hit → returned immediately.
+ * - Miss → triggers a deduped resolve; re-renders when it lands.
+ * - Plain names short-circuit inside getAddressName (no network).
+ */
+export declare const useEnsStatus: (username?: string) => EnsStatus;

package/dist/editor/components/comments/use-comment-cell-popup.d.ts

@@ -0,0 +1,12 @@
+export declare const useCommentCell: ({ onSendComment, cellKey, }: {
+    onSendComment: (commentKey: string, textareaId: string) => void;
+    cellKey: string;
+}) => {
+    cellKey: string;
+    textareaId: string;
+    handleSend: (textareaId: string) => void;
+    handleKeyDown: (e: React.KeyboardEvent) => void;
+    handleDoubleClick: (e: React.MouseEvent) => void;
+    handleScroll: (e: React.UIEvent) => void;
+    handler: (e: WheelEvent) => void;
+};

package/dist/editor/components/comments/use-comment-permissions.d.ts

@@ -0,0 +1,15 @@
+export declare const useCommentPermissions: (ownerAddress?: string, currentUserName?: string, currentUserAddress?: string, isOwner?: boolean) => {
+    canDeleteComment: (item: {
+        username: string;
+    }) => boolean;
+    canResolveComment: (item: {
+        username: string;
+    }) => boolean;
+    canDeleteReply: (item: {
+        username: string;
+    }) => boolean;
+    canResolveReply: (item: {
+        username: string;
+    }) => boolean;
+    isOwner: boolean;
+};

package/dist/editor/components/editor-workbook.d.ts

@@ -1,10 +1,11 @@
-import { default as React, ComponentProps } from 'react';
-import { Workbook } from '../../sheet-engine/react';
+import { default as React } from 'react';
+import { SidebarPortalRegistryHandle, SidebarPortalRenderer } from '../../sheet-engine/react';
+import { ThemeKey } from '../../sheet-engine/core/theme';
 import { SmartContractQueryHandler } from '../utils/after-update-cell';
-import { OnboardingHandlerType, DataBlockApiKeyHandlerType } from '../types';
+import { OnboardingHandlerType } from '../types';
+import { CommentsConfig } from '../types/comments';
 
 type OnboardingHandler = OnboardingHandlerType;
-type DataBlockApiKeyHandler = DataBlockApiKeyHandlerType;
 interface EditorWorkbookProps {
     setShowSmartContractModal?: React.Dispatch<React.SetStateAction<boolean>>;
     setShowFetchURLModal?: React.Dispatch<React.SetStateAction<boolean>>;
@@ -12,25 +13,21 @@ interface EditorWorkbookProps {
     setInputFetchURLDataBlock?: React.Dispatch<React.SetStateAction<string>>;
     isReadOnly?: boolean;
     allowSheetDownload?: boolean;
-    allowComments?: boolean;
     toggleTemplateSidebar?: () => void;
     onboardingComplete?: boolean;
     onboardingCompleteLocalStorageKey?: string;
     onboardingHandler?: OnboardingHandler;
-    dataBlockApiKeyHandler?: DataBlockApiKeyHandler;
     exportDropdownOpen?: boolean;
-    commentData?: Object;
-    getCommentCellUI?: ComponentProps<typeof Workbook>['getCommentCellUI'];
+    commentsConfig?: CommentsConfig;
     setExportDropdownOpen?: React.Dispatch<React.SetStateAction<boolean>>;
     dsheetId: string;
-    storeApiKey?: (apiKeyName: string) => void;
-    onDataBlockApiResponse?: (dataBlockName: string) => void;
     onDuneChartEmbed?: () => void;
     onSheetCountChange?: (sheetCount: number) => void;
     handleSmartContractQuery?: SmartContractQueryHandler;
+    sidebarActivePanel?: string | null;
+    sidebarPortalRegistry?: SidebarPortalRegistryHandle | null;
+    sidebarPortalRenderers?: Record<string, SidebarPortalRenderer>;
+    theme?: ThemeKey;
 }
-/**
- * EditorWorkbook component handles rendering the Fortune Workbook with proper configuration
- */
-export declare const EditorWorkbook: React.FC<EditorWorkbookProps>;
+export declare const EditorWorkbook: React.NamedExoticComponent<EditorWorkbookProps>;
 export {};

package/dist/editor/components/sidebar/editor-right-sidebar.d.ts

@@ -0,0 +1,20 @@
+import { ReactNode } from 'react';
+
+export interface ActivePanelConfig {
+    id: string;
+    width: string;
+    header: {
+        title: string;
+        subtitle?: string;
+    };
+    content: ReactNode;
+}
+interface EditorRightSidebarProps {
+    isOpen: boolean;
+    activePanelConfig: ActivePanelConfig | null;
+    onClose: () => void;
+    /** Read/preview mode hides the toolbar, so the sidebar starts higher. */
+    isReadOnly?: boolean;
+}
+export declare const EditorRightSidebar: ({ isOpen, activePanelConfig, onClose, isReadOnly, }: EditorRightSidebarProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/editor/components/sidebar/right-sidebar.d.ts

@@ -0,0 +1,14 @@
+import { ReactNode } from 'react';
+
+export declare function RightSidebar({ width, className, children, isOpen, top, height, }: Readonly<{
+    width?: string;
+    className?: string;
+    children: ReactNode;
+    isOpen?: boolean;
+    top?: string;
+    height?: string;
+}>): import("react/jsx-runtime").JSX.Element;
+export declare function RightSidebarHeader({ className, children, }: Readonly<{
+    className?: string;
+    children: ReactNode;
+}>): import("react/jsx-runtime").JSX.Element;

package/dist/editor/components/sidebar/sidebar-context.d.ts

@@ -0,0 +1,17 @@
+import { ReactNode } from 'react';
+import { PanelId } from './use-right-panels';
+
+interface SidebarContextType {
+    activePanel: PanelId | null;
+    isOpen: boolean;
+    openPanel: (panel: PanelId) => void;
+    closePanel: () => void;
+    togglePanel: (panel: PanelId) => void;
+    isActive: (panel: PanelId) => boolean;
+}
+export declare function SidebarProvider({ children, isReadMode, }: Readonly<{
+    children: ReactNode;
+    isReadMode?: boolean;
+}>): import("react/jsx-runtime").JSX.Element;
+export declare function useSidebar(): SidebarContextType;
+export {};

package/dist/editor/components/sidebar/sidebar-portal-registry.d.ts

@@ -0,0 +1,20 @@
+import { CSSProperties, ReactNode } from 'react';
+
+export type SidebarPortalTargets = Record<string, HTMLElement>;
+export type SidebarPortalRegistryHandle = {
+    getTargets: () => SidebarPortalTargets;
+    subscribe: (onStoreChange: () => void) => () => void;
+};
+export declare function SidebarPortalRegistryProvider({ children, }: Readonly<{
+    children: ReactNode;
+}>): import("react/jsx-runtime").JSX.Element;
+export declare function useSidebarPortalRegistryHandle(): SidebarPortalRegistryHandle;
+export declare function useSidebarPortalTargets(): SidebarPortalTargets;
+export declare function useSidebarPortalTarget(panelId: string): (node: HTMLElement | null) => void;
+interface SidebarPortalSlotProps {
+    panelId: string;
+    className?: string;
+    style?: CSSProperties;
+}
+export declare function SidebarPortalSlot({ panelId, className, style, }: Readonly<SidebarPortalSlotProps>): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/editor/components/sidebar/use-right-panels.d.ts

@@ -0,0 +1,12 @@
+export type BuiltInPanelType = 'templates' | 'comments' | 'functions' | 'data-verification' | 'conditional-format';
+export type PanelId = BuiltInPanelType | string;
+interface UseRightPanelsReturn {
+    activePanel: PanelId | null;
+    isOpen: boolean;
+    openPanel: (panel: PanelId) => void;
+    closePanel: () => void;
+    togglePanel: (panel: PanelId) => void;
+    isActive: (panel: PanelId) => boolean;
+}
+export declare const useRightPanels: (isReadMode?: boolean) => UseRightPanelsReturn;
+export {};

package/dist/editor/components/sidebars/conditional-format.d.ts

@@ -0,0 +1,2 @@
+declare const ConditionalFormat: () => import("react/jsx-runtime").JSX.Element;
+export { ConditionalFormat };

package/dist/editor/components/sidebars/data-verification.d.ts

@@ -0,0 +1,2 @@
+declare const DataVerification: () => import("react/jsx-runtime").JSX.Element;
+export { DataVerification };

package/dist/editor/components/sidebars/function/function-categories-logic.d.ts

@@ -0,0 +1,11 @@
+import { SpreadsheetFunction } from './types';
+
+export declare const PARSER_FUNCTIONS: Set<string>;
+export declare const TYPE_TO_CATEGORY_KEY: Record<number, string>;
+export declare const CATEGORY_ORDER: readonly ["All", "Datablock", "Array", "Database", "Date", "Engineering", "Financial", "Info", "Logical", "Lookup", "Math", "Operator", "Parser", "Statistical", "Text", "Other"];
+export type CategoryKey = (typeof CATEGORY_ORDER)[number];
+export declare function getFunctionCategoryKey(fnName: string, typeId: number): CategoryKey;
+export declare function groupFunctionsByCategory(functionlist: SpreadsheetFunction[]): {
+    categories: ("Text" | "Date" | "Other" | "Logical" | "All" | "Array" | "Database" | "Engineering" | "Datablock" | "Financial" | "Lookup" | "Math" | "Operator" | "Parser" | "Statistical" | "Info")[];
+    byCategory: Map<"Text" | "Date" | "Other" | "Logical" | "All" | "Array" | "Database" | "Engineering" | "Datablock" | "Financial" | "Lookup" | "Math" | "Operator" | "Parser" | "Statistical" | "Info", SpreadsheetFunction[]>;
+};

package/dist/editor/components/sidebars/function/function-categories.d.ts

@@ -0,0 +1,6 @@
+declare const FunctionCategories: ({ onCategorySelection, categories, categoryName, }: {
+    onCategorySelection: (value: string) => void;
+    categoryName: string;
+    categories: string[];
+}) => import("react/jsx-runtime").JSX.Element;
+export default FunctionCategories;

package/dist/editor/components/sidebars/function/function-metadata.d.ts

@@ -0,0 +1,7 @@
+import { SpreadsheetFunction } from './types';
+
+declare const FunctionMetadata: ({ selectedFunction, onInsert, }: {
+    selectedFunction: SpreadsheetFunction;
+    onInsert: () => void;
+}) => import("react/jsx-runtime").JSX.Element;
+export default FunctionMetadata;

package/dist/editor/components/sidebars/function/functionList.d.ts

@@ -0,0 +1,8 @@
+import { SpreadsheetFunction } from './types';
+
+declare const FunctionList: ({ list, onFunctionSelection, selectedFunction, }: {
+    list: SpreadsheetFunction[];
+    onFunctionSelection: (data: SpreadsheetFunction, functionIndex: number) => void;
+    selectedFunction: SpreadsheetFunction | null;
+}) => import("react/jsx-runtime").JSX.Element;
+export default FunctionList;

package/dist/editor/components/sidebars/function/types.d.ts

@@ -0,0 +1,24 @@
+export type FunctionParam = {
+    name: string;
+    detail: string;
+    example: string;
+    require: string;
+    repeat: string;
+    type: string;
+};
+export type SpreadsheetFunction = {
+    API_KEY: string;
+    LOGO: string;
+    BRAND_COLOR: string;
+    n: string;
+    t: any;
+    d: string;
+    a: string;
+    m?: number[];
+    p: FunctionParam[];
+    examples: {
+        title: string;
+        argumentString: string;
+        description: string;
+    }[];
+};

package/dist/editor/components/sidebars/function/use-functions.d.ts

@@ -0,0 +1,20 @@
+import { WorkbookInstance } from '../../../../sheet-engine/react';
+import { default as React } from 'react';
+import { SpreadsheetFunction } from './types';
+
+declare const useFunctions: (sheetEditorRef: React.RefObject<WorkbookInstance>, shouldHandleSuggestionFromCell: number) => {
+    filteredFunctionList: SpreadsheetFunction[];
+    functionIndex: number;
+    setFunctionIndex: React.Dispatch<React.SetStateAction<number>>;
+    setSearchText: React.Dispatch<React.SetStateAction<string>>;
+    selectedFunction: SpreadsheetFunction | null;
+    groupedFunctions: {
+        categories: ("Text" | "Date" | "Other" | "Logical" | "All" | "Array" | "Database" | "Engineering" | "Datablock" | "Financial" | "Lookup" | "Math" | "Operator" | "Parser" | "Statistical" | "Info")[];
+        byCategory: Map<"Text" | "Date" | "Other" | "Logical" | "All" | "Array" | "Database" | "Engineering" | "Datablock" | "Financial" | "Lookup" | "Math" | "Operator" | "Parser" | "Statistical" | "Info", SpreadsheetFunction[]>;
+    };
+    setSelectedCategory: React.Dispatch<React.SetStateAction<"Text" | "Date" | "Other" | "Logical" | "All" | "Array" | "Database" | "Engineering" | "Datablock" | "Financial" | "Lookup" | "Math" | "Operator" | "Parser" | "Statistical" | "Info">>;
+    setSelectedFunction: React.Dispatch<React.SetStateAction<SpreadsheetFunction | null>>;
+    searchText: string;
+    selectedCategoryName: "Text" | "Date" | "Other" | "Logical" | "All" | "Array" | "Database" | "Engineering" | "Datablock" | "Financial" | "Lookup" | "Math" | "Operator" | "Parser" | "Statistical" | "Info";
+};
+export default useFunctions;

package/dist/editor/components/sidebars/function-content.d.ts

@@ -0,0 +1,8 @@
+import { default as React } from 'react';
+import { WorkbookInstance } from '../../../sheet-engine/react';
+
+declare const FunctionContent: ({ sheetEditorRef, shouldHandleSuggestionFromCell, }: {
+    sheetEditorRef: React.RefObject<WorkbookInstance>;
+    shouldHandleSuggestionFromCell: number;
+}) => import("react/jsx-runtime").JSX.Element;
+export default FunctionContent;

package/dist/editor/components/sidebars/template-ui.d.ts

@@ -0,0 +1,22 @@
+export interface Template {
+    slug: string;
+    title: string;
+    description: string;
+    thumbnail: string;
+    fullImage: string;
+    category?: string;
+    isProTemplate: boolean;
+    techStack: {
+        name: string;
+        image: string;
+    }[];
+}
+export declare const TemplateCard: ({ template, onMouseEnter, onMouseLeave, onSelect, }: {
+    template: Template;
+    onMouseEnter?: () => void;
+    onMouseLeave?: () => void;
+    onSelect: () => void;
+}) => import("react/jsx-runtime").JSX.Element;
+export declare const TemplatePreview: ({ template }: {
+    template: Template;
+}) => import("react/jsx-runtime").JSX.Element;

package/dist/editor/components/sidebars/templates.d.ts

@@ -0,0 +1,9 @@
+import { default as React } from 'react';
+import { Template } from './template-ui';
+
+interface TemplatesProps {
+    setSelectedTemplate: (template: string) => void;
+    setHoveredTemplate: React.Dispatch<React.SetStateAction<Template | null>>;
+}
+export declare const Templates: ({ setSelectedTemplate, setHoveredTemplate, }: TemplatesProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/editor/contexts/editor-context.d.ts

@@ -1,7 +1,10 @@
 import { default as React } from 'react';
 import { LiveQueryData, Sheet, WorkbookInstance } from '../../sheet-engine/react';
 import { IndexeddbPersistence } from 'y-indexeddb';
-import { DataBlockApiKeyHandlerType, SheetUpdateData } from '../types';
+import { SheetUpdateData, DataBlockEvent } from '../types';
+import { CommentsConfig } from '../types/comments';
+import { ApiKeyStorage } from '../utils/api-key-storage';
+import { OpenApiKeyModalFn } from '../utils/data-block-error-handler';
 import { CollaborationProps, CollabState, CollabUser } from '../../sync-local/types';
 import { Awareness } from 'y-protocols/awareness';
 
@@ -48,9 +51,17 @@ export interface EditorContextType {
     terminateSession?: () => void;
     onCollaboratorsChange?: (collaborators: CollabUser[]) => void;
     handleLiveQuery: (subsheetIndex: number, data: LiveQueryData) => void;
+    apiKeyStorage: ApiKeyStorage;
+    onDataBlockEvent?: (event: DataBlockEvent) => void;
+    openApiKeyModal: OpenApiKeyModalFn;
+    apiKeyModalState: {
+        open: boolean;
+        apiKeyName: string;
+        onSave: (key: string) => void;
+        onClose: () => void;
+    } | null;
 }
 interface EditorProviderProps {
-    allowComments?: boolean;
     setSelectedTemplate?: React.Dispatch<React.SetStateAction<string>>;
     setShowSmartContractModal?: React.Dispatch<React.SetStateAction<boolean>>;
     getDocumentTitle?: (dsheetId: string) => Promise<string>;
@@ -65,7 +76,7 @@ interface EditorProviderProps {
     onChange?: (data: SheetUpdateData, encodedUpdate?: string) => void;
     collaboration?: CollaborationProps;
     externalEditorRef?: React.MutableRefObject<WorkbookInstance | null>;
-    commentData?: object;
+    commentsConfig?: CommentsConfig;
     editorStateRef?: React.MutableRefObject<{
         refreshIndexedDB: () => Promise<void>;
         terminateSession?: () => void;
@@ -74,7 +85,8 @@ interface EditorProviderProps {
     } | null>;
     enableLiveQuery?: boolean;
     liveQueryRefreshRate?: number;
-    dataBlockApiKeyHandler?: DataBlockApiKeyHandlerType;
+    apiKeyStorage?: ApiKeyStorage;
+    onDataBlockEvent?: (event: DataBlockEvent) => void;
 }
 export declare const EditorProvider: React.FC<EditorProviderProps>;
 export declare const useEditor: () => EditorContextType;

package/dist/editor/dsheet-editor.d.ts

@@ -7,5 +7,5 @@ import { DsheetProps } from './types';
  * @param props - Component properties
  * @returns The SpreadsheetEditor component
  */
-declare const SpreadsheetEditor: ({ isReadOnly, allowSheetDownload, allowComments, renderNavbar, enableIndexeddbSync, dsheetId, portalContent, onChange, username, selectedTemplate, toggleTemplateSidebar, isTemplateOpen, onboardingComplete, onboardingCompleteLocalStorageKey, onboardingHandler, commentData, getCommentCellUI, dataBlockApiKeyHandler, setFetchingURLData, setShowFetchURLModal, setInputFetchURLDataBlock, sheetEditorRef: externalSheetEditorRef, storeApiKey, onDuneChartEmbed, onSheetCountChange, onDataBlockApiResponse, isAuthorized, getDocumentTitle, updateDocumentTitle, setShowSmartContractModal, editorStateRef, handleSmartContractQuery, setSelectedTemplate, isNewSheet, liveQueryRefreshRate, enableLiveQuery, collaboration, }: DsheetProps) => JSX.Element;
+declare const SpreadsheetEditor: ({ isReadOnly, allowSheetDownload, renderNavbar, enableIndexeddbSync, dsheetId, portalContent, onChange, username, selectedTemplate, toggleTemplateSidebar, isTemplateOpen, onboardingComplete, onboardingCompleteLocalStorageKey, onboardingHandler, commentsConfig, setFetchingURLData, setShowFetchURLModal, setInputFetchURLDataBlock, sheetEditorRef: externalSheetEditorRef, onDuneChartEmbed, onSheetCountChange, isAuthorized, getDocumentTitle, updateDocumentTitle, setShowSmartContractModal, editorStateRef, handleSmartContractQuery, setSelectedTemplate, isNewSheet, liveQueryRefreshRate, enableLiveQuery, collaboration, customPanels, apiKeyStorage, onDataBlockEvent, theme, }: DsheetProps) => JSX.Element;
 export default SpreadsheetEditor;

package/dist/editor/hooks/live-query/use-live-query.d.ts

@@ -1,8 +1,10 @@
 import { LiveQueryData, Sheet, WorkbookInstance } from '../../../sheet-engine/react';
-import { DataBlockApiKeyHandlerType } from '../../types';
+import { ApiKeyStorage } from '../../utils/api-key-storage';
+import { OpenApiKeyModalFn } from '../../utils/data-block-error-handler';
+import { DataBlockEvent } from '../../types';
 
 export declare const LIVE_QUERY_ERROR = "LIVE_QUERY_ERROR";
-export declare const useLiveQuery: (sheetEditorRef: React.MutableRefObject<WorkbookInstance | null>, dataBlockApiKeyHandler?: DataBlockApiKeyHandlerType, enableLiveQuery?: boolean, refreshRate?: number) => {
+export declare const useLiveQuery: (sheetEditorRef: React.MutableRefObject<WorkbookInstance | null>, apiKeyStorage?: ApiKeyStorage, openApiKeyModal?: OpenApiKeyModalFn, onDataBlockEvent?: (event: DataBlockEvent) => void, enableLiveQuery?: boolean, refreshRate?: number) => {
     handleLiveQuery: (subsheetIndex: number, queryData: LiveQueryData) => void;
     initialiseLiveQueryData: (sheets: Sheet[]) => void;
 };

package/dist/editor/hooks/use-editor-data.d.ts

@@ -1,5 +1,7 @@
 import { Sheet, WorkbookInstance } from '../../sheet-engine/react';
-import { DataBlockApiKeyHandlerType } from '../types';
+import { ApiKeyStorage } from '../utils/api-key-storage';
+import { OpenApiKeyModalFn } from '../utils/data-block-error-handler';
+import { DataBlockEvent } from '../types';
 
 import * as Y from 'yjs';
 /**
@@ -14,7 +16,7 @@ export declare const useEditorData: (ydocRef: React.MutableRefObject<Y.Doc | nul
     [key: string]: {
         [key: string]: any;
     };
-}>>, enableLiveQuery?: boolean, liveQueryRefreshRate?: number, dataBlockApiKeyHandler?: DataBlockApiKeyHandlerType, allowComments?: boolean, hasCollabContentInitialised?: boolean, collabEnabled?: boolean) => {
+}>>, enableLiveQuery?: boolean, liveQueryRefreshRate?: number, apiKeyStorage?: ApiKeyStorage, openApiKeyModal?: OpenApiKeyModalFn, onDataBlockEvent?: (event: DataBlockEvent) => void, allowComments?: boolean, hasCollabContentInitialised?: boolean, collabEnabled?: boolean) => {
     sheetData: Sheet[];
     setSheetData: import('react').Dispatch<import('react').SetStateAction<Sheet[]>>;
     currentDataRef: import('react').MutableRefObject<Sheet[]>;

package/dist/editor/types/comments.d.ts

@@ -0,0 +1,133 @@
+import { default as React } from 'react';
+
+export interface CommentThread {
+    id: string;
+    key: string;
+    dsheetId: string;
+    username: string;
+    content: string;
+    createdAt: string;
+    commentIndex: number;
+    cellContent?: string;
+    replies: CommentReply[];
+    isResolved?: boolean;
+    isDeleted?: boolean;
+}
+export interface CommentReply {
+    id: string;
+    username: string;
+    content: string;
+    createdAt: string;
+    commentIndex: number;
+    isResolved?: boolean;
+    isDeleted?: boolean;
+}
+export declare enum CommentAction {
+    RESOLVE = "resolve",
+    UNRESOLVE = "unresolve",
+    DELETE = "delete"
+}
+export interface CommentActionParams {
+    action: CommentAction;
+    commentId: string;
+    dsheetId: string;
+    commentKey: string;
+    isReply?: boolean;
+    parentCommentId?: string;
+    row: number;
+    col: number;
+}
+export interface CommentsConfig {
+    commentsData: Record<string, CommentThread>;
+    onSendComment: (key: string, textareaId: string) => void;
+    onCommentAction: (action: CommentActionParams) => void;
+    userName?: string;
+    ownerAddress?: string;
+    currentUserAddress?: string;
+    isOwner?: boolean;
+    isAuthenticated?: boolean;
+    unauthenticatedFallback?: React.ReactNode;
+    ensResolutionUrl?: string;
+    disabled?: boolean;
+}
+export interface CellPosition {
+    row: number;
+    col: number;
+    sheetId?: string;
+}
+export interface SheetEditorRef {
+    scroll: (o: {
+        scrollLeft?: number;
+        scrollTop?: number;
+        targetRow?: number;
+        targetColumn?: number;
+    }) => void;
+    setSelection: (s: Array<{
+        row: number[];
+        column: number[];
+    }>) => void;
+}
+export interface CommentInputProps {
+    id: string;
+    onSend: (textareaId: string) => void;
+    placeholder?: string;
+    autoFocus?: boolean;
+    className?: string;
+    backgroundColor?: string;
+    inCellComment?: boolean;
+    cancelComment?: () => void;
+    onBlur?: () => void;
+    isStaticButton?: boolean;
+    removeCancelButton?: boolean;
+    focusTrap?: boolean;
+    disabled?: boolean;
+}
+export interface CommentItemProps {
+    comment: CommentThread;
+    showAvatar?: boolean;
+    avatarSize?: 'sm' | 'md' | 'lg';
+    className?: string;
+    isHovered?: boolean;
+    sheetName?: string;
+    cellReference?: string;
+    onAction?: (a: CommentActionParams) => void;
+    ownerAddress?: string;
+    currentUserAddress?: string;
+    isOwner?: boolean;
+    currentUserName?: string;
+    contentClassName?: string;
+    isCellPopup?: boolean;
+    shouldShowActions?: boolean;
+    row?: number;
+    col?: number;
+}
+export interface CommentCellUIProps {
+    row: number;
+    col: number;
+    sheetId: string;
+    comment?: CommentThread;
+    onSendComment: (commentKey: string, textareaId: string) => void;
+    onAction?: (a: CommentActionParams) => void;
+    ownerAddress?: string;
+    currentUserAddress?: string;
+    isOwner?: boolean;
+    sheetEditorRef?: React.RefObject<SheetEditorRef>;
+    currentUserName?: string;
+    removeCommentFromCell: (row: number, col: number) => void;
+    dragHandler: (e: React.MouseEvent<HTMLDivElement, MouseEvent>) => void;
+    isHover?: boolean;
+    disabled?: boolean;
+}
+export interface CommentsContentProps {
+    sheetEditorRef: React.RefObject<SheetEditorRef>;
+    userName: string | undefined;
+    commentsData: Record<string, CommentThread>;
+    onSendComment: (commentKey: string, textareaId: string) => void;
+    onCommentAction?: (a: CommentActionParams) => void;
+    ownerAddress?: string;
+    currentUserAddress?: string;
+    isOwner?: boolean;
+    disabled?: boolean;
+    isAuthenticated?: boolean;
+    unauthenticatedFallback?: React.ReactNode;
+}