@almadar/std 6.5.2 → 7.2.0

package/behaviors/registry/atoms/std-flip-card.orb

@@ -1,7 +1,7 @@
 {
   "name": "std-flip-card",
   "version": "1.0.0",
-  "description": "Flip card atom for flashcard-style front/back content. Absorbs: flip-container, flip-card.",
+  "description": "std-flip-card as a Function",
   "orbitals": [
     {
       "name": "FlashcardOrbital",
@@ -45,42 +45,61 @@
             "type": "string",
             "default": ""
           }
-        ],
-        "instances": [
-          {
-            "id": "fc-1",
-            "name": "What is photosynthesis?",
-            "description": "The process by which plants convert sunlight into energy",
-            "status": "active",
-            "createdAt": "2026-01-01",
-            "question": "What is photosynthesis?",
-            "answer": "The process by which green plants use sunlight to synthesize foods from carbon dioxide and water."
-          },
-          {
-            "id": "fc-2",
-            "name": "What is the speed of light?",
-            "description": "299,792,458 meters per second",
-            "status": "active",
-            "createdAt": "2026-01-02",
-            "question": "What is the speed of light?",
-            "answer": "Approximately 299,792,458 meters per second in a vacuum."
-          },
-          {
-            "id": "fc-3",
-            "name": "What is DNA?",
-            "description": "Deoxyribonucleic acid",
-            "status": "active",
-            "createdAt": "2026-01-03",
-            "question": "What is DNA?",
-            "answer": "Deoxyribonucleic acid, the molecule that carries genetic instructions for life."
-          }
         ]
       },
       "traits": [
         {
           "name": "FlashcardFlipCard",
-          "linkedEntity": "Flashcard",
           "category": "interaction",
+          "linkedEntity": "Flashcard",
+          "emits": [
+            {
+              "event": "FlashcardLoaded",
+              "description": "Fired when Flashcard 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": "question",
+                  "type": "string"
+                },
+                {
+                  "name": "answer",
+                  "type": "string"
+                }
+              ]
+            },
+            {
+              "event": "FlashcardLoadFailed",
+              "description": "Fired when Flashcard fails to load",
+              "scope": "internal",
+              "payload": [
+                {
+                  "name": "message",
+                  "type": "string"
+                }
+              ]
+            }
+          ],
           "stateMachine": {
             "states": [
               {
@@ -98,7 +117,7 @@
               },
               {
                 "key": "FLIP",
-                "name": "Flip Card"
+                "name": "Flip"
               },
               {
                 "key": "FLIP_BACK",
@@ -106,7 +125,21 @@
               },
               {
                 "key": "NEXT",
-                "name": "Next Card"
+                "name": "Next"
+              },
+              {
+                "key": "FlashcardLoaded",
+                "name": "Flashcard loaded"
+              },
+              {
+                "key": "FlashcardLoadFailed",
+                "name": "Flashcard load failed",
+                "payload": [
+                  {
+                    "name": "message",
+                    "type": "string"
+                  }
+                ]
               }
             ],
             "transitions": [
@@ -117,7 +150,13 @@
                 "effects": [
                   [
                     "fetch",
-                    "Flashcard"
+                    "Flashcard",
+                    {
+                      "emit": {
+                        "success": "FlashcardLoaded",
+                        "failure": "FlashcardLoadFailed"
+                      }
+                    }
                   ],
                   [
                     "render-ui",
@@ -125,42 +164,42 @@
                     {
                       "type": "stack",
                       "direction": "vertical",
-                      "gap": "lg",
                       "align": "center",
+                      "gap": "lg",
                       "children": [
                         {
                           "type": "stack",
                           "direction": "horizontal",
-                          "gap": "sm",
                           "align": "center",
                           "children": [
                             {
+                              "size": "lg",
                               "type": "icon",
-                              "name": "rotate-3d",
-                              "size": "lg"
+                              "name": "rotate-3d"
                             },
                             {
-                              "type": "typography",
+                              "variant": "h2",
                               "content": "Flashcards Flashcards",
-                              "variant": "h2"
+                              "type": "typography"
                             }
-                          ]
+                          ],
+                          "gap": "sm"
                         },
                         {
                           "type": "divider"
                         },
                         {
                           "type": "flip-card",
-                          "front": {
+                          "back": {
                             "type": "stack",
-                            "direction": "vertical",
                             "gap": "md",
+                            "direction": "vertical",
                             "align": "center",
                             "children": [
                               {
-                                "type": "icon",
-                                "name": "help-circle",
-                                "size": "lg"
+                                "name": "lightbulb",
+                                "size": "lg",
+                                "type": "icon"
                               },
                               {
                                 "type": "typography",
@@ -171,54 +210,54 @@
                                     "array/first",
                                     "@entity"
                                   ],
-                                  "name"
+                                  "description"
                                 ]
                               },
                               {
-                                "type": "typography",
-                                "variant": "caption",
-                                "color": "muted",
-                                "content": "Tap to reveal answer"
+                                "label": "Answer",
+                                "type": "badge"
                               }
                             ]
                           },
-                          "back": {
-                            "type": "stack",
-                            "direction": "vertical",
+                          "front": {
                             "gap": "md",
-                            "align": "center",
                             "children": [
                               {
                                 "type": "icon",
-                                "name": "lightbulb",
+                                "name": "help-circle",
                                 "size": "lg"
                               },
                               {
                                 "type": "typography",
-                                "variant": "h3",
                                 "content": [
                                   "object/get",
                                   [
                                     "array/first",
                                     "@entity"
                                   ],
-                                  "description"
-                                ]
+                                  "name"
+                                ],
+                                "variant": "h3"
                               },
                               {
-                                "type": "badge",
-                                "label": "Answer"
+                                "variant": "caption",
+                                "content": "Tap to reveal answer",
+                                "type": "typography",
+                                "color": "muted"
                               }
-                            ]
+                            ],
+                            "type": "stack",
+                            "align": "center",
+                            "direction": "vertical"
                           },
                           "flipped": false
                         },
                         {
                           "type": "button",
-                          "label": "Flip",
-                          "event": "FLIP",
+                          "icon": "rotate-3d",
                           "variant": "primary",
-                          "icon": "rotate-3d"
+                          "event": "FLIP",
+                          "label": "Flip"
                         }
                       ]
                     }
@@ -234,25 +273,23 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
                       "direction": "vertical",
-                      "gap": "lg",
                       "align": "center",
                       "children": [
                         {
-                          "type": "stack",
-                          "direction": "horizontal",
                           "gap": "sm",
                           "align": "center",
+                          "type": "stack",
+                          "direction": "horizontal",
                           "children": [
                             {
                               "type": "icon",
-                              "name": "rotate-3d",
-                              "size": "lg"
+                              "size": "lg",
+                              "name": "rotate-3d"
                             },
                             {
-                              "type": "typography",
                               "content": "Flashcards Flashcards",
+                              "type": "typography",
                               "variant": "h2"
                             }
                           ]
@@ -261,20 +298,16 @@
                           "type": "divider"
                         },
                         {
-                          "type": "flip-card",
-                          "front": {
-                            "type": "stack",
-                            "direction": "vertical",
-                            "gap": "md",
+                          "back": {
                             "align": "center",
+                            "type": "stack",
                             "children": [
                               {
                                 "type": "icon",
-                                "name": "help-circle",
-                                "size": "lg"
+                                "size": "lg",
+                                "name": "lightbulb"
                               },
                               {
-                                "type": "typography",
                                 "variant": "h3",
                                 "content": [
                                   "object/get",
@@ -282,27 +315,29 @@
                                     "array/first",
                                     "@entity"
                                   ],
-                                  "name"
-                                ]
+                                  "description"
+                                ],
+                                "type": "typography"
                               },
                               {
-                                "type": "typography",
-                                "variant": "caption",
-                                "color": "muted",
-                                "content": "Tap to reveal answer"
+                                "label": "Answer",
+                                "type": "badge"
                               }
-                            ]
-                          },
-                          "back": {
-                            "type": "stack",
-                            "direction": "vertical",
+                            ],
                             "gap": "md",
+                            "direction": "vertical"
+                          },
+                          "flipped": true,
+                          "type": "flip-card",
+                          "front": {
                             "align": "center",
+                            "gap": "md",
+                            "type": "stack",
                             "children": [
                               {
-                                "type": "icon",
-                                "name": "lightbulb",
-                                "size": "lg"
+                                "size": "lg",
+                                "name": "help-circle",
+                                "type": "icon"
                               },
                               {
                                 "type": "typography",
@@ -313,40 +348,44 @@
                                     "array/first",
                                     "@entity"
                                   ],
-                                  "description"
+                                  "name"
                                 ]
                               },
                               {
-                                "type": "badge",
-                                "label": "Answer"
+                                "variant": "caption",
+                                "type": "typography",
+                                "content": "Tap to reveal answer",
+                                "color": "muted"
                               }
-                            ]
-                          },
-                          "flipped": true
+                            ],
+                            "direction": "vertical"
+                          }
                         },
                         {
+                          "gap": "sm",
                           "type": "stack",
                           "direction": "horizontal",
-                          "gap": "sm",
-                          "justify": "center",
                           "children": [
                             {
-                              "type": "button",
                               "label": "Flip Back",
-                              "event": "FLIP_BACK",
+                              "type": "button",
                               "variant": "ghost",
+                              "event": "FLIP_BACK",
                               "icon": "rotate-3d"
                             },
                             {
                               "type": "button",
-                              "label": "Next",
                               "event": "NEXT",
+                              "icon": "arrow-right",
                               "variant": "primary",
-                              "icon": "arrow-right"
+                              "label": "Next"
                             }
-                          ]
+                          ],
+                          "justify": "center"
                         }
-                      ]
+                      ],
+                      "gap": "lg",
+                      "type": "stack"
                     }
                   ]
                 ]
@@ -361,25 +400,22 @@
                     "main",
                     {
                       "type": "stack",
-                      "direction": "vertical",
-                      "gap": "lg",
-                      "align": "center",
                       "children": [
                         {
+                          "gap": "sm",
                           "type": "stack",
                           "direction": "horizontal",
-                          "gap": "sm",
                           "align": "center",
                           "children": [
                             {
-                              "type": "icon",
                               "name": "rotate-3d",
-                              "size": "lg"
+                              "size": "lg",
+                              "type": "icon"
                             },
                             {
+                              "variant": "h2",
                               "type": "typography",
-                              "content": "Flashcards Flashcards",
-                              "variant": "h2"
+                              "content": "Flashcards Flashcards"
                             }
                           ]
                         },
@@ -388,15 +424,15 @@
                         },
                         {
                           "type": "flip-card",
-                          "front": {
-                            "type": "stack",
-                            "direction": "vertical",
+                          "back": {
                             "gap": "md",
+                            "direction": "vertical",
+                            "type": "stack",
                             "align": "center",
                             "children": [
                               {
+                                "name": "lightbulb",
                                 "type": "icon",
-                                "name": "help-circle",
                                 "size": "lg"
                               },
                               {
@@ -408,56 +444,59 @@
                                     "array/first",
                                     "@entity"
                                   ],
-                                  "name"
+                                  "description"
                                 ]
                               },
                               {
-                                "type": "typography",
-                                "variant": "caption",
-                                "color": "muted",
-                                "content": "Tap to reveal answer"
+                                "label": "Answer",
+                                "type": "badge"
                               }
                             ]
                           },
-                          "back": {
-                            "type": "stack",
-                            "direction": "vertical",
+                          "flipped": false,
+                          "front": {
                             "gap": "md",
-                            "align": "center",
                             "children": [
                               {
-                                "type": "icon",
-                                "name": "lightbulb",
-                                "size": "lg"
+                                "size": "lg",
+                                "name": "help-circle",
+                                "type": "icon"
                               },
                               {
                                 "type": "typography",
-                                "variant": "h3",
                                 "content": [
                                   "object/get",
                                   [
                                     "array/first",
                                     "@entity"
                                   ],
-                                  "description"
-                                ]
+                                  "name"
+                                ],
+                                "variant": "h3"
                               },
                               {
-                                "type": "badge",
-                                "label": "Answer"
+                                "type": "typography",
+                                "color": "muted",
+                                "variant": "caption",
+                                "content": "Tap to reveal answer"
                               }
-                            ]
-                          },
-                          "flipped": false
+                            ],
+                            "type": "stack",
+                            "direction": "vertical",
+                            "align": "center"
+                          }
                         },
                         {
-                          "type": "button",
                           "label": "Flip",
                           "event": "FLIP",
+                          "type": "button",
                           "variant": "primary",
                           "icon": "rotate-3d"
                         }
-                      ]
+                      ],
+                      "align": "center",
+                      "direction": "vertical",
+                      "gap": "lg"
                     }
                   ]
                 ]
@@ -469,107 +508,113 @@
                 "effects": [
                   [
                     "fetch",
-                    "Flashcard"
+                    "Flashcard",
+                    {
+                      "emit": {
+                        "failure": "FlashcardLoadFailed",
+                        "success": "FlashcardLoaded"
+                      }
+                    }
                   ],
                   [
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
                       "direction": "vertical",
                       "gap": "lg",
+                      "type": "stack",
                       "align": "center",
                       "children": [
                         {
                           "type": "stack",
-                          "direction": "horizontal",
-                          "gap": "sm",
                           "align": "center",
                           "children": [
                             {
-                              "type": "icon",
                               "name": "rotate-3d",
+                              "type": "icon",
                               "size": "lg"
                             },
                             {
-                              "type": "typography",
                               "content": "Flashcards Flashcards",
+                              "type": "typography",
                               "variant": "h2"
                             }
-                          ]
+                          ],
+                          "direction": "horizontal",
+                          "gap": "sm"
                         },
                         {
                           "type": "divider"
                         },
                         {
                           "type": "flip-card",
-                          "front": {
+                          "back": {
                             "type": "stack",
                             "direction": "vertical",
-                            "gap": "md",
-                            "align": "center",
                             "children": [
                               {
                                 "type": "icon",
-                                "name": "help-circle",
+                                "name": "lightbulb",
                                 "size": "lg"
                               },
                               {
-                                "type": "typography",
-                                "variant": "h3",
                                 "content": [
                                   "object/get",
                                   [
                                     "array/first",
                                     "@entity"
                                   ],
-                                  "name"
-                                ]
+                                  "description"
+                                ],
+                                "variant": "h3",
+                                "type": "typography"
                               },
                               {
-                                "type": "typography",
-                                "variant": "caption",
-                                "color": "muted",
-                                "content": "Tap to reveal answer"
+                                "type": "badge",
+                                "label": "Answer"
                               }
-                            ]
+                            ],
+                            "gap": "md",
+                            "align": "center"
                           },
-                          "back": {
-                            "type": "stack",
-                            "direction": "vertical",
+                          "front": {
                             "gap": "md",
-                            "align": "center",
                             "children": [
                               {
                                 "type": "icon",
-                                "name": "lightbulb",
+                                "name": "help-circle",
                                 "size": "lg"
                               },
                               {
                                 "type": "typography",
-                                "variant": "h3",
                                 "content": [
                                   "object/get",
                                   [
                                     "array/first",
                                     "@entity"
                                   ],
-                                  "description"
-                                ]
+                                  "name"
+                                ],
+                                "variant": "h3"
                               },
                               {
-                                "type": "badge",
-                                "label": "Answer"
+                                "type": "typography",
+                                "color": "muted",
+                                "content": "Tap to reveal answer",
+                                "variant": "caption"
                               }
-                            ]
+                            ],
+                            "direction": "vertical",
+                            "align": "center",
+                            "type": "stack"
                           },
                           "flipped": false
                         },
                         {
+                          "variant": "primary",
+                          "event": "FLIP",
                           "type": "button",
                           "label": "Flip",
-                          "event": "FLIP",
-                          "variant": "primary",
                           "icon": "rotate-3d"
                         }
                       ]
@@ -578,7 +623,8 @@
                 ]
               }
             ]
-          }
+          },
+          "scope": "instance"
         }
       ],
       "pages": [
@@ -594,4 +640,4 @@
       ]
     }
   ]
-}
+}