@almadar/ui 5.12.1 → 5.13.2

package/dist/avl/index.cjs

@@ -21491,6 +21491,7 @@ function CalendarGrid({
   swipeRightEvent,
   dayWindow = "auto"
 }) {
+  const evs = Array.isArray(events2) ? events2 : events2 ? [events2] : [];
   const eventBus = useEventBus();
   const longPressTimer = React98.useRef(null);
   const resolvedWeekStart = React98.useMemo(
@@ -21539,7 +21540,7 @@ function CalendarGrid({
     [onEventClick]
   );
   const eventsForDayCount = React98.useCallback(
-    (day) => events2.filter(
+    (day) => evs.filter(
       (ev) => new Date(ev.startTime).toDateString() === day.toDateString()
     ).length,
     [events2]
@@ -21654,7 +21655,7 @@ function CalendarGrid({
                   }
                 ) }),
                 visibleDays.map((day) => {
-                  const slotEvents = events2.filter(
+                  const slotEvents = evs.filter(
                     (ev) => eventInSlot(ev, day, time)
                   );
                   const isToday = day.toDateString() === (/* @__PURE__ */ new Date()).toDateString();
@@ -33879,7 +33880,7 @@ function useSafeEventBus10() {
   }
 }
 function SortableListInner({
-  items: initialItems = EMPTY_ITEMS,
+  items: initialItemsProp = EMPTY_ITEMS,
   renderItem,
   reorderEvent,
   reorderPayload,
@@ -33887,6 +33888,7 @@ function SortableListInner({
   className
 }) {
   const eventBus = useSafeEventBus10();
+  const initialItems = Array.isArray(initialItemsProp) ? initialItemsProp : initialItemsProp ? [initialItemsProp] : [];
   const handleReorder = React98.useCallback(
     (fromIndex, toIndex, item) => {
       eventBus.emit(`UI:${reorderEvent}`, {
@@ -37383,9 +37385,10 @@ var init_ReplyTree = __esm({
       showActions = true,
       className
     }) => {
+      const nodeList = Array.isArray(nodes) ? nodes : nodes ? [nodes] : [];
       const [collapsedSet, setCollapsedSet] = React98.useState(() => {
         const acc = /* @__PURE__ */ new Set();
-        collectInitiallyCollapsed(nodes, acc);
+        collectInitiallyCollapsed(nodeList, acc);
         return acc;
       });
       const toggleCollapse = React98.useCallback((id) => {
@@ -37399,10 +37402,10 @@ var init_ReplyTree = __esm({
           return next;
         });
       }, []);
-      if (nodes.length === 0) {
+      if (nodeList.length === 0) {
         return /* @__PURE__ */ jsxRuntime.jsx(Box, { className: cn("text-sm text-muted-foreground", className), children: "No replies yet." });
       }
-      return /* @__PURE__ */ jsxRuntime.jsx(Box, { className: cn("flex flex-col gap-2 min-w-0", className), children: nodes.map((node) => /* @__PURE__ */ jsxRuntime.jsx(
+      return /* @__PURE__ */ jsxRuntime.jsx(Box, { className: cn("flex flex-col gap-2 min-w-0", className), children: nodeList.map((node) => /* @__PURE__ */ jsxRuntime.jsx(
         ReplyTreeNode,
         {
           node,

package/dist/avl/index.js

@@ -21442,6 +21442,7 @@ function CalendarGrid({
   swipeRightEvent,
   dayWindow = "auto"
 }) {
+  const evs = Array.isArray(events2) ? events2 : events2 ? [events2] : [];
   const eventBus = useEventBus();
   const longPressTimer = useRef(null);
   const resolvedWeekStart = useMemo(
@@ -21490,7 +21491,7 @@ function CalendarGrid({
     [onEventClick]
   );
   const eventsForDayCount = useCallback(
-    (day) => events2.filter(
+    (day) => evs.filter(
       (ev) => new Date(ev.startTime).toDateString() === day.toDateString()
     ).length,
     [events2]
@@ -21605,7 +21606,7 @@ function CalendarGrid({
                   }
                 ) }),
                 visibleDays.map((day) => {
-                  const slotEvents = events2.filter(
+                  const slotEvents = evs.filter(
                     (ev) => eventInSlot(ev, day, time)
                   );
                   const isToday = day.toDateString() === (/* @__PURE__ */ new Date()).toDateString();
@@ -33830,7 +33831,7 @@ function useSafeEventBus10() {
   }
 }
 function SortableListInner({
-  items: initialItems = EMPTY_ITEMS,
+  items: initialItemsProp = EMPTY_ITEMS,
   renderItem,
   reorderEvent,
   reorderPayload,
@@ -33838,6 +33839,7 @@ function SortableListInner({
   className
 }) {
   const eventBus = useSafeEventBus10();
+  const initialItems = Array.isArray(initialItemsProp) ? initialItemsProp : initialItemsProp ? [initialItemsProp] : [];
   const handleReorder = useCallback(
     (fromIndex, toIndex, item) => {
       eventBus.emit(`UI:${reorderEvent}`, {
@@ -37334,9 +37336,10 @@ var init_ReplyTree = __esm({
       showActions = true,
       className
     }) => {
+      const nodeList = Array.isArray(nodes) ? nodes : nodes ? [nodes] : [];
       const [collapsedSet, setCollapsedSet] = useState(() => {
         const acc = /* @__PURE__ */ new Set();
-        collectInitiallyCollapsed(nodes, acc);
+        collectInitiallyCollapsed(nodeList, acc);
         return acc;
       });
       const toggleCollapse = useCallback((id) => {
@@ -37350,10 +37353,10 @@ var init_ReplyTree = __esm({
           return next;
         });
       }, []);
-      if (nodes.length === 0) {
+      if (nodeList.length === 0) {
         return /* @__PURE__ */ jsx(Box, { className: cn("text-sm text-muted-foreground", className), children: "No replies yet." });
       }
-      return /* @__PURE__ */ jsx(Box, { className: cn("flex flex-col gap-2 min-w-0", className), children: nodes.map((node) => /* @__PURE__ */ jsx(
+      return /* @__PURE__ */ jsx(Box, { className: cn("flex flex-col gap-2 min-w-0", className), children: nodeList.map((node) => /* @__PURE__ */ jsx(
         ReplyTreeNode,
         {
           node,

package/dist/components/atoms/Input.d.ts

@@ -34,4 +34,4 @@ export interface InputProps extends Omit<React.InputHTMLAttributes<HTMLInputElem
     /** onChange handler - accepts events from input, select, or textarea */
     onChange?: React.ChangeEventHandler<HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement>;
 }
-export declare const Input: React.ForwardRefExoticComponent<InputProps & React.RefAttributes<HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement>>;
+export declare const Input: React.ForwardRefExoticComponent<InputProps & React.RefAttributes<HTMLSelectElement | HTMLInputElement | HTMLTextAreaElement>>;

package/dist/components/index.cjs

@@ -16427,6 +16427,7 @@ function CalendarGrid({
   swipeRightEvent,
   dayWindow = "auto"
 }) {
+  const evs = Array.isArray(events2) ? events2 : events2 ? [events2] : [];
   const eventBus = useEventBus();
   const longPressTimer = React80.useRef(null);
   const resolvedWeekStart = React80.useMemo(
@@ -16475,7 +16476,7 @@ function CalendarGrid({
     [onEventClick]
   );
   const eventsForDayCount = React80.useCallback(
-    (day) => events2.filter(
+    (day) => evs.filter(
       (ev) => new Date(ev.startTime).toDateString() === day.toDateString()
     ).length,
     [events2]
@@ -16590,7 +16591,7 @@ function CalendarGrid({
                   }
                 ) }),
                 visibleDays.map((day) => {
-                  const slotEvents = events2.filter(
+                  const slotEvents = evs.filter(
                     (ev) => eventInSlot(ev, day, time)
                   );
                   const isToday = day.toDateString() === (/* @__PURE__ */ new Date()).toDateString();
@@ -29338,7 +29339,7 @@ function useSafeEventBus10() {
   }
 }
 function SortableListInner({
-  items: initialItems = EMPTY_ITEMS,
+  items: initialItemsProp = EMPTY_ITEMS,
   renderItem,
   reorderEvent,
   reorderPayload,
@@ -29346,6 +29347,7 @@ function SortableListInner({
   className
 }) {
   const eventBus = useSafeEventBus10();
+  const initialItems = Array.isArray(initialItemsProp) ? initialItemsProp : initialItemsProp ? [initialItemsProp] : [];
   const handleReorder = React80.useCallback(
     (fromIndex, toIndex, item) => {
       eventBus.emit(`UI:${reorderEvent}`, {
@@ -32842,9 +32844,10 @@ var init_ReplyTree = __esm({
       showActions = true,
       className
     }) => {
+      const nodeList = Array.isArray(nodes) ? nodes : nodes ? [nodes] : [];
       const [collapsedSet, setCollapsedSet] = React80.useState(() => {
         const acc = /* @__PURE__ */ new Set();
-        collectInitiallyCollapsed(nodes, acc);
+        collectInitiallyCollapsed(nodeList, acc);
         return acc;
       });
       const toggleCollapse = React80.useCallback((id) => {
@@ -32858,10 +32861,10 @@ var init_ReplyTree = __esm({
           return next;
         });
       }, []);
-      if (nodes.length === 0) {
+      if (nodeList.length === 0) {
         return /* @__PURE__ */ jsxRuntime.jsx(exports.Box, { className: cn("text-sm text-muted-foreground", className), children: "No replies yet." });
       }
-      return /* @__PURE__ */ jsxRuntime.jsx(exports.Box, { className: cn("flex flex-col gap-2 min-w-0", className), children: nodes.map((node) => /* @__PURE__ */ jsxRuntime.jsx(
+      return /* @__PURE__ */ jsxRuntime.jsx(exports.Box, { className: cn("flex flex-col gap-2 min-w-0", className), children: nodeList.map((node) => /* @__PURE__ */ jsxRuntime.jsx(
         ReplyTreeNode,
         {
           node,

package/dist/components/index.js

@@ -16378,6 +16378,7 @@ function CalendarGrid({
   swipeRightEvent,
   dayWindow = "auto"
 }) {
+  const evs = Array.isArray(events2) ? events2 : events2 ? [events2] : [];
   const eventBus = useEventBus();
   const longPressTimer = useRef(null);
   const resolvedWeekStart = useMemo(
@@ -16426,7 +16427,7 @@ function CalendarGrid({
     [onEventClick]
   );
   const eventsForDayCount = useCallback(
-    (day) => events2.filter(
+    (day) => evs.filter(
       (ev) => new Date(ev.startTime).toDateString() === day.toDateString()
     ).length,
     [events2]
@@ -16541,7 +16542,7 @@ function CalendarGrid({
                   }
                 ) }),
                 visibleDays.map((day) => {
-                  const slotEvents = events2.filter(
+                  const slotEvents = evs.filter(
                     (ev) => eventInSlot(ev, day, time)
                   );
                   const isToday = day.toDateString() === (/* @__PURE__ */ new Date()).toDateString();
@@ -29289,7 +29290,7 @@ function useSafeEventBus10() {
   }
 }
 function SortableListInner({
-  items: initialItems = EMPTY_ITEMS,
+  items: initialItemsProp = EMPTY_ITEMS,
   renderItem,
   reorderEvent,
   reorderPayload,
@@ -29297,6 +29298,7 @@ function SortableListInner({
   className
 }) {
   const eventBus = useSafeEventBus10();
+  const initialItems = Array.isArray(initialItemsProp) ? initialItemsProp : initialItemsProp ? [initialItemsProp] : [];
   const handleReorder = useCallback(
     (fromIndex, toIndex, item) => {
       eventBus.emit(`UI:${reorderEvent}`, {
@@ -32793,9 +32795,10 @@ var init_ReplyTree = __esm({
       showActions = true,
       className
     }) => {
+      const nodeList = Array.isArray(nodes) ? nodes : nodes ? [nodes] : [];
       const [collapsedSet, setCollapsedSet] = useState(() => {
         const acc = /* @__PURE__ */ new Set();
-        collectInitiallyCollapsed(nodes, acc);
+        collectInitiallyCollapsed(nodeList, acc);
         return acc;
       });
       const toggleCollapse = useCallback((id) => {
@@ -32809,10 +32812,10 @@ var init_ReplyTree = __esm({
           return next;
         });
       }, []);
-      if (nodes.length === 0) {
+      if (nodeList.length === 0) {
         return /* @__PURE__ */ jsx(Box, { className: cn("text-sm text-muted-foreground", className), children: "No replies yet." });
       }
-      return /* @__PURE__ */ jsx(Box, { className: cn("flex flex-col gap-2 min-w-0", className), children: nodes.map((node) => /* @__PURE__ */ jsx(
+      return /* @__PURE__ */ jsx(Box, { className: cn("flex flex-col gap-2 min-w-0", className), children: nodeList.map((node) => /* @__PURE__ */ jsx(
         ReplyTreeNode,
         {
           node,

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

@@ -6,7 +6,7 @@
  * Composes DayCell and TimeSlotCell atoms into a 7-day grid.
  */
 import React from "react";
-import type { EventEmit, EventPayload } from "@almadar/core";
+import type { EventEmit, EventPayload, EntityCollection } from "@almadar/core";
 export interface CalendarEvent {
     id: string;
     title: string;
@@ -26,7 +26,7 @@ export interface CalendarGridProps {
     /** Time slot labels (defaults to 09:00-17:00) */
     timeSlots?: string[];
     /** Events to display on the grid */
-    events?: CalendarEvent[];
+    events?: EntityCollection<CalendarEvent>;
     /** Called when a time slot is clicked */
     onSlotClick?: (day: Date, time: string) => void;
     /** Called when a day header is clicked */

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

@@ -11,7 +11,7 @@
  * Uses atoms only internally: Box, VStack, HStack, Typography, Badge, Button, Icon.
  */
 import React from 'react';
-import type { EntityRow, EventKey } from '@almadar/core';
+import type { EntityRow, EventKey, EntityCollection } from '@almadar/core';
 import { type DataDndProps } from './useDataDnd';
 export interface DataGridField {
     /** Entity field name (dot-notation supported) */
@@ -54,8 +54,14 @@ export interface DataGridProps<T extends EntityRow = EntityRow> extends DataDndP
      * without widening. The generic `T` lets consumers pass a narrower
      * entity (e.g. `CartItem`) and have the `children` render function
      * receive cards typed to that exact shape.
+     *
+     * Declared as the pattern's data INLET via `EntityCollection<T>` (the inlet
+     * half of the circuit, symmetric with the `EventKey` outlet props below):
+     * pattern-sync tags it `kind:"entity", cardinality:"collection"` so consumers
+     * bind the domain entity without name-matching the prop. Structurally still
+     * `T | readonly T[]` — see the brand's doc.
      */
-    entity: T | readonly T[];
+    entity: EntityCollection<T>;
     /**
      * Field definitions for rendering each card. The pattern contract in
      * `@almadar/patterns` documents `columns` as the wire-format alias the

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

@@ -11,7 +11,7 @@
  * Uses atoms only internally: Box, VStack, HStack, Typography, Badge, Button, Icon.
  */
 import React from 'react';
-import type { EntityRow, EventKey } from "@almadar/core";
+import type { EntityRow, EntityCollection, EventKey } from "@almadar/core";
 import { type DataDndProps } from './useDataDnd';
 export interface DataListField {
     /** Entity field name (dot-notation supported) */
@@ -45,7 +45,7 @@ export interface DataListProps<T extends EntityRow = EntityRow> extends DataDndP
      * entity (e.g. `CartItem`) and have the `children` render function
      * receive items of that exact shape.
      */
-    entity: T | readonly T[];
+    entity: EntityCollection<T>;
     /**
      * Field definitions for rendering each row. The pattern contract in
      * `@almadar/patterns` documents `columns` as the wire-format alias the

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

@@ -1,5 +1,5 @@
 import React from "react";
-import type { EventEmit, EventPayloadValue } from "@almadar/core";
+import type { EventEmit, EntityCollection } from "@almadar/core";
 export type CanvasItemStatus = 'empty' | 'seated' | 'ordered' | 'awaiting-bill' | 'cleaning';
 export type CanvasItemShape = 'round' | 'rectangle' | 'square';
 export interface CanvasItem {
@@ -20,7 +20,7 @@ export interface PositionedCanvasProps {
      * molecule narrows non-array values to `[]` and validates element shape at
      * render time via the `id` / `x` / `y` guards.
      */
-    items: readonly CanvasItem[] | EventPayloadValue;
+    items: EntityCollection<CanvasItem>;
     width?: number;
     height?: number;
     selectedId?: string | null;

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

@@ -5,7 +5,7 @@
  * Composes the VoteStack molecule + Avatar/Typography/Button atoms.
  */
 import React from "react";
-import type { EventEmit } from "@almadar/core";
+import type { EventEmit, EntityCollection } from "@almadar/core";
 import { type VoteValue } from "../molecules/VoteStack";
 export interface ReplyNode {
     id: string;
@@ -19,7 +19,7 @@ export interface ReplyNode {
     collapsed?: boolean;
 }
 export interface ReplyTreeProps {
-    nodes: ReplyNode[];
+    nodes: EntityCollection<ReplyNode>;
     maxDepth?: number;
     onVote?: (nodeId: string, vote: VoteValue) => void;
     onReply?: (parentNodeId: string) => void;

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

@@ -6,9 +6,9 @@
  * Shows a drop indicator line at the target position during drag.
  */
 import React from 'react';
-import type { EventKey, EventPayload, EventPayloadValue } from "@almadar/core";
+import type { EntityCollection, EventKey, EventPayload, EventPayloadValue } from "@almadar/core";
 export interface SortableListProps<T extends EventPayloadValue = EventPayload> {
-    items: T[];
+    items: EntityCollection<T>;
     renderItem: (item: T, index: number) => React.ReactNode;
     reorderEvent: EventKey;
     reorderPayload?: EventPayload;

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

@@ -12,7 +12,7 @@
  * Icon, Checkbox, Divider.
  */
 import React from 'react';
-import type { EntityRow, EventKey } from '@almadar/core';
+import type { EntityRow, EventKey, EntityCollection } from '@almadar/core';
 import { type DataDndProps } from './useDataDnd';
 export interface TableViewColumn {
     /** Stable column key (React key + default value lookup). */
@@ -52,7 +52,7 @@ export interface TableViewItemAction {
 }
 export interface TableViewProps<T extends EntityRow = EntityRow> extends DataDndProps {
     /** Schema entity data — single record or collection. */
-    entity: T | readonly T[];
+    entity: EntityCollection<T>;
     /** Column definitions. The compiler emits `columns`; `fields` is the alias. */
     columns?: readonly TableViewColumn[];
     /** Alias for `columns`. */

package/dist/components/organisms/DetailPanel.d.ts

@@ -7,6 +7,7 @@
  * See EntityDisplayProps in ./types.ts for base prop contract.
  */
 import React from "react";
+import type { EntityRecord, EntityRow } from "@almadar/core";
 import type { LucideIcon } from "lucide-react";
 import type { EntityDisplayProps } from "./types";
 export interface DetailField {
@@ -44,6 +45,8 @@ export type FieldDef = string | {
     type: string;
 };
 export interface DetailPanelProps extends EntityDisplayProps {
+    /** RECORD-cardinality override: renders ONE record (see body collapse below). */
+    entity?: EntityRecord<EntityRow>;
     title?: string;
     subtitle?: string;
     status?: {

package/dist/components/organisms/HeroOrganism.d.ts

@@ -10,9 +10,11 @@
  * - Never listens to events
  */
 import React from 'react';
+import type { EntityRecord } from '@almadar/core';
 import type { EntityDisplayProps } from './types';
 import type { HeroEntity } from './marketing-types';
 export interface HeroOrganismProps extends EntityDisplayProps<HeroEntity> {
+    entity?: EntityRecord<HeroEntity>;
     children?: React.ReactNode;
 }
 export declare const HeroOrganism: React.FC<HeroOrganismProps>;

package/dist/components/organisms/Timeline.d.ts

@@ -12,7 +12,7 @@
  */
 import React from "react";
 import type { EventKey } from "@almadar/core";
-import type { EntityRow } from "@almadar/core";
+import type { EntityCollection, EntityRow } from "@almadar/core";
 import type { LucideIcon } from "lucide-react";
 export type TimelineItemStatus = "complete" | "active" | "pending" | "error";
 /**
@@ -55,7 +55,7 @@ export interface TimelineProps {
      * TimelineItem fields (`icon`, callbacks) cannot round-trip through the
      * event bus, so decorative stories that need them pass `items` directly.
      */
-    entity?: EntityRow | readonly EntityRow[];
+    entity?: EntityCollection<EntityRow>;
     /** Timeline title */
     title?: string;
     /** Timeline items */

package/dist/components/organisms/book/BookViewer.d.ts

@@ -17,9 +17,12 @@
  * - Listens: UI:BOOK_START, UI:BOOK_NAVIGATE, UI:BOOK_PAGE_PREV/NEXT, UI:BOOK_PRINT, UI:BOOK_SHOW_TOC
  */
 import React from 'react';
+import type { EntityRecord, EntityRow } from '@almadar/core';
 import type { EntityDisplayProps } from '../types';
 import type { BookFieldMap } from './types';
 export interface BookViewerProps extends EntityDisplayProps {
+    /** Renders ONE record (the book), not a collection */
+    entity?: EntityRecord<EntityRow>;
     /** Initial page index (default: 0 = cover) */
     initialPage?: number;
     /** Field name translation map — a BookFieldMap object or locale key ("ar") */

package/dist/components/organisms/types.d.ts

@@ -7,7 +7,7 @@
  * Exception: Form manages local `formData` state for field input tracking.
  * This is the ONE allowed exception — documented here.
  */
-import type { EntityRow } from '@almadar/core';
+import type { EntityRow, EntityInlet } from '@almadar/core';
 export declare const EntityDisplayEvents: {
     readonly SORT: "SORT";
     readonly PAGINATE: "PAGINATE";
@@ -61,7 +61,7 @@ export interface EntityDisplayProps<T extends EntityRow = EntityRow> {
      * extend `EntityRow`. They surface `EntityDisplayProps<T>` constraint errors.
      * Tracked as a Phase 7 follow-up in `docs/Almadar_Entity_V2_Plan.md` §10.
      */
-    entity?: T | readonly T[];
+    entity?: EntityInlet<T>;
     /** Additional CSS classes */
     className?: string;
     /** Loading state indicator */

package/dist/docs/index.d.cts

@@ -318,7 +318,7 @@ interface InputProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, "
     /** onChange handler - accepts events from input, select, or textarea */
     onChange?: React.ChangeEventHandler<HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement>;
 }
-declare const Input: React.ForwardRefExoticComponent<InputProps & React.RefAttributes<HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement>>;
+declare const Input: React.ForwardRefExoticComponent<InputProps & React.RefAttributes<HTMLSelectElement | HTMLInputElement | HTMLTextAreaElement>>;
 
 /**
  * DocSidebar Molecule Component

package/dist/providers/index.cjs

@@ -17903,6 +17903,7 @@ function CalendarGrid({
   swipeRightEvent,
   dayWindow = "auto"
 }) {
+  const evs = Array.isArray(events2) ? events2 : events2 ? [events2] : [];
   const eventBus = useEventBus();
   const longPressTimer = React86.useRef(null);
   const resolvedWeekStart = React86.useMemo(
@@ -17951,7 +17952,7 @@ function CalendarGrid({
     [onEventClick]
   );
   const eventsForDayCount = React86.useCallback(
-    (day) => events2.filter(
+    (day) => evs.filter(
       (ev) => new Date(ev.startTime).toDateString() === day.toDateString()
     ).length,
     [events2]
@@ -18066,7 +18067,7 @@ function CalendarGrid({
                   }
                 ) }),
                 visibleDays.map((day) => {
-                  const slotEvents = events2.filter(
+                  const slotEvents = evs.filter(
                     (ev) => eventInSlot(ev, day, time)
                   );
                   const isToday = day.toDateString() === (/* @__PURE__ */ new Date()).toDateString();
@@ -30291,7 +30292,7 @@ function useSafeEventBus10() {
   }
 }
 function SortableListInner({
-  items: initialItems = EMPTY_ITEMS,
+  items: initialItemsProp = EMPTY_ITEMS,
   renderItem,
   reorderEvent,
   reorderPayload,
@@ -30299,6 +30300,7 @@ function SortableListInner({
   className
 }) {
   const eventBus = useSafeEventBus10();
+  const initialItems = Array.isArray(initialItemsProp) ? initialItemsProp : initialItemsProp ? [initialItemsProp] : [];
   const handleReorder = React86.useCallback(
     (fromIndex, toIndex, item) => {
       eventBus.emit(`UI:${reorderEvent}`, {
@@ -33795,9 +33797,10 @@ var init_ReplyTree = __esm({
       showActions = true,
       className
     }) => {
+      const nodeList = Array.isArray(nodes) ? nodes : nodes ? [nodes] : [];
       const [collapsedSet, setCollapsedSet] = React86.useState(() => {
         const acc = /* @__PURE__ */ new Set();
-        collectInitiallyCollapsed(nodes, acc);
+        collectInitiallyCollapsed(nodeList, acc);
         return acc;
       });
       const toggleCollapse = React86.useCallback((id) => {
@@ -33811,10 +33814,10 @@ var init_ReplyTree = __esm({
           return next;
         });
       }, []);
-      if (nodes.length === 0) {
+      if (nodeList.length === 0) {
         return /* @__PURE__ */ jsxRuntime.jsx(Box, { className: cn("text-sm text-muted-foreground", className), children: "No replies yet." });
       }
-      return /* @__PURE__ */ jsxRuntime.jsx(Box, { className: cn("flex flex-col gap-2 min-w-0", className), children: nodes.map((node) => /* @__PURE__ */ jsxRuntime.jsx(
+      return /* @__PURE__ */ jsxRuntime.jsx(Box, { className: cn("flex flex-col gap-2 min-w-0", className), children: nodeList.map((node) => /* @__PURE__ */ jsxRuntime.jsx(
         ReplyTreeNode,
         {
           node,

package/dist/providers/index.js

@@ -17854,6 +17854,7 @@ function CalendarGrid({
   swipeRightEvent,
   dayWindow = "auto"
 }) {
+  const evs = Array.isArray(events2) ? events2 : events2 ? [events2] : [];
   const eventBus = useEventBus();
   const longPressTimer = useRef(null);
   const resolvedWeekStart = useMemo(
@@ -17902,7 +17903,7 @@ function CalendarGrid({
     [onEventClick]
   );
   const eventsForDayCount = useCallback(
-    (day) => events2.filter(
+    (day) => evs.filter(
       (ev) => new Date(ev.startTime).toDateString() === day.toDateString()
     ).length,
     [events2]
@@ -18017,7 +18018,7 @@ function CalendarGrid({
                   }
                 ) }),
                 visibleDays.map((day) => {
-                  const slotEvents = events2.filter(
+                  const slotEvents = evs.filter(
                     (ev) => eventInSlot(ev, day, time)
                   );
                   const isToday = day.toDateString() === (/* @__PURE__ */ new Date()).toDateString();
@@ -30242,7 +30243,7 @@ function useSafeEventBus10() {
   }
 }
 function SortableListInner({
-  items: initialItems = EMPTY_ITEMS,
+  items: initialItemsProp = EMPTY_ITEMS,
   renderItem,
   reorderEvent,
   reorderPayload,
@@ -30250,6 +30251,7 @@ function SortableListInner({
   className
 }) {
   const eventBus = useSafeEventBus10();
+  const initialItems = Array.isArray(initialItemsProp) ? initialItemsProp : initialItemsProp ? [initialItemsProp] : [];
   const handleReorder = useCallback(
     (fromIndex, toIndex, item) => {
       eventBus.emit(`UI:${reorderEvent}`, {
@@ -33746,9 +33748,10 @@ var init_ReplyTree = __esm({
       showActions = true,
       className
     }) => {
+      const nodeList = Array.isArray(nodes) ? nodes : nodes ? [nodes] : [];
       const [collapsedSet, setCollapsedSet] = useState(() => {
         const acc = /* @__PURE__ */ new Set();
-        collectInitiallyCollapsed(nodes, acc);
+        collectInitiallyCollapsed(nodeList, acc);
         return acc;
       });
       const toggleCollapse = useCallback((id) => {
@@ -33762,10 +33765,10 @@ var init_ReplyTree = __esm({
           return next;
         });
       }, []);
-      if (nodes.length === 0) {
+      if (nodeList.length === 0) {
         return /* @__PURE__ */ jsx(Box, { className: cn("text-sm text-muted-foreground", className), children: "No replies yet." });
       }
-      return /* @__PURE__ */ jsx(Box, { className: cn("flex flex-col gap-2 min-w-0", className), children: nodes.map((node) => /* @__PURE__ */ jsx(
+      return /* @__PURE__ */ jsx(Box, { className: cn("flex flex-col gap-2 min-w-0", className), children: nodeList.map((node) => /* @__PURE__ */ jsx(
         ReplyTreeNode,
         {
           node,

package/dist/runtime/index.cjs

@@ -17686,6 +17686,7 @@ function CalendarGrid({
   swipeRightEvent,
   dayWindow = "auto"
 }) {
+  const evs = Array.isArray(events2) ? events2 : events2 ? [events2] : [];
   const eventBus = useEventBus();
   const longPressTimer = React85.useRef(null);
   const resolvedWeekStart = React85.useMemo(
@@ -17734,7 +17735,7 @@ function CalendarGrid({
     [onEventClick]
   );
   const eventsForDayCount = React85.useCallback(
-    (day) => events2.filter(
+    (day) => evs.filter(
       (ev) => new Date(ev.startTime).toDateString() === day.toDateString()
     ).length,
     [events2]
@@ -17849,7 +17850,7 @@ function CalendarGrid({
                   }
                 ) }),
                 visibleDays.map((day) => {
-                  const slotEvents = events2.filter(
+                  const slotEvents = evs.filter(
                     (ev) => eventInSlot(ev, day, time)
                   );
                   const isToday = day.toDateString() === (/* @__PURE__ */ new Date()).toDateString();
@@ -29923,7 +29924,7 @@ function useSafeEventBus10() {
   }
 }
 function SortableListInner({
-  items: initialItems = EMPTY_ITEMS,
+  items: initialItemsProp = EMPTY_ITEMS,
   renderItem,
   reorderEvent,
   reorderPayload,
@@ -29931,6 +29932,7 @@ function SortableListInner({
   className
 }) {
   const eventBus = useSafeEventBus10();
+  const initialItems = Array.isArray(initialItemsProp) ? initialItemsProp : initialItemsProp ? [initialItemsProp] : [];
   const handleReorder = React85.useCallback(
     (fromIndex, toIndex, item) => {
       eventBus.emit(`UI:${reorderEvent}`, {
@@ -33362,9 +33364,10 @@ var init_ReplyTree = __esm({
       showActions = true,
       className
     }) => {
+      const nodeList = Array.isArray(nodes) ? nodes : nodes ? [nodes] : [];
       const [collapsedSet, setCollapsedSet] = React85.useState(() => {
         const acc = /* @__PURE__ */ new Set();
-        collectInitiallyCollapsed(nodes, acc);
+        collectInitiallyCollapsed(nodeList, acc);
         return acc;
       });
       const toggleCollapse = React85.useCallback((id) => {
@@ -33378,10 +33381,10 @@ var init_ReplyTree = __esm({
           return next;
         });
       }, []);
-      if (nodes.length === 0) {
+      if (nodeList.length === 0) {
         return /* @__PURE__ */ jsxRuntime.jsx(Box, { className: cn("text-sm text-muted-foreground", className), children: "No replies yet." });
       }
-      return /* @__PURE__ */ jsxRuntime.jsx(Box, { className: cn("flex flex-col gap-2 min-w-0", className), children: nodes.map((node) => /* @__PURE__ */ jsxRuntime.jsx(
+      return /* @__PURE__ */ jsxRuntime.jsx(Box, { className: cn("flex flex-col gap-2 min-w-0", className), children: nodeList.map((node) => /* @__PURE__ */ jsxRuntime.jsx(
         ReplyTreeNode,
         {
           node,

package/dist/runtime/index.js

@@ -17637,6 +17637,7 @@ function CalendarGrid({
   swipeRightEvent,
   dayWindow = "auto"
 }) {
+  const evs = Array.isArray(events2) ? events2 : events2 ? [events2] : [];
   const eventBus = useEventBus();
   const longPressTimer = useRef(null);
   const resolvedWeekStart = useMemo(
@@ -17685,7 +17686,7 @@ function CalendarGrid({
     [onEventClick]
   );
   const eventsForDayCount = useCallback(
-    (day) => events2.filter(
+    (day) => evs.filter(
       (ev) => new Date(ev.startTime).toDateString() === day.toDateString()
     ).length,
     [events2]
@@ -17800,7 +17801,7 @@ function CalendarGrid({
                   }
                 ) }),
                 visibleDays.map((day) => {
-                  const slotEvents = events2.filter(
+                  const slotEvents = evs.filter(
                     (ev) => eventInSlot(ev, day, time)
                   );
                   const isToday = day.toDateString() === (/* @__PURE__ */ new Date()).toDateString();
@@ -29874,7 +29875,7 @@ function useSafeEventBus10() {
   }
 }
 function SortableListInner({
-  items: initialItems = EMPTY_ITEMS,
+  items: initialItemsProp = EMPTY_ITEMS,
   renderItem,
   reorderEvent,
   reorderPayload,
@@ -29882,6 +29883,7 @@ function SortableListInner({
   className
 }) {
   const eventBus = useSafeEventBus10();
+  const initialItems = Array.isArray(initialItemsProp) ? initialItemsProp : initialItemsProp ? [initialItemsProp] : [];
   const handleReorder = useCallback(
     (fromIndex, toIndex, item) => {
       eventBus.emit(`UI:${reorderEvent}`, {
@@ -33313,9 +33315,10 @@ var init_ReplyTree = __esm({
       showActions = true,
       className
     }) => {
+      const nodeList = Array.isArray(nodes) ? nodes : nodes ? [nodes] : [];
       const [collapsedSet, setCollapsedSet] = useState(() => {
         const acc = /* @__PURE__ */ new Set();
-        collectInitiallyCollapsed(nodes, acc);
+        collectInitiallyCollapsed(nodeList, acc);
         return acc;
       });
       const toggleCollapse = useCallback((id) => {
@@ -33329,10 +33332,10 @@ var init_ReplyTree = __esm({
           return next;
         });
       }, []);
-      if (nodes.length === 0) {
+      if (nodeList.length === 0) {
         return /* @__PURE__ */ jsx(Box, { className: cn("text-sm text-muted-foreground", className), children: "No replies yet." });
       }
-      return /* @__PURE__ */ jsx(Box, { className: cn("flex flex-col gap-2 min-w-0", className), children: nodes.map((node) => /* @__PURE__ */ jsx(
+      return /* @__PURE__ */ jsx(Box, { className: cn("flex flex-col gap-2 min-w-0", className), children: nodeList.map((node) => /* @__PURE__ */ jsx(
         ReplyTreeNode,
         {
           node,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/ui",
-  "version": "5.12.1",
+  "version": "5.13.2",
   "description": "React UI components, hooks, and providers for Almadar",
   "type": "module",
   "sideEffects": [
@@ -129,10 +129,10 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@almadar/core": "^9.0.0",
+    "@almadar/core": ">=9.8.0",
     "@almadar/evaluator": ">=2.9.2",
     "@almadar/logger": "^1.3.0",
-    "@almadar/patterns": "^2.26.0",
+    "@almadar/patterns": ">=2.35.0",
     "@almadar/runtime": "^6.7.0",
     "@almadar/std": ">=6.4.1",
     "@almadar/syntax": ">=1.3.1",
@@ -232,5 +232,8 @@
       "@types/react": "^19.0.0",
       "@types/react-dom": "^19.0.0"
     }
+  },
+  "overrides": {
+    "@almadar/core": "$@almadar/core"
   }
 }