import type { AuditListModel, IntegrationCatalogModel, DataTableModel, FileBrowserModel, MembersListModel, NotificationCenterModel, RolesListModel, SelectTenantModel, SessionListModel, ShellRegistries, TaskListModel, VMState, } from "@hivegrid/view-models"; export type MockPage = { readonly id: string; readonly route: string; readonly title?: string; readonly titleKey?: string; readonly description?: string; readonly descriptionKey?: string; readonly state: VMState; readonly registries?: ShellRegistries; }; export type HotSwapDrillData = { readonly cards: readonly { readonly labelKey: string; readonly value: string; readonly trend: "up" | "flat" | "down"; }[]; readonly activity: readonly { readonly labelKey: string; readonly meta: string; }[]; }; export type MockVisualSnapshot = { readonly pageId: string; readonly route: string; readonly status: string; readonly htmlHash: string; readonly moduleHash: string; readonly stateHash: string; readonly metrics: { readonly htmlBytes: number; readonly moduleBytes: number; readonly sidebarItems: number; readonly breadcrumbItems: number; readonly mobileItems: number; readonly portalItems: number; }; }; export type MockArtifacts = { readonly module: string; readonly html: string; readonly snapshot: MockVisualSnapshot; }; export function createMockPage(page: MockPage): MockPage { return page; } export function createMockRegistry(pages: readonly MockPage[] = []): ReadonlyMap { return new Map(pages.map((page) => [page.route, page])); } export function generateHotSwapMock(page: MockPage): string { return ["export const mockPage = ", stableStringify(page), ";", "export default mockPage;", ""].join("\n"); } export function generateMockPageHtml(page: MockPage): string { const stateJson = stableStringify(page.state); const stateSummary = stableStringify({ status: translateMockText(`mock.status.${page.state.status}`, page.state.status), cards: isHotSwapDrillData(page.state.data) ? page.state.data.cards.length : 0, activity: isHotSwapDrillData(page.state.data) ? page.state.data.activity.length : 0, }); const registriesJson = stableStringify(page.registries ?? {}); const title = page.titleKey ? translateMockText(page.titleKey, page.titleKey) : (page.title ?? page.id); const description = page.descriptionKey ? translateMockText(page.descriptionKey, page.descriptionKey) : (page.description ?? `mock.static.${page.id}`); const sidebarItems = page.registries?.sidebar ?? []; const breadcrumbs = page.registries?.breadcrumbs ?? []; const cards = isHotSwapDrillData(page.state.data) ? page.state.data.cards : []; const activity = isHotSwapDrillData(page.state.data) ? page.state.data.activity : []; return [ "", '', "", ' ', ' ', ` ${escapeHtml(`${translateMockText("mock.ui.documentTitle", "UI Mock")}: ${title}`)}`, " ", "", ``, `
`, ` ", '
', `
${breadcrumbs.map((item) => `${escapeHtml(translateMockText(item.labelKey, item.labelKey))}`).join("/")}
`, '
', "
", `

${escapeHtml(title)}

`, `

${escapeHtml(description)}

`, "
", `
${escapeHtml(translateMockText(`mock.status.${page.state.status}`, page.state.status))}
`, "
", `
`, ...cards.map((card) => [ '
', `

${escapeHtml(translateMockText(card.labelKey, card.labelKey))}

`, `

${escapeHtml(card.value)}

`, `
${escapeHtml(translateMockText(`mock.trend.${card.trend}`, card.trend))}
`, "
", ].join("\n") ), "
", `
`, '
    ', ...activity.map( (item) => `
  • ${escapeHtml(translateMockText(item.labelKey, item.labelKey))}${escapeHtml(item.meta)}
  • ` ), "
", "
", `
`, ` ${escapeHtml(translateMockText("mock.ui.serializedState", "Serialized state"))}`, `
${escapeHtml(stateSummary)}
`, "
", ` `, ` `, "
", "
", "", "", "", ].join("\n"); } const defaultMockTranslations: Record = { "mock.root": "Mock", "mock.phase-c.label": "Phase C", "mock.phase-c.home": "Phase C home", "mock.phase-c.summary": "Phase C summary", "mock.phase-c.hot-swap.label": "Hot swap", "mock.phase-c.hot-swap.title": "Hot swap drill", "mock.phase-c.hot-swap.description": "Static mock page used to verify hot-swap rendering.", "mock.phase-c.hot-swap.metrics.modules": "Modules", "mock.phase-c.hot-swap.metrics.snapshotHash": "Snapshot hash", "mock.phase-c.hot-swap.metrics.browserDownloads": "Browser downloads", "mock.phase-c.hot-swap.activity.generatedModule": "Generated module", "mock.phase-c.hot-swap.activity.staticArtifact": "Static artifact", "mock.phase-c.hot-swap.activity.visualSnapshot": "Visual snapshot", "mock.phase-c.hot-swap.replacement.label": "Replacement", "mock.phase-c.hot-swap.replacement.title": "Replacement hot swap drill", "mock.phase-c.hot-swap.metrics.swap": "Swap", "mock.phase-c.hot-swap.activity.registrySwap": "Registry swap", "mock.ui.documentTitle": "UI Mock", "mock.ui.sidebarAria": "Mock sidebar", "mock.ui.brand": "HiveGrid mock", "mock.ui.metricsAria": "Mock metrics", "mock.ui.activityAria": "Mock activity", "mock.ui.stateAria": "Mock state payload", "mock.ui.serializedState": "Serialized state", "mock.status.ready": "Ready", "mock.trend.up": "Up", "mock.trend.flat": "Flat", "mock.trend.down": "Down", }; function translateMockText(key: string, fallback: string) { return defaultMockTranslations[key] ?? fallback; } export function createVisualSnapshot(page: MockPage, artifacts?: { readonly html?: string; readonly module?: string }): MockVisualSnapshot { const html = artifacts?.html ?? generateMockPageHtml(page); const module = artifacts?.module ?? generateHotSwapMock(page); const state = stableStringify(page.state); return { pageId: page.id, route: page.route, status: page.state.status, htmlHash: stableHash(html), moduleHash: stableHash(module), stateHash: stableHash(state), metrics: { htmlBytes: byteLength(html), moduleBytes: byteLength(module), sidebarItems: page.registries?.sidebar?.length ?? 0, breadcrumbItems: page.registries?.breadcrumbs?.length ?? 0, mobileItems: page.registries?.mobile?.length ?? 0, portalItems: page.registries?.portals?.length ?? 0, }, }; } export function generateMockArtifacts(page: MockPage): MockArtifacts { const module = generateHotSwapMock(page); const html = generateMockPageHtml(page); return { module, html, snapshot: createVisualSnapshot(page, { html, module }), }; } export function createHotSwapDrillPage(): MockPage { return createMockPage({ id: "phase-c-hot-swap", route: "/mock/phase-c/hot-swap", titleKey: "mock.phase-c.hot-swap.title", descriptionKey: "mock.phase-c.hot-swap.description", state: { status: "ready", data: { cards: [ { labelKey: "mock.phase-c.hot-swap.metrics.modules", value: "3", trend: "up" }, { labelKey: "mock.phase-c.hot-swap.metrics.snapshotHash", value: "stable", trend: "flat" }, { labelKey: "mock.phase-c.hot-swap.metrics.browserDownloads", value: "0", trend: "down" }, ], activity: [ { labelKey: "mock.phase-c.hot-swap.activity.generatedModule", meta: "index.ts" }, { labelKey: "mock.phase-c.hot-swap.activity.staticArtifact", meta: "hot-swap.html" }, { labelKey: "mock.phase-c.hot-swap.activity.visualSnapshot", meta: "fnv1a" }, ], }, }, registries: { sidebar: [ { id: "phase-c-home", href: "/mock/phase-c", labelKey: "mock.phase-c.home" }, { id: "phase-c-hot-swap", href: "/mock/phase-c/hot-swap", labelKey: "mock.phase-c.hot-swap.label" }, ], breadcrumbs: [ { id: "mock", href: "/mock", labelKey: "mock.root" }, { id: "phase-c", href: "/mock/phase-c", labelKey: "mock.phase-c.label" }, { id: "hot-swap", href: "/mock/phase-c/hot-swap", labelKey: "mock.phase-c.hot-swap.label" }, ], mobile: [{ id: "phase-c-hot-swap", href: "/mock/phase-c/hot-swap", labelKey: "mock.phase-c.hot-swap.label", priority: 1 }], portals: [{ id: "phase-c-summary", slot: "mock.summary", labelKey: "mock.phase-c.summary", order: 1 }], }, }); } /** * Mock render implementation: renders the SAME normalized {@link DataTableModel} * data as the real Subframe impl but with deliberately different, minimal chrome * (div/row layout instead of a semantic ``). Proves the implementation is * swappable — the data travels identically, only the surrounding markup differs. * Carries only structure, data-attributes and cell data; labels stay as i18n keys. */ export function renderDataTableMock(model: DataTableModel): string { const headerCells = model.columns .map((col) => ``) .join(""); const rows = model.rowCount === 0 ? `
` : model.rows .map((row) => { const cells = model.columns .map((col) => `${escapeHtml(row.cells[col.key] ?? "")}`) .join(""); return `
${cells}
`; }) .join(""); const caption = model.captionKey ? `
` : ""; return `
${caption}
${headerCells}
${rows}
`; } /** * Mock render implementation for the files browser. Same normalized * {@link FileBrowserModel} data as the real Subframe impl, deliberately different * minimal chrome — proves the renderer is swappable (hot-swap drill, M017). */ export function renderFileBrowserMock(model: FileBrowserModel): string { const rows = model.rowCount === 0 ? `
` : model.rows .map( (row) => `
${escapeHtml(row.displayName)}
` ) .join(""); return `
${rows}
`; } /** * Mock render implementation for the reusable task list. Same normalized * {@link TaskListModel} data as the real Subframe impl, deliberately different * minimal chrome — proves the renderer is swappable (hot-swap drill, M017). */ export function renderTaskListMock(model: TaskListModel): string { const rows = model.rowCount === 0 ? `
` : model.rows .map( (row) => `
${escapeHtml(row.title)}
` ) .join(""); return `
${rows}
`; } /** * Mock render implementation for the session device list. Same normalized * {@link SessionListModel} data as the real Subframe impl, deliberately different * minimal chrome — proves the renderer is swappable (hot-swap drill, M017). */ export function renderSessionListMock(model: SessionListModel): string { const rows = model.rowCount === 0 ? `
` : model.rows .map((row) => { const label = row.deviceLabel ? escapeHtml(row.deviceLabel) : ""; return `
${label}
`; }) .join(""); return `
${rows}
`; } /** * Mock render implementation for the tenant/workspace picker. Same normalized * {@link SelectTenantModel} data as the real Subframe impl, deliberately different * minimal chrome — proves the renderer is swappable (hot-swap drill, M017). */ export function renderSelectTenantMock(model: SelectTenantModel): string { const rows = model.rowCount === 0 ? `
` : model.rows .map( (row) => `
${escapeHtml(row.name)}
` ) .join(""); return `
${rows}
`; } function isHotSwapDrillData(value: unknown): value is HotSwapDrillData { if (!value || typeof value !== "object") return false; const candidate = value as Partial; return Array.isArray(candidate.cards) && Array.isArray(candidate.activity); } function stableStringify(value: unknown, spaces = 2): string { return JSON.stringify(sortValue(value), null, spaces); } function sortValue(value: unknown): unknown { if (Array.isArray(value)) { return value.map((item) => sortValue(item)); } if (!value || typeof value !== "object") { return value; } return Object.fromEntries( Object.entries(value) .sort(([left], [right]) => left.localeCompare(right)) .map(([key, child]) => [key, sortValue(child)]) ); } function stableHash(value: string): string { let hash = 0x811c9dc5; for (let index = 0; index < value.length; index += 1) { hash ^= value.charCodeAt(index); hash = Math.imul(hash, 0x01000193); } return (hash >>> 0).toString(16).padStart(8, "0"); } function byteLength(value: string): number { let bytes = 0; for (let index = 0; index < value.length; index += 1) { const code = value.charCodeAt(index); if (code < 0x80) bytes += 1; else if (code < 0x800) bytes += 2; else if (code >= 0xd800 && code <= 0xdbff) { bytes += 4; index += 1; } else bytes += 3; } return bytes; } function escapeHtml(value: string): string { return value.replaceAll("&", "&").replaceAll("<", "<").replaceAll(">", ">").replaceAll('"', """); } function escapeAttribute(value: string): string { return escapeHtml(value).replaceAll("'", "'"); } /** * Mock render implementation for the Audit-Viewer list (AK-P3). Same * normalized {@link AuditListModel} data as the real Subframe impl, * deliberately different minimal chrome (M017 hot-swap drill proof). */ export function renderAuditListMock(model: AuditListModel): string { const rows = model.rowCount === 0 ? `
` : model.rows .map((row) => { const summary = row.summaryText ? escapeHtml(row.summaryText) : ""; return `
${escapeHtml(row.actorLabel)} ${escapeHtml(row.action)} ${summary}
`; }) .join(""); return `
${rows}
`; } /** * Mock render implementation for the Notification-Center list (AK-P3). Same * normalized {@link NotificationCenterModel} data, minimal div chrome; labels * stay i18n keys (no hardcoded copy in the mock). */ export function renderNotificationCenterMock(model: NotificationCenterModel): string { const rows = model.totalCount === 0 ? `
` : model.items .map( (item) => `
` ) .join(""); return `
${rows}
`; } /** * Mock render implementation for the members admin list (R-P2b). Same * normalized {@link MembersListModel} data as the real Subframe impl, * deliberately different minimal chrome (M017 hot-swap drill proof). */ export function renderMembersListMock(model: MembersListModel): string { const rows = model.rowCount === 0 ? `
` : model.rows .map( (row) => `
${escapeHtml(row.name)} ${escapeHtml(row.email)} ${escapeHtml(row.roleNames.join(", "))}
` ) .join(""); return `
${rows}
`; } /** * Mock render implementation for the merged roles list (R-P2b). Same * normalized {@link RolesListModel} data, minimal div chrome; type labels stay * i18n keys, capabilities + the D03 delete blocker ride as data-attributes. */ export function renderRolesListMock(model: RolesListModel): string { const rows = model.rowCount === 0 ? `
` : model.rows .map( (row) => `
${escapeHtml(row.name)}
` ) .join(""); return `
${rows}
`; } /** * Mock render implementation for the integrations catalog (R-P5). Same * normalized {@link IntegrationCatalogModel} data, minimal div chrome; titles * and categories stay i18n keys, connection counts ride as data-attributes. */ export function renderIntegrationsCatalogMock(model: IntegrationCatalogModel): string { const rows = model.rowCount === 0 ? `
` : model.rows .map( (row) => `
` ) .join(""); return `
${rows}
`; }