@almadar/std 16.234.0 → 16.236.0

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

@@ -1,5 +1,5 @@
 {
-  "description": "std-graphs — embeddable chart atom. ITEMS_LOADED groups @payload.data by @config.categoryField (or @config.timeField when timeAxis=true) and aggregates per bucket. Multi-series rendering via @config.series (preformatted ChartSeries shape). Histograms via chartType=histogram pass pre-binned @payload.data through unchanged. Stacked / 100% stacked bars via @config.stack. Post-process sort + limit. Clicking a data point emits UI:@config.drillEvent with { label, value, seriesLabel? }. Drop into a dashboard alongside std-stats / std-browse.",
+  "description": "std-graphs — embeddable chart atom. ITEMS_LOADED keeps the rows whose @config.filterField equals @config.filterValue (blank = all), groups them by @config.categoryField, or (timeAxis=true) by the @config.period bucket of @config.timeField — rows without a time value have no place on a time axis and are left out — and aggregates per bucket. Multi-series rendering via @config.series (preformatted ChartSeries shape). Histograms via chartType=histogram pass pre-binned @payload.data through unchanged. Stacked / 100% stacked bars via @config.stack. Post-process sort + limit. Clicking a data point emits UI:@config.drillEvent with { label, value, seriesLabel? }. Drop into a dashboard alongside std-stats / std-browse.",
   "ledger": {
     "entries": {
       "ent_01KXG04GN3VS5JTJHRM5AAK86J": {
@@ -173,6 +173,22 @@
               "tier": "internal",
               "type": "event"
             },
+            "filterField": {
+              "default": "",
+              "description": "Row field a row must match to be charted (blank = every row), compared with filterValue — e.g. status + paid charts paid invoices only",
+              "label": "Only count rows where field",
+              "synonyms": "only include, where, filter by, restrict to. user phrases: 'only paid invoices' -> filterField=status + filterValue=paid; 'just the open deals' -> filterField=status + filterValue=open",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "filterValue": {
+              "default": "",
+              "description": "The value filterField must equal for a row to be charted",
+              "label": "Equals",
+              "synonyms": "the kept value. user phrases: 'only paid' -> paid; 'just active ones' -> active",
+              "tier": "presentation",
+              "type": "string"
+            },
             "height": {
               "default": 280.0,
               "description": "Pixel height of the rendered chart",
@@ -437,6 +453,7 @@
                       "data": "@entity.chartData",
                       "drillEvent": "@config.drillEvent",
                       "height": "@config.height",
+                      "period": "@config.period",
                       "series": "@config.series",
                       "showLegend": "@config.showLegend",
                       "showValues": "@config.showValues",
@@ -456,84 +473,141 @@
               {
                 "effects": [
                   [
-                    "set",
-                    "@entity.chartData",
+                    "let",
                     [
-                      "if",
                       [
-                        "=",
-                        "@config.chartType",
-                        "histogram"
-                      ],
-                      [
-                        "array/map",
-                        "@payload.data",
+                        "rows",
                         [
-                          "fn",
-                          "p",
-                          {
-                            "label": [
-                              "object/get",
-                              "@p",
-                              "label"
-                            ],
-                            "value": [
-                              "object/get",
-                              "@p",
-                              "value"
+                          "if",
+                          [
+                            "=",
+                            "@config.filterField",
+                            ""
+                          ],
+                          "@payload.data",
+                          [
+                            "array/filter",
+                            "@payload.data",
+                            [
+                              "fn",
+                              "row",
+                              [
+                                "=",
+                                [
+                                  "object/get",
+                                  "@row",
+                                  "@config.filterField"
+                                ],
+                                "@config.filterValue"
+                              ]
                             ]
-                          }
+                          ]
                         ]
-                      ],
+                      ]
+                    ],
+                    [
+                      "set",
+                      "@entity.chartData",
                       [
-                        "array/map",
+                        "if",
                         [
-                          "object/entries",
+                          "=",
+                          "@config.chartType",
+                          "histogram"
+                        ],
+                        [
+                          "array/map",
+                          "@rows",
                           [
-                            "array/groupBy",
-                            "@payload.data",
-                            [
-                              "if",
-                              "@config.timeAxis",
-                              "@config.timeField",
-                              "@config.categoryField"
-                            ]
+                            "fn",
+                            "p",
+                            {
+                              "label": [
+                                "object/get",
+                                "@p",
+                                "label"
+                              ],
+                              "value": [
+                                "object/get",
+                                "@p",
+                                "value"
+                              ]
+                            }
                           ]
                         ],
                         [
-                          "fn",
-                          "entry",
-                          {
-                            "label": [
-                              "object/get",
-                              "@entry",
-                              "0"
-                            ],
-                            "value": [
+                          "array/map",
+                          [
+                            "object/entries",
+                            [
                               "if",
+                              "@config.timeAxis",
                               [
-                                "=",
-                                "@config.aggregation",
-                                "sum"
-                              ],
-                              [
-                                "array/sum",
+                                "array/groupBy",
                                 [
-                                  "object/get",
-                                  "@entry",
-                                  "1"
+                                  "array/map",
+                                  [
+                                    "array/filter",
+                                    "@rows",
+                                    [
+                                      "fn",
+                                      "row",
+                                      [
+                                        "object/get",
+                                        "@row",
+                                        "@config.timeField"
+                                      ]
+                                    ]
+                                  ],
+                                  [
+                                    "fn",
+                                    "row",
+                                    [
+                                      "object/set",
+                                      "@row",
+                                      "periodStart",
+                                      [
+                                        "time/startOf",
+                                        [
+                                          "time/parse",
+                                          [
+                                            "object/get",
+                                            "@row",
+                                            "@config.timeField"
+                                          ]
+                                        ],
+                                        "@config.period"
+                                      ]
+                                    ]
+                                  ]
                                 ],
-                                "@config.valueField"
+                                "periodStart"
                               ],
                               [
+                                "array/groupBy",
+                                "@rows",
+                                "@config.categoryField"
+                              ]
+                            ]
+                          ],
+                          [
+                            "fn",
+                            "entry",
+                            {
+                              "label": [
+                                "object/get",
+                                "@entry",
+                                "0"
+                              ],
+                              "value": [
                                 "if",
                                 [
                                   "=",
                                   "@config.aggregation",
-                                  "avg"
+                                  "sum"
                                 ],
                                 [
-                                  "array/avg",
+                                  "array/sum",
                                   [
                                     "object/get",
                                     "@entry",
@@ -546,10 +620,10 @@
                                   [
                                     "=",
                                     "@config.aggregation",
-                                    "min"
+                                    "avg"
                                   ],
                                   [
-                                    "array/min",
+                                    "array/avg",
                                     [
                                       "object/get",
                                       "@entry",
@@ -562,10 +636,10 @@
                                     [
                                       "=",
                                       "@config.aggregation",
-                                      "max"
+                                      "min"
                                     ],
                                     [
-                                      "array/max",
+                                      "array/min",
                                       [
                                         "object/get",
                                         "@entry",
@@ -574,22 +648,54 @@
                                       "@config.valueField"
                                     ],
                                     [
-                                      "array/len",
+                                      "if",
                                       [
-                                        "object/get",
-                                        "@entry",
-                                        "1"
+                                        "=",
+                                        "@config.aggregation",
+                                        "max"
+                                      ],
+                                      [
+                                        "array/max",
+                                        [
+                                          "object/get",
+                                          "@entry",
+                                          "1"
+                                        ],
+                                        "@config.valueField"
+                                      ],
+                                      [
+                                        "array/len",
+                                        [
+                                          "object/get",
+                                          "@entry",
+                                          "1"
+                                        ]
                                       ]
                                     ]
                                   ]
                                 ]
                               ]
-                            ]
-                          }
+                            }
+                          ]
                         ]
                       ]
                     ]
                   ],
+                  [
+                    "set",
+                    "@entity.chartData",
+                    [
+                      "if",
+                      "@config.timeAxis",
+                      [
+                        "array/sort",
+                        "@entity.chartData",
+                        "label",
+                        "asc"
+                      ],
+                      "@entity.chartData"
+                    ]
+                  ],
                   [
                     "set",
                     "@entity.chartData",
@@ -635,6 +741,7 @@
                       "data": "@entity.chartData",
                       "drillEvent": "@config.drillEvent",
                       "height": "@config.height",
+                      "period": "@config.period",
                       "series": "@config.series",
                       "showLegend": "@config.showLegend",
                       "showValues": "@config.showValues",

package/behaviors/registry/ui/core/atoms/std-import.orb

@@ -283,14 +283,6 @@
               "tier": "presentation",
               "type": "string"
             },
-            "event": {
-              "default": "IMPORT_SOURCE_PICKED",
-              "description": "Event emitted when the user picks a source. Each entry in sources[] carries its own literal event field (no per-item templating in .lolo) — overriding this alone does not retarget the click; also set sources[].event to match.",
-              "label": "Source-picked event",
-              "synonyms": "bus event name. internal wiring; users rarely target directly",
-              "tier": "internal",
-              "type": "string"
-            },
             "sources": {
               "default": [
                 {

package/behaviors/registry/ui/core/atoms/std-list.orb

@@ -218,6 +218,22 @@
         "kind": "trait",
         "owner": "workspace",
         "renames": []
+      },
+      "trt_01M3SFBP29125B6XWS09H2479Q": {
+        "bakedName": "ListItemCreateButton",
+        "curName": "ListItemCreateButton",
+        "id": "trt_01M3SFBP29125B6XWS09H2479Q",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
+      },
+      "trt_01M3SFBP2919B7ZZAVP0866HMK": {
+        "bakedName": "ListItemCreateGate",
+        "curName": "ListItemCreateGate",
+        "id": "trt_01M3SFBP2919B7ZZAVP0866HMK",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
       }
     },
     "schemaVersion": 1
@@ -317,6 +333,16 @@
               "tier": "presentation",
               "type": "boolean"
             },
+            "createRoles": {
+              "default": [],
+              "description": "Roles (matched against viewerRole) that see the Create button. Empty = everyone.",
+              "items": {
+                "type": "string"
+              },
+              "label": "Roles that can create",
+              "tier": "policy",
+              "type": "[string]"
+            },
             "displayPageSize": {
               "default": 20.0,
               "description": "Rows visible per page before the data-grid's own pagination control appears — 20 matches the CRUD-list density sweet spot (Miller's law, 10-25 rows).",
@@ -371,6 +397,57 @@
               "tier": "presentation",
               "type": "[FilterSpec]"
             },
+            "itemActions": {
+              "default": [
+                {
+                  "event": "EDIT",
+                  "label": "Edit",
+                  "variant": "ghost"
+                },
+                {
+                  "event": "DELETE",
+                  "label": "Delete",
+                  "variant": "danger"
+                }
+              ],
+              "description": "Actions offered on each row; give an item `roles` to show it only to those viewer roles.",
+              "items": {
+                "properties": {
+                  "event": {
+                    "name": "event",
+                    "required": false,
+                    "type": "event"
+                  },
+                  "label": {
+                    "name": "label",
+                    "required": true,
+                    "type": "string"
+                  },
+                  "roles": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "name": "roles",
+                    "required": false,
+                    "type": "array"
+                  },
+                  "variant": {
+                    "name": "variant",
+                    "required": false,
+                    "type": "string"
+                  },
+                  "when": {
+                    "name": "when",
+                    "required": false,
+                    "type": "object"
+                  }
+                },
+                "type": "object"
+              },
+              "label": "Row actions",
+              "tier": "presentation",
+              "type": "[ItemAction]"
+            },
             "pageSize": {
               "default": 20.0,
               "description": "Records fetched from the server per REFETCH_PAGE request. The initial load and search/filter refetches remain unpaginated (load everything that matches) unless a consumer wires REFETCH_PAGE, so the default list surface is unchanged.",
@@ -394,6 +471,13 @@
               "synonyms": "search hint, placeholder, search box text",
               "tier": "presentation",
               "type": "string"
+            },
+            "viewerRole": {
+              "default": "",
+              "description": "The signed-in viewer's role that each action's `roles` is checked against. Bind it explicitly at the call site (e.g. `viewerRole: @user.role`) in an app whose identity carries a role; left empty, only actions with no `roles` show.",
+              "label": "Viewer's role",
+              "tier": "policy",
+              "type": "string"
             }
           },
           "effectRow": [
@@ -908,13 +992,7 @@
                               "gap": "md",
                               "type": "stack"
                             },
-                            {
-                              "action": "CREATE",
-                              "icon": "plus",
-                              "label": "Create",
-                              "type": "button",
-                              "variant": "primary"
-                            }
+                            "@trait.ListItemCreateGate"
                           ],
                           "direction": "horizontal",
                           "gap": "md",
@@ -998,16 +1076,38 @@
                             }
                           ],
                           "itemActions": [
-                            {
-                              "event": "EDIT",
-                              "label": "Edit",
-                              "variant": "ghost"
-                            },
-                            {
-                              "event": "DELETE",
-                              "label": "Delete",
-                              "variant": "danger"
-                            }
+                            "array/filter",
+                            "@config.itemActions",
+                            [
+                              "fn",
+                              "action",
+                              [
+                                "or",
+                                [
+                                  "=",
+                                  [
+                                    "array/len",
+                                    [
+                                      "object/get",
+                                      "@action",
+                                      "roles",
+                                      []
+                                    ]
+                                  ],
+                                  0.0
+                                ],
+                                [
+                                  "array/includes",
+                                  [
+                                    "object/get",
+                                    "@action",
+                                    "roles",
+                                    []
+                                  ],
+                                  "@config.viewerRole"
+                                ]
+                              ]
+                            ]
                           ],
                           "pageSize": "@config.displayPageSize",
                           "type": "data-grid"
@@ -1241,13 +1341,7 @@
                               "gap": "md",
                               "type": "stack"
                             },
-                            {
-                              "action": "CREATE",
-                              "icon": "plus",
-                              "label": "Create",
-                              "type": "button",
-                              "variant": "primary"
-                            }
+                            "@trait.ListItemCreateGate"
                           ],
                           "direction": "horizontal",
                           "gap": "md",
@@ -1331,16 +1425,38 @@
                             }
                           ],
                           "itemActions": [
-                            {
-                              "event": "EDIT",
-                              "label": "Edit",
-                              "variant": "ghost"
-                            },
-                            {
-                              "event": "DELETE",
-                              "label": "Delete",
-                              "variant": "danger"
-                            }
+                            "array/filter",
+                            "@config.itemActions",
+                            [
+                              "fn",
+                              "action",
+                              [
+                                "or",
+                                [
+                                  "=",
+                                  [
+                                    "array/len",
+                                    [
+                                      "object/get",
+                                      "@action",
+                                      "roles",
+                                      []
+                                    ]
+                                  ],
+                                  0.0
+                                ],
+                                [
+                                  "array/includes",
+                                  [
+                                    "object/get",
+                                    "@action",
+                                    "roles",
+                                    []
+                                  ],
+                                  "@config.viewerRole"
+                                ]
+                              ]
+                            ]
                           ],
                           "pageSize": "@config.displayPageSize",
                           "type": "data-grid"
@@ -1409,8 +1525,53 @@
                 "to": "loading"
               }
             ]
+          },
+          "traitEmbedIds": {
+            "ListItemCreateGate": "trt_01M3SFBP2919B7ZZAVP0866HMK"
           }
         },
+        {
+          "config": {
+            "action": {
+              "default": "CREATE",
+              "type": "unknown"
+            },
+            "icon": {
+              "default": "plus",
+              "type": "unknown"
+            },
+            "label": {
+              "default": "Create",
+              "type": "unknown"
+            },
+            "variant": {
+              "default": "primary",
+              "type": "unknown"
+            }
+          },
+          "id": "trt_01M3SFBP29125B6XWS09H2479Q",
+          "name": "ListItemCreateButton",
+          "ref": "Button.traits.ButtonRender"
+        },
+        {
+          "config": {
+            "content": {
+              "default": "@trait.ListItemCreateButton",
+              "type": "unknown"
+            },
+            "roles": {
+              "default": "@config.createRoles",
+              "type": "unknown"
+            },
+            "viewerRole": {
+              "default": "@config.viewerRole",
+              "type": "unknown"
+            }
+          },
+          "id": "trt_01M3SFBP2919B7ZZAVP0866HMK",
+          "name": "ListItemCreateGate",
+          "ref": "RoleGate.traits.RoleGate"
+        },
         {
           "config": {
             "fields": {
@@ -1876,9 +2037,40 @@
             "name": "options",
             "type": "[string]"
           }
+        ],
+        "ItemAction": [
+          {
+            "name": "label",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "event",
+            "type": "event"
+          },
+          {
+            "name": "variant",
+            "type": "string"
+          },
+          {
+            "name": "roles",
+            "type": "[string]"
+          },
+          {
+            "name": "when",
+            "type": "SExpr"
+          }
         ]
       },
       "uses": [
+        {
+          "as": "RoleGate",
+          "from": "std/behaviors/std-role-gate"
+        },
+        {
+          "as": "Button",
+          "from": "std/behaviors/ui-button"
+        },
         {
           "as": "Confirmation",
           "from": "std/behaviors/std-confirmation"