@almadar/std 1.0.0 → 1.0.1

package/dist/behaviors/data-management.js

@@ -1,486 +1,505 @@
 // behaviors/data-management.ts
 var PAGINATION_BEHAVIOR = {
-  name: "std/Pagination",
-  category: "data-management",
+  name: "std-pagination",
+  version: "1.0.0",
   description: "Page-based navigation for large data sets",
-  suggestedFor: [
-    "Large lists",
-    "Table pagination",
-    "Infinite scroll alternative",
-    "Data-heavy views"
-  ],
-  dataEntities: [
+  orbitals: [
     {
-      name: "PaginationState",
-      runtime: true,
-      singleton: true,
-      fields: [
-        { name: "page", type: "number", default: 1 },
-        { name: "pageSize", type: "number", default: 20 },
-        { name: "totalItems", type: "number", default: 0 }
-      ]
-    }
-  ],
-  stateMachine: {
-    initial: "Active",
-    states: [
-      { name: "Active", isInitial: true }
-    ],
-    events: [
-      { key: "INIT" },
-      { key: "NEXT_PAGE" },
-      { key: "PREV_PAGE" },
-      { key: "GO_TO_PAGE" },
-      { key: "SET_PAGE_SIZE" }
-    ],
-    transitions: [
-      {
-        from: "*",
-        event: "INIT",
-        effects: [
-          ["set", "@entity.page", 1],
-          ["set", "@entity.pageSize", "@config.defaultPageSize"]
-        ]
-      },
-      {
-        event: "NEXT_PAGE",
-        guard: ["<", "@entity.page", ["math/ceil", ["/", "@entity.totalItems", "@entity.pageSize"]]],
-        effects: [
-          ["set", "@entity.page", ["+", "@entity.page", 1]]
-        ]
-      },
-      {
-        event: "PREV_PAGE",
-        guard: [">", "@entity.page", 1],
-        effects: [
-          ["set", "@entity.page", ["-", "@entity.page", 1]]
+      name: "PaginationOrbital",
+      entity: {
+        name: "PaginationState",
+        persistence: "runtime",
+        fields: [
+          { name: "id", type: "string", required: true },
+          { name: "page", type: "number", default: 1 },
+          { name: "pageSize", type: "number", default: 20 },
+          { name: "totalItems", type: "number", default: 0 },
+          { name: "defaultPageSize", type: "number", default: 20 }
         ]
       },
-      {
-        event: "GO_TO_PAGE",
-        guard: [
-          "and",
-          [">=", "@payload.page", 1],
-          ["<=", "@payload.page", ["math/ceil", ["/", "@entity.totalItems", "@entity.pageSize"]]]
-        ],
-        effects: [
-          ["set", "@entity.page", "@payload.page"]
-        ]
-      },
-      {
-        event: "SET_PAGE_SIZE",
-        effects: [
-          ["set", "@entity.pageSize", "@payload.size"],
-          ["set", "@entity.page", 1]
-        ]
-      }
-    ]
-  },
-  configSchema: {
-    required: [],
-    optional: [
-      { name: "defaultPageSize", type: "number", description: "Default items per page", default: 20 },
-      { name: "pageSizeOptions", type: "array", description: "Available page sizes", default: [10, 20, 50, 100] }
-    ]
-  }
+      traits: [
+        {
+          name: "Pagination",
+          linkedEntity: "PaginationState",
+          category: "interaction",
+          stateMachine: {
+            states: [{ name: "Active", isInitial: true }],
+            events: [
+              { key: "INIT", name: "Initialize" },
+              { key: "NEXT_PAGE", name: "Next Page" },
+              { key: "PREV_PAGE", name: "Previous Page" },
+              { key: "GO_TO_PAGE", name: "Go to Page" },
+              { key: "SET_PAGE_SIZE", name: "Set Page Size" }
+            ],
+            transitions: [
+              {
+                from: "Active",
+                to: "Active",
+                event: "INIT",
+                effects: [
+                  ["set", "@entity.page", 1],
+                  ["set", "@entity.pageSize", "@entity.defaultPageSize"]
+                ]
+              },
+              {
+                from: "Active",
+                to: "Active",
+                event: "NEXT_PAGE",
+                guard: ["<", "@entity.page", ["math/ceil", ["/", "@entity.totalItems", "@entity.pageSize"]]],
+                effects: [["set", "@entity.page", ["+", "@entity.page", 1]]]
+              },
+              {
+                from: "Active",
+                to: "Active",
+                event: "PREV_PAGE",
+                guard: [">", "@entity.page", 1],
+                effects: [["set", "@entity.page", ["-", "@entity.page", 1]]]
+              },
+              {
+                from: "Active",
+                to: "Active",
+                event: "GO_TO_PAGE",
+                guard: [
+                  "and",
+                  [">=", "@payload.page", 1],
+                  ["<=", "@payload.page", ["math/ceil", ["/", "@entity.totalItems", "@entity.pageSize"]]]
+                ],
+                effects: [["set", "@entity.page", "@payload.page"]]
+              },
+              {
+                from: "Active",
+                to: "Active",
+                event: "SET_PAGE_SIZE",
+                effects: [
+                  ["set", "@entity.pageSize", "@payload.size"],
+                  ["set", "@entity.page", 1]
+                ]
+              }
+            ]
+          }
+        }
+      ],
+      pages: []
+    }
+  ]
 };
 var SELECTION_BEHAVIOR = {
-  name: "std/Selection",
-  category: "data-management",
+  name: "std-selection",
+  version: "1.0.0",
   description: "Single or multi-selection management",
-  suggestedFor: [
-    "Multi-select lists",
-    "Bulk operations",
-    "Item picking",
-    "Checkboxes in tables"
-  ],
-  dataEntities: [
+  orbitals: [
     {
-      name: "SelectionState",
-      runtime: true,
-      singleton: true,
-      fields: [
-        { name: "selected", type: "array", default: [] },
-        { name: "lastSelected", type: "string", default: null }
-      ]
-    }
-  ],
-  stateMachine: {
-    initial: "Active",
-    states: [
-      { name: "Active", isInitial: true }
-    ],
-    events: [
-      { key: "INIT" },
-      { key: "SELECT" },
-      { key: "DESELECT" },
-      { key: "TOGGLE" },
-      { key: "SELECT_ALL" },
-      { key: "CLEAR" }
-    ],
-    transitions: [
-      {
-        from: "*",
-        event: "INIT",
-        effects: [
-          ["set", "@entity.selected", []],
-          ["set", "@entity.lastSelected", null]
+      name: "SelectionOrbital",
+      entity: {
+        name: "SelectionState",
+        persistence: "runtime",
+        fields: [
+          { name: "id", type: "string", required: true },
+          { name: "selected", type: "array", default: [] },
+          { name: "lastSelected", type: "string", default: null },
+          { name: "mode", type: "string", default: "multi" },
+          { name: "maxSelection", type: "number", default: null }
         ]
       },
-      {
-        event: "SELECT",
-        effects: [
-          [
-            "if",
-            ["=", "@config.mode", "single"],
-            [
-              "do",
-              ["set", "@entity.selected", ["@payload.id"]],
-              ["set", "@entity.lastSelected", "@payload.id"]
+      traits: [
+        {
+          name: "Selection",
+          linkedEntity: "SelectionState",
+          category: "interaction",
+          stateMachine: {
+            states: [{ name: "Active", isInitial: true }],
+            events: [
+              { key: "INIT", name: "Initialize" },
+              { key: "SELECT", name: "Select" },
+              { key: "DESELECT", name: "Deselect" },
+              { key: "TOGGLE", name: "Toggle" },
+              { key: "SELECT_ALL", name: "Select All" },
+              { key: "CLEAR", name: "Clear" }
             ],
-            [
-              "if",
-              [
-                "or",
-                ["not", "@config.maxSelection"],
-                ["<", ["array/len", "@entity.selected"], "@config.maxSelection"]
-              ],
-              [
-                "do",
-                ["set", "@entity.selected", ["array/append", "@entity.selected", "@payload.id"]],
-                ["set", "@entity.lastSelected", "@payload.id"]
-              ],
-              ["notify", { type: "warning", message: "Maximum selection reached" }]
-            ]
-          ]
-        ]
-      },
-      {
-        event: "DESELECT",
-        effects: [
-          ["set", "@entity.selected", ["array/filter", "@entity.selected", ["fn", "id", ["!=", "@id", "@payload.id"]]]]
-        ]
-      },
-      {
-        event: "TOGGLE",
-        effects: [
-          [
-            "if",
-            ["array/includes", "@entity.selected", "@payload.id"],
-            ["set", "@entity.selected", ["array/filter", "@entity.selected", ["fn", "id", ["!=", "@id", "@payload.id"]]]],
-            [
-              "if",
-              ["or", ["=", "@config.mode", "single"], [
-                "or",
-                ["not", "@config.maxSelection"],
-                ["<", ["array/len", "@entity.selected"], "@config.maxSelection"]
-              ]],
-              [
-                "set",
-                "@entity.selected",
-                [
-                  "if",
-                  ["=", "@config.mode", "single"],
-                  ["@payload.id"],
-                  ["array/append", "@entity.selected", "@payload.id"]
+            transitions: [
+              {
+                from: "Active",
+                to: "Active",
+                event: "INIT",
+                effects: [
+                  ["set", "@entity.selected", []],
+                  ["set", "@entity.lastSelected", null]
+                ]
+              },
+              {
+                from: "Active",
+                to: "Active",
+                event: "SELECT",
+                effects: [
+                  [
+                    "if",
+                    ["=", "@entity.mode", "single"],
+                    [
+                      "do",
+                      ["set", "@entity.selected", ["@payload.id"]],
+                      ["set", "@entity.lastSelected", "@payload.id"]
+                    ],
+                    [
+                      "if",
+                      [
+                        "or",
+                        ["not", "@entity.maxSelection"],
+                        ["<", ["array/len", "@entity.selected"], "@entity.maxSelection"]
+                      ],
+                      [
+                        "do",
+                        ["set", "@entity.selected", ["array/append", "@entity.selected", "@payload.id"]],
+                        ["set", "@entity.lastSelected", "@payload.id"]
+                      ],
+                      ["notify", "in_app", "Maximum selection reached"]
+                    ]
+                  ]
+                ]
+              },
+              {
+                from: "Active",
+                to: "Active",
+                event: "DESELECT",
+                effects: [
+                  ["set", "@entity.selected", ["array/filter", "@entity.selected", ["fn", "id", ["!=", "@id", "@payload.id"]]]]
+                ]
+              },
+              {
+                from: "Active",
+                to: "Active",
+                event: "TOGGLE",
+                effects: [
+                  [
+                    "if",
+                    ["array/includes", "@entity.selected", "@payload.id"],
+                    ["set", "@entity.selected", ["array/filter", "@entity.selected", ["fn", "id", ["!=", "@id", "@payload.id"]]]],
+                    [
+                      "if",
+                      ["or", ["=", "@entity.mode", "single"], [
+                        "or",
+                        ["not", "@entity.maxSelection"],
+                        ["<", ["array/len", "@entity.selected"], "@entity.maxSelection"]
+                      ]],
+                      [
+                        "set",
+                        "@entity.selected",
+                        [
+                          "if",
+                          ["=", "@entity.mode", "single"],
+                          ["@payload.id"],
+                          ["array/append", "@entity.selected", "@payload.id"]
+                        ]
+                      ],
+                      ["notify", "in_app", "Maximum selection reached"]
+                    ]
+                  ]
+                ]
+              },
+              {
+                from: "Active",
+                to: "Active",
+                event: "SELECT_ALL",
+                guard: ["=", "@entity.mode", "multi"],
+                effects: [["set", "@entity.selected", "@payload.ids"]]
+              },
+              {
+                from: "Active",
+                to: "Active",
+                event: "CLEAR",
+                effects: [
+                  ["set", "@entity.selected", []],
+                  ["set", "@entity.lastSelected", null]
                 ]
-              ],
-              ["notify", { type: "warning", message: "Maximum selection reached" }]
+              }
             ]
-          ]
-        ]
-      },
-      {
-        event: "SELECT_ALL",
-        guard: ["=", "@config.mode", "multi"],
-        effects: [
-          ["set", "@entity.selected", "@payload.ids"]
-        ]
-      },
-      {
-        event: "CLEAR",
-        effects: [
-          ["set", "@entity.selected", []],
-          ["set", "@entity.lastSelected", null]
-        ]
-      }
-    ]
-  },
-  configSchema: {
-    required: [],
-    optional: [
-      { name: "mode", type: "string", description: "Selection mode", default: "single", enum: ["single", "multi"] },
-      { name: "maxSelection", type: "number", description: "Maximum selections (multi mode)", default: null }
-    ]
-  }
+          }
+        }
+      ],
+      pages: []
+    }
+  ]
 };
 var SORT_BEHAVIOR = {
-  name: "std/Sort",
-  category: "data-management",
+  name: "std-sort",
+  version: "1.0.0",
   description: "Sorting by field with direction toggle",
-  suggestedFor: [
-    "Sortable tables",
-    "List ordering",
-    "Column headers"
-  ],
-  dataEntities: [
+  orbitals: [
     {
-      name: "SortState",
-      runtime: true,
-      singleton: true,
-      fields: [
-        { name: "sortField", type: "string", default: null },
-        { name: "sortDirection", type: "string", default: "asc" }
-      ]
-    }
-  ],
-  stateMachine: {
-    initial: "Active",
-    states: [
-      { name: "Active", isInitial: true }
-    ],
-    events: [
-      { key: "INIT" },
-      { key: "SORT" },
-      { key: "TOGGLE_DIRECTION" },
-      { key: "CLEAR_SORT" }
-    ],
-    transitions: [
-      {
-        from: "*",
-        event: "INIT",
-        effects: [
-          ["set", "@entity.sortField", "@config.defaultField"],
-          ["set", "@entity.sortDirection", "@config.defaultDirection"]
+      name: "SortOrbital",
+      entity: {
+        name: "SortState",
+        persistence: "runtime",
+        fields: [
+          { name: "id", type: "string", required: true },
+          { name: "sortField", type: "string", default: null },
+          { name: "sortDirection", type: "string", default: "asc" },
+          { name: "defaultField", type: "string", default: null },
+          { name: "defaultDirection", type: "string", default: "asc" }
         ]
       },
-      {
-        event: "SORT",
-        effects: [
-          [
-            "if",
-            ["=", "@entity.sortField", "@payload.field"],
-            ["set", "@entity.sortDirection", ["if", ["=", "@entity.sortDirection", "asc"], "desc", "asc"]],
-            [
-              "do",
-              ["set", "@entity.sortField", "@payload.field"],
-              ["set", "@entity.sortDirection", "asc"]
+      traits: [
+        {
+          name: "Sort",
+          linkedEntity: "SortState",
+          category: "interaction",
+          stateMachine: {
+            states: [{ name: "Active", isInitial: true }],
+            events: [
+              { key: "INIT", name: "Initialize" },
+              { key: "SORT", name: "Sort" },
+              { key: "TOGGLE_DIRECTION", name: "Toggle Direction" },
+              { key: "CLEAR_SORT", name: "Clear Sort" }
+            ],
+            transitions: [
+              {
+                from: "Active",
+                to: "Active",
+                event: "INIT",
+                effects: [
+                  ["set", "@entity.sortField", "@entity.defaultField"],
+                  ["set", "@entity.sortDirection", "@entity.defaultDirection"]
+                ]
+              },
+              {
+                from: "Active",
+                to: "Active",
+                event: "SORT",
+                effects: [
+                  [
+                    "if",
+                    ["=", "@entity.sortField", "@payload.field"],
+                    ["set", "@entity.sortDirection", ["if", ["=", "@entity.sortDirection", "asc"], "desc", "asc"]],
+                    [
+                      "do",
+                      ["set", "@entity.sortField", "@payload.field"],
+                      ["set", "@entity.sortDirection", "asc"]
+                    ]
+                  ]
+                ]
+              },
+              {
+                from: "Active",
+                to: "Active",
+                event: "TOGGLE_DIRECTION",
+                guard: ["!=", "@entity.sortField", null],
+                effects: [
+                  ["set", "@entity.sortDirection", ["if", ["=", "@entity.sortDirection", "asc"], "desc", "asc"]]
+                ]
+              },
+              {
+                from: "Active",
+                to: "Active",
+                event: "CLEAR_SORT",
+                effects: [
+                  ["set", "@entity.sortField", null],
+                  ["set", "@entity.sortDirection", "asc"]
+                ]
+              }
             ]
-          ]
-        ]
-      },
-      {
-        event: "TOGGLE_DIRECTION",
-        guard: ["!=", "@entity.sortField", null],
-        effects: [
-          ["set", "@entity.sortDirection", ["if", ["=", "@entity.sortDirection", "asc"], "desc", "asc"]]
-        ]
-      },
-      {
-        event: "CLEAR_SORT",
-        effects: [
-          ["set", "@entity.sortField", null],
-          ["set", "@entity.sortDirection", "asc"]
-        ]
-      }
-    ]
-  },
-  configSchema: {
-    required: [],
-    optional: [
-      { name: "defaultField", type: "string", description: "Default sort field" },
-      { name: "defaultDirection", type: "string", description: "Default direction", default: "asc", enum: ["asc", "desc"] }
-    ]
-  }
+          }
+        }
+      ],
+      pages: []
+    }
+  ]
 };
 var FILTER_BEHAVIOR = {
-  name: "std/Filter",
-  category: "data-management",
+  name: "std-filter",
+  version: "1.0.0",
   description: "Query Singleton pattern for explicit filtering - use with entity-table query prop",
-  suggestedFor: [
-    "Filterable lists",
-    "Advanced search",
-    "Filter panels",
-    "Faceted search",
-    "Entity tables with filters"
-  ],
-  dataEntities: [
+  orbitals: [
     {
-      name: "QueryState",
-      runtime: true,
-      singleton: true,
-      fields: [
-        { name: "status", type: "string", default: null, description: "Filter by status field" },
-        { name: "priority", type: "string", default: null, description: "Filter by priority field" },
-        { name: "search", type: "string", default: "", description: "Search term" },
-        { name: "sortBy", type: "string", default: "createdAt", description: "Sort field" },
-        { name: "sortOrder", type: "string", default: "desc", description: "Sort direction: asc or desc" }
-      ]
-    }
-  ],
-  stateMachine: {
-    initial: "Active",
-    states: [
-      { name: "Active", isInitial: true }
-    ],
-    events: [
-      { key: "INIT" },
-      { key: "FILTER" },
-      { key: "SEARCH" },
-      { key: "SORT" },
-      { key: "CLEAR_FILTERS" }
-    ],
-    transitions: [
-      {
-        from: "*",
-        event: "INIT",
-        effects: [
-          // Render filter UI with query reference
-          ["render-ui", "sidebar", {
-            type: "filter-group",
-            query: "@QueryState",
-            filters: "@config.filters"
-          }],
-          // Render entity table with query reference
-          ["render-ui", "main", {
-            type: "entity-table",
-            entity: "@config.entity",
-            query: "@QueryState",
-            columns: "@config.columns"
-          }]
-        ]
-      },
-      {
-        event: "FILTER",
-        effects: [
-          ["set", "@QueryState.status", "@payload.status"],
-          ["set", "@QueryState.priority", "@payload.priority"]
-        ]
-      },
-      {
-        event: "SEARCH",
-        effects: [
-          ["set", "@QueryState.search", "@payload.searchTerm"]
-        ]
-      },
-      {
-        event: "SORT",
-        effects: [
-          ["set", "@QueryState.sortBy", "@payload.field"],
-          ["set", "@QueryState.sortOrder", "@payload.order"]
+      name: "FilterOrbital",
+      entity: {
+        name: "QueryState",
+        persistence: "runtime",
+        fields: [
+          { name: "id", type: "string", required: true },
+          { name: "status", type: "string", default: null },
+          { name: "priority", type: "string", default: null },
+          { name: "search", type: "string", default: "" },
+          { name: "sortBy", type: "string", default: "createdAt" },
+          { name: "sortOrder", type: "string", default: "desc" },
+          { name: "entityType", type: "string", default: "" },
+          { name: "filters", type: "array", default: [] },
+          { name: "columns", type: "array", default: [] }
         ]
       },
-      {
-        event: "CLEAR_FILTERS",
-        effects: [
-          ["set", "@QueryState.status", null],
-          ["set", "@QueryState.priority", null],
-          ["set", "@QueryState.search", ""]
-        ]
-      }
-    ]
-  },
-  configSchema: {
-    required: [
-      { name: "entity", type: "string", description: "Entity to filter" }
-    ],
-    optional: [
-      { name: "filters", type: "array", description: "Filter field definitions", default: [] },
-      { name: "columns", type: "array", description: "Table columns to display", default: [] }
-    ]
-  }
+      traits: [
+        {
+          name: "Filter",
+          linkedEntity: "QueryState",
+          category: "interaction",
+          stateMachine: {
+            states: [{ name: "Active", isInitial: true }],
+            events: [
+              { key: "INIT", name: "Initialize" },
+              { key: "FILTER", name: "Filter" },
+              { key: "SEARCH", name: "Search" },
+              { key: "SORT", name: "Sort" },
+              { key: "CLEAR_FILTERS", name: "Clear Filters" }
+            ],
+            transitions: [
+              {
+                from: "Active",
+                to: "Active",
+                event: "INIT",
+                effects: [
+                  ["render-ui", "sidebar", {
+                    type: "filter-group",
+                    entity: "@entity.entityType",
+                    query: "@QueryState",
+                    filters: "@entity.filters"
+                  }],
+                  ["render-ui", "main", {
+                    type: "entity-table",
+                    entity: "@entity.entityType",
+                    query: "@QueryState",
+                    columns: "@entity.columns"
+                  }]
+                ]
+              },
+              {
+                from: "Active",
+                to: "Active",
+                event: "FILTER",
+                effects: [
+                  ["set", "@QueryState.status", "@payload.status"],
+                  ["set", "@QueryState.priority", "@payload.priority"]
+                ]
+              },
+              {
+                from: "Active",
+                to: "Active",
+                event: "SEARCH",
+                effects: [["set", "@QueryState.search", "@payload.searchTerm"]]
+              },
+              {
+                from: "Active",
+                to: "Active",
+                event: "SORT",
+                effects: [
+                  ["set", "@QueryState.sortBy", "@payload.field"],
+                  ["set", "@QueryState.sortOrder", "@payload.order"]
+                ]
+              },
+              {
+                from: "Active",
+                to: "Active",
+                event: "CLEAR_FILTERS",
+                effects: [
+                  ["set", "@QueryState.status", null],
+                  ["set", "@QueryState.priority", null],
+                  ["set", "@QueryState.search", ""]
+                ]
+              }
+            ]
+          }
+        }
+      ],
+      pages: []
+    }
+  ]
 };
 var SEARCH_BEHAVIOR = {
-  name: "std/Search",
-  category: "data-management",
+  name: "std-search",
+  version: "1.0.0",
   description: "Search with debounce - updates QueryState.search field",
-  suggestedFor: [
-    "Search inputs",
-    "Quick filters",
-    "Global search",
-    "Type-ahead"
-  ],
-  dataEntities: [
+  orbitals: [
     {
-      name: "SearchState",
-      runtime: true,
-      singleton: true,
-      fields: [
-        { name: "search", type: "string", default: "" },
-        { name: "isSearching", type: "boolean", default: false }
-      ]
-    }
-  ],
-  stateMachine: {
-    initial: "Idle",
-    states: [
-      { name: "Idle", isInitial: true },
-      { name: "Searching" }
-    ],
-    events: [
-      { key: "INIT" },
-      { key: "SEARCH" },
-      { key: "CLEAR_SEARCH" },
-      { key: "SEARCH_COMPLETE" }
-    ],
-    transitions: [
-      {
-        from: "*",
-        event: "INIT",
-        effects: [
-          ["set", "@entity.search", ""],
-          ["set", "@entity.isSearching", false],
-          ["render-ui", "main", {
-            type: "search-bar",
-            query: "@SearchState",
-            placeholder: "@config.placeholder"
-          }]
-        ]
-      },
-      {
-        from: "Idle",
-        to: "Searching",
-        event: "SEARCH",
-        guard: [">=", ["str/len", "@payload.term"], "@config.minLength"],
-        effects: [
-          ["set", "@entity.search", "@payload.term"],
-          ["set", "@entity.isSearching", true],
-          ["async/debounce", "@config.debounceMs", ["emit", "SEARCH_COMPLETE"]]
-        ]
-      },
-      {
-        from: "Idle",
-        event: "SEARCH",
-        guard: ["<", ["str/len", "@payload.term"], "@config.minLength"],
-        effects: [
-          ["set", "@entity.search", "@payload.term"]
-        ]
-      },
-      {
-        from: "Searching",
-        to: "Idle",
-        event: "SEARCH_COMPLETE",
-        effects: [
-          ["set", "@entity.isSearching", false]
+      name: "SearchOrbital",
+      entity: {
+        name: "SearchState",
+        persistence: "runtime",
+        fields: [
+          { name: "id", type: "string", required: true },
+          { name: "search", type: "string", default: "" },
+          { name: "isSearching", type: "boolean", default: false },
+          { name: "minLength", type: "number", default: 2 },
+          { name: "debounceMs", type: "number", default: 300 },
+          { name: "placeholder", type: "string", default: "Search..." }
         ]
       },
-      {
-        event: "CLEAR_SEARCH",
-        effects: [
-          ["set", "@entity.search", ""],
-          ["set", "@entity.isSearching", false]
-        ]
-      }
-    ]
-  },
-  configSchema: {
-    required: [],
-    optional: [
-      { name: "debounceMs", type: "number", description: "Debounce delay in ms", default: 300 },
-      { name: "minLength", type: "number", description: "Minimum search length", default: 1 },
-      { name: "placeholder", type: "string", description: "Input placeholder", default: "Search..." }
-    ]
-  }
+      traits: [
+        {
+          name: "Search",
+          linkedEntity: "SearchState",
+          category: "interaction",
+          stateMachine: {
+            states: [
+              { name: "Idle", isInitial: true },
+              { name: "Searching" }
+            ],
+            events: [
+              { key: "INIT", name: "Initialize" },
+              { key: "SEARCH", name: "Search" },
+              { key: "CLEAR_SEARCH", name: "Clear Search" },
+              { key: "SEARCH_COMPLETE", name: "Search Complete" }
+            ],
+            transitions: [
+              {
+                from: "Idle",
+                to: "Idle",
+                event: "INIT",
+                effects: [
+                  ["set", "@entity.search", ""],
+                  ["set", "@entity.isSearching", false],
+                  ["render-ui", "main", {
+                    type: "search-input",
+                    query: "@SearchState",
+                    placeholder: "@entity.placeholder"
+                  }]
+                ]
+              },
+              {
+                from: "Idle",
+                to: "Searching",
+                event: "SEARCH",
+                guard: [">=", ["str/len", "@payload.term"], "@entity.minLength"],
+                effects: [
+                  ["set", "@entity.search", "@payload.term"],
+                  ["set", "@entity.isSearching", true],
+                  ["async/debounce", "@entity.debounceMs", ["emit", "SEARCH_COMPLETE"]]
+                ]
+              },
+              {
+                from: "Idle",
+                to: "Idle",
+                event: "SEARCH",
+                guard: ["<", ["str/len", "@payload.term"], "@entity.minLength"],
+                effects: [["set", "@entity.search", "@payload.term"]]
+              },
+              {
+                from: "Searching",
+                to: "Idle",
+                event: "SEARCH_COMPLETE",
+                effects: [["set", "@entity.isSearching", false]]
+              },
+              {
+                from: "Idle",
+                to: "Idle",
+                event: "CLEAR_SEARCH",
+                effects: [
+                  ["set", "@entity.search", ""],
+                  ["set", "@entity.isSearching", false]
+                ]
+              },
+              {
+                from: "Searching",
+                to: "Idle",
+                event: "CLEAR_SEARCH",
+                effects: [
+                  ["set", "@entity.search", ""],
+                  ["set", "@entity.isSearching", false]
+                ]
+              }
+            ]
+          }
+        }
+      ],
+      pages: []
+    }
+  ]
 };
 var DATA_MANAGEMENT_BEHAVIORS = [
   PAGINATION_BEHAVIOR,