@almadar/ui 6.57.0 → 6.58.0

package/dist/{AwaitingSkeletonContext-DPgW__WV.d.ts → AwaitingSkeletonContext-Bh399p1x.d.ts}

@@ -108,8 +108,6 @@ interface ServerBridgeContextValue {
  */
 type ServerBridgeTransport = EventTransport;
 
-/** Whether a `ServerBridgeProvider` is already above — a nested preview (a lazy page) reuses its registration. */
-declare function useHasServerBridge(): boolean;
 /**
  * Access the server bridge. Returns a no-op stub when outside the provider —
  * `useCircuitKernel` treats an absent/no-op transport as offline (plan G7).
@@ -230,4 +228,4 @@ declare function useAwaitingSkeleton(target: {
     trait: string;
 }): SkeletonNode | undefined;
 
-export { type AwaitingSkeletonSource as A, type EntityBindingSource as E, type ServerBridgeTransport as S, TraitContext as T, type EntitySchemaContextValue as a, EntitySchemaProvider as b, type EntitySchemaProviderProps as c, type ServerBridgeContextValue as d, ServerBridgeProvider as e, type TraitContextValue as f, type TraitInstance as g, TraitProvider as h, type TraitProviderProps as i, useEntitySchemaOptional as j, useServerBridge as k, useTrait as l, useTraitContext as m, AwaitingSkeletonContext as n, EntityBindingContext as o, type ServerBridgeProviderProps as p, useAwaitingSkeleton as q, useEntityBindingSnapshot as r, useHasServerBridge as s, useEntitySchema as u };
+export { type AwaitingSkeletonSource as A, type EntityBindingSource as E, type ServerBridgeTransport as S, TraitContext as T, type EntitySchemaContextValue as a, EntitySchemaProvider as b, type EntitySchemaProviderProps as c, type ServerBridgeContextValue as d, ServerBridgeProvider as e, type TraitContextValue as f, type TraitInstance as g, TraitProvider as h, type TraitProviderProps as i, useEntitySchemaOptional as j, useServerBridge as k, useTrait as l, useTraitContext as m, AwaitingSkeletonContext as n, EntityBindingContext as o, type ServerBridgeProviderProps as p, useAwaitingSkeleton as q, useEntityBindingSnapshot as r, useEntitySchema as u };

package/dist/{Canvas3DHost-DfAhg6EH.d.ts → Canvas3DHost-BTvRPfsr.d.ts}

@@ -1,7 +1,7 @@
 import { AnimationName, Asset, ScenePos, EventEmit, EventKey } from '@almadar/core';
 import React__default from 'react';
 import * as THREE from 'three';
-import { D as DrawableNode } from './paintDispatch-_6EhJCiL.js';
+import { D as DrawableNode } from './paintDispatch-BN8Vbzgs.js';
 
 /**
  * Sprite Sheet Animation Types

package/dist/{GameAudioProvider-DyBvYP2c.d.ts → GameAudioProvider-kXbonWTv.d.ts}

@@ -1,6 +1,6 @@
 import React__default from 'react';
 import { AudioManifest } from '@almadar/core';
-import { U as UiError } from './paintDispatch-_6EhJCiL.js';
+import { U as UiError } from './paintDispatch-BN8Vbzgs.js';
 
 /** Core owns the sound-manifest shape (`@almadar/core` `types/asset.ts`) so the
  *  pattern extractor and the generated `.lolo` factories resolve the same

package/dist/{UISlotRenderer-NCGDIXN4.js → UISlotRenderer-N5DFYE6K.js}

@@ -1,4 +1,4 @@
-export { SlotContainedContext, SlotContentRenderer, SuspenseConfigProvider, UISlotComponent, UISlotRenderer, renderPatternValue } from './chunk-PYJ2UQWM.js';
+export { SlotContainedContext, SlotContentRenderer, SuspenseConfigProvider, UISlotComponent, UISlotRenderer, renderPatternValue } from './chunk-I2ZNE5TD.js';
 import './chunk-HA7CJWQX.js';
 import './chunk-4ZGXIW3B.js';
 import './chunk-I5QOYW2Z.js';

package/dist/avl/index.cjs

@@ -78,6 +78,7 @@ var utilities = require('@dnd-kit/utilities');
 var emojilib = require('emojilib');
 var d3Force = require('d3-force');
 var OrbitalServerRuntime = require('@almadar/runtime/OrbitalServerRuntime');
+var mock = require('@almadar/db/mock');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
@@ -17004,6 +17005,7 @@ var init_Tabs = __esm({
         }
       };
       const activeTabContent = safeItems.find((item) => item.id === activeTab)?.content;
+      const rendersPanel = activeTabContent !== void 0 && activeTabContent !== null;
       if (safeItems.length === 0) {
         return /* @__PURE__ */ jsxRuntime.jsx(Box, { ...domPassthrough(rest), className: cn("w-full", className), children: /* @__PURE__ */ jsxRuntime.jsx(Typography, { variant: "small", color: "muted", className: "py-4", children: t("empty.noItems") }) });
       }
@@ -17054,7 +17056,7 @@ var init_Tabs = __esm({
                 id: tabId(item.id),
                 role: "tab",
                 "aria-selected": isActive,
-                "aria-controls": isActive ? panelId(item.id) : void 0,
+                "aria-controls": isActive && rendersPanel ? panelId(item.id) : void 0,
                 "aria-disabled": isDisabled,
                 tabIndex: isActive ? 0 : -1,
                 onClick: () => !isDisabled && handleTabChange(item.id, item.event),
@@ -17114,7 +17116,7 @@ var init_Tabs = __esm({
             )
           ] })
         ] }) : tablist,
-        activeTabContent !== void 0 && activeTabContent !== null && /* @__PURE__ */ jsxRuntime.jsx(
+        rendersPanel && /* @__PURE__ */ jsxRuntime.jsx(
           Box,
           {
             role: "tabpanel",
@@ -35137,8 +35139,11 @@ function DataGrid({
                   children: [
                     imageField && (() => {
                       const imgUrl = resolveImageUrl(core.getNestedValue(itemData, imageField));
-                      if (!imgUrl) return null;
-                      return /* @__PURE__ */ jsxRuntime.jsx(Box, { className: asRows ? "w-12 h-12 flex-shrink-0 overflow-hidden rounded-container" : "w-full aspect-video overflow-hidden rounded-t-container", children: /* @__PURE__ */ jsxRuntime.jsx(
+                      const mediaClass = asRows ? "w-12 h-12 flex-shrink-0 overflow-hidden rounded-container" : "w-full aspect-video overflow-hidden rounded-t-container";
+                      if (!imgUrl) {
+                        return /* @__PURE__ */ jsxRuntime.jsx(Box, { "data-media-placeholder": true, "aria-hidden": "true", className: cn(mediaClass, "flex items-center justify-center bg-muted text-muted-foreground"), children: /* @__PURE__ */ jsxRuntime.jsx(Icon, { name: "image", size: asRows ? "sm" : "lg" }) });
+                      }
+                      return /* @__PURE__ */ jsxRuntime.jsx(Box, { className: mediaClass, children: /* @__PURE__ */ jsxRuntime.jsx(
                         "img",
                         {
                           src: imgUrl,
@@ -35171,7 +35176,7 @@ function DataGrid({
                                 Typography,
                                 {
                                   variant: titleField?.variant === "h3" && !asRows ? "h3" : "h4",
-                                  className: "font-semibold truncate min-w-0",
+                                  className: cn("font-semibold min-w-0", asRows ? "truncate" : "line-clamp-2 break-words"),
                                   children: titleDisplay
                                 }
                               )
@@ -35300,24 +35305,33 @@ var init_DataGrid = __esm({
     DataGrid.displayName = "DataGrid";
   }
 });
-function renderIconInput2(icon, props) {
-  return typeof icon === "string" ? /* @__PURE__ */ jsxRuntime.jsx(Icon, { name: icon, ...props }) : /* @__PURE__ */ jsxRuntime.jsx(Icon, { icon, ...props });
-}
-function formatValue2(value, format, fmt2, relationOptions) {
-  const relationDisplay = resolveRelationCellDisplay(value, relationOptions);
-  if (relationDisplay !== void 0) return relationDisplay;
-  return formatValue(value, format, fmt2);
-}
-function groupData(items, field) {
+
+// lib/groupRows.ts
+function groupRows(items, field, format, fmt2 = {}) {
   const groups = /* @__PURE__ */ new Map();
   for (const item of items) {
-    const key = String(core.getNestedValue(item, field) ?? "");
+    const raw = core.getNestedValue(item, field);
+    const key = format ? formatValue(raw ?? void 0, format, fmt2) : String(raw ?? "");
     const group = groups.get(key);
     if (group) group.push(item);
     else groups.set(key, [item]);
   }
   return Array.from(groups.entries()).map(([label, groupItems]) => ({ label, items: groupItems }));
 }
+var init_groupRows = __esm({
+  "lib/groupRows.ts"() {
+    init_format();
+    init_getNestedValue();
+  }
+});
+function renderIconInput2(icon, props) {
+  return typeof icon === "string" ? /* @__PURE__ */ jsxRuntime.jsx(Icon, { name: icon, ...props }) : /* @__PURE__ */ jsxRuntime.jsx(Icon, { icon, ...props });
+}
+function formatValue2(value, format, fmt2, relationOptions) {
+  const relationDisplay = resolveRelationCellDisplay(value, relationOptions);
+  if (relationDisplay !== void 0) return relationDisplay;
+  return formatValue(value, format, fmt2);
+}
 function DataList({
   entity,
   fields,
@@ -35328,6 +35342,7 @@ function DataList({
   gap = "none",
   variant = "default",
   groupBy,
+  groupFormat,
   senderField,
   senderLabelField,
   currentUser,
@@ -35435,9 +35450,9 @@ function DataList({
     e.stopPropagation();
     fireRowAction(action, itemData, String(itemData.id ?? ""));
   };
-  const renderItemActions = (itemData, onPrimary = false) => {
+  const renderItemActions = (itemData, onPrimary = false, only) => {
     if (!itemActions || itemActions.length === 0) return null;
-    const shown = rowActions(itemActions, itemData);
+    const shown = only ?? rowActions(itemActions, itemData);
     if (shown.length === 0) return null;
     const inline = maxInlineActions != null ? shown.slice(0, maxInlineActions) : shown;
     const overflow = maxInlineActions != null ? shown.slice(maxInlineActions) : [];
@@ -35521,7 +35536,7 @@ function DataList({
   const isMessage = variant === "message";
   if (isMessage) {
     const items2 = [...data];
-    const groups2 = groupBy ? groupData(items2, groupBy) : [{ label: "", items: items2 }];
+    const groups2 = groupBy ? groupRows(items2, groupBy, groupFormat, fmt2) : [{ label: "", items: items2 }];
     const contentField = (fieldDefs.find((f3) => f3.variant === "body") ?? titleField)?.name ?? "";
     const senderLabel = (itemData, raw) => {
       if (!senderLabelField) return raw;
@@ -35618,7 +35633,7 @@ function DataList({
     ] });
   }
   const items = [...data];
-  const groups = groupBy ? groupData(items, groupBy) : [{ label: "", items }];
+  const groups = groupBy ? groupRows(items, groupBy, groupFormat, fmt2) : [{ label: "", items }];
   const idFieldName = dndItemIdField ?? "id";
   const renderItem = (itemData, index, isLast) => {
     const dndId = itemData[idFieldName] ?? `__idx_${index}`;
@@ -35629,7 +35644,11 @@ function DataList({
     const divider = (isCard || isCompact) && !isLast ? /* @__PURE__ */ jsxRuntime.jsx(Box, { className: cn("border-b border-border/40", isCompact ? "mx-4" : "mx-6") }) : null;
     if (hasRenderProp) {
       const id2 = itemData.id || String(index);
-      const actions = renderItemActions(itemData);
+      const allActions = itemActions ? rowActions(itemActions, itemData) : [];
+      const primaryActions = allActions.filter((a) => a.variant === "primary");
+      const otherActions = allActions.filter((a) => a.variant !== "primary");
+      const primary = primaryActions.length > 0 ? renderItemActions(itemData, false, primaryActions) : null;
+      const actions = otherActions.length > 0 ? renderItemActions(itemData, false, otherActions) : null;
       return wrapDnd(
         /* @__PURE__ */ jsxRuntime.jsxs(
           Box,
@@ -35650,6 +35669,7 @@ function DataList({
                 }
               ),
               /* @__PURE__ */ jsxRuntime.jsx(Box, { className: cn(onOpen && "relative"), children: itemRenderer(itemData, index) }),
+              primary && /* @__PURE__ */ jsxRuntime.jsx(HStack, { justify: "end", className: cn("relative px-4 pb-3", STRETCHED_ABOVE), children: primary }),
               actions && /* @__PURE__ */ jsxRuntime.jsxs(Box, { onClick: (e) => e.stopPropagation(), className: "absolute top-2 right-2 z-10 opacity-0 group-hover/rowactions:opacity-100 focus-within:opacity-100 [@media(pointer:coarse)]:opacity-100 transition-opacity duration-fast", children: [
                 /* @__PURE__ */ jsxRuntime.jsx(Box, { className: "rounded-container border border-border bg-card/95 backdrop-blur-sm shadow-elevation-popover surface-material p-0.5 [@media(pointer:coarse)]:hidden", children: actions }),
                 /* @__PURE__ */ jsxRuntime.jsx(Box, { className: "hidden [@media(pointer:coarse)]:block rounded-container border border-border bg-card/95 backdrop-blur-sm shadow-elevation-popover surface-material p-0.5", children: /* @__PURE__ */ jsxRuntime.jsx(
@@ -35657,7 +35677,7 @@ function DataList({
                   {
                     position: "bottom-end",
                     trigger: /* @__PURE__ */ jsxRuntime.jsx(Button, { variant: "ghost", size: "sm", "aria-label": t("common.actions"), "data-testid": "action-overflow", children: /* @__PURE__ */ jsxRuntime.jsx(Icon, { name: "more-horizontal", size: "xs" }) }),
-                    items: rowActions(itemActions ?? [], itemData).map((action) => ({
+                    items: otherActions.map((action) => ({
                       label: action.label,
                       icon: action.icon,
                       variant: action.variant === "danger" ? "danger" : "default",
@@ -35848,6 +35868,7 @@ var init_DataList = __esm({
     init_format();
     init_relationLabel();
     init_getNestedValue();
+    init_groupRows();
     init_useEventBus();
     init_useRowActions();
     init_Box();
@@ -36282,7 +36303,7 @@ var init_MapView = __esm({
         shadowSize: [41, 41]
       });
       L.Marker.prototype.options.icon = defaultIcon;
-      const { useEffect: useEffect85, useRef: useRef90, useCallback: useCallback108, useState: useState120 } = React96__namespace.default;
+      const { useEffect: useEffect85, useRef: useRef90, useCallback: useCallback109, useState: useState120 } = React96__namespace.default;
       const { Typography: Typography2 } = await Promise.resolve().then(() => (init_Typography(), Typography_exports));
       const { useEventBus: useEventBus2 } = await Promise.resolve().then(() => (init_useEventBus(), useEventBus_exports));
       function MapUpdater({ centerLat, centerLng, zoom }) {
@@ -36331,7 +36352,7 @@ var init_MapView = __esm({
         const contentSurface = providers.useContentSurface(surface);
         const eventBus = useEventBus2();
         const [clickedPosition, setClickedPosition] = useState120(null);
-        const handleMapClick = useCallback108((lat, lng) => {
+        const handleMapClick = useCallback109((lat, lng) => {
           if (showClickedPin) {
             setClickedPosition({ lat, lng });
           }
@@ -36340,7 +36361,7 @@ var init_MapView = __esm({
             eventBus.emit(`UI:${mapClickEvent}`, { latitude: lat, longitude: lng });
           }
         }, [onMapClick, mapClickEvent, eventBus, showClickedPin]);
-        const handleMarkerClick = useCallback108((marker) => {
+        const handleMarkerClick = useCallback109((marker) => {
           onMarkerClick?.(marker);
           if (markerClickEvent) {
             eventBus.emit(`UI:${markerClickEvent}`, { ...marker });
@@ -36941,16 +36962,6 @@ function asFieldValue(v) {
   if (t === "object") return v;
   return void 0;
 }
-function groupData2(items, field) {
-  const groups = /* @__PURE__ */ new Map();
-  for (const item of items) {
-    const key = String(core.getNestedValue(item, field) ?? "");
-    const group = groups.get(key);
-    if (group) group.push(item);
-    else groups.set(key, [item]);
-  }
-  return Array.from(groups.entries()).map(([label, groupItems]) => ({ label, items: groupItems }));
-}
 function TableView({
   entity,
   columns,
@@ -37261,7 +37272,7 @@ function TableView({
     return dnd.isZone ? /* @__PURE__ */ jsxRuntime.jsx(dnd.SortableItem, { id: row[idField] ?? id, children: rowInner }, id) : /* @__PURE__ */ jsxRuntime.jsx(React96__namespace.default.Fragment, { children: rowInner }, id);
   };
   const items = Array.from(data);
-  const groups = groupBy ? groupData2(items, groupBy) : [{ label: "", items }];
+  const groups = groupBy ? groupRows(items, groupBy) : [{ label: "", items }];
   let runningIndex = 0;
   const body = /* @__PURE__ */ jsxRuntime.jsx(Box, { role: "rowgroup", children: groups.map((group, gi) => /* @__PURE__ */ jsxRuntime.jsxs(React96__namespace.default.Fragment, { children: [
     group.label && /* @__PURE__ */ jsxRuntime.jsx(Divider, { label: group.label, className: gi > 0 ? "mt-3" : "mt-0" }),
@@ -37300,6 +37311,7 @@ var init_TableView = __esm({
     init_format();
     init_relationLabel();
     init_getNestedValue();
+    init_groupRows();
     init_useEventBus();
     init_useRowActions();
     init_Box();
@@ -64609,6 +64621,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 runtime.collectListenerTargets(traitIndex, event.source, eventKey, event.payload)) {
+          log13.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();
     };
@@ -65519,9 +65547,16 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
   React96.useEffect(() => {
     if (!transport?.subscribe) return;
     return transport.subscribe((emitted, target) => {
-      for (const t2 of runtime.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 listeners7 = runtime.collectListenerTargets(traitIndex, emitted.source, emitted.event, emitted.payload);
+      if (target !== "origin") {
+        for (const t2 of listeners7) void dispatchAndSettle(t2.listenerTrait, t2.triggers, t2.payload);
+        return;
       }
+      const caller = emitted.source?.trait;
+      if (caller !== void 0 && traitIndex.byName.has(caller) && !listeners7.some((t2) => t2.listenerTrait === caller && t2.triggers === emitted.event)) {
+        void progressAndSettle(caller, emitted.event, emitted.payload);
+      }
+      for (const t2 of listeners7) void progressAndSettle(t2.listenerTrait, t2.triggers, t2.payload);
     }, { clientId: getTabClientId() });
   }, [transport, traitIndex, progressAndSettle, dispatchAndSettle]);
   React96.useEffect(() => {
@@ -65531,7 +65566,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 = React96.useCallback(async (seeds, payload) => {
     const composedBefore = new Map(store.callsitePayloads);
@@ -65592,6 +65627,13 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
     prevActiveTraitNamesRef.current = nextActiveTraitNames;
   }, [traitBindings, uiSlots]);
   const mountedRef = React96.useRef(null);
+  const aliveRef = React96.useRef(true);
+  React96.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)))}`;
   React96.useEffect(() => {
     const prev = mountedRef.current;
@@ -65622,6 +65664,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
         const failed = err instanceof runtime.TraitMountError ? err.trait : traits2.join(", ");
         const cause = err instanceof runtime.TraitMountError ? err.original : err;
         stateLog.warn("mount:failed", { traits: traits2, failed, error: message, stack: cause instanceof Error ? cause.stack : void 0 });
+        if (!aliveRef.current) return;
         uiSlots.render({
           target: "main",
           pattern: "error-state",
@@ -65754,6 +65797,7 @@ function TraitInitializer({ traits: traits2, routeParams, mountKey, orbitals, on
 }
 var CONTENT_STAGE_WIDTH = 480;
 var NO_ORBITALS = [];
+var LazyPageOfRegisteredProgram = React96.createContext(false);
 function FitToBox({ children, mode = "box" }) {
   const outerRef = React96.useRef(null);
   const innerRef = React96.useRef(null);
@@ -66025,7 +66069,7 @@ function OrbPreview({
     if (localFallback) return;
     setLocalFallback(true);
   }, [localFallback]);
-  const hasOuterBridge = providers.useHasServerBridge();
+  const isLazyPageOfRegisteredProgram = React96.useContext(LazyPageOfRegisteredProgram);
   const parseResult = React96.useMemo(() => {
     let parsed;
     if (typeof schema === "string") {
@@ -66049,7 +66093,7 @@ function OrbPreview({
   const persistence = React96.useMemo(() => {
     if (!parsedSchema || serverUrl || transport) return void 0;
     if (!autoMock) return void 0;
-    const adapter = new runtime.InMemoryPersistence();
+    const adapter = new mock.InMemoryPersistence();
     adapter.seed(effectiveMockData);
     return adapter;
   }, [parsedSchema, serverUrl, transport, autoMock, effectiveMockData]);
@@ -66217,13 +66261,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__ */ jsxRuntime.jsx(providers.ServerBridgeProvider, { schema: parseResult.schema, serverUrl, transport, getAccessToken, children: node }) : node;
+  const withBridge = (node) => (serverUrl || transport) && !isLazyPageOfRegisteredProgram ? /* @__PURE__ */ jsxRuntime.jsx(providers.ServerBridgeProvider, { schema: parseResult.schema, serverUrl, transport, getAccessToken, children: node }) : node;
   if (lazyRoute) {
     return withBridge(
       /* @__PURE__ */ jsxRuntime.jsxs(Box, { ref: containerRef, className: `overflow-auto ${className ?? ""}`, style: { height }, children: [
         lazyLoad.status === "loading" && /* @__PURE__ */ jsxRuntime.jsx(LoadingState, {}),
         lazyLoad.status === "error" && /* @__PURE__ */ jsxRuntime.jsx(ErrorState, { "data-testid": "lazy-page-error", message: lazyLoad.error }),
-        lazyLoad.status === "ready" && /* @__PURE__ */ jsxRuntime.jsx(
+        lazyLoad.status === "ready" && /* @__PURE__ */ jsxRuntime.jsx(LazyPageOfRegisteredProgram.Provider, { value: true, children: /* @__PURE__ */ jsxRuntime.jsx(
           OrbPreview,
           {
             schema: lazyLoad.schema,
@@ -66243,7 +66287,7 @@ function OrbPreview({
             onUnmatchedNavigate: handleNavigate
           },
           lazyRoute.page.orbRef
-        )
+        ) })
       ] })
     );
   }
@@ -66340,21 +66384,28 @@ function BrowserPlayground({
       runtime$1.resumeTicks();
     }
   }, [runtime$1, paused]);
-  const registrationReady = React96.useMemo(() => {
-    const orbitalNames = schema.orbitals.map((o) => o.name);
-    playgroundLog.debug("register:start", { schema: schema.name, orbitalNames });
+  const lazySchemas = React96.useMemo(() => {
     const lazyPages = schema.lazyPages ?? [];
-    const lazy6 = 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 runtime.loadLazyPage(lazyLoader, page, schemaPath);
       if (!loaded.success) throw new Error(loaded.error);
       return loaded.data;
-    })) : Promise.resolve([]);
-    return lazy6.then(
-      (lazySchemas) => runtime$1.register(schema, { ...messages !== void 0 ? { messages } : {}, lazy: lazySchemas })
-    ).then(() => {
-      playgroundLog.debug("register:done", { schema: schema.name, orbitalNames });
+    }));
+  }, [schema.lazyPages, lazyLoader, schemaPath]);
+  const registerProgram = React96.useCallback((program) => {
+    const orbitalNames = program.orbitals.map((o) => o.name);
+    playgroundLog.debug("register:start", { schema: program.name, orbitalNames });
+    return lazySchemas.then((lazy6) => runtime$1.register(program, { ...messages !== void 0 ? { messages } : {}, lazy: lazy6 })).then(() => {
+      playgroundLog.debug("register:done", { schema: program.name, orbitalNames });
     });
-  }, [runtime$1, schema, messages, lazyLoader, schemaPath]);
+  }, [runtime$1, lazySchemas, messages]);
+  const latestRegistration = React96.useRef(Promise.resolve());
+  const registrationReady = React96.useMemo(() => {
+    const ready = registerProgram(schema);
+    latestRegistration.current = ready;
+    return ready;
+  }, [registerProgram, schema]);
   const teardownTimerRef = React96.useRef(null);
   React96.useEffect(() => {
     if (teardownTimerRef.current !== null) {
@@ -66372,18 +66423,22 @@ function BrowserPlayground({
   const transport = React96.useMemo(
     () => runtime.createInProcessTransport(
       async (orbitalName, request) => {
-        await registrationReady;
+        await latestRegistration.current;
         return runtime$1.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$1.unregisterAll();
         }
       }
     ),
-    [runtime$1, registrationReady]
+    [runtime$1, registerProgram, registrationReady]
   );
   const viewerLocale = locale ?? schema.locales?.[0];
   const i18n$1 = React96.useMemo(() => {

package/dist/avl/index.js

@@ -1,11 +1,11 @@
-import { BrowserPlayground, collectEmbeddedTraits } from '../chunk-RHP5WL55.js';
+import { BrowserPlayground, collectEmbeddedTraits } from '../chunk-HB3D3HUJ.js';
 import { zoomReducer, initialZoomState, getBreadcrumbs } from '../chunk-GZGDBS4S.js';
 import { useTranslate as useTranslate$1 } from '../chunk-N7JIG57B.js';
 import '../chunk-VHTJRS2N.js';
 import '../chunk-YYYHH5BA.js';
 import { spacingTokenOf, positionOf, withPosition, snapToSpacingStep, defaultSpacingStepPx, spacingOf, withSizing, withSpacing, layoutOf, withLayout, sizingOf, DESIGN_COLOR_TOKENS, DESIGN_RADIUS_TOKENS, DESIGN_SPACING_SCALE, sizeLimitOf, withSizeLimit, isArbitraryClass, tokenOfDesignClass } from '../chunk-D2E44ODB.js';
-import { AvlGlyph, Popover, Button, Icon, Select, Badge, IconButton, AvlStateMachine, Input, AvlOrbital, AvlTrait, AvlEntity, AvlPage, AvlEvent, AvlGuard, AvlEffect, AvlState, useAlmadarDndSensors, almadarDndCollisionDetection, TagInput, Checkbox, Switch, CodeBlock, AvlFieldType, FileTree, AvlTransitionDetail, RangeSlider, computeTraitLayout, edgePath, Accordion, FormField, Radio, useCompactLayout, ButtonGroup } from '../chunk-PYJ2UQWM.js';
-export { AVL_GLYPH_KINDS, AvlApplication, AvlBinding, AvlBindingRef, AvlCircuit, AvlEffect, AvlEffectChip, AvlEntity, AvlEvent, AvlField, AvlFieldType, AvlGlyph, AvlGuard, AvlLiteral, AvlOperator, AvlOrbital, AvlPage, AvlPersistence, AvlSExpr, AvlState, AvlStateMachine, AvlTrait, AvlTransition, AvlTransitionDetail, AvlTransitionExplainer, BehaviorView, FIELD_TYPE_SHAPES, MiniStateMachine, ModuleCard, computeTraitLayout, edgePath } from '../chunk-PYJ2UQWM.js';
+import { AvlGlyph, Popover, Button, Icon, Select, Badge, IconButton, AvlStateMachine, Input, AvlOrbital, AvlTrait, AvlEntity, AvlPage, AvlEvent, AvlGuard, AvlEffect, AvlState, useAlmadarDndSensors, almadarDndCollisionDetection, TagInput, Checkbox, Switch, CodeBlock, AvlFieldType, FileTree, AvlTransitionDetail, RangeSlider, computeTraitLayout, edgePath, Accordion, FormField, Radio, useCompactLayout, ButtonGroup } from '../chunk-I2ZNE5TD.js';
+export { AVL_GLYPH_KINDS, AvlApplication, AvlBinding, AvlBindingRef, AvlCircuit, AvlEffect, AvlEffectChip, AvlEntity, AvlEvent, AvlField, AvlFieldType, AvlGlyph, AvlGuard, AvlLiteral, AvlOperator, AvlOrbital, AvlPage, AvlPersistence, AvlSExpr, AvlState, AvlStateMachine, AvlTrait, AvlTransition, AvlTransitionDetail, AvlTransitionExplainer, BehaviorView, FIELD_TYPE_SHAPES, MiniStateMachine, ModuleCard, computeTraitLayout, edgePath } from '../chunk-I2ZNE5TD.js';
 import { avlSeries, STATE_COLORS, Box, HStack, VStack, avlTint, CONNECTION_COLORS, parseTraitLevel, parseApplicationLevel, parseOrbitalLevel, getStateRole, effectCategoryOf, EFFECT_CATEGORY_COLORS, pressableProps, traitTransitionRenderUi, traitEventWires } from '../chunk-HA7CJWQX.js';
 export { CONNECTION_COLORS, EFFECT_CATEGORY_COLORS, OPERATOR_CATEGORY_COLORS, STATE_COLORS, effectCategoryOf, getStateRole, parseApplicationLevel, parseOrbitalLevel, parseTraitLevel, parseTransitionLevel, traitLevelFromTrait } from '../chunk-HA7CJWQX.js';
 import { Typography, INLINE_TEXT_ATTR } from '../chunk-4ZGXIW3B.js';