mapa-mental-core

Constrói árvore hierárquica a partir de array plano de objetos (rows). Genérico: aceita qualquer schema — você define os níveis da árvore via levels.

Zero dependências. JS puro. Node 12+.

Install

npm install mapa-mental-core
# ou local:
npm install file:../mapa-mental-core

Uso básico

const { buildTree } = require('mapa-mental-core');

const rows = [
  { cliente: 'Alpha Ltda', pedido: '00123', material: 'Aço', espessura: 6.35, status: 'pendente' },
  { cliente: 'Beta S.A.',  pedido: '00456', material: 'Inox', espessura: 3.00, status: 'finalizado' },
];

const result = buildTree(rows, {
  levels: [
    { text: r => r.cliente,                   dedup: { words: 3 } },
    { text: r => r.pedido || 'Sem pedido',    trimZero: true },
    { text: r => `${r.material} ${r.espessura.toFixed(2)}` }
  ],
  color: leafRows => piorStatus(leafRows.map(r => r.status), colorMap)
});
// → { treeData, contagem }

API

buildTree(rows, opts)

rows (obrigatório)

Array de objetos. Qualquer schema — você mapeia via levels.

opts.levels (obrigatório)

Array de nível, um por profundidade (raiz → folha).

| Propriedade | Tipo | Descrição | |---|---|---| | text(row) | fn | Obrigatório. Extrai label do nó | | dedup | object | { words: N } abrevia pra N palavras + contador se duplicar | | trimZero | boolean | Remove zeros à esquerda do texto |

Exemplo:

levels: [
  { text: r => r.cliente_nome,  dedup: { words: 3 } },  // profundidade 0
  { text: r => r.pedido_codigo, trimZero: true },        // profundidade 1
  { text: r => `${r.material} ${r.espessura_mm}` }       // profundidade 2 (folha)
]

opts.color (opcional)

color(leafRows) → string (hex)

Função chamada para cada grupo de rows que caiu na mesma folha. Retorna cor hex para colorir o nó. Se omitido, nós folha não têm _cor.

color: leafRows => {
  const map = { pendente: '#cbd5e1', finalizado: '#bbf7d0' };
  return map[leafRows[0].status] || '#ccc';
}

Output

{
  treeData: {
    text: "root",
    children: [{
      text: "Alpha Ltda",           // profundidade 0
      children: [{
        text: "123",                // profundidade 1 (trimZero)
        children: [{
          text: "Aço 6.35",         // profundidade 2 (folha)
          _cor: "#cbd5e1"           // só se opts.color foi fornecido
        }]
      }]
    }]
  },
  contagem: {                       // cor → qtd de folhas com essa cor
    "#cbd5e1": 1,
    "#bbf7d0": 1
  }
}

piorStatus(statuses, colorMap)

Retorna cor hex do pior status (menor idx no colorMap).

const { piorStatus } = require('mapa-mental-core');

const colorMap = {
  pendente:   { idx: 0, cor: '#cbd5e1' },
  em_corte:   { idx: 3, cor: '#fde047' },
  finalizado: { idx: 5, cor: '#bbf7d0' }
};

piorStatus(['finalizado', 'em_corte', 'pendente'], colorMap);
// → '#cbd5e1'  (pendente é o pior)

Licença MIT