@seekora-ai/ui-sdk-react 0.2.13 → 0.2.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (74) hide show
  1. package/dist/components/CurrentRefinements.d.ts +22 -2
  2. package/dist/components/CurrentRefinements.d.ts.map +1 -1
  3. package/dist/components/CurrentRefinements.js +199 -47
  4. package/dist/components/Facets.d.ts +30 -1
  5. package/dist/components/Facets.d.ts.map +1 -1
  6. package/dist/components/Facets.js +418 -46
  7. package/dist/components/HierarchicalMenu.d.ts.map +1 -1
  8. package/dist/components/HierarchicalMenu.js +112 -4
  9. package/dist/components/Pagination.d.ts +47 -1
  10. package/dist/components/Pagination.d.ts.map +1 -1
  11. package/dist/components/Pagination.js +166 -28
  12. package/dist/components/RangeSlider.d.ts.map +1 -1
  13. package/dist/components/RangeSlider.js +49 -2
  14. package/dist/components/RichQuerySuggestions.d.ts +7 -0
  15. package/dist/components/RichQuerySuggestions.d.ts.map +1 -1
  16. package/dist/components/SearchBar.d.ts +16 -0
  17. package/dist/components/SearchBar.d.ts.map +1 -1
  18. package/dist/components/SearchBar.js +130 -16
  19. package/dist/components/SearchProvider.d.ts +8 -1
  20. package/dist/components/SearchProvider.d.ts.map +1 -1
  21. package/dist/components/SearchProvider.js +16 -4
  22. package/dist/components/SearchResults.d.ts +10 -0
  23. package/dist/components/SearchResults.d.ts.map +1 -1
  24. package/dist/components/SearchResults.js +9 -5
  25. package/dist/components/SortBy.d.ts +44 -4
  26. package/dist/components/SortBy.d.ts.map +1 -1
  27. package/dist/components/SortBy.js +154 -29
  28. package/dist/components/Stats.d.ts +14 -0
  29. package/dist/components/Stats.d.ts.map +1 -1
  30. package/dist/components/Stats.js +172 -23
  31. package/dist/components/suggestions/AmazonDropdown.d.ts.map +1 -1
  32. package/dist/components/suggestions/AmazonDropdown.js +2 -4
  33. package/dist/components/suggestions/GoogleDropdown.d.ts.map +1 -1
  34. package/dist/components/suggestions/GoogleDropdown.js +2 -6
  35. package/dist/components/suggestions/MinimalDropdown.d.ts.map +1 -1
  36. package/dist/components/suggestions/MinimalDropdown.js +2 -4
  37. package/dist/components/suggestions/MobileSheetDropdown.d.ts.map +1 -1
  38. package/dist/components/suggestions/MobileSheetDropdown.js +2 -4
  39. package/dist/components/suggestions/PinterestDropdown.d.ts.map +1 -1
  40. package/dist/components/suggestions/PinterestDropdown.js +2 -6
  41. package/dist/components/suggestions/ShopifyDropdown.d.ts.map +1 -1
  42. package/dist/components/suggestions/ShopifyDropdown.js +2 -4
  43. package/dist/components/suggestions/SpotlightDropdown.d.ts.map +1 -1
  44. package/dist/components/suggestions/SpotlightDropdown.js +2 -4
  45. package/dist/components/suggestions/utils.d.ts +10 -1
  46. package/dist/components/suggestions/utils.d.ts.map +1 -1
  47. package/dist/components/suggestions/utils.js +36 -0
  48. package/dist/components/suggestions-primitives/highlightMarkup.d.ts +16 -4
  49. package/dist/components/suggestions-primitives/highlightMarkup.d.ts.map +1 -1
  50. package/dist/components/suggestions-primitives/highlightMarkup.js +42 -4
  51. package/dist/hooks/useClickTracking.d.ts +36 -0
  52. package/dist/hooks/useClickTracking.d.ts.map +1 -0
  53. package/dist/hooks/useClickTracking.js +96 -0
  54. package/dist/hooks/useExperiment.d.ts +25 -0
  55. package/dist/hooks/useExperiment.d.ts.map +1 -0
  56. package/dist/hooks/useExperiment.js +146 -0
  57. package/dist/hooks/useKeyboardNavigation.d.ts +51 -0
  58. package/dist/hooks/useKeyboardNavigation.d.ts.map +1 -0
  59. package/dist/hooks/useKeyboardNavigation.js +113 -0
  60. package/dist/hooks/useQuerySuggestions.d.ts.map +1 -1
  61. package/dist/hooks/useQuerySuggestions.js +19 -3
  62. package/dist/hooks/useQuerySuggestionsEnhanced.d.ts.map +1 -1
  63. package/dist/hooks/useQuerySuggestionsEnhanced.js +23 -6
  64. package/dist/hooks/useSuggestionsAnalytics.d.ts.map +1 -1
  65. package/dist/hooks/useSuggestionsAnalytics.js +6 -1
  66. package/dist/index.d.ts +4 -1
  67. package/dist/index.d.ts.map +1 -1
  68. package/dist/index.umd.js +1 -1
  69. package/dist/src/index.d.ts +217 -16
  70. package/dist/src/index.esm.js +1586 -249
  71. package/dist/src/index.esm.js.map +1 -1
  72. package/dist/src/index.js +1585 -248
  73. package/dist/src/index.js.map +1 -1
  74. package/package.json +3 -3
@@ -1,6 +1,6 @@
1
1
  /**
2
2
  * Parses suggestion text containing <mark>...</mark> and returns React nodes
3
- * with the marked segments rendered as <mark> elements. Safe: inner content
3
+ * with the marked segments rendered as styled elements. Safe: inner content
4
4
  * is rendered as text, not HTML.
5
5
  */
6
6
  import React from 'react';
@@ -10,9 +10,40 @@ const defaultMarkStyle = {
10
10
  borderRadius: '2px',
11
11
  padding: '0 2px',
12
12
  };
13
+ /** Compute styles based on highlight options */
14
+ function computeHighlightStyles(options) {
15
+ const style = options.highlightStyle || 'background';
16
+ const base = {};
17
+ switch (style) {
18
+ case 'background':
19
+ base.backgroundColor = options.highlightColor || 'var(--seekora-highlight-bg, rgba(251, 191, 36, 0.4))';
20
+ base.borderRadius = '2px';
21
+ base.padding = '0 2px';
22
+ break;
23
+ case 'underline':
24
+ base.textDecoration = 'underline';
25
+ base.textDecorationColor = options.highlightColor || 'var(--seekora-highlight-bg, rgba(251, 191, 36, 0.8))';
26
+ base.textUnderlineOffset = '2px';
27
+ break;
28
+ case 'bold':
29
+ // Only bold, no background
30
+ break;
31
+ case 'color-only':
32
+ // Only color, no background
33
+ break;
34
+ }
35
+ if (options.highlightTextColor) {
36
+ base.color = options.highlightTextColor;
37
+ }
38
+ else {
39
+ base.color = 'var(--seekora-highlight-color, inherit)';
40
+ }
41
+ base.fontWeight = options.highlightFontWeight || 'var(--seekora-highlight-weight, 500)';
42
+ return base;
43
+ }
13
44
  /**
14
45
  * Converts a string like "lined <mark>blue</mark>" into React nodes with
15
- * the marked part rendered as a <mark> element. When no <mark> tags are
46
+ * the marked part rendered as a styled element. When no <mark> tags are
16
47
  * present, returns the string as-is.
17
48
  */
18
49
  export function parseHighlightMarkup(text, options = {}) {
@@ -21,11 +52,18 @@ export function parseHighlightMarkup(text, options = {}) {
21
52
  const parts = text.split(/(<mark>[\s\S]*?<\/mark>)/g);
22
53
  if (parts.length <= 1)
23
54
  return text;
24
- const { markClassName, markStyle } = options;
55
+ const { markClassName, markStyle, highlightTag } = options;
56
+ const Tag = (highlightTag || 'mark');
57
+ // Compute styles: if no custom options provided, use legacy defaults
58
+ const hasCustomOptions = options.highlightColor || options.highlightTextColor
59
+ || options.highlightFontWeight || options.highlightStyle;
60
+ const computedStyle = hasCustomOptions
61
+ ? computeHighlightStyles(options)
62
+ : defaultMarkStyle;
25
63
  return (React.createElement(React.Fragment, null, parts.map((part, i) => {
26
64
  const m = part.match(/^<mark>([\s\S]*)<\/mark>$/);
27
65
  if (m) {
28
- return (React.createElement("mark", { key: i, className: markClassName, style: { ...defaultMarkStyle, ...markStyle } }, m[1]));
66
+ return (React.createElement(Tag, { key: i, className: markClassName, style: { ...computedStyle, ...markStyle } }, m[1]));
29
67
  }
30
68
  return part;
31
69
  })));
@@ -0,0 +1,36 @@
1
+ /**
2
+ * useClickTracking Hook
3
+ *
4
+ * Wraps result link clicks with analytics fire-before-navigate.
5
+ * - For target="_blank" links: fires analytics normally (page stays)
6
+ * - For same-page navigation: uses sendBeacon + small delay before navigation
7
+ * - Tracks click_target: 'new_tab' | 'same_page' | 'in_page'
8
+ * - Includes destination_url and source_url in click event payload
9
+ */
10
+ export type ClickTarget = 'new_tab' | 'same_page' | 'in_page';
11
+ export interface ClickTrackingOptions {
12
+ /** The destination URL the user is navigating to */
13
+ destinationUrl?: string;
14
+ /** The clicked item ID */
15
+ itemId: string;
16
+ /** Position in search results (1-based) */
17
+ position: number;
18
+ /** Click target type */
19
+ clickTarget?: ClickTarget;
20
+ /** Additional metadata */
21
+ metadata?: Record<string, unknown>;
22
+ }
23
+ export interface UseClickTrackingReturn {
24
+ /**
25
+ * Track a click event and optionally delay navigation.
26
+ * Returns a promise that resolves when tracking is complete.
27
+ */
28
+ trackClick: (options: ClickTrackingOptions) => Promise<void>;
29
+ /**
30
+ * Create an onClick handler that tracks before navigating.
31
+ * Use this to wrap <a> tag clicks.
32
+ */
33
+ createClickHandler: (options: ClickTrackingOptions, onComplete?: () => void) => (e: React.MouseEvent<HTMLAnchorElement>) => void;
34
+ }
35
+ export declare const useClickTracking: () => UseClickTrackingReturn;
36
+ //# sourceMappingURL=useClickTracking.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"useClickTracking.d.ts","sourceRoot":"","sources":["../../src/hooks/useClickTracking.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;AAE9D,MAAM,WAAW,oBAAoB;IACnC,oDAAoD;IACpD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,UAAU,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D;;;OAGG;IACH,kBAAkB,EAAE,CAClB,OAAO,EAAE,oBAAoB,EAC7B,UAAU,CAAC,EAAE,MAAM,IAAI,KACpB,CAAC,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;CACvD;AAED,eAAO,MAAM,gBAAgB,QAAO,sBAwFnC,CAAC"}
@@ -0,0 +1,96 @@
1
+ /**
2
+ * useClickTracking Hook
3
+ *
4
+ * Wraps result link clicks with analytics fire-before-navigate.
5
+ * - For target="_blank" links: fires analytics normally (page stays)
6
+ * - For same-page navigation: uses sendBeacon + small delay before navigation
7
+ * - Tracks click_target: 'new_tab' | 'same_page' | 'in_page'
8
+ * - Includes destination_url and source_url in click event payload
9
+ */
10
+ import { useCallback, useRef } from 'react';
11
+ import { useSearchContext } from '../components/SearchProvider';
12
+ import { useSearchState } from './useSearchState';
13
+ import { sendAnalyticsBeacon } from '@seekora-ai/ui-sdk-core';
14
+ export const useClickTracking = () => {
15
+ const { client, enableAnalytics, stateManager } = useSearchContext();
16
+ const { results } = useSearchState();
17
+ const pendingRef = useRef(false);
18
+ const trackClick = useCallback(async (options) => {
19
+ if (!enableAnalytics || pendingRef.current)
20
+ return;
21
+ pendingRef.current = true;
22
+ try {
23
+ const sourceUrl = typeof window !== 'undefined' ? window.location.href : undefined;
24
+ const searchContext = results?.context;
25
+ // Include A/B test fields from state manager (beacon payloads bypass client.trackEvent)
26
+ const abTestId = stateManager.getAbTestId?.();
27
+ const abVariant = stateManager.getAbVariant?.();
28
+ const eventPayload = {
29
+ event_name: 'product_click',
30
+ clicked_item_id: options.itemId,
31
+ position: options.position,
32
+ destination_url: options.destinationUrl || '',
33
+ source_url: sourceUrl || '',
34
+ click_target: options.clickTarget || 'in_page',
35
+ ...(abTestId && { ab_test_id: abTestId }),
36
+ ...(abVariant && { ab_variant: abVariant }),
37
+ ...options.metadata,
38
+ };
39
+ // For same_page navigation, use sendBeacon for reliability
40
+ if (options.clickTarget === 'same_page') {
41
+ if (client.trackClick) {
42
+ // Try sendBeacon approach
43
+ const baseUrl = client.baseUrl || client.apiUrl || '';
44
+ if (baseUrl) {
45
+ sendAnalyticsBeacon(`${baseUrl}/api/analytics/event`, {
46
+ ...eventPayload,
47
+ ...(searchContext || {}),
48
+ });
49
+ }
50
+ }
51
+ }
52
+ else {
53
+ // Normal tracking via client SDK
54
+ if (client.trackClick) {
55
+ await client.trackClick(options.itemId, options.position, searchContext);
56
+ }
57
+ else if (client.trackEvent) {
58
+ await client.trackEvent(eventPayload, searchContext);
59
+ }
60
+ }
61
+ }
62
+ catch {
63
+ // Silently fail — analytics should never break navigation
64
+ }
65
+ finally {
66
+ pendingRef.current = false;
67
+ }
68
+ }, [client, enableAnalytics, results, stateManager]);
69
+ const createClickHandler = useCallback((options, onComplete) => {
70
+ return (e) => {
71
+ const anchor = e.currentTarget;
72
+ const href = anchor.href;
73
+ const target = anchor.target;
74
+ const isNewTab = target === '_blank' || e.metaKey || e.ctrlKey;
75
+ const clickTarget = isNewTab ? 'new_tab' : 'same_page';
76
+ const trackOptions = { ...options, destinationUrl: href, clickTarget };
77
+ if (isNewTab) {
78
+ // New tab: page stays, track normally
79
+ trackClick(trackOptions);
80
+ onComplete?.();
81
+ }
82
+ else {
83
+ // Same page: prevent default, track with beacon, then navigate
84
+ e.preventDefault();
85
+ trackClick(trackOptions).then(() => {
86
+ // Small delay to ensure beacon fires
87
+ setTimeout(() => {
88
+ onComplete?.();
89
+ window.location.href = href;
90
+ }, 50);
91
+ });
92
+ }
93
+ };
94
+ }, [trackClick]);
95
+ return { trackClick, createClickHandler };
96
+ };
@@ -0,0 +1,25 @@
1
+ /**
2
+ * useExperiment Hook
3
+ *
4
+ * Fetches experiment variant assignments from the backend and caches them.
5
+ * Auto-injects ab_test_id and ab_variant into SearchProvider context.
6
+ *
7
+ * Usage:
8
+ * const { experimentId, variantId, variantConfig, isLoading } = useExperiment('search-ranking-v2');
9
+ */
10
+ export interface ExperimentAssignment {
11
+ experiment_id: string;
12
+ variant_id: string;
13
+ variant_config?: Record<string, unknown>;
14
+ }
15
+ export interface UseExperimentReturn {
16
+ experimentId: string | null;
17
+ variantId: string | null;
18
+ variantConfig: Record<string, unknown> | null;
19
+ isLoading: boolean;
20
+ error: Error | null;
21
+ /** All active assignments for the current user */
22
+ allAssignments: ExperimentAssignment[];
23
+ }
24
+ export declare const useExperiment: (experimentId?: string) => UseExperimentReturn;
25
+ //# sourceMappingURL=useExperiment.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"useExperiment.d.ts","sourceRoot":"","sources":["../../src/hooks/useExperiment.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC9C,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,kDAAkD;IAClD,cAAc,EAAE,oBAAoB,EAAE,CAAC;CACxC;AAsCD,eAAO,MAAM,aAAa,GAAI,eAAe,MAAM,KAAG,mBAkHrD,CAAC"}
@@ -0,0 +1,146 @@
1
+ /**
2
+ * useExperiment Hook
3
+ *
4
+ * Fetches experiment variant assignments from the backend and caches them.
5
+ * Auto-injects ab_test_id and ab_variant into SearchProvider context.
6
+ *
7
+ * Usage:
8
+ * const { experimentId, variantId, variantConfig, isLoading } = useExperiment('search-ranking-v2');
9
+ */
10
+ import { useState, useEffect, useCallback, useRef } from 'react';
11
+ import { useSearchContext } from '../components/SearchProvider';
12
+ const CACHE_PREFIX = 'seekora_experiment_';
13
+ const CACHE_TTL_MS = 24 * 60 * 60 * 1000; // 24 hours
14
+ function getCachedAssignment(userKey, experimentId) {
15
+ if (typeof localStorage === 'undefined')
16
+ return null;
17
+ try {
18
+ const key = `${CACHE_PREFIX}${userKey}_${experimentId}`;
19
+ const raw = localStorage.getItem(key);
20
+ if (!raw)
21
+ return null;
22
+ const cached = JSON.parse(raw);
23
+ if (Date.now() - cached.timestamp > CACHE_TTL_MS) {
24
+ localStorage.removeItem(key);
25
+ return null;
26
+ }
27
+ return cached.assignment;
28
+ }
29
+ catch {
30
+ return null;
31
+ }
32
+ }
33
+ function setCachedAssignment(userKey, assignment) {
34
+ if (typeof localStorage === 'undefined')
35
+ return;
36
+ try {
37
+ const key = `${CACHE_PREFIX}${userKey}_${assignment.experiment_id}`;
38
+ const cached = { assignment, timestamp: Date.now() };
39
+ localStorage.setItem(key, JSON.stringify(cached));
40
+ }
41
+ catch {
42
+ // Silently fail — localStorage may be full or unavailable
43
+ }
44
+ }
45
+ export const useExperiment = (experimentId) => {
46
+ const { client, stateManager } = useSearchContext();
47
+ const [allAssignments, setAllAssignments] = useState([]);
48
+ const [isLoading, setIsLoading] = useState(false);
49
+ const [error, setError] = useState(null);
50
+ const fetchedRef = useRef(false);
51
+ const fetchAssignments = useCallback(async () => {
52
+ if (fetchedRef.current)
53
+ return;
54
+ fetchedRef.current = true;
55
+ setIsLoading(true);
56
+ try {
57
+ // Get user key from client config or generate anonymous one
58
+ const clientAny = client;
59
+ const baseUrl = clientAny.baseUrl || clientAny.apiUrl || '';
60
+ const storeId = clientAny.storeId || clientAny.xStoreId || '';
61
+ if (!baseUrl || !storeId) {
62
+ setIsLoading(false);
63
+ return;
64
+ }
65
+ // Try to determine user key
66
+ const userKey = clientAny.userId || clientAny.anonymousId || clientAny.anonId || '';
67
+ if (!userKey) {
68
+ setIsLoading(false);
69
+ return;
70
+ }
71
+ // Check cache first for specific experiment
72
+ if (experimentId) {
73
+ const cached = getCachedAssignment(userKey, experimentId);
74
+ if (cached) {
75
+ setAllAssignments([cached]);
76
+ // Update state manager and SDK client with cached assignment
77
+ stateManager.setAbTest(cached.experiment_id, cached.variant_id);
78
+ if (typeof client.setAbTest === 'function') {
79
+ client.setAbTest(cached.experiment_id, cached.variant_id);
80
+ }
81
+ setIsLoading(false);
82
+ return;
83
+ }
84
+ }
85
+ // Fetch from backend (requires store authentication for orgID resolution)
86
+ const readSecret = clientAny.readSecret || clientAny.storeSecret || '';
87
+ const headers = {
88
+ 'x-storeid': storeId,
89
+ 'x-user-id': userKey,
90
+ };
91
+ if (readSecret) {
92
+ headers['x-storesecret'] = readSecret;
93
+ }
94
+ const response = await fetch(`${baseUrl}/api/v1/experiments/assignment`, {
95
+ headers,
96
+ });
97
+ if (!response.ok) {
98
+ throw new Error(`Failed to fetch experiment assignments: ${response.status}`);
99
+ }
100
+ const data = await response.json();
101
+ const assignments = data.assignments || [];
102
+ // Cache all assignments
103
+ assignments.forEach(a => setCachedAssignment(userKey, a));
104
+ setAllAssignments(assignments);
105
+ // If a specific experiment was requested, set it on the state manager and SDK client
106
+ const setAbFields = (expId, varId) => {
107
+ stateManager.setAbTest(expId, varId);
108
+ if (typeof client.setAbTest === 'function') {
109
+ client.setAbTest(expId, varId);
110
+ }
111
+ };
112
+ if (experimentId) {
113
+ const match = assignments.find(a => a.experiment_id === experimentId);
114
+ if (match) {
115
+ setAbFields(match.experiment_id, match.variant_id);
116
+ }
117
+ }
118
+ else if (assignments.length > 0) {
119
+ // Use the first assignment by default
120
+ setAbFields(assignments[0].experiment_id, assignments[0].variant_id);
121
+ }
122
+ setError(null);
123
+ }
124
+ catch (err) {
125
+ setError(err instanceof Error ? err : new Error(String(err)));
126
+ }
127
+ finally {
128
+ setIsLoading(false);
129
+ }
130
+ }, [client, stateManager, experimentId]);
131
+ useEffect(() => {
132
+ fetchAssignments();
133
+ }, [fetchAssignments]);
134
+ // Find the specific experiment assignment
135
+ const assignment = experimentId
136
+ ? allAssignments.find(a => a.experiment_id === experimentId)
137
+ : allAssignments[0] || null;
138
+ return {
139
+ experimentId: assignment?.experiment_id || null,
140
+ variantId: assignment?.variant_id || null,
141
+ variantConfig: assignment?.variant_config || null,
142
+ isLoading,
143
+ error,
144
+ allAssignments,
145
+ };
146
+ };
@@ -0,0 +1,51 @@
1
+ /**
2
+ * useKeyboardNavigation Hook
3
+ *
4
+ * Shared focus management for navigable component lists.
5
+ * Handles arrow keys, Enter/Space, Escape, Home/End.
6
+ * Provides visible focus indicators via CSS variables.
7
+ */
8
+ export interface KeyboardNavigationOptions {
9
+ /** Total number of items in the list */
10
+ itemCount: number;
11
+ /** Orientation: 'vertical' for up/down, 'horizontal' for left/right */
12
+ orientation?: 'vertical' | 'horizontal';
13
+ /** Whether navigation wraps around at boundaries */
14
+ wrap?: boolean;
15
+ /** Callback when an item is selected (Enter/Space) */
16
+ onSelect?: (index: number) => void;
17
+ /** Callback when Escape is pressed */
18
+ onEscape?: () => void;
19
+ /** Callback when Delete/Backspace is pressed on focused item */
20
+ onDelete?: (index: number) => void;
21
+ /** Whether keyboard navigation is enabled */
22
+ enabled?: boolean;
23
+ }
24
+ export interface UseKeyboardNavigationReturn {
25
+ /** Currently focused item index (-1 = none) */
26
+ activeIndex: number;
27
+ /** Set active index programmatically */
28
+ setActiveIndex: (index: number) => void;
29
+ /** Props to spread onto the container element */
30
+ containerProps: {
31
+ tabIndex: number;
32
+ role: string;
33
+ 'aria-activedescendant': string | undefined;
34
+ onKeyDown: (e: React.KeyboardEvent) => void;
35
+ onBlur: () => void;
36
+ };
37
+ /** Get props for an individual item */
38
+ getItemProps: (index: number) => {
39
+ id: string;
40
+ role: string;
41
+ tabIndex: number;
42
+ 'aria-selected': boolean;
43
+ onMouseEnter: () => void;
44
+ onFocus: () => void;
45
+ style: React.CSSProperties;
46
+ };
47
+ /** Whether any item is currently focused */
48
+ hasFocus: boolean;
49
+ }
50
+ export declare const useKeyboardNavigation: (options: KeyboardNavigationOptions) => UseKeyboardNavigationReturn;
51
+ //# sourceMappingURL=useKeyboardNavigation.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"useKeyboardNavigation.d.ts","sourceRoot":"","sources":["../../src/hooks/useKeyboardNavigation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,WAAW,yBAAyB;IACxC,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,WAAW,CAAC,EAAE,UAAU,GAAG,YAAY,CAAC;IACxC,oDAAoD;IACpD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,sDAAsD;IACtD,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,6CAA6C;IAC7C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,2BAA2B;IAC1C,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,iDAAiD;IACjD,cAAc,EAAE;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,uBAAuB,EAAE,MAAM,GAAG,SAAS,CAAC;QAC5C,SAAS,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,aAAa,KAAK,IAAI,CAAC;QAC5C,MAAM,EAAE,MAAM,IAAI,CAAC;KACpB,CAAC;IACF,uCAAuC;IACvC,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK;QAC/B,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,eAAe,EAAE,OAAO,CAAC;QACzB,YAAY,EAAE,MAAM,IAAI,CAAC;QACzB,OAAO,EAAE,MAAM,IAAI,CAAC;QACpB,KAAK,EAAE,KAAK,CAAC,aAAa,CAAC;KAC5B,CAAC;IACF,4CAA4C;IAC5C,QAAQ,EAAE,OAAO,CAAC;CACnB;AAaD,eAAO,MAAM,qBAAqB,GAAI,SAAS,yBAAyB,KAAG,2BAkH1E,CAAC"}
@@ -0,0 +1,113 @@
1
+ /**
2
+ * useKeyboardNavigation Hook
3
+ *
4
+ * Shared focus management for navigable component lists.
5
+ * Handles arrow keys, Enter/Space, Escape, Home/End.
6
+ * Provides visible focus indicators via CSS variables.
7
+ */
8
+ import { useState, useCallback, useRef, useEffect } from 'react';
9
+ const FOCUS_RING_STYLE = {
10
+ outline: '2px solid var(--seekora-focus-color, #2563eb)',
11
+ outlineOffset: '2px',
12
+ };
13
+ const NO_FOCUS_STYLE = {
14
+ outline: 'none',
15
+ };
16
+ let idCounter = 0;
17
+ export const useKeyboardNavigation = (options) => {
18
+ const { itemCount, orientation = 'vertical', wrap = false, onSelect, onEscape, onDelete, enabled = true, } = options;
19
+ const [activeIndex, setActiveIndex] = useState(-1);
20
+ const idPrefixRef = useRef(`seekora-nav-${++idCounter}`);
21
+ // Reset active index when item count changes
22
+ useEffect(() => {
23
+ if (activeIndex >= itemCount) {
24
+ setActiveIndex(itemCount > 0 ? itemCount - 1 : -1);
25
+ }
26
+ }, [itemCount, activeIndex]);
27
+ const moveNext = useCallback(() => {
28
+ setActiveIndex(prev => {
29
+ if (prev >= itemCount - 1) {
30
+ return wrap ? 0 : prev;
31
+ }
32
+ return prev + 1;
33
+ });
34
+ }, [itemCount, wrap]);
35
+ const movePrev = useCallback(() => {
36
+ setActiveIndex(prev => {
37
+ if (prev <= 0) {
38
+ return wrap ? itemCount - 1 : (prev === -1 ? 0 : prev);
39
+ }
40
+ return prev - 1;
41
+ });
42
+ }, [itemCount, wrap]);
43
+ const handleKeyDown = useCallback((e) => {
44
+ if (!enabled || itemCount === 0)
45
+ return;
46
+ const nextKey = orientation === 'vertical' ? 'ArrowDown' : 'ArrowRight';
47
+ const prevKey = orientation === 'vertical' ? 'ArrowUp' : 'ArrowLeft';
48
+ switch (e.key) {
49
+ case nextKey:
50
+ e.preventDefault();
51
+ moveNext();
52
+ break;
53
+ case prevKey:
54
+ e.preventDefault();
55
+ movePrev();
56
+ break;
57
+ case 'Enter':
58
+ case ' ':
59
+ if (activeIndex >= 0) {
60
+ e.preventDefault();
61
+ onSelect?.(activeIndex);
62
+ }
63
+ break;
64
+ case 'Escape':
65
+ e.preventDefault();
66
+ setActiveIndex(-1);
67
+ onEscape?.();
68
+ break;
69
+ case 'Home':
70
+ e.preventDefault();
71
+ setActiveIndex(0);
72
+ break;
73
+ case 'End':
74
+ e.preventDefault();
75
+ setActiveIndex(itemCount - 1);
76
+ break;
77
+ case 'Delete':
78
+ case 'Backspace':
79
+ if (activeIndex >= 0) {
80
+ e.preventDefault();
81
+ onDelete?.(activeIndex);
82
+ }
83
+ break;
84
+ }
85
+ }, [enabled, itemCount, orientation, activeIndex, moveNext, movePrev, onSelect, onEscape, onDelete]);
86
+ const handleBlur = useCallback(() => {
87
+ // Delay reset to allow click events to fire
88
+ setTimeout(() => setActiveIndex(-1), 150);
89
+ }, []);
90
+ const containerProps = {
91
+ tabIndex: enabled ? 0 : -1,
92
+ role: orientation === 'vertical' ? 'listbox' : 'list',
93
+ 'aria-activedescendant': activeIndex >= 0 ? `${idPrefixRef.current}-${activeIndex}` : undefined,
94
+ onKeyDown: handleKeyDown,
95
+ onBlur: handleBlur,
96
+ };
97
+ const getItemProps = useCallback((index) => ({
98
+ id: `${idPrefixRef.current}-${index}`,
99
+ role: 'option',
100
+ tabIndex: -1,
101
+ 'aria-selected': index === activeIndex,
102
+ onMouseEnter: () => setActiveIndex(index),
103
+ onFocus: () => setActiveIndex(index),
104
+ style: index === activeIndex ? FOCUS_RING_STYLE : NO_FOCUS_STYLE,
105
+ }), [activeIndex]);
106
+ return {
107
+ activeIndex,
108
+ setActiveIndex,
109
+ containerProps,
110
+ getItemProps,
111
+ hasFocus: activeIndex >= 0,
112
+ };
113
+ };
@@ -1 +1 @@
1
- {"version":3,"file":"useQuerySuggestions.d.ts","sourceRoot":"","sources":["../../src/hooks/useQuerySuggestions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED,eAAO,MAAM,mBAAmB,GAAI,yDAMjC,0BAA0B,KAAG,yBAqE/B,CAAC"}
1
+ {"version":3,"file":"useQuerySuggestions.d.ts","sourceRoot":"","sources":["../../src/hooks/useQuerySuggestions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED,eAAO,MAAM,mBAAmB,GAAI,yDAMjC,0BAA0B,KAAG,yBAuF/B,CAAC"}
@@ -46,9 +46,25 @@ export const useQuerySuggestions = ({ client, query, enabled = true, debounceMs
46
46
  }
47
47
  catch (err) {
48
48
  const error = err instanceof Error ? err : new Error(String(err));
49
- log.error('Error in useQuerySuggestions:', error);
50
- setError(error);
51
- setSuggestions([]);
49
+ // Check if it's a 404 error (suggestions not enabled for this store).
50
+ // The search SDK wraps axios errors into plain Error objects with the status
51
+ // embedded in the message, e.g. "[getSuggestions] ... (404)".
52
+ const errMsg = error.message || '';
53
+ const is404 = err?.response?.status === 404 ||
54
+ err?.status === 404 ||
55
+ /\(404\)/.test(errMsg);
56
+ if (is404) {
57
+ // Silently handle 404 - suggestions feature not enabled
58
+ log.verbose('Query suggestions not enabled for this store (404)');
59
+ setSuggestions([]);
60
+ setError(null);
61
+ }
62
+ else {
63
+ // For other errors, log and set error state
64
+ log.error('Error in useQuerySuggestions:', error);
65
+ setError(error);
66
+ setSuggestions([]);
67
+ }
52
68
  }
53
69
  finally {
54
70
  setLoading(false);
@@ -1 +1 @@
1
- {"version":3,"file":"useQuerySuggestionsEnhanced.d.ts","sourceRoot":"","sources":["../../src/hooks/useQuerySuggestionsEnhanced.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"useQuerySuggestionsEnhanced.d.ts","sourceRoot":"","sources":["../../src/hooks/useQuerySuggestionsEnhanced.ts"],"names":[],"mappings":"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"}
@@ -221,12 +221,29 @@ export function useQuerySuggestionsEnhanced(options) {
221
221
  const error = err instanceof Error ? err : new Error(String(err));
222
222
  if (error.name === 'AbortError')
223
223
  return;
224
- log.error('Failed to fetch query suggestions', { query: searchQuery, error: error.message });
225
- setError(error);
226
- setSuggestions([]);
227
- setDropdownRecommendations(null);
228
- if (onError) {
229
- onError(error);
224
+ // Check if it's a 404 error (suggestions not enabled for this store).
225
+ // The search SDK wraps axios errors into plain Error objects with the status
226
+ // embedded in the message, e.g. "[getSuggestions] ... (404)".
227
+ const errMsg = error.message || '';
228
+ const is404 = err?.response?.status === 404 ||
229
+ err?.status === 404 ||
230
+ /\(404\)/.test(errMsg);
231
+ if (is404) {
232
+ // Silently handle 404 - suggestions feature not enabled
233
+ log.verbose('Query suggestions not enabled for this store (404)');
234
+ setSuggestions([]);
235
+ setDropdownRecommendations(null);
236
+ setError(null);
237
+ }
238
+ else {
239
+ // For other errors, log and set error state
240
+ log.error('Failed to fetch query suggestions', { query: searchQuery, error: error.message });
241
+ setError(error);
242
+ setSuggestions([]);
243
+ setDropdownRecommendations(null);
244
+ if (onError) {
245
+ onError(error);
246
+ }
230
247
  }
231
248
  }
232
249
  finally {
@@ -1 +1 @@
1
- {"version":3,"file":"useSuggestionsAnalytics.d.ts","sourceRoot":"","sources":["../../src/hooks/useSuggestionsAnalytics.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"useSuggestionsAnalytics.d.ts","sourceRoot":"","sources":["../../src/hooks/useSuggestionsAnalytics.ts"],"names":[],"mappings":"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"}