sanity 6.2.0-next.113 → 6.2.0-next.115

package/lib/_chunks-dts/index.d.ts

@@ -732,6 +732,14 @@ declare const PaneContainer: import("react").MemoExoticComponent<(props: BaseStr
  * @internal
  */
 type DocumentListPaneProps = ComponentProps<typeof PaneContainer>;
+/**
+ * Reserved sentinel field name. A sort order using this field signals that the
+ * list should be ordered to match the incoming `$ids` param rather than sorted
+ * server-side, so the surrounding pane preserves the caller-provided ordering.
+ *
+ * @internal
+ */
+declare const ORDER_BY_IDS_PARAM_FIELD = "__orderByIdsParam";
 /**
  * The structureTool is a studio plugin which adds the “structure tool” – a tool within
  * Sanity Studio in which content editors can drill down to specific documents to edit them.
@@ -793,4 +801,4 @@ declare function StructureToolProvider({
 }: StructureToolProviderProps): React.JSX.Element;
 /** @internal */
 declare function useStructureTool(): StructureToolContextValue;
-export { PaneLayout as C, ConfirmDeleteDialogProps as D, ConfirmDeleteDialogContainer as E, BaseStructureToolPaneProps as O, usePaneRouter as S, Pane as T, StructureLocaleResourceKeys as _, structureTool as a, IncomingReferenceAction as b, useDocumentPane as c, useDocumentTitle as d, DocumentPaneProviderWrapper as f, structureLocaleNamespace as g, DocumentPaneProviderProps as h, StructureToolProviderProps as i, DocumentInspectorHeader as l, usePaneOptions as m, useStructureTool as n, DocumentListPaneProps as o, DocumentPane as p, StructureToolProvider as r, PaneContainer as s, PaneRouterContext as t, UseDocumentTitle as u, isIncomingReferenceCreation as v, PaneContent as w, IncomingReferencesOptions as x, defineIncomingReferenceDecoration as y };
+export { usePaneRouter as C, ConfirmDeleteDialogContainer as D, Pane as E, ConfirmDeleteDialogProps as O, IncomingReferencesOptions as S, PaneContent as T, structureLocaleNamespace as _, structureTool as a, defineIncomingReferenceDecoration as b, PaneContainer as c, UseDocumentTitle as d, useDocumentTitle as f, DocumentPaneProviderProps as g, usePaneOptions as h, StructureToolProviderProps as i, BaseStructureToolPaneProps as k, useDocumentPane as l, DocumentPane as m, useStructureTool as n, ORDER_BY_IDS_PARAM_FIELD as o, DocumentPaneProviderWrapper as p, StructureToolProvider as r, DocumentListPaneProps as s, PaneRouterContext as t, DocumentInspectorHeader as u, StructureLocaleResourceKeys as v, PaneLayout as w, IncomingReferenceAction as x, isIncomingReferenceCreation as y };

package/lib/_chunks-dts/types.d.ts

@@ -2435,6 +2435,8 @@ interface DocumentListPaneNode extends BaseResolvedPaneNode<'documentList'> {
     params?: Record<string, unknown>;
     apiVersion?: string;
   };
+  /** Suppresses auto-injected restore-default sort/layout menu items for panes with a fixed ordering choice. */
+  suppressRestoreDefaultMenuItems?: boolean;
   schemaTypeName: string;
   source?: string;
 }

package/lib/_chunks-es/PresentationToolGrantsCheck.js

@@ -15,7 +15,7 @@ import { PresentationSharedStateContext, PresentationPanelsContext, Presentation
 import { Tab, Button, ErrorBoundary, Tooltip, MenuItem, MenuButton, TooltipDelayGroupProvider } from "./index.js";
 import "react-i18next";
 import { WarningOutlineIcon, LaunchIcon, ResetIcon, CopyIcon, ShareIcon, PanelLeftIcon, MobileDeviceIcon, DesktopIcon, RefreshIcon } from "@sanity/icons";
-import { PaneRouterContext, PaneLayout, StructureToolProvider, DocumentListPane as DocumentListPane$1, DocumentPane as DocumentPane$1 } from "sanity/structure";
+import { PaneRouterContext, PaneLayout, StructureToolProvider, ORDER_BY_IDS_PARAM_FIELD, DocumentListPane as DocumentListPane$1, DocumentPane as DocumentPane$1 } from "sanity/structure";
 import { toString } from "@sanity/util/paths";
 import { StructureToolProvider as StructureToolProvider$1 } from "./StructureToolProvider.js";
 import { studioPath } from "@sanity/client/csm";
@@ -216,7 +216,7 @@ const itemKey = "presentation/panels", getStoredItem = () => JSON.parse(localSto
   localStorage.setItem(itemKey, JSON.stringify(data));
 }, getKeyForPanels = (panels) => panels.map((panel) => [panel.id, panel.order].join(":")).join(",");
 function usePanelsStorage() {
-  const $ = c(1), get = _temp2$9, set = _temp3$4;
+  const $ = c(1), get = _temp2$8, set = _temp3$5;
   let t0;
   if ($[0] === /* @__PURE__ */ Symbol.for("react.memo_cache_sentinel")) {
     const setDebounced = debounce(set, 100);
@@ -229,14 +229,14 @@ function usePanelsStorage() {
     t0 = $[0];
   return t0;
 }
-function _temp3$4(panels_0, widths) {
+function _temp3$5(panels_0, widths) {
   const stored_0 = getStoredItem(), key_0 = getKeyForPanels(panels_0), data = {
     ...stored_0,
     [key_0]: widths
   };
   setStoredItem(data);
 }
-function _temp2$9(panels) {
+function _temp2$8(panels) {
   const stored = getStoredItem(), key = getKeyForPanels(panels);
   return Array.isArray(stored[key]) && stored[key].some(_temp$g) ? void 0 : stored[key];
 }
@@ -769,9 +769,9 @@ function PresentationPaneRouterProvider(props) {
     BackLink: t6,
     ReferenceChildLink: t7,
     ParameterizedLink: _temp$f,
-    closeCurrentAndAfter: _temp2$8,
+    closeCurrentAndAfter: _temp2$7,
     handleEditReference: t8,
-    replaceCurrent: _temp3$3,
+    replaceCurrent: _temp3$4,
     closeCurrent: _temp4$2,
     duplicateCurrent: _temp5$2,
     setView: _temp6$1,
@@ -799,10 +799,10 @@ function _temp5$2(pane_0) {
 function _temp4$2() {
   console.warn("closeCurrent");
 }
-function _temp3$3(pane) {
+function _temp3$4(pane) {
   console.warn("replaceCurrent", pane);
 }
-function _temp2$8() {
+function _temp2$7() {
   console.warn("closeCurrentAndAfter");
 }
 function _temp$f() {
@@ -818,71 +818,132 @@ const RootLayout = styled(PaneLayout).withConfig({
   displayName: "WrappedCode",
   componentId: "sc-18wb5dr-2"
 })`white-space:pre-wrap;`;
+function deriveOrderedIds({
+  visualOrderPublishedIds,
+  refs,
+  mainDocumentId
+}) {
+  const seenPublishedIds = /* @__PURE__ */ new Set();
+  return [...visualOrderPublishedIds, ...refs.map((ref) => getPublishedId(ref._id))].reduce((accumulatedIds, publishedId) => (publishedId === mainDocumentId || seenPublishedIds.has(publishedId) || (seenPublishedIds.add(publishedId), accumulatedIds.push(publishedId)), accumulatedIds), []);
+}
 function DocumentListPane(props) {
-  const $ = c(34), {
+  const $ = c(41), {
     mainDocumentState,
     onEditReference,
     onStructureParams,
     searchParams,
-    refs
+    refs,
+    visualOrderPublishedIds
   } = props, {
     t
   } = useTranslation(presentationLocaleNamespace), {
     devMode
-  } = usePresentationTool();
-  let t0;
-  if ($[0] !== mainDocumentState?.document?._id || $[1] !== refs) {
-    let t12;
-    $[3] !== mainDocumentState?.document?._id ? (t12 = (r) => getPublishedId(r._id) !== mainDocumentState?.document?._id, $[3] = mainDocumentState?.document?._id, $[4] = t12) : t12 = $[4], t0 = refs.filter(t12).map(_temp$e), $[0] = mainDocumentState?.document?._id, $[1] = refs, $[2] = t0;
-  } else
-    t0 = $[2];
-  const ids = t0;
+  } = usePresentationTool(), t0 = mainDocumentState?.document?._id;
   let t1;
-  $[5] !== ids ? (t1 = {
-    filter: "_id in $ids",
-    params: {
-      ids
-    }
-  }, $[5] = ids, $[6] = t1) : t1 = $[6];
+  $[0] !== refs || $[1] !== t0 || $[2] !== visualOrderPublishedIds ? (t1 = deriveOrderedIds({
+    visualOrderPublishedIds,
+    refs,
+    mainDocumentId: t0
+  }), $[0] = refs, $[1] = t0, $[2] = visualOrderPublishedIds, $[3] = t1) : t1 = $[3];
+  const ids = t1;
   let t2;
-  $[7] !== t ? (t2 = t("document-list-pane.document-list.title"), $[7] = t, $[8] = t2) : t2 = $[8];
+  $[4] !== ids ? (t2 = {
+    ids
+  }, $[4] = ids, $[5] = t2) : t2 = $[5];
   let t3;
-  $[9] !== t1 || $[10] !== t2 ? (t3 = {
-    id: "$root",
-    options: t1,
-    schemaTypeName: "",
-    title: t2,
-    type: "documentList"
-  }, $[9] = t1, $[10] = t2, $[11] = t3) : t3 = $[11];
-  const pane = t3, [errorParams, setErrorParams] = useState(null);
+  $[6] === /* @__PURE__ */ Symbol.for("react.memo_cache_sentinel") ? (t3 = [{
+    field: ORDER_BY_IDS_PARAM_FIELD,
+    direction: "asc"
+  }], $[6] = t3) : t3 = $[6];
   let t4;
-  $[12] === /* @__PURE__ */ Symbol.for("react.memo_cache_sentinel") ? (t4 = () => setErrorParams(null), $[12] = t4) : t4 = $[12];
-  const handleRetry = t4, [structureParams] = useState(_temp2$7);
+  $[7] !== t2 ? (t4 = {
+    filter: "_id in $ids",
+    params: t2,
+    defaultOrdering: t3
+  }, $[7] = t2, $[8] = t4) : t4 = $[8];
   let t5;
-  $[13] === /* @__PURE__ */ Symbol.for("react.memo_cache_sentinel") ? (t5 = () => setErrorParams(null), $[13] = t5) : t5 = $[13];
+  $[9] !== t ? (t5 = t("document-list-pane.document-list.title"), $[9] = t, $[10] = t5) : t5 = $[10];
   let t6;
-  if ($[14] !== refs ? (t6 = [refs], $[14] = refs, $[15] = t6) : t6 = $[15], useEffect(t5, t6), errorParams) {
-    let t72;
-    $[16] !== t ? (t72 = t("document-list-pane.error.text"), $[16] = t, $[17] = t72) : t72 = $[17];
-    let t82;
-    $[18] !== devMode || $[19] !== errorParams || $[20] !== t ? (t82 = devMode && /* @__PURE__ */ jsx(Card, { overflow: "auto", padding: 3, radius: 2, tone: "critical", children: /* @__PURE__ */ jsxs(Stack, { space: 3, children: [
+  $[11] === /* @__PURE__ */ Symbol.for("react.memo_cache_sentinel") ? (t6 = [{
+    id: "sorting"
+  }], $[11] = t6) : t6 = $[11];
+  let t7;
+  $[12] === /* @__PURE__ */ Symbol.for("react.memo_cache_sentinel") ? (t7 = {
+    title: {
+      key: "document-list-pane.ordering.by-appearance",
+      ns: presentationLocaleNamespace
+    }
+  }, $[12] = t7) : t7 = $[12];
+  let t8;
+  $[13] === /* @__PURE__ */ Symbol.for("react.memo_cache_sentinel") ? (t8 = {
+    group: "sorting",
+    action: "setSortOrder",
+    i18n: t7,
+    title: "By appearance",
+    params: {
+      by: [{
+        field: ORDER_BY_IDS_PARAM_FIELD,
+        direction: "asc"
+      }]
+    }
+  }, $[13] = t8) : t8 = $[13];
+  let t9;
+  $[14] === /* @__PURE__ */ Symbol.for("react.memo_cache_sentinel") ? (t9 = {
+    title: {
+      key: "document-list-pane.ordering.last-edited",
+      ns: presentationLocaleNamespace
+    }
+  }, $[14] = t9) : t9 = $[14];
+  let t10;
+  $[15] === /* @__PURE__ */ Symbol.for("react.memo_cache_sentinel") ? (t10 = [t8, {
+    group: "sorting",
+    action: "setSortOrder",
+    i18n: t9,
+    title: "Last edited",
+    params: {
+      by: [{
+        field: "_updatedAt",
+        direction: "desc"
+      }]
+    }
+  }], $[15] = t10) : t10 = $[15];
+  let t11;
+  $[16] !== t4 || $[17] !== t5 ? (t11 = {
+    id: "presentationDocumentsOnPage",
+    options: t4,
+    schemaTypeName: "",
+    title: t5,
+    type: "documentList",
+    menuItemGroups: t6,
+    menuItems: t10,
+    suppressRestoreDefaultMenuItems: !0
+  }, $[16] = t4, $[17] = t5, $[18] = t11) : t11 = $[18];
+  const pane = t11, [errorParams, setErrorParams] = useState(null);
+  let t12;
+  $[19] === /* @__PURE__ */ Symbol.for("react.memo_cache_sentinel") ? (t12 = () => setErrorParams(null), $[19] = t12) : t12 = $[19];
+  const handleRetry = t12, [structureParams] = useState(_temp$e);
+  let t13;
+  $[20] === /* @__PURE__ */ Symbol.for("react.memo_cache_sentinel") ? (t13 = () => setErrorParams(null), $[20] = t13) : t13 = $[20];
+  let t14;
+  if ($[21] !== refs ? (t14 = [refs], $[21] = refs, $[22] = t14) : t14 = $[22], useEffect(t13, t14), errorParams) {
+    let t152;
+    $[23] !== t ? (t152 = t("document-list-pane.error.text"), $[23] = t, $[24] = t152) : t152 = $[24];
+    let t162;
+    $[25] !== devMode || $[26] !== errorParams || $[27] !== t ? (t162 = devMode && /* @__PURE__ */ jsx(Card, { overflow: "auto", padding: 3, radius: 2, tone: "critical", children: /* @__PURE__ */ jsxs(Stack, { space: 3, children: [
       /* @__PURE__ */ jsx(Label, { muted: !0, size: 0, children: t("presentation-error.label") }),
       /* @__PURE__ */ jsx(WrappedCode$1, { size: 1, children: errorParams.error.message })
-    ] }) }), $[18] = devMode, $[19] = errorParams, $[20] = t, $[21] = t82) : t82 = $[21];
-    let t9;
-    return $[22] !== t72 || $[23] !== t82 ? (t9 = /* @__PURE__ */ jsx(ErrorCard, { flex: 1, message: t72, onRetry: handleRetry, children: t82 }), $[22] = t72, $[23] = t82, $[24] = t9) : t9 = $[24], t9;
+    ] }) }), $[25] = devMode, $[26] = errorParams, $[27] = t, $[28] = t162) : t162 = $[28];
+    let t17;
+    return $[29] !== t152 || $[30] !== t162 ? (t17 = /* @__PURE__ */ jsx(ErrorCard, { flex: 1, message: t152, onRetry: handleRetry, children: t162 }), $[29] = t152, $[30] = t162, $[31] = t17) : t17 = $[31], t17;
   }
-  let t7;
-  $[25] !== pane ? (t7 = /* @__PURE__ */ jsx(Root, { direction: "column", flex: 1, children: /* @__PURE__ */ jsx(DocumentListPane$1, { index: 0, itemId: "$root", pane, paneKey: "$root" }) }), $[25] = pane, $[26] = t7) : t7 = $[26];
-  let t8;
-  return $[27] !== onEditReference || $[28] !== onStructureParams || $[29] !== refs || $[30] !== searchParams || $[31] !== structureParams || $[32] !== t7 ? (t8 = /* @__PURE__ */ jsx(ErrorBoundary, { onCatch: setErrorParams, children: /* @__PURE__ */ jsx(RootLayout, { children: /* @__PURE__ */ jsx(StructureToolProvider, { children: /* @__PURE__ */ jsx(PresentationPaneRouterProvider, { onEditReference, onStructureParams, structureParams, searchParams, refs, children: t7 }) }) }) }), $[27] = onEditReference, $[28] = onStructureParams, $[29] = refs, $[30] = searchParams, $[31] = structureParams, $[32] = t7, $[33] = t8) : t8 = $[33], t8;
+  let t15;
+  $[32] !== pane ? (t15 = /* @__PURE__ */ jsx(Root, { direction: "column", flex: 1, children: /* @__PURE__ */ jsx(DocumentListPane$1, { index: 0, itemId: "$root", pane, paneKey: "$root" }) }), $[32] = pane, $[33] = t15) : t15 = $[33];
+  let t16;
+  return $[34] !== onEditReference || $[35] !== onStructureParams || $[36] !== refs || $[37] !== searchParams || $[38] !== structureParams || $[39] !== t15 ? (t16 = /* @__PURE__ */ jsx(ErrorBoundary, { onCatch: setErrorParams, children: /* @__PURE__ */ jsx(RootLayout, { children: /* @__PURE__ */ jsx(StructureToolProvider, { children: /* @__PURE__ */ jsx(PresentationPaneRouterProvider, { onEditReference, onStructureParams, structureParams, searchParams, refs, children: t15 }) }) }) }), $[34] = onEditReference, $[35] = onStructureParams, $[36] = refs, $[37] = searchParams, $[38] = structureParams, $[39] = t15, $[40] = t16) : t16 = $[40], t16;
 }
-function _temp2$7() {
+function _temp$e() {
   return {};
 }
-function _temp$e(r_0) {
-  return getPublishedId(r_0._id);
-}
 const WrappedCode = styled(Code).withConfig({
   displayName: "WrappedCode",
   componentId: "sc-m0u57n-0"
@@ -991,7 +1052,7 @@ function usePreviewState(documentId, schemaType2) {
   }, t2 = [documentPreviewStore, schemaType2, documentId, perspectiveStack], $[1] = documentId, $[2] = documentPreviewStore, $[3] = perspectiveStack, $[4] = schemaType2, $[5] = t1, $[6] = t2) : (t1 = $[5], t2 = $[6]), useEffect(t1, t2), preview;
 }
 function ContentEditor(props) {
-  const $ = c(40), {
+  const $ = c(41), {
     documentId,
     documentType,
     mainDocumentState,
@@ -999,6 +1060,7 @@ function ContentEditor(props) {
     onFocusPath,
     onStructureParams,
     refs,
+    visualOrderPublishedIds,
     searchParams,
     structureParams
   } = props, {
@@ -1047,12 +1109,12 @@ function ContentEditor(props) {
     } }) }) })
   ] }) }) }), $[26] = MainDocumentLink, $[27] = mainDocumentState, $[28] = preview, $[29] = t, $[30] = t3) : t3 = $[30];
   let t4;
-  $[31] !== mainDocumentState || $[32] !== onEditReference || $[33] !== onStructureParams || $[34] !== refs || $[35] !== searchParams ? (t4 = /* @__PURE__ */ jsx(DocumentListPane, { mainDocumentState, onEditReference, onStructureParams, searchParams, refs }), $[31] = mainDocumentState, $[32] = onEditReference, $[33] = onStructureParams, $[34] = refs, $[35] = searchParams, $[36] = t4) : t4 = $[36];
+  $[31] !== mainDocumentState || $[32] !== onEditReference || $[33] !== onStructureParams || $[34] !== refs || $[35] !== searchParams || $[36] !== visualOrderPublishedIds ? (t4 = /* @__PURE__ */ jsx(DocumentListPane, { mainDocumentState, onEditReference, onStructureParams, searchParams, refs, visualOrderPublishedIds }), $[31] = mainDocumentState, $[32] = onEditReference, $[33] = onStructureParams, $[34] = refs, $[35] = searchParams, $[36] = visualOrderPublishedIds, $[37] = t4) : t4 = $[37];
   let t5;
-  return $[37] !== t3 || $[38] !== t4 ? (t5 = /* @__PURE__ */ jsxs(Flex, { direction: "column", flex: 1, height: "fill", children: [
+  return $[38] !== t3 || $[39] !== t4 ? (t5 = /* @__PURE__ */ jsxs(Flex, { direction: "column", flex: 1, height: "fill", children: [
     t3,
     t4
-  ] }), $[37] = t3, $[38] = t4, $[39] = t5) : t5 = $[39], t5;
+  ] }), $[38] = t3, $[39] = t4, $[40] = t5) : t5 = $[40], t5;
 }
 function usePanelId(id) {
   const $ = c(2);
@@ -1186,9 +1248,10 @@ const Resizer = styled.div.withConfig({
     t4
   ] }), $[13] = t0, $[14] = t4, $[15] = t5) : t5 = $[15], t5;
 }, PresentationContent = (props) => {
-  const $ = c(17), {
+  const $ = c(18), {
     documentId,
     documentsOnPage,
+    visualOrderPublishedIds,
     documentType,
     getCommentIntent,
     hidden,
@@ -1202,9 +1265,9 @@ const Resizer = styled.div.withConfig({
     structureParams
   } = props;
   let t0;
-  $[0] !== documentId || $[1] !== documentType || $[2] !== documentsOnPage || $[3] !== mainDocumentState || $[4] !== onEditReference || $[5] !== onFocusPath || $[6] !== onStructureParams || $[7] !== searchParams || $[8] !== structureParams ? (t0 = /* @__PURE__ */ jsx(ContentEditor, { documentId, documentType, mainDocumentState, onEditReference, onFocusPath, onStructureParams, refs: documentsOnPage, searchParams, structureParams }), $[0] = documentId, $[1] = documentType, $[2] = documentsOnPage, $[3] = mainDocumentState, $[4] = onEditReference, $[5] = onFocusPath, $[6] = onStructureParams, $[7] = searchParams, $[8] = structureParams, $[9] = t0) : t0 = $[9];
+  $[0] !== documentId || $[1] !== documentType || $[2] !== documentsOnPage || $[3] !== mainDocumentState || $[4] !== onEditReference || $[5] !== onFocusPath || $[6] !== onStructureParams || $[7] !== searchParams || $[8] !== structureParams || $[9] !== visualOrderPublishedIds ? (t0 = /* @__PURE__ */ jsx(ContentEditor, { documentId, documentType, mainDocumentState, onEditReference, onFocusPath, onStructureParams, refs: documentsOnPage, visualOrderPublishedIds, searchParams, structureParams }), $[0] = documentId, $[1] = documentType, $[2] = documentsOnPage, $[3] = mainDocumentState, $[4] = onEditReference, $[5] = onFocusPath, $[6] = onStructureParams, $[7] = searchParams, $[8] = structureParams, $[9] = visualOrderPublishedIds, $[10] = t0) : t0 = $[10];
   let t1;
-  return $[10] !== documentId || $[11] !== getCommentIntent || $[12] !== hidden || $[13] !== resizerHidden || $[14] !== setDisplayedDocument || $[15] !== t0 ? (t1 = /* @__PURE__ */ jsx(PresentationContentWrapper, { documentId, getCommentIntent, hidden, resizerHidden, setDisplayedDocument, children: t0 }), $[10] = documentId, $[11] = getCommentIntent, $[12] = hidden, $[13] = resizerHidden, $[14] = setDisplayedDocument, $[15] = t0, $[16] = t1) : t1 = $[16], t1;
+  return $[11] !== documentId || $[12] !== getCommentIntent || $[13] !== hidden || $[14] !== resizerHidden || $[15] !== setDisplayedDocument || $[16] !== t0 ? (t1 = /* @__PURE__ */ jsx(PresentationContentWrapper, { documentId, getCommentIntent, hidden, resizerHidden, setDisplayedDocument, children: t0 }), $[11] = documentId, $[12] = getCommentIntent, $[13] = hidden, $[14] = resizerHidden, $[15] = setDisplayedDocument, $[16] = t0, $[17] = t1) : t1 = $[17], t1;
 }, PresentationNavigateProvider = function(props) {
   const $ = c(5), {
     children,
@@ -1757,7 +1820,7 @@ const PreviewHeaderDefault = (props) => {
       }));
     });
   }, $[3] = iframeRef, $[4] = onRefresh, $[5] = presentationRef, $[6] = previewUrl, $[7] = targetOrigin, $[8] = t1) : t1 = $[8];
-  const handleRefresh = t1, isLoading = useSelector(presentationRef, _temp$a), isLoaded = useSelector(presentationRef, _temp2$6), isRefreshing = useSelector(presentationRef, _temp3$2), isReloading = useSelector(presentationRef, _temp4$1), overlaysEnabled = useSelector(presentationRef, _temp5$1);
+  const handleRefresh = t1, isLoading = useSelector(presentationRef, _temp$a), isLoaded = useSelector(presentationRef, _temp2$6), isRefreshing = useSelector(presentationRef, _temp3$3), isReloading = useSelector(presentationRef, _temp4$1), overlaysEnabled = useSelector(presentationRef, _temp5$1);
   let t2;
   if ($[9] !== previewUrl || $[10] !== targetOrigin) {
     const previewURL = new URL(previewUrl || "/", targetOrigin);
@@ -1904,7 +1967,7 @@ function _temp$a(state) {
 function _temp2$6(state_0) {
   return state_0.matches("loaded");
 }
-function _temp3$2(state_1) {
+function _temp3$3(state_1) {
   return state_1.matches({
     loaded: "refreshing"
   });
@@ -2214,7 +2277,7 @@ function defineWarnOnce() {
 }
 const warnOnceAboutCrossDatasetReference = defineWarnOnce();
 function useDocumentsOnPage(perspective, frameStateRef) {
-  const $ = c(11);
+  const $ = c(15);
   validateApiPerspective(perspective);
   let t0;
   $[0] === /* @__PURE__ */ Symbol.for("react.memo_cache_sentinel") ? (t0 = {}, $[0] = t0) : t0 = $[0];
@@ -2248,7 +2311,30 @@ function useDocumentsOnPage(perspective, frameStateRef) {
   $[6] !== uniqueDocuments ? (t4 = Object.values(uniqueDocuments), $[6] = uniqueDocuments, $[7] = t4) : t4 = $[7];
   const documentsOnPage = t4;
   let t5;
-  return $[8] !== documentsOnPage || $[9] !== setDocumentsOnPage ? (t5 = [documentsOnPage, setDocumentsOnPage], $[8] = documentsOnPage, $[9] = setDocumentsOnPage, $[10] = t5) : t5 = $[10], t5;
+  bb0: {
+    const visualCache = (perspective === "published" ? published : previewDrafts)["visual-editing"];
+    if (!visualCache) {
+      let t63;
+      $[8] === /* @__PURE__ */ Symbol.for("react.memo_cache_sentinel") ? (t63 = [], $[8] = t63) : t63 = $[8], t5 = t63;
+      break bb0;
+    }
+    let t62;
+    $[9] !== visualCache ? (t62 = Object.values(visualCache).reduce(_temp3$2, {
+      orderedIds: [],
+      seen: /* @__PURE__ */ new Set()
+    }), $[9] = visualCache, $[10] = t62) : t62 = $[10];
+    const {
+      orderedIds
+    } = t62;
+    t5 = orderedIds;
+  }
+  const visualOrderPublishedIds = t5;
+  let t6;
+  return $[11] !== documentsOnPage || $[12] !== setDocumentsOnPage || $[13] !== visualOrderPublishedIds ? (t6 = [documentsOnPage, setDocumentsOnPage, visualOrderPublishedIds], $[11] = documentsOnPage, $[12] = setDocumentsOnPage, $[13] = visualOrderPublishedIds, $[14] = t6) : t6 = $[14], t6;
+}
+function _temp3$2(accumulator, document_0) {
+  const publishedId = getPublishedId(document_0._id);
+  return accumulator.seen.has(publishedId) || (accumulator.seen.add(publishedId), accumulator.orderedIds.push(publishedId)), accumulator;
 }
 function _temp2$5(acc, cache_0) {
   return Object.values(cache_0).forEach((doc) => {
@@ -2686,7 +2772,7 @@ function resolveActiveTab(activeTab, navigatorEnabled) {
   return activeTab === "navigator" && navigatorEnabled ? "navigator" : activeTab === "navigator" ? "preview" : activeTab;
 }
 function PresentationTool(props) {
-  const $ = c(214), {
+  const $ = c(215), {
     canToggleSharePreviewAccess,
     canUseSharedPreviewAccess,
     tool,
@@ -2738,7 +2824,7 @@ function PresentationTool(props) {
   $[12] !== params.scheduledDraft ? (t5 = {
     scheduledDraft: params.scheduledDraft
   }, $[12] = params.scheduledDraft, $[13] = t5) : t5 = $[13];
-  const perspective = usePresentationPerspective(t5), presentationRef = useActorRef(presentationMachine), viewport = params.viewport ? "mobile" : "desktop", [documentsOnPage, setDocumentsOnPage] = useDocumentsOnPage(perspective, frameStateRef), projectId = useProjectId(), dataset = useDataset(), t6 = tool.options?.resolve?.mainDocuments;
+  const perspective = usePresentationPerspective(t5), presentationRef = useActorRef(presentationMachine), viewport = params.viewport ? "mobile" : "desktop", [documentsOnPage, setDocumentsOnPage, visualOrderPublishedIds] = useDocumentsOnPage(perspective, frameStateRef), projectId = useProjectId(), dataset = useDataset(), t6 = tool.options?.resolve?.mainDocuments;
   let t7;
   $[14] !== navigate || $[15] !== navigationHistory || $[16] !== params.preview || $[17] !== perspective || $[18] !== t6 || $[19] !== targetOrigin ? (t7 = {
     navigate,
@@ -3020,44 +3106,44 @@ function PresentationTool(props) {
   $[132] !== t37 || $[133] !== t38 || $[134] !== t40 ? (t41 = /* @__PURE__ */ jsx(Panel, { id: "preview", htmlId: t36, minWidth: 325, defaultSize: t37, order: 3, hidden: t38, children: t40 }), $[132] = t37, $[133] = t38, $[134] = t40, $[135] = t41) : t41 = $[135];
   const t42 = isNarrow && resolvedTab !== "content";
   let t43;
-  $[136] !== documentsOnPage || $[137] !== getCommentIntent || $[138] !== handleEditReference || $[139] !== handleFocusPath || $[140] !== handleStructureParams || $[141] !== isNarrow || $[142] !== mainDocumentState || $[143] !== params.id || $[144] !== params.type || $[145] !== searchParams || $[146] !== structureParams || $[147] !== t42 ? (t43 = /* @__PURE__ */ jsx(PresentationContent, { documentId: params.id, documentsOnPage, documentType: params.type, getCommentIntent, hidden: t42, mainDocumentState, onEditReference: handleEditReference, onFocusPath: handleFocusPath, onStructureParams: handleStructureParams, resizerHidden: isNarrow, searchParams, setDisplayedDocument, structureParams }), $[136] = documentsOnPage, $[137] = getCommentIntent, $[138] = handleEditReference, $[139] = handleFocusPath, $[140] = handleStructureParams, $[141] = isNarrow, $[142] = mainDocumentState, $[143] = params.id, $[144] = params.type, $[145] = searchParams, $[146] = structureParams, $[147] = t42, $[148] = t43) : t43 = $[148];
+  $[136] !== documentsOnPage || $[137] !== getCommentIntent || $[138] !== handleEditReference || $[139] !== handleFocusPath || $[140] !== handleStructureParams || $[141] !== isNarrow || $[142] !== mainDocumentState || $[143] !== params.id || $[144] !== params.type || $[145] !== searchParams || $[146] !== structureParams || $[147] !== t42 || $[148] !== visualOrderPublishedIds ? (t43 = /* @__PURE__ */ jsx(PresentationContent, { documentId: params.id, documentsOnPage, visualOrderPublishedIds, documentType: params.type, getCommentIntent, hidden: t42, mainDocumentState, onEditReference: handleEditReference, onFocusPath: handleFocusPath, onStructureParams: handleStructureParams, resizerHidden: isNarrow, searchParams, setDisplayedDocument, structureParams }), $[136] = documentsOnPage, $[137] = getCommentIntent, $[138] = handleEditReference, $[139] = handleFocusPath, $[140] = handleStructureParams, $[141] = isNarrow, $[142] = mainDocumentState, $[143] = params.id, $[144] = params.type, $[145] = searchParams, $[146] = structureParams, $[147] = t42, $[148] = visualOrderPublishedIds, $[149] = t43) : t43 = $[149];
   let t44;
-  $[149] !== t35 || $[150] !== t41 || $[151] !== t43 ? (t44 = /* @__PURE__ */ jsx(Flex, { direction: "column", flex: 1, style: t33, children: /* @__PURE__ */ jsxs(Panels, { children: [
+  $[150] !== t35 || $[151] !== t41 || $[152] !== t43 ? (t44 = /* @__PURE__ */ jsx(Flex, { direction: "column", flex: 1, style: t33, children: /* @__PURE__ */ jsxs(Panels, { children: [
     t35,
     t41,
     t43
-  ] }) }), $[149] = t35, $[150] = t41, $[151] = t43, $[152] = t44) : t44 = $[152];
+  ] }) }), $[150] = t35, $[151] = t41, $[152] = t43, $[153] = t44) : t44 = $[153];
   let t45;
-  $[153] !== t32 || $[154] !== t44 ? (t45 = /* @__PURE__ */ jsxs(Container, { "data-testid": "presentation-root", direction: "column", height: "fill", children: [
+  $[154] !== t32 || $[155] !== t44 ? (t45 = /* @__PURE__ */ jsxs(Container, { "data-testid": "presentation-root", direction: "column", height: "fill", children: [
     t32,
     t44
-  ] }), $[153] = t32, $[154] = t44, $[155] = t45) : t45 = $[155];
+  ] }), $[154] = t32, $[155] = t44, $[156] = t45) : t45 = $[156];
   let t46;
-  $[156] !== t45 || $[157] !== visualEditingComlink ? (t46 = /* @__PURE__ */ jsx(SharedStateProvider, { comlink: visualEditingComlink, children: t45 }), $[156] = t45, $[157] = visualEditingComlink, $[158] = t46) : t46 = $[158];
+  $[157] !== t45 || $[158] !== visualEditingComlink ? (t46 = /* @__PURE__ */ jsx(SharedStateProvider, { comlink: visualEditingComlink, children: t45 }), $[157] = t45, $[158] = visualEditingComlink, $[159] = t46) : t46 = $[159];
   let t47;
-  $[159] !== params || $[160] !== t46 ? (t47 = /* @__PURE__ */ jsx(PresentationParamsProvider, { params, children: t46 }), $[159] = params, $[160] = t46, $[161] = t47) : t47 = $[161];
+  $[160] !== params || $[161] !== t46 ? (t47 = /* @__PURE__ */ jsx(PresentationParamsProvider, { params, children: t46 }), $[160] = params, $[161] = t46, $[162] = t47) : t47 = $[162];
   let t48;
-  $[162] !== navigate || $[163] !== t47 ? (t48 = /* @__PURE__ */ jsx(PresentationNavigateProvider, { navigate, children: t47 }), $[162] = navigate, $[163] = t47, $[164] = t48) : t48 = $[164];
+  $[163] !== navigate || $[164] !== t47 ? (t48 = /* @__PURE__ */ jsx(PresentationNavigateProvider, { navigate, children: t47 }), $[163] = navigate, $[164] = t47, $[165] = t48) : t48 = $[165];
   let t49;
-  $[165] !== devMode || $[166] !== name || $[167] !== navigate || $[168] !== params || $[169] !== searchParams || $[170] !== structureParams || $[171] !== t48 ? (t49 = /* @__PURE__ */ jsx(PresentationProvider, { devMode, name, navigate, params, searchParams, structureParams, children: t48 }), $[165] = devMode, $[166] = name, $[167] = navigate, $[168] = params, $[169] = searchParams, $[170] = structureParams, $[171] = t48, $[172] = t49) : t49 = $[172];
+  $[166] !== devMode || $[167] !== name || $[168] !== navigate || $[169] !== params || $[170] !== searchParams || $[171] !== structureParams || $[172] !== t48 ? (t49 = /* @__PURE__ */ jsx(PresentationProvider, { devMode, name, navigate, params, searchParams, structureParams, children: t48 }), $[166] = devMode, $[167] = name, $[168] = navigate, $[169] = params, $[170] = searchParams, $[171] = structureParams, $[172] = t48, $[173] = t49) : t49 = $[173];
   let t50;
-  $[173] !== controller || $[174] !== displayedDocument || $[175] !== perspective || $[176] !== setDocumentsOnPage || $[177] !== setLoadersConnection ? (t50 = controller && /* @__PURE__ */ jsx(LiveQueries, { controller, perspective, liveDocument: displayedDocument, onDocumentsOnPage: setDocumentsOnPage, onLoadersConnection: setLoadersConnection }), $[173] = controller, $[174] = displayedDocument, $[175] = perspective, $[176] = setDocumentsOnPage, $[177] = setLoadersConnection, $[178] = t50) : t50 = $[178];
+  $[174] !== controller || $[175] !== displayedDocument || $[176] !== perspective || $[177] !== setDocumentsOnPage || $[178] !== setLoadersConnection ? (t50 = controller && /* @__PURE__ */ jsx(LiveQueries, { controller, perspective, liveDocument: displayedDocument, onDocumentsOnPage: setDocumentsOnPage, onLoadersConnection: setLoadersConnection }), $[174] = controller, $[175] = displayedDocument, $[176] = perspective, $[177] = setDocumentsOnPage, $[178] = setLoadersConnection, $[179] = t50) : t50 = $[179];
   let t51;
-  $[179] !== loadersConnection || $[180] !== params.id || $[181] !== params.type || $[182] !== previewKitConnection || $[183] !== visualEditingComlink ? (t51 = visualEditingComlink && params.id && params.type && /* @__PURE__ */ jsx(PostMessageRefreshMutations, { comlink: visualEditingComlink, id: params.id, type: params.type, loadersConnection, previewKitConnection }), $[179] = loadersConnection, $[180] = params.id, $[181] = params.type, $[182] = previewKitConnection, $[183] = visualEditingComlink, $[184] = t51) : t51 = $[184];
+  $[180] !== loadersConnection || $[181] !== params.id || $[182] !== params.type || $[183] !== previewKitConnection || $[184] !== visualEditingComlink ? (t51 = visualEditingComlink && params.id && params.type && /* @__PURE__ */ jsx(PostMessageRefreshMutations, { comlink: visualEditingComlink, id: params.id, type: params.type, loadersConnection, previewKitConnection }), $[180] = loadersConnection, $[181] = params.id, $[182] = params.type, $[183] = previewKitConnection, $[184] = visualEditingComlink, $[185] = t51) : t51 = $[185];
   let t52;
-  $[185] !== perspective || $[186] !== visualEditingComlink ? (t52 = visualEditingComlink && /* @__PURE__ */ jsx(PostMessageSchema, { comlink: visualEditingComlink, perspective }), $[185] = perspective, $[186] = visualEditingComlink, $[187] = t52) : t52 = $[187];
+  $[186] !== perspective || $[187] !== visualEditingComlink ? (t52 = visualEditingComlink && /* @__PURE__ */ jsx(PostMessageSchema, { comlink: visualEditingComlink, perspective }), $[186] = perspective, $[187] = visualEditingComlink, $[188] = t52) : t52 = $[188];
   let t53;
-  $[188] !== documentsOnPage || $[189] !== perspective || $[190] !== visualEditingComlink ? (t53 = visualEditingComlink && documentsOnPage.length > 0 && /* @__PURE__ */ jsx(PostMessagePreviewSnapshots, { comlink: visualEditingComlink, perspective, refs: documentsOnPage }), $[188] = documentsOnPage, $[189] = perspective, $[190] = visualEditingComlink, $[191] = t53) : t53 = $[191];
+  $[189] !== documentsOnPage || $[190] !== perspective || $[191] !== visualEditingComlink ? (t53 = visualEditingComlink && documentsOnPage.length > 0 && /* @__PURE__ */ jsx(PostMessagePreviewSnapshots, { comlink: visualEditingComlink, perspective, refs: documentsOnPage }), $[189] = documentsOnPage, $[190] = perspective, $[191] = visualEditingComlink, $[192] = t53) : t53 = $[192];
   let t54;
-  $[192] !== perspective || $[193] !== visualEditingComlink ? (t54 = visualEditingComlink && /* @__PURE__ */ jsx(PostMessageDocuments, { comlink: visualEditingComlink, perspective }), $[192] = perspective, $[193] = visualEditingComlink, $[194] = t54) : t54 = $[194];
+  $[193] !== perspective || $[194] !== visualEditingComlink ? (t54 = visualEditingComlink && /* @__PURE__ */ jsx(PostMessageDocuments, { comlink: visualEditingComlink, perspective }), $[193] = perspective, $[194] = visualEditingComlink, $[195] = t54) : t54 = $[195];
   let t55;
-  $[195] !== visualEditingComlink ? (t55 = visualEditingComlink && /* @__PURE__ */ jsx(PostMessageFeatures, { comlink: visualEditingComlink }), $[195] = visualEditingComlink, $[196] = t55) : t55 = $[196];
+  $[196] !== visualEditingComlink ? (t55 = visualEditingComlink && /* @__PURE__ */ jsx(PostMessageFeatures, { comlink: visualEditingComlink }), $[196] = visualEditingComlink, $[197] = t55) : t55 = $[197];
   let t56;
-  $[197] !== perspective || $[198] !== visualEditingComlink ? (t56 = visualEditingComlink && /* @__PURE__ */ jsx(PostMessagePerspective, { comlink: visualEditingComlink, perspective, setHandlesPerspectiveChange }), $[197] = perspective, $[198] = visualEditingComlink, $[199] = t56) : t56 = $[199];
+  $[198] !== perspective || $[199] !== visualEditingComlink ? (t56 = visualEditingComlink && /* @__PURE__ */ jsx(PostMessagePerspective, { comlink: visualEditingComlink, perspective, setHandlesPerspectiveChange }), $[198] = perspective, $[199] = visualEditingComlink, $[200] = t56) : t56 = $[200];
   let t57;
-  $[200] !== visualEditingComlink ? (t57 = visualEditingComlink && /* @__PURE__ */ jsx(PostMessageTelemetry, { comlink: visualEditingComlink }), $[200] = visualEditingComlink, $[201] = t57) : t57 = $[201];
+  $[201] !== visualEditingComlink ? (t57 = visualEditingComlink && /* @__PURE__ */ jsx(PostMessageTelemetry, { comlink: visualEditingComlink }), $[201] = visualEditingComlink, $[202] = t57) : t57 = $[202];
   let t58;
-  $[202] !== t50 || $[203] !== t51 || $[204] !== t52 || $[205] !== t53 || $[206] !== t54 || $[207] !== t55 || $[208] !== t56 || $[209] !== t57 ? (t58 = /* @__PURE__ */ jsxs(Suspense, { children: [
+  $[203] !== t50 || $[204] !== t51 || $[205] !== t52 || $[206] !== t53 || $[207] !== t54 || $[208] !== t55 || $[209] !== t56 || $[210] !== t57 ? (t58 = /* @__PURE__ */ jsxs(Suspense, { children: [
     t50,
     t51,
     t52,
@@ -3066,12 +3152,12 @@ function PresentationTool(props) {
     t55,
     t56,
     t57
-  ] }), $[202] = t50, $[203] = t51, $[204] = t52, $[205] = t53, $[206] = t54, $[207] = t55, $[208] = t56, $[209] = t57, $[210] = t58) : t58 = $[210];
+  ] }), $[203] = t50, $[204] = t51, $[205] = t52, $[206] = t53, $[207] = t54, $[208] = t55, $[209] = t56, $[210] = t57, $[211] = t58) : t58 = $[211];
   let t59;
-  return $[211] !== t49 || $[212] !== t58 ? (t59 = /* @__PURE__ */ jsxs(Fragment, { children: [
+  return $[212] !== t49 || $[213] !== t58 ? (t59 = /* @__PURE__ */ jsxs(Fragment, { children: [
     t49,
     t58
-  ] }), $[211] = t49, $[212] = t58, $[213] = t59) : t59 = $[213], t59;
+  ] }), $[212] = t49, $[213] = t58, $[214] = t59) : t59 = $[214], t59;
 }
 function _temp2$2(state_0) {
   return state_0.matches("loading");