@almadar/std 16.187.0 → 16.189.0

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

@@ -132,6 +132,13 @@
         {
           "category": "interaction",
           "config": {
+            "labelField": {
+              "default": "name",
+              "description": "Name of the field on the (rebound) related row rendered as the row label and carried as SELECT_RELATED's name — set it to `title` (etc.) whenever the bound entity labels rows differently. The rows are mapped through this at render time, because a trait-level `fields {}` rename is declaration-only on the runtime path and every populated row used to render a blank label.",
+              "label": "Which field labels each related row?",
+              "tier": "presentation",
+              "type": "string"
+            },
             "relationField": {
               "default": "",
               "description": "RelatedItem field compared against SHOW_RELATED's key to scope the fetch to one parent document; empty renders the full unfiltered collection (default).",
@@ -444,7 +451,22 @@
                           "type": "divider"
                         },
                         {
-                          "entity": "@payload.data",
+                          "entity": [
+                            "array/map",
+                            "@payload.data",
+                            [
+                              "fn",
+                              "row",
+                              {
+                                "id": "@row.id",
+                                "name": [
+                                  "object/get",
+                                  "@row",
+                                  "@config.labelField"
+                                ]
+                              }
+                            ]
+                          ],
                           "fields": [],
                           "look": "@config.tableLook",
                           "renderItem": [

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

@@ -73,6 +73,33 @@
         "parent": "trt_01KXG04HJTNYPBNM3ZFYKY5S77",
         "renames": []
       },
+      "evt_01M11H7B3J0W8ESAJ5VJPWPDWE": {
+        "bakedName": "REFETCH_FILTER",
+        "curName": "REFETCH_FILTER",
+        "id": "evt_01M11H7B3J0W8ESAJ5VJPWPDWE",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KXG04HJTNYPBNM3ZFYKY5S77",
+        "renames": []
+      },
+      "evt_01M11H7B3J1A0DSR6SHK7EXBRH": {
+        "bakedName": "REFETCH_QUERY",
+        "curName": "REFETCH_QUERY",
+        "id": "evt_01M11H7B3J1A0DSR6SHK7EXBRH",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KXG04HJTNYPBNM3ZFYKY5S77",
+        "renames": []
+      },
+      "evt_01M11H7B3JKPSJZP3X1HY8R9F1": {
+        "bakedName": "REFETCH_PAGE",
+        "curName": "REFETCH_PAGE",
+        "id": "evt_01M11H7B3JKPSJZP3X1HY8R9F1",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KXG04HJTNYPBNM3ZFYKY5S77",
+        "renames": []
+      },
       "orb_01KXG04HJTVKFQ22E0H5QJRN08": {
         "bakedName": "SelectableItemOrbital",
         "curName": "SelectableItemOrbital",
@@ -163,6 +190,84 @@
         {
           "category": "interaction",
           "config": {
+            "bodySearch": {
+              "default": false,
+              "description": "Embeds a search box above the pick-list. Set true only when the page has no other search affordance (e.g. no page-level std-search), so the surface shows one search box instead of two. False is the default — this atom has never had a search box (0 consumers today).",
+              "label": "Show the pick-list's own search box?",
+              "synonyms": "inline search, list search, built-in search, show search",
+              "tier": "presentation",
+              "type": "boolean"
+            },
+            "displayPageSize": {
+              "default": 20.0,
+              "description": "Rows visible per page before the data-grid's own pagination control appears — 20 matches the pick-list density sweet spot (Miller's law, 10-25 rows).",
+              "label": "How many candidates to show at once?",
+              "synonyms": "visible rows, items per page, display limit, show per page",
+              "tier": "presentation",
+              "type": "number"
+            },
+            "filterBarLook": {
+              "default": "toolbar",
+              "description": "Visual treatment for the embedded filter bar, mirroring std-filter's own enum. Only applies when `filters` is non-empty.",
+              "label": "Filter bar look",
+              "synonyms": "filter bar style, facet style, chips, pills",
+              "tier": "presentation",
+              "type": "string",
+              "values": [
+                "toolbar",
+                "chips",
+                "pills",
+                "popover-trigger",
+                "inline-column-header"
+              ]
+            },
+            "filters": {
+              "default": [],
+              "description": "Dropdown filter facets by field, rendered as an embedded filter bar above the rows; each selection fires REFETCH_FILTER on this trait. Empty (the default) = no filter bar, the right setting whenever the page already composes std-filter beside this list and routes XFilter.FILTER -> REFETCH_FILTER — that is the wired owner and remains the primary path. Use this knob only for a standalone pick-list with no page-level filter affordance.",
+              "items": {
+                "properties": {
+                  "field": {
+                    "name": "field",
+                    "required": true,
+                    "type": "string"
+                  },
+                  "label": {
+                    "name": "label",
+                    "required": false,
+                    "type": "string"
+                  },
+                  "options": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "name": "options",
+                    "required": false,
+                    "type": "array"
+                  }
+                },
+                "type": "object"
+              },
+              "label": "Which filters should appear above the pick-list?",
+              "synonyms": "filter bar, faceted filters, field filters, dropdowns",
+              "tier": "presentation",
+              "type": "[FilterSpec]"
+            },
+            "pageSize": {
+              "default": 20.0,
+              "description": "Records fetched from the server per REFETCH_PAGE request. The initial load and search/filter refetches remain unpaginated (load every candidate) unless a consumer wires REFETCH_PAGE, so the default pick-list surface is unchanged. Safe to page: this atom's selection is a single transient id (never an accumulated array), so no already-picked item can be stranded on another page.",
+              "label": "How many candidates per page when paging?",
+              "synonyms": "fetch limit, records per page, page limit",
+              "tier": "presentation",
+              "type": "number"
+            },
+            "searchPlaceholder": {
+              "default": "Search…",
+              "description": "Hint text inside the pick-list search box.",
+              "label": "Search box placeholder text",
+              "synonyms": "search hint, placeholder, search box text",
+              "tier": "presentation",
+              "type": "string"
+            },
             "tableLook": {
               "default": "dense",
               "description": "Layer 2 visual treatment for the data table rendered by this atom.",
@@ -264,6 +369,56 @@
                 "synonyms": "error, failure, problem, unsuccessful",
                 "tier": "internal"
               },
+              {
+                "description": "Triggers a pick-list refresh based on the current search term.",
+                "id": "evt_01M11H7B3J1A0DSR6SHK7EXBRH",
+                "key": "REFETCH_QUERY",
+                "name": "Refetch Query",
+                "payloadSchema": [
+                  {
+                    "name": "searchTerm",
+                    "required": true,
+                    "type": "string"
+                  }
+                ],
+                "synonyms": "refresh, reload, update, re-query, search",
+                "tier": "domain"
+              },
+              {
+                "description": "Triggers a pick-list refresh based on current filter criteria.",
+                "id": "evt_01M11H7B3J0W8ESAJ5VJPWPDWE",
+                "key": "REFETCH_FILTER",
+                "name": "Refetch Filter",
+                "payloadSchema": [
+                  {
+                    "name": "field",
+                    "required": true,
+                    "type": "string"
+                  },
+                  {
+                    "name": "value",
+                    "required": true,
+                    "type": "string"
+                  }
+                ],
+                "synonyms": "refresh, filter, update, reload",
+                "tier": "domain"
+              },
+              {
+                "description": "Triggers a pick-list page refresh.",
+                "id": "evt_01M11H7B3JKPSJZP3X1HY8R9F1",
+                "key": "REFETCH_PAGE",
+                "name": "Refetch Page",
+                "payloadSchema": [
+                  {
+                    "name": "page",
+                    "required": true,
+                    "type": "number"
+                  }
+                ],
+                "synonyms": "reload, refresh, update, paginate",
+                "tier": "domain"
+              },
               {
                 "description": "Indicates an item has been chosen.",
                 "id": "evt_01KXG04HJXZE6B9HHPC6JT0FEW",
@@ -388,6 +543,59 @@
                           "gap": "sm",
                           "type": "stack"
                         },
+                        [
+                          "if",
+                          "@config.bodySearch",
+                          {
+                            "children": [
+                              {
+                                "className": "w-full max-w-md",
+                                "clearable": true,
+                                "event": "REFETCH_QUERY",
+                                "placeholder": "@config.searchPlaceholder",
+                                "type": "search-input"
+                              }
+                            ],
+                            "direction": "horizontal",
+                            "gap": "sm",
+                            "type": "stack"
+                          },
+                          {
+                            "children": [],
+                            "gap": "none",
+                            "type": "stack"
+                          }
+                        ],
+                        [
+                          "if",
+                          [
+                            ">",
+                            [
+                              "array/len",
+                              "@config.filters"
+                            ],
+                            0.0
+                          ],
+                          {
+                            "children": [
+                              {
+                                "entity": "SelectableItem",
+                                "event": "REFETCH_FILTER",
+                                "filters": "@config.filters",
+                                "look": "@config.filterBarLook",
+                                "type": "filter-group"
+                              }
+                            ],
+                            "direction": "horizontal",
+                            "gap": "sm",
+                            "type": "stack"
+                          },
+                          {
+                            "children": [],
+                            "gap": "none",
+                            "type": "stack"
+                          }
+                        ],
                         {
                           "type": "divider"
                         },
@@ -409,6 +617,7 @@
                             }
                           ],
                           "look": "@config.tableLook",
+                          "pageSize": "@config.displayPageSize",
                           "renderItem": [
                             "fn",
                             "item",
@@ -483,6 +692,233 @@
                 "from": "loading",
                 "to": "error"
               },
+              {
+                "effects": [
+                  [
+                    "fetch",
+                    "SelectableItem",
+                    {
+                      "emit": {
+                        "failure": "SelectableItemLoadFailed",
+                        "success": "SelectableItemLoaded"
+                      },
+                      "filter": [
+                        "or",
+                        [
+                          "=",
+                          "@payload.searchTerm",
+                          ""
+                        ],
+                        [
+                          "str/includes",
+                          [
+                            "object/get",
+                            "@entity",
+                            "name"
+                          ],
+                          "@payload.searchTerm"
+                        ]
+                      ]
+                    }
+                  ]
+                ],
+                "event": "REFETCH_QUERY",
+                "eventId": "evt_01M11H7B3J1A0DSR6SHK7EXBRH",
+                "from": "idle",
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "fetch",
+                    "SelectableItem",
+                    {
+                      "emit": {
+                        "failure": "SelectableItemLoadFailed",
+                        "success": "SelectableItemLoaded"
+                      },
+                      "filter": [
+                        "or",
+                        [
+                          "=",
+                          "@payload.value",
+                          ""
+                        ],
+                        [
+                          "=",
+                          [
+                            "object/get",
+                            "@entity",
+                            "@payload.field"
+                          ],
+                          "@payload.value"
+                        ]
+                      ]
+                    }
+                  ]
+                ],
+                "event": "REFETCH_FILTER",
+                "eventId": "evt_01M11H7B3J0W8ESAJ5VJPWPDWE",
+                "from": "idle",
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "fetch",
+                    "SelectableItem",
+                    {
+                      "emit": {
+                        "failure": "SelectableItemLoadFailed",
+                        "success": "SelectableItemLoaded"
+                      },
+                      "limit": "@config.pageSize",
+                      "offset": [
+                        "*",
+                        [
+                          "-",
+                          "@payload.page",
+                          1.0
+                        ],
+                        "@config.pageSize"
+                      ]
+                    }
+                  ]
+                ],
+                "event": "REFETCH_PAGE",
+                "eventId": "evt_01M11H7B3JKPSJZP3X1HY8R9F1",
+                "from": "idle",
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "children": [
+                        {
+                          "align": "center",
+                          "children": [
+                            {
+                              "name": "check-square",
+                              "type": "icon"
+                            },
+                            {
+                              "content": "SelectableItems",
+                              "type": "typography",
+                              "variant": "h2"
+                            }
+                          ],
+                          "direction": "horizontal",
+                          "gap": "sm",
+                          "type": "stack"
+                        },
+                        [
+                          "if",
+                          "@config.bodySearch",
+                          {
+                            "children": [
+                              {
+                                "className": "w-full max-w-md",
+                                "clearable": true,
+                                "event": "REFETCH_QUERY",
+                                "placeholder": "@config.searchPlaceholder",
+                                "type": "search-input"
+                              }
+                            ],
+                            "direction": "horizontal",
+                            "gap": "sm",
+                            "type": "stack"
+                          },
+                          {
+                            "children": [],
+                            "gap": "none",
+                            "type": "stack"
+                          }
+                        ],
+                        [
+                          "if",
+                          [
+                            ">",
+                            [
+                              "array/len",
+                              "@config.filters"
+                            ],
+                            0.0
+                          ],
+                          {
+                            "children": [
+                              {
+                                "entity": "SelectableItem",
+                                "event": "REFETCH_FILTER",
+                                "filters": "@config.filters",
+                                "look": "@config.filterBarLook",
+                                "type": "filter-group"
+                              }
+                            ],
+                            "direction": "horizontal",
+                            "gap": "sm",
+                            "type": "stack"
+                          },
+                          {
+                            "children": [],
+                            "gap": "none",
+                            "type": "stack"
+                          }
+                        ],
+                        {
+                          "type": "divider"
+                        },
+                        {
+                          "color": "muted",
+                          "content": "Choose a selectableitem to continue.",
+                          "type": "typography",
+                          "variant": "caption"
+                        },
+                        {
+                          "className": "transition-shadow hover:shadow-md cursor-pointer",
+                          "entity": "@payload.data",
+                          "fields": [],
+                          "itemActions": [
+                            {
+                              "event": "SELECT",
+                              "icon": "check",
+                              "label": "Select"
+                            }
+                          ],
+                          "look": "@config.tableLook",
+                          "pageSize": "@config.displayPageSize",
+                          "renderItem": [
+                            "fn",
+                            "item",
+                            {
+                              "align": "center",
+                              "children": [
+                                {
+                                  "label": "@item.name",
+                                  "type": "checkbox"
+                                }
+                              ],
+                              "direction": "horizontal",
+                              "gap": "sm",
+                              "type": "stack"
+                            }
+                          ],
+                          "type": "data-grid"
+                        }
+                      ],
+                      "direction": "vertical",
+                      "gap": "lg",
+                      "type": "stack"
+                    }
+                  ]
+                ],
+                "event": "SelectableItemLoaded",
+                "eventId": "evt_01KXG04HJX5R9HCFT8K1N30HFV",
+                "from": "idle",
+                "to": "idle"
+              },
               {
                 "effects": [
                   [