@aeriz/wysiwyg 1.0.2 → 1.0.4

package/dist-types/cjs/core/render-string.d.cts

@@ -0,0 +1,68 @@
+/**
+ * DOM 없이 `BlockSnapshot[]` → HTML 문자열.
+ *
+ * `document` / `window` 를 **모듈 최상위에서도, 함수 안에서도** 참조하지 않는다.
+ * Cloudflare Workers(workerd) · Node · Deno · Bun 어디서든 그대로 동작한다.
+ *
+ * ## 보장
+ *
+ * - **결정적** — 같은 입력이면 항상 같은 문자열. 난수 · 현재 시각 · 순회 순서에
+ *   의존하는 값을 쓰지 않는다. 따라서 재렌더 결과의 diff 가 의미를 갖는다.
+ * - **멱등** — 같은 스냅샷을 몇 번 렌더해도 결과가 누적되거나 변하지 않는다.
+ * - **에디터 전용 마크업 없음** — 리사이즈 핸들 · 정렬 컨트롤 · `contenteditable`
+ *   같은 편집 보조 마크업은 출력에 포함되지 않는다.
+ *
+ * ## 브라우저 렌더 경로와의 관계
+ *
+ * DOM 경로(`renderBlock`) 와 **같은 결과**를 내는 것이 목표다. 모든 블록은
+ * `snapshot.html` 을 그대로 싣고, `html` 이 비어 있을 때만 `attrs` 로 골격을
+ * 조립한다 (`AerizViewer` 도 같은 규칙).
+ *
+ * 원자 블록(이미지 · 유튜브 · 링크 카드 · 파일) 도 예외가 아니다. 예전에는
+ * `attrs` 로만 다시 조립했는데, 그러면 `<figcaption>` 처럼 `attrs` 에 없는
+ * 사용자 컨텐츠가 **서버 렌더에서만** 사라져 같은 스냅샷이 브라우저와 서버에서
+ * 다르게 보였다.
+ *
+ * 편집 보조 마크업(정렬 컨트롤 · 리사이즈 핸들) 은 1.0.3 부터 `serialize()` 가
+ * 애초에 싣지 않지만, 그 이전 데이터를 위해 읽는 쪽에서도 걷어낸다.
+ */
+import type { BlockSnapshot } from './blocks.cjs';
+export interface RenderHtmlOptions {
+    /**
+     * 각 블록에 `data-block-id` 를 남길지. 기본 `true`.
+     *
+     * 저장된 스냅샷과 렌더된 HTML 을 대조해야 하는 경우(앵커 링크, 코멘트 위치
+     * 고정 등) 켜 두고, 순수 발행용 HTML 이면 끈다.
+     */
+    blockIds?: boolean;
+    /**
+     * 감싸는 컨테이너.
+     * - `'none'` (기본) — 블록들만 이어붙인 조각
+     * - `'content'` — `<div class="aeriz-wysiwyg"><div class="aw-content">…`
+     *   로 감싼다. 배포된 `aeriz-wysiwyg.min.css` 를 함께 로드하면 에디터와 같은
+     *   시각으로 렌더된다 (클래스 기반 스타일링 경로).
+     */
+    wrapper?: 'none' | 'content';
+    /** `wrapper: 'content'` 일 때 컨테이너에 부여할 테마. */
+    theme?: 'light' | 'dark';
+}
+/**
+ * 스냅샷 배열을 HTML 문자열로 렌더한다.
+ *
+ * @example
+ *   // Cloudflare Worker
+ *   import { renderBlocksToHTML } from '@aeriz/wysiwyg/server';
+ *
+ *   const html = renderBlocksToHTML(post.blocks, { wrapper: 'content' });
+ */
+export declare function renderBlocksToHTML(snapshots: readonly BlockSnapshot[], options?: RenderHtmlOptions): string;
+/**
+ * 단일 스냅샷을 HTML 문자열로 렌더한다.
+ *
+ * 스트리밍 · 블록 단위 캐시처럼 블록을 하나씩 렌더하는 호출자를 위해 공개돼
+ * 있다. `renderBlocksToHTML` 과 **같은 정규화**를 거쳐야 하므로 여기서도
+ * `upgradeSnapshot` 을 적용한다 — 빠뜨리면 모르는 kind 가 exhaustive 분기로
+ * 떨어져 빈 문자열이 되고, 블록이 조용히 사라진다.
+ */
+export declare function renderBlockToHTML(snapshot: BlockSnapshot, options?: Pick<RenderHtmlOptions, 'blockIds'>): string;
+// (소스맵은 CJS 선언 사본에서 제외됨 — scripts/finalize-types.mjs)

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

@@ -0,0 +1,46 @@
+/** 문자 오프셋으로 표현한 선택 영역. */
+export interface SelectionOffsets {
+    start: number;
+    end: number;
+}
+/**
+ * `<code>` element 안의 셀렉션을 텍스트 오프셋으로 저장한다.
+ * 하이라이트가 innerHTML 을 다시 쓰기 직전에 부른다.
+ */
+export declare function saveCodeSelection(codeEl: HTMLElement): SelectionOffsets | null;
+/** {@link saveCodeSelection} 로 저장한 위치에 캐럿을 되돌린다. */
+export declare function restoreCodeSelection(codeEl: HTMLElement, saved: SelectionOffsets): void;
+/**
+ * `root` 안의 현재 셀렉션을 문자 오프셋으로 캡처한다.
+ * 셀렉션이 `root` 밖이면 null.
+ */
+export declare function captureSelectionOffsets(root: HTMLElement): SelectionOffsets | null;
+/**
+ * 문자 오프셋으로 저장해 둔 셀렉션을 되살린다.
+ * 문서가 짧아져 오프셋이 넘치면 가장 가까운 위치(문서 끝) 에 둔다.
+ */
+export declare function restoreSelectionOffsets(root: HTMLElement, saved: SelectionOffsets): void;
+/**
+ * 캐럿이 블록의 맨 끝에 있는지.
+ *
+ * 캐럿 뒤에 남은 **글자**가 없으면 끝으로 본다. 빈 단락의 `<br>` 이나 캐럿
+ * 고정용 zero-width 문자는 글자로 치지 않는다 — 사용자 눈에는 아무것도 없는
+ * 자리이기 때문이다.
+ */
+export declare function isCaretAtBlockEnd(blockEl: HTMLElement): boolean;
+/**
+ * 블록 시작부터 캐럿까지의 **보이는 글자**.
+ *
+ * 마크다운 입력 규칙이 방아쇠(`# ` 등) 를 알아보는 근거다. 노드 구조로
+ * 판정하지 않는 이유 — 빈 단락에는 placeholder `<br>` 이 남아 있고 첫 입력의
+ * 노드 배치가 브라우저마다 달라서, "첫 텍스트 노드" 같은 조건은 실제
+ * 브라우저에서 조용히 빗나간다.
+ *
+ * 판정에 쓴 Range 를 함께 돌려준다 — 방아쇠를 지우려면 정확히 그 범위가
+ * 필요하고, 다시 계산하면 그 사이 캐럿이 움직였을 때 엉뚱한 곳을 지운다.
+ */
+export declare function textBeforeCaret(blockEl: HTMLElement): {
+    text: string;
+    range: Range;
+} | null;
+// (소스맵은 CJS 선언 사본에서 제외됨 — scripts/finalize-types.mjs)

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

@@ -0,0 +1,51 @@
+/**
+ * BlockSnapshot 스키마 버전과 마이그레이션 진입점.
+ *
+ * 이 모듈은 **DOM 을 전혀 참조하지 않는다**. `document` / `window` 가 없는
+ * 런타임(Cloudflare workerd, Node, Deno) 에서 그대로 import 할 수 있어야 하므로
+ * blocks.ts 로부터는 타입만 가져온다.
+ */
+import type { BlockSnapshot } from './blocks.cjs';
+/**
+ * 현재 직렬화 스키마 버전.
+ *
+ * `serializeBlock()` 은 항상 이 값을 `snapshot.version` 에 기록한다.
+ *
+ * ## 버전 변경 정책
+ *
+ * 버전을 올리는 경우 — 저장된 데이터를 그대로 읽으면 **의미가 달라지는** 변경:
+ * - `kind` 의 삭제 또는 의미 변경
+ * - 기존 `attrs` 필드의 삭제 · 이름 변경 · 타입 변경 · 단위 변경
+ * - `html` 필드가 담는 내용의 범위 변경 (예: 인라인 컨텐츠 → 전체 outerHTML)
+ *
+ * 버전을 올리지 않는 경우 — 구버전 데이터를 그대로 읽어도 안전한 변경:
+ * - 새로운 `kind` 추가 (구버전 데이터에는 등장하지 않음)
+ * - 새로운 optional `attrs` 필드 추가
+ * - 렌더 결과의 시각적 변경 (CSS · 마크업 세부)
+ *
+ * 버전이 올라가면 {@link upgradeSnapshots} 에 해당 단계의 변환을 추가하고,
+ * 이 상수를 올린다. 읽기 경로(`AerizViewer.setBlocks` /
+ * `renderBlocksToHTML`) 는 모두 upgrade 를 거치도록 유지한다.
+ */
+export declare const SNAPSHOT_VERSION = 1;
+/**
+ * 스냅샷의 스키마 버전. `version` 이 없으면 버전 필드 도입 이전 데이터이므로
+ * 1 로 간주한다 (1.0.x 까지의 출력이 여기 해당한다).
+ */
+export declare function snapshotVersionOf(snapshot: BlockSnapshot): number;
+/**
+ * 저장된 스냅샷을 현재 스키마로 정규화한다.
+ *
+ * 읽기 경로의 단일 관문이다. 지금(v1) 은 실질 변환이 없고 다음만 보정한다.
+ * - `version` 누락 → 1 로 채움
+ * - 모르는 `kind` → `'unknown'` 으로 강등 (미래 버전으로 저장된 글을 구버전
+ *   클라이언트가 열었을 때 렌더가 통째로 깨지는 대신 해당 블록만 원문 유지)
+ * - `html` 누락 → 빈 문자열
+ *
+ * 버전이 올라가면 여기에 단계별 변환(1→2, 2→3 …) 을 순차 적용하는 형태로
+ * 확장한다.
+ */
+export declare function upgradeSnapshots(input: readonly BlockSnapshot[]): BlockSnapshot[];
+/** 단일 스냅샷 정규화. {@link upgradeSnapshots} 의 단위 연산. */
+export declare function upgradeSnapshot(snapshot: BlockSnapshot): BlockSnapshot;
+// (소스맵은 CJS 선언 사본에서 제외됨 — scripts/finalize-types.mjs)

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

@@ -0,0 +1,30 @@
+/**
+ * 표 셀의 기하와 이동.
+ *
+ * 표 편집은 "지금 어느 셀인가" 를 계속 되묻는 일이다 — 캐럿이 놓인 셀, 드래그
+ * 로 걸친 셀 범위, 마우스가 가장자리에 닿았는지, Tab 을 눌렀을 때 다음 셀.
+ * 그 판정들만 여기 모은다. 에디터 인스턴스 상태를 보지 않는 순수 계산이라
+ * 따로 두면 표 동작을 고칠 때 에디터 본체를 읽지 않아도 된다.
+ *
+ * **rowspan / colspan 은 고려하지 않는다.** 이 에디터는 둘 다 만들지 않으며,
+ * 병합 셀을 지원하게 되면 여기 있는 인덱스 계산은 전부 다시 짜야 한다.
+ */
+/** 임의의 노드에서 가장 가까운 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/index.d.cts

@@ -0,0 +1,22 @@
+// (CSS 부수 효과 import 는 타입 선언에서 제거됨 — scripts/strip-css-imports.mjs)
+export { AerizEditor } 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 { 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 type { RenderHtmlOptions } from './core/render-string.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 { decodeEntities, escapeAttr, escapeHtml, parseHtmlFragment, serializeNodes, textOf, textWithBlockBreaks, } from './core/html-mini.cjs';
+export type { HtmlElementNode, HtmlNode, HtmlText } from './core/html-mini.cjs';
+// (소스맵은 CJS 선언 사본에서 제외됨 — scripts/finalize-types.mjs)

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

@@ -0,0 +1,37 @@
+/**
+ * `@aeriz/wysiwyg/server` — DOM 없는 런타임용 진입점.
+ *
+ * 이 모듈은 **CSS 를 import 하지 않으며**, import 그래프 전체가
+ * `document` / `window` 를 참조하지 않는다. Cloudflare Workers(workerd) ·
+ * Node · Deno · Bun 에서 그대로 쓸 수 있다.
+ *
+ * 브라우저용 기본 진입점(`@aeriz/wysiwyg`) 은 스타일시트를 부수 효과로
+ * 불러오고 에디터/뷰어가 DOM 을 직접 만들기 때문에 서버에서 쓸 수 없다.
+ * 저장된 스냅샷을 HTML · 마크다운 · 평문으로 바꾸는 일만 필요하면 여기서
+ * 가져오면 된다.
+ *
+ * @example
+ *   // Cloudflare Worker — 저장된 글을 HTML 로 재렌더
+ *   import { renderBlocksToHTML, blocksToPlainText } from '@aeriz/wysiwyg/server';
+ *
+ *   export default {
+ *     async fetch(req, env) {
+ *       const post = await env.DB.get('post:1', 'json');
+ *       return new Response(
+ *         renderBlocksToHTML(post.blocks, { wrapper: 'content' }),
+ *         { headers: { 'content-type': 'text/html; charset=utf-8' } },
+ *       );
+ *     },
+ *   };
+ */
+export { renderBlockToHTML, renderBlocksToHTML, } from '../core/render-string.cjs';
+export type { RenderHtmlOptions } from '../core/render-string.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';
+// (소스맵은 CJS 선언 사본에서 제외됨 — scripts/finalize-types.mjs)

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

@@ -0,0 +1,61 @@
+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 interface ToolbarConfig {
+    items: ToolbarItem[];
+    sticky?: boolean;
+}
+/**
+ * HTML 출력의 스타일 전략.
+ *
+ * - `'inline'` — 테마 색을 블록 인라인 style 에 베이크. 스타일시트 없이도
+ *   에디터와 같은 시각으로 렌더된다 (기본값).
+ * - `'class'` — 테마 스타일을 베이크하지 않고 `aw-block-*` / `aw-align-*`
+ *   클래스만 남긴다. `style` 속성을 제거하는 서버 sanitizer 를 통과해야 할 때
+ *   쓴다. 출력은 `aeriz-wysiwyg.min.css` 가 로드된 페이지의
+ *   `.aeriz-wysiwyg > .aw-content` 안에 넣는 것을 전제로 한다.
+ */
+export type HtmlStyleMode = 'inline' | 'class';
+/** `getHTML()` 호출 단위 옵션. */
+export interface SerializeHtmlOptions {
+    /** 스타일 전략. 미지정 시 인스턴스 기본값을 따른다. */
+    styles?: HtmlStyleMode;
+}
+export interface EditorOptions {
+    element: HTMLElement;
+    initialHTML?: string;
+    placeholder?: string;
+    toolbar?: ToolbarConfig | false;
+    theme?: 'light' | 'dark';
+    /** UI 언어. 'en' / 'ko' / 'ja' / 'zh'. 기본 'ko'. */
+    locale?: 'en' | 'ko' | 'ja' | 'zh';
+    /**
+     * `getHTML()` 과 `onChange` 가 내보내는 HTML 의 스타일 전략. 기본 `'inline'`.
+     * `getHTML({ styles })` 로 호출 단위 재정의 가능.
+     */
+    htmlStyles?: HtmlStyleMode;
+    onChange?: (html: string) => void;
+    /**
+     * 직접 업로드 핸들러. 우선 적용된다. 미설정 + `imageUploadUrl` 만 있을 때는
+     * 에디터가 multipart/form-data 로 그 URL 에 POST 한 응답 JSON 의
+     * `url` 필드를 사용한다.
+     */
+    onImageUpload?: (file: File) => Promise<string>;
+    /**
+     * 서버 이미지 업로드 API URL. 설정 시 이미지 다이얼로그의 "업로드" 탭이
+     * 활성화된다. 미설정 시 업로드 탭은 비활성 + 툴팁 안내.
+     */
+    imageUploadUrl?: string;
+    /**
+     * 파일 첨부 직접 업로드 핸들러. 첨부 다이얼로그의 "업로드" 탭에서 사용.
+     * 미설정 + `fileUploadUrl` 만 있을 때는 에디터가 multipart/form-data 로
+     * POST 한 응답 JSON 의 `url` 필드를 사용한다.
+     */
+    onFileUpload?: (file: File) => Promise<string>;
+    /**
+     * 서버 파일 업로드 API URL. 설정 시 파일 첨부 다이얼로그의 "업로드" 탭이
+     * 활성화된다. 미설정 시 업로드 탭은 비활성 + 툴팁 안내.
+     */
+    fileUploadUrl?: string;
+}
+export declare const DEFAULT_TOOLBAR: ToolbarConfig;
+// (소스맵은 CJS 선언 사본에서 제외됨 — scripts/finalize-types.mjs)

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

@@ -0,0 +1,21 @@
+import type { ToolbarConfig, ToolbarItemName } from '../types/index.cjs';
+export interface ToolbarHandlers {
+    onAction: (name: ToolbarItemName, anchor: HTMLElement) => void;
+}
+export declare class Toolbar {
+    readonly element: HTMLDivElement;
+    private buttons;
+    constructor(config: ToolbarConfig, handlers: ToolbarHandlers);
+    setActive(name: ToolbarItemName, active: boolean): void;
+    setEnabled(name: ToolbarItemName, enabled: boolean): void;
+    /** 조건부 항목을 완전히 숨긴다 (display:none). 허용 블록으로 돌아오면 다시 보임. */
+    setVisible(name: ToolbarItemName, visible: boolean): void;
+    /**
+     * 모든 자식 버튼이 숨겨진 그룹을 함께 숨긴다 — `|` 구분자 padding 이 외롭게
+     * 남지 않도록. applyToolbarState 에서 visibility 갱신 후 호출.
+     */
+    syncGroupVisibility(): void;
+    private createGroup;
+    private createButton;
+}
+// (소스맵은 CJS 선언 사본에서 제외됨 — scripts/finalize-types.mjs)

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

@@ -0,0 +1,74 @@
+export interface DialogResult {
+    confirmed: boolean;
+}
+export interface LinkDialogResult extends DialogResult {
+    text?: string;
+    href?: string;
+    newWindow?: boolean;
+}
+export interface ImageDialogResult extends DialogResult {
+    src?: string;
+}
+export interface YouTubeDialogResult extends DialogResult {
+    url?: string;
+}
+export interface ImportHtmlDialogResult extends DialogResult {
+    /** 사용자가 선택했거나 붙여넣은 원본 HTML 문서 텍스트. */
+    html?: string;
+}
+export interface ImportMarkdownDialogResult extends DialogResult {
+    /** 사용자가 선택했거나 붙여넣은 원본 Markdown 텍스트. */
+    markdown?: string;
+}
+export interface FileAttachmentDialogResult extends DialogResult {
+    /** 다운로드 URL — 외부 URL 또는 업로드 API 응답에서 받은 URL. */
+    src?: string;
+    /** 원본 파일명. download attr 와 표시 라벨에 사용. */
+    name?: string;
+    /** 바이트 크기 (선택). 파일 업로드/메타에서 알 수 있을 때만. */
+    size?: number;
+    /** MIME 타입 (선택). 파일 업로드 시에만 알 수 있다. */
+    type?: string;
+}
+export interface TableDialogResult extends DialogResult {
+    rows?: number;
+    cols?: number;
+}
+export declare function openLinkDialog(initial?: {
+    text?: string;
+    href?: string;
+    newWindow?: boolean;
+}, theme?: 'light' | 'dark'): Promise<LinkDialogResult>;
+export declare function openImageDialog(options?: {
+    onUpload?: (file: File) => Promise<string>;
+}, theme?: 'light' | 'dark'): Promise<ImageDialogResult>;
+export declare function openTableDialog(theme?: 'light' | 'dark'): Promise<TableDialogResult>;
+/**
+ * HTML 파일을 골라 본문에 임포트하기 위한 다이얼로그.
+ * 파일 선택(.html / .htm) 또는 textarea 직접 붙여넣기를 모두 지원한다.
+ * 확인 시 원본 HTML 문자열을 resolve.
+ *
+ * 다이얼로그 안에서는 가져오기 동작 자체는 수행하지 않는다 — 호출자가
+ * 받은 html 을 importHtmlWithComputedStyles 로 처리한다.
+ */
+export declare function openImportHtmlDialog(theme?: 'light' | 'dark'): Promise<ImportHtmlDialogResult>;
+/**
+ * Markdown 파일을 골라 본문에 임포트하기 위한 다이얼로그.
+ * 파일 선택(.md / .markdown) 또는 textarea 직접 붙여넣기 모두 지원. 확인 시
+ * 원본 markdown 문자열을 resolve. 호출자가 받은 markdown 을 markdownToBlocks
+ * 으로 처리해 본문에 삽입한다.
+ */
+export declare function openMarkdownImportDialog(theme?: 'light' | 'dark'): Promise<ImportMarkdownDialogResult>;
+/**
+ * 파일 첨부 다이얼로그. 두 가지 입력 방식:
+ *  1) 링크 — 외부 URL + 표시 이름(선택) 입력
+ *  2) 업로드 — 사용자가 등록한 onUpload(file) 로 서버 업로드 후 응답 URL 사용
+ *
+ * 이미지 다이얼로그와 달리 base64 임베드 모드는 의도적으로 제외 — 첨부
+ * 파일은 보통 크기가 커서 직렬화 snapshot 비대화의 부작용이 크다.
+ */
+export declare function openFileAttachmentDialog(options?: {
+    onUpload?: (file: File) => Promise<string>;
+}, theme?: 'light' | 'dark'): Promise<FileAttachmentDialogResult>;
+export declare function openYouTubeDialog(theme?: 'light' | 'dark'): Promise<YouTubeDialogResult>;
+// (소스맵은 CJS 선언 사본에서 제외됨 — scripts/finalize-types.mjs)

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

@@ -0,0 +1,2 @@
+export declare const icons: Record<string, string>;
+// (소스맵은 CJS 선언 사본에서 제외됨 — scripts/finalize-types.mjs)

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

@@ -0,0 +1,70 @@
+import type { BlockAttrs, BlockKind } from '../core/blocks.cjs';
+export declare const COLOR_PALETTE: string[];
+export declare function openColorPicker(anchor: HTMLElement, onPick: (color: string | null) => void, recents?: ReadonlyArray<string>): void;
+/**
+ * 블록 드롭다운에서 사용자가 고른 항목.
+ * - `kind` 가 BlockKind 인 경우 일반 블록 추가/변환
+ * - `kind` 가 'importHtml' / 'importMarkdown' 인 경우 외부 가져오기 액션(특수 처리)
+ */
+export interface BlockTypeChoice {
+    kind: BlockKind | 'importHtml' | 'importMarkdown';
+    attrs: BlockAttrs;
+}
+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)` 호출 + 팝오버 닫힘
+ */
+export declare function openFontFamilyDropdown(anchor: HTMLElement, onPick: (choice: FontFamilyChoice) => void, currentId?: string): void;
+export interface CodeLanguageChoice {
+    id: string;
+    label: string;
+}
+/**
+ * 코드 블록의 언어 선택 드롭다운. highlight.ts 의 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';
+/**
+ * 표 편집 드롭다운 — 행/열 추가·삭제. 활성 블록이 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;
+/**
+ * 기능 미구현 메뉴 항목용 placeholder 드롭다운.
+ * 항목명만 노출하고 "준비 중" 메시지를 보여준다.
+ */
+export declare function openComingSoonDropdown(anchor: HTMLElement, label: string): void;
+/**
+ * 표 삽입 드롭다운. 모달 대신 anchor 아래에 떠 호버 위치에 따라 2x2 부터
+ * 12x12 까지 그리드가 동적으로 늘어난다. 셀을 클릭하면 onPick 호출 + 닫힘,
+ * 외부 클릭 / Esc → 취소.
+ */
+export interface TableSizeChoice {
+    rows: number;
+    cols: number;
+}
+export declare function openTableDropdown(anchor: HTMLElement, onPick: (choice: TableSizeChoice) => void): void;
+// (소스맵은 CJS 선언 사본에서 제외됨 — scripts/finalize-types.mjs)