@olddevs/ui 0.0.0-stage → 4.0.0

package/dist/editor/core/blockTypes.d.ts

@@ -0,0 +1,89 @@
+import type { Node as PmNode } from "@tiptap/pm/model";
+import type { EditorState } from "@tiptap/pm/state";
+import type { PrefixedName } from "./customTool.js";
+import type { InsertItem } from "./insertItems.js";
+import { type ToolList } from "./toolDescriptor.js";
+import type { Tool } from "./tools.js";
+/**
+ * Пункт меню «¶» — тип Блока.
+ *
+ * Это пункт раздела «Превратить в» Меню вставки (`InsertItem`, `section:
+ * "turnInto"`), и применяется он тем же `applyInsertItem`: сначала с Блока
+ * снимаются обёртки (список, цитата), потом пункт оборачивает или меняет его
+ * заново — одной транзакцией, на одну отмену. Своего пути смены типа у меню
+ * нет: два пути разошлись бы на первом же списке внутри цитаты.
+ *
+ * Отдельный реестр, а не выборка из `INSERT_ITEMS`, потому что у меню «¶»
+ * другие слова и иконки: «Текст» с иконкой `T`, а не
+ * «Абзац» с пилкроу, и уровень заголовка на иконке. Блока кода в нём нет — у
+ * него своя кнопка Панели.
+ */
+export interface BlockTypeItem extends InsertItem {
+    section: "turnInto";
+    /**
+     * Инструмент, без которого пункта нет. У «Текста» — `null`: абзац есть всегда.
+     * У пункта своего Инструмента — его имя (ADR-0058, п. 5): набор уже отфильтрован.
+     */
+    tool: Tool | PrefixedName | null;
+    /** Второй нужный инструмент: H1 — надстройка над `heading`. */
+    alsoTool?: Tool;
+    keys: readonly string[];
+}
+/**
+ * Пункты «¶» Инструмента из его описания — те же пункты «Превратить в» Меню
+ * вставки: слова, иконка, сочетание и команда у них одни, поэтому вторую запись
+ * Инструмент не пишет (ADR-0058, п. 5).
+ */
+export declare function turnIntoTypes(tool: Tool | PrefixedName, items: readonly InsertItem[]): BlockTypeItem[];
+/**
+ * Пункты «¶» по порядку показа. Сочетания — подписи из общей таблицы
+ * (`shortcuts.ts`), по тем же id, что у Меню вставки и справочника:
+ * вешают их расширения движка, и подпись обязана совпадать с ними.
+ */
+export declare const BLOCK_TYPE_ITEMS: readonly BlockTypeItem[];
+/**
+ * Пункты «¶» для набора инструментов: «Текст», заголовки и пункты своих
+ * Инструментов. Меню из одного «Текста» ничего не выбирает, и тогда список
+ * пуст: кнопки «¶» на Панели нет.
+ */
+export declare function blockTypeItemsFor(tools: ToolList): readonly BlockTypeItem[];
+/**
+ * Пункты «Формат ›» ручки Блока: весь набор «Превратить в» —
+ * с цитатой и списками, в отличие от «¶» (решение владельца).
+ */
+export declare function formatItemsFor(tools: ToolList): readonly BlockTypeItem[];
+/** Пункт цитаты набора — для флажка «Цитата» в «…»; без инструмента — `undefined`. */
+export declare function quoteItemFor(tools: ToolList): BlockTypeItem | undefined;
+/**
+ * Текущий тип Блока под началом выделения: `id` пункта «¶», `"codeBlock"` или
+ * `null` (выделен не текст — картинка, разделитель).
+ *
+ * РЕШАЕТ СТРОКА ПОД КАРЕТКОЙ (решение владельца). Списков и цитаты
+ * в «¶» больше нет, и абзац в пункте списка или в цитате — это «Текст», а
+ * заголовок в цитате — его уровень. Список и цитату показывают свои кнопки:
+ * «Списки ▾» и флажок «Цитата» в «…». Прежде решала ближайшая обёртка.
+ */
+export declare function currentBlockType(state: EditorState): string | null;
+/**
+ * Тип Блока целиком — для «Формат ›» ручки Блока: решает сам
+ * Блок, а не текст под кареткой. Цитата со списком внутри — «Цитата»: ручка
+ * превращает всю цитату. `null` — Блок, который превратить нельзя (таблица,
+ * картинка, линия).
+ */
+export declare function blockTypeOf(block: PmNode): string | null;
+/** Виды списка — id пунктов «Превратить в» Меню вставки и имена узлов Схемы. */
+export declare const LIST_TYPES: readonly ["bulletList", "orderedList", "taskList"];
+export type ListType = (typeof LIST_TYPES)[number];
+/**
+ * Пункты меню «Списки» — те же пункты «Превратить в» Меню вставки,
+ * что и виды списка: одни слова, иконки, сочетания и одна команда. В отличие от «¶», меню из одного
+ * пункта остаётся меню: «Чек-лист» без соседей — всё равно выбор вида списка.
+ */
+export declare function listTypeItemsFor(tools: ToolList): readonly BlockTypeItem[];
+/**
+ * Вид ближайшего списка вокруг начала выделения или `null` — каретка не в
+ * списке. Цитата между текстом и списком не мешает: пункт списка с цитатой
+ * внутри всё равно пункт списка, и снимать меню «Списки» должно его.
+ */
+export declare function currentListType(state: EditorState): ListType | null;
+//# sourceMappingURL=blockTypes.d.ts.map

package/dist/editor/core/blockTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blockTypes.d.ts","sourceRoot":"","sources":["../../../src/editor/core/blockTypes.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,IAAI,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAapD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,aAAc,SAAQ,UAAU;IAC/C,OAAO,EAAE,UAAU,CAAC;IACpB;;;OAGG;IACH,IAAI,EAAE,IAAI,GAAG,YAAY,GAAG,IAAI,CAAC;IACjC,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,IAAI,CAAC;IAChB,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CACzB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,IAAI,GAAG,YAAY,EACzB,KAAK,EAAE,SAAS,UAAU,EAAE,GAC3B,aAAa,EAAE,CAIjB;AAaD;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,aAAa,EAyCpD,CAAC;AAwCF;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,QAAQ,GAAG,SAAS,aAAa,EAAE,CAG3E;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,GAAG,SAAS,aAAa,EAAE,CAGxE;AAED,sFAAsF;AACtF,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,GAAG,aAAa,GAAG,SAAS,CAEvE;AAkBD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAElE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAExD;AAED,gFAAgF;AAChF,eAAO,MAAM,UAAU,oDAAqD,CAAC;AAE7E,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,QAAQ,GAAG,SAAS,aAAa,EAAE,CAI1E;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,QAAQ,GAAG,IAAI,CAOnE"}

package/dist/editor/core/blockTypes.js

@@ -0,0 +1,121 @@
+"use client";
+import { Heading1Icon, Heading2Icon, Heading3Icon, Heading4Icon, ListIcon, OrderedListIcon, TaskListIcon, TextIcon, } from "../../icons.js";
+import { shortcutKeys } from "./shortcuts.js";
+import { projectRecords } from "./toolDescriptor.js";
+export function turnIntoTypes(tool, items) {
+    return items
+        .filter((item) => item.section === "turnInto")
+        .map((item) => ({ ...item, section: "turnInto", tool, keys: item.keys ?? [] }));
+}
+const heading = (level, icon) => ({
+    id: `heading${level}`,
+    section: "turnInto",
+    tool: "heading",
+    alsoTool: level === 1 ? "heading1" : undefined,
+    label: (m) => m.heading({ level }),
+    icon,
+    keys: shortcutKeys(`h${level}`),
+    run: (chain) => chain.setHeading({ level }),
+});
+export const BLOCK_TYPE_ITEMS = [
+    {
+        id: "text",
+        section: "turnInto",
+        tool: null,
+        label: (m) => m.textBlock,
+        icon: TextIcon,
+        keys: shortcutKeys("paragraph"),
+        run: (chain) => chain.setParagraph(),
+    },
+    heading(1, Heading1Icon),
+    heading(2, Heading2Icon),
+    heading(3, Heading3Icon),
+    heading(4, Heading4Icon),
+    {
+        id: "bulletList",
+        section: "turnInto",
+        tool: "bulletList",
+        label: (m) => m.bulletList,
+        icon: ListIcon,
+        keys: shortcutKeys("bulletList"),
+        run: (chain) => chain.toggleBulletList(),
+    },
+    {
+        id: "orderedList",
+        section: "turnInto",
+        tool: "orderedList",
+        label: (m) => m.orderedList,
+        icon: OrderedListIcon,
+        keys: shortcutKeys("orderedList"),
+        run: (chain) => chain.toggleOrderedList(),
+    },
+    {
+        id: "taskList",
+        section: "turnInto",
+        tool: "taskList",
+        label: (m) => m.taskList,
+        icon: TaskListIcon,
+        keys: shortcutKeys("taskList"),
+        run: (chain) => chain.toggleTaskList(),
+    },
+];
+const BLOCK_TYPE_ORDER = [
+    "heading",
+    "blockquote",
+    "bulletList",
+    "orderedList",
+    "taskList",
+];
+function blockTypeItemsOf(tools) {
+    return [
+        ...BLOCK_TYPE_ITEMS.filter((item) => item.tool === null),
+        ...projectRecords(tools, BLOCK_TYPE_ORDER, (tool) => BLOCK_TYPE_ITEMS.filter((item) => item.tool === tool), (descriptor) => descriptor.blockTypes),
+    ].filter((item) => item.alsoTool === undefined || tools.has(item.alsoTool));
+}
+const notInBlockTypeMenu = (id) => id === "blockquote" || LIST_TYPES.includes(id);
+export function blockTypeItemsFor(tools) {
+    const items = blockTypeItemsOf(tools).filter((item) => !notInBlockTypeMenu(item.id));
+    return items.length > 1 ? items : [];
+}
+export function formatItemsFor(tools) {
+    const items = blockTypeItemsOf(tools);
+    return items.length > 1 ? items : [];
+}
+export function quoteItemFor(tools) {
+    return blockTypeItemsOf(tools).find((item) => item.id === "blockquote");
+}
+const WRAPPERS = {
+    blockquote: "blockquote",
+    bulletList: "bulletList",
+    orderedList: "orderedList",
+    taskList: "taskList",
+};
+function textBlockType(block) {
+    if (block.type.name === "heading")
+        return `heading${String(block.attrs.level)}`;
+    if (block.type.name === "codeBlock")
+        return "codeBlock";
+    if (block.type.name === "paragraph")
+        return "text";
+    return null;
+}
+export function currentBlockType(state) {
+    return textBlockType(state.selection.$from.parent);
+}
+export function blockTypeOf(block) {
+    return WRAPPERS[block.type.name] ?? textBlockType(block);
+}
+export const LIST_TYPES = ["bulletList", "orderedList", "taskList"];
+export function listTypeItemsFor(tools) {
+    return blockTypeItemsOf(tools).filter((item) => LIST_TYPES.includes(item.id));
+}
+export function currentListType(state) {
+    const { $from } = state.selection;
+    for (let depth = $from.depth - 1; depth > 0; depth--) {
+        const name = $from.node(depth).type.name;
+        if (LIST_TYPES.includes(name))
+            return name;
+    }
+    return null;
+}
+//# sourceMappingURL=blockTypes.js.map

package/dist/editor/core/blockTypes.js.map

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

package/dist/editor/core/containers.d.ts

@@ -0,0 +1,43 @@
+import type { Node as PmNode, ResolvedPos } from "@tiptap/pm/model";
+import { type Transaction } from "@tiptap/pm/state";
+/**
+ * Общее у контейнерных Блоков — Раскладки (`layout.ts`, ADR-0056) и Обёртки
+ * (`wrapper.ts`, ADR-0057): где их нет и куда встаёт новый.
+ *
+ * Оба не входят в группу `block`: их принимают только узлы, назвавшие их
+ * поимённо, — Документ, а Обёртку ещё и колонка Раскладки. Поэтому правила
+ * разбора и вставки у них одни и те же, и живут здесь, чтобы списки и
+ * арифметика позиций не разъезжались молча.
+ */
+/**
+ * Имя узла Обёртки в Схеме движка. Живёт здесь, а не в `wrapper.ts`: оно же
+ * входит в общий список ниже, а `wrapper.ts` импортирует этот модуль —
+ * определение там дало бы цикл импортов. `wrapper.ts` его реэкспортирует.
+ */
+export declare const WRAPPER_NODE = "wrapper";
+/**
+ * Контекст правила разбора (`context` в `parseHTML`), где контейнерный Блок
+ * снимается: правило с `skip` отдаёт его Блоки подряд, а не режет контейнер
+ * вставки надвое. `more` — узлы, где нет именно этого Блока (колонка — для
+ * Раскладки). Имена выключенных инструментов безвредны: контекст сверяется по
+ * имени узла.
+ */
+export declare function containerFreeContext(...more: string[]): string;
+/**
+ * Лежит ли позиция в узле, где контейнерного Блока нет (`CONTAINER_FREE_NODES`):
+ * то же правило, что `containerFreeContext` для разбора HTML, — для путей, где
+ * Блоки строятся не разбором HTML (вставка Markdown, `markdown.ts`).
+ */
+export declare function inContainerFreeNode($pos: ResolvedPos): boolean;
+/**
+ * Поставить контейнерный Блок `container` под текущим Блоком — в ближайший
+ * вверх узел, который его принимает (Документ; для Обёртки — и колонку).
+ *
+ * Пустой абзац прямо в нём (его готовит Меню вставки) заменяется. Из Обёртки,
+ * колонки, списка, цитаты или ячейки Блок встаёт под их Блоком в этом узле;
+ * пустой абзац контейнера Блоков (Обёртки или колонки), в котором набрали `/`,
+ * при этом убирается, если там есть что-то ещё, — иначе от вставки оставался
+ * бы пустой хвост. Каретка — в первый текстовый Блок нового контейнера.
+ */
+export declare function placeContainerBlock(tr: Transaction, container: PmNode): void;
+//# sourceMappingURL=containers.d.ts.map

package/dist/editor/core/containers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"containers.d.ts","sourceRoot":"","sources":["../../../src/editor/core/containers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,IAAI,MAAM,EAAY,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC9E,OAAO,EAAiB,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEnE;;;;;;;;GAQG;AAEH;;;;GAIG;AACH,eAAO,MAAM,YAAY,YAAY,CAAC;AAgBtC;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAE9D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAK9D;AAOD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAyB5E"}

package/dist/editor/core/containers.js

@@ -0,0 +1,52 @@
+"use client";
+import { TextSelection } from "@tiptap/pm/state";
+export const WRAPPER_NODE = "wrapper";
+const CONTAINER_FREE_NODES = [
+    WRAPPER_NODE,
+    "blockquote",
+    "listItem",
+    "taskItem",
+    "tableCell",
+    "tableHeader",
+];
+export function containerFreeContext(...more) {
+    return [...more, ...CONTAINER_FREE_NODES].map((name) => `${name}//`).join(" | ");
+}
+export function inContainerFreeNode($pos) {
+    for (let depth = $pos.depth; depth > 0; depth--) {
+        if (CONTAINER_FREE_NODES.includes($pos.node(depth).type.name))
+            return true;
+    }
+    return false;
+}
+function holds(node, type) {
+    return node.type.contentMatch.matchType(type) !== null;
+}
+export function placeContainerBlock(tr, container) {
+    const { selection } = tr;
+    const { $from } = selection;
+    let depth = $from.depth;
+    while (depth > 0 && !holds($from.node(depth), container.type))
+        depth--;
+    const emptyBlock = $from.parent.isTextblock && $from.parent.content.size === 0;
+    let pos;
+    if (emptyBlock && $from.depth === depth + 1) {
+        pos = $from.before();
+        tr.replaceWith(pos, $from.after(), container);
+    }
+    else {
+        pos = $from.depth === depth ? selection.to : $from.after(depth + 1);
+        const parent = $from.depth > depth + 1 ? $from.node(-1) : null;
+        if (emptyBlock && parent?.type.spec.blockContainer === true && parent.childCount > 1) {
+            const steps = tr.mapping.maps.length;
+            tr.delete($from.before(), $from.after());
+            pos = tr.mapping.slice(steps).map(pos);
+        }
+        tr.insert(pos, container);
+    }
+    let inner = pos + 1;
+    for (let node = container; !node.isTextblock && node.firstChild; node = node.firstChild)
+        inner++;
+    tr.setSelection(TextSelection.create(tr.doc, inner)).scrollIntoView();
+}
+//# sourceMappingURL=containers.js.map

package/dist/editor/core/containers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"containers.js","sourceRoot":"","sources":["../../../src/editor/core/containers.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAGb,OAAO,EAAE,aAAa,EAAoB,MAAM,kBAAkB,CAAC;AAiBnE,MAAM,CAAC,MAAM,YAAY,GAAG,SAAS,CAAC;AAOtC,MAAM,oBAAoB,GAAG;IAC3B,YAAY;IACZ,YAAY;IACZ,UAAU;IACV,UAAU;IACV,WAAW;IACX,aAAa;CACd,CAAC;AASF,MAAM,UAAU,oBAAoB,CAAC,GAAG,IAAc;IACpD,OAAO,CAAC,GAAG,IAAI,EAAE,GAAG,oBAAoB,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACnF,CAAC;AAOD,MAAM,UAAU,mBAAmB,CAAC,IAAiB;IACnD,KAAK,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;QAChD,IAAI,oBAAoB,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;IAC7E,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAGD,SAAS,KAAK,CAAC,IAAY,EAAE,IAAc;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;AACzD,CAAC;AAYD,MAAM,UAAU,mBAAmB,CAAC,EAAe,EAAE,SAAiB;IACpE,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;IACzB,MAAM,EAAE,KAAK,EAAE,GAAG,SAAS,CAAC;IAC5B,IAAI,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IACxB,OAAO,KAAK,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC;QAAE,KAAK,EAAE,CAAC;IACvE,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,WAAW,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,CAAC;IAC/E,IAAI,GAAW,CAAC;IAChB,IAAI,UAAU,IAAI,KAAK,CAAC,KAAK,KAAK,KAAK,GAAG,CAAC,EAAE,CAAC;QAC5C,GAAG,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;QACrB,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;IAChD,CAAC;SAAM,CAAC;QACN,GAAG,GAAG,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QACpE,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC/D,IAAI,UAAU,IAAI,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,cAAc,KAAK,IAAI,IAAI,MAAM,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;YACrF,MAAM,KAAK,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;YACrC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;YACzC,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACzC,CAAC;QACD,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAC5B,CAAC;IAGD,IAAI,KAAK,GAAG,GAAG,GAAG,CAAC,CAAC;IACpB,KAAK,IAAI,IAAI,GAAG,SAAS,EAAE,CAAC,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,UAAU,EAAE,IAAI,GAAG,IAAI,CAAC,UAAU;QAAE,KAAK,EAAE,CAAC;IACjG,EAAE,CAAC,YAAY,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,cAAc,EAAE,CAAC;AACxE,CAAC"}

package/dist/editor/core/customMarkdown.d.ts

@@ -0,0 +1,8 @@
+import { type AnyExtension } from "@tiptap/core";
+/** Поле конфигурации атома своего Инструмента без правил Markdown: имя Инструмента. */
+export declare const MARKDOWN_FALLBACK = "kitMarkdownFallback";
+/** Предупреждение о Markdown по умолчанию — одно на Инструмент (`devWarn` помнит текст). */
+export declare function warnNoMarkdown(tool: string): void;
+/** Поля Node или Mark, дописывающие Markdown по умолчанию; `{}`, если свои правила есть. */
+export declare function markdownFallback(extension: AnyExtension, tool: string): object;
+//# sourceMappingURL=customMarkdown.d.ts.map

package/dist/editor/core/customMarkdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"customMarkdown.d.ts","sourceRoot":"","sources":["../../../src/editor/core/customMarkdown.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,YAAY,EAIlB,MAAM,cAAc,CAAC;AAmBtB,uFAAuF;AACvF,eAAO,MAAM,iBAAiB,wBAAwB,CAAC;AAEvD,4FAA4F;AAC5F,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAKjD;AAED,4FAA4F;AAC5F,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAkC9E"}

package/dist/editor/core/customMarkdown.js

@@ -0,0 +1,34 @@
+"use client";
+import { getExtensionField, } from "@tiptap/core";
+import { devWarn } from "../../lib/dev-warn.js";
+export const MARKDOWN_FALLBACK = "kitMarkdownFallback";
+export function warnNoMarkdown(tool) {
+    devWarn(`custom tool "${tool}" has no Markdown rules (renderMarkdown in its engine part): ` +
+        "getMarkdown() writes its blocks as their content and its atoms as their text");
+}
+export function markdownFallback(extension, tool) {
+    if (getExtensionField(extension, "renderMarkdown") !== undefined)
+        return {};
+    if (extension.type === "node" &&
+        (getExtensionField(extension, "atom") === true ||
+            getExtensionField(extension, "content") === undefined)) {
+        return { [MARKDOWN_FALLBACK]: tool };
+    }
+    let editor = null;
+    return {
+        onBeforeCreate(...args) {
+            editor = this.editor;
+            this.parent?.(...args);
+        },
+        renderMarkdown(node, helpers) {
+            warnNoMarkdown(tool);
+            if (extension.type === "mark")
+                return helpers.renderChildren(node);
+            const type = editor?.schema.nodes[node.type ?? ""];
+            if (!node.content)
+                return "";
+            return helpers.renderChildren(node.content, type && !type.inlineContent ? "\n\n" : "");
+        },
+    };
+}
+//# sourceMappingURL=customMarkdown.js.map

package/dist/editor/core/customMarkdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"customMarkdown.js","sourceRoot":"","sources":["../../../src/editor/core/customMarkdown.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EACL,iBAAiB,GAKlB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAmBhD,MAAM,CAAC,MAAM,iBAAiB,GAAG,qBAAqB,CAAC;AAGvD,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,CACL,gBAAgB,IAAI,+DAA+D;QACjF,8EAA8E,CACjF,CAAC;AACJ,CAAC;AAGD,MAAM,UAAU,gBAAgB,CAAC,SAAuB,EAAE,IAAY;IACpE,IAAI,iBAAiB,CAAC,SAAS,EAAE,gBAAgB,CAAC,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IAI5E,IACE,SAAS,CAAC,IAAI,KAAK,MAAM;QACzB,CAAC,iBAAiB,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,IAAI;YAC5C,iBAAiB,CAAC,SAAS,EAAE,SAAS,CAAC,KAAK,SAAS,CAAC,EACxD,CAAC;QACD,OAAO,EAAE,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,CAAC;IACvC,CAAC;IAID,IAAI,MAAM,GAAkB,IAAI,CAAC;IACjC,OAAO;QACL,cAAc,CAEZ,GAAG,IAAe;YAElB,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;YACrB,IAAI,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QACzB,CAAC;QACD,cAAc,CAAC,IAAiB,EAAE,OAAgC;YAChE,cAAc,CAAC,IAAI,CAAC,CAAC;YAGrB,IAAI,SAAS,CAAC,IAAI,KAAK,MAAM;gBAAE,OAAO,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;YACnE,MAAM,IAAI,GAAG,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;YACnD,IAAI,CAAC,IAAI,CAAC,OAAO;gBAAE,OAAO,EAAE,CAAC;YAC7B,OAAO,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACzF,CAAC;KACF,CAAC;AACJ,CAAC"}