@scalemule/news-publication 0.0.67 → 0.0.69

package/dist/story-review.cjs

@@ -4,6 +4,38 @@
 var react = require('react');
 var jsxRuntime = require('react/jsx-runtime');
 
+// src/article-presentation.ts
+var standard = {
+  id: "standard",
+  version: 1,
+  name: "Standard article",
+  renderer: "standard",
+  hero_aspect: "landscape",
+  headline_position: "before_hero",
+  wide_body: false
+};
+var formats = [
+  "news",
+  "brief",
+  "explainer",
+  "interview",
+  "opinion",
+  "photo_essay",
+  "video_story"
+];
+function articlePresentation(value) {
+  const l = value?.layout;
+  if (!l || !/^[a-z0-9_-]{1,80}$/.test(l.id) || !Number.isInteger(l.version) || l.version < 1 || !["standard", "feature", "portrait"].includes(l.renderer) || !["landscape", "portrait", "square"].includes(l.hero_aspect) || !["before_hero", "after_hero"].includes(l.headline_position) || typeof l.wide_body !== "boolean") {
+    return { layout: standard };
+  }
+  return {
+    format: value?.format && formats.includes(value.format) ? value.format : void 0,
+    layout: l
+  };
+}
+function articleFormatLabel(format) {
+  return format === "opinion" ? "Opinion" : format === "explainer" ? "Explainer" : format === "interview" ? "Interview" : format === "photo_essay" ? "Photo essay" : format === "video_story" ? "Video story" : void 0;
+}
 var stable = (value) => Array.isArray(value) ? value.map(stable) : value && typeof value === "object" ? Object.fromEntries(Object.keys(value).sort().map((k) => [k, stable(value[k])])) : value;
 var same = (a, b) => JSON.stringify(stable(a)) === JSON.stringify(stable(b));
 var hasDraft = (data) => !!data && Object.keys(data).length > 0;
@@ -509,6 +541,7 @@ function EditorialNotices({ editorial }) {
     ] }, i))
   ] }) : null;
 }
+var ReviewMediaSession = react.createContext(false);
 var human = (s) => s.toLowerCase().replaceAll("_", " ");
 function StoryReview({
   sessionId,
@@ -518,10 +551,14 @@ function StoryReview({
   publicationFooter,
   readerAccountUrl,
   renderSignIn,
-  feedbackEmail
+  feedbackEmail,
+  initialReview,
+  onReviewLoaded,
+  formatImageCaption = (value) => value || ""
 }) {
   const base = `/api/news/review/${encodeURIComponent(sessionId)}`;
-  const [review, setReview] = react.useState(null), [error, setError] = react.useState(""), [notice, setNotice] = react.useState(""), [busy, setBusy] = react.useState(false), [panel, setPanelState] = react.useState("article"), [verification, setVerification] = react.useState(false), [code, setCode] = react.useState("");
+  const [mediaSessionReady, setMediaSessionReady] = react.useState(false);
+  const [review, setReview] = react.useState(initialReview ?? null), [error, setError] = react.useState(""), [notice, setNotice] = react.useState(""), [busy, setBusy] = react.useState(false), [panel, setPanelState] = react.useState("article"), [verification, setVerification] = react.useState(false), [code, setCode] = react.useState("");
   const [shareUrl, setShareUrl] = react.useState(""), [canShare, setCanShare] = react.useState(false);
   const [contributorName, setContributorName] = react.useState(""), [contributorEmail, setContributorEmail] = react.useState("");
   const [identityStep, setIdentityStep] = react.useState("name"), [requestedPanel, setRequestedPanel] = react.useState("comment");
@@ -576,6 +613,9 @@ function StoryReview({
   const responseRef = react.useRef(null);
   const thanksRef = react.useRef(null);
   const [moreQuestions, setMoreQuestions] = react.useState(false);
+  react.useEffect(() => {
+    if (review) onReviewLoaded?.(review);
+  }, [review, onReviewLoaded]);
   const [replacementPhoto, setReplacementPhoto] = react.useState(null);
   const photoToReplace = pendingPhoto.photo?.replacement || replacementPhoto;
   function openMedia(photo = null) {
@@ -655,6 +695,7 @@ function StoryReview({
       setReview(null);
     } else {
       setVerification(false);
+      setMediaSessionReady(true);
       setReview(data);
     }
   }
@@ -696,7 +737,7 @@ function StoryReview({
         const token = new URL(window.location.href).searchParams.get("key") || (/^[a-f0-9]{64}$/.test(window.location.hash.slice(1)) ? window.location.hash.slice(1) : void 0);
         let exchange = {};
         try {
-          exchange = await request("/session", token ? { token } : {});
+          exchange = await request("/session", { ...token ? { token } : {}, include_review: true });
         } catch (e) {
           if (token) throw e;
         }
@@ -713,13 +754,14 @@ function StoryReview({
             }
           }
         }
-        const data = await request();
+        const data = exchange.review ?? await request();
         if (active) {
           if (data.verification_required) {
             setVerification(true);
             setReview(null);
           } else {
             setVerification(false);
+            setMediaSessionReady(true);
             setReview(data);
           }
         }
@@ -880,10 +922,29 @@ function StoryReview({
     /* @__PURE__ */ jsxRuntime.jsx("a", { href: emailLink, children: "Email the newsroom" }),
     ". Your email app will open; send your message there."
   ] });
-  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: `sm-review-frame${publicationHeader ? " sm-review-publication-frame" : ""}`, children: [
+  const presentation = articlePresentation(review?.presentation);
+  const formatLabel = articleFormatLabel(presentation.format);
+  const sourceHero = review?.revision.document.media.filter((m) => m.position === "hero").map((m) => /* @__PURE__ */ jsxRuntime.jsx(
+    PrivatePhoto,
+    {
+      media: m,
+      base,
+      onChange: can("UPLOAD_MEDIA") ? () => openMedia(m) : void 0,
+      onSuggestCorrection: can("REQUEST_CHANGES") ? () => openCorrection(m) : void 0,
+      disabled: busy
+    },
+    m.file_id
+  ));
+  const generated = review?.generated_visual;
+  const hero = sourceHero?.length ? sourceHero : generated && /^https:\/\//.test(generated.url) ? /* @__PURE__ */ jsxRuntime.jsxs("figure", { children: [
+    /* @__PURE__ */ jsxRuntime.jsx("img", { src: generated.url, alt: formatImageCaption(generated.alt) || review?.revision.document.title || "Article illustration" }),
+    formatImageCaption(generated.caption) && /* @__PURE__ */ jsxRuntime.jsx("figcaption", { children: formatImageCaption(generated.caption) })
+  ] }) : null;
+  const heroBeforeHeadline = presentation.layout.headline_position === "after_hero";
+  return /* @__PURE__ */ jsxRuntime.jsx(ReviewMediaSession.Provider, { value: mediaSessionReady, children: /* @__PURE__ */ jsxRuntime.jsxs("div", { className: `sm-review-frame${publicationHeader ? " sm-review-publication-frame" : ""}`, children: [
     /* @__PURE__ */ jsxRuntime.jsx("div", { className: "sm-review-banner-wrap", children: /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "sm-review-private", children: [
-      /* @__PURE__ */ jsxRuntime.jsx("strong", { children: review?.published ? "Private review" : "Private preview \xB7 Not published" }),
-      /* @__PURE__ */ jsxRuntime.jsx("span", { children: review?.published ? "This revision has been published. This review link remains private." : `Prepared by ${publicationName} for ${celebration ? "family " : ""}review.` })
+      /* @__PURE__ */ jsxRuntime.jsx("strong", { children: review?.article_published || review?.published ? "Private review" : "Private preview \xB7 Not published" }),
+      /* @__PURE__ */ jsxRuntime.jsx("span", { children: review?.published ? "This revision has been published. This review link remains private." : review?.article_published ? "The article is published. This private link preserves the version you were invited to review." : `Prepared by ${publicationName} for ${celebration ? "family " : ""}review.` })
     ] }) }),
     publicationHeader ?? /* @__PURE__ */ jsxRuntime.jsx("div", { className: "sm-review-brand-wrap", children: /* @__PURE__ */ jsxRuntime.jsxs("header", { className: "sm-review-masthead", children: [
       nameplateUrl && /* @__PURE__ */ jsxRuntime.jsx("img", { src: nameplateUrl, alt: "", width: 80, height: 80 }),
@@ -1030,117 +1091,118 @@ function StoryReview({
             "newsroom for final editorial review. It has not been published yet."
           ] })
         ] }),
-        /* @__PURE__ */ jsxRuntime.jsxs("article", { className: "sm-review-article", children: [
-          /* @__PURE__ */ jsxRuntime.jsxs("p", { className: "sm-review-category", children: [
-            /* @__PURE__ */ jsxRuntime.jsx("span", { children: review.revision.document.section }),
-            celebration && /* @__PURE__ */ jsxRuntime.jsx("span", { children: human(review.celebration_type || "") })
-          ] }),
-          /* @__PURE__ */ jsxRuntime.jsx("h1", { children: review.revision.document.title }),
-          /* @__PURE__ */ jsxRuntime.jsx("p", { className: "sm-review-dek", children: review.revision.document.subtitle }),
-          /* @__PURE__ */ jsxRuntime.jsx(EditorialNotices, { editorial: review.revision.editorial }),
-          review.revision.document.media.filter((m) => m.position === "hero").map((m) => /* @__PURE__ */ jsxRuntime.jsx(
-            PrivatePhoto,
-            {
-              media: m,
-              base,
-              onChange: can("UPLOAD_MEDIA") ? () => openMedia(m) : void 0,
-              onSuggestCorrection: can("REQUEST_CHANGES") ? () => openCorrection(m) : void 0,
-              disabled: busy
-            },
-            m.file_id
-          )),
-          celebration && !review.revision.document.media.some(
-            (m) => m.position === "hero"
-          ) && can("UPLOAD_MEDIA") && /* @__PURE__ */ jsxRuntime.jsxs(
-            "aside",
-            {
-              className: "sm-review-photo-invitation",
-              "aria-label": "Family photograph",
-              children: [
-                /* @__PURE__ */ jsxRuntime.jsxs("div", { children: [
-                  /* @__PURE__ */ jsxRuntime.jsx("strong", { children: "A photograph makes it yours." }),
-                  /* @__PURE__ */ jsxRuntime.jsx("p", { children: "Family photograph may be added before publication." })
-                ] }),
-                /* @__PURE__ */ jsxRuntime.jsx("button", { onClick: () => openMedia(), children: "+ Add a photograph" })
-              ]
-            }
-          ),
-          (() => {
-            const blocks = parseDocumentBlocks({
-              content_markdown: review.revision.document.content_markdown,
-              media: review.revision.document.media,
-              blocks: review.revision.document.blocks
-            });
-            const mediaMap = /* @__PURE__ */ new Map();
-            for (const m of review.revision.document.media) {
-              mediaMap.set(m.file_id, m);
-              if (m.contribution_id) mediaMap.set(m.contribution_id, m);
-            }
-            return /* @__PURE__ */ jsxRuntime.jsx("div", { className: "sm-review-prose", children: blocks.length === 0 && review.revision.content_html ? /* @__PURE__ */ jsxRuntime.jsx("div", { dangerouslySetInnerHTML: { __html: review.revision.content_html } }) : blocks.map((block, idx) => {
-              switch (block.type) {
-                case "paragraph":
-                  return /* @__PURE__ */ jsxRuntime.jsx(
-                    "p",
-                    {
-                      dangerouslySetInnerHTML: { __html: block.html }
-                    },
-                    idx
-                  );
-                case "heading": {
-                  if (block.level === 1)
-                    return /* @__PURE__ */ jsxRuntime.jsx("h1", { dangerouslySetInnerHTML: { __html: block.html } }, idx);
-                  if (block.level === 2)
-                    return /* @__PURE__ */ jsxRuntime.jsx("h2", { dangerouslySetInnerHTML: { __html: block.html } }, idx);
-                  if (block.level === 3)
-                    return /* @__PURE__ */ jsxRuntime.jsx("h3", { dangerouslySetInnerHTML: { __html: block.html } }, idx);
-                  if (block.level === 4)
-                    return /* @__PURE__ */ jsxRuntime.jsx("h4", { dangerouslySetInnerHTML: { __html: block.html } }, idx);
-                  if (block.level === 5)
-                    return /* @__PURE__ */ jsxRuntime.jsx("h5", { dangerouslySetInnerHTML: { __html: block.html } }, idx);
-                  return /* @__PURE__ */ jsxRuntime.jsx("h6", { dangerouslySetInnerHTML: { __html: block.html } }, idx);
+        /* @__PURE__ */ jsxRuntime.jsxs(
+          "article",
+          {
+            className: "sm-review-article",
+            "data-article-layout": presentation.layout.renderer,
+            "data-wide-body": presentation.layout.wide_body,
+            "data-hero-aspect": presentation.layout.hero_aspect,
+            children: [
+              heroBeforeHeadline && /* @__PURE__ */ jsxRuntime.jsx("div", { className: "sm-review-hero", children: hero }),
+              /* @__PURE__ */ jsxRuntime.jsxs("p", { className: "sm-review-category", children: [
+                /* @__PURE__ */ jsxRuntime.jsx("span", { children: review.revision.document.section }),
+                formatLabel && /* @__PURE__ */ jsxRuntime.jsx("span", { children: formatLabel }),
+                celebration && /* @__PURE__ */ jsxRuntime.jsx("span", { children: human(review.celebration_type || "") })
+              ] }),
+              /* @__PURE__ */ jsxRuntime.jsx("h1", { children: review.revision.document.title }),
+              /* @__PURE__ */ jsxRuntime.jsx("p", { className: "sm-review-dek", children: review.revision.document.subtitle }),
+              /* @__PURE__ */ jsxRuntime.jsx(EditorialNotices, { editorial: review.revision.editorial }),
+              !heroBeforeHeadline && /* @__PURE__ */ jsxRuntime.jsx("div", { className: "sm-review-hero", children: hero }),
+              celebration && !review.revision.document.media.some(
+                (m) => m.position === "hero"
+              ) && can("UPLOAD_MEDIA") && /* @__PURE__ */ jsxRuntime.jsxs(
+                "aside",
+                {
+                  className: "sm-review-photo-invitation",
+                  "aria-label": "Family photograph",
+                  children: [
+                    /* @__PURE__ */ jsxRuntime.jsxs("div", { children: [
+                      /* @__PURE__ */ jsxRuntime.jsx("strong", { children: "A photograph makes it yours." }),
+                      /* @__PURE__ */ jsxRuntime.jsx("p", { children: "Family photograph may be added before publication." })
+                    ] }),
+                    /* @__PURE__ */ jsxRuntime.jsx("button", { onClick: () => openMedia(), children: "+ Add a photograph" })
+                  ]
                 }
-                case "quote":
-                  return /* @__PURE__ */ jsxRuntime.jsxs("blockquote", { children: [
-                    /* @__PURE__ */ jsxRuntime.jsx("p", { dangerouslySetInnerHTML: { __html: block.html } }),
-                    block.attribution && /* @__PURE__ */ jsxRuntime.jsx("cite", { children: block.attribution })
-                  ] }, idx);
-                case "list":
-                  return block.ordered ? /* @__PURE__ */ jsxRuntime.jsx("ol", { children: block.items.map((it, i) => /* @__PURE__ */ jsxRuntime.jsx("li", { dangerouslySetInnerHTML: { __html: it } }, i)) }, idx) : /* @__PURE__ */ jsxRuntime.jsx("ul", { children: block.items.map((it, i) => /* @__PURE__ */ jsxRuntime.jsx("li", { dangerouslySetInnerHTML: { __html: it } }, i)) }, idx);
-                case "divider":
-                  return /* @__PURE__ */ jsxRuntime.jsx("hr", {}, idx);
-                case "inline_media": {
-                  const m = mediaMap.get(block.media_id);
-                  if (!m) return null;
-                  return /* @__PURE__ */ jsxRuntime.jsx(
-                    PrivatePhoto,
-                    {
-                      media: m,
-                      base,
-                      onChange: m.kind !== "video" && can("UPLOAD_MEDIA") ? () => openMedia(m) : void 0,
-                      onSuggestCorrection: can("REQUEST_CHANGES") ? () => openCorrection(m) : void 0,
-                      disabled: busy,
-                      isInline: true
-                    },
-                    m.file_id
-                  );
+              ),
+              (() => {
+                const blocks = parseDocumentBlocks({
+                  content_markdown: review.revision.document.content_markdown,
+                  media: review.revision.document.media,
+                  blocks: review.revision.document.blocks
+                });
+                const mediaMap = /* @__PURE__ */ new Map();
+                for (const m of review.revision.document.media) {
+                  mediaMap.set(m.file_id, m);
+                  if (m.contribution_id) mediaMap.set(m.contribution_id, m);
                 }
-                default:
-                  return null;
-              }
-            }) });
-          })(),
-          review.revision.document.media.filter((m) => m.position === "gallery").map((m) => /* @__PURE__ */ jsxRuntime.jsx(
-            PrivatePhoto,
-            {
-              media: m,
-              base,
-              onChange: m.kind !== "video" && can("UPLOAD_MEDIA") ? () => openMedia(m) : void 0,
-              onSuggestCorrection: can("REQUEST_CHANGES") ? () => openCorrection(m) : void 0,
-              disabled: busy
-            },
-            m.file_id
-          ))
-        ] }),
+                return /* @__PURE__ */ jsxRuntime.jsx("div", { className: "sm-review-prose", children: blocks.length === 0 && review.revision.content_html ? /* @__PURE__ */ jsxRuntime.jsx("div", { dangerouslySetInnerHTML: { __html: review.revision.content_html } }) : blocks.map((block, idx) => {
+                  switch (block.type) {
+                    case "paragraph":
+                      return /* @__PURE__ */ jsxRuntime.jsx(
+                        "p",
+                        {
+                          dangerouslySetInnerHTML: { __html: block.html }
+                        },
+                        idx
+                      );
+                    case "heading": {
+                      if (block.level === 1)
+                        return /* @__PURE__ */ jsxRuntime.jsx("h1", { dangerouslySetInnerHTML: { __html: block.html } }, idx);
+                      if (block.level === 2)
+                        return /* @__PURE__ */ jsxRuntime.jsx("h2", { dangerouslySetInnerHTML: { __html: block.html } }, idx);
+                      if (block.level === 3)
+                        return /* @__PURE__ */ jsxRuntime.jsx("h3", { dangerouslySetInnerHTML: { __html: block.html } }, idx);
+                      if (block.level === 4)
+                        return /* @__PURE__ */ jsxRuntime.jsx("h4", { dangerouslySetInnerHTML: { __html: block.html } }, idx);
+                      if (block.level === 5)
+                        return /* @__PURE__ */ jsxRuntime.jsx("h5", { dangerouslySetInnerHTML: { __html: block.html } }, idx);
+                      return /* @__PURE__ */ jsxRuntime.jsx("h6", { dangerouslySetInnerHTML: { __html: block.html } }, idx);
+                    }
+                    case "quote":
+                      return /* @__PURE__ */ jsxRuntime.jsxs("blockquote", { children: [
+                        /* @__PURE__ */ jsxRuntime.jsx("p", { dangerouslySetInnerHTML: { __html: block.html } }),
+                        block.attribution && /* @__PURE__ */ jsxRuntime.jsx("cite", { children: block.attribution })
+                      ] }, idx);
+                    case "list":
+                      return block.ordered ? /* @__PURE__ */ jsxRuntime.jsx("ol", { children: block.items.map((it, i) => /* @__PURE__ */ jsxRuntime.jsx("li", { dangerouslySetInnerHTML: { __html: it } }, i)) }, idx) : /* @__PURE__ */ jsxRuntime.jsx("ul", { children: block.items.map((it, i) => /* @__PURE__ */ jsxRuntime.jsx("li", { dangerouslySetInnerHTML: { __html: it } }, i)) }, idx);
+                    case "divider":
+                      return /* @__PURE__ */ jsxRuntime.jsx("hr", {}, idx);
+                    case "inline_media": {
+                      const m = mediaMap.get(block.media_id);
+                      if (!m) return null;
+                      return /* @__PURE__ */ jsxRuntime.jsx(
+                        PrivatePhoto,
+                        {
+                          media: m,
+                          base,
+                          onChange: m.kind !== "video" && can("UPLOAD_MEDIA") ? () => openMedia(m) : void 0,
+                          onSuggestCorrection: can("REQUEST_CHANGES") ? () => openCorrection(m) : void 0,
+                          disabled: busy,
+                          isInline: true
+                        },
+                        m.file_id
+                      );
+                    }
+                    default:
+                      return null;
+                  }
+                }) });
+              })(),
+              review.revision.document.media.filter((m) => m.position === "gallery").map((m) => /* @__PURE__ */ jsxRuntime.jsx(
+                PrivatePhoto,
+                {
+                  media: m,
+                  base,
+                  onChange: m.kind !== "video" && can("UPLOAD_MEDIA") ? () => openMedia(m) : void 0,
+                  onSuggestCorrection: can("REQUEST_CHANGES") ? () => openCorrection(m) : void 0,
+                  disabled: busy
+                },
+                m.file_id
+              ))
+            ]
+          }
+        ),
         celebration && /* @__PURE__ */ jsxRuntime.jsxs("section", { id: "review-options", className: "sm-review-welcome", children: [
           /* @__PURE__ */ jsxRuntime.jsx("h2", { children: "Help us make this just right" }),
           /* @__PURE__ */ jsxRuntime.jsxs("p", { children: [
@@ -1841,7 +1903,7 @@ function StoryReview({
       ] })
     ] }),
     publicationFooter
-  ] });
+  ] }) });
 }
 function PrivatePhoto({
   base,
@@ -1851,9 +1913,11 @@ function PrivatePhoto({
   disabled,
   isInline
 }) {
+  const sessionReady = react.useContext(ReviewMediaSession);
   const [url, setUrl] = react.useState("");
   const [video, setVideo] = react.useState(false);
   react.useEffect(() => {
+    if (!sessionReady) return;
     let active = true, object = "";
     void fetch(`${base}/media/${encodeURIComponent(media.file_id)}`, {
       cache: "no-store",
@@ -1872,7 +1936,7 @@ function PrivatePhoto({
       active = false;
       if (object) URL.revokeObjectURL(object);
     };
-  }, [base, media.file_id]);
+  }, [base, media.file_id, sessionReady]);
   const captionInfo = formatArtworkCaption(media);
   return /* @__PURE__ */ jsxRuntime.jsxs(
     "figure",
@@ -1896,7 +1960,7 @@ function PrivatePhoto({
             alt: media.alt || captionInfo.title || "Story photograph",
             referrerPolicy: "no-referrer"
           }
-        ) : /* @__PURE__ */ jsxRuntime.jsx("p", { children: "Media unavailable." }),
+        ) : /* @__PURE__ */ jsxRuntime.jsx("p", { children: sessionReady ? "Media unavailable." : "Loading photograph\u2026" }),
         /* @__PURE__ */ jsxRuntime.jsxs("figcaption", { className: "sm-review-photo-details", children: [
           /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "sm-review-caption-text", children: [
             captionInfo.title && /* @__PURE__ */ jsxRuntime.jsx("div", { className: "sm-review-artwork-title", children: /* @__PURE__ */ jsxRuntime.jsxs("strong", { children: [

package/dist/story-review.d.cts

@@ -1,6 +1,15 @@
+import { A as ArticleFormat, a as ArticlePresentation } from './article-presentation-0d1FiDgA.cjs';
 import React__default from 'react';
 import { C as ContentBlock } from './article-blocks-DsabIDmH.cjs';
 
+type Data = Record<string, any>;
+type Draft = {
+    panel: string;
+    version: number;
+    data: Data;
+    updated_at?: string;
+};
+
 type Media = {
     kind?: "image" | "video";
     contribution_id: string;
@@ -18,6 +27,11 @@ type Media = {
     rights_status?: string;
 };
 type Document = {
+    format?: ArticleFormat;
+    layout?: {
+        id: string;
+        version: number;
+    };
     title: string;
     subtitle: string;
     content_markdown: string;
@@ -41,7 +55,59 @@ type Revision = {
     document: Document;
     content_html: string;
 };
-declare function StoryReview({ sessionId, publicationName, nameplateUrl, publicationHeader, publicationFooter, readerAccountUrl, renderSignIn, feedbackEmail, }: {
+type StoryReviewData = {
+    session_id?: string;
+    identity_required?: boolean;
+    participant?: boolean;
+    response_drafts?: Record<string, Draft>;
+    publication: {
+        name: string;
+    };
+    reviewer: string;
+    revision: Revision;
+    history: Revision[];
+    permissions: string[];
+    questions: {
+        id: string;
+        prompt: string;
+        required: boolean;
+    }[];
+    contributions: {
+        id: string;
+        kind: string;
+        state: string;
+        payload: {
+            message?: string;
+            file_id?: string;
+            caption?: string;
+            credit?: string;
+            answers?: Record<string, string>;
+            target?: {
+                kind: string;
+                reference?: string;
+            };
+            alt?: string;
+        };
+    }[];
+    review_policy: string;
+    published: boolean;
+    article_published?: boolean;
+    presentation?: ArticlePresentation;
+    generated_visual?: {
+        url: string;
+        alt?: string;
+        caption?: string;
+        label?: string;
+    };
+    permalink_path?: string;
+    public_article?: {
+        id: string;
+        path: string;
+    } | null;
+    celebration_type?: string | null;
+    decision?: string | null;
+};
+declare function StoryReview({ sessionId, publicationName, nameplateUrl, publicationHeader, publicationFooter, readerAccountUrl, renderSignIn, feedbackEmail, initialReview, onReviewLoaded, formatImageCaption, }: {
     sessionId: string;
     publicationName: string;
     nameplateUrl?: string;
@@ -52,6 +118,10 @@ declare function StoryReview({ sessionId, publicationName, nameplateUrl, publica
     readerAccountUrl?: string;
     renderSignIn?: (returnTo: string) => React__default.ReactNode;
     feedbackEmail?: string;
+    /** Only a server-validated private capability may supply this snapshot. Never cache publicly. */
+    initialReview?: StoryReviewData;
+    onReviewLoaded?: (review: StoryReviewData) => void;
+    formatImageCaption?: (value?: string | null) => string;
 }): React__default.JSX.Element;
 /** Paragraph comparisons preserve readable prose and identify title/dek and media changes. */
 declare function ReviewDiff({ before, after, }: {
@@ -59,4 +129,4 @@ declare function ReviewDiff({ before, after, }: {
     after: Revision;
 }): React__default.JSX.Element;
 
-export { type Document, type Media, ReviewDiff, StoryReview };
+export { type Document, type Media, ReviewDiff, StoryReview, type StoryReviewData };

package/dist/story-review.d.ts

@@ -1,6 +1,15 @@
+import { A as ArticleFormat, a as ArticlePresentation } from './article-presentation-0d1FiDgA.js';
 import React__default from 'react';
 import { C as ContentBlock } from './article-blocks-DsabIDmH.js';
 
+type Data = Record<string, any>;
+type Draft = {
+    panel: string;
+    version: number;
+    data: Data;
+    updated_at?: string;
+};
+
 type Media = {
     kind?: "image" | "video";
     contribution_id: string;
@@ -18,6 +27,11 @@ type Media = {
     rights_status?: string;
 };
 type Document = {
+    format?: ArticleFormat;
+    layout?: {
+        id: string;
+        version: number;
+    };
     title: string;
     subtitle: string;
     content_markdown: string;
@@ -41,7 +55,59 @@ type Revision = {
     document: Document;
     content_html: string;
 };
-declare function StoryReview({ sessionId, publicationName, nameplateUrl, publicationHeader, publicationFooter, readerAccountUrl, renderSignIn, feedbackEmail, }: {
+type StoryReviewData = {
+    session_id?: string;
+    identity_required?: boolean;
+    participant?: boolean;
+    response_drafts?: Record<string, Draft>;
+    publication: {
+        name: string;
+    };
+    reviewer: string;
+    revision: Revision;
+    history: Revision[];
+    permissions: string[];
+    questions: {
+        id: string;
+        prompt: string;
+        required: boolean;
+    }[];
+    contributions: {
+        id: string;
+        kind: string;
+        state: string;
+        payload: {
+            message?: string;
+            file_id?: string;
+            caption?: string;
+            credit?: string;
+            answers?: Record<string, string>;
+            target?: {
+                kind: string;
+                reference?: string;
+            };
+            alt?: string;
+        };
+    }[];
+    review_policy: string;
+    published: boolean;
+    article_published?: boolean;
+    presentation?: ArticlePresentation;
+    generated_visual?: {
+        url: string;
+        alt?: string;
+        caption?: string;
+        label?: string;
+    };
+    permalink_path?: string;
+    public_article?: {
+        id: string;
+        path: string;
+    } | null;
+    celebration_type?: string | null;
+    decision?: string | null;
+};
+declare function StoryReview({ sessionId, publicationName, nameplateUrl, publicationHeader, publicationFooter, readerAccountUrl, renderSignIn, feedbackEmail, initialReview, onReviewLoaded, formatImageCaption, }: {
     sessionId: string;
     publicationName: string;
     nameplateUrl?: string;
@@ -52,6 +118,10 @@ declare function StoryReview({ sessionId, publicationName, nameplateUrl, publica
     readerAccountUrl?: string;
     renderSignIn?: (returnTo: string) => React__default.ReactNode;
     feedbackEmail?: string;
+    /** Only a server-validated private capability may supply this snapshot. Never cache publicly. */
+    initialReview?: StoryReviewData;
+    onReviewLoaded?: (review: StoryReviewData) => void;
+    formatImageCaption?: (value?: string | null) => string;
 }): React__default.JSX.Element;
 /** Paragraph comparisons preserve readable prose and identify title/dek and media changes. */
 declare function ReviewDiff({ before, after, }: {
@@ -59,4 +129,4 @@ declare function ReviewDiff({ before, after, }: {
     after: Revision;
 }): React__default.JSX.Element;
 
-export { type Document, type Media, ReviewDiff, StoryReview };
+export { type Document, type Media, ReviewDiff, StoryReview, type StoryReviewData };