@backmatter/studio 0.0.10 → 0.0.11

package/dist/chunks/{dashboard-8rjkfEXl.js → dashboard-kWmpeuAP.js}

@@ -3,7 +3,7 @@ var Xe = (e, t, n) => t in e ? Ke(e, t, { enumerable: !0, configurable: !0, writ
 var D = (e, t, n) => Xe(e, typeof t != "symbol" ? t + "" : t, n);
 import { jsxs as k, jsx as o, Fragment as be } from "react/jsx-runtime";
 import { useRef as Ye, useCallback as Qe, useSyncExternalStore as Ze, useState as w, useEffect as V, lazy as et, Suspense as tt } from "react";
-import { O as nt, ag as ye, ah as rt, K as _, ai as st, p as it, aj as at, ak as Ne, al as Ce, am as Ie, an as ot, ao as lt, N as qe, ap as ct, aq as ie, aa as J, Q as ze, ar as ut, as as Fe, ab as dt, ad as re, a4 as Q, a5 as Z, P as ae, at as ft, M as z, au as ht, z as ve, av as ee, ac as pt, aw as gt, ax as mt, ay as xt, f as yt, az as vt, a0 as bt, aA as wt, aB as kt, q as St, B as Et, y as Rt, aC as _t, aD as Ot, aE as Tt, A as Pt, aF as Lt, R as At, F as jt, G as Ut, H as Nt, I as F, L as Ct, J as It } from "./WorkspaceRoutes-BKKEkAq7.js";
+import { O as nt, ag as ye, ah as rt, K as _, ai as st, p as it, aj as at, ak as Ne, al as Ce, am as Ie, an as ot, ao as lt, N as qe, ap as ct, aq as ie, aa as J, Q as ze, ar as ut, as as Fe, ab as dt, ad as re, a4 as Q, a5 as Z, P as ae, at as ft, M as z, au as ht, z as ve, av as ee, ac as pt, aw as gt, ax as mt, ay as xt, f as yt, az as vt, a0 as bt, aA as wt, aB as kt, q as St, B as Et, y as Rt, aC as _t, aD as Ot, aE as Tt, A as Pt, aF as Lt, R as At, F as jt, G as Ut, H as Nt, I as F, L as Ct, J as It } from "./WorkspaceRoutes-Dzpaj8ov.js";
 const te = /* @__PURE__ */ Object.create(null), W = (e) => {
   var t, n;
   return ((t = globalThis.process) == null ? void 0 : t.env) || ((n = globalThis.Deno) == null ? void 0 : n.env.toObject()) || globalThis.__env__ || (e ? te : globalThis);
@@ -1701,7 +1701,7 @@ function kr(e) {
   const t = e.replace(/\/$/, "") || "/";
   return t === "/__ui" || /^\/__ui\/[^/]+$/.test(t);
 }
-const Sr = et(() => import("./UiKitApp-BxvTwsko.js").then((e) => ({
+const Sr = et(() => import("./UiKitApp-Cu0CS1NU.js").then((e) => ({
   default: e.UiKitApp
 })));
 function Pr() {

package/dist/chunks/{index-laWAz5_p.js → index-Bryt_VJQ.js}

@@ -1,7 +1,7 @@
 var Rs = Object.defineProperty;
 var Es = (r, e, t) => e in r ? Rs(r, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : r[e] = t;
 var M = (r, e, t) => Es(r, typeof e != "symbol" ? e + "" : e, t);
-import { aG as Bt, aH as Bs, aI as a0, aJ as ct, aK as xt, aL as ea, aM as Gn, aN as Is, aO as Ls, aP as Ds, aQ as La, aR as Ps, aS as Os, aT as Le, aU as qs } from "./WorkspaceRoutes-BKKEkAq7.js";
+import { aG as Bt, aH as Bs, aI as a0, aJ as ct, aK as xt, aL as ea, aM as Gn, aN as Is, aO as Ls, aP as Ds, aQ as La, aR as Ps, aS as Os, aT as Le, aU as qs } from "./WorkspaceRoutes-Dzpaj8ov.js";
 function Fs() {
   return {
     enter: {

package/dist/dashboard.js

@@ -1,5 +1,5 @@
-import { A as a, i as s } from "./chunks/dashboard-8rjkfEXl.js";
-import { w as t, x as f } from "./chunks/WorkspaceRoutes-BKKEkAq7.js";
+import { A as a, i as s } from "./chunks/dashboard-kWmpeuAP.js";
+import { w as t, x as f } from "./chunks/WorkspaceRoutes-Dzpaj8ov.js";
 export {
   a as DashboardApp,
   t as configureStudio,

package/dist/index.js

@@ -1,7 +1,7 @@
 import { jsx as t, jsxs as d } from "react/jsx-runtime";
 import { useLayoutEffect as re, useEffect as f, useRef as W, useState as g, useMemo as oe } from "react";
-import { i as J, T as ae, E as se, C as ce, a as le, b as de, u as ue, D as A, c as X, d as B, e as xe, f as Y, g as G, h as me, p as z, j as C, k as N, r as fe, n as he, s as pe, l as ge, m as we, o as be, q as ye, B as ve, t as ke, S as qe, v as Ee, w as Q, x as P, y as ze, z as Ce, A as Ne, R as Se, F as Re, G as Le, H as Pe, I as S, N as I, L as Ue, J as je, K as F, M as Te } from "./chunks/WorkspaceRoutes-BKKEkAq7.js";
-import { O as ot } from "./chunks/WorkspaceRoutes-BKKEkAq7.js";
+import { i as J, T as ae, E as se, C as ce, a as le, b as de, u as ue, D as A, c as X, d as B, e as xe, f as Y, g as G, h as me, p as z, j as C, k as N, r as fe, n as he, s as pe, l as ge, m as we, o as be, q as ye, B as ve, t as ke, S as qe, v as Ee, w as Q, x as P, y as ze, z as Ce, A as Ne, R as Se, F as Re, G as Le, H as Pe, I as S, N as I, L as Ue, J as je, K as F, M as Te } from "./chunks/WorkspaceRoutes-Dzpaj8ov.js";
+import { O as ot } from "./chunks/WorkspaceRoutes-Dzpaj8ov.js";
 import { u as Me, S as _e } from "./chunks/define-studio-BYtYDGLX.js";
 import { d as st } from "./chunks/define-studio-BYtYDGLX.js";
 const R = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backmatter/studio",
-  "version": "0.0.10",
+  "version": "0.0.11",
   "description": "The Backmatter editing surface: document editor, AI chat, publish. Mounted on your site or hosted on the dashboard.",
   "type": "module",
   "publishConfig": {

package/src/api.ts

@@ -501,7 +501,7 @@ export function notifyTreeChanged(detail?: TreeChangeDetail) {
   );
 }
 
-/** Branch HEAD moved (teammate push, pull, commit); clean docs should reload. */
+/** Branch HEAD moved (teammate push, pull, commit). Clean docs reload their fields. The preview frame stays up. */
 export function notifyHeadChanged() {
   window.dispatchEvent(new Event("backmatter:head-changed"));
 }

package/src/chrome/WorkspaceStatusBar.tsx

@@ -35,9 +35,11 @@ import { replicaStore } from "../replica/instance";
 import { useReplicaSession } from "../replica/ReplicaProvider";
 import { useReplicaState } from "../replica/useReplica";
 import { useWorkspaceNav } from "./WorkspaceNavContext";
+import { branchHeadMoved } from "./branch-head";
 import { commitTriggerDisabled, statusBarAction } from "./status-bar-action";
 
 const hover = "@media (hover: hover)";
+/** Status bar only. The preview frame follows HEAD on its SSE stream, not on this poll. */
 const POLL_MS = 8000;
 
 export const STATUS_LABEL: Record<ChangeStatus, string> = {
@@ -181,7 +183,8 @@ export function WorkspaceStatusBar({ workspaceId }: { workspaceId: string }) {
   const [resolvingKey, setResolvingKey] = useState<string | null>(null);
   const [message, setMessage] = useState("");
   const [error, setError] = useState<string | null>(null);
-  // HEAD identity from the last poll so we can announce "HEAD moved".
+  // Commit sha from the last poll. A new sha means HEAD moved. The preview
+  // iframe does not reload for that; its page follows the SSE head event.
   const lastHead = useRef<string | null | undefined>(undefined);
 
   async function reloadGit() {
@@ -195,11 +198,9 @@ export function WorkspaceStatusBar({ workspaceId }: { workspaceId: string }) {
       } else {
         setError(null);
       }
-      const headKey = next.head ? `${next.head.sha}:${next.head.updatedAt}` : null;
-      if (lastHead.current !== undefined && lastHead.current !== headKey) {
-        notifyHeadChanged();
-      }
-      lastHead.current = headKey;
+      const nextSha = next.head?.sha ?? null;
+      if (branchHeadMoved(lastHead.current, nextSha)) notifyHeadChanged();
+      lastHead.current = nextSha;
     } catch (err) {
       setError(err instanceof Error ? err.message : "Git status failed");
     }

package/src/chrome/branch-head.ts

@@ -0,0 +1,14 @@
+// packages/studio/src/chrome/branch-head.ts
+
+/**
+ * Whether a later git poll is a new commit.
+ * The first sample only records the sha. `updatedAt` is not part of the
+ * identity: rewriting the head row must not look like HEAD moved.
+ */
+export function branchHeadMoved(
+  previousSha: string | null | undefined,
+  nextSha: string | null,
+): boolean {
+  if (previousSha === undefined) return false;
+  return previousSha !== nextSha;
+}

package/src/pages/DocEditorPage.tsx

@@ -49,9 +49,10 @@ import {
 import {
   editorPreviewPath,
   modelForType,
-  previewSiteUrl,
-  primarySiteUrl,
   onSitePreviewUrl,
+  previewEnableUrl,
+  previewFrameIdentity,
+  primarySiteUrl,
   studioIsOnSite,
   productionDocUrl,
 } from "./preview-url";
@@ -255,31 +256,35 @@ export function DocEditorPage() {
     fieldNames.find((name) => fieldKinds[name] === "blocks") ?? "blocks";
   const siteUrl = primarySiteUrl(workspace.siteUrls ?? []);
   const liveUrl = productionDocUrl(siteUrl, modelForType(models, type), locale, slug);
+  const previewPath = editorPreviewPath(
+    modelForType(models, type),
+    slug,
+    locale,
+    branch,
+    tree,
+  );
+  // Strings only. A replica refresh builds new models and siteUrls arrays
+  // with the same contents; that must not mint a ticket and reload the frame.
+  const frameIdentity = previewFrameIdentity({
+    siteUrl,
+    path: showPreview ? previewPath : null,
+    branch,
+    tree,
+  });
 
   useEffect(() => {
-    if (!showPreview) {
-      setPreviewUrl(null);
-      return;
-    }
-    const redirect = editorPreviewPath(
-      modelForType(models, type),
-      slug,
-      locale,
-      branch,
-      tree,
-    );
-    if (!redirect || !workspaceId || !siteUrl) {
+    if (!frameIdentity || !previewPath || !workspaceId || !siteUrl) {
       setPreviewUrl(null);
       return;
     }
     if (studioIsOnSite(siteUrl, window.location.origin)) {
-      setPreviewUrl(onSitePreviewUrl(siteUrl, redirect));
+      setPreviewUrl(onSitePreviewUrl(siteUrl, previewPath));
       return;
     }
     let cancelled = false;
-    void createPreviewTicket(workspaceId, { redirect, branch, tree })
+    void createPreviewTicket(workspaceId, { redirect: previewPath, branch, tree })
       .then((res) => {
-        if (!cancelled) setPreviewUrl(previewSiteUrl(workspace.siteUrls ?? [], res.ticket));
+        if (!cancelled) setPreviewUrl(previewEnableUrl(siteUrl, res.ticket));
       })
       .catch(() => {
         if (!cancelled) setPreviewUrl(null);
@@ -287,7 +292,7 @@ export function DocEditorPage() {
     return () => {
       cancelled = true;
     };
-  }, [showPreview, workspaceId, workspace.siteUrls, siteUrl, models, type, slug, locale, branch, tree]);
+  }, [frameIdentity, previewPath, workspaceId, siteUrl, branch, tree]);
 
   useEffect(() => {
     setPreviewLoading(true);
@@ -539,13 +544,12 @@ export function DocEditorPage() {
       setDocStatus(detail.status);
       setSource(detail.status === "clean" ? "head" : "tree");
     }
-    // Branch HEAD moved (teammate push / pull / commit). A clean doc reloads to
-    // show the new HEAD; a doc I am editing keeps my text and just refreshes its
-    // status, which the server reports as `conflict` when HEAD touched this file.
+    // Branch HEAD moved (teammate push / pull / commit). A clean doc reloads its
+    // fields. The preview frame stays mounted: the page follows the same move
+    // on its SSE stream and refreshes in place.
     function onHeadChanged() {
       if (docStatusRef.current === "clean") {
         onChanged();
-        remountPreview();
         return;
       }
       void fetchDoc(workspaceId, locale, type, slug)

package/src/pages/preview-url.ts

@@ -32,6 +32,21 @@ export function editorPreviewPath(
   return `${path}?${params.toString()}`;
 }
 
+/**
+ * Identity of the preview iframe. Equal results must keep the frame mounted.
+ * A replacement models array or siteUrls array is not a new target; the page
+ * inside the frame follows saves and HEAD on its SSE stream.
+ */
+export function previewFrameIdentity(input: {
+  siteUrl: string | null;
+  path: string | null;
+  branch: string | null;
+  tree: string | null;
+}): string | null {
+  if (!input.siteUrl || !input.path || !input.branch?.trim() || !input.tree?.trim()) return null;
+  return `${input.siteUrl}\0${input.branch}\0${input.tree}\0${input.path}`;
+}
+
 /**
  * A Studio mounted on the site it previews already carries the site session
  * cookie, so the preview frame loads the page directly — no ticket.