@almadar/std 6.5.2 → 7.2.0

package/behaviors/registry/atoms/std-text-effects.orb

@@ -1,7 +1,7 @@
 {
   "name": "std-text-effects",
   "version": "1.0.0",
-  "description": "Text animation and highlighting atom. Absorbs: typewriter-text, text-highlight, law-reference-tooltip.",
+  "description": "std-text-effects as a Function",
   "orbitals": [
     {
       "name": "TextContentOrbital",
@@ -50,25 +50,65 @@
             "type": "string",
             "default": ""
           }
-        ],
-        "instances": [
-          {
-            "id": "txt-1",
-            "name": "The quick brown fox jumps over the lazy dog",
-            "description": "A pangram sentence",
-            "status": "active",
-            "createdAt": "2026-01-01",
-            "content": "The **quick** brown fox _jumps_ over the lazy dog. This demonstrates text animation and highlighting capabilities.",
-            "highlightType": "emphasis",
-            "reference": "Article 42, Section 3.1 — Typography Standards"
-          }
         ]
       },
       "traits": [
         {
           "name": "TextContentTextEffects",
-          "linkedEntity": "TextContent",
           "category": "interaction",
+          "linkedEntity": "TextContent",
+          "emits": [
+            {
+              "event": "TextContentLoaded",
+              "description": "Fired when TextContent finishes loading",
+              "scope": "internal",
+              "payload": [
+                {
+                  "name": "id",
+                  "type": "string"
+                },
+                {
+                  "name": "name",
+                  "type": "string"
+                },
+                {
+                  "name": "description",
+                  "type": "string"
+                },
+                {
+                  "name": "status",
+                  "type": "string"
+                },
+                {
+                  "name": "createdAt",
+                  "type": "string"
+                },
+                {
+                  "name": "content",
+                  "type": "string"
+                },
+                {
+                  "name": "highlightType",
+                  "type": "string"
+                },
+                {
+                  "name": "reference",
+                  "type": "string"
+                }
+              ]
+            },
+            {
+              "event": "TextContentLoadFailed",
+              "description": "Fired when TextContent fails to load",
+              "scope": "internal",
+              "payload": [
+                {
+                  "name": "message",
+                  "type": "string"
+                }
+              ]
+            }
+          ],
           "stateMachine": {
             "states": [
               {
@@ -98,6 +138,20 @@
               {
                 "key": "RESET",
                 "name": "Reset"
+              },
+              {
+                "key": "TextContentLoaded",
+                "name": "TextContent loaded"
+              },
+              {
+                "key": "TextContentLoadFailed",
+                "name": "TextContent load failed",
+                "payload": [
+                  {
+                    "name": "message",
+                    "type": "string"
+                  }
+                ]
               }
             ],
             "transitions": [
@@ -108,39 +162,43 @@
                 "effects": [
                   [
                     "fetch",
-                    "TextContent"
+                    "TextContent",
+                    {
+                      "emit": {
+                        "failure": "TextContentLoadFailed",
+                        "success": "TextContentLoaded"
+                      }
+                    }
                   ],
                   [
                     "render-ui",
                     "main",
                     {
                       "type": "stack",
-                      "direction": "vertical",
                       "gap": "lg",
                       "children": [
                         {
                           "type": "stack",
-                          "direction": "horizontal",
                           "gap": "sm",
-                          "align": "center",
+                          "direction": "horizontal",
                           "children": [
                             {
-                              "type": "icon",
+                              "size": "lg",
                               "name": "type",
-                              "size": "lg"
+                              "type": "icon"
                             },
                             {
-                              "type": "typography",
                               "content": "Text Effects",
-                              "variant": "h2"
+                              "variant": "h2",
+                              "type": "typography"
                             }
-                          ]
+                          ],
+                          "align": "center"
                         },
                         {
                           "type": "divider"
                         },
                         {
-                          "type": "markdown-content",
                           "content": [
                             "object/get",
                             [
@@ -148,10 +206,10 @@
                               "@entity"
                             ],
                             "name"
-                          ]
+                          ],
+                          "type": "markdown-content"
                         },
                         {
-                          "type": "code-block",
                           "code": [
                             "object/get",
                             [
@@ -160,6 +218,7 @@
                             ],
                             "reference"
                           ],
+                          "type": "code-block",
                           "language": "text"
                         },
                         {
@@ -176,27 +235,28 @@
                         },
                         {
                           "type": "stack",
-                          "direction": "horizontal",
                           "gap": "sm",
-                          "justify": "center",
                           "children": [
                             {
-                              "type": "button",
-                              "label": "Animate",
                               "event": "ANIMATE",
+                              "icon": "play",
+                              "label": "Animate",
                               "variant": "primary",
-                              "icon": "play"
+                              "type": "button"
                             },
                             {
-                              "type": "button",
+                              "icon": "highlighter",
                               "label": "Highlight",
+                              "type": "button",
                               "event": "HIGHLIGHT",
-                              "variant": "secondary",
-                              "icon": "highlighter"
+                              "variant": "secondary"
                             }
-                          ]
+                          ],
+                          "direction": "horizontal",
+                          "justify": "center"
                         }
-                      ]
+                      ],
+                      "direction": "vertical"
                     }
                   ]
                 ]
@@ -210,33 +270,35 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
-                      "direction": "vertical",
                       "gap": "lg",
+                      "direction": "vertical",
+                      "type": "stack",
                       "children": [
                         {
-                          "type": "stack",
                           "direction": "horizontal",
-                          "gap": "sm",
                           "align": "center",
                           "children": [
                             {
                               "type": "icon",
-                              "name": "type",
-                              "size": "lg"
+                              "size": "lg",
+                              "name": "type"
                             },
                             {
-                              "type": "typography",
+                              "variant": "h2",
                               "content": "Text Effects",
-                              "variant": "h2"
+                              "type": "typography"
                             }
-                          ]
+                          ],
+                          "type": "stack",
+                          "gap": "sm"
                         },
                         {
                           "type": "divider"
                         },
                         {
                           "type": "typewriter-text",
+                          "cursor": true,
+                          "speed": 50.0,
                           "text": [
                             "object/get",
                             [
@@ -244,12 +306,9 @@
                               "@entity"
                             ],
                             "name"
-                          ],
-                          "speed": 50,
-                          "cursor": true
+                          ]
                         },
                         {
-                          "type": "law-reference-tooltip",
                           "reference": [
                             "object/get",
                             [
@@ -261,18 +320,19 @@
                           "children": [
                             {
                               "type": "typography",
+                              "content": "Hover for reference details",
                               "variant": "caption",
-                              "color": "muted",
-                              "content": "Hover for reference details"
+                              "color": "muted"
                             }
-                          ]
+                          ],
+                          "type": "law-reference-tooltip"
                         },
                         {
                           "type": "button",
-                          "label": "Highlight",
-                          "event": "HIGHLIGHT",
                           "variant": "secondary",
-                          "icon": "highlighter"
+                          "icon": "highlighter",
+                          "label": "Highlight",
+                          "event": "HIGHLIGHT"
                         }
                       ]
                     }
@@ -280,7 +340,7 @@
                 ]
               },
               {
-                "from": "animating",
+                "from": "idle",
                 "to": "highlighted",
                 "event": "HIGHLIGHT",
                 "effects": [
@@ -288,32 +348,33 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
                       "direction": "vertical",
+                      "type": "stack",
                       "gap": "lg",
                       "children": [
                         {
-                          "type": "stack",
-                          "direction": "horizontal",
-                          "gap": "sm",
-                          "align": "center",
                           "children": [
                             {
+                              "size": "lg",
                               "type": "icon",
-                              "name": "type",
-                              "size": "lg"
+                              "name": "type"
                             },
                             {
                               "type": "typography",
                               "content": "Text Effects",
                               "variant": "h2"
                             }
-                          ]
+                          ],
+                          "gap": "sm",
+                          "direction": "horizontal",
+                          "type": "stack",
+                          "align": "center"
                         },
                         {
                           "type": "divider"
                         },
                         {
+                          "highlightColor": "yellow",
                           "type": "text-highlight",
                           "text": [
                             "object/get",
@@ -323,23 +384,12 @@
                             ],
                             "name"
                           ],
-                          "highlightColor": "yellow",
                           "pattern": "important"
                         },
                         {
-                          "type": "law-reference-tooltip",
-                          "reference": [
-                            "object/get",
-                            [
-                              "array/first",
-                              "@entity"
-                            ],
-                            "reference"
-                          ],
                           "children": [
                             {
                               "type": "typography",
-                              "variant": "body",
                               "content": [
                                 "object/get",
                                 [
@@ -347,16 +397,26 @@
                                   "@entity"
                                 ],
                                 "name"
-                              ]
+                              ],
+                              "variant": "body"
                             }
-                          ]
+                          ],
+                          "reference": [
+                            "object/get",
+                            [
+                              "array/first",
+                              "@entity"
+                            ],
+                            "reference"
+                          ],
+                          "type": "law-reference-tooltip"
                         },
                         {
-                          "type": "button",
                           "label": "Reset",
-                          "event": "RESET",
                           "variant": "ghost",
-                          "icon": "rotate-ccw"
+                          "icon": "rotate-ccw",
+                          "event": "RESET",
+                          "type": "button"
                         }
                       ]
                     }
@@ -364,23 +424,17 @@
                 ]
               },
               {
-                "from": "highlighted",
-                "to": "idle",
-                "event": "RESET",
+                "from": "animating",
+                "to": "highlighted",
+                "event": "HIGHLIGHT",
                 "effects": [
                   [
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
-                      "direction": "vertical",
                       "gap": "lg",
                       "children": [
                         {
-                          "type": "stack",
-                          "direction": "horizontal",
-                          "gap": "sm",
-                          "align": "center",
                           "children": [
                             {
                               "type": "icon",
@@ -388,29 +442,34 @@
                               "size": "lg"
                             },
                             {
-                              "type": "typography",
                               "content": "Text Effects",
-                              "variant": "h2"
+                              "variant": "h2",
+                              "type": "typography"
                             }
-                          ]
+                          ],
+                          "gap": "sm",
+                          "direction": "horizontal",
+                          "type": "stack",
+                          "align": "center"
                         },
                         {
                           "type": "divider"
                         },
                         {
-                          "type": "markdown-content",
-                          "content": [
+                          "pattern": "important",
+                          "type": "text-highlight",
+                          "text": [
                             "object/get",
                             [
                               "array/first",
                               "@entity"
                             ],
                             "name"
-                          ]
+                          ],
+                          "highlightColor": "yellow"
                         },
                         {
-                          "type": "code-block",
-                          "code": [
+                          "reference": [
                             "object/get",
                             [
                               "array/first",
@@ -418,43 +477,32 @@
                             ],
                             "reference"
                           ],
-                          "language": "text"
-                        },
-                        {
-                          "type": "typography",
-                          "variant": "body",
-                          "content": [
-                            "object/get",
-                            [
-                              "array/first",
-                              "@entity"
-                            ],
-                            "name"
-                          ]
-                        },
-                        {
-                          "type": "stack",
-                          "direction": "horizontal",
-                          "gap": "sm",
-                          "justify": "center",
+                          "type": "law-reference-tooltip",
                           "children": [
                             {
-                              "type": "button",
-                              "label": "Animate",
-                              "event": "ANIMATE",
-                              "variant": "primary",
-                              "icon": "play"
-                            },
-                            {
-                              "type": "button",
-                              "label": "Highlight",
-                              "event": "HIGHLIGHT",
-                              "variant": "secondary",
-                              "icon": "highlighter"
+                              "variant": "body",
+                              "content": [
+                                "object/get",
+                                [
+                                  "array/first",
+                                  "@entity"
+                                ],
+                                "name"
+                              ],
+                              "type": "typography"
                             }
                           ]
+                        },
+                        {
+                          "icon": "rotate-ccw",
+                          "label": "Reset",
+                          "type": "button",
+                          "variant": "ghost",
+                          "event": "RESET"
                         }
-                      ]
+                      ],
+                      "direction": "vertical",
+                      "type": "stack"
                     }
                   ]
                 ]
@@ -468,33 +516,29 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
-                      "direction": "vertical",
-                      "gap": "lg",
                       "children": [
                         {
-                          "type": "stack",
-                          "direction": "horizontal",
-                          "gap": "sm",
                           "align": "center",
                           "children": [
                             {
-                              "type": "icon",
                               "name": "type",
-                              "size": "lg"
+                              "size": "lg",
+                              "type": "icon"
                             },
                             {
                               "type": "typography",
                               "content": "Text Effects",
                               "variant": "h2"
                             }
-                          ]
+                          ],
+                          "type": "stack",
+                          "gap": "sm",
+                          "direction": "horizontal"
                         },
                         {
                           "type": "divider"
                         },
                         {
-                          "type": "markdown-content",
                           "content": [
                             "object/get",
                             [
@@ -502,10 +546,10 @@
                               "@entity"
                             ],
                             "name"
-                          ]
+                          ],
+                          "type": "markdown-content"
                         },
                         {
-                          "type": "code-block",
                           "code": [
                             "object/get",
                             [
@@ -514,11 +558,12 @@
                             ],
                             "reference"
                           ],
+                          "type": "code-block",
                           "language": "text"
                         },
                         {
-                          "type": "typography",
                           "variant": "body",
+                          "type": "typography",
                           "content": [
                             "object/get",
                             [
@@ -529,60 +574,61 @@
                           ]
                         },
                         {
-                          "type": "stack",
-                          "direction": "horizontal",
                           "gap": "sm",
-                          "justify": "center",
+                          "type": "stack",
                           "children": [
                             {
-                              "type": "button",
                               "label": "Animate",
-                              "event": "ANIMATE",
                               "variant": "primary",
+                              "event": "ANIMATE",
+                              "type": "button",
                               "icon": "play"
                             },
                             {
-                              "type": "button",
-                              "label": "Highlight",
                               "event": "HIGHLIGHT",
-                              "variant": "secondary",
-                              "icon": "highlighter"
+                              "icon": "highlighter",
+                              "label": "Highlight",
+                              "type": "button",
+                              "variant": "secondary"
                             }
-                          ]
+                          ],
+                          "direction": "horizontal",
+                          "justify": "center"
                         }
-                      ]
+                      ],
+                      "gap": "lg",
+                      "type": "stack",
+                      "direction": "vertical"
                     }
                   ]
                 ]
               },
               {
-                "from": "idle",
-                "to": "highlighted",
-                "event": "HIGHLIGHT",
+                "from": "highlighted",
+                "to": "idle",
+                "event": "RESET",
                 "effects": [
                   [
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
                       "direction": "vertical",
-                      "gap": "lg",
                       "children": [
                         {
+                          "align": "center",
                           "type": "stack",
                           "direction": "horizontal",
                           "gap": "sm",
-                          "align": "center",
                           "children": [
                             {
-                              "type": "icon",
                               "name": "type",
-                              "size": "lg"
+                              "size": "lg",
+                              "type": "icon"
                             },
                             {
-                              "type": "typography",
                               "content": "Text Effects",
-                              "variant": "h2"
+                              "variant": "h2",
+                              "type": "typography"
                             }
                           ]
                         },
@@ -590,8 +636,7 @@
                           "type": "divider"
                         },
                         {
-                          "type": "text-highlight",
-                          "text": [
+                          "content": [
                             "object/get",
                             [
                               "array/first",
@@ -599,12 +644,11 @@
                             ],
                             "name"
                           ],
-                          "highlightColor": "yellow",
-                          "pattern": "important"
+                          "type": "markdown-content"
                         },
                         {
-                          "type": "law-reference-tooltip",
-                          "reference": [
+                          "type": "code-block",
+                          "code": [
                             "object/get",
                             [
                               "array/first",
@@ -612,35 +656,52 @@
                             ],
                             "reference"
                           ],
+                          "language": "text"
+                        },
+                        {
+                          "content": [
+                            "object/get",
+                            [
+                              "array/first",
+                              "@entity"
+                            ],
+                            "name"
+                          ],
+                          "type": "typography",
+                          "variant": "body"
+                        },
+                        {
+                          "gap": "sm",
                           "children": [
                             {
-                              "type": "typography",
-                              "variant": "body",
-                              "content": [
-                                "object/get",
-                                [
-                                  "array/first",
-                                  "@entity"
-                                ],
-                                "name"
-                              ]
+                              "type": "button",
+                              "icon": "play",
+                              "variant": "primary",
+                              "event": "ANIMATE",
+                              "label": "Animate"
+                            },
+                            {
+                              "label": "Highlight",
+                              "event": "HIGHLIGHT",
+                              "variant": "secondary",
+                              "icon": "highlighter",
+                              "type": "button"
                             }
-                          ]
-                        },
-                        {
-                          "type": "button",
-                          "label": "Reset",
-                          "event": "RESET",
-                          "variant": "ghost",
-                          "icon": "rotate-ccw"
+                          ],
+                          "direction": "horizontal",
+                          "type": "stack",
+                          "justify": "center"
                         }
-                      ]
+                      ],
+                      "gap": "lg",
+                      "type": "stack"
                     }
                   ]
                 ]
               }
             ]
-          }
+          },
+          "scope": "instance"
         }
       ],
       "pages": [
@@ -656,4 +717,4 @@
       ]
     }
   ]
-}
+}