mdsquare 0.0.0-stage → 0.1.0

package/dist/codeBlock.d.ts

@@ -0,0 +1,78 @@
+import { Language, LanguageDescription } from "@codemirror/language";
+import { Facet, type EditorState, type Extension } from "@codemirror/state";
+import { type SyntaxNode } from "@lezer/common";
+import { type CodeTheme } from "./codeTheme.js";
+/** 코드 본문 조각: 인용 안에서는 줄마다 `>`로, 목록 안에서는 들여쓰기로 나뉩니다. */
+interface Piece {
+    /** 이어 붙인 코드 문자열에서의 시작 위치 */
+    readonly codeFrom: number;
+    /** 문서에서의 시작 위치 */
+    readonly docFrom: number;
+    readonly length: number;
+}
+export interface FencedCodeInfo {
+    readonly from: number;
+    readonly to: number;
+    /** 언어 (정보 문자열의 첫 단어, 소문자). 없으면 "" */
+    readonly lang: string;
+    /** 이어 붙인 코드 본문 (인용 기호/목록 들여쓰기 제외) */
+    readonly code: string;
+    readonly pieces: readonly Piece[];
+    readonly open: {
+        readonly from: number;
+        readonly to: number;
+    };
+    readonly close: {
+        readonly from: number;
+        readonly to: number;
+    } | null;
+    readonly info: {
+        readonly from: number;
+        readonly to: number;
+    } | null;
+}
+/** FencedCode 노드에서 언어, 코드 본문, 기호 위치를 읽습니다. */
+export declare function readFencedCode(state: EditorState, node: SyntaxNode): FencedCodeInfo | null;
+/**
+ * 코드 블록 언어 목록.
+ * - `LanguageDescription` 배열 (예: `@codemirror/language-data`의 `languages`): 필요할 때 불러옵니다.
+ * - 함수: 정보 문자열의 언어(소문자)를 받아 `Language` 또는 `LanguageDescription`을 돌려줍니다.
+ */
+export type CodeLanguages = readonly LanguageDescription[] | ((lang: string) => Language | LanguageDescription | null | undefined);
+/** 코드 문자열 기준 토큰 구간과 클래스 */
+interface TokenSpan {
+    readonly from: number;
+    readonly to: number;
+    readonly className: string;
+}
+/** Lezer 파서로 코드 전체를 파싱해 테마 클래스를 붙입니다. (최근 결과를 캐시) */
+export declare function tokenize(language: Language, theme: CodeTheme, lang: string, code: string): readonly TokenSpan[];
+/**
+ * 다른 확장이 그림 등으로 대신 그리는 코드 블록 언어 (예: tikz()의 "tikz").
+ * 이 언어의 블록은 커서가 밖에 있을 때 codeBlock()이 그리지 않고, 커서가 들어오면(원문) 코드 블록으로 그립니다.
+ */
+export declare const renderedCodeLanguages: Facet<readonly string[], ReadonlySet<string>>;
+/** 도구 모음에 보여줄 언어 이름 */
+export declare const languageLabel: (lang: string) => string;
+export interface CodeBlockOptions {
+    /** 강조할 언어 목록 (예: `@codemirror/language-data`의 `languages`). 없으면 강조하지 않습니다. */
+    languages?: CodeLanguages;
+    /** 토큰 색 테마 (기본: GitHub 계열). VS Code 테마는 `vscodeTheme(json)` */
+    theme?: CodeTheme;
+    /** 복사 버튼을 보여줄지 (기본 true) */
+    copyButton?: boolean;
+}
+/**
+ * 펜스 코드 블록(```` ```lang ````)을 CodeMirror(Lezer) 언어 파서로 강조해 보여주는 확장입니다.
+ * - 언어: 정보 문자열의 첫 단어(별칭 포함, 예: ts, js, py). `languages`에서 찾고, 처음 쓰일 때 불러옵니다.
+ *   ```ts
+ *   import { languages } from "@codemirror/language-data";
+ *   codeBlock({ languages, theme: vscodeTheme(themeJsonText) });
+ *   ```
+ * - 코드 블록마다 따로 파싱하므로 문서 전체 구문 트리에 다른 언어가 섞이지 않습니다.
+ *   lang-markdown의 `codeLanguages`와 함께 쓰면 두 강조가 겹치므로 함께 쓰지 마세요.
+ * - 커서가 블록 밖이면 펜스 줄을 숨기고, 안이면 펜스 원문을 보여줍니다.
+ * - 블록에 마우스를 올리면 오른쪽 위에 도구 모음(언어, 복사 버튼)을 보여줍니다.
+ */
+export declare function codeBlock(options?: CodeBlockOptions): Extension;
+export {};