@almadar/std 16.242.0 → 16.244.0

package/behaviors/registry/ui/avl/atoms/ui-avl-transition-explainer.orb

@@ -0,0 +1,678 @@
+{
+  "description": "One transition explained step by step: from-state, event and to-state, the guard that must hold, and each effect it runs in order. — UI factory (1:1 with the @almadar/ui avl-transition-explainer pattern).",
+  "ledger": {
+    "entries": {
+      "ent_01M459G6DDJKYVJ0W1HBTGX27A": {
+        "bakedName": "AvlTransitionExplainerItem",
+        "curName": "AvlTransitionExplainerItem",
+        "id": "ent_01M459G6DDJKYVJ0W1HBTGX27A",
+        "kind": "entity",
+        "owner": "workspace",
+        "renames": []
+      },
+      "evt_01M459G6DD9XCR06WRYKX3JX3K": {
+        "bakedName": "INIT",
+        "curName": "INIT",
+        "id": "evt_01M459G6DD9XCR06WRYKX3JX3K",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M459G6DDCFZQ0HZS23H0N8W6",
+        "renames": []
+      },
+      "orb_01M459G6DCM3DEX8DBEGFBNF0Y": {
+        "bakedName": "AvlTransitionExplainerOrbital",
+        "curName": "AvlTransitionExplainerOrbital",
+        "id": "orb_01M459G6DCM3DEX8DBEGFBNF0Y",
+        "kind": "orbital",
+        "owner": "workspace",
+        "renames": []
+      },
+      "pag_01M459G6DDMGRRPF3HRD4ABXJQ": {
+        "bakedName": "AvlTransitionExplainerPage",
+        "curName": "AvlTransitionExplainerPage",
+        "id": "pag_01M459G6DDMGRRPF3HRD4ABXJQ",
+        "kind": "page",
+        "owner": "workspace",
+        "renames": []
+      },
+      "trt_01M459G6DDCFZQ0HZS23H0N8W6": {
+        "bakedName": "AvlTransitionExplainerRender",
+        "curName": "AvlTransitionExplainerRender",
+        "id": "trt_01M459G6DDCFZQ0HZS23H0N8W6",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
+      }
+    },
+    "schemaVersion": 1
+  },
+  "name": "ui-avl-transition-explainer",
+  "orbitals": [
+    {
+      "entity": {
+        "fields": [
+          {
+            "name": "id",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "id": "ent_01M459G6DDJKYVJ0W1HBTGX27A",
+        "name": "AvlTransitionExplainerItem",
+        "persistence": "runtime"
+      },
+      "id": "orb_01M459G6DCM3DEX8DBEGFBNF0Y",
+      "name": "AvlTransitionExplainerOrbital",
+      "pages": [
+        {
+          "id": "pag_01M459G6DDMGRRPF3HRD4ABXJQ",
+          "name": "AvlTransitionExplainerPage",
+          "path": "/avl-transition-explainer",
+          "traits": [
+            {
+              "ref": "AvlTransitionExplainerRender",
+              "refId": "trt_01M459G6DDCFZQ0HZS23H0N8W6"
+            }
+          ]
+        }
+      ],
+      "traits": [
+        {
+          "category": "interaction",
+          "config": {
+            "annotations": {
+              "default": {
+                "effects": {
+                  "persist": {
+                    "body": "Saves the order."
+                  }
+                },
+                "transitions": {
+                  "PAY": {
+                    "body": "The customer pays the order total.",
+                    "title": "Paying"
+                  }
+                }
+              },
+              "description": "Author explanations shown in a popover on hover: the event's note and per-effect-type notes.",
+              "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": "AvlTransitionExplainerAnnotations"
+            },
+            "ariaBusy": {
+              "description": "This region is updating; assistive technology waits before announcing it.",
+              "label": "Aria-busy",
+              "synonyms": "aria-busy",
+              "tier": "presentation",
+              "type": "boolean"
+            },
+            "ariaCurrent": {
+              "description": "Marks the current item in a set: the current page, step, location, date or time.",
+              "label": "Aria-current",
+              "synonyms": "aria-current",
+              "tier": "presentation",
+              "type": "string",
+              "values": [
+                "page",
+                "step",
+                "location",
+                "date",
+                "time",
+                "true",
+                "false"
+              ]
+            },
+            "ariaDescribedby": {
+              "description": "Id of the element whose text describes this one (help text, error).",
+              "label": "Aria-describedby",
+              "synonyms": "aria-describedby",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "ariaExpanded": {
+              "description": "Whether the element it controls is expanded.",
+              "label": "Aria-expanded",
+              "synonyms": "aria-expanded",
+              "tier": "presentation",
+              "type": "boolean"
+            },
+            "ariaHidden": {
+              "description": "Hide from assistive technology (decorative content only).",
+              "label": "Aria-hidden",
+              "synonyms": "aria-hidden",
+              "tier": "presentation",
+              "type": "boolean"
+            },
+            "ariaLabel": {
+              "description": "Accessible name read by screen readers when the visible text is missing or not descriptive (e.g. an icon-only control).",
+              "label": "Aria-label",
+              "synonyms": "aria-label",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "ariaLabelledby": {
+              "description": "Id of the element whose text names this one.",
+              "label": "Aria-labelledby",
+              "synonyms": "aria-labelledby",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "ariaLive": {
+              "description": "Announce changes to this region: polite waits for a pause, assertive interrupts.",
+              "label": "Aria-live",
+              "synonyms": "aria-live",
+              "tier": "presentation",
+              "type": "string",
+              "values": [
+                "off",
+                "polite",
+                "assertive"
+              ]
+            },
+            "ariaPressed": {
+              "description": "Toggle-button state.",
+              "label": "Aria-pressed",
+              "synonyms": "aria-pressed",
+              "tier": "presentation",
+              "type": "string",
+              "values": [
+                "true",
+                "false",
+                "mixed"
+              ]
+            },
+            "ariaSelected": {
+              "description": "Whether this item is selected (tabs, options, grid cells).",
+              "label": "Aria-selected",
+              "synonyms": "aria-selected",
+              "tier": "presentation",
+              "type": "boolean"
+            },
+            "className": {
+              "description": "className prop",
+              "label": "Class Name",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "dir": {
+              "description": "Text direction of this element's content.",
+              "label": "Dir",
+              "tier": "presentation",
+              "type": "string",
+              "values": [
+                "ltr",
+                "rtl",
+                "auto"
+              ]
+            },
+            "enter": {
+              "description": "How this element animates in when it mounts (theme-styled); overrides the theme's default slot entry. `none` opts out.",
+              "label": "Enter",
+              "tier": "presentation",
+              "type": "string",
+              "values": [
+                "none",
+                "fade",
+                "rise",
+                "scale",
+                "slide"
+              ]
+            },
+            "enterDelay": {
+              "description": "Stagger step for the entry: waits this many `--motion-enter-stagger` steps before animating.",
+              "label": "Enter Delay",
+              "tier": "presentation",
+              "type": "number"
+            },
+            "lang": {
+              "description": "Language of this element's content (BCP 47, e.g. ar, sl, en).",
+              "label": "Lang",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "orbitalName": {
+              "default": "",
+              "description": "Orbital the transition belongs to.",
+              "label": "Orbital Name",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "role": {
+              "description": "WAI-ARIA role when the element's native semantics don't describe it.",
+              "label": "Role",
+              "tier": "presentation",
+              "type": "string",
+              "values": [
+                "alert",
+                "alertdialog",
+                "application",
+                "article",
+                "banner",
+                "blockquote",
+                "button",
+                "caption",
+                "cell",
+                "checkbox",
+                "code",
+                "columnheader",
+                "combobox",
+                "complementary",
+                "contentinfo",
+                "definition",
+                "deletion",
+                "dialog",
+                "document",
+                "emphasis",
+                "feed",
+                "figure",
+                "form",
+                "generic",
+                "grid",
+                "gridcell",
+                "group",
+                "heading",
+                "img",
+                "insertion",
+                "link",
+                "list",
+                "listbox",
+                "listitem",
+                "log",
+                "main",
+                "marquee",
+                "math",
+                "menu",
+                "menubar",
+                "menuitem",
+                "menuitemcheckbox",
+                "menuitemradio",
+                "meter",
+                "navigation",
+                "none",
+                "note",
+                "option",
+                "paragraph",
+                "presentation",
+                "progressbar",
+                "radio",
+                "radiogroup",
+                "region",
+                "row",
+                "rowgroup",
+                "rowheader",
+                "scrollbar",
+                "search",
+                "searchbox",
+                "separator",
+                "slider",
+                "spinbutton",
+                "status",
+                "strong",
+                "subscript",
+                "superscript",
+                "switch",
+                "tab",
+                "table",
+                "tablist",
+                "tabpanel",
+                "term",
+                "textbox",
+                "time",
+                "timer",
+                "toolbar",
+                "tooltip",
+                "tree",
+                "treegrid",
+                "treeitem"
+              ]
+            },
+            "skeleton": {
+              "description": "Skeleton shown while this element's server render is in flight: a shape (`table`, `list`, …), `{ variant, rows?, columns?, fields? }`, or `none`.",
+              "label": "Skeleton",
+              "tier": "presentation",
+              "type": "string",
+              "values": [
+                "header",
+                "table",
+                "list",
+                "grid",
+                "detail",
+                "stats",
+                "form",
+                "card",
+                "text",
+                "none"
+              ]
+            },
+            "tabIndex": {
+              "description": "0 puts the element in the Tab order; -1 makes it focusable only programmatically.",
+              "label": "Tab Index",
+              "tier": "presentation",
+              "type": "number"
+            },
+            "traitName": {
+              "default": "",
+              "description": "Trait the transition belongs to.",
+              "label": "Trait Name",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "transition": {
+              "default": {
+                "effects": [
+                  {
+                    "args": [],
+                    "type": "set"
+                  },
+                  {
+                    "args": [],
+                    "type": "persist"
+                  }
+                ],
+                "event": "PAY",
+                "from": "pending",
+                "index": 0.0,
+                "to": "paid"
+              },
+              "description": "The transition to explain.",
+              "label": "Transition",
+              "properties": {
+                "effects": {
+                  "items": {
+                    "properties": {
+                      "args": {
+                        "items": {
+                          "type": "object"
+                        },
+                        "name": "args",
+                        "required": true,
+                        "type": "array"
+                      },
+                      "type": {
+                        "name": "type",
+                        "required": true,
+                        "type": "string"
+                      }
+                    },
+                    "type": "object"
+                  },
+                  "name": "effects",
+                  "required": true,
+                  "type": "array"
+                },
+                "event": {
+                  "name": "event",
+                  "required": true,
+                  "type": "string"
+                },
+                "from": {
+                  "name": "from",
+                  "required": true,
+                  "type": "string"
+                },
+                "guard": {
+                  "name": "guard",
+                  "required": false,
+                  "type": "object"
+                },
+                "index": {
+                  "name": "index",
+                  "required": true,
+                  "type": "number"
+                },
+                "to": {
+                  "name": "to",
+                  "required": true,
+                  "type": "string"
+                }
+              },
+              "tier": "presentation",
+              "type": "AvlTransitionExplainerTransition"
+            }
+          },
+          "effectRow": [
+            {
+              "kind": "render-ui",
+              "resource": "main"
+            }
+          ],
+          "entityContract": {
+            "provides": [],
+            "requires": []
+          },
+          "entityRebindable": true,
+          "entityRefIds": {
+            "AvlTransitionExplainerItem": "ent_01M459G6DDJKYVJ0W1HBTGX27A"
+          },
+          "id": "trt_01M459G6DDCFZQ0HZS23H0N8W6",
+          "linkedEntity": "AvlTransitionExplainerItem",
+          "linkedEntityId": "ent_01M459G6DDJKYVJ0W1HBTGX27A",
+          "name": "AvlTransitionExplainerRender",
+          "scope": "instance",
+          "stateMachine": {
+            "events": [
+              {
+                "id": "evt_01M459G6DD9XCR06WRYKX3JX3K",
+                "key": "INIT",
+                "name": "Initialize"
+              }
+            ],
+            "states": [
+              {
+                "isInitial": true,
+                "name": "idle"
+              }
+            ],
+            "transitions": [
+              {
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "annotations": "@config.annotations",
+                      "aria-busy": "@config.ariaBusy",
+                      "aria-current": "@config.ariaCurrent",
+                      "aria-describedby": "@config.ariaDescribedby",
+                      "aria-expanded": "@config.ariaExpanded",
+                      "aria-hidden": "@config.ariaHidden",
+                      "aria-label": "@config.ariaLabel",
+                      "aria-labelledby": "@config.ariaLabelledby",
+                      "aria-live": "@config.ariaLive",
+                      "aria-pressed": "@config.ariaPressed",
+                      "aria-selected": "@config.ariaSelected",
+                      "className": "@config.className",
+                      "dir": "@config.dir",
+                      "enter": "@config.enter",
+                      "enterDelay": "@config.enterDelay",
+                      "lang": "@config.lang",
+                      "orbitalName": "@config.orbitalName",
+                      "role": "@config.role",
+                      "skeleton": "@config.skeleton",
+                      "tabIndex": "@config.tabIndex",
+                      "traitName": "@config.traitName",
+                      "transition": "@config.transition",
+                      "type": "avl-transition-explainer"
+                    }
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01M459G6DD9XCR06WRYKX3JX3K",
+                "from": "idle",
+                "to": "idle"
+              }
+            ]
+          }
+        }
+      ],
+      "types": {
+        "AvlTransitionExplainerAnnotations": [
+          {
+            "name": "states",
+            "type": "Map<string,AvlTransitionExplainerAnnotationsStatesValue>"
+          },
+          {
+            "name": "transitions",
+            "type": "Map<string,AvlTransitionExplainerAnnotationsTransitionsValue>"
+          },
+          {
+            "name": "effects",
+            "type": "Map<string,AvlTransitionExplainerAnnotationsEffectsValue>"
+          }
+        ],
+        "AvlTransitionExplainerAnnotationsEffectsValue": [
+          {
+            "name": "title",
+            "type": "string"
+          },
+          {
+            "name": "body",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "AvlTransitionExplainerAnnotationsStatesValue": [
+          {
+            "name": "title",
+            "type": "string"
+          },
+          {
+            "name": "body",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "AvlTransitionExplainerAnnotationsTransitionsValue": [
+          {
+            "name": "title",
+            "type": "string"
+          },
+          {
+            "name": "body",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "AvlTransitionExplainerTransition": [
+          {
+            "name": "from",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "to",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "event",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "guard",
+            "type": "SExpr"
+          },
+          {
+            "name": "effects",
+            "properties": [
+              {
+                "name": "type",
+                "required": true,
+                "type": "string"
+              },
+              {
+                "name": "args",
+                "required": true,
+                "type": "[SExpr]"
+              }
+            ],
+            "required": true,
+            "type": "[object]"
+          },
+          {
+            "name": "index",
+            "required": true,
+            "type": "number"
+          }
+        ],
+        "AvlTransitionExplainerTransitionEffectsItem": [
+          {
+            "name": "type",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "args",
+            "required": true,
+            "type": "[SExpr]"
+          }
+        ]
+      }
+    }
+  ],
+  "schemaVersion": 1,
+  "version": "1.0.0"
+}