@almadar/std 13.12.0 → 13.13.0

package/behaviors/registry/core/atoms/std-browse.orb

@@ -171,11 +171,11 @@
                     "fetch",
                     "BrowseItem",
                     {
+                      "limit": "@config.pageSize",
                       "emit": {
-                        "failure": "BrowseItemLoadFailed",
-                        "success": "BrowseItemLoaded"
+                        "success": "BrowseItemLoaded",
+                        "failure": "BrowseItemLoadFailed"
                       },
-                      "limit": "@config.pageSize",
                       "offset": 0.0
                     }
                   ],
@@ -198,16 +198,16 @@
                     "render-ui",
                     "main",
                     {
+                      "type": "stack",
+                      "direction": "vertical",
                       "children": [
                         {
-                          "fields": "@config.fields",
+                          "pageSize": "@config.displayPageSize",
                           "type": "data-grid",
-                          "entity": "@payload.data",
-                          "pageSize": "@config.displayPageSize"
+                          "fields": "@config.fields",
+                          "entity": "@payload.data"
                         }
-                      ],
-                      "direction": "vertical",
-                      "type": "stack"
+                      ]
                     }
                   ]
                 ]
@@ -222,9 +222,9 @@
                     "main",
                     {
                       "variant": "caption",
-                      "color": "error",
+                      "content": "@payload.error",
                       "type": "typography",
-                      "content": "@payload.error"
+                      "color": "error"
                     }
                   ]
                 ]
@@ -239,19 +239,19 @@
                     "BrowseItem",
                     {
                       "limit": "@config.pageSize",
+                      "offset": 0.0,
                       "emit": {
-                        "success": "BrowseItemLoaded",
-                        "failure": "BrowseItemLoadFailed"
-                      },
-                      "offset": 0.0
+                        "failure": "BrowseItemLoadFailed",
+                        "success": "BrowseItemLoaded"
+                      }
                     }
                   ],
                   [
                     "render-ui",
                     "main",
                     {
-                      "type": "spinner",
-                      "size": "sm"
+                      "size": "sm",
+                      "type": "spinner"
                     }
                   ]
                 ]
@@ -266,11 +266,6 @@
                     "BrowseItem",
                     {
                       "offset": 0.0,
-                      "limit": "@config.pageSize",
-                      "emit": {
-                        "success": "BrowseItemLoaded",
-                        "failure": "BrowseItemLoadFailed"
-                      },
                       "filter": [
                         "or",
                         [
@@ -287,7 +282,12 @@
                           ],
                           "@payload.searchTerm"
                         ]
-                      ]
+                      ],
+                      "emit": {
+                        "success": "BrowseItemLoaded",
+                        "failure": "BrowseItemLoadFailed"
+                      },
+                      "limit": "@config.pageSize"
                     }
                   ]
                 ]
@@ -302,9 +302,10 @@
                     "BrowseItem",
                     {
                       "emit": {
-                        "success": "BrowseItemLoaded",
-                        "failure": "BrowseItemLoadFailed"
+                        "failure": "BrowseItemLoadFailed",
+                        "success": "BrowseItemLoaded"
                       },
+                      "limit": "@config.pageSize",
                       "offset": 0.0,
                       "filter": [
                         "or",
@@ -322,8 +323,7 @@
                           ],
                           "@payload.value"
                         ]
-                      ],
-                      "limit": "@config.pageSize"
+                      ]
                     }
                   ]
                 ]
@@ -337,6 +337,11 @@
                     "fetch",
                     "BrowseItem",
                     {
+                      "limit": "@config.pageSize",
+                      "emit": {
+                        "failure": "BrowseItemLoadFailed",
+                        "success": "BrowseItemLoaded"
+                      },
                       "offset": [
                         "*",
                         [
@@ -345,12 +350,7 @@
                           1.0
                         ],
                         "@config.pageSize"
-                      ],
-                      "limit": "@config.pageSize",
-                      "emit": {
-                        "success": "BrowseItemLoaded",
-                        "failure": "BrowseItemLoadFailed"
-                      }
+                      ]
                     }
                   ]
                 ]
@@ -364,16 +364,16 @@
                     "render-ui",
                     "main",
                     {
+                      "type": "stack",
                       "direction": "vertical",
                       "children": [
                         {
-                          "type": "data-grid",
-                          "fields": "@config.fields",
+                          "entity": "@payload.data",
                           "pageSize": "@config.displayPageSize",
-                          "entity": "@payload.data"
+                          "type": "data-grid",
+                          "fields": "@config.fields"
                         }
-                      ],
-                      "type": "stack"
+                      ]
                     }
                   ]
                 ]
@@ -387,8 +387,8 @@
                     "fetch",
                     "BrowseItem",
                     {
-                      "offset": 0.0,
                       "limit": "@config.pageSize",
+                      "offset": 0.0,
                       "emit": {
                         "failure": "BrowseItemLoadFailed",
                         "success": "BrowseItemLoaded"
@@ -410,15 +410,31 @@
           "config": {
             "displayPageSize": {
               "type": "number",
-              "default": 0.0
+              "default": 10.0
             },
             "fields": {
               "type": "[object]",
-              "default": []
+              "default": [
+                {
+                  "variant": "h4",
+                  "name": "name",
+                  "label": "Name"
+                },
+                {
+                  "variant": "caption",
+                  "name": "description",
+                  "label": "Description"
+                },
+                {
+                  "label": "Status",
+                  "name": "status",
+                  "variant": "badge"
+                }
+              ]
             },
             "pageSize": {
               "type": "number",
-              "default": 0.0
+              "default": 10.0
             }
           },
           "scope": "collection"

package/behaviors/registry/core/atoms/std-display.orb

@@ -1,7 +1,7 @@
 {
   "name": "std-display",
   "version": "1.1.0",
-  "description": "std-display — DEPRECATED. The earlier shape inlined a hard-coded\nchart + graph-view + several stat cards into a single render-ui spec\nwith @entity.X bindings that no transition explicitly set, which\nviolates the explicit-binding rule (gap #25 in\ndocs/Almadar_Std_Verification.md). The chart payload was hand-\nauthored literal data, not aggregated from a real entity stream.\n\nUse these instead:\n  std-stats   — embeddable stat-card aggregations (count / sum / avg\n                / min / max / distinct), ITEMS_LOADED listener.\n  std-graphs  — embeddable charts (bar / line / pie / area / donut),\n                config-driven categoryField + aggregation, same\n                ITEMS_LOADED listener shape.\n\nCompose them in a molecule alongside std-browse the same way\nstd-filtered-list composes std-search / std-filter / std-browse /\nstd-pagination. See std-dashboard.lolo for the canonical pattern.\n\nThis file is preserved (and still embedded) so existing projects\nthat import `std/behaviors/std-display` keep loading; new dashboards\nshould target std-stats + std-graphs.",
+  "description": "std-display — DEPRECATED. Use std-stats (stat-cards) + std-graphs (charts) composed in a molecule (see std-dashboard); the original violated the explicit-binding rule. Preserved so existing imports keep loading.",
   "orbitals": [
     {
       "name": "DisplayItemOrbital",
@@ -44,10 +44,10 @@
                     "render-ui",
                     "main",
                     {
+                      "title": "std-display is deprecated",
                       "message": "@config.message",
-                      "variant": "warning",
                       "type": "alert",
-                      "title": "std-display is deprecated"
+                      "variant": "warning"
                     }
                   ]
                 ]

package/behaviors/registry/core/atoms/std-filter.orb

@@ -1,7 +1,7 @@
 {
   "name": "std-filter",
   "version": "1.0.0",
-  "description": "std-filter as a Function — single primitive: filter-group. The atom's\nown FilterTarget entity is the UI-state container — every FILTER\ntransition persists field/value into the entity. Visual reflection of\nthe persisted value (filter-group `value` prop) is a follow-up that\nneeds the pattern registry + UI component to accept a `value` prop;\nthe persistence side is done.",
+  "description": "std-filter — single primitive: filter-group. Owns a FilterTarget runtime entity; every FILTER transition persists field/value so cross-trait listeners can route the latest selection into data atoms.",
   "orbitals": [
     {
       "name": "FilterTargetOrbital",
@@ -94,9 +94,9 @@
                     "render-ui",
                     "main",
                     {
-                      "filters": "@config.filters",
                       "entity": "FilterTarget",
-                      "type": "filter-group"
+                      "type": "filter-group",
+                      "filters": "@config.filters"
                     }
                   ]
                 ]
@@ -121,8 +121,8 @@
                     "main",
                     {
                       "type": "filter-group",
-                      "entity": "FilterTarget",
-                      "filters": "@config.filters"
+                      "filters": "@config.filters",
+                      "entity": "FilterTarget"
                     }
                   ]
                 ]
@@ -146,17 +146,17 @@
                     "emit",
                     "FILTER",
                     {
-                      "field": "",
-                      "value": ""
+                      "value": "",
+                      "field": ""
                     }
                   ],
                   [
                     "render-ui",
                     "main",
                     {
+                      "type": "filter-group",
                       "entity": "FilterTarget",
-                      "filters": "@config.filters",
-                      "type": "filter-group"
+                      "filters": "@config.filters"
                     }
                   ]
                 ]

package/behaviors/registry/core/atoms/std-graphs.orb

@@ -1,7 +1,7 @@
 {
   "name": "std-graphs",
   "version": "1.0.0",
-  "description": "std-graphs — embeddable chart atom. Drops into a dashboard molecule\nalongside std-stats / std-browse; wire its ITEMS_LOADED listener to\nthe upstream collection's success emit, then configure `chartType` +\n`categoryField` + (`valueField` | `aggregation`) per call-site to\ndeclare WHAT to chart.\n\nAggregation runs in the lolo state machine: ITEMS_LOADED groups\n@payload.data by @config.categoryField (array/groupBy returns\n{<category>: [<rows>]}) then array/maps over (object/entries result)\nto apply the configured aggregation (count | sum | avg | min | max)\nper bucket. The resulting chart-data array of {label, value} drops\ninto the existing chart pattern with no aggregator component required.\n\nThe `ChartPoint` type alias narrows the entity field to the exact\nshape the `chart` pattern's `data` prop expects (`{label, value}`),\nso no `Record<string, unknown>` cast lands at the call site —\nschema authors keep strict typing end-to-end.",
+  "description": "std-graphs — embeddable chart atom. ITEMS_LOADED groups @payload.data by @config.categoryField and applies the configured aggregation (count|sum|avg|min|max) per bucket, emitting {label,value} points into the chart pattern. Drop into a dashboard alongside std-stats / std-browse.",
   "orbitals": [
     {
       "name": "GraphItemOrbital",
@@ -21,13 +21,13 @@
             "items": {
               "type": "object",
               "properties": {
-                "value": {
-                  "name": "value",
-                  "type": "number"
-                },
                 "label": {
                   "name": "label",
                   "type": "string"
+                },
+                "value": {
+                  "name": "value",
+                  "type": "number"
                 }
               }
             }
@@ -81,14 +81,14 @@
                     "render-ui",
                     "main",
                     {
-                      "data": "@entity.chartData",
-                      "chartType": "@config.chartType",
                       "subtitle": "@config.subtitle",
-                      "type": "chart",
-                      "showValues": "@config.showValues",
+                      "chartType": "@config.chartType",
+                      "showLegend": "@config.showLegend",
                       "title": "@config.title",
-                      "height": "@config.height",
-                      "showLegend": "@config.showLegend"
+                      "data": "@entity.chartData",
+                      "showValues": "@config.showValues",
+                      "type": "chart",
+                      "height": "@config.height"
                     }
                   ]
                 ]
@@ -207,11 +207,11 @@
                       "chartType": "@config.chartType",
                       "data": "@entity.chartData",
                       "height": "@config.height",
+                      "showValues": "@config.showValues",
                       "type": "chart",
+                      "showLegend": "@config.showLegend",
                       "title": "@config.title",
-                      "subtitle": "@config.subtitle",
-                      "showValues": "@config.showValues",
-                      "showLegend": "@config.showLegend"
+                      "subtitle": "@config.subtitle"
                     }
                   ]
                 ]
@@ -219,13 +219,28 @@
             ]
           },
           "config": {
-            "categoryField": {
+            "chartType": {
+              "type": "string",
+              "default": "bar",
+              "values": [
+                "bar",
+                "line",
+                "pie",
+                "area",
+                "donut"
+              ]
+            },
+            "showLegend": {
+              "type": "boolean",
+              "default": true
+            },
+            "subtitle": {
               "type": "string",
               "default": ""
             },
-            "height": {
-              "type": "number",
-              "default": 280.0
+            "valueField": {
+              "type": "string",
+              "default": ""
             },
             "showValues": {
               "type": "boolean",
@@ -242,32 +257,17 @@
                 "max"
               ]
             },
-            "title": {
+            "categoryField": {
               "type": "string",
               "default": ""
             },
-            "subtitle": {
-              "type": "string",
-              "default": ""
+            "height": {
+              "type": "number",
+              "default": 280.0
             },
-            "valueField": {
+            "title": {
               "type": "string",
               "default": ""
-            },
-            "chartType": {
-              "type": "string",
-              "default": "bar",
-              "values": [
-                "bar",
-                "line",
-                "pie",
-                "area",
-                "donut"
-              ]
-            },
-            "showLegend": {
-              "type": "boolean",
-              "default": true
             }
           },
           "scope": "instance"

package/behaviors/registry/core/atoms/std-pagination.orb

@@ -1,7 +1,7 @@
 {
   "name": "std-pagination",
   "version": "1.0.0",
-  "description": "std-pagination as a Function — single primitive: pagination control.\nThe Pagination UI component emits `{page}` for page changes; the atom's\nPAGE event payload matches that shape. ITEMS_LOADED accepts an upstream\ndata-loaded event payload `{data : [object]}` and derives totalPages =\nceil(len(data) / pageSize). Molecules wire e.g.\n`FilteredItemBrowse.BrowseItemLoaded -> ITEMS_LOADED` to keep the\npagination control in lockstep with the data hub. The PagedItem entity\npersists currentPage and the derived totalPages so reads from\n@entity.totalPages reflect the latest row count.",
+  "description": "std-pagination — single primitive: pagination control. PAGE accepts the Pagination component's `{page}` emit; ITEMS_LOADED accepts an upstream `{data:[object]}` payload and derives totalPages = ceil(len/pageSize). Molecules wire `BrowseItemLoaded -> ITEMS_LOADED` to keep it in lockstep with the data hub.",
   "orbitals": [
     {
       "name": "PagedItemOrbital",
@@ -130,10 +130,10 @@
                     "main",
                     {
                       "type": "pagination",
-                      "totalPages": "@entity.totalPages",
                       "pageChangeEvent": "@config.event",
-                      "showPageSize": false,
-                      "currentPage": "@entity.currentPage"
+                      "currentPage": "@entity.currentPage",
+                      "totalPages": "@entity.totalPages",
+                      "showPageSize": false
                     }
                   ]
                 ]
@@ -148,10 +148,10 @@
                     "main",
                     {
                       "type": "pagination",
-                      "pageChangeEvent": "@config.event",
-                      "showPageSize": false,
                       "totalPages": "@entity.totalPages",
-                      "currentPage": "@entity.currentPage"
+                      "pageChangeEvent": "@config.event",
+                      "currentPage": "@entity.currentPage",
+                      "showPageSize": false
                     }
                   ]
                 ]
@@ -170,11 +170,11 @@
                     "render-ui",
                     "main",
                     {
+                      "currentPage": "@entity.currentPage",
+                      "showPageSize": false,
                       "totalPages": "@entity.totalPages",
                       "type": "pagination",
-                      "pageChangeEvent": "@config.event",
-                      "currentPage": "@entity.currentPage",
-                      "showPageSize": false
+                      "pageChangeEvent": "@config.event"
                     }
                   ]
                 ]
@@ -200,11 +200,11 @@
                     "render-ui",
                     "main",
                     {
-                      "pageChangeEvent": "@config.event",
-                      "showPageSize": false,
+                      "type": "pagination",
                       "currentPage": "@entity.currentPage",
+                      "pageChangeEvent": "@config.event",
                       "totalPages": "@entity.totalPages",
-                      "type": "pagination"
+                      "showPageSize": false
                     }
                   ]
                 ]
@@ -212,13 +212,13 @@
             ]
           },
           "config": {
-            "event": {
-              "type": "string",
-              "default": "PAGE"
-            },
             "pageSize": {
               "type": "number",
               "default": 10.0
+            },
+            "event": {
+              "type": "string",
+              "default": "PAGE"
             }
           },
           "scope": "instance"

package/behaviors/registry/core/atoms/std-search.orb

@@ -1,7 +1,7 @@
 {
   "name": "std-search",
   "version": "1.0.0",
-  "description": "std-search as a Function — single primitive: search-input. The atom's\nown SearchResult entity is the UI-state container — SEARCH persists\n@payload.searchTerm (matching the SearchInput component's emit shape)\ninto @entity.searchTerm. Cross-trait listeners route the same payload\nfield to data atoms (Browse REFETCH_QUERY).",
+  "description": "std-search — single primitive: search-input. Owns a SearchResult runtime entity; SEARCH persists @payload.searchTerm (matching SearchInput's emit shape) so cross-trait listeners can route it into data atoms (Browse REFETCH_QUERY).",
   "orbitals": [
     {
       "name": "SearchResultOrbital",
@@ -71,9 +71,9 @@
                     "render-ui",
                     "main",
                     {
-                      "event": "@config.event",
                       "placeholder": "@config.placeholder",
-                      "type": "search-input"
+                      "type": "search-input",
+                      "event": "@config.event"
                     }
                   ]
                 ]
@@ -93,8 +93,8 @@
                     "main",
                     {
                       "placeholder": "@config.placeholder",
-                      "type": "search-input",
-                      "event": "@config.event"
+                      "event": "@config.event",
+                      "type": "search-input"
                     }
                   ]
                 ]
@@ -102,13 +102,13 @@
             ]
           },
           "config": {
-            "placeholder": {
-              "type": "string",
-              "default": "Search…"
-            },
             "event": {
               "type": "string",
               "default": "SEARCH"
+            },
+            "placeholder": {
+              "type": "string",
+              "default": "Search…"
             }
           },
           "scope": "instance"