@lumir-company/editor 0.4.19 → 0.4.22

package/README.md

@@ -1479,7 +1479,32 @@ const url = await uploader(imageFile);
 
 ## 변경 로그
 
-### v0.4.19
+### v0.4.22 (2026-06-22)
+
+- **글자 크기 1px 단위 조절** *(신규)*
+  - 글자 크기 드롭다운(포매팅 툴바·플로팅 메뉴) 상단에 **−/+ 스테퍼 + 직접 입력** 추가 → 프리셋 사이 값(13·15·17·21px…)을 1px 단위로 지정 (`↑`/`↓` 키로도 증감)
+  - 허용 범위 **8~96px**(범위 밖 입력은 자동 보정), 명시 크기가 없으면 14px 기준으로 증감. 스테퍼 클릭 시 드롭다운은 닫히지 않아 연속 조절 가능
+  - 기존 프리셋(10·12·14·16·18·20·24·28px)·"기본" 리셋은 그대로 유지. 저장 JSON·하위호환(형제 키 직렬화)은 변경 없음
+  - 공개 API에 `FONT_SIZE_MIN`/`FONT_SIZE_MAX`/`FONT_SIZE_DEFAULT_PX`/`FONT_SIZE_STEP` 및 `parseFontSizePx`/`clampFontSizePx`/`toFontSizeValue` 추가
+  - **글자 크기 스타일을 동기 스펙(`createStyleSpec`)으로 변경**: 기존 React 스펙은 span 내용이 비동기 렌더되어, 크기 적용 직후 포매팅 툴바가 좌상단으로 튀는 문제가 있었음(선택 영역 DOM 좌표가 순간 (0,0)으로 측정됨). 동기 렌더로 바꿔 툴바가 선택 위치에 고정됨. HTML 직렬화(`data-style-type`/`data-value`)는 동일
+
+### v0.4.21 (2026-06-18)
+
+- **Word/docx 표 붙여넣기 품질 개선** *(신규)*
+  - **에디터 너비 자동 맞춤**: 에디터보다 넓은 표를 붙여넣으면 각 열 비율을 유지한 채 에디터 너비에 맞춰 축소(가로 스크롤 방지). 열 너비를 colgroup/셀(pt/px/%)에서 읽어 `columnWidths`로 적용
+  - **셀 서식 보존 확대**: 기존(굵게·기울임·밑줄·취소선·글자색·배경색·텍스트 정렬)에 더해 **글자 크기**와 **세로 정렬**(middle/bottom)도 보존
+  - 한계: 글자 크기는 셀 단위 균일 적용, 글꼴(font-family)·정확한 hex 색은 BlockNote 미지원(색은 10색 팔레트 근사)
+
+### v0.4.20 (2026-06-18)
+
+- **2단 컬럼 구분선 — 생성 시 선택** *(신규)*
+  - 슬래시 메뉴에서 `2단 컬럼` / `2단 컬럼 (구분선)` 중 골라 삽입 → 선택한 구분선 유무가 그 블록에 **고정**(문서에 `showDivider`로 저장·라운드트립). 구분선 있는/없는 컬럼을 섞어 사용 가능
+  - v0.4.19의 전역 `columnDivider` prop과 별개로, **블록별**로 구분선을 지정
+- **표 셀에서 Ctrl/Cmd+A → 표 전체 선택** *(신규)*
+  - 셀에 포커스(커서/선택) 시 Ctrl/Cmd+A로 표의 모든 셀을 한 번에 선택(일괄 색·정렬·삭제 등에 유용)
+  - 이미 표 전체가 선택된 상태에서 다시 누르면 문서 전체로 단계적 확장. 표 밖에서는 기본 동작 유지
+
+### v0.4.19 (2026-06-17)
 
 - **2단 컬럼 중앙 세로 구분선 (`columnDivider` 옵션)** *(신규)*
   - `columnDivider` prop(기본 `false`)으로 2단(다단) 컬럼 사이 중앙에 세로 구분선 표시
@@ -1491,14 +1516,14 @@ const url = await uploader(imageFile);
   - 셀 focus 없이 표 hover만으로 동작(코어 hover 상태 기반), 기존 행/열 개별 리사이즈와 충돌 없음
   - `tableHandles` prop으로 게이트(행/열 리사이즈와 동일)
 
-### v0.4.18
+### v0.4.18 (2026-06-17)
 
 - **표 열 삭제 버그 수정 (병합 셀 포함)**
   - 그립 메뉴로 첫 열/행 삭제 시, 그립 클릭으로 ProseMirror 선택이 표 밖으로 빠져 삭제가 무시되던 문제 수정(삭제 대상 표를 포커스 표 기준으로 결정적으로 탐색)
   - **세로 병합(rowspan) 인접 열**이 있을 때 첫 열이 삭제되지 않던 문제 수정 — 코어 prosemirror-tables가 행의 유일 셀을 지울 때 빈 셀을 남겨(`tableRow+` 스키마) `fixTables`가 원복하던 케이스. 열 삭제를 표 재구성 방식으로 변경해 colspan/rowspan 병합을 안전하게 처리
   - 병합 셀이 행 축소로 collapse될 때 **행 높이를 보존**(원래 차지하던 행 높이 합을 유지)
 
-### v0.4.17
+### v0.4.17 (2026-06-16)
 
 - **표 행 높이(세로) 리사이즈**
   - 행 경계 hover → 드래그로 행 높이 조절(가로 열 리사이즈와 대칭). 드래그 중 셀 높이가 마우스를 따라 실시간 반영
@@ -1513,7 +1538,7 @@ const url = await uploader(imageFile);
   - 공식 `@blocknote/xl-multi-column`(AGPL) 대신 MIT 안전 자체 구현
   - *제한(후속 예정)*: 컬럼 안↔밖 DnD/3단 추가, 컬럼 너비 리사이즈, 다중 블록 드래그
 
-### v0.4.16
+### v0.4.16 (2026-06-05)
 
 - **인라인 글자 크기 (Font Size)**
   - 포매팅 툴바·상단 고정 툴바(FloatingMenu)에 글자 크기 드롭다운 추가 (기본 + 10~28px 프리셋 8단계)
@@ -1524,7 +1549,7 @@ const url = await uploader(imageFile);
   - 일반 텍스트 선택 시 선택 팝업 툴바를 표시하지 않음 (상단 고정 툴바와 중복 + 상단 툴바에서 스타일 적용 직후 팝업이 잘못된 위치(0,0)에 재표시되던 문제 수정)
   - 테이블 셀 컨텍스트(셀 병합·세로 정렬·셀 배경)와 이미지/노드 선택(캡션·교체·다운로드 등)은 팝업에만 있는 도구이므로 기존대로 팝업 표시
 
-### v0.4.15
+### v0.4.15 (2026-06-05)
 
 - **Notion 스타일 테이블 셀 색상·정렬·포커스 핸들**
   - 셀 focus 시 상(열)·좌(행)·우(셀) gutter/grip 표시, grip 클릭으로 행·열·셀 드롭다운 메뉴 (`LumirTableHandlesController`)
@@ -1533,25 +1558,25 @@ const url = await uploader(imageFile);
   - 상단 고정 툴바(FloatingMenu)의 정렬·배경색 버튼이 테이블 셀에 올바르게 적용되도록 수정
   - 행/열 grip 메뉴가 열려 범위 하이라이트 중일 때 셀 우측 grip 미노출 처리
 
-### v0.4.14
+### v0.4.14 (2026-05-29)
 
 - **Excel/스프레드시트 셀 붙여넣기 → 편집 가능한 테이블**
   - Excel 복사 시 클립보드의 비트맵 이미지가 업로드되어 테이블이 무시되던 문제 수정
   - 클립보드 HTML에 `<table>`이 있으면 이미지보다 우선 파싱하여 실제 테이블 블록 생성
   - Excel 서식(셀 배경, 글자색, 정렬, 굵게/기울임/밑줄)을 BlockNote 속성으로 매핑
 
-### v0.4.13
+### v0.4.13 (2026-04-03)
 
 - **@tiptap/core 외부화(externalize)**
   - 번들에 포함된 @tiptap/core 중복으로 발생하던 `proseMirrorPlugins` 런타임 에러 수정
   - `@tiptap/core`를 peerDependency로 전환하고 빌드에서 external 처리
 
-### v0.4.12
+### v0.4.12 (2026-04-03)
 
 - **Numbered List & Bullet List font size 14px**
   - Numbered List & Bullet List의 font size 14px로 일반 텍스트 크기와 통일성 있게 변경
 
-### v0.4.10
+### v0.4.10 (2026-03-18)
 
 - **동영상·이미지 업로드 진행률 표시**
   - S3 업로드 시 진행률이 0만 보이다가 100으로 바로 완료되던 문제 개선
@@ -1560,19 +1585,19 @@ const url = await uploader(imageFile);
   - README: `s3Upload.onProgress` 설명 및 업로드 진행률 표시 섹션 추가
   - README: `S3UploaderConfig`에 `onProgress`, `uploadTimeoutMs`, `maxRetries` 문서화
 
-### v0.4.9
+### v0.4.9 (2026-03-17)
 
 - **업로드 용량·타임아웃 사용자 설정**
   - `maxImageFileSize`, `maxVideoFileSize` prop 추가 (미설정 시 기본 10MB/100MB)
   - `isImageFile(file, maxSize?)`, `isVideoFile(file, maxSize?)` 시그니처 확장
   - README: 용량 및 타임아웃 설정 예시 및 `s3Upload.uploadTimeoutMs` 안내 보강
 
-### v0.4.8
+### v0.4.8 (2026-03)
 
 - README update (video & image upload)
 - 버전 배포
 
-### v0.4.6
+### v0.4.6 (2026-03)
 
 - **README: S3 Presigned URL API**
   - Next.js App Router용 `app/api/s3/presigned/route.ts` 구현 예시 추가 (PutObjectCommand, getSignedUrl)
@@ -1580,13 +1605,13 @@ const url = await uploader(imageFile);
 - **README: 이미지·동영상 업로드 경로 분리**
   - `fileNameTransform`으로 이미지/동영상 prefix 분리 (`images/`, `videos/`) 예시 및 결과 경로 설명 추가
 
-### v0.4.5
+### v0.4.5 (2026-03-06)
 
 - **README: 이미지·동영상 업로드**
   - 지원 형식/용량, 삽입 경로, 설정 방법(s3Upload / uploadFile), 저장 데이터 구조, 삭제 콜백, 에러 처리 정리
   - 동영상 블록은 직접 재생 가능한 파일 URL만 지원한다는 안내 추가 (YouTube/Vimeo 링크 미지원)
 
-### v0.4.4
+### v0.4.4 (2026-03-05)
 
 - **Link Preview API 핸들러 내장**
   - `@lumir-company/editor/api/link-preview` 서브패스 export 추가
@@ -1600,7 +1625,7 @@ const url = await uploader(imageFile);
   - 내장 API 핸들러 export 목록 문서화
   - Props API 테이블에 `placeholder`, `linkPreview` 추가
 
-### v0.4.3
+### v0.4.3 (2026-02-23)
 
 - **링크 프리뷰 기능 추가**
   - `linkPreview` prop으로 링크 미리보기 활성화 (카카오톡 스타일 OG 카드)
@@ -1633,7 +1658,7 @@ const url = await uploader(imageFile);
   - S3 삭제 API 구현 예시 추가
   - Props API 문서 업데이트
 
-### v0.4.2
+### v0.4.2 (2026-02-23)
 
 - **코드 구조 리팩토링**
   - FloatingMenu 컴포넌트 분리 (Icons, 개별 버튼 컴포넌트)
@@ -1650,7 +1675,7 @@ const url = await uploader(imageFile);
   - `LumirErrorCode`, `LumirErrorDetails` 타입 export
   - `ColorItem` 타입 export
 
-### v0.4.1
+### v0.4.1 (2026-01-15)
 
 - `preserveExtension` prop 추가 - 확장자 자동 붙이기 제어 (기본: true)
 - **중요**: 파일명 변환 시 확장자 위치 수정 (확장자가 항상 맨 뒤에 오도록)
@@ -1660,14 +1685,14 @@ const url = await uploader(imageFile);
 - 확장자 제거 사용 사례 문서화
 - README 예제 및 설명 개선
 
-### v0.4.0
+### v0.4.0 (2026-01-15)
 
 - 파일명 변환 콜백 (`fileNameTransform`) 추가
 - UUID 자동 추가 옵션 (`appendUUID`) 추가
 - 여러 이미지 동시 업로드 시 중복 문제 해결
 - 문서 대폭 개선
 
-### v0.3.3
+### v0.3.3 (2025-12-11)
 
 - 에디터 재생성 방지 최적화
 - 타입 정의 개선

package/dist/index.d.mts

@@ -436,12 +436,20 @@ declare const schema: BlockNoteSchema<_blocknote_core.BlockSchemaFromSpecs<{
         config: {
             type: "columnList";
             content: "none";
-            propSchema: {};
+            propSchema: {
+                showDivider: {
+                    default: false;
+                };
+            };
         };
         implementation: _blocknote_core.TiptapBlockImplementation<{
             type: "columnList";
             content: "none";
-            propSchema: {};
+            propSchema: {
+                showDivider: {
+                    default: false;
+                };
+            };
         }, any, _blocknote_core.InlineContentSchema, _blocknote_core.StyleSchema>;
     };
     column: {
@@ -924,13 +932,10 @@ declare const schema: BlockNoteSchema<_blocknote_core.BlockSchemaFromSpecs<{
         implementation: any;
     };
 }>, _blocknote_core.StyleSchemaFromSpecs<{
-    fontSize: {
-        config: {
-            type: string;
-            propSchema: "string";
-        };
-        implementation: _blocknote_core.StyleImplementation;
-    };
+    fontSize: _blocknote_core.StyleSpec<{
+        type: string;
+        propSchema: "string";
+    }>;
     bold: {
         config: {
             type: string;
@@ -1072,16 +1077,25 @@ declare const FloatingMenu: React.FC<FloatingMenuProps>;
  * styles.fontSize 대신 형제 키 fontSize로 직렬화한다.
  * → src/utils/font-size-serialization.ts (liftFontSize/lowerFontSize) 참고.
  */
-declare const FontSize: {
-    config: {
-        type: string;
-        propSchema: "string";
-    };
-    implementation: _blocknote_core.StyleImplementation;
-};
+declare const FontSize: _blocknote_core.StyleSpec<{
+    type: string;
+    propSchema: "string";
+}>;
 /** 툴바 드롭다운에서 제공하는 프리셋 (본문 기본은 14px = "기본") */
 declare const FONT_SIZE_PRESETS: readonly ["10px", "12px", "14px", "16px", "18px", "20px", "24px", "28px"];
 type FontSizePreset = (typeof FONT_SIZE_PRESETS)[number];
+/** 글자 크기 1px 스테퍼의 허용 범위/기본값 (사용자 결정: 8~96px). */
+declare const FONT_SIZE_MIN = 8;
+declare const FONT_SIZE_MAX = 96;
+/** "기본"(명시 fontSize 없음)일 때 기준이 되는 본문 px. */
+declare const FONT_SIZE_DEFAULT_PX = 14;
+declare const FONT_SIZE_STEP = 1;
+/** "18px" → 18, "" / 파싱 실패 → 14(기본). */
+declare function parseFontSizePx(size: string): number;
+/** 8~96 범위로 보정 + 정수 반올림. */
+declare function clampFontSizePx(px: number): number;
+/** 숫자 → "Npx" (clamp 포함). */
+declare function toFontSizeValue(px: number): string;
 
 declare function FontSizeButton(): react_jsx_runtime.JSX.Element | null;
 
@@ -1107,4 +1121,4 @@ declare const BACKGROUND_COLORS: ColorItem[];
  */
 declare const getHexFromColorValue: (value: string, type: "text" | "background") => string;
 
-export { BACKGROUND_COLORS, type ColorItem, ContentUtils, type DefaultPartialBlock, EditorConfig, type EditorType, FONT_SIZE_PRESETS, FloatingMenu, FontSize, FontSizeButton, type FontSizePreset, HtmlPreviewBlock, schema as HtmlPreviewSchema, type LinkMetadata, LinkPreviewBlock, LumirEditor, LumirEditorError, type LumirEditorProps, type LumirErrorCode, type LumirErrorDetails, type S3UploaderConfig, type SerializedStyledText, TEXT_COLORS, clearMetadataCache, cn, createS3Uploader, fetchLinkMetadata, getHexFromColorValue, liftFontSize, lowerFontSize };
+export { BACKGROUND_COLORS, type ColorItem, ContentUtils, type DefaultPartialBlock, EditorConfig, type EditorType, FONT_SIZE_DEFAULT_PX, FONT_SIZE_MAX, FONT_SIZE_MIN, FONT_SIZE_PRESETS, FONT_SIZE_STEP, FloatingMenu, FontSize, FontSizeButton, type FontSizePreset, HtmlPreviewBlock, schema as HtmlPreviewSchema, type LinkMetadata, LinkPreviewBlock, LumirEditor, LumirEditorError, type LumirEditorProps, type LumirErrorCode, type LumirErrorDetails, type S3UploaderConfig, type SerializedStyledText, TEXT_COLORS, clampFontSizePx, clearMetadataCache, cn, createS3Uploader, fetchLinkMetadata, getHexFromColorValue, liftFontSize, lowerFontSize, parseFontSizePx, toFontSizeValue };

package/dist/index.d.ts

@@ -436,12 +436,20 @@ declare const schema: BlockNoteSchema<_blocknote_core.BlockSchemaFromSpecs<{
         config: {
             type: "columnList";
             content: "none";
-            propSchema: {};
+            propSchema: {
+                showDivider: {
+                    default: false;
+                };
+            };
         };
         implementation: _blocknote_core.TiptapBlockImplementation<{
             type: "columnList";
             content: "none";
-            propSchema: {};
+            propSchema: {
+                showDivider: {
+                    default: false;
+                };
+            };
         }, any, _blocknote_core.InlineContentSchema, _blocknote_core.StyleSchema>;
     };
     column: {
@@ -924,13 +932,10 @@ declare const schema: BlockNoteSchema<_blocknote_core.BlockSchemaFromSpecs<{
         implementation: any;
     };
 }>, _blocknote_core.StyleSchemaFromSpecs<{
-    fontSize: {
-        config: {
-            type: string;
-            propSchema: "string";
-        };
-        implementation: _blocknote_core.StyleImplementation;
-    };
+    fontSize: _blocknote_core.StyleSpec<{
+        type: string;
+        propSchema: "string";
+    }>;
     bold: {
         config: {
             type: string;
@@ -1072,16 +1077,25 @@ declare const FloatingMenu: React.FC<FloatingMenuProps>;
  * styles.fontSize 대신 형제 키 fontSize로 직렬화한다.
  * → src/utils/font-size-serialization.ts (liftFontSize/lowerFontSize) 참고.
  */
-declare const FontSize: {
-    config: {
-        type: string;
-        propSchema: "string";
-    };
-    implementation: _blocknote_core.StyleImplementation;
-};
+declare const FontSize: _blocknote_core.StyleSpec<{
+    type: string;
+    propSchema: "string";
+}>;
 /** 툴바 드롭다운에서 제공하는 프리셋 (본문 기본은 14px = "기본") */
 declare const FONT_SIZE_PRESETS: readonly ["10px", "12px", "14px", "16px", "18px", "20px", "24px", "28px"];
 type FontSizePreset = (typeof FONT_SIZE_PRESETS)[number];
+/** 글자 크기 1px 스테퍼의 허용 범위/기본값 (사용자 결정: 8~96px). */
+declare const FONT_SIZE_MIN = 8;
+declare const FONT_SIZE_MAX = 96;
+/** "기본"(명시 fontSize 없음)일 때 기준이 되는 본문 px. */
+declare const FONT_SIZE_DEFAULT_PX = 14;
+declare const FONT_SIZE_STEP = 1;
+/** "18px" → 18, "" / 파싱 실패 → 14(기본). */
+declare function parseFontSizePx(size: string): number;
+/** 8~96 범위로 보정 + 정수 반올림. */
+declare function clampFontSizePx(px: number): number;
+/** 숫자 → "Npx" (clamp 포함). */
+declare function toFontSizeValue(px: number): string;
 
 declare function FontSizeButton(): react_jsx_runtime.JSX.Element | null;
 
@@ -1107,4 +1121,4 @@ declare const BACKGROUND_COLORS: ColorItem[];
  */
 declare const getHexFromColorValue: (value: string, type: "text" | "background") => string;
 
-export { BACKGROUND_COLORS, type ColorItem, ContentUtils, type DefaultPartialBlock, EditorConfig, type EditorType, FONT_SIZE_PRESETS, FloatingMenu, FontSize, FontSizeButton, type FontSizePreset, HtmlPreviewBlock, schema as HtmlPreviewSchema, type LinkMetadata, LinkPreviewBlock, LumirEditor, LumirEditorError, type LumirEditorProps, type LumirErrorCode, type LumirErrorDetails, type S3UploaderConfig, type SerializedStyledText, TEXT_COLORS, clearMetadataCache, cn, createS3Uploader, fetchLinkMetadata, getHexFromColorValue, liftFontSize, lowerFontSize };
+export { BACKGROUND_COLORS, type ColorItem, ContentUtils, type DefaultPartialBlock, EditorConfig, type EditorType, FONT_SIZE_DEFAULT_PX, FONT_SIZE_MAX, FONT_SIZE_MIN, FONT_SIZE_PRESETS, FONT_SIZE_STEP, FloatingMenu, FontSize, FontSizeButton, type FontSizePreset, HtmlPreviewBlock, schema as HtmlPreviewSchema, type LinkMetadata, LinkPreviewBlock, LumirEditor, LumirEditorError, type LumirEditorProps, type LumirErrorCode, type LumirErrorDetails, type S3UploaderConfig, type SerializedStyledText, TEXT_COLORS, clampFontSizePx, clearMetadataCache, cn, createS3Uploader, fetchLinkMetadata, getHexFromColorValue, liftFontSize, lowerFontSize, parseFontSizePx, toFontSizeValue };