Track HiveGrid Cloud planning reference

This commit is contained in:
david committed 2026-06-26 20:48:01 +02:00
1 parent b3d5ea6764
commit e341c5938a
5784 files changed
+1104929 -3

No files matched your search

@@ -0,0 +1,56 @@
import "@testing-library/jest-dom";
import { render, screen } from "@testing-library/react";
import { describe, expect, it } from "vitest";
import { createHotSwapDrillPage } from "@toolctrl/ui-mock";
import { HotSwapPageRenderer } from "./HotSwapPageRenderer";
describe("HotSwapPageRenderer", () => {
it("renders the ui-mock hot-swap drill descriptor through the ui-app registry shell", () => {
const descriptor = createHotSwapDrillPage();
const { container } = render(<HotSwapPageRenderer descriptor={descriptor} />);
const shell = container.querySelector('[data-ui-shell="hot-swap"]');
expect(shell).not.toBeNull();
expect(shell?.getAttribute("data-ui-source")).toBe("ui-app-registry");
expect(shell?.getAttribute("data-page-id")).toBe(descriptor.id);
expect(shell?.getAttribute("data-page-route")).toBe(descriptor.route);
expect(shell?.getAttribute("data-page-status")).toBe(descriptor.state.status);
});
it("derives counts from the descriptor registries via createShellRegistries", () => {
const descriptor = createHotSwapDrillPage();
const { container } = render(<HotSwapPageRenderer descriptor={descriptor} />);
const shell = container.querySelector('[data-ui-shell="hot-swap"]');
expect(shell?.getAttribute("data-sidebar-count")).toBe(String(descriptor.registries?.sidebar?.length ?? 0));
expect(shell?.getAttribute("data-breadcrumb-count")).toBe(String(descriptor.registries?.breadcrumbs?.length ?? 0));
expect(shell?.getAttribute("data-mobile-count")).toBe(String(descriptor.registries?.mobile?.length ?? 0));
expect(shell?.getAttribute("data-portal-count")).toBe(String(descriptor.registries?.portals?.length ?? 0));
});
it("renders each descriptor section (sidebar, breadcrumbs, header, cards, activity)", () => {
const descriptor = createHotSwapDrillPage();
const { container } = render(<HotSwapPageRenderer descriptor={descriptor} />);
expect(container.querySelector('[data-section="sidebar"]')).not.toBeNull();
expect(container.querySelector('[data-section="breadcrumbs"]')).not.toBeNull();
expect(container.querySelector('[data-section="header"]')).not.toBeNull();
expect(container.querySelector('[data-section="cards"]')).not.toBeNull();
expect(container.querySelector('[data-section="activity"]')).not.toBeNull();
const cards = container.querySelectorAll('[data-section="cards"] [data-card-value]');
expect(cards.length).toBe(descriptor.state.data?.cards.length ?? 0);
const activityItems = container.querySelectorAll('[data-section="activity"] li');
expect(activityItems.length).toBe(descriptor.state.data?.activity.length ?? 0);
});
it("renders the label keys from the descriptor as text nodes", () => {
const descriptor = createHotSwapDrillPage();
render(<HotSwapPageRenderer descriptor={descriptor} />);
// The renderer surfaces translation keys verbatim so the i18n layer can hydrate them later.
expect(screen.getByText(descriptor.titleKey!)).toBeInTheDocument();
expect(screen.getByText(descriptor.descriptionKey!)).toBeInTheDocument();
});
});
@@ -0,0 +1,81 @@
import type { ReactElement } from "react";
import { createShellRegistries } from "@toolctrl/ui-app";
import type { HotSwapDrillData, MockPage } from "@toolctrl/ui-mock";
export type HotSwapPageRendererProps = {
readonly descriptor: MockPage<HotSwapDrillData>;
};
function isHotSwapDrillData(value: unknown): value is HotSwapDrillData {
if (!value || typeof value !== "object") return false;
const candidate = value as Partial<HotSwapDrillData>;
return Array.isArray(candidate.cards) && Array.isArray(candidate.activity);
}
export function HotSwapPageRenderer({ descriptor }: HotSwapPageRendererProps): ReactElement {
const registries = createShellRegistries(descriptor.registries);
const titleKey = descriptor.titleKey ?? descriptor.title ?? descriptor.id;
const descriptionKey = descriptor.descriptionKey ?? descriptor.description ?? `${descriptor.id}.description`;
const data = isHotSwapDrillData(descriptor.state.data) ? descriptor.state.data : null;
return (
<section
data-ui-shell="hot-swap"
data-ui-source="ui-app-registry"
data-page-id={descriptor.id}
data-page-route={descriptor.route}
data-page-status={descriptor.state.status}
data-sidebar-count={registries.sidebar.length}
data-breadcrumb-count={registries.breadcrumbs.length}
data-mobile-count={registries.mobile.length}
data-portal-count={registries.portals.length}
>
<nav data-section="sidebar" aria-label={titleKey}>
<ul>
{registries.sidebar.map((item) => (
<li key={item.id} data-sidebar-id={item.id}>
<a href={item.href} data-label-key={item.labelKey}>
{item.labelKey}
</a>
</li>
))}
</ul>
</nav>
<ol data-section="breadcrumbs" aria-label={`${descriptor.id}.breadcrumbs`}>
{registries.breadcrumbs.map((item) => (
<li key={item.id} data-breadcrumb-id={item.id} data-label-key={item.labelKey}>
{item.labelKey}
</li>
))}
</ol>
<header data-section="header">
<h1 data-label-key={titleKey}>{titleKey}</h1>
<p data-label-key={descriptionKey}>{descriptionKey}</p>
</header>
<section data-section="cards" aria-label={`${descriptor.id}.cards`}>
{(data?.cards ?? []).map((card, index) => (
<article
key={`${card.labelKey}-${index}`}
data-card-trend={card.trend}
data-label-key={card.labelKey}
>
<p data-card-label data-label-key={card.labelKey}>
{card.labelKey}
</p>
<p data-card-value>{card.value}</p>
</article>
))}
</section>
<section data-section="activity" aria-label={`${descriptor.id}.activity`}>
<ul>
{(data?.activity ?? []).map((entry, index) => (
<li key={`${entry.labelKey}-${index}`} data-label-key={entry.labelKey}>
<span data-label-key={entry.labelKey}>{entry.labelKey}</span>
<span data-meta>{entry.meta}</span>
</li>
))}
</ul>
</section>
</section>
);
}