@almadar/ui 2.47.0 → 2.48.2

package/dist/avl/index.cjs

@@ -47219,15 +47219,16 @@ function SchemaRunner({ schema, serverUrl, mockData, pageName, onNavigate }) {
     return orbitals.filter((o) => typeof o.name === "string").map((o) => o.name);
   }, [schema]);
   const entityStore = useEntityStore();
-  React125.useEffect(() => {
-    if (!serverUrl && mockData) {
-      for (const [entityType, records] of Object.entries(mockData)) {
-        if (Array.isArray(records)) {
-          entityStore.setAll(entityType, records);
-        }
+  const seededRef = React125.useRef("");
+  const mockKey = mockData ? Object.keys(mockData).sort().join(",") : "";
+  if (!serverUrl && mockData && seededRef.current !== mockKey) {
+    seededRef.current = mockKey;
+    for (const [entityType, records] of Object.entries(mockData)) {
+      if (Array.isArray(records)) {
+        entityStore.setAll(entityType, records);
       }
     }
-  }, [mockData, serverUrl, entityStore]);
+  }
   const inner = /* @__PURE__ */ jsxRuntime.jsx(VerificationProvider, { enabled: true, children: /* @__PURE__ */ jsxRuntime.jsx(SlotsProvider, { children: /* @__PURE__ */ jsxRuntime.jsxs(EntitySchemaProvider, { entities: Array.from(allEntities.values()), children: [
     /* @__PURE__ */ jsxRuntime.jsx(TraitInitializer, { traits: allPageTraits, orbitalNames: serverUrl ? orbitalNames : void 0, onNavigate }),
     /* @__PURE__ */ jsxRuntime.jsx(SlotBridge, {}),

package/dist/avl/index.js

@@ -47171,15 +47171,16 @@ function SchemaRunner({ schema, serverUrl, mockData, pageName, onNavigate }) {
     return orbitals.filter((o) => typeof o.name === "string").map((o) => o.name);
   }, [schema]);
   const entityStore = useEntityStore();
-  useEffect(() => {
-    if (!serverUrl && mockData) {
-      for (const [entityType, records] of Object.entries(mockData)) {
-        if (Array.isArray(records)) {
-          entityStore.setAll(entityType, records);
-        }
+  const seededRef = useRef("");
+  const mockKey = mockData ? Object.keys(mockData).sort().join(",") : "";
+  if (!serverUrl && mockData && seededRef.current !== mockKey) {
+    seededRef.current = mockKey;
+    for (const [entityType, records] of Object.entries(mockData)) {
+      if (Array.isArray(records)) {
+        entityStore.setAll(entityType, records);
       }
     }
-  }, [mockData, serverUrl, entityStore]);
+  }
   const inner = /* @__PURE__ */ jsx(VerificationProvider, { enabled: true, children: /* @__PURE__ */ jsx(SlotsProvider, { children: /* @__PURE__ */ jsxs(EntitySchemaProvider, { entities: Array.from(allEntities.values()), children: [
     /* @__PURE__ */ jsx(TraitInitializer, { traits: allPageTraits, orbitalNames: serverUrl ? orbitalNames : void 0, onNavigate }),
     /* @__PURE__ */ jsx(SlotBridge, {}),

package/dist/components/index.cjs

@@ -36914,31 +36914,7 @@ function useUISlotManager() {
 var SelectionContext = React90.createContext(null);
 
 // hooks/useUIEvents.ts
-var UI_EVENT_MAP = {
-  // Form/CRUD events
-  "UI:SAVE": "SAVE",
-  "UI:CANCEL": "CANCEL",
-  "UI:CLOSE": "CLOSE",
-  "UI:VIEW": "VIEW",
-  "UI:EDIT": "EDIT",
-  "UI:DELETE": "DELETE",
-  "UI:CREATE": "CREATE",
-  "UI:SELECT": "SELECT",
-  "UI:DESELECT": "DESELECT",
-  "UI:SUBMIT": "SAVE",
-  "UI:UPDATE_STATUS": "UPDATE_STATUS",
-  "UI:SEARCH": "SEARCH",
-  "UI:CLEAR_SEARCH": "CLEAR_SEARCH",
-  "UI:ADD": "CREATE",
-  // Game events (for closed circuit with GameMenu, GamePauseOverlay, GameOverScreen)
-  "UI:PAUSE": "PAUSE",
-  "UI:RESUME": "RESUME",
-  "UI:RESTART": "RESTART",
-  "UI:GAME_OVER": "GAME_OVER",
-  "UI:START": "START",
-  "UI:QUIT": "QUIT",
-  "UI:INIT": "INIT"
-};
+var UI_PREFIX = "UI:";
 function useUIEvents(dispatch, validEvents, eventBusInstance) {
   const defaultEventBus = useEventBus();
   const eventBus = eventBusInstance ?? defaultEventBus;
@@ -36950,15 +36926,18 @@ function useUIEvents(dispatch, validEvents, eventBusInstance) {
   );
   React90.useEffect(() => {
     const unsubscribes = [];
-    Object.entries(UI_EVENT_MAP).forEach(([uiEvent, smEvent]) => {
-      const handler = (event) => {
-        if (!stableValidEvents || stableValidEvents.includes(smEvent)) {
+    if (stableValidEvents) {
+      for (const smEvent of stableValidEvents) {
+        const prefixedHandler = (event) => {
           dispatch(smEvent, event.payload);
-        }
-      };
-      const unsubscribe = eventBus.on(uiEvent, handler);
-      unsubscribes.push(unsubscribe);
-    });
+        };
+        unsubscribes.push(eventBus.on(`${UI_PREFIX}${smEvent}`, prefixedHandler));
+        const directHandler = (event) => {
+          dispatch(smEvent, event.payload);
+        };
+        unsubscribes.push(eventBus.on(smEvent, directHandler));
+      }
+    }
     const genericHandler = (event) => {
       const eventName = event.payload?.event;
       if (eventName) {
@@ -36968,30 +36947,11 @@ function useUIEvents(dispatch, validEvents, eventBusInstance) {
         }
       }
     };
-    const genericUnsubscribe = eventBus.on("UI:DISPATCH", genericHandler);
-    unsubscribes.push(genericUnsubscribe);
-    if (stableValidEvents) {
-      stableValidEvents.forEach((smEvent) => {
-        const uiPrefixedEvent = `UI:${smEvent}`;
-        const alreadyMapped = Object.keys(UI_EVENT_MAP).includes(uiPrefixedEvent);
-        if (!alreadyMapped) {
-          const directHandler = (event) => {
-            dispatch(smEvent, event.payload);
-          };
-          const unsubscribePrefixed = eventBus.on(
-            uiPrefixedEvent,
-            directHandler
-          );
-          unsubscribes.push(unsubscribePrefixed);
-          const unsubscribeDirect = eventBus.on(smEvent, directHandler);
-          unsubscribes.push(unsubscribeDirect);
-        }
-      });
-    }
+    unsubscribes.push(eventBus.on(`${UI_PREFIX}DISPATCH`, genericHandler));
     return () => {
-      unsubscribes.forEach((unsub) => {
+      for (const unsub of unsubscribes) {
         if (typeof unsub === "function") unsub();
-      });
+      }
     };
   }, [eventBus, dispatch, stableValidEvents]);
 }

package/dist/components/index.js

@@ -36867,31 +36867,7 @@ function useUISlotManager() {
 var SelectionContext = createContext(null);
 
 // hooks/useUIEvents.ts
-var UI_EVENT_MAP = {
-  // Form/CRUD events
-  "UI:SAVE": "SAVE",
-  "UI:CANCEL": "CANCEL",
-  "UI:CLOSE": "CLOSE",
-  "UI:VIEW": "VIEW",
-  "UI:EDIT": "EDIT",
-  "UI:DELETE": "DELETE",
-  "UI:CREATE": "CREATE",
-  "UI:SELECT": "SELECT",
-  "UI:DESELECT": "DESELECT",
-  "UI:SUBMIT": "SAVE",
-  "UI:UPDATE_STATUS": "UPDATE_STATUS",
-  "UI:SEARCH": "SEARCH",
-  "UI:CLEAR_SEARCH": "CLEAR_SEARCH",
-  "UI:ADD": "CREATE",
-  // Game events (for closed circuit with GameMenu, GamePauseOverlay, GameOverScreen)
-  "UI:PAUSE": "PAUSE",
-  "UI:RESUME": "RESUME",
-  "UI:RESTART": "RESTART",
-  "UI:GAME_OVER": "GAME_OVER",
-  "UI:START": "START",
-  "UI:QUIT": "QUIT",
-  "UI:INIT": "INIT"
-};
+var UI_PREFIX = "UI:";
 function useUIEvents(dispatch, validEvents, eventBusInstance) {
   const defaultEventBus = useEventBus();
   const eventBus = eventBusInstance ?? defaultEventBus;
@@ -36903,15 +36879,18 @@ function useUIEvents(dispatch, validEvents, eventBusInstance) {
   );
   useEffect(() => {
     const unsubscribes = [];
-    Object.entries(UI_EVENT_MAP).forEach(([uiEvent, smEvent]) => {
-      const handler = (event) => {
-        if (!stableValidEvents || stableValidEvents.includes(smEvent)) {
+    if (stableValidEvents) {
+      for (const smEvent of stableValidEvents) {
+        const prefixedHandler = (event) => {
           dispatch(smEvent, event.payload);
-        }
-      };
-      const unsubscribe = eventBus.on(uiEvent, handler);
-      unsubscribes.push(unsubscribe);
-    });
+        };
+        unsubscribes.push(eventBus.on(`${UI_PREFIX}${smEvent}`, prefixedHandler));
+        const directHandler = (event) => {
+          dispatch(smEvent, event.payload);
+        };
+        unsubscribes.push(eventBus.on(smEvent, directHandler));
+      }
+    }
     const genericHandler = (event) => {
       const eventName = event.payload?.event;
       if (eventName) {
@@ -36921,30 +36900,11 @@ function useUIEvents(dispatch, validEvents, eventBusInstance) {
         }
       }
     };
-    const genericUnsubscribe = eventBus.on("UI:DISPATCH", genericHandler);
-    unsubscribes.push(genericUnsubscribe);
-    if (stableValidEvents) {
-      stableValidEvents.forEach((smEvent) => {
-        const uiPrefixedEvent = `UI:${smEvent}`;
-        const alreadyMapped = Object.keys(UI_EVENT_MAP).includes(uiPrefixedEvent);
-        if (!alreadyMapped) {
-          const directHandler = (event) => {
-            dispatch(smEvent, event.payload);
-          };
-          const unsubscribePrefixed = eventBus.on(
-            uiPrefixedEvent,
-            directHandler
-          );
-          unsubscribes.push(unsubscribePrefixed);
-          const unsubscribeDirect = eventBus.on(smEvent, directHandler);
-          unsubscribes.push(unsubscribeDirect);
-        }
-      });
-    }
+    unsubscribes.push(eventBus.on(`${UI_PREFIX}DISPATCH`, genericHandler));
     return () => {
-      unsubscribes.forEach((unsub) => {
+      for (const unsub of unsubscribes) {
         if (typeof unsub === "function") unsub();
-      });
+      }
     };
   }, [eventBus, dispatch, stableValidEvents]);
 }

package/dist/components/molecules/DataGrid.d.ts

@@ -69,6 +69,13 @@ export interface DataGridProps {
     hasMore?: boolean;
     /** Render prop for custom per-item content. When provided, `fields` and `itemActions` are ignored. */
     children?: (item: Record<string, unknown>, index: number) => React.ReactNode;
+    /**
+     * Per-item render function (schema-level alias for children render prop).
+     * In .orb schemas: ["fn", "item", { pattern tree with @item.field bindings }]
+     * The compiler converts this to the children render prop.
+     * @deprecated Use children render prop in React code. This prop exists for pattern registry sync.
+     */
+    renderItem?: (item: Record<string, unknown>, index: number) => React.ReactNode;
     /** Max items to show before "Show More" button. Defaults to 0 (disabled). */
     pageSize?: number;
 }

package/dist/components/molecules/DataList.d.ts

@@ -89,6 +89,13 @@ export interface DataListProps {
     hasMore?: boolean;
     /** Render prop for custom per-item content. When provided, `fields` and `itemActions` are ignored. */
     children?: (item: Record<string, unknown>, index: number) => React.ReactNode;
+    /**
+     * Per-item render function (schema-level alias for children render prop).
+     * In .orb schemas: ["fn", "item", { pattern tree with @item.field bindings }]
+     * The compiler converts this to the children render prop.
+     * @deprecated Use children render prop in React code. This prop exists for pattern registry sync.
+     */
+    renderItem?: (item: Record<string, unknown>, index: number) => React.ReactNode;
     /** Max items to show before "Show More" button. Defaults to 5. Set to 0 to disable. */
     pageSize?: number;
 }

package/dist/hooks/index.cjs

@@ -1177,31 +1177,7 @@ function useUISlotManager() {
 var SelectionContext = React2.createContext(null);
 
 // hooks/useUIEvents.ts
-var UI_EVENT_MAP = {
-  // Form/CRUD events
-  "UI:SAVE": "SAVE",
-  "UI:CANCEL": "CANCEL",
-  "UI:CLOSE": "CLOSE",
-  "UI:VIEW": "VIEW",
-  "UI:EDIT": "EDIT",
-  "UI:DELETE": "DELETE",
-  "UI:CREATE": "CREATE",
-  "UI:SELECT": "SELECT",
-  "UI:DESELECT": "DESELECT",
-  "UI:SUBMIT": "SAVE",
-  "UI:UPDATE_STATUS": "UPDATE_STATUS",
-  "UI:SEARCH": "SEARCH",
-  "UI:CLEAR_SEARCH": "CLEAR_SEARCH",
-  "UI:ADD": "CREATE",
-  // Game events (for closed circuit with GameMenu, GamePauseOverlay, GameOverScreen)
-  "UI:PAUSE": "PAUSE",
-  "UI:RESUME": "RESUME",
-  "UI:RESTART": "RESTART",
-  "UI:GAME_OVER": "GAME_OVER",
-  "UI:START": "START",
-  "UI:QUIT": "QUIT",
-  "UI:INIT": "INIT"
-};
+var UI_PREFIX = "UI:";
 function useUIEvents(dispatch, validEvents, eventBusInstance) {
   const defaultEventBus = useEventBus();
   const eventBus = eventBusInstance ?? defaultEventBus;
@@ -1213,15 +1189,18 @@ function useUIEvents(dispatch, validEvents, eventBusInstance) {
   );
   React2.useEffect(() => {
     const unsubscribes = [];
-    Object.entries(UI_EVENT_MAP).forEach(([uiEvent, smEvent]) => {
-      const handler = (event) => {
-        if (!stableValidEvents || stableValidEvents.includes(smEvent)) {
+    if (stableValidEvents) {
+      for (const smEvent of stableValidEvents) {
+        const prefixedHandler = (event) => {
           dispatch(smEvent, event.payload);
-        }
-      };
-      const unsubscribe = eventBus.on(uiEvent, handler);
-      unsubscribes.push(unsubscribe);
-    });
+        };
+        unsubscribes.push(eventBus.on(`${UI_PREFIX}${smEvent}`, prefixedHandler));
+        const directHandler = (event) => {
+          dispatch(smEvent, event.payload);
+        };
+        unsubscribes.push(eventBus.on(smEvent, directHandler));
+      }
+    }
     const genericHandler = (event) => {
       const eventName = event.payload?.event;
       if (eventName) {
@@ -1231,30 +1210,11 @@ function useUIEvents(dispatch, validEvents, eventBusInstance) {
         }
       }
     };
-    const genericUnsubscribe = eventBus.on("UI:DISPATCH", genericHandler);
-    unsubscribes.push(genericUnsubscribe);
-    if (stableValidEvents) {
-      stableValidEvents.forEach((smEvent) => {
-        const uiPrefixedEvent = `UI:${smEvent}`;
-        const alreadyMapped = Object.keys(UI_EVENT_MAP).includes(uiPrefixedEvent);
-        if (!alreadyMapped) {
-          const directHandler = (event) => {
-            dispatch(smEvent, event.payload);
-          };
-          const unsubscribePrefixed = eventBus.on(
-            uiPrefixedEvent,
-            directHandler
-          );
-          unsubscribes.push(unsubscribePrefixed);
-          const unsubscribeDirect = eventBus.on(smEvent, directHandler);
-          unsubscribes.push(unsubscribeDirect);
-        }
-      });
-    }
+    unsubscribes.push(eventBus.on(`${UI_PREFIX}DISPATCH`, genericHandler));
     return () => {
-      unsubscribes.forEach((unsub) => {
+      for (const unsub of unsubscribes) {
         if (typeof unsub === "function") unsub();
-      });
+      }
     };
   }, [eventBus, dispatch, stableValidEvents]);
 }

package/dist/hooks/index.js

@@ -1170,31 +1170,7 @@ function useUISlotManager() {
 var SelectionContext = createContext(null);
 
 // hooks/useUIEvents.ts
-var UI_EVENT_MAP = {
-  // Form/CRUD events
-  "UI:SAVE": "SAVE",
-  "UI:CANCEL": "CANCEL",
-  "UI:CLOSE": "CLOSE",
-  "UI:VIEW": "VIEW",
-  "UI:EDIT": "EDIT",
-  "UI:DELETE": "DELETE",
-  "UI:CREATE": "CREATE",
-  "UI:SELECT": "SELECT",
-  "UI:DESELECT": "DESELECT",
-  "UI:SUBMIT": "SAVE",
-  "UI:UPDATE_STATUS": "UPDATE_STATUS",
-  "UI:SEARCH": "SEARCH",
-  "UI:CLEAR_SEARCH": "CLEAR_SEARCH",
-  "UI:ADD": "CREATE",
-  // Game events (for closed circuit with GameMenu, GamePauseOverlay, GameOverScreen)
-  "UI:PAUSE": "PAUSE",
-  "UI:RESUME": "RESUME",
-  "UI:RESTART": "RESTART",
-  "UI:GAME_OVER": "GAME_OVER",
-  "UI:START": "START",
-  "UI:QUIT": "QUIT",
-  "UI:INIT": "INIT"
-};
+var UI_PREFIX = "UI:";
 function useUIEvents(dispatch, validEvents, eventBusInstance) {
   const defaultEventBus = useEventBus();
   const eventBus = eventBusInstance ?? defaultEventBus;
@@ -1206,15 +1182,18 @@ function useUIEvents(dispatch, validEvents, eventBusInstance) {
   );
   useEffect(() => {
     const unsubscribes = [];
-    Object.entries(UI_EVENT_MAP).forEach(([uiEvent, smEvent]) => {
-      const handler = (event) => {
-        if (!stableValidEvents || stableValidEvents.includes(smEvent)) {
+    if (stableValidEvents) {
+      for (const smEvent of stableValidEvents) {
+        const prefixedHandler = (event) => {
           dispatch(smEvent, event.payload);
-        }
-      };
-      const unsubscribe = eventBus.on(uiEvent, handler);
-      unsubscribes.push(unsubscribe);
-    });
+        };
+        unsubscribes.push(eventBus.on(`${UI_PREFIX}${smEvent}`, prefixedHandler));
+        const directHandler = (event) => {
+          dispatch(smEvent, event.payload);
+        };
+        unsubscribes.push(eventBus.on(smEvent, directHandler));
+      }
+    }
     const genericHandler = (event) => {
       const eventName = event.payload?.event;
       if (eventName) {
@@ -1224,30 +1203,11 @@ function useUIEvents(dispatch, validEvents, eventBusInstance) {
         }
       }
     };
-    const genericUnsubscribe = eventBus.on("UI:DISPATCH", genericHandler);
-    unsubscribes.push(genericUnsubscribe);
-    if (stableValidEvents) {
-      stableValidEvents.forEach((smEvent) => {
-        const uiPrefixedEvent = `UI:${smEvent}`;
-        const alreadyMapped = Object.keys(UI_EVENT_MAP).includes(uiPrefixedEvent);
-        if (!alreadyMapped) {
-          const directHandler = (event) => {
-            dispatch(smEvent, event.payload);
-          };
-          const unsubscribePrefixed = eventBus.on(
-            uiPrefixedEvent,
-            directHandler
-          );
-          unsubscribes.push(unsubscribePrefixed);
-          const unsubscribeDirect = eventBus.on(smEvent, directHandler);
-          unsubscribes.push(unsubscribeDirect);
-        }
-      });
-    }
+    unsubscribes.push(eventBus.on(`${UI_PREFIX}DISPATCH`, genericHandler));
     return () => {
-      unsubscribes.forEach((unsub) => {
+      for (const unsub of unsubscribes) {
         if (typeof unsub === "function") unsub();
-      });
+      }
     };
   }, [eventBus, dispatch, stableValidEvents]);
 }

package/dist/runtime/index.cjs

@@ -33643,15 +33643,16 @@ function SchemaRunner({ schema, serverUrl, mockData, pageName, onNavigate }) {
     return orbitals.filter((o) => typeof o.name === "string").map((o) => o.name);
   }, [schema]);
   const entityStore = useEntityStore();
-  React117.useEffect(() => {
-    if (!serverUrl && mockData) {
-      for (const [entityType, records] of Object.entries(mockData)) {
-        if (Array.isArray(records)) {
-          entityStore.setAll(entityType, records);
-        }
+  const seededRef = React117.useRef("");
+  const mockKey = mockData ? Object.keys(mockData).sort().join(",") : "";
+  if (!serverUrl && mockData && seededRef.current !== mockKey) {
+    seededRef.current = mockKey;
+    for (const [entityType, records] of Object.entries(mockData)) {
+      if (Array.isArray(records)) {
+        entityStore.setAll(entityType, records);
       }
     }
-  }, [mockData, serverUrl, entityStore]);
+  }
   const inner = /* @__PURE__ */ jsxRuntime.jsx(VerificationProvider, { enabled: true, children: /* @__PURE__ */ jsxRuntime.jsx(SlotsProvider, { children: /* @__PURE__ */ jsxRuntime.jsxs(EntitySchemaProvider, { entities: Array.from(allEntities.values()), children: [
     /* @__PURE__ */ jsxRuntime.jsx(TraitInitializer, { traits: allPageTraits, orbitalNames: serverUrl ? orbitalNames : void 0, onNavigate }),
     /* @__PURE__ */ jsxRuntime.jsx(SlotBridge, {}),

package/dist/runtime/index.js

@@ -33596,15 +33596,16 @@ function SchemaRunner({ schema, serverUrl, mockData, pageName, onNavigate }) {
     return orbitals.filter((o) => typeof o.name === "string").map((o) => o.name);
   }, [schema]);
   const entityStore = useEntityStore();
-  useEffect(() => {
-    if (!serverUrl && mockData) {
-      for (const [entityType, records] of Object.entries(mockData)) {
-        if (Array.isArray(records)) {
-          entityStore.setAll(entityType, records);
-        }
+  const seededRef = useRef("");
+  const mockKey = mockData ? Object.keys(mockData).sort().join(",") : "";
+  if (!serverUrl && mockData && seededRef.current !== mockKey) {
+    seededRef.current = mockKey;
+    for (const [entityType, records] of Object.entries(mockData)) {
+      if (Array.isArray(records)) {
+        entityStore.setAll(entityType, records);
       }
     }
-  }, [mockData, serverUrl, entityStore]);
+  }
   const inner = /* @__PURE__ */ jsx(VerificationProvider, { enabled: true, children: /* @__PURE__ */ jsx(SlotsProvider, { children: /* @__PURE__ */ jsxs(EntitySchemaProvider, { entities: Array.from(allEntities.values()), children: [
     /* @__PURE__ */ jsx(TraitInitializer, { traits: allPageTraits, orbitalNames: serverUrl ? orbitalNames : void 0, onNavigate }),
     /* @__PURE__ */ jsx(SlotBridge, {}),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/ui",
-  "version": "2.47.0",
+  "version": "2.48.2",
   "description": "React UI components, hooks, and providers for Almadar",
   "type": "module",
   "main": "./dist/components/index.js",