@seekora-ai/ui-sdk-react 0.0.0-stage-20260517092419

package/dist/docsearch/hooks/useSeekoraSearch.js

@@ -0,0 +1,213 @@
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { SeekoraClient } from '@seekora-ai/search-sdk';
+/** Build hierarchy from doc: either nested doc.hierarchy or flat keys like doc['hierarchy.lvl0'] */
+function getHierarchy(doc) {
+    const hierarchy = {};
+    if (doc?.hierarchy && typeof doc.hierarchy === 'object') {
+        hierarchy.lvl0 = doc.hierarchy.lvl0;
+        hierarchy.lvl1 = doc.hierarchy.lvl1;
+        hierarchy.lvl2 = doc.hierarchy.lvl2;
+        hierarchy.lvl3 = doc.hierarchy.lvl3;
+        hierarchy.lvl4 = doc.hierarchy.lvl4;
+        hierarchy.lvl5 = doc.hierarchy.lvl5;
+    }
+    else if (doc && typeof doc === 'object') {
+        hierarchy.lvl0 = doc['hierarchy.lvl0'];
+        hierarchy.lvl1 = doc['hierarchy.lvl1'];
+        hierarchy.lvl2 = doc['hierarchy.lvl2'];
+        hierarchy.lvl3 = doc['hierarchy.lvl3'];
+        hierarchy.lvl4 = doc['hierarchy.lvl4'];
+        hierarchy.lvl5 = doc['hierarchy.lvl5'];
+    }
+    return hierarchy;
+}
+function transformResults(results) {
+    const stripMark = (s) => typeof s === 'string' ? s.replace(/<\/?mark>/g, '') : (s ? String(s) : '');
+    return results.map((result) => {
+        const doc = result?.document ?? result;
+        const hierarchy = getHierarchy(doc);
+        const url = doc.url || result.url || doc.route || result.route || doc.link || result.link || '';
+        const rawTitle = doc.title || result.title || doc.name || result.name || hierarchy?.lvl3 || hierarchy?.lvl2 || hierarchy?.lvl1 || hierarchy?.lvl0 || '';
+        const content = doc.content ?? result.content ?? doc.description ?? result.description ?? doc.snippet ?? result.snippet ?? '';
+        const description = doc.description ?? result.description ?? (typeof content === 'string' ? content.substring(0, 150) : '');
+        const plainTitle = stripMark(rawTitle) || stripMark(hierarchy?.lvl3) || stripMark(hierarchy?.lvl2) || stripMark(hierarchy?.lvl1) || stripMark(hierarchy?.lvl0) || 'Untitled';
+        const plainContent = stripMark(content)?.substring(0, 200) || content;
+        const apiHighlight = result?.highlight ?? doc?.highlight;
+        const highlightTitle = typeof apiHighlight?.title === 'string' ? apiHighlight.title : undefined;
+        const highlightContent = typeof apiHighlight?.content === 'string' ? apiHighlight.content : undefined;
+        return {
+            url,
+            title: plainTitle,
+            content: plainContent,
+            description: stripMark(description) || description,
+            category: doc.category ?? result.category ?? hierarchy?.lvl0 ?? '',
+            hierarchy,
+            route: doc.route ?? result.route,
+            parentTitle: doc.parent_title ?? doc.parentTitle ?? result.parent_title ?? result.parentTitle,
+            type: doc.type ?? result.type ?? '',
+            anchor: doc.anchor ?? result.anchor ?? '',
+            _source: 'seekora',
+            highlight: (highlightTitle ?? highlightContent) ? { title: highlightTitle, content: highlightContent } : undefined,
+        };
+    });
+}
+export function useSeekoraSearch(options) {
+    const { storeId, storeSecret, apiEndpoint, maxResults = 20, debounceMs = 200, analyticsTags = ['docsearch'], groupField = 'hierarchy.lvl3', groupSize = 10, } = options;
+    const [query, setQueryState] = useState('');
+    const [suggestions, setSuggestions] = useState([]);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const [selectedIndex, setSelectedIndex] = useState(0);
+    const clientRef = useRef(null);
+    const lastSearchContextRef = useRef(null);
+    const debounceTimerRef = useRef(null);
+    const abortControllerRef = useRef(null);
+    useEffect(() => {
+        if (!storeId)
+            return;
+        const config = {
+            storeId,
+            readSecret: storeSecret,
+            logLevel: 'warn',
+            enableContextCollection: true,
+            enableEventQueue: true, // Enable batching for better performance
+            eventQueue: {
+                batchSize: 10,
+                flushInterval: 5000, // 5 seconds
+                enablePersistence: true,
+            },
+        };
+        if (apiEndpoint) {
+            if (['local', 'stage', 'production'].includes(apiEndpoint)) {
+                config.environment = apiEndpoint;
+            }
+            else {
+                // Search SDK path is /v1/search; backend serves at /api/v1/search. baseUrl must include /api.
+                const base = apiEndpoint.replace(/\/$/, '');
+                config.baseUrl = base.endsWith('/api') ? base : `${base}/api`;
+            }
+        }
+        try {
+            clientRef.current = new SeekoraClient(config);
+        }
+        catch (err) {
+            console.error('Failed to initialize SeekoraClient:', err);
+            setError('Failed to initialize search client');
+        }
+        return () => {
+            clientRef.current = null;
+        };
+    }, [storeId, storeSecret, apiEndpoint]);
+    const performSearch = useCallback(async (searchQuery) => {
+        if (!clientRef.current) {
+            setError('Search client not initialized');
+            return;
+        }
+        if (!searchQuery.trim()) {
+            setSuggestions([]);
+            return;
+        }
+        if (abortControllerRef.current)
+            abortControllerRef.current.abort();
+        abortControllerRef.current = new AbortController();
+        setIsLoading(true);
+        setError(null);
+        try {
+            const response = await clientRef.current.search(searchQuery, {
+                per_page: maxResults,
+                analytics_tags: analyticsTags,
+                return_fields: [
+                    'hierarchy.lvl0', 'hierarchy.lvl1', 'hierarchy.lvl2', 'hierarchy.lvl3',
+                    'hierarchy.lvl4', 'hierarchy.lvl5', 'hierarchy.lvl6',
+                    'content', 'type', 'url', 'title', 'anchor'
+                ],
+                snippet_fields: [
+                    'hierarchy.lvl1', 'hierarchy.lvl2', 'hierarchy.lvl3',
+                    'hierarchy.lvl4', 'hierarchy.lvl5', 'hierarchy.lvl6', 'content'
+                ],
+                snippet_prefix: '<mark>',
+                snippet_suffix: '</mark>',
+                include_snippets: true,
+                group_field: groupField,
+                group_size: groupSize,
+            });
+            if (abortControllerRef.current?.signal.aborted)
+                return;
+            if (response?.context)
+                lastSearchContextRef.current = response.context;
+            setSuggestions(transformResults(response.results || []));
+            setSelectedIndex(0);
+        }
+        catch (err) {
+            if (err instanceof Error && err.name === 'AbortError')
+                return;
+            console.error('Search failed:', err);
+            setError(err instanceof Error ? err.message : 'Search failed');
+            setSuggestions([]);
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [maxResults, analyticsTags, groupField, groupSize]);
+    const setQuery = useCallback((newQuery) => {
+        setQueryState(newQuery);
+        setSelectedIndex(0);
+        if (debounceTimerRef.current)
+            clearTimeout(debounceTimerRef.current);
+        debounceTimerRef.current = setTimeout(() => performSearch(newQuery), debounceMs);
+    }, [performSearch, debounceMs]);
+    const selectNext = useCallback(() => {
+        setSelectedIndex((prev) => (prev >= suggestions.length - 1 ? 0 : prev + 1));
+    }, [suggestions.length]);
+    const selectPrev = useCallback(() => {
+        setSelectedIndex((prev) => (prev <= 0 ? suggestions.length - 1 : prev - 1));
+    }, [suggestions.length]);
+    const reset = useCallback(() => {
+        if (abortControllerRef.current)
+            abortControllerRef.current.abort();
+        if (debounceTimerRef.current)
+            clearTimeout(debounceTimerRef.current);
+        setQueryState('');
+        setSuggestions([]);
+        setIsLoading(false);
+        setError(null);
+        setSelectedIndex(0);
+    }, []);
+    const getSelectedItem = useCallback(() => {
+        return suggestions[selectedIndex] || null;
+    }, [suggestions, selectedIndex]);
+    const trackDocClick = useCallback((hit, position) => {
+        const client = clientRef.current;
+        if (!client?.trackEvent)
+            return;
+        const context = lastSearchContextRef.current ?? undefined;
+        const itemId = hit.url || hit.id || hit.title || String(position);
+        client.trackEvent({
+            event_name: 'doc_click',
+            clicked_item_id: itemId,
+            metadata: { position, result: hit, source: 'docsearch' },
+        }, context);
+    }, []);
+    useEffect(() => {
+        return () => {
+            if (abortControllerRef.current)
+                abortControllerRef.current.abort();
+            if (debounceTimerRef.current)
+                clearTimeout(debounceTimerRef.current);
+        };
+    }, []);
+    return {
+        query,
+        suggestions,
+        isLoading,
+        error,
+        selectedIndex,
+        setQuery,
+        selectNext,
+        selectPrev,
+        setSelectedIndex,
+        reset,
+        getSelectedItem,
+        trackDocClick,
+    };
+}

package/dist/docsearch/index.d.ts

@@ -0,0 +1,13 @@
+export { DocSearch } from './components/DocSearch';
+export { DocSearchButton } from './components/DocSearchButton';
+export { Modal } from './components/Modal';
+export { SearchBox } from './components/SearchBox';
+export { Results } from './components/Results';
+export { Hit } from './components/Hit';
+export { Highlight, truncateAroundMatch } from './components/Highlight';
+export { Footer } from './components/Footer';
+export { useDocSearch } from './hooks/useDocSearch';
+export { useSeekoraSearch, type UseSeekoraSearchOptions, type UseSeekoraSearchResult } from './hooks/useSeekoraSearch';
+export { useKeyboard, getShortcutText } from './hooks/useKeyboard';
+export type { DocSearchProps, DocSearchButtonProps, DocSearchHit, DocSearchSuggestion, DocSearchResponse, DocSearchSuggestionsResponse, DocSearchTranslations, DocSearchState, DocSearchAction, SearchSource, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/docsearch/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/docsearch/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7C,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,KAAK,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AACvH,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEnE,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EACjB,4BAA4B,EAC5B,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,YAAY,GACb,MAAM,SAAS,CAAC"}

package/dist/docsearch/index.js

@@ -0,0 +1,11 @@
+export { DocSearch } from './components/DocSearch';
+export { DocSearchButton } from './components/DocSearchButton';
+export { Modal } from './components/Modal';
+export { SearchBox } from './components/SearchBox';
+export { Results } from './components/Results';
+export { Hit } from './components/Hit';
+export { Highlight, truncateAroundMatch } from './components/Highlight';
+export { Footer } from './components/Footer';
+export { useDocSearch } from './hooks/useDocSearch';
+export { useSeekoraSearch } from './hooks/useSeekoraSearch';
+export { useKeyboard, getShortcutText } from './hooks/useKeyboard';

package/dist/docsearch/types.d.ts

@@ -0,0 +1,175 @@
+/**
+ * Seekora DocSearch Types
+ */
+import type React from "react";
+export interface DocSearchHit {
+    objectID: string;
+    url: string;
+    anchor?: string;
+    title: string;
+    content: string;
+    section_level: number;
+    hierarchy: {
+        lvl0?: string;
+        lvl1?: string;
+        lvl2?: string;
+        lvl3?: string;
+        lvl4?: string;
+        lvl5?: string;
+    };
+    _highlightResult?: {
+        title?: {
+            value: string;
+            matchLevel: string;
+        };
+        content?: {
+            value: string;
+            matchLevel: string;
+        };
+        hierarchy?: {
+            lvl0?: {
+                value: string;
+                matchLevel: string;
+            };
+            lvl1?: {
+                value: string;
+                matchLevel: string;
+            };
+            lvl2?: {
+                value: string;
+                matchLevel: string;
+            };
+            lvl3?: {
+                value: string;
+                matchLevel: string;
+            };
+        };
+    };
+    _source?: string;
+}
+export interface DocSearchSuggestion {
+    url: string;
+    title: string;
+    content?: string;
+    description?: string;
+    category?: string;
+    hierarchy?: {
+        lvl0?: string;
+        lvl1?: string;
+        lvl2?: string;
+        lvl3?: string;
+        lvl4?: string;
+        lvl5?: string;
+    };
+    highlight?: {
+        title?: string;
+        content?: string;
+    };
+    _source?: string;
+    route?: string;
+    parentTitle?: string;
+    type?: string;
+    anchor?: string;
+}
+export interface SearchSource {
+    id: string;
+    name: string;
+    endpoint: string;
+    apiKey?: string;
+    storeId?: string;
+    storeSecret?: string;
+    maxResults?: number;
+    minQueryLength?: number;
+    transformResults?: (data: any) => DocSearchSuggestion[];
+    openInNewTab?: boolean;
+    icon?: string;
+}
+export interface DocSearchResponse {
+    hits: DocSearchHit[];
+    query: string;
+    total?: number;
+    page?: number;
+    nbPages?: number;
+}
+export interface DocSearchSuggestionsResponse {
+    suggestions: DocSearchSuggestion[];
+    query: string;
+}
+export interface DocSearchProps {
+    storeId?: string;
+    storeSecret?: string;
+    seekoraApiEndpoint?: string;
+    apiEndpoint?: string;
+    apiKey?: string;
+    sources?: SearchSource[];
+    indexName?: string;
+    placeholder?: string;
+    maxResults?: number;
+    debounceMs?: number;
+    onSelect?: (hit: DocSearchHit | DocSearchSuggestion) => void;
+    onClose?: () => void;
+    translations?: DocSearchTranslations;
+    renderButton?: boolean;
+    buttonComponent?: React.ComponentType<DocSearchButtonProps>;
+    initialOpen?: boolean;
+    disableShortcut?: boolean;
+    shortcutKey?: string;
+    /** Post-process results per source (e.g. filter by permission, resolve :storeId). */
+    processGroupedResults?: (sourceId: string, items: DocSearchSuggestion[]) => DocSearchSuggestion[];
+    /** Additional CSS class applied to the modal overlay and container — use to scope CSS variable overrides. */
+    className?: string;
+}
+export interface DocSearchButtonProps {
+    onClick: () => void;
+    placeholder?: string;
+    /** Additional CSS class for the button element. */
+    className?: string;
+}
+export interface DocSearchTranslations {
+    buttonText?: string;
+    buttonAriaLabel?: string;
+    searchPlaceholder?: string;
+    noResultsText?: string;
+    errorText?: string;
+    footerText?: string;
+    closeText?: string;
+    searchByText?: string;
+}
+export interface DocSearchState {
+    query: string;
+    results: DocSearchHit[];
+    suggestions: DocSearchSuggestion[];
+    isLoading: boolean;
+    error: string | null;
+    selectedIndex: number;
+    mode: "suggestions" | "results";
+}
+export type DocSearchAction = {
+    type: "SET_QUERY";
+    payload: string;
+} | {
+    type: "SET_RESULTS";
+    payload: DocSearchHit[];
+} | {
+    type: "SET_SUGGESTIONS";
+    payload: DocSearchSuggestion[];
+} | {
+    type: "SET_LOADING";
+    payload: boolean;
+} | {
+    type: "SET_ERROR";
+    payload: string | null;
+} | {
+    type: "SET_SELECTED_INDEX";
+    payload: number;
+} | {
+    type: "SELECT_NEXT";
+} | {
+    type: "SELECT_PREV";
+} | {
+    type: "SET_MODE";
+    payload: "suggestions" | "results";
+} | {
+    type: "RESET";
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/docsearch/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/docsearch/types.ts"],"names":[],"mappings":"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"}

package/dist/docsearch/types.js

@@ -0,0 +1,4 @@
+/**
+ * Seekora DocSearch Types
+ */
+export {};

package/dist/docsearch.css

@@ -0,0 +1,234 @@
+/**
+ * Seekora DocSearch CSS - bundled with @seekora/ui-sdk-react
+ * Override CSS variables to customize. Dark mode: [data-theme="dark"] or prefers-color-scheme.
+ */
+
+:root {
+  --seekora-docsearch-primary: #5468ff;
+  --seekora-docsearch-primary-hover: #4458e8;
+  --seekora-docsearch-text: #1a1a1a;
+  --seekora-docsearch-text-muted: #6b7280;
+  --seekora-docsearch-text-secondary: #9ca3af;
+  --seekora-docsearch-background: #ffffff;
+  --seekora-docsearch-background-secondary: #f9fafb;
+  --seekora-docsearch-border: #e5e7eb;
+  --seekora-docsearch-border-light: #f3f4f6;
+  --seekora-docsearch-shadow: rgba(0, 0, 0, 0.1);
+  --seekora-docsearch-shadow-strong: rgba(0, 0, 0, 0.2);
+  --seekora-docsearch-overlay: rgba(0, 0, 0, 0.4);
+  --seekora-docsearch-highlight-bg: rgba(84, 104, 255, 0.1);
+  --seekora-docsearch-highlight-text: #5468ff;
+  --seekora-docsearch-hit-bg: transparent;
+  --seekora-docsearch-hit-bg-hover: #f3f4f6;
+  --seekora-docsearch-hit-bg-selected: #eef2ff;
+  --seekora-docsearch-icon: #9ca3af;
+  --seekora-docsearch-icon-active: #5468ff;
+  --seekora-docsearch-key-bg: #f3f4f6;
+  --seekora-docsearch-key-border: #d1d5db;
+  --seekora-docsearch-key-text: #6b7280;
+  --seekora-docsearch-spacing-xs: 4px;
+  --seekora-docsearch-spacing-sm: 8px;
+  --seekora-docsearch-spacing-md: 12px;
+  --seekora-docsearch-spacing-lg: 16px;
+  --seekora-docsearch-spacing-xl: 24px;
+  --seekora-docsearch-font-family: system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
+  --seekora-docsearch-font-size-xs: 11px;
+  --seekora-docsearch-font-size-sm: 13px;
+  --seekora-docsearch-font-size-md: 14px;
+  --seekora-docsearch-font-size-lg: 16px;
+  --seekora-docsearch-font-weight-normal: 400;
+  --seekora-docsearch-font-weight-medium: 500;
+  --seekora-docsearch-font-weight-semibold: 600;
+  --seekora-docsearch-line-height: 1.5;
+  --seekora-docsearch-radius-sm: 4px;
+  --seekora-docsearch-radius-md: 8px;
+  --seekora-docsearch-radius-lg: 12px;
+  --seekora-docsearch-radius-xl: 16px;
+  --seekora-docsearch-transition-fast: 100ms;
+  --seekora-docsearch-transition-normal: 150ms;
+  --seekora-docsearch-transition-slow: 200ms;
+  --seekora-docsearch-modal-width: 560px;
+  --seekora-docsearch-modal-max-height: 80vh;
+  --seekora-docsearch-modal-shadow: 0 25px 50px -12px rgba(0, 0, 0, 0.25);
+  --seekora-docsearch-z-index: 99999;
+}
+
+[data-theme="dark"], .dark {
+  --seekora-docsearch-primary: #7c8aff;
+  --seekora-docsearch-primary-hover: #6e7dff;
+  --seekora-docsearch-text: #f9fafb;
+  --seekora-docsearch-text-muted: #9ca3af;
+  --seekora-docsearch-text-secondary: #6b7280;
+  --seekora-docsearch-background: #1f2937;
+  --seekora-docsearch-background-secondary: #111827;
+  --seekora-docsearch-border: #374151;
+  --seekora-docsearch-border-light: #374151;
+  --seekora-docsearch-shadow: rgba(0, 0, 0, 0.3);
+  --seekora-docsearch-shadow-strong: rgba(0, 0, 0, 0.5);
+  --seekora-docsearch-overlay: rgba(0, 0, 0, 0.6);
+  --seekora-docsearch-highlight-bg: rgba(124, 138, 255, 0.15);
+  --seekora-docsearch-highlight-text: #a5b4fc;
+  --seekora-docsearch-hit-bg: transparent;
+  --seekora-docsearch-hit-bg-hover: #374151;
+  --seekora-docsearch-hit-bg-selected: #312e81;
+  --seekora-docsearch-icon: #6b7280;
+  --seekora-docsearch-icon-active: #7c8aff;
+  --seekora-docsearch-key-bg: #374151;
+  --seekora-docsearch-key-border: #4b5563;
+  --seekora-docsearch-key-text: #9ca3af;
+}
+
+@media (prefers-color-scheme: dark) {
+  :root:not([data-theme="light"]):not(.light) {
+    --seekora-docsearch-primary: #7c8aff;
+    --seekora-docsearch-primary-hover: #6e7dff;
+    --seekora-docsearch-text: #f9fafb;
+    --seekora-docsearch-text-muted: #9ca3af;
+    --seekora-docsearch-text-secondary: #6b7280;
+    --seekora-docsearch-background: #1f2937;
+    --seekora-docsearch-background-secondary: #111827;
+    --seekora-docsearch-border: #374151;
+    --seekora-docsearch-border-light: #374151;
+    --seekora-docsearch-shadow: rgba(0, 0, 0, 0.3);
+    --seekora-docsearch-shadow-strong: rgba(0, 0, 0, 0.5);
+    --seekora-docsearch-overlay: rgba(0, 0, 0, 0.6);
+    --seekora-docsearch-highlight-bg: rgba(124, 138, 255, 0.15);
+    --seekora-docsearch-highlight-text: #a5b4fc;
+    --seekora-docsearch-hit-bg: transparent;
+    --seekora-docsearch-hit-bg-hover: #374151;
+    --seekora-docsearch-hit-bg-selected: #312e81;
+    --seekora-docsearch-icon: #6b7280;
+    --seekora-docsearch-icon-active: #7c8aff;
+    --seekora-docsearch-key-bg: #374151;
+    --seekora-docsearch-key-border: #4b5563;
+    --seekora-docsearch-key-text: #9ca3af;
+  }
+}
+
+.seekora-docsearch-button {
+  display: flex;
+  align-items: center;
+  gap: var(--seekora-docsearch-spacing-sm);
+  padding: var(--seekora-docsearch-spacing-sm) var(--seekora-docsearch-spacing-md);
+  min-width: 200px;
+  height: 40px;
+  background: var(--seekora-docsearch-background);
+  border: 1px solid var(--seekora-docsearch-border);
+  border-radius: var(--seekora-docsearch-radius-md);
+  color: var(--seekora-docsearch-text-muted);
+  font-family: var(--seekora-docsearch-font-family);
+  font-size: var(--seekora-docsearch-font-size-md);
+  cursor: pointer;
+  transition: all var(--seekora-docsearch-transition-normal) ease;
+  box-shadow: 0 1px 2px var(--seekora-docsearch-shadow);
+}
+.seekora-docsearch-button:hover { border-color: var(--seekora-docsearch-primary); box-shadow: 0 2px 4px var(--seekora-docsearch-shadow); }
+.seekora-docsearch-button:focus { outline: none; border-color: var(--seekora-docsearch-primary); box-shadow: 0 0 0 3px var(--seekora-docsearch-highlight-bg); }
+.seekora-docsearch-button-icon { display: flex; align-items: center; justify-content: center; color: var(--seekora-docsearch-icon); flex-shrink: 0; }
+.seekora-docsearch-button-placeholder { flex: 1; text-align: left; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.seekora-docsearch-button-keys { display: flex; align-items: center; gap: var(--seekora-docsearch-spacing-xs); flex-shrink: 0; }
+.seekora-docsearch-button-key {
+  display: inline-flex; align-items: center; justify-content: center; padding: 2px 6px; min-width: 20px; height: 20px;
+  background: var(--seekora-docsearch-key-bg); border: 1px solid var(--seekora-docsearch-key-border);
+  border-radius: var(--seekora-docsearch-radius-sm); color: var(--seekora-docsearch-key-text);
+  font-family: var(--seekora-docsearch-font-family); font-size: var(--seekora-docsearch-font-size-xs);
+  font-weight: var(--seekora-docsearch-font-weight-medium); box-shadow: inset 0 -1px 0 var(--seekora-docsearch-key-border);
+}
+@media (max-width: 640px) {
+  .seekora-docsearch-button { min-width: auto; padding: var(--seekora-docsearch-spacing-sm); }
+  .seekora-docsearch-button-placeholder { display: none; }
+  .seekora-docsearch-button-keys { display: none; }
+}
+
+.seekora-docsearch-overlay {
+  position: fixed; inset: 0; z-index: var(--seekora-docsearch-z-index);
+  display: flex; align-items: flex-start; justify-content: center;
+  padding: 10vh var(--seekora-docsearch-spacing-lg);
+  background: var(--seekora-docsearch-overlay); backdrop-filter: blur(4px);
+  animation: seekora-docsearch-fade-in var(--seekora-docsearch-transition-normal) ease;
+}
+@keyframes seekora-docsearch-fade-in { from { opacity: 0; } to { opacity: 1; } }
+.seekora-docsearch-container { width: 100%; max-width: var(--seekora-docsearch-modal-width); animation: seekora-docsearch-slide-in var(--seekora-docsearch-transition-slow) ease; }
+@keyframes seekora-docsearch-slide-in { from { opacity: 0; transform: translateY(-20px) scale(0.98); } to { opacity: 1; transform: translateY(0) scale(1); } }
+.seekora-docsearch-modal {
+  display: flex; flex-direction: column; max-height: var(--seekora-docsearch-modal-max-height);
+  background: var(--seekora-docsearch-background); border: 1px solid var(--seekora-docsearch-border);
+  border-radius: var(--seekora-docsearch-radius-xl); box-shadow: var(--seekora-docsearch-modal-shadow); overflow: hidden;
+}
+.seekora-docsearch-header { display: flex; align-items: center; gap: var(--seekora-docsearch-spacing-sm); padding: var(--seekora-docsearch-spacing-md); border-bottom: 1px solid var(--seekora-docsearch-border-light); }
+.seekora-docsearch-close {
+  display: flex; align-items: center; justify-content: center;
+  padding: var(--seekora-docsearch-spacing-xs) var(--seekora-docsearch-spacing-sm);
+  background: var(--seekora-docsearch-key-bg); border: 1px solid var(--seekora-docsearch-key-border);
+  border-radius: var(--seekora-docsearch-radius-sm); color: var(--seekora-docsearch-key-text);
+  font-family: var(--seekora-docsearch-font-family); font-size: var(--seekora-docsearch-font-size-xs);
+  font-weight: var(--seekora-docsearch-font-weight-medium); cursor: pointer; transition: all var(--seekora-docsearch-transition-fast) ease; flex-shrink: 0;
+}
+.seekora-docsearch-close:hover { background: var(--seekora-docsearch-hit-bg-hover); border-color: var(--seekora-docsearch-border); }
+.seekora-docsearch-close-text { text-transform: uppercase; letter-spacing: 0.05em; }
+.seekora-docsearch-body { flex: 1; overflow-y: auto; min-height: 0; overscroll-behavior: contain; scroll-behavior: auto; scroll-padding: 8px 0; }
+.seekora-docsearch-body::-webkit-scrollbar { width: 8px; }
+.seekora-docsearch-body::-webkit-scrollbar-track { background: transparent; }
+.seekora-docsearch-body::-webkit-scrollbar-thumb { background: var(--seekora-docsearch-border); border-radius: 4px; }
+.seekora-docsearch-body::-webkit-scrollbar-thumb:hover { background: var(--seekora-docsearch-text-muted); }
+@media (max-width: 640px) {
+  .seekora-docsearch-overlay { padding: var(--seekora-docsearch-spacing-md); }
+  .seekora-docsearch-modal { max-height: calc(100vh - 32px); border-radius: var(--seekora-docsearch-radius-lg); }
+}
+
+.seekora-docsearch-searchbox {
+  display: flex; align-items: center; gap: var(--seekora-docsearch-spacing-sm); flex: 1;
+  padding: 0 var(--seekora-docsearch-spacing-sm); background: var(--seekora-docsearch-background-secondary);
+  border: 1px solid transparent; border-radius: var(--seekora-docsearch-radius-md); transition: all var(--seekora-docsearch-transition-fast) ease;
+}
+.seekora-docsearch-searchbox:focus-within { background: var(--seekora-docsearch-background); border-color: var(--seekora-docsearch-primary); box-shadow: 0 0 0 3px var(--seekora-docsearch-highlight-bg); }
+.seekora-docsearch-searchbox-icon { display: flex; align-items: center; justify-content: center; color: var(--seekora-docsearch-icon); flex-shrink: 0; cursor: default; }
+.seekora-docsearch-searchbox:focus-within .seekora-docsearch-searchbox-icon { color: var(--seekora-docsearch-icon-active); }
+.seekora-docsearch-input {
+  flex: 1; padding: var(--seekora-docsearch-spacing-md) var(--seekora-docsearch-spacing-sm);
+  background: transparent; border: none; color: var(--seekora-docsearch-text);
+  font-family: var(--seekora-docsearch-font-family); font-size: var(--seekora-docsearch-font-size-lg);
+  line-height: var(--seekora-docsearch-line-height); outline: none; min-width: 0;
+}
+.seekora-docsearch-input::placeholder { color: var(--seekora-docsearch-text-secondary); }
+.seekora-docsearch-clear { display: flex; align-items: center; justify-content: center; padding: var(--seekora-docsearch-spacing-xs); background: transparent; border: none; border-radius: var(--seekora-docsearch-radius-sm); color: var(--seekora-docsearch-text-muted); cursor: pointer; transition: all var(--seekora-docsearch-transition-fast) ease; flex-shrink: 0; }
+.seekora-docsearch-clear:hover { background: var(--seekora-docsearch-hit-bg-hover); color: var(--seekora-docsearch-text); }
+
+.seekora-docsearch-results { padding: var(--seekora-docsearch-spacing-sm) 0; }
+.seekora-docsearch-results-list { list-style: none; margin: 0; padding: 0; }
+.seekora-docsearch-results-group { margin-bottom: var(--seekora-docsearch-spacing-sm); }
+.seekora-docsearch-results-group:last-child { margin-bottom: 0; }
+.seekora-docsearch-results-group-header { padding: var(--seekora-docsearch-spacing-sm) var(--seekora-docsearch-spacing-lg); color: var(--seekora-docsearch-text-muted); font-size: var(--seekora-docsearch-font-size-sm); font-weight: var(--seekora-docsearch-font-weight-semibold); text-transform: uppercase; letter-spacing: 0.05em; }
+.seekora-docsearch-results-group-items { list-style: none; margin: 0; padding: 0; }
+.seekora-docsearch-hit { display: flex; align-items: center; gap: var(--seekora-docsearch-spacing-md); padding: var(--seekora-docsearch-spacing-md) var(--seekora-docsearch-spacing-lg); background: var(--seekora-docsearch-hit-bg); color: var(--seekora-docsearch-text); text-decoration: none; cursor: pointer; transition: background var(--seekora-docsearch-transition-fast) ease; }
+.seekora-docsearch-hit:hover { background: var(--seekora-docsearch-hit-bg-hover); }
+.seekora-docsearch-hit--selected { background: var(--seekora-docsearch-hit-bg-selected); }
+.seekora-docsearch-hit--selected:hover { background: var(--seekora-docsearch-hit-bg-selected); }
+.seekora-docsearch-hit-icon { display: flex; align-items: center; justify-content: center; width: 40px; height: 40px; background: var(--seekora-docsearch-background-secondary); border-radius: var(--seekora-docsearch-radius-md); color: var(--seekora-docsearch-icon); flex-shrink: 0; }
+.seekora-docsearch-hit--selected .seekora-docsearch-hit-icon { background: var(--seekora-docsearch-primary); color: white; }
+.seekora-docsearch-hit-content { flex: 1; min-width: 0; display: flex; flex-direction: column; gap: var(--seekora-docsearch-spacing-xs); }
+.seekora-docsearch-hit-breadcrumb { color: var(--seekora-docsearch-text-secondary); font-size: var(--seekora-docsearch-font-size-xs); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.seekora-docsearch-hit-title { color: var(--seekora-docsearch-text); font-size: var(--seekora-docsearch-font-size-md); font-weight: var(--seekora-docsearch-font-weight-medium); line-height: var(--seekora-docsearch-line-height); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.seekora-docsearch-hit-description { color: var(--seekora-docsearch-text-muted); font-size: var(--seekora-docsearch-font-size-sm); line-height: var(--seekora-docsearch-line-height); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.seekora-docsearch-hit-action { display: flex; align-items: center; justify-content: center; color: var(--seekora-docsearch-text-secondary); flex-shrink: 0; opacity: 0; transition: opacity var(--seekora-docsearch-transition-fast) ease; }
+.seekora-docsearch-hit:hover .seekora-docsearch-hit-action, .seekora-docsearch-hit--selected .seekora-docsearch-hit-action { opacity: 1; }
+.seekora-docsearch-highlight mark { background: var(--seekora-docsearch-highlight-bg); color: var(--seekora-docsearch-highlight-text); font-weight: var(--seekora-docsearch-font-weight-semibold); padding: 0 2px; border-radius: 2px; }
+.seekora-docsearch-empty, .seekora-docsearch-no-results, .seekora-docsearch-error { display: flex; flex-direction: column; align-items: center; justify-content: center; padding: var(--seekora-docsearch-spacing-xl); text-align: center; }
+.seekora-docsearch-empty-text, .seekora-docsearch-no-results-text, .seekora-docsearch-error-text { color: var(--seekora-docsearch-text-muted); font-size: var(--seekora-docsearch-font-size-md); margin: 0; }
+.seekora-docsearch-error-text { color: #ef4444; }
+.seekora-docsearch-hit--child { padding-left: var(--seekora-docsearch-spacing-md); }
+.seekora-docsearch-hit--child .seekora-docsearch-hit-icon { width: 32px; height: 32px; }
+.seekora-docsearch-hit-tree { display: flex; align-items: center; justify-content: center; flex-shrink: 0; color: var(--seekora-docsearch-border); }
+.seekora-docsearch-hit-tree-icon { width: 16px; height: 20px; color: var(--seekora-docsearch-border); }
+
+.seekora-docsearch-footer { display: flex; align-items: center; justify-content: space-between; padding: var(--seekora-docsearch-spacing-md) var(--seekora-docsearch-spacing-lg); background: var(--seekora-docsearch-background-secondary); border-top: 1px solid var(--seekora-docsearch-border-light); }
+.seekora-docsearch-footer-commands { display: flex; align-items: center; }
+.seekora-docsearch-footer-commands-list { display: flex; align-items: center; gap: var(--seekora-docsearch-spacing-lg); list-style: none; margin: 0; padding: 0; }
+.seekora-docsearch-footer-command { display: flex; align-items: center; gap: var(--seekora-docsearch-spacing-xs); color: var(--seekora-docsearch-text-muted); font-size: var(--seekora-docsearch-font-size-xs); }
+.seekora-docsearch-key { display: inline-flex; align-items: center; justify-content: center; min-width: 20px; height: 20px; padding: 0 4px; background: var(--seekora-docsearch-key-bg); border: 1px solid var(--seekora-docsearch-key-border); border-radius: var(--seekora-docsearch-radius-sm); color: var(--seekora-docsearch-key-text); font-family: var(--seekora-docsearch-font-family); font-size: var(--seekora-docsearch-font-size-xs); font-weight: var(--seekora-docsearch-font-weight-medium); box-shadow: inset 0 -1px 0 var(--seekora-docsearch-key-border); }
+.seekora-docsearch-footer-logo { display: flex; align-items: center; gap: var(--seekora-docsearch-spacing-sm); }
+.seekora-docsearch-footer-logo-text { color: var(--seekora-docsearch-text-secondary); font-size: var(--seekora-docsearch-font-size-xs); }
+.seekora-docsearch-footer-logo-link { display: flex; align-items: center; color: var(--seekora-docsearch-text); text-decoration: none; transition: color var(--seekora-docsearch-transition-fast) ease; }
+.seekora-docsearch-footer-logo-link:hover { color: var(--seekora-docsearch-primary); }
+.seekora-docsearch-logo { height: 16px; width: auto; }
+@media (max-width: 640px) { .seekora-docsearch-footer { justify-content: center; } .seekora-docsearch-footer-commands { display: none; } }