use-kbd 0.5.0 → 0.6.0

package/dist/index.d.cts

@@ -260,11 +260,9 @@ interface EndpointResponse {
  */
 type EndpointPaginationMode = 'scroll' | 'buttons' | 'none';
 /**
- * Configuration for a remote omnibar endpoint
+ * Base configuration shared by async and sync endpoints
  */
-interface OmnibarEndpointConfig {
-    /** Fetch function that returns entries for a query */
-    fetch: (query: string, signal: AbortSignal, pagination: EndpointPagination) => Promise<EndpointResponse>;
+interface OmnibarEndpointConfigBase {
     /** Default group for entries from this endpoint */
     group?: string;
     /** Priority for result ordering (higher = shown first, default: 0, local actions: 100) */
@@ -278,6 +276,30 @@ interface OmnibarEndpointConfig {
     /** Pagination mode (default: 'none') */
     pagination?: EndpointPaginationMode;
 }
+/**
+ * Configuration for an async omnibar endpoint (remote API calls)
+ */
+interface OmnibarEndpointAsyncConfig extends OmnibarEndpointConfigBase {
+    /** Async fetch function for remote data sources */
+    fetch: (query: string, signal: AbortSignal, pagination: EndpointPagination) => Promise<EndpointResponse>;
+    filter?: never;
+    /** Internal: true if this was originally a sync endpoint (skip debouncing) */
+    isSync?: boolean;
+}
+/**
+ * Configuration for a sync omnibar endpoint (in-memory filtering)
+ *
+ * Sync endpoints skip debouncing for instant results.
+ */
+interface OmnibarEndpointSyncConfig extends OmnibarEndpointConfigBase {
+    /** Sync filter function for in-memory data sources */
+    filter: (query: string, pagination: EndpointPagination) => EndpointResponse;
+    fetch?: never;
+}
+/**
+ * Configuration for an omnibar endpoint (async or sync)
+ */
+type OmnibarEndpointConfig = OmnibarEndpointAsyncConfig | OmnibarEndpointSyncConfig;
 
 /**
  * Hotkey definition - maps key combinations/sequences to action names
@@ -393,7 +415,8 @@ declare function useEditableHotkeys(defaults: HotkeyMap, handlers: HandlerMap, o
 
 interface RegisteredEndpoint {
     id: string;
-    config: OmnibarEndpointConfig;
+    /** Internal config is always async (useOmnibarEndpoint normalizes sync endpoints) */
+    config: OmnibarEndpointAsyncConfig;
     registeredAt: number;
 }
 /**
@@ -410,7 +433,7 @@ interface EndpointQueryResult {
 }
 interface OmnibarEndpointsRegistryValue {
     /** Register an endpoint. Called by useOmnibarEndpoint on mount. */
-    register: (id: string, config: OmnibarEndpointConfig) => void;
+    register: (id: string, config: OmnibarEndpointAsyncConfig) => void;
     /** Unregister an endpoint. Called by useOmnibarEndpoint on unmount. */
     unregister: (id: string) => void;
     /** Currently registered endpoints */
@@ -1388,39 +1411,50 @@ declare function useHotkeysContext(): HotkeysContextValue;
 declare function useMaybeHotkeysContext(): HotkeysContextValue | null;
 
 /**
- * Register a remote omnibar endpoint.
+ * Register an omnibar endpoint for dynamic search results.
+ *
+ * Supports both async (remote API) and sync (in-memory) endpoints:
+ * - Use `fetch` for async operations that need AbortSignal support
+ * - Use `filter` for sync in-memory filtering (skips debouncing for instant results)
  *
  * Endpoints are automatically unregistered when the component unmounts,
  * making this ideal for colocating search providers with their data context.
  *
- * @example
+ * @example Async endpoint (remote API)
  * ```tsx
- * function UsersPage() {
- *   const navigate = useNavigate()
- *
- *   useOmnibarEndpoint('users', {
- *     fetch: async (query, signal, pagination) => {
- *       const res = await fetch(`/api/users?q=${query}&offset=${pagination.offset}&limit=${pagination.limit}`, { signal })
- *       const { users, total } = await res.json()
- *       return {
- *         entries: users.map(u => ({
- *           id: `user:${u.id}`,
- *           label: u.name,
- *           description: u.email,
- *           handler: () => navigate(`/users/${u.id}`),
- *         })),
- *         total,
- *         hasMore: pagination.offset + users.length < total,
- *       }
- *     },
- *     group: 'Users',
- *     priority: 10,
- *     pageSize: 10,
- *     pagination: 'scroll',
- *   })
+ * useOmnibarEndpoint('users', {
+ *   fetch: async (query, signal, pagination) => {
+ *     const res = await fetch(`/api/users?q=${query}`, { signal })
+ *     const { users, total } = await res.json()
+ *     return {
+ *       entries: users.map(u => ({
+ *         id: `user:${u.id}`,
+ *         label: u.name,
+ *         handler: () => navigate(`/users/${u.id}`),
+ *       })),
+ *       total,
+ *       hasMore: pagination.offset + users.length < total,
+ *     }
+ *   },
+ *   group: 'Users',
+ * })
+ * ```
  *
- *   return <UsersList />
- * }
+ * @example Sync endpoint (in-memory filtering)
+ * ```tsx
+ * useOmnibarEndpoint('stations', {
+ *   filter: (query, pagination) => {
+ *     const matches = stations.filter(s => s.name.includes(query))
+ *     return {
+ *       entries: matches.slice(pagination.offset, pagination.offset + pagination.limit)
+ *         .map(s => ({ id: s.id, label: s.name, handler: () => select(s) })),
+ *       total: matches.length,
+ *       hasMore: pagination.offset + pagination.limit < matches.length,
+ *     }
+ *   },
+ *   group: 'Stations',
+ *   minQueryLength: 0,
+ * })
  * ```
  */
 declare function useOmnibarEndpoint(id: string, config: OmnibarEndpointConfig): void;
@@ -1631,4 +1665,4 @@ declare const ACTION_MODAL = "__hotkeys:modal";
 declare const ACTION_OMNIBAR = "__hotkeys:omnibar";
 declare const ACTION_LOOKUP = "__hotkeys:lookup";
 
-export { ACTION_LOOKUP, ACTION_MODAL, ACTION_OMNIBAR, type ActionConfig, type ActionDefinition, type ActionHandler, type ActionRegistry, type ActionSearchResult, ActionsRegistryContext, type ActionsRegistryValue, Alt, Backspace, type BindingInfo, Command, Ctrl, DEFAULT_SEQUENCE_TIMEOUT, DIGITS_PLACEHOLDER, DIGIT_PLACEHOLDER, Down, type EndpointPagination, type EndpointPaginationInfo, type EndpointPaginationMode, type EndpointQueryResult, type EndpointResponse, Enter, type FuzzyMatchResult, type GroupRenderer, type GroupRendererProps, type HandlerMap, type HotkeyHandler, type HotkeyMap, type HotkeySequence, type HotkeysConfig, type HotkeysContextValue, HotkeysProvider, type HotkeysProviderProps, Kbd, KbdLookup, KbdModal, KbdOmnibar, type KbdProps, Kbds, Key, type KeyCombination, type KeyCombinationDisplay, type KeyConflict, type KeyIconProps, type KeyIconType, type KeySeq, KeybindingEditor, type KeybindingEditorProps, type KeybindingEditorRenderProps, Left, LookupModal, ModifierIcon, type ModifierIconProps, type ModifierType, type Modifiers, Omnibar, type OmnibarActionEntry, type OmnibarEndpointConfig, OmnibarEndpointsRegistryContext, type OmnibarEndpointsRegistryValue, type OmnibarEntry, type OmnibarEntryBase, type OmnibarLinkEntry, type OmnibarProps, type OmnibarRenderProps, Option, type RecordHotkeyOptions, type RecordHotkeyResult, type RegisteredAction, type RegisteredEndpoint, type RemoteOmnibarResult, Right, type SeqElem, type SeqElemState, type SeqMatchState, type SequenceCompletion, SequenceModal, Shift, type ShortcutGroup, ShortcutsModal, type ShortcutsModalProps, type ShortcutsModalRenderProps, type TooltipComponent, type TooltipProps, type TwoColumnConfig, type TwoColumnRow, Up, type UseEditableHotkeysOptions, type UseEditableHotkeysResult, type UseHotkeysOptions, type UseHotkeysResult, type UseOmnibarOptions, type UseOmnibarResult, countPlaceholders, createTwoColumnRenderer, extractCaptures, findConflicts, formatBinding, formatCombination, formatKeyForDisplay, formatKeySeq, fuzzyMatch, getActionBindings, getConflictsArray, getKeyIcon, getModifierIcon, getSequenceCompletions, hasConflicts, hasDigitPlaceholders, hotkeySequenceToKeySeq, isDigitPlaceholder, isMac, isModifierKey, isPlaceholderSentinel, isSequence, isShiftedSymbol, keySeqToHotkeySequence, normalizeKey, parseHotkeyString, parseKeySeq, searchActions, useAction, useActions, useActionsRegistry, useEditableHotkeys, useHotkeys, useHotkeysContext, useMaybeHotkeysContext, useOmnibar, useOmnibarEndpoint, useOmnibarEndpointsRegistry, useRecordHotkey };
+export { ACTION_LOOKUP, ACTION_MODAL, ACTION_OMNIBAR, type ActionConfig, type ActionDefinition, type ActionHandler, type ActionRegistry, type ActionSearchResult, ActionsRegistryContext, type ActionsRegistryValue, Alt, Backspace, type BindingInfo, Command, Ctrl, DEFAULT_SEQUENCE_TIMEOUT, DIGITS_PLACEHOLDER, DIGIT_PLACEHOLDER, Down, type EndpointPagination, type EndpointPaginationInfo, type EndpointPaginationMode, type EndpointQueryResult, type EndpointResponse, Enter, type FuzzyMatchResult, type GroupRenderer, type GroupRendererProps, type HandlerMap, type HotkeyHandler, type HotkeyMap, type HotkeySequence, type HotkeysConfig, type HotkeysContextValue, HotkeysProvider, type HotkeysProviderProps, Kbd, KbdLookup, KbdModal, KbdOmnibar, type KbdProps, Kbds, Key, type KeyCombination, type KeyCombinationDisplay, type KeyConflict, type KeyIconProps, type KeyIconType, type KeySeq, KeybindingEditor, type KeybindingEditorProps, type KeybindingEditorRenderProps, Left, LookupModal, ModifierIcon, type ModifierIconProps, type ModifierType, type Modifiers, Omnibar, type OmnibarActionEntry, type OmnibarEndpointAsyncConfig, type OmnibarEndpointConfig, type OmnibarEndpointConfigBase, type OmnibarEndpointSyncConfig, OmnibarEndpointsRegistryContext, type OmnibarEndpointsRegistryValue, type OmnibarEntry, type OmnibarEntryBase, type OmnibarLinkEntry, type OmnibarProps, type OmnibarRenderProps, Option, type RecordHotkeyOptions, type RecordHotkeyResult, type RegisteredAction, type RegisteredEndpoint, type RemoteOmnibarResult, Right, type SeqElem, type SeqElemState, type SeqMatchState, type SequenceCompletion, SequenceModal, Shift, type ShortcutGroup, ShortcutsModal, type ShortcutsModalProps, type ShortcutsModalRenderProps, type TooltipComponent, type TooltipProps, type TwoColumnConfig, type TwoColumnRow, Up, type UseEditableHotkeysOptions, type UseEditableHotkeysResult, type UseHotkeysOptions, type UseHotkeysResult, type UseOmnibarOptions, type UseOmnibarResult, countPlaceholders, createTwoColumnRenderer, extractCaptures, findConflicts, formatBinding, formatCombination, formatKeyForDisplay, formatKeySeq, fuzzyMatch, getActionBindings, getConflictsArray, getKeyIcon, getModifierIcon, getSequenceCompletions, hasConflicts, hasDigitPlaceholders, hotkeySequenceToKeySeq, isDigitPlaceholder, isMac, isModifierKey, isPlaceholderSentinel, isSequence, isShiftedSymbol, keySeqToHotkeySequence, normalizeKey, parseHotkeyString, parseKeySeq, searchActions, useAction, useActions, useActionsRegistry, useEditableHotkeys, useHotkeys, useHotkeysContext, useMaybeHotkeysContext, useOmnibar, useOmnibarEndpoint, useOmnibarEndpointsRegistry, useRecordHotkey };

package/dist/index.d.ts

@@ -260,11 +260,9 @@ interface EndpointResponse {
  */
 type EndpointPaginationMode = 'scroll' | 'buttons' | 'none';
 /**
- * Configuration for a remote omnibar endpoint
+ * Base configuration shared by async and sync endpoints
  */
-interface OmnibarEndpointConfig {
-    /** Fetch function that returns entries for a query */
-    fetch: (query: string, signal: AbortSignal, pagination: EndpointPagination) => Promise<EndpointResponse>;
+interface OmnibarEndpointConfigBase {
     /** Default group for entries from this endpoint */
     group?: string;
     /** Priority for result ordering (higher = shown first, default: 0, local actions: 100) */
@@ -278,6 +276,30 @@ interface OmnibarEndpointConfig {
     /** Pagination mode (default: 'none') */
     pagination?: EndpointPaginationMode;
 }
+/**
+ * Configuration for an async omnibar endpoint (remote API calls)
+ */
+interface OmnibarEndpointAsyncConfig extends OmnibarEndpointConfigBase {
+    /** Async fetch function for remote data sources */
+    fetch: (query: string, signal: AbortSignal, pagination: EndpointPagination) => Promise<EndpointResponse>;
+    filter?: never;
+    /** Internal: true if this was originally a sync endpoint (skip debouncing) */
+    isSync?: boolean;
+}
+/**
+ * Configuration for a sync omnibar endpoint (in-memory filtering)
+ *
+ * Sync endpoints skip debouncing for instant results.
+ */
+interface OmnibarEndpointSyncConfig extends OmnibarEndpointConfigBase {
+    /** Sync filter function for in-memory data sources */
+    filter: (query: string, pagination: EndpointPagination) => EndpointResponse;
+    fetch?: never;
+}
+/**
+ * Configuration for an omnibar endpoint (async or sync)
+ */
+type OmnibarEndpointConfig = OmnibarEndpointAsyncConfig | OmnibarEndpointSyncConfig;
 
 /**
  * Hotkey definition - maps key combinations/sequences to action names
@@ -393,7 +415,8 @@ declare function useEditableHotkeys(defaults: HotkeyMap, handlers: HandlerMap, o
 
 interface RegisteredEndpoint {
     id: string;
-    config: OmnibarEndpointConfig;
+    /** Internal config is always async (useOmnibarEndpoint normalizes sync endpoints) */
+    config: OmnibarEndpointAsyncConfig;
     registeredAt: number;
 }
 /**
@@ -410,7 +433,7 @@ interface EndpointQueryResult {
 }
 interface OmnibarEndpointsRegistryValue {
     /** Register an endpoint. Called by useOmnibarEndpoint on mount. */
-    register: (id: string, config: OmnibarEndpointConfig) => void;
+    register: (id: string, config: OmnibarEndpointAsyncConfig) => void;
     /** Unregister an endpoint. Called by useOmnibarEndpoint on unmount. */
     unregister: (id: string) => void;
     /** Currently registered endpoints */
@@ -1388,39 +1411,50 @@ declare function useHotkeysContext(): HotkeysContextValue;
 declare function useMaybeHotkeysContext(): HotkeysContextValue | null;
 
 /**
- * Register a remote omnibar endpoint.
+ * Register an omnibar endpoint for dynamic search results.
+ *
+ * Supports both async (remote API) and sync (in-memory) endpoints:
+ * - Use `fetch` for async operations that need AbortSignal support
+ * - Use `filter` for sync in-memory filtering (skips debouncing for instant results)
  *
  * Endpoints are automatically unregistered when the component unmounts,
  * making this ideal for colocating search providers with their data context.
  *
- * @example
+ * @example Async endpoint (remote API)
  * ```tsx
- * function UsersPage() {
- *   const navigate = useNavigate()
- *
- *   useOmnibarEndpoint('users', {
- *     fetch: async (query, signal, pagination) => {
- *       const res = await fetch(`/api/users?q=${query}&offset=${pagination.offset}&limit=${pagination.limit}`, { signal })
- *       const { users, total } = await res.json()
- *       return {
- *         entries: users.map(u => ({
- *           id: `user:${u.id}`,
- *           label: u.name,
- *           description: u.email,
- *           handler: () => navigate(`/users/${u.id}`),
- *         })),
- *         total,
- *         hasMore: pagination.offset + users.length < total,
- *       }
- *     },
- *     group: 'Users',
- *     priority: 10,
- *     pageSize: 10,
- *     pagination: 'scroll',
- *   })
+ * useOmnibarEndpoint('users', {
+ *   fetch: async (query, signal, pagination) => {
+ *     const res = await fetch(`/api/users?q=${query}`, { signal })
+ *     const { users, total } = await res.json()
+ *     return {
+ *       entries: users.map(u => ({
+ *         id: `user:${u.id}`,
+ *         label: u.name,
+ *         handler: () => navigate(`/users/${u.id}`),
+ *       })),
+ *       total,
+ *       hasMore: pagination.offset + users.length < total,
+ *     }
+ *   },
+ *   group: 'Users',
+ * })
+ * ```
  *
- *   return <UsersList />
- * }
+ * @example Sync endpoint (in-memory filtering)
+ * ```tsx
+ * useOmnibarEndpoint('stations', {
+ *   filter: (query, pagination) => {
+ *     const matches = stations.filter(s => s.name.includes(query))
+ *     return {
+ *       entries: matches.slice(pagination.offset, pagination.offset + pagination.limit)
+ *         .map(s => ({ id: s.id, label: s.name, handler: () => select(s) })),
+ *       total: matches.length,
+ *       hasMore: pagination.offset + pagination.limit < matches.length,
+ *     }
+ *   },
+ *   group: 'Stations',
+ *   minQueryLength: 0,
+ * })
  * ```
  */
 declare function useOmnibarEndpoint(id: string, config: OmnibarEndpointConfig): void;
@@ -1631,4 +1665,4 @@ declare const ACTION_MODAL = "__hotkeys:modal";
 declare const ACTION_OMNIBAR = "__hotkeys:omnibar";
 declare const ACTION_LOOKUP = "__hotkeys:lookup";
 
-export { ACTION_LOOKUP, ACTION_MODAL, ACTION_OMNIBAR, type ActionConfig, type ActionDefinition, type ActionHandler, type ActionRegistry, type ActionSearchResult, ActionsRegistryContext, type ActionsRegistryValue, Alt, Backspace, type BindingInfo, Command, Ctrl, DEFAULT_SEQUENCE_TIMEOUT, DIGITS_PLACEHOLDER, DIGIT_PLACEHOLDER, Down, type EndpointPagination, type EndpointPaginationInfo, type EndpointPaginationMode, type EndpointQueryResult, type EndpointResponse, Enter, type FuzzyMatchResult, type GroupRenderer, type GroupRendererProps, type HandlerMap, type HotkeyHandler, type HotkeyMap, type HotkeySequence, type HotkeysConfig, type HotkeysContextValue, HotkeysProvider, type HotkeysProviderProps, Kbd, KbdLookup, KbdModal, KbdOmnibar, type KbdProps, Kbds, Key, type KeyCombination, type KeyCombinationDisplay, type KeyConflict, type KeyIconProps, type KeyIconType, type KeySeq, KeybindingEditor, type KeybindingEditorProps, type KeybindingEditorRenderProps, Left, LookupModal, ModifierIcon, type ModifierIconProps, type ModifierType, type Modifiers, Omnibar, type OmnibarActionEntry, type OmnibarEndpointConfig, OmnibarEndpointsRegistryContext, type OmnibarEndpointsRegistryValue, type OmnibarEntry, type OmnibarEntryBase, type OmnibarLinkEntry, type OmnibarProps, type OmnibarRenderProps, Option, type RecordHotkeyOptions, type RecordHotkeyResult, type RegisteredAction, type RegisteredEndpoint, type RemoteOmnibarResult, Right, type SeqElem, type SeqElemState, type SeqMatchState, type SequenceCompletion, SequenceModal, Shift, type ShortcutGroup, ShortcutsModal, type ShortcutsModalProps, type ShortcutsModalRenderProps, type TooltipComponent, type TooltipProps, type TwoColumnConfig, type TwoColumnRow, Up, type UseEditableHotkeysOptions, type UseEditableHotkeysResult, type UseHotkeysOptions, type UseHotkeysResult, type UseOmnibarOptions, type UseOmnibarResult, countPlaceholders, createTwoColumnRenderer, extractCaptures, findConflicts, formatBinding, formatCombination, formatKeyForDisplay, formatKeySeq, fuzzyMatch, getActionBindings, getConflictsArray, getKeyIcon, getModifierIcon, getSequenceCompletions, hasConflicts, hasDigitPlaceholders, hotkeySequenceToKeySeq, isDigitPlaceholder, isMac, isModifierKey, isPlaceholderSentinel, isSequence, isShiftedSymbol, keySeqToHotkeySequence, normalizeKey, parseHotkeyString, parseKeySeq, searchActions, useAction, useActions, useActionsRegistry, useEditableHotkeys, useHotkeys, useHotkeysContext, useMaybeHotkeysContext, useOmnibar, useOmnibarEndpoint, useOmnibarEndpointsRegistry, useRecordHotkey };
+export { ACTION_LOOKUP, ACTION_MODAL, ACTION_OMNIBAR, type ActionConfig, type ActionDefinition, type ActionHandler, type ActionRegistry, type ActionSearchResult, ActionsRegistryContext, type ActionsRegistryValue, Alt, Backspace, type BindingInfo, Command, Ctrl, DEFAULT_SEQUENCE_TIMEOUT, DIGITS_PLACEHOLDER, DIGIT_PLACEHOLDER, Down, type EndpointPagination, type EndpointPaginationInfo, type EndpointPaginationMode, type EndpointQueryResult, type EndpointResponse, Enter, type FuzzyMatchResult, type GroupRenderer, type GroupRendererProps, type HandlerMap, type HotkeyHandler, type HotkeyMap, type HotkeySequence, type HotkeysConfig, type HotkeysContextValue, HotkeysProvider, type HotkeysProviderProps, Kbd, KbdLookup, KbdModal, KbdOmnibar, type KbdProps, Kbds, Key, type KeyCombination, type KeyCombinationDisplay, type KeyConflict, type KeyIconProps, type KeyIconType, type KeySeq, KeybindingEditor, type KeybindingEditorProps, type KeybindingEditorRenderProps, Left, LookupModal, ModifierIcon, type ModifierIconProps, type ModifierType, type Modifiers, Omnibar, type OmnibarActionEntry, type OmnibarEndpointAsyncConfig, type OmnibarEndpointConfig, type OmnibarEndpointConfigBase, type OmnibarEndpointSyncConfig, OmnibarEndpointsRegistryContext, type OmnibarEndpointsRegistryValue, type OmnibarEntry, type OmnibarEntryBase, type OmnibarLinkEntry, type OmnibarProps, type OmnibarRenderProps, Option, type RecordHotkeyOptions, type RecordHotkeyResult, type RegisteredAction, type RegisteredEndpoint, type RemoteOmnibarResult, Right, type SeqElem, type SeqElemState, type SeqMatchState, type SequenceCompletion, SequenceModal, Shift, type ShortcutGroup, ShortcutsModal, type ShortcutsModalProps, type ShortcutsModalRenderProps, type TooltipComponent, type TooltipProps, type TwoColumnConfig, type TwoColumnRow, Up, type UseEditableHotkeysOptions, type UseEditableHotkeysResult, type UseHotkeysOptions, type UseHotkeysResult, type UseOmnibarOptions, type UseOmnibarResult, countPlaceholders, createTwoColumnRenderer, extractCaptures, findConflicts, formatBinding, formatCombination, formatKeyForDisplay, formatKeySeq, fuzzyMatch, getActionBindings, getConflictsArray, getKeyIcon, getModifierIcon, getSequenceCompletions, hasConflicts, hasDigitPlaceholders, hotkeySequenceToKeySeq, isDigitPlaceholder, isMac, isModifierKey, isPlaceholderSentinel, isSequence, isShiftedSymbol, keySeqToHotkeySequence, normalizeKey, parseHotkeyString, parseKeySeq, searchActions, useAction, useActions, useActionsRegistry, useEditableHotkeys, useHotkeys, useHotkeysContext, useMaybeHotkeysContext, useOmnibar, useOmnibarEndpoint, useOmnibarEndpointsRegistry, useRecordHotkey };

package/dist/index.js

@@ -176,7 +176,8 @@ function useActionsRegistry(options = {}) {
       registry[id] = {
         label: config.label,
         group: config.group,
-        keywords: config.keywords
+        keywords: config.keywords,
+        hideFromModal: config.hideFromModal
       };
     }
     return registry;
@@ -296,7 +297,6 @@ function useOmnibarEndpointsRegistry() {
   const queryEndpoint = useCallback(async (endpointId, query, pagination, signal) => {
     const ep = endpointsRef.current.get(endpointId);
     if (!ep) return null;
-    if (ep.config.enabled === false) return null;
     if (query.length < (ep.config.minQueryLength ?? 2)) return null;
     try {
       const response = await ep.config.fetch(query, signal, pagination);
@@ -323,7 +323,11 @@ function useOmnibarEndpointsRegistry() {
   }, []);
   const queryAll = useCallback(async (query, signal) => {
     const endpoints2 = Array.from(endpointsRef.current.values());
-    const promises = endpoints2.filter((ep) => ep.config.enabled !== false).filter((ep) => query.length >= (ep.config.minQueryLength ?? 2)).map(async (ep) => {
+    const filteredByMinQuery = endpoints2.filter((ep) => {
+      const minLen = ep.config.minQueryLength ?? 2;
+      return query.length >= minLen;
+    });
+    const promises = filteredByMinQuery.map(async (ep) => {
       const pageSize = ep.config.pageSize ?? 10;
       const result = await queryEndpoint(ep.id, query, { offset: 0, limit: pageSize }, signal);
       return result ?? { endpointId: ep.id, entries: [] };
@@ -1731,18 +1735,36 @@ function useOmnibarEndpoint(id, config) {
   }
   const registryRef = useRef(registry);
   registryRef.current = registry;
-  const fetchRef = useRef(config.fetch);
-  fetchRef.current = config.fetch;
+  const isSync = "filter" in config && config.filter !== void 0;
+  const fetchFn = isSync ? void 0 : config.fetch;
+  const filterFn = isSync ? config.filter : void 0;
+  const fetchRef = useRef(fetchFn);
+  fetchRef.current = fetchFn;
+  const filterRef = useRef(filterFn);
+  filterRef.current = filterFn;
+  const isSyncRef = useRef(isSync);
+  isSyncRef.current = isSync;
   const enabledRef = useRef(config.enabled ?? true);
   enabledRef.current = config.enabled ?? true;
   useEffect(() => {
-    registryRef.current.register(id, {
-      ...config,
+    const asyncConfig = {
+      group: config.group,
+      priority: config.priority,
+      minQueryLength: config.minQueryLength,
+      enabled: config.enabled,
+      pageSize: config.pageSize,
+      pagination: config.pagination,
+      isSync: isSyncRef.current,
+      // Track sync endpoints to skip debouncing
       fetch: async (query, signal, pagination) => {
         if (!enabledRef.current) return { entries: [] };
+        if (isSyncRef.current && filterRef.current) {
+          return filterRef.current(query, pagination);
+        }
         return fetchRef.current(query, signal, pagination);
       }
-    });
+    };
+    registryRef.current.register(id, asyncConfig);
     return () => {
       registryRef.current.unregister(id);
     };
@@ -1753,7 +1775,7 @@ function useOmnibarEndpoint(id, config) {
     config.minQueryLength,
     config.pageSize,
     config.pagination
-    // Note: we use refs for fetch and enabled, so they don't cause re-registration
+    // Note: we use refs for fetch/filter and enabled, so they don't cause re-registration
   ]);
 }
 function useEventCallback(fn) {
@@ -2177,50 +2199,99 @@ function useOmnibar(options) {
       abortControllerRef.current.abort();
       abortControllerRef.current = null;
     }
-    if (!endpointsRegistry || !query.trim()) {
+    if (!endpointsRegistry) {
       setEndpointStates(/* @__PURE__ */ new Map());
       return;
     }
-    setEndpointStates((prev) => {
-      const next = new Map(prev);
-      for (const [id] of endpointsRegistry.endpoints) {
-        next.set(id, { entries: [], offset: 0, isLoading: true });
+    const syncEndpoints = [];
+    const asyncEndpoints = [];
+    for (const [id, ep] of endpointsRegistry.endpoints) {
+      if (ep.config.isSync) {
+        syncEndpoints.push(id);
+      } else {
+        asyncEndpoints.push(id);
       }
-      return next;
-    });
-    debounceTimerRef.current = setTimeout(async () => {
-      const controller = new AbortController();
-      abortControllerRef.current = controller;
-      try {
-        const endpointResults = await endpointsRegistry.queryAll(query, controller.signal);
-        if (controller.signal.aborted) return;
-        setEndpointStates(() => {
-          const next = /* @__PURE__ */ new Map();
-          for (const epResult of endpointResults) {
-            const ep = endpointsRegistry.endpoints.get(epResult.endpointId);
-            const pageSize = ep?.config.pageSize ?? 10;
-            next.set(epResult.endpointId, {
-              entries: epResult.entries,
-              offset: pageSize,
-              total: epResult.total,
-              hasMore: epResult.hasMore ?? (epResult.total !== void 0 ? epResult.entries.length < epResult.total : void 0),
-              isLoading: false
-            });
-          }
-          return next;
-        });
-      } catch (error) {
-        if (error instanceof Error && error.name === "AbortError") return;
-        console.error("Omnibar endpoint query failed:", error);
+    }
+    const updateEndpointState = (epResult) => {
+      const ep = endpointsRegistry.endpoints.get(epResult.endpointId);
+      const pageSize = ep?.config.pageSize ?? 10;
+      return {
+        entries: epResult.entries,
+        offset: pageSize,
+        total: epResult.total,
+        hasMore: epResult.hasMore ?? (epResult.total !== void 0 ? epResult.entries.length < epResult.total : void 0),
+        isLoading: false
+      };
+    };
+    if (syncEndpoints.length > 0) {
+      const syncController = new AbortController();
+      Promise.all(
+        syncEndpoints.map(
+          (id) => endpointsRegistry.queryEndpoint(id, query, { offset: 0, limit: endpointsRegistry.endpoints.get(id)?.config.pageSize ?? 10 }, syncController.signal)
+        )
+      ).then((results2) => {
+        if (syncController.signal.aborted) return;
         setEndpointStates((prev) => {
           const next = new Map(prev);
-          for (const [id, state] of next) {
-            next.set(id, { ...state, isLoading: false });
+          for (const result of results2) {
+            if (result) {
+              next.set(result.endpointId, updateEndpointState(result));
+            }
           }
           return next;
         });
-      }
-    }, debounceMs);
+      });
+    }
+    if (asyncEndpoints.length > 0) {
+      setEndpointStates((prev) => {
+        const next = new Map(prev);
+        for (const id of asyncEndpoints) {
+          const existing = prev.get(id);
+          next.set(id, {
+            entries: existing?.entries ?? [],
+            offset: existing?.offset ?? 0,
+            total: existing?.total,
+            hasMore: existing?.hasMore,
+            isLoading: true
+          });
+        }
+        return next;
+      });
+      debounceTimerRef.current = setTimeout(async () => {
+        const controller = new AbortController();
+        abortControllerRef.current = controller;
+        try {
+          const results2 = await Promise.all(
+            asyncEndpoints.map(
+              (id) => endpointsRegistry.queryEndpoint(id, query, { offset: 0, limit: endpointsRegistry.endpoints.get(id)?.config.pageSize ?? 10 }, controller.signal)
+            )
+          );
+          if (controller.signal.aborted) return;
+          setEndpointStates((prev) => {
+            const next = new Map(prev);
+            for (const result of results2) {
+              if (result) {
+                next.set(result.endpointId, updateEndpointState(result));
+              }
+            }
+            return next;
+          });
+        } catch (error) {
+          if (error instanceof Error && error.name === "AbortError") return;
+          console.error("Omnibar endpoint query failed:", error);
+          setEndpointStates((prev) => {
+            const next = new Map(prev);
+            for (const id of asyncEndpoints) {
+              const state = next.get(id);
+              if (state) {
+                next.set(id, { ...state, isLoading: false });
+              }
+            }
+            return next;
+          });
+        }
+      }, debounceMs);
+    }
     return () => {
       if (debounceTimerRef.current) {
         clearTimeout(debounceTimerRef.current);