@aeriz/wysiwyg 1.0.2 → 1.0.4

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

@@ -1,7 +1,7 @@
-import type { EditorOptions } from '../types';
-import { Toolbar } from '../ui/Toolbar';
-import type { Block, BlockAttrs, BlockKind, BlockSnapshot } from './blocks';
-export type { Block, BlockAttrs, BlockKind, BlockMatch, BlockSnapshot, BlockType, ClassifyResult, HeadingLevel, } from './blocks';
+import type { EditorOptions, SerializeHtmlOptions } from '../types/index.js';
+import { Toolbar } from '../ui/Toolbar.js';
+import type { Block, BlockAttrs, BlockKind, BlockSnapshot } from './blocks.js';
+export type { Block, BlockAttrs, BlockKind, BlockMatch, BlockSnapshot, BlockType, ClassifyResult, HeadingLevel, } from './blocks.js';
 export interface InlineState {
     bold: boolean;
     italic: boolean;
@@ -23,7 +23,11 @@ export declare class AerizEditor {
     private readonly dropIndicator;
     private readonly handles;
     private readonly blockLabelPill;
+    private readonly pillGlyphEl;
+    private readonly pillTextEl;
     private readonly statusBar;
+    private readonly undoBtn;
+    private readonly redoBtn;
     private readonly statusBlockEl;
     private readonly statusBlocksEl;
     private readonly statusCharsEl;
@@ -35,22 +39,56 @@ export declare class AerizEditor {
     private readonly listeners;
     private readonly handleSelectionChange;
     private readonly handleResize;
+    /** document 에 붙는다 — destroy() 에서 반드시 떼야 인스턴스가 GC 된다. */
+    private readonly handleDocumentMouseUp;
     private state;
     private destroyed;
     private syncQueued;
     private lastSerialized;
+    /** 포인터가 올라가 있는 블록. 그 블록의 컨트롤만 드러낸다. */
+    private hoveredBlockId;
+    /** hover 판정을 프레임당 1 회로 묶기 위한 rAF 핸들. */
+    private hoverRaf;
+    /** 라벨 pill 의 등장 애니메이션을 블록이 **바뀔 때만** 다시 재생하기 위한 표식. */
+    private pillBlockId;
+    /**
+     * 편집 이력. 브라우저 기본 undo 는 우리가 직접 한 DOM 조작(블록 이동 · 표
+     * 편집 · 유형 변경) 을 모르기 때문에 자체 스택을 둔다.
+     */
+    private history;
+    /**
+     * 이력 되돌리기가 만든 DOM 변경인지. 이 동안의 변경은 다시 기록하지 않는다
+     * (되돌리기가 스스로를 이력에 쌓으면 되돌리기를 되돌릴 수 없다).
+     */
+    private applyingHistory;
+    /**
+     * 다음 기록의 성격. 구조를 바꾸는 조작은 타이핑과 합쳐지지 않도록
+     * 조작 직전에 이 값을 올려 둔다.
+     */
+    private pendingChangeKind;
     /** 사용자가 색 다이얼로그에서 직접 고른 색상의 LRU. 에디터 인스턴스 메모리에만 유지. */
     private recentCustomColors;
     constructor(options: EditorOptions);
     /**
-     * 본문 HTML 을 반환한다. 외부 컨텍스트에서도 에디터에서 보이는 그대로
-     * 동일한 시각으로 렌더되도록, 호출 시점의 테마 변수(--aw-primary 등) 를
-     * 읽어 블록 단위 인라인 스타일에 베이크한다. 에디터 내부 DOM 자체는
-     * 변형되지 않으며(clone 트리에 적용), data-block-kind / data-block-label /
-     * data-block-focused 같은 에디터 전용 속성은 출력에서 제거된다.
+     * 본문 HTML 을 반환한다.
+     *
+     * 두 가지 스타일 전략을 지원한다 (`options.styles`, 기본값은 생성 시
+     * `EditorOptions.htmlStyles`, 그것도 없으면 `'inline'`).
+     *
+     * - `'inline'` — 호출 시점의 테마 변수(--aw-primary 등) 를 읽어 블록 단위
+     *   인라인 스타일에 베이크한다. 스타일시트 없이 어디에 붙여도(이메일 본문,
+     *   다른 페이지) 에디터에서 보이는 그대로 렌더된다.
+     * - `'class'` — 테마 스타일을 베이크하지 않고 `aw-block-*` / `aw-align-*`
+     *   클래스만 남긴다. `style` 속성을 지우는 서버 sanitizer 아래에서 서식을
+     *   보존해야 할 때 쓴다. 출력은 `aeriz-wysiwyg.min.css` 를 로드한 페이지의
+     *   `.aeriz-wysiwyg > .aw-content` 안에 넣는 것을 전제로 한다.
+     *
+     * 어느 쪽이든 에디터 내부 DOM 은 변형되지 않으며(clone 트리에 적용),
+     * data-block-kind / data-block-focused 같은 에디터 전용 속성과 리사이즈
+     * 핸들 · 정렬 컨트롤 같은 편집 보조 마크업은 출력에서 제거된다.
      * data-block-id 는 보존.
      */
-    getHTML(): string;
+    getHTML(options?: SerializeHtmlOptions): string;
     /** 가공 없는 원본 innerHTML. 직렬화 검증/디버그 용도. */
     getRawHTML(): string;
     setHTML(html: string): void;
@@ -85,7 +123,48 @@ export declare class AerizEditor {
      * takeRecords 로 흡수한 뒤 onChange + queueSync.
      */
     private flush;
+    /**
+     * 지금 본문을 이력에 기록한다.
+     *
+     * 되돌리기가 만든 변경은 기록하지 않는다 — 자기 자신을 이력에 쌓으면
+     * 되돌리기를 되돌릴 수 없다.
+     */
+    private recordHistory;
+    /**
+     * 유형이 막 바뀐 블록을 한 번 반짝인다.
+     *
+     * 유형 변경은 결과가 화면 아래쪽(들여쓰기 · 글꼴 · 배경) 에서 조용히 일어나
+     * "눌리긴 한 건가" 싶을 때가 있다. 짧은 하이라이트 하나로 어느 블록이
+     * 바뀌었는지가 분명해진다.
+     *
+     * 표식은 `data-block-flash` 속성이다 — class 로 걸면 사용자 컨텐츠의 class 에
+     * 섞여 `getHTML()` 로 새어 나갈 수 있다. data-block-* 는 출력 단계에서
+     * 통째로 제거되는 에디터 전용 네임스페이스다.
+     *
+     * 속성을 넣고 뺄 때마다 옵저버 레코드를 흡수한다. 이걸 빠뜨리면 이 표식
+     * 하나가 "문서가 바뀌었다" 로 잡혀 이력에 항목이 하나 더 쌓이고, 되돌리기가
+     * 눈에 보이는 변화 없이 한 번 헛돈다 (실제로 그랬다).
+     */
+    private flashBlock;
+    /**
+     * 이어지는 한 번의 변경을 **구조 변경**으로 표시한다.
+     *
+     * 블록 이동 · 유형 변경 · 표 편집처럼 사용자가 "한 번에 하나씩" 되돌리길
+     * 기대하는 조작 직전에 부른다. 이 표시가 없으면 직전 타이핑과 한 항목으로
+     * 합쳐져 Ctrl+Z 한 번에 둘 다 사라진다.
+     */
+    private markStructuralChange;
+    /** 되돌리기. 되돌릴 것이 없으면 아무 일도 하지 않는다. */
+    undo(): void;
+    /** 다시 실행. */
+    redo(): void;
+    private applyHistoryEntry;
     private handleToolbarAction;
+    /**
+     * 선택 영역의 인라인 서식을 지운다. 블록 유형은 건드리지 않는다 —
+     * "서식 지우기" 로 제목이 본문이 되면 되돌릴 방법을 찾기 어렵다.
+     */
+    private clearInlineFormat;
     /**
      * 인라인 마크(bold/italic/underline/strike) 토글. 활성 블록의 allowedMarks
      * 에 포함되지 않은 마크면 무시. styleWithCSS=true 모드로 deprecated 태그
@@ -190,6 +269,25 @@ export declare class AerizEditor {
      */
     private handleTableResizeStart;
     private handleTableResizeMove;
+    /**
+     * 체크리스트 항목의 체크 표시 토글.
+     *
+     * 체크박스는 실제 element 가 아니라 `<li>` 의 `::before` 다 — 폼 요소를
+     * contentEditable 안에 두면 캐럿이 그 안으로 들어가고 서버 sanitizer 가
+     * 지워 버린다. 그래서 클릭 좌표가 그 표시 영역 안인지 직접 따진다.
+     *
+     * `click` 이 아니라 `mousedown` 에서 처리한다 — click 까지 기다리면 그
+     * 사이에 캐럿이 항목 안으로 들어가 화면이 한 번 흔들린다.
+     */
+    private handleTaskToggle;
+    /**
+     * 이미지 캡션(`<figcaption>`) 에 캐럿을 둔다. 없으면 만든다.
+     *
+     * 버튼은 토글이 아니다 — 다시 눌러 캡션을 지우면 사용자가 쓴 글이 말없이
+     * 사라진다. 캡션을 없애는 방법은 글자를 지우는 것이고, 빈 캡션은 캐럿이
+     * 떠난 뒤 `normalizeContent` 가 알아서 걷어낸다.
+     */
+    private focusImageCaption;
     /**
      * 이미지/유튜브 좌상단 정렬 컨트롤 클릭 핸들러. data-align 에 따라 wrapper
      * 의 marginLeft / marginRight 를 조정 — left/center/right.
@@ -199,8 +297,17 @@ export declare class AerizEditor {
      * 이미지 / 유튜브 wrapper 의 너비를 드래그로 조정. 높이는 자동 (이미지는
      * 종횡비 유지, 유튜브는 CSS aspect-ratio 16/9). mouseup 에서 cursor 복귀
      * + flush.
+     *
+     * 너비는 본문 안쪽 폭을 상한으로 한다. 상한이 없으면 오른쪽으로 계속 끌 때
+     * wrapper 가 본문보다 넓어지고, 그만큼 에디터 전체가 가로로 늘어난다
+     * (드래그를 멈춰도 늘어난 상태가 남는다).
      */
     private startBlockResize;
+    /**
+     * 본문의 padding 을 제외한 실제 컨텐츠 폭. 블록 리사이즈의 상한이다.
+     * 에디터가 아주 좁을 때도 최소 폭은 확보되도록 하한을 둔다.
+     */
+    private contentInnerWidth;
     private currentTheme;
     /**
      * 선택 영역에 글꼴을 적용한다.
@@ -283,20 +390,99 @@ export declare class AerizEditor {
      * `url` 필드를 사용. 둘 다 없으면 undefined → 다이얼로그 업로드 탭 비활성.
      */
     private resolveImageUploadFn;
-    /**
-     * `src` 의 이미지를 figure>img 블록으로 본문에 삽입.
-     * 활성 블록이 있으면 그 블록을 image 로 변환, 없으면 본문 끝에 추가.
-     */
-    private insertImageBlock;
     private queueSync;
     private sync;
     private handleKeyDown;
     /**
-     * 활성 블록 뒤에 새 빈 단락을 만들고 캐럿을 그 안에 둔다.
-     * 인용구 / 코드 블록의 Enter 탈출 동작에 사용.
+     * 마크다운 입력 규칙.
+     *
+     * 본문 블록 맨 앞에 `# ` / `- ` / `1. ` / `> ` / ``` 을 치면 그 자리에서
+     * 블록 유형이 바뀌고 방아쇠 문자는 사라진다. 메뉴를 열지 않고 글을 쓰던
+     * 흐름 그대로 유형을 고르는 길이다.
+     *
+     * 조건을 좁게 잡는다 — **본문 블록**에서, **캐럿이 그 텍스트 바로 뒤**에
+     * 있을 때만. 그렇지 않으면 이미 쓴 문단 중간에서 "- " 를 고치다가 블록이
+     * 통째로 바뀌는 사고가 난다.
+     */
+    private handleInputRule;
+    /**
+     * 글머리 목록 항목에서 `[ ] ` / `[x] ` 를 알아보고 체크리스트로 바꾼다.
+     *
+     * `setBlockType` 을 쓰지 않는다 — 그 경로는 항목들을 `<br>` 로 이어 붙여
+     * 한 덩어리로 만들기 때문에, 항목이 여럿인 목록에서 줄이 뭉개진다. 목록
+     * 구조는 그대로 두고 클래스만 올린다.
+     */
+    private applyTaskItemRule;
+    /**
+     * 블록 단축키. 처리했으면 `true`.
+     *
+     * 유형 변경은 `Ctrl/Cmd + Alt + 숫자` 다 — 구글 문서 · 노션이 같은 자리를
+     * 쓰기 때문에 손이 이미 알고 있는 배열이고, 브라우저 기본 단축키
+     * (Ctrl+숫자 = 탭 전환) 와 겹치지 않는다. 어느 유형의 블록에서든 다른
+     * 유형으로 바로 넘어간다.
+     *
+     *   Ctrl+Alt+0        본문          Ctrl+Alt+1~6   제목 1~6
+     *   Ctrl+Alt+7        번호 목록     Ctrl+Alt+8     글머리 목록
+     *   Ctrl+Alt+9        인용구        Ctrl+Alt+C     코드 블록
+     *   Ctrl+Shift+↑/↓    블록 이동     Ctrl+Shift+D   블록 삭제
+     *
+     * 이동과 삭제는 캐럿이 어디 있든 **블록 단위**로 동작한다. 지금까지는
+     * 드래그 핸들을 잡는 것 말고는 블록을 옮길 방법이 없었다.
+     */
+    private handleBlockShortcut;
+    /**
+     * 활성 블록을 위/아래 형제와 자리바꿈한다. 문서 끝에서는 아무 일도 하지
+     * 않는다 — 경고 없이 조용히 멈추는 편이 캐럿을 잃는 것보다 낫다.
+     */
+    private moveActiveBlock;
+    /**
+     * 활성 블록을 지우고 캐럿을 이웃 블록으로 옮긴다.
+     *
+     * 마지막 블록을 지우면 `normalizeContent` 가 빈 본문 블록을 다시 만든다 —
+     * 본문이 블록 없는 상태로 남지 않는다.
+     */
+    private deleteActiveBlock;
+    /**
+     * Tab 처리. 처리했으면 `true`.
+     *
+     * - 표 안: 다음(Shift 면 이전) 셀로 캐럿 이동. 마지막 셀에서 Tab 은 새 행을
+     *   만든다 — 표를 채워 넣을 때 손이 마우스로 갈 일이 없어진다.
+     * - 목록 안: `indent` / `outdent` 로 한 단계 들여쓰기. 중첩 목록을 만들
+     *   방법이 이것 말고는 없었다(마크다운으로 가져온 중첩 목록은 편집만 가능).
+     */
+    private handleTabKey;
+    /**
+     * Backspace 처리. 처리했으면 `true`.
+     *
+     * 비어 있는 제목 · 인용구 · 코드 블록 · 목록의 맨 앞에서 Backspace 를 누르면
+     * **본문 블록으로 되돌린다.** 유형을 잘못 골랐을 때 되돌리는 가장 자연스러운
+     * 동작이고, 브라우저 기본 동작(앞 블록에 병합) 이 만들어 내는 이상한 중첩
+     * (제목 안에 목록이 들어가는 등) 도 함께 피한다.
+     */
+    private handleBackspaceKey;
+    /**
+     * 활성 블록 뒤에 새 빈 **본문 블록**을 만들고 캐럿을 그 안에 둔다.
+     * 인용구 / 코드 블록의 Enter 탈출, 제목 끝 Enter 에 사용.
      */
     private exitBlockOnEnter;
     private syncBlockHandles;
+    /**
+     * 컨트롤(드래그 핸들 · 단락 추가) 은 **지금 다루고 있는 블록** 에만 보인다.
+     * 포인터가 놓인 블록과 캐럿이 있는 블록 두 가지가 그 대상이다.
+     *
+     * 예전에는 본문에 포인터만 올라가면 모든 블록의 핸들이 한꺼번에 흐리게
+     * 떠올랐다. 글이 길어질수록 왼쪽에 점 세 개짜리 기둥이 생겨서, 정작 어느
+     * 블록을 잡는 손잡이인지가 안 보였다.
+     */
+    private syncHandleVisibility;
+    private readonly handleHoverMove;
+    private readonly handleHoverLeave;
+    private setHoveredBlock;
+    /**
+     * 뷰포트 y 좌표가 걸치는 블록의 id. 좌표가 블록들 사이의 여백이면 가장
+     * 가까운 블록으로 붙인다 — 문단 사이 간격에서 컨트롤이 깜빡이지 않게.
+     */
+    private blockIdAtViewportY;
     private repositionHandles;
     private positionHandle;
     private createBlockHandle;
@@ -331,6 +517,13 @@ export declare class AerizEditor {
      * - 우측: 총 블록 수, 본문 글자 수(공백 제외)
      */
     private syncStatusBar;
+    /**
+     * 되돌리기 / 다시 실행 버튼의 활성 상태.
+     *
+     * 누를 수 없는 버튼이 누를 수 있는 것처럼 보이면, 눌러 보고 아무 일도 안
+     * 일어나는 경험을 준다. 이력 끝에 닿았다는 사실 자체가 정보다.
+     */
+    private syncHistoryButtons;
     private syncBlockMarkers;
     private applyToolbarState;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"AerizEditor.d.ts","sourceRoot":"","sources":["../../src/core/AerizEditor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"AerizEditor.d.ts","sourceRoot":"","sources":["../../src/core/AerizEditor.ts"],"names":[],"mappings":"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"}

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

@@ -1,4 +1,5 @@
-import type { Block, BlockSnapshot } from './blocks';
+import type { HtmlStyleMode, SerializeHtmlOptions } from '../types/index.js';
+import type { Block, BlockSnapshot } from './blocks.js';
 export interface ViewerOptions {
     /** 마운트할 호스트 element */
     element: HTMLElement;
@@ -6,6 +7,8 @@ export interface ViewerOptions {
     initialBlocks?: BlockSnapshot[];
     /** 초기 테마 */
     theme?: 'light' | 'dark';
+    /** `getHTML()` 의 스타일 전략. 기본 `'inline'`. */
+    htmlStyles?: HtmlStyleMode;
 }
 /**
  * 편집 불가 모드의 읽기 전용 뷰어.
@@ -25,6 +28,12 @@ export declare class AerizViewer {
     readonly content: HTMLDivElement;
     private readonly blockIds;
     private readonly idFor;
+    /**
+     * 생성 시 받은 options 객체를 그대로 들고 있는다. `htmlStyles` 를 여기서
+     * 매번 다시 읽으므로, 호출자가 이 객체를 갱신하면 재생성 없이 출력 전략이
+     * 바뀐다 (AerizEditor 와 같은 규약).
+     */
+    private readonly options;
     private destroyed;
     constructor(options: ViewerOptions);
     /**
@@ -38,10 +47,13 @@ export declare class AerizViewer {
     /** 임의의 노드를 받아 그 노드가 속한 블록을 반환한다. 본문 밖이면 null. */
     getBlockOf(node: Node): Block | null;
     /**
-     * 외부 컨텍스트(이메일, 다른 페이지의 HTML 영역 등) 에서도 동일한 시각으로
-     * 보이도록 portable 인라인 스타일을 입힌 자급자족적 HTML 을 반환한다.
+     * 본문 HTML 을 반환한다. 전략은 `AerizEditor.getHTML()` 과 동일하다.
+     *
+     * - `'inline'` (기본) — 외부 컨텍스트(이메일, 다른 페이지의 HTML 영역 등)
+     *   에서도 동일한 시각으로 보이도록 portable 인라인 스타일을 베이크한다.
+     * - `'class'` — 클래스만 남긴다. `style` 속성을 지우는 sanitizer 대응.
      */
-    getHTML(): string;
+    getHTML(options?: SerializeHtmlOptions): string;
     setTheme(theme: 'light' | 'dark'): void;
     destroy(): void;
     private listBlocksInternal;

package/dist-types/core/AerizViewer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AerizViewer.d.ts","sourceRoot":"","sources":["../../src/core/AerizViewer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAarD,MAAM,WAAW,aAAa;IAC5B,uBAAuB;IACvB,OAAO,EAAE,WAAW,CAAC;IACrB,gDAAgD;IAChD,aAAa,CAAC,EAAE,aAAa,EAAE,CAAC;IAChC,YAAY;IACZ,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,WAAW;IACtB,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IAEjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;IAClD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyD;IAC/E,OAAO,CAAC,SAAS,CAAS;gBAEd,OAAO,EAAE,aAAa;IA8BlC;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,IAAI;IAKxC,qCAAqC;IACrC,SAAS,IAAI,aAAa,EAAE;IAI5B,iDAAiD;IACjD,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,KAAK,GAAG,IAAI;IAKpC;;;OAGG;IACH,OAAO,IAAI,MAAM;IAUjB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI;IAIvC,OAAO,IAAI,IAAI;IAMf,OAAO,CAAC,kBAAkB;CAG3B"}
+{"version":3,"file":"AerizViewer.d.ts","sourceRoot":"","sources":["../../src/core/AerizViewer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AACpE,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAerD,MAAM,WAAW,aAAa;IAC5B,uBAAuB;IACvB,OAAO,EAAE,WAAW,CAAC;IACrB,gDAAgD;IAChD,aAAa,CAAC,EAAE,aAAa,EAAE,CAAC;IAChC,YAAY;IACZ,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACzB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,aAAa,CAAC;CAC5B;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,WAAW;IACtB,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IAEjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;IAClD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyD;IAC/E;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,SAAS,CAAS;gBAEd,OAAO,EAAE,aAAa;IA+BlC;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,IAAI;IAKxC,qCAAqC;IACrC,SAAS,IAAI,aAAa,EAAE;IAI5B,iDAAiD;IACjD,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,KAAK,GAAG,IAAI;IAKpC;;;;;;OAMG;IACH,OAAO,CAAC,OAAO,GAAE,oBAAyB,GAAG,MAAM;IAgBnD,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI;IAIvC,OAAO,IAAI,IAAI;IAMf,OAAO,CAAC,kBAAkB;CAG3B"}

package/dist-types/core/block-meta.d.ts

@@ -0,0 +1,98 @@
+/**
+ * 블록 렌더링에 쓰이는 순수 헬퍼와 상수.
+ *
+ * DOM 을 참조하지 않는다. 브라우저 렌더 경로(`blocks.ts`) 와 DOM 없는 문자열
+ * 렌더 경로(`render-string.ts`) 가 **같은** 값을 쓰도록 여기 한 곳에 둔다.
+ * 두 경로가 갈라지면 서버 재렌더 결과와 에디터 출력이 미묘하게 달라지므로,
+ * 양쪽이 공유해야 하는 것은 반드시 이 모듈로 올린다.
+ */
+/** 바이트 수를 사람이 읽는 크기 문자열로. */
+export declare function formatBytes(bytes: number): string;
+/** 표시용 짧은 타입 라벨. 파일명 확장자 우선, 없으면 MIME subtype. */
+export declare function fileExtensionLabel(name?: string, mime?: string): string;
+/** URL 의 hostname (subdomain 포함) 만 추출. 실패 시 빈 문자열. */
+export declare function hostnameFromUrl(url: string): string;
+/**
+ * Google 의 무료 favicon 서비스 URL 을 반환. CORS / 인증 불필요. URL 파싱
+ * 실패 시 빈 문자열.
+ */
+export declare function defaultFaviconUrl(url: string): string;
+/** 파일 첨부 카드 좌측 문서 아이콘. */
+export declare const FILE_ICON_SVG: string;
+/** 파일 첨부 카드 우측 다운로드 아이콘. */
+export declare const FILE_ACTION_SVG: string;
+/** 유튜브 iframe 의 `allow` 목록. */
+export declare const YOUTUBE_IFRAME_ALLOW = "accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture";
+/** 유튜브 임베드 base URL. 쿠키를 덜 쓰는 nocookie 도메인을 사용한다. */
+export declare const YOUTUBE_EMBED_BASE = "https://www.youtube-nocookie.com/embed/";
+/** 파일명이 없는 첨부의 기본 표시 이름. */
+export declare const FILE_FALLBACK_NAME = "\uD30C\uC77C";
+/** 블록의 안정 식별자를 담는 속성명. */
+export declare const BLOCK_ID_ATTR = "data-block-id";
+/**
+ * 눈에 보이지 않는 폭 없는 문자들 — ZWSP · ZWNJ · ZWJ · BOM.
+ *
+ * 에디터가 캐럿을 붙잡아 두려고 심는 U+200B 가 대표적이다. 글자 수를 세거나
+ * "이 블록이 비었나" 를 판단할 때 이것들을 글자로 치면 사용자가 보는 것과
+ * 다른 답이 나온다. 세 군데(글자 수 · 캐럿 판정 · 평문 추출)에서 같은 판정을
+ * 써야 해서 여기 한 번만 적는다.
+ */
+export declare const ZERO_WIDTH_RE: RegExp;
+/**
+ * 스냅샷이 블록 element **자신**에서 함께 실어 나르는 속성.
+ *
+ * `html` 은 블록의 **안쪽**만 담고 `style` 은 따로 필드가 있다. 그래서 블록에
+ * 직접 걸린 나머지 속성은 아무 데도 실리지 않아 저장 한 번에 사라졌다.
+ * 잃으면 실제로 곤란한 것만 골라 담는다.
+ *
+ * - `id`   : 문서 안 앵커 링크(`#section-1`) 가 끊긴다
+ * - `class`: 가져온 문서의 스타일 훅이 사라진다
+ * - `dir`  : 아랍어 · 히브리어 문단의 쓰기 방향이 뒤집힌다
+ * - `lang` : 스크린 리더 발음과 하이픈 규칙이 바뀐다
+ * - `title`: 마우스를 올렸을 때 뜨는 설명
+ *
+ * **허용목록인 것이 핵심이다.** 전부 실어 나르면 `onclick` 같은 이벤트 핸들러
+ * 속성이 저장을 거쳐 되살아난다 — 저장된 글은 다른 사람에게 렌더된다.
+ */
+export declare const PRESERVED_BLOCK_ATTRS: ReadonlyArray<string>;
+/**
+ * `unknown` 블록으로 되살릴 수 있는 태그.
+ *
+ * 저장된 값에서 온 태그명을 그대로 `createElement` 에 넘기면 안 된다 —
+ * `script` 를 만들어 내용을 넣고 문서에 붙이면 **실행된다** (innerHTML 경로와
+ * 달리 createElement 경로는 막히지 않는다). 내용을 담기만 하는 컨테이너
+ * 태그만 허용하고, 나머지는 `<div>` 로 떨어뜨린다.
+ */
+export declare const SAFE_UNKNOWN_TAGS: ReadonlySet<string>;
+/** 저장된 태그명을 되살릴 수 있는 것으로 정규화한다. 알 수 없으면 `'div'`. */
+export declare function safeUnknownTag(raw: string | undefined | null): string;
+/**
+ * 클래스 이름들을 순서를 지키며 하나로 합친다 (중복 제거).
+ *
+ * 어떤 블록은 클래스가 곧 정체성이다 — `aw-task-list` 가 없으면 체크리스트가
+ * 글머리 목록으로 잡힌다. 그런데 스냅샷에 저장된 사용자 클래스도 함께 살려야
+ * 한다. 둘 중 하나를 고르면 반드시 무언가를 잃으므로 합친다.
+ */
+export declare function mergeClassNames(...values: ReadonlyArray<string | undefined | null>): string;
+/** 체크리스트 `<ul>` 을 글머리 목록과 구분하는 클래스. */
+export declare const TASK_LIST_CLASS = "aw-task-list";
+/** 체크리스트 항목의 완료 여부를 담는 속성명. */
+export declare const TASK_CHECKED_ATTR = "data-checked";
+/**
+ * 링크 / 다운로드 URL 을 검사한다. 안전하면 원문 그대로, 아니면 빈 문자열.
+ *
+ * 스킴이 없는 값(상대 경로 · `#앵커` · `?쿼리`) 은 그대로 통과한다 — 문서
+ * 안에서 쓰는 정상적인 링크다.
+ */
+export declare function safeLinkUrl(raw: string | undefined | null): string;
+/**
+ * 이미지 src 를 검사한다. 안전하면 원문 그대로, 아니면 빈 문자열.
+ * `data:image/...` 는 허용한다 — 이미지 다이얼로그의 임베드 탭이 만드는 값이다.
+ */
+export declare function safeImageUrl(raw: string | undefined | null): string;
+/**
+ * YouTube 영상 ID 의 형태 검사. 임베드 URL 에 그대로 이어 붙이는 값이라
+ * `../` 나 따옴표가 섞이면 URL 자체가 다른 곳을 가리키게 된다.
+ */
+export declare function safeYouTubeId(raw: string | undefined | null): string;
+//# sourceMappingURL=block-meta.d.ts.map

package/dist-types/core/block-meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-meta.d.ts","sourceRoot":"","sources":["../../src/core/block-meta.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,6BAA6B;AAC7B,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKjD;AAED,kDAAkD;AAClD,wBAAgB,kBAAkB,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAYvE;AAED,sDAAsD;AACtD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMnD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIrD;AAED,0BAA0B;AAC1B,eAAO,MAAM,aAAa,QAGK,CAAC;AAEhC,4BAA4B;AAC5B,eAAO,MAAM,eAAe,QAGyD,CAAC;AAEtF,+BAA+B;AAC/B,eAAO,MAAM,oBAAoB,6FAC2D,CAAC;AAE7F,qDAAqD;AACrD,eAAO,MAAM,kBAAkB,4CAA4C,CAAC;AAE5E,4BAA4B;AAC5B,eAAO,MAAM,kBAAkB,iBAAO,CAAC;AAEvC,0BAA0B;AAC1B,eAAO,MAAM,aAAa,kBAAkB,CAAC;AAE7C;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,QAAY,CAAC;AAEvC;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,qBAAqB,EAAE,aAAa,CAAC,MAAM,CAMvD,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAIhD,CAAC;AAEH,oDAAoD;AACpD,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAIrE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,GAAG,MAAM,EAAE,aAAa,CAAC,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC,GAClD,MAAM,CASR;AAED,uCAAuC;AACvC,eAAO,MAAM,eAAe,iBAAiB,CAAC;AAE9C,+BAA+B;AAC/B,eAAO,MAAM,iBAAiB,iBAAiB,CAAC;AA2DhD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAOlE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CASnE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAGpE"}

package/dist-types/core/block-policy.d.ts

@@ -0,0 +1,43 @@
+/**
+ * 블록이 무엇을 허용하는지, 그리고 화면에 어떻게 소개되는지.
+ *
+ * 툴바의 항목 표시 여부, 단축키가 먹히는지, 유형을 바꿀 때 어떤 서식을
+ * 남길지가 모두 같은 판정에서 나와야 한다. 한 곳에서만 답하게 두면
+ * "툴바에서는 안 보이는데 단축키로는 먹는" 종류의 어긋남이 생기지 않는다.
+ *
+ * 판정의 근거는 대부분 `BlockType` 에 이미 선언돼 있다 (`allowedMarks` ·
+ * `allowsColor` · `allowsFontSize` · `allowsInlineFormat`). 여기 있는 함수는
+ * 그 선언을 "활성 블록" 이라는 물음으로 바꿔 주는 얇은 층이다.
+ */
+import type { Block, BlockMatch, InlineMarkName } from './blocks.js';
+/**
+ * 활성 블록이 특정 인라인 마크를 허용하는지.
+ *
+ *   paragraph / 목록 / 체크리스트 / table — 모든 마크
+ *   heading    — italic 만 (제목은 이미 굵고, 밑줄·취소선은 시맨틱에 안 맞는다)
+ *   blockquote — bold / underline / strike (인용구는 이미 italic 으로 렌더된다)
+ *   codeBlock 및 원자 블록 — 없음
+ */
+export declare function isMarkAllowed(active: Block | null, mark: InlineMarkName): boolean;
+/** 인라인 서식(글꼴 등) 적용을 허용하는지. */
+export declare function isInlineFormatAllowed(active: Block | null): boolean;
+/** 글자 크기 조정을 허용하는지. heading 은 level 이 크기를 정하므로 false. */
+export declare function isFontSizeAllowed(active: Block | null): boolean;
+/** 글자색 / 배경색 적용을 허용하는지. heading · blockquote 는 톤 보존을 위해 false. */
+export declare function isColorAllowed(active: Block | null): boolean;
+export declare function isAlignAllowed(active: Block | null): boolean;
+/** 표 전용 도구(셀 배경 · 표 편집) 를 켤 조건. */
+export declare function isTableActive(active: Block | null): boolean;
+/**
+ * 블록 라벨.
+ *
+ * 블록은 언제나 자기 kind 의 정식 라벨을 단다. 비어 있다고 해서 유형이 없는
+ * 것이 아니다 — Enter 로 갓 생긴 빈 블록은 **본문 블록**이고 그렇게 보여야
+ * 한다. 예전에는 이런 블록에 '?' 를 달았는데, 사용자에게 "아직 유형이 정해지지
+ * 않은 블록" 이라는 없는 상태를 만들어 보여 준 셈이었다.
+ *
+ * 어떤 BlockType 에도 매칭되지 않은 element(`unknown`) 만 태그명을 쓴다.
+ */
+export declare function blockLabelFor(el: HTMLElement, match: BlockMatch): string;
+export declare function blockGlyphFor(match: BlockMatch): string;
+//# sourceMappingURL=block-policy.d.ts.map

package/dist-types/core/block-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-policy.d.ts","sourceRoot":"","sources":["../../src/core/block-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,KAAK,EAAa,UAAU,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAS7E;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,KAAK,GAAG,IAAI,EACpB,IAAI,EAAE,cAAc,GACnB,OAAO,CAET;AAED,8BAA8B;AAC9B,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,KAAK,GAAG,IAAI,GAAG,OAAO,CAEnE;AAED,yDAAyD;AACzD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,KAAK,GAAG,IAAI,GAAG,OAAO,CAE/D;AAED,kEAAkE;AAClE,wBAAgB,cAAc,CAAC,MAAM,EAAE,KAAK,GAAG,IAAI,GAAG,OAAO,CAE5D;AAeD,wBAAgB,cAAc,CAAC,MAAM,EAAE,KAAK,GAAG,IAAI,GAAG,OAAO,CAE5D;AAED,mCAAmC;AACnC,wBAAgB,aAAa,CAAC,MAAM,EAAE,KAAK,GAAG,IAAI,GAAG,OAAO,CAE3D;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,CAGxE;AA2BD,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAGvD"}