npm - @almadar/std - Versions diffs - 6.1.0 → 6.1.7 - Mend

@almadar/std 6.1.0 → 6.1.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (446) hide show

package/dist/behaviors/exports/molecules/std-inventory.orb DELETED Viewed

@@ -1,823 +0,0 @@
-{
-  "name": "InventoryItemOrbital",
-  "version": "1.0.0",
-  "orbitals": [
-    {
-      "name": "InventoryItemOrbital",
-      "entity": {
-        "name": "InventoryItem",
-        "persistence": "persistent",
-        "collection": "inventoryitems",
-        "fields": [
-          {
-            "name": "id",
-            "type": "string"
-          },
-          {
-            "name": "name",
-            "type": "string"
-          },
-          {
-            "name": "description",
-            "type": "string"
-          },
-          {
-            "name": "status",
-            "type": "string",
-            "default": "active",
-            "values": [
-              "active",
-              "inactive",
-              "pending"
-            ]
-          },
-          {
-            "name": "createdAt",
-            "type": "string"
-          },
-          {
-            "name": "pendingId",
-            "type": "string"
-          }
-        ],
-        "instances": [
-          {
-            "id": "item-1",
-            "name": "Health Potion",
-            "description": "Restores 50 HP",
-            "status": "active",
-            "pendingId": ""
-          },
-          {
-            "id": "item-2",
-            "name": "Iron Sword",
-            "description": "A sturdy blade",
-            "status": "active",
-            "pendingId": ""
-          },
-          {
-            "id": "item-3",
-            "name": "Wooden Shield",
-            "description": "Basic protection",
-            "status": "active",
-            "pendingId": ""
-          }
-        ]
-      },
-      "traits": [
-        {
-          "name": "InventoryItemBrowse",
-          "linkedEntity": "InventoryItem",
-          "category": "interaction",
-          "listens": [
-            {
-              "event": "ITEM_ADDED",
-              "triggers": "INIT"
-            },
-            {
-              "event": "ITEM_USED",
-              "triggers": "INIT"
-            },
-            {
-              "event": "CONFIRM_DROP",
-              "triggers": "INIT"
-            }
-          ],
-          "stateMachine": {
-            "states": [
-              {
-                "name": "browsing",
-                "isInitial": true
-              }
-            ],
-            "events": [
-              {
-                "key": "INIT",
-                "name": "Initialize"
-              },
-              {
-                "key": "ADD_ITEM",
-                "name": "ADD_ITEM"
-              },
-              {
-                "key": "USE_ITEM",
-                "name": "USE_ITEM",
-                "payload": [
-                  {
-                    "name": "id",
-                    "type": "string",
-                    "required": true
-                  },
-                  {
-                    "name": "row",
-                    "type": "object"
-                  }
-                ]
-              },
-              {
-                "key": "DROP",
-                "name": "DROP",
-                "payload": [
-                  {
-                    "name": "id",
-                    "type": "string",
-                    "required": true
-                  },
-                  {
-                    "name": "row",
-                    "type": "object"
-                  }
-                ]
-              }
-            ],
-            "transitions": [
-              {
-                "from": "browsing",
-                "to": "browsing",
-                "event": "INIT",
-                "effects": [
-                  [
-                    "ref",
-                    "InventoryItem"
-                  ],
-                  [
-                    "render-ui",
-                    "main",
-                    {
-                      "type": "stack",
-                      "direction": "vertical",
-                      "gap": "lg",
-                      "className": "max-w-5xl mx-auto w-full",
-                      "children": [
-                        {
-                          "type": "stack",
-                          "direction": "horizontal",
-                          "gap": "md",
-                          "justify": "space-between",
-                          "align": "center",
-                          "children": [
-                            {
-                              "type": "stack",
-                              "direction": "horizontal",
-                              "gap": "sm",
-                              "align": "center",
-                              "children": [
-                                {
-                                  "type": "icon",
-                                  "name": "package",
-                                  "size": "lg"
-                                },
-                                {
-                                  "type": "typography",
-                                  "content": "InventoryItems Inventory",
-                                  "variant": "h2"
-                                }
-                              ]
-                            },
-                            {
-                              "type": "stack",
-                              "direction": "horizontal",
-                              "gap": "sm",
-                              "children": [
-                                {
-                                  "type": "button",
-                                  "label": "Add InventoryItem",
-                                  "event": "ADD_ITEM",
-                                  "variant": "primary",
-                                  "icon": "plus"
-                                }
-                              ]
-                            }
-                          ]
-                        },
-                        {
-                          "type": "divider"
-                        },
-                        {
-                          "type": "data-grid",
-                          "entity": "InventoryItem",
-                          "emptyIcon": "inbox",
-                          "emptyTitle": "No items yet",
-                          "emptyDescription": "Add your first item to get started.",
-                          "itemActions": [
-                            {
-                              "label": "Use",
-                              "event": "USE_ITEM",
-                              "variant": "ghost",
-                              "size": "sm"
-                            },
-                            {
-                              "label": "Drop",
-                              "event": "DROP",
-                              "variant": "danger",
-                              "size": "sm"
-                            }
-                          ],
-                          "columns": [
-                            {
-                              "name": "name",
-                              "label": "Name",
-                              "variant": "h4",
-                              "icon": "package"
-                            },
-                            {
-                              "name": "description",
-                              "label": "Description",
-                              "variant": "badge",
-                              "colorMap": {
-                                "active": "success",
-                                "completed": "success",
-                                "done": "success",
-                                "pending": "warning",
-                                "draft": "warning",
-                                "scheduled": "warning",
-                                "inactive": "neutral",
-                                "archived": "neutral",
-                                "disabled": "neutral",
-                                "error": "destructive",
-                                "cancelled": "destructive",
-                                "failed": "destructive"
-                              }
-                            },
-                            {
-                              "name": "status",
-                              "label": "Status",
-                              "variant": "caption"
-                            }
-                          ]
-                        }
-                      ]
-                    }
-                  ]
-                ]
-              }
-            ]
-          }
-        },
-        {
-          "name": "InventoryItemAdd",
-          "linkedEntity": "InventoryItem",
-          "category": "interaction",
-          "emits": [
-            {
-              "event": "SAVE"
-            },
-            {
-              "event": "ITEM_ADDED"
-            }
-          ],
-          "stateMachine": {
-            "states": [
-              {
-                "name": "closed",
-                "isInitial": true
-              },
-              {
-                "name": "open"
-              }
-            ],
-            "events": [
-              {
-                "key": "INIT",
-                "name": "Initialize"
-              },
-              {
-                "key": "ADD_ITEM",
-                "name": "Open"
-              },
-              {
-                "key": "CLOSE",
-                "name": "Close"
-              },
-              {
-                "key": "SAVE",
-                "name": "Save",
-                "payload": [
-                  {
-                    "name": "data",
-                    "type": "object",
-                    "required": true
-                  }
-                ]
-              }
-            ],
-            "transitions": [
-              {
-                "from": "closed",
-                "to": "closed",
-                "event": "INIT",
-                "effects": [
-                  [
-                    "ref",
-                    "InventoryItem"
-                  ]
-                ]
-              },
-              {
-                "from": "closed",
-                "to": "open",
-                "event": "ADD_ITEM",
-                "effects": [
-                  [
-                    "fetch",
-                    "InventoryItem"
-                  ],
-                  [
-                    "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 InventoryItem",
-                              "variant": "h3"
-                            }
-                          ]
-                        },
-                        {
-                          "type": "divider"
-                        },
-                        {
-                          "type": "form-section",
-                          "entity": "InventoryItem",
-                          "mode": "create",
-                          "submitEvent": "SAVE",
-                          "cancelEvent": "CLOSE",
-                          "fields": [
-                            "name",
-                            "description",
-                            "status"
-                          ]
-                        }
-                      ]
-                    }
-                  ]
-                ]
-              },
-              {
-                "from": "open",
-                "to": "closed",
-                "event": "CLOSE",
-                "effects": [
-                  [
-                    "render-ui",
-                    "modal",
-                    null
-                  ],
-                  [
-                    "notify",
-                    "Cancelled",
-                    "info"
-                  ]
-                ]
-              },
-              {
-                "from": "open",
-                "to": "closed",
-                "event": "SAVE",
-                "effects": [
-                  [
-                    "persist",
-                    "create",
-                    "InventoryItem",
-                    "@payload.data"
-                  ],
-                  [
-                    "render-ui",
-                    "modal",
-                    null
-                  ],
-                  [
-                    "emit",
-                    "ITEM_ADDED"
-                  ],
-                  [
-                    "notify",
-                    "InventoryItem created successfully"
-                  ]
-                ]
-              }
-            ]
-          }
-        },
-        {
-          "name": "InventoryItemUse",
-          "linkedEntity": "InventoryItem",
-          "category": "interaction",
-          "emits": [
-            {
-              "event": "SAVE"
-            },
-            {
-              "event": "ITEM_USED"
-            }
-          ],
-          "stateMachine": {
-            "states": [
-              {
-                "name": "closed",
-                "isInitial": true
-              },
-              {
-                "name": "open"
-              }
-            ],
-            "events": [
-              {
-                "key": "INIT",
-                "name": "Initialize"
-              },
-              {
-                "key": "USE_ITEM",
-                "name": "Open",
-                "payload": [
-                  {
-                    "name": "id",
-                    "type": "string",
-                    "required": true
-                  }
-                ]
-              },
-              {
-                "key": "CLOSE",
-                "name": "Close"
-              },
-              {
-                "key": "SAVE",
-                "name": "Save",
-                "payload": [
-                  {
-                    "name": "data",
-                    "type": "object",
-                    "required": true
-                  }
-                ]
-              }
-            ],
-            "transitions": [
-              {
-                "from": "closed",
-                "to": "closed",
-                "event": "INIT",
-                "effects": [
-                  [
-                    "ref",
-                    "InventoryItem"
-                  ]
-                ]
-              },
-              {
-                "from": "closed",
-                "to": "open",
-                "event": "USE_ITEM",
-                "effects": [
-                  [
-                    "fetch",
-                    "InventoryItem",
-                    {
-                      "id": "@payload.id"
-                    }
-                  ],
-                  [
-                    "render-ui",
-                    "modal",
-                    {
-                      "type": "stack",
-                      "direction": "vertical",
-                      "gap": "md",
-                      "align": "center",
-                      "children": [
-                        {
-                          "type": "stack",
-                          "direction": "horizontal",
-                          "gap": "sm",
-                          "align": "center",
-                          "children": [
-                            {
-                              "type": "icon",
-                              "name": "zap",
-                              "size": "md"
-                            },
-                            {
-                              "type": "typography",
-                              "content": "Use InventoryItem",
-                              "variant": "h3"
-                            }
-                          ]
-                        },
-                        {
-                          "type": "divider"
-                        },
-                        {
-                          "type": "typography",
-                          "content": "@entity.name",
-                          "variant": "body"
-                        },
-                        {
-                          "type": "stack",
-                          "direction": "horizontal",
-                          "gap": "sm",
-                          "justify": "center",
-                          "children": [
-                            {
-                              "type": "button",
-                              "label": "Cancel",
-                              "event": "CLOSE",
-                              "variant": "ghost"
-                            },
-                            {
-                              "type": "button",
-                              "label": "Confirm Use",
-                              "event": "SAVE",
-                              "variant": "primary",
-                              "icon": "check"
-                            }
-                          ]
-                        }
-                      ]
-                    }
-                  ]
-                ]
-              },
-              {
-                "from": "open",
-                "to": "closed",
-                "event": "CLOSE",
-                "effects": [
-                  [
-                    "render-ui",
-                    "modal",
-                    null
-                  ],
-                  [
-                    "notify",
-                    "Cancelled",
-                    "info"
-                  ]
-                ]
-              },
-              {
-                "from": "open",
-                "to": "closed",
-                "event": "SAVE",
-                "effects": [
-                  [
-                    "persist",
-                    "update",
-                    "InventoryItem",
-                    "@payload.data"
-                  ],
-                  [
-                    "render-ui",
-                    "modal",
-                    null
-                  ],
-                  [
-                    "emit",
-                    "ITEM_USED"
-                  ],
-                  [
-                    "notify",
-                    "InventoryItem updated successfully"
-                  ]
-                ]
-              }
-            ]
-          }
-        },
-        {
-          "name": "InventoryItemDrop",
-          "linkedEntity": "InventoryItem",
-          "category": "interaction",
-          "emits": [
-            {
-              "event": "CONFIRM_DROP"
-            }
-          ],
-          "stateMachine": {
-            "states": [
-              {
-                "name": "idle",
-                "isInitial": true
-              },
-              {
-                "name": "confirming"
-              }
-            ],
-            "events": [
-              {
-                "key": "INIT",
-                "name": "Initialize"
-              },
-              {
-                "key": "DROP",
-                "name": "Request Confirmation",
-                "payload": [
-                  {
-                    "name": "id",
-                    "type": "string",
-                    "required": true
-                  }
-                ]
-              },
-              {
-                "key": "CONFIRM_DROP",
-                "name": "Confirm"
-              },
-              {
-                "key": "CANCEL",
-                "name": "Cancel"
-              },
-              {
-                "key": "CLOSE",
-                "name": "Close"
-              }
-            ],
-            "transitions": [
-              {
-                "from": "idle",
-                "to": "idle",
-                "event": "INIT",
-                "effects": [
-                  [
-                    "ref",
-                    "InventoryItem"
-                  ]
-                ]
-              },
-              {
-                "from": "idle",
-                "to": "confirming",
-                "event": "DROP",
-                "effects": [
-                  [
-                    "set",
-                    "@entity.pendingId",
-                    "@payload.id"
-                  ],
-                  [
-                    "fetch",
-                    "InventoryItem",
-                    {
-                      "id": "@payload.id"
-                    }
-                  ],
-                  [
-                    "render-ui",
-                    "modal",
-                    {
-                      "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": "Drop InventoryItem",
-                              "variant": "h3"
-                            }
-                          ]
-                        },
-                        {
-                          "type": "divider"
-                        },
-                        {
-                          "type": "alert",
-                          "variant": "danger",
-                          "message": "Are you sure you want to drop this inventoryitem?"
-                        },
-                        {
-                          "type": "stack",
-                          "direction": "horizontal",
-                          "gap": "sm",
-                          "justify": "end",
-                          "children": [
-                            {
-                              "type": "button",
-                              "label": "Cancel",
-                              "event": "CANCEL",
-                              "variant": "ghost"
-                            },
-                            {
-                              "type": "button",
-                              "label": "Drop",
-                              "event": "CONFIRM_DROP",
-                              "variant": "danger",
-                              "icon": "check"
-                            }
-                          ]
-                        }
-                      ]
-                    }
-                  ]
-                ]
-              },
-              {
-                "from": "confirming",
-                "to": "idle",
-                "event": "CONFIRM_DROP",
-                "effects": [
-                  [
-                    "persist",
-                    "delete",
-                    "InventoryItem",
-                    "@entity.pendingId"
-                  ],
-                  [
-                    "render-ui",
-                    "modal",
-                    null
-                  ],
-                  [
-                    "ref",
-                    "InventoryItem"
-                  ],
-                  [
-                    "notify",
-                    "InventoryItem deleted successfully"
-                  ]
-                ]
-              },
-              {
-                "from": "confirming",
-                "to": "idle",
-                "event": "CANCEL",
-                "effects": [
-                  [
-                    "render-ui",
-                    "modal",
-                    null
-                  ],
-                  [
-                    "ref",
-                    "InventoryItem"
-                  ]
-                ]
-              },
-              {
-                "from": "confirming",
-                "to": "idle",
-                "event": "CLOSE",
-                "effects": [
-                  [
-                    "render-ui",
-                    "modal",
-                    null
-                  ],
-                  [
-                    "ref",
-                    "InventoryItem"
-                  ]
-                ]
-              }
-            ]
-          }
-        }
-      ],
-      "pages": [
-        {
-          "name": "InventoryItemPage",
-          "path": "/inventoryitems",
-          "traits": [
-            {
-              "ref": "InventoryItemBrowse"
-            },
-            {
-              "ref": "InventoryItemAdd"
-            },
-            {
-              "ref": "InventoryItemUse"
-            },
-            {
-              "ref": "InventoryItemDrop"
-            }
-          ]
-        }
-      ]
-    }
-  ],
-  "description": "Item collection molecule. Composes atoms via shared event bus: - stdBrowse: data-grid with item actions (fires ADD_ITEM, USE_ITEM, DROP) - stdModal (add): create form for adding items (responds to ADD_ITEM) - stdModal (use): item detail for using items (responds to USE_ITEM) - stdConfirmation: drop confirmation (responds to DROP) No emits/listens wiring. Traits on the same page share the event bus. Only the trait with a matching transition from its current state responds. (2026-04-08). The canonical source for std behaviors is now the registry `.orb` file at `packages/almadar-std/behaviors/registry/<level>/<name>.orb`, which is generated from this TS source by `tools/almadar-behavior-ts-to-orb/` and consumed by the compiler's embedded loader. Consumers should import behaviors via `.lolo`/`.orb` `uses` declarations and reference them as `Alias.entity` / `Alias.traits.X` / `Alias.pages.X`, applying overrides at the call site (`linkedEntity`, `name`, `events`, `effects`, `listens`, `emitsScope`). The TS `*Params` interface and the exported factory functions remain ONLY as the authoring path for the converter; they are NOT a stable public API and may change without notice. See `docs/Almadar_Orb_Behaviors.md` for the orbital-as-function model and `docs/LOLO_Gaps.md` for the migration plan."
-}