@almadar/std 6.5.2 → 7.2.0

package/dist/behaviors/registry/atoms/std-calendar.orb

@@ -1,7 +1,7 @@
 {
   "name": "std-calendar",
   "version": "1.0.0",
-  "description": "Calendar browsing atom with month/day/slot views. Absorbs: calendar-grid, day-cell, time-slot-cell, date-range-selector.",
+  "description": "std-calendar as a Function",
   "orbitals": [
     {
       "name": "CalendarEventOrbital",
@@ -48,47 +48,67 @@
           {
             "name": "duration",
             "type": "number",
-            "default": 60
-          }
-        ],
-        "instances": [
-          {
-            "id": "evt-1",
-            "name": "Team Standup",
-            "description": "Daily sync",
-            "status": "active",
-            "createdAt": "2026-03-19",
-            "date": "2026-03-19",
-            "time": "09:00",
-            "duration": 30
-          },
-          {
-            "id": "evt-2",
-            "name": "Sprint Review",
-            "description": "End of sprint demo",
-            "status": "active",
-            "createdAt": "2026-03-19",
-            "date": "2026-03-21",
-            "time": "14:00",
-            "duration": 60
-          },
-          {
-            "id": "evt-3",
-            "name": "Design Workshop",
-            "description": "UI/UX review session",
-            "status": "pending",
-            "createdAt": "2026-03-19",
-            "date": "2026-03-22",
-            "time": "10:30",
-            "duration": 90
+            "default": 60.0
           }
         ]
       },
       "traits": [
         {
           "name": "CalendarEventCalendar",
-          "linkedEntity": "CalendarEvent",
           "category": "interaction",
+          "linkedEntity": "CalendarEvent",
+          "emits": [
+            {
+              "event": "CalendarEventLoaded",
+              "description": "Fired when CalendarEvent finishes loading",
+              "scope": "internal",
+              "payload": [
+                {
+                  "name": "id",
+                  "type": "string"
+                },
+                {
+                  "name": "name",
+                  "type": "string"
+                },
+                {
+                  "name": "description",
+                  "type": "string"
+                },
+                {
+                  "name": "status",
+                  "type": "string"
+                },
+                {
+                  "name": "createdAt",
+                  "type": "string"
+                },
+                {
+                  "name": "date",
+                  "type": "string"
+                },
+                {
+                  "name": "time",
+                  "type": "string"
+                },
+                {
+                  "name": "duration",
+                  "type": "number"
+                }
+              ]
+            },
+            {
+              "event": "CalendarEventLoadFailed",
+              "description": "Fired when CalendarEvent fails to load",
+              "scope": "internal",
+              "payload": [
+                {
+                  "name": "message",
+                  "type": "string"
+                }
+              ]
+            }
+          ],
           "stateMachine": {
             "states": [
               {
@@ -132,6 +152,20 @@
               {
                 "key": "BACK",
                 "name": "Back"
+              },
+              {
+                "key": "CalendarEventLoaded",
+                "name": "CalendarEvent loaded"
+              },
+              {
+                "key": "CalendarEventLoadFailed",
+                "name": "CalendarEvent load failed",
+                "payload": [
+                  {
+                    "name": "message",
+                    "type": "string"
+                  }
+                ]
               }
             ],
             "transitions": [
@@ -142,27 +176,29 @@
                 "effects": [
                   [
                     "fetch",
-                    "CalendarEvent"
+                    "CalendarEvent",
+                    {
+                      "emit": {
+                        "success": "CalendarEventLoaded",
+                        "failure": "CalendarEventLoadFailed"
+                      }
+                    }
                   ],
                   [
                     "render-ui",
                     "main",
                     {
                       "type": "stack",
-                      "direction": "vertical",
                       "gap": "lg",
                       "children": [
                         {
-                          "type": "stack",
                           "direction": "horizontal",
                           "gap": "md",
-                          "justify": "space-between",
-                          "align": "center",
                           "children": [
                             {
                               "type": "stack",
-                              "direction": "horizontal",
                               "gap": "sm",
+                              "direction": "horizontal",
                               "align": "center",
                               "children": [
                                 {
@@ -178,20 +214,23 @@
                               ]
                             },
                             {
+                              "endDate": "2026-12-31",
                               "type": "date-range-selector",
                               "startDate": "2026-01-01",
-                              "endDate": "2026-12-31",
                               "onSelect": "SELECT_DAY"
                             }
-                          ]
+                          ],
+                          "justify": "space-between",
+                          "type": "stack",
+                          "align": "center"
                         },
                         {
                           "type": "divider"
                         },
                         {
+                          "month": 3.0,
                           "type": "calendar-grid",
-                          "month": 3,
-                          "year": 2026
+                          "year": 2026.0
                         },
                         {
                           "type": "divider"
@@ -202,44 +241,45 @@
                           "content": "Upcoming Events"
                         },
                         {
-                          "type": "data-list",
-                          "entity": "CalendarEvent",
-                          "emptyIcon": "calendar",
-                          "emptyTitle": "No events",
                           "emptyDescription": "No events scheduled.",
                           "columns": [
                             {
-                              "name": "name",
-                              "label": "Event",
+                              "icon": "calendar",
                               "variant": "h4",
-                              "icon": "calendar"
+                              "label": "Event",
+                              "name": "name"
                             },
                             {
-                              "name": "time",
                               "label": "Time",
+                              "name": "time",
                               "variant": "badge"
                             },
                             {
                               "name": "date",
-                              "label": "Date",
+                              "format": "date",
                               "variant": "caption",
-                              "format": "date"
+                              "label": "Date"
                             },
                             {
-                              "name": "status",
                               "label": "Status",
-                              "variant": "badge"
+                              "variant": "badge",
+                              "name": "status"
                             }
                           ],
                           "itemActions": [
                             {
-                              "label": "View",
+                              "icon": "eye",
                               "event": "SELECT_DAY",
-                              "icon": "eye"
+                              "label": "View"
                             }
-                          ]
+                          ],
+                          "emptyIcon": "calendar",
+                          "emptyTitle": "No events",
+                          "type": "data-list",
+                          "entity": "CalendarEvent"
                         }
-                      ]
+                      ],
+                      "direction": "vertical"
                     }
                   ]
                 ]
@@ -251,74 +291,74 @@
                 "effects": [
                   [
                     "fetch",
-                    "CalendarEvent"
+                    "CalendarEvent",
+                    {
+                      "emit": {
+                        "failure": "CalendarEventLoadFailed",
+                        "success": "CalendarEventLoaded"
+                      }
+                    }
                   ],
                   [
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
                       "direction": "vertical",
-                      "gap": "lg",
                       "children": [
                         {
-                          "type": "stack",
-                          "direction": "horizontal",
-                          "gap": "md",
                           "justify": "space-between",
-                          "align": "center",
                           "children": [
                             {
-                              "type": "stack",
-                              "direction": "horizontal",
-                              "gap": "sm",
-                              "align": "center",
                               "children": [
                                 {
+                                  "size": "lg",
                                   "type": "icon",
-                                  "name": "clock",
-                                  "size": "lg"
+                                  "name": "clock"
                                 },
                                 {
-                                  "type": "typography",
                                   "content": "Day View",
-                                  "variant": "h2"
+                                  "variant": "h2",
+                                  "type": "typography"
                                 }
-                              ]
+                              ],
+                              "type": "stack",
+                              "direction": "horizontal",
+                              "align": "center",
+                              "gap": "sm"
                             },
                             {
-                              "type": "button",
-                              "label": "Back to Month",
+                              "icon": "arrow-left",
                               "event": "BACK",
-                              "variant": "ghost",
-                              "icon": "arrow-left"
+                              "label": "Back to Month",
+                              "type": "button",
+                              "variant": "ghost"
                             }
-                          ]
+                          ],
+                          "direction": "horizontal",
+                          "type": "stack",
+                          "align": "center",
+                          "gap": "md"
                         },
                         {
                           "type": "divider"
                         },
                         {
-                          "type": "typography",
                           "variant": "h4",
+                          "type": "typography",
                           "content": "Events for Selected Day"
                         },
                         {
-                          "type": "data-grid",
-                          "entity": "CalendarEvent",
                           "emptyIcon": "calendar",
-                          "emptyTitle": "No events today",
-                          "emptyDescription": "Select a time slot to add an event.",
                           "columns": [
                             {
-                              "name": "name",
+                              "icon": "clock",
                               "label": "Event",
-                              "variant": "h4",
-                              "icon": "clock"
+                              "name": "name",
+                              "variant": "h4"
                             },
                             {
-                              "name": "time",
                               "label": "Time",
+                              "name": "time",
                               "variant": "badge"
                             },
                             {
@@ -327,15 +367,21 @@
                               "variant": "badge"
                             }
                           ],
+                          "emptyDescription": "Select a time slot to add an event.",
                           "itemActions": [
                             {
-                              "label": "Select",
+                              "icon": "check",
                               "event": "SELECT_SLOT",
-                              "icon": "check"
+                              "label": "Select"
                             }
-                          ]
+                          ],
+                          "entity": "CalendarEvent",
+                          "type": "data-grid",
+                          "emptyTitle": "No events today"
                         }
-                      ]
+                      ],
+                      "gap": "lg",
+                      "type": "stack"
                     }
                   ]
                 ]
@@ -354,62 +400,59 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
                       "direction": "vertical",
-                      "gap": "lg",
                       "children": [
                         {
                           "type": "stack",
-                          "direction": "horizontal",
-                          "gap": "md",
-                          "justify": "space-between",
-                          "align": "center",
                           "children": [
                             {
                               "type": "stack",
-                              "direction": "horizontal",
                               "gap": "sm",
-                              "align": "center",
                               "children": [
                                 {
+                                  "size": "lg",
                                   "type": "icon",
-                                  "name": "clock",
-                                  "size": "lg"
+                                  "name": "clock"
                                 },
                                 {
                                   "type": "typography",
                                   "content": "Day View",
                                   "variant": "h2"
                                 }
-                              ]
+                              ],
+                              "direction": "horizontal",
+                              "align": "center"
                             },
                             {
+                              "icon": "arrow-left",
+                              "event": "BACK",
                               "type": "button",
                               "label": "Back to Month",
-                              "event": "BACK",
-                              "variant": "ghost",
-                              "icon": "arrow-left"
+                              "variant": "ghost"
                             }
-                          ]
+                          ],
+                          "gap": "md",
+                          "justify": "space-between",
+                          "align": "center",
+                          "direction": "horizontal"
                         },
                         {
                           "type": "divider"
                         },
                         {
                           "type": "typography",
-                          "variant": "h4",
-                          "content": "Events for Selected Day"
+                          "content": "Events for Selected Day",
+                          "variant": "h4"
                         },
                         {
+                          "emptyTitle": "No events today",
                           "type": "data-grid",
                           "entity": "CalendarEvent",
-                          "emptyIcon": "calendar",
-                          "emptyTitle": "No events today",
                           "emptyDescription": "Select a time slot to add an event.",
                           "columns": [
                             {
-                              "name": "name",
                               "label": "Event",
+                              "name": "name",
                               "variant": "h4",
                               "icon": "clock"
                             },
@@ -420,19 +463,22 @@
                             },
                             {
                               "name": "status",
-                              "label": "Status",
-                              "variant": "badge"
+                              "variant": "badge",
+                              "label": "Status"
                             }
                           ],
+                          "emptyIcon": "calendar",
                           "itemActions": [
                             {
-                              "label": "Select",
                               "event": "SELECT_SLOT",
-                              "icon": "check"
+                              "icon": "check",
+                              "label": "Select"
                             }
                           ]
                         }
-                      ]
+                      ],
+                      "gap": "lg",
+                      "type": "stack"
                     }
                   ]
                 ]
@@ -444,104 +490,110 @@
                 "effects": [
                   [
                     "fetch",
-                    "CalendarEvent"
+                    "CalendarEvent",
+                    {
+                      "emit": {
+                        "failure": "CalendarEventLoadFailed",
+                        "success": "CalendarEventLoaded"
+                      }
+                    }
                   ],
                   [
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
                       "direction": "vertical",
-                      "gap": "lg",
                       "children": [
                         {
                           "type": "stack",
-                          "direction": "horizontal",
-                          "gap": "md",
                           "justify": "space-between",
-                          "align": "center",
+                          "gap": "md",
                           "children": [
                             {
-                              "type": "stack",
-                              "direction": "horizontal",
-                              "gap": "sm",
-                              "align": "center",
                               "children": [
                                 {
+                                  "size": "lg",
                                   "type": "icon",
-                                  "name": "calendar",
-                                  "size": "lg"
+                                  "name": "calendar"
                                 },
                                 {
-                                  "type": "typography",
                                   "content": "CalendarEvents Calendar",
+                                  "type": "typography",
                                   "variant": "h2"
                                 }
-                              ]
+                              ],
+                              "align": "center",
+                              "direction": "horizontal",
+                              "gap": "sm",
+                              "type": "stack"
                             },
                             {
-                              "type": "date-range-selector",
-                              "startDate": "2026-01-01",
+                              "onSelect": "SELECT_DAY",
                               "endDate": "2026-12-31",
-                              "onSelect": "SELECT_DAY"
+                              "startDate": "2026-01-01",
+                              "type": "date-range-selector"
                             }
-                          ]
+                          ],
+                          "direction": "horizontal",
+                          "align": "center"
                         },
                         {
                           "type": "divider"
                         },
                         {
                           "type": "calendar-grid",
-                          "month": 3,
-                          "year": 2026
+                          "month": 3.0,
+                          "year": 2026.0
                         },
                         {
                           "type": "divider"
                         },
                         {
-                          "type": "typography",
                           "variant": "h4",
+                          "type": "typography",
                           "content": "Upcoming Events"
                         },
                         {
+                          "itemActions": [
+                            {
+                              "label": "View",
+                              "event": "SELECT_DAY",
+                              "icon": "eye"
+                            }
+                          ],
                           "type": "data-list",
                           "entity": "CalendarEvent",
-                          "emptyIcon": "calendar",
                           "emptyTitle": "No events",
-                          "emptyDescription": "No events scheduled.",
                           "columns": [
                             {
                               "name": "name",
                               "label": "Event",
-                              "variant": "h4",
-                              "icon": "calendar"
+                              "icon": "calendar",
+                              "variant": "h4"
                             },
                             {
-                              "name": "time",
+                              "variant": "badge",
                               "label": "Time",
-                              "variant": "badge"
+                              "name": "time"
                             },
                             {
                               "name": "date",
                               "label": "Date",
-                              "variant": "caption",
-                              "format": "date"
+                              "format": "date",
+                              "variant": "caption"
                             },
                             {
-                              "name": "status",
+                              "variant": "badge",
                               "label": "Status",
-                              "variant": "badge"
+                              "name": "status"
                             }
                           ],
-                          "itemActions": [
-                            {
-                              "label": "View",
-                              "event": "SELECT_DAY",
-                              "icon": "eye"
-                            }
-                          ]
+                          "emptyIcon": "calendar",
+                          "emptyDescription": "No events scheduled."
                         }
-                      ]
+                      ],
+                      "type": "stack",
+                      "gap": "lg"
                     }
                   ]
                 ]
@@ -553,28 +605,29 @@
                 "effects": [
                   [
                     "fetch",
-                    "CalendarEvent"
+                    "CalendarEvent",
+                    {
+                      "emit": {
+                        "failure": "CalendarEventLoadFailed",
+                        "success": "CalendarEventLoaded"
+                      }
+                    }
                   ],
                   [
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
                       "direction": "vertical",
+                      "type": "stack",
                       "gap": "lg",
                       "children": [
                         {
                           "type": "stack",
-                          "direction": "horizontal",
                           "gap": "md",
-                          "justify": "space-between",
                           "align": "center",
+                          "justify": "space-between",
                           "children": [
                             {
-                              "type": "stack",
-                              "direction": "horizontal",
-                              "gap": "sm",
-                              "align": "center",
                               "children": [
                                 {
                                   "type": "icon",
@@ -582,73 +635,78 @@
                                   "size": "lg"
                                 },
                                 {
-                                  "type": "typography",
                                   "content": "CalendarEvents Calendar",
-                                  "variant": "h2"
+                                  "variant": "h2",
+                                  "type": "typography"
                                 }
-                              ]
+                              ],
+                              "gap": "sm",
+                              "direction": "horizontal",
+                              "type": "stack",
+                              "align": "center"
                             },
                             {
+                              "onSelect": "SELECT_DAY",
                               "type": "date-range-selector",
                               "startDate": "2026-01-01",
-                              "endDate": "2026-12-31",
-                              "onSelect": "SELECT_DAY"
+                              "endDate": "2026-12-31"
                             }
-                          ]
+                          ],
+                          "direction": "horizontal"
                         },
                         {
                           "type": "divider"
                         },
                         {
+                          "year": 2026.0,
                           "type": "calendar-grid",
-                          "month": 3,
-                          "year": 2026
+                          "month": 3.0
                         },
                         {
                           "type": "divider"
                         },
                         {
-                          "type": "typography",
                           "variant": "h4",
+                          "type": "typography",
                           "content": "Upcoming Events"
                         },
                         {
-                          "type": "data-list",
-                          "entity": "CalendarEvent",
                           "emptyIcon": "calendar",
-                          "emptyTitle": "No events",
-                          "emptyDescription": "No events scheduled.",
                           "columns": [
                             {
-                              "name": "name",
                               "label": "Event",
-                              "variant": "h4",
-                              "icon": "calendar"
+                              "icon": "calendar",
+                              "name": "name",
+                              "variant": "h4"
                             },
                             {
-                              "name": "time",
                               "label": "Time",
+                              "name": "time",
                               "variant": "badge"
                             },
                             {
-                              "name": "date",
                               "label": "Date",
+                              "format": "date",
                               "variant": "caption",
-                              "format": "date"
+                              "name": "date"
                             },
                             {
-                              "name": "status",
                               "label": "Status",
-                              "variant": "badge"
+                              "variant": "badge",
+                              "name": "status"
                             }
                           ],
+                          "emptyDescription": "No events scheduled.",
                           "itemActions": [
                             {
-                              "label": "View",
                               "event": "SELECT_DAY",
-                              "icon": "eye"
+                              "icon": "eye",
+                              "label": "View"
                             }
-                          ]
+                          ],
+                          "type": "data-list",
+                          "entity": "CalendarEvent",
+                          "emptyTitle": "No events"
                         }
                       ]
                     }
@@ -662,70 +720,72 @@
                 "effects": [
                   [
                     "fetch",
-                    "CalendarEvent"
+                    "CalendarEvent",
+                    {
+                      "emit": {
+                        "success": "CalendarEventLoaded",
+                        "failure": "CalendarEventLoadFailed"
+                      }
+                    }
                   ],
                   [
                     "render-ui",
                     "main",
                     {
                       "type": "stack",
-                      "direction": "vertical",
                       "gap": "lg",
                       "children": [
                         {
-                          "type": "stack",
-                          "direction": "horizontal",
-                          "gap": "md",
                           "justify": "space-between",
                           "align": "center",
+                          "gap": "md",
+                          "direction": "horizontal",
                           "children": [
                             {
-                              "type": "stack",
                               "direction": "horizontal",
                               "gap": "sm",
+                              "type": "stack",
                               "align": "center",
                               "children": [
                                 {
-                                  "type": "icon",
+                                  "size": "lg",
                                   "name": "clock",
-                                  "size": "lg"
+                                  "type": "icon"
                                 },
                                 {
-                                  "type": "typography",
+                                  "variant": "h2",
                                   "content": "Day View",
-                                  "variant": "h2"
+                                  "type": "typography"
                                 }
                               ]
                             },
                             {
+                              "variant": "ghost",
                               "type": "button",
-                              "label": "Back to Month",
                               "event": "BACK",
-                              "variant": "ghost",
+                              "label": "Back to Month",
                               "icon": "arrow-left"
                             }
-                          ]
+                          ],
+                          "type": "stack"
                         },
                         {
                           "type": "divider"
                         },
                         {
+                          "content": "Events for Selected Day",
                           "type": "typography",
-                          "variant": "h4",
-                          "content": "Events for Selected Day"
+                          "variant": "h4"
                         },
                         {
-                          "type": "data-grid",
-                          "entity": "CalendarEvent",
-                          "emptyIcon": "calendar",
                           "emptyTitle": "No events today",
                           "emptyDescription": "Select a time slot to add an event.",
                           "columns": [
                             {
-                              "name": "name",
                               "label": "Event",
                               "variant": "h4",
-                              "icon": "clock"
+                              "icon": "clock",
+                              "name": "name"
                             },
                             {
                               "name": "time",
@@ -738,21 +798,26 @@
                               "variant": "badge"
                             }
                           ],
+                          "type": "data-grid",
+                          "entity": "CalendarEvent",
                           "itemActions": [
                             {
                               "label": "Select",
                               "event": "SELECT_SLOT",
                               "icon": "check"
                             }
-                          ]
+                          ],
+                          "emptyIcon": "calendar"
                         }
-                      ]
+                      ],
+                      "direction": "vertical"
                     }
                   ]
                 ]
               }
             ]
-          }
+          },
+          "scope": "collection"
         }
       ],
       "pages": [
@@ -768,4 +833,4 @@
       ]
     }
   ]
-}
+}