@almadar/ui 5.126.0 → 5.127.0

package/dist/avl/index.cjs

@@ -21142,6 +21142,32 @@ var init_ButtonGroup = __esm({
     ButtonGroup.displayName = "ButtonGroup";
   }
 });
+
+// lib/getNestedValue.ts
+function getNestedValue(obj, path) {
+  if (obj === null || obj === void 0 || !path) {
+    return void 0;
+  }
+  if (!path.includes(".")) {
+    return obj[path];
+  }
+  const parts = path.split(".");
+  let value = obj;
+  for (const part of parts) {
+    if (value === null || value === void 0) {
+      return void 0;
+    }
+    if (typeof value !== "object" || Array.isArray(value)) {
+      return void 0;
+    }
+    value = value[part];
+  }
+  return value;
+}
+var init_getNestedValue = __esm({
+  "lib/getNestedValue.ts"() {
+  }
+});
 function useSwipeGesture(callbacks, options = {}) {
   const { threshold = 50, velocityThreshold = 0.3, preventDefault = false } = options;
   const startX = React91.useRef(0);
@@ -21255,11 +21281,15 @@ function getWeekDays(start) {
   }
   return days;
 }
-function generateDefaultTimeSlots(events2) {
+function eventStartDate(event, startField) {
+  const raw = getNestedValue(event, startField);
+  return new Date(raw ?? "");
+}
+function generateDefaultTimeSlots(events2, startField) {
   let first = DEFAULT_FIRST_HOUR;
   let last = DEFAULT_LAST_HOUR;
   for (const ev of events2) {
-    const start = new Date(ev.startTime);
+    const start = eventStartDate(ev, startField);
     if (Number.isNaN(start.getTime())) continue;
     const hour = start.getHours();
     if (hour < first) first = hour;
@@ -21271,8 +21301,8 @@ function generateDefaultTimeSlots(events2) {
   }
   return slots;
 }
-function eventInSlot(event, day, slotTime) {
-  const eventStart = new Date(event.startTime);
+function eventInSlot(event, day, slotTime, startField) {
+  const eventStart = eventStartDate(event, startField);
   if (Number.isNaN(eventStart.getTime())) return false;
   const [slotHour] = slotTime.split(":").map(Number);
   return eventStart.toDateString() === day.toDateString() && eventStart.getHours() === slotHour;
@@ -21289,7 +21319,12 @@ function CalendarGrid({
   longPressPayload,
   swipeLeftEvent,
   swipeRightEvent,
-  dayWindow = "auto"
+  dayWindow = "auto",
+  titleField = "title",
+  startField = "startTime",
+  colorField = "color",
+  children,
+  renderItem
 }) {
   const evs = Array.isArray(events2) ? events2 : events2 ? [events2] : [];
   const eventBus = useEventBus();
@@ -21304,8 +21339,8 @@ function CalendarGrid({
     [resolvedWeekStart]
   );
   const resolvedTimeSlots = React91.useMemo(
-    () => timeSlots ?? generateDefaultTimeSlots(evs),
-    [timeSlots, evs]
+    () => timeSlots ?? generateDefaultTimeSlots(evs, startField),
+    [timeSlots, evs, startField]
   );
   const visibleCount = useDayWindow(dayWindow);
   const [dayOffset, setDayOffset] = React91.useState(0);
@@ -21342,9 +21377,9 @@ function CalendarGrid({
   );
   const eventsForDayCount = React91.useCallback(
     (day) => evs.filter(
-      (ev) => new Date(ev.startTime).toDateString() === day.toDateString()
+      (ev) => eventStartDate(ev, startField).toDateString() === day.toDateString()
     ).length,
-    [events2]
+    [events2, startField]
   );
   const swipeCallbacks = React91.useMemo(() => ({
     onSwipeLeft: swipeLeftEvent ? () => eventBus.emit(`UI:${swipeLeftEvent}`, {}) : void 0,
@@ -21363,8 +21398,11 @@ function CalendarGrid({
       eventBus.emit(`UI:${longPressEvent}`, { date: day.toISOString(), time, ...longPressPayload });
     }, 500);
   }, [longPressEvent, longPressPayload, eventBus]);
+  const renderChip = children ?? renderItem;
   const renderEvent = (event) => {
-    const color = event.color;
+    const color = getNestedValue(event, colorField);
+    const label = String(getNestedValue(event, titleField) ?? "");
+    const eventIndex = evs.indexOf(event);
     return /* @__PURE__ */ jsxRuntime.jsx(
       Box,
       {
@@ -21376,7 +21414,7 @@ function CalendarGrid({
           color ? color : "bg-primary/10 border-primary/30 text-primary"
         ),
         onClick: (e) => handleEventClick(event, e),
-        children: /* @__PURE__ */ jsxRuntime.jsx(Typography, { variant: "small", className: "truncate font-medium", children: event.title })
+        children: renderChip ? renderChip(event, eventIndex) : /* @__PURE__ */ jsxRuntime.jsx(Typography, { variant: "small", className: "truncate font-medium", children: label })
       },
       event.id
     );
@@ -21460,7 +21498,7 @@ function CalendarGrid({
                 ) }),
                 visibleDays.map((day) => {
                   const slotEvents = evs.filter(
-                    (ev) => eventInSlot(ev, day, time)
+                    (ev) => eventInSlot(ev, day, time, startField)
                   );
                   const isToday = day.toDateString() === (/* @__PURE__ */ new Date()).toDateString();
                   return /* @__PURE__ */ jsxRuntime.jsx(
@@ -21497,6 +21535,7 @@ var init_CalendarGrid = __esm({
   "components/core/molecules/CalendarGrid.tsx"() {
     "use client";
     init_cn();
+    init_getNestedValue();
     init_Box();
     init_Button();
     init_Stack();
@@ -21513,32 +21552,6 @@ var init_CalendarGrid = __esm({
     CalendarGrid.displayName = "CalendarGrid";
   }
 });
-
-// lib/getNestedValue.ts
-function getNestedValue(obj, path) {
-  if (obj === null || obj === void 0 || !path) {
-    return void 0;
-  }
-  if (!path.includes(".")) {
-    return obj[path];
-  }
-  const parts = path.split(".");
-  let value = obj;
-  for (const part of parts) {
-    if (value === null || value === void 0) {
-      return void 0;
-    }
-    if (typeof value !== "object" || Array.isArray(value)) {
-      return void 0;
-    }
-    value = value[part];
-  }
-  return value;
-}
-var init_getNestedValue = __esm({
-  "lib/getNestedValue.ts"() {
-  }
-});
 var Pagination;
 var init_Pagination = __esm({
   "components/core/molecules/Pagination.tsx"() {
@@ -51291,7 +51304,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
           crossTraitLog.debug("listen:fired", { busKey, targetTrait: binding.trait.name, triggers: listen.triggers });
           enqueueAndDrain(
             listen.triggers,
-            core.applyListenPayloadMapping(listen.payloadMapping, event.payload),
+            core.applyListenPayloadMapping(listen.payloadMapping, event.payload, evaluator.evaluateListenPayloadExpr),
             binding.trait.name
           );
         });

package/dist/avl/index.js

@@ -10,7 +10,7 @@ import * as LucideIcons2 from 'lucide-react';
 import { Loader2, X, Code, FileText, WrapText, Check, Copy, Lightbulb, CheckCircle, List, Printer, ChevronRight, ChevronLeft, GitBranch, Pencil, Eye, Plus, ArrowRight, Trash, RotateCcw, Play, Terminal, XCircle, AlertTriangle, Trash2, Link2, ZoomOut, ZoomIn, Download, ChevronDown, Menu as Menu$1, Package, Calendar, MoreHorizontal, Image as Image$1, Upload, ArrowLeft, HelpCircle, PauseCircle, Search, Type, Heading1, Heading2, Heading3, ListOrdered, Quote, Minus, Eraser, TrendingUp, TrendingDown, AlertCircle, Circle, Clock, CheckCircle2, ChevronUp, Tag, User, DollarSign } from 'lucide-react';
 import { createPortal } from 'react-dom';
 import { UISlotProvider, useUISlots, useTheme } from '@almadar/ui/context';
-import { evaluateGuard, evaluate, createMinimalContext, executeEffects } from '@almadar/evaluator';
+import { evaluateGuard, evaluateListenPayloadExpr, evaluate, createMinimalContext, executeEffects } from '@almadar/evaluator';
 import { prepareSchemaForPreview, collectTraitRefsFromResolvedTrait, buildOrbitalsByTrait, collectEmbeddedTraits, wrapCallbackForEvent, pushPerfEntry, perfStart, perfEnd } from '@almadar/runtime/ui';
 import { Link, Outlet, useLocation } from 'react-router-dom';
 import SyntaxHighlighter from 'react-syntax-highlighter/dist/esm/prism-light.js';
@@ -21066,6 +21066,32 @@ var init_ButtonGroup = __esm({
     ButtonGroup.displayName = "ButtonGroup";
   }
 });
+
+// lib/getNestedValue.ts
+function getNestedValue(obj, path) {
+  if (obj === null || obj === void 0 || !path) {
+    return void 0;
+  }
+  if (!path.includes(".")) {
+    return obj[path];
+  }
+  const parts = path.split(".");
+  let value = obj;
+  for (const part of parts) {
+    if (value === null || value === void 0) {
+      return void 0;
+    }
+    if (typeof value !== "object" || Array.isArray(value)) {
+      return void 0;
+    }
+    value = value[part];
+  }
+  return value;
+}
+var init_getNestedValue = __esm({
+  "lib/getNestedValue.ts"() {
+  }
+});
 function useSwipeGesture(callbacks, options = {}) {
   const { threshold = 50, velocityThreshold = 0.3, preventDefault = false } = options;
   const startX = useRef(0);
@@ -21179,11 +21205,15 @@ function getWeekDays(start) {
   }
   return days;
 }
-function generateDefaultTimeSlots(events2) {
+function eventStartDate(event, startField) {
+  const raw = getNestedValue(event, startField);
+  return new Date(raw ?? "");
+}
+function generateDefaultTimeSlots(events2, startField) {
   let first = DEFAULT_FIRST_HOUR;
   let last = DEFAULT_LAST_HOUR;
   for (const ev of events2) {
-    const start = new Date(ev.startTime);
+    const start = eventStartDate(ev, startField);
     if (Number.isNaN(start.getTime())) continue;
     const hour = start.getHours();
     if (hour < first) first = hour;
@@ -21195,8 +21225,8 @@ function generateDefaultTimeSlots(events2) {
   }
   return slots;
 }
-function eventInSlot(event, day, slotTime) {
-  const eventStart = new Date(event.startTime);
+function eventInSlot(event, day, slotTime, startField) {
+  const eventStart = eventStartDate(event, startField);
   if (Number.isNaN(eventStart.getTime())) return false;
   const [slotHour] = slotTime.split(":").map(Number);
   return eventStart.toDateString() === day.toDateString() && eventStart.getHours() === slotHour;
@@ -21213,7 +21243,12 @@ function CalendarGrid({
   longPressPayload,
   swipeLeftEvent,
   swipeRightEvent,
-  dayWindow = "auto"
+  dayWindow = "auto",
+  titleField = "title",
+  startField = "startTime",
+  colorField = "color",
+  children,
+  renderItem
 }) {
   const evs = Array.isArray(events2) ? events2 : events2 ? [events2] : [];
   const eventBus = useEventBus();
@@ -21228,8 +21263,8 @@ function CalendarGrid({
     [resolvedWeekStart]
   );
   const resolvedTimeSlots = useMemo(
-    () => timeSlots ?? generateDefaultTimeSlots(evs),
-    [timeSlots, evs]
+    () => timeSlots ?? generateDefaultTimeSlots(evs, startField),
+    [timeSlots, evs, startField]
   );
   const visibleCount = useDayWindow(dayWindow);
   const [dayOffset, setDayOffset] = useState(0);
@@ -21266,9 +21301,9 @@ function CalendarGrid({
   );
   const eventsForDayCount = useCallback(
     (day) => evs.filter(
-      (ev) => new Date(ev.startTime).toDateString() === day.toDateString()
+      (ev) => eventStartDate(ev, startField).toDateString() === day.toDateString()
     ).length,
-    [events2]
+    [events2, startField]
   );
   const swipeCallbacks = useMemo(() => ({
     onSwipeLeft: swipeLeftEvent ? () => eventBus.emit(`UI:${swipeLeftEvent}`, {}) : void 0,
@@ -21287,8 +21322,11 @@ function CalendarGrid({
       eventBus.emit(`UI:${longPressEvent}`, { date: day.toISOString(), time, ...longPressPayload });
     }, 500);
   }, [longPressEvent, longPressPayload, eventBus]);
+  const renderChip = children ?? renderItem;
   const renderEvent = (event) => {
-    const color = event.color;
+    const color = getNestedValue(event, colorField);
+    const label = String(getNestedValue(event, titleField) ?? "");
+    const eventIndex = evs.indexOf(event);
     return /* @__PURE__ */ jsx(
       Box,
       {
@@ -21300,7 +21338,7 @@ function CalendarGrid({
           color ? color : "bg-primary/10 border-primary/30 text-primary"
         ),
         onClick: (e) => handleEventClick(event, e),
-        children: /* @__PURE__ */ jsx(Typography, { variant: "small", className: "truncate font-medium", children: event.title })
+        children: renderChip ? renderChip(event, eventIndex) : /* @__PURE__ */ jsx(Typography, { variant: "small", className: "truncate font-medium", children: label })
       },
       event.id
     );
@@ -21384,7 +21422,7 @@ function CalendarGrid({
                 ) }),
                 visibleDays.map((day) => {
                   const slotEvents = evs.filter(
-                    (ev) => eventInSlot(ev, day, time)
+                    (ev) => eventInSlot(ev, day, time, startField)
                   );
                   const isToday = day.toDateString() === (/* @__PURE__ */ new Date()).toDateString();
                   return /* @__PURE__ */ jsx(
@@ -21421,6 +21459,7 @@ var init_CalendarGrid = __esm({
   "components/core/molecules/CalendarGrid.tsx"() {
     "use client";
     init_cn();
+    init_getNestedValue();
     init_Box();
     init_Button();
     init_Stack();
@@ -21437,32 +21476,6 @@ var init_CalendarGrid = __esm({
     CalendarGrid.displayName = "CalendarGrid";
   }
 });
-
-// lib/getNestedValue.ts
-function getNestedValue(obj, path) {
-  if (obj === null || obj === void 0 || !path) {
-    return void 0;
-  }
-  if (!path.includes(".")) {
-    return obj[path];
-  }
-  const parts = path.split(".");
-  let value = obj;
-  for (const part of parts) {
-    if (value === null || value === void 0) {
-      return void 0;
-    }
-    if (typeof value !== "object" || Array.isArray(value)) {
-      return void 0;
-    }
-    value = value[part];
-  }
-  return value;
-}
-var init_getNestedValue = __esm({
-  "lib/getNestedValue.ts"() {
-  }
-});
 var Pagination;
 var init_Pagination = __esm({
   "components/core/molecules/Pagination.tsx"() {
@@ -51215,7 +51228,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
           crossTraitLog.debug("listen:fired", { busKey, targetTrait: binding.trait.name, triggers: listen.triggers });
           enqueueAndDrain(
             listen.triggers,
-            applyListenPayloadMapping(listen.payloadMapping, event.payload),
+            applyListenPayloadMapping(listen.payloadMapping, event.payload, evaluateListenPayloadExpr),
             binding.trait.name
           );
         });

package/dist/components/index.cjs

@@ -14488,6 +14488,32 @@ var init_ButtonGroup = __esm({
     exports.ButtonGroup.displayName = "ButtonGroup";
   }
 });
+
+// lib/getNestedValue.ts
+function getNestedValue(obj, path) {
+  if (obj === null || obj === void 0 || !path) {
+    return void 0;
+  }
+  if (!path.includes(".")) {
+    return obj[path];
+  }
+  const parts = path.split(".");
+  let value = obj;
+  for (const part of parts) {
+    if (value === null || value === void 0) {
+      return void 0;
+    }
+    if (typeof value !== "object" || Array.isArray(value)) {
+      return void 0;
+    }
+    value = value[part];
+  }
+  return value;
+}
+var init_getNestedValue = __esm({
+  "lib/getNestedValue.ts"() {
+  }
+});
 function useSwipeGesture(callbacks, options = {}) {
   const { threshold = 50, velocityThreshold = 0.3, preventDefault = false } = options;
   const startX = React74.useRef(0);
@@ -14601,11 +14627,15 @@ function getWeekDays(start) {
   }
   return days;
 }
-function generateDefaultTimeSlots(events2) {
+function eventStartDate(event, startField) {
+  const raw = getNestedValue(event, startField);
+  return new Date(raw ?? "");
+}
+function generateDefaultTimeSlots(events2, startField) {
   let first = DEFAULT_FIRST_HOUR;
   let last = DEFAULT_LAST_HOUR;
   for (const ev of events2) {
-    const start = new Date(ev.startTime);
+    const start = eventStartDate(ev, startField);
     if (Number.isNaN(start.getTime())) continue;
     const hour = start.getHours();
     if (hour < first) first = hour;
@@ -14617,8 +14647,8 @@ function generateDefaultTimeSlots(events2) {
   }
   return slots;
 }
-function eventInSlot(event, day, slotTime) {
-  const eventStart = new Date(event.startTime);
+function eventInSlot(event, day, slotTime, startField) {
+  const eventStart = eventStartDate(event, startField);
   if (Number.isNaN(eventStart.getTime())) return false;
   const [slotHour] = slotTime.split(":").map(Number);
   return eventStart.toDateString() === day.toDateString() && eventStart.getHours() === slotHour;
@@ -14635,7 +14665,12 @@ function CalendarGrid({
   longPressPayload,
   swipeLeftEvent,
   swipeRightEvent,
-  dayWindow = "auto"
+  dayWindow = "auto",
+  titleField = "title",
+  startField = "startTime",
+  colorField = "color",
+  children,
+  renderItem
 }) {
   const evs = Array.isArray(events2) ? events2 : events2 ? [events2] : [];
   const eventBus = useEventBus();
@@ -14650,8 +14685,8 @@ function CalendarGrid({
     [resolvedWeekStart]
   );
   const resolvedTimeSlots = React74.useMemo(
-    () => timeSlots ?? generateDefaultTimeSlots(evs),
-    [timeSlots, evs]
+    () => timeSlots ?? generateDefaultTimeSlots(evs, startField),
+    [timeSlots, evs, startField]
   );
   const visibleCount = useDayWindow(dayWindow);
   const [dayOffset, setDayOffset] = React74.useState(0);
@@ -14688,9 +14723,9 @@ function CalendarGrid({
   );
   const eventsForDayCount = React74.useCallback(
     (day) => evs.filter(
-      (ev) => new Date(ev.startTime).toDateString() === day.toDateString()
+      (ev) => eventStartDate(ev, startField).toDateString() === day.toDateString()
     ).length,
-    [events2]
+    [events2, startField]
   );
   const swipeCallbacks = React74.useMemo(() => ({
     onSwipeLeft: swipeLeftEvent ? () => eventBus.emit(`UI:${swipeLeftEvent}`, {}) : void 0,
@@ -14709,8 +14744,11 @@ function CalendarGrid({
       eventBus.emit(`UI:${longPressEvent}`, { date: day.toISOString(), time, ...longPressPayload });
     }, 500);
   }, [longPressEvent, longPressPayload, eventBus]);
+  const renderChip = children ?? renderItem;
   const renderEvent = (event) => {
-    const color = event.color;
+    const color = getNestedValue(event, colorField);
+    const label = String(getNestedValue(event, titleField) ?? "");
+    const eventIndex = evs.indexOf(event);
     return /* @__PURE__ */ jsxRuntime.jsx(
       exports.Box,
       {
@@ -14722,7 +14760,7 @@ function CalendarGrid({
           color ? color : "bg-primary/10 border-primary/30 text-primary"
         ),
         onClick: (e) => handleEventClick(event, e),
-        children: /* @__PURE__ */ jsxRuntime.jsx(exports.Typography, { variant: "small", className: "truncate font-medium", children: event.title })
+        children: renderChip ? renderChip(event, eventIndex) : /* @__PURE__ */ jsxRuntime.jsx(exports.Typography, { variant: "small", className: "truncate font-medium", children: label })
       },
       event.id
     );
@@ -14806,7 +14844,7 @@ function CalendarGrid({
                 ) }),
                 visibleDays.map((day) => {
                   const slotEvents = evs.filter(
-                    (ev) => eventInSlot(ev, day, time)
+                    (ev) => eventInSlot(ev, day, time, startField)
                   );
                   const isToday = day.toDateString() === (/* @__PURE__ */ new Date()).toDateString();
                   return /* @__PURE__ */ jsxRuntime.jsx(
@@ -14843,6 +14881,7 @@ var init_CalendarGrid = __esm({
   "components/core/molecules/CalendarGrid.tsx"() {
     "use client";
     init_cn();
+    init_getNestedValue();
     init_Box();
     init_Button();
     init_Stack();
@@ -16454,32 +16493,6 @@ var init_Canvas = __esm({
     Canvas.displayName = "Canvas";
   }
 });
-
-// lib/getNestedValue.ts
-function getNestedValue(obj, path) {
-  if (obj === null || obj === void 0 || !path) {
-    return void 0;
-  }
-  if (!path.includes(".")) {
-    return obj[path];
-  }
-  const parts = path.split(".");
-  let value = obj;
-  for (const part of parts) {
-    if (value === null || value === void 0) {
-      return void 0;
-    }
-    if (typeof value !== "object" || Array.isArray(value)) {
-      return void 0;
-    }
-    value = value[part];
-  }
-  return value;
-}
-var init_getNestedValue = __esm({
-  "lib/getNestedValue.ts"() {
-  }
-});
 exports.Pagination = void 0;
 var init_Pagination = __esm({
   "components/core/molecules/Pagination.tsx"() {

package/dist/components/index.d.cts

@@ -5307,8 +5307,34 @@ interface CalendarGridProps {
      * layouts or screenshot tests).
      */
     dayWindow?: CalendarDayWindow | 'auto';
+    /**
+     * Row field holding the chip label. Defaults to `title`. Lets a host bound
+     * to its own entity name the column instead of being forced to rename its
+     * fields to this grid's contract (same accessor idiom as `DataList`'s
+     * `senderField` / `DataGrid`'s `imageField`).
+     */
+    titleField?: string;
+    /** Row field holding the start timestamp (ISO or epoch). Defaults to `startTime`. */
+    startField?: string;
+    /** Row field holding the chip's Tailwind colour class. Defaults to `color`. */
+    colorField?: string;
+    /**
+     * Render function for one event chip's content. Receives the row and its
+     * index in the materialised events array. The grid keeps ownership of
+     * placement, colour and the click target; this replaces only what is drawn
+     * INSIDE the chip, so a host can show a time + instructor + badge stack
+     * instead of the default single label.
+     */
+    children?: (item: EntityRow, index: number) => React__default.ReactNode;
+    /**
+     * Per-event render function (schema-level alias for the children render
+     * prop). In `.orb`: `["fn", "item", { pattern tree with @item.field bindings }]`.
+     * In `.lolo`: `renderItem: (fn item <Component …={@item.field}/>)` — the same
+     * contract `data-list` / `data-grid` / `carousel` already use.
+     */
+    renderItem?: (item: EntityRow, index: number) => React__default.ReactNode;
 }
-declare function CalendarGrid({ weekStart, timeSlots, events, onSlotClick, onDayClick, onEventClick, className, longPressEvent, longPressPayload, swipeLeftEvent, swipeRightEvent, dayWindow, }: CalendarGridProps): React__default.JSX.Element;
+declare function CalendarGrid({ weekStart, timeSlots, events, onSlotClick, onDayClick, onEventClick, className, longPressEvent, longPressPayload, swipeLeftEvent, swipeRightEvent, dayWindow, titleField, startField, colorField, children, renderItem, }: CalendarGridProps): React__default.JSX.Element;
 declare namespace CalendarGrid {
     var displayName: string;
 }

package/dist/components/index.d.ts

@@ -5307,8 +5307,34 @@ interface CalendarGridProps {
      * layouts or screenshot tests).
      */
     dayWindow?: CalendarDayWindow | 'auto';
+    /**
+     * Row field holding the chip label. Defaults to `title`. Lets a host bound
+     * to its own entity name the column instead of being forced to rename its
+     * fields to this grid's contract (same accessor idiom as `DataList`'s
+     * `senderField` / `DataGrid`'s `imageField`).
+     */
+    titleField?: string;
+    /** Row field holding the start timestamp (ISO or epoch). Defaults to `startTime`. */
+    startField?: string;
+    /** Row field holding the chip's Tailwind colour class. Defaults to `color`. */
+    colorField?: string;
+    /**
+     * Render function for one event chip's content. Receives the row and its
+     * index in the materialised events array. The grid keeps ownership of
+     * placement, colour and the click target; this replaces only what is drawn
+     * INSIDE the chip, so a host can show a time + instructor + badge stack
+     * instead of the default single label.
+     */
+    children?: (item: EntityRow, index: number) => React__default.ReactNode;
+    /**
+     * Per-event render function (schema-level alias for the children render
+     * prop). In `.orb`: `["fn", "item", { pattern tree with @item.field bindings }]`.
+     * In `.lolo`: `renderItem: (fn item <Component …={@item.field}/>)` — the same
+     * contract `data-list` / `data-grid` / `carousel` already use.
+     */
+    renderItem?: (item: EntityRow, index: number) => React__default.ReactNode;
 }
-declare function CalendarGrid({ weekStart, timeSlots, events, onSlotClick, onDayClick, onEventClick, className, longPressEvent, longPressPayload, swipeLeftEvent, swipeRightEvent, dayWindow, }: CalendarGridProps): React__default.JSX.Element;
+declare function CalendarGrid({ weekStart, timeSlots, events, onSlotClick, onDayClick, onEventClick, className, longPressEvent, longPressPayload, swipeLeftEvent, swipeRightEvent, dayWindow, titleField, startField, colorField, children, renderItem, }: CalendarGridProps): React__default.JSX.Element;
 declare namespace CalendarGrid {
     var displayName: string;
 }