@aeriz/wysiwyg 1.0.5 → 2.0.0

package/dist-types/cjs/core/fonts.d.cts

@@ -1,60 +1,47 @@
 /**
- * 글꼴 라이브러리 — 한국어 본문에 친화적인 무료 / 상용 가능 글꼴만 큐레이션.
- * 모두 SIL Open Font License 또는 자체 무제한 상용 라이선스.
+ * 글꼴 · 글자 크기 목록.
  *
- * 로딩 정책:
- *  - 모든 글꼴은 글꼴 드롭다운이 처음 열릴 때 1회 일괄 lazy 로드.
- *  - Google Fonts CSS2 endpoint 한 번 + 외부 CDN(Pretendard) 별도 1 회.
- *  - 실패해도 stack 의 fallback 글꼴이 자동 적용되므로 graceful degradation.
+ * ## 기본 목록은 "이미 깔려 있는 글꼴" 이다
+ *
+ * 1.x 는 글꼴 드롭다운을 열 때 Google Fonts 와 jsDelivr 에서 웹폰트를 받았다.
+ * 그 때문에 (1) 망이 막힌 공공 · 금융 환경에서는 목록이 비고, (2) 열 때마다
+ * 외부로 요청이 나가 개인정보 · 보안 심사에서 걸리고, (3) 받은 글꼴로 쓴 문서가
+ * 다른 PC 에서는 다른 글꼴로 보였다.
+ *
+ * 2.0 의 기본값은 한국 문서에서 실제로 쓰는 시스템 글꼴(맑은 고딕 · 굴림 · 돋움 ·
+ * 바탕 · 궁서 …) 이고, 네트워크를 쓰지 않는다. 웹폰트가 필요하면 `fonts`
+ * 옵션에 `cssUrl` 과 함께 넘긴다 — 그 글꼴만, 드롭다운을 처음 열 때 받는다.
+ *
+ * 이 PC 에 없는 글꼴(맥의 굴림 등) 은 목록에서 뺀다. 골라도 적용되지 않는
+ * 항목은 없느니만 못하다.
  */
 export interface FontFamily {
-    /** 안정 식별자 — 직렬화 / 다음 선택 비교에 사용. */
-    id: string;
-    /** 드롭다운에 표시되는 한국어 라벨. */
+    /** 드롭다운에 보이는 이름. */
     label: string;
-    /** CSS font-family 스택 — execCommand fontName 의 인자로 들어간다. */
+    /** CSS font-family 값. 첫 글꼴이 "그 글꼴" 이고 나머지는 대체 글꼴이다. */
     stack: string;
-    /** Google Fonts CSS2 family 파라미터 (예: "Noto+Sans+KR:wght@400;700"). */
-    googleFonts?: string;
-    /** 외부 CDN 의 전체 CSS URL (Google Fonts 가 아닌 글꼴용). */
+    /** 웹폰트 스타일시트 주소. 있으면 드롭다운을 처음 열 때 한 번 받는다. */
     cssUrl?: string;
 }
-/** "시스템 기본" 항목의 id. clearFormat / 초기화 분기에 사용. */
-export declare const SYSTEM_FONT_ID = "system";
-export declare const FONT_FAMILIES: ReadonlyArray<FontFamily>;
-/** id → FontFamily lookup. */
-export declare const FONT_FAMILY_BY_ID: Readonly<Record<string, FontFamily>>;
-/**
- * 글자 크기 프리셋 (px). 본문 기본은 16px.
- * 12 ~ 48px 범위에서 자주 쓰이는 단계만 큐레이션.
- */
-export declare const FONT_SIZES: ReadonlyArray<number>;
-/**
- * Computed CSS font-size 문자열(예: "16px", "1.125rem")을 px 정수로 변환.
- * 매칭 실패 시 null. 활성 toolbar 크기 표시에 사용.
- */
-export declare function pxFromCss(css: string | null | undefined): number | null;
+/** 목록 맨 위 "기본 글꼴" — 서식을 지워 본문 글꼴로 돌아간다. stack 이 빈 문자열이다. */
+export declare const DEFAULT_FONT: FontFamily;
+export declare const DEFAULT_FONTS: ReadonlyArray<FontFamily>;
 /**
- * 현재 실제로 쓸 수 있는 글꼴만 반환한다. 드롭다운은 이 목록으로 그린다.
- *
- * `FONT_FAMILIES` 전체는 그대로 남겨 둔다 — 이미 그 글꼴로 저장된 본문의
- * 라벨을 표시하려면(`findFontIdFromCss`) 실패한 항목도 알고 있어야 한다.
+ * 글자 크기(pt). 한글 · 워드와 같은 단위다 — 붙여넣은 문서의 10pt 가 목록의
+ * 10 과 그대로 맞는다. 에디터 본문 기본 크기 16px 는 12pt 다.
  */
-export declare function getAvailableFontFamilies(): ReadonlyArray<FontFamily>;
-/** 사용 가능 목록이 바뀌면 호출된다. 반환값을 부르면 구독이 해제된다. */
+export declare const DEFAULT_FONT_SIZES: ReadonlyArray<number>;
+/** CSS 글자 크기(computed 값은 px) → pt, 0.5 단위로 반올림. */
+export declare function ptFromCss(css: string | null | undefined): number | null;
+/** `fonts` 중 지금 쓸 수 있는 것. 드롭다운은 이 목록으로 그린다. */
+export declare function availableFonts(fonts: ReadonlyArray<FontFamily>): FontFamily[];
+/** 쓸 수 있는 목록이 바뀌면 호출된다. 반환값을 부르면 구독이 해제된다. */
 export declare function subscribeFontAvailability(listener: () => void): () => void;
 /**
- * 모든 글꼴의 CSS 를 1 회만 lazy 로드한다. 글꼴 드롭다운이 열릴 때 호출.
- * 두 번째 이후 호출은 즉시 반환.
- *
- * 실패는 조용히 넘어가지 않는다 — 받지 못한 글꼴은 목록에서 빠진다.
- */
-export declare function ensureFontFamiliesLoaded(): void;
-/**
- * 임의의 CSS font-family 문자열에 대해 FONT_FAMILIES 중 가장 비슷한 항목을
- * 찾아 id 를 반환. 매칭 실패 시 null. 활성 toolbar 표시에 사용.
- *
- * 비교는 stack 의 첫 family 토큰을 추출해 case-insensitive 비교.
+ * 드롭다운을 열 때 부른다. 웹폰트(`cssUrl`) 는 그때 한 번 받고, 시스템 글꼴은
+ * 이 PC 에 있는지 확인한다. 같은 글꼴은 두 번 확인하지 않는다.
  */
-export declare function findFontIdFromCss(css: string | null | undefined): string | null;
+export declare function prepareFonts(fonts: ReadonlyArray<FontFamily>): void;
+/** CSS font-family 값이 목록의 어느 글꼴인지 (첫 글꼴 이름으로 비교). */
+export declare function findFont(fonts: ReadonlyArray<FontFamily>, css: string | null | undefined): FontFamily | null;
 // (소스맵은 CJS 선언 사본에서 제외됨 — scripts/finalize-types.mjs)

package/dist-types/cjs/core/history.d.cts

@@ -11,13 +11,13 @@
  *
  * ## 무엇을 저장하는가
  *
- * 본문 HTML 전체와 캐럿 위치를 한 항목으로 저장하는 스냅샷 방식이다.
+ * 본문 블록별 HTML 과 캐럿 위치를 한 항목으로 저장하는 스냅샷 방식이다.
  * 조작 단위 이력(operation log) 이 메모리는 덜 쓰지만, 되돌리기가 **정확히**
  * 원래 화면으로 돌아간다는 보장을 얻기가 훨씬 어렵다. 스냅샷은 그 보장이
  * 공짜다 — 문자열을 도로 넣기만 하면 된다.
  *
- * 캐럿은 문자 오프셋으로 저장한다. HTML 을 통째로 갈아끼우면 노드 참조는
- * 전부 무효가 되지만, "본문 시작에서 몇 번째 글자" 는 그대로 살아남는다.
+ * 캐럿은 "몇 번째 블록의 몇 번째 글자" 로 저장한다. 블록을 갈아끼우면 노드
+ * 참조는 무효가 되지만 이 좌표는 그대로 살아남는다.
  *
  * ## 언제 한 항목으로 묶는가
  *
@@ -26,15 +26,33 @@
  * 유형 변경처럼 **구조가 바뀌는 조작**은 합치지 않는다 — 그건 사용자가 한
  * 번에 하나씩 되돌리길 기대하는 단위다.
  */
-/** 이력 한 항목 — 그 순간의 본문 전체와 캐럿. */
+/**
+ * 문서 안 캐럿 위치. 블록 순번 + 그 블록 안의 글자 오프셋.
+ *
+ * 문서 맨 앞부터의 글자 수로 적으면 기록할 때마다 문서 전체 텍스트를 읽어야
+ * 한다 (190쪽 문서에서 키 하나에 수 ms). 블록 단위로 적으면 그 블록만 읽는다.
+ */
+export interface DocSelection {
+    startBlock: number;
+    start: number;
+    endBlock: number;
+    end: number;
+}
+/**
+ * 이력 한 칸. 본문 직계 블록마다 HTML 문자열 하나.
+ *
+ * 블록 단위로 나눠 두는 이유 — 타이핑 한 번에 바뀌는 블록은 보통 하나라서,
+ * 나머지 블록의 문자열은 **이전 칸과 같은 문자열 객체를 그대로 공유한다.**
+ * 문서 전체를 한 문자열로 저장하면 190쪽 문서에서 이력 200칸이 수십 MB 가 된다.
+ */
 export interface HistoryEntry {
-    html: string;
-    /** 본문 시작 기준 캐럿 시작/끝 문자 오프셋. 셀렉션이 없으면 null. */
-    selection: {
-        start: number;
-        end: number;
-    } | null;
+    blocks: readonly string[];
+    /** 모든 블록 문자열 길이의 합. 대량 변경 판정에 쓴다. */
+    size: number;
+    selection: DocSelection | null;
 }
+/** 두 칸의 내용이 같은지. 공유된 문자열은 참조 비교로 바로 끝난다. */
+export declare function sameContent(a: HistoryEntry, b: HistoryEntry): boolean;
 /**
  * 이 시간 안에 이어지는 타이핑은 한 항목으로 합친다.
  * 사람이 문장 하나를 치는 동안의 간격보다 짧게, 생각하고 다시 치기 시작하는

package/dist-types/cjs/core/html-to-blocks.d.cts

@@ -0,0 +1,10 @@
+import type { BlockSnapshot } from './blocks.cjs';
+/**
+ * HTML 문자열을 `BlockSnapshot[]` 로 변환한다 (브라우저 전용).
+ *
+ * 에디터 본문과 같은 정화 · 정규화 경로를 타므로, 같은 HTML 을 에디터에 넣고
+ * `getSnapshots()` 한 결과와 블록 구성이 같다. 편집용 꼬리 단락은 붙이지
+ * 않는다 — 뷰어에 넘길 목록에 원본에 없던 빈 단락이 생기면 여백이 늘어난다.
+ */
+export declare function htmlToBlocks(html: string): BlockSnapshot[];
+// (소스맵은 CJS 선언 사본에서 제외됨 — scripts/finalize-types.mjs)

package/dist-types/cjs/core/i18n.d.cts

@@ -21,6 +21,8 @@ export interface Strings {
         italic: string;
         underline: string;
         strike: string;
+        superscript: string;
+        subscript: string;
         color: string;
         backgroundColor: string;
         align: string;
@@ -36,6 +38,13 @@ export interface Strings {
         table: string;
         hr: string;
         clearFormat: string;
+        lineHeight: string;
+        letterSpacing: string;
+        specialChar: string;
+        findReplace: string;
+        source: string;
+        print: string;
+        fullscreen: string;
         blockTypeChangeTooltip: string;
         blockMoveTooltip: string;
         addBelowTooltip: string;
@@ -49,6 +58,8 @@ export interface Strings {
         taskList: string;
         blockquote: string;
         codeBlock: string;
+        toggle: string;
+        callout: string;
         image: string;
         table: string;
         hr: string;
@@ -68,6 +79,8 @@ export interface Strings {
         orderedList: string;
         blockquote: string;
         codeBlock: string;
+        toggle: string;
+        callout: string;
         hr: string;
         link: string;
         image: string;
@@ -95,6 +108,37 @@ export interface Strings {
         colRight: string;
         deleteRow: string;
         deleteCol: string;
+        mergeCells: string;
+        splitCell: string;
+    };
+    docTools: {
+        /** 본문 편집 영역의 접근성 이름. `ariaLabel` 옵션이 없을 때 쓴다. */
+        editorLabel: string;
+        find: string;
+        replaceWith: string;
+        previous: string;
+        next: string;
+        replace: string;
+        replaceAll: string;
+        close: string;
+        /** `{current}` / `{total}`. */
+        matchCount: string;
+        noMatch: string;
+        /** `{count}` 건을 바꿨을 때. */
+        replaced: string;
+        matchCase: string;
+        sourceLabel: string;
+        letterSpacingNormal: string;
+        /** `{size}` — 올릴 수 있는 최대 크기. */
+        tooLarge: string;
+        specialGroups: {
+            symbols: string;
+            arrows: string;
+            numbers: string;
+            units: string;
+            brackets: string;
+            math: string;
+        };
     };
     fontFamily: {
         systemDefault: string;

package/dist-types/cjs/core/import-html.d.cts

@@ -1,16 +1,3 @@
-/**
- * 외부 HTML 문서를 가져와 모든 스타일을 인라인으로 베이크한다.
- *
- * 흐름:
- * 1. 숨김 iframe 을 만들고 srcdoc 으로 HTML 주입
- * 2. iframe load 이벤트(=body 의 마지막 동기 스크립트까지 실행 완료) +
- *    추가 RAF/idle 대기 → setTimeout(0) 류 비동기 스타일 적용까지 안정화
- * 3. body 트리 전체를 walk 하면서 각 element 의 computed style 중
- *    "캐스케이드로 채워지지 않을" 속성만 인라인 style 속성으로 베이크
- * 4. iframe 제거 후 변환된 element 들의 outerHTML 배열 반환
- *
- * 다른 origin / iframe contentDocument 접근 제한이 발생하면 reject.
- */
 export declare function isBlockLevelTag(tagName: string): boolean;
 export interface ImportHtmlOptions {
     /** iframe load 후 추가 idle 대기(ms). Tailwind CDN 등 런타임 스타일 주입을

package/dist-types/cjs/core/insert-fragment.d.cts

@@ -0,0 +1,21 @@
+/**
+ * 붙여넣기 · 끌어 놓기로 들어온 조각을 캐럿 자리에 넣는다.
+ *
+ * `document.execCommand('insertHTML')` 을 쓰지 않는 이유 — 크롬은 넣는 순간
+ * 주변 글자의 계산된 스타일을 `<span style>` 으로 덧입혀, 깨끗하게 다듬은 조각을
+ * 다시 지저분하게 만든다. 표를 문단 안에 넣으면 문단을 이상하게 쪼개기도 한다.
+ * 이 에디터는 이력을 직접 관리하므로 브라우저 undo 스택이 필요 없다.
+ *
+ * 규칙은 워드프로세서와 같다.
+ * - 글자만 있는 조각은 캐럿 자리에 그대로 끼운다.
+ * - 문단 · 표 같은 블록이 있으면 지금 문단을 캐럿에서 둘로 나누고 그 사이에
+ *   넣는다. 첫 문단은 앞 조각에, 마지막 문단은 뒤 조각에 이어 붙인다.
+ * - 표 칸 · 목록 항목 · 코드 안처럼 블록을 둘 수 없는 자리에는 줄바꿈으로
+ *   이은 글로 넣는다.
+ */
+/**
+ * `range` 자리에 조각을 넣고, 넣은 내용의 **끝** 을 가리키는 [노드, 오프셋]
+ * 을 돌려준다 (캐럿을 둘 곳). `root` 는 본문 element.
+ */
+export declare function insertFragment(root: HTMLElement, range: Range, frag: DocumentFragment): [Node, number] | null;
+// (소스맵은 CJS 선언 사본에서 제외됨 — scripts/finalize-types.mjs)

package/dist-types/cjs/core/paste-clean.d.cts

@@ -0,0 +1,36 @@
+/**
+ * 붙여넣은 HTML 을 에디터 문서로 다듬는다 — 워드 · 한글 · 엑셀 · 웹.
+ *
+ * ## 왜 필요한가
+ *
+ * 오피스 프로그램이 클립보드에 올리는 HTML 은 문서가 아니라 "그 프로그램이
+ * 다시 읽을 수 있는 덤프" 다. 서식 대부분이 `<style>` 의 클래스 규칙
+ * (`.xl65`, `p.MsoNormal`, `P.HStyle0`) 에 들어 있고, 본문에는 `mso-*` 속성 ·
+ * `<o:p>` · 조건부 주석 · 목록 기호를 흉내 낸 글자가 섞여 있다. 그대로 넣으면
+ *
+ * - 엑셀 머리글의 배경 · 테두리 · 굵기가 사라지고(클래스에만 있으므로),
+ * - 워드 글머리 목록이 "§ 신규 고객" 같은 글자 문단이 되고,
+ * - 저장한 HTML 이 몇 배로 부풀어 서버 · 뷰어에서도 같은 쓰레기를 끌고 다닌다.
+ *
+ * ## 무엇을 하는가
+ *
+ * 1. `DOMParser` 로 **비활성 문서** 에 읽는다 — 스크립트가 돌지 않고 이미지도
+ *    내려받지 않는다. 보안 거름은 이 다음 단계(`parseSafeFragment`) 가 맡는다.
+ * 2. `<style>` 의 클래스 규칙에서 **눈에 보이는 서식만**(굵기 · 기울임 · 색 ·
+ *    배경 · 정렬 · 테두리) 골라 요소의 style 로 옮긴다. 글꼴 · 크기 · 줄 간격 같은
+ *    "문서 기본값" 은 옮기지 않는다 — 붙여넣은 글이 주변 글과 다른 글꼴로 박히는
+ *    것이 사용자가 가장 싫어하는 결과다. 요소에 **직접** 쓴 글꼴 · 크기는 남긴다.
+ * 3. 워드의 `mso-list` 문단을 진짜 `<ul>/<ol>` 로 묶는다(수준별 중첩 포함).
+ * 4. `mso-*` · 클래스 · `lang` · `<o:p>` · 빈 `<span>` 을 걷어 낸다. 길이 단위 pt 는
+ *    px 로 (글자 크기는 에디터 목록과 같은 pt 로 둔다).
+ * 5. 표 칸 안의 문단 하나짜리 `<p>` 는 풀어 칸에 글만 남긴다.
+ */
+export type PasteSource = 'word' | 'excel' | 'hwp' | 'web';
+/** 클립보드 HTML 이 어느 프로그램에서 왔는지. */
+export declare function detectSource(html: string): PasteSource;
+/**
+ * 붙여넣을 HTML 을 다듬어 돌려준다. 결과는 아직 **신뢰할 수 없는** HTML 이다
+ * — 호출하는 쪽이 반드시 sanitize 를 거쳐 문서에 넣는다.
+ */
+export declare function cleanPastedHtml(html: string): string;
+// (소스맵은 CJS 선언 사본에서 제외됨 — scripts/finalize-types.mjs)

package/dist-types/cjs/core/sanitize-dom.d.cts

@@ -0,0 +1,21 @@
+/** 신뢰할 수 없는 HTML 을 정화한 DocumentFragment 로 만든다. `doc` 의 노드다. */
+export declare function parseSafeFragment(html: string, doc?: Document): DocumentFragment;
+/**
+ * `root` 아래를 제자리에서 정화한다. `root` 자신의 속성은 건드리지 않는다.
+ *
+ * 이미 문서에 붙어 있는 트리에도 쓸 수 있다 (붙여넣기 뒤 방어선 등). 다만
+ * 그때는 이미 로드가 시작됐을 수 있으므로 들어오는 길목에서는
+ * {@link parseSafeFragment} 를 쓴다.
+ */
+export declare function sanitizeTree(root: ParentNode): void;
+/**
+ * 이미 본문에 붙은 트리의 방어선 — **실행 경로만** 끊는다.
+ *
+ * 들어오는 길목은 {@link parseSafeFragment} 가 맡는다. 이 함수는 그 길목을
+ * 거치지 않고 브라우저가 직접 넣은 HTML(끌어다 놓기 등) 을 위해 타이핑마다
+ * 바뀐 블록에만 돈다. 그래서 가볍게 유지한다 — 모르는 태그를 벗기거나
+ * 속성 허용 목록을 적용하지 않는다(에디터의 편집 보조 버튼도 이 트리 안에
+ * 있다). 스크립트 · 임베드 · 이벤트 핸들러 · 위험한 URL 만 지운다.
+ */
+export declare function guardLiveTree(root: Element): void;
+// (소스맵은 CJS 선언 사본에서 제외됨 — scripts/finalize-types.mjs)

package/dist-types/cjs/core/sanitize-html.d.cts

@@ -0,0 +1,8 @@
+/**
+ * 신뢰할 수 없는 HTML 을 허용 목록으로 정화해 문자열로 돌려준다.
+ *
+ * 에디터의 `getHTML()` 출력은 이미 이 규칙을 만족하므로 그대로 통과한다
+ * (정화는 멱등이다 — 두 번 거쳐도 결과가 같다).
+ */
+export declare function sanitizeHTML(html: string): string;
+// (소스맵은 CJS 선언 사본에서 제외됨 — scripts/finalize-types.mjs)

package/dist-types/cjs/core/sanitize-policy.d.cts

@@ -0,0 +1,22 @@
+export type TagAction = 'keep' | 'unwrap' | 'drop';
+export declare function tagAction(tag: string): TagAction;
+/**
+ * 속성 하나를 판정한다. 남길 값(필요하면 고친 값) 또는 버리라는 뜻의 `null`.
+ *
+ * `tag` · `name` 은 소문자로 넘긴다.
+ */
+export declare function cleanAttr(tag: string, name: string, value: string): string | null;
+export declare function safeId(value: string): string | null;
+/**
+ * 인라인 `style` 값을 정화한다. 위험한 선언만 빼고 나머지는 그대로 둔다.
+ *
+ * `url(...)` 은 이미지 URL 로 안전한 것(http(s), data:image, 상대 경로) 만
+ * 남긴다. `url(javascript:…)` 는 오래된 브라우저에서 실행된다.
+ */
+export declare function cleanStyle(css: string): string;
+/**
+ * 새 창으로 여는 링크에 `rel="noopener noreferrer"` 를 보장한다.
+ * 열린 페이지가 `window.opener` 로 원래 페이지를 바꿔치기하는 것을 막는다.
+ */
+export declare function relForTarget(target: string | null, rel: string | null): string | null;
+// (소스맵은 CJS 선언 사본에서 제외됨 — scripts/finalize-types.mjs)

package/dist-types/cjs/core/selection.d.cts

@@ -20,6 +20,11 @@ export declare function captureSelectionOffsets(root: HTMLElement): SelectionOff
  * 문서가 짧아져 오프셋이 넘치면 가장 가까운 위치(문서 끝) 에 둔다.
  */
 export declare function restoreSelectionOffsets(root: HTMLElement, saved: SelectionOffsets): void;
+/** 문자 오프셋에 해당하는 (텍스트 노드, 노드 안 offset). */
+export declare function pointAtTextOffset(root: HTMLElement, offset: number): {
+    node: Node;
+    offset: number;
+};
 /**
  * 캐럿이 블록의 맨 끝에 있는지.
  *

package/dist-types/cjs/core/table-grid.d.cts

@@ -0,0 +1,87 @@
+/**
+ * 표 격자 모델 — 병합 셀(`rowspan` · `colspan`) 을 반영한 좌표.
+ *
+ * ## 왜 필요한가
+ *
+ * DOM 의 `<tr>` 안 셀 순번은 **열 번호가 아니다.** 위 행의 `rowspan` 이 내려와
+ * 자리를 차지하면 그 행의 첫 `<td>` 가 2열일 수 있고, `colspan="2"` 셀 다음
+ * 셀은 3열이다. 1.0 은 셀 순번을 열 번호로 써서, 엑셀 · 한글에서 가져온 병합
+ * 표에 열을 넣으면 머리글과 데이터가 어긋났다.
+ *
+ * 여기서는 표를 한 번 훑어 "몇 행 몇 열 칸을 어느 셀이 차지하는가" 를 담은
+ * 격자를 만들고, 행 · 열 삽입과 삭제 · 병합 · 분할을 모두 그 격자 위에서
+ * 계산한다. 모든 조작은 끝난 뒤에도 표가 **직사각형**(모든 행의 칸 수가 같음)
+ * 이도록 유지한다.
+ */
+/** 격자 위 셀 하나. `row` · `col` 은 셀이 시작하는 칸(왼쪽 위) 이다. */
+export interface GridCell {
+    el: HTMLTableCellElement;
+    row: number;
+    col: number;
+    rowSpan: number;
+    colSpan: number;
+}
+export interface TableGrid {
+    /** 표의 모든 행 (thead · tbody · tfoot 순서 그대로). */
+    rows: HTMLTableRowElement[];
+    /** `slots[r][c]` = 그 칸을 차지하는 셀. 빈 칸(모양이 깨진 표) 은 null. */
+    slots: (GridCell | null)[][];
+    /** 열 수. */
+    width: number;
+    /** 셀 element → 격자 정보. */
+    cells: Map<HTMLTableCellElement, GridCell>;
+}
+/** 직사각형 범위. 양 끝 포함. */
+export interface GridRect {
+    top: number;
+    left: number;
+    bottom: number;
+    right: number;
+}
+/** 표를 훑어 격자를 만든다. */
+export declare function buildGrid(table: HTMLTableElement): TableGrid;
+/** 셀이 덮는 범위. */
+export declare function rectOf(cell: GridCell): GridRect;
+/**
+ * 두 셀을 모서리로 하는 직사각형. 걸치는 병합 셀이 있으면 그 셀이 통째로
+ * 들어오도록 범위를 넓힌다 — 병합 셀의 일부만 고르는 일은 없다.
+ */
+export declare function expandRect(grid: TableGrid, rect: GridRect): GridRect;
+/** 직사각형 안의 셀들 (문서 순서, 중복 없음). */
+export declare function cellsInRect(grid: TableGrid, rect: GridRect): HTMLTableCellElement[];
+/** 두 셀을 모서리로 한 선택 범위의 셀들 (병합 셀을 통째로 포함). */
+export declare function cellsBetween(table: HTMLTableElement, a: HTMLTableCellElement, b: HTMLTableCellElement): HTMLTableCellElement[];
+/** `cell` 이 있는 행의 위/아래에 행을 넣는다. 새 행의 첫 셀을 돌려준다. */
+export declare function insertRow(table: HTMLTableElement, cell: HTMLTableCellElement, where: 'above' | 'below'): HTMLTableCellElement | null;
+/** `cell` 이 덮는 행들을 지운다. 표에 행이 하나뿐이면 아무 것도 하지 않는다. */
+export declare function deleteRow(table: HTMLTableElement, cell: HTMLTableCellElement): boolean;
+/** `cell` 이 있는 열의 왼쪽/오른쪽에 열을 넣는다. */
+export declare function insertColumn(table: HTMLTableElement, cell: HTMLTableCellElement, where: 'left' | 'right'): void;
+/** `cell` 이 덮는 열들을 지운다. 열이 하나뿐이면 아무 것도 하지 않는다. */
+export declare function deleteColumn(table: HTMLTableElement, cell: HTMLTableCellElement): boolean;
+/** 고른 셀들을 하나로 합칠 수 있는지 (두 칸 이상을 덮어야 한다). */
+export declare function canMerge(table: HTMLTableElement, cells: readonly HTMLTableCellElement[]): boolean;
+/**
+ * 고른 셀들을 감싸는 직사각형을 셀 하나로 합친다. 합쳐진 셀(왼쪽 위) 을
+ * 돌려준다. 다른 셀의 내용은 줄을 바꿔 뒤에 이어 붙인다 — 한글 · 워드와 같다.
+ */
+export declare function mergeCells(table: HTMLTableElement, cells: readonly HTMLTableCellElement[]): HTMLTableCellElement | null;
+/** 병합 셀을 1×1 칸들로 나눈다. 나눌 것이 없으면 false. */
+export declare function splitCell(table: HTMLTableElement, cell: HTMLTableCellElement): boolean;
+/** 셀이 병합 셀인지. */
+export declare function isMerged(cell: HTMLTableCellElement): boolean;
+/** 격자 순서(행 우선) 로 다음 셀. 마지막 셀이면 null. */
+export declare function gridNextCell(table: HTMLTableElement, cell: HTMLTableCellElement): HTMLTableCellElement | null;
+/** 격자 순서로 이전 셀. 첫 셀이면 null. */
+export declare function gridPreviousCell(table: HTMLTableElement, cell: HTMLTableCellElement): HTMLTableCellElement | null;
+/**
+ * 행 · 열을 지운 뒤 캐럿을 둘 셀. 지워지는 범위 바로 아래(오른쪽) 셀, 없으면
+ * 바로 위(왼쪽) 셀. 지우기 **전에** 부른다.
+ */
+export declare function neighborAfterDelete(table: HTMLTableElement, cell: HTMLTableCellElement, axis: 'row' | 'col'): HTMLTableCellElement | null;
+/**
+ * 열 너비를 끌어 바꿀 때 너비를 줄 셀들 — `cell` 의 오른쪽 경계 열에 있는
+ * 1칸짜리 셀. 병합 셀의 너비는 그 열들의 합이라 브라우저가 맞춘다.
+ */
+export declare function columnCells(table: HTMLTableElement, cell: HTMLTableCellElement): HTMLTableCellElement[];
+// (소스맵은 CJS 선언 사본에서 제외됨 — scripts/finalize-types.mjs)

package/dist-types/cjs/core/table-ops.d.cts

@@ -1,30 +1,10 @@
 /**
- * 표 셀의 기하와 이동.
+ * 표 셀 하나에 대한 판정 — 노드가 속한 셀, 포인터가 셀 가장자리에 있는지.
  *
- * 표 편집은 "지금 어느 셀인가" 를 계속 되묻는 일이다 — 캐럿이 놓인 셀, 드래그
- * 로 걸친 셀 범위, 마우스가 가장자리에 닿았는지, Tab 을 눌렀을 때 다음 셀.
- * 그 판정들만 여기 모은다. 에디터 인스턴스 상태를 보지 않는 순수 계산이라
- * 따로 두면 표 동작을 고칠 때 에디터 본체를 읽지 않아도 된다.
- *
- * **rowspan / colspan 은 고려하지 않는다.** 이 에디터는 둘 다 만들지 않으며,
- * 병합 셀을 지원하게 되면 여기 있는 인덱스 계산은 전부 다시 짜야 한다.
+ * 행 · 열 · 병합처럼 표 전체 모양을 따지는 계산은 `table-grid` 에 있다.
  */
 /** 임의의 노드에서 가장 가까운 td/th element. 없으면 null. */
 export declare function nearestCell(node: Node): HTMLTableCellElement | null;
-/**
- * 다음 표 셀. 행 끝이면 다음 행의 첫 셀, 표의 마지막 셀이면 **새 행을 만들어**
- * 그 첫 셀을 돌려준다 — Tab 만으로 표를 끝까지 채울 수 있도록.
- */
-export declare function nextTableCell(cell: HTMLTableCellElement, table: HTMLTableElement): HTMLTableCellElement | null;
-/** 이전 표 셀. 첫 셀이면 null. */
-export declare function previousTableCell(cell: HTMLTableCellElement): HTMLTableCellElement | null;
-/**
- * `startCell` 과 `endCell` 을 모서리로 하는 사각 영역의 모든 td/th.
- *
- * thead 와 tbody 가 섞여 있어도 `querySelectorAll('tr')` 의 document order 로
- * 단일 행 인덱스를 매긴다 — 사용자 눈에 보이는 순서와 같다.
- */
-export declare function cellsInRectangle(table: HTMLTableElement, startCell: HTMLTableCellElement, endCell: HTMLTableCellElement): HTMLTableCellElement[];
 /** 셀의 우/하 가장자리에 포인터가 있으면 'right' / 'bottom'. 아니면 null. */
 export declare function detectCellEdge(cell: HTMLTableCellElement, x: number, y: number): 'right' | 'bottom' | null;
 // (소스맵은 CJS 선언 사본에서 제외됨 — scripts/finalize-types.mjs)

package/dist-types/cjs/highlight/index.d.cts

@@ -0,0 +1,5 @@
+import type { CodeHighlighter } from '../types/index.cjs';
+export type { CodeHighlighter } from '../types/index.cjs';
+/** 기본 제공 언어 16 종(Plain Text 포함) 의 색칠기. */
+export declare const highlighter: CodeHighlighter;
+// (소스맵은 CJS 선언 사본에서 제외됨 — scripts/finalize-types.mjs)

package/dist-types/cjs/index.d.cts

@@ -1,22 +1,30 @@
+/**
+ * `@aeriz/wysiwyg` — 브라우저 진입점. 스타일시트를 부수 효과로 불러온다.
+ *
+ * 여기서 내보내는 것이 공개 API 의 전부다. 에디터 내부(블록 레지스트리 ·
+ * 정규화 · HTML 파서 · 로케일 사전) 는 내보내지 않는다 — 내보내면 고칠 때마다
+ * 호환이 깨진다. 서버(Node · workerd · Deno) 에서는 CSS 를 끌어오지 않는
+ * `@aeriz/wysiwyg/server` 를 쓴다.
+ */
 // (CSS 부수 효과 import 는 타입 선언에서 제거됨 — scripts/strip-css-imports.mjs)
 export { AerizEditor } from './core/AerizEditor.cjs';
-export type { EditorState, EditorStateListener, InlineState, } from './core/AerizEditor.cjs';
+export type { EditorState, EditorStateListener, InlineState } from './core/AerizEditor.cjs';
 export { AerizViewer } from './core/AerizViewer.cjs';
 export type { ViewerOptions } from './core/AerizViewer.cjs';
-export { ALIGN_CLASS_BY_VALUE, ALL_INLINE_MARKS, BLOCK_ID_ATTR, BLOCK_TYPES, BLOCK_TYPE_BY_KIND, BlockIdRegistry, applyBlockClassNames, applyBlockInlineStyles, assignMissingIds, classifyBlockElement, extractInlineContent, fillInlineContent, findBlockFrom, getBlockLabel, isElementBlank, listBlocks, normalizeContent, placeCaretAtStart, readBlockStyleTheme, renderBlock, renderBlocks, serializeBlock, serializeBlocks, restoreAlignFromClasses, stripEditorOnlyAttrs, stripEditorOnlyNodes, } from './core/blocks.cjs';
-export type { BlockStyleTheme } from './core/blocks.cjs';
-export type { Block, BlockAttrs, BlockAttrsByKind, BlockIdResolver, BlockKind, BlockMatch, BlockSnapshot, BlockType, BlockquoteAttrs, BulletListAttrs, ClassifyResult, CodeBlockAttrs, FileAttrs, HeadingAttrs, HeadingLevel, HrAttrs, ImageAttrs, ImportedHtmlAttrs, InlineMarkName, LinkCardAttrs, OrderedListAttrs, ParagraphAttrs, Snapshot, TableAttrs, UnknownAttrs, YoutubeAttrs, } from './core/blocks.cjs';
-export { getLocale, setLocale, t } from './core/i18n.cjs';
-export type { Locale, Strings } from './core/i18n.cjs';
-export type { EditorOptions, HtmlStyleMode, SerializeHtmlOptions, ToolbarConfig, ToolbarItem, ToolbarItemName, } from './types/index.cjs';
+export type { EditorErrorCode, EditorOptions, HtmlStyleMode, SerializeHtmlOptions, ToolbarConfig, ToolbarItem, ToolbarItemName, UploadOptions, CodeHighlighter, } from './types/index.cjs';
 export { DEFAULT_TOOLBAR } from './types/index.cjs';
-export { SNAPSHOT_VERSION, snapshotVersionOf, upgradeSnapshot, upgradeSnapshots, } from './core/snapshot.cjs';
-export { renderBlockToHTML, renderBlocksToHTML } from './core/render-string.cjs';
+export { DEFAULT_FONTS, DEFAULT_FONT_SIZES } from './core/fonts.cjs';
+export type { FontFamily } from './core/fonts.cjs';
+export type { Locale } from './core/i18n.cjs';
+export { SNAPSHOT_VERSION, upgradeSnapshots } from './core/snapshot.cjs';
+export { renderBlocksToHTML } from './core/render-string.cjs';
 export type { RenderHtmlOptions } from './core/render-string.cjs';
+export { sanitizeHTML } from './core/sanitize-html.cjs';
+export { htmlToBlocks } from './core/html-to-blocks.cjs';
 export { blocksToMarkdown } from './core/markdown-export.cjs';
 export type { MarkdownOptions } from './core/markdown-export.cjs';
+export { markdownToBlocks, markdownToHtml } from './core/import-markdown.cjs';
 export { blocksToPlainText } from './core/plain-text.cjs';
 export type { PlainTextOptions } from './core/plain-text.cjs';
-export { decodeEntities, escapeAttr, escapeHtml, parseHtmlFragment, serializeNodes, textOf, textWithBlockBreaks, } from './core/html-mini.cjs';
-export type { HtmlElementNode, HtmlNode, HtmlText } from './core/html-mini.cjs';
+export type { Block, BlockAttrs, BlockAttrsByKind, BlockKind, BlockSnapshot, BlockquoteAttrs, BulletListAttrs, CodeBlockAttrs, FileAttrs, HeadingAttrs, HeadingLevel, HrAttrs, ImageAttrs, ImportedHtmlAttrs, InlineMarkName, LinkCardAttrs, OrderedListAttrs, ParagraphAttrs, Snapshot, TableAttrs, UnknownAttrs, YoutubeAttrs, } from './core/blocks.cjs';
 // (소스맵은 CJS 선언 사본에서 제외됨 — scripts/finalize-types.mjs)

package/dist-types/cjs/server/index.d.cts

@@ -24,14 +24,13 @@
  *     },
  *   };
  */
-export { renderBlockToHTML, renderBlocksToHTML, } from '../core/render-string.cjs';
+export { renderBlocksToHTML } from '../core/render-string.cjs';
 export type { RenderHtmlOptions } from '../core/render-string.cjs';
+export { sanitizeHTML } from '../core/sanitize-html.cjs';
 export { blocksToMarkdown } from '../core/markdown-export.cjs';
 export type { MarkdownOptions } from '../core/markdown-export.cjs';
 export { blocksToPlainText } from '../core/plain-text.cjs';
 export type { PlainTextOptions } from '../core/plain-text.cjs';
-export { SNAPSHOT_VERSION, snapshotVersionOf, upgradeSnapshot, upgradeSnapshots, } from '../core/snapshot.cjs';
-export type { Block, BlockAttrs, BlockAttrsByKind, BlockKind, BlockSnapshot, BlockquoteAttrs, BulletListAttrs, CodeBlockAttrs, FileAttrs, HeadingAttrs, HeadingLevel, HrAttrs, ImageAttrs, ImportedHtmlAttrs, InlineMarkName, LinkCardAttrs, OrderedListAttrs, ParagraphAttrs, Snapshot, TableAttrs, UnknownAttrs, YoutubeAttrs, } from '../core/blocks.cjs';
-export { decodeEntities, escapeAttr, escapeHtml, parseHtmlFragment, serializeNodes, textOf, textWithBlockBreaks, } from '../core/html-mini.cjs';
-export type { HtmlElementNode, HtmlNode, HtmlText } from '../core/html-mini.cjs';
+export { SNAPSHOT_VERSION, upgradeSnapshots } from '../core/snapshot.cjs';
+export type { BlockAttrs, BlockAttrsByKind, BlockKind, BlockSnapshot, BlockquoteAttrs, BulletListAttrs, CodeBlockAttrs, FileAttrs, HeadingAttrs, HeadingLevel, HrAttrs, ImageAttrs, ImportedHtmlAttrs, InlineMarkName, LinkCardAttrs, OrderedListAttrs, ParagraphAttrs, Snapshot, TableAttrs, UnknownAttrs, YoutubeAttrs, } from '../core/blocks.cjs';
 // (소스맵은 CJS 선언 사본에서 제외됨 — scripts/finalize-types.mjs)