/*
<MODULE_CONTRACT>
<purpose>Creates a typed context object for JSON-LD node builders from a SemanticPageModel.</purpose>
<non-goals>
  <item>Do not parse or transform content.</item>
  <item>Do not fetch external data.</item>
</non-goals>
</MODULE_CONTRACT>
<CHANGE_SUMMARY>
  <item>RFC-1097: step 6 — compass.migrate codemod run

Mechanical v1 to v2 header migration across the workspace: 942 files rewritten — CHANGE_SUMMARY windows collapsed into history, forbidden v1 blocks stripped, KEY_DECISIONS seeded from @ai-invariant comments (5 files) or TODO placeholders (103 files), blocks reordered to canonical order.</item>
  <item>RFC-1097: sweep — werkstatt-engine clean

Sweep batch 4: 73 Compass headers on headerless engine files (certification, component-runtime, isolation, evolution, testing), real KEY_DECISIONS on 75 files (kernel, cache, dht, swim, gitmesh, runtime), ~80 purpose expansions (CONTRACT-02/PURPOSE-02), non-goals on 13 CONTRACT-03 files, CS-07 history literal fix repo-wide (253 files). Policy: .template.ts/.template.astro excludedPaths. werkstatt-engine now 0 diagnostics.</item>
</CHANGE_SUMMARY>
*/

import { createSemanticIds } from "../ids.ts";
import type { SemanticPageModel } from "../models.ts";

export type JsonLdContext = {
  page: SemanticPageModel;
  ids: ReturnType<typeof createSemanticIds>;
  webpageId: string;
  breadcrumbId: string;
  initiativesListId: string;
  servicesListId?: string;
  faqPageId?: string;
  collectionListId?: string;
};

export function createJsonLdContext(page: SemanticPageModel): JsonLdContext {
  const ids = createSemanticIds(new URL(page.url).origin);
  const webpageId = ids.webpage(page.url);

  return {
    page,
    ids,
    webpageId,
    breadcrumbId: ids.breadcrumb(page.url),
    initiativesListId: `${webpageId}/initiatives`,
    servicesListId: page.organization.services?.length ? `${ids.organization}/services` : undefined,
    faqPageId: page.faqEntries && page.faqEntries.length > 0 ? ids.faq(page.url) : undefined,
    collectionListId:
      page.type === "collection" && page.collectionItems?.length
        ? `${webpageId}/industries`
        : undefined,
  };
}