src/converters/board-to-markdown.js - dev - deka/buffer

src/converters/board-to-markdown.js
223 строки8 KB
Maksim Ratnikov
feat: доска в Markdown — таблицы объектов
07 авг 2026, 12:01
07 авг 2026, 12:013f61bda
// Доска → Markdown-таблицы объектов.
//
// На доске объекты живут в двух видах, и различать их приходится по форме
// таблицы, потому что больше не по чему:
//   - таблица «Поле | Значение» — это ОДИН объект, её строки это его свойства;
//   - таблица с заголовками колонок — набор объектов, по объекту на строку.
// Таблицы одинаковой формы сливаются в одну Markdown-таблицу, чтобы 65 бланков
// команд превратились в 65 строк, а не в 65 отдельных таблиц.

const KEY_VALUE_HEADERS = [
  ["поле", "значение"],
  ["field", "value"],
  ["свойство", "значение"],
  ["параметр", "значение"]
];

export function boardLayoutToMarkdown(layout, opts = {}) {
  const collected = collect(layout);
  const parts = [];

  if (opts.title) parts.push(`# ${opts.title}`, "");

  for (const group of collected.objectGroups) {
    parts.push(`## ${group.name}`, "");
    parts.push(renderTable(
      ["Дорожка", "Объект", ...group.fields],
      group.objects.map((object) => [
        object.lane, object.name,
        ...group.fields.map((field) => object.fields.get(field) ?? "")
      ])
    ), "");
  }

  for (const group of collected.rowGroups) {
    parts.push(`## ${group.name}`, "");
    parts.push(renderTable(
      ["Дорожка", "Объект", ...group.columns],
      group.rows.map((row) => [row.lane, row.source, ...row.cells])
    ), "");
  }

  if (collected.cards.length) {
    parts.push("## Карточки", "");
    parts.push(renderTable(
      ["Дорожка", "Тип", "Заголовок", "Текст", "Цвет"],
      collected.cards.map((card) => [card.lane, card.kind, card.title, card.text, card.color])
    ), "");
  }

  if (collected.edges.length) {
    parts.push("## Связи", "");
    parts.push(renderTable(
      ["Откуда", "Куда", "Стрелка"],
      collected.edges.map((edge) => [edge.from, edge.to, edge.arrow])
    ), "");
  }

  if (!parts.length) return "На доске нет ни таблиц, ни карточек.\n";
  return parts.join("\n").replace(/\n+$/, "") + "\n";
}

function collect(layout) {
  const objects = [];
  const rowRecords = [];
  const cards = [];
  const titleById = new Map();

  const walk = (node, lane) => {
    if (!node || typeof node !== "object") return;
    switch (node.type) {
      case "swimlanes":
        for (const swimlane of node.lanes ?? []) {
          walk(swimlane.content, firstLine(swimlane.title) || lane);
        }
        return;
      case "table":
        readTable(node, lane);
        return;
      case "card":
        titleById.set(node.id, firstLine(node.title) || firstLine(node.text) || node.id);
        cards.push({
          lane: lane ?? "",
          kind: node.variant === "figure" ? (node.figure ?? "фигура") : (node.variant ?? "sticker"),
          title: inline(node.title),
          text: inline(node.text),
          color: node.color ?? ""
        });
        return;
      default:
        for (const item of node.items ?? []) walk(item, lane);
    }
  };

  const readTable = (table, lane) => {
    const columns = table.columns ?? [];
    const rows = table.rows ?? [];
    const source = firstLine(table.title) || table.id || "";

    if (isKeyValue(columns)) {
      const fields = new Map();
      for (const row of rows) {
        const key = inline(row.cells?.[columns[0].id]);
        if (!key) continue;
        fields.set(key, inline(row.cells?.[columns[1].id]));
      }
      // Имя объекта — из поля «Команда»/«Название», иначе из заголовка таблицы
      // после разделителя: «Ландшафт SDD · Знания Ops» → «Знания Ops».
      const named = fields.get("Команда") || fields.get("Название") || fields.get("Объект");
      objects.push({
        lane: lane ?? "",
        name: named || afterSeparator(source),
        group: beforeSeparator(source),
        fields
      });
    } else {
      for (const row of rows) {
        rowRecords.push({
          lane: lane ?? "",
          source: afterSeparator(source) || source,
          group: beforeSeparator(source),
          columns: columns.map((column) => column.title || column.id),
          cells: columns.map((column) => inline(row.cells?.[column.id]))
        });
      }
    }

    for (const row of rows) {
      for (const nested of Object.values(row.content ?? {})) walk(nested, lane);
    }
  };

  walk(layout?.content, null);

  return {
    objectGroups: groupBy(objects, (object) => object.group, (name, list) => ({
      name: name || "Объекты",
      fields: unionFields(list),
      objects: list
    })),
    rowGroups: groupBy(rowRecords, (record) => `${record.group}�${record.columns.join("|")}`,
      (key, list) => ({ name: key.split("�")[0] || "Записи", columns: list[0].columns, rows: list })),
    cards,
    edges: (layout?.edges ?? []).map((edge) => ({
      from: titleById.get(edge.from?.id) ?? edge.from?.id ?? "",
      to: titleById.get(edge.to?.id) ?? edge.to?.id ?? "",
      arrow: edge.arrow ?? "end"
    }))
  };
}

function isKeyValue(columns) {
  if (columns.length !== 2) return false;
  const titles = columns.map((column) => String(column.title ?? "").trim().toLowerCase());
  if (KEY_VALUE_HEADERS.some(([a, b]) => titles[0] === a && titles[1] === b)) return true;
  // Колонки без заголовков в паре тоже читаются как «свойство — значение».
  return titles.every((title) => !title);
}

function unionFields(objects) {
  const fields = [];
  const seen = new Set();
  for (const object of objects) {
    for (const key of object.fields.keys()) {
      if (seen.has(key)) continue;
      seen.add(key);
      fields.push(key);
    }
  }
  return fields;
}

function groupBy(items, keyOf, build) {
  const buckets = new Map();
  for (const item of items) {
    const key = keyOf(item);
    if (!buckets.has(key)) buckets.set(key, []);
    buckets.get(key).push(item);
  }
  return [...buckets.entries()].map(([key, list]) => build(key, list));
}

const SEPARATOR = /\s+[·|—-]\s+/;

function beforeSeparator(title) {
  const parts = String(title).split(SEPARATOR);
  return parts.length > 1 ? parts[0].trim() : String(title).trim();
}

function afterSeparator(title) {
  const parts = String(title).split(SEPARATOR);
  return parts.length > 1 ? parts.slice(1).join(" · ").trim() : "";
}

function firstLine(value) {
  return String(value ?? "").split("\n")[0].trim();
}

// В ячейке Markdown-таблицы вертикальная черта рвёт разметку, а перевод строки
// заканчивает строку таблицы — оба экранируем, содержимое не теряя.
function inline(value) {
  return String(value ?? "")
    .replace(/\r?\n+/g, " / ")
    .replace(/\|/g, "\\|")
    .trim();
}

// Ширина строки, после которой выравнивание пробелами перестаёт помогать
// глазу и начинает раздувать файл: 17 колонок с ФИО дают 182 КБ пустоты.
const ALIGN_WIDTH_LIMIT = 200;

function renderTable(headers, rows) {
  const widths = headers.map((header, index) =>
    Math.max(header.length, ...rows.map((row) => String(row[index] ?? "").length), 3));
  const total = widths.reduce((sum, width) => sum + width + 3, 1);
  const align = total <= ALIGN_WIDTH_LIMIT;
  const line = (cells) => "| " + cells.map((cell, index) =>
    align ? String(cell ?? "").padEnd(widths[index]) : String(cell ?? "")).join(" | ") + " |";
  return [
    line(headers),
    "|" + widths.map((width) => "-".repeat(align ? width + 2 : 3)).join("|") + "|",
    ...rows.map((row) => line(row))
  ].join("\n");
}