@almadar/std 16.235.0 → 16.236.0

package/behaviors/registry/ui/core/atoms/std-role-gate.orb

@@ -0,0 +1,217 @@
+{
+  "description": "std-role-gate — explicit role gate around ONE piece of UI. Renders its `content` trait only when `roles` is empty or lists the viewer's role; any other viewer gets nothing rendered. Wrap a single button, FAB or panel in it, bind `viewerRole` at the call site (e.g. `viewerRole: @user.role`), and list the roles that may see it.",
+  "ledger": {
+    "entries": {
+      "ent_01M3SD4DFQDETDJ6R5BBWSDXZG": {
+        "bakedName": "RoleGateData",
+        "curName": "RoleGateData",
+        "id": "ent_01M3SD4DFQDETDJ6R5BBWSDXZG",
+        "kind": "entity",
+        "owner": "workspace",
+        "renames": []
+      },
+      "evt_01M3SD4DFQQYBWZDDP7GVPFB45": {
+        "bakedName": "INIT",
+        "curName": "INIT",
+        "id": "evt_01M3SD4DFQQYBWZDDP7GVPFB45",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M3SD4DFQVBEVVR5G583YHJAF",
+        "renames": []
+      },
+      "orb_01M3SD4DFQJYJ4PCJSXZP0MS1M": {
+        "bakedName": "RoleGateOrbital",
+        "curName": "RoleGateOrbital",
+        "id": "orb_01M3SD4DFQJYJ4PCJSXZP0MS1M",
+        "kind": "orbital",
+        "owner": "workspace",
+        "renames": []
+      },
+      "pag_01M3SD4DFQ7QSVZVFATBWGPXF3": {
+        "bakedName": "RoleGatePage",
+        "curName": "RoleGatePage",
+        "id": "pag_01M3SD4DFQ7QSVZVFATBWGPXF3",
+        "kind": "page",
+        "owner": "workspace",
+        "renames": []
+      },
+      "trt_01M3SD4DFQVBEVVR5G583YHJAF": {
+        "bakedName": "RoleGate",
+        "curName": "RoleGate",
+        "id": "trt_01M3SD4DFQVBEVVR5G583YHJAF",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
+      }
+    },
+    "schemaVersion": 1
+  },
+  "name": "std-role-gate",
+  "orbitals": [
+    {
+      "entity": {
+        "fields": [
+          {
+            "name": "id",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "id": "ent_01M3SD4DFQDETDJ6R5BBWSDXZG",
+        "name": "RoleGateData",
+        "persistence": "runtime"
+      },
+      "id": "orb_01M3SD4DFQJYJ4PCJSXZP0MS1M",
+      "name": "RoleGateOrbital",
+      "pages": [
+        {
+          "id": "pag_01M3SD4DFQ7QSVZVFATBWGPXF3",
+          "name": "RoleGatePage",
+          "path": "/role-gate",
+          "traits": [
+            {
+              "ref": "RoleGate",
+              "refId": "trt_01M3SD4DFQVBEVVR5G583YHJAF"
+            }
+          ]
+        }
+      ],
+      "traits": [
+        {
+          "category": "interaction",
+          "config": {
+            "content": {
+              "description": "The trait rendered when the viewer's role is allowed, e.g. a button or panel trait ref.",
+              "label": "Gated content",
+              "synonyms": "wrapped content, guarded element, protected button",
+              "tier": "presentation",
+              "type": "trait"
+            },
+            "roles": {
+              "default": [],
+              "description": "Roles (matched against viewerRole) that see the content. Empty = everyone; any other viewer sees nothing.",
+              "items": {
+                "type": "string"
+              },
+              "label": "Visible to roles",
+              "synonyms": "allowed roles, only for, who can see, permitted roles",
+              "tier": "policy",
+              "type": "[string]"
+            },
+            "viewerRole": {
+              "default": "",
+              "description": "The signed-in viewer's role that `roles` is checked against. Bind it explicitly at the call site (e.g. `viewerRole: @user.role`); left empty, only an ungated (empty `roles`) gate renders.",
+              "label": "Viewer's role",
+              "tier": "policy",
+              "type": "string"
+            }
+          },
+          "effectRow": [
+            {
+              "kind": "render-ui",
+              "resource": "main"
+            }
+          ],
+          "entityContract": {
+            "provides": [],
+            "requires": []
+          },
+          "entityRebindable": true,
+          "entityRefIds": {
+            "RoleGateData": "ent_01M3SD4DFQDETDJ6R5BBWSDXZG"
+          },
+          "id": "trt_01M3SD4DFQVBEVVR5G583YHJAF",
+          "linkedEntity": "RoleGateData",
+          "linkedEntityId": "ent_01M3SD4DFQDETDJ6R5BBWSDXZG",
+          "name": "RoleGate",
+          "scope": "instance",
+          "stateMachine": {
+            "events": [
+              {
+                "id": "evt_01M3SD4DFQQYBWZDDP7GVPFB45",
+                "key": "INIT",
+                "name": "Initialize"
+              }
+            ],
+            "states": [
+              {
+                "isInitial": true,
+                "name": "idle"
+              }
+            ],
+            "transitions": [
+              {
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "children": [
+                        "@config.content"
+                      ],
+                      "type": "box"
+                    }
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01M3SD4DFQQYBWZDDP7GVPFB45",
+                "from": "idle",
+                "guard": [
+                  "or",
+                  [
+                    "=",
+                    [
+                      "array/len",
+                      "@config.roles"
+                    ],
+                    0.0
+                  ],
+                  [
+                    "array/includes",
+                    "@config.roles",
+                    "@config.viewerRole"
+                  ]
+                ],
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    null
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01M3SD4DFQQYBWZDDP7GVPFB45",
+                "from": "idle",
+                "guard": [
+                  "not",
+                  [
+                    "or",
+                    [
+                      "=",
+                      [
+                        "array/len",
+                        "@config.roles"
+                      ],
+                      0.0
+                    ],
+                    [
+                      "array/includes",
+                      "@config.roles",
+                      "@config.viewerRole"
+                    ]
+                  ]
+                ],
+                "to": "idle"
+              }
+            ]
+          }
+        }
+      ]
+    }
+  ],
+  "schemaVersion": 1,
+  "version": "1.0.0"
+}