@salesforce/ui-bundle-features 11.10.1 → 11.11.1

package/dist/features.json

@@ -133,6 +133,82 @@
         "filterUtils - URL serialization and GraphQL filter building for all filter types",
         "sortUtils - GraphQL sort order building"
       ]
+    },
+    "search": {
+      "name": "Search (Beta)",
+      "package": "@salesforce/ui-bundle-template-feature-react-search",
+      "shortDescription": "[Beta] Configuration-driven multi-source (multi-object) search with one query box, per-source filters/sort, and global or per-source pagination over GraphQL",
+      "longDescription": "[Beta — API may change in a future release] Configuration-driven unified search across multiple Salesforce objects from a single query box. The application declares a SearchConfig with one entry per searchable SObject source; the library handles query construction, per-source filter/sort/pagination state, URL sync, and a single batched multi-aliased GraphQL request that fans out across every source. Supports two pagination models: per-source cursor pagination (each source advances its own Relay cursor) and merged/global pagination (the cumulative result set is windowed into fixed pages of pageSize). Provides a drop-in <Search> component plus lower-level primitives (useSearch hook, SearchBar, SearchResults, ScopeSelector, sort and pagination controls) and a configuration-driven filter panel (text, select, multi-select, numeric range, date range, boolean). Results can render one section per source or as a single combined grid via mergedResults, and a scope selector narrows the search to a single object or 'all'.",
+      "keywords": [
+        "search",
+        "multi-object",
+        "unified search",
+        "global search",
+        "filter",
+        "sort",
+        "pagination",
+        "GraphQL",
+        "scope",
+        "multi-source",
+        "beta"
+      ],
+      "featureDependencies": [],
+      "packageDependencies": {
+        "@salesforce/platform-sdk": "^11.2.0",
+        "lucide-react": "^0.562.0",
+        "react-router": "^7.10.1"
+      },
+      "copy": [
+        {
+          "from": "force-app/main/default/uiBundles/feature-react-search/src/features/search",
+          "to": "<uiBundleDir>/src/features/search",
+          "description": "Multi-source search library: useSearch hook, drop-in <Search> component, scope selector, filter panel, sort and pagination controls, query builder, GraphQL search service, and the example config.json"
+        },
+        {
+          "from": "force-app/main/default/uiBundles/feature-react-search/src/pages/Home.tsx",
+          "to": "<uiBundleDir>/src/features/search/__examples__/search-page-example.tsx",
+          "description": "Example page rendering the drop-in <Search config={config} /> — shows how to mount the search experience on a route",
+          "integrationTarget": "src/routes.tsx"
+        }
+      ],
+      "features": [
+        "Configuration-driven multi-object search from a single query box",
+        "One batched multi-aliased GraphQL request fans out across all in-scope sources",
+        "Two pagination models: per-source cursor pagination and merged/global fixed-size pagination",
+        "Merge ordering for the combined result list: sequential, interleaved, or proportional",
+        "Scope selector to narrow the search to a single object or search across all",
+        "Per-source structured filters: text, select, multi-select, numeric range, date range, boolean",
+        "Per-source sort controls with configurable sort fields and default sort",
+        "URL-synced query, scope, filters, sort, and pagination for bookmarkable/shareable searches",
+        "Drop-in <Search> component (one section per source) plus low-level primitives for custom layouts",
+        "mergedResults for rendering a single combined cross-source grid",
+        "Extensible adapter boundary — SObject sources today, room for CMS/REST adapters"
+      ],
+      "components": [
+        "Search - Drop-in multi-source search experience (search bar, scope, sections, pagination)",
+        "useSearch - Hook orchestrating query, scope, per-source filter/sort/pagination, URL sync, and fetch",
+        "SearchBar - Global query input driving every source",
+        "ScopeSelector - Dropdown to narrow search scope to one source or 'all'",
+        "SearchResults - Renders in-scope source results",
+        "SourceSection - One result section for a single source",
+        "SortControl - Per-source sort field and direction dropdown",
+        "PaginationControls - Pagination with page navigation and configurable page size",
+        "DefaultFilterPanel - Sidebar panel rendering filter controls from config",
+        "DefaultResultRow - Default renderer for a single result node",
+        "ActiveFilters - Chip display of active filters with removal",
+        "FilterContext - FilterProvider and hooks (useFilterField, useFilterPanel) for custom filter UIs",
+        "TextFilter - Debounced text input filter",
+        "SelectFilter - Single-select picklist filter",
+        "MultiSelectFilter - Multi-select picklist filter",
+        "NumericRangeFilter - Min/max numeric range filter",
+        "DateRangeFilter - Date range filter with start/end pickers",
+        "BooleanFilter - Boolean toggle filter",
+        "useDistinctValues - Hook for fetching distinct picklist values",
+        "useAsyncData - Hook for async data fetching with loading/error states",
+        "queryBuilder - Builds the multi-aliased GraphQL document and variables",
+        "searchService - Runs the batched GraphQL search and parses per-source results",
+        "filterUtils / sortUtils / fieldUtils - URL serialization, GraphQL filter/order building, field extraction"
+      ]
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/ui-bundle-features",
-  "version": "11.10.1",
+  "version": "11.11.1",
   "description": "CLI tool for searching and installing UI features into Salesforce UI Bundles",
   "license": "SEE LICENSE IN LICENSE.txt",
   "type": "module",