@olddevs/ui 0.0.0-stage → 4.0.1

package/dist/editor/features/code/CodeCopyButton.js

@@ -0,0 +1,29 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useEffect, useRef, useState } from "react";
+import { CopyButton } from "../../../components/actions/CopyButton.js";
+import { Tooltip, TooltipProvider } from "../../../components/overlays/Tooltip.js";
+import { useMessages } from "../../../i18n/useMessages.js";
+import { cn } from "../../../lib/cn.js";
+const RESET_MS = 2000;
+export function CodeCopyButton({ code, ...rest }) {
+    const messages = useMessages();
+    const [state, setState] = useState("idle");
+    const timer = useRef(null);
+    useEffect(() => () => {
+        if (timer.current != null)
+            clearTimeout(timer.current);
+    }, []);
+    const content = state === "copied"
+        ? messages.copyButton.copied
+        : state === "failed"
+            ? messages.copyButton.failed
+            : messages.editor.codeCopy;
+    return (_jsx(TooltipProvider, { children: _jsx(Tooltip, { content: content, children: _jsx("span", { className: "inline-flex", children: _jsx(CopyButton, { ...rest, value: code, className: cn("[&_svg]:size-3", rest.className), size: "xs", variant: "ghost", resetDelay: RESET_MS, onCopy: (ok) => {
+                        setState(ok ? "copied" : "failed");
+                        if (timer.current != null)
+                            clearTimeout(timer.current);
+                        timer.current = setTimeout(() => setState("idle"), RESET_MS);
+                    } }) }) }) }));
+}
+//# sourceMappingURL=CodeCopyButton.js.map

package/dist/editor/features/code/CodeCopyButton.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodeCopyButton.js","sourceRoot":"","sources":["../../../../src/editor/features/code/CodeCopyButton.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACpD,OAAO,EAAE,UAAU,EAAwB,MAAM,2CAA2C,CAAC;AAC7F,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AACnF,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,EAAE,EAAE,MAAM,oBAAoB,CAAC;AAGxC,MAAM,QAAQ,GAAG,IAAI,CAAC;AAuBtB,MAAM,UAAU,cAAc,CAAC,EAAE,IAAI,EAAE,GAAG,IAAI,EAAuB;IACnE,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAC/B,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAA+B,MAAM,CAAC,CAAC;IACzE,MAAM,KAAK,GAAG,MAAM,CAAuC,IAAI,CAAC,CAAC;IAEjE,SAAS,CACP,GAAG,EAAE,CAAC,GAAG,EAAE;QACT,IAAI,KAAK,CAAC,OAAO,IAAI,IAAI;YAAE,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACzD,CAAC,EACD,EAAE,CACH,CAAC;IAEF,MAAM,OAAO,GACX,KAAK,KAAK,QAAQ;QAChB,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM;QAC5B,CAAC,CAAC,KAAK,KAAK,QAAQ;YAClB,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM;YAC5B,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC;IAEjC,OAAO,CACL,KAAC,eAAe,cACd,KAAC,OAAO,IAAC,OAAO,EAAE,OAAO,YACvB,eAAM,SAAS,EAAC,aAAa,YAC3B,KAAC,UAAU,OACL,IAAI,EACR,KAAK,EAAE,IAAI,EAIX,SAAS,EAAE,EAAE,CAAC,gBAAgB,EAAE,IAAI,CAAC,SAAS,CAAC,EAC/C,IAAI,EAAC,IAAI,EACT,OAAO,EAAC,OAAO,EACf,UAAU,EAAE,QAAQ,EACpB,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE;wBACb,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;wBACnC,IAAI,KAAK,CAAC,OAAO,IAAI,IAAI;4BAAE,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;wBACvD,KAAK,CAAC,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,CAAC;oBAC/D,CAAC,GACD,GACG,GACC,GACM,CACnB,CAAC;AACJ,CAAC"}

package/dist/editor/features/code/CodeCopyIsland.d.ts

@@ -0,0 +1,37 @@
+export interface CodeCopyIslandProps {
+    /** Идентификатор просмотра: гнёзда его блоков помечены им же (`withCodeHeaders`). */
+    hostId: string;
+    /** Отпечаток HTML просмотра: сменился Документ — гнёзда новые, и остров ищет их заново. */
+    docKey: string;
+}
+/**
+ * Островок клиента у `RichTextView`: вставляет кнопку «Копировать» в гнёзда
+ * шапок блоков кода.
+ *
+ * ЗАЧЕМ ОН. `RichTextView` — серверный компонент, и обработчика клика у него
+ * быть не может. Шапка с подписью языка и пустым гнездом приходит в HTML от
+ * сервера; здесь, после монтирования, в каждое гнездо своего просмотра
+ * вставляется порталом `CodeCopyButton`. До гидрации и без JS кнопки нет, а
+ * документ читается так же.
+ *
+ * ЧТО КОПИРУЕТСЯ — `textContent` элемента `code` рядом с гнездом. Для текста
+ * без разметки и для блока, уже подсвеченного `highlightCodeBlocks` (токены —
+ * `span` внутри `code`), это один и тот же исходный код: токены текста не
+ * добавляют (ADR-0039: копируется текст, а не разметка).
+ *
+ * ГНЁЗДА ИЩУТСЯ ОТ СВОЕГО МЕСТА В ДЕРЕВЕ, а не по глобальному `document`. У
+ * серверного компонента нет ссылки, которую можно передать клиентскому, поэтому
+ * остров рисует пустой инертный `<template>` сразу за контейнером просмотра
+ * (`RichTextView` ставит их соседями) и после монтирования берёт его соседа
+ * слева. Так просмотр в теневом корне или в `iframe`, которых глобальный
+ * `document` не видит, получает свои кнопки, а обход идёт только по своему
+ * контейнеру, а не по всей странице. Идентификатор гнезда сверяется всё равно:
+ * гнездо с чужим идентификатором кнопку не получает.
+ *
+ * `<template>` есть и в разметке сервера, и в первом клиентском проходе, а
+ * порталы появляются только после эффекта — разметка сервера и гидрации
+ * совпадают. `<template>` браузер не показывает и в дерево доступности не
+ * кладёт; во флексе и гриде родителя он не занимает ячейку.
+ */
+export declare function CodeCopyIsland({ hostId, docKey }: CodeCopyIslandProps): import("react").JSX.Element;
+//# sourceMappingURL=CodeCopyIsland.d.ts.map

package/dist/editor/features/code/CodeCopyIsland.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodeCopyIsland.d.ts","sourceRoot":"","sources":["../../../../src/editor/features/code/CodeCopyIsland.tsx"],"names":[],"mappings":"AAMA,MAAM,WAAW,mBAAmB;IAClC,qFAAqF;IACrF,MAAM,EAAE,MAAM,CAAC;IACf,2FAA2F;IAC3F,MAAM,EAAE,MAAM,CAAC;CAChB;AAOD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,cAAc,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,mBAAmB,+BAuBrE"}

package/dist/editor/features/code/CodeCopyIsland.js

@@ -0,0 +1,21 @@
+"use client";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useRef, useState } from "react";
+import { createPortal } from "react-dom";
+import { CodeCopyButton } from "./CodeCopyButton.js";
+export function CodeCopyIsland({ hostId, docKey }) {
+    const [slots, setSlots] = useState([]);
+    const markerRef = useRef(null);
+    useEffect(() => {
+        const view = markerRef.current?.previousElementSibling;
+        const found = [...(view?.querySelectorAll("[data-code-copy]") ?? [])]
+            .filter((element) => element.dataset.codeCopy === hostId)
+            .map((element) => ({
+            element,
+            code: element.closest("[data-code-block]")?.querySelector("pre > code")?.textContent ?? "",
+        }));
+        setSlots(found);
+    }, [hostId, docKey]);
+    return (_jsxs(_Fragment, { children: [_jsx("template", { ref: markerRef, "data-code-copy-island": "" }), slots.map(({ element, code }, index) => createPortal(_jsx(CodeCopyButton, { code: code }), element, `${hostId}:${index}`))] }));
+}
+//# sourceMappingURL=CodeCopyIsland.js.map

package/dist/editor/features/code/CodeCopyIsland.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodeCopyIsland.js","sourceRoot":"","sources":["../../../../src/editor/features/code/CodeCopyIsland.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AA2CrD,MAAM,UAAU,cAAc,CAAC,EAAE,MAAM,EAAE,MAAM,EAAuB;IACpE,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAS,EAAE,CAAC,CAAC;IAC/C,MAAM,SAAS,GAAG,MAAM,CAAsB,IAAI,CAAC,CAAC;IAEpD,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,EAAE,sBAAsB,CAAC;QACvD,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,gBAAgB,CAAc,kBAAkB,CAAC,IAAI,EAAE,CAAC,CAAC;aAC/E,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,KAAK,MAAM,CAAC;aACxD,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACjB,OAAO;YACP,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE,aAAa,CAAC,YAAY,CAAC,EAAE,WAAW,IAAI,EAAE;SAC3F,CAAC,CAAC,CAAC;QACN,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAErB,OAAO,CACL,8BACE,mBAAU,GAAG,EAAE,SAAS,2BAAwB,EAAE,GAAG,EACpD,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,CACtC,YAAY,CAAC,KAAC,cAAc,IAAC,IAAI,EAAE,IAAI,GAAI,EAAE,OAAO,EAAE,GAAG,MAAM,IAAI,KAAK,EAAE,CAAC,CAC5E,IACA,CACJ,CAAC;AACJ,CAAC"}

package/dist/editor/features/code/codeBlock.d.ts

@@ -0,0 +1,25 @@
+/** Имя узла — то же, что у блока кода StarterKit: на нём держатся `Tool`, Панель и Меню вставки. */
+export declare const CODE_BLOCK_NODE = "codeBlock";
+export interface RichCodeBlockOptions {
+    /** Перевести фокус в Панель — `Alt+F10` с кнопки языка (`extensions.ts`). */
+    focusToolbar: () => boolean;
+}
+/**
+ * Блок кода с языком и подсветкой (ADR-0051) вместо блока кода
+ * StarterKit. Имя узла, `Mod+Alt+C`, правило ```` ``` ```` и пункты «Блок кода»
+ * в Панели и в Меню вставки остаются прежними.
+ *
+ * ЯЗЫК — ТОЛЬКО ИМЯ ИЗ `codeLanguages.ts` ИЛИ НИЧЕГО. Он приходит из пяти
+ * мест: `value` и вставка HTML (`class="language-py"`), правило ```` ```py ````,
+ * Markdown (```` ```yml ````), вставка из VS Code (`vscode-editor-data`) и
+ * команды движка. Первые три приводятся на входе, остальные — дописанной
+ * транзакцией (`codeLanguageNormalizer`); неизвестный язык становится
+ * «Обычным текстом», и в Документ уходит `<code>` без класса.
+ *
+ * ПОДСВЕТКА — ДЕКОРАЦИИ. Расширение размечает токены `span class="hljs-…"`
+ * поверх текста блока, и в `getHTML()` их нет: в Документе остаётся только
+ * `class="language-…"`. Цвета токенов — тема в `codeTheme.ts`, классами на
+ * контейнере.
+ */
+export declare const RichCodeBlock: import("@tiptap/core").Node<RichCodeBlockOptions, any>;
+//# sourceMappingURL=codeBlock.d.ts.map

package/dist/editor/features/code/codeBlock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codeBlock.d.ts","sourceRoot":"","sources":["../../../../src/editor/features/code/codeBlock.ts"],"names":[],"mappings":"AAgBA,oGAAoG;AACpG,eAAO,MAAM,eAAe,cAAc,CAAC;AAE3C,MAAM,WAAW,oBAAoB;IACnC,6EAA6E;IAC7E,YAAY,EAAE,MAAM,OAAO,CAAC;CAC7B;AAuCD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,aAAa,wDA6GxB,CAAC"}

package/dist/editor/features/code/codeBlock.js

@@ -0,0 +1,116 @@
+"use client";
+import { textblockTypeInputRule } from "@tiptap/core";
+import { CodeBlockLowlight } from "@tiptap/extension-code-block-lowlight";
+import { Plugin, PluginKey } from "@tiptap/pm/state";
+import { ReactNodeViewRenderer } from "@tiptap/react";
+import { CODE_LANGUAGE_TRIGGER, CodeBlockView } from "./CodeBlockView.js";
+import { codeLanguageOf } from "./codeBlockTool.js";
+import { CODE_LANGUAGE_IDS, normalizeCodeLanguage } from "./codeLanguages.js";
+import { highlightCode } from "./lowlight.js";
+export const CODE_BLOCK_NODE = "codeBlock";
+const plain = (value) => ({
+    type: "root",
+    children: [{ type: "text", value }],
+});
+const LOWLIGHT = {
+    highlight: (language, code) => {
+        const id = normalizeCodeLanguage(language);
+        return id ? highlightCode(id, code) : plain(code);
+    },
+    highlightAuto: plain,
+    listLanguages: () => [...CODE_LANGUAGE_IDS],
+};
+function strayLanguages(state) {
+    const found = [];
+    state.doc.descendants((node, pos) => {
+        if (node.type.name !== CODE_BLOCK_NODE)
+            return !node.isTextblock;
+        const language = normalizeCodeLanguage(node.attrs.language);
+        if (language !== node.attrs.language)
+            found.push({ pos, language });
+        return false;
+    });
+    return found;
+}
+export const RichCodeBlock = CodeBlockLowlight.extend({
+    name: CODE_BLOCK_NODE,
+    addOptions() {
+        return {
+            ...this.parent(),
+            lowlight: LOWLIGHT,
+            focusToolbar: () => false,
+        };
+    },
+    addAttributes() {
+        return {
+            language: {
+                default: null,
+                parseHTML: codeLanguageOf,
+                rendered: false,
+            },
+        };
+    },
+    addInputRules() {
+        return [/^```([a-z]+)?[\s\n]$/, /^~~~([a-z]+)?[\s\n]$/].map((find) => textblockTypeInputRule({
+            find,
+            type: this.type,
+            getAttributes: (match) => ({ language: normalizeCodeLanguage(match[1]) }),
+        }));
+    },
+    parseMarkdown: (token, helpers) => {
+        if (token.raw?.startsWith("```") === false &&
+            token.raw?.startsWith("~~~") === false &&
+            token.codeBlockStyle !== "indented") {
+            return [];
+        }
+        return helpers.createNode(CODE_BLOCK_NODE, { language: normalizeCodeLanguage(token.lang) }, token.text ? [helpers.createTextNode(token.text)] : []);
+    },
+    renderMarkdown: (node, helpers) => {
+        const text = node.content ? helpers.renderChildren(node.content) : "";
+        const longest = Math.max(0, ...(text.match(/`+/g) ?? []).map((run) => run.length));
+        const fence = "`".repeat(Math.max(3, longest + 1));
+        const language = node.attrs?.language ?? "";
+        return `${fence}${language}\n${text}\n${fence}`;
+    },
+    addKeyboardShortcuts() {
+        return {
+            ...this.parent?.(),
+            "Alt-F10": ({ editor }) => {
+                const { $from } = editor.state.selection;
+                if ($from.parent.type !== this.type || !editor.isEditable)
+                    return false;
+                const block = editor.view.nodeDOM($from.before());
+                const trigger = block instanceof HTMLElement
+                    ? block.querySelector(`[${CODE_LANGUAGE_TRIGGER}]`)
+                    : null;
+                if (!trigger)
+                    return false;
+                trigger.focus();
+                return true;
+            },
+        };
+    },
+    addProseMirrorPlugins() {
+        return [
+            ...(this.parent?.() ?? []),
+            new Plugin({
+                key: new PluginKey("codeLanguageNormalizer"),
+                appendTransaction: (transactions, _oldState, state) => {
+                    if (!transactions.some((transaction) => transaction.docChanged))
+                        return null;
+                    const stray = strayLanguages(state);
+                    if (stray.length === 0)
+                        return null;
+                    const { tr } = state;
+                    for (const { pos, language } of stray)
+                        tr.setNodeAttribute(pos, "language", language);
+                    return tr;
+                },
+            }),
+        ];
+    },
+    addNodeView() {
+        return ReactNodeViewRenderer(CodeBlockView);
+    },
+});
+//# sourceMappingURL=codeBlock.js.map

package/dist/editor/features/code/codeBlock.js.map

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

package/dist/editor/features/code/codeBlockTool.d.ts

@@ -0,0 +1,24 @@
+import { type CodeLanguageId } from "./codeLanguages.js";
+import type { ToolDescriptor } from "../../core/toolDescriptor.js";
+/**
+ * Язык блока кода из разметки `<pre><code class="…">`: первый класс
+ * `language-*`, который знает Редактор. `evil language-js` даёт JavaScript,
+ * `language-rust` — «Обычный текст». Один разбор у движка (`codeBlock.ts`) и у
+ * формы блока в Скелете (здесь). Не в `codeLanguages.ts`: тот едет и в
+ * `RichTextView`, и в серверный вход Схемы, а им разбор DOM не нужен.
+ */
+export declare function codeLanguageOf(pre: Element): CodeLanguageId | null;
+/**
+ * Блок кода на описании Инструмента (ADR-0058, п. 11.1): его нет в
+ * `basic`, а Часть для движка тяжелее 10 кБ, поэтому она грузится тем же
+ * загрузчиком, что у своего Инструмента. До загрузки Редактор с блоком кода —
+ * Скелет (`RichTextEditor.tsx`).
+ *
+ * Переехали Часть для движка и пункты Меню вставки. Сочетание `Mod+Alt+C`
+ * вешает расширение, и его строка справочника осталась в `SHORTCUTS`: на неё
+ * ссылаются пункты меню (`shortcutKeys`), «Формат ›» и место строки цитаты
+ * (`MOVED_BEFORE`). Кнопка «Блок кода» меню «…» и «¶» — виджеты Панели, они
+ * переезжают позже (ADR-0058, «Последствия»).
+ */
+export declare const CODE_BLOCK_TOOL: ToolDescriptor;
+//# sourceMappingURL=codeBlockTool.d.ts.map

package/dist/editor/features/code/codeBlockTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codeBlockTool.d.ts","sourceRoot":"","sources":["../../../../src/editor/features/code/codeBlockTool.ts"],"names":[],"mappings":"AAMA,OAAO,EAAyB,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEhF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAUnE;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAOlE;AAyBD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,eAAe,EAAE,cAqC7B,CAAC"}

package/dist/editor/features/code/codeBlockTool.js

@@ -0,0 +1,66 @@
+"use client";
+import { Node } from "@tiptap/core";
+import { CodeBlockIcon } from "../../../icons.js";
+import { normalizeCodeLanguage } from "./codeLanguages.js";
+import { shortcutKeys } from "../../core/shortcuts.js";
+import { loaded } from "../../core/toolLoader.js";
+const loadCodeBlock = () => import("./codeBlock.js");
+export function codeLanguageOf(pre) {
+    for (const name of pre.firstElementChild?.classList ?? []) {
+        if (!name.startsWith("language-"))
+            continue;
+        const language = normalizeCodeLanguage(name.slice("language-".length));
+        if (language)
+            return language;
+    }
+    return null;
+}
+const CodeBlockShape = Node.create({
+    name: "codeBlock",
+    group: "block",
+    content: "text*",
+    marks: "",
+    code: true,
+    defining: true,
+    addAttributes: () => ({
+        language: { default: null, parseHTML: codeLanguageOf, rendered: false },
+    }),
+    parseHTML: () => [{ tag: "pre", preserveWhitespace: "full" }],
+    renderHTML: ({ node }) => [
+        "pre",
+        ["code", node.attrs.language ? { class: `language-${node.attrs.language}` } : {}, 0],
+    ],
+});
+export const CODE_BLOCK_TOOL = {
+    name: "codeBlock",
+    load: loadCodeBlock,
+    engine: ({ focusToolbar }) => [
+        loaded(loadCodeBlock).RichCodeBlock.configure({
+            focusToolbar,
+        }),
+    ],
+    skeleton: () => [CodeBlockShape],
+    kitTags: ["pre", "code"],
+    insertItems: [
+        {
+            id: "codeBlock",
+            section: "insert",
+            label: (m) => m.codeBlock,
+            icon: CodeBlockIcon,
+            aliases: ["```", "pre"],
+            markdown: "```",
+            keys: shortcutKeys("codeBlock"),
+            run: (chain) => chain.setCodeBlock(),
+        },
+        {
+            id: "codeBlockFromText",
+            section: "turnInto",
+            label: (m) => m.codeBlock,
+            icon: CodeBlockIcon,
+            aliases: ["```", "pre"],
+            keys: shortcutKeys("codeBlock"),
+            run: (chain) => chain.setCodeBlock(),
+        },
+    ],
+};
+//# sourceMappingURL=codeBlockTool.js.map

package/dist/editor/features/code/codeBlockTool.js.map

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

package/dist/editor/features/code/codeHeader.d.ts

@@ -0,0 +1,41 @@
+/** Обёртка блока: сам `pre` внутри теряет верх рамки. */
+export declare const CODE_BLOCK_CLASS = "[&_pre]:rounded-t-none [&_pre]:border-t-0";
+export declare const CODE_HEADER_CLASS: string;
+/** Гнездо кнопки справа: строчная коробка иначе поднимала бы иконку по базовой линии. */
+export declare const CODE_SLOT_CLASS = "inline-flex items-center";
+/**
+ * Подпись языка слева; отступ тот же, что у кнопки языка в Редакторе, цвет —
+ * той же ролью `--rte-secondary`, что у кнопок шапки.
+ */
+export declare const CODE_LABEL_CLASS = "px-1.5 leading-6 font-semibold text-(--rte-secondary)";
+/**
+ * Есть ли в Документе хоть один блок кода — тот, что получит шапку
+ * `withCodeHeaders`. По нему `RichTextView` решает, рисовать ли остров
+ * «Копировать»: текстовому Документу остров не нужен. Выражение то же, что у
+ * шапки, — новое, а не общее: у глобального выражения `test` сдвигает
+ * `lastIndex`.
+ */
+export declare function hasCodeBlocks(html: string): boolean;
+/**
+ * Шапка у каждого блока кода сохранённого Документа — строка в строку, на
+ * сервере, при показе.
+ *
+ * ЗАЧЕМ РАЗМЕТКОЙ, А НЕ КЛИЕНТОМ. Подпись языка и сама полоса приходят в HTML
+ * страницы: без JS документ читается так же, а место под кнопку не
+ * появляется после гидрации и не двигает текст. Клиентский островок
+ * (`CodeCopyIsland`) только вставляет кнопку в пустое гнездо
+ * `data-code-copy`; значение атрибута — идентификатор этого просмотра, чтобы
+ * два просмотра на странице не делили гнёзда.
+ *
+ * Название языка — из данных `codeLanguages.ts` по ПРИВЕДЁННОМУ имени, а не
+ * подставленная из строки Документа: чужой класс в разметку не попадает. Блок
+ * без языка и с неизвестным остаётся без подписи — каталог сообщений серверному
+ * компоненту недоступен, а «Plain text» без перевода у русскоязычного
+ * потребителя вышло бы на английском.
+ *
+ * Строка сюда приходит уже очищенной (она так же идёт в `innerHTML`); хелпер
+ * новых источников разметки не открывает: в неё попадают только константы
+ * модуля, подпись из списка языков и идентификатор просмотра с экранированием.
+ */
+export declare function withCodeHeaders(html: string, hostId: string): string;
+//# sourceMappingURL=codeHeader.d.ts.map

package/dist/editor/features/code/codeHeader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codeHeader.d.ts","sourceRoot":"","sources":["../../../../src/editor/features/code/codeHeader.ts"],"names":[],"mappings":"AAkBA,yDAAyD;AACzD,eAAO,MAAM,gBAAgB,8CAA8C,CAAC;AAE5E,eAAO,MAAM,iBAAiB,QAYmC,CAAC;AAElE,yFAAyF;AACzF,eAAO,MAAM,eAAe,6BAA6B,CAAC;AAE1D;;;GAGG;AACH,eAAO,MAAM,gBAAgB,0DAA0D,CAAC;AAWxF;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAWpE"}

package/dist/editor/features/code/codeHeader.js

@@ -0,0 +1,25 @@
+import { codeLanguage, normalizeCodeLanguage } from "./codeLanguages.js";
+export const CODE_BLOCK_CLASS = "[&_pre]:rounded-t-none [&_pre]:border-t-0";
+export const CODE_HEADER_CLASS = "flex h-7 items-center justify-between gap-2 rounded-t-(--rte-radius) border " +
+    "border-(--rte-code-border) border-b-(--rte-hr) bg-(--rte-code-block-background) " +
+    "px-1 font-sans text-xs text-(--rte-code-block-foreground) select-none " +
+    "[&_button]:text-(--rte-secondary) " +
+    "[&_button:is([data-hovered],:hover)]:bg-(--rte-control-hover)";
+export const CODE_SLOT_CLASS = "inline-flex items-center";
+export const CODE_LABEL_CLASS = "px-1.5 leading-6 font-semibold text-(--rte-secondary)";
+const BLOCK = /<pre>(<code(?: class="language-([\w+#-]+)")?>[\s\S]*?)<\/pre>/g;
+const escapeAttribute = (value) => value.replace(/&/g, "&amp;").replace(/"/g, "&quot;");
+export function hasCodeBlocks(html) {
+    return new RegExp(BLOCK.source).test(html);
+}
+export function withCodeHeaders(html, hostId) {
+    return html.replace(BLOCK, (_block, inner, name) => {
+        const label = name ? (codeLanguage(normalizeCodeLanguage(name))?.label ?? "") : "";
+        return (`<div class="${CODE_BLOCK_CLASS}" data-code-block>` +
+            `<div class="${CODE_HEADER_CLASS}" data-code-header>` +
+            `<span class="${CODE_LABEL_CLASS}">${label}</span>` +
+            `<span class="${CODE_SLOT_CLASS}" data-code-copy="${escapeAttribute(hostId)}"></span>` +
+            `</div><pre>${inner}</pre></div>`);
+    });
+}
+//# sourceMappingURL=codeHeader.js.map

package/dist/editor/features/code/codeHeader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codeHeader.js","sourceRoot":"","sources":["../../../../src/editor/features/code/codeHeader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAmBzE,MAAM,CAAC,MAAM,gBAAgB,GAAG,2CAA2C,CAAC;AAE5E,MAAM,CAAC,MAAM,iBAAiB,GAC5B,8EAA8E;IAC9E,kFAAkF;IAClF,wEAAwE;IAQxE,oCAAoC;IACpC,+DAA+D,CAAC;AAGlE,MAAM,CAAC,MAAM,eAAe,GAAG,0BAA0B,CAAC;AAM1D,MAAM,CAAC,MAAM,gBAAgB,GAAG,uDAAuD,CAAC;AAOxF,MAAM,KAAK,GAAG,gEAAgE,CAAC;AAE/E,MAAM,eAAe,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAShG,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC7C,CAAC;AAuBD,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,MAAc;IAC1D,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,KAAa,EAAE,IAAwB,EAAE,EAAE;QAC7E,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACnF,OAAO,CACL,eAAe,gBAAgB,oBAAoB;YACnD,eAAe,iBAAiB,qBAAqB;YACrD,gBAAgB,gBAAgB,KAAK,KAAK,SAAS;YACnD,gBAAgB,eAAe,qBAAqB,eAAe,CAAC,MAAM,CAAC,WAAW;YACtF,cAAc,KAAK,cAAc,CAClC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/editor/features/code/codeLanguages.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Языки блока кода ДАННЫМИ (ADR-0051): единственное место, где
+ * Редактор знает, какие языки бывают.
+ *
+ * НОВЫЙ ЯЗЫК — СТРОКА ЗДЕСЬ И ГРАММАТИКА В `lowlight.ts`. Схема
+ * (`RICH_TEXT_SCHEMA.codeLanguages`), меню языка у блока, разбор вставки и
+ * Markdown, серверный хелпер подсветки читают этот список, а не свои копии.
+ * Забытую грамматику ловит тип: `lowlight.ts` держит `Record` по `grammar`.
+ *
+ * `id` — то, что уходит в Документ (`class="language-<id>"`) и в Markdown
+ * (```` ```<id> ````); `grammar` — имя грамматики highlight.js, когда оно не
+ * совпадает с `id` (HTML подсвечивает грамматика `xml`). `aliases` — короткие
+ * и чужие имена, которые приходят из Markdown, вставки и сохранённого HTML и
+ * приводятся к `id` при загрузке: `py` в Документе не остаётся.
+ *
+ * ИМЕНА ЯЗЫКОВ — ДАННЫЕ, А НЕ СТРОКИ КАТАЛОГА. «Python» и «YAML» не
+ * переводятся; через каталог идёт только «Обычный текст» — блок без языка.
+ *
+ * Модуль серверно-безопасен: данные и чистая функция, без импортов.
+ */
+export declare const CODE_LANGUAGES: readonly [{
+    readonly id: "python";
+    readonly label: "Python";
+    readonly grammar: "python";
+    readonly aliases: readonly ["py"];
+}, {
+    readonly id: "typescript";
+    readonly label: "TypeScript";
+    readonly grammar: "typescript";
+    readonly aliases: readonly ["ts"];
+}, {
+    readonly id: "javascript";
+    readonly label: "JavaScript";
+    readonly grammar: "javascript";
+    readonly aliases: readonly ["js"];
+}, {
+    readonly id: "go";
+    readonly label: "Go";
+    readonly grammar: "go";
+    readonly aliases: readonly ["golang"];
+}, {
+    readonly id: "html";
+    readonly label: "HTML";
+    readonly grammar: "xml";
+    readonly aliases: readonly ["htm"];
+}, {
+    readonly id: "json";
+    readonly label: "JSON";
+    readonly grammar: "json";
+    readonly aliases: readonly [];
+}, {
+    readonly id: "yaml";
+    readonly label: "YAML";
+    readonly grammar: "yaml";
+    readonly aliases: readonly ["yml"];
+}, {
+    readonly id: "markdown";
+    readonly label: "Markdown";
+    readonly grammar: "markdown";
+    readonly aliases: readonly ["md"];
+}];
+export type CodeLanguage = (typeof CODE_LANGUAGES)[number];
+export type CodeLanguageId = CodeLanguage["id"];
+export type CodeLanguageGrammar = CodeLanguage["grammar"];
+/** Имена языков в порядке меню — то, что бывает в `class="language-…"`. */
+export declare const CODE_LANGUAGE_IDS: readonly CodeLanguageId[];
+/**
+ * Имя языка из чужого источника — к имени Документа. Регистр и пробелы по
+ * краям не важны (```` ```Python ````), псевдоним становится именем (`yml` →
+ * `yaml`). Неизвестный язык — `null`, то есть «Обычный текст»: блок остаётся,
+ * класса у него нет, и санитайзеру такой класс пропускать незачем.
+ */
+export declare function normalizeCodeLanguage(raw: unknown): CodeLanguageId | null;
+/** Описание языка по имени Документа; `null` — «Обычный текст». */
+export declare function codeLanguage(id: CodeLanguageId | null): CodeLanguage | null;
+//# sourceMappingURL=codeLanguages.d.ts.map

package/dist/editor/features/code/codeLanguages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codeLanguages.d.ts","sourceRoot":"","sources":["../../../../src/editor/features/code/codeLanguages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAajB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAC3D,MAAM,MAAM,cAAc,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;AAChD,MAAM,MAAM,mBAAmB,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;AAE1D,2EAA2E;AAC3E,eAAO,MAAM,iBAAiB,EAAE,SAAS,cAAc,EAAuC,CAAC;AAE/F;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAQzE;AAED,mEAAmE;AACnE,wBAAgB,YAAY,CAAC,EAAE,EAAE,cAAc,GAAG,IAAI,GAAG,YAAY,GAAG,IAAI,CAE3E"}

package/dist/editor/features/code/codeLanguages.js

@@ -0,0 +1,24 @@
+export const CODE_LANGUAGES = [
+    { id: "python", label: "Python", grammar: "python", aliases: ["py"] },
+    { id: "typescript", label: "TypeScript", grammar: "typescript", aliases: ["ts"] },
+    { id: "javascript", label: "JavaScript", grammar: "javascript", aliases: ["js"] },
+    { id: "go", label: "Go", grammar: "go", aliases: ["golang"] },
+    { id: "html", label: "HTML", grammar: "xml", aliases: ["htm"] },
+    { id: "json", label: "JSON", grammar: "json", aliases: [] },
+    { id: "yaml", label: "YAML", grammar: "yaml", aliases: ["yml"] },
+    { id: "markdown", label: "Markdown", grammar: "markdown", aliases: ["md"] },
+];
+export const CODE_LANGUAGE_IDS = CODE_LANGUAGES.map(({ id }) => id);
+export function normalizeCodeLanguage(raw) {
+    if (typeof raw !== "string")
+        return null;
+    const name = raw.trim().toLowerCase();
+    if (!name)
+        return null;
+    const found = CODE_LANGUAGES.find(({ id, aliases }) => id === name || aliases.includes(name));
+    return found?.id ?? null;
+}
+export function codeLanguage(id) {
+    return CODE_LANGUAGES.find((language) => language.id === id) ?? null;
+}
+//# sourceMappingURL=codeLanguages.js.map

package/dist/editor/features/code/codeLanguages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codeLanguages.js","sourceRoot":"","sources":["../../../../src/editor/features/code/codeLanguages.ts"],"names":[],"mappings":"AAoBA,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE;IACrE,EAAE,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE;IACjF,EAAE,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE;IACjF,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE;IAC7D,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,KAAK,CAAC,EAAE;IAK/D,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE;IAC3D,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,CAAC,EAAE;IAChE,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE;CACnE,CAAC;AAOX,MAAM,CAAC,MAAM,iBAAiB,GAA8B,cAAc,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;AAQ/F,MAAM,UAAU,qBAAqB,CAAC,GAAY;IAChD,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACzC,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACtC,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAC/B,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,IAAI,IAAK,OAA6B,CAAC,QAAQ,CAAC,IAAI,CAAC,CAClF,CAAC;IACF,OAAO,KAAK,EAAE,EAAE,IAAI,IAAI,CAAC;AAC3B,CAAC;AAGD,MAAM,UAAU,YAAY,CAAC,EAAyB;IACpD,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAC,IAAI,IAAI,CAAC;AACvE,CAAC"}

package/dist/editor/features/code/highlight.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Подсветить блоки кода в сохранённом Документе — для `RichTextView` и любой
+ * другой страницы показа (ADR-0051).
+ *
+ * В каждом `<pre><code class="language-…">` на языке Редактора текст
+ * заменяется токенами `<span class="hljs-…">`; цвета им даёт тема на
+ * контейнере `RichTextView` (`codeTheme.ts`). Остальной HTML не трогается ни
+ * на байт. Блок без языка, на неизвестном языке или уже с разметкой внутри
+ * остаётся как был — поэтому повторный вызов ничего не меняет.
+ *
+ * ПОРЯДОК: СНАЧАЛА ОЧИСТКА, ПОТОМ ПОДСВЕТКА. Хелпер ищет блоки выражением, а не
+ * разбором HTML, и рассчитан на разметку Схемы, которую отдаёт санитайзер.
+ * Токенов `hljs-*` в Схеме нет, и `sanitizeRichText` их снимает: очистка после
+ * подсветки вернула бы блок к голому тексту.
+ *
+ * Модуль серверно-безопасен: строка в строку, без DOM, React и Tiptap. Зовут
+ * его на сервере — при выдаче страницы или при сохранении, рядом с очисткой.
+ */
+export declare function highlightCodeBlocks(html: string): string;
+//# sourceMappingURL=highlight.d.ts.map

package/dist/editor/features/code/highlight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"highlight.d.ts","sourceRoot":"","sources":["../../../../src/editor/features/code/highlight.ts"],"names":[],"mappings":"AA+EA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAWxD"}