@almadar/std 3.2.3 → 3.3.4

package/LICENSE

@@ -1,21 +1,72 @@
-MIT License
-
-Copyright (c) 2026 Almadar Team
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+Business Source License 1.1
+
+Parameters
+
+Licensor:             Almadar FZE
+Licensed Work:        KFlow Builder / Almadar
+                      The Licensed Work is (c) 2025-2026 Almadar FZE.
+Additional Use Grant: You may make production use of the Licensed Work for
+                      non-commercial purposes and for internal evaluation.
+                      Production use for commercial purposes requires a
+                      commercial license from the Licensor.
+Change Date:          2030-02-01
+Change License:       Apache License, Version 2.0
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited
+production use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under
+the terms of the Change License, and the rights granted in the paragraph
+above terminate.
+
+If your use of the Licensed Work does not comply with the requirements
+currently in effect as described in this License, you must purchase a
+commercial license from the Licensor, its affiliated entities, or authorized
+resellers, or you must refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works
+of the Licensed Work, are subject to this License. This License applies
+separately for each version of the Licensed Work and the Change Date may vary
+for each version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy
+of the Licensed Work. If you receive the Licensed Work in original or
+modified form from a third party, the terms and conditions set forth in this
+License apply to your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other
+versions of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of
+Licensor or its affiliates (provided that you may use a trademark or logo of
+Licensor as expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
+AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
+EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
+TITLE.
+
+---
+
+License text copyright (c) 2017 MariaDB Corporation Ab, All Rights Reserved.
+"Business Source License" is a trademark of MariaDB Corporation Ab.
+
+ADDITIONAL TERMS:
+
+Documentation (builder/packages/website/docs/) is licensed under CC BY 4.0.
+
+TRADEMARKS:
+
+"Orbital", "KFlow", "Almadar", and the Almadar logo are trademarks of
+Almadar FZE. You may not use these trademarks without prior written
+permission from Almadar FZE.
+
+For licensing inquiries: licensing@almadar.io

package/README.md

@@ -22,4 +22,4 @@ import { /* ... */ } from '@almadar/std';
 
 ## License
 
-MIT
+BSL 1.1 (Business Source License). Converts to Apache 2.0 on 2030-02-01. Non-production use is free.

package/behaviors/exports/atoms/std-combat-log.orb

@@ -1,10 +1,10 @@
 {
-  "name": "CombatLogOrbital",
+  "name": "CombatLogEntryOrbital",
   "orbitals": [
     {
-      "name": "CombatLogOrbital",
+      "name": "CombatLogEntryOrbital",
       "entity": {
-        "name": "CombatLog",
+        "name": "CombatLogEntry",
         "persistence": "runtime",
         "fields": [
           {
@@ -37,8 +37,8 @@
       },
       "traits": [
         {
-          "name": "CombatLogCombatLog",
-          "linkedEntity": "CombatLog",
+          "name": "CombatLogEntryCombatLog",
+          "linkedEntity": "CombatLogEntry",
           "category": "interaction",
           "stateMachine": {
             "states": [
@@ -76,14 +76,14 @@
                 "effects": [
                   [
                     "fetch",
-                    "CombatLog"
+                    "CombatLogEntry"
                   ],
                   [
                     "render-ui",
                     "main",
                     {
                       "type": "combat-log",
-                      "events": "@CombatLog",
+                      "events": "@CombatLogEntry",
                       "maxVisible": 10,
                       "autoScroll": true,
                       "showTimestamps": true,
@@ -102,7 +102,7 @@
                     "main",
                     {
                       "type": "combat-log",
-                      "events": "@CombatLog",
+                      "events": "@CombatLogEntry",
                       "maxVisible": 10,
                       "autoScroll": true,
                       "showTimestamps": true,
@@ -121,7 +121,7 @@
                     "main",
                     {
                       "type": "combat-log",
-                      "events": "@CombatLog",
+                      "events": "@CombatLogEntry",
                       "maxVisible": 10,
                       "autoScroll": true,
                       "showTimestamps": true,
@@ -136,11 +136,11 @@
       ],
       "pages": [
         {
-          "name": "CombatLogLogPage",
-          "path": "/combatlogs",
+          "name": "CombatLogEntryLogPage",
+          "path": "/combatlogentrys",
           "traits": [
             {
-              "ref": "CombatLogCombatLog"
+              "ref": "CombatLogEntryCombatLog"
             }
           ]
         }

package/behaviors/exports/atoms/std-dialogue-box.orb

@@ -1,10 +1,10 @@
 {
-  "name": "DialogueBoxOrbital",
+  "name": "DialogueNodeOrbital",
   "orbitals": [
     {
-      "name": "DialogueBoxOrbital",
+      "name": "DialogueNodeOrbital",
       "entity": {
-        "name": "DialogueBox",
+        "name": "DialogueNode",
         "persistence": "runtime",
         "fields": [
           {
@@ -47,8 +47,8 @@
       },
       "traits": [
         {
-          "name": "DialogueBoxDialogue",
-          "linkedEntity": "DialogueBox",
+          "name": "DialogueNodeDialogue",
+          "linkedEntity": "DialogueNode",
           "category": "interaction",
           "stateMachine": {
             "states": [
@@ -97,7 +97,7 @@
                 "effects": [
                   [
                     "fetch",
-                    "DialogueBox"
+                    "DialogueNode"
                   ],
                   [
                     "set",
@@ -131,7 +131,7 @@
                 "effects": [
                   [
                     "fetch",
-                    "DialogueBox"
+                    "DialogueNode"
                   ],
                   [
                     "render-ui",
@@ -206,7 +206,7 @@
                 "effects": [
                   [
                     "fetch",
-                    "DialogueBox"
+                    "DialogueNode"
                   ],
                   [
                     "render-ui",
@@ -229,11 +229,11 @@
       ],
       "pages": [
         {
-          "name": "DialogueBoxDialoguePage",
-          "path": "/dialogueboxs",
+          "name": "DialogueNodeDialoguePage",
+          "path": "/dialoguenodes",
           "traits": [
             {
-              "ref": "DialogueBoxDialogue"
+              "ref": "DialogueNodeDialogue"
             }
           ]
         }

package/behaviors/exports/atoms/std-game-audio.orb

@@ -1,10 +1,10 @@
 {
-  "name": "GameAudioOrbital",
+  "name": "AudioTrackOrbital",
   "orbitals": [
     {
-      "name": "GameAudioOrbital",
+      "name": "AudioTrackOrbital",
       "entity": {
-        "name": "GameAudio",
+        "name": "AudioTrack",
         "persistence": "runtime",
         "fields": [
           {
@@ -37,8 +37,8 @@
       },
       "traits": [
         {
-          "name": "GameAudioGameAudio",
-          "linkedEntity": "GameAudio",
+          "name": "AudioTrackGameAudio",
+          "linkedEntity": "AudioTrack",
           "category": "interaction",
           "stateMachine": {
             "states": [
@@ -65,7 +65,7 @@
                 "effects": [
                   [
                     "fetch",
-                    "GameAudio"
+                    "AudioTrack"
                   ],
                   [
                     "render-ui",
@@ -104,11 +104,11 @@
       ],
       "pages": [
         {
-          "name": "GameAudioAudioPage",
-          "path": "/gameaudios",
+          "name": "AudioTrackAudioPage",
+          "path": "/audiotracks",
           "traits": [
             {
-              "ref": "GameAudioGameAudio"
+              "ref": "AudioTrackGameAudio"
             }
           ]
         }

package/behaviors/exports/atoms/std-game-canvas3d.orb

@@ -1,10 +1,10 @@
 {
-  "name": "GameCanvas3dOrbital",
+  "name": "Canvas3dSceneOrbital",
   "orbitals": [
     {
-      "name": "GameCanvas3dOrbital",
+      "name": "Canvas3dSceneOrbital",
       "entity": {
-        "name": "GameCanvas3d",
+        "name": "Canvas3dScene",
         "persistence": "runtime",
         "fields": [
           {
@@ -37,8 +37,8 @@
       },
       "traits": [
         {
-          "name": "GameCanvas3dGameCanvas3d",
-          "linkedEntity": "GameCanvas3d",
+          "name": "Canvas3dSceneGameCanvas3d",
+          "linkedEntity": "Canvas3dScene",
           "category": "interaction",
           "stateMachine": {
             "states": [
@@ -90,16 +90,16 @@
                 "effects": [
                   [
                     "fetch",
-                    "GameCanvas3d"
+                    "Canvas3dScene"
                   ],
                   [
                     "render-ui",
                     "main",
                     {
                       "type": "game-canvas3-d",
-                      "tiles": "@GameCanvas3d",
-                      "units": "@GameCanvas3d",
-                      "features": "@GameCanvas3d",
+                      "tiles": "@Canvas3dScene",
+                      "units": "@Canvas3dScene",
+                      "features": "@Canvas3dScene",
                       "orientation": "isometric",
                       "cameraMode": "orbital",
                       "showGrid": true,
@@ -121,9 +121,9 @@
                     "main",
                     {
                       "type": "game-canvas3-d",
-                      "tiles": "@GameCanvas3d",
-                      "units": "@GameCanvas3d",
-                      "features": "@GameCanvas3d",
+                      "tiles": "@Canvas3dScene",
+                      "units": "@Canvas3dScene",
+                      "features": "@Canvas3dScene",
                       "orientation": "isometric",
                       "cameraMode": "orbital",
                       "showGrid": true,
@@ -145,9 +145,9 @@
                     "main",
                     {
                       "type": "game-canvas3-d",
-                      "tiles": "@GameCanvas3d",
-                      "units": "@GameCanvas3d",
-                      "features": "@GameCanvas3d",
+                      "tiles": "@Canvas3dScene",
+                      "units": "@Canvas3dScene",
+                      "features": "@Canvas3dScene",
                       "orientation": "isometric",
                       "cameraMode": "orbital",
                       "showGrid": true,
@@ -169,9 +169,9 @@
                     "main",
                     {
                       "type": "game-canvas3-d",
-                      "tiles": "@GameCanvas3d",
-                      "units": "@GameCanvas3d",
-                      "features": "@GameCanvas3d",
+                      "tiles": "@Canvas3dScene",
+                      "units": "@Canvas3dScene",
+                      "features": "@Canvas3dScene",
                       "orientation": "isometric",
                       "cameraMode": "orbital",
                       "showGrid": true,
@@ -193,9 +193,9 @@
                     "main",
                     {
                       "type": "game-canvas3-d",
-                      "tiles": "@GameCanvas3d",
-                      "units": "@GameCanvas3d",
-                      "features": "@GameCanvas3d",
+                      "tiles": "@Canvas3dScene",
+                      "units": "@Canvas3dScene",
+                      "features": "@Canvas3dScene",
                       "orientation": "isometric",
                       "cameraMode": "orbital",
                       "showGrid": true,
@@ -225,11 +225,11 @@
       ],
       "pages": [
         {
-          "name": "GameCanvas3dCanvas3dPage",
-          "path": "/gamecanvas3ds",
+          "name": "Canvas3dSceneCanvas3dPage",
+          "path": "/canvas3dscenes",
           "traits": [
             {
-              "ref": "GameCanvas3dGameCanvas3d"
+              "ref": "Canvas3dSceneGameCanvas3d"
             }
           ]
         }

package/behaviors/exports/atoms/std-game-hud.orb

@@ -1,10 +1,10 @@
 {
-  "name": "GameHudOrbital",
+  "name": "HudStateOrbital",
   "orbitals": [
     {
-      "name": "GameHudOrbital",
+      "name": "HudStateOrbital",
       "entity": {
-        "name": "GameHud",
+        "name": "HudState",
         "persistence": "runtime",
         "fields": [
           {
@@ -37,8 +37,8 @@
       },
       "traits": [
         {
-          "name": "GameHudHud",
-          "linkedEntity": "GameHud",
+          "name": "HudStateHud",
+          "linkedEntity": "HudState",
           "category": "interaction",
           "stateMachine": {
             "states": [
@@ -65,7 +65,7 @@
                 "effects": [
                   [
                     "fetch",
-                    "GameHud"
+                    "HudState"
                   ],
                   [
                     "render-ui",
@@ -104,7 +104,7 @@
                 "effects": [
                   [
                     "fetch",
-                    "GameHud"
+                    "HudState"
                   ],
                   [
                     "render-ui",
@@ -142,11 +142,11 @@
       ],
       "pages": [
         {
-          "name": "GameHudHudPage",
-          "path": "/gamehuds",
+          "name": "HudStateHudPage",
+          "path": "/hudstates",
           "traits": [
             {
-              "ref": "GameHudHud"
+              "ref": "HudStateHud"
             }
           ]
         }

package/behaviors/exports/atoms/std-game-menu.orb

@@ -1,10 +1,10 @@
 {
-  "name": "GameMenuOrbital",
+  "name": "MenuStateOrbital",
   "orbitals": [
     {
-      "name": "GameMenuOrbital",
+      "name": "MenuStateOrbital",
       "entity": {
-        "name": "GameMenu",
+        "name": "MenuState",
         "persistence": "runtime",
         "fields": [
           {
@@ -37,8 +37,8 @@
       },
       "traits": [
         {
-          "name": "GameMenuMenu",
-          "linkedEntity": "GameMenu",
+          "name": "MenuStateMenu",
+          "linkedEntity": "MenuState",
           "category": "interaction",
           "stateMachine": {
             "states": [
@@ -80,7 +80,7 @@
                     "main",
                     {
                       "type": "game-menu",
-                      "title": "GameMenu",
+                      "title": "MenuState",
                       "subtitle": "Press Start",
                       "menuItems": [
                         {
@@ -116,7 +116,7 @@
                     "main",
                     {
                       "type": "game-menu",
-                      "title": "GameMenu",
+                      "title": "MenuState",
                       "subtitle": "Press Start",
                       "menuItems": [
                         {
@@ -146,7 +146,7 @@
                     "main",
                     {
                       "type": "game-menu",
-                      "title": "GameMenu",
+                      "title": "MenuState",
                       "subtitle": "Press Start",
                       "menuItems": [
                         {
@@ -176,7 +176,7 @@
                     "main",
                     {
                       "type": "game-menu",
-                      "title": "GameMenu",
+                      "title": "MenuState",
                       "subtitle": "Press Start",
                       "menuItems": [
                         {
@@ -202,11 +202,11 @@
       ],
       "pages": [
         {
-          "name": "GameMenuMenuPage",
-          "path": "/gamemenus",
+          "name": "MenuStateMenuPage",
+          "path": "/menustates",
           "traits": [
             {
-              "ref": "GameMenuMenu"
+              "ref": "MenuStateMenu"
             }
           ]
         }

package/behaviors/exports/atoms/std-game-over-screen.orb

@@ -1,10 +1,10 @@
 {
-  "name": "GameOverScreenOrbital",
+  "name": "GameOverStateOrbital",
   "orbitals": [
     {
-      "name": "GameOverScreenOrbital",
+      "name": "GameOverStateOrbital",
       "entity": {
-        "name": "GameOverScreen",
+        "name": "GameOverState",
         "persistence": "runtime",
         "fields": [
           {
@@ -47,8 +47,8 @@
       },
       "traits": [
         {
-          "name": "GameOverScreenGameOver",
-          "linkedEntity": "GameOverScreen",
+          "name": "GameOverStateGameOver",
+          "linkedEntity": "GameOverState",
           "category": "interaction",
           "stateMachine": {
             "states": [
@@ -87,7 +87,7 @@
                 "effects": [
                   [
                     "fetch",
-                    "GameOverScreen"
+                    "GameOverState"
                   ],
                   [
                     "render-ui",
@@ -186,11 +186,11 @@
       ],
       "pages": [
         {
-          "name": "GameOverScreenGameOverPage",
-          "path": "/gameoverscreens",
+          "name": "GameOverStateGameOverPage",
+          "path": "/gameoverstates",
           "traits": [
             {
-              "ref": "GameOverScreenGameOver"
+              "ref": "GameOverStateGameOver"
             }
           ]
         }

package/behaviors/exports/atoms/std-inventory-panel.orb

@@ -1,10 +1,10 @@
 {
-  "name": "InventoryPanelOrbital",
+  "name": "InventorySlotOrbital",
   "orbitals": [
     {
-      "name": "InventoryPanelOrbital",
+      "name": "InventorySlotOrbital",
       "entity": {
-        "name": "InventoryPanel",
+        "name": "InventorySlot",
         "persistence": "singleton",
         "fields": [
           {
@@ -84,8 +84,8 @@
       },
       "traits": [
         {
-          "name": "InventoryPanelInventoryPanel",
-          "linkedEntity": "InventoryPanel",
+          "name": "InventorySlotInventoryPanel",
+          "linkedEntity": "InventorySlot",
           "category": "interaction",
           "stateMachine": {
             "states": [
@@ -141,7 +141,7 @@
                 "effects": [
                   [
                     "fetch",
-                    "InventoryPanel"
+                    "InventorySlot"
                   ],
                   [
                     "render-ui",
@@ -187,7 +187,7 @@
                 "effects": [
                   [
                     "fetch",
-                    "InventoryPanel"
+                    "InventorySlot"
                   ],
                   [
                     "render-ui",
@@ -213,12 +213,12 @@
                   [
                     "persist",
                     "delete",
-                    "InventoryPanel",
+                    "InventorySlot",
                     "@payload.id"
                   ],
                   [
                     "fetch",
-                    "InventoryPanel"
+                    "InventorySlot"
                   ],
                   [
                     "render-ui",
@@ -236,7 +236,7 @@
                   ],
                   [
                     "notify",
-                    "InventoryPanel deleted successfully"
+                    "InventorySlot deleted successfully"
                   ]
                 ]
               }
@@ -246,11 +246,11 @@
       ],
       "pages": [
         {
-          "name": "InventoryPanelInventoryPage",
-          "path": "/inventorypanels",
+          "name": "InventorySlotInventoryPage",
+          "path": "/inventoryslots",
           "traits": [
             {
-              "ref": "InventoryPanelInventoryPanel"
+              "ref": "InventorySlotInventoryPanel"
             }
           ]
         }