@almadar/std 1.0.0

package/dist/behaviors/data-management.js

@@ -0,0 +1,495 @@
+// behaviors/data-management.ts
+var PAGINATION_BEHAVIOR = {
+  name: "std/Pagination",
+  category: "data-management",
+  description: "Page-based navigation for large data sets",
+  suggestedFor: [
+    "Large lists",
+    "Table pagination",
+    "Infinite scroll alternative",
+    "Data-heavy views"
+  ],
+  dataEntities: [
+    {
+      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]]
+        ]
+      },
+      {
+        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] }
+    ]
+  }
+};
+var SELECTION_BEHAVIOR = {
+  name: "std/Selection",
+  category: "data-management",
+  description: "Single or multi-selection management",
+  suggestedFor: [
+    "Multi-select lists",
+    "Bulk operations",
+    "Item picking",
+    "Checkboxes in tables"
+  ],
+  dataEntities: [
+    {
+      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]
+        ]
+      },
+      {
+        event: "SELECT",
+        effects: [
+          [
+            "if",
+            ["=", "@config.mode", "single"],
+            [
+              "do",
+              ["set", "@entity.selected", ["@payload.id"]],
+              ["set", "@entity.lastSelected", "@payload.id"]
+            ],
+            [
+              "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"]
+                ]
+              ],
+              ["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 }
+    ]
+  }
+};
+var SORT_BEHAVIOR = {
+  name: "std/Sort",
+  category: "data-management",
+  description: "Sorting by field with direction toggle",
+  suggestedFor: [
+    "Sortable tables",
+    "List ordering",
+    "Column headers"
+  ],
+  dataEntities: [
+    {
+      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"]
+        ]
+      },
+      {
+        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"]
+            ]
+          ]
+        ]
+      },
+      {
+        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"] }
+    ]
+  }
+};
+var FILTER_BEHAVIOR = {
+  name: "std/Filter",
+  category: "data-management",
+  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: [
+    {
+      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"]
+        ]
+      },
+      {
+        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: [] }
+    ]
+  }
+};
+var SEARCH_BEHAVIOR = {
+  name: "std/Search",
+  category: "data-management",
+  description: "Search with debounce - updates QueryState.search field",
+  suggestedFor: [
+    "Search inputs",
+    "Quick filters",
+    "Global search",
+    "Type-ahead"
+  ],
+  dataEntities: [
+    {
+      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]
+        ]
+      },
+      {
+        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..." }
+    ]
+  }
+};
+var DATA_MANAGEMENT_BEHAVIORS = [
+  PAGINATION_BEHAVIOR,
+  SELECTION_BEHAVIOR,
+  SORT_BEHAVIOR,
+  FILTER_BEHAVIOR,
+  SEARCH_BEHAVIOR
+];
+
+export { DATA_MANAGEMENT_BEHAVIORS, FILTER_BEHAVIOR, PAGINATION_BEHAVIOR, SEARCH_BEHAVIOR, SELECTION_BEHAVIOR, SORT_BEHAVIOR };
+//# sourceMappingURL=data-management.js.map
+//# sourceMappingURL=data-management.js.map

package/dist/behaviors/data-management.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../behaviors/data-management.ts"],"names":[],"mappings":"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","file":"data-management.js","sourcesContent":["/**\n * Data Management Behaviors\n *\n * Standard behaviors for data operations like pagination, selection,\n * sorting, filtering, and search.\n *\n * @packageDocumentation\n */\n\nimport type { StandardBehavior } from './types.js';\n\n// ============================================================================\n// std/Pagination - Page Navigation\n// ============================================================================\n\n/**\n * std/Pagination - Page navigation behavior for large data sets.\n */\nexport const PAGINATION_BEHAVIOR: StandardBehavior = {\n  name: 'std/Pagination',\n  category: 'data-management',\n  description: 'Page-based navigation for large data sets',\n  suggestedFor: [\n    'Large lists',\n    'Table pagination',\n    'Infinite scroll alternative',\n    'Data-heavy views',\n  ],\n\n  dataEntities: [\n    {\n      name: 'PaginationState',\n      runtime: true,\n      singleton: true,\n      fields: [\n        { name: 'page', type: 'number', default: 1 },\n        { name: 'pageSize', type: 'number', default: 20 },\n        { name: 'totalItems', type: 'number', default: 0 },\n      ],\n    },\n  ],\n\n  stateMachine: {\n    initial: 'Active',\n    states: [\n      { name: 'Active', isInitial: true },\n    ],\n    events: [\n      { key: 'INIT' },\n      { key: 'NEXT_PAGE' },\n      { key: 'PREV_PAGE' },\n      { key: 'GO_TO_PAGE' },\n      { key: 'SET_PAGE_SIZE' },\n    ],\n    transitions: [\n      {\n        from: '*',\n        event: 'INIT',\n        effects: [\n          ['set', '@entity.page', 1],\n          ['set', '@entity.pageSize', '@config.defaultPageSize'],\n        ],\n      },\n      {\n        event: 'NEXT_PAGE',\n        guard: ['<', '@entity.page', ['math/ceil', ['/', '@entity.totalItems', '@entity.pageSize']]],\n        effects: [\n          ['set', '@entity.page', ['+', '@entity.page', 1]],\n        ],\n      },\n      {\n        event: 'PREV_PAGE',\n        guard: ['>', '@entity.page', 1],\n        effects: [\n          ['set', '@entity.page', ['-', '@entity.page', 1]],\n        ],\n      },\n      {\n        event: 'GO_TO_PAGE',\n        guard: ['and',\n          ['>=', '@payload.page', 1],\n          ['<=', '@payload.page', ['math/ceil', ['/', '@entity.totalItems', '@entity.pageSize']]]],\n        effects: [\n          ['set', '@entity.page', '@payload.page'],\n        ],\n      },\n      {\n        event: 'SET_PAGE_SIZE',\n        effects: [\n          ['set', '@entity.pageSize', '@payload.size'],\n          ['set', '@entity.page', 1],\n        ],\n      },\n    ],\n  },\n\n  configSchema: {\n    required: [],\n    optional: [\n      { name: 'defaultPageSize', type: 'number', description: 'Default items per page', default: 20 },\n      { name: 'pageSizeOptions', type: 'array', description: 'Available page sizes', default: [10, 20, 50, 100] },\n    ],\n  },\n};\n\n// ============================================================================\n// std/Selection - Single/Multi Selection\n// ============================================================================\n\nexport const SELECTION_BEHAVIOR: StandardBehavior = {\n  name: 'std/Selection',\n  category: 'data-management',\n  description: 'Single or multi-selection management',\n  suggestedFor: [\n    'Multi-select lists',\n    'Bulk operations',\n    'Item picking',\n    'Checkboxes in tables',\n  ],\n\n  dataEntities: [\n    {\n      name: 'SelectionState',\n      runtime: true,\n      singleton: true,\n      fields: [\n        { name: 'selected', type: 'array', default: [] },\n        { name: 'lastSelected', type: 'string', default: null },\n      ],\n    },\n  ],\n\n  stateMachine: {\n    initial: 'Active',\n    states: [\n      { name: 'Active', isInitial: true },\n    ],\n    events: [\n      { key: 'INIT' },\n      { key: 'SELECT' },\n      { key: 'DESELECT' },\n      { key: 'TOGGLE' },\n      { key: 'SELECT_ALL' },\n      { key: 'CLEAR' },\n    ],\n    transitions: [\n      {\n        from: '*',\n        event: 'INIT',\n        effects: [\n          ['set', '@entity.selected', []],\n          ['set', '@entity.lastSelected', null],\n        ],\n      },\n      {\n        event: 'SELECT',\n        effects: [\n          ['if', ['=', '@config.mode', 'single'],\n            ['do',\n              ['set', '@entity.selected', ['@payload.id']],\n              ['set', '@entity.lastSelected', '@payload.id']],\n            ['if', ['or',\n              ['not', '@config.maxSelection'],\n              ['<', ['array/len', '@entity.selected'], '@config.maxSelection']],\n              ['do',\n                ['set', '@entity.selected', ['array/append', '@entity.selected', '@payload.id']],\n                ['set', '@entity.lastSelected', '@payload.id']],\n              ['notify', { type: 'warning', message: 'Maximum selection reached' }]]],\n        ],\n      },\n      {\n        event: 'DESELECT',\n        effects: [\n          ['set', '@entity.selected', ['array/filter', '@entity.selected', ['fn', 'id', ['!=', '@id', '@payload.id']]]],\n        ],\n      },\n      {\n        event: 'TOGGLE',\n        effects: [\n          ['if', ['array/includes', '@entity.selected', '@payload.id'],\n            ['set', '@entity.selected', ['array/filter', '@entity.selected', ['fn', 'id', ['!=', '@id', '@payload.id']]]],\n            ['if', ['or', ['=', '@config.mode', 'single'], ['or',\n              ['not', '@config.maxSelection'],\n              ['<', ['array/len', '@entity.selected'], '@config.maxSelection']]],\n              ['set', '@entity.selected',\n                ['if', ['=', '@config.mode', 'single'],\n                  ['@payload.id'],\n                  ['array/append', '@entity.selected', '@payload.id']]],\n              ['notify', { type: 'warning', message: 'Maximum selection reached' }]]],\n        ],\n      },\n      {\n        event: 'SELECT_ALL',\n        guard: ['=', '@config.mode', 'multi'],\n        effects: [\n          ['set', '@entity.selected', '@payload.ids'],\n        ],\n      },\n      {\n        event: 'CLEAR',\n        effects: [\n          ['set', '@entity.selected', []],\n          ['set', '@entity.lastSelected', null],\n        ],\n      },\n    ],\n  },\n\n  configSchema: {\n    required: [],\n    optional: [\n      { name: 'mode', type: 'string', description: 'Selection mode', default: 'single', enum: ['single', 'multi'] },\n      { name: 'maxSelection', type: 'number', description: 'Maximum selections (multi mode)', default: null },\n    ],\n  },\n};\n\n// ============================================================================\n// std/Sort - Sorting\n// ============================================================================\n\nexport const SORT_BEHAVIOR: StandardBehavior = {\n  name: 'std/Sort',\n  category: 'data-management',\n  description: 'Sorting by field with direction toggle',\n  suggestedFor: [\n    'Sortable tables',\n    'List ordering',\n    'Column headers',\n  ],\n\n  dataEntities: [\n    {\n      name: 'SortState',\n      runtime: true,\n      singleton: true,\n      fields: [\n        { name: 'sortField', type: 'string', default: null },\n        { name: 'sortDirection', type: 'string', default: 'asc' },\n      ],\n    },\n  ],\n\n  stateMachine: {\n    initial: 'Active',\n    states: [\n      { name: 'Active', isInitial: true },\n    ],\n    events: [\n      { key: 'INIT' },\n      { key: 'SORT' },\n      { key: 'TOGGLE_DIRECTION' },\n      { key: 'CLEAR_SORT' },\n    ],\n    transitions: [\n      {\n        from: '*',\n        event: 'INIT',\n        effects: [\n          ['set', '@entity.sortField', '@config.defaultField'],\n          ['set', '@entity.sortDirection', '@config.defaultDirection'],\n        ],\n      },\n      {\n        event: 'SORT',\n        effects: [\n          ['if', ['=', '@entity.sortField', '@payload.field'],\n            ['set', '@entity.sortDirection', ['if', ['=', '@entity.sortDirection', 'asc'], 'desc', 'asc']],\n            ['do',\n              ['set', '@entity.sortField', '@payload.field'],\n              ['set', '@entity.sortDirection', 'asc']]],\n        ],\n      },\n      {\n        event: 'TOGGLE_DIRECTION',\n        guard: ['!=', '@entity.sortField', null],\n        effects: [\n          ['set', '@entity.sortDirection', ['if', ['=', '@entity.sortDirection', 'asc'], 'desc', 'asc']],\n        ],\n      },\n      {\n        event: 'CLEAR_SORT',\n        effects: [\n          ['set', '@entity.sortField', null],\n          ['set', '@entity.sortDirection', 'asc'],\n        ],\n      },\n    ],\n  },\n\n  configSchema: {\n    required: [],\n    optional: [\n      { name: 'defaultField', type: 'string', description: 'Default sort field' },\n      { name: 'defaultDirection', type: 'string', description: 'Default direction', default: 'asc', enum: ['asc', 'desc'] },\n    ],\n  },\n};\n\n// ============================================================================\n// std/Filter - Query Singleton Pattern for Filtering\n// ============================================================================\n\n/**\n * std/Filter - Query Singleton pattern for explicit filtering.\n *\n * This behavior uses a singleton entity to hold filter state, making filtering\n * explicit in the schema rather than implicit in component behavior.\n *\n * The query singleton is referenced by patterns via the `query` prop:\n * ```json\n * { \"type\": \"entity-table\", \"entity\": \"Task\", \"query\": \"@TaskQuery\" }\n * ```\n */\nexport const FILTER_BEHAVIOR: StandardBehavior = {\n  name: 'std/Filter',\n  category: 'data-management',\n  description: 'Query Singleton pattern for explicit filtering - use with entity-table query prop',\n  suggestedFor: [\n    'Filterable lists',\n    'Advanced search',\n    'Filter panels',\n    'Faceted search',\n    'Entity tables with filters',\n  ],\n\n  dataEntities: [\n    {\n      name: 'QueryState',\n      runtime: true,\n      singleton: true,\n      fields: [\n        { name: 'status', type: 'string', default: null, description: 'Filter by status field' },\n        { name: 'priority', type: 'string', default: null, description: 'Filter by priority field' },\n        { name: 'search', type: 'string', default: '', description: 'Search term' },\n        { name: 'sortBy', type: 'string', default: 'createdAt', description: 'Sort field' },\n        { name: 'sortOrder', type: 'string', default: 'desc', description: 'Sort direction: asc or desc' },\n      ],\n    },\n  ],\n\n  stateMachine: {\n    initial: 'Active',\n    states: [\n      { name: 'Active', isInitial: true },\n    ],\n    events: [\n      { key: 'INIT' },\n      { key: 'FILTER' },\n      { key: 'SEARCH' },\n      { key: 'SORT' },\n      { key: 'CLEAR_FILTERS' },\n    ],\n    transitions: [\n      {\n        from: '*',\n        event: 'INIT',\n        effects: [\n          // Render filter UI with query reference\n          ['render-ui', 'sidebar', {\n            type: 'filter-group',\n            query: '@QueryState',\n            filters: '@config.filters',\n          }],\n          // Render entity table with query reference\n          ['render-ui', 'main', {\n            type: 'entity-table',\n            entity: '@config.entity',\n            query: '@QueryState',\n            columns: '@config.columns',\n          }],\n        ],\n      },\n      {\n        event: 'FILTER',\n        effects: [\n          ['set', '@QueryState.status', '@payload.status'],\n          ['set', '@QueryState.priority', '@payload.priority'],\n        ],\n      },\n      {\n        event: 'SEARCH',\n        effects: [\n          ['set', '@QueryState.search', '@payload.searchTerm'],\n        ],\n      },\n      {\n        event: 'SORT',\n        effects: [\n          ['set', '@QueryState.sortBy', '@payload.field'],\n          ['set', '@QueryState.sortOrder', '@payload.order'],\n        ],\n      },\n      {\n        event: 'CLEAR_FILTERS',\n        effects: [\n          ['set', '@QueryState.status', null],\n          ['set', '@QueryState.priority', null],\n          ['set', '@QueryState.search', ''],\n        ],\n      },\n    ],\n  },\n\n  configSchema: {\n    required: [\n      { name: 'entity', type: 'string', description: 'Entity to filter' },\n    ],\n    optional: [\n      { name: 'filters', type: 'array', description: 'Filter field definitions', default: [] },\n      { name: 'columns', type: 'array', description: 'Table columns to display', default: [] },\n    ],\n  },\n};\n\n// ============================================================================\n// std/Search - Search with Debounce\n// ============================================================================\n\n/**\n * std/Search - Search with debounce.\n *\n * Uses a singleton to hold search state. Can be combined with std/Filter\n * for full query singleton functionality, or used standalone.\n */\nexport const SEARCH_BEHAVIOR: StandardBehavior = {\n  name: 'std/Search',\n  category: 'data-management',\n  description: 'Search with debounce - updates QueryState.search field',\n  suggestedFor: [\n    'Search inputs',\n    'Quick filters',\n    'Global search',\n    'Type-ahead',\n  ],\n\n  dataEntities: [\n    {\n      name: 'SearchState',\n      runtime: true,\n      singleton: true,\n      fields: [\n        { name: 'search', type: 'string', default: '' },\n        { name: 'isSearching', type: 'boolean', default: false },\n      ],\n    },\n  ],\n\n  stateMachine: {\n    initial: 'Idle',\n    states: [\n      { name: 'Idle', isInitial: true },\n      { name: 'Searching' },\n    ],\n    events: [\n      { key: 'INIT' },\n      { key: 'SEARCH' },\n      { key: 'CLEAR_SEARCH' },\n      { key: 'SEARCH_COMPLETE' },\n    ],\n    transitions: [\n      {\n        from: '*',\n        event: 'INIT',\n        effects: [\n          ['set', '@entity.search', ''],\n          ['set', '@entity.isSearching', false],\n          ['render-ui', 'main', {\n            type: 'search-bar',\n            query: '@SearchState',\n            placeholder: '@config.placeholder',\n          }],\n        ],\n      },\n      {\n        from: 'Idle',\n        to: 'Searching',\n        event: 'SEARCH',\n        guard: ['>=', ['str/len', '@payload.term'], '@config.minLength'],\n        effects: [\n          ['set', '@entity.search', '@payload.term'],\n          ['set', '@entity.isSearching', true],\n          ['async/debounce', '@config.debounceMs', ['emit', 'SEARCH_COMPLETE']],\n        ],\n      },\n      {\n        from: 'Idle',\n        event: 'SEARCH',\n        guard: ['<', ['str/len', '@payload.term'], '@config.minLength'],\n        effects: [\n          ['set', '@entity.search', '@payload.term'],\n        ],\n      },\n      {\n        from: 'Searching',\n        to: 'Idle',\n        event: 'SEARCH_COMPLETE',\n        effects: [\n          ['set', '@entity.isSearching', false],\n        ],\n      },\n      {\n        event: 'CLEAR_SEARCH',\n        effects: [\n          ['set', '@entity.search', ''],\n          ['set', '@entity.isSearching', false],\n        ],\n      },\n    ],\n  },\n\n  configSchema: {\n    required: [],\n    optional: [\n      { name: 'debounceMs', type: 'number', description: 'Debounce delay in ms', default: 300 },\n      { name: 'minLength', type: 'number', description: 'Minimum search length', default: 1 },\n      { name: 'placeholder', type: 'string', description: 'Input placeholder', default: 'Search...' },\n    ],\n  },\n};\n\n// ============================================================================\n// Export All Data Management Behaviors\n// ============================================================================\n\nexport const DATA_MANAGEMENT_BEHAVIORS: StandardBehavior[] = [\n  PAGINATION_BEHAVIOR,\n  SELECTION_BEHAVIOR,\n  SORT_BEHAVIOR,\n  FILTER_BEHAVIOR,\n  SEARCH_BEHAVIOR,\n];\n"]}

package/dist/behaviors/feedback.d.ts

@@ -0,0 +1,18 @@
+import { StandardBehavior } from './types.js';
+import '@almadar/core/types';
+
+/**
+ * Feedback Behaviors
+ *
+ * Standard behaviors for user feedback including notifications,
+ * confirmations, and undo functionality.
+ *
+ * @packageDocumentation
+ */
+
+declare const NOTIFICATION_BEHAVIOR: StandardBehavior;
+declare const CONFIRMATION_BEHAVIOR: StandardBehavior;
+declare const UNDO_BEHAVIOR: StandardBehavior;
+declare const FEEDBACK_BEHAVIORS: StandardBehavior[];
+
+export { CONFIRMATION_BEHAVIOR, FEEDBACK_BEHAVIORS, NOTIFICATION_BEHAVIOR, UNDO_BEHAVIOR };