@sobree/core 0.1.10 → 0.1.11

package/dist/createSobree.d.ts

@@ -65,6 +65,13 @@ export interface CreateSobreeOptions {
      * viewport yourself.
      */
     fitOnMount?: FitOnMount;
+    /**
+     * Show a small, non-interactive `@sobree/core` version badge at the
+     * bottom-centre of the screen. Off by default. A debug aid for
+     * confirming which renderer build is live (e.g. past a stale cache
+     * after a deploy). Forwarded to `SobreeOptions.versionBadge`.
+     */
+    versionBadge?: boolean;
 }
 /**
  * The editor handle returned by `createSobree()`. Proxies the most-used

package/dist/index.d.ts

@@ -12,6 +12,7 @@
  */
 export { createSobree } from './createSobree';
 export type { CreateSobreeOptions, SobreeContent, SobreeHandle, } from './createSobree';
+export { VERSION } from './version';
 export { parseMarkdown } from './markdown/parse';
 export { Sobree } from './sobree';
 export type { SobreeMode, SobreeOptions, SobreeEvent, SobreeEventPayload, SobreeUnsubscribe, } from './sobree';

package/dist/index.js

@@ -1439,16 +1439,16 @@ function Rs(t, e = [], n = {}) {
 function st(t, e = {}) {
   return { kind: "text", text: t, properties: e };
 }
-function gh(t, e = {}) {
+function yh(t, e = {}) {
   return { kind: "text", text: t, properties: { ...e, italic: !0 } };
 }
-function mh(t, e = {}) {
+function wh(t, e = {}) {
   return { kind: "text", text: t, properties: { ...e, bold: !0 } };
 }
-function bh() {
+function kh() {
   return { kind: "break", type: "line" };
 }
-function yh() {
+function vh() {
   return { kind: "break", type: "page" };
 }
 function en() {
@@ -1501,13 +1501,13 @@ function en() {
 function St(t, e) {
   return t.body.push(e), t;
 }
-function wh(t, e) {
+function xh(t, e) {
   return { type: t, partId: e };
 }
-function kh(t) {
+function Sh(t) {
   return t.kind === "paragraph";
 }
-function vh(t) {
+function Th(t) {
   return t.kind === "table";
 }
 function Or(t) {
@@ -4087,7 +4087,7 @@ const Lc = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   isBlobHash: ti,
   sha256Hex: on
 }, Symbol.toStringTag, { value: "Module" }));
-function xh() {
+function Eh() {
   const t = /* @__PURE__ */ new Map();
   return {
     async put(e) {
@@ -4106,7 +4106,7 @@ function xh() {
     }
   };
 }
-function Sh(t) {
+function Ah(t) {
   const e = t.baseUrl.replace(/\/+$/, ""), n = t.fetch ?? globalThis.fetch;
   if (!n)
     throw new Error("fetchBlobStore: no global `fetch` available. Pass one via opts.fetch.");
@@ -10315,7 +10315,22 @@ function Zd(t) {
   const i = t.getDocument(), o = i.sections.slice(), s = o.length - 1, a = o[s];
   a && (o.push(structuredClone(a)), t.setDocument({ ...i, sections: o }));
 }
-class Qd {
+const Qd = "0.1.11", eh = Qd;
+function th(t = document) {
+  const e = t.createElement("div");
+  return e.className = "sobree-version-badge", e.textContent = `@sobree/core v${eh}`, e.setAttribute("aria-hidden", "true"), Object.assign(e.style, {
+    position: "fixed",
+    bottom: "6px",
+    left: "50%",
+    transform: "translateX(-50%)",
+    pointerEvents: "none",
+    userSelect: "none",
+    zIndex: "2147483647",
+    font: "11px/1.4 system-ui, -apple-system, sans-serif",
+    color: "rgba(0, 0, 0, 0.4)"
+  }), t.body.appendChild(e), () => e.remove();
+}
+class nh {
   constructor(e, n = {}) {
     w(this, "editor");
     w(this, "stack");
@@ -10324,6 +10339,8 @@ class Qd {
     /** Guards a single in-flight `document.fonts.ready` repagination so
      *  repeated triggers while fonts load coalesce into one re-run. */
     w(this, "fontSettleScheduled", !1);
+    /** Removes the version badge (when `versionBadge` is on). `null` otherwise. */
+    w(this, "versionBadgeTeardown", null);
     w(this, "listeners", {
       change: /* @__PURE__ */ new Set(),
       paginate: /* @__PURE__ */ new Set(),
@@ -10339,11 +10356,11 @@ class Qd {
     /** Detachers for default + user-provided plugins, run in reverse on
      *  `destroy` so attach order is mirrored on teardown. */
     w(this, "pluginDetachers", []);
-    this.setup = n.pageSetup ?? eh(n.initialDocument), this.stack = new Wd(e, this.setup);
+    this.setup = n.pageSetup ?? rh(n.initialDocument), this.stack = new Wd(e, this.setup);
     const r = {
       contentHosts: () => this.stack.contentHosts
     };
-    n.initialDocument && (r.initialDocument = n.initialDocument), n.changeDebounceMs !== void 0 && (r.changeDebounceMs = n.changeDebounceMs), n.ydoc && (r.ydoc = n.ydoc), n.blobStore && (r.blobStore = n.blobStore), n.trackChanges && (r.trackChanges = n.trackChanges), this.editor = new Bf(this.stack.root, r), this.pluginDetachers.push(Jd(this.editor)), this.syncStackSections(), this.syncSetupFromDocument(), typeof requestAnimationFrame < "u" && requestAnimationFrame(() => this.paginateUnlessZoneEditing()), this.detachChange = this.editor.on("change", (i) => {
+    n.initialDocument && (r.initialDocument = n.initialDocument), n.changeDebounceMs !== void 0 && (r.changeDebounceMs = n.changeDebounceMs), n.ydoc && (r.ydoc = n.ydoc), n.blobStore && (r.blobStore = n.blobStore), n.trackChanges && (r.trackChanges = n.trackChanges), this.editor = new Bf(this.stack.root, r), this.pluginDetachers.push(Jd(this.editor)), n.versionBadge && (this.versionBadgeTeardown = th()), this.syncStackSections(), this.syncSetupFromDocument(), typeof requestAnimationFrame < "u" && requestAnimationFrame(() => this.paginateUnlessZoneEditing()), this.detachChange = this.editor.on("change", (i) => {
       this.syncSetupFromDocument(), this.syncStackSections(), this.paginateUnlessZoneEditing();
       for (const o of this.listeners.change)
         try {
@@ -10455,7 +10472,7 @@ class Qd {
   /** Project the current `setup` into `doc.sections[0]` and commit. */
   writeSetupToSection0() {
     const e = this.editor.getDocument(), { section: n, headerFooterBodies: r } = Ue(this.setup), i = e.sections[0];
-    if (i && th(i, n)) return;
+    if (i && ih(i, n)) return;
     const o = e.sections.slice();
     o[0] = n, this.editor.setDocument({
       ...e,
@@ -10646,7 +10663,7 @@ class Qd {
     const e = this.editor.getDocument(), n = e.sections[0];
     if (!n) return;
     const r = $t(n, e.headerFooterBodies), i = { ...this.setup, ...r };
-    if (n.headerRefs.length === 0 && (i.header = gt()), n.footerRefs.length === 0 && (i.footer = gt()), !nh(this.setup, i)) {
+    if (n.headerRefs.length === 0 && (i.header = gt()), n.footerRefs.length === 0 && (i.footer = gt()), !oh(this.setup, i)) {
       this.setup = i, this.stack.updateSetup(this.setup);
       for (const o of this.listeners.setup)
         try {
@@ -10657,17 +10674,17 @@ class Qd {
     }
   }
   destroy() {
-    var e, n;
-    for (let r = this.pluginDetachers.length - 1; r >= 0; r--)
+    var e, n, r;
+    for (let i = this.pluginDetachers.length - 1; i >= 0; i--)
       try {
-        (n = (e = this.pluginDetachers)[r]) == null || n.call(e);
-      } catch (i) {
-        console.error("[sobree] plugin detach threw:", i);
+        (n = (e = this.pluginDetachers)[i]) == null || n.call(e);
+      } catch (o) {
+        console.error("[sobree] plugin detach threw:", o);
       }
-    this.pluginDetachers.length = 0, this.detachChange(), this.detachPaginate(), this.detachTrackChanges(), this.listeners.change.clear(), this.listeners.paginate.clear(), this.listeners.setup.clear(), this.listeners["mode-change"].clear(), this.listeners["track-changes-change"].clear(), this.listeners["docx:import"].clear(), this.listeners["docx:export"].clear(), this.editor.destroy(), this.stack.destroy();
+    this.pluginDetachers.length = 0, (r = this.versionBadgeTeardown) == null || r.call(this), this.versionBadgeTeardown = null, this.detachChange(), this.detachPaginate(), this.detachTrackChanges(), this.listeners.change.clear(), this.listeners.paginate.clear(), this.listeners.setup.clear(), this.listeners["mode-change"].clear(), this.listeners["track-changes-change"].clear(), this.listeners["docx:import"].clear(), this.listeners["docx:export"].clear(), this.editor.destroy(), this.stack.destroy();
   }
 }
-function eh(t) {
+function rh(t) {
   const e = structuredClone($r);
   if (!t) return e;
   const n = t.sections[0];
@@ -10684,22 +10701,23 @@ function gt() {
     differentLast: !1
   };
 }
-function th(t, e) {
+function ih(t, e) {
   return JSON.stringify(t) === JSON.stringify(e);
 }
-function nh(t, e) {
+function oh(t, e) {
   return JSON.stringify(t) === JSON.stringify(e);
 }
-function Th(t, e = {}) {
-  const n = rh(t), { initialDocument: r, deferredDocx: i } = ih(e.content), o = new ws(n), s = {
+function Ch(t, e = {}) {
+  const n = sh(t), { initialDocument: r, deferredDocx: i } = ah(e.content), o = new ws(n), s = {
     ...r && { initialDocument: r },
     ...e.pageSetup && { pageSetup: e.pageSetup },
     ...e.changeDebounceMs !== void 0 && {
       changeDebounceMs: e.changeDebounceMs
     },
     ...e.ydoc && { ydoc: e.ydoc },
-    ...e.blobStore && { blobStore: e.blobStore }
-  }, a = new Qd(o.slot, s), c = {
+    ...e.blobStore && { blobStore: e.blobStore },
+    ...e.versionBadge && { versionBadge: !0 }
+  }, a = new nh(o.slot, s), c = {
     editor: a.editor,
     sobree: a,
     viewport: o,
@@ -10769,7 +10787,7 @@ function Th(t, e = {}) {
     }
   };
 }
-function rh(t) {
+function sh(t) {
   if (typeof t == "string") {
     const e = document.querySelector(t);
     if (!(e instanceof HTMLElement))
@@ -10778,10 +10796,10 @@ function rh(t) {
   }
   return t;
 }
-function ih(t) {
-  return t === void 0 ? { initialDocument: void 0, deferredDocx: void 0 } : typeof t == "string" ? { initialDocument: Or(t), deferredDocx: void 0 } : oh(t) ? { initialDocument: void 0, deferredDocx: t } : { initialDocument: t, deferredDocx: void 0 };
+function ah(t) {
+  return t === void 0 ? { initialDocument: void 0, deferredDocx: void 0 } : typeof t == "string" ? { initialDocument: Or(t), deferredDocx: void 0 } : ch(t) ? { initialDocument: void 0, deferredDocx: t } : { initialDocument: t, deferredDocx: void 0 };
 }
-function oh(t) {
+function ch(t) {
   return typeof Blob < "u" && t instanceof Blob || t instanceof ArrayBuffer || t instanceof Uint8Array;
 }
 function xr(t) {
@@ -10790,8 +10808,8 @@ function xr(t) {
   });
   return e;
 }
-const et = 12, sh = 8;
-function Eh(t, e) {
+const et = 12, lh = 8;
+function Nh(t, e) {
   const n = `:scope > .sobree-floating-corner[data-placement="${e}"]`, r = t.querySelector(n);
   if (r) return r;
   const i = document.createElement("div");
@@ -10800,7 +10818,7 @@ function Eh(t, e) {
     display: "flex",
     flexDirection: e.startsWith("bottom-") ? "column-reverse" : "column",
     alignItems: e.endsWith("-right") ? "flex-end" : "flex-start",
-    gap: `${sh}px`,
+    gap: `${lh}px`,
     // Don't intercept clicks on the underlying paper — only the
     // children should be interactive.
     pointerEvents: "none",
@@ -10812,13 +10830,13 @@ function Eh(t, e) {
       s.style.pointerEvents = "auto";
   }).observe(i, { childList: !0 }), t.appendChild(i), i;
 }
-function Ah(t) {
-  const { zone: e, kind: n, stackRoot: r, getSetup: i, setSetup: o, onExit: s } = t, a = ah(e, n, r, i()), l = i()[n][a];
+function Ph(t) {
+  const { zone: e, kind: n, stackRoot: r, getSetup: i, setSetup: o, onExit: s } = t, a = uh(e, n, r, i()), l = i()[n][a];
   e.replaceChildren();
   const u = document.createTextNode(l);
   e.appendChild(u), e.classList.remove("is-empty"), r.classList.add("is-zone-editing");
   const f = r.contentEditable;
-  r.contentEditable = "false", e.contentEditable = "true", e.focus(), ch(u);
+  r.contentEditable = "false", e.contentEditable = "true", e.focus(), fh(u);
   let d = !1;
   const h = () => {
     if (d) return;
@@ -10835,19 +10853,19 @@ function Ah(t) {
   };
   return e.addEventListener("blur", p), e.addEventListener("keydown", y), document.addEventListener("mousedown", m, !0), h;
 }
-function ah(t, e, n, r) {
+function uh(t, e, n, r) {
   const i = Array.from(n.querySelectorAll(".paper")), o = t.closest(".paper");
   if (!o) return "default";
   const s = i.indexOf(o) + 1, a = i.length, c = r[e];
   return s === 1 && c.differentFirst ? "first" : s === a && c.differentLast && a > 1 ? "last" : "default";
 }
-function ch(t) {
+function fh(t) {
   const e = document.createRange();
   e.setStart(t, t.length), e.collapse(!0);
   const n = window.getSelection();
   n == null || n.removeAllRanges(), n == null || n.addRange(e);
 }
-class Ch {
+class Ih {
   constructor(e, n = {}) {
     w(this, "ydoc");
     w(this, "commands");
@@ -11142,7 +11160,7 @@ function Sr(t) {
     focus: t.range.to.offset
   };
 }
-function lh(t) {
+function dh(t) {
   if (!t || typeof t != "object") return !1;
   const e = t;
   if (!e.user || typeof e.user != "object") return !1;
@@ -11156,7 +11174,7 @@ function lh(t) {
   }
   return !0;
 }
-function uh(t, e, n) {
+function hh(t, e, n) {
   const r = n.publishOwnSelection ?? !0, i = {
     user: n.user,
     selection: r ? Sr(t.selection.get()) : null
@@ -11173,7 +11191,7 @@ function uh(t, e, n) {
   const s = () => {
     const c = /* @__PURE__ */ new Map();
     for (const [l, u] of e.getStates())
-      lh(u) && c.set(l, u);
+      dh(u) && c.set(l, u);
     return c;
   }, a = (c) => {
     n.onChange && n.onChange(s());
@@ -11191,19 +11209,19 @@ function uh(t, e, n) {
     }
   };
 }
-const fh = "sobree-presence-overlay";
-function Nh(t, e, n) {
+const ph = "sobree-presence-overlay";
+function Rh(t, e, n) {
   const r = n.container, i = n.blockHost ?? r;
   getComputedStyle(r).position === "static" && (r.style.position = "relative");
   const s = document.createElement("div");
-  s.className = fh, s.style.cssText = "position:absolute; inset:0; pointer-events:none; z-index:2;", r.appendChild(s);
+  s.className = ph, s.style.cssText = "position:absolute; inset:0; pointer-events:none; z-index:2;", r.appendChild(s);
   let a = /* @__PURE__ */ new Map();
   const c = (f) => {
     a = f, s.replaceChildren();
     for (const [d, h] of f) {
       if (d === e.clientID || !h.selection) continue;
       const p = i.querySelector(
-        `[data-block-id="${dh(h.selection.blockId)}"]`
+        `[data-block-id="${gh(h.selection.blockId)}"]`
       );
       if (!p) continue;
       const y = p.getBoundingClientRect(), m = r.getBoundingClientRect(), x = document.createElement("div");
@@ -11211,7 +11229,7 @@ function Nh(t, e, n) {
       const S = document.createElement("span");
       S.className = "sobree-caret-label", S.textContent = h.user.name, S.style.cssText = `position:absolute; top:-1.4em; left:0; padding:0 4px; background:${h.user.color}; color:#fff; font:11px/1.4 system-ui, sans-serif; border-radius:3px 3px 3px 0; white-space:nowrap;`, x.appendChild(S), s.appendChild(x);
     }
-  }, l = uh(t, e, {
+  }, l = hh(t, e, {
     ...n,
     onChange(f) {
       c(f), n.onChange && n.onChange(f);
@@ -11227,7 +11245,7 @@ function Nh(t, e, n) {
     }
   };
 }
-function dh(t) {
+function gh(t) {
   return typeof CSS < "u" && typeof CSS.escape == "function" ? CSS.escape(t) : t.replace(/(["\\])/g, "\\$1");
 }
 export {
@@ -11237,7 +11255,7 @@ export {
   $r as DEFAULT_PAGE_SETUP,
   Bf as Editor,
   xo as FontFaceRegistry,
-  Ch as HeadlessSobree,
+  Ih as HeadlessSobree,
   ii as History,
   ol as MARK_COMMAND_DEFS,
   il as MARK_ON,
@@ -11245,38 +11263,39 @@ export {
   tn as PAGE_SIZES,
   Od as Paper,
   Wd as PaperStack,
-  Qd as Sobree,
+  nh as Sobree,
+  eh as VERSION,
   ws as Viewport,
   St as appendBlock,
   pi as applyDocumentToYDoc,
-  uh as attachPresence,
-  Nh as attachPresenceOverlay,
+  hh as attachPresence,
+  Rh as attachPresenceOverlay,
   Jd as attachSections,
   zs as blocksToTemplate,
   ro as canEmbed,
-  Th as createSobree,
+  Ch as createSobree,
   Is as defaultMargins,
   Ps as defaultPageSize,
   Ns as defaultSection,
   en as defaultStyles,
   Ji as deobfuscate,
   wo as embedFontIntoDoc,
-  gh as emphasis,
+  yh as emphasis,
   Qt as emptyDocument,
-  Ah as enterZoneEdit,
-  Sh as fetchBlobStore,
+  Ph as enterZoneEdit,
+  Ah as fetchBlobStore,
   Qi as generateFontKey,
-  Eh as getFloatingCorner,
+  Nh as getFloatingCorner,
   Rs as heading,
-  xh as inMemoryBlobStore,
+  Eh as inMemoryBlobStore,
   ti as isBlobHash,
   bi as isMarkActive,
-  kh as isParagraph,
-  lh as isPresenceState,
-  vh as isTable,
-  wh as makeHeaderFooterRef,
+  Sh as isParagraph,
+  dh as isPresenceState,
+  Th as isTable,
+  xh as makeHeaderFooterRef,
   Zi as obfuscate,
-  yh as pageBreak,
+  vh as pageBreak,
   Fe as paragraph,
   Or as parseMarkdown,
   Sr as presenceSelectionFromEditor,
@@ -11287,8 +11306,8 @@ export {
   Zr as resolveStyleCascade,
   li as seedYDoc,
   on as sha256Hex,
-  bh as softBreak,
-  mh as strong,
+  kh as softBreak,
+  wh as strong,
   _s as templateToBlocks,
   st as text,
   sl as toggleMark