@almadar/ui 6.56.0 → 6.58.0

package/dist/{chunk-FQM37C56.js → chunk-HB3D3HUJ.js}

@@ -1,18 +1,18 @@
-import { useTranslate, useRenderI18n, runTickFrame } from './chunk-QGH4NAQO.js';
+import { useTranslate, useRenderI18n, runTickFrame } from './chunk-N7JIG57B.js';
 import { ALL_SLOTS } from './chunk-VHTJRS2N.js';
-import { LoadingState, ErrorState, UISlotRenderer } from './chunk-XZKGRSIO.js';
-import { Box } from './chunk-Y53Q55H5.js';
-import { Typography } from './chunk-HCSJHRC4.js';
-import { beginPending, endPending } from './chunk-JRW33U35.js';
-import { useEventBus } from './chunk-6EV3OEBQ.js';
-import { registerTrait, unregisterTrait, perfTimeAsync } from './chunk-KQXXO42S.js';
+import { LoadingState, ErrorState, UISlotRenderer } from './chunk-I2ZNE5TD.js';
+import { Box } from './chunk-HA7CJWQX.js';
+import { Typography } from './chunk-4ZGXIW3B.js';
+import { beginPending, endPending } from './chunk-I5QOYW2Z.js';
+import { useEventBus } from './chunk-CHNC4UYE.js';
+import { registerTrait, unregisterTrait, perfTimeAsync } from './chunk-KJGVLXEN.js';
 import { bindTraitStateGetter, registerTraitSnapshot, recordTransition, recordingTransport, recordServerResponse } from './chunk-Q47ZN2DW.js';
 import { isNotificationSlot } from './chunk-PEST66PN.js';
-import React, { useState, useMemo, useEffect, useRef, useCallback, useSyncExternalStore } from 'react';
+import React, { createContext, useState, useMemo, useEffect, useRef, useCallback, useSyncExternalStore, useContext } from 'react';
 import { schemaToIR, getPage, clearSchemaCache as clearSchemaCache$1, traitsEmbeddedByEvent, traitReferencesCallsitePayload, configReferencesCallsitePayload, TRAIT_MOUNT_ERROR_TESTID, traitsEmbeddedByEffects, applyListenPayloadMapping, buildResolvedTraitConfigs, collectCallsiteCaptureChildren, orbitalInlineEntities, storesRowsInBrowser, walkSExpr, isRenderBindingMarker, containsEntityBinding, isSExpr, isEventPayloadValue, RENDER_BINDING_MARKER } from '@almadar/core';
 import { createLogger } from '@almadar/logger';
-import { collectListenerTargets, LIFECYCLE_EVENTS, TraitMountError, InMemoryPersistence, loadLazyPage, createInProcessTransport, buildTraitIndex, createMemoryCircuitStore, createLocalStoreTransport, createResidenceTransport, createClientKernel, createTickScheduler, isValidCronExpression, parseDurationString, UNMOUNT_EVENT, createClientEffectHandlers, EffectExecutor, isSExpression, collectDeclaredConfigDefaults, createContextFromBindings, openBrowserStore, browserStoreName, normalizeCallSiteConfigToValues } from '@almadar/runtime';
-import { useUser, useHasServerBridge, useArbitraryClassStyles, getAllPages, matchPathAmong, CurrentPagePathProvider, NavStackProvider, OrbitalProvider, ServerBridgeProvider, useNavStack, VerificationProvider, EntitySchemaProvider, OrbitalThemeProvider, useServerBridge, EntityBindingContext, AwaitingSkeletonContext } from '@almadar/ui/providers';
+import { collectListenerTargets, LIFECYCLE_EVENTS, TraitMountError, loadLazyPage, createInProcessTransport, buildTraitIndex, createMemoryCircuitStore, createLocalStoreTransport, createResidenceTransport, createClientKernel, createTickScheduler, isValidCronExpression, parseDurationString, UNMOUNT_EVENT, createClientEffectHandlers, EffectExecutor, isSExpression, collectDeclaredConfigDefaults, createContextFromBindings, openBrowserStore, browserStoreName, normalizeCallSiteConfigToValues } from '@almadar/runtime';
+import { useUser, useArbitraryClassStyles, getAllPages, matchPathAmong, CurrentPagePathProvider, NavStackProvider, OrbitalProvider, ServerBridgeProvider, useNavStack, VerificationProvider, EntitySchemaProvider, OrbitalThemeProvider, useServerBridge, EntityBindingContext, AwaitingSkeletonContext } from '@almadar/ui/providers';
 import { evaluateListenPayloadExpr, evaluate, createMinimalContext, evaluateGuard, executeEffects } from '@almadar/evaluator';
 import { getPatternDefinition } from '@almadar/core/patterns';
 import { isKnownStdOperator } from '@almadar/std/registry';
@@ -21,6 +21,7 @@ export { adjustSchemaForMockData, buildMockData, collectEmbeddedTraits, prepareS
 import { useInRouterContext, useHref } from 'react-router-dom';
 import { UISlotProvider, useUISlots } from '@almadar/ui/context';
 import { useTranslate as useTranslate$1, createTranslate, I18nProvider } from '@almadar/ui/hooks';
+import { InMemoryPersistence } from '@almadar/db/mock';
 import { jsx, jsxs } from 'react/jsx-runtime';
 import { OrbitalServerRuntime } from '@almadar/runtime/OrbitalServerRuntime';
 import { localeDirection } from '@almadar/core/i18n';
@@ -440,6 +441,22 @@ function useBusIngress(traitBindings, traitIndex, settle, eventBus, appTraitName
       });
       unsubscribes.push(unsub);
     }
+    const routedBareEvents = /* @__PURE__ */ new Set();
+    for (const binding of traitBindings) {
+      for (const listen of binding.trait.listens ?? []) {
+        if (listen.source !== void 0 && listen.source.kind !== "any") routedBareEvents.add(listen.event);
+      }
+    }
+    for (const eventKey of routedBareEvents) {
+      const unsub = eventBus.on(`UI:${eventKey}`, (event) => {
+        if (deliveredHere(event.source) || event.source?.trait === void 0) return;
+        for (const target of collectListenerTargets(traitIndex, event.source, eventKey, event.payload)) {
+          log2.debug("listen-bare:fire", { event: eventKey, source: event.source.trait, listener: target.listenerTrait, triggers: target.triggers });
+          dispatch(target.listenerTrait, target.triggers, target.payload, event.source);
+        }
+      });
+      unsubscribes.push(unsub);
+    }
     return () => {
       for (const unsub of unsubscribes) unsub();
     };
@@ -518,7 +535,7 @@ function resolveLambdaBindings(body, params, item, index) {
   return body;
 }
 var LazySlotContentRenderer = React.lazy(
-  () => import('./UISlotRenderer-QTHFT6Z4.js').then((m) => ({ default: m.SlotContentRenderer }))
+  () => import('./UISlotRenderer-N5DFYE6K.js').then((m) => ({ default: m.SlotContentRenderer }))
 );
 function deferLambdaEntityExprs(value) {
   if (typeof value === "string") {
@@ -953,6 +970,7 @@ function createSharedEntityWriter(binding, tick, traitStatesRef, emit, traitConf
 }
 function useClientTicks(traitBindings, store, traitIndex, options) {
   useEffect(() => {
+    if (options.hostRunsProgram === true) return;
     const scheduler = createTickScheduler();
     const traitStatesRef = { current: store.manager.getAllStates() };
     const refreshStates = () => {
@@ -1098,7 +1116,7 @@ function useClientTicks(traitBindings, store, traitIndex, options) {
       }
     }
     return () => scheduler.stopAll();
-  }, [traitBindings, store, traitIndex, options.eventBus, options.slotFlush, options.traitConfigsByName, options.navigate, options.navigateBack, options.user]);
+  }, [traitBindings, store, traitIndex, options.eventBus, options.slotFlush, options.traitConfigsByName, options.navigate, options.navigateBack, options.user, options.hostRunsProgram]);
 }
 var EMPTY_ENTITY = {};
 function useEntityBindingSource(store, traitIndex) {
@@ -1195,6 +1213,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
   useClientTicks(traitBindings, store, traitIndex, {
     eventBus,
     slotFlush,
+    hostRunsProgram: transport?.hostsBrowserStore === true,
     ...options.traitConfigsByName !== void 0 ? { traitConfigsByName: options.traitConfigsByName } : {},
     ...options.navigate !== void 0 ? { navigate: options.navigate } : {},
     ...options.navigateBack !== void 0 ? { navigateBack: options.navigateBack } : {},
@@ -1329,9 +1348,16 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
   useEffect(() => {
     if (!transport?.subscribe) return;
     return transport.subscribe((emitted, target) => {
-      for (const t2 of collectListenerTargets(traitIndex, emitted.source, emitted.event, emitted.payload)) {
-        void (target === "origin" ? progressAndSettle(t2.listenerTrait, t2.triggers, t2.payload) : dispatchAndSettle(t2.listenerTrait, t2.triggers, t2.payload));
+      const listeners = collectListenerTargets(traitIndex, emitted.source, emitted.event, emitted.payload);
+      if (target !== "origin") {
+        for (const t2 of listeners) void dispatchAndSettle(t2.listenerTrait, t2.triggers, t2.payload);
+        return;
       }
+      const caller = emitted.source?.trait;
+      if (caller !== void 0 && traitIndex.byName.has(caller) && !listeners.some((t2) => t2.listenerTrait === caller && t2.triggers === emitted.event)) {
+        void progressAndSettle(caller, emitted.event, emitted.payload);
+      }
+      for (const t2 of listeners) void progressAndSettle(t2.listenerTrait, t2.triggers, t2.payload);
     }, { clientId: getTabClientId() });
   }, [transport, traitIndex, progressAndSettle, dispatchAndSettle]);
   useEffect(() => {
@@ -1341,7 +1367,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
       if (traitName === void 0 || !traitIndex.byName.has(traitName)) return;
       const composedBefore = new Map(store.callsitePayloads);
       void kernel.foldHostDispatch(request, response).then((outcome) => settleOutcome(traitName, request.event, request.payload, outcome, composedBefore));
-    });
+    }, { clientId: getTabClientId() });
   }, [transport, traitIndex, kernel, store, settleOutcome]);
   const mountAndSettle = useCallback(async (seeds, payload) => {
     const composedBefore = new Map(store.callsitePayloads);
@@ -1402,6 +1428,13 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
     prevActiveTraitNamesRef.current = nextActiveTraitNames;
   }, [traitBindings, uiSlots]);
   const mountedRef = useRef(null);
+  const aliveRef = useRef(true);
+  useEffect(() => {
+    aliveRef.current = true;
+    return () => {
+      aliveRef.current = false;
+    };
+  }, []);
   const mountKey = `${options.mountKey ?? ""}\0${JSON.stringify(Object.entries(options.initPayload ?? {}).sort(([a], [b]) => a.localeCompare(b)))}`;
   useEffect(() => {
     const prev = mountedRef.current;
@@ -1432,6 +1465,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
         const failed = err instanceof TraitMountError ? err.trait : traits.join(", ");
         const cause = err instanceof TraitMountError ? err.original : err;
         stateLog.warn("mount:failed", { traits, failed, error: message, stack: cause instanceof Error ? cause.stack : void 0 });
+        if (!aliveRef.current) return;
         uiSlots.render({
           target: "main",
           pattern: "error-state",
@@ -1560,6 +1594,7 @@ function TraitInitializer({ traits, routeParams, mountKey, orbitals, onNavigate,
 }
 var CONTENT_STAGE_WIDTH = 480;
 var NO_ORBITALS = [];
+var LazyPageOfRegisteredProgram = createContext(false);
 function FitToBox({ children, mode = "box" }) {
   const outerRef = useRef(null);
   const innerRef = useRef(null);
@@ -1789,6 +1824,17 @@ function resolvePreviewTheme(schema, pageName) {
   }
   return schema.orbitals[0]?.theme ?? schema.theme;
 }
+function NavigateListener({ onNavigate }) {
+  const bus = useEventBus();
+  useEffect(
+    () => bus.on("UI:NAVIGATE", (event) => {
+      const url = event.payload?.url;
+      if (typeof url === "string" && url.length > 0) onNavigate(url);
+    }),
+    [bus, onNavigate]
+  );
+  return null;
+}
 function OrbPreview({
   schema,
   mockData,
@@ -1814,14 +1860,13 @@ function OrbPreview({
   }
   const { t } = useTranslate$1();
   const [localFallback, setLocalFallback] = useState(false);
-  const eventBus = useEventBus();
   const inHostRouter = useInRouterContext();
   const [hostHrefBase, setHostHrefBase] = useState("/");
   const handleLocalFallback = useCallback(() => {
     if (localFallback) return;
     setLocalFallback(true);
   }, [localFallback]);
-  const hasOuterBridge = useHasServerBridge();
+  const isLazyPageOfRegisteredProgram = useContext(LazyPageOfRegisteredProgram);
   const parseResult = useMemo(() => {
     let parsed;
     if (typeof schema === "string") {
@@ -1968,15 +2013,6 @@ function OrbPreview({
   const handleNavigateBack = useCallback(() => {
     navStackRef.current?.back();
   }, []);
-  useEffect(() => {
-    const unsubscribe = eventBus.on("UI:NAVIGATE", (event) => {
-      const url = event.payload?.url;
-      if (typeof url === "string" && url.length > 0) {
-        handleNavigate(url);
-      }
-    });
-    return unsubscribe;
-  }, [eventBus, handleNavigate]);
   if (!parseResult.ok) {
     return /* @__PURE__ */ jsx(Box, { className, style: { height }, children: /* @__PURE__ */ jsxs(Typography, { as: "pre", color: "error", variant: "small", className: "font-mono whitespace-pre-wrap break-all m-0 p-4", children: [
       "Parse error: ",
@@ -2022,13 +2058,13 @@ function OrbPreview({
     navLog.info("interceptor:installed", { pageCount: pages.length, paths: pages.map((p) => p.page.path) });
     return () => el.removeEventListener("click", handler, true);
   }, [pages, handleNavigate, isolated, hostHrefBase]);
-  const withBridge = (node) => (serverUrl || transport) && !hasOuterBridge ? /* @__PURE__ */ jsx(ServerBridgeProvider, { schema: parseResult.schema, serverUrl, transport, getAccessToken, children: node }) : node;
+  const withBridge = (node) => (serverUrl || transport) && !isLazyPageOfRegisteredProgram ? /* @__PURE__ */ jsx(ServerBridgeProvider, { schema: parseResult.schema, serverUrl, transport, getAccessToken, children: node }) : node;
   if (lazyRoute) {
     return withBridge(
       /* @__PURE__ */ jsxs(Box, { ref: containerRef, className: `overflow-auto ${className ?? ""}`, style: { height }, children: [
         lazyLoad.status === "loading" && /* @__PURE__ */ jsx(LoadingState, {}),
         lazyLoad.status === "error" && /* @__PURE__ */ jsx(ErrorState, { "data-testid": "lazy-page-error", message: lazyLoad.error }),
-        lazyLoad.status === "ready" && /* @__PURE__ */ jsx(
+        lazyLoad.status === "ready" && /* @__PURE__ */ jsx(LazyPageOfRegisteredProgram.Provider, { value: true, children: /* @__PURE__ */ jsx(
           OrbPreview,
           {
             schema: lazyLoad.schema,
@@ -2048,7 +2084,7 @@ function OrbPreview({
             onUnmatchedNavigate: handleNavigate
           },
           lazyRoute.page.orbRef
-        )
+        ) })
       ] })
     );
   }
@@ -2071,41 +2107,44 @@ function OrbPreview({
               storageKey: `almadar:navstack:${parseResult.schema.name ?? "preview"}`,
               children: [
                 /* @__PURE__ */ jsx(NavStackRefBridge, { apiRef: navStackRef }),
-                /* @__PURE__ */ jsx(OrbitalProvider, { initialData: effectiveMockData, skipTheme: true, verification: true, isolated, user, children: /* @__PURE__ */ jsx(UISlotProvider, { children: fit ? /* @__PURE__ */ jsx(FitToBox, { mode: fit === "content" ? "content" : "box", children: /* @__PURE__ */ jsx(
-                  SchemaRunner,
-                  {
-                    schema: parseResult.schema,
-                    serverUrl,
-                    transport,
-                    getAccessToken,
-                    mockData: effectiveMockData,
-                    pageName: currentPage,
-                    routeParams,
-                    onNavigate: handleNavigateEffect,
-                    onNavigateBack: handleNavigateBack,
-                    onLocalFallback: handleLocalFallback,
-                    localFallbackTimeoutMs,
-                    persistence,
-                    themeOverride
-                  }
-                ) }) : /* @__PURE__ */ jsx(
-                  SchemaRunner,
-                  {
-                    schema: parseResult.schema,
-                    serverUrl,
-                    transport,
-                    getAccessToken,
-                    mockData: effectiveMockData,
-                    pageName: currentPage,
-                    routeParams,
-                    onNavigate: handleNavigateEffect,
-                    onNavigateBack: handleNavigateBack,
-                    onLocalFallback: handleLocalFallback,
-                    localFallbackTimeoutMs,
-                    persistence,
-                    themeOverride
-                  }
-                ) }) })
+                /* @__PURE__ */ jsxs(OrbitalProvider, { initialData: effectiveMockData, skipTheme: true, verification: true, isolated, user, children: [
+                  /* @__PURE__ */ jsx(NavigateListener, { onNavigate: handleNavigate }),
+                  /* @__PURE__ */ jsx(UISlotProvider, { children: fit ? /* @__PURE__ */ jsx(FitToBox, { mode: fit === "content" ? "content" : "box", children: /* @__PURE__ */ jsx(
+                    SchemaRunner,
+                    {
+                      schema: parseResult.schema,
+                      serverUrl,
+                      transport,
+                      getAccessToken,
+                      mockData: effectiveMockData,
+                      pageName: currentPage,
+                      routeParams,
+                      onNavigate: handleNavigateEffect,
+                      onNavigateBack: handleNavigateBack,
+                      onLocalFallback: handleLocalFallback,
+                      localFallbackTimeoutMs,
+                      persistence,
+                      themeOverride
+                    }
+                  ) }) : /* @__PURE__ */ jsx(
+                    SchemaRunner,
+                    {
+                      schema: parseResult.schema,
+                      serverUrl,
+                      transport,
+                      getAccessToken,
+                      mockData: effectiveMockData,
+                      pageName: currentPage,
+                      routeParams,
+                      onNavigate: handleNavigateEffect,
+                      onNavigateBack: handleNavigateBack,
+                      onLocalFallback: handleLocalFallback,
+                      localFallbackTimeoutMs,
+                      persistence,
+                      themeOverride
+                    }
+                  ) })
+                ] })
               ]
             }
           ) })
@@ -2142,21 +2181,28 @@ function BrowserPlayground({
       runtime.resumeTicks();
     }
   }, [runtime, paused]);
-  const registrationReady = useMemo(() => {
-    const orbitalNames = schema.orbitals.map((o) => o.name);
-    playgroundLog.debug("register:start", { schema: schema.name, orbitalNames });
+  const lazySchemas = useMemo(() => {
     const lazyPages = schema.lazyPages ?? [];
-    const lazy = lazyPages.length > 0 && lazyLoader !== void 0 ? Promise.all(lazyPages.map(async (page) => {
+    if (lazyPages.length === 0 || lazyLoader === void 0) return Promise.resolve([]);
+    return Promise.all(lazyPages.map(async (page) => {
       const loaded = await loadLazyPage(lazyLoader, page, schemaPath);
       if (!loaded.success) throw new Error(loaded.error);
       return loaded.data;
-    })) : Promise.resolve([]);
-    return lazy.then(
-      (lazySchemas) => runtime.register(schema, { ...messages !== void 0 ? { messages } : {}, lazy: lazySchemas })
-    ).then(() => {
-      playgroundLog.debug("register:done", { schema: schema.name, orbitalNames });
+    }));
+  }, [schema.lazyPages, lazyLoader, schemaPath]);
+  const registerProgram = useCallback((program) => {
+    const orbitalNames = program.orbitals.map((o) => o.name);
+    playgroundLog.debug("register:start", { schema: program.name, orbitalNames });
+    return lazySchemas.then((lazy) => runtime.register(program, { ...messages !== void 0 ? { messages } : {}, lazy })).then(() => {
+      playgroundLog.debug("register:done", { schema: program.name, orbitalNames });
     });
-  }, [runtime, schema, messages, lazyLoader, schemaPath]);
+  }, [runtime, lazySchemas, messages]);
+  const latestRegistration = useRef(Promise.resolve());
+  const registrationReady = useMemo(() => {
+    const ready = registerProgram(schema);
+    latestRegistration.current = ready;
+    return ready;
+  }, [registerProgram, schema]);
   const teardownTimerRef = useRef(null);
   useEffect(() => {
     if (teardownTimerRef.current !== null) {
@@ -2174,24 +2220,28 @@ function BrowserPlayground({
   const transport = useMemo(
     () => createInProcessTransport(
       async (orbitalName, request) => {
-        await registrationReady;
+        await latestRegistration.current;
         return runtime.processOrbitalEvent(orbitalName, request);
       },
       {
-        // The program (lazy behaviors included) is registered above; the bridge only waits for it.
-        onRegister: () => registrationReady,
+        // Registers what the bridge hands over (lazy behaviors included): a bridge that unregistered first gets it back.
+        onRegister: (program) => {
+          const ready = registerProgram(program);
+          latestRegistration.current = ready;
+          return ready;
+        },
         onUnregister: () => {
           runtime.unregisterAll();
         }
       }
     ),
-    [runtime, registrationReady]
+    [runtime, registerProgram, registrationReady]
   );
   const viewerLocale = locale ?? schema.locales?.[0];
   const i18n = useMemo(() => {
     if (viewerLocale === void 0 || messages === void 0) return void 0;
     const catalog = messages[viewerLocale] ?? {};
-    return { locale: viewerLocale, direction: localeDirection(viewerLocale), t: createTranslate(catalog), messages: catalog };
+    return { locale: viewerLocale, direction: localeDirection(viewerLocale), t: createTranslate(catalog, viewerLocale), messages: catalog };
   }, [viewerLocale, messages]);
   const preview = /* @__PURE__ */ jsx(
     OrbPreview,