@almadar/ui 6.21.0 → 6.23.0

package/dist/{EntityBindingContext-DoK8Xq71.d.cts → EntityBindingContext-CTZw2DbY.d.cts}

@@ -200,7 +200,20 @@ interface ServerBridgeTransport {
     sendEvent: (orbitalName: string, event: string, payload?: EventPayload, clientId?: string, tick?: string, sourceTrait?: string, results?: ReadonlyArray<{
         traitName: string;
         result: TransitionResult;
-    }>, entityByTrait?: Readonly<Record<string, EntityRow>>) => Promise<OrbitalEventResponse>;
+    }>, entityByTrait?: Readonly<Record<string, EntityRow>>, 
+    /**
+     * The mounted top-level schema's own `name` (`ServerBridgeProvider`'s
+     * `schema` prop). Orbital names are not unique across a hosting
+     * server's whole catalog — a "whole orbital import" copies an existing
+     * orbital wholesale into a new behavior, so two catalog entries can
+     * declare an orbital with the identical name — this disambiguates
+     * which one a stateless server should resolve against instead of it
+     * guessing from a global orbital-name reverse index (verified
+     * 2026-09-16: project-friday's own imported `TaskOrbital` was
+     * misrouted to the standalone `std-project-manager` orbital of the
+     * same name). An unmodified server ignores the extra field.
+     */
+    behaviorHint?: string) => Promise<OrbitalEventResponse>;
 }
 /**
  * Supplies the bearer token the hosting server authenticates with. Resolved

package/dist/{EntityBindingContext-DoK8Xq71.d.ts → EntityBindingContext-CTZw2DbY.d.ts}

@@ -200,7 +200,20 @@ interface ServerBridgeTransport {
     sendEvent: (orbitalName: string, event: string, payload?: EventPayload, clientId?: string, tick?: string, sourceTrait?: string, results?: ReadonlyArray<{
         traitName: string;
         result: TransitionResult;
-    }>, entityByTrait?: Readonly<Record<string, EntityRow>>) => Promise<OrbitalEventResponse>;
+    }>, entityByTrait?: Readonly<Record<string, EntityRow>>, 
+    /**
+     * The mounted top-level schema's own `name` (`ServerBridgeProvider`'s
+     * `schema` prop). Orbital names are not unique across a hosting
+     * server's whole catalog — a "whole orbital import" copies an existing
+     * orbital wholesale into a new behavior, so two catalog entries can
+     * declare an orbital with the identical name — this disambiguates
+     * which one a stateless server should resolve against instead of it
+     * guessing from a global orbital-name reverse index (verified
+     * 2026-09-16: project-friday's own imported `TaskOrbital` was
+     * misrouted to the standalone `std-project-manager` orbital of the
+     * same name). An unmodified server ignores the extra field.
+     */
+    behaviorHint?: string) => Promise<OrbitalEventResponse>;
 }
 /**
  * Supplies the bearer token the hosting server authenticates with. Resolved

package/dist/avl/index.cjs

@@ -60549,7 +60549,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 = React96.useMemo(
     () => new Set(traits2.map((b) => b.trait.name).filter((n) => !!n)),
@@ -60616,9 +60616,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]);
   React96.useEffect(() => {
     if (!bridge.connected || !orbitalNames?.length || initSentRef.current) return;
     initSentRef.current = true;
@@ -60672,7 +60672,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 = React96.useMemo(() => {
     let base;
@@ -60835,6 +60835,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 }) }) })
         }
@@ -60858,7 +60859,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");
@@ -61040,6 +61042,7 @@ function OrbPreview({
                   onNavigate: handleNavigateEffect,
                   onNavigateBack: handleNavigateBack,
                   onLocalFallback: handleLocalFallback,
+                  localFallbackTimeoutMs,
                   persistence
                 }
               ) }) : /* @__PURE__ */ jsxRuntime.jsx(
@@ -61055,6 +61058,7 @@ function OrbPreview({
                   onNavigate: handleNavigateEffect,
                   onNavigateBack: handleNavigateBack,
                   onLocalFallback: handleLocalFallback,
+                  localFallbackTimeoutMs,
                   persistence
                 }
               ) }) })

package/dist/avl/index.js

@@ -60473,7 +60473,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 = useServerBridge();
   const activeTraitNames = useMemo(
     () => new Set(traits2.map((b) => b.trait.name).filter((n) => !!n)),
@@ -60540,9 +60540,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]);
   useEffect(() => {
     if (!bridge.connected || !orbitalNames?.length || initSentRef.current) return;
     initSentRef.current = true;
@@ -60596,7 +60596,7 @@ function FitToBox({ children }) {
   }, []);
   return /* @__PURE__ */ jsx("div", { ref: outerRef, className: "relative h-full w-full overflow-hidden", children: /* @__PURE__ */ 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 = useMemo(() => {
     let base;
@@ -60759,6 +60759,7 @@ function SchemaRunner({ schema, serverUrl, transport, getAccessToken, mockData,
           onNavigate,
           onNavigateBack,
           onLocalFallback,
+          localFallbackTimeoutMs,
           persistence,
           children: /* @__PURE__ */ jsx(OrbitalThemeProvider, { theme: activeOrbitalTheme, children: /* @__PURE__ */ jsx(Box, { className: "h-full min-h-full overflow-auto p-4", children: /* @__PURE__ */ jsx(UISlotRenderer, { includeHud: true, hudMode: "inline", includeFloating: true }) }) })
         }
@@ -60782,7 +60783,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");
@@ -60964,6 +60966,7 @@ function OrbPreview({
                   onNavigate: handleNavigateEffect,
                   onNavigateBack: handleNavigateBack,
                   onLocalFallback: handleLocalFallback,
+                  localFallbackTimeoutMs,
                   persistence
                 }
               ) }) : /* @__PURE__ */ jsx(
@@ -60979,6 +60982,7 @@ function OrbPreview({
                   onNavigate: handleNavigateEffect,
                   onNavigateBack: handleNavigateBack,
                   onLocalFallback: handleLocalFallback,
+                  localFallbackTimeoutMs,
                   persistence
                 }
               ) }) })

package/dist/providers/index.cjs

@@ -54647,7 +54647,7 @@ function createHttpTransport(serverUrl, getAccessToken) {
       } catch {
       }
     },
-    sendEvent: async (orbitalName, event, payload, clientId, tick, sourceTrait, results, entityByTrait) => {
+    sendEvent: async (orbitalName, event, payload, clientId, tick, sourceTrait, results, entityByTrait, behaviorHint) => {
       const traits2 = results?.map((r) => ({ trait: r.traitName, from: r.result.previousState }));
       const body = {
         event,
@@ -54667,7 +54667,8 @@ function createHttpTransport(serverUrl, getAccessToken) {
         // `traits`" would make the mount-time case indistinguishable from
         // "do nothing" and break every organism's INIT on the stateless path.
         ...results !== void 0 ? { traits: traits2 ?? [] } : {},
-        ...entityByTrait ? { entityByTrait } : {}
+        ...entityByTrait ? { entityByTrait } : {},
+        ...behaviorHint !== void 0 ? { behavior: behaviorHint } : {}
       };
       const res = await fetch(`${serverUrl}/${orbitalName}/events`, {
         method: "POST",
@@ -54716,9 +54717,9 @@ function ServerBridgeProvider({
   );
   const tickRelay = React89.useMemo(
     () => createTickSendRelay(async (_key, snap) => {
-      await transport.sendEvent(snap.orbitalName, snap.event, snap.payload, getTabClientId(), snap.tick, snap.sourceTrait);
+      await transport.sendEvent(snap.orbitalName, snap.event, snap.payload, getTabClientId(), snap.tick, snap.sourceTrait, void 0, void 0, schema.name);
     }),
-    [transport]
+    [transport, schema.name]
   );
   React89.useEffect(() => () => tickRelay.clear(), [tickRelay]);
   const commandPump = React89.useMemo(createCommandSendPump, []);
@@ -54739,7 +54740,7 @@ function ServerBridgeProvider({
     return commandPump.enqueue(async () => {
       if (disposedRef.current) return { effects: [], meta: emptyMeta };
       try {
-        const result = await transport.sendEvent(orbitalName, event, payload, getTabClientId(), tick, sourceTrait, results, entityByTrait);
+        const result = await transport.sendEvent(orbitalName, event, payload, getTabClientId(), tick, sourceTrait, results, entityByTrait, schema.name);
         const effects = [];
         const responseData = result.data || {};
         const dataEntities = {};
@@ -54820,7 +54821,7 @@ function ServerBridgeProvider({
         return { effects: [], meta: { ...emptyMeta, error: msg } };
       }
     });
-  }, [connected, transport, eventBus, tickRelay, commandPump]);
+  }, [connected, transport, eventBus, tickRelay, commandPump, schema.name]);
   React89.useEffect(() => {
     if (!schema) return;
     let cancelled = false;

package/dist/providers/index.d.cts

@@ -6,7 +6,7 @@ export { a as CurrentPagePathContext, b as CurrentPagePathProvider, c as Current
 import { b as UserData } from '../UserContext-D566nfWA.cjs';
 export { U as UserContext, a as UserContextValue, c as UserProvider, d as UserProviderProps, u as useHasPermission, e as useHasRole, f as useUser, g as useUserForEvaluation } from '../UserContext-D566nfWA.cjs';
 import { E as EventBusContextType } from '../event-bus-types-Bl78kokd.cjs';
-export { A as AccessTokenProvider, E as EntityBindingContext, a as EntityBindingSource, b as EntitySchemaContextValue, c as EntitySchemaProvider, d as EntitySchemaProviderProps, S as SendEventResult, e as ServerBridgeContextValue, f as ServerBridgeProvider, g as ServerBridgeProviderProps, h as ServerBridgeTransport, i as ServerClientEffect, j as ServerResponseMeta, T as TraitContext, k as TraitContextValue, l as TraitInstance, m as TraitProvider, n as TraitProviderProps, u as useEntityBindingSnapshot, o as useEntitySchema, p as useEntitySchemaOptional, q as useServerBridge, r as useTrait, s as useTraitContext } from '../EntityBindingContext-DoK8Xq71.cjs';
+export { A as AccessTokenProvider, E as EntityBindingContext, a as EntityBindingSource, b as EntitySchemaContextValue, c as EntitySchemaProvider, d as EntitySchemaProviderProps, S as SendEventResult, e as ServerBridgeContextValue, f as ServerBridgeProvider, g as ServerBridgeProviderProps, h as ServerBridgeTransport, i as ServerClientEffect, j as ServerResponseMeta, T as TraitContext, k as TraitContextValue, l as TraitInstance, m as TraitProvider, n as TraitProviderProps, u as useEntityBindingSnapshot, o as useEntitySchema, p as useEntitySchemaOptional, q as useServerBridge, r as useTrait, s as useTraitContext } from '../EntityBindingContext-CTZw2DbY.cjs';
 import { i as UseOfflineExecutorResult, U as UseOfflineExecutorOptions } from '../offline-executor-DdV2o0Zu.cjs';
 export { N as NavigationContextValue, c as NavigationProvider, d as NavigationProviderProps, e as NavigationState, j as comparePathSpecificity, l as extractRouteParams, m as findPageByName, n as findPageByPath, o as getAllPages, p as getDefaultPage, q as matchPath, r as matchPathAmong, s as pathMatches, u as useActivePage, t as useInitPayload, v as useNavigateTo, w as useNavigation, x as useNavigationId, y as useNavigationState } from '../offline-executor-DdV2o0Zu.cjs';
 import '../verificationRegistry-DTrKDRoa.cjs';

package/dist/providers/index.d.ts

@@ -6,7 +6,7 @@ export { a as CurrentPagePathContext, b as CurrentPagePathProvider, c as Current
 import { b as UserData } from '../UserContext-D566nfWA.js';
 export { U as UserContext, a as UserContextValue, c as UserProvider, d as UserProviderProps, u as useHasPermission, e as useHasRole, f as useUser, g as useUserForEvaluation } from '../UserContext-D566nfWA.js';
 import { E as EventBusContextType } from '../event-bus-types-Bl78kokd.js';
-export { A as AccessTokenProvider, E as EntityBindingContext, a as EntityBindingSource, b as EntitySchemaContextValue, c as EntitySchemaProvider, d as EntitySchemaProviderProps, S as SendEventResult, e as ServerBridgeContextValue, f as ServerBridgeProvider, g as ServerBridgeProviderProps, h as ServerBridgeTransport, i as ServerClientEffect, j as ServerResponseMeta, T as TraitContext, k as TraitContextValue, l as TraitInstance, m as TraitProvider, n as TraitProviderProps, u as useEntityBindingSnapshot, o as useEntitySchema, p as useEntitySchemaOptional, q as useServerBridge, r as useTrait, s as useTraitContext } from '../EntityBindingContext-DoK8Xq71.js';
+export { A as AccessTokenProvider, E as EntityBindingContext, a as EntityBindingSource, b as EntitySchemaContextValue, c as EntitySchemaProvider, d as EntitySchemaProviderProps, S as SendEventResult, e as ServerBridgeContextValue, f as ServerBridgeProvider, g as ServerBridgeProviderProps, h as ServerBridgeTransport, i as ServerClientEffect, j as ServerResponseMeta, T as TraitContext, k as TraitContextValue, l as TraitInstance, m as TraitProvider, n as TraitProviderProps, u as useEntityBindingSnapshot, o as useEntitySchema, p as useEntitySchemaOptional, q as useServerBridge, r as useTrait, s as useTraitContext } from '../EntityBindingContext-CTZw2DbY.js';
 import { i as UseOfflineExecutorResult, U as UseOfflineExecutorOptions } from '../offline-executor-DdV2o0Zu.js';
 export { N as NavigationContextValue, c as NavigationProvider, d as NavigationProviderProps, e as NavigationState, j as comparePathSpecificity, l as extractRouteParams, m as findPageByName, n as findPageByPath, o as getAllPages, p as getDefaultPage, q as matchPath, r as matchPathAmong, s as pathMatches, u as useActivePage, t as useInitPayload, v as useNavigateTo, w as useNavigation, x as useNavigationId, y as useNavigationState } from '../offline-executor-DdV2o0Zu.js';
 import '../verificationRegistry-Cwa52VyK.js';

package/dist/providers/index.js

@@ -54573,7 +54573,7 @@ function createHttpTransport(serverUrl, getAccessToken) {
       } catch {
       }
     },
-    sendEvent: async (orbitalName, event, payload, clientId, tick, sourceTrait, results, entityByTrait) => {
+    sendEvent: async (orbitalName, event, payload, clientId, tick, sourceTrait, results, entityByTrait, behaviorHint) => {
       const traits2 = results?.map((r) => ({ trait: r.traitName, from: r.result.previousState }));
       const body = {
         event,
@@ -54593,7 +54593,8 @@ function createHttpTransport(serverUrl, getAccessToken) {
         // `traits`" would make the mount-time case indistinguishable from
         // "do nothing" and break every organism's INIT on the stateless path.
         ...results !== void 0 ? { traits: traits2 ?? [] } : {},
-        ...entityByTrait ? { entityByTrait } : {}
+        ...entityByTrait ? { entityByTrait } : {},
+        ...behaviorHint !== void 0 ? { behavior: behaviorHint } : {}
       };
       const res = await fetch(`${serverUrl}/${orbitalName}/events`, {
         method: "POST",
@@ -54642,9 +54643,9 @@ function ServerBridgeProvider({
   );
   const tickRelay = useMemo(
     () => createTickSendRelay(async (_key, snap) => {
-      await transport.sendEvent(snap.orbitalName, snap.event, snap.payload, getTabClientId(), snap.tick, snap.sourceTrait);
+      await transport.sendEvent(snap.orbitalName, snap.event, snap.payload, getTabClientId(), snap.tick, snap.sourceTrait, void 0, void 0, schema.name);
     }),
-    [transport]
+    [transport, schema.name]
   );
   useEffect(() => () => tickRelay.clear(), [tickRelay]);
   const commandPump = useMemo(createCommandSendPump, []);
@@ -54665,7 +54666,7 @@ function ServerBridgeProvider({
     return commandPump.enqueue(async () => {
       if (disposedRef.current) return { effects: [], meta: emptyMeta };
       try {
-        const result = await transport.sendEvent(orbitalName, event, payload, getTabClientId(), tick, sourceTrait, results, entityByTrait);
+        const result = await transport.sendEvent(orbitalName, event, payload, getTabClientId(), tick, sourceTrait, results, entityByTrait, schema.name);
         const effects = [];
         const responseData = result.data || {};
         const dataEntities = {};
@@ -54746,7 +54747,7 @@ function ServerBridgeProvider({
         return { effects: [], meta: { ...emptyMeta, error: msg } };
       }
     });
-  }, [connected, transport, eventBus, tickRelay, commandPump]);
+  }, [connected, transport, eventBus, tickRelay, commandPump, schema.name]);
   useEffect(() => {
     if (!schema) return;
     let cancelled = false;

package/dist/runtime/index.cjs

@@ -54776,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)),
@@ -54843,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;
@@ -54899,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;
@@ -55062,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 }) }) })
         }
@@ -55085,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");
@@ -55267,6 +55269,7 @@ function OrbPreview({
                   onNavigate: handleNavigateEffect,
                   onNavigateBack: handleNavigateBack,
                   onLocalFallback: handleLocalFallback,
+                  localFallbackTimeoutMs,
                   persistence
                 }
               ) }) : /* @__PURE__ */ jsxRuntime.jsx(
@@ -55282,6 +55285,7 @@ function OrbPreview({
                   onNavigate: handleNavigateEffect,
                   onNavigateBack: handleNavigateBack,
                   onLocalFallback: handleLocalFallback,
+                  localFallbackTimeoutMs,
                   persistence
                 }
               ) }) })

package/dist/runtime/index.d.cts

@@ -5,8 +5,8 @@ import * as _almadar_runtime from '@almadar/runtime';
 import { TraitState, TransitionResult, EffectHandlers } from '@almadar/runtime';
 import { K as KeyCaptureTable } from '../useKeyboardRouter-CVn8lfiX.cjs';
 import { c as useUISlots } from '../UISlotContext-BlRDbHDy.cjs';
-import { a as EntityBindingSource, h as ServerBridgeTransport, A as AccessTokenProvider } from '../EntityBindingContext-DoK8Xq71.cjs';
-export { b as EntitySchemaContextValue, c as EntitySchemaProvider, d as EntitySchemaProviderProps, e as ServerBridgeContextValue, f as ServerBridgeProvider, i as ServerClientEffect, T as TraitContext, k as TraitContextValue, l as TraitInstance, m as TraitProvider, n as TraitProviderProps, o as useEntitySchema, p as useEntitySchemaOptional, q as useServerBridge, r as useTrait, s as useTraitContext } from '../EntityBindingContext-DoK8Xq71.cjs';
+import { a as EntityBindingSource, h as ServerBridgeTransport, A as AccessTokenProvider } from '../EntityBindingContext-CTZw2DbY.cjs';
+export { b as EntitySchemaContextValue, c as EntitySchemaProvider, d as EntitySchemaProviderProps, e as ServerBridgeContextValue, f as ServerBridgeProvider, i as ServerClientEffect, T as TraitContext, k as TraitContextValue, l as TraitInstance, m as TraitProvider, n as TraitProviderProps, o as useEntitySchema, p as useEntitySchemaOptional, q as useServerBridge, r as useTrait, s as useTraitContext } from '../EntityBindingContext-CTZw2DbY.cjs';
 import '../verificationRegistry-DTrKDRoa.cjs';
 export { PERF_NAMESPACE, PerfEntry, PreparedPreviewSchema, adjustSchemaForMockData, buildMockData, clearPerf, perfEnd, perfStart, perfTime, prepareSchemaForPreview, wrapCallbackForEvent } from '@almadar/runtime/ui';
 import React__default, { ReactNode } from 'react';
@@ -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

@@ -5,8 +5,8 @@ import * as _almadar_runtime from '@almadar/runtime';
 import { TraitState, TransitionResult, EffectHandlers } from '@almadar/runtime';
 import { K as KeyCaptureTable } from '../useKeyboardRouter-B1pIi9jo.js';
 import { c as useUISlots } from '../UISlotContext-CB89mv7N.js';
-import { a as EntityBindingSource, h as ServerBridgeTransport, A as AccessTokenProvider } from '../EntityBindingContext-DoK8Xq71.js';
-export { b as EntitySchemaContextValue, c as EntitySchemaProvider, d as EntitySchemaProviderProps, e as ServerBridgeContextValue, f as ServerBridgeProvider, i as ServerClientEffect, T as TraitContext, k as TraitContextValue, l as TraitInstance, m as TraitProvider, n as TraitProviderProps, o as useEntitySchema, p as useEntitySchemaOptional, q as useServerBridge, r as useTrait, s as useTraitContext } from '../EntityBindingContext-DoK8Xq71.js';
+import { a as EntityBindingSource, h as ServerBridgeTransport, A as AccessTokenProvider } from '../EntityBindingContext-CTZw2DbY.js';
+export { b as EntitySchemaContextValue, c as EntitySchemaProvider, d as EntitySchemaProviderProps, e as ServerBridgeContextValue, f as ServerBridgeProvider, i as ServerClientEffect, T as TraitContext, k as TraitContextValue, l as TraitInstance, m as TraitProvider, n as TraitProviderProps, o as useEntitySchema, p as useEntitySchemaOptional, q as useServerBridge, r as useTrait, s as useTraitContext } from '../EntityBindingContext-CTZw2DbY.js';
 import '../verificationRegistry-Cwa52VyK.js';
 export { PERF_NAMESPACE, PerfEntry, PreparedPreviewSchema, adjustSchemaForMockData, buildMockData, clearPerf, perfEnd, perfStart, perfTime, prepareSchemaForPreview, wrapCallbackForEvent } from '@almadar/runtime/ui';
 import React__default, { ReactNode } from 'react';
@@ -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.js

@@ -54702,7 +54702,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 = useServerBridge();
   const activeTraitNames = useMemo(
     () => new Set(traits2.map((b) => b.trait.name).filter((n) => !!n)),
@@ -54769,9 +54769,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]);
   useEffect(() => {
     if (!bridge.connected || !orbitalNames?.length || initSentRef.current) return;
     initSentRef.current = true;
@@ -54825,7 +54825,7 @@ function FitToBox({ children }) {
   }, []);
   return /* @__PURE__ */ jsx("div", { ref: outerRef, className: "relative h-full w-full overflow-hidden", children: /* @__PURE__ */ 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 = useMemo(() => {
     let base;
@@ -54988,6 +54988,7 @@ function SchemaRunner({ schema, serverUrl, transport, getAccessToken, mockData,
           onNavigate,
           onNavigateBack,
           onLocalFallback,
+          localFallbackTimeoutMs,
           persistence,
           children: /* @__PURE__ */ jsx(OrbitalThemeProvider, { theme: activeOrbitalTheme, children: /* @__PURE__ */ jsx(Box, { className: "h-full min-h-full overflow-auto p-4", children: /* @__PURE__ */ jsx(UISlotRenderer, { includeHud: true, hudMode: "inline", includeFloating: true }) }) })
         }
@@ -55011,7 +55012,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");
@@ -55193,6 +55195,7 @@ function OrbPreview({
                   onNavigate: handleNavigateEffect,
                   onNavigateBack: handleNavigateBack,
                   onLocalFallback: handleLocalFallback,
+                  localFallbackTimeoutMs,
                   persistence
                 }
               ) }) : /* @__PURE__ */ jsx(
@@ -55208,6 +55211,7 @@ function OrbPreview({
                   onNavigate: handleNavigateEffect,
                   onNavigateBack: handleNavigateBack,
                   onLocalFallback: handleLocalFallback,
+                  localFallbackTimeoutMs,
                   persistence
                 }
               ) }) })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/ui",
-  "version": "6.21.0",
+  "version": "6.23.0",
   "description": "React UI components, hooks, and providers for Almadar",
   "type": "module",
   "sideEffects": [