@jxsuite/studio 2.0.0 → 2.1.0

package/dist/chunks/studio-7afd21nw.js

@@ -0,0 +1,67 @@
+// src/settings/section-registry.ts
+var DEFAULT_SETTINGS_SECTION = "overview";
+var sections = new Map;
+var listeners = new Set;
+function announce() {
+  for (const listener of listeners) {
+    listener();
+  }
+}
+function notifySettingsDocument() {
+  announce();
+}
+function onSettingsDocumentChanged(listener) {
+  listeners.add(listener);
+  return () => {
+    listeners.delete(listener);
+  };
+}
+function registerSettingsSection(section) {
+  sections.set(section.key, section);
+  announce();
+}
+function unregisterSettingsSection(key) {
+  if (sections.delete(key)) {
+    announce();
+  }
+}
+function sortedSettingsSections() {
+  return [...sections.values()].toSorted((a, b) => a.order - b.order);
+}
+function settingsSectionKeys() {
+  return sortedSettingsSections().map((section) => section.key);
+}
+function settingsSection(key) {
+  return sections.get(key);
+}
+var _requested = null;
+var _displayed = DEFAULT_SETTINGS_SECTION;
+function settingsDocumentSection() {
+  if (_requested !== null && sections.has(_requested)) {
+    _displayed = _requested;
+    _requested = null;
+    return _displayed;
+  }
+  if (sections.has(_displayed)) {
+    return _displayed;
+  }
+  return settingsSectionKeys()[0] ?? _displayed;
+}
+function setSettingsSection(key) {
+  if (sections.has(key)) {
+    _displayed = key;
+    _requested = null;
+  } else {
+    _requested = key;
+  }
+  announce();
+}
+function resetSettingsDocumentState() {
+  _requested = null;
+  _displayed = DEFAULT_SETTINGS_SECTION;
+}
+
+export { DEFAULT_SETTINGS_SECTION, notifySettingsDocument, onSettingsDocumentChanged, registerSettingsSection, unregisterSettingsSection, sortedSettingsSections, settingsSectionKeys, settingsSection, settingsDocumentSection, setSettingsSection, resetSettingsDocumentState };
+
+//# debugId=19468228E71CB42E64756E2164756E21
+//# sourceMappingURL=studio-7afd21nw.js.map

package/dist/chunks/studio-7afd21nw.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/settings/section-registry.ts"],
+  "sourcesContent": [
+    "/**\n * The Project Settings section registry, and which of its sections the document is showing.\n *\n * `registerSettingsSection` is a **preserved public contract** (specs/extensions.md §9.1): an\n * extension's `project` class declares a `$studio.settings` block and `settings/extension-sections`\n * turns it into one of these records. P6 moved Project Settings out of a modal and into a document\n * in the pane; the registry did not move with it, because a section is a contribution to\n * CONFIGURATION, not to a dialog. Splitting it out is what lets the host be replaced without the\n * contribution point being touched.\n *\n * **This module holds no renderer and imports nothing.** That is load-bearing rather than tidy:\n * `panels/settings-pane.ts` is reached from `canvas/canvas-render.ts`, so anything this module\n * imports becomes part of the canvas's import graph. The section RENDERERS are registered by\n * `settings/settings-document.ts`, which the app loads when it registers its commands.\n *\n * **What is requested and what is displayed are two variables, and unregistering touches neither.**\n * The modal had one, and its `unregisterSettingsSection` reset it to `\"general\"` — which is half of\n * the deep-link race P6 exists to close. The contribution sync unregisters stale keys before it\n * registers fresh ones, so a section merely being REFRESHED took the caller's requested section\n * down with it, silently, after the awaited readiness promise had already resolved. Here a request\n * outlives its section going away and is satisfied the moment the key comes back.\n */\n\n/** A Project Settings section: an inner-nav entry plus a renderer for the content area. */\nexport interface SettingsSection {\n  key: string;\n  label: string;\n  /** Nav icon name (reserved for future nav treatments). */\n  icon?: string | undefined;\n  /** Sort position — lower orders render higher in the inner nav. */\n  order: number;\n  render: (container: HTMLElement) => void;\n}\n\n/** Where a settings document lands when nobody named a section. */\nexport const DEFAULT_SETTINGS_SECTION = \"overview\";\n\nconst sections = new Map<string, SettingsSection>();\n\nconst listeners = new Set<() => void>();\n\n/**\n * Tell every subscriber something changed.\n *\n * A `Set` tolerates deletion during its own iteration, so a listener that unsubscribes itself (the\n * pane host, on unmount) is safe without copying.\n */\nfunction announce(): void {\n  for (const listener of listeners) {\n    listener();\n  }\n}\n\n/**\n * Redraw the settings document — for a change this module cannot see, such as a command selecting\n * an entry inside the section that is already on screen.\n */\nexport function notifySettingsDocument(): void {\n  announce();\n}\n\n/**\n * Subscribe to everything that changes what the settings document draws: the section set (an\n * extension registering or going away) and the chosen section. Returns the unsubscribe.\n *\n * @param {() => void} listener\n * @returns {() => void}\n */\nexport function onSettingsDocumentChanged(listener: () => void): () => void {\n  listeners.add(listener);\n  return () => {\n    listeners.delete(listener);\n  };\n}\n\n// ─── Registration ─────────────────────────────────────────────────────────────\n\n/**\n * Register (or replace) a settings section.\n *\n * @param {SettingsSection} section\n */\nexport function registerSettingsSection(section: SettingsSection): void {\n  sections.set(section.key, section);\n  announce();\n}\n\n/**\n * Remove a registered section — used when a descriptor-contributed section's extension is disabled\n * (see ./extension-sections). Built-ins are never unregistered.\n *\n * @param {string} key\n */\nexport function unregisterSettingsSection(key: string): void {\n  if (sections.delete(key)) {\n    announce();\n  }\n}\n\n/** Registered sections sorted by order (registration order breaks ties). */\nexport function sortedSettingsSections(): SettingsSection[] {\n  return [...sections.values()].toSorted((a, b) => a.order - b.order);\n}\n\n/** Every registered section key, built-ins and contributions alike, in display order. */\nexport function settingsSectionKeys(): string[] {\n  return sortedSettingsSections().map((section) => section.key);\n}\n\n/**\n * One section by key, or `undefined`.\n *\n * @param {string} key\n * @returns {SettingsSection | undefined}\n */\nexport function settingsSection(key: string): SettingsSection | undefined {\n  return sections.get(key);\n}\n\n// ─── Which section is on screen ───────────────────────────────────────────────\n\n/** The section the last caller ASKED for, kept until it is satisfied. */\nlet _requested: string | null = null;\n\n/** The section the document is drawing. Only a nav click and a satisfied request move it. */\nlet _displayed = DEFAULT_SETTINGS_SECTION;\n\n/**\n * The section key the document should render right now.\n *\n * A pending request wins as soon as its section exists. Otherwise the displayed one, and — when\n * that has been unregistered too — the first section there is, so the content area is never blank\n * because of bookkeeping.\n *\n * @returns {string}\n */\nexport function settingsDocumentSection(): string {\n  if (_requested !== null && sections.has(_requested)) {\n    _displayed = _requested;\n    _requested = null;\n    return _displayed;\n  }\n  if (sections.has(_displayed)) {\n    return _displayed;\n  }\n  return settingsSectionKeys()[0] ?? _displayed;\n}\n\n/**\n * Show a section. A nav click satisfies itself immediately; a deep link to a section that has not\n * registered yet is remembered until it does.\n *\n * @param {string} key\n */\nexport function setSettingsSection(key: string): void {\n  if (sections.has(key)) {\n    _displayed = key;\n    _requested = null;\n  } else {\n    _requested = key;\n  }\n  announce();\n}\n\n/** Forget the chosen section — the project-close and test hook. */\nexport function resetSettingsDocumentState(): void {\n  _requested = null;\n  _displayed = DEFAULT_SETTINGS_SECTION;\n}\n"
+  ],
+  "mappings": ";AAmCO,IAAM,2BAA2B;AAExC,IAAM,WAAW,IAAI;AAErB,IAAM,YAAY,IAAI;AAQtB,SAAS,QAAQ,GAAS;AAAA,EACxB,WAAW,YAAY,WAAW;AAAA,IAChC,SAAS;AAAA,EACX;AAAA;AAOK,SAAS,sBAAsB,GAAS;AAAA,EAC7C,SAAS;AAAA;AAUJ,SAAS,yBAAyB,CAAC,UAAkC;AAAA,EAC1E,UAAU,IAAI,QAAQ;AAAA,EACtB,OAAO,MAAM;AAAA,IACX,UAAU,OAAO,QAAQ;AAAA;AAAA;AAWtB,SAAS,uBAAuB,CAAC,SAAgC;AAAA,EACtE,SAAS,IAAI,QAAQ,KAAK,OAAO;AAAA,EACjC,SAAS;AAAA;AASJ,SAAS,yBAAyB,CAAC,KAAmB;AAAA,EAC3D,IAAI,SAAS,OAAO,GAAG,GAAG;AAAA,IACxB,SAAS;AAAA,EACX;AAAA;AAIK,SAAS,sBAAsB,GAAsB;AAAA,EAC1D,OAAO,CAAC,GAAG,SAAS,OAAO,CAAC,EAAE,SAAS,CAAC,GAAG,MAAM,EAAE,QAAQ,EAAE,KAAK;AAAA;AAI7D,SAAS,mBAAmB,GAAa;AAAA,EAC9C,OAAO,uBAAuB,EAAE,IAAI,CAAC,YAAY,QAAQ,GAAG;AAAA;AASvD,SAAS,eAAe,CAAC,KAA0C;AAAA,EACxE,OAAO,SAAS,IAAI,GAAG;AAAA;AAMzB,IAAI,aAA4B;AAGhC,IAAI,aAAa;AAWV,SAAS,uBAAuB,GAAW;AAAA,EAChD,IAAI,eAAe,QAAQ,SAAS,IAAI,UAAU,GAAG;AAAA,IACnD,aAAa;AAAA,IACb,aAAa;AAAA,IACb,OAAO;AAAA,EACT;AAAA,EACA,IAAI,SAAS,IAAI,UAAU,GAAG;AAAA,IAC5B,OAAO;AAAA,EACT;AAAA,EACA,OAAO,oBAAoB,EAAE,MAAM;AAAA;AAS9B,SAAS,kBAAkB,CAAC,KAAmB;AAAA,EACpD,IAAI,SAAS,IAAI,GAAG,GAAG;AAAA,IACrB,aAAa;AAAA,IACb,aAAa;AAAA,EACf,EAAO;AAAA,IACL,aAAa;AAAA;AAAA,EAEf,SAAS;AAAA;AAIJ,SAAS,0BAA0B,GAAS;AAAA,EACjD,aAAa;AAAA,EACb,aAAa;AAAA;",
+  "debugId": "19468228E71CB42E64756E2164756E21",
+  "names": []
+}

package/dist/chunks/{studio-xze4zrs1.js → studio-7bmdvzne.js}

@@ -91,5 +91,5 @@ function decodeFrame(data) {
 
 export { FRAME_DOC_SYNC, FRAME_AWARENESS, FRAME_DOC_CLOSE, FRAME_CONTROL, EnvelopeError, encodeFrame, decodeFrame };
 
-//# debugId=DAAAC2821D4C97A164756E2164756E21
-//# sourceMappingURL=studio-xze4zrs1.js.map
+//# debugId=9834DA0DD0D8392964756E2164756E21
+//# sourceMappingURL=studio-7bmdvzne.js.map

package/dist/chunks/studio-7bmdvzne.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../../collab/src/envelope.ts"],
+  "sourcesContent": [
+    "/**\n * The binary wire envelope every Jx collab provider speaks: the Cloudflare platform DO, the\n * devserver endpoint in the server package, and the browser client. One WebSocket per project\n * carries every open document, multiplexed by path:\n *\n *     frame          := varUint frameType, body\n *     0 DOC_SYNC     := varString path, varUint docEpoch, varUint8Array y-protocols sync body\n *     1 AWARENESS    := varUint8Array y-protocols awareness update (project-scoped)\n *     2 DOC_CLOSE    := varString path                (client → server unsubscribe)\n *     3 CONTROL      := varString json                (see ControlMessage)\n *\n * `docEpoch` is the server-owned lifetime counter of a document's Y history. Out-of-band content\n * replacement (git discard/pull/rename, non-collab writes) bumps it; frames carrying a stale epoch\n * are dropped and answered with a `doc-reset` control message, upon which the client destroys its\n * Y.Doc and re-opens. The invariant \"Y history is never deleted or replaced without an epoch bump\"\n * is what prevents divergent-history duplicate-content merges.\n *\n * The layout above is what the `jx.collab.v1` WebSocket subprotocol names. A change that would make\n * a peer mis-parse a frame is a new token, not a silent edit here — see `negotiate.ts` for the bump\n * rule and for why the capability probe, not the socket, is where the two sides agree.\n */\n\nimport * as decoding from \"lib0/decoding\";\nimport * as encoding from \"lib0/encoding\";\n\nexport { COLLAB_SUBPROTOCOL } from \"./negotiate.ts\";\n\nexport const FRAME_DOC_SYNC = 0;\nexport const FRAME_AWARENESS = 1;\nexport const FRAME_DOC_CLOSE = 2;\nexport const FRAME_CONTROL = 3;\n\nexport type CollabPermission = \"admin\" | \"write\" | \"read\";\n\n/** JSON payloads of CONTROL frames. */\nexport type ControlMessage =\n  /** Server → client on accept: the socket's identity and effective permission. */\n  | {\n      type: \"hello\";\n      login: string;\n      name?: string;\n      avatarUrl?: string;\n      color: string;\n      permission: CollabPermission;\n    }\n  /** Client → server: subscribe to a document (the client's Y.Doc must start EMPTY). */\n  | { type: \"open\"; path: string }\n  /** Server → client: the room is ready at this epoch; sync follows. */\n  | { type: \"opened\"; path: string; epoch: number }\n  /** Server → client: the doc's history was replaced; destroy the local Y.Doc and re-open. */\n  | { type: \"doc-reset\"; path: string; epoch: number }\n  /** Client → server: persist this doc to durable storage now (Cmd+S). */\n  | { type: \"flush\"; path: string }\n  /** Server → client: the flush landed. */\n  | { type: \"flush-ack\"; path: string }\n  /**\n   * Server → client: the room's unsaved-since-last-persist state changed (drives the Save\n   * affordance). Room-level and authoritative: any peer's edit dirties the room for everyone; a\n   * persist clears it for everyone. Sent to a newly-subscribing connection during the open\n   * handshake so it learns the current state.\n   */\n  | { type: \"doc-dirty\"; path: string; dirty: boolean }\n  /**\n   * Server → client: a request was refused (codes: read-only, content-not-loaded, too-large,\n   * rate-limited, binary-file, unknown-frame).\n   */\n  | { type: \"error\"; path?: string; code: string; message: string };\n\nexport type CollabFrame =\n  | { type: \"doc-sync\"; path: string; epoch: number; body: Uint8Array }\n  | { type: \"awareness\"; body: Uint8Array }\n  | { type: \"doc-close\"; path: string }\n  | { type: \"control\"; message: ControlMessage };\n\nexport class EnvelopeError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"EnvelopeError\";\n  }\n}\n\nexport function encodeFrame(frame: CollabFrame): Uint8Array {\n  const encoder = encoding.createEncoder();\n  switch (frame.type) {\n    case \"doc-sync\": {\n      encoding.writeVarUint(encoder, FRAME_DOC_SYNC);\n      encoding.writeVarString(encoder, frame.path);\n      encoding.writeVarUint(encoder, frame.epoch);\n      encoding.writeVarUint8Array(encoder, frame.body);\n      break;\n    }\n    case \"awareness\": {\n      encoding.writeVarUint(encoder, FRAME_AWARENESS);\n      encoding.writeVarUint8Array(encoder, frame.body);\n      break;\n    }\n    case \"doc-close\": {\n      encoding.writeVarUint(encoder, FRAME_DOC_CLOSE);\n      encoding.writeVarString(encoder, frame.path);\n      break;\n    }\n    case \"control\": {\n      encoding.writeVarUint(encoder, FRAME_CONTROL);\n      encoding.writeVarString(encoder, JSON.stringify(frame.message));\n      break;\n    }\n    default: {\n      throw new EnvelopeError(`unknown-frame:${(frame as CollabFrame).type}`);\n    }\n  }\n  return encoding.toUint8Array(encoder);\n}\n\nexport function decodeFrame(data: Uint8Array): CollabFrame {\n  try {\n    const decoder = decoding.createDecoder(data);\n    const frameType = decoding.readVarUint(decoder);\n    switch (frameType) {\n      case FRAME_DOC_SYNC: {\n        const path = decoding.readVarString(decoder);\n        const epoch = decoding.readVarUint(decoder);\n        const body = decoding.readVarUint8Array(decoder);\n        return { body, epoch, path, type: \"doc-sync\" };\n      }\n      case FRAME_AWARENESS: {\n        return { body: decoding.readVarUint8Array(decoder), type: \"awareness\" };\n      }\n      case FRAME_DOC_CLOSE: {\n        return { path: decoding.readVarString(decoder), type: \"doc-close\" };\n      }\n      case FRAME_CONTROL: {\n        const message = JSON.parse(decoding.readVarString(decoder)) as ControlMessage;\n        if (typeof message !== \"object\" || typeof message.type !== \"string\") {\n          throw new EnvelopeError(\"malformed-control\");\n        }\n        return { message, type: \"control\" };\n      }\n      default: {\n        throw new EnvelopeError(`unknown-frame-type:${frameType}`);\n      }\n    }\n  } catch (error) {\n    if (error instanceof EnvelopeError) {\n      throw error;\n    }\n    throw new EnvelopeError(\n      `malformed-frame: ${error instanceof Error ? error.message : String(error)}`,\n    );\n  }\n}\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;AA2BO,IAAM,iBAAiB;AACvB,IAAM,kBAAkB;AACxB,IAAM,kBAAkB;AACxB,IAAM,gBAAgB;AAAA;AA4CtB,MAAM,sBAAsB,MAAM;AAAA,EACvC,WAAW,CAAC,SAAiB;AAAA,IAC3B,MAAM,OAAO;AAAA,IACb,KAAK,OAAO;AAAA;AAEhB;AAEO,SAAS,WAAW,CAAC,OAAgC;AAAA,EAC1D,MAAM,UAAmB,cAAc;AAAA,EACvC,QAAQ,MAAM;AAAA,SACP,YAAY;AAAA,MACN,aAAa,SAAS,cAAc;AAAA,MACpC,eAAe,SAAS,MAAM,IAAI;AAAA,MAClC,aAAa,SAAS,MAAM,KAAK;AAAA,MACjC,mBAAmB,SAAS,MAAM,IAAI;AAAA,MAC/C;AAAA,IACF;AAAA,SACK,aAAa;AAAA,MACP,aAAa,SAAS,eAAe;AAAA,MACrC,mBAAmB,SAAS,MAAM,IAAI;AAAA,MAC/C;AAAA,IACF;AAAA,SACK,aAAa;AAAA,MACP,aAAa,SAAS,eAAe;AAAA,MACrC,eAAe,SAAS,MAAM,IAAI;AAAA,MAC3C;AAAA,IACF;AAAA,SACK,WAAW;AAAA,MACL,aAAa,SAAS,aAAa;AAAA,MACnC,eAAe,SAAS,KAAK,UAAU,MAAM,OAAO,CAAC;AAAA,MAC9D;AAAA,IACF;AAAA,aACS;AAAA,MACP,MAAM,IAAI,cAAc,iBAAkB,MAAsB,MAAM;AAAA,IACxE;AAAA;AAAA,EAEF,OAAgB,aAAa,OAAO;AAAA;AAG/B,SAAS,WAAW,CAAC,MAA+B;AAAA,EACzD,IAAI;AAAA,IACF,MAAM,UAAmB,cAAc,IAAI;AAAA,IAC3C,MAAM,YAAqB,YAAY,OAAO;AAAA,IAC9C,QAAQ;AAAA,WACD,gBAAgB;AAAA,QACnB,MAAM,OAAgB,cAAc,OAAO;AAAA,QAC3C,MAAM,QAAiB,YAAY,OAAO;AAAA,QAC1C,MAAM,OAAgB,kBAAkB,OAAO;AAAA,QAC/C,OAAO,EAAE,MAAM,OAAO,MAAM,MAAM,WAAW;AAAA,MAC/C;AAAA,WACK,iBAAiB;AAAA,QACpB,OAAO,EAAE,MAAe,kBAAkB,OAAO,GAAG,MAAM,YAAY;AAAA,MACxE;AAAA,WACK,iBAAiB;AAAA,QACpB,OAAO,EAAE,MAAe,cAAc,OAAO,GAAG,MAAM,YAAY;AAAA,MACpE;AAAA,WACK,eAAe;AAAA,QAClB,MAAM,UAAU,KAAK,MAAe,cAAc,OAAO,CAAC;AAAA,QAC1D,IAAI,OAAO,YAAY,YAAY,OAAO,QAAQ,SAAS,UAAU;AAAA,UACnE,MAAM,IAAI,cAAc,mBAAmB;AAAA,QAC7C;AAAA,QACA,OAAO,EAAE,SAAS,MAAM,UAAU;AAAA,MACpC;AAAA,eACS;AAAA,QACP,MAAM,IAAI,cAAc,sBAAsB,WAAW;AAAA,MAC3D;AAAA;AAAA,IAEF,OAAO,OAAO;AAAA,IACd,IAAI,iBAAiB,eAAe;AAAA,MAClC,MAAM;AAAA,IACR;AAAA,IACA,MAAM,IAAI,cACR,oBAAoB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GAC3E;AAAA;AAAA;",
+  "debugId": "9834DA0DD0D8392964756E2164756E21",
+  "names": []
+}

package/dist/chunks/studio-8jpzqk5s.js

@@ -0,0 +1,128 @@
+// src/panels/panel-scheduler.ts
+function isTextInput(el) {
+  if (!el) {
+    return false;
+  }
+  const tag = el.tagName.toLowerCase();
+  if (tag === "input" || tag === "textarea") {
+    return true;
+  }
+  if (tag === "sp-textfield" || tag === "sp-number-field" || tag === "sp-search") {
+    return true;
+  }
+  if (el.shadowRoot?.activeElement) {
+    return isTextInput(el.shadowRoot.activeElement);
+  }
+  return false;
+}
+var boundSchedulers = new Set;
+function describeRoot(root) {
+  if (root.id) {
+    return `#${root.id}`;
+  }
+  const first = root.className.split(/\s+/).find(Boolean);
+  return first ? `.${first}` : root.tagName.toLowerCase();
+}
+function pendingSchedulers() {
+  const blockers = [];
+  for (const entry of boundSchedulers) {
+    if (entry.hasFrame()) {
+      blockers.push(`${describeRoot(entry.root)} has a frame queued`);
+    } else if (entry.isDeferring()) {
+      blockers.push(`${describeRoot(entry.root)} is withholding a render (a field has focus)`);
+    }
+  }
+  return blockers;
+}
+function createPanelScheduler(opts) {
+  const { root, render, blockWhile } = opts;
+  let editing = false;
+  let scheduled = false;
+  let pending = false;
+  let rendering = false;
+  let rafId = 0;
+  const blocked = () => editing || (blockWhile ? blockWhile() : false);
+  function markStale(stale) {
+    if (stale) {
+      root.dataset.jxStale = "";
+    } else {
+      delete root.dataset.jxStale;
+    }
+  }
+  function flush() {
+    scheduled = false;
+    rafId = 0;
+    if (rendering) {
+      return;
+    }
+    if (blocked()) {
+      pending = true;
+      markStale(true);
+      return;
+    }
+    pending = false;
+    markStale(false);
+    rendering = true;
+    try {
+      render();
+    } finally {
+      rendering = false;
+    }
+  }
+  function schedule() {
+    if (scheduled) {
+      return;
+    }
+    scheduled = true;
+    rafId = requestAnimationFrame(flush);
+  }
+  function onFocusIn(e) {
+    editing = isTextInput(e.target);
+  }
+  function onFocusOut() {
+    editing = false;
+    if (pending) {
+      schedule();
+    }
+  }
+  const tracked = {
+    hasFrame: () => scheduled,
+    isDeferring: () => pending,
+    root
+  };
+  boundSchedulers.add(tracked);
+  return {
+    bindFocus() {
+      root.addEventListener("focusin", onFocusIn);
+      root.addEventListener("focusout", onFocusOut);
+    },
+    flushNow() {
+      if (rafId) {
+        cancelAnimationFrame(rafId);
+      }
+      rafId = 0;
+      scheduled = false;
+      flush();
+    },
+    isEditing: () => blocked(),
+    schedule,
+    unbind() {
+      boundSchedulers.delete(tracked);
+      root.removeEventListener("focusin", onFocusIn);
+      root.removeEventListener("focusout", onFocusOut);
+      if (rafId) {
+        cancelAnimationFrame(rafId);
+      }
+      scheduled = false;
+      pending = false;
+      editing = false;
+      markStale(false);
+      rendering = false;
+    }
+  };
+}
+
+export { pendingSchedulers, createPanelScheduler };
+
+//# debugId=590200A08A20676A64756E2164756E21
+//# sourceMappingURL=studio-8jpzqk5s.js.map

package/dist/chunks/studio-8jpzqk5s.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/panels/panel-scheduler.ts"],
+  "sourcesContent": [
+    "/// <reference lib=\"dom\" />\n/**\n * Panel-scheduler.ts — Shared focus-aware render scheduler for Studio panels.\n *\n * Generalizes the guard that previously lived only in the right panel: render requests are\n * coalesced via requestAnimationFrame and DEFERRED while a text input inside the panel root is\n * focused, then flushed on focusout. Routing every render path (reactive effect, renderOnly(...),\n * explicit calls) through one scheduler means a focused field is never rebuilt mid-edit — which is\n * what previously truncated or dropped characters in the document/head sidebar.\n */\n\n/**\n * Is the element (or its shadow-DOM active descendant) a text-entry control whose value would be\n * clobbered by a re-render? Covers native inputs and the Spectrum web components used in panels.\n *\n * @param {Element | null} el\n * @returns {boolean}\n */\nexport function isTextInput(el: Element | null): boolean {\n  if (!el) {\n    return false;\n  }\n  const tag = el.tagName.toLowerCase();\n  if (tag === \"input\" || tag === \"textarea\") {\n    return true;\n  }\n  if (tag === \"sp-textfield\" || tag === \"sp-number-field\" || tag === \"sp-search\") {\n    return true;\n  }\n  if (el.shadowRoot?.activeElement) {\n    return isTextInput(el.shadowRoot.activeElement);\n  }\n  return false;\n}\n\n/**\n * Every bound scheduler, so \"is any panel still owing a repaint?\" has one answer.\n *\n * Condition 2 of the `probe.idle()` predicate (`services/idle.ts`, spec §13.5). Each scheduler\n * already knew whether it had a frame queued or a render withheld; nothing could ask all of them at\n * once. P4.4 makes the withheld case visible to the author too — a panel silently showing stale\n * state is a bug whichever consumer notices it first.\n */\nconst boundSchedulers = new Set<TrackedScheduler>();\n\ninterface TrackedScheduler {\n  /** The panel root, for the human-readable blocker string. */\n  root: HTMLElement;\n  /** A coalescing frame is queued and will paint. */\n  hasFrame: () => boolean;\n  /** A render was requested and is being WITHHELD because a field in the panel has focus. */\n  isDeferring: () => boolean;\n}\n\n/** `#right-panel`, `.frontmatter-panel`, `div` — the most specific handle the root offers. */\nfunction describeRoot(root: HTMLElement): string {\n  if (root.id) {\n    return `#${root.id}`;\n  }\n  const first = root.className.split(/\\s+/).find(Boolean);\n  return first ? `.${first}` : root.tagName.toLowerCase();\n}\n\n/**\n * One line per panel that still owes a repaint — empty when every panel's DOM matches its state.\n *\n * A withheld render is reported separately from a queued one because they end differently: a queued\n * frame lands on its own, a withheld one waits for a focusout that may never come. A predicate that\n * conflated them would either hang or lie.\n */\nexport function pendingSchedulers(): string[] {\n  const blockers: string[] = [];\n  for (const entry of boundSchedulers) {\n    if (entry.hasFrame()) {\n      blockers.push(`${describeRoot(entry.root)} has a frame queued`);\n    } else if (entry.isDeferring()) {\n      blockers.push(`${describeRoot(entry.root)} is withholding a render (a field has focus)`);\n    }\n  }\n  return blockers;\n}\n\nexport interface PanelScheduler {\n  /** Request a render. Coalesced; deferred while a text input in the panel is focused. */\n  schedule: () => void;\n  /** True when a render would currently be deferred (text input focused or blockWhile()). */\n  isEditing: () => boolean;\n  /** Attach focusin/focusout listeners to the panel root. */\n  bindFocus: () => void;\n  /** Detach listeners and cancel any pending frame. */\n  unbind: () => void;\n  /** Render immediately, bypassing the rAF coalescing (still respects the focus guard). */\n  flushNow: () => void;\n}\n\n/**\n * Create a focus-aware render scheduler bound to a panel root.\n *\n * @param {{\n *   root: HTMLElement;\n *   render: () => void;\n *   blockWhile?: () => boolean;\n * }} opts\n *   - `render` does the actual DOM paint; `blockWhile` is an extra defer predicate (e.g. a color\n *     popover being open).\n * @returns {PanelScheduler}\n */\nexport function createPanelScheduler(opts: {\n  root: HTMLElement;\n  render: () => void;\n  blockWhile?: () => boolean;\n}): PanelScheduler {\n  const { root, render, blockWhile } = opts;\n  let editing = false;\n  let scheduled = false;\n  let pending = false;\n  let rendering = false;\n  let rafId = 0;\n\n  const blocked = () => editing || (blockWhile ? blockWhile() : false);\n\n  /**\n   * Publish the withheld render to the person looking at the panel.\n   *\n   * A deferred render is the panel deciding, correctly, that finishing your sentence matters more\n   * than being current — but until P4 it made that trade in silence, so a panel showing state from\n   * before your last edit was indistinguishable from a panel that had stopped working. The\n   * attribute is the whole mechanism: `styles/overlays.css` hangs the hint off it, so every panel\n   * that already routes through this scheduler inherits it without a line of its own.\n   */\n  function markStale(stale: boolean) {\n    if (stale) {\n      root.dataset.jxStale = \"\";\n    } else {\n      delete root.dataset.jxStale;\n    }\n  }\n\n  function flush() {\n    scheduled = false;\n    rafId = 0;\n    if (rendering) {\n      return;\n    }\n    // Defer while a field is focused — flushed later by focusout (or the next schedule()).\n    if (blocked()) {\n      pending = true;\n      markStale(true);\n      return;\n    }\n    pending = false;\n    markStale(false);\n    rendering = true;\n    try {\n      render();\n    } finally {\n      rendering = false;\n    }\n  }\n\n  function schedule() {\n    if (scheduled) {\n      return;\n    }\n    scheduled = true;\n    rafId = requestAnimationFrame(flush);\n  }\n\n  function onFocusIn(e: FocusEvent) {\n    editing = isTextInput(e.target as Element);\n  }\n\n  function onFocusOut() {\n    // Clear the editing flag and schedule a flush. If focus is merely moving to another field in\n    // The same panel, the synchronous focusin that follows re-sets `editing` before the rAF runs,\n    // So the deferred render keeps waiting (no mid-edit clobber).\n    editing = false;\n    if (pending) {\n      schedule();\n    }\n  }\n\n  const tracked: TrackedScheduler = {\n    hasFrame: () => scheduled,\n    isDeferring: () => pending,\n    root,\n  };\n  boundSchedulers.add(tracked);\n\n  return {\n    bindFocus() {\n      root.addEventListener(\"focusin\", onFocusIn);\n      root.addEventListener(\"focusout\", onFocusOut);\n    },\n    flushNow() {\n      if (rafId) {\n        cancelAnimationFrame(rafId);\n      }\n      rafId = 0;\n      scheduled = false;\n      flush();\n    },\n    isEditing: () => blocked(),\n    schedule,\n    unbind() {\n      boundSchedulers.delete(tracked);\n      root.removeEventListener(\"focusin\", onFocusIn);\n      root.removeEventListener(\"focusout\", onFocusOut);\n      if (rafId) {\n        cancelAnimationFrame(rafId);\n      }\n      scheduled = false;\n      pending = false;\n      editing = false;\n      markStale(false);\n      rendering = false;\n    },\n  };\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "590200A08A20676A64756E2164756E21",
+  "names": []
+}