@bavuchoko/js-editor 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,234 @@
+# @bavuchoko/js-editor
+
+React용 경량 WYSIWYG 에디터입니다.  
+`contentEditable` + Selection API로 구현되어 있으며 TipTap / Lexical / ProseMirror 같은 외부 에디터 엔진에 의존하지 않습니다.
+
+## Install
+
+```bash
+npm install @bavuchoko/js-editor
+```
+
+peer dependency:
+
+```bash
+npm install react react-dom
+```
+
+React 18 이상을 지원합니다.
+
+## Usage
+
+```tsx
+import { useRef } from 'react'
+import { Editor, type EditorHandle } from '@bavuchoko/js-editor'
+import '@bavuchoko/js-editor/style.css'
+
+function App() {
+  const editorRef = useRef<EditorHandle>(null)
+
+  const save = () => {
+    // 권장: JSON으로 저장
+    const json = editorRef.current?.getJson()
+    // await api.save(json)
+  }
+
+  const load = (doc: unknown) => {
+    editorRef.current?.setJson(doc)
+  }
+
+  return (
+    <Editor
+      ref={editorRef}
+      theme={{
+        toolbar: { background: '#fff' },
+        content: { padding: 24, minHeight: 320 },
+      }}
+    />
+  )
+}
+```
+
+스타일(`style.css`)은 반드시 함께 import 해야 합니다.
+
+## Features
+
+| 영역 | 지원 |
+|------|------|
+| 인라인 | 굵게, 기울임, 밑줄, 글자색, 배경색 |
+| 블록 | 본문, Heading 1–3, 인용, 코드 블록 |
+| 목록 | 글머리, 번호, 체크리스트 |
+| 정렬 | 왼쪽 / 가운데 / 오른쪽 |
+| 테이블 | 삽입, 셀 드래그 선택, 셀 병합, Tab/Enter 이동 |
+| 단축키 | Undo/Redo, 마크다운 입력 |
+| 보안 | 붙여넣기·`initialHTML`·`setHtml` sanitize |
+
+플레이스홀더 문구: `내용을 입력하세요`
+
+## Keyboard shortcuts
+
+| 단축키 | 동작 |
+|--------|------|
+| `Ctrl+Z` / `Cmd+Z` | Undo |
+| `Ctrl+Shift+Z` / `Cmd+Shift+Z` | Redo |
+| `Ctrl+Y` / `Cmd+Y` | Redo |
+| `Tab` (테이블 셀) | 다음 셀로 이동 |
+| `Enter` (테이블 셀) | 아래 셀로 이동 |
+
+툴바에 Undo/Redo 버튼은 없고 단축키만 지원합니다.
+
+## Markdown shortcuts
+
+줄 시작에서 입력 후 스페이스:
+
+| 입력 | 결과 |
+|------|------|
+| `# ` | Heading 1 |
+| `## ` | Heading 2 |
+| `### ` | Heading 3 |
+| `> ` | 인용 |
+| `- ` 또는 `* ` | 글머리 목록 |
+| `1. ` | 번호 목록 |
+| `` ``` `` + 스페이스 | 코드 블록 |
+
+인라인:
+
+| 입력 | 결과 |
+|------|------|
+| `**텍스트** ` | 굵게 |
+| `*텍스트* ` | 기울임 |
+
+## API
+
+### `Editor` props
+
+| prop | 타입 | 설명 |
+|------|------|------|
+| `initialHTML` | `string` | 초기 HTML (sanitize 후 적용) |
+| `theme` | `EditorTheme` | `toolbar` / `content`에 `CSSProperties` |
+| `className` / `style` | | 루트 요소 |
+| `toolbarClassName` / `toolbarStyle` | | 툴바 (theme.toolbar와 병합) |
+| `contentClassName` / `contentStyle` | | 본문 (theme.content와 병합) |
+
+```tsx
+type EditorTheme = {
+  toolbar?: CSSProperties
+  content?: CSSProperties
+}
+```
+
+### `ref` methods (`EditorHandle`)
+
+| method | 설명 |
+|--------|------|
+| `getHtml()` | 현재 본문 HTML |
+| `setHtml(html)` | HTML 로드 (sanitize + 히스토리 리셋) |
+| `getJson()` | 현재 본문 JSON (`EditorDoc`) |
+| `setJson(doc)` | JSON 로드 (HTML 변환 + sanitize + 히스토리 리셋) |
+| `getText()` | plain text |
+| `focus()` | 편집 영역 포커스 |
+
+### 유틸 export
+
+```ts
+import {
+  htmlToJson,
+  jsonToHtml,
+  domToJson,
+  normalizeDoc,
+  sanitizeHTML,
+  sanitizePlainText,
+  type EditorDoc,
+  type BlockNode,
+  type InlineNode,
+  type Mark,
+} from '@bavuchoko/js-editor'
+```
+
+| 함수 | 설명 |
+|------|------|
+| `htmlToJson(html)` | HTML → `EditorDoc` |
+| `jsonToHtml(doc)` | `EditorDoc` → HTML |
+| `domToJson(element)` | DOM 노드 → `EditorDoc` |
+| `normalizeDoc(doc)` | 알 수 없는 입력을 안전한 `EditorDoc`으로 정규화 |
+| `sanitizeHTML(html)` | 허용 태그/속성만 남김 |
+| `sanitizePlainText(text)` | 텍스트만 남김 |
+
+## Document JSON
+
+저장·전송은 HTML보다 JSON을 권장합니다.
+
+```ts
+type EditorDoc = {
+  type: 'doc'
+  content: BlockNode[]
+}
+```
+
+예시:
+
+```json
+{
+  "type": "doc",
+  "content": [
+    {
+      "type": "heading",
+      "attrs": { "level": 1 },
+      "content": [{ "type": "text", "text": "제목" }]
+    },
+    {
+      "type": "paragraph",
+      "attrs": { "textAlign": "left" },
+      "content": [
+        { "type": "text", "text": "안녕하세요, " },
+        {
+          "type": "text",
+          "text": "굵은 글씨",
+          "marks": [{ "type": "bold" }]
+        }
+      ]
+    },
+    {
+      "type": "taskList",
+      "content": [
+        {
+          "type": "taskItem",
+          "attrs": { "checked": false },
+          "content": [{ "type": "text", "text": "할 일" }]
+        }
+      ]
+    }
+  ]
+}
+```
+
+지원 블록: `paragraph`, `heading`, `blockquote`, `codeBlock`, `bulletList`, `orderedList`, `taskList`, `table`  
+지원 마크: `bold`, `italic`, `underline`, `code`, `textStyle`(색), `highlight`(배경색)
+
+## Security
+
+- 붙여넣기, `initialHTML`, `setHtml` / `setJson` 경로에서 HTML을 sanitize 합니다.
+- 허용되지 않은 태그·속성·이벤트 핸들러·위험한 URL은 제거됩니다.
+- 서버에서도 저장 전에 검증하는 것을 권장합니다. JSON으로 저장하면 스키마 검증이 쉽습니다.
+
+```tsx
+// 서버에서 받은 HTML을 넣을 때
+editorRef.current?.setHtml(untrustedHtml) // 내부에서 sanitize
+
+// 더 안전하게 JSON만 받기
+editorRef.current?.setJson(docFromDb)
+```
+
+## Develop
+
+```bash
+npm install
+npm run dev          # 데모 앱
+npm run build        # 라이브러리 빌드 (publish용)
+npm run build:demo   # 데모 앱 빌드
+npm run pack:check   # 빌드 + npm pack dry-run
+```
+
+## License
+
+MIT

package/dist/Editor.d.ts

@@ -0,0 +1,39 @@
+import { type CSSProperties } from 'react';
+import { type EditorDoc } from './document';
+import { type EditorTheme } from './theme';
+export type EditorHandle = {
+    /** 현재 본문 HTML */
+    getHtml: () => string;
+    /** DB 등에서 불러온 HTML 넣기 (sanitize + 히스토리 리셋) */
+    setHtml: (html: string) => void;
+    /** 현재 본문 JSON */
+    getJson: () => EditorDoc;
+    /** DB 등에서 불러온 JSON 넣기 (HTML 변환 + sanitize + 히스토리 리셋) */
+    setJson: (doc: EditorDoc | unknown) => void;
+    /** 본문 텍스트만 */
+    getText: () => string;
+    /** 편집 영역에 포커스 */
+    focus: () => void;
+};
+export type EditorProps = {
+    initialHTML?: string;
+    /** 에디터 루트 클래스 */
+    className?: string;
+    /** 에디터 루트 인라인 스타일 */
+    style?: CSSProperties;
+    /**
+     * 툴바/본문 스타일
+     * @example theme={{ toolbar: { background: '#fff' }, content: { padding: 24 } }}
+     */
+    theme?: EditorTheme;
+    /** 툴바 영역 클래스 */
+    toolbarClassName?: string;
+    /** 툴바 영역 인라인 스타일 (theme.toolbar와 병합) */
+    toolbarStyle?: CSSProperties;
+    /** 본문(페이퍼) 영역 클래스 */
+    contentClassName?: string;
+    /** 본문 편집 영역 인라인 스타일 (theme.content와 병합) */
+    contentStyle?: CSSProperties;
+};
+export declare const Editor: import("react").ForwardRefExoticComponent<EditorProps & import("react").RefAttributes<EditorHandle>>;
+//# sourceMappingURL=Editor.d.ts.map

package/dist/Editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Editor.d.ts","sourceRoot":"","sources":["../src/editor/Editor.tsx"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,aAAa,EAGnB,MAAM,OAAO,CAAA;AAiBd,OAAO,EAIL,KAAK,SAAS,EACf,MAAM,YAAY,CAAA;AAQnB,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,SAAS,CAAA;AAuB1C,MAAM,MAAM,YAAY,GAAG;IACzB,iBAAiB;IACjB,OAAO,EAAE,MAAM,MAAM,CAAA;IACrB,8CAA8C;IAC9C,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC/B,iBAAiB;IACjB,OAAO,EAAE,MAAM,SAAS,CAAA;IACxB,wDAAwD;IACxD,OAAO,EAAE,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,KAAK,IAAI,CAAA;IAC3C,cAAc;IACd,OAAO,EAAE,MAAM,MAAM,CAAA;IACrB,iBAAiB;IACjB,KAAK,EAAE,MAAM,IAAI,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,iBAAiB;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,qBAAqB;IACrB,KAAK,CAAC,EAAE,aAAa,CAAA;IACrB;;;OAGG;IACH,KAAK,CAAC,EAAE,WAAW,CAAA;IACnB,gBAAgB;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,wCAAwC;IACxC,YAAY,CAAC,EAAE,aAAa,CAAA;IAC5B,qBAAqB;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,2CAA2C;IAC3C,YAAY,CAAC,EAAE,aAAa,CAAA;CAC7B,CAAA;AAED,eAAO,MAAM,MAAM,sGAgQjB,CAAA"}

package/dist/TableSelection.d.ts

@@ -0,0 +1,8 @@
+import { type RefObject } from 'react';
+type TableSelectionProps = {
+    editorRef: RefObject<HTMLDivElement | null>;
+    onMerge: (cells: HTMLTableCellElement[]) => void;
+};
+export declare function TableSelection({ editorRef, onMerge, }: TableSelectionProps): import("react").JSX.Element | null;
+export {};
+//# sourceMappingURL=TableSelection.d.ts.map

package/dist/TableSelection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TableSelection.d.ts","sourceRoot":"","sources":["../src/editor/TableSelection.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAEnE,KAAK,mBAAmB,GAAG;IACzB,SAAS,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAA;IAC3C,OAAO,EAAE,CAAC,KAAK,EAAE,oBAAoB,EAAE,KAAK,IAAI,CAAA;CACjD,CAAA;AAgJD,wBAAgB,cAAc,CAAC,EAC7B,SAAS,EACT,OAAO,GACR,EAAE,mBAAmB,sCA+NrB"}

package/dist/Toolbar.d.ts

@@ -0,0 +1,32 @@
+import type { ActiveState, AlignValue } from './selection';
+export type ToolbarCommand = {
+    type: 'inline';
+    mark: 'bold' | 'italic' | 'underline';
+} | {
+    type: 'block';
+    format: 'p' | 'h1' | 'h2' | 'h3' | 'blockquote' | 'pre' | 'ul' | 'ol' | 'checklist';
+} | {
+    type: 'align';
+    align: AlignValue;
+} | {
+    type: 'textColor';
+    color: string | null;
+} | {
+    type: 'highlightColor';
+    color: string | null;
+} | {
+    type: 'insertTable';
+    rows?: number;
+    cols?: number;
+} | {
+    type: 'undo';
+} | {
+    type: 'redo';
+};
+type ToolbarProps = {
+    active: ActiveState;
+    onCommand: (command: ToolbarCommand) => void;
+};
+export declare function Toolbar({ active, onCommand }: ToolbarProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=Toolbar.d.ts.map

package/dist/Toolbar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Toolbar.d.ts","sourceRoot":"","sources":["../src/editor/Toolbar.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAsJ1D,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,WAAW,CAAA;CAAE,GACzD;IACE,IAAI,EAAE,OAAO,CAAA;IACb,MAAM,EAAE,GAAG,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,YAAY,GAAG,KAAK,GAAG,IAAI,GAAG,IAAI,GAAG,WAAW,CAAA;CACpF,GACD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AA2CpB,KAAK,YAAY,GAAG;IAClB,MAAM,EAAE,WAAW,CAAA;IACnB,SAAS,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAA;CAC7C,CAAA;AAmpBD,wBAAgB,OAAO,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,YAAY,+BAoF1D"}

package/dist/commands.d.ts

@@ -0,0 +1,22 @@
+import { type AlignValue } from './selection';
+declare const INLINE_TAG_MAP: Record<string, string>;
+export declare function toggleInline(editor: HTMLElement, mark: keyof typeof INLINE_TAG_MAP): boolean;
+/** 체크리스트 체크박스 클릭 토글 */
+export declare function handleChecklistClick(editor: HTMLElement, event: MouseEvent): boolean;
+export declare function setBlockFormat(editor: HTMLElement, format: 'p' | 'h1' | 'h2' | 'h3' | 'blockquote' | 'pre' | 'ul' | 'ol' | 'checklist'): boolean;
+export declare function setAlign(editor: HTMLElement, align: AlignValue): boolean;
+export declare function setTextColor(editor: HTMLElement, color: string | null): boolean;
+export declare function setHighlightColor(editor: HTMLElement, color: string | null): boolean;
+export declare function insertHTML(editor: HTMLElement, html: string): boolean;
+export declare function insertTable(editor: HTMLElement, rows?: number, cols?: number): boolean;
+/** 사각 선택 영역의 셀들을 병합 (가로 colspan + 세로 rowspan) */
+export declare function mergeCells(cells: HTMLTableCellElement[]): boolean;
+/** @deprecated use mergeCells */
+export declare function mergeColumnCells(cells: HTMLTableCellElement[]): boolean;
+/** 현재 셀을 오른쪽 옆 셀과 열 병합 (colspan) */
+export declare function mergeColumns(editor: HTMLElement): boolean;
+export declare function handleTableTab(editor: HTMLElement, event: KeyboardEvent): boolean;
+export declare function handleEnterKey(editor: HTMLElement, event: KeyboardEvent): boolean;
+export declare function focusEditor(editor: HTMLElement): void;
+export {};
+//# sourceMappingURL=commands.d.ts.map

package/dist/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../src/editor/commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAWL,KAAK,UAAU,EAChB,MAAM,aAAa,CAAA;AAEpB,QAAA,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAI1C,CAAA;AAuDD,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,OAAO,cAAc,WAclF;AA+UD,uBAAuB;AACvB,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,UAAU,GAChB,OAAO,CAaT;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,GAAG,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,YAAY,GAAG,KAAK,GAAG,IAAI,GAAG,IAAI,GAAG,WAAW,WA8CpF;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,WAS9D;AA2GD,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,WAErE;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,WAE1E;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,WAW3D;AAQD,wBAAgB,WAAW,CACzB,MAAM,EAAE,WAAW,EACnB,IAAI,SAAI,EACR,IAAI,SAAI,GACP,OAAO,CAyCT;AA+DD,iDAAiD;AACjD,wBAAgB,UAAU,CAAC,KAAK,EAAE,oBAAoB,EAAE,GAAG,OAAO,CAwDjE;AAED,iCAAiC;AACjC,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,oBAAoB,EAAE,GAAG,OAAO,CAEvE;AAED,oCAAoC;AACpC,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CASzD;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,aAAa,GACnB,OAAO,CAgCT;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CA6EjF;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,QAmB9C"}

package/dist/document.d.ts

@@ -0,0 +1,110 @@
+/** 에디터 문서 JSON 스키마 */
+export type TextAlign = 'left' | 'center' | 'right';
+export type Mark = {
+    type: 'bold';
+} | {
+    type: 'italic';
+} | {
+    type: 'underline';
+} | {
+    type: 'code';
+} | {
+    type: 'textStyle';
+    attrs?: {
+        color?: string;
+    };
+} | {
+    type: 'highlight';
+    attrs?: {
+        color?: string;
+    };
+};
+export type TextNode = {
+    type: 'text';
+    text: string;
+    marks?: Mark[];
+};
+export type HardBreakNode = {
+    type: 'hardBreak';
+};
+export type InlineNode = TextNode | HardBreakNode;
+export type ParagraphNode = {
+    type: 'paragraph';
+    attrs?: {
+        textAlign?: TextAlign;
+    };
+    content?: InlineNode[];
+};
+export type HeadingNode = {
+    type: 'heading';
+    attrs: {
+        level: 1 | 2 | 3;
+        textAlign?: TextAlign;
+    };
+    content?: InlineNode[];
+};
+export type BlockquoteNode = {
+    type: 'blockquote';
+    attrs?: {
+        textAlign?: TextAlign;
+    };
+    content?: InlineNode[];
+};
+export type CodeBlockNode = {
+    type: 'codeBlock';
+    content?: TextNode[];
+};
+export type ListItemNode = {
+    type: 'listItem';
+    content?: Array<ParagraphNode | BulletListNode | OrderedListNode>;
+};
+export type BulletListNode = {
+    type: 'bulletList';
+    content?: ListItemNode[];
+};
+export type OrderedListNode = {
+    type: 'orderedList';
+    content?: ListItemNode[];
+};
+export type TaskItemNode = {
+    type: 'taskItem';
+    attrs?: {
+        checked?: boolean;
+    };
+    content?: InlineNode[];
+};
+export type TaskListNode = {
+    type: 'taskList';
+    content?: TaskItemNode[];
+};
+export type TableCellNode = {
+    type: 'tableCell';
+    attrs?: {
+        colspan?: number;
+        rowspan?: number;
+        color?: string;
+        backgroundColor?: string;
+    };
+    content?: InlineNode[];
+};
+export type TableRowNode = {
+    type: 'tableRow';
+    content?: TableCellNode[];
+};
+export type TableNode = {
+    type: 'table';
+    content?: TableRowNode[];
+};
+export type BlockNode = ParagraphNode | HeadingNode | BlockquoteNode | CodeBlockNode | BulletListNode | OrderedListNode | TaskListNode | TableNode;
+export type EditorDoc = {
+    type: 'doc';
+    content: BlockNode[];
+};
+/** contentEditable 루트 → JSON */
+export declare function domToJson(root: HTMLElement): EditorDoc;
+export declare function htmlToJson(html: string): EditorDoc;
+/** JSON → HTML 문자열 */
+export declare function jsonToHtml(doc: EditorDoc): string;
+/** 느슨한 입력도 EditorDoc으로 정규화 */
+export declare function normalizeDoc(input: unknown): EditorDoc;
+//# sourceMappingURL=document.d.ts.map

package/dist/document.d.ts.map

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

package/dist/history.d.ts

@@ -0,0 +1,26 @@
+export type HistorySnapshot = {
+    html: string;
+    selection?: {
+        startPath: number[];
+        startOffset: number;
+        endPath: number[];
+        endOffset: number;
+    };
+};
+export declare function captureSelection(root: HTMLElement): HistorySnapshot['selection'];
+export declare function restoreSelection(root: HTMLElement, snapshot?: HistorySnapshot['selection']): void;
+export declare class EditorHistory {
+    private undoStack;
+    private redoStack;
+    private lastPush;
+    private debounceMs;
+    private maxSize;
+    constructor(debounceMs?: number, maxSize?: number);
+    reset(html: string): void;
+    push(editor: HTMLElement, force?: boolean): void;
+    undo(editor: HTMLElement): boolean;
+    redo(editor: HTMLElement): boolean;
+    canUndo(): boolean;
+    canRedo(): boolean;
+}
+//# sourceMappingURL=history.d.ts.map

package/dist/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../src/editor/history.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,CAAC,EAAE;QACV,SAAS,EAAE,MAAM,EAAE,CAAA;QACnB,WAAW,EAAE,MAAM,CAAA;QACnB,OAAO,EAAE,MAAM,EAAE,CAAA;QACjB,SAAS,EAAE,MAAM,CAAA;KAClB,CAAA;CACF,CAAA;AAuBD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,GAAG,eAAe,CAAC,WAAW,CAAC,CAehF;AAQD,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,WAAW,EACjB,QAAQ,CAAC,EAAE,eAAe,CAAC,WAAW,CAAC,QAgBxC;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,SAAS,CAAwB;IACzC,OAAO,CAAC,SAAS,CAAwB;IACzC,OAAO,CAAC,QAAQ,CAAI;IACpB,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,OAAO,CAAQ;gBAEX,UAAU,SAAM,EAAE,OAAO,SAAM;IAK3C,KAAK,CAAC,IAAI,EAAE,MAAM;IAMlB,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,UAAQ;IAyBvC,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO;IAUlC,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO;IASlC,OAAO;IAIP,OAAO;CAGR"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { Editor, type EditorHandle, type EditorProps } from './Editor';
+export { domToJson, htmlToJson, jsonToHtml, normalizeDoc, type BlockNode, type EditorDoc, type InlineNode, type Mark, } from './document';
+export { sanitizeHTML, sanitizePlainText } from './sanitize';
+export { type EditorTheme, type EditorThemeVars } from './theme';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/editor/index.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,CAAA;AAErB,OAAO,EAAE,MAAM,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAA;AACtE,OAAO,EACL,SAAS,EACT,UAAU,EACV,UAAU,EACV,YAAY,EACZ,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,IAAI,GACV,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAC5D,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,SAAS,CAAA"}