NestQuest/frontend/tests/render-party-board.mjs

/**
 * Render the built party-board card under jsdom and print its plates.
 *
 * Usage: node render-party-board.mjs < spec.json
 *
 * The spec JSON carries {bundle, tag, config, hass, url?, click_plate?, now?};
 * stdout receives one JSON object {plates, tappable, location, html} where
 * plates is the ordered plate list the shadow DOM renders (name +
 * present/away/unknown kind), tappable the plate names rendered as tappable
 * <button> plates, and location the window pathname after the optional plate
 * tap. With now: <ISO instant> the card's clock is pinned there
 * (argument-less new Date() and Date.now() return it; the process TZ
 * decides its local wall time). The Python panel tests drive this harness
 * so the assertions run against the exact bundle HACS ships.
 */
import { readFileSync } from "node:fs";
import { pathToFileURL } from "node:url";
import { JSDOM } from "jsdom";

const spec = JSON.parse(readFileSync(0, "utf8"));

const dom = new JSDOM("<!doctype html><html><body></body></html>", {
  url: spec.url ?? "http://homeassistant.local/nestquest/board",
  pretendToBeVisual: true,
});

// Expose the jsdom globals the Lit bundle expects. Node's own intrinsics
// (Object, Array, ...) are kept — only what globalThis lacks is copied.
for (const key of Object.getOwnPropertyNames(dom.window)) {
  if (!(key in globalThis)) {
    try {
      globalThis[key] = dom.window[key];
    } catch {
      // jsdom getters may throw on access; the card does not need them.
    }
  }
}
globalThis.window = dom.window;
// The card navigates by dispatching new Event("location-changed") on this
// window; jsdom's EventTarget rejects Node's own global Event class, so the
// jsdom Event must shadow it for the dispatched event to be delivered.
globalThis.Event = dom.window.Event;

// Pin the clock: argument-less construction and Date.now() read `pinned`,
// every other Date use is the real class.
if (spec.now !== undefined) {
  const pinned = new Date(spec.now).getTime();
  const RealDate = Date;
  class PinnedDate extends RealDate {
    constructor(...args) {
      super(...(args.length === 0 ? [pinned] : args));
    }
    static now() {
      return pinned;
    }
  }
  globalThis.Date = PinnedDate;
  dom.window.Date = PinnedDate;
}

await import(pathToFileURL(spec.bundle).href);

const element = document.createElement(spec.tag);
element.setConfig(spec.config);
element.hass = spec.hass;
document.body.appendChild(element);
await element.updateComplete;

const plateNodes = [
  ...element.shadowRoot.querySelectorAll(".plates .plate"),
];
const plates = plateNodes.map((plate) => ({
  name: plate.querySelector(".name")?.textContent?.trim() ?? "",
  kind: plate.classList.contains("unknown")
    ? "unknown"
    : plate.classList.contains("away")
      ? "away"
      : "present",
}));
const tappable = plateNodes
  .filter((plate) => plate.tagName === "BUTTON")
  .map((plate) => plate.querySelector(".name")?.textContent?.trim() ?? "");

if (spec.click_plate !== undefined) {
  const plate = plateNodes.find(
    (candidate) =>
      candidate.querySelector(".name")?.textContent?.trim() === spec.click_plate
  );
  plate?.click();
}

const payload = JSON.stringify({
  plates,
  tappable,
  location: window.location.pathname,
  html: element.shadowRoot.innerHTML,
});
await new Promise((resolve) => process.stdout.write(payload, () => resolve()));
process.exit(0);