@almadar/ui 4.6.14 → 4.8.0

package/dist/marketing/index.d.cts

@@ -245,6 +245,8 @@ interface CardProps extends React.HTMLAttributes<HTMLDivElement> {
     subtitle?: string;
     /** Shadow size override */
     shadow?: CardShadow;
+    /** Card content */
+    children?: React.ReactNode;
 }
 declare const Card: React.ForwardRefExoticComponent<CardProps & React.RefAttributes<HTMLDivElement>>;
 

package/dist/providers/index.cjs

@@ -1772,6 +1772,7 @@ var init_SlotsContext = __esm({
   "runtime/ui/SlotsContext.tsx"() {
     init_logger();
     slotLog = createLogger("almadar:ui:slot-render");
+    createLogger("almadar:runtime:cross-orbital");
     refIds = /* @__PURE__ */ new WeakMap();
     nextRefId = 1;
     React116.createContext({});
@@ -9057,9 +9058,9 @@ function bindEventBus(eventBus) {
   log2.info("bindEventBus", { hasOnAny: !!eventBus.onAny });
   exposeOnWindow();
   if (window.__orbitalVerification) {
-    window.__orbitalVerification.sendEvent = (event, payload) => {
-      const prefixed = event.startsWith("UI:") ? event : `UI:${event}`;
-      log2.debug("sendEvent", { event: prefixed, payloadKeys: payload ? Object.keys(payload) : [] });
+    window.__orbitalVerification.sendEvent = (event, payload, traitScope) => {
+      const prefixed = event.startsWith("UI:") ? event : traitScope ? `UI:${traitScope}.${event}` : `UI:${event}`;
+      log2.debug("sendEvent", { event: prefixed, traitScope, payloadKeys: payload ? Object.keys(payload) : [] });
       eventBus.emit(prefixed, payload);
     };
     const eventLog = [];
@@ -18650,8 +18651,7 @@ function formatValue(value, format) {
 }
 function DataGrid({
   entity,
-  fields: fieldsProp,
-  columns: columnsProp,
+  fields,
   itemActions,
   cols,
   gap = "md",
@@ -18672,7 +18672,6 @@ function DataGrid({
   const { t } = useTranslate();
   const [selectedIds, setSelectedIds] = React116.useState(/* @__PURE__ */ new Set());
   const [visibleCount, setVisibleCount] = React116.useState(pageSize || Infinity);
-  const fields = fieldsProp ?? columnsProp ?? [];
   const allData = Array.isArray(entity) ? entity : entity ? [entity] : [];
   const data = pageSize > 0 ? allData.slice(0, visibleCount) : allData;
   const hasMoreLocal = pageSize > 0 && visibleCount < allData.length;
@@ -19015,8 +19014,7 @@ function groupData(items, field) {
 }
 function DataList({
   entity,
-  fields: fieldsProp,
-  columns: columnsProp,
+  fields,
   itemActions,
   gap = "none",
   variant = "default",
@@ -19045,7 +19043,6 @@ function DataList({
   const eventBus = useEventBus();
   const { t } = useTranslate();
   const [visibleCount, setVisibleCount] = React116__namespace.default.useState(pageSize || Infinity);
-  const fields = fieldsProp ?? columnsProp ?? [];
   const allData = Array.isArray(entity) ? entity : entity ? [entity] : [];
   const data = pageSize > 0 ? allData.slice(0, visibleCount) : allData;
   const hasMoreLocal = pageSize > 0 && visibleCount < allData.length;

package/dist/providers/index.js

@@ -1727,6 +1727,7 @@ var init_SlotsContext = __esm({
   "runtime/ui/SlotsContext.tsx"() {
     init_logger();
     slotLog = createLogger("almadar:ui:slot-render");
+    createLogger("almadar:runtime:cross-orbital");
     refIds = /* @__PURE__ */ new WeakMap();
     nextRefId = 1;
     createContext({});
@@ -9012,9 +9013,9 @@ function bindEventBus(eventBus) {
   log2.info("bindEventBus", { hasOnAny: !!eventBus.onAny });
   exposeOnWindow();
   if (window.__orbitalVerification) {
-    window.__orbitalVerification.sendEvent = (event, payload) => {
-      const prefixed = event.startsWith("UI:") ? event : `UI:${event}`;
-      log2.debug("sendEvent", { event: prefixed, payloadKeys: payload ? Object.keys(payload) : [] });
+    window.__orbitalVerification.sendEvent = (event, payload, traitScope) => {
+      const prefixed = event.startsWith("UI:") ? event : traitScope ? `UI:${traitScope}.${event}` : `UI:${event}`;
+      log2.debug("sendEvent", { event: prefixed, traitScope, payloadKeys: payload ? Object.keys(payload) : [] });
       eventBus.emit(prefixed, payload);
     };
     const eventLog = [];
@@ -18605,8 +18606,7 @@ function formatValue(value, format) {
 }
 function DataGrid({
   entity,
-  fields: fieldsProp,
-  columns: columnsProp,
+  fields,
   itemActions,
   cols,
   gap = "md",
@@ -18627,7 +18627,6 @@ function DataGrid({
   const { t } = useTranslate();
   const [selectedIds, setSelectedIds] = useState(/* @__PURE__ */ new Set());
   const [visibleCount, setVisibleCount] = useState(pageSize || Infinity);
-  const fields = fieldsProp ?? columnsProp ?? [];
   const allData = Array.isArray(entity) ? entity : entity ? [entity] : [];
   const data = pageSize > 0 ? allData.slice(0, visibleCount) : allData;
   const hasMoreLocal = pageSize > 0 && visibleCount < allData.length;
@@ -18970,8 +18969,7 @@ function groupData(items, field) {
 }
 function DataList({
   entity,
-  fields: fieldsProp,
-  columns: columnsProp,
+  fields,
   itemActions,
   gap = "none",
   variant = "default",
@@ -19000,7 +18998,6 @@ function DataList({
   const eventBus = useEventBus();
   const { t } = useTranslate();
   const [visibleCount, setVisibleCount] = React116__default.useState(pageSize || Infinity);
-  const fields = fieldsProp ?? columnsProp ?? [];
   const allData = Array.isArray(entity) ? entity : entity ? [entity] : [];
   const data = pageSize > 0 ? allData.slice(0, visibleCount) : allData;
   const hasMoreLocal = pageSize > 0 && visibleCount < allData.length;

package/dist/runtime/OrbPreview.d.ts

@@ -42,6 +42,14 @@ export interface OrbPreviewProps {
     className?: string;
     /** Server URL for dual execution (e.g. "/api/orbitals"). When set, events are forwarded to the server. */
     serverUrl?: string;
+    /**
+     * Initial page path to render (e.g. `/deals`). Resolves against the
+     * schema's `pages[]` to seed `currentPage` so the right orbital's traits
+     * mount on first render. Without this the playground falls back to the
+     * schema's first page binding (gap #13 Phase 5). runtime-verify uses this
+     * to walk DealCreate, NoteCompose, etc. on their owning pages.
+     */
+    initialPagePath?: string;
 }
 /**
  * Renders a live preview of an Orbital schema.
@@ -56,7 +64,7 @@ export interface OrbPreviewProps {
  * <OrbPreview schema={schema} serverUrl="/api/orbitals" />
  * ```
  */
-export declare function OrbPreview({ schema, mockData, autoMock, height, className, serverUrl, }: OrbPreviewProps): React.ReactElement;
+export declare function OrbPreview({ schema, mockData, autoMock, height, className, serverUrl, initialPagePath, }: OrbPreviewProps): React.ReactElement;
 export declare namespace OrbPreview {
     var displayName: string;
 }

package/dist/runtime/index.cjs

@@ -1116,13 +1116,23 @@ function SlotsProvider({ children }) {
   const setSlotPatterns = React115.useCallback((slot, patterns, source) => {
     const sourceKey = source?.trait ?? DEFAULT_SOURCE_KEY;
     const entityProp = patterns[0]?.pattern && typeof patterns[0].pattern === "object" ? patterns[0].pattern.entity : void 0;
+    const firstPatternType = patterns[0]?.pattern && typeof patterns[0].pattern === "object" ? patterns[0].pattern.type : void 0;
     slotLog.debug("setSlotPatterns", {
       slot,
       sourceKey,
       patternCount: patterns.length,
-      firstPatternType: patterns[0]?.pattern && typeof patterns[0].pattern === "object" ? patterns[0].pattern.type : void 0,
+      firstPatternType,
       entityRefId: refId(entityProp)
     });
+    if (source?.trait) {
+      xOrbitalLog.info("slot-set", {
+        slot,
+        sourceTrait: source.trait,
+        patternCount: patterns.length,
+        firstPatternType,
+        state: source.state
+      });
+    }
     setSlots((prev) => {
       const prevSlot = prev[slot] ?? {};
       return {
@@ -1144,6 +1154,7 @@ function SlotsProvider({ children }) {
     });
   }, []);
   const clearSlotForSource = React115.useCallback((slot, sourceTrait) => {
+    xOrbitalLog.info("slot-clear-source", { slot, sourceTrait });
     setSlots((prev) => {
       const existing = prev[slot];
       if (!existing || !(sourceTrait in existing)) return prev;
@@ -1184,11 +1195,12 @@ function useSlotsActions() {
   }
   return actions;
 }
-var slotLog, refIds, nextRefId, DEFAULT_SOURCE_KEY, SlotsStateContext, SlotsActionsContext;
+var slotLog, xOrbitalLog, refIds, nextRefId, DEFAULT_SOURCE_KEY, SlotsStateContext, SlotsActionsContext;
 var init_SlotsContext = __esm({
   "runtime/ui/SlotsContext.tsx"() {
     init_logger();
     slotLog = createLogger("almadar:ui:slot-render");
+    xOrbitalLog = createLogger("almadar:runtime:cross-orbital");
     refIds = /* @__PURE__ */ new WeakMap();
     nextRefId = 1;
     DEFAULT_SOURCE_KEY = "__default__";
@@ -8182,7 +8194,7 @@ var init_MapView = __esm({
         shadowSize: [41, 41]
       });
       L.Marker.prototype.options.icon = defaultIcon;
-      const { useEffect: useEffect68, useRef: useRef65, useCallback: useCallback110, useState: useState103 } = React115__namespace.default;
+      const { useEffect: useEffect68, useRef: useRef65, useCallback: useCallback110, useState: useState102 } = React115__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 }) {
@@ -8226,7 +8238,7 @@ var init_MapView = __esm({
         showAttribution = true
       }) {
         const eventBus = useEventBus2();
-        const [clickedPosition, setClickedPosition] = useState103(null);
+        const [clickedPosition, setClickedPosition] = useState102(null);
         const handleMapClick = useCallback110((lat, lng) => {
           if (showClickedPin) {
             setClickedPosition({ lat, lng });
@@ -18539,8 +18551,7 @@ function formatValue(value, format) {
 }
 function DataGrid({
   entity,
-  fields: fieldsProp,
-  columns: columnsProp,
+  fields,
   itemActions,
   cols,
   gap = "md",
@@ -18561,7 +18572,6 @@ function DataGrid({
   const { t } = useTranslate();
   const [selectedIds, setSelectedIds] = React115.useState(/* @__PURE__ */ new Set());
   const [visibleCount, setVisibleCount] = React115.useState(pageSize || Infinity);
-  const fields = fieldsProp ?? columnsProp ?? [];
   const allData = Array.isArray(entity) ? entity : entity ? [entity] : [];
   const data = pageSize > 0 ? allData.slice(0, visibleCount) : allData;
   const hasMoreLocal = pageSize > 0 && visibleCount < allData.length;
@@ -18904,8 +18914,7 @@ function groupData(items, field) {
 }
 function DataList({
   entity,
-  fields: fieldsProp,
-  columns: columnsProp,
+  fields,
   itemActions,
   gap = "none",
   variant = "default",
@@ -18934,7 +18943,6 @@ function DataList({
   const eventBus = useEventBus();
   const { t } = useTranslate();
   const [visibleCount, setVisibleCount] = React115__namespace.default.useState(pageSize || Infinity);
-  const fields = fieldsProp ?? columnsProp ?? [];
   const allData = Array.isArray(entity) ? entity : entity ? [entity] : [];
   const data = pageSize > 0 ? allData.slice(0, visibleCount) : allData;
   const hasMoreLocal = pageSize > 0 && visibleCount < allData.length;
@@ -38179,6 +38187,7 @@ function useTraitStateMachine(traitBindings, slotsActions, options) {
   const eventBus = useEventBus();
   const { entities } = useEntitySchema();
   const traitConfigsByName = options?.traitConfigsByName;
+  const orbitalsByTrait = options?.orbitalsByTrait;
   const manager = React115.useMemo(() => {
     const traitDefs = traitBindings.map(toTraitDefinition);
     const m = new runtime.StateMachineManager(traitDefs);
@@ -38627,7 +38636,10 @@ function useTraitStateMachine(traitBindings, slotsActions, options) {
     if (!LIFECYCLE_EVENTS.has(normalizedEvent)) {
       for (const { traitName, result } of results) {
         if (!result.executed) continue;
-        eventBus.emit(normalizedEvent, payload, {
+        const orbitalName = orbitalsByTrait?.[traitName];
+        if (!orbitalName) continue;
+        eventBus.emit(`UI:${orbitalName}.${traitName}.${normalizedEvent}`, payload, {
+          orbital: orbitalName,
           trait: traitName,
           fromBridge: true
         });
@@ -38638,7 +38650,13 @@ function useTraitStateMachine(traitBindings, slotsActions, options) {
     }
     const onEventProcessed = optionsRef.current?.onEventProcessed;
     if (onEventProcessed) {
-      await onEventProcessed(normalizedEvent, payload);
+      const dispatchedOrbitals = /* @__PURE__ */ new Set();
+      for (const { traitName, result } of results) {
+        if (!result.executed) continue;
+        const orbital = orbitalsByTrait?.[traitName];
+        if (orbital) dispatchedOrbitals.add(orbital);
+      }
+      await onEventProcessed(normalizedEvent, payload, dispatchedOrbitals);
     }
   }, [entities, eventBus]);
   const drainEventQueue = React115.useCallback(async () => {
@@ -38682,26 +38700,34 @@ function useTraitStateMachine(traitBindings, slotsActions, options) {
     }
     console.log("[TraitStateMachine] Subscribing to events:", Array.from(allEvents));
     const unsubscribes = [];
-    for (const eventKey of allEvents) {
-      if (eventKey === "INIT" || eventKey === "LOAD" || eventKey === "$MOUNT") {
-        continue;
+    for (const binding of traitBindings) {
+      const traitName = binding.trait.name;
+      const orbitalName = orbitalsByTrait?.[traitName];
+      if (!orbitalName) continue;
+      for (const transition of binding.trait.transitions) {
+        const eventKey = transition.event;
+        if (eventKey === "INIT" || eventKey === "LOAD" || eventKey === "$MOUNT") {
+          continue;
+        }
+        const unsub = eventBus.on(`UI:${orbitalName}.${traitName}.${eventKey}`, (event) => {
+          if (event.source && event.source.fromBridge) {
+            return;
+          }
+          enqueueAndDrain(eventKey, event.payload);
+        });
+        unsubscribes.push(unsub);
       }
-      const unsub = eventBus.on(`UI:${eventKey}`, (event) => {
-        console.log("[TraitStateMachine] Received event:", `UI:${eventKey}`, event);
-        enqueueAndDrain(eventKey, event.payload);
-      });
-      unsubscribes.push(unsub);
     }
     for (const binding of traitBindings) {
+      const ownOrbital = orbitalsByTrait?.[binding.trait.name];
       const listens = binding.trait.listens ?? [];
       for (const listen of listens) {
-        const expectedTrait = listen.source?.trait;
-        const unsub = eventBus.on(listen.event, (event) => {
-          if (expectedTrait) {
-            const emitTrait = event.source?.trait;
-            if (emitTrait !== expectedTrait) return;
-          }
-          console.log("[TraitStateMachine] listens", binding.trait.name, listen.event, "\u2192", listen.triggers, "from", event.source?.trait);
+        const sourceTrait = listen.source?.trait;
+        if (!sourceTrait) continue;
+        const sourceOrbital = listen.source?.orbital ?? ownOrbital;
+        if (!sourceOrbital) continue;
+        const busKey = `UI:${sourceOrbital}.${sourceTrait}.${listen.event}`;
+        const unsub = eventBus.on(busKey, (event) => {
           enqueueAndDrain(listen.triggers, event.payload);
         });
         unsubscribes.push(unsub);
@@ -38848,6 +38874,8 @@ init_EntitySchemaContext();
 
 // runtime/ServerBridge.tsx
 init_useEventBus();
+init_logger();
+var xOrbitalLog2 = createLogger("almadar:runtime:cross-orbital");
 var ServerBridgeContext = React115.createContext(null);
 function useServerBridge() {
   const ctx = React115.useContext(ServerBridgeContext);
@@ -38925,8 +38953,22 @@ function ServerBridgeProvider({
         }
         if (result.emittedEvents) {
           for (const emitted of result.emittedEvents) {
-            eventBus.emit(`UI:${emitted.event}`, emitted.payload);
-            eventBus.emit(emitted.event, emitted.payload);
+            const evTrait = emitted.source?.trait;
+            if (!evTrait) {
+              xOrbitalLog2.warn("emit:dropped-no-source", {
+                event: emitted.event,
+                dispatchOrbital: orbitalName
+              });
+              continue;
+            }
+            const key = emitted.source?.orbital ? `UI:${emitted.source.orbital}.${evTrait}.${emitted.event}` : `UI:${evTrait}.${emitted.event}`;
+            xOrbitalLog2.info("emit:rebroadcast", {
+              busKey: key,
+              sourceOrbital: emitted.source?.orbital,
+              sourceTrait: evTrait,
+              dispatchOrbital: orbitalName
+            });
+            eventBus.emit(key, emitted.payload);
           }
         }
       } else if (result.error) {
@@ -39047,6 +39089,10 @@ function prepareSchemaForPreview(input) {
   const schema = adjustSchemaForMockData(parsed, mockData);
   return { schema, mockData };
 }
+
+// runtime/OrbPreview.tsx
+init_logger();
+var xOrbitalLog3 = createLogger("almadar:runtime:cross-orbital");
 function normalizeChild(child) {
   if (typeof child === "string") return child;
   if (child === null || typeof child !== "object" || Array.isArray(child)) {
@@ -39126,6 +39172,11 @@ function applyServerEffects(effects, uiSlots, onNavigate) {
       const patternRecord = eff.pattern;
       const { type: patternType, children, ...inlineProps } = patternRecord;
       const normalizedChildren = Array.isArray(children) ? children.map((c) => normalizeChild(c)) : children;
+      xOrbitalLog3.info("slot-write", {
+        slot: eff.slot,
+        sourceTrait: eff.traitName ?? "server",
+        patternType: typeof patternType === "string" ? patternType : void 0
+      });
       uiSlots.render({
         target: eff.slot,
         pattern: patternType,
@@ -39140,19 +39191,26 @@ function applyServerEffects(effects, uiSlots, onNavigate) {
     }
   }
 }
-function TraitInitializer({ traits: traits2, orbitalNames, onNavigate, onLocalFallback, persistence, traitConfigsByName }) {
+function TraitInitializer({ traits: traits2, orbitalNames, onNavigate, onLocalFallback, persistence, traitConfigsByName, orbitalsByTrait }) {
   const slotsActions = useSlotsActions();
   const bridge = useServerBridge();
   const uiSlots = context.useUISlots();
-  const onEventProcessed = React115.useCallback(async (event, payload) => {
+  const onEventProcessed = React115.useCallback(async (event, payload, dispatchedOrbitals) => {
     if (!bridge.connected || !orbitalNames?.length) return;
-    for (const name of orbitalNames) {
+    const targets = dispatchedOrbitals && dispatchedOrbitals.size > 0 ? orbitalNames.filter((n) => dispatchedOrbitals.has(n)) : orbitalNames;
+    xOrbitalLog3.info("TraitInitializer:fanout", {
+      event,
+      sentTo: targets,
+      skipped: orbitalNames.filter((n) => !targets.includes(n)),
+      dispatchedOrbitalsSize: dispatchedOrbitals?.size ?? 0
+    });
+    for (const name of targets) {
       const { effects, meta } = await bridge.sendEvent(name, event, payload);
       recordServerResponse(name, event, meta);
       applyServerEffects(effects, uiSlots, onNavigate);
     }
   }, [bridge.connected, bridge.sendEvent, orbitalNames, uiSlots, onNavigate]);
-  const opts = orbitalNames ? { onEventProcessed, navigate: onNavigate, traitConfigsByName } : { navigate: onNavigate, persistence, traitConfigsByName };
+  const opts = orbitalNames ? { onEventProcessed, navigate: onNavigate, traitConfigsByName, orbitalsByTrait } : { navigate: onNavigate, persistence, traitConfigsByName, orbitalsByTrait };
   const { sendEvent } = useTraitStateMachine(traits2, slotsActions, opts);
   const initSentRef = React115.useRef(false);
   React115.useEffect(() => {
@@ -39202,27 +39260,68 @@ function SchemaRunner({ schema, serverUrl, mockData, pageName, onNavigate, onLoc
   const allPageTraits = React115.useMemo(() => {
     if (pageName && traits2.length > 0) return traits2;
     if (!ir?.pages || ir.pages.size <= 1) return traits2;
-    const combined = [];
+    const firstPage = ir.pages.values().next().value;
+    if (!firstPage) return traits2;
+    const firstPageTraits = [];
     const seen = /* @__PURE__ */ new Set();
-    for (const page of ir.pages.values()) {
-      for (const t of page.traits) {
-        const binding = t;
-        const traitObj = binding.trait;
-        const name = traitObj?.name ?? binding.name ?? "";
-        if (name && !seen.has(name)) {
-          seen.add(name);
-          combined.push(t);
-        }
+    for (const binding of firstPage.traits) {
+      const name = binding.trait.name;
+      if (name && !seen.has(name)) {
+        seen.add(name);
+        firstPageTraits.push(binding);
       }
     }
-    return combined.length > 0 ? combined : traits2;
+    return firstPageTraits.length > 0 ? firstPageTraits : traits2;
   }, [ir, traits2, pageName]);
-  const orbitalNames = React115.useMemo(() => {
+  React115.useMemo(() => {
     const parsed = schema;
     const orbitals = parsed?.orbitals;
     if (!orbitals) return [];
     return orbitals.filter((o) => typeof o.name === "string").map((o) => o.name);
   }, [schema]);
+  const orbitalsByTrait = React115.useMemo(() => {
+    const map = {};
+    const parsed = schema;
+    if (!parsed?.orbitals) return map;
+    for (const orb of parsed.orbitals) {
+      for (const traitRef of orb.traits) {
+        let traitName;
+        if (typeof traitRef === "string") {
+          const parts = traitRef.split(".");
+          traitName = parts[parts.length - 1];
+        } else if ("ref" in traitRef && typeof traitRef.ref === "string") {
+          const parts = traitRef.ref.split(".");
+          traitName = traitRef.name ?? parts[parts.length - 1];
+        } else if ("name" in traitRef && typeof traitRef.name === "string") {
+          traitName = traitRef.name;
+        }
+        if (traitName) map[traitName] = orb.name;
+      }
+    }
+    return map;
+  }, [schema]);
+  const pageOrbitalNames = React115.useMemo(() => {
+    const set = /* @__PURE__ */ new Set();
+    for (const binding of allPageTraits) {
+      const orb = orbitalsByTrait[binding.trait.name];
+      if (orb) set.add(orb);
+    }
+    return Array.from(set);
+  }, [allPageTraits, orbitalsByTrait]);
+  React115.useEffect(() => {
+    const traitNames = allPageTraits.map((b) => b.trait.name);
+    const orbitalsByTraitForPage = {};
+    for (const name of traitNames) {
+      const orb = orbitalsByTrait[name];
+      if (orb) orbitalsByTraitForPage[name] = orb;
+    }
+    xOrbitalLog3.info("SchemaRunner:mount", {
+      pageName,
+      traitNames,
+      orbitalsByTraitForPage,
+      pageOrbitalNames: pageOrbitalNames.join(",")
+    });
+  }, [pageName, allPageTraits, orbitalsByTrait, pageOrbitalNames]);
   const traitConfigsByName = React115.useMemo(() => {
     const map = {};
     const parsed = schema;
@@ -39263,8 +39362,9 @@ function SchemaRunner({ schema, serverUrl, mockData, pageName, onNavigate, onLoc
           TraitInitializer,
           {
             traits: allPageTraits,
-            orbitalNames: serverUrl ? orbitalNames : void 0,
+            orbitalNames: serverUrl ? pageOrbitalNames : void 0,
             traitConfigsByName,
+            orbitalsByTrait,
             onNavigate,
             onLocalFallback,
             persistence
@@ -39286,7 +39386,8 @@ function OrbPreview({
   autoMock = false,
   height = "400px",
   className,
-  serverUrl
+  serverUrl,
+  initialPagePath
 }) {
   const [localFallback, setLocalFallback] = React115.useState(false);
   const eventBus = useEventBus();
@@ -39332,7 +39433,17 @@ function OrbPreview({
       return [];
     }
   }, [parsedSchema]);
-  const [currentPage, setCurrentPage] = React115.useState(void 0);
+  const initialPageName = React115.useMemo(() => {
+    if (!initialPagePath) return void 0;
+    const match = pages.find(({ page }) => page.path === initialPagePath);
+    return match?.page.name;
+  }, [pages, initialPagePath]);
+  const [currentPage, setCurrentPage] = React115.useState(initialPageName);
+  React115.useEffect(() => {
+    if (initialPageName && initialPageName !== currentPage) {
+      setCurrentPage(initialPageName);
+    }
+  }, [initialPageName, currentPage]);
   const handleNavigate = React115.useCallback((path) => {
     const match = pages.find(({ page }) => page.path === path);
     if (match) {