Files
archie/ui/test/nav-tree.test.ts
T
sam a779a4e8a2 feat(ui): give organisation, instance and account clear homes
The Access area mixed organisation, instance and personal settings under
one name. Split them: /org is the organisation's own area (members,
identities, connections, models, schedules, playbooks), /settings is
instance administration only, and personal security stays in the account
menu. Setup checklist steps now link to the page that fixes them.
2026-10-17 09:01:41 +11:00

126 lines
3.8 KiB
TypeScript

import assert from "node:assert/strict";
import test from "node:test";
import { buildNav, flattenRoutes, type NavRoute, type NavSpec } from "../src/lib/nav-tree.ts";
const table: NavRoute[] = [
{ path: "/", meta: { label: "Dashboard" } },
{ path: "/tasks", meta: { label: "Tasks" } },
{ path: "/settings/models", meta: { label: "Models" } },
{ path: "/settings/skills", meta: { label: "Skills" } },
{ path: "/settings/channels", meta: { label: "Channels" } },
{ path: "/logs", meta: { label: "Logs" } },
];
const specs: NavSpec[] = [
{ kind: "link", path: "/" },
{ kind: "link", path: "/tasks" },
{
kind: "group",
label: "Settings",
sections: [
{ label: "Agents", paths: ["/settings/models", "/settings/skills"] },
{ label: "Integrations", paths: ["/settings/channels"] },
],
},
];
test("each settings section labels its first visible item", () => {
const nav = buildNav(table, specs, ["/settings/models"]);
const group = nav.tree.find((n) => n.kind === "group");
assert.ok(group && group.kind === "group");
assert.deepEqual(
group.items.map((i) => [i.path, i.dividerBefore]),
[
["/settings/skills", "Agents"],
["/settings/channels", "Integrations"],
],
);
});
test("a section with every item hidden leaves no label behind", () => {
const nav = buildNav(table, specs, ["/settings/models", "/settings/skills"]);
const group = nav.tree.find((n) => n.kind === "group");
assert.ok(group && group.kind === "group");
assert.deepEqual(
group.items.map((i) => [i.path, i.dividerBefore]),
[["/settings/channels", "Integrations"]],
);
});
test("a group with every item hidden is dropped", () => {
const nav = buildNav(table, specs, [
"/settings/models",
"/settings/skills",
"/settings/channels",
]);
assert.deepEqual(
nav.tree.map((n) => (n.kind === "link" ? n.entry.path : n.label)),
["/", "/tasks"],
);
});
test("jump targets add unlisted pages to what the bar reaches", () => {
const nav = buildNav(table, specs, [], ["/logs"]);
assert.deepEqual(
nav.jumpTargets.map((e) => e.path),
["/", "/tasks", "/settings/models", "/settings/skills", "/settings/channels", "/logs"],
);
assert.deepEqual(buildNav(table, specs, ["/logs"], ["/logs"]).jumpTargets.map((e) => e.path).includes("/logs"), false);
});
test("a spec naming a missing route fails loudly", () => {
assert.throws(() => buildNav(table, [{ kind: "link", path: "/nope" }]), /\/nope/);
});
test("a nav spec names the address the browser visits, not the child's own path", () => {
const flat = flattenRoutes([
{
path: "/org",
children: [
{ path: "", meta: { label: "Overview" } },
{ path: "agents", meta: { label: "Agents" } },
{
path: "settings/keys",
children: [{ path: "new", meta: { label: "New" } }],
},
],
},
{ path: "/absolute", children: [{ path: "/absolute/child" }] },
]);
assert.deepEqual(
flat.map((r) => r.path),
["/org", "/org", "/org/agents", "/org/settings/keys", "/org/settings/keys/new", "/absolute", "/absolute/child"],
);
});
test("a link spec may label the entry differently from the route", () => {
const nav = buildNav(table, [{ kind: "link", path: "/", label: "Home" }]);
assert.deepEqual(
nav.tree.map((n) => (n.kind === "link" ? n.entry.label : n.label)),
["Home"],
);
});
test("an unlabelled section marks its first item with an empty divider", () => {
const nav = buildNav(table, [
{
kind: "group",
label: "Settings",
sections: [
{ label: "Agents", paths: ["/settings/models"] },
{ paths: ["/logs"] },
],
},
]);
const group = nav.tree[0];
assert.ok(group && group.kind === "group");
assert.deepEqual(
group.items.map((i) => [i.path, i.dividerBefore]),
[
["/settings/models", "Agents"],
["/logs", ""],
],
);
});