@almadar/ui 5.125.0 → 5.127.0

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,17 +21205,31 @@ function getWeekDays(start) {
   }
   return days;
 }
-function generateDefaultTimeSlots() {
+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 = eventStartDate(ev, startField);
+    if (Number.isNaN(start.getTime())) continue;
+    const hour = start.getHours();
+    if (hour < first) first = hour;
+    if (hour > last) last = hour;
+  }
   const slots = [];
-  for (let hour = 9; hour <= 17; hour++) {
-    slots.push(`${hour.toString().padStart(2, "0")}:00`);
+  for (let hour = first; hour <= last; hour++) {
+    slots.push(slotLabel(hour));
   }
   return slots;
 }
-function eventInSlot(event, day, slotTime) {
-  const eventStart = new Date(event.startTime);
-  const [slotHour, slotMinute] = slotTime.split(":").map(Number);
-  return eventStart.toDateString() === day.toDateString() && eventStart.getHours() === slotHour && eventStart.getMinutes() === slotMinute;
+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;
 }
 function CalendarGrid({
   weekStart,
@@ -21203,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();
@@ -21218,8 +21263,8 @@ function CalendarGrid({
     [resolvedWeekStart]
   );
   const resolvedTimeSlots = useMemo(
-    () => timeSlots ?? generateDefaultTimeSlots(),
-    [timeSlots]
+    () => timeSlots ?? generateDefaultTimeSlots(evs, startField),
+    [timeSlots, evs, startField]
   );
   const visibleCount = useDayWindow(dayWindow);
   const [dayOffset, setDayOffset] = useState(0);
@@ -21256,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,
@@ -21277,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,
       {
@@ -21290,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
     );
@@ -21374,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(
@@ -21406,11 +21454,12 @@ function CalendarGrid({
     }
   );
 }
-var SHORT_DATE;
+var SHORT_DATE, DEFAULT_FIRST_HOUR, DEFAULT_LAST_HOUR, slotLabel;
 var init_CalendarGrid = __esm({
   "components/core/molecules/CalendarGrid.tsx"() {
     "use client";
     init_cn();
+    init_getNestedValue();
     init_Box();
     init_Button();
     init_Stack();
@@ -21421,35 +21470,12 @@ var init_CalendarGrid = __esm({
     init_useEventBus();
     init_useSwipeGesture();
     SHORT_DATE = { month: "short", day: "numeric" };
+    DEFAULT_FIRST_HOUR = 9;
+    DEFAULT_LAST_HOUR = 17;
+    slotLabel = (hour) => `${hour.toString().padStart(2, "0")}:00`;
     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"() {
@@ -45757,6 +45783,13 @@ function MaybeTraitScope({
   if (wrap) {
     return /* @__PURE__ */ jsx(TraitScopeProvider, { orbital, trait: sourceTrait, children });
   }
+  if (sourceTrait !== void 0 && schemaCtx !== null) {
+    scopeWrapLog.warn("decline", {
+      sourceTrait,
+      orbitalsByTraitSize: schemaCtx.orbitalsByTrait.size,
+      reason: "sourceTrait not in orbitalsByTrait \u2014 children render unscoped"
+    });
+  }
   return /* @__PURE__ */ jsx(Fragment, { children });
 }
 function UISlotComponent({
@@ -46054,7 +46087,7 @@ function renderPatternChildren(children, onDismiss, parentId = "root", parentPat
     const childId = `${parentId}-${index}`;
     const childPath = parentPath === "root" ? `root.children.${index}` : `${parentPath}.children.${index}`;
     const childAsRecord = child;
-    const { type: _childType, props: nestedProps, _id: _childNodeId, children: _childChildren, ...flatProps } = childAsRecord;
+    const { type: _childType, props: nestedProps, _id: _childNodeId, _sourceTrait: childSourceTrait, children: _childChildren, ...flatProps } = childAsRecord;
     const resolvedProps = nestedProps !== void 0 ? nestedProps : flatProps;
     if (_childChildren !== void 0 && nestedProps === void 0) {
       resolvedProps.children = _childChildren;
@@ -46069,11 +46102,14 @@ function renderPatternChildren(children, onDismiss, parentId = "root", parentPat
       // (e.g. form-section inside a stack) can resolve entityDef via
       // the trait's linkedEntity for form-field enrichment. The orbCtx
       // (slot/transition/state/entity) propagates the same way so every
-      // nested node carries a complete contextual-edit address.
-      ...sourceTrait !== void 0 && { sourceTrait },
+      // nested node carries a complete contextual-edit address. A child
+      // carrying its own `_sourceTrait` (multi-source slot stack) owns it
+      // outright — inheriting the synthetic wrapper's sentinel instead
+      // would erase the real owner.
+      ...childSourceTrait !== void 0 ? { sourceTrait: childSourceTrait } : sourceTrait !== void 0 && { sourceTrait },
       ...orbCtx ?? {}
     };
-    return /* @__PURE__ */ jsx(
+    const renderedChild = /* @__PURE__ */ jsx(
       SlotContentRenderer,
       {
         content: childContent,
@@ -46082,6 +46118,7 @@ function renderPatternChildren(children, onDismiss, parentId = "root", parentPat
       },
       childId
     );
+    return childSourceTrait !== void 0 ? /* @__PURE__ */ jsx(MaybeTraitScope, { sourceTrait: childSourceTrait, children: renderedChild }, childId) : renderedChild;
   });
 }
 function toDrawableNodes(children) {
@@ -51191,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,17 +14627,31 @@ function getWeekDays(start) {
   }
   return days;
 }
-function generateDefaultTimeSlots() {
+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 = eventStartDate(ev, startField);
+    if (Number.isNaN(start.getTime())) continue;
+    const hour = start.getHours();
+    if (hour < first) first = hour;
+    if (hour > last) last = hour;
+  }
   const slots = [];
-  for (let hour = 9; hour <= 17; hour++) {
-    slots.push(`${hour.toString().padStart(2, "0")}:00`);
+  for (let hour = first; hour <= last; hour++) {
+    slots.push(slotLabel(hour));
   }
   return slots;
 }
-function eventInSlot(event, day, slotTime) {
-  const eventStart = new Date(event.startTime);
-  const [slotHour, slotMinute] = slotTime.split(":").map(Number);
-  return eventStart.toDateString() === day.toDateString() && eventStart.getHours() === slotHour && eventStart.getMinutes() === slotMinute;
+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;
 }
 function CalendarGrid({
   weekStart,
@@ -14625,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();
@@ -14640,8 +14685,8 @@ function CalendarGrid({
     [resolvedWeekStart]
   );
   const resolvedTimeSlots = React74.useMemo(
-    () => timeSlots ?? generateDefaultTimeSlots(),
-    [timeSlots]
+    () => timeSlots ?? generateDefaultTimeSlots(evs, startField),
+    [timeSlots, evs, startField]
   );
   const visibleCount = useDayWindow(dayWindow);
   const [dayOffset, setDayOffset] = React74.useState(0);
@@ -14678,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,
@@ -14699,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,
       {
@@ -14712,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
     );
@@ -14796,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(
@@ -14828,11 +14876,12 @@ function CalendarGrid({
     }
   );
 }
-var SHORT_DATE;
+var SHORT_DATE, DEFAULT_FIRST_HOUR, DEFAULT_LAST_HOUR, slotLabel;
 var init_CalendarGrid = __esm({
   "components/core/molecules/CalendarGrid.tsx"() {
     "use client";
     init_cn();
+    init_getNestedValue();
     init_Box();
     init_Button();
     init_Stack();
@@ -14843,6 +14892,9 @@ var init_CalendarGrid = __esm({
     init_useEventBus();
     init_useSwipeGesture();
     SHORT_DATE = { month: "short", day: "numeric" };
+    DEFAULT_FIRST_HOUR = 9;
+    DEFAULT_LAST_HOUR = 17;
+    slotLabel = (hour) => `${hour.toString().padStart(2, "0")}:00`;
     CalendarGrid.displayName = "CalendarGrid";
   }
 });
@@ -16441,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"() {
@@ -45409,6 +45435,13 @@ function MaybeTraitScope({
   if (wrap) {
     return /* @__PURE__ */ jsxRuntime.jsx(providers.TraitScopeProvider, { orbital, trait: sourceTrait, children });
   }
+  if (sourceTrait !== void 0 && schemaCtx !== null) {
+    scopeWrapLog.warn("decline", {
+      sourceTrait,
+      orbitalsByTraitSize: schemaCtx.orbitalsByTrait.size,
+      reason: "sourceTrait not in orbitalsByTrait \u2014 children render unscoped"
+    });
+  }
   return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children });
 }
 function UISlotComponent({
@@ -45706,7 +45739,7 @@ function renderPatternChildren(children, onDismiss, parentId = "root", parentPat
     const childId = `${parentId}-${index}`;
     const childPath = parentPath === "root" ? `root.children.${index}` : `${parentPath}.children.${index}`;
     const childAsRecord = child;
-    const { type: _childType, props: nestedProps, _id: _childNodeId, children: _childChildren, ...flatProps } = childAsRecord;
+    const { type: _childType, props: nestedProps, _id: _childNodeId, _sourceTrait: childSourceTrait, children: _childChildren, ...flatProps } = childAsRecord;
     const resolvedProps = nestedProps !== void 0 ? nestedProps : flatProps;
     if (_childChildren !== void 0 && nestedProps === void 0) {
       resolvedProps.children = _childChildren;
@@ -45721,11 +45754,14 @@ function renderPatternChildren(children, onDismiss, parentId = "root", parentPat
       // (e.g. form-section inside a stack) can resolve entityDef via
       // the trait's linkedEntity for form-field enrichment. The orbCtx
       // (slot/transition/state/entity) propagates the same way so every
-      // nested node carries a complete contextual-edit address.
-      ...sourceTrait !== void 0 && { sourceTrait },
+      // nested node carries a complete contextual-edit address. A child
+      // carrying its own `_sourceTrait` (multi-source slot stack) owns it
+      // outright — inheriting the synthetic wrapper's sentinel instead
+      // would erase the real owner.
+      ...childSourceTrait !== void 0 ? { sourceTrait: childSourceTrait } : sourceTrait !== void 0 && { sourceTrait },
       ...orbCtx ?? {}
     };
-    return /* @__PURE__ */ jsxRuntime.jsx(
+    const renderedChild = /* @__PURE__ */ jsxRuntime.jsx(
       SlotContentRenderer,
       {
         content: childContent,
@@ -45734,6 +45770,7 @@ function renderPatternChildren(children, onDismiss, parentId = "root", parentPat
       },
       childId
     );
+    return childSourceTrait !== void 0 ? /* @__PURE__ */ jsxRuntime.jsx(MaybeTraitScope, { sourceTrait: childSourceTrait, children: renderedChild }, childId) : renderedChild;
   });
 }
 function toDrawableNodes(children) {
@@ -47282,9 +47319,10 @@ function aggregateSlot(sources) {
   const entries = Object.entries(sources);
   if (entries.length === 0) return null;
   if (entries.length === 1) return entries[0][1];
-  const children = entries.map(([, entry]) => ({
+  const children = entries.map(([sourceKey, entry]) => ({
     type: entry.pattern,
-    ...entry.props
+    ...entry.props,
+    ...sourceKey !== DEFAULT_SOURCE_KEY && { _sourceTrait: sourceKey }
   }));
   const stackId = `slot-content-stack-${entries.map(([k]) => k).join("-")}`;
   return {

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;
 }