@almadar/ui 4.50.16 → 4.50.18

package/dist/avl/index.cjs

@@ -24913,6 +24913,7 @@ function useDataDnd(args) {
     sortable: sortable$1,
     dropEvent,
     reorderEvent,
+    positionEvent,
     dndItemIdField = "id",
     dndRoot,
     items,
@@ -24980,8 +24981,8 @@ function useDataDnd(args) {
   const [activeDrag, setActiveDrag] = React93__namespace.default.useState(null);
   const [overZoneGroup, setOverZoneGroup] = React93__namespace.default.useState(null);
   const meta = React93__namespace.default.useMemo(
-    () => ({ group: ownGroup, dropEvent, reorderEvent, itemIds, rawItems: items, idField: dndItemIdField }),
-    [ownGroup, dropEvent, reorderEvent, itemIds, items, dndItemIdField]
+    () => ({ group: ownGroup, dropEvent, reorderEvent, positionEvent, itemIds, rawItems: items, idField: dndItemIdField }),
+    [ownGroup, dropEvent, reorderEvent, positionEvent, itemIds, items, dndItemIdField]
   );
   React93__namespace.default.useEffect(() => {
     const target = isRoot ? null : parentRoot;
@@ -25067,6 +25068,20 @@ function useDataDnd(args) {
         dndLog.warn("dragEnd:abort:no-zone-resolved", { activeId: active.id, hasSource: !!sourceMeta, hasTarget: !!targetMeta });
         return;
       }
+      const emitPositions = (zoneMeta) => {
+        if (!zoneMeta.positionEvent) {
+          dndLog.debug("dragEnd:positions:no-event", { group: zoneMeta.group });
+          return;
+        }
+        const evt = `UI:${zoneMeta.positionEvent}`;
+        const order = optimisticOrdersRef.current.get(zoneMeta.group) ?? zoneMeta.rawItems;
+        order.forEach((it, idx) => {
+          const id = String(it[zoneMeta.idField]);
+          const position = idx * 1e3;
+          eventBus.emit(evt, { id, position });
+        });
+        dndLog.info("dragEnd:positions:emitted", { event: evt, group: zoneMeta.group, count: order.length });
+      };
       if (sourceMeta.group !== targetMeta.group) {
         if (targetMeta.dropEvent) {
           const evt = `UI:${targetMeta.dropEvent}`;
@@ -25086,6 +25101,8 @@ function useDataDnd(args) {
         } else {
           dndLog.warn("dragEnd:cross-container:no-dropEvent-on-target", { targetGroup: targetMeta.group });
         }
+        emitPositions(sourceMeta);
+        emitPositions(targetMeta);
         return;
       }
       if (oldIndex === newIndex) {
@@ -25108,6 +25125,7 @@ function useDataDnd(args) {
       } else {
         dndLog.debug("dragEnd:reorder:no-reorderEvent", { sourceGroup: sourceMeta.group });
       }
+      emitPositions(sourceMeta);
     },
     [eventBus]
   );
@@ -25412,6 +25430,7 @@ function DataGrid({
   sortable,
   dropEvent,
   reorderEvent,
+  positionEvent,
   dndItemIdField,
   dndRoot
 }) {
@@ -25429,6 +25448,7 @@ function DataGrid({
     sortable,
     dropEvent,
     reorderEvent,
+    positionEvent,
     dndItemIdField,
     dndRoot
   });
@@ -25821,6 +25841,7 @@ function DataList({
   sortable: sortableProp,
   dropEvent,
   reorderEvent: dndReorderEvent,
+  positionEvent,
   dndItemIdField,
   dndRoot
 }) {
@@ -25837,6 +25858,7 @@ function DataList({
     sortable: sortableProp,
     dropEvent,
     reorderEvent: dndReorderEvent,
+    positionEvent,
     dndItemIdField,
     dndRoot
   });
@@ -58405,6 +58427,74 @@ function ServerBridgeProvider({
   return /* @__PURE__ */ jsxRuntime.jsx(ServerBridgeContext.Provider, { value: { connected, sendEvent }, children });
 }
 
+// context/OrbitalThemeProvider.tsx
+init_ThemeContext();
+
+// context/themeTokens.ts
+function themeTokensToCssVars(tokens, mode = "light", darkVariant) {
+  const vars = {};
+  const isDark = mode === "dark";
+  const pickColors = isDark && darkVariant?.colors ? darkVariant.colors : tokens.colors;
+  if (pickColors) {
+    for (const [key, value] of Object.entries(pickColors)) {
+      vars[`--color-${key}`] = value;
+    }
+    if (isDark && darkVariant?.colors && tokens.colors) {
+      for (const [key, value] of Object.entries(tokens.colors)) {
+        const varName = `--color-${key}`;
+        if (!(varName in vars)) vars[varName] = value;
+      }
+    }
+  }
+  const pickRadii = isDark && darkVariant?.radii ? darkVariant.radii : tokens.radii;
+  if (pickRadii) {
+    for (const [key, value] of Object.entries(pickRadii)) {
+      vars[`--radius-${key}`] = value;
+    }
+  }
+  const pickSpacing = isDark && darkVariant?.spacing ? darkVariant.spacing : tokens.spacing;
+  if (pickSpacing) {
+    for (const [key, value] of Object.entries(pickSpacing)) {
+      vars[`--space-${key}`] = value;
+    }
+  }
+  const pickTypography = isDark && darkVariant?.typography ? darkVariant.typography : tokens.typography;
+  if (pickTypography) {
+    for (const [key, value] of Object.entries(pickTypography)) {
+      vars[`--${key}`] = value;
+    }
+  }
+  const pickShadows = isDark && darkVariant?.shadows ? darkVariant.shadows : tokens.shadows;
+  if (pickShadows) {
+    for (const [key, value] of Object.entries(pickShadows)) {
+      vars[`--shadow-${key}`] = value;
+    }
+  }
+  return vars;
+}
+function resolveThemeForRuntime(theme) {
+  if (theme === void 0) return void 0;
+  if (typeof theme === "string") return void 0;
+  return theme;
+}
+function OrbitalThemeProvider({ theme, children }) {
+  const resolved = resolveThemeForRuntime(theme);
+  const { resolvedMode } = useTheme();
+  if (!resolved) {
+    return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children });
+  }
+  const vars = themeTokensToCssVars(resolved.tokens, resolvedMode, resolved.variants?.dark);
+  return /* @__PURE__ */ jsxRuntime.jsx(
+    "div",
+    {
+      "data-orbital-theme": resolved.name,
+      style: { display: "contents", ...vars },
+      children
+    }
+  );
+}
+OrbitalThemeProvider.displayName = "OrbitalThemeProvider";
+
 // runtime/OrbPreview.tsx
 init_navigation();
 init_verificationRegistry();
@@ -58816,6 +58906,19 @@ function SchemaRunner({ schema, serverUrl, transport, mockData, pageName, onNavi
     });
     return set;
   }, [schema, pageName]);
+  const activeOrbitalTheme = React93.useMemo(() => {
+    const parsed = schema;
+    if (!parsed?.orbitals?.length) return void 0;
+    if (pageName) {
+      for (const orb of parsed.orbitals) {
+        for (const pageRef of orb.pages ?? []) {
+          const name = typeof pageRef === "object" && pageRef !== null ? pageRef.name : void 0;
+          if (name === pageName) return orb.theme;
+        }
+      }
+    }
+    return parsed.orbitals[0]?.theme;
+  }, [schema, pageName]);
   const inner = /* @__PURE__ */ jsxRuntime.jsx(VerificationProvider, { enabled: true, children: /* @__PURE__ */ jsxRuntime.jsxs(
     EntitySchemaProvider,
     {
@@ -58836,7 +58939,7 @@ function SchemaRunner({ schema, serverUrl, transport, mockData, pageName, onNavi
             persistence
           }
         ),
-        /* @__PURE__ */ jsxRuntime.jsx(Box, { className: "h-full p-4", children: /* @__PURE__ */ jsxRuntime.jsx(UISlotRenderer, { includeHud: true, hudMode: "inline", includeFloating: true }) })
+        /* @__PURE__ */ jsxRuntime.jsx(OrbitalThemeProvider, { theme: activeOrbitalTheme, children: /* @__PURE__ */ jsxRuntime.jsx(Box, { className: "h-full p-4", children: /* @__PURE__ */ jsxRuntime.jsx(UISlotRenderer, { includeHud: true, hudMode: "inline", includeFloating: true }) }) })
       ]
     }
   ) });

package/dist/avl/index.js

@@ -24867,6 +24867,7 @@ function useDataDnd(args) {
     sortable,
     dropEvent,
     reorderEvent,
+    positionEvent,
     dndItemIdField = "id",
     dndRoot,
     items,
@@ -24934,8 +24935,8 @@ function useDataDnd(args) {
   const [activeDrag, setActiveDrag] = React93__default.useState(null);
   const [overZoneGroup, setOverZoneGroup] = React93__default.useState(null);
   const meta = React93__default.useMemo(
-    () => ({ group: ownGroup, dropEvent, reorderEvent, itemIds, rawItems: items, idField: dndItemIdField }),
-    [ownGroup, dropEvent, reorderEvent, itemIds, items, dndItemIdField]
+    () => ({ group: ownGroup, dropEvent, reorderEvent, positionEvent, itemIds, rawItems: items, idField: dndItemIdField }),
+    [ownGroup, dropEvent, reorderEvent, positionEvent, itemIds, items, dndItemIdField]
   );
   React93__default.useEffect(() => {
     const target = isRoot ? null : parentRoot;
@@ -25021,6 +25022,20 @@ function useDataDnd(args) {
         dndLog.warn("dragEnd:abort:no-zone-resolved", { activeId: active.id, hasSource: !!sourceMeta, hasTarget: !!targetMeta });
         return;
       }
+      const emitPositions = (zoneMeta) => {
+        if (!zoneMeta.positionEvent) {
+          dndLog.debug("dragEnd:positions:no-event", { group: zoneMeta.group });
+          return;
+        }
+        const evt = `UI:${zoneMeta.positionEvent}`;
+        const order = optimisticOrdersRef.current.get(zoneMeta.group) ?? zoneMeta.rawItems;
+        order.forEach((it, idx) => {
+          const id = String(it[zoneMeta.idField]);
+          const position = idx * 1e3;
+          eventBus.emit(evt, { id, position });
+        });
+        dndLog.info("dragEnd:positions:emitted", { event: evt, group: zoneMeta.group, count: order.length });
+      };
       if (sourceMeta.group !== targetMeta.group) {
         if (targetMeta.dropEvent) {
           const evt = `UI:${targetMeta.dropEvent}`;
@@ -25040,6 +25055,8 @@ function useDataDnd(args) {
         } else {
           dndLog.warn("dragEnd:cross-container:no-dropEvent-on-target", { targetGroup: targetMeta.group });
         }
+        emitPositions(sourceMeta);
+        emitPositions(targetMeta);
         return;
       }
       if (oldIndex === newIndex) {
@@ -25062,6 +25079,7 @@ function useDataDnd(args) {
       } else {
         dndLog.debug("dragEnd:reorder:no-reorderEvent", { sourceGroup: sourceMeta.group });
       }
+      emitPositions(sourceMeta);
     },
     [eventBus]
   );
@@ -25366,6 +25384,7 @@ function DataGrid({
   sortable,
   dropEvent,
   reorderEvent,
+  positionEvent,
   dndItemIdField,
   dndRoot
 }) {
@@ -25383,6 +25402,7 @@ function DataGrid({
     sortable,
     dropEvent,
     reorderEvent,
+    positionEvent,
     dndItemIdField,
     dndRoot
   });
@@ -25775,6 +25795,7 @@ function DataList({
   sortable: sortableProp,
   dropEvent,
   reorderEvent: dndReorderEvent,
+  positionEvent,
   dndItemIdField,
   dndRoot
 }) {
@@ -25791,6 +25812,7 @@ function DataList({
     sortable: sortableProp,
     dropEvent,
     reorderEvent: dndReorderEvent,
+    positionEvent,
     dndItemIdField,
     dndRoot
   });
@@ -58359,6 +58381,74 @@ function ServerBridgeProvider({
   return /* @__PURE__ */ jsx(ServerBridgeContext.Provider, { value: { connected, sendEvent }, children });
 }
 
+// context/OrbitalThemeProvider.tsx
+init_ThemeContext();
+
+// context/themeTokens.ts
+function themeTokensToCssVars(tokens, mode = "light", darkVariant) {
+  const vars = {};
+  const isDark = mode === "dark";
+  const pickColors = isDark && darkVariant?.colors ? darkVariant.colors : tokens.colors;
+  if (pickColors) {
+    for (const [key, value] of Object.entries(pickColors)) {
+      vars[`--color-${key}`] = value;
+    }
+    if (isDark && darkVariant?.colors && tokens.colors) {
+      for (const [key, value] of Object.entries(tokens.colors)) {
+        const varName = `--color-${key}`;
+        if (!(varName in vars)) vars[varName] = value;
+      }
+    }
+  }
+  const pickRadii = isDark && darkVariant?.radii ? darkVariant.radii : tokens.radii;
+  if (pickRadii) {
+    for (const [key, value] of Object.entries(pickRadii)) {
+      vars[`--radius-${key}`] = value;
+    }
+  }
+  const pickSpacing = isDark && darkVariant?.spacing ? darkVariant.spacing : tokens.spacing;
+  if (pickSpacing) {
+    for (const [key, value] of Object.entries(pickSpacing)) {
+      vars[`--space-${key}`] = value;
+    }
+  }
+  const pickTypography = isDark && darkVariant?.typography ? darkVariant.typography : tokens.typography;
+  if (pickTypography) {
+    for (const [key, value] of Object.entries(pickTypography)) {
+      vars[`--${key}`] = value;
+    }
+  }
+  const pickShadows = isDark && darkVariant?.shadows ? darkVariant.shadows : tokens.shadows;
+  if (pickShadows) {
+    for (const [key, value] of Object.entries(pickShadows)) {
+      vars[`--shadow-${key}`] = value;
+    }
+  }
+  return vars;
+}
+function resolveThemeForRuntime(theme) {
+  if (theme === void 0) return void 0;
+  if (typeof theme === "string") return void 0;
+  return theme;
+}
+function OrbitalThemeProvider({ theme, children }) {
+  const resolved = resolveThemeForRuntime(theme);
+  const { resolvedMode } = useTheme();
+  if (!resolved) {
+    return /* @__PURE__ */ jsx(Fragment, { children });
+  }
+  const vars = themeTokensToCssVars(resolved.tokens, resolvedMode, resolved.variants?.dark);
+  return /* @__PURE__ */ jsx(
+    "div",
+    {
+      "data-orbital-theme": resolved.name,
+      style: { display: "contents", ...vars },
+      children
+    }
+  );
+}
+OrbitalThemeProvider.displayName = "OrbitalThemeProvider";
+
 // runtime/OrbPreview.tsx
 init_navigation();
 init_verificationRegistry();
@@ -58770,6 +58860,19 @@ function SchemaRunner({ schema, serverUrl, transport, mockData, pageName, onNavi
     });
     return set;
   }, [schema, pageName]);
+  const activeOrbitalTheme = useMemo(() => {
+    const parsed = schema;
+    if (!parsed?.orbitals?.length) return void 0;
+    if (pageName) {
+      for (const orb of parsed.orbitals) {
+        for (const pageRef of orb.pages ?? []) {
+          const name = typeof pageRef === "object" && pageRef !== null ? pageRef.name : void 0;
+          if (name === pageName) return orb.theme;
+        }
+      }
+    }
+    return parsed.orbitals[0]?.theme;
+  }, [schema, pageName]);
   const inner = /* @__PURE__ */ jsx(VerificationProvider, { enabled: true, children: /* @__PURE__ */ jsxs(
     EntitySchemaProvider,
     {
@@ -58790,7 +58893,7 @@ function SchemaRunner({ schema, serverUrl, transport, mockData, pageName, onNavi
             persistence
           }
         ),
-        /* @__PURE__ */ jsx(Box, { className: "h-full p-4", children: /* @__PURE__ */ jsx(UISlotRenderer, { includeHud: true, hudMode: "inline", includeFloating: true }) })
+        /* @__PURE__ */ jsx(OrbitalThemeProvider, { theme: activeOrbitalTheme, children: /* @__PURE__ */ jsx(Box, { className: "h-full p-4", children: /* @__PURE__ */ jsx(UISlotRenderer, { includeHud: true, hudMode: "inline", includeFloating: true }) }) })
       ]
     }
   ) });

package/dist/components/index.cjs

@@ -20080,6 +20080,7 @@ function useDataDnd(args) {
     sortable: sortable$1,
     dropEvent,
     reorderEvent,
+    positionEvent,
     dndItemIdField = "id",
     dndRoot,
     items,
@@ -20147,8 +20148,8 @@ function useDataDnd(args) {
   const [activeDrag, setActiveDrag] = React75__namespace.default.useState(null);
   const [overZoneGroup, setOverZoneGroup] = React75__namespace.default.useState(null);
   const meta = React75__namespace.default.useMemo(
-    () => ({ group: ownGroup, dropEvent, reorderEvent, itemIds, rawItems: items, idField: dndItemIdField }),
-    [ownGroup, dropEvent, reorderEvent, itemIds, items, dndItemIdField]
+    () => ({ group: ownGroup, dropEvent, reorderEvent, positionEvent, itemIds, rawItems: items, idField: dndItemIdField }),
+    [ownGroup, dropEvent, reorderEvent, positionEvent, itemIds, items, dndItemIdField]
   );
   React75__namespace.default.useEffect(() => {
     const target = isRoot ? null : parentRoot;
@@ -20234,6 +20235,20 @@ function useDataDnd(args) {
         dndLog.warn("dragEnd:abort:no-zone-resolved", { activeId: active.id, hasSource: !!sourceMeta, hasTarget: !!targetMeta });
         return;
       }
+      const emitPositions = (zoneMeta) => {
+        if (!zoneMeta.positionEvent) {
+          dndLog.debug("dragEnd:positions:no-event", { group: zoneMeta.group });
+          return;
+        }
+        const evt = `UI:${zoneMeta.positionEvent}`;
+        const order = optimisticOrdersRef.current.get(zoneMeta.group) ?? zoneMeta.rawItems;
+        order.forEach((it, idx) => {
+          const id = String(it[zoneMeta.idField]);
+          const position = idx * 1e3;
+          eventBus.emit(evt, { id, position });
+        });
+        dndLog.info("dragEnd:positions:emitted", { event: evt, group: zoneMeta.group, count: order.length });
+      };
       if (sourceMeta.group !== targetMeta.group) {
         if (targetMeta.dropEvent) {
           const evt = `UI:${targetMeta.dropEvent}`;
@@ -20253,6 +20268,8 @@ function useDataDnd(args) {
         } else {
           dndLog.warn("dragEnd:cross-container:no-dropEvent-on-target", { targetGroup: targetMeta.group });
         }
+        emitPositions(sourceMeta);
+        emitPositions(targetMeta);
         return;
       }
       if (oldIndex === newIndex) {
@@ -20275,6 +20292,7 @@ function useDataDnd(args) {
       } else {
         dndLog.debug("dragEnd:reorder:no-reorderEvent", { sourceGroup: sourceMeta.group });
       }
+      emitPositions(sourceMeta);
     },
     [eventBus]
   );
@@ -20579,6 +20597,7 @@ function DataGrid({
   sortable,
   dropEvent,
   reorderEvent,
+  positionEvent,
   dndItemIdField,
   dndRoot
 }) {
@@ -20596,6 +20615,7 @@ function DataGrid({
     sortable,
     dropEvent,
     reorderEvent,
+    positionEvent,
     dndItemIdField,
     dndRoot
   });
@@ -20988,6 +21008,7 @@ function DataList({
   sortable: sortableProp,
   dropEvent,
   reorderEvent: dndReorderEvent,
+  positionEvent,
   dndItemIdField,
   dndRoot
 }) {
@@ -21004,6 +21025,7 @@ function DataList({
     sortable: sortableProp,
     dropEvent,
     reorderEvent: dndReorderEvent,
+    positionEvent,
     dndItemIdField,
     dndRoot
   });

package/dist/components/index.js

@@ -20034,6 +20034,7 @@ function useDataDnd(args) {
     sortable,
     dropEvent,
     reorderEvent,
+    positionEvent,
     dndItemIdField = "id",
     dndRoot,
     items,
@@ -20101,8 +20102,8 @@ function useDataDnd(args) {
   const [activeDrag, setActiveDrag] = React75__default.useState(null);
   const [overZoneGroup, setOverZoneGroup] = React75__default.useState(null);
   const meta = React75__default.useMemo(
-    () => ({ group: ownGroup, dropEvent, reorderEvent, itemIds, rawItems: items, idField: dndItemIdField }),
-    [ownGroup, dropEvent, reorderEvent, itemIds, items, dndItemIdField]
+    () => ({ group: ownGroup, dropEvent, reorderEvent, positionEvent, itemIds, rawItems: items, idField: dndItemIdField }),
+    [ownGroup, dropEvent, reorderEvent, positionEvent, itemIds, items, dndItemIdField]
   );
   React75__default.useEffect(() => {
     const target = isRoot ? null : parentRoot;
@@ -20188,6 +20189,20 @@ function useDataDnd(args) {
         dndLog.warn("dragEnd:abort:no-zone-resolved", { activeId: active.id, hasSource: !!sourceMeta, hasTarget: !!targetMeta });
         return;
       }
+      const emitPositions = (zoneMeta) => {
+        if (!zoneMeta.positionEvent) {
+          dndLog.debug("dragEnd:positions:no-event", { group: zoneMeta.group });
+          return;
+        }
+        const evt = `UI:${zoneMeta.positionEvent}`;
+        const order = optimisticOrdersRef.current.get(zoneMeta.group) ?? zoneMeta.rawItems;
+        order.forEach((it, idx) => {
+          const id = String(it[zoneMeta.idField]);
+          const position = idx * 1e3;
+          eventBus.emit(evt, { id, position });
+        });
+        dndLog.info("dragEnd:positions:emitted", { event: evt, group: zoneMeta.group, count: order.length });
+      };
       if (sourceMeta.group !== targetMeta.group) {
         if (targetMeta.dropEvent) {
           const evt = `UI:${targetMeta.dropEvent}`;
@@ -20207,6 +20222,8 @@ function useDataDnd(args) {
         } else {
           dndLog.warn("dragEnd:cross-container:no-dropEvent-on-target", { targetGroup: targetMeta.group });
         }
+        emitPositions(sourceMeta);
+        emitPositions(targetMeta);
         return;
       }
       if (oldIndex === newIndex) {
@@ -20229,6 +20246,7 @@ function useDataDnd(args) {
       } else {
         dndLog.debug("dragEnd:reorder:no-reorderEvent", { sourceGroup: sourceMeta.group });
       }
+      emitPositions(sourceMeta);
     },
     [eventBus]
   );
@@ -20533,6 +20551,7 @@ function DataGrid({
   sortable,
   dropEvent,
   reorderEvent,
+  positionEvent,
   dndItemIdField,
   dndRoot
 }) {
@@ -20550,6 +20569,7 @@ function DataGrid({
     sortable,
     dropEvent,
     reorderEvent,
+    positionEvent,
     dndItemIdField,
     dndRoot
   });
@@ -20942,6 +20962,7 @@ function DataList({
   sortable: sortableProp,
   dropEvent,
   reorderEvent: dndReorderEvent,
+  positionEvent,
   dndItemIdField,
   dndRoot
 }) {
@@ -20958,6 +20979,7 @@ function DataList({
     sortable: sortableProp,
     dropEvent,
     reorderEvent: dndReorderEvent,
+    positionEvent,
     dndItemIdField,
     dndRoot
   });

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

@@ -103,7 +103,7 @@ export interface DataGridProps<T extends EntityRow = EntityRow> extends DataDndP
     /** Max items to show before "Show More" button. Defaults to 0 (disabled). */
     pageSize?: number;
 }
-export declare function DataGrid<T extends EntityRow = EntityRow>({ entity, fields, columns, itemActions, cols, gap, minCardWidth, className, isLoading, error, imageField, selectable, selectionEvent, infiniteScroll, loadMoreEvent, hasMore, children, pageSize, renderItem: schemaRenderItem, dragGroup, accepts, sortable, dropEvent, reorderEvent, dndItemIdField, dndRoot, }: DataGridProps<T>): string | number | bigint | boolean | import("react/jsx-runtime").JSX.Element | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | null | undefined;
+export declare function DataGrid<T extends EntityRow = EntityRow>({ entity, fields, columns, itemActions, cols, gap, minCardWidth, className, isLoading, error, imageField, selectable, selectionEvent, infiniteScroll, loadMoreEvent, hasMore, children, pageSize, renderItem: schemaRenderItem, dragGroup, accepts, sortable, dropEvent, reorderEvent, positionEvent, dndItemIdField, dndRoot, }: DataGridProps<T>): string | number | bigint | boolean | import("react/jsx-runtime").JSX.Element | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | null | undefined;
 export declare namespace DataGrid {
     var displayName: string;
 }

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

@@ -117,7 +117,7 @@ export interface DataListProps<T extends EntityRow = EntityRow> extends DataDndP
     /** Max items to show before "Show More" button. Defaults to 5. Set to 0 to disable. */
     pageSize?: number;
 }
-export declare function DataList<T extends EntityRow = EntityRow>({ entity, fields, columns, itemActions, gap, variant, groupBy, senderField, currentUser, className, isLoading, error, reorderable: _reorderable, reorderEvent: _reorderEvent, swipeLeftEvent: _swipeLeftEvent, swipeLeftActions: _swipeLeftActions, swipeRightEvent: _swipeRightEvent, swipeRightActions: _swipeRightActions, longPressEvent: _longPressEvent, infiniteScroll, loadMoreEvent, hasMore, children, pageSize, renderItem: schemaRenderItem, dragGroup, accepts, sortable: sortableProp, dropEvent, reorderEvent: dndReorderEvent, dndItemIdField, dndRoot, }: DataListProps<T>): string | number | bigint | boolean | import("react/jsx-runtime").JSX.Element | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | null | undefined;
+export declare function DataList<T extends EntityRow = EntityRow>({ entity, fields, columns, itemActions, gap, variant, groupBy, senderField, currentUser, className, isLoading, error, reorderable: _reorderable, reorderEvent: _reorderEvent, swipeLeftEvent: _swipeLeftEvent, swipeLeftActions: _swipeLeftActions, swipeRightEvent: _swipeRightEvent, swipeRightActions: _swipeRightActions, longPressEvent: _longPressEvent, infiniteScroll, loadMoreEvent, hasMore, children, pageSize, renderItem: schemaRenderItem, dragGroup, accepts, sortable: sortableProp, dropEvent, reorderEvent: dndReorderEvent, positionEvent, dndItemIdField, dndRoot, }: DataListProps<T>): string | number | bigint | boolean | import("react/jsx-runtime").JSX.Element | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | null | undefined;
 export declare namespace DataList {
     var displayName: string;
 }

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

@@ -20,6 +20,14 @@ import React from 'react';
 import { type UniqueIdentifier } from '@dnd-kit/core';
 import type { EntityRow, EventKey } from '@almadar/core';
 export interface DataDndProps {
+    /**
+     * Event emitted N times per drop (one per item in each affected zone) so
+     * the trait can persist new positions for every item — not just the moved
+     * one. Required for stable sort-by-position because setting only the
+     * dragged item's position creates collisions with the (unchanged) others.
+     * Payload: { id : string, position : number }.
+     */
+    positionEvent?: EventKey;
     dragGroup?: string;
     accepts?: string;
     sortable?: boolean;

package/dist/context/OrbitalThemeProvider.d.ts

@@ -0,0 +1,37 @@
+/**
+ * OrbitalThemeProvider — runtime application of `OrbitalDefinition.theme`.
+ *
+ * Wraps an orbital's rendered subtree in a wrapping `<div>` that sets the
+ * CSS variables derived from `theme.tokens` (and `variants.dark` when the
+ * resolved color mode is dark). Inline custom-property declarations on the
+ * wrapper override any `[data-theme]` selector rule for the same variable
+ * within the subtree, while letting unset variables cascade from the parent.
+ *
+ * Mapping is delegated to `themeTokensToCssVars`, which mirrors the Rust
+ * compiler's `generate_tokens_css`. Compile-time and runtime produce the
+ * same CSS variable map for the same `ThemeDefinition` input, so a Studio
+ * Design System edit and an `orbital compile` of the same schema render
+ * identically.
+ *
+ * No-op when:
+ * - `theme` is `undefined` (orbital declares no theme — parent cascades)
+ * - `theme` is a string ref that didn't get inlined upstream
+ *
+ * @example
+ * ```tsx
+ * <OrbitalThemeProvider theme={orbital.theme}>
+ *   <UISlotRenderer />
+ * </OrbitalThemeProvider>
+ * ```
+ */
+import { type ReactElement, type ReactNode } from 'react';
+import type { ThemeRef } from '@almadar/core';
+export interface OrbitalThemeProviderProps {
+    /** The `OrbitalDefinition.theme` value (inline definition or string ref). */
+    theme?: ThemeRef;
+    children: ReactNode;
+}
+export declare function OrbitalThemeProvider({ theme, children }: OrbitalThemeProviderProps): ReactElement;
+export declare namespace OrbitalThemeProvider {
+    var displayName: string;
+}