@fileverse-dev/dsheet 2.1.1 → 2.1.2-dropIn-2

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,7 +1,7 @@
-import { default as React, ComponentProps } from 'react';
-import { Workbook } from '../../sheet-engine/react';
+import { default as React } from 'react';
 import { SmartContractQueryHandler } from '../utils/after-update-cell';
 import { OnboardingHandlerType, DataBlockApiKeyHandlerType } from '../types';
+import { CommentsConfig } from '../types/comments';
 
 type OnboardingHandler = OnboardingHandlerType;
 type DataBlockApiKeyHandler = DataBlockApiKeyHandlerType;
@@ -12,15 +12,13 @@ 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;
@@ -29,8 +27,5 @@ interface EditorWorkbookProps {
     onSheetCountChange?: (sheetCount: number) => void;
     handleSmartContractQuery?: SmartContractQueryHandler;
 }
-/**
- * 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/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

@@ -2,6 +2,7 @@ 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 { CommentsConfig } from '../types/comments';
 import { CollaborationProps, CollabState, CollabUser } from '../../sync-local/types';
 import { Awareness } from 'y-protocols/awareness';
 
@@ -50,7 +51,6 @@ export interface EditorContextType {
     handleLiveQuery: (subsheetIndex: number, data: LiveQueryData) => void;
 }
 interface EditorProviderProps {
-    allowComments?: boolean;
     setSelectedTemplate?: React.Dispatch<React.SetStateAction<string>>;
     setShowSmartContractModal?: React.Dispatch<React.SetStateAction<boolean>>;
     getDocumentTitle?: (dsheetId: string) => Promise<string>;
@@ -65,7 +65,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;

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, dataBlockApiKeyHandler, setFetchingURLData, setShowFetchURLModal, setInputFetchURLDataBlock, sheetEditorRef: externalSheetEditorRef, storeApiKey, onDuneChartEmbed, onSheetCountChange, onDataBlockApiResponse, isAuthorized, getDocumentTitle, updateDocumentTitle, setShowSmartContractModal, editorStateRef, handleSmartContractQuery, setSelectedTemplate, isNewSheet, liveQueryRefreshRate, enableLiveQuery, collaboration, customPanels, }: DsheetProps) => JSX.Element;
 export default SpreadsheetEditor;

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

@@ -0,0 +1,131 @@
+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;
+}

package/dist/editor/types.d.ts

@@ -1,10 +1,13 @@
-import { Sheet, Workbook, WorkbookInstance, Cell } from '../sheet-engine/react';
-import { ComponentProps, RefObject } from 'react';
+import { Sheet, WorkbookInstance, Cell } from '../sheet-engine/react';
+import { RefObject } from 'react';
 import { ERROR_MESSAGES_FLAG } from './constants/shared-constants';
 import { SmartContractQueryHandler } from './utils/after-update-cell';
 import { CollaborationProps } from '../sync-local/types';
+import { CommentsConfig } from './types/comments';
 
 import * as Y from 'yjs';
+export type { CommentThread, CommentReply, CommentActionParams, CommentsConfig, } from './types/comments';
+export { CommentAction } from './types/comments';
 export interface SheetUpdateData {
     data: Sheet[];
 }
@@ -12,7 +15,19 @@ export interface EditorValues {
     sheetEditorRef: RefObject<WorkbookInstance>;
     currentDataRef: React.MutableRefObject<Sheet[] | null>;
     ydocRef: React.RefObject<Y.Doc | null>;
+    openPanel: (panelId: string) => void;
+    closePanel: () => void;
 }
+export interface PanelConfig {
+    id: string;
+    header: {
+        title: string;
+        subtitle?: string;
+    };
+    width?: string;
+    content: React.ReactNode;
+}
+export type { PanelId, BuiltInPanelType, } from './components/sidebar/use-right-panels';
 export type OnboardingHandlerType = (params: {
     row: number;
     column: number;
@@ -69,14 +84,12 @@ export interface DsheetProps {
     onboardingHandler?: OnboardingHandlerType;
     dataBlockApiKeyHandler?: DataBlockApiKeyHandlerType;
     setForceSheetRender?: React.Dispatch<React.SetStateAction<number>>;
-    getCommentCellUI?: ComponentProps<typeof Workbook>['getCommentCellUI'];
-    commentData?: Object;
+    commentsConfig?: CommentsConfig;
     toggleTemplateSidebar?: () => void;
     sheetEditorRef?: RefObject<WorkbookInstance & {
         refreshIndexedDB: () => Promise<void>;
     }>;
     storeApiKey?: (apiKeyName: string) => void;
-    allowComments?: boolean;
     onDataBlockApiResponse?: (dataBlockName: string) => void;
     onDuneChartEmbed?: () => void;
     onSheetCountChange?: (sheetCount: number) => void;
@@ -86,6 +99,7 @@ export interface DsheetProps {
     handleSmartContractQuery?: SmartContractQueryHandler;
     enableLiveQuery?: boolean;
     liveQueryRefreshRate?: number;
+    customPanels?: PanelConfig[];
 }
 export type BaseError = {
     message: string;

package/dist/editor/utils/api-keys-local-storage.d.ts

@@ -0,0 +1,17 @@
+export declare const INVALID_KEY_MARKER = "_invalid";
+export declare const RATE_LIMITED_KEYS = "RATE_LIMITED_KEYS";
+export declare const DATABLOCK_API_KEYS: string[];
+export declare class ApiKeyStorageHelper {
+    static getApiKey(keyName: string): string;
+    static clearApiKeys(): void;
+    static saveApiKey(keyName: string, key: string): void;
+    static getAllSupportedApiKeys(): Record<string, string>;
+    static getListOfRateLimitedKeys(): any;
+    static markKeyAsRateLimited(key: string): void;
+}
+export declare const getApiKey: (keyName: string) => string;
+export declare const clearApiKeys: () => void;
+export declare const saveApiKey: (keyName: string, key: string) => void;
+export declare const getListOfRateLimitedKeys: () => any;
+export declare const getAllSupportedApiKeysInLs: () => Record<string, string>;
+export declare const markKeyAsRateLimited: (key: string) => void;

package/dist/editor/utils/cell-comment-marker.d.ts

@@ -0,0 +1,29 @@
+type SheetEditorRefLike = {
+    current: {
+        getWorkbookSetContext?: () => unknown;
+    } | null;
+} | null | undefined;
+/**
+ * Clears the comment indicator from a cell.
+ *
+ * - Hides the package-rendered marker DOM node immediately so the user sees
+ *   the change without waiting for a re-render.
+ * - Sets `cell.ps = undefined` in the workbook model so the dsheet package
+ *   stops drawing the marker on subsequent renders / persists.
+ *
+ * Used on top-level comment delete and on top-level comment resolve.
+ */
+export declare const hideCellCommentMarker: (sheetEditorRef: SheetEditorRefLike, row: number, col: number) => void;
+/**
+ * Restores the comment indicator on a cell.
+ *
+ * - Removes the inline `display: none` we set on hide so the package's marker
+ *   DOM node becomes visible again if it still exists.
+ * - Re-creates a minimal `cell.ps` stub in the workbook model so the package
+ *   redraws the marker on next render. Geometry fields are `null` so the
+ *   package recomputes them; the existing `ps` is preserved if already set.
+ *
+ * Used on top-level comment unresolve.
+ */
+export declare const showCellCommentMarker: (sheetEditorRef: SheetEditorRefLike, row: number, col: number, value?: string) => void;
+export {};

package/dist/editor/utils/comment-key-utils.d.ts

@@ -0,0 +1,7 @@
+import { CellPosition } from '../types/comments';
+
+export declare const parseCellKey: (key: string) => CellPosition | null;
+export declare const generateWithoutCellKey: (dataLength: number) => string;
+export declare const isCellComment: (key: string) => boolean;
+export declare const getCellReference: (row: number, col: number) => string;
+export declare const formatCommentDateTime: (dateString: string) => string;