import type {
  DocumentLiveMapCapture,
  HostedLiveMapLibrariesSnapshot,
  LiveMapLibrariesSnapshot,
} from "../../types/livemap.types.js";
import type { LocusSnapshotEnvelope } from "../../types/locus.representation.types.js";

declare const BROWSER_REALIZATION_HTML: unique symbol;

/**
 * HTML produced by the browser-realization composition path.
 *
 * The brand distinguishes this parser-compatible output from Hson transport
 * HTML. It makes no sanitization, trust, XSS, CSP, or authentication claim.
 */
export type BrowserRealizationHtml = string & Readonly<{
  [BROWSER_REALIZATION_HTML]: true;
}>;

/** One local canonical cut and the browser-realization HTML derived from it. */
export type DocumentSsr = Readonly<{
  html: BrowserRealizationHtml;
  bootstrap: DocumentLiveMapCapture<"document">;
}>;

/** One hosted semantic cut and the browser-realization HTML derived from it. */
export type HostedDocumentSsr = Readonly<{
  html: BrowserRealizationHtml;
  bootstrap: Extract<LocusSnapshotEnvelope, { hson: string }> & Readonly<{ mode: "document" }>;
}>;

/** One selected document realization paired with its complete local Libraries cut. */
export type LibrariesDocumentSsr = Readonly<{
  html: BrowserRealizationHtml;
  bootstrap: LiveMapLibrariesSnapshot;
  document: string;
}>;

/** One selected document realization paired with its complete hosted Libraries cut. */
export type HostedLibrariesDocumentSsr = Readonly<{
  html: BrowserRealizationHtml;
  bootstrap: HostedLiveMapLibrariesSnapshot;
  document: string;
}>;