@almadar/std 6.5.2 → 7.2.0

package/behaviors/registry/atoms/std-theme.orb

@@ -1,7 +1,7 @@
 {
   "name": "std-theme",
   "version": "1.0.0",
-  "description": "Theme selection atom with toggle and full selector. Absorbs: theme-toggle, theme-selector.",
+  "description": "std-theme as a Function",
   "orbitals": [
     {
       "name": "ThemePreferenceOrbital",
@@ -45,24 +45,61 @@
             "type": "string",
             "default": "default"
           }
-        ],
-        "instances": [
-          {
-            "id": "theme-1",
-            "name": "Default Theme",
-            "description": "System default",
-            "status": "active",
-            "createdAt": "2026-01-01",
-            "mode": "light",
-            "colorScheme": "almadar"
-          }
         ]
       },
       "traits": [
         {
           "name": "ThemePreferenceTheme",
-          "linkedEntity": "ThemePreference",
           "category": "interaction",
+          "linkedEntity": "ThemePreference",
+          "emits": [
+            {
+              "event": "ThemePreferenceLoaded",
+              "description": "Fired when ThemePreference 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": "mode",
+                  "type": "string"
+                },
+                {
+                  "name": "colorScheme",
+                  "type": "string"
+                }
+              ]
+            },
+            {
+              "event": "ThemePreferenceLoadFailed",
+              "description": "Fired when ThemePreference fails to load",
+              "scope": "internal",
+              "payload": [
+                {
+                  "name": "message",
+                  "type": "string"
+                }
+              ]
+            }
+          ],
           "stateMachine": {
             "states": [
               {
@@ -77,11 +114,11 @@
               },
               {
                 "key": "TOGGLE",
-                "name": "Toggle Theme"
+                "name": "Toggle"
               },
               {
                 "key": "SELECT",
-                "name": "Select Theme",
+                "name": "Select",
                 "payload": [
                   {
                     "name": "theme",
@@ -89,6 +126,20 @@
                     "required": true
                   }
                 ]
+              },
+              {
+                "key": "ThemePreferenceLoaded",
+                "name": "ThemePreference loaded"
+              },
+              {
+                "key": "ThemePreferenceLoadFailed",
+                "name": "ThemePreference load failed",
+                "payload": [
+                  {
+                    "name": "message",
+                    "type": "string"
+                  }
+                ]
               }
             ],
             "transitions": [
@@ -99,31 +150,35 @@
                 "effects": [
                   [
                     "fetch",
-                    "ThemePreference"
+                    "ThemePreference",
+                    {
+                      "emit": {
+                        "success": "ThemePreferenceLoaded",
+                        "failure": "ThemePreferenceLoadFailed"
+                      }
+                    }
                   ],
                   [
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
-                      "direction": "vertical",
                       "gap": "lg",
                       "children": [
                         {
-                          "type": "stack",
                           "direction": "horizontal",
                           "gap": "sm",
                           "align": "center",
+                          "type": "stack",
                           "children": [
                             {
+                              "size": "lg",
                               "type": "icon",
-                              "name": "palette",
-                              "size": "lg"
+                              "name": "palette"
                             },
                             {
+                              "variant": "h2",
                               "type": "typography",
-                              "content": "Theme Settings",
-                              "variant": "h2"
+                              "content": "Theme Settings"
                             }
                           ]
                         },
@@ -135,24 +190,24 @@
                           "children": [
                             {
                               "type": "stack",
-                              "direction": "vertical",
-                              "gap": "md",
                               "children": [
                                 {
-                                  "type": "typography",
                                   "variant": "h4",
-                                  "content": "Quick Toggle"
+                                  "content": "Quick Toggle",
+                                  "type": "typography"
                                 },
                                 {
-                                  "type": "typography",
                                   "variant": "caption",
-                                  "color": "muted",
-                                  "content": "Switch between light and dark mode"
+                                  "type": "typography",
+                                  "content": "Switch between light and dark mode",
+                                  "color": "muted"
                                 },
                                 {
                                   "type": "theme-toggle"
                                 }
-                              ]
+                              ],
+                              "direction": "vertical",
+                              "gap": "md"
                             }
                           ]
                         },
@@ -160,61 +215,57 @@
                           "type": "card",
                           "children": [
                             {
-                              "type": "stack",
-                              "direction": "vertical",
-                              "gap": "md",
                               "children": [
                                 {
                                   "type": "typography",
-                                  "variant": "h4",
-                                  "content": "Theme Palette"
+                                  "content": "Theme Palette",
+                                  "variant": "h4"
                                 },
                                 {
-                                  "type": "typography",
                                   "variant": "caption",
                                   "color": "muted",
-                                  "content": "Choose from available color schemes"
+                                  "content": "Choose from available color schemes",
+                                  "type": "typography"
                                 },
                                 {
                                   "type": "simple-grid",
-                                  "columns": 3,
                                   "children": [
                                     {
-                                      "type": "button",
-                                      "label": "Almadar",
                                       "event": "SELECT",
-                                      "variant": "secondary"
+                                      "variant": "secondary",
+                                      "type": "button",
+                                      "label": "Almadar"
                                     },
                                     {
-                                      "type": "button",
-                                      "label": "Ocean",
+                                      "variant": "secondary",
                                       "event": "SELECT",
-                                      "variant": "secondary"
+                                      "label": "Ocean",
+                                      "type": "button"
                                     },
                                     {
                                       "type": "button",
-                                      "label": "Forest",
+                                      "variant": "secondary",
                                       "event": "SELECT",
-                                      "variant": "secondary"
+                                      "label": "Forest"
                                     }
-                                  ]
+                                  ],
+                                  "columns": 3.0
                                 }
-                              ]
+                              ],
+                              "gap": "md",
+                              "direction": "vertical",
+                              "type": "stack"
                             }
                           ]
                         },
                         {
-                          "type": "stack",
-                          "direction": "horizontal",
-                          "gap": "md",
                           "children": [
                             {
                               "type": "typography",
-                              "variant": "caption",
-                              "content": "Current mode:"
+                              "content": "Current mode:",
+                              "variant": "caption"
                             },
                             {
-                              "type": "badge",
                               "label": [
                                 "object/get",
                                 [
@@ -222,12 +273,13 @@
                                   "@entity"
                                 ],
                                 "mode"
-                              ]
+                              ],
+                              "type": "badge"
                             },
                             {
+                              "content": "Scheme:",
                               "type": "typography",
-                              "variant": "caption",
-                              "content": "Scheme:"
+                              "variant": "caption"
                             },
                             {
                               "type": "badge",
@@ -240,9 +292,14 @@
                                 "colorScheme"
                               ]
                             }
-                          ]
+                          ],
+                          "direction": "horizontal",
+                          "type": "stack",
+                          "gap": "md"
                         }
-                      ]
+                      ],
+                      "direction": "vertical",
+                      "type": "stack"
                     }
                   ]
                 ]
@@ -256,25 +313,22 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
-                      "direction": "vertical",
-                      "gap": "lg",
                       "children": [
                         {
+                          "align": "center",
                           "type": "stack",
                           "direction": "horizontal",
                           "gap": "sm",
-                          "align": "center",
                           "children": [
                             {
-                              "type": "icon",
                               "name": "palette",
-                              "size": "lg"
+                              "size": "lg",
+                              "type": "icon"
                             },
                             {
-                              "type": "typography",
+                              "variant": "h2",
                               "content": "Theme Settings",
-                              "variant": "h2"
+                              "type": "typography"
                             }
                           ]
                         },
@@ -282,12 +336,9 @@
                           "type": "divider"
                         },
                         {
-                          "type": "card",
                           "children": [
                             {
                               "type": "stack",
-                              "direction": "vertical",
-                              "gap": "md",
                               "children": [
                                 {
                                   "type": "typography",
@@ -296,68 +347,68 @@
                                 },
                                 {
                                   "type": "typography",
-                                  "variant": "caption",
                                   "color": "muted",
-                                  "content": "Switch between light and dark mode"
+                                  "content": "Switch between light and dark mode",
+                                  "variant": "caption"
                                 },
                                 {
                                   "type": "theme-toggle"
                                 }
-                              ]
+                              ],
+                              "gap": "md",
+                              "direction": "vertical"
                             }
-                          ]
+                          ],
+                          "type": "card"
                         },
                         {
-                          "type": "card",
                           "children": [
                             {
-                              "type": "stack",
                               "direction": "vertical",
                               "gap": "md",
+                              "type": "stack",
                               "children": [
                                 {
-                                  "type": "typography",
                                   "variant": "h4",
-                                  "content": "Theme Palette"
+                                  "content": "Theme Palette",
+                                  "type": "typography"
                                 },
                                 {
+                                  "content": "Choose from available color schemes",
                                   "type": "typography",
                                   "variant": "caption",
-                                  "color": "muted",
-                                  "content": "Choose from available color schemes"
+                                  "color": "muted"
                                 },
                                 {
+                                  "columns": 3.0,
                                   "type": "simple-grid",
-                                  "columns": 3,
                                   "children": [
                                     {
+                                      "variant": "secondary",
                                       "type": "button",
-                                      "label": "Almadar",
                                       "event": "SELECT",
-                                      "variant": "secondary"
+                                      "label": "Almadar"
                                     },
                                     {
-                                      "type": "button",
-                                      "label": "Ocean",
+                                      "variant": "secondary",
                                       "event": "SELECT",
-                                      "variant": "secondary"
+                                      "label": "Ocean",
+                                      "type": "button"
                                     },
                                     {
-                                      "type": "button",
                                       "label": "Forest",
+                                      "variant": "secondary",
                                       "event": "SELECT",
-                                      "variant": "secondary"
+                                      "type": "button"
                                     }
                                   ]
                                 }
                               ]
                             }
-                          ]
+                          ],
+                          "type": "card"
                         },
                         {
-                          "type": "stack",
-                          "direction": "horizontal",
-                          "gap": "md",
                           "children": [
                             {
                               "type": "typography",
@@ -381,7 +432,6 @@
                               "content": "Scheme:"
                             },
                             {
-                              "type": "badge",
                               "label": [
                                 "object/get",
                                 [
@@ -389,11 +439,18 @@
                                   "@entity"
                                 ],
                                 "colorScheme"
-                              ]
+                              ],
+                              "type": "badge"
                             }
-                          ]
+                          ],
+                          "type": "stack",
+                          "gap": "md",
+                          "direction": "horizontal"
                         }
-                      ]
+                      ],
+                      "gap": "lg",
+                      "direction": "vertical",
+                      "type": "stack"
                     }
                   ]
                 ]
@@ -412,27 +469,26 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
-                      "direction": "vertical",
                       "gap": "lg",
+                      "direction": "vertical",
                       "children": [
                         {
-                          "type": "stack",
-                          "direction": "horizontal",
-                          "gap": "sm",
-                          "align": "center",
                           "children": [
                             {
-                              "type": "icon",
                               "name": "palette",
+                              "type": "icon",
                               "size": "lg"
                             },
                             {
-                              "type": "typography",
                               "content": "Theme Settings",
+                              "type": "typography",
                               "variant": "h2"
                             }
-                          ]
+                          ],
+                          "type": "stack",
+                          "direction": "horizontal",
+                          "align": "center",
+                          "gap": "sm"
                         },
                         {
                           "type": "divider"
@@ -442,34 +498,31 @@
                           "children": [
                             {
                               "type": "stack",
-                              "direction": "vertical",
-                              "gap": "md",
                               "children": [
                                 {
                                   "type": "typography",
-                                  "variant": "h4",
-                                  "content": "Quick Toggle"
+                                  "content": "Quick Toggle",
+                                  "variant": "h4"
                                 },
                                 {
-                                  "type": "typography",
                                   "variant": "caption",
                                   "color": "muted",
+                                  "type": "typography",
                                   "content": "Switch between light and dark mode"
                                 },
                                 {
                                   "type": "theme-toggle"
                                 }
-                              ]
+                              ],
+                              "gap": "md",
+                              "direction": "vertical"
                             }
                           ]
                         },
                         {
-                          "type": "card",
                           "children": [
                             {
-                              "type": "stack",
                               "direction": "vertical",
-                              "gap": "md",
                               "children": [
                                 {
                                   "type": "typography",
@@ -477,19 +530,19 @@
                                   "content": "Theme Palette"
                                 },
                                 {
-                                  "type": "typography",
                                   "variant": "caption",
-                                  "color": "muted",
-                                  "content": "Choose from available color schemes"
+                                  "content": "Choose from available color schemes",
+                                  "type": "typography",
+                                  "color": "muted"
                                 },
                                 {
                                   "type": "simple-grid",
-                                  "columns": 3,
+                                  "columns": 3.0,
                                   "children": [
                                     {
                                       "type": "button",
-                                      "label": "Almadar",
                                       "event": "SELECT",
+                                      "label": "Almadar",
                                       "variant": "secondary"
                                     },
                                     {
@@ -499,20 +552,21 @@
                                       "variant": "secondary"
                                     },
                                     {
-                                      "type": "button",
-                                      "label": "Forest",
                                       "event": "SELECT",
-                                      "variant": "secondary"
+                                      "type": "button",
+                                      "variant": "secondary",
+                                      "label": "Forest"
                                     }
                                   ]
                                 }
-                              ]
+                              ],
+                              "type": "stack",
+                              "gap": "md"
                             }
-                          ]
+                          ],
+                          "type": "card"
                         },
                         {
-                          "type": "stack",
-                          "direction": "horizontal",
                           "gap": "md",
                           "children": [
                             {
@@ -532,12 +586,11 @@
                               ]
                             },
                             {
+                              "content": "Scheme:",
                               "type": "typography",
-                              "variant": "caption",
-                              "content": "Scheme:"
+                              "variant": "caption"
                             },
                             {
-                              "type": "badge",
                               "label": [
                                 "object/get",
                                 [
@@ -545,17 +598,22 @@
                                   "@entity"
                                 ],
                                 "colorScheme"
-                              ]
+                              ],
+                              "type": "badge"
                             }
-                          ]
+                          ],
+                          "type": "stack",
+                          "direction": "horizontal"
                         }
-                      ]
+                      ],
+                      "type": "stack"
                     }
                   ]
                 ]
               }
             ]
-          }
+          },
+          "scope": "collection"
         }
       ],
       "pages": [
@@ -571,4 +629,4 @@
       ]
     }
   ]
-}
+}