@aeriz/wysiwyg 1.0.2 → 1.0.3

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

@@ -0,0 +1,209 @@
+/**
+ * 다국어 (i18n) 문자열 사전 — UI 정적 라벨, tooltip, 다이얼로그 제목/필드,
+ * 블록 라벨, 팝오버 항목 등.
+ *
+ * 4 개 로케일: 영어 / 한국어 / 일본어 / 중국어(간체).
+ *
+ * 사용 모델 — 모듈 레벨 "current locale" 을 두고 `t()` accessor 로 어디서든
+ * 같은 사전을 참조한다. `AerizEditor` 가 옵션에 따라 시작 시 setLocale() 1 회.
+ */
+export type Locale = 'en' | 'ko' | 'ja' | 'zh';
+export interface Strings {
+    toolbar: {
+        undo: string;
+        redo: string;
+        blockType: string;
+        fontFamily: string;
+        fontSize: string;
+        bold: string;
+        italic: string;
+        underline: string;
+        strike: string;
+        color: string;
+        backgroundColor: string;
+        align: string;
+        cellBg: string;
+        tableMenu: string;
+        codeLang: string;
+        bulletList: string;
+        orderedList: string;
+        blockquote: string;
+        codeBlock: string;
+        link: string;
+        image: string;
+        table: string;
+        hr: string;
+        clearFormat: string;
+        blockTypeChangeTooltip: string;
+        blockMoveTooltip: string;
+        addBelowTooltip: string;
+    };
+    blocks: {
+        paragraph: string;
+        /** "Heading {n}" 형식 — caller 가 {n} 을 level 숫자로 치환 */
+        heading: string;
+        bulletList: string;
+        orderedList: string;
+        blockquote: string;
+        codeBlock: string;
+        image: string;
+        table: string;
+        hr: string;
+        linkCard: string;
+        youtube: string;
+        file: string;
+        importedHtml: string;
+        unknown: string;
+    };
+    blockMenu: {
+        body: string;
+        h1: string;
+        h2: string;
+        h3: string;
+        bulletList: string;
+        orderedList: string;
+        blockquote: string;
+        codeBlock: string;
+        hr: string;
+        link: string;
+        image: string;
+        table: string;
+        youtube: string;
+        file: string;
+        importHtml: string;
+        importMarkdown: string;
+    };
+    align: {
+        left: string;
+        center: string;
+        right: string;
+        justify: string;
+    };
+    color: {
+        customColor: string;
+        defaultColor: string;
+        recent: string;
+    };
+    tableMenu: {
+        rowAbove: string;
+        rowBelow: string;
+        colLeft: string;
+        colRight: string;
+        deleteRow: string;
+        deleteCol: string;
+    };
+    fontFamily: {
+        systemDefault: string;
+    };
+    blockAlign: {
+        left: string;
+        center: string;
+        right: string;
+    };
+    comingSoon: {
+        label: string;
+    };
+    dialogs: {
+        confirm: string;
+        cancel: string;
+        insert: string;
+        apply: string;
+        importBtn: string;
+        close: string;
+        selectedFileNone: string;
+        dropOrClick: string;
+    };
+    link: {
+        title: string;
+        text: string;
+        textPlaceholder: string;
+        url: string;
+        urlPlaceholder: string;
+        openNewWindow: string;
+    };
+    image: {
+        title: string;
+        embedTab: string;
+        embedTabTitle: string;
+        urlTab: string;
+        urlTabTitle: string;
+        uploadTab: string;
+        uploadTabTitle: string;
+        uploadDisabledTitle: string;
+        embedDropzone: string;
+        urlLabel: string;
+        urlPlaceholder: string;
+        uploadDropzone: string;
+        noUploadApi: string;
+    };
+    youtube: {
+        title: string;
+        urlLabel: string;
+        urlPlaceholder: string;
+        formatHint: string;
+    };
+    table: {
+        title: string;
+        statusZero: string;
+        /** "{r} × {c} 표" 형식 — caller 가 {r}, {c} 치환 */
+        statusFormat: string;
+        pickerHint: string;
+    };
+    importHtml: {
+        title: string;
+        fileSelect: string;
+        pasteLabel: string;
+        pastePlaceholder: string;
+        hint: string;
+        errEmpty: string;
+        errNoBody: string;
+        errFailed: string;
+    };
+    importMarkdown: {
+        title: string;
+        fileSelect: string;
+        pasteLabel: string;
+        pastePlaceholder: string;
+        hint: string;
+        errEmpty: string;
+        errNoBody: string;
+        errFailed: string;
+    };
+    fileAttach: {
+        title: string;
+        urlTab: string;
+        urlTabTitle: string;
+        uploadTab: string;
+        uploadTabTitle: string;
+        uploadDisabledTitle: string;
+        urlLabel: string;
+        urlPlaceholder: string;
+        nameLabel: string;
+        namePlaceholder: string;
+        noUploadApi: string;
+        uploadDropzone: string;
+        uploadComplete: string;
+        uploadFailed: string;
+        errEmpty: string;
+    };
+    status: {
+        /** "{label} ({id8})" 의 prefix 라벨용 */
+        noActive: string;
+        /** "{n} 블록(s)" — {n} 치환 */
+        blocksCount: string;
+        /** "텍스트 {n} 자" — {n} 치환 */
+        chars: string;
+        /** "소스 {n}" — {n} 치환 (formatCount 결과) */
+        source: string;
+    };
+}
+export declare function setLocale(locale: Locale): void;
+export declare function getLocale(): Locale;
+/** 현재 활성화된 strings 사전을 반환. 모든 UI 코드에서 호출 진입점. */
+export declare function t(): Strings;
+/**
+ * 템플릿 치환 유틸. `{key}` 패턴을 `vars[key]` 로 치환.
+ * 예: format('Heading {n}', { n: 1 }) → 'Heading 1'
+ */
+export declare function format(template: string, vars: Record<string, string | number>): string;
+// (소스맵은 CJS 선언 사본에서 제외됨 — scripts/finalize-types.mjs)

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

@@ -0,0 +1,39 @@
+/**
+ * 외부 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 interface ImportHtmlOptions {
+    /** iframe load 후 추가 idle 대기(ms). Tailwind CDN 등 런타임 스타일 주입을
+     *  기다리기 위해 기본 1000ms. */
+    settleMs?: number;
+    /** iframe load timeout(ms). 기본 30_000. */
+    timeoutMs?: number;
+    /** 화면 밖 iframe 폭. computed style 의 width/height 단위 변환에 영향. */
+    width?: number;
+    /**
+     * 가져온 element 들이 최종적으로 삽입될 destination element. 지정하면
+     * 해당 위치의 CSS 캐스케이드를 고려한 baseline 비교로 인라인 스타일을 더
+     * 엄격하게 추려낸다 — destination 의 descendant selector 룰
+     * (`.aw-content blockquote { ... }` 등) 이 imported 트리에 적용될 값을
+     * baseline 으로 간주해, 같은 값이면 인라인을 박지 않는다.
+     *
+     * 미지정 시 iframe 단독 baseline (UA 기본값) 으로 처리되어, 결과 트리가
+     * destination 의 descendant 룰에 영향받을 수 있다.
+     */
+    mountTarget?: HTMLElement;
+}
+/**
+ * 외부 HTML 을 받아 인라인 스타일이 베이크된 element 배열을 반환한다.
+ * 호출자는 원하는 위치에 `appendChild` / `insertBefore` 등으로 삽입하면 된다.
+ */
+export declare function importHtmlWithComputedStyles(html: string, options?: ImportHtmlOptions): Promise<HTMLElement[]>;
+// (소스맵은 CJS 선언 사본에서 제외됨 — scripts/finalize-types.mjs)

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

@@ -0,0 +1,37 @@
+/**
+ * 가벼운 Markdown → HTMLElement[] 변환기.
+ *
+ * 외부 의존성 없이 CommonMark 의 자주 쓰이는 문법만 지원한다 — 에디터의
+ * 네이티브 블록 유형(p / h1~6 / ul / ol / blockquote / pre / hr / table /
+ * a / img) 으로 직접 매핑되도록 결과 구조를 단순하게 유지.
+ *
+ * 지원 문법 (블록):
+ *  - ATX 제목: `# … ###### …`
+ *  - 단락
+ *  - 글머리 목록: `- `, `* `, `+ `
+ *  - 번호 목록: `1. `
+ *  - 인용구: `> …`
+ *  - 코드 블록: ```lang\n…\n```
+ *  - 구분선: `---`, `***`, `___`
+ *  - 표 (GFM): `| a | b |\n|---|---|\n…`
+ *
+ * 지원 문법 (인라인):
+ *  - 굵게: `**…**`, `__…__`
+ *  - 기울임: `*…*`, `_…_`
+ *  - 취소선: `~~…~~`
+ *  - 인라인 코드: `` `…` ``
+ *  - 링크: `[text](url)`
+ *  - 이미지: `![alt](url)`
+ *  - 자동 링크: `<https://…>`
+ *  - 줄바꿈: 줄 끝 두 칸 공백 → `<br>`
+ */
+/**
+ * Markdown 문자열을 본문에 삽입할 수 있는 HTMLElement 배열로 변환한다.
+ * 결과 element 들은 에디터의 네이티브 블록 유형으로 인식 가능한 표준 태그.
+ */
+export declare function markdownToBlocks(md: string): HTMLElement[];
+/**
+ * Markdown 문자열을 HTML 문자열로 변환. 외부 직접 사용 가능 (테스트 등).
+ */
+export declare function markdownToHtml(md: string): string;
+// (소스맵은 CJS 선언 사본에서 제외됨 — scripts/finalize-types.mjs)

package/dist-types/cjs/core/markdown-export.d.cts

@@ -0,0 +1,30 @@
+/**
+ * `BlockSnapshot[]` → 마크다운. DOM 을 쓰지 않는다.
+ *
+ * `import-markdown.ts` 의 역방향이다. 포맷 종속을 푸는 탈출구 — 저장된 글을
+ * 언제든 에디터 밖으로 꺼낼 수 있게 한다.
+ *
+ * ## 표현 범위
+ *
+ * 마크다운으로 표현할 수 없는 서식은 다음 두 갈래로 처리한다.
+ * - **원시 HTML 로 보존** — 밑줄(`<u>`), 위/아래 첨자, 가져온 HTML 블록.
+ *   GFM 은 인라인 HTML 을 허용하므로 정보가 사라지지 않는다.
+ * - **버림** — 글자색 · 배경색 · 글자 크기 · 글꼴 · 정렬. 마크다운에 대응
+ *   개념이 없고 HTML 로 남기면 결과가 마크다운이라 부르기 어려워진다.
+ */
+import type { BlockSnapshot } from './blocks.cjs';
+export interface MarkdownOptions {
+    /**
+     * 글머리 목록 기호. 기본 `'-'`.
+     */
+    bullet?: '-' | '*' | '+';
+    /**
+     * 표를 GFM 표로 낼지. 기본 `true`.
+     * `false` 면 표를 원시 HTML 로 보존한다 (셀 병합 등 GFM 이 표현할 수 없는
+     * 구조를 잃지 않아야 할 때).
+     */
+    gfmTables?: boolean;
+}
+/** 스냅샷 배열을 마크다운 문서로 변환한다. */
+export declare function blocksToMarkdown(snapshots: readonly BlockSnapshot[], options?: MarkdownOptions): string;
+// (소스맵은 CJS 선언 사본에서 제외됨 — scripts/finalize-types.mjs)

package/dist-types/cjs/core/plain-text.d.cts

@@ -0,0 +1,17 @@
+/**
+ * `BlockSnapshot[]` → 평문. DOM 을 쓰지 않는다.
+ *
+ * 전문 검색(FTS) 색인 · 요약 스니펫 · 글자 수 계산용이다. 서식은 전부 버리고
+ * **사람이 읽는 텍스트만** 남긴다. 이미지는 `alt`, 링크는 표시 텍스트,
+ * 파일 첨부는 파일명이 텍스트로 들어간다 — 색인에 걸려야 의미가 있는 값들이다.
+ */
+import type { BlockSnapshot } from './blocks.cjs';
+export interface PlainTextOptions {
+    /** 블록 사이 구분자. 기본 `'\n\n'`. 색인용으로 `' '` 를 쓰기도 한다. */
+    blockSeparator?: string;
+    /** 표 셀 구분자. 기본 `'\t'`. */
+    cellSeparator?: string;
+}
+/** 스냅샷 배열에서 평문을 추출한다. */
+export declare function blocksToPlainText(snapshots: readonly BlockSnapshot[], options?: PlainTextOptions): string;
+// (소스맵은 CJS 선언 사본에서 제외됨 — scripts/finalize-types.mjs)

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/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/index.d.cts

@@ -0,0 +1,20 @@
+// (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 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)