{ buildNpmPackage }:

# Static build of the swarm-level UI shell (project-bootstrap scope:
# empty start page, no functionality yet — see
# frontend/packages/swarm-ui/package.json for the full rationale).
# Stack: Preact + wouter + TypeScript + JSX, a real SPA shell with
# routing/deep-links, distinct from the per-hive dashboard's
# vanilla-JS + custom-element MPA.
#
# Deliberately its OWN package, not folded into `./frontend.nix`
# (which bundles dashboard + agent into `packages.default`'s closure):
# swarm-ui is swarm-scoped, same reasoning `swarm-controller`/`swarmctl`
# already use for staying out of `daemonBins` — a hive that doesn't run
# the swarm controller shouldn't carry swarm-ui bytes in its closure.
#
# Not yet consumed anywhere: swarm-controller only serves `/health`
# today (swarm-controller/README.md) — this just makes the static
# build a buildable, packageable artifact so the wiring (once auth
# against authelia is figured out) has something to point at.
#
# Shares `frontend/package-lock.json` with `./frontend.nix` (same repo,
# same npm workspace root) — `npmDepsHash` must be updated in lockstep
# with that file's whenever the lockfile changes, since both hash the
# same file. Scoped to build only the `swarm-ui` workspace (not the
# whole `npm run build --workspaces` frontend.nix runs) via an explicit
# `npm run build --workspace=…` buildPhase, so a dashboard/agent-only
# change doesn't need to rebuild (or re-review the output of) this
# derivation.

buildNpmPackage {
  pname = "hyperhive-swarm-ui";
  version = "0.0.0";
  src = ../../frontend;

  # Recompute with `prefetch-npm-deps frontend/package-lock.json`
  # whenever the lockfile changes — same value as `./frontend.nix`'s
  # `npmDepsHash`, both hash the one shared lockfile.
  npmDepsHash = "sha256-LIwW5Nn9cSqJHCm1czPIVxQdP5OqWk7U/4kvkwaj2ts=";

  buildPhase = ''
    runHook preBuild
    npm run build --workspace=packages/swarm-ui
    runHook postBuild
  '';

  dontNpmInstall = true;
  installPhase = ''
    runHook preInstall
    mkdir -p $out
    cp -r packages/swarm-ui/dist/. $out/
    runHook postInstall
  '';

  meta = {
    description = "hyperhive swarm-level UI static frontend build (bootstrap — empty start page)";
    homepage = "https://forge.darkest.space/hyperhive/hyperhive";
  };
}