@almadar/std 6.5.2 → 7.2.0

package/behaviors/registry/molecules/std-cart.orb

@@ -1,7 +1,7 @@
 {
   "name": "std-cart",
   "version": "1.0.0",
-  "description": "Shopping cart molecule. Composes atoms: - Cart-specific browse trait (empty/hasItems/checkout states) - stdModal for the add-item form (responds to ADD_ITEM)",
+  "description": "std-cart as a Function",
   "orbitals": [
     {
       "name": "CartItemOrbital",
@@ -17,8 +17,8 @@
       ],
       "entity": {
         "name": "CartItem",
-        "persistence": "persistent",
         "collection": "cartitems",
+        "persistence": "persistent",
         "fields": [
           {
             "name": "id",
@@ -56,16 +56,81 @@
       "traits": [
         {
           "name": "CartItemCartBrowse",
-          "linkedEntity": "CartItem",
           "category": "interaction",
+          "linkedEntity": "CartItem",
+          "emits": [
+            {
+              "event": "CartItemLoaded",
+              "description": "Fired when the cart collection 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": "pendingId",
+                  "type": "string"
+                }
+              ]
+            },
+            {
+              "event": "CartItemLoadFailed",
+              "description": "Fired when the cart collection fails to load",
+              "scope": "internal",
+              "payload": [
+                {
+                  "name": "message",
+                  "type": "string"
+                }
+              ]
+            }
+          ],
+          "listens": [
+            {
+              "event": "ITEM_CREATED",
+              "triggers": "INIT",
+              "source": {
+                "kind": "trait",
+                "trait": "CartItemPersistor"
+              }
+            },
+            {
+              "event": "ITEM_DELETED",
+              "triggers": "INIT",
+              "source": {
+                "kind": "trait",
+                "trait": "CartItemPersistor"
+              }
+            }
+          ],
           "stateMachine": {
             "states": [
               {
-                "name": "browsing",
+                "name": "loading",
                 "isInitial": true
               },
               {
-                "name": "checkout"
+                "name": "browsing"
+              },
+              {
+                "name": "error"
               }
             ],
             "events": [
@@ -74,49 +139,72 @@
                 "name": "Initialize"
               },
               {
-                "key": "ADD_ITEM",
-                "name": "Add Item"
+                "key": "CartItemLoaded",
+                "name": "CartItem loaded"
               },
               {
-                "key": "REQUEST_REMOVE",
-                "name": "Request Remove",
+                "key": "CartItemLoadFailed",
+                "name": "CartItem load failed",
                 "payload": [
                   {
-                    "name": "id",
-                    "type": "string",
-                    "required": true
+                    "name": "message",
+                    "type": "string"
                   }
                 ]
-              },
-              {
-                "key": "PROCEED_CHECKOUT",
-                "name": "Proceed to Checkout"
-              },
-              {
-                "key": "BACK_TO_CART",
-                "name": "Back to Cart"
-              },
-              {
-                "key": "CONFIRM_ORDER",
-                "name": "Confirm Order"
               }
             ],
             "transitions": [
               {
-                "from": "browsing",
-                "to": "browsing",
+                "from": "loading",
+                "to": "loading",
                 "event": "INIT",
                 "effects": [
                   [
-                    "ref",
-                    "CartItem"
+                    "fetch",
+                    "CartItem",
+                    {
+                      "emit": {
+                        "failure": "CartItemLoadFailed",
+                        "success": "CartItemLoaded"
+                      }
+                    }
                   ],
                   [
                     "render-ui",
                     "main",
                     {
+                      "direction": "vertical",
+                      "className": "py-12",
+                      "gap": "md",
+                      "children": [
+                        {
+                          "type": "spinner",
+                          "size": "lg"
+                        },
+                        {
+                          "variant": "caption",
+                          "color": "muted",
+                          "content": "Loading cart…",
+                          "type": "typography"
+                        }
+                      ],
                       "type": "stack",
+                      "align": "center"
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "loading",
+                "to": "browsing",
+                "event": "CartItemLoaded",
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
                       "direction": "vertical",
+                      "type": "stack",
                       "gap": "lg",
                       "children": [
                         {
@@ -126,26 +214,26 @@
                           "justify": "space-between",
                           "children": [
                             {
-                              "type": "stack",
-                              "direction": "horizontal",
                               "gap": "md",
                               "children": [
                                 {
                                   "type": "icon",
-                                  "name": "shopping-cart",
-                                  "size": "lg"
+                                  "size": "lg",
+                                  "name": "shopping-cart"
                                 },
                                 {
-                                  "type": "typography",
+                                  "variant": "h2",
                                   "content": "Shopping Cart",
-                                  "variant": "h2"
+                                  "type": "typography"
                                 }
-                              ]
+                              ],
+                              "direction": "horizontal",
+                              "type": "stack"
                             },
                             {
-                              "type": "button",
                               "label": "Add Item",
                               "event": "ADD_ITEM",
+                              "type": "button",
                               "variant": "primary",
                               "icon": "plus"
                             }
@@ -155,81 +243,37 @@
                           "type": "divider"
                         },
                         {
-                          "type": "simple-grid",
-                          "columns": 3,
-                          "children": [
-                            {
-                              "type": "stat-display",
-                              "label": "Items",
-                              "value": [
-                                "array/len",
-                                "@entity"
-                              ],
-                              "icon": "package"
-                            },
-                            {
-                              "type": "stat-display",
-                              "label": "Subtotal",
-                              "value": [
-                                "array/len",
-                                "@entity"
-                              ],
-                              "icon": "dollar-sign"
-                            },
-                            {
-                              "type": "stat-display",
-                              "label": "Total",
-                              "value": [
-                                "array/len",
-                                "@entity"
-                              ],
-                              "icon": "receipt"
-                            }
-                          ]
-                        },
-                        {
-                          "type": "divider"
-                        },
-                        {
-                          "type": "data-grid",
-                          "entity": "CartItem",
-                          "emptyIcon": "inbox",
-                          "emptyTitle": "Your cart is empty",
                           "emptyDescription": "Add items to get started.",
                           "itemActions": [
                             {
                               "label": "Remove",
-                              "event": "REQUEST_REMOVE",
                               "variant": "danger",
-                              "size": "sm"
+                              "size": "sm",
+                              "event": "REQUEST_REMOVE"
                             }
                           ],
+                          "type": "data-grid",
+                          "emptyTitle": "Your cart is empty",
+                          "entity": "CartItem",
                           "columns": [
                             {
                               "name": "name",
+                              "icon": "shopping-cart",
                               "label": "Name",
-                              "variant": "h4",
-                              "icon": "shopping-cart"
+                              "variant": "h4"
                             },
                             {
-                              "name": "description",
                               "label": "Description",
-                              "variant": "caption",
-                              "format": "currency"
+                              "name": "description",
+                              "variant": "caption"
                             },
                             {
-                              "name": "status",
                               "label": "Status",
+                              "name": "status",
                               "variant": "badge"
                             }
-                          ]
-                        },
-                        {
-                          "type": "button",
-                          "label": "Proceed to Checkout",
-                          "event": "PROCEED_CHECKOUT",
-                          "variant": "primary",
-                          "icon": "arrow-right"
+                          ],
+                          "emptyIcon": "inbox"
                         }
                       ]
                     }
@@ -237,378 +281,272 @@
                 ]
               },
               {
-                "from": "browsing",
-                "to": "checkout",
-                "event": "PROCEED_CHECKOUT",
+                "from": "loading",
+                "to": "error",
+                "event": "CartItemLoadFailed",
                 "effects": [
-                  [
-                    "ref",
-                    "CartItem"
-                  ],
                   [
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
-                      "direction": "vertical",
-                      "gap": "lg",
+                      "align": "center",
+                      "className": "py-12",
+                      "gap": "md",
                       "children": [
                         {
-                          "type": "stack",
-                          "direction": "horizontal",
-                          "gap": "sm",
-                          "children": [
-                            {
-                              "type": "icon",
-                              "name": "clipboard",
-                              "size": "lg"
-                            },
-                            {
-                              "type": "typography",
-                              "content": "Checkout",
-                              "variant": "h2"
-                            }
-                          ]
+                          "size": "xl",
+                          "name": "alert-triangle",
+                          "color": "destructive",
+                          "type": "icon"
                         },
                         {
-                          "type": "divider"
+                          "content": "Failed to load cart",
+                          "type": "typography",
+                          "variant": "h3"
                         },
                         {
-                          "type": "data-grid",
-                          "entity": "CartItem",
-                          "emptyIcon": "inbox",
-                          "emptyTitle": "Your cart is empty",
-                          "emptyDescription": "Add items to get started.",
-                          "itemActions": [
-                            {
-                              "label": "Remove",
-                              "event": "REQUEST_REMOVE",
-                              "variant": "danger",
-                              "size": "sm"
-                            }
-                          ],
-                          "columns": [
-                            {
-                              "name": "name",
-                              "label": "Name",
-                              "variant": "h4",
-                              "icon": "shopping-cart"
-                            },
-                            {
-                              "name": "description",
-                              "label": "Description",
-                              "variant": "caption",
-                              "format": "currency"
-                            },
-                            {
-                              "name": "status",
-                              "label": "Status",
-                              "variant": "badge"
-                            }
-                          ]
+                          "color": "muted",
+                          "content": "@payload.message",
+                          "type": "typography",
+                          "variant": "body"
                         },
                         {
-                          "type": "stack",
-                          "direction": "horizontal",
-                          "gap": "sm",
-                          "justify": "end",
-                          "children": [
-                            {
-                              "type": "button",
-                              "label": "Back to Cart",
-                              "event": "BACK_TO_CART",
-                              "variant": "ghost",
-                              "icon": "arrow-left"
-                            },
-                            {
-                              "type": "button",
-                              "label": "Confirm Order",
-                              "event": "CONFIRM_ORDER",
-                              "variant": "primary",
-                              "icon": "check"
-                            }
-                          ]
+                          "variant": "primary",
+                          "label": "Retry",
+                          "icon": "rotate-ccw",
+                          "type": "button",
+                          "event": "INIT"
                         }
-                      ]
+                      ],
+                      "type": "stack",
+                      "direction": "vertical"
                     }
                   ]
                 ]
               },
               {
-                "from": "checkout",
-                "to": "browsing",
-                "event": "BACK_TO_CART",
+                "from": "browsing",
+                "to": "loading",
+                "event": "INIT",
                 "effects": [
                   [
-                    "ref",
-                    "CartItem"
+                    "fetch",
+                    "CartItem",
+                    {
+                      "emit": {
+                        "success": "CartItemLoaded",
+                        "failure": "CartItemLoadFailed"
+                      }
+                    }
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "spinner",
+                      "size": "lg"
+                    }
                   ]
                 ]
               },
               {
-                "from": "checkout",
-                "to": "browsing",
-                "event": "CONFIRM_ORDER",
+                "from": "error",
+                "to": "loading",
+                "event": "INIT",
                 "effects": [
                   [
-                    "ref",
-                    "CartItem"
+                    "fetch",
+                    "CartItem",
+                    {
+                      "emit": {
+                        "failure": "CartItemLoadFailed",
+                        "success": "CartItemLoaded"
+                      }
+                    }
                   ],
                   [
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
-                      "direction": "vertical",
-                      "gap": "lg",
-                      "align": "center",
-                      "children": [
-                        {
-                          "type": "icon",
-                          "name": "check-circle",
-                          "size": "lg"
-                        },
-                        {
-                          "type": "typography",
-                          "content": "Order Confirmed",
-                          "variant": "h2"
-                        },
-                        {
-                          "type": "typography",
-                          "content": "Your order has been placed successfully.",
-                          "variant": "body"
-                        },
-                        {
-                          "type": "button",
-                          "label": "Continue Shopping",
-                          "event": "INIT",
-                          "variant": "primary"
-                        }
-                      ]
+                      "type": "spinner",
+                      "size": "lg"
                     }
                   ]
                 ]
               }
             ]
-          }
+          },
+          "scope": "collection"
         },
         {
           "ref": "Modal.traits.ModalRecordModal",
           "name": "CartItemAddItem",
           "linkedEntity": "CartItem",
+          "config": {
+            "mode": "create",
+            "icon": "plus-circle",
+            "title": "Add Item",
+            "openButtonLabel": "Add Item",
+            "fields": [
+              "name",
+              "description",
+              "status"
+            ]
+          },
           "events": {
             "OPEN": "ADD_ITEM"
-          },
-          "effects": {
-            "INIT": [
-              [
-                "ref",
-                "CartItem"
-              ]
-            ],
-            "ADD_ITEM": [
-              [
-                "fetch",
-                "CartItem"
-              ],
-              [
-                "render-ui",
-                "modal",
-                {
-                  "type": "stack",
-                  "direction": "vertical",
-                  "gap": "md",
-                  "children": [
-                    {
-                      "type": "stack",
-                      "direction": "horizontal",
-                      "gap": "sm",
-                      "children": [
-                        {
-                          "type": "icon",
-                          "name": "plus-circle",
-                          "size": "md"
-                        },
-                        {
-                          "type": "typography",
-                          "content": "Add Item",
-                          "variant": "h3"
-                        }
-                      ]
-                    },
-                    {
-                      "type": "divider"
-                    },
-                    {
-                      "type": "form-section",
-                      "entity": "CartItem",
-                      "mode": "create",
-                      "submitEvent": "SAVE",
-                      "cancelEvent": "CLOSE",
-                      "fields": [
-                        "name",
-                        "description",
-                        "status"
-                      ]
-                    }
-                  ]
-                }
-              ]
-            ],
-            "CLOSE": [
-              [
-                "render-ui",
-                "modal",
-                null
-              ],
-              [
-                "notify",
-                "Cancelled",
-                "info"
-              ]
-            ],
-            "SAVE": [
-              [
-                "persist",
-                "create",
-                "CartItem",
-                "@payload.data"
-              ],
-              [
-                "render-ui",
-                "modal",
-                null
-              ]
-            ]
           }
         },
         {
           "ref": "Confirmation.traits.ConfirmActionConfirmation",
           "name": "CartItemRemoveConfirm",
           "linkedEntity": "CartItem",
-          "events": {
-            "REQUEST": "REQUEST_REMOVE",
-            "CONFIRM": "CONFIRM_REMOVE"
+          "config": {
+            "icon": "alert-triangle",
+            "title": "Remove Item",
+            "confirmLabel": "Remove",
+            "alertMessage": "Are you sure you want to remove this item from your cart?"
           },
-          "effects": {
-            "INIT": [
-              [
-                "ref",
-                "CartItem"
-              ]
-            ],
-            "REQUEST_REMOVE": [
-              [
-                "set",
-                "@entity.pendingId",
-                "@payload.id"
-              ],
-              [
-                "fetch",
-                "CartItem",
+          "events": {
+            "CONFIRM": "CONFIRM_REMOVE",
+            "REQUEST": "REQUEST_REMOVE"
+          }
+        },
+        {
+          "name": "CartItemPersistor",
+          "category": "lifecycle",
+          "linkedEntity": "CartItem",
+          "emits": [
+            {
+              "event": "ITEM_CREATED",
+              "scope": "external",
+              "payload": [
                 {
-                  "id": "@payload.id"
+                  "name": "id",
+                  "type": "string"
                 }
-              ],
-              [
-                "render-ui",
-                "modal",
+              ]
+            },
+            {
+              "event": "ITEM_DELETED",
+              "scope": "external",
+              "payload": [
                 {
-                  "type": "stack",
-                  "direction": "vertical",
-                  "gap": "md",
-                  "children": [
-                    {
-                      "type": "stack",
-                      "direction": "horizontal",
-                      "gap": "sm",
-                      "align": "center",
-                      "children": [
-                        {
-                          "type": "icon",
-                          "name": "alert-triangle",
-                          "size": "md"
-                        },
-                        {
-                          "type": "typography",
-                          "content": "Remove Item",
-                          "variant": "h3"
-                        }
-                      ]
-                    },
-                    {
-                      "type": "divider"
-                    },
-                    {
-                      "type": "alert",
-                      "variant": "danger",
-                      "message": "Are you sure you want to remove this item from your cart?"
-                    },
-                    {
-                      "type": "stack",
-                      "direction": "horizontal",
-                      "gap": "sm",
-                      "justify": "end",
-                      "children": [
-                        {
-                          "type": "button",
-                          "label": "Cancel",
-                          "event": "CANCEL",
-                          "variant": "ghost"
-                        },
-                        {
-                          "type": "button",
-                          "label": "Remove",
-                          "event": "CONFIRM_REMOVE",
-                          "variant": "danger",
-                          "icon": "check"
-                        }
-                      ]
-                    }
-                  ]
+                  "name": "id",
+                  "type": "string"
                 }
               ]
+            }
+          ],
+          "listens": [
+            {
+              "event": "SAVE",
+              "triggers": "DO_CREATE",
+              "source": {
+                "kind": "trait",
+                "trait": "CartItemAddItem"
+              }
+            },
+            {
+              "event": "CONFIRM_REMOVE",
+              "triggers": "DO_DELETE",
+              "source": {
+                "kind": "trait",
+                "trait": "CartItemRemoveConfirm"
+              }
+            }
+          ],
+          "stateMachine": {
+            "states": [
+              {
+                "name": "idle",
+                "isInitial": true
+              }
             ],
-            "CONFIRM_REMOVE": [
-              [
-                "persist",
-                "delete",
-                "CartItem",
-                "@entity.pendingId"
-              ],
-              [
-                "render-ui",
-                "modal",
-                null
-              ],
-              [
-                "ref",
-                "CartItem"
-              ]
-            ],
-            "CANCEL": [
-              [
-                "render-ui",
-                "modal",
-                null
-              ],
-              [
-                "ref",
-                "CartItem"
-              ]
+            "events": [
+              {
+                "key": "INIT",
+                "name": "Initialize"
+              },
+              {
+                "key": "DO_CREATE",
+                "name": "Do Create",
+                "payload": [
+                  {
+                    "name": "data",
+                    "type": "object",
+                    "required": true
+                  }
+                ]
+              },
+              {
+                "key": "DO_DELETE",
+                "name": "Do Delete",
+                "payload": [
+                  {
+                    "name": "id",
+                    "type": "string"
+                  }
+                ]
+              },
+              {
+                "key": "ITEM_CREATED",
+                "name": "Item Created"
+              },
+              {
+                "key": "ITEM_DELETED",
+                "name": "Item Deleted"
+              }
             ],
-            "CLOSE": [
-              [
-                "render-ui",
-                "modal",
-                null
-              ],
-              [
-                "ref",
-                "CartItem"
-              ]
+            "transitions": [
+              {
+                "from": "idle",
+                "to": "idle",
+                "event": "INIT"
+              },
+              {
+                "from": "idle",
+                "to": "idle",
+                "event": "DO_CREATE",
+                "effects": [
+                  [
+                    "persist",
+                    "create",
+                    "CartItem",
+                    "@payload.data"
+                  ],
+                  [
+                    "emit",
+                    "ITEM_CREATED",
+                    {
+                      "id": "@payload.data.id"
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "idle",
+                "to": "idle",
+                "event": "DO_DELETE",
+                "effects": [
+                  [
+                    "persist",
+                    "delete",
+                    "CartItem",
+                    "@entity.pendingId"
+                  ],
+                  [
+                    "emit",
+                    "ITEM_DELETED",
+                    {
+                      "id": "@entity.pendingId"
+                    }
+                  ]
+                ]
+              }
             ]
-          }
+          },
+          "scope": "instance"
         }
       ],
       "pages": [
@@ -624,10 +562,13 @@
             },
             {
               "ref": "CartItemRemoveConfirm"
+            },
+            {
+              "ref": "CartItemPersistor"
             }
           ]
         }
       ]
     }
   ]
-}
+}