@almadar/ui 6.20.0 → 6.22.0

package/dist/providers/index.js

@@ -1503,6 +1503,36 @@ var init_Typography = __esm({
     Typography.displayName = "Typography";
   }
 });
+
+// lib/portalRoot.ts
+function lastThemedElement(selector, portalRoot) {
+  const matches = Array.from(document.querySelectorAll(selector)).filter(
+    (el) => el !== document.documentElement && el !== portalRoot
+  );
+  return matches[matches.length - 1] ?? null;
+}
+function getOrCreatePortalRoot() {
+  let root = document.getElementById("ui-slot-portal-root");
+  if (!root) {
+    root = document.createElement("div");
+    root.id = "ui-slot-portal-root";
+    root.style.position = "relative";
+    root.style.zIndex = "9999";
+    document.body.appendChild(root);
+  }
+  const themed = lastThemedElement('[data-theme*="-"]', root) ?? lastThemedElement("[data-theme]", root);
+  if (themed) {
+    const theme = themed.getAttribute("data-theme");
+    if (theme && root.getAttribute("data-theme") !== theme) {
+      root.setAttribute("data-theme", theme);
+    }
+  }
+  return root;
+}
+var init_portalRoot = __esm({
+  "lib/portalRoot.ts"() {
+  }
+});
 function isMotionEnabled() {
   if (typeof document === "undefined") return true;
   if (motionEnabledCache !== null) return motionEnabledCache;
@@ -1583,6 +1613,7 @@ var init_Modal = __esm({
     init_Dialog();
     init_Typography();
     init_cn();
+    init_portalRoot();
     init_useEventBus();
     init_Presence();
     sizeClasses2 = {
@@ -1793,7 +1824,7 @@ var init_Modal = __esm({
             )
           }
         ),
-        document.body
+        getOrCreatePortalRoot()
       );
     };
     Modal.displayName = "Modal";
@@ -20429,6 +20460,7 @@ var init_StateMachineView = __esm({
     init_Icon();
     init_useEventBus();
     init_cn();
+    init_portalRoot();
     StateNode2 = ({ state, config }) => {
       const { t } = useTranslate();
       const size = state.radius * 2;
@@ -20945,7 +20977,7 @@ var init_StateMachineView = __esm({
             )
           }
         ),
-        document.body
+        getOrCreatePortalRoot()
       );
     };
     EntityBox = ({ entity, config }) => {
@@ -27586,7 +27618,7 @@ function SubMenu({
       })
     }
   );
-  return typeof document !== "undefined" ? createPortal(panel, document.body) : panel;
+  return typeof document !== "undefined" ? createPortal(panel, getOrCreatePortalRoot()) : panel;
 }
 function MenuItemRow({
   item,
@@ -27673,6 +27705,7 @@ var init_Menu = __esm({
     init_Typography();
     init_Badge();
     init_cn();
+    init_portalRoot();
     init_useEventBus();
     MENU_GAP = 4;
     menuContainerStyles = cn(
@@ -27809,7 +27842,7 @@ var init_Menu = __esm({
       ) : null;
       return /* @__PURE__ */ jsxs(Fragment, { children: [
         triggerElement,
-        panel && typeof document !== "undefined" ? createPortal(panel, document.body) : panel
+        panel && typeof document !== "undefined" ? createPortal(panel, getOrCreatePortalRoot()) : panel
       ] });
     };
     Menu.displayName = "Menu";
@@ -31193,6 +31226,7 @@ var init_Popover = __esm({
     init_Typography();
     init_Presence();
     init_cn();
+    init_portalRoot();
     init_useTapReveal();
     arrowClasses = {
       top: "top-full left-1/2 -translate-x-1/2 border-t-white border-l-transparent border-r-transparent border-b-transparent",
@@ -31352,7 +31386,7 @@ var init_Popover = __esm({
       ) : null;
       return /* @__PURE__ */ jsxs(Fragment, { children: [
         triggerElement,
-        panel && typeof document !== "undefined" ? createPortal(panel, document.body) : panel
+        panel && typeof document !== "undefined" ? createPortal(panel, getOrCreatePortalRoot()) : panel
       ] });
     };
     Popover.displayName = "Popover";
@@ -31858,6 +31892,7 @@ var init_Tooltip = __esm({
     "use client";
     init_Typography();
     init_cn();
+    init_portalRoot();
     init_useTapReveal();
     TRIGGER_GAP2 = 8;
     arrowClasses2 = {
@@ -31963,7 +31998,7 @@ var init_Tooltip = __esm({
       ) : null;
       return /* @__PURE__ */ jsxs(Fragment, { children: [
         trigger,
-        typeof window !== "undefined" && tooltipContent ? createPortal(tooltipContent, document.body) : tooltipContent
+        typeof window !== "undefined" && tooltipContent ? createPortal(tooltipContent, getOrCreatePortalRoot()) : tooltipContent
       ] });
     };
     Tooltip.displayName = "Tooltip";
@@ -43383,6 +43418,7 @@ var init_GraphCanvas = __esm({
   "components/core/molecules/GraphCanvas.tsx"() {
     "use client";
     init_cn();
+    init_portalRoot();
     init_atoms();
     init_Stack();
     init_LoadingState();
@@ -44094,7 +44130,7 @@ var init_GraphCanvas = __esm({
                 children: hoveredObj?.label
               }
             ),
-            document.body
+            getOrCreatePortalRoot()
           )
         ] }),
         groups.length > 1 && /* @__PURE__ */ jsx(HStack, { gap: "md", className: "px-4 py-2 border-t border-border", wrap: true, children: groups.map((group, idx) => /* @__PURE__ */ jsxs(HStack, { gap: "xs", align: "center", children: [
@@ -45255,6 +45291,7 @@ var init_DetailPanel = __esm({
     init_ErrorState();
     init_EmptyState();
     init_cn();
+    init_portalRoot();
     init_format();
     init_getNestedValue();
     init_relationLabel();
@@ -45674,7 +45711,7 @@ var init_DetailPanel = __esm({
         return /* @__PURE__ */ jsx(Box, { className, children: content });
       }
       const panel = /* @__PURE__ */ jsx(Box, { className: cn("fixed inset-y-0 right-0 w-full max-w-2xl bg-card shadow-lg z-50 overflow-y-auto p-6", className), children: content });
-      return typeof document === "undefined" ? panel : createPortal(panel, document.body);
+      return typeof document === "undefined" ? panel : createPortal(panel, getOrCreatePortalRoot());
     };
     DetailPanel.displayName = "DetailPanel";
   }
@@ -52565,24 +52602,6 @@ function UISlotComponentInner({
     }
   );
 }
-function getOrCreatePortalRoot() {
-  let root = document.getElementById("ui-slot-portal-root");
-  if (!root) {
-    root = document.createElement("div");
-    root.id = "ui-slot-portal-root";
-    root.style.position = "relative";
-    root.style.zIndex = "9999";
-    document.body.appendChild(root);
-  }
-  const themed = document.querySelector('[data-theme*="-"]') ?? document.querySelector("[data-theme]");
-  if (themed) {
-    const theme = themed.getAttribute("data-theme");
-    if (theme && root.getAttribute("data-theme") !== theme) {
-      root.setAttribute("data-theme", theme);
-    }
-  }
-  return root;
-}
 function CompiledPortal({ slot, className, pattern, sourceTrait, children }) {
   const [portalRoot, setPortalRoot] = useState(null);
   const slotsBus = useUISlots();
@@ -53205,6 +53224,7 @@ var init_UISlotRenderer = __esm({
     init_slot_types();
     init_cn();
     init_format();
+    init_portalRoot();
     init_ErrorBoundary();
     init_Skeleton();
     init_renderer();

package/dist/runtime/index.cjs

@@ -2176,6 +2176,36 @@ var init_Typography = __esm({
     Typography.displayName = "Typography";
   }
 });
+
+// lib/portalRoot.ts
+function lastThemedElement(selector, portalRoot) {
+  const matches = Array.from(document.querySelectorAll(selector)).filter(
+    (el) => el !== document.documentElement && el !== portalRoot
+  );
+  return matches[matches.length - 1] ?? null;
+}
+function getOrCreatePortalRoot() {
+  let root = document.getElementById("ui-slot-portal-root");
+  if (!root) {
+    root = document.createElement("div");
+    root.id = "ui-slot-portal-root";
+    root.style.position = "relative";
+    root.style.zIndex = "9999";
+    document.body.appendChild(root);
+  }
+  const themed = lastThemedElement('[data-theme*="-"]', root) ?? lastThemedElement("[data-theme]", root);
+  if (themed) {
+    const theme = themed.getAttribute("data-theme");
+    if (theme && root.getAttribute("data-theme") !== theme) {
+      root.setAttribute("data-theme", theme);
+    }
+  }
+  return root;
+}
+var init_portalRoot = __esm({
+  "lib/portalRoot.ts"() {
+  }
+});
 function isMotionEnabled() {
   if (typeof document === "undefined") return true;
   if (motionEnabledCache !== null) return motionEnabledCache;
@@ -2256,6 +2286,7 @@ var init_Modal = __esm({
     init_Dialog();
     init_Typography();
     init_cn();
+    init_portalRoot();
     init_useEventBus();
     init_Presence();
     sizeClasses2 = {
@@ -2466,7 +2497,7 @@ var init_Modal = __esm({
             )
           }
         ),
-        document.body
+        getOrCreatePortalRoot()
       );
     };
     Modal.displayName = "Modal";
@@ -20532,6 +20563,7 @@ var init_StateMachineView = __esm({
     init_Icon();
     init_useEventBus();
     init_cn();
+    init_portalRoot();
     StateNode2 = ({ state, config }) => {
       const { t } = hooks.useTranslate();
       const size = state.radius * 2;
@@ -21048,7 +21080,7 @@ var init_StateMachineView = __esm({
             )
           }
         ),
-        document.body
+        getOrCreatePortalRoot()
       );
     };
     EntityBox = ({ entity, config }) => {
@@ -27608,7 +27640,7 @@ function SubMenu({
       })
     }
   );
-  return typeof document !== "undefined" ? reactDom.createPortal(panel, document.body) : panel;
+  return typeof document !== "undefined" ? reactDom.createPortal(panel, getOrCreatePortalRoot()) : panel;
 }
 function MenuItemRow({
   item,
@@ -27695,6 +27727,7 @@ var init_Menu = __esm({
     init_Typography();
     init_Badge();
     init_cn();
+    init_portalRoot();
     init_useEventBus();
     MENU_GAP = 4;
     menuContainerStyles = cn(
@@ -27831,7 +27864,7 @@ var init_Menu = __esm({
       ) : null;
       return /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
         triggerElement,
-        panel && typeof document !== "undefined" ? reactDom.createPortal(panel, document.body) : panel
+        panel && typeof document !== "undefined" ? reactDom.createPortal(panel, getOrCreatePortalRoot()) : panel
       ] });
     };
     Menu.displayName = "Menu";
@@ -31045,6 +31078,7 @@ var init_Popover = __esm({
     init_Typography();
     init_Presence();
     init_cn();
+    init_portalRoot();
     init_useTapReveal();
     arrowClasses = {
       top: "top-full left-1/2 -translate-x-1/2 border-t-white border-l-transparent border-r-transparent border-b-transparent",
@@ -31204,7 +31238,7 @@ var init_Popover = __esm({
       ) : null;
       return /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
         triggerElement,
-        panel && typeof document !== "undefined" ? reactDom.createPortal(panel, document.body) : panel
+        panel && typeof document !== "undefined" ? reactDom.createPortal(panel, getOrCreatePortalRoot()) : panel
       ] });
     };
     Popover.displayName = "Popover";
@@ -31710,6 +31744,7 @@ var init_Tooltip = __esm({
     "use client";
     init_Typography();
     init_cn();
+    init_portalRoot();
     init_useTapReveal();
     TRIGGER_GAP2 = 8;
     arrowClasses2 = {
@@ -31815,7 +31850,7 @@ var init_Tooltip = __esm({
       ) : null;
       return /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
         trigger,
-        typeof window !== "undefined" && tooltipContent ? reactDom.createPortal(tooltipContent, document.body) : tooltipContent
+        typeof window !== "undefined" && tooltipContent ? reactDom.createPortal(tooltipContent, getOrCreatePortalRoot()) : tooltipContent
       ] });
     };
     Tooltip.displayName = "Tooltip";
@@ -43097,6 +43132,7 @@ var init_GraphCanvas = __esm({
   "components/core/molecules/GraphCanvas.tsx"() {
     "use client";
     init_cn();
+    init_portalRoot();
     init_atoms();
     init_Stack();
     init_LoadingState();
@@ -43808,7 +43844,7 @@ var init_GraphCanvas = __esm({
                 children: hoveredObj?.label
               }
             ),
-            document.body
+            getOrCreatePortalRoot()
           )
         ] }),
         groups.length > 1 && /* @__PURE__ */ jsxRuntime.jsx(HStack, { gap: "md", className: "px-4 py-2 border-t border-border", wrap: true, children: groups.map((group, idx) => /* @__PURE__ */ jsxRuntime.jsxs(HStack, { gap: "xs", align: "center", children: [
@@ -44969,6 +45005,7 @@ var init_DetailPanel = __esm({
     init_ErrorState();
     init_EmptyState();
     init_cn();
+    init_portalRoot();
     init_format();
     init_getNestedValue();
     init_relationLabel();
@@ -45388,7 +45425,7 @@ var init_DetailPanel = __esm({
         return /* @__PURE__ */ jsxRuntime.jsx(Box, { className, children: content });
       }
       const panel = /* @__PURE__ */ jsxRuntime.jsx(Box, { className: cn("fixed inset-y-0 right-0 w-full max-w-2xl bg-card shadow-lg z-50 overflow-y-auto p-6", className), children: content });
-      return typeof document === "undefined" ? panel : reactDom.createPortal(panel, document.body);
+      return typeof document === "undefined" ? panel : reactDom.createPortal(panel, getOrCreatePortalRoot());
     };
     DetailPanel.displayName = "DetailPanel";
   }
@@ -52298,24 +52335,6 @@ function UISlotComponentInner({
     }
   );
 }
-function getOrCreatePortalRoot() {
-  let root = document.getElementById("ui-slot-portal-root");
-  if (!root) {
-    root = document.createElement("div");
-    root.id = "ui-slot-portal-root";
-    root.style.position = "relative";
-    root.style.zIndex = "9999";
-    document.body.appendChild(root);
-  }
-  const themed = document.querySelector('[data-theme*="-"]') ?? document.querySelector("[data-theme]");
-  if (themed) {
-    const theme = themed.getAttribute("data-theme");
-    if (theme && root.getAttribute("data-theme") !== theme) {
-      root.setAttribute("data-theme", theme);
-    }
-  }
-  return root;
-}
 function CompiledPortal({ slot, className, pattern, sourceTrait, children }) {
   const [portalRoot, setPortalRoot] = React87.useState(null);
   const slotsBus = context.useUISlots();
@@ -52938,6 +52957,7 @@ var init_UISlotRenderer = __esm({
     init_slot_types();
     init_cn();
     init_format();
+    init_portalRoot();
     init_ErrorBoundary();
     init_Skeleton();
     init_renderer();
@@ -54756,7 +54776,7 @@ function NavStackRefBridge({ apiRef }) {
   }, [api, apiRef]);
   return null;
 }
-function TraitInitializer({ traits: traits2, routeParams, orbitalNames, onNavigate, onNavigateBack, onLocalFallback, persistence, traitConfigsByName, orbitalsByTrait, embeddedTraits, callsiteCaptureChildrenByTrait, serverActiveTraits, children }) {
+function TraitInitializer({ traits: traits2, routeParams, orbitalNames, onNavigate, onNavigateBack, onLocalFallback, localFallbackTimeoutMs, persistence, traitConfigsByName, orbitalsByTrait, embeddedTraits, callsiteCaptureChildrenByTrait, serverActiveTraits, children }) {
   const bridge = providers.useServerBridge();
   const activeTraitNames = React87.useMemo(
     () => new Set(traits2.map((b) => b.trait.name).filter((n) => !!n)),
@@ -54823,9 +54843,9 @@ function TraitInitializer({ traits: traits2, routeParams, orbitalNames, onNaviga
         sendEvent("INIT", routeParams);
         onLocalFallback?.();
       }
-    }, 5e3);
+    }, localFallbackTimeoutMs ?? 5e3);
     return () => clearTimeout(fallback);
-  }, [traits2, orbitalNames, sendEvent, onLocalFallback, routeParams]);
+  }, [traits2, orbitalNames, sendEvent, onLocalFallback, localFallbackTimeoutMs, routeParams]);
   React87.useEffect(() => {
     if (!bridge.connected || !orbitalNames?.length || initSentRef.current) return;
     initSentRef.current = true;
@@ -54879,7 +54899,7 @@ function FitToBox({ children }) {
   }, []);
   return /* @__PURE__ */ jsxRuntime.jsx("div", { ref: outerRef, className: "relative h-full w-full overflow-hidden", children: /* @__PURE__ */ jsxRuntime.jsx("div", { ref: innerRef, style: { transform: `scale(${scale})`, transformOrigin: "top left", width: "fit-content" }, children }) });
 }
-function SchemaRunner({ schema, serverUrl, transport, getAccessToken, mockData, pageName, routeParams, onNavigate, onNavigateBack, onLocalFallback, persistence }) {
+function SchemaRunner({ schema, serverUrl, transport, getAccessToken, mockData, pageName, routeParams, onNavigate, onNavigateBack, onLocalFallback, localFallbackTimeoutMs, persistence }) {
   const { traits: traits2, allEntities, allTraits, ir } = useResolvedSchema(schema, pageName);
   const allPageTraits = React87.useMemo(() => {
     let base;
@@ -55042,6 +55062,7 @@ function SchemaRunner({ schema, serverUrl, transport, getAccessToken, mockData,
           onNavigate,
           onNavigateBack,
           onLocalFallback,
+          localFallbackTimeoutMs,
           persistence,
           children: /* @__PURE__ */ jsxRuntime.jsx(providers.OrbitalThemeProvider, { theme: activeOrbitalTheme, children: /* @__PURE__ */ jsxRuntime.jsx(Box, { className: "h-full min-h-full overflow-auto p-4", children: /* @__PURE__ */ jsxRuntime.jsx(UISlotRenderer, { includeHud: true, hudMode: "inline", includeFloating: true }) }) })
         }
@@ -55065,7 +55086,8 @@ function OrbPreview({
   initialPagePath,
   isolated = false,
   fit = false,
-  user = null
+  user = null,
+  localFallbackTimeoutMs
 }) {
   if (serverUrl && transport) {
     throw new Error("OrbPreview accepts serverUrl OR transport, not both");
@@ -55247,6 +55269,7 @@ function OrbPreview({
                   onNavigate: handleNavigateEffect,
                   onNavigateBack: handleNavigateBack,
                   onLocalFallback: handleLocalFallback,
+                  localFallbackTimeoutMs,
                   persistence
                 }
               ) }) : /* @__PURE__ */ jsxRuntime.jsx(
@@ -55262,6 +55285,7 @@ function OrbPreview({
                   onNavigate: handleNavigateEffect,
                   onNavigateBack: handleNavigateBack,
                   onLocalFallback: handleLocalFallback,
+                  localFallbackTimeoutMs,
                   persistence
                 }
               ) }) })

package/dist/runtime/index.d.cts

@@ -292,6 +292,15 @@ interface OrbPreviewProps {
     transport?: ServerBridgeTransport;
     /** Bearer token for `serverUrl` requests (see `ServerBridgeProviderProps.getAccessToken`). */
     getAccessToken?: AccessTokenProvider;
+    /**
+     * How long (ms) to wait for the server bridge to connect before assuming
+     * it's unreachable and falling back to local-only execution. Default
+     * 5000 (unchanged unless you pass this). Widen it for a caller whose
+     * schema is large enough that the server's first `register()` genuinely
+     * takes longer than 5s (e.g. a 53-orbital organism measured ~14.5s in
+     * production) — see `TraitInitializer`'s `localFallbackTimeoutMs` doc.
+     */
+    localFallbackTimeoutMs?: number;
     /**
      * Initial page path to render (e.g. `/deals`). Resolves against the
      * schema's `pages[]` to seed `currentPage` so the right orbital's traits
@@ -333,7 +342,7 @@ interface OrbPreviewProps {
  * <OrbPreview schema={schema} serverUrl="/api/orbitals" />
  * ```
  */
-declare function OrbPreview({ schema, mockData, autoMock, height, className, serverUrl, transport, getAccessToken, initialPagePath, isolated, fit, user, }: OrbPreviewProps): React__default.ReactElement;
+declare function OrbPreview({ schema, mockData, autoMock, height, className, serverUrl, transport, getAccessToken, initialPagePath, isolated, fit, user, localFallbackTimeoutMs, }: OrbPreviewProps): React__default.ReactElement;
 declare namespace OrbPreview {
     var displayName: string;
 }

package/dist/runtime/index.d.ts

@@ -292,6 +292,15 @@ interface OrbPreviewProps {
     transport?: ServerBridgeTransport;
     /** Bearer token for `serverUrl` requests (see `ServerBridgeProviderProps.getAccessToken`). */
     getAccessToken?: AccessTokenProvider;
+    /**
+     * How long (ms) to wait for the server bridge to connect before assuming
+     * it's unreachable and falling back to local-only execution. Default
+     * 5000 (unchanged unless you pass this). Widen it for a caller whose
+     * schema is large enough that the server's first `register()` genuinely
+     * takes longer than 5s (e.g. a 53-orbital organism measured ~14.5s in
+     * production) — see `TraitInitializer`'s `localFallbackTimeoutMs` doc.
+     */
+    localFallbackTimeoutMs?: number;
     /**
      * Initial page path to render (e.g. `/deals`). Resolves against the
      * schema's `pages[]` to seed `currentPage` so the right orbital's traits
@@ -333,7 +342,7 @@ interface OrbPreviewProps {
  * <OrbPreview schema={schema} serverUrl="/api/orbitals" />
  * ```
  */
-declare function OrbPreview({ schema, mockData, autoMock, height, className, serverUrl, transport, getAccessToken, initialPagePath, isolated, fit, user, }: OrbPreviewProps): React__default.ReactElement;
+declare function OrbPreview({ schema, mockData, autoMock, height, className, serverUrl, transport, getAccessToken, initialPagePath, isolated, fit, user, localFallbackTimeoutMs, }: OrbPreviewProps): React__default.ReactElement;
 declare namespace OrbPreview {
     var displayName: string;
 }