@aeriz/wysiwyg 1.0.2 → 1.0.4

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

@@ -0,0 +1,60 @@
+/**
+ * 글꼴 라이브러리 — 한국어 본문에 친화적인 무료 / 상용 가능 글꼴만 큐레이션.
+ * 모두 SIL Open Font License 또는 자체 무제한 상용 라이선스.
+ *
+ * 로딩 정책:
+ *  - 모든 글꼴은 글꼴 드롭다운이 처음 열릴 때 1회 일괄 lazy 로드.
+ *  - Google Fonts CSS2 endpoint 한 번 + 외부 CDN(Pretendard) 별도 1 회.
+ *  - 실패해도 stack 의 fallback 글꼴이 자동 적용되므로 graceful degradation.
+ */
+export interface FontFamily {
+    /** 안정 식별자 — 직렬화 / 다음 선택 비교에 사용. */
+    id: string;
+    /** 드롭다운에 표시되는 한국어 라벨. */
+    label: string;
+    /** CSS font-family 스택 — execCommand fontName 의 인자로 들어간다. */
+    stack: string;
+    /** Google Fonts CSS2 family 파라미터 (예: "Noto+Sans+KR:wght@400;700"). */
+    googleFonts?: string;
+    /** 외부 CDN 의 전체 CSS URL (Google Fonts 가 아닌 글꼴용). */
+    cssUrl?: string;
+}
+/** "시스템 기본" 항목의 id. clearFormat / 초기화 분기에 사용. */
+export declare const SYSTEM_FONT_ID = "system";
+export declare const FONT_FAMILIES: ReadonlyArray<FontFamily>;
+/** id → FontFamily lookup. */
+export declare const FONT_FAMILY_BY_ID: Readonly<Record<string, FontFamily>>;
+/**
+ * 글자 크기 프리셋 (px). 본문 기본은 16px.
+ * 12 ~ 48px 범위에서 자주 쓰이는 단계만 큐레이션.
+ */
+export declare const FONT_SIZES: ReadonlyArray<number>;
+/**
+ * Computed CSS font-size 문자열(예: "16px", "1.125rem")을 px 정수로 변환.
+ * 매칭 실패 시 null. 활성 toolbar 크기 표시에 사용.
+ */
+export declare function pxFromCss(css: string | null | undefined): number | null;
+/**
+ * 현재 실제로 쓸 수 있는 글꼴만 반환한다. 드롭다운은 이 목록으로 그린다.
+ *
+ * `FONT_FAMILIES` 전체는 그대로 남겨 둔다 — 이미 그 글꼴로 저장된 본문의
+ * 라벨을 표시하려면(`findFontIdFromCss`) 실패한 항목도 알고 있어야 한다.
+ */
+export declare function getAvailableFontFamilies(): ReadonlyArray<FontFamily>;
+/** 사용 가능 목록이 바뀌면 호출된다. 반환값을 부르면 구독이 해제된다. */
+export declare function subscribeFontAvailability(listener: () => void): () => void;
+/**
+ * 모든 글꼴의 CSS 를 1 회만 lazy 로드한다. 글꼴 드롭다운이 열릴 때 호출.
+ * 두 번째 이후 호출은 즉시 반환.
+ *
+ * 실패는 조용히 넘어가지 않는다 — 받지 못한 글꼴은 목록에서 빠진다.
+ */
+export declare function ensureFontFamiliesLoaded(): void;
+/**
+ * 임의의 CSS font-family 문자열에 대해 FONT_FAMILIES 중 가장 비슷한 항목을
+ * 찾아 id 를 반환. 매칭 실패 시 null. 활성 toolbar 표시에 사용.
+ *
+ * 비교는 stack 의 첫 family 토큰을 추출해 case-insensitive 비교.
+ */
+export declare function findFontIdFromCss(css: string | null | undefined): string | null;
+// (소스맵은 CJS 선언 사본에서 제외됨 — scripts/finalize-types.mjs)

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

@@ -0,0 +1,44 @@
+/**
+ * 가벼운 자체 syntax highlighter — 외부 의존성 없음.
+ *
+ * 단일 generic tokenizer 가 LanguageDef 의 룰(keywords / comments / strings /
+ * builtins) 을 받아 동작. 결과는 `<span class="hl-…">` 으로 wrap 된 HTML
+ * 문자열로 반환되며, AerizEditor 가 codeBlock 의 innerHTML 로 적용한다.
+ *
+ * 지원 언어: 15 종 — JavaScript / TypeScript / Python / JSON / HTML / CSS /
+ * Bash / SQL / Markdown / C / C++ / C# / Java / Kotlin / Go / Rust.
+ *
+ * 정확도 목표: 일반적인 코드 80% 케이스. 100% 정확한 파서가 아니므로 corner
+ * case (예: regex 리터럴 vs 나누기 연산자, 템플릿 문자열의 ${…} 내부 표현식)
+ * 는 단순화되어 있다.
+ */
+export interface LanguageDef {
+    /** 안정 식별자 — `data-language` 속성에 저장되는 값. */
+    id: string;
+    /** UI 드롭다운에 표시되는 라벨. */
+    label: string;
+    /** 키워드 집합. 이 단어로 매칭되면 hl-keyword 로 wrap. */
+    keywords: ReadonlySet<string>;
+    /** 빌트인 / 라이브러리 함수. hl-builtin. */
+    builtins?: ReadonlySet<string>;
+    /** 라인 주석 prefix (예: '//'). */
+    lineComment?: string;
+    /** 블록 주석. */
+    blockComment?: {
+        start: string;
+        end: string;
+    };
+    /** 문자열 구분자 목록. 일반적으로 ['"', "'"], JS 는 백틱 추가. */
+    stringDelims?: ReadonlyArray<string>;
+    /** 키워드 매칭 시 case-insensitive (SQL 용). */
+    caseInsensitiveKeywords?: boolean;
+    /** HTML / CSS 등 특수 처리가 필요한 언어. 자체 토크나이저 사용. */
+    custom?: (code: string) => string;
+}
+export declare const LANGUAGES: ReadonlyArray<LanguageDef>;
+/**
+ * 코드 문자열을 언어 식별자에 따라 highlight HTML 로 변환.
+ * 알 수 없는 언어 또는 'plaintext' 면 escape 만 적용.
+ */
+export declare function highlightCode(code: string, langId: string | undefined): string;
+// (소스맵은 CJS 선언 사본에서 제외됨 — scripts/finalize-types.mjs)

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

@@ -0,0 +1,86 @@
+/**
+ * 본문 편집 이력(undo / redo).
+ *
+ * ## 왜 브라우저 기본 undo 를 쓰지 않는가
+ *
+ * `document.execCommand('undo')` 는 브라우저가 **자기가 만든 변경**만 되돌린다.
+ * 이 에디터는 블록 이동 · 표 행/열 편집 · 이미지 리사이즈 · 블록 유형 변경을
+ * 전부 직접 DOM 조작으로 처리하는데, 그 조작들은 브라우저 undo 스택에 아예
+ * 올라가지 않는다. 결과적으로 Ctrl+Z 를 누르면 방금 옮긴 블록은 그대로 있고
+ * 그 전에 타이핑한 글자가 지워지는, 예측할 수 없는 동작이 된다.
+ *
+ * ## 무엇을 저장하는가
+ *
+ * 본문 HTML 전체와 캐럿 위치를 한 항목으로 저장하는 스냅샷 방식이다.
+ * 조작 단위 이력(operation log) 이 메모리는 덜 쓰지만, 되돌리기가 **정확히**
+ * 원래 화면으로 돌아간다는 보장을 얻기가 훨씬 어렵다. 스냅샷은 그 보장이
+ * 공짜다 — 문자열을 도로 넣기만 하면 된다.
+ *
+ * 캐럿은 문자 오프셋으로 저장한다. HTML 을 통째로 갈아끼우면 노드 참조는
+ * 전부 무효가 되지만, "본문 시작에서 몇 번째 글자" 는 그대로 살아남는다.
+ *
+ * ## 언제 한 항목으로 묶는가
+ *
+ * 글자 하나마다 항목을 쌓으면 되돌리기가 사실상 쓸모없어진다. 연속된 타이핑은
+ * {@link COALESCE_MS} 안에 이어지는 한 하나로 합친다. 반대로 블록 이동 ·
+ * 유형 변경처럼 **구조가 바뀌는 조작**은 합치지 않는다 — 그건 사용자가 한
+ * 번에 하나씩 되돌리길 기대하는 단위다.
+ */
+/** 이력 한 항목 — 그 순간의 본문 전체와 캐럿. */
+export interface HistoryEntry {
+    html: string;
+    /** 본문 시작 기준 캐럿 시작/끝 문자 오프셋. 셀렉션이 없으면 null. */
+    selection: {
+        start: number;
+        end: number;
+    } | null;
+}
+/**
+ * 이 시간 안에 이어지는 타이핑은 한 항목으로 합친다.
+ * 사람이 문장 하나를 치는 동안의 간격보다 짧게, 생각하고 다시 치기 시작하는
+ * 간격보다는 길게 잡은 값이다.
+ */
+export declare const COALESCE_MS = 600;
+/** 스택에 쌓아 두는 최대 항목 수. 넘치면 가장 오래된 것부터 버린다. */
+export declare const HISTORY_LIMIT = 200;
+/**
+ * 이 길이를 넘게 한 번에 바뀌면 타이핑으로 보지 않는다.
+ *
+ * 붙여넣기는 `input` 이벤트로 들어와 타이핑과 구분되지 않는다. 그대로 두면
+ * "글 좀 쓰다가 붙여넣기" 가 한 항목으로 묶여, 붙여넣기를 되돌리려다 앞서
+ * 쓴 글까지 함께 사라진다. 사람이 600ms 안에 칠 수 있는 양보다 넉넉히 크게
+ * 잡아, 실제 타이핑이 여기 걸리지 않도록 한다.
+ */
+export declare const BULK_CHANGE_CHARS = 64;
+/** 변경의 성격 — 합쳐도 되는 타이핑인지, 한 단위로 남아야 하는 조작인지. */
+export type ChangeKind = 'typing' | 'structural';
+export declare class History {
+    private readonly past;
+    private readonly future;
+    /** 지금 화면에 보이는 상태. past 의 마지막이 아니라 이 값이 현재다. */
+    private present;
+    /** 마지막으로 항목을 쌓은 시각과 성격 — 합침 판단에 쓴다. */
+    private lastPushAt;
+    private lastKind;
+    constructor(initial: HistoryEntry);
+    get canUndo(): boolean;
+    get canRedo(): boolean;
+    /**
+     * 새 상태를 기록한다.
+     *
+     * @param now 현재 시각(ms). 테스트가 시간을 직접 넣을 수 있도록 인자로 받는다.
+     */
+    record(entry: HistoryEntry, kind: ChangeKind, now: number): void;
+    /** 되돌린다. 되돌릴 것이 없으면 null. */
+    undo(): HistoryEntry | null;
+    /** 다시 실행한다. 없으면 null. */
+    redo(): HistoryEntry | null;
+    /** 현재 상태. 외부에서 비교용으로 읽는다. */
+    current(): HistoryEntry;
+    /**
+     * 이력을 비우고 주어진 상태에서 다시 시작한다.
+     * `setHTML()` 처럼 문서를 통째로 갈아끼우는 프로그램적 변경에 쓴다.
+     */
+    reset(entry: HistoryEntry): void;
+}
+// (소스맵은 CJS 선언 사본에서 제외됨 — scripts/finalize-types.mjs)

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

@@ -0,0 +1,65 @@
+/**
+ * DOM 없이 동작하는 최소 HTML 파서.
+ *
+ * `blocksToMarkdown` / `blocksToPlainText` 가 `snapshot.html` 의 인라인
+ * 컨텐츠를 해석하기 위해 쓴다. `document` 를 쓸 수 없는 런타임(workerd, Node,
+ * Deno) 에서 돌아야 하므로 브라우저 파서를 쓸 수 없다.
+ *
+ * 범위를 의도적으로 좁게 잡았다 — 에디터가 만든 인라인 마크업과, HTML 가져오기
+ * 로 들어온 정도의 일반적인 마크업을 다루는 것이 목표이며, 브라우저 HTML5
+ * 파싱 알고리즘의 완전한 재현은 목표가 아니다. 아래 두 가지만 보장한다.
+ *
+ * 1. 어떤 입력에도 예외를 던지지 않는다 (깨진 마크업은 최선 해석 후 통과).
+ * 2. `<script>` / `<style>` 의 내용은 결과 트리에 남기지 않는다.
+ */
+export interface HtmlText {
+    type: 'text';
+    value: string;
+}
+export interface HtmlElementNode {
+    type: 'element';
+    /** 소문자 태그명. */
+    tag: string;
+    /** 소문자 속성명 → 값. 엔티티가 해제된 상태. */
+    attrs: Readonly<Record<string, string>>;
+    children: HtmlNode[];
+}
+export type HtmlNode = HtmlText | HtmlElementNode;
+/** HTML 엔티티를 문자로 되돌린다. 해석할 수 없는 참조는 원문 유지. */
+export declare function decodeEntities(input: string): string;
+/** 텍스트를 HTML 본문에 넣을 수 있게 이스케이프한다. */
+export declare function escapeHtml(input: string): string;
+/** 텍스트를 큰따옴표 속성값으로 넣을 수 있게 이스케이프한다. */
+export declare function escapeAttr(input: string): string;
+/**
+ * HTML 조각을 노드 트리로 파싱한다.
+ *
+ * 텍스트 노드의 값은 엔티티가 해제된 상태로 들어온다.
+ */
+export declare function parseHtmlFragment(html: string): HtmlNode[];
+/** 노드 트리를 HTML 문자열로 되돌린다. 파싱 → 직렬화는 정규화 역할을 한다. */
+export declare function serializeNodes(nodes: readonly HtmlNode[]): string;
+/**
+ * 노드 트리의 텍스트만 이어붙인다. `<br>` 은 개행으로 바꾼다.
+ *
+ * 블록 경계는 무시한다 — 코드 블록처럼 원문 그대로가 필요한 곳에서 쓴다.
+ * 사람이 읽는 텍스트를 뽑을 때는 {@link textWithBlockBreaks} 를 쓸 것.
+ */
+export declare function textOf(nodes: readonly HtmlNode[]): string;
+/**
+ * 텍스트를 뽑되 블록 경계에 개행을 넣는다.
+ *
+ * `textOf` 만으로는 `<p>첫 문장</p><p>둘째 문장</p>` 이
+ * `"첫 문장둘째 문장"` 이 되어 버린다. 전문 검색 색인에 그대로 들어가면 두
+ * 단어가 한 토큰으로 붙어 어느 쪽으로도 검색되지 않고, 미리보기 스니펫도
+ * 문장이 뭉개진 채 나온다.
+ */
+export declare function textWithBlockBreaks(nodes: readonly HtmlNode[]): string;
+/** 트리에서 주어진 태그의 직계 자식들만 모은다. */
+export declare function childElements(nodes: readonly HtmlNode[], tag: string): HtmlElementNode[];
+/**
+ * 트리를 깊이 우선으로 훑어 주어진 태그의 첫 노드를 찾는다.
+ * 없으면 `null`.
+ */
+export declare function findElement(nodes: readonly HtmlNode[], tag: string): HtmlElementNode | null;
+// (소스맵은 CJS 선언 사본에서 제외됨 — scripts/finalize-types.mjs)

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

@@ -0,0 +1,221 @@
+/**
+ * 다국어 (i18n) 문자열 사전 — UI 정적 라벨, tooltip, 다이얼로그 제목/필드,
+ * 블록 라벨, 팝오버 항목 등.
+ *
+ * 4 개 로케일: 영어 / 한국어 / 일본어 / 중국어(간체).
+ *
+ * 사용 모델 — 모듈 레벨 "current locale" 을 두고 `t()` accessor 로 어디서든
+ * 같은 사전을 참조한다. `AerizEditor` 가 옵션에 따라 시작 시 setLocale() 1 회.
+ */
+export type Locale = 'en' | 'ko' | 'ja' | 'zh';
+export interface Strings {
+    toolbar: {
+        /** 툴바 컨테이너의 aria-label. */
+        ariaLabel: string;
+        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;
+        taskList: string;
+        blockquote: string;
+        codeBlock: string;
+        image: string;
+        table: string;
+        hr: string;
+        linkCard: string;
+        youtube: string;
+        file: string;
+        importedHtml: string;
+        unknown: string;
+    };
+    blockMenu: {
+        body: string;
+        taskList: 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;
+        /** 캡션 버튼 tooltip. */
+        captionAdd: string;
+        /** 빈 캡션에 흐리게 뜨는 안내. */
+        captionPlaceholder: 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;
+    };
+    content: {
+        /** 캐럿이 놓인 빈 본문 블록에 흐릿하게 뜨는 안내. */
+        emptyHint: 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,40 @@
+/**
+ * 외부 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 declare function isBlockLevelTag(tagName: string): boolean;
+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,33 @@
+/**
+ * 가벼운 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>`
+ */
+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/input-rules.d.cts

@@ -0,0 +1,46 @@
+/**
+ * 키보드와 타이핑을 블록 유형으로 옮기는 표.
+ *
+ * 블록 유형을 고르는 길은 둘이다 — 메뉴에서 고르거나, 쓰던 흐름 그대로
+ * 신호를 주거나. 후자가 여기다. 두 갈래를 한 파일에 두는 이유는 둘이 같은
+ * 목적지(BlockKind) 를 가리키기 때문이고, 한쪽만 고치면 곧바로 어긋난다.
+ *
+ * 문법은 마크다운 가져오기(`import-markdown.ts`) 와 같은 것을 쓴다. 한쪽에서
+ * 되는 표기가 다른 쪽에서 안 되면 사용자가 규칙을 두 벌 외워야 한다.
+ */
+import type { BlockAttrs, BlockKind } from './blocks.cjs';
+/** 블록 유형을 가리키는 목적지. */
+export interface BlockTarget {
+    kind: BlockKind;
+    attrs?: BlockAttrs;
+}
+/**
+ * `Ctrl/Cmd + Alt + 키` → 바꿀 블록 유형.
+ *
+ * 숫자는 제목 레벨과 그대로 맞춘다(1 → 제목 1). 0 이 본문인 것도 같은 이유다
+ * — "제목 아님" 자리다. 목록·인용구는 툴바 툴팁이 예전부터 광고해 온 7/8/9
+ * 자리를 그대로 쓴다.
+ *
+ * `Ctrl + 숫자` 가 아니라 `Ctrl + Alt + 숫자` 인 이유는 브라우저의 탭 전환
+ * 단축키와 겹치지 않기 위해서다.
+ */
+export declare const BLOCK_SHORTCUTS: Readonly<Record<string, BlockTarget>>;
+/**
+ * 블록 첫 글자들이 마크다운 방아쇠인지 본다. 아니면 null.
+ *
+ * 방아쇠는 **본문 블록의 맨 앞**에서만 인식한다 (호출자 책임). 이미 쓴 문단
+ * 중간에서 "- " 를 고치다가 블록이 통째로 바뀌면 사고다.
+ */
+export declare function matchInputRule(text: string): BlockTarget | null;
+/**
+ * 목록 **항목 안**에서 체크박스 표기를 알아본다. 완료 여부를 함께 돌려준다.
+ *
+ * `- [ ] ` 를 통째로 방아쇠로 삼을 수는 없다 — 앞의 `- ` 에서 이미 글머리
+ * 목록으로 바뀌기 때문에 뒤 절반은 영영 도달하지 않는다. 그래서 "글머리
+ * 목록 항목 맨 앞의 `[ ] `" 를 따로 본다. 사용자가 치는 순서(`- ` → `[ ] `)
+ * 를 그대로 따라가는 셈이고, 결과도 기대한 것과 같다.
+ */
+export declare function matchTaskItemRule(text: string): {
+    checked: boolean;
+} | null;
+// (소스맵은 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)