improvise/web/tests/dispatch.test.js

// What a node in a delegated surface MEANS, and what the page bar reads as.
// Both are decisions, so neither needs a browser — context/code/clients.md.

import { test } from "node:test";
import assert from "node:assert/strict";

import { cellAction, cellAttrs, gridPlan, indexAction, pageEntries } from "../shell.js";

const cell = (text, extra = {}) => ({
  text,
  edit_text: text,
  numeric: true,
  error: false,
  selected: false,
  editable: true,
  ...extra,
});

/// The shape the row index has to survive: a group header between data rows,
/// which is exactly what walking the table back up would get wrong.
function grouped() {
  return {
    row_levels: 1,
    col_levels: [["Revenue", "Cost"]],
    col_groups: [],
    totals: [],
    editing: null,
    rows: [
      { kind: "group", label: "Hot", collapsed: false },
      { kind: "data", labels: ["Espresso"], cells: [cell("1"), cell("2")] },
      { kind: "group", label: "Cold", collapsed: true },
      {
        kind: "data",
        labels: ["Cold Brew"],
        cells: [cell("3", { editable: false }), cell("4", { edit_text: "4000" })],
      },
    ],
  };
}

test("a cell's attributes carry the plan's answers back to the handler", () => {
  const plan = gridPlan(grouped());
  const last = plan.body.at(-1).cells[1];
  const action = cellAction(cellAttrs(last), last.editable);
  assert.deepEqual(action, { row: 1, col: 1, editable: true, editText: "4000" });
});

// improvise-b8ot: the DATA row index is what a click sends, and `gridPlan`
// counts it because a group header is not a data row. A delegated handler
// that inferred the row from the node's position in the table would say 3.
test("the row a delegated click means is the data index, not the table row", () => {
  const plan = gridPlan(grouped());
  const rows = plan.body
    .filter((r) => r.kind === "data")
    .map((r) => cellAction(cellAttrs(r.cells[0]), r.cells[0].editable).row);
  assert.deepEqual(rows, [0, 1]);
});

test("editable is the class, so an unsettable cell opens no editor", () => {
  const plan = gridPlan(grouped());
  const aggregate = plan.body.at(-1).cells[0];
  assert.equal(aggregate.classes.editable, false);
  assert.equal(cellAction(cellAttrs(aggregate), false).editable, false);
});

// Every header, the corner and the totals strip reach the delegated handler
// too. None of them is a cell, and `Number("")` is 0 rather than nothing.
test("a node carrying no coordinates means nothing at all", () => {
  assert.equal(cellAction({}, false), null);
  assert.equal(cellAction({ row: "0" }, false), null);
  assert.equal(cellAction({ row: "", col: "" }, false), null);
  assert.equal(cellAction({ row: "x", col: "0" }, false), null);
  assert.equal(cellAction({ row: "1.5", col: "0" }, false), null);
});

test("an index surface reads its row back, and nothing else", () => {
  assert.equal(indexAction({ index: "0" }), 0);
  assert.equal(indexAction({ index: "12" }), 12);
  assert.equal(indexAction({}), null);
  assert.equal(indexAction({ index: "" }), null);
  assert.equal(indexAction({ index: "-1" }), null);
});

// improvise-p7lh: a grid filtered to Q1 said nothing at all, and `[`/`]`
// moved it in silence. The bar is what says which quarter this is.
test("the page bar names the category and the item it is fixed to", () => {
  const [entry] = pageEntries({
    page_coords: [{ cat: "Quarter", selected: "Q2", cycle: { at: 1, count: 4 } }],
  });
  assert.equal(entry.text, "Quarter = Q2");
  assert.equal(entry.position, "2/4", "one-based, as a user counts");
  assert.equal(entry.navigable, true);
});

// Gotcha 27: Page is navigable and Filter is not. A Filter axis offers no
// position, because there is no key that would move it.
test("a filter axis is shown, and is not offered as something to cycle", () => {
  const [entry] = pageEntries({
    page_coords: [{ cat: "Region", selected: "North", cycle: null }],
  });
  assert.equal(entry.text, "Region = North");
  assert.equal(entry.position, "");
  assert.equal(entry.navigable, false);
});

test("no fixed categories is an empty bar, not a blank one", () => {
  assert.deepEqual(pageEntries({ page_coords: [] }), []);
});