@simai-studio/ui 5.20261023.214 → 5.20261025.207

package/distr/core/js/open-surface-mark.js

@@ -0,0 +1,88 @@
+// While a transient surface is open the root says so, and a component whose own
+// Escape closes something larger -- a drawer, a modal, a record panel -- stands
+// back. They all listen on the document in capture, where stopPropagation
+// cannot reach a listener on the same node and the one registered first wins
+// whatever it is: without a shared mark, one press closed the surface and the
+// window behind it together.
+//
+// The mark started inside sf-popover, which made it that component's state
+// instead of the protocol it is: a dropdown list is the same kind of surface and
+// raised nothing, so Escape over an open list closed the record panel behind it
+// (Larena storage QA, 2026-10-22) -- and a drawer and a modal read the same mark,
+// so the same press closed those too. It lives here now, raised by every surface
+// that owns Escape while it is open and read by every component that owns Escape
+// for something larger.
+//
+// The attribute name is unchanged, because it is already the published protocol:
+// `document.documentElement.dataset.sfPopoverOpen`.
+const OPEN_MARK = 'sfPopoverOpen';
+
+// A count, not a flag: two surfaces can be open at once -- a dropdown inside a
+// popover -- and the first to close must not clear the mark the second needs.
+const held = new WeakSet();
+
+// The same holders in the order they opened, so the one opened last -- the
+// innermost layer -- is known. The mark answers "is anything open"; this answers
+// "is it me". Two surfaces that both listen on the document in capture cannot
+// settle it with stopPropagation, which does not reach a listener on the same
+// node: a calendar opened inside a popover closed together with the popover, and
+// a popover closed over a dropdown list it held and left the list open.
+//
+// Kept on a shared global, not in module scope: every Smart bundle carries its
+// own copy of this module, so a module-scope list in the popover's bundle never
+// saw the calendar the datepicker's bundle opened. The count lives on the root
+// for the same reason.
+const LAYERS_KEY = Symbol.for('sf.openSurfaceLayers');
+function openLayers() {
+    const scope = globalThis;
+    if (!Array.isArray(scope[LAYERS_KEY])) scope[LAYERS_KEY] = [];
+    return scope[LAYERS_KEY];
+}
+
+function step(delta) {
+    const root = globalThis.document?.documentElement;
+    if (!root) return;
+    const next = Math.max(0, Number(root.dataset[OPEN_MARK] || 0) + delta);
+    if (next) root.dataset[OPEN_MARK] = String(next);
+    else delete root.dataset[OPEN_MARK];
+}
+
+// Idempotent for one owner, so a component can call it from every update with
+// its own open state and only a change moves the count. An owner that is removed
+// while open releases it the same way, from wherever it tears down.
+export function holdOpenSurfaceMark(owner, open) {
+    if (!owner) return;
+    const wanted = Boolean(open);
+    if (wanted === held.has(owner)) return;
+    const layers = openLayers();
+    if (wanted) {
+        held.add(owner);
+        layers.push(owner);
+    } else {
+        held.delete(owner);
+        const at = layers.lastIndexOf(owner);
+        if (at >= 0) layers.splice(at, 1);
+    }
+    step(wanted ? 1 : -1);
+}
+
+// What a surface asks before its own Escape closes it: whether it is the
+// innermost open layer. A holder that left the document without releasing is
+// passed over rather than allowed to hold every Escape on the page. An owner
+// that holds nothing is the top only when nothing else is open.
+export function isTopOpenSurface(owner) {
+    const layers = openLayers();
+    for (let at = layers.length - 1; at >= 0; at -= 1) {
+        const layer = layers[at];
+        if (layer?.isConnected === false) continue;
+        return layer === owner;
+    }
+    return true;
+}
+
+// What a component asks before its own Escape closes something larger.
+export function isOpenSurfaceMarked() {
+    return Boolean(globalThis.document?.documentElement?.dataset?.[OPEN_MARK]);
+}
+
+export const OPEN_SURFACE_MARK = OPEN_MARK;

package/distr/core/js/template-utilities.generated.json

@@ -201,6 +201,9 @@
     "font-weight/default",
     "position/default"
   ],
+  "cl-image-field": [
+    "position/default"
+  ],
   "cl-inputs": [
     "align-items/default",
     "display/default",