@almadar/std 16.238.0 → 16.239.0

package/behaviors/registry/ui/core/organisms/ui-media-gallery.orb

@@ -552,6 +552,24 @@
               "tier": "presentation",
               "type": "boolean"
             },
+            "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"
+              ]
+            },
             "sortBy": {
               "description": "Current sort field",
               "label": "Sort By",
@@ -575,6 +593,17 @@
               "tier": "presentation",
               "type": "string"
             },
+            "surface": {
+              "default": "auto",
+              "description": "Content surface: `auto` paints the theme's surface behind this block unless it already sits on one (a card, dialog or another block); `none` opts out.",
+              "label": "Surface",
+              "tier": "presentation",
+              "type": "string",
+              "values": [
+                "auto",
+                "none"
+              ]
+            },
             "tabIndex": {
               "description": "0 puts the element in the Tab order; -1 makes it focusable only programmatically.",
               "label": "Tab Index",
@@ -795,9 +824,11 @@
                       "selectedItems": "@config.selectedItems",
                       "selectionEvent": "@config.selectionEvent",
                       "showUpload": "@config.showUpload",
+                      "skeleton": "@config.skeleton",
                       "sortBy": "@config.sortBy",
                       "sortDirection": "@config.sortDirection",
                       "srcField": "@config.srcField",
+                      "surface": "@config.surface",
                       "tabIndex": "@config.tabIndex",
                       "title": "@config.title",
                       "totalCount": "@config.totalCount",
@@ -883,9 +914,11 @@
                       "selectedItems": "@config.selectedItems",
                       "selectionEvent": "@config.selectionEvent",
                       "showUpload": "@config.showUpload",
+                      "skeleton": "@config.skeleton",
                       "sortBy": "@config.sortBy",
                       "sortDirection": "@config.sortDirection",
                       "srcField": "@config.srcField",
+                      "surface": "@config.surface",
                       "tabIndex": "@config.tabIndex",
                       "title": "@config.title",
                       "totalCount": "@config.totalCount",
@@ -974,9 +1007,11 @@
                       "selectedItems": "@config.selectedItems",
                       "selectionEvent": "@config.selectionEvent",
                       "showUpload": "@config.showUpload",
+                      "skeleton": "@config.skeleton",
                       "sortBy": "@config.sortBy",
                       "sortDirection": "@config.sortDirection",
                       "srcField": "@config.srcField",
+                      "surface": "@config.surface",
                       "tabIndex": "@config.tabIndex",
                       "title": "@config.title",
                       "totalCount": "@config.totalCount",

package/behaviors/registry/ui/core/organisms/ui-modal-slot.orb

@@ -159,6 +159,24 @@
                 "full"
               ]
             },
+            "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"
+              ]
+            },
             "sourceTrait": {
               "description": "Source trait name for qualified event emission",
               "label": "Source Trait",
@@ -229,6 +247,7 @@
                       "error": "@config.error",
                       "isLoading": "@config.isLoading",
                       "size": "@config.size",
+                      "skeleton": "@config.skeleton",
                       "sourceTrait": "@config.sourceTrait",
                       "title": "@config.title",
                       "type": "modal-slot"

package/behaviors/registry/ui/core/organisms/ui-runtime-debugger.orb

@@ -338,6 +338,24 @@
                 "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",
@@ -405,6 +423,7 @@
                       "mode": "@config.mode",
                       "position": "@config.position",
                       "role": "@config.role",
+                      "skeleton": "@config.skeleton",
                       "tabIndex": "@config.tabIndex",
                       "type": "runtime-debugger"
                     }

package/behaviors/registry/ui/core/organisms/ui-segment-renderer.orb

@@ -309,19 +309,26 @@
             "segments": {
               "default": [
                 {
-                  "content": "Content",
-                  "type": "markdown"
+                  "answer": "Answer",
+                  "question": "Question",
+                  "type": "quiz"
                 },
                 {
-                  "content": "Content 2",
-                  "type": "markdown"
+                  "answer": "Answer 2",
+                  "question": "Question 2",
+                  "type": "quiz"
                 }
               ],
               "description": "Parsed lesson segments (see `parseLessonSegments`)",
               "items": {
                 "properties": {
-                  "content": {
-                    "name": "content",
+                  "answer": {
+                    "name": "answer",
+                    "required": true,
+                    "type": "string"
+                  },
+                  "question": {
+                    "name": "question",
                     "required": true,
                     "type": "string"
                   },
@@ -330,7 +337,7 @@
                     "required": true,
                     "type": "string",
                     "values": [
-                      "markdown"
+                      "quiz"
                     ]
                   }
                 },
@@ -340,6 +347,24 @@
               "tier": "presentation",
               "type": "[SegmentRendererSegmentsItem]"
             },
+            "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",
@@ -434,6 +459,7 @@
                       "lang": "@config.lang",
                       "role": "@config.role",
                       "segments": "@config.segments",
+                      "skeleton": "@config.skeleton",
                       "tabIndex": "@config.tabIndex",
                       "type": "segment-renderer",
                       "userProgress": "@config.userProgress"
@@ -457,7 +483,12 @@
             "type": "string"
           },
           {
-            "name": "content",
+            "name": "question",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "answer",
             "required": true,
             "type": "string"
           }

package/behaviors/registry/ui/core/organisms/ui-split-pane.orb

@@ -387,6 +387,24 @@
                 "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",
@@ -510,6 +528,7 @@
                       "right": "@config.right",
                       "rightClassName": "@config.rightClassName",
                       "role": "@config.role",
+                      "skeleton": "@config.skeleton",
                       "tabIndex": "@config.tabIndex",
                       "type": "split-pane"
                     }
@@ -556,6 +575,7 @@
                       "right": "@config.right",
                       "rightClassName": "@config.rightClassName",
                       "role": "@config.role",
+                      "skeleton": "@config.skeleton",
                       "tabIndex": "@config.tabIndex",
                       "type": "split-pane"
                     }

package/behaviors/registry/ui/core/organisms/ui-stat-card.orb

@@ -526,6 +526,24 @@
               "tier": "internal",
               "type": "boolean"
             },
+            "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"
+              ]
+            },
             "sortBy": {
               "description": "Current sort field",
               "label": "Sort By",
@@ -558,6 +576,17 @@
               "tier": "presentation",
               "type": "string"
             },
+            "surface": {
+              "default": "auto",
+              "description": "Content surface: `auto` paints the theme's surface behind this block unless it already sits on one (a card, dialog or another block); `none` opts out.",
+              "label": "Surface",
+              "tier": "presentation",
+              "type": "string",
+              "values": [
+                "auto",
+                "none"
+              ]
+            },
             "tabIndex": {
               "description": "0 puts the element in the Tab order; -1 makes it focusable only programmatically.",
               "label": "Tab Index",
@@ -737,10 +766,12 @@
                       "role": "@config.role",
                       "searchValue": "@config.searchValue",
                       "selectedIds": "@config.selectedIds",
+                      "skeleton": "@config.skeleton",
                       "sortBy": "@config.sortBy",
                       "sortDirection": "@config.sortDirection",
                       "sparklineData": "@config.sparklineData",
                       "subtitle": "@config.subtitle",
+                      "surface": "@config.surface",
                       "tabIndex": "@config.tabIndex",
                       "title": "@config.title",
                       "totalCount": "@config.totalCount",
@@ -797,10 +828,12 @@
                       "role": "@config.role",
                       "searchValue": "@config.searchValue",
                       "selectedIds": "@config.selectedIds",
+                      "skeleton": "@config.skeleton",
                       "sortBy": "@config.sortBy",
                       "sortDirection": "@config.sortDirection",
                       "sparklineData": "@config.sparklineData",
                       "subtitle": "@config.subtitle",
+                      "surface": "@config.surface",
                       "tabIndex": "@config.tabIndex",
                       "title": "@config.title",
                       "totalCount": "@config.totalCount",
@@ -860,10 +893,12 @@
                       "role": "@config.role",
                       "searchValue": "@config.searchValue",
                       "selectedIds": "@config.selectedIds",
+                      "skeleton": "@config.skeleton",
                       "sortBy": "@config.sortBy",
                       "sortDirection": "@config.sortDirection",
                       "sparklineData": "@config.sparklineData",
                       "subtitle": "@config.subtitle",
+                      "surface": "@config.surface",
                       "tabIndex": "@config.tabIndex",
                       "title": "@config.title",
                       "totalCount": "@config.totalCount",

package/behaviors/registry/ui/core/organisms/ui-state-machine-view.orb

@@ -217,6 +217,7 @@
               ]
             },
             "direction": {
+              "default": "ltr",
               "description": "Flow direction. @default 'ltr'",
               "label": "Direction",
               "tier": "presentation",
@@ -297,6 +298,7 @@
               "type": "string"
             },
             "nodeShape": {
+              "default": "pill",
               "description": "Node silhouette. @default 'pill'",
               "label": "Node Shape",
               "tier": "presentation",
@@ -415,11 +417,30 @@
               "type": "string"
             },
             "showHeader": {
+              "default": true,
               "description": "Show the trait header (name, entity, listens/emits). @default true",
               "label": "Show Header",
               "tier": "presentation",
               "type": "boolean"
             },
+            "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"
+              ]
+            },
             "stateClickEvent": {
               "default": "STATE_CLICK",
               "description": "Emits UI:{stateClickEvent} with { stateId } when a state is clicked.",
@@ -778,6 +799,7 @@
                       "role": "@config.role",
                       "selectedState": "@config.selectedState",
                       "showHeader": "@config.showHeader",
+                      "skeleton": "@config.skeleton",
                       "stateClickEvent": "@config.stateClickEvent",
                       "tabIndex": "@config.tabIndex",
                       "trait": "@config.traitProp",