@aeriz/wysiwyg 1.0.5 → 2.0.0

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

@@ -1,5 +1,6 @@
+import type { FontFamily } from '../core/fonts.cjs';
 export type ToolbarItem = ToolbarItemName | '|';
-export type ToolbarItemName = 'undo' | 'redo' | 'blockType' | 'fontFamily' | 'fontSize' | 'bold' | 'italic' | 'underline' | 'strike' | 'color' | 'backgroundColor' | 'align' | 'cellBg' | 'tableMenu' | 'codeLang' | 'bulletList' | 'orderedList' | 'blockquote' | 'codeBlock' | 'link' | 'image' | 'table' | 'hr' | 'clearFormat';
+export type ToolbarItemName = 'undo' | 'redo' | 'blockType' | 'fontFamily' | 'fontSize' | 'bold' | 'italic' | 'underline' | 'strike' | 'superscript' | 'subscript' | 'color' | 'backgroundColor' | 'align' | 'cellBg' | 'tableMenu' | 'codeLang' | 'bulletList' | 'orderedList' | 'blockquote' | 'codeBlock' | 'link' | 'image' | 'table' | 'hr' | 'clearFormat' | 'lineHeight' | 'letterSpacing' | 'specialChar' | 'findReplace' | 'source' | 'print' | 'fullscreen';
 export interface ToolbarConfig {
     items: ToolbarItem[];
     sticky?: boolean;
@@ -24,6 +25,12 @@ export interface EditorOptions {
     element: HTMLElement;
     initialHTML?: string;
     placeholder?: string;
+    /**
+     * 아래쪽 상태바(되돌리기 · 블록 수 · 글자 수) 를 보일지. 기본 `true`.
+     */
+    statusBar?: boolean;
+    /** 본문 편집 영역의 접근성 이름(aria-label). 기본은 로케일의 "본문 편집기". */
+    ariaLabel?: string;
     toolbar?: ToolbarConfig | false;
     theme?: 'light' | 'dark';
     /** UI 언어. 'en' / 'ko' / 'ja' / 'zh'. 기본 'ko'. */
@@ -35,27 +42,68 @@ export interface EditorOptions {
     htmlStyles?: HtmlStyleMode;
     onChange?: (html: string) => void;
     /**
-     * 직접 업로드 핸들러. 우선 적용된다. 미설정 + `imageUploadUrl` 만 있을 때는
-     * 에디터가 multipart/form-data 로 그 URL 에 POST 한 응답 JSON 의
-     * `url` 필드를 사용한다.
+     * 읽기 전용. 글을 고칠 수 없고 툴바는 인쇄 · 전체 화면만 쓸 수 있다.
+     * 나중에 바꾸려면 `editor.setReadOnly()`.
+     */
+    readOnly?: boolean;
+    /**
+     * 에디터 높이. 숫자는 px, 문자열은 CSS 값('60vh' 등). 지정하면 본문이 그 안에서
+     * 스크롤된다. 지정하지 않으면 부모 높이를 채우고 최소 320px 이다.
      */
-    onImageUpload?: (file: File) => Promise<string>;
+    height?: number | string;
+    /** 그림 · 파일 올리기. 없으면 다이얼로그의 "올리기" 탭이 꺼지고 붙여넣은 그림은 문서에 그대로 담긴다. */
+    upload?: UploadOptions;
     /**
-     * 서버 이미지 업로드 API URL. 설정 시 이미지 다이얼로그의 "업로드" 탭이
-     * 활성화된다. 미설정 시 업로드 탭은 비활성 + 툴팁 안내.
+     * 에디터 안에서 난 오류(올리기 실패 등). 지정하지 않으면 콘솔에 남긴다.
+     * `code` 로 종류를 가린다.
      */
-    imageUploadUrl?: string;
+    onError?: (error: Error, context: {
+        code: EditorErrorCode;
+    }) => void;
     /**
-     * 파일 첨부 직접 업로드 핸들러. 첨부 다이얼로그의 "업로드" 탭에서 사용.
-     * 미설정 + `fileUploadUrl` 만 있을 때는 에디터가 multipart/form-data 로
-     * POST 한 응답 JSON 의 `url` 필드를 사용한다.
+     * 코드 블록 색칠기. 없으면 코드는 색 없이 보이고 언어 고르기 버튼도 숨는다.
+     * 기본 색칠기는 `import { highlighter } from '@aeriz/wysiwyg/highlight'`.
      */
-    onFileUpload?: (file: File) => Promise<string>;
+    highlighter?: CodeHighlighter;
     /**
-     * 서버 파일 업로드 API URL. 설정 시 파일 첨부 다이얼로그의 "업로드" 탭이
-     * 활성화된다. 미설정 시 업로드 탭은 비활성 + 툴팁 안내.
+     * 글꼴 드롭다운 목록. 기본은 한국 문서에서 쓰는 시스템 글꼴(맑은 고딕 · 굴림 ·
+     * 돋움 · 바탕 · 궁서 …) 이며 네트워크를 쓰지 않는다. 웹폰트는 `cssUrl` 을
+     * 함께 주면 드롭다운을 처음 열 때 받는다. 이 PC 에 없는 글꼴은 목록에서 빠진다.
+     *
+     * `{ label: '', stack: '' }` 항목은 "기본 글꼴"(서식 지우기) 이다.
      */
-    fileUploadUrl?: string;
+    fonts?: ReadonlyArray<FontFamily>;
+    /** 글자 크기 드롭다운 목록(pt). 기본 8 ~ 48pt. */
+    fontSizes?: ReadonlyArray<number>;
+}
+/** `onError` 의 오류 종류. */
+export type EditorErrorCode = 'upload' | 'paste';
+/**
+ * 그림 · 파일 올리기 설정. 둘 중 하나를 준다.
+ *
+ * - `url` — 그 주소로 `multipart/form-data`(필드 `file`, `kind`) 를 POST 하고,
+ *   응답 JSON 의 `url` 을 쓴다. 인증이 필요하면 `headers`.
+ * - `handler` — 직접 올리고 주소를 돌려준다 (S3 서명 URL 등).
+ */
+/**
+ * 코드 블록 색칠기. `highlight` 는 글을 받아 HTML 을 돌려준다. 결과는 `<span class>`
+ * 만 남기고 걸러서 넣으므로, 다른 태그나 속성은 무시된다.
+ */
+export interface CodeHighlighter {
+    /** 언어 고르기 목록. `id` 는 `<code data-language>` 에 저장된다. */
+    languages: ReadonlyArray<{
+        id: string;
+        label: string;
+    }>;
+    highlight(code: string, languageId: string | undefined): string;
+}
+export interface UploadOptions {
+    url?: string;
+    /** `url` 로 보낼 때 붙일 헤더. 함수면 보낼 때마다 불러 최신 토큰을 쓴다. */
+    headers?: Record<string, string> | (() => Record<string, string>);
+    handler?: (file: File, kind: 'image' | 'file') => Promise<string>;
+    /** 올릴 수 있는 최대 크기(바이트). 넘으면 올리지 않고 `onError('upload')`. */
+    maxSize?: number;
 }
 export declare const DEFAULT_TOOLBAR: ToolbarConfig;
 // (소스맵은 CJS 선언 사본에서 제외됨 — scripts/finalize-types.mjs)

package/dist-types/cjs/ui/Toolbar.d.cts

@@ -1,11 +1,21 @@
 import type { ToolbarConfig, ToolbarItemName } from '../types/index.cjs';
 export interface ToolbarHandlers {
     onAction: (name: ToolbarItemName, anchor: HTMLElement) => void;
+    /** 툴바에서 Esc — 본문으로 돌아간다. */
+    onEscape: () => void;
 }
 export declare class Toolbar {
     readonly element: HTMLDivElement;
     private buttons;
     constructor(config: ToolbarConfig, handlers: ToolbarHandlers);
+    /** 툴바에 있는 항목 이름들. */
+    names(): ToolbarItemName[];
+    /** 툴바로 포커스를 옮긴다 (Alt+F10). 마지막으로 머문 버튼, 없으면 첫 버튼. */
+    focus(): void;
+    /** 소스 보기처럼 툴바 대부분을 잠글 때. `except` 는 계속 쓸 수 있다. */
+    setAllEnabled(enabled: boolean, except: ToolbarItemName): void;
+    private focusable;
+    private handleKeydown;
     setActive(name: ToolbarItemName, active: boolean): void;
     setEnabled(name: ToolbarItemName, enabled: boolean): void;
     /** 조건부 항목을 완전히 숨긴다 (display:none). 허용 블록으로 돌아오면 다시 보임. */

package/dist-types/cjs/ui/doc-tools.d.cts

@@ -0,0 +1,58 @@
+/** 줄 간격(%). 한글의 기본값 160% 를 포함한다. */
+export declare const LINE_HEIGHTS: ReadonlyArray<number>;
+/** 자간(em 의 백분율). 한글의 자간 -5% 는 letter-spacing: -0.05em 이다. */
+export declare const LETTER_SPACINGS: ReadonlyArray<number>;
+/** 줄 간격 드롭다운. `current` 는 지금 블록의 line-height(%), 모르면 null. */
+export declare function openLineHeightDropdown(anchor: HTMLElement, onPick: (percent: number) => void, current: number | null): void;
+/** 자간 드롭다운. 값은 em 의 백분율(-5 → -0.05em). */
+export declare function openLetterSpacingDropdown(anchor: HTMLElement, onPick: (percent: number) => void, current: number | null): void;
+/** 특수 문자 표. 고르면 `onPick(char)` — 팝오버는 열어 둔다(여러 개 넣기). */
+export declare function openSpecialCharDropdown(anchor: HTMLElement, onPick: (char: string) => void): void;
+interface Match {
+    range: Range;
+}
+/**
+ * 본문 안 글자 검색. 블록마다 텍스트 노드를 이어 붙인 문자열에서 찾으므로
+ * 굵게 · 색 같은 서식 경계를 넘는 낱말도 찾는다. 블록 경계는 넘지 않는다.
+ */
+export declare function findInContent(root: HTMLElement, query: string, matchCase: boolean): Match[];
+export interface FindPanelHost {
+    content: HTMLElement;
+    /** 바꾸기 전에 부른다 — 이력이 한 단계로 묶이도록. */
+    beforeChange(): void;
+    /** 바꾼 뒤에 부른다. */
+    afterChange(): void;
+}
+/**
+ * 찾기 · 바꾸기 패널. 에디터 위쪽에 붙는 작은 막대다 — 모달로 띄우면 찾은
+ * 자리를 가린다.
+ */
+export declare class FindPanel {
+    private readonly host;
+    readonly element: HTMLDivElement;
+    private readonly findInput;
+    private readonly replaceInput;
+    private readonly caseBox;
+    private readonly status;
+    private matches;
+    private index;
+    constructor(host: FindPanelHost);
+    get isOpen(): boolean;
+    open(): void;
+    close(): void;
+    /** 문서가 바뀌면 다시 찾는다 (열려 있을 때만). */
+    refresh(): void;
+    private search;
+    private step;
+    private paint;
+    private replaceOne;
+    private replaceAll;
+}
+/**
+ * 문서만 인쇄한다 — 툴바 · 핸들 · 페이지의 다른 부분 없이. 보이지 않는 iframe
+ * 에 `getHTML()` 결과(스타일이 인라인으로 들어 있다) 를 넣고 그 창을 인쇄한다.
+ * iframe 은 스크립트를 돌리지 않는다(sandbox) — 인쇄만 허용한다.
+ */
+export declare function printHtml(html: string, title: string): void;
+export {};
+// (소스맵은 CJS 선언 사본에서 제외됨 — scripts/finalize-types.mjs)

package/dist-types/cjs/ui/popovers.d.cts

@@ -1,4 +1,7 @@
 import type { BlockAttrs, BlockKind } from '../core/blocks.cjs';
+import type { FontFamily } from '../core/fonts.cjs';
+/** contentEditable 선택 영역이 사라지지 않도록 mousedown 시 포커스 이동을 막는다. */
+export declare function preserveSelection(el: HTMLElement): void;
 export declare const COLOR_PALETTE: string[];
 export declare function openColorPicker(anchor: HTMLElement, onPick: (color: string | null) => void, recents?: ReadonlyArray<string>): void;
 /**
@@ -12,46 +15,30 @@ export interface BlockTypeChoice {
 }
 export declare function openBlockTypeDropdown(anchor: HTMLElement, onPick: (choice: BlockTypeChoice) => void): void;
 export declare function openAlignDropdown(anchor: HTMLElement, onPick: (value: 'left' | 'center' | 'right' | 'justify') => void): void;
-export interface FontFamilyChoice {
-    id: string;
-    label: string;
-    stack: string;
-}
 /**
- * 글꼴 선택 드롭다운. 첫 호출 시 모든 글꼴 CSS 를 lazy 로드(Google Fonts +
- * Pretendard CDN), 항목 라벨은 각 글꼴 자신으로 미리보기 렌더한다.
- *
- * - `currentId` 가 지정되면 해당 글꼴 항목에 `aw-popover-item-active` 적용
- * - 선택 시 `onPick(choice)` 호출 + 팝오버 닫힘
+ * 글꼴 드롭다운. 항목 이름 옆 미리보기('가A') 만 그 글꼴로 그린다.
+ * 이 PC 에 없는 글꼴은 확인되는 대로 목록에서 빠진다.
  */
-export declare function openFontFamilyDropdown(anchor: HTMLElement, onPick: (choice: FontFamilyChoice) => void, currentId?: string): void;
+export declare function openFontFamilyDropdown(anchor: HTMLElement, fonts: ReadonlyArray<FontFamily>, onPick: (font: FontFamily) => void, current?: FontFamily | null): void;
 export interface CodeLanguageChoice {
     id: string;
     label: string;
 }
 /**
- * 코드 블록의 언어 선택 드롭다운. highlight.ts 의 LANGUAGES 를 그대로 노출.
+ * 코드 블록의 언어 선택 드롭다운. 색칠기(`highlighter.languages`) 의 목록을 보여 준다.
  *
  * - `currentId` 가 일치하는 항목에 active(✓) 표시
  * - 선택 시 onPick(choice) 호출 + 팝오버 닫힘
  */
-export declare function openCodeLanguageDropdown(anchor: HTMLElement, onPick: (choice: CodeLanguageChoice) => void, currentId?: string): void;
-export type TableMenuAction = 'rowAbove' | 'rowBelow' | 'colLeft' | 'colRight' | 'deleteRow' | 'deleteCol';
+export declare function openCodeLanguageDropdown(anchor: HTMLElement, languages: ReadonlyArray<CodeLanguageChoice>, onPick: (choice: CodeLanguageChoice) => void, currentId?: string): void;
+export type TableMenuAction = 'rowAbove' | 'rowBelow' | 'colLeft' | 'colRight' | 'deleteRow' | 'deleteCol' | 'mergeCells' | 'splitCell';
 /**
  * 표 편집 드롭다운 — 행/열 추가·삭제. 활성 블록이 table 일 때만 의미가 있어
  * AerizEditor 가 toolbar 'tableMenu' 항목 클릭 시점에 호출.
  */
-export declare function openTableMenuDropdown(anchor: HTMLElement, onPick: (action: TableMenuAction) => void): void;
-export interface FontSizeChoice {
-    px: number;
-}
-/**
- * 글자 크기 프리셋 드롭다운. FONT_SIZES 의 px 값을 작은 라벨로 나열.
- *
- * - `currentPx` 가 일치하는 항목에 active 표시
- * - 선택 시 `onPick({ px })` 호출 + 팝오버 닫힘
- */
-export declare function openFontSizeDropdown(anchor: HTMLElement, onPick: (choice: FontSizeChoice) => void, currentPx?: number): void;
+export declare function openTableMenuDropdown(anchor: HTMLElement, onPick: (action: TableMenuAction) => void, disabled?: ReadonlySet<TableMenuAction>): void;
+/** 글자 크기(pt) 드롭다운. `current` 와 같은 항목에 표시. */
+export declare function openFontSizeDropdown(anchor: HTMLElement, sizes: ReadonlyArray<number>, onPick: (pt: number) => void, current?: number | null): void;
 /**
  * 기능 미구현 메뉴 항목용 placeholder 드롭다운.
  * 항목명만 노출하고 "준비 중" 메시지를 보여준다.
@@ -67,4 +54,6 @@ export interface TableSizeChoice {
     cols: number;
 }
 export declare function openTableDropdown(anchor: HTMLElement, onPick: (choice: TableSizeChoice) => void): void;
+export declare function anchorPopover(popover: HTMLElement, anchor: HTMLElement): void;
+export declare function closeAllPopovers(): void;
 // (소스맵은 CJS 선언 사본에서 제외됨 — scripts/finalize-types.mjs)

package/dist-types/core/AerizEditor.d.ts

@@ -1,13 +1,15 @@
 import type { EditorOptions, SerializeHtmlOptions } from '../types/index.js';
 import { Toolbar } from '../ui/Toolbar.js';
-import type { Block, BlockAttrs, BlockKind, BlockSnapshot } from './blocks.js';
+import type { Block, BlockAttrs, BlockKind, BlockSnapshot, InlineMarkName } from './blocks.js';
 export type { Block, BlockAttrs, BlockKind, BlockMatch, BlockSnapshot, BlockType, ClassifyResult, HeadingLevel, } from './blocks.js';
-export interface InlineState {
-    bold: boolean;
-    italic: boolean;
-    underline: boolean;
-    strike: boolean;
-}
+/**
+ * 커서 위치에서 켜져 있는 인라인 마크들.
+ *
+ * 마크 목록을 그대로 따라간다 — 마크를 하나 늘릴 때 이 타입 · 상태 수집 ·
+ * 툴바 동기화를 각각 고치면 반드시 한 군데를 빠뜨린다 (그러면 버튼이 눌리긴
+ * 하는데 눌린 표시가 안 나는 식으로 어긋난다).
+ */
+export type InlineState = Record<InlineMarkName, boolean>;
 export interface EditorState {
     blocks: Block[];
     activeBlockId: string | null;
@@ -31,20 +33,39 @@ export declare class AerizEditor {
     private readonly statusBlockEl;
     private readonly statusBlocksEl;
     private readonly statusCharsEl;
-    private readonly statusSourceEl;
     private readonly options;
     private readonly observer;
     private readonly blockIds;
     private readonly idFor;
     private readonly listeners;
     private readonly handleSelectionChange;
+    /**
+     * 문서 전체의 selectionchange. **선택이 이 에디터 안에 있을 때만** 반응한다.
+     * 같은 페이지의 제목 입력란에서 타자를 칠 때도 이 이벤트가 오는데, 그때마다
+     * 에디터를 다시 동기화하면 키 하나에 수십 ms 를 쓴다(1.0 의 문제).
+     * 안에 있다가 밖으로 나간 순간 한 번은 동기화해서 활성 블록 표시를 지운다.
+     */
+    private readonly handleDocumentSelectionChange;
+    private selectionInside;
     private readonly handleResize;
     /** document 에 붙는다 — destroy() 에서 반드시 떼야 인스턴스가 GC 된다. */
     private readonly handleDocumentMouseUp;
     private state;
     private destroyed;
     private syncQueued;
-    private lastSerialized;
+    /** 바뀐 블록만 다시 계산하기 위한 장부. */
+    private tracker;
+    /** 표식(data-block-kind · label) 을 다시 달아야 하는 블록. */
+    private readonly markerPending;
+    /** state.blocks 를 다시 만들어야 하는지. */
+    private blocksStale;
+    private cachedBlocks;
+    /** 표식을 단 마지막 활성 블록. */
+    private focusedEl;
+    /** 오버레이(핸들 · 라벨) 위치 계산을 프레임당 한 번으로 묶는 rAF 핸들. */
+    private overlayRaf;
+    /** 상태바 갱신을 타이핑이 멈춘 뒤로 미루는 타이머. */
+    private statusTimer;
     /** 포인터가 올라가 있는 블록. 그 블록의 컨트롤만 드러낸다. */
     private hoveredBlockId;
     /** hover 판정을 프레임당 1 회로 묶기 위한 rAF 핸들. */
@@ -94,18 +115,39 @@ export declare class AerizEditor {
      * data-block-id 는 보존.
      */
     getHTML(options?: SerializeHtmlOptions): string;
-    /** 가공 없는 원본 innerHTML. 직렬화 검증/디버그 용도. */
-    getRawHTML(): string;
+    /**
+     * 본문을 통째로 갈아끼운다.
+     *
+     * 들어온 HTML 은 저장소에서 바로 온 값일 수 있으므로 정화를 거친다
+     * (`renderBlock` · `renderBlocksToHTML` 과 같은 규칙). 에디터가 스스로 만든
+     * 출력에는 걸릴 것이 없으니 왕복(`getHTML()` → 저장 → `setHTML()`) 은 그대로다.
+     */
     setHTML(html: string): void;
+    /**
+     * 블록 스냅샷(`getBlocks()` 의 결과 · 서버에 저장한 값) 으로 본문을 바꾼다.
+     * `setHTML` 과 같이 이력을 새로 시작한다.
+     */
+    setBlocks(blocks: readonly BlockSnapshot[]): void;
+    /** 본문을 통째로 갈아끼우는 공통 경로 (setHTML · setBlocks). */
+    private replaceDocument;
     focus(): void;
+    private readOnly;
+    /** 읽기 전용 켜고 끄기. 켜면 글을 고칠 수 없고 툴바는 인쇄 · 전체 화면만 남는다. */
+    setReadOnly(readOnly: boolean): void;
     setTheme(theme: 'light' | 'dark'): void;
     getState(): EditorState;
-    getBlocks(): Block[];
     /**
-     * 본문 블록들을 직렬화 가능한 BlockSnapshot 배열로 반환한다.
-     * AerizViewer.setBlocks(snapshots) 가 받아 동일한 트리를 렌더할 수 있다.
+     * 본문을 블록 스냅샷 배열로. 서버에 저장하거나 `AerizViewer.setBlocks()` ·
+     * `setBlocks()` 로 그대로 되살릴 수 있는 직렬화 형식이다.
+     */
+    getBlocks(): BlockSnapshot[];
+    /**
+     * 블록 목록. 구조나 내용이 바뀐 뒤 처음 부를 때만 다시 만든다 — 바뀌지
+     * 않은 블록은 분류 결과와 Block 객체를 그대로 쓴다.
      */
-    serialize(): BlockSnapshot[];
+    private currentBlocks;
+    /** 본문 직계 자식 하나를 Block 으로. 분류는 캐시를 쓴다. */
+    private blockOf;
     /**
      * data-block-id 로 본문에서 블록을 찾아 반환. 없으면 null.
      */
@@ -128,6 +170,11 @@ export declare class AerizEditor {
      * takeRecords 로 흡수한 뒤 onChange + queueSync.
      */
     private flush;
+    /** 지금 본문으로 이력 한 칸을 만든다. 바뀌지 않은 블록 문자열은 공유된다. */
+    private makeHistoryEntry;
+    /** 캐럿 위치를 "블록 순번 + 블록 안 글자 오프셋" 으로 읽는다. */
+    private captureDocSelection;
+    private restoreDocSelection;
     /**
      * 지금 본문을 이력에 기록한다.
      *
@@ -165,17 +212,45 @@ export declare class AerizEditor {
     redo(): void;
     private applyHistoryEntry;
     private handleToolbarAction;
+    /** 선택 영역이 걸친 본문 블록들 (캐럿만 있으면 그 블록 하나). */
+    private selectedTopBlocks;
+    /** 줄 간격(%) — 블록 단위. 한글처럼 문단 전체에 적용된다. */
+    private applyLineHeight;
+    /** 자간 — 선택한 글자에 `letter-spacing: Nem`. 0 은 기본으로 되돌린다. */
+    private applyLetterSpacing;
+    private findPanel;
+    /** 찾기 · 바꾸기 (Ctrl+H). */
+    openFind(): void;
+    private sourceArea;
+    private sourceStart;
+    /**
+     * HTML 소스 보기 ↔ 편집 화면. 소스에서 고친 내용은 돌아올 때 **거른 뒤**
+     * 본문에 넣고, 되돌리기 한 번으로 소스 편집 전체를 되돌릴 수 있다.
+     */
+    toggleSource(): void;
+    private fullscreenScroll;
+    /** 전체 화면 — 에디터가 창을 꽉 채운다. Esc 로 나온다. */
+    toggleFullscreen(): void;
     /**
      * 선택 영역의 인라인 서식을 지운다. 블록 유형은 건드리지 않는다 —
      * "서식 지우기" 로 제목이 본문이 되면 되돌릴 방법을 찾기 어렵다.
      */
     private clearInlineFormat;
     /**
-     * 인라인 마크(bold/italic/underline/strike) 토글. 활성 블록의 allowedMarks
-     * 에 포함되지 않은 마크면 무시. styleWithCSS=true 모드로 deprecated 태그
-     * (<b>/<i>/<u>) 대신 `<span style="font-weight:bold">` 형태가 만들어진다.
+     * 인라인 마크 토글. 활성 블록의 allowedMarks 에 포함되지 않은 마크면 무시.
+     * styleWithCSS=true 모드로 deprecated 태그(<b>/<i>/<u>) 대신
+     * `<span style="font-weight:bold">` 형태가 만들어진다.
+     *
+     * 마크 이름과 execCommand 명령명이 다른 것만 {@link MARK_COMMAND} 로 옮긴다.
+     *
+     * **위/아래 첨자만 styleWithCSS 를 끈다.** 켜 두면 Chrome 이 `<sub>` 대신
+     * `<span style="vertical-align: sub">` 를 만드는데, 그 span 은
+     *  - 글자가 작아지지 않아 첨자로 보이지 않고,
+     *  - 스크린 리더가 첨자로 읽지 않으며,
+     *  - 마크다운 내보내기가 `<sub>` / `<sup>` **태그**를 보고 판단하므로 첨자가
+     *    통째로 사라진다.
      *
-     * 'strike' 는 execCommand 표준 명령명이 'strikeThrough'.
+     * 나머지 마크는 반대다 — deprecated 된 `<b>` / `<i>` 대신 style 을 원한다.
      */
     private applyMark;
     /**
@@ -230,14 +305,11 @@ export declare class AerizEditor {
      * 가 항상 우선하도록 setProperty('important') 로 박는다.
      */
     private applyCellBgToCells;
-    /** 표 편집 드롭다운에서 받은 액션을 분기 실행. */
+    /**
+     * 표 편집 드롭다운에서 받은 액션을 실행한다. 행 · 열 계산은 병합 셀을 아는
+     * 격자 모델(`table-grid`) 이 맡는다 — DOM 의 셀 순번은 열 번호가 아니다.
+     */
     private runTableMenu;
-    /** 활성 셀의 행 위/아래에 새 행 삽입. 같은 열 수, 빈 td 로 채움. */
-    private insertRow;
-    /** 활성 셀이 속한 열의 좌/우에 새 열 삽입. 모든 행에 빈 td 추가. */
-    private insertColumn;
-    /** 활성 셀의 행 전체 삭제. 마지막 행이면 보존(빈 표 회피). */
-    private deleteRow;
     /**
      * 코드 블록 input 마다 호출되는 debounced rehighlight. 활성 블록이 codeBlock
      * 이고 data-language 가 설정돼 있을 때만 동작 — 타이핑 멈춘 뒤 300ms 후 1 회.
@@ -254,13 +326,17 @@ export declare class AerizEditor {
      * code 안에 있다면 textContent offset 으로 caret 위치 보존.
      */
     private rehighlightCode;
+    /**
+     * 코드 글을 `<code>` 안에 넣을 HTML 로. 색칠기가 없으면 글을 그대로(escape),
+     * 있으면 그 결과를 `<span class>` 만 남기고 거른다 — 바깥 색칠기가 돌려준
+     * HTML 이 본문에 스크립트나 이벤트 속성을 들이지 못하게.
+     */
+    private codeHtml;
     /**
      * 본문에서 모든 codeBlock 을 순회하며 highlight 적용. setHTML / 초기 로드
      * / 외부 import 후 호출.
      */
     private rehighlightAllCodeBlocks;
-    /** 활성 셀의 열 전체 삭제. 마지막 열이면 보존(빈 표 회피). */
-    private deleteColumn;
     /**
      * 마우스 이동 시 셀 우/하 가장자리에서 col-resize / row-resize 커서 표시.
      * 드래그 진행 중에는 별도 핸들러가 cursor 를 관리하므로 skip.
@@ -285,6 +361,28 @@ export declare class AerizEditor {
      * 사이에 캐럿이 항목 안으로 들어가 화면이 한 번 흔들린다.
      */
     private handleTaskToggle;
+    /**
+     * 콜아웃의 아이콘 자리를 누르면 종류를 순환시킨다
+     * (안내 → 도움말 → 주의 → 경고 → 안내).
+     *
+     * 종류마다 메뉴 항목을 따로 두면 삽입 메뉴가 콜아웃 넷으로 뒤덮인다. 반대로
+     * 종류를 바꿀 방법이 아예 없으면 안내 하나만 쓸 수 있는 반쪽 기능이 된다.
+     * 체크리스트의 체크박스 · 토글의 표식과 같은 "왼쪽 여백을 누른다" 규칙을
+     * 재사용해, 새로 배울 것 없이 자리만 알면 되게 했다.
+     */
+    private handleCalloutVariantClick;
+    /**
+     * 토글의 요약 줄을 클릭했을 때 접기/펴기를 할지 정한다.
+     *
+     * `<details>` 는 요약 줄 **어디를 눌러도** 열리고 닫힌다. 편집 중에는 그게
+     * 방해가 된다 — 제목의 오타를 고치려고 캐럿을 옮길 때마다 블록이 접혀서
+     * 방금 쓰던 본문이 사라진다.
+     *
+     * 그래서 삼각형 표식 자리를 누른 것만 접기/펴기로 보고, 글자 자리를 누른
+     * 것은 캐럿 이동으로만 둔다. 체크리스트 체크박스와 같은 판정 방식이라
+     * 사용자가 규칙을 새로 배울 필요가 없다.
+     */
+    private handleToggleSummaryClick;
     /**
      * 이미지 캡션(`<figcaption>`) 에 캐럿을 둔다. 없으면 만든다.
      *
@@ -321,11 +419,8 @@ export declare class AerizEditor {
      * 비어 있으면(캐럿만) 다음 입력 글꼴이 결정된다(브라우저 기본 동작).
      */
     private applyFontFamily;
-    /**
-     * 현재 selection 의 anchor 노드 기준 computed font-family 를 읽어 알려진
-     * FONT_FAMILIES id 와 매칭. 글꼴 드롭다운의 active 표시에 사용.
-     */
-    private detectActiveFontId;
+    /** 캐럿 위치 요소의 계산된 스타일. 드롭다운의 "지금 값" 표시에 쓴다. */
+    private computedStyleAtCaret;
     /**
      * 선택 영역에 글자 크기를 적용한다. execCommand('fontSize') 는 1~7 만 받기
      * 때문에 px 적용을 위해 Range API 로 직접 `<span style="font-size: Xpx">`
@@ -337,11 +432,11 @@ export declare class AerizEditor {
      */
     private applyFontSize;
     /**
-     * 현재 selection 의 anchor 노드 기준 computed font-size 를 px 정수로 읽어
-     * FONT_SIZES 의 값과 일치할 때만 반환. 글자 크기 드롭다운의 active 표시에
-     * 사용.
+     * 선택한 글자를 `<span style>` 로 감싼다. `execCommand` 는 글자 크기를 1~7
+     * 단계로만 받고 자간은 아예 없어 직접 감싼다. 캐럿만 있으면 빈 span 을 두어
+     * 다음에 칠 글자가 그 서식을 받게 한다.
      */
-    private detectActiveFontSize;
+    private wrapSelectionStyle;
     /**
      * 블록 유형 드롭다운을 열어 사용자 선택 결과를 처리한다.
      * 툴바의 blockType 버튼 / 활성 블록 라벨 pill 양쪽 진입점이 동일한 분기
@@ -384,19 +479,25 @@ export declare class AerizEditor {
      */
     private openFileAttachmentDialogAndApply;
     /**
-     * 파일 업로드 핸들러를 결정. onFileUpload 가 우선, 없으면 fileUploadUrl 에
-     * multipart/form-data POST 후 응답 JSON 의 `url` 필드를 사용. 둘 다 없으면
-     * undefined → 다이얼로그 업로드 탭 비활성.
-     */
-    private resolveFileUploadFn;
-    /**
-     * 이미지 업로드 핸들러를 결정. options.onImageUpload 가 우선이며, 없으면
-     * options.imageUploadUrl 로 multipart/form-data POST 후 응답 JSON 의
-     * `url` 필드를 사용. 둘 다 없으면 undefined → 다이얼로그 업로드 탭 비활성.
+     * 올리기 함수. `upload.handler` 가 있으면 그것, `upload.url` 이 있으면 그 주소로
+     * POST. 둘 다 없으면 undefined — 다이얼로그의 "올리기" 탭이 꺼진다.
+     * 크기 제한 · 오류 보고는 여기서 한 번에 처리한다.
      */
-    private resolveImageUploadFn;
+    private uploader;
+    private reportError;
     private queueSync;
     private sync;
+    /**
+     * 캐럿 위치의 인라인 마크 상태.
+     *
+     * `queryCommandState` 는 부를 때마다 스타일 · 레이아웃을 강제로 다시 계산한다
+     * (마크 7개 × 키 하나). 같은 텍스트 노드 안에서 타이핑하는 동안에는 결과가
+     * 바뀌지 않으므로, 캐럿이 놓인 노드와 그 부모가 같으면 지난 결과를 쓴다.
+     * 서식 명령을 실행하면 {@link invalidateInlineState} 로 다시 읽게 한다.
+     */
+    private readInlineState;
+    private inlineCache;
+    private invalidateInlineState;
     private handleKeyDown;
     /**
      * 마크다운 입력 규칙.
@@ -499,7 +600,20 @@ export declare class AerizEditor {
      * 인용구 / 코드 블록의 Enter 탈출, 제목 끝 Enter 에 사용.
      */
     private exitBlockOnEnter;
+    /**
+     * 핸들은 **보이는 블록에만** 만든다 — 캐럿이 있는 블록과 포인터가 올라간
+     * 블록, 많아야 두 개다.
+     *
+     * 1.0 은 블록마다 핸들 DOM 을 만들고 위치를 잡았다. 화면에는 하나만 보이는데
+     * 190쪽 문서에서는 3,000개를 만들고 블록마다 레이아웃을 다시 읽어서 열기에만
+     * 8초 가까이 걸렸다(초기화 시간의 86%).
+     */
     private syncBlockHandles;
+    /**
+     * 핸들 · 라벨 위치는 다음 프레임 직전에 한 번만 계산한다. 같은 프레임 안의
+     * 키 입력 · selectionchange · keyup 이 레이아웃을 여러 번 강제로 읽지 않게.
+     */
+    private scheduleOverlays;
     /**
      * 컨트롤(드래그 핸들 · 단락 추가) 은 **지금 다루고 있는 블록** 에만 보인다.
      * 포인터가 놓인 블록과 캐럿이 있는 블록 두 가지가 그 대상이다.
@@ -517,7 +631,14 @@ export declare class AerizEditor {
      * 가까운 블록으로 붙인다 — 문단 사이 간격에서 컨트롤이 깜빡이지 않게.
      */
     private blockIdAtViewportY;
+    /** `clientY` 가 걸치거나 그 아래에 있는 첫 블록의 순번 (이진 탐색). */
+    private blockIndexAtY;
     private repositionHandles;
+    /**
+     * id 로 블록 element 를 찾는다. 활성 · hover 블록은 대개 방금 본 것이라
+     * 그쪽부터 확인하고, 없을 때만 문서를 찾는다.
+     */
+    private elementOfId;
     private positionHandle;
     private createBlockHandle;
     /**
@@ -525,6 +646,22 @@ export declare class AerizEditor {
      * MutationObserver flush 가 새 단락에 신규 data-block-id 를 발급한다.
      */
     private insertParagraphAfter;
+    private plainPasteNext;
+    /**
+     * 붙여넣기. 브라우저 기본 동작에 맡기지 않는다 — 기본 동작은 워드 · 한글 ·
+     * 엑셀의 클래스 서식을 잃고 `mso-*` 쓰레기를 남기며, 웹 페이지의 위험한
+     * 속성도 일단 문서에 들어온다. 여기서 다듬고(`cleanPastedHtml`) 거른 뒤
+     * (`parseSafeFragment`) 직접 넣는다.
+     */
+    private handlePaste;
+    /** 클립보드 · 끌어 놓기 데이터를 지금 캐럿 자리에 넣는다. */
+    private insertTransfer;
+    private insertFragmentAtCaret;
+    /**
+     * 그림 파일을 지금 블록 뒤에 그림 블록으로 넣는다. 업로드 처리기가 있으면
+     * 올린 뒤의 주소를, 없으면 data URL 을 쓴다 (문서에 그림이 그대로 담긴다).
+     */
+    private insertImageFiles;
     private handleDragOver;
     private handleDrop;
     private handleDragLeave;
@@ -550,7 +687,14 @@ export declare class AerizEditor {
      * - 좌측: 활성 블록 라벨 + id (없으면 — )
      * - 우측: 총 블록 수, 본문 글자 수(공백 제외)
      */
-    private syncStatusBar;
+    /**
+     * 상태바는 타이핑이 잠깐 멈춘 뒤에 갱신한다. 글자 수를 세려면 문서 전체
+     * 텍스트를 읽어야 해서, 키마다 하면 긴 문서에서 그 비용이 그대로 쌓인다.
+     * 활성 블록 라벨은 바로 바꾼다(싸고, 늦으면 어색하다).
+     */
+    private scheduleStatusBar;
+    private syncStatusBlock;
+    private syncStatusCounts;
     /**
      * 되돌리기 / 다시 실행 버튼의 활성 상태.
      *
@@ -558,7 +702,19 @@ export declare class AerizEditor {
      * 일어나는 경험을 준다. 이력 끝에 닿았다는 사실 자체가 정보다.
      */
     private syncHistoryButtons;
+    /**
+     * 바뀐 블록에만 표식(kind · label) 을 다시 달고, 활성 표시는 이전 활성
+     * 블록과 새 활성 블록 둘만 고친다. 1.0 은 키마다 모든 블록에 속성을 다시
+     * 썼다.
+     */
     private syncBlockMarkers;
+    /**
+     * 옵저버에 쌓인 레코드를 지금 장부로 옮긴다. 에디터가 스스로 쓴 표식만
+     * 바뀐 레코드는 장부가 버린다. 진짜 변경이 섞여 있었다면 확정은 다음
+     * 마이크로태스크의 flush 가 한다 — 가져간 레코드는 옵저버 콜백으로 다시
+     * 오지 않기 때문이다.
+     */
+    private absorb;
     private applyToolbarState;
 }
 //# sourceMappingURL=AerizEditor.d.ts.map