@almadar/std 16.242.0 → 16.244.0

package/behaviors/registry/infra/atoms/std-page-search.orb

@@ -163,7 +163,7 @@
           "config": {
             "fields": {
               "default": {},
-              "description": "Field name to how to read it from each result: `selector` (a descendant; absent reads the result itself), `attr` (an attribute; absent reads the text) and `resolve` (the attribute is a URL: return it absolute)",
+              "description": "Field name to how to read it from each result: `selector` (a descendant; absent reads the result itself), `attr` (an attribute; absent reads the text) , `resolve` (the value is a URL: return it absolute), `template` (compose the value from other fields, `{name}` per field; empty when any is empty) and `required` (leave the result out until this field reads non-empty)",
               "items": {
                 "properties": {
                   "attr": {
@@ -171,6 +171,11 @@
                     "required": false,
                     "type": "string"
                   },
+                  "required": {
+                    "name": "required",
+                    "required": false,
+                    "type": "boolean"
+                  },
                   "resolve": {
                     "name": "resolve",
                     "required": false,
@@ -180,6 +185,11 @@
                     "name": "selector",
                     "required": false,
                     "type": "string"
+                  },
+                  "template": {
+                    "name": "template",
+                    "required": false,
+                    "type": "string"
                   }
                 },
                 "type": "object"
@@ -846,6 +856,14 @@
           {
             "name": "resolve",
             "type": "boolean"
+          },
+          {
+            "name": "template",
+            "type": "string"
+          },
+          {
+            "name": "required",
+            "type": "boolean"
           }
         ],
         "PageResult": [

package/behaviors/registry/infra/atoms/std-page-treat.orb

@@ -1,5 +1,5 @@
 {
-  "description": "std-page-treat — applies a declared visual treatment to one element of a browser tab (hide, blur, highlight, or label it with text) or restores it, and reports which element it treated. TREAT takes the tab and element id std-page-watch reports. The treatments are a fixed, declared set: no arbitrary styles or scripts. Needs a host with the `page` service (a browser extension).",
+  "description": "std-page-treat — applies a declared visual treatment to one element of a browser tab (hide, blur, highlight, or label it with text) or restores it, and reports which element it treated. TREAT takes the tab and element id std-page-watch reports; TREAT_MANY treats a whole list at once and reports which elements were treated and which had already left their page. The treatments are a fixed, declared set: no arbitrary styles or scripts. Needs a host with the `page` service (a browser extension).",
   "ledger": {
     "entries": {
       "ent_01M431PMWEZFEQMV1ZADZ4AR3S": {
@@ -64,6 +64,33 @@
         "parent": "trt_01M431PMWE8GVWK42G31TJKSYS",
         "renames": []
       },
+      "evt_01M45BPXT9139TFQ4Y8FZMW7YR": {
+        "bakedName": "TREATED_MANY",
+        "curName": "TREATED_MANY",
+        "id": "evt_01M45BPXT9139TFQ4Y8FZMW7YR",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M431PMWE8GVWK42G31TJKSYS",
+        "renames": []
+      },
+      "evt_01M45BPXT9RQKY42KAAF2R587N": {
+        "bakedName": "TREAT_MANY",
+        "curName": "TREAT_MANY",
+        "id": "evt_01M45BPXT9RQKY42KAAF2R587N",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M431PMWE8GVWK42G31TJKSYS",
+        "renames": []
+      },
+      "evt_01M45BPXT9SP0TMHXWX7EP6WEE": {
+        "bakedName": "APPLIED_MANY",
+        "curName": "APPLIED_MANY",
+        "id": "evt_01M45BPXT9SP0TMHXWX7EP6WEE",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M431PMWE8GVWK42G31TJKSYS",
+        "renames": []
+      },
       "orb_01M431PMWEGB77DC3DGPK02RAP": {
         "bakedName": "PageTreatOrbital",
         "curName": "PageTreatOrbital",
@@ -148,10 +175,18 @@
               "kind": "call-service",
               "resource": "page.apply"
             },
+            {
+              "kind": "call-service",
+              "resource": "page.applyMany"
+            },
             {
               "kind": "emit",
               "resource": "TREATED"
             },
+            {
+              "kind": "emit",
+              "resource": "TREATED_MANY"
+            },
             {
               "kind": "emit",
               "resource": "TREAT_FAILED"
@@ -198,6 +233,48 @@
               ],
               "tier": "secondary"
             },
+            {
+              "description": "The page service applied a list of treatments",
+              "event": "APPLIED_MANY",
+              "eventId": "evt_01M45BPXT9SP0TMHXWX7EP6WEE",
+              "payloadSchema": [
+                {
+                  "entity": "PageElementRef",
+                  "name": "applied",
+                  "properties": [
+                    {
+                      "name": "tab",
+                      "required": true,
+                      "type": "number"
+                    },
+                    {
+                      "name": "elementId",
+                      "required": true,
+                      "type": "string"
+                    }
+                  ],
+                  "type": "[object]"
+                },
+                {
+                  "entity": "PageElementRef",
+                  "name": "missing",
+                  "properties": [
+                    {
+                      "name": "tab",
+                      "required": true,
+                      "type": "number"
+                    },
+                    {
+                      "name": "elementId",
+                      "required": true,
+                      "type": "string"
+                    }
+                  ],
+                  "type": "[object]"
+                }
+              ],
+              "tier": "secondary"
+            },
             {
               "description": "The page service could not apply the treatment",
               "event": "APPLY_FAILED",
@@ -235,6 +312,50 @@
               "synonyms": "hidden, blurred, highlighted, labelled, restored",
               "tier": "primary"
             },
+            {
+              "description": "Each listed element now shows its treatment; `missing` lists those that had left their page (or whose tab closed)",
+              "event": "TREATED_MANY",
+              "eventId": "evt_01M45BPXT9139TFQ4Y8FZMW7YR",
+              "payloadSchema": [
+                {
+                  "entity": "PageElementRef",
+                  "name": "applied",
+                  "properties": [
+                    {
+                      "name": "tab",
+                      "required": true,
+                      "type": "number"
+                    },
+                    {
+                      "name": "elementId",
+                      "required": true,
+                      "type": "string"
+                    }
+                  ],
+                  "type": "[object]"
+                },
+                {
+                  "entity": "PageElementRef",
+                  "name": "missing",
+                  "properties": [
+                    {
+                      "name": "tab",
+                      "required": true,
+                      "type": "number"
+                    },
+                    {
+                      "name": "elementId",
+                      "required": true,
+                      "type": "string"
+                    }
+                  ],
+                  "type": "[object]"
+                }
+              ],
+              "scope": "external",
+              "synonyms": "hidden, blurred, restored, treated",
+              "tier": "primary"
+            },
             {
               "description": "The treatment could not be applied (the element is gone, or the tab closed)",
               "event": "TREAT_FAILED",
@@ -320,6 +441,82 @@
                 ],
                 "tier": "secondary"
               },
+              {
+                "description": "Treat a list of page elements in one call, each with its own treatment and label",
+                "external": true,
+                "id": "evt_01M45BPXT9RQKY42KAAF2R587N",
+                "key": "TREAT_MANY",
+                "name": "Treat Many",
+                "payloadSchema": [
+                  {
+                    "name": "items",
+                    "properties": [
+                      {
+                        "name": "tab",
+                        "required": true,
+                        "type": "number"
+                      },
+                      {
+                        "name": "elementId",
+                        "required": true,
+                        "type": "string"
+                      },
+                      {
+                        "name": "treatment",
+                        "type": "string"
+                      },
+                      {
+                        "name": "label",
+                        "type": "string"
+                      }
+                    ],
+                    "type": "[object]"
+                  }
+                ]
+              },
+              {
+                "description": "The page service applied a list of treatments",
+                "id": "evt_01M45BPXT9SP0TMHXWX7EP6WEE",
+                "key": "APPLIED_MANY",
+                "name": "Applied Many",
+                "payloadSchema": [
+                  {
+                    "entity": "PageElementRef",
+                    "name": "applied",
+                    "properties": [
+                      {
+                        "name": "tab",
+                        "required": true,
+                        "type": "number"
+                      },
+                      {
+                        "name": "elementId",
+                        "required": true,
+                        "type": "string"
+                      }
+                    ],
+                    "type": "[object]"
+                  },
+                  {
+                    "entity": "PageElementRef",
+                    "name": "missing",
+                    "properties": [
+                      {
+                        "name": "tab",
+                        "required": true,
+                        "type": "number"
+                      },
+                      {
+                        "name": "elementId",
+                        "required": true,
+                        "type": "string"
+                      }
+                    ],
+                    "type": "[object]"
+                  }
+                ],
+                "tier": "secondary"
+              },
               {
                 "description": "The page service could not apply the treatment",
                 "id": "evt_01M431PMWETQ15DFSCY7X3S3DQ",
@@ -358,6 +555,50 @@
                 "synonyms": "hidden, blurred, highlighted, labelled, restored",
                 "tier": "primary"
               },
+              {
+                "description": "Each listed element now shows its treatment; `missing` lists those that had left their page (or whose tab closed)",
+                "id": "evt_01M45BPXT9139TFQ4Y8FZMW7YR",
+                "key": "TREATED_MANY",
+                "name": "Treated Many",
+                "payloadSchema": [
+                  {
+                    "entity": "PageElementRef",
+                    "name": "applied",
+                    "properties": [
+                      {
+                        "name": "tab",
+                        "required": true,
+                        "type": "number"
+                      },
+                      {
+                        "name": "elementId",
+                        "required": true,
+                        "type": "string"
+                      }
+                    ],
+                    "type": "[object]"
+                  },
+                  {
+                    "entity": "PageElementRef",
+                    "name": "missing",
+                    "properties": [
+                      {
+                        "name": "tab",
+                        "required": true,
+                        "type": "number"
+                      },
+                      {
+                        "name": "elementId",
+                        "required": true,
+                        "type": "string"
+                      }
+                    ],
+                    "type": "[object]"
+                  }
+                ],
+                "synonyms": "hidden, blurred, restored, treated",
+                "tier": "primary"
+              },
               {
                 "description": "The treatment could not be applied (the element is gone, or the tab closed)",
                 "id": "evt_01M431PMWEBZK1KCZAB9FG6AE1",
@@ -449,6 +690,56 @@
                 "from": "ready",
                 "to": "ready"
               },
+              {
+                "effects": [
+                  [
+                    "call-service",
+                    "page",
+                    "applyMany",
+                    {
+                      "items": "@payload.items"
+                    },
+                    {
+                      "emit": {
+                        "failure": "APPLY_FAILED",
+                        "success": "APPLIED_MANY"
+                      }
+                    }
+                  ]
+                ],
+                "event": "TREAT_MANY",
+                "eventId": "evt_01M45BPXT9RQKY42KAAF2R587N",
+                "from": "ready",
+                "to": "ready"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.treated",
+                    [
+                      "+",
+                      "@entity.treated",
+                      [
+                        "array/len",
+                        "@payload.applied"
+                      ]
+                    ]
+                  ],
+                  [
+                    "emit",
+                    "TREATED_MANY",
+                    {
+                      "applied": "@payload.applied",
+                      "missing": "@payload.missing"
+                    }
+                  ]
+                ],
+                "event": "APPLIED_MANY",
+                "eventId": "evt_01M45BPXT9SP0TMHXWX7EP6WEE",
+                "from": "ready",
+                "to": "ready"
+              },
               {
                 "effects": [
                   [
@@ -486,7 +777,41 @@
             ]
           }
         }
-      ]
+      ],
+      "types": {
+        "PageElementRef": [
+          {
+            "name": "tab",
+            "required": true,
+            "type": "number"
+          },
+          {
+            "name": "elementId",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "PageTreatment": [
+          {
+            "name": "tab",
+            "required": true,
+            "type": "number"
+          },
+          {
+            "name": "elementId",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "treatment",
+            "type": "string"
+          },
+          {
+            "name": "label",
+            "type": "string"
+          }
+        ]
+      }
     }
   ],
   "schemaVersion": 1,

package/behaviors/registry/infra/atoms/std-page-watch.orb

@@ -146,7 +146,7 @@
           "config": {
             "fields": {
               "default": {},
-              "description": "Field name to how to read it from each element: `selector` (a descendant; absent reads the element itself), `attr` (an attribute; absent reads the text) and `resolve` (the attribute is a URL: return it absolute)",
+              "description": "Field name to how to read it from each element: `selector` (a descendant; absent reads the element itself), `attr` (an attribute; absent reads the text) , `resolve` (the value is a URL: return it absolute), `template` (compose the value from other fields, `{name}` per field; empty when any is empty) and `required` (leave the element out until this field reads non-empty — a placeholder is reported once it fills in)",
               "items": {
                 "properties": {
                   "attr": {
@@ -154,6 +154,11 @@
                     "required": false,
                     "type": "string"
                   },
+                  "required": {
+                    "name": "required",
+                    "required": false,
+                    "type": "boolean"
+                  },
                   "resolve": {
                     "name": "resolve",
                     "required": false,
@@ -163,6 +168,11 @@
                     "name": "selector",
                     "required": false,
                     "type": "string"
+                  },
+                  "template": {
+                    "name": "template",
+                    "required": false,
+                    "type": "string"
                   }
                 },
                 "type": "object"
@@ -544,6 +554,14 @@
           {
             "name": "resolve",
             "type": "boolean"
+          },
+          {
+            "name": "template",
+            "type": "string"
+          },
+          {
+            "name": "required",
+            "type": "boolean"
           }
         ]
       }

package/behaviors/registry/ui/avl/atoms/ui-avl-state-machine.orb

@@ -110,6 +110,92 @@
               "tier": "presentation",
               "type": "number"
             },
+            "annotations": {
+              "default": {
+                "effects": {
+                  "persist": {
+                    "body": "Saves the order."
+                  }
+                },
+                "states": {
+                  "pending": {
+                    "body": "Every order starts here.",
+                    "title": "Unpaid"
+                  }
+                },
+                "transitions": {
+                  "PAY": {
+                    "body": "Only fires when the amount is positive."
+                  }
+                }
+              },
+              "description": "Author explanations shown in a popover on hover: a note per state name, per transition event and per effect type.",
+              "label": "Annotations",
+              "properties": {
+                "effects": {
+                  "items": {
+                    "properties": {
+                      "body": {
+                        "name": "body",
+                        "required": true,
+                        "type": "string"
+                      },
+                      "title": {
+                        "name": "title",
+                        "required": false,
+                        "type": "string"
+                      }
+                    },
+                    "type": "object"
+                  },
+                  "name": "effects",
+                  "required": false,
+                  "type": "object"
+                },
+                "states": {
+                  "items": {
+                    "properties": {
+                      "body": {
+                        "name": "body",
+                        "required": true,
+                        "type": "string"
+                      },
+                      "title": {
+                        "name": "title",
+                        "required": false,
+                        "type": "string"
+                      }
+                    },
+                    "type": "object"
+                  },
+                  "name": "states",
+                  "required": false,
+                  "type": "object"
+                },
+                "transitions": {
+                  "items": {
+                    "properties": {
+                      "body": {
+                        "name": "body",
+                        "required": true,
+                        "type": "string"
+                      },
+                      "title": {
+                        "name": "title",
+                        "required": false,
+                        "type": "string"
+                      }
+                    },
+                    "type": "object"
+                  },
+                  "name": "transitions",
+                  "required": false,
+                  "type": "object"
+                }
+              },
+              "tier": "presentation",
+              "type": "AvlStateMachineAnnotations"
+            },
             "ariaBusy": {
               "description": "This region is updating; assistive technology waits before announcing it.",
               "label": "Aria-busy",
@@ -865,6 +951,7 @@
                     {
                       "activeState": "@config.activeState",
                       "activeTransition": "@config.activeTransition",
+                      "annotations": "@config.annotations",
                       "aria-busy": "@config.ariaBusy",
                       "aria-current": "@config.ariaCurrent",
                       "aria-describedby": "@config.ariaDescribedby",
@@ -908,6 +995,53 @@
         }
       ],
       "types": {
+        "AvlStateMachineAnnotations": [
+          {
+            "name": "states",
+            "type": "Map<string,AvlStateMachineAnnotationsStatesValue>"
+          },
+          {
+            "name": "transitions",
+            "type": "Map<string,AvlStateMachineAnnotationsTransitionsValue>"
+          },
+          {
+            "name": "effects",
+            "type": "Map<string,AvlStateMachineAnnotationsEffectsValue>"
+          }
+        ],
+        "AvlStateMachineAnnotationsEffectsValue": [
+          {
+            "name": "title",
+            "type": "string"
+          },
+          {
+            "name": "body",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "AvlStateMachineAnnotationsStatesValue": [
+          {
+            "name": "title",
+            "type": "string"
+          },
+          {
+            "name": "body",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "AvlStateMachineAnnotationsTransitionsValue": [
+          {
+            "name": "title",
+            "type": "string"
+          },
+          {
+            "name": "body",
+            "required": true,
+            "type": "string"
+          }
+        ],
         "AvlStateMachineTRANSITIONCLICKTransition": [
           {
             "name": "index",