mdsquare 0.0.0-stage → 0.2.0

package/dist/editor.js

@@ -0,0 +1,225 @@
+import { LanguageDescription } from "@codemirror/language";
+import { languages as languageData } from "@codemirror/language-data";
+import { Compartment, EditorState } from "@codemirror/state";
+import { EditorView, placeholder as placeholderExtension } from "@codemirror/view";
+import { callout } from "./callout.js";
+import { codeBlock } from "./codeBlock.js";
+import { emphasis } from "./emphasis.js";
+import { escape } from "./escape.js";
+import { extendedMarkdown } from "./extensions.js";
+import { footnote } from "./footnote.js";
+import { hashtag } from "./hashtag.js";
+import { heading } from "./heading.js";
+import { horizontalRule } from "./horizontalRule.js";
+import { image } from "./image.js";
+import { inlineCode } from "./inlineCode.js";
+import { link } from "./link.js";
+import { list } from "./list.js";
+import { listIndent } from "./listIndent.js";
+import { markVision } from "./markVision.js";
+import { math } from "./math.js";
+import { mention } from "./mention.js";
+import { quote } from "./quote.js";
+import { basicSetup } from "./setup.js";
+import { table } from "./table.js";
+import { task } from "./task.js";
+import { tikz, tikzjaxRenderer } from "./tikz.js";
+// ---------------------------------------------------------------------------
+// 테마
+// ---------------------------------------------------------------------------
+const lightTheme = EditorView.theme({
+    "&": { color: "#1f2328", backgroundColor: "#ffffff" },
+    ".cm-content": { caretColor: "#1f2328" },
+    ".cm-cursor, .cm-dropCursor": { borderLeftColor: "#1f2328" },
+    "&.cm-focused > .cm-scroller > .cm-selectionLayer .cm-selectionBackground, .cm-selectionBackground, .cm-content ::selection": { backgroundColor: "#cfe3ff" },
+    ".cm-gutters": { backgroundColor: "#ffffff", color: "#8c959f", border: "none" },
+    ".cm-activeLineGutter": { backgroundColor: "#f3f4f6" },
+}, { dark: false });
+const darkTheme = EditorView.theme({
+    "&": { color: "#d4d4d4", backgroundColor: "#1e1e1e" },
+    ".cm-content": { caretColor: "#e5e5e5" },
+    ".cm-cursor, .cm-dropCursor": { borderLeftColor: "#e5e5e5" },
+    "&.cm-focused > .cm-scroller > .cm-selectionLayer .cm-selectionBackground, .cm-selectionBackground, .cm-content ::selection": { backgroundColor: "#264f78" },
+    ".cm-gutters": { backgroundColor: "#1e1e1e", color: "#6e7681", border: "none" },
+    ".cm-activeLineGutter": { backgroundColor: "#2a2d2e" },
+    ".cm-panels": { backgroundColor: "#252526", color: "#d4d4d4" },
+}, { dark: true });
+const darkQuery = "(prefers-color-scheme: dark)";
+const prefersDark = () => typeof matchMedia === "function" && matchMedia(darkQuery).matches;
+// ---------------------------------------------------------------------------
+// 에디터
+// ---------------------------------------------------------------------------
+/** codeBlock 옵션의 기본 언어: language-data (쓸 때 불러옴). tikz 블록은 LaTeX로 강조 */
+const defaultLanguages = (lang) => LanguageDescription.matchLanguageName(languageData, lang === "tikz" ? "latex" : lang, true);
+/**
+ * 하이브리드 마크다운 에디터 (CodeMirror 6 기반).
+ *
+ * ```ts
+ * import MDSquareEditor from "mdsquare";
+ * import "mdsquare/style.css";
+ *
+ * const editor = new MDSquareEditor({ parent: document.getElementById("editor")!, value: "# 안녕하세요" });
+ * editor.getValue();
+ * ```
+ */
+export class MDSquareEditor {
+    /** CodeMirror 뷰 (확장을 직접 다룰 때) */
+    view;
+    themeSlot = new Compartment();
+    readOnlySlot = new Compartment();
+    theme;
+    media = null;
+    onMediaChange = () => this.applyTheme();
+    /** 옵션으로 정해지는 확장들. 파일을 새로 열 때도 같은 것을 써서 렌더링 캐시(수식, TikZ 등)를 이어 씁니다. */
+    extensions;
+    readOnly;
+    constructor(options = {}) {
+        this.theme = options.theme ?? "auto";
+        this.readOnly = options.readOnly ?? false;
+        const onChange = options.onChange;
+        this.extensions = [
+            basicSetup({ lineNumbers: options.lineNumbers ?? false }),
+            EditorView.lineWrapping,
+            options.placeholder ? placeholderExtension(options.placeholder) : [],
+            markdownExtensions(options),
+            onChange
+                ? EditorView.updateListener.of((update) => {
+                    if (update.docChanged)
+                        onChange(update.state.doc.toString(), this);
+                })
+                : [],
+            options.extensions ?? [],
+        ];
+        this.view = new EditorView({ state: this.createState(options.value ?? ""), parent: options.parent });
+        this.watchSystemTheme();
+    }
+    /** 지금 설정(테마, 읽기 전용)으로 새 상태를 만듭니다. */
+    createState(doc) {
+        return EditorState.create({
+            doc,
+            extensions: [
+                this.themeSlot.of(this.themeExtension()),
+                this.readOnlySlot.of(readOnlyExtension(this.readOnly)),
+                this.extensions,
+            ],
+        });
+    }
+    /** 에디터 바깥 요소 (`.cm-editor`) */
+    get dom() {
+        return this.view.dom;
+    }
+    /** 지금 문서 (마크다운) */
+    getValue() {
+        return this.view.state.doc.toString();
+    }
+    /**
+     * 다른 파일(문서)을 엽니다. 처음 연 것처럼 새로 시작합니다.
+     * - 실행 취소 기록을 새로 시작합니다. (Ctrl+Z로 이전 파일 내용으로 돌아가지 않음)
+     * - onChange를 부르지 않습니다. (방금 연 파일을 바로 저장하지 않음)
+     * - 커서는 문서 처음, 스크롤은 맨 위. 접기·열린 메뉴 등 화면 상태도 초기화합니다.
+     * - 테마, 읽기 전용 등 설정은 그대로입니다.
+     *
+     * 같은 문서 안에서 내용을 바꾸는 것(실행 취소할 수 있어야 하는 편집)은 setValue를 쓰세요.
+     */
+    open(value) {
+        this.view.setState(this.createState(value));
+        this.view.scrollDOM.scrollTop = 0;
+        this.view.scrollDOM.scrollLeft = 0;
+    }
+    /**
+     * 지금 문서의 내용을 바꿉니다. 편집처럼 다뤄 실행 취소할 수 있고 onChange도 호출됩니다. 커서는 문서 처음으로.
+     * 다른 파일을 여는 것이라면 open을 쓰세요.
+     */
+    setValue(value) {
+        this.view.dispatch({
+            changes: { from: 0, to: this.view.state.doc.length, insert: value },
+            selection: { anchor: 0 },
+        });
+    }
+    focus() {
+        this.view.focus();
+    }
+    /** 테마 바꾸기 ("auto": 시스템 설정을 따르고, 설정이 바뀌면 함께 바뀜) */
+    setTheme(theme) {
+        this.theme = theme;
+        this.watchSystemTheme();
+        this.applyTheme();
+    }
+    setReadOnly(readOnly) {
+        this.readOnly = readOnly;
+        this.view.dispatch({ effects: this.readOnlySlot.reconfigure(readOnlyExtension(readOnly)) });
+    }
+    /** 에디터를 없애고 이벤트를 정리합니다. */
+    destroy() {
+        this.media?.removeEventListener("change", this.onMediaChange);
+        this.media = null;
+        this.view.destroy();
+    }
+    themeExtension() {
+        const dark = this.theme === "dark" || (this.theme === "auto" && prefersDark());
+        return dark ? darkTheme : lightTheme;
+    }
+    applyTheme() {
+        this.view.dispatch({ effects: this.themeSlot.reconfigure(this.themeExtension()) });
+    }
+    watchSystemTheme() {
+        const wanted = this.theme === "auto" && typeof matchMedia === "function";
+        if (wanted && !this.media) {
+            this.media = matchMedia(darkQuery);
+            this.media.addEventListener("change", this.onMediaChange);
+        }
+        else if (!wanted && this.media) {
+            this.media.removeEventListener("change", this.onMediaChange);
+            this.media = null;
+        }
+    }
+}
+function readOnlyExtension(readOnly) {
+    return [EditorState.readOnly.of(readOnly), EditorView.editable.of(!readOnly)];
+}
+/** 옵션에 따라 마크다운 확장들을 고릅니다. */
+export function markdownExtensions(options = {}) {
+    const on = (name) => options.features?.[name] ?? true;
+    const out = [extendedMarkdown(options.markdown), markVision()];
+    if (on("emphasis"))
+        out.push(emphasis());
+    if (on("heading"))
+        out.push(heading());
+    if (on("hashtag"))
+        out.push(hashtag());
+    if (on("escape"))
+        out.push(escape());
+    if (on("inlineCode"))
+        out.push(inlineCode());
+    if (on("mention"))
+        out.push(mention());
+    if (on("list"))
+        out.push(list(), listIndent());
+    if (on("task"))
+        out.push(task());
+    if (on("link"))
+        out.push(link(options.link));
+    if (on("image"))
+        out.push(image(options.image));
+    if (on("horizontalRule"))
+        out.push(horizontalRule());
+    if (on("footnote"))
+        out.push(footnote());
+    // callout()은 quote()를 포함합니다.
+    if (on("callout"))
+        out.push(callout());
+    else if (on("quote"))
+        out.push(quote());
+    if (on("codeBlock"))
+        out.push(codeBlock({ languages: defaultLanguages, ...options.codeBlock }));
+    if (on("math"))
+        out.push(math(options.math));
+    if (on("table"))
+        out.push(table());
+    if (options.tikz) {
+        const { tikzjax, render, ...rest } = options.tikz;
+        out.push(tikz({ ...rest, render: render ?? tikzjaxRenderer(tikzjax) }));
+    }
+    return out;
+}
+export default MDSquareEditor;

package/dist/emphasis.d.ts

@@ -0,0 +1,6 @@
+import type { Extension } from "@codemirror/state";
+export declare const emphasisPlugin: import("@codemirror/view").ViewPlugin<import("./extensions.js").RevealPluginValue, undefined>;
+/**
+ * 강조 문법(*, **, ~~, ==, --)의 기호를 커서가 해당 문법에 닿아 있을 때만 보여주는 확장입니다.
+ */
+export declare function emphasis(): Extension;

package/dist/emphasis.js

@@ -0,0 +1,101 @@
+import { Decoration, EditorView } from "@codemirror/view";
+import { createRevealPlugin } from "./utils/reveal.js";
+// 데코레이션 객체는 모듈 로드 시 한 번만 만들고 재사용합니다.
+function defineConstruct(className, mark) {
+    return {
+        mark,
+        content: Decoration.mark({ class: `cm-${className}` }),
+        formatting: Decoration.mark({
+            class: `cm-formatting cm-formatting-${className} cm-${className}`,
+        }),
+    };
+}
+const CONSTRUCTS = new Map([
+    ["Emphasis", defineConstruct("emphasis", "EmphasisMark")], // *, _
+    ["StrongEmphasis", defineConstruct("strong-emphasis", "EmphasisMark")], // **, __
+    ["Strikethrough", defineConstruct("strikethrough", "StrikethroughMark")], // ~~
+    ["Highlight", defineConstruct("highlight", "HighlightMark")], // ==
+    ["Underline", defineConstruct("underline", "UnderlineMark")], // --
+]);
+/** 내부에 강조 문법이 올 수 없으므로 자식 순회를 생략하는 노드 */
+const SKIP_CHILDREN = new Set(["FencedCode", "CodeBlock", "InlineCode"]);
+const hiddenMark = Decoration.replace({});
+export const emphasisPlugin = createRevealPlugin({
+    // 내용 데코레이션은 leave에서 추가되어 순서가 섞이므로 정렬합니다.
+    sort: true,
+    visit({ decorations, isRevealed }) {
+        const stack = [];
+        return {
+            enter(node) {
+                const spec = CONSTRUCTS.get(node.name);
+                if (spec) {
+                    stack.push({
+                        spec,
+                        from: node.from,
+                        to: node.to,
+                        revealed: isRevealed(node.from, node.to),
+                        contentFrom: node.from,
+                        contentTo: node.to,
+                    });
+                    return;
+                }
+                const frame = stack[stack.length - 1];
+                if (frame && node.name === frame.spec.mark) {
+                    // 기호 위치는 트리의 Mark 노드에서 그대로 가져옵니다.
+                    if (node.from === frame.from)
+                        frame.contentFrom = node.to;
+                    if (node.to === frame.to)
+                        frame.contentTo = node.from;
+                    decorations.push((frame.revealed ? frame.spec.formatting : hiddenMark).range(node.from, node.to));
+                    return;
+                }
+                if (SKIP_CHILDREN.has(node.name))
+                    return false;
+            },
+            leave(node) {
+                if (!CONSTRUCTS.has(node.name))
+                    return;
+                const frame = stack.pop();
+                if (frame.contentFrom < frame.contentTo) {
+                    decorations.push(frame.spec.content.range(frame.contentFrom, frame.contentTo));
+                }
+            },
+        };
+    },
+});
+// ---------------------------------------------------------------------------
+// 테마
+// ---------------------------------------------------------------------------
+const highlightTheme = EditorView.baseTheme({
+    ".cm-highlight": {
+        backgroundColor: "rgba(255, 177, 80, 0.3)",
+    },
+    ".cm-highlight:has(+ .cm-formatting-highlight)": {
+        padding: "1px 0",
+    },
+    ".cm-highlight:not(.cm-formatting-highlight):not(:has(+ .cm-formatting-highlight))": {
+        borderRadius: "2px",
+        padding: "1px 4px",
+    },
+    ".cm-formatting-highlight:has(+ .cm-highlight)": {
+        borderTopLeftRadius: "2px",
+        borderBottomLeftRadius: "2px",
+        padding: "1px 0 1px 4px",
+    },
+    ".cm-highlight + .cm-formatting-highlight": {
+        borderTopRightRadius: "2px",
+        borderBottomRightRadius: "2px",
+        padding: "1px 4px 1px 0",
+    },
+});
+const underlineTheme = EditorView.baseTheme({
+    ".cm-underline": {
+        textDecoration: "underline",
+    },
+});
+/**
+ * 강조 문법(*, **, ~~, ==, --)의 기호를 커서가 해당 문법에 닿아 있을 때만 보여주는 확장입니다.
+ */
+export function emphasis() {
+    return [emphasisPlugin, highlightTheme, underlineTheme];
+}

package/dist/escape.d.ts

@@ -0,0 +1,4 @@
+import type { Extension } from "@codemirror/state";
+export declare const escapePlugin: import("@codemirror/view").ViewPlugin<import("./extensions.js").RevealPluginValue, undefined>;
+/** 이스케이프(`\*`)의 `\`를 커서가 닿아 있을 때만 보여주는 확장입니다. */
+export declare function escape(): Extension;

package/dist/escape.js

@@ -0,0 +1,39 @@
+import { Decoration } from "@codemirror/view";
+import { createRevealPlugin } from "./utils/reveal.js";
+// 데코레이션 객체는 모듈 로드 시 한 번만 만들고 재사용합니다.
+const hiddenBackslash = Decoration.replace({});
+const revealedBackslash = Decoration.mark({
+    class: "cm-formatting cm-formatting-escape cm-escape",
+});
+/** 이스케이프가 올 수 없으므로 자식 순회를 생략하는 노드 */
+const SKIP_CHILDREN = new Set([
+    "FencedCode",
+    "CodeBlock",
+    "InlineCode",
+    "HTMLBlock",
+    "CommentBlock",
+    "URL",
+    "Autolink",
+]);
+export const escapePlugin = createRevealPlugin({
+    // 이스케이프는 서로 겹치지 않고 문서 순서대로 추가되므로 정렬이 필요 없습니다.
+    visit({ decorations, isRevealed }) {
+        return {
+            enter(node) {
+                if (node.name === "Escape") {
+                    // Lezer의 Escape 노드는 항상 `\` + ASCII 구두점 2글자입니다.
+                    // (`\` + 줄바꿈은 HardBreak이므로 줄바꿈을 숨기는 일은 없습니다.)
+                    const revealed = isRevealed(node.from, node.to);
+                    decorations.push((revealed ? revealedBackslash : hiddenBackslash).range(node.from, node.from + 1));
+                    return false;
+                }
+                if (SKIP_CHILDREN.has(node.name))
+                    return false;
+            },
+        };
+    },
+});
+/** 이스케이프(`\*`)의 `\`를 커서가 닿아 있을 때만 보여주는 확장입니다. */
+export function escape() {
+    return escapePlugin;
+}

package/dist/extensions.d.ts

@@ -0,0 +1,74 @@
+import { markdown } from "@codemirror/lang-markdown";
+import { type Extension } from "@codemirror/state";
+import type { MarkdownConfig, MarkdownExtension } from "@lezer/markdown";
+import { Highlight, markTag } from "./highlight.js";
+import { Underline, underlineTag } from "./underline.js";
+import { Hashtag, hashtagTag } from "./hashtagSyntax.js";
+import { Mention, mentionTag } from "./mentionSyntax.js";
+import { Footnote } from "./footnoteSyntax.js";
+import { MathSyntax } from "./mathSyntax.js";
+import { TableSyntax } from "./tableModel.js";
+export { Highlight, markTag, Underline, underlineTag, Hashtag, hashtagTag, Mention, mentionTag, Footnote, MathSyntax, TableSyntax, };
+export { basicSetup, type BasicSetupOptions } from "./setup.js";
+export { parseHashtag, type HashtagInfo } from "./hashtagSyntax.js";
+export { doubleDelimiterSyntax, type DoubleDelimiterSpec } from "./delimiter.js";
+export { MarkVisionPlugin, markVisionPlugin, markVision, activeLineClass, } from "./markVision.js";
+export { emphasis, emphasisPlugin } from "./emphasis.js";
+export { heading, headingPlugin } from "./heading.js";
+export { hashtag, hashtagPlugin } from "./hashtag.js";
+export { escape, escapePlugin } from "./escape.js";
+export { inlineCode, inlineCodePlugin } from "./inlineCode.js";
+export { mention, mentionPlugin } from "./mention.js";
+export { listIndent, listKeymap, indentListItem, outdentListItem } from "./listIndent.js";
+export { endListWithBlankLine } from "./listEnter.js";
+export { list, listPlugin, taskMarkersHandled } from "./list.js";
+export { task, taskPlugin, toggleTask } from "./task.js";
+export { isSafeUrl, link, linkPlugin, openLinkSafely, readInlineLink, type InlineLink, type LinkOptions, } from "./link.js";
+export { image, parseImageAlt, readImage, type ImageAlign, type ImageAltOptions, type ImageInfo, type ImageOptions, } from "./image.js";
+export { horizontalRule, horizontalRuleField } from "./horizontalRule.js";
+export { quote, quotePlugin } from "./quote.js";
+export { math, readMath, type MathInfo, type MathOptions } from "./math.js";
+export { parseTikz, sanitizeSvg, tikz, tikzjaxRenderer, type TikzDocument, type TikzJaxOptions, type TikzOptions, type TikzRenderer, } from "./tikz.js";
+export { table, tablesHandled, cellAt, insertTableRow, nextTableCell, previousTableCell, } from "./table.js";
+export { editTableColumn, editTableRow, moveTableColumn, moveTableRow, setCellColor, clearCells, type TableColumnAction, type TableRowAction, } from "./tableEdit.js";
+export { tablesField, tableBlockAt, setTableSelection, tableSelectionField, selectedCells, type TableCellRange, type TableSelection, } from "./tableState.js";
+export { readTableRow, readTableRows, scanTables, setTableOption, setTableColor, TABLE_COLORS, setColumnAlign, delimiterCells, DEFAULT_TABLE_OPTIONS, type TableAlign, type TableAxis, type TableBlock, type TableColor, type TableColorName, type TableColorPair, type TableColors, type TableCellInfo, type CellMarker, type TableComment, type TableOptions, type TableRowInfo, } from "./tableModel.js";
+export { callout, calloutPlugin } from "./callout.js";
+export { codeBlock, languageLabel, readFencedCode, renderedCodeLanguages, type CodeBlockOptions, type CodeLanguages, type FencedCodeInfo, } from "./codeBlock.js";
+export { defaultCodeTheme, vscodeTheme, type CodeTheme, type VSCodeThemeJson, type VSCodeThemeOptions, } from "./codeTheme.js";
+export { parseJsonc, textMateTheme, type TextMateTheme, type TokenColorRule, type TokenStyle } from "./textMate.js";
+export { calloutsHandled, defaultCalloutTitle, readCalloutHeader, type CalloutHeader, type CalloutType, } from "./calloutHeader.js";
+export { footnote, footnotePlugin, footnoteDefinitions, footnoteTooltipAt, renderFootnoteDefinition, type FootnoteDefinitionInfo, } from "./footnote.js";
+export { createRevealField, createRevealPlugin, RevealPluginValue, type RevealContext, type RevealFieldSpec, type RevealFieldValue, type RevealPluginSpec, } from "./utils/reveal.js";
+/** 이 플러그인이 제공하는 Lezer Markdown 문법 확장 목록 */
+export declare const extendedMarkdownSyntax: MarkdownExtension[];
+export interface ExtendedMarkdownOptions {
+    /** `markdown()`에 전달할 추가 옵션 (codeLanguages 등) */
+    markdownConfig?: Parameters<typeof markdown>[0];
+    /**
+     * 목록의 두 번째 항목이 비어 있을 때 Enter를 누르면, 목록을 끝내는 대신
+     * 빈 줄을 넣어 느슨한(loose) 목록으로 바꾸는 lang-markdown 기본 동작을 사용할지 여부.
+     * 기본값 false: 다른 항목과 마찬가지로 빈 항목에서 Enter를 누르면 목록을 끝내거나 한 단계 내어씁니다.
+     */
+    nonTightLists?: boolean;
+    /**
+     * 가장 바깥 목록의 마지막 빈 항목에서 Enter를 누르면 목록을 끝내고 빈 줄을 넣어
+     * 다음 글이 새 문단이 되게 합니다. (기본값 true)
+     * false이면 빈 줄 없이 목록 기호만 지웁니다. 이 경우 다음 줄은 마크다운 규칙상
+     * 바로 위 항목의 이어지는 줄이 됩니다.
+     */
+    blankLineAfterList?: boolean;
+    /**
+     * Setext 제목(`제목` 다음 줄의 `===`, `---`)을 쓸지 여부. 기본값 false (쓰지 않음).
+     * 끄면 `===` 줄은 그냥 글이고, 문단 바로 아래의 `---`는 수평선입니다.
+     * (`---`가 의도와 달리 윗줄을 제목으로 만드는 일을 막습니다. 제목은 `#`를 씁니다)
+     */
+    setextHeadings?: boolean;
+}
+/** Setext 제목(`===`, `---` 밑줄)을 끄는 문법 설정 */
+export declare const NoSetextHeading: MarkdownConfig;
+/**
+ * 확장 마크다운 문법(파서)을 활성화하는 CodeMirror 확장입니다.
+ * 시각 스타일(하이라이트 배경, 기호 숨김 등)은 `emphasis()`가 담당합니다.
+ */
+export declare function extendedMarkdown(options?: ExtendedMarkdownOptions): Extension;

package/dist/extensions.js

@@ -0,0 +1,81 @@
+import { deleteMarkupBackward, insertNewlineContinueMarkupCommand, markdown, markdownLanguage, } from "@codemirror/lang-markdown";
+import { Prec } from "@codemirror/state";
+import { keymap } from "@codemirror/view";
+import { Highlight, markTag } from "./highlight.js";
+import { Underline, underlineTag } from "./underline.js";
+import { Hashtag, hashtagTag } from "./hashtagSyntax.js";
+import { Mention, mentionTag } from "./mentionSyntax.js";
+import { Footnote } from "./footnoteSyntax.js";
+import { MathSyntax } from "./mathSyntax.js";
+import { TableSyntax } from "./tableModel.js";
+import { endListWithBlankLine } from "./listEnter.js";
+export { Highlight, markTag, Underline, underlineTag, Hashtag, hashtagTag, Mention, mentionTag, Footnote, MathSyntax, TableSyntax, };
+export { basicSetup } from "./setup.js";
+export { parseHashtag } from "./hashtagSyntax.js";
+export { doubleDelimiterSyntax } from "./delimiter.js";
+export { MarkVisionPlugin, markVisionPlugin, markVision, activeLineClass, } from "./markVision.js";
+export { emphasis, emphasisPlugin } from "./emphasis.js";
+export { heading, headingPlugin } from "./heading.js";
+export { hashtag, hashtagPlugin } from "./hashtag.js";
+export { escape, escapePlugin } from "./escape.js";
+export { inlineCode, inlineCodePlugin } from "./inlineCode.js";
+export { mention, mentionPlugin } from "./mention.js";
+export { listIndent, listKeymap, indentListItem, outdentListItem } from "./listIndent.js";
+export { endListWithBlankLine } from "./listEnter.js";
+export { list, listPlugin, taskMarkersHandled } from "./list.js";
+export { task, taskPlugin, toggleTask } from "./task.js";
+export { isSafeUrl, link, linkPlugin, openLinkSafely, readInlineLink, } from "./link.js";
+export { image, parseImageAlt, readImage, } from "./image.js";
+export { horizontalRule, horizontalRuleField } from "./horizontalRule.js";
+export { quote, quotePlugin } from "./quote.js";
+export { math, readMath } from "./math.js";
+export { parseTikz, sanitizeSvg, tikz, tikzjaxRenderer, } from "./tikz.js";
+export { table, tablesHandled, cellAt, insertTableRow, nextTableCell, previousTableCell, } from "./table.js";
+export { editTableColumn, editTableRow, moveTableColumn, moveTableRow, setCellColor, clearCells, } from "./tableEdit.js";
+export { tablesField, tableBlockAt, setTableSelection, tableSelectionField, selectedCells, } from "./tableState.js";
+export { readTableRow, readTableRows, scanTables, setTableOption, setTableColor, TABLE_COLORS, setColumnAlign, delimiterCells, DEFAULT_TABLE_OPTIONS, } from "./tableModel.js";
+export { callout, calloutPlugin } from "./callout.js";
+export { codeBlock, languageLabel, readFencedCode, renderedCodeLanguages, } from "./codeBlock.js";
+export { defaultCodeTheme, vscodeTheme, } from "./codeTheme.js";
+export { parseJsonc, textMateTheme } from "./textMate.js";
+export { calloutsHandled, defaultCalloutTitle, readCalloutHeader, } from "./calloutHeader.js";
+export { footnote, footnotePlugin, footnoteDefinitions, footnoteTooltipAt, renderFootnoteDefinition, } from "./footnote.js";
+export { createRevealField, createRevealPlugin, RevealPluginValue, } from "./utils/reveal.js";
+/** 이 플러그인이 제공하는 Lezer Markdown 문법 확장 목록 */
+export const extendedMarkdownSyntax = [
+    Highlight,
+    Underline,
+    Hashtag,
+    Mention,
+    Footnote,
+    MathSyntax,
+    TableSyntax,
+];
+/** Setext 제목(`===`, `---` 밑줄)을 끄는 문법 설정 */
+export const NoSetextHeading = { remove: ["SetextHeading"] };
+/**
+ * 확장 마크다운 문법(파서)을 활성화하는 CodeMirror 확장입니다.
+ * 시각 스타일(하이라이트 배경, 기호 숨김 등)은 `emphasis()`가 담당합니다.
+ */
+export function extendedMarkdown(options = {}) {
+    const { markdownConfig = {}, nonTightLists = false, blankLineAfterList = true, setextHeadings = false } = options;
+    const userExtensions = markdownConfig.extensions ?? [];
+    const addKeymap = markdownConfig.addKeymap ?? true;
+    return [
+        markdown({
+            base: markdownLanguage,
+            ...markdownConfig,
+            extensions: [extendedMarkdownSyntax, setextHeadings ? [] : NoSetextHeading, userExtensions],
+            // 기본 키맵은 Enter 동작을 바꿀 수 없으므로 끄고, 아래에서 같은 우선순위로 다시 등록합니다.
+            addKeymap: false,
+        }),
+        addKeymap
+            ? Prec.high(keymap.of([
+                // 목록 끝내기(빈 줄 추가)가 해당하지 않으면 다음 바인딩(기본 Enter 동작)으로 넘어갑니다.
+                ...(blankLineAfterList ? [{ key: "Enter", run: endListWithBlankLine }] : []),
+                { key: "Enter", run: insertNewlineContinueMarkupCommand({ nonTightLists }) },
+                { key: "Backspace", run: deleteMarkupBackward },
+            ]))
+            : [],
+    ];
+}

package/dist/footnote.d.ts

@@ -0,0 +1,24 @@
+import { type EditorState, type Extension } from "@codemirror/state";
+import { type Tooltip } from "@codemirror/view";
+export interface FootnoteDefinitionInfo {
+    readonly label: string;
+    /** 정의 전체 범위 */
+    readonly from: number;
+    readonly to: number;
+    /** 내용 시작 위치 ("]:" 뒤 공백 다음) */
+    readonly contentFrom: number;
+    /** 툴팁용 내용 (앞뒤 공백 제거, 길면 자름) */
+    readonly text: string;
+}
+/**
+ * 문서의 각주 정의를 라벨별로 찾습니다. (같은 라벨이 여러 번 정의되면 첫 번째)
+ * 정의는 최상위 블록에만 오므로 최상위 블록만 확인하고, 결과는 구문 트리별로 캐시합니다.
+ * (커서만 움직이는 동안에는 다시 계산하지 않습니다)
+ */
+export declare function footnoteDefinitions(state: EditorState): ReadonlyMap<string, FootnoteDefinitionInfo>;
+export declare const footnotePlugin: import("@codemirror/view").ViewPlugin<import("./extensions.js").RevealPluginValue, undefined>;
+/** 각주 정의 내용을 서식이 반영된 DOM으로 그립니다. 정의가 없으면 null */
+export declare function renderFootnoteDefinition(state: EditorState, label: string): HTMLElement | null;
+/** pos(마우스 위치)에 각주 참조가 있으면 그 정의를 보여주는 툴팁 */
+export declare function footnoteTooltipAt(state: EditorState, pos: number, side?: -1 | 1): Tooltip | null;
+export declare function footnote(): Extension;