@almadar/std 16.193.0 → 16.195.0

package/behaviors/lolo/ui/game/atoms/ui-choice-button.lolo

@@ -78,11 +78,11 @@ orbital ChoiceButtonOrbital {
         @label "Selected"
         @description "Whether the choice is currently selected"
         @tier "presentation"
-      onClick : string = "CLICK"
+      onClick : event = "CLICK"
         @label "On Click"
         @description "Click handler"
         @tier "presentation"
-      action : string = "ACTION"
+      action : event = "ACTION"
         @label "Action"
         @description "Declarative event name — emits UI:{action} via eventBus on click"
         @tier "presentation"

package/behaviors/lolo/ui/game/atoms/ui-control-button.lolo

@@ -81,19 +81,19 @@ orbital ControlButtonOrbital {
         @label "Variant"
         @description "Visual variant"
         @tier "presentation"
-      onPress : string = "PRESS"
+      onPress : event = "PRESS"
         @label "On Press"
         @description "Called when button is pressed"
         @tier "presentation"
-      onRelease : string = "RELEASE"
+      onRelease : event = "RELEASE"
         @label "On Release"
         @description "Called when button is released"
         @tier "presentation"
-      pressEvent : string = "PRESS"
+      pressEvent : event = "PRESS"
         @label "Press Event"
         @description "Declarative event name emitted on press via useEventBus"
         @tier "presentation"
-      releaseEvent : string = "RELEASE"
+      releaseEvent : event = "RELEASE"
         @label "Release Event"
         @description "Declarative event name emitted on release via useEventBus"
         @tier "presentation"

package/behaviors/lolo/ui/game/atoms/ui-control-grid.lolo

@@ -98,19 +98,19 @@ orbital ControlGridOrbital {
         @label "Include Diagonals"
         @description "Whether to include diagonal buttons (kind='dpad')"
         @tier "presentation"
-      onAction : string = "ACTION"
+      onAction : event = "ACTION"
         @label "On Action"
         @description "Called when a button/direction is pressed or released"
         @tier "presentation"
-      actionEvent : string = "ACTION"
+      actionEvent : event = "ACTION"
         @label "Action Event"
         @description "Event-bus event emitted with `{ id, pressed }` on press/release"
         @tier "presentation"
-      onDirection : string = "DIRECTION"
+      onDirection : event = "DIRECTION"
         @label "On Direction"
         @description "Called when a direction is pressed or released (kind='dpad' convenience overload)"
         @tier "presentation"
-      directionEvent : string = "DIRECTION"
+      directionEvent : event = "DIRECTION"
         @label "Direction Event"
         @description "Event-bus event emitted with `{ direction, pressed }` (kind='dpad')"
         @tier "presentation"

package/behaviors/lolo/ui/game/atoms/ui-game-menu.lolo

@@ -93,7 +93,7 @@ orbital GameMenuOrbital {
         @label "Menu Items"
         @description "Alias for options (schema compatibility)"
         @tier "presentation"
-      onSelect : string = "SELECT"
+      onSelect : event = "SELECT"
         @label "On Select"
         @description "Called when an option is selected (legacy callback, prefer event bus)"
         @tier "presentation"

package/behaviors/lolo/ui/game/atoms/ui-sequence-bar.lolo

@@ -104,19 +104,19 @@ orbital SequenceBarOrbital {
         @label "Max Slots"
         @description "Max number of slots"
         @tier "presentation"
-      onSlotDrop : string = "SLOT_DROP"
+      onSlotDrop : event = "SLOT_DROP"
         @label "On Slot Drop"
         @description "Called when an item is dropped into slot at index (callback path)"
         @tier "presentation"
-      onSlotRemove : string = "SLOT_REMOVE"
+      onSlotRemove : event = "SLOT_REMOVE"
         @label "On Slot Remove"
         @description "Called when a slot is cleared (callback path)"
         @tier "presentation"
-      slotDropEvent : string = "SLOT_DROP"
+      slotDropEvent : event = "SLOT_DROP"
         @label "Slot Drop Event"
         @description "Emits UI:{slotDropEvent} with { slotNumber, itemId } when an item is dropped (declarative path)"
         @tier "presentation"
-      slotRemoveEvent : string = "SLOT_REMOVE"
+      slotRemoveEvent : event = "SLOT_REMOVE"
         @label "Slot Remove Event"
         @description "Emits UI:{slotRemoveEvent} with { slotNumber } when a slot is cleared (declarative path)"
         @tier "presentation"

package/behaviors/lolo/ui/game/atoms/ui-state-graph.lolo

@@ -73,7 +73,7 @@ orbital StateGraphOrbital {
         @label "Height"
         @description "Graph canvas height."
         @tier "presentation"
-      nodeClickEvent : string = "NODE_CLICK"
+      nodeClickEvent : event = "NODE_CLICK"
         @label "Node Click Event"
         @description "Emits UI:{nodeClickEvent} with { stateId } when a node is clicked."
         @tier "presentation"

package/behaviors/lolo/ui/game/atoms/ui-trait-slot.lolo

@@ -267,7 +267,7 @@ orbital TraitSlotOrbital {
         @label "Error"
         @description "Error state"
         @tier "presentation"
-      onItemDrop : string = "ITEM_DROP"
+      onItemDrop : event = "ITEM_DROP"
         @label "On Item Drop"
         @description "-- Drag and drop --"
         @tier "presentation"
@@ -275,7 +275,7 @@ orbital TraitSlotOrbital {
         @label "Draggable"
         @description "Whether this slot's equipped item is draggable"
         @tier "presentation"
-      onDragStart : string = "DRAG_START"
+      onDragStart : event = "DRAG_START"
         @label "On Drag Start"
         @description "Called when drag starts from this slot"
         @tier "presentation"
@@ -283,23 +283,23 @@ orbital TraitSlotOrbital {
         @label "Feedback"
         @description "Per-slot correctness feedback after a failed attempt"
         @tier "presentation"
-      onClick : string = "CLICK"
+      onClick : event = "CLICK"
         @label "On Click"
         @description "-- Callbacks --"
         @tier "presentation"
-      onRemove : string = ""
+      onRemove : event = ""
         @label "On Remove"
         @description "Remove handler"
         @tier "presentation"
-      clickEvent : string = "CLICK"
+      clickEvent : event = "CLICK"
         @label "Click Event"
         @description "-- Declarative events --"
         @tier "presentation"
-      removeEvent : string = ""
+      removeEvent : event = ""
         @label "Remove Event"
         @description "Emits UI:{removeEvent} with { slotNumber }"
         @tier "presentation"
-      dropEvent : string = "DROP"
+      dropEvent : event = "DROP"
         @label "Drop Event"
         @description "Emits UI:{dropEvent} with { slotNumber, itemId } when an item is dropped into this slot"
         @tier "presentation"

package/behaviors/lolo/ui/game/organisms/std-tactics-board-2d.lolo

@@ -417,7 +417,7 @@ orbital TacticsBoard2DOrbital {
         @label "Extra Addon Buttons"
         @description "Board-specific action buttons appended after End Turn/Cancel (e.g. Produce). The action names events listened by composed mechanic atoms."
         @tier "presentation"
-      extraAddonEvent : string = ""
+      extraAddonEvent : event = ""
         @label "Extra Addon Event"
         @description "Event name used by an `extraAddons` button's `action` literal (e.g. \"PRODUCE\"). Set this to the same value so the trait's own event set declares it."
         @tier "domain"

package/behaviors/lolo/ui/learning/atoms/ui-algo-graph-canvas.lolo

@@ -169,11 +169,11 @@ orbital AlgoGraphCanvasOrbital {
         @label "Animate"
         @description "animate prop"
         @tier "presentation"
-      onShapeClick : string = "SHAPE_CLICK"
+      onShapeClick : event = "SHAPE_CLICK"
         @label "On Shape Click"
         @description "onShapeClick prop"
         @tier "presentation"
-      onNodeClick : string = "NODE_CLICK"
+      onNodeClick : event = "NODE_CLICK"
         @label "On Node Click"
         @description "Fires when a node circle is clicked, alongside `onShapeClick`."
         @tier "presentation"

package/behaviors/lolo/ui/learning/atoms/ui-algorithm-canvas.lolo

@@ -281,7 +281,7 @@ orbital AlgorithmCanvasOrbital {
         @label "Animate"
         @description "animate prop"
         @tier "presentation"
-      onShapeClick : string = "SHAPE_CLICK"
+      onShapeClick : event = "SHAPE_CLICK"
         @label "On Shape Click"
         @description "onShapeClick prop"
         @tier "presentation"

package/behaviors/lolo/ui/learning/atoms/ui-biology-canvas.lolo

@@ -351,7 +351,7 @@ orbital BiologyCanvasOrbital {
         @label "Animate"
         @description "2D only: continuous redraw loop. 3D motion is entity-state driven."
         @tier "presentation"
-      onShapeClick : string = "SHAPE_CLICK"
+      onShapeClick : event = "SHAPE_CLICK"
         @label "On Shape Click"
         @description "onShapeClick prop"
         @tier "presentation"

package/behaviors/lolo/ui/learning/atoms/ui-chemistry-canvas.lolo

@@ -345,7 +345,7 @@ orbital ChemistryCanvasOrbital {
         @label "Animate"
         @description "2D only: continuous redraw loop. 3D motion is entity-state driven."
         @tier "presentation"
-      onShapeClick : string = "SHAPE_CLICK"
+      onShapeClick : event = "SHAPE_CLICK"
         @label "On Shape Click"
         @description "onShapeClick prop"
         @tier "presentation"

package/behaviors/lolo/ui/learning/atoms/ui-learning-canvas.lolo

@@ -187,11 +187,11 @@ orbital LearningCanvasOrbital {
         @label "Animate"
         @description "Enable continuous redraw loop."
         @tier "presentation"
-      onShapeClick : string = "SHAPE_CLICK"
+      onShapeClick : event = "SHAPE_CLICK"
         @label "On Shape Click"
         @description "Clicked shape payload: { id?, type?, index }."
         @tier "presentation"
-      onShapeHover : string = "SHAPE_HOVER"
+      onShapeHover : event = "SHAPE_HOVER"
         @label "On Shape Hover"
         @description "Hovered shape payload: { id?, type?, index }."
         @tier "presentation"

package/behaviors/lolo/ui/learning/atoms/ui-math-canvas.lolo

@@ -377,7 +377,7 @@ orbital MathCanvasOrbital {
         @label "Animate"
         @description "animate prop"
         @tier "presentation"
-      onShapeClick : string = "SHAPE_CLICK"
+      onShapeClick : event = "SHAPE_CLICK"
         @label "On Shape Click"
         @description "onShapeClick prop"
         @tier "presentation"

package/behaviors/lolo/ui/learning/atoms/ui-physics-canvas.lolo

@@ -426,7 +426,7 @@ orbital PhysicsCanvasOrbital {
         @label "Animate"
         @description "2D only: continuous redraw loop. 3D motion is entity-state driven."
         @tier "presentation"
-      onShapeClick : string = "SHAPE_CLICK"
+      onShapeClick : event = "SHAPE_CLICK"
         @label "On Shape Click"
         @description "onShapeClick prop"
         @tier "presentation"

package/behaviors/registry/infra/atoms/std-approval-gate.orb

@@ -1,5 +1,5 @@
 {
-  "description": "std-approval-gate — generic approval gate / approver workflow. Use when a user voices that an action must be reviewed, approved, signed off, or authorized by a privileged role before it proceeds (admin approval, supervisor sign-off, manager approval, gatekeeper review, editor approval, senior editor approval, reviewer approval, publishing approval, draft approval, content review, submit drafts then editors review and approve or reject, needs approval before going live, requires sign-off before publish). Persists ApprovalRequest rows + surfaces the PENDING ones in a review queue showing what is being approved and who asked, with Approve / Deny actions — Deny captures a written reason. approverRoles is ENFORCED by the review transitions themselves: an APPROVE/DENY from a viewer whose role is not listed does not fire. On approval emits ApprovalGranted; on denial emits ApprovalDenied (with the reason). Hosts that replay the gated action MUST route a failed replay back via APPROVAL_REPLAY_FAILED so the request reopens instead of being silently consumed. Compose onto any orbital whose action you want to gate: the target orbital emits an external event, an ApprovalRequest row is created (stamp subjectLabel/subjectId/requestedBy so reviewers see what they are judging), and downstream effects wait on ApprovalGranted. Differs from std-mod-queue, which is content-moderation-specific.",
+  "description": "std-approval-gate — generic approval gate / approver workflow. Use when a user voices that an action must be reviewed, approved, signed off, or authorized by a privileged role before it proceeds (admin approval, supervisor sign-off, manager approval, gatekeeper review, editor approval, senior editor approval, reviewer approval, publishing approval, draft approval, content review, submit drafts then editors review and approve or reject, needs approval before going live, requires sign-off before publish). Persists ApprovalRequest rows + surfaces the PENDING ones in a review queue showing what is being approved and who asked, with Approve / Deny actions — Deny captures a written reason. approverRoles is ENFORCED by the review transitions themselves: an APPROVE/DENY from a viewer whose role is not listed does not fire. blockSelfApproval additionally stops a reviewer approving their own request (four-eyes) — DENY stays allowed as self-withdrawal. On approval emits ApprovalGranted; on denial emits ApprovalDenied (with the reason). Hosts that replay the gated action MUST route a failed replay back via APPROVAL_REPLAY_FAILED so the request reopens instead of being silently consumed. Compose onto any orbital whose action you want to gate: the target orbital emits an external event, an ApprovalRequest row is created (stamp subjectLabel/subjectId/requestedBy so reviewers see what they are judging), and downstream effects wait on ApprovalGranted. Differs from std-mod-queue, which is content-moderation-specific.",
   "ledger": {
     "entries": {
       "ent_01KXG04EYQFWN6TM97JNWHHSF4": {
@@ -560,6 +560,14 @@
               "tier": "policy",
               "type": "boolean"
             },
+            "blockSelfApproval": {
+              "default": false,
+              "description": "When on, a reviewer cannot APPROVE a request they submitted themselves (requestedBy = the viewer's id) — enforced by the APPROVE transition guard, from the button or from the bus. Requires hosts to stamp requestedBy at request creation. DENY stays allowed on your own request (denying your own request withdraws it). Off by default.",
+              "label": "Block approving your own requests?",
+              "synonyms": "self approval, self-approval, four eyes, four-eyes, separation of duties, cannot approve own, no self sign-off, dual control",
+              "tier": "policy",
+              "type": "boolean"
+            },
             "enabled": {
               "default": false,
               "description": "Require sign-off before a record is finalized. Off by default.",
@@ -905,65 +913,11 @@
               "eventId": "evt_01KXG04EZ0XXBA89NVB97J1NAM",
               "payloadSchema": [
                 {
-                  "name": "row",
-                  "properties": [
-                    {
-                      "name": "id",
-                      "required": true,
-                      "type": "string"
-                    },
-                    {
-                      "name": "gatedEvent",
-                      "type": "string"
-                    },
-                    {
-                      "name": "subjectLabel",
-                      "type": "string"
-                    },
-                    {
-                      "name": "subjectId",
-                      "type": "string"
-                    },
-                    {
-                      "name": "requestedBy",
-                      "type": "string"
-                    },
-                    {
-                      "name": "requestedByName",
-                      "type": "string"
-                    },
-                    {
-                      "name": "status",
-                      "type": "string"
-                    },
-                    {
-                      "name": "reviewer",
-                      "type": "string"
-                    },
-                    {
-                      "name": "requestedAt",
-                      "type": "number"
-                    },
-                    {
-                      "name": "decidedAt",
-                      "type": "number"
-                    },
-                    {
-                      "name": "escalatedAt",
-                      "type": "number"
-                    },
-                    {
-                      "name": "notes",
-                      "type": "string"
-                    },
-                    {
-                      "name": "payload",
-                      "type": "object"
-                    }
-                  ],
-                  "type": "object"
+                  "name": "value",
+                  "type": "@entity"
                 }
               ],
+              "scope": "internal",
               "synonyms": "reviewed, processed, examined",
               "tier": "internal"
             },
@@ -1104,7 +1058,62 @@
                   },
                   {
                     "name": "row",
-                    "type": "ApprovalRequest"
+                    "properties": [
+                      {
+                        "name": "id",
+                        "required": true,
+                        "type": "string"
+                      },
+                      {
+                        "name": "gatedEvent",
+                        "type": "string"
+                      },
+                      {
+                        "name": "subjectLabel",
+                        "type": "string"
+                      },
+                      {
+                        "name": "subjectId",
+                        "type": "string"
+                      },
+                      {
+                        "name": "requestedBy",
+                        "type": "string"
+                      },
+                      {
+                        "name": "requestedByName",
+                        "type": "string"
+                      },
+                      {
+                        "name": "status",
+                        "type": "string"
+                      },
+                      {
+                        "name": "reviewer",
+                        "type": "string"
+                      },
+                      {
+                        "name": "requestedAt",
+                        "type": "number"
+                      },
+                      {
+                        "name": "decidedAt",
+                        "type": "number"
+                      },
+                      {
+                        "name": "escalatedAt",
+                        "type": "number"
+                      },
+                      {
+                        "name": "notes",
+                        "type": "string"
+                      },
+                      {
+                        "name": "payload",
+                        "type": "object"
+                      }
+                    ],
+                    "type": "object"
                   }
                 ],
                 "synonyms": "accept, authorize, confirm, pass",
@@ -1123,7 +1132,62 @@
                   },
                   {
                     "name": "row",
-                    "type": "ApprovalRequest"
+                    "properties": [
+                      {
+                        "name": "id",
+                        "required": true,
+                        "type": "string"
+                      },
+                      {
+                        "name": "gatedEvent",
+                        "type": "string"
+                      },
+                      {
+                        "name": "subjectLabel",
+                        "type": "string"
+                      },
+                      {
+                        "name": "subjectId",
+                        "type": "string"
+                      },
+                      {
+                        "name": "requestedBy",
+                        "type": "string"
+                      },
+                      {
+                        "name": "requestedByName",
+                        "type": "string"
+                      },
+                      {
+                        "name": "status",
+                        "type": "string"
+                      },
+                      {
+                        "name": "reviewer",
+                        "type": "string"
+                      },
+                      {
+                        "name": "requestedAt",
+                        "type": "number"
+                      },
+                      {
+                        "name": "decidedAt",
+                        "type": "number"
+                      },
+                      {
+                        "name": "escalatedAt",
+                        "type": "number"
+                      },
+                      {
+                        "name": "notes",
+                        "type": "string"
+                      },
+                      {
+                        "name": "payload",
+                        "type": "object"
+                      }
+                    ],
+                    "type": "object"
                   }
                 ],
                 "synonyms": "reject, decline",
@@ -1159,8 +1223,8 @@
                 "name": "ApprovalRequest reviewed",
                 "payloadSchema": [
                   {
-                    "name": "row",
-                    "type": "ApprovalRequest"
+                    "name": "value",
+                    "type": "@entity"
                   }
                 ],
                 "synonyms": "reviewed, processed, examined",
@@ -1569,19 +1633,39 @@
                 "eventId": "evt_01KXG04EZ0H0D5WC8FJKBRGBQE",
                 "from": "reviewing",
                 "guard": [
-                  "or",
+                  "and",
                   [
-                    "=",
+                    "or",
                     [
-                      "array/len",
-                      "@config.approverRoles"
+                      "=",
+                      [
+                        "array/len",
+                        "@config.approverRoles"
+                      ],
+                      0.0
                     ],
-                    0.0
+                    [
+                      "array/includes",
+                      "@config.approverRoles",
+                      "@user.role"
+                    ]
                   ],
                   [
-                    "array/includes",
-                    "@config.approverRoles",
-                    "@user.role"
+                    "or",
+                    [
+                      "=",
+                      "@config.blockSelfApproval",
+                      false
+                    ],
+                    [
+                      "!=",
+                      [
+                        "object/get",
+                        "@payload.row",
+                        "requestedBy"
+                      ],
+                      "@user.id"
+                    ]
                   ]
                 ],
                 "to": "reviewing"