@doenet/doenetml-iframe 0.7.20-dev.327 → 0.7.20-dev.329

package/README.md

@@ -140,7 +140,38 @@ either `flags.allowSaveState` (the wrapper snapshots the flushed
 `reportScoreAndState` and seeds `initialState` on restore) or
 `flags.allowLocalState` (IndexedDB restores on reboot). Windowed viewers
 with neither flag still mount lazily but, once booted, always stay live
-(a console warning points this out).
+(a console warning — once per page — points this out). Hosts that consume
+reports through the `reportScoreAndStateCallback` prop are fully supported:
+the wrapper captures the flushed report for its park snapshot before
+forwarding it to the callback.
+
+Parking also requires a standalone bundle new enough to acknowledge the
+flush (v0.7.21+). A viewer pinned to an older `doenetmlVersion` mounts
+lazily and obeys the boot cap, but is never parked. A host-specified
+`standaloneUrl` is assumed modern (hosts shipping a custom URL control both
+sides — note a `-dev.N` prerelease *version string* compares as its base
+release, so dev-channel hosts should pin `standaloneUrl` rather than
+`doenetmlVersion`).
+
+#### `keepLive`: prefetching hosts
+
+A windowed viewer inside a hidden (`display:none`) or far-off-screen
+container never intersects the viewport, so it would stay parked forever.
+A host that knows the viewer is about to be shown — e.g. a paginator
+prefetching the pages adjacent to the current one — sets the dynamic
+`keepLive` prop to treat it as visible: it boots eagerly (still subject to
+`maxConcurrentBoots`, visible-first) and is never parked while the hint is
+set. Clear the hint and the viewer becomes an ordinary windowed citizen
+again (parked when off-screen and over budget).
+
+```tsx
+<DoenetViewer
+    doenetML={doenetML}
+    flags={{ allowSaveState: true }}
+    mountPolicy={{ mode: "windowed", maxLiveViewers: 3 }}
+    keepLive={Math.abs(itemIndex - currentIndex) <= 1}
+/>
+```
 
 Notes:
 

package/index.d.ts

@@ -86,7 +86,7 @@ declare type DoenetEditorProps = Omit<React.ComponentProps<typeof DoenetEditor_2
  * v0.7.18 cannot re-render in place; for those the wrapper falls back to
  * reloading the iframe on any prop change, its historical behavior.)
  */
-export declare function DoenetViewer({ doenetML, standaloneUrl: specifiedStandaloneUrl, cssUrl: specifiedCssUrl, doenetmlVersion: specifiedDoenetmlVersion, autodetectVersion, useSharedCoreWorker, mountPolicy, ...doenetViewerProps }: DoenetViewerIframeProps): default_2.JSX.Element | null;
+export declare function DoenetViewer({ doenetML, standaloneUrl: specifiedStandaloneUrl, cssUrl: specifiedCssUrl, doenetmlVersion: specifiedDoenetmlVersion, autodetectVersion, useSharedCoreWorker, mountPolicy, keepLive, ...doenetViewerProps }: DoenetViewerIframeProps): default_2.JSX.Element | null;
 
 export declare type DoenetViewerIframeProps = DoenetViewerProps & {
     doenetML: string;
@@ -134,12 +134,27 @@ export declare type DoenetViewerIframeProps = DoenetViewerProps & {
      * viewport. Parking requires a persistence path: it only activates for
      * viewers with `flags.allowSaveState` (the wrapper snapshots the
      * flushed `reportScoreAndState` and seeds `initialState` on restore) or
-     * `flags.allowLocalState` (IndexedDB restores on reboot); otherwise the
-     * viewer boots on visibility but then always stays live. The policy is
-     * read at mount; changing it afterwards is not supported. Default off
-     * (no prop = today's behavior).
+     * `flags.allowLocalState` (IndexedDB restores on reboot), and only when
+     * the selected bundle is new enough to acknowledge the flush (v0.7.21+,
+     * or a host-specified `standaloneUrl`); otherwise the viewer boots on
+     * visibility but then always stays live. The policy is read at mount;
+     * changing it afterwards is not supported. Default off (no prop =
+     * today's behavior).
      */
     mountPolicy?: MountPolicy;
+    /**
+     * Windowed-mounting hint: treat this viewer as visible regardless of
+     * viewport intersection — boot it eagerly (still subject to the
+     * page-wide `maxConcurrentBoots` slot queue) and never park it while
+     * set. For hosts that know an off-screen or `display:none` viewer is
+     * about to be shown, e.g. a paginator prefetching the pages adjacent to
+     * the current one. Dynamic, unlike `mountPolicy`; no effect without a
+     * windowed `mountPolicy`. The hint counts as visibility for boot
+     * ordering and the least-recently-visible eviction order, so keep it on
+     * a few viewers at a time (a page-wide `keepLive` would defeat the
+     * budget).
+     */
+    keepLive?: boolean;
 };
 
 declare type DoenetViewerProps = Omit<React.ComponentProps<typeof DoenetViewer_2>, "doenetML" | "externalVirtualKeyboardProvided">;

package/index.js

@@ -25618,7 +25618,7 @@ function requireCssesc$1() {
   return cssesc_1$1;
 }
 requireCssesc$1();
-const viewerIframeJsSource = '(function() {\n  "use strict";\n  let lastAugmentedProps = null;\n  let currentFunctionProps = {};\n  const functionPropDispatchers = {};\n  function getFunctionPropDispatcher(key) {\n    let dispatcher = functionPropDispatchers[key];\n    if (!dispatcher) {\n      dispatcher = (...callArgs) => currentFunctionProps[key]?.(...callArgs);\n      functionPropDispatchers[key] = dispatcher;\n    }\n    return dispatcher;\n  }\n  function functionPropArgsToMap(args) {\n    const map = {};\n    for (let i = 0; i < args.length; i += 2) {\n      const key = args[i];\n      const fn = args[i + 1];\n      if (typeof key === "string" && typeof fn === "function") {\n        map[key] = fn;\n      }\n    }\n    return map;\n  }\n  function releaseFunctionProxy(fn) {\n    try {\n      fn?.[ComlinkViewer.releaseProxy]?.();\n    } catch (e) {\n      console.warn(\n        "iframe DoenetViewer: failed to release stale Comlink proxy",\n        e\n      );\n    }\n  }\n  function setCurrentFunctionProps(incoming) {\n    for (const [key, fn] of Object.entries(currentFunctionProps)) {\n      if (incoming[key] !== fn) {\n        releaseFunctionProxy(fn);\n      }\n    }\n    currentFunctionProps = incoming;\n  }\n  function defaultRequestScrollTo(offset) {\n    messageParentFromViewer({ type: "scrollTo", offset });\n  }\n  function syncAugmentedFunctionProps() {\n    if (!lastAugmentedProps) {\n      return;\n    }\n    const next = {};\n    for (const [key, val] of Object.entries(lastAugmentedProps)) {\n      if (typeof val !== "function") {\n        next[key] = val;\n      }\n    }\n    for (const key of Object.keys(currentFunctionProps)) {\n      next[key] = getFunctionPropDispatcher(key);\n    }\n    if (!("requestScrollTo" in next)) {\n      next.requestScrollTo = defaultRequestScrollTo;\n    }\n    lastAugmentedProps = next;\n  }\n  let currentDoenetMLSource = null;\n  function resolveDoenetMLSource(root) {\n    if (currentDoenetMLSource !== null) {\n      return currentDoenetMLSource;\n    }\n    const scriptTag = root.querySelector(\'script[type="text/doenetml"]\');\n    currentDoenetMLSource = scriptTag?.innerHTML ?? "";\n    return currentDoenetMLSource;\n  }\n  async function waitForStandaloneBundle(timeoutMs) {\n    if (typeof window.renderDoenetViewerToContainer === "function") {\n      return true;\n    }\n    const deadline = Date.now() + timeoutMs;\n    while (Date.now() < deadline) {\n      await new Promise((resolve) => setTimeout(resolve, 50));\n      if (typeof window.renderDoenetViewerToContainer === "function") {\n        return true;\n      }\n    }\n    return false;\n  }\n  ComlinkViewer.expose(\n    {\n      renderViewerWithFunctionProps,\n      updateViewerProps(updatedSerializableProps) {\n        if (!lastAugmentedProps) {\n          console.warn(\n            "iframe DoenetViewer: updateViewerProps arrived before renderViewerWithFunctionProps completed — likely a bug in the iframe wrapper\'s queue/replay sequencing."\n          );\n          return;\n        }\n        const { doenetML, ...rest } = updatedSerializableProps;\n        if (typeof doenetML === "string") {\n          currentDoenetMLSource = doenetML;\n        }\n        lastAugmentedProps = {\n          ...lastAugmentedProps,\n          ...rest\n        };\n        renderWithLastAugmentedProps();\n      },\n      updateViewerFunctionProps(...args) {\n        if (!lastAugmentedProps) {\n          console.warn(\n            "iframe DoenetViewer: updateViewerFunctionProps arrived before renderViewerWithFunctionProps completed — likely a bug in the iframe wrapper\'s queue/replay sequencing."\n          );\n          return;\n        }\n        const incoming = functionPropArgsToMap(args);\n        const prevKeys = Object.keys(currentFunctionProps).sort();\n        const nextKeys = Object.keys(incoming).sort();\n        const keysChanged = prevKeys.length !== nextKeys.length || prevKeys.some((key, i) => key !== nextKeys[i]);\n        setCurrentFunctionProps(incoming);\n        if (keysChanged) {\n          syncAugmentedFunctionProps();\n          renderWithLastAugmentedProps();\n        }\n      }\n    },\n    ComlinkViewer.windowEndpoint(globalThis.parent)\n  );\n  function renderViewerWithFunctionProps(...args) {\n    setCurrentFunctionProps(functionPropArgsToMap(args));\n    const augmentedDoenetViewerProps = { ...doenetViewerProps };\n    augmentedDoenetViewerProps.externalVirtualKeyboardProvided = true;\n    for (const propName of doenetViewerPropsSpecified) {\n      if (!(propName in doenetViewerProps) && propName in currentFunctionProps) {\n        augmentedDoenetViewerProps[propName] = getFunctionPropDispatcher(propName);\n      }\n    }\n    if (!doenetViewerPropsSpecified.includes("requestScrollTo")) {\n      augmentedDoenetViewerProps.requestScrollTo = defaultRequestScrollTo;\n    }\n    lastAugmentedProps = augmentedDoenetViewerProps;\n    renderWithLastAugmentedProps();\n  }\n  function renderWithLastAugmentedProps() {\n    const root = document.getElementById("root");\n    window.renderDoenetViewerToContainer(\n      root,\n      resolveDoenetMLSource(root),\n      lastAugmentedProps\n    );\n  }\n  function installSharedCorePortProvider() {\n    let coreCounter = 0;\n    window.doenetGlobalConfig.createExternalCoreWorkerPort = () => {\n      const coreId = `${viewerId}-core-${++coreCounter}`;\n      const channel = new MessageChannel();\n      window.parent.postMessage(\n        { origin: viewerId, data: { type: "createSharedCore", coreId } },\n        window.parent.origin,\n        [channel.port2]\n      );\n      return {\n        port: channel.port1,\n        destroy: (suspectWedge) => {\n          messageParentFromViewer({\n            type: "destroySharedCore",\n            coreId,\n            suspectWedge: Boolean(suspectWedge)\n          });\n        }\n      };\n    };\n  }\n  (async () => {\n    if (await waitForStandaloneBundle(6e4)) {\n      if (typeof doenetSharedCoreWorker !== "undefined" && doenetSharedCoreWorker) {\n        installSharedCorePortProvider();\n      }\n      messageParentFromViewer({ iframeReady: true });\n    } else {\n      messageParentFromViewer({\n        error: "Invalid DoenetML version or DoenetML package not found"\n      });\n    }\n  })().catch((err) => {\n    console.error(\n      "iframe DoenetViewer: unexpected failure while signalling iframeReady",\n      err\n    );\n    try {\n      messageParentFromViewer({\n        error: "iframe viewer failed to initialize"\n      });\n    } catch {\n    }\n  });\n  function messageParentFromViewer(data) {\n    window.parent.postMessage(\n      {\n        origin: viewerId,\n        data\n      },\n      window.parent.origin\n    );\n  }\n})();\n';
+const viewerIframeJsSource = '(function() {\n  "use strict";\n  let lastAugmentedProps = null;\n  let currentFunctionProps = {};\n  const functionPropDispatchers = {};\n  function getFunctionPropDispatcher(key) {\n    let dispatcher = functionPropDispatchers[key];\n    if (!dispatcher) {\n      if (key === "reportScoreAndStateCallback" && typeof doenetWindowedViewer !== "undefined" && doenetWindowedViewer) {\n        dispatcher = (report) => messageParentFromViewer({\n          type: "reportScoreAndState",\n          report\n        });\n      } else {\n        dispatcher = (...callArgs) => currentFunctionProps[key]?.(...callArgs);\n      }\n      functionPropDispatchers[key] = dispatcher;\n    }\n    return dispatcher;\n  }\n  function functionPropArgsToMap(args) {\n    const map = {};\n    for (let i = 0; i < args.length; i += 2) {\n      const key = args[i];\n      const fn = args[i + 1];\n      if (typeof key === "string" && typeof fn === "function") {\n        map[key] = fn;\n      }\n    }\n    return map;\n  }\n  function releaseFunctionProxy(fn) {\n    try {\n      fn?.[ComlinkViewer.releaseProxy]?.();\n    } catch (e) {\n      console.warn(\n        "iframe DoenetViewer: failed to release stale Comlink proxy",\n        e\n      );\n    }\n  }\n  function setCurrentFunctionProps(incoming) {\n    for (const [key, fn] of Object.entries(currentFunctionProps)) {\n      if (incoming[key] !== fn) {\n        releaseFunctionProxy(fn);\n      }\n    }\n    currentFunctionProps = incoming;\n  }\n  function defaultRequestScrollTo(offset) {\n    messageParentFromViewer({ type: "scrollTo", offset });\n  }\n  function syncAugmentedFunctionProps() {\n    if (!lastAugmentedProps) {\n      return;\n    }\n    const next = {};\n    for (const [key, val] of Object.entries(lastAugmentedProps)) {\n      if (typeof val !== "function") {\n        next[key] = val;\n      }\n    }\n    for (const key of Object.keys(currentFunctionProps)) {\n      next[key] = getFunctionPropDispatcher(key);\n    }\n    if (!("requestScrollTo" in next)) {\n      next.requestScrollTo = defaultRequestScrollTo;\n    }\n    lastAugmentedProps = next;\n  }\n  let currentDoenetMLSource = null;\n  function resolveDoenetMLSource(root) {\n    if (currentDoenetMLSource !== null) {\n      return currentDoenetMLSource;\n    }\n    const scriptTag = root.querySelector(\'script[type="text/doenetml"]\');\n    currentDoenetMLSource = scriptTag?.innerHTML ?? "";\n    return currentDoenetMLSource;\n  }\n  async function waitForStandaloneBundle(timeoutMs) {\n    if (typeof window.renderDoenetViewerToContainer === "function") {\n      return true;\n    }\n    const deadline = Date.now() + timeoutMs;\n    while (Date.now() < deadline) {\n      await new Promise((resolve) => setTimeout(resolve, 50));\n      if (typeof window.renderDoenetViewerToContainer === "function") {\n        return true;\n      }\n    }\n    return false;\n  }\n  ComlinkViewer.expose(\n    {\n      renderViewerWithFunctionProps,\n      updateViewerProps(updatedSerializableProps) {\n        if (!lastAugmentedProps) {\n          console.warn(\n            "iframe DoenetViewer: updateViewerProps arrived before renderViewerWithFunctionProps completed — likely a bug in the iframe wrapper\'s queue/replay sequencing."\n          );\n          return;\n        }\n        const { doenetML, ...rest } = updatedSerializableProps;\n        if (typeof doenetML === "string") {\n          currentDoenetMLSource = doenetML;\n        }\n        lastAugmentedProps = {\n          ...lastAugmentedProps,\n          ...rest\n        };\n        renderWithLastAugmentedProps();\n      },\n      updateViewerFunctionProps(...args) {\n        if (!lastAugmentedProps) {\n          console.warn(\n            "iframe DoenetViewer: updateViewerFunctionProps arrived before renderViewerWithFunctionProps completed — likely a bug in the iframe wrapper\'s queue/replay sequencing."\n          );\n          return;\n        }\n        const incoming = functionPropArgsToMap(args);\n        const prevKeys = Object.keys(currentFunctionProps).sort();\n        const nextKeys = Object.keys(incoming).sort();\n        const keysChanged = prevKeys.length !== nextKeys.length || prevKeys.some((key, i) => key !== nextKeys[i]);\n        setCurrentFunctionProps(incoming);\n        if (keysChanged) {\n          syncAugmentedFunctionProps();\n          renderWithLastAugmentedProps();\n        }\n      }\n    },\n    ComlinkViewer.windowEndpoint(globalThis.parent)\n  );\n  function renderViewerWithFunctionProps(...args) {\n    setCurrentFunctionProps(functionPropArgsToMap(args));\n    const augmentedDoenetViewerProps = { ...doenetViewerProps };\n    augmentedDoenetViewerProps.externalVirtualKeyboardProvided = true;\n    for (const propName of doenetViewerPropsSpecified) {\n      if (!(propName in doenetViewerProps) && propName in currentFunctionProps) {\n        augmentedDoenetViewerProps[propName] = getFunctionPropDispatcher(propName);\n      }\n    }\n    if (!doenetViewerPropsSpecified.includes("requestScrollTo")) {\n      augmentedDoenetViewerProps.requestScrollTo = defaultRequestScrollTo;\n    }\n    lastAugmentedProps = augmentedDoenetViewerProps;\n    renderWithLastAugmentedProps();\n  }\n  function renderWithLastAugmentedProps() {\n    const root = document.getElementById("root");\n    window.renderDoenetViewerToContainer(\n      root,\n      resolveDoenetMLSource(root),\n      lastAugmentedProps\n    );\n  }\n  function installSharedCorePortProvider() {\n    let coreCounter = 0;\n    window.doenetGlobalConfig.createExternalCoreWorkerPort = () => {\n      const coreId = `${viewerId}-core-${++coreCounter}`;\n      const channel = new MessageChannel();\n      window.parent.postMessage(\n        { origin: viewerId, data: { type: "createSharedCore", coreId } },\n        window.parent.origin,\n        [channel.port2]\n      );\n      return {\n        port: channel.port1,\n        destroy: (suspectWedge) => {\n          messageParentFromViewer({\n            type: "destroySharedCore",\n            coreId,\n            suspectWedge: Boolean(suspectWedge)\n          });\n        }\n      };\n    };\n  }\n  (async () => {\n    if (await waitForStandaloneBundle(6e4)) {\n      if (typeof doenetSharedCoreWorker !== "undefined" && doenetSharedCoreWorker) {\n        installSharedCorePortProvider();\n      }\n      messageParentFromViewer({ iframeReady: true });\n    } else {\n      messageParentFromViewer({\n        error: "Invalid DoenetML version or DoenetML package not found"\n      });\n    }\n  })().catch((err) => {\n    console.error(\n      "iframe DoenetViewer: unexpected failure while signalling iframeReady",\n      err\n    );\n    try {\n      messageParentFromViewer({\n        error: "iframe viewer failed to initialize"\n      });\n    } catch {\n    }\n  });\n  function messageParentFromViewer(data) {\n    window.parent.postMessage(\n      {\n        origin: viewerId,\n        data\n      },\n      window.parent.origin\n    );\n  }\n})();\n';
 const editorIframeJsSource = `(function() {
   "use strict";
   let editorControlHandle = null;
@@ -25856,7 +25856,7 @@ function createIframeHead(standaloneUrl, cssUrl) {
 function createIframeBodyOpenTag(darkMode) {
   return `<body style="margin:0" ${BODY_BACKGROUND_ATTRIBUTE}="${bodyBackgroundMode(darkMode)}">`;
 }
-function createHtmlForDoenetViewer(id2, doenetML, doenetViewerProps, standaloneUrl, cssUrl, useSharedCoreWorker = false) {
+function createHtmlForDoenetViewer(id2, doenetML, doenetViewerProps, standaloneUrl, cssUrl, useSharedCoreWorker = false, windowed = false) {
   const doenetViewerPropsSpecified = Object.keys(doenetViewerProps);
   if (!doenetViewerPropsSpecified.includes("initializedCallback")) {
     doenetViewerPropsSpecified.push("initializedCallback");
@@ -25870,6 +25870,7 @@ function createHtmlForDoenetViewer(id2, doenetML, doenetViewerProps, standaloneU
             const doenetViewerProps = ${JSON.stringify(doenetViewerProps)};
             const doenetViewerPropsSpecified = ${JSON.stringify(doenetViewerPropsSpecified)};
             const doenetSharedCoreWorker = ${JSON.stringify(!!useSharedCoreWorker)};
+            const doenetWindowedViewer = ${JSON.stringify(!!windowed)};
             import * as ComlinkViewer from "https://unpkg.com/comlink/dist/esm/comlink.mjs";
 
             // This source code has been compiled by vite and should be directly included.
@@ -26039,6 +26040,14 @@ const records = /* @__PURE__ */ new Map();
 let visibleOrderCounter = 0;
 let effectiveMaxLive = null;
 let warnedMixedBudgets = false;
+let warnedWindowedWithoutPersistence = false;
+function shouldWarnWindowedWithoutPersistence() {
+  if (warnedWindowedWithoutPersistence) {
+    return false;
+  }
+  warnedWindowedWithoutPersistence = true;
+  return true;
+}
 let evaluateTimerId = null;
 let evaluateTimerAt = Infinity;
 let effectiveMaxBoots = null;
@@ -26216,6 +26225,32 @@ function evaluate$1() {
     scheduleEvaluate(Math.max(0, nextDebounceExpiry - now));
   }
 }
+const LIVE_UPDATE_MIN_VERSION = [0, 7, 18];
+const PARK_MIN_VERSION = [0, 7, 21];
+function versionAtLeast(version2, min2) {
+  const match2 = version2.replace(/^v/, "").match(/^(\d+)(?:\.(\d+))?(?:\.(\d+))?/);
+  if (!match2) {
+    return true;
+  }
+  const parts = [match2[1], match2[2], match2[3]].map(
+    (p2) => p2 === void 0 ? Infinity : parseInt(p2, 10)
+  );
+  for (let i2 = 0; i2 < 3; i2++) {
+    if (parts[i2] > min2[i2]) {
+      return true;
+    }
+    if (parts[i2] < min2[i2]) {
+      return false;
+    }
+  }
+  return true;
+}
+function versionSupportsLiveUpdates(version2) {
+  return versionAtLeast(version2, LIVE_UPDATE_MIN_VERSION);
+}
+function versionSupportsParking(version2) {
+  return versionAtLeast(version2, PARK_MIN_VERSION);
+}
 function findNodesWithPositionInfo(nodes) {
   if (typeof nodes !== "object" || nodes === null) {
     return [];
@@ -63362,7 +63397,7 @@ function ExternalVirtualKeyboard({
     }
   );
 }
-const version = "0.7.20-dev.327";
+const version = "0.7.20-dev.329";
 const latestDoenetmlVersion = version;
 function subscribeToPinnedTheme() {
   return () => {
@@ -63377,25 +63412,6 @@ function useResolvedTheme(setting) {
   );
   return setting === "system" ? systemTheme : setting;
 }
-const LIVE_UPDATE_MIN_VERSION = [0, 7, 18];
-function versionSupportsLiveUpdates(version2) {
-  const match2 = version2.replace(/^v/, "").match(/^(\d+)(?:\.(\d+))?(?:\.(\d+))?/);
-  if (!match2) {
-    return true;
-  }
-  const parts = [match2[1], match2[2], match2[3]].map(
-    (p2) => p2 === void 0 ? Infinity : parseInt(p2, 10)
-  );
-  for (let i2 = 0; i2 < 3; i2++) {
-    if (parts[i2] > LIVE_UPDATE_MIN_VERSION[i2]) {
-      return true;
-    }
-    if (parts[i2] < LIVE_UPDATE_MIN_VERSION[i2]) {
-      return false;
-    }
-  }
-  return true;
-}
 function DoenetViewer({
   doenetML,
   standaloneUrl: specifiedStandaloneUrl,
@@ -63404,6 +63420,7 @@ function DoenetViewer({
   autodetectVersion = true,
   useSharedCoreWorker = false,
   mountPolicy,
+  keepLive = false,
   ...doenetViewerProps
 }) {
   const [id2, _2] = React__default.useState(() => Math.random().toString(36).slice(2));
@@ -63421,7 +63438,8 @@ function DoenetViewer({
   const [parkGeneration, setParkGeneration] = React__default.useState(0);
   const parkedRef = React__default.useRef(windowed);
   const parkingRef = React__default.useRef(false);
-  const visibleRef = React__default.useRef(false);
+  const intersectingRef = React__default.useRef(false);
+  const keepLiveRef = React__default.useRef(false);
   const containerRef = React__default.useRef(null);
   const parkFlushCounterRef = React__default.useRef(0);
   const parkFlushIdRef = React__default.useRef(null);
@@ -63510,6 +63528,9 @@ function DoenetViewer({
     specifiedStandaloneUrl && !foundAutoVersion
   );
   const liveUpdatesSupported = usingCustomStandaloneUrl || versionSupportsLiveUpdates(selectedDoenetmlVersion);
+  const parkingSupported = usingCustomStandaloneUrl || versionSupportsParking(selectedDoenetmlVersion);
+  const parkingSupportedRef = React__default.useRef(parkingSupported);
+  parkingSupportedRef.current = parkingSupported;
   const standaloneUrlRef = React__default.useRef(standaloneUrl);
   standaloneUrlRef.current = standaloneUrl;
   const propsSnapshotStr = serializePropsSnapshot(
@@ -63538,7 +63559,8 @@ function DoenetViewer({
       bakedProps,
       standaloneUrl,
       cssUrl,
-      useSharedCoreWorker
+      useSharedCoreWorker,
+      windowed
     );
   }, [
     id2,
@@ -63593,7 +63615,9 @@ function DoenetViewer({
       }
       if (windowed) {
         if (event.data.subject === "SPLICE.reportScoreAndState") {
-          lastCapturedReportRef.current = event.data;
+          lastCapturedReportRef.current = {
+            state: event.data.state
+          };
           return;
         }
         if (event.data.subject === "SPLICE.flushState.response" && event.data.message_id === parkFlushIdRef.current) {
@@ -63605,6 +63629,24 @@ function DoenetViewer({
         return;
       }
       const data = event.data.data;
+      if (windowed && data.type === "reportScoreAndState") {
+        const report = data.report ?? {};
+        lastCapturedReportRef.current = { state: report.state };
+        const hostCallback = doenetViewerPropsRef.current.reportScoreAndStateCallback;
+        if (typeof hostCallback === "function") {
+          hostCallback(report);
+        } else {
+          window.postMessage({
+            subject: "SPLICE.reportScoreAndState",
+            state: report.state,
+            score: report.score,
+            activity_id: report.activityId,
+            doc_id: report.docId,
+            message_id: Math.random().toString(36).slice(2)
+          });
+        }
+        return;
+      }
       if (data.type === "createSharedCore" && event.ports[0]) {
         handleCreateSharedCore({
           viewerId: id2,
@@ -63751,7 +63793,7 @@ function DoenetViewer({
     return Boolean(flags?.allowSaveState || flags?.allowLocalState);
   }
   function canPark() {
-    return hasPersistencePath() && Boolean(ref.current?.contentWindow);
+    return hasPersistencePath() && parkingSupportedRef.current && Boolean(ref.current?.contentWindow);
   }
   function beginPark() {
     if (parkedRef.current || parkingRef.current) {
@@ -63788,28 +63830,32 @@ function DoenetViewer({
     parkFlushCleanupRef.current?.();
     parkFlushIdRef.current = null;
     parkingRef.current = false;
-    if (visibleRef.current) {
+    if (effectivelyVisible()) {
       notifyViewerState(id2, "live");
       return false;
     }
     return true;
   }
+  function seedSnapshotFromCapturedReport() {
+    if (lastCapturedReportRef.current?.state) {
+      parkedSnapshotRef.current = lastCapturedReportRef.current.state;
+    }
+  }
   function completeParkFlush(ack) {
     if (!endParkFlush()) {
       return;
     }
     if (ack.hadState) {
       everHadStateRef.current = true;
-      if (lastCapturedReportRef.current?.state) {
-        parkedSnapshotRef.current = lastCapturedReportRef.current.state;
-      }
     }
+    seedSnapshotFromCapturedReport();
     finishPark();
   }
   function onParkFlushTimeout() {
     if (!endParkFlush()) {
       return;
     }
+    seedSnapshotFromCapturedReport();
     finishPark();
   }
   function finishPark() {
@@ -63825,7 +63871,7 @@ function DoenetViewer({
       return;
     }
     requestBootSlot(id2, () => {
-      if (!parkedRef.current || !visibleRef.current) {
+      if (!parkedRef.current || !effectivelyVisible()) {
         releaseBootSlot(id2);
         return;
       }
@@ -63840,6 +63886,18 @@ function DoenetViewer({
       }, BOOT_SLOT_WATCHDOG_MS);
     });
   }
+  function effectivelyVisible() {
+    return intersectingRef.current || keepLiveRef.current;
+  }
+  function updateEffectiveVisibility() {
+    const effective = effectivelyVisible();
+    setViewerVisibility(id2, effective);
+    if (effective) {
+      unpark();
+    } else {
+      cancelBootRequest(id2);
+    }
+  }
   React__default.useEffect(() => {
     if (!windowed || !containerRef.current) {
       return;
@@ -63847,13 +63905,8 @@ function DoenetViewer({
     const observer = new IntersectionObserver(
       (entries) => {
         for (const entry of entries) {
-          visibleRef.current = entry.isIntersecting;
-          setViewerVisibility(id2, entry.isIntersecting);
-          if (entry.isIntersecting && parkedRef.current) {
-            unpark();
-          } else if (!entry.isIntersecting) {
-            cancelBootRequest(id2);
-          }
+          intersectingRef.current = entry.isIntersecting;
+          updateEffectiveVisibility();
         }
       },
       {
@@ -63869,9 +63922,9 @@ function DoenetViewer({
     if (!windowed) {
       return;
     }
-    if (!hasPersistencePath()) {
+    if (!hasPersistencePath() && shouldWarnWindowedWithoutPersistence()) {
       console.warn(
-        "DoenetViewer mountPolicy: windowed mounting is enabled but neither flags.allowSaveState nor flags.allowLocalState is set, so parking would lose student work. This viewer will always stay live."
+        "DoenetViewer mountPolicy: windowed mounting is enabled but neither flags.allowSaveState nor flags.allowLocalState is set, so parking would lose student work. Such viewers will always stay live. (Warned once per page.)"
       );
     }
     const unregister = registerWindowedViewer({
@@ -63891,6 +63944,13 @@ function DoenetViewer({
       unregister();
     };
   }, [windowed]);
+  React__default.useEffect(() => {
+    if (!windowed) {
+      return;
+    }
+    keepLiveRef.current = keepLive;
+    updateEffectiveVisibility();
+  }, [windowed, keepLive]);
   if (inErrorState) {
     if (foundAutoVersion) {
       setIgnoreDetectedVersion(true);