@almadar/std 16.21.2 → 16.21.4

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

@@ -0,0 +1,382 @@
+{
+  "name": "std-autocomplete",
+  "version": "1.0.0",
+  "description": "std-autocomplete — reusable inline typeahead: as the user types (AUTO_QUERY), fetches the linked entity filtered by @config.searchField and shows a compact suggestions list; picking one emits AUTO_SELECTED { id } for the consumer to open the record or fill a field. Rebind to any entity; configure searchField + the label field shown per suggestion.",
+  "orbitals": [
+    {
+      "name": "AutocompleteOrbital",
+      "entity": {
+        "name": "AutoTarget",
+        "persistence": "runtime",
+        "fields": [
+          {
+            "name": "id",
+            "type": "string",
+            "required": true
+          },
+          {
+            "name": "name",
+            "type": "string",
+            "description": "The primary label matched + shown per suggestion.",
+            "synonyms": "title, label, productName"
+          },
+          {
+            "name": "searchTerm",
+            "type": "string",
+            "default": "",
+            "intrinsic": true,
+            "description": "The current typed query.",
+            "synonyms": "query, term, q"
+          }
+        ]
+      },
+      "traits": [
+        {
+          "name": "Autocomplete",
+          "entityRebindable": true,
+          "entityContract": {
+            "requires": [],
+            "provides": [
+              "searchTerm"
+            ]
+          },
+          "category": "interaction",
+          "linkedEntity": "AutoTarget",
+          "emits": [
+            {
+              "event": "AutoLoaded",
+              "description": "Suggestion matches loaded",
+              "scope": "internal",
+              "payloadSchema": [
+                {
+                  "name": "data",
+                  "type": "[AutoTarget]"
+                }
+              ]
+            },
+            {
+              "event": "AutoFailed",
+              "description": "Suggestion fetch failed",
+              "scope": "internal",
+              "payloadSchema": [
+                {
+                  "name": "error",
+                  "type": "string"
+                }
+              ]
+            },
+            {
+              "event": "AUTO_SELECTED",
+              "description": "A suggestion was picked; carries the chosen record id for the consumer to open or bind.",
+              "synonyms": "select, choose, pick",
+              "tier": "essential",
+              "scope": "external",
+              "payloadSchema": [
+                {
+                  "name": "id",
+                  "type": "string",
+                  "required": true
+                }
+              ]
+            }
+          ],
+          "stateMachine": {
+            "states": [
+              {
+                "name": "idle",
+                "isInitial": true
+              }
+            ],
+            "events": [
+              {
+                "key": "INIT",
+                "name": "Initialize"
+              },
+              {
+                "key": "AUTO_QUERY",
+                "name": "Auto Query",
+                "description": "The user typed/submitted a query in the typeahead input.",
+                "synonyms": "type, query, search",
+                "tier": "essential",
+                "payloadSchema": [
+                  {
+                    "name": "value",
+                    "type": "string"
+                  }
+                ]
+              },
+              {
+                "key": "AutoLoaded",
+                "name": "Auto loaded",
+                "payloadSchema": [
+                  {
+                    "name": "data",
+                    "type": "[AutoTarget]"
+                  }
+                ]
+              },
+              {
+                "key": "AUTO_SELECT",
+                "name": "Auto Select",
+                "description": "The user clicked a suggestion.",
+                "synonyms": "pick, choose, open",
+                "tier": "essential",
+                "payloadSchema": [
+                  {
+                    "name": "id",
+                    "type": "string",
+                    "required": true
+                  }
+                ]
+              },
+              {
+                "key": "AutoFailed",
+                "name": "Auto failed",
+                "payloadSchema": [
+                  {
+                    "name": "error",
+                    "type": "string"
+                  }
+                ]
+              },
+              {
+                "key": "AUTO_SELECTED",
+                "name": "Auto Selected",
+                "description": "A suggestion was picked; carries the chosen record id for the consumer to open or bind.",
+                "synonyms": "select, choose, pick",
+                "tier": "essential"
+              }
+            ],
+            "transitions": [
+              {
+                "from": "idle",
+                "to": "idle",
+                "event": "INIT",
+                "effects": [
+                  [
+                    "fetch",
+                    "AutoTarget",
+                    {}
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "event": "AUTO_QUERY",
+                      "placeholder": "@config.placeholder",
+                      "type": "search-input",
+                      "query": "@entity.searchTerm"
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "idle",
+                "to": "idle",
+                "event": "AUTO_QUERY",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.searchTerm",
+                    "@payload.value"
+                  ],
+                  [
+                    "fetch",
+                    "AutoTarget",
+                    {
+                      "filter": [
+                        "or",
+                        [
+                          "=",
+                          "@payload.value",
+                          ""
+                        ],
+                        [
+                          "str/includes",
+                          [
+                            "object/get",
+                            "@entity",
+                            "@config.searchField"
+                          ],
+                          "@payload.value"
+                        ]
+                      ],
+                      "emit": {
+                        "success": "AutoLoaded",
+                        "failure": "AutoFailed"
+                      }
+                    }
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "gap": "xs",
+                      "direction": "vertical",
+                      "children": [
+                        {
+                          "type": "search-input",
+                          "event": "AUTO_QUERY",
+                          "query": "@entity.searchTerm",
+                          "placeholder": "@config.placeholder"
+                        },
+                        {
+                          "type": "spinner",
+                          "size": "sm"
+                        }
+                      ],
+                      "type": "stack"
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "idle",
+                "to": "idle",
+                "event": "AutoLoaded",
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "children": [
+                        {
+                          "event": "AUTO_QUERY",
+                          "query": "@entity.searchTerm",
+                          "type": "search-input",
+                          "placeholder": "@config.placeholder"
+                        },
+                        {
+                          "entity": "@payload.data",
+                          "fields": "@config.suggestionFields",
+                          "type": "data-list",
+                          "itemActions": [
+                            {
+                              "variant": "ghost",
+                              "label": "Open",
+                              "event": "AUTO_SELECT"
+                            }
+                          ]
+                        }
+                      ],
+                      "gap": "xs",
+                      "direction": "vertical",
+                      "type": "stack"
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "idle",
+                "to": "idle",
+                "event": "AUTO_SELECT",
+                "effects": [
+                  [
+                    "emit",
+                    "AUTO_SELECTED",
+                    {
+                      "id": "@payload.id"
+                    }
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "event": "AUTO_QUERY",
+                      "placeholder": "@config.placeholder",
+                      "query": "@entity.searchTerm",
+                      "type": "search-input"
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "idle",
+                "to": "idle",
+                "event": "AutoFailed",
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "query": "@entity.searchTerm",
+                      "type": "search-input",
+                      "placeholder": "@config.placeholder",
+                      "event": "AUTO_QUERY"
+                    }
+                  ]
+                ]
+              }
+            ]
+          },
+          "config": {
+            "searchField": {
+              "type": "string",
+              "default": "name",
+              "label": "Search field",
+              "description": "Entity field matched against the typed query (case-insensitive substring).",
+              "tier": "presentation"
+            },
+            "placeholder": {
+              "type": "string",
+              "default": "Search…",
+              "label": "Placeholder",
+              "description": "Hint text in the empty typeahead input.",
+              "tier": "presentation"
+            },
+            "suggestionFields": {
+              "type": "[AutoSuggestSpec]",
+              "default": [
+                {
+                  "label": "Name",
+                  "name": "name",
+                  "variant": "body"
+                }
+              ],
+              "label": "Suggestion fields",
+              "description": "Fields shown per suggestion row.",
+              "tier": "presentation",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "label": {
+                    "name": "label",
+                    "type": "string",
+                    "required": false
+                  },
+                  "variant": {
+                    "name": "variant",
+                    "type": "string",
+                    "required": false
+                  },
+                  "icon": {
+                    "name": "icon",
+                    "type": "string",
+                    "required": false
+                  },
+                  "name": {
+                    "name": "name",
+                    "type": "string",
+                    "required": true
+                  }
+                }
+              }
+            }
+          },
+          "scope": "collection"
+        }
+      ],
+      "pages": [
+        {
+          "name": "AutocompletePage",
+          "path": "/autocomplete",
+          "traits": [
+            {
+              "ref": "Autocomplete"
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}

package/behaviors/registry/core/atoms/std-event-log.orb

@@ -232,6 +232,21 @@
           "name": "EventLogTimeline",
           "category": "interaction",
           "linkedEntity": "EventLogView",
+          "entityRebindable": true,
+          "entityContract": {
+            "requires": [],
+            "provides": [
+              "allEntries",
+              "backfillDate",
+              "backfillDescription",
+              "backfillKind",
+              "backfillTitle",
+              "entries",
+              "errorMessage",
+              "filterChips",
+              "filterKind"
+            ]
+          },
           "emits": [
             {
               "event": "APPLY_FILTER",

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

@@ -33,6 +33,14 @@
           "name": "FilterTargetFilter",
           "category": "interaction",
           "linkedEntity": "FilterTarget",
+          "entityRebindable": true,
+          "entityContract": {
+            "requires": [],
+            "provides": [
+              "field",
+              "value"
+            ]
+          },
           "emits": [
             {
               "event": "FILTER",

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

@@ -27,6 +27,13 @@
           "name": "PushSubscriberIndicator",
           "category": "interaction",
           "linkedEntity": "PushSubscriber",
+          "entityRebindable": true,
+          "entityContract": {
+            "requires": [],
+            "provides": [
+              "status"
+            ]
+          },
           "emits": [
             {
               "event": "PUSH_RECEIVED",

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

@@ -186,6 +186,23 @@
           "name": "RecurrenceEditor",
           "category": "interaction",
           "linkedEntity": "RecurrenceView",
+          "entityRebindable": true,
+          "entityContract": {
+            "requires": [],
+            "provides": [
+              "currentOccurrenceDate",
+              "currentOccurrenceId",
+              "currentOccurrenceLabel",
+              "endAfterCount",
+              "endDate",
+              "errorMessage",
+              "frequency",
+              "interval",
+              "occurrences",
+              "rescheduleDate",
+              "startDate"
+            ]
+          },
           "emits": [
             {
               "event": "EDIT_RULE",

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

@@ -27,6 +27,13 @@
           "name": "SearchResultSearch",
           "category": "interaction",
           "linkedEntity": "SearchResult",
+          "entityRebindable": true,
+          "entityContract": {
+            "requires": [],
+            "provides": [
+              "searchTerm"
+            ]
+          },
           "emits": [
             {
               "event": "SEARCH",

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

@@ -191,6 +191,26 @@
           "name": "WizardForm",
           "category": "interaction",
           "linkedEntity": "WizardView",
+          "entityRebindable": true,
+          "entityContract": {
+            "requires": [],
+            "provides": [
+              "cancelReason",
+              "completionMessage",
+              "currentFields",
+              "currentStepDescription",
+              "currentStepIcon",
+              "currentStepIndex",
+              "currentStepLabel",
+              "errorMessage",
+              "isFirstStep",
+              "isLastStep",
+              "primaryActionIcon",
+              "primaryActionLabel",
+              "totalSteps",
+              "wizardSteps"
+            ]
+          },
           "emits": [
             {
               "event": "ADVANCE",