@lumir-company/editor 0.4.1 → 0.4.3

package/dist/index.d.mts

@@ -1,6 +1,55 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { PartialBlock, DefaultBlockSchema, DefaultInlineContentSchema, DefaultStyleSchema, BlockNoteEditor } from '@blocknote/core';
+import * as _blocknote_core from '@blocknote/core';
+import { PartialBlock, DefaultBlockSchema, DefaultInlineContentSchema, DefaultStyleSchema, BlockNoteEditor, BlockNoteSchema } from '@blocknote/core';
 export { BlockNoteEditor, DefaultBlockSchema, DefaultInlineContentSchema, DefaultStyleSchema, PartialBlock } from '@blocknote/core';
+import React from 'react';
+
+/**
+ * LumirEditor 커스텀 에러 클래스
+ */
+type LumirErrorCode = "UPLOAD_FAILED" | "INVALID_FILE_TYPE" | "S3_CONFIG_ERROR" | "PRESIGNED_URL_ERROR" | "NETWORK_ERROR" | "EDITOR_ERROR" | "UNKNOWN_ERROR";
+interface LumirErrorDetails {
+    code: LumirErrorCode;
+    originalError?: Error;
+    context?: Record<string, unknown>;
+}
+/**
+ * LumirEditor에서 발생하는 에러를 위한 커스텀 에러 클래스
+ */
+declare class LumirEditorError extends Error {
+    readonly code: LumirErrorCode;
+    readonly originalError?: Error;
+    readonly context?: Record<string, unknown>;
+    constructor(message: string, details?: Partial<LumirErrorDetails>);
+    /**
+     * 에러 정보를 JSON 형태로 반환
+     */
+    toJSON(): Record<string, unknown>;
+    /**
+     * 사용자 친화적 에러 메시지 반환
+     */
+    getUserMessage(): string;
+    /**
+     * 일반 Error를 LumirEditorError로 변환
+     */
+    static fromError(error: Error, code?: LumirErrorCode, context?: Record<string, unknown>): LumirEditorError;
+    /**
+     * 업로드 실패 에러 생성
+     */
+    static uploadFailed(message: string, originalError?: Error): LumirEditorError;
+    /**
+     * 잘못된 파일 형식 에러 생성
+     */
+    static invalidFileType(fileName: string): LumirEditorError;
+    /**
+     * S3 설정 에러 생성
+     */
+    static s3ConfigError(message: string): LumirEditorError;
+    /**
+     * 네트워크 에러 생성
+     */
+    static networkError(originalError?: Error): LumirEditorError;
+}
 
 /**
  * LumirEditor에서 사용하는 BlockNote 에디터 타입
@@ -59,7 +108,22 @@ interface LumirEditorProps {
     onSelectionChange?: () => void;
     className?: string;
     sideMenuAddButton?: boolean;
+    floatingMenu?: boolean;
+    floatingMenuPosition?: "sticky" | "fixed";
+    linkPreview?: {
+        /** 링크 메타데이터를 가져올 API 엔드포인트 (예: "/api/link-preview") */
+        apiEndpoint: string;
+    };
     onContentChange?: (content: DefaultPartialBlock[]) => void;
+    /** 에러 발생 시 호출되는 콜백 */
+    onError?: (error: LumirEditorError) => void;
+    /**
+     * 이미지가 에디터에서 삭제될 때 호출되는 콜백
+     * - S3 등 외부 스토리지에서 이미지를 삭제하는 용도로 사용
+     * - Undo/Redo를 고려하여 지연 삭제를 권장
+     * @param imageUrl 삭제된 이미지의 URL
+     */
+    onImageDelete?: (imageUrl: string) => void;
 }
 
 /**
@@ -132,7 +196,7 @@ declare class EditorConfig {
      */
     static getDisabledExtensions(userExtensions?: string[], allowVideo?: boolean, allowAudio?: boolean, allowFile?: boolean): string[];
 }
-declare function LumirEditor({ initialContent, initialEmptyBlocks, uploadFile, s3Upload, tables, heading, defaultStyles, disableExtensions, tabBehavior, trailingBlock, allowVideoUpload, allowAudioUpload, allowFileUpload, editable, theme, formattingToolbar, linkToolbar, sideMenu, emojiPicker, filePanel, tableHandles, onSelectionChange, className, sideMenuAddButton, onContentChange, }: LumirEditorProps): react_jsx_runtime.JSX.Element;
+declare function LumirEditor({ initialContent, initialEmptyBlocks, uploadFile, s3Upload, tables, heading, defaultStyles, disableExtensions, tabBehavior, trailingBlock, allowVideoUpload, allowAudioUpload, allowFileUpload, linkPreview, editable, theme, formattingToolbar, linkToolbar, sideMenu, emojiPicker, filePanel, tableHandles, onSelectionChange, className, placeholder, sideMenuAddButton, floatingMenu, floatingMenuPosition, onContentChange, onError, onImageDelete, }: LumirEditorProps): react_jsx_runtime.JSX.Element;
 
 declare function cn(...inputs: (string | undefined | null | false)[]): string;
 
@@ -149,4 +213,807 @@ interface S3UploaderConfig {
 }
 declare const createS3Uploader: (config: S3UploaderConfig) => (file: File) => Promise<string>;
 
-export { ContentUtils, type DefaultPartialBlock, EditorConfig, type EditorType, LumirEditor, type LumirEditorProps, type S3UploaderConfig, cn, createS3Uploader };
+declare const HtmlPreviewBlock: {
+    config: {
+        readonly type: "htmlPreview";
+        readonly propSchema: {
+            readonly htmlContent: {
+                readonly default: "";
+            };
+            readonly fileName: {
+                readonly default: "";
+            };
+            readonly height: {
+                readonly default: "400px";
+            };
+        };
+        readonly content: "none";
+    };
+    implementation: _blocknote_core.TiptapBlockImplementation<{
+        readonly type: "htmlPreview";
+        readonly propSchema: {
+            readonly htmlContent: {
+                readonly default: "";
+            };
+            readonly fileName: {
+                readonly default: "";
+            };
+            readonly height: {
+                readonly default: "400px";
+            };
+        };
+        readonly content: "none";
+    }, any, _blocknote_core.InlineContentSchema, _blocknote_core.StyleSchema>;
+};
+declare const schema: BlockNoteSchema<_blocknote_core.BlockSchemaFromSpecs<{
+    htmlPreview: {
+        config: {
+            readonly type: "htmlPreview";
+            readonly propSchema: {
+                readonly htmlContent: {
+                    readonly default: "";
+                };
+                readonly fileName: {
+                    readonly default: "";
+                };
+                readonly height: {
+                    readonly default: "400px";
+                };
+            };
+            readonly content: "none";
+        };
+        implementation: _blocknote_core.TiptapBlockImplementation<{
+            readonly type: "htmlPreview";
+            readonly propSchema: {
+                readonly htmlContent: {
+                    readonly default: "";
+                };
+                readonly fileName: {
+                    readonly default: "";
+                };
+                readonly height: {
+                    readonly default: "400px";
+                };
+            };
+            readonly content: "none";
+        }, any, _blocknote_core.InlineContentSchema, _blocknote_core.StyleSchema>;
+    };
+    linkPreview: {
+        config: {
+            readonly type: "linkPreview";
+            readonly propSchema: {
+                readonly url: {
+                    readonly default: "";
+                };
+                readonly title: {
+                    readonly default: "";
+                };
+                readonly description: {
+                    readonly default: "";
+                };
+                readonly image: {
+                    readonly default: "";
+                };
+                readonly domain: {
+                    readonly default: "";
+                };
+                readonly previewWidth: {
+                    readonly default: 400;
+                };
+                readonly previewHeight: {
+                    readonly default: 200;
+                };
+            };
+            readonly content: "none";
+        };
+        implementation: _blocknote_core.TiptapBlockImplementation<{
+            readonly type: "linkPreview";
+            readonly propSchema: {
+                readonly url: {
+                    readonly default: "";
+                };
+                readonly title: {
+                    readonly default: "";
+                };
+                readonly description: {
+                    readonly default: "";
+                };
+                readonly image: {
+                    readonly default: "";
+                };
+                readonly domain: {
+                    readonly default: "";
+                };
+                readonly previewWidth: {
+                    readonly default: 400;
+                };
+                readonly previewHeight: {
+                    readonly default: 200;
+                };
+            };
+            readonly content: "none";
+        }, any, _blocknote_core.InlineContentSchema, _blocknote_core.StyleSchema>;
+    };
+    paragraph: {
+        config: {
+            type: "paragraph";
+            content: "inline";
+            propSchema: {
+                backgroundColor: {
+                    default: "default";
+                };
+                textColor: {
+                    default: "default";
+                };
+                textAlignment: {
+                    default: "left";
+                    values: readonly ["left", "center", "right", "justify"];
+                };
+            };
+        };
+        implementation: _blocknote_core.TiptapBlockImplementation<{
+            type: "paragraph";
+            content: "inline";
+            propSchema: {
+                backgroundColor: {
+                    default: "default";
+                };
+                textColor: {
+                    default: "default";
+                };
+                textAlignment: {
+                    default: "left";
+                    values: readonly ["left", "center", "right", "justify"];
+                };
+            };
+        }, any, _blocknote_core.InlineContentSchema, _blocknote_core.StyleSchema>;
+    };
+    heading: {
+        config: {
+            type: "heading";
+            content: "inline";
+            propSchema: {
+                level: {
+                    default: number;
+                    values: readonly [1, 2, 3, 4, 5, 6];
+                };
+                isToggleable: {
+                    default: false;
+                };
+                backgroundColor: {
+                    default: "default";
+                };
+                textColor: {
+                    default: "default";
+                };
+                textAlignment: {
+                    default: "left";
+                    values: readonly ["left", "center", "right", "justify"];
+                };
+            };
+        };
+        implementation: _blocknote_core.TiptapBlockImplementation<{
+            type: "heading";
+            content: "inline";
+            propSchema: {
+                level: {
+                    default: number;
+                    values: readonly [1, 2, 3, 4, 5, 6];
+                };
+                isToggleable: {
+                    default: false;
+                };
+                backgroundColor: {
+                    default: "default";
+                };
+                textColor: {
+                    default: "default";
+                };
+                textAlignment: {
+                    default: "left";
+                    values: readonly ["left", "center", "right", "justify"];
+                };
+            };
+        }, any, _blocknote_core.InlineContentSchema, _blocknote_core.StyleSchema>;
+    };
+    quote: {
+        config: {
+            type: "quote";
+            content: "inline";
+            propSchema: {
+                backgroundColor: {
+                    default: "default";
+                };
+                textColor: {
+                    default: "default";
+                };
+                textAlignment: {
+                    default: "left";
+                    values: readonly ["left", "center", "right", "justify"];
+                };
+            };
+        };
+        implementation: _blocknote_core.TiptapBlockImplementation<{
+            type: "quote";
+            content: "inline";
+            propSchema: {
+                backgroundColor: {
+                    default: "default";
+                };
+                textColor: {
+                    default: "default";
+                };
+                textAlignment: {
+                    default: "left";
+                    values: readonly ["left", "center", "right", "justify"];
+                };
+            };
+        }, any, _blocknote_core.InlineContentSchema, _blocknote_core.StyleSchema>;
+    };
+    codeBlock: {
+        config: {
+            type: "codeBlock";
+            content: "inline";
+            propSchema: {
+                language: {
+                    default: string;
+                };
+            };
+        };
+        implementation: _blocknote_core.TiptapBlockImplementation<{
+            type: "codeBlock";
+            content: "inline";
+            propSchema: {
+                language: {
+                    default: string;
+                };
+            };
+        }, any, _blocknote_core.InlineContentSchema, _blocknote_core.StyleSchema>;
+    };
+    toggleListItem: {
+        config: {
+            type: "toggleListItem";
+            content: "inline";
+            propSchema: {
+                backgroundColor: {
+                    default: "default";
+                };
+                textColor: {
+                    default: "default";
+                };
+                textAlignment: {
+                    default: "left";
+                    values: readonly ["left", "center", "right", "justify"];
+                };
+            };
+        };
+        implementation: _blocknote_core.TiptapBlockImplementation<{
+            type: "toggleListItem";
+            content: "inline";
+            propSchema: {
+                backgroundColor: {
+                    default: "default";
+                };
+                textColor: {
+                    default: "default";
+                };
+                textAlignment: {
+                    default: "left";
+                    values: readonly ["left", "center", "right", "justify"];
+                };
+            };
+        }, any, _blocknote_core.InlineContentSchema, _blocknote_core.StyleSchema>;
+    };
+    bulletListItem: {
+        config: {
+            type: "bulletListItem";
+            content: "inline";
+            propSchema: {
+                backgroundColor: {
+                    default: "default";
+                };
+                textColor: {
+                    default: "default";
+                };
+                textAlignment: {
+                    default: "left";
+                    values: readonly ["left", "center", "right", "justify"];
+                };
+            };
+        };
+        implementation: _blocknote_core.TiptapBlockImplementation<{
+            type: "bulletListItem";
+            content: "inline";
+            propSchema: {
+                backgroundColor: {
+                    default: "default";
+                };
+                textColor: {
+                    default: "default";
+                };
+                textAlignment: {
+                    default: "left";
+                    values: readonly ["left", "center", "right", "justify"];
+                };
+            };
+        }, any, _blocknote_core.InlineContentSchema, _blocknote_core.StyleSchema>;
+    };
+    numberedListItem: {
+        config: {
+            type: "numberedListItem";
+            content: "inline";
+            propSchema: {
+                start: {
+                    default: undefined;
+                    type: "number";
+                };
+                backgroundColor: {
+                    default: "default";
+                };
+                textColor: {
+                    default: "default";
+                };
+                textAlignment: {
+                    default: "left";
+                    values: readonly ["left", "center", "right", "justify"];
+                };
+            };
+        };
+        implementation: _blocknote_core.TiptapBlockImplementation<{
+            type: "numberedListItem";
+            content: "inline";
+            propSchema: {
+                start: {
+                    default: undefined;
+                    type: "number";
+                };
+                backgroundColor: {
+                    default: "default";
+                };
+                textColor: {
+                    default: "default";
+                };
+                textAlignment: {
+                    default: "left";
+                    values: readonly ["left", "center", "right", "justify"];
+                };
+            };
+        }, any, _blocknote_core.InlineContentSchema, _blocknote_core.StyleSchema>;
+    };
+    checkListItem: {
+        config: {
+            type: "checkListItem";
+            content: "inline";
+            propSchema: {
+                checked: {
+                    default: false;
+                };
+                backgroundColor: {
+                    default: "default";
+                };
+                textColor: {
+                    default: "default";
+                };
+                textAlignment: {
+                    default: "left";
+                    values: readonly ["left", "center", "right", "justify"];
+                };
+            };
+        };
+        implementation: _blocknote_core.TiptapBlockImplementation<{
+            type: "checkListItem";
+            content: "inline";
+            propSchema: {
+                checked: {
+                    default: false;
+                };
+                backgroundColor: {
+                    default: "default";
+                };
+                textColor: {
+                    default: "default";
+                };
+                textAlignment: {
+                    default: "left";
+                    values: readonly ["left", "center", "right", "justify"];
+                };
+            };
+        }, any, _blocknote_core.InlineContentSchema, _blocknote_core.StyleSchema>;
+    };
+    table: {
+        config: {
+            type: "table";
+            content: "table";
+            propSchema: {
+                textColor: {
+                    default: "default";
+                };
+            };
+        };
+        implementation: _blocknote_core.TiptapBlockImplementation<{
+            type: "table";
+            content: "table";
+            propSchema: {
+                textColor: {
+                    default: "default";
+                };
+            };
+        }, any, _blocknote_core.InlineContentSchema, _blocknote_core.StyleSchema>;
+    };
+    file: {
+        config: {
+            type: "file";
+            propSchema: {
+                backgroundColor: {
+                    default: "default";
+                };
+                name: {
+                    default: "";
+                };
+                url: {
+                    default: "";
+                };
+                caption: {
+                    default: "";
+                };
+            };
+            content: "none";
+            isFileBlock: true;
+        };
+        implementation: _blocknote_core.TiptapBlockImplementation<{
+            type: "file";
+            propSchema: {
+                backgroundColor: {
+                    default: "default";
+                };
+                name: {
+                    default: "";
+                };
+                url: {
+                    default: "";
+                };
+                caption: {
+                    default: "";
+                };
+            };
+            content: "none";
+            isFileBlock: true;
+        }, any, _blocknote_core.InlineContentSchema, _blocknote_core.StyleSchema>;
+    };
+    image: {
+        config: {
+            type: "image";
+            propSchema: {
+                textAlignment: {
+                    default: "left";
+                    values: readonly ["left", "center", "right", "justify"];
+                };
+                backgroundColor: {
+                    default: "default";
+                };
+                name: {
+                    default: "";
+                };
+                url: {
+                    default: "";
+                };
+                caption: {
+                    default: "";
+                };
+                showPreview: {
+                    default: true;
+                };
+                previewWidth: {
+                    default: undefined;
+                    type: "number";
+                };
+            };
+            content: "none";
+            isFileBlock: true;
+            fileBlockAccept: string[];
+        };
+        implementation: _blocknote_core.TiptapBlockImplementation<{
+            type: "image";
+            propSchema: {
+                textAlignment: {
+                    default: "left";
+                    values: readonly ["left", "center", "right", "justify"];
+                };
+                backgroundColor: {
+                    default: "default";
+                };
+                name: {
+                    default: "";
+                };
+                url: {
+                    default: "";
+                };
+                caption: {
+                    default: "";
+                };
+                showPreview: {
+                    default: true;
+                };
+                previewWidth: {
+                    default: undefined;
+                    type: "number";
+                };
+            };
+            content: "none";
+            isFileBlock: true;
+            fileBlockAccept: string[];
+        }, any, _blocknote_core.InlineContentSchema, _blocknote_core.StyleSchema>;
+    };
+    video: {
+        config: {
+            type: "video";
+            propSchema: {
+                textAlignment: {
+                    default: "left";
+                    values: readonly ["left", "center", "right", "justify"];
+                };
+                backgroundColor: {
+                    default: "default";
+                };
+                name: {
+                    default: "";
+                };
+                url: {
+                    default: "";
+                };
+                caption: {
+                    default: "";
+                };
+                showPreview: {
+                    default: true;
+                };
+                previewWidth: {
+                    default: undefined;
+                    type: "number";
+                };
+            };
+            content: "none";
+            isFileBlock: true;
+            fileBlockAccept: string[];
+        };
+        implementation: _blocknote_core.TiptapBlockImplementation<{
+            type: "video";
+            propSchema: {
+                textAlignment: {
+                    default: "left";
+                    values: readonly ["left", "center", "right", "justify"];
+                };
+                backgroundColor: {
+                    default: "default";
+                };
+                name: {
+                    default: "";
+                };
+                url: {
+                    default: "";
+                };
+                caption: {
+                    default: "";
+                };
+                showPreview: {
+                    default: true;
+                };
+                previewWidth: {
+                    default: undefined;
+                    type: "number";
+                };
+            };
+            content: "none";
+            isFileBlock: true;
+            fileBlockAccept: string[];
+        }, any, _blocknote_core.InlineContentSchema, _blocknote_core.StyleSchema>;
+    };
+    audio: {
+        config: {
+            type: "audio";
+            propSchema: {
+                backgroundColor: {
+                    default: "default";
+                };
+                name: {
+                    default: "";
+                };
+                url: {
+                    default: "";
+                };
+                caption: {
+                    default: "";
+                };
+                showPreview: {
+                    default: true;
+                };
+            };
+            content: "none";
+            isFileBlock: true;
+            fileBlockAccept: string[];
+        };
+        implementation: _blocknote_core.TiptapBlockImplementation<{
+            type: "audio";
+            propSchema: {
+                backgroundColor: {
+                    default: "default";
+                };
+                name: {
+                    default: "";
+                };
+                url: {
+                    default: "";
+                };
+                caption: {
+                    default: "";
+                };
+                showPreview: {
+                    default: true;
+                };
+            };
+            content: "none";
+            isFileBlock: true;
+            fileBlockAccept: string[];
+        }, any, _blocknote_core.InlineContentSchema, _blocknote_core.StyleSchema>;
+    };
+}>, _blocknote_core.InlineContentSchemaFromSpecs<{
+    text: {
+        config: "text";
+        implementation: any;
+    };
+    link: {
+        config: "link";
+        implementation: any;
+    };
+}>, _blocknote_core.StyleSchemaFromSpecs<{
+    bold: {
+        config: {
+            type: string;
+            propSchema: "boolean";
+        };
+        implementation: _blocknote_core.StyleImplementation;
+    };
+    italic: {
+        config: {
+            type: string;
+            propSchema: "boolean";
+        };
+        implementation: _blocknote_core.StyleImplementation;
+    };
+    underline: {
+        config: {
+            type: string;
+            propSchema: "boolean";
+        };
+        implementation: _blocknote_core.StyleImplementation;
+    };
+    strike: {
+        config: {
+            type: string;
+            propSchema: "boolean";
+        };
+        implementation: _blocknote_core.StyleImplementation;
+    };
+    code: {
+        config: {
+            type: string;
+            propSchema: "boolean";
+        };
+        implementation: _blocknote_core.StyleImplementation;
+    };
+    textColor: {
+        config: {
+            type: string;
+            propSchema: "string";
+        };
+        implementation: _blocknote_core.StyleImplementation;
+    };
+    backgroundColor: {
+        config: {
+            type: string;
+            propSchema: "string";
+        };
+        implementation: _blocknote_core.StyleImplementation;
+    };
+}>>;
+
+interface LinkMetadata {
+    url: string;
+    title: string;
+    description?: string;
+    image?: string;
+    domain: string;
+}
+declare function fetchLinkMetadata(url: string, apiEndpoint: string): Promise<LinkMetadata>;
+declare function clearMetadataCache(): void;
+declare const LinkPreviewBlock: {
+    config: {
+        readonly type: "linkPreview";
+        readonly propSchema: {
+            readonly url: {
+                readonly default: "";
+            };
+            readonly title: {
+                readonly default: "";
+            };
+            readonly description: {
+                readonly default: "";
+            };
+            readonly image: {
+                readonly default: "";
+            };
+            readonly domain: {
+                readonly default: "";
+            };
+            readonly previewWidth: {
+                readonly default: 400;
+            };
+            readonly previewHeight: {
+                readonly default: 200;
+            };
+        };
+        readonly content: "none";
+    };
+    implementation: _blocknote_core.TiptapBlockImplementation<{
+        readonly type: "linkPreview";
+        readonly propSchema: {
+            readonly url: {
+                readonly default: "";
+            };
+            readonly title: {
+                readonly default: "";
+            };
+            readonly description: {
+                readonly default: "";
+            };
+            readonly image: {
+                readonly default: "";
+            };
+            readonly domain: {
+                readonly default: "";
+            };
+            readonly previewWidth: {
+                readonly default: 400;
+            };
+            readonly previewHeight: {
+                readonly default: 200;
+            };
+        };
+        readonly content: "none";
+    }, any, _blocknote_core.InlineContentSchema, _blocknote_core.StyleSchema>;
+};
+
+interface FloatingMenuProps {
+    editor: EditorType | any;
+    position?: "sticky" | "fixed";
+    className?: string;
+    onImageUpload?: () => void;
+}
+/**
+ * FloatingMenu - 에디터 상단 고정 툴바
+ */
+declare const FloatingMenu: React.FC<FloatingMenuProps>;
+
+/**
+ * 색상 팔레트 상수
+ * BlockNote 기본 색상 팔레트와 일치
+ */
+interface ColorItem {
+    name: string;
+    value: string;
+    hex: string;
+}
+/**
+ * 텍스트 색상 팔레트
+ */
+declare const TEXT_COLORS: ColorItem[];
+/**
+ * 배경 색상 팔레트
+ */
+declare const BACKGROUND_COLORS: ColorItem[];
+/**
+ * 색상 값으로 hex 색상 코드 찾기
+ */
+declare const getHexFromColorValue: (value: string, type: "text" | "background") => string;
+
+export { BACKGROUND_COLORS, type ColorItem, ContentUtils, type DefaultPartialBlock, EditorConfig, type EditorType, FloatingMenu, HtmlPreviewBlock, schema as HtmlPreviewSchema, type LinkMetadata, LinkPreviewBlock, LumirEditor, LumirEditorError, type LumirEditorProps, type LumirErrorCode, type LumirErrorDetails, type S3UploaderConfig, TEXT_COLORS, clearMetadataCache, cn, createS3Uploader, fetchLinkMetadata, getHexFromColorValue };