@xyd-js/plugin-orama 0.1.0-build.157

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 xyd
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE. 

package/dist/Search.tsx

@@ -0,0 +1,170 @@
+import React, { useState, lazy, Suspense, useEffect, useCallback, useRef } from "react"
+import { createPortal } from 'react-dom'
+import { create, insertMultiple } from '@orama/orama'
+
+import {
+    useColorScheme
+} from "@xyd-js/components/writer";
+import { SearchButton } from "@xyd-js/components/system"
+import { useUXEvents } from "@xyd-js/analytics"
+
+const OramaSearchBox = lazy(() => import('@orama/react-components').then(mod => ({ default: mod.OramaSearchBox })));
+
+export default function OramaSearch() {
+    const [isSearchOpen, setIsSearchOpen] = useState(false);
+    const ux = useUXEvents()
+
+    const handleClick = useCallback(() => {
+        if (isSearchOpen) {
+            return
+        }
+
+        ux.docs.search.open({})
+        setIsSearchOpen(true)
+    }, [])
+
+    const onModalClosed = useCallback(() => {
+        setIsSearchOpen(false)
+    }, [])
+
+    return <>
+        <SearchButton onClick={handleClick} />
+
+        <Suspense>
+            <$OramaSearchBoxWrapper isSearchOpen={isSearchOpen} onModalClosed={onModalClosed} />
+        </Suspense>
+    </>
+}
+
+function $OramaSearchBoxWrapper({ isSearchOpen, onModalClosed }: { isSearchOpen: boolean, onModalClosed: () => void }) {
+    const [oramaLocalClientInstance, setOramaLocalClientInstance] = useState<any>(null);
+    const [pluginOptions, setPluginOptions] = useState<any>(null);
+    const [colorScheme] = useColorScheme()
+    const ux = useUXEvents()
+    const uxTyping = useUXTyping((term: string) => {
+        ux.docs.search.query_change({
+            term: term
+        })
+    })
+
+    async function loadData() {
+        // @ts-ignore
+        const oramaDataModule = await import('virtual:xyd-plugin-orama-data')
+
+        const oramaDocs = oramaDataModule.default.docs
+        const oramaCloudConfig = oramaDataModule.default.cloudConfig || null
+        const oramaSuggestions = oramaDataModule.default.suggestions || []
+
+        if (oramaCloudConfig) {
+            setPluginOptions({
+                cloudConfig: oramaCloudConfig,
+                suggestions: oramaSuggestions
+            })
+            return
+        }
+
+        const db = await createOramaInstance(oramaDocs)
+
+        setOramaLocalClientInstance(db)
+        setPluginOptions({
+            suggestions: oramaSuggestions
+        })
+    }
+
+    useEffect(() => {
+        loadData()
+    }, [])
+
+    if (!isSearchOpen) return null;
+
+    const searchBox = (oramaLocalClientInstance || pluginOptions?.cloudConfig) ? (
+        <OramaSearchBox
+            colorScheme={colorScheme || "system"}
+            open={isSearchOpen}
+            clientInstance={oramaLocalClientInstance}
+            onModalClosed={onModalClosed}
+            suggestions={pluginOptions.suggestions}
+            highlightTitle={{
+                caseSensitive: false,
+                HTMLTag: 'b',
+            }}
+            highlightDescription={{
+                caseSensitive: false,
+                HTMLTag: 'b',
+            }}
+            index={pluginOptions?.cloudConfig && {
+                endpoint: pluginOptions.cloudConfig.endpoint,
+                api_key: pluginOptions.cloudConfig.apiKey
+            }}
+            disableChat={!pluginOptions?.cloudConfig}
+            onSearchResultClick={(resp) => {
+                const result = resp.detail.result
+
+                ux.docs.search.result_click({
+                    title: result.title,
+                    description: result.description,
+                })
+            }}
+            onSearchCompleted={(resp) => {
+                const term = resp.detail.clientSearchParams?.term
+                uxTyping(term)
+            }}
+        />
+    ) : null;
+
+
+    return createPortal(searchBox, document.body);
+}
+
+async function createOramaInstance(oramaDocs: any[]): Promise<any> {
+    const db = create({
+        schema: {
+            category: "string",
+            path: "string",
+            title: "string",
+            description: "string",
+            content: "string"
+        },
+        plugins: [
+            //    TODO: finish pluganalytics
+        ]
+    })
+
+    await insertMultiple(db, oramaDocs as any)
+
+    return db
+}
+
+// TODO: move to uxsdk
+function useUXTyping(callback: (term: string) => void, delay: number = 500) {
+    const timeoutRef = useRef<number | null>(null)
+    const lastTermRef = useRef<string>('')
+
+    const trackTyping = useCallback((term?: any) => {
+        // Only track if term has actually changed and is a valid string
+        if (term && typeof term === 'string' && term !== lastTermRef.current) {
+            // Clear existing timeout only when term changes
+            if (timeoutRef.current) {
+                clearTimeout(timeoutRef.current)
+            }
+            lastTermRef.current = term
+            
+            timeoutRef.current = window.setTimeout(() => {
+                if (term.trim()) {
+                    callback(term.trim())
+                }
+            }, delay)
+        }
+    }, [callback, delay])
+
+    // Cleanup timeout on unmount
+    useEffect(() => {
+        return () => {
+            if (timeoutRef.current) {
+                clearTimeout(timeoutRef.current)
+            }
+        }
+    }, [])
+
+    return trackTyping
+}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+import { Plugin } from '@xyd-js/plugins';
+
+interface OramaPluginOptions {
+    endpoint?: string;
+    apiKey?: string;
+    suggestions?: string[];
+}
+
+declare function OramaPlugin(pluginOptions?: OramaPluginOptions): Plugin;
+
+export { OramaPlugin as default };

package/dist/index.js

@@ -0,0 +1,223 @@
+// src/index.ts
+import { mapSettingsToDocSections } from "@xyd-js/content/md";
+
+// src/const.ts
+var DEFAULT_SUGGESTIONS = [
+  "How to install xyd?",
+  "How to generate API Docs?",
+  "How to built-in components?"
+];
+
+// src/Search.tsx
+import React, { useState, lazy, Suspense, useEffect, useCallback, useRef } from "react";
+import { createPortal } from "react-dom";
+import { create, insertMultiple } from "@orama/orama";
+import {
+  useColorScheme
+} from "@xyd-js/components/writer";
+import { SearchButton } from "@xyd-js/components/system";
+import { useUXEvents } from "@xyd-js/analytics";
+var OramaSearchBox = lazy(() => import("@orama/react-components").then((mod) => ({ default: mod.OramaSearchBox })));
+function OramaSearch() {
+  const [isSearchOpen, setIsSearchOpen] = useState(false);
+  const ux = useUXEvents();
+  const handleClick = useCallback(() => {
+    if (isSearchOpen) {
+      return;
+    }
+    ux.docs.search.open({});
+    setIsSearchOpen(true);
+  }, []);
+  const onModalClosed = useCallback(() => {
+    setIsSearchOpen(false);
+  }, []);
+  return /* @__PURE__ */ React.createElement(React.Fragment, null, /* @__PURE__ */ React.createElement(SearchButton, { onClick: handleClick }), /* @__PURE__ */ React.createElement(Suspense, null, /* @__PURE__ */ React.createElement($OramaSearchBoxWrapper, { isSearchOpen, onModalClosed })));
+}
+function $OramaSearchBoxWrapper({ isSearchOpen, onModalClosed }) {
+  const [oramaLocalClientInstance, setOramaLocalClientInstance] = useState(null);
+  const [pluginOptions, setPluginOptions] = useState(null);
+  const [colorScheme] = useColorScheme();
+  const ux = useUXEvents();
+  const uxTyping = useUXTyping((term) => {
+    ux.docs.search.query_change({
+      term
+    });
+  });
+  async function loadData() {
+    const oramaDataModule = await import("virtual:xyd-plugin-orama-data");
+    const oramaDocs = oramaDataModule.default.docs;
+    const oramaCloudConfig = oramaDataModule.default.cloudConfig || null;
+    const oramaSuggestions = oramaDataModule.default.suggestions || [];
+    if (oramaCloudConfig) {
+      setPluginOptions({
+        cloudConfig: oramaCloudConfig,
+        suggestions: oramaSuggestions
+      });
+      return;
+    }
+    const db = await createOramaInstance(oramaDocs);
+    setOramaLocalClientInstance(db);
+    setPluginOptions({
+      suggestions: oramaSuggestions
+    });
+  }
+  useEffect(() => {
+    loadData();
+  }, []);
+  if (!isSearchOpen) return null;
+  const searchBox = oramaLocalClientInstance || pluginOptions?.cloudConfig ? /* @__PURE__ */ React.createElement(
+    OramaSearchBox,
+    {
+      colorScheme: colorScheme || "system",
+      open: isSearchOpen,
+      clientInstance: oramaLocalClientInstance,
+      onModalClosed,
+      suggestions: pluginOptions.suggestions,
+      highlightTitle: {
+        caseSensitive: false,
+        HTMLTag: "b"
+      },
+      highlightDescription: {
+        caseSensitive: false,
+        HTMLTag: "b"
+      },
+      index: pluginOptions?.cloudConfig && {
+        endpoint: pluginOptions.cloudConfig.endpoint,
+        api_key: pluginOptions.cloudConfig.apiKey
+      },
+      disableChat: !pluginOptions?.cloudConfig,
+      onSearchResultClick: (resp) => {
+        const result = resp.detail.result;
+        ux.docs.search.result_click({
+          title: result.title,
+          description: result.description
+        });
+      },
+      onSearchCompleted: (resp) => {
+        const term = resp.detail.clientSearchParams?.term;
+        uxTyping(term);
+      }
+    }
+  ) : null;
+  return createPortal(searchBox, document.body);
+}
+async function createOramaInstance(oramaDocs) {
+  const db = create({
+    schema: {
+      category: "string",
+      path: "string",
+      title: "string",
+      description: "string",
+      content: "string"
+    },
+    plugins: [
+      //    TODO: finish pluganalytics
+    ]
+  });
+  await insertMultiple(db, oramaDocs);
+  return db;
+}
+function useUXTyping(callback, delay = 500) {
+  const timeoutRef = useRef(null);
+  const lastTermRef = useRef("");
+  const trackTyping = useCallback((term) => {
+    if (term && typeof term === "string" && term !== lastTermRef.current) {
+      if (timeoutRef.current) {
+        clearTimeout(timeoutRef.current);
+      }
+      lastTermRef.current = term;
+      timeoutRef.current = window.setTimeout(() => {
+        if (term.trim()) {
+          callback(term.trim());
+        }
+      }, delay);
+    }
+  }, [callback, delay]);
+  useEffect(() => {
+    return () => {
+      if (timeoutRef.current) {
+        clearTimeout(timeoutRef.current);
+      }
+    };
+  }, []);
+  return trackTyping;
+}
+
+// src/index.ts
+function OramaPlugin(pluginOptions = {}) {
+  return function(settings) {
+    return {
+      name: "plugin-orama",
+      vite: [
+        vitePlugin(
+          settings,
+          pluginOptions
+        )
+      ],
+      components: [
+        {
+          component: OramaSearch,
+          name: "Search",
+          dist: "@xyd-js/plugin-orama/Search"
+          // TODO: better in the future
+        }
+      ]
+    };
+  };
+}
+function vitePlugin(settings, pluginOptions = {}) {
+  const virtualModuleId = "virtual:xyd-plugin-orama-data";
+  const resolvedVirtualModuleId = `\0${virtualModuleId}`;
+  let resolveConfig = null;
+  return {
+    name: "xyd-plugin-orama",
+    enforce: "pre",
+    async configResolved(config) {
+      if (resolveConfig) {
+        return;
+      }
+      resolveConfig = config;
+    },
+    async resolveId(id) {
+      if (id === virtualModuleId) {
+        return resolvedVirtualModuleId;
+      }
+    },
+    async load(id) {
+      if (id !== resolvedVirtualModuleId) {
+        return;
+      }
+      let cloudConfig = null;
+      if (pluginOptions.endpoint && pluginOptions.apiKey) {
+        cloudConfig = {
+          endpoint: pluginOptions.endpoint,
+          apiKey: pluginOptions.apiKey
+        };
+      }
+      const sections = (await mapSettingsToDocSections(settings)).map(mapDocSectionsToOrama);
+      return `
+                const docs = ${JSON.stringify(sections)};
+                const cloudConfig = ${JSON.stringify(cloudConfig)};
+                const suggestions = ${JSON.stringify(pluginOptions.suggestions || DEFAULT_SUGGESTIONS)};
+
+                export default { docs, cloudConfig, suggestions };
+            `;
+    }
+  };
+}
+function mapDocSectionsToOrama(doc) {
+  return {
+    category: "",
+    // TODO: finish
+    path: doc.pageUrl,
+    title: doc.headingTitle,
+    description: doc.content,
+    content: doc.content
+    // section: doc.content,
+    // version: string
+  };
+}
+export {
+  OramaPlugin as default
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/const.ts","../src/Search.tsx"],"sourcesContent":["import type {Plugin as VitePlugin, ResolvedConfig} from 'vite'\n\nimport type {Settings} from '@xyd-js/core'\nimport type {Plugin} from '@xyd-js/plugins'\nimport {mapSettingsToDocSections, type DocSectionSchema} from '@xyd-js/content/md'\n\nimport {DEFAULT_SUGGESTIONS} from './const'\nimport type {OramaPluginOptions, OramaCloudConfig, OramaSectionSchema} from './types'\nimport Search from './Search'\n\nexport default function OramaPlugin(\n    pluginOptions: OramaPluginOptions = {}\n): Plugin {\n    return function (settings: Settings) {\n        return {\n            name: \"plugin-orama\",\n            vite: [\n                vitePlugin(\n                    settings,\n                    pluginOptions,\n                )\n            ],\n            components: [\n                {\n                    component: Search,\n                    name: \"Search\",\n                    dist: \"@xyd-js/plugin-orama/Search\" // TODO: better in the future\n                }\n            ]\n        }\n    }\n}\n\nfunction vitePlugin(\n    settings: Settings,\n    pluginOptions: OramaPluginOptions = {}\n): VitePlugin {\n    const virtualModuleId = 'virtual:xyd-plugin-orama-data'\n    const resolvedVirtualModuleId = `\\0${virtualModuleId}`\n\n    let resolveConfig: ResolvedConfig | null = null\n\n    return {\n        name: 'xyd-plugin-orama',\n        enforce: 'pre',\n\n        async configResolved(config: ResolvedConfig) {\n            if (resolveConfig) {\n                return\n            }\n\n            resolveConfig = config\n        },\n\n        async resolveId(id) {\n            if (id === virtualModuleId) {\n                return resolvedVirtualModuleId\n            }\n        },\n\n        async load(this, id: string) {\n            if (id !== resolvedVirtualModuleId) {\n                return\n            }\n\n            let cloudConfig: OramaCloudConfig | null = null\n            if (pluginOptions.endpoint && pluginOptions.apiKey) {\n                cloudConfig = {\n                    endpoint: pluginOptions.endpoint,\n                    apiKey: pluginOptions.apiKey\n                }\n            }\n\n            const sections = (await mapSettingsToDocSections(settings)).map(mapDocSectionsToOrama)\n\n            return `\n                const docs = ${JSON.stringify(sections)};\n                const cloudConfig = ${JSON.stringify(cloudConfig)};\n                const suggestions = ${JSON.stringify(pluginOptions.suggestions || DEFAULT_SUGGESTIONS)};\n\n                export default { docs, cloudConfig, suggestions };\n            `\n        }\n    }\n}\n\nfunction mapDocSectionsToOrama(doc: DocSectionSchema): OramaSectionSchema {\n    return {\n        category: '', // TODO: finish\n\n        path: doc.pageUrl,\n\n        title: doc.headingTitle,\n\n        description: doc.content,\n\n        content: doc.content,\n\n        // section: doc.content,\n        // version: string\n    }\n}\n\n","export const DEFAULT_SUGGESTIONS = [\n    \"How to install xyd?\",\n    \"How to generate API Docs?\",\n    \"How to built-in components?\",\n]","import React, { useState, lazy, Suspense, useEffect, useCallback, useRef } from \"react\"\nimport { createPortal } from 'react-dom'\nimport { create, insertMultiple } from '@orama/orama'\n\nimport {\n    useColorScheme\n} from \"@xyd-js/components/writer\";\nimport { SearchButton } from \"@xyd-js/components/system\"\nimport { useUXEvents } from \"@xyd-js/analytics\"\n\nconst OramaSearchBox = lazy(() => import('@orama/react-components').then(mod => ({ default: mod.OramaSearchBox })));\n\nexport default function OramaSearch() {\n    const [isSearchOpen, setIsSearchOpen] = useState(false);\n    const ux = useUXEvents()\n\n    const handleClick = useCallback(() => {\n        if (isSearchOpen) {\n            return\n        }\n\n        ux.docs.search.open({})\n        setIsSearchOpen(true)\n    }, [])\n\n    const onModalClosed = useCallback(() => {\n        setIsSearchOpen(false)\n    }, [])\n\n    return <>\n        <SearchButton onClick={handleClick} />\n\n        <Suspense>\n            <$OramaSearchBoxWrapper isSearchOpen={isSearchOpen} onModalClosed={onModalClosed} />\n        </Suspense>\n    </>\n}\n\nfunction $OramaSearchBoxWrapper({ isSearchOpen, onModalClosed }: { isSearchOpen: boolean, onModalClosed: () => void }) {\n    const [oramaLocalClientInstance, setOramaLocalClientInstance] = useState<any>(null);\n    const [pluginOptions, setPluginOptions] = useState<any>(null);\n    const [colorScheme] = useColorScheme()\n    const ux = useUXEvents()\n    const uxTyping = useUXTyping((term: string) => {\n        ux.docs.search.query_change({\n            term: term\n        })\n    })\n\n    async function loadData() {\n        // @ts-ignore\n        const oramaDataModule = await import('virtual:xyd-plugin-orama-data')\n\n        const oramaDocs = oramaDataModule.default.docs\n        const oramaCloudConfig = oramaDataModule.default.cloudConfig || null\n        const oramaSuggestions = oramaDataModule.default.suggestions || []\n\n        if (oramaCloudConfig) {\n            setPluginOptions({\n                cloudConfig: oramaCloudConfig,\n                suggestions: oramaSuggestions\n            })\n            return\n        }\n\n        const db = await createOramaInstance(oramaDocs)\n\n        setOramaLocalClientInstance(db)\n        setPluginOptions({\n            suggestions: oramaSuggestions\n        })\n    }\n\n    useEffect(() => {\n        loadData()\n    }, [])\n\n    if (!isSearchOpen) return null;\n\n    const searchBox = (oramaLocalClientInstance || pluginOptions?.cloudConfig) ? (\n        <OramaSearchBox\n            colorScheme={colorScheme || \"system\"}\n            open={isSearchOpen}\n            clientInstance={oramaLocalClientInstance}\n            onModalClosed={onModalClosed}\n            suggestions={pluginOptions.suggestions}\n            highlightTitle={{\n                caseSensitive: false,\n                HTMLTag: 'b',\n            }}\n            highlightDescription={{\n                caseSensitive: false,\n                HTMLTag: 'b',\n            }}\n            index={pluginOptions?.cloudConfig && {\n                endpoint: pluginOptions.cloudConfig.endpoint,\n                api_key: pluginOptions.cloudConfig.apiKey\n            }}\n            disableChat={!pluginOptions?.cloudConfig}\n            onSearchResultClick={(resp) => {\n                const result = resp.detail.result\n\n                ux.docs.search.result_click({\n                    title: result.title,\n                    description: result.description,\n                })\n            }}\n            onSearchCompleted={(resp) => {\n                const term = resp.detail.clientSearchParams?.term\n                uxTyping(term)\n            }}\n        />\n    ) : null;\n\n\n    return createPortal(searchBox, document.body);\n}\n\nasync function createOramaInstance(oramaDocs: any[]): Promise<any> {\n    const db = create({\n        schema: {\n            category: \"string\",\n            path: \"string\",\n            title: \"string\",\n            description: \"string\",\n            content: \"string\"\n        },\n        plugins: [\n            //    TODO: finish pluganalytics\n        ]\n    })\n\n    await insertMultiple(db, oramaDocs as any)\n\n    return db\n}\n\n// TODO: move to uxsdk\nfunction useUXTyping(callback: (term: string) => void, delay: number = 500) {\n    const timeoutRef = useRef<number | null>(null)\n    const lastTermRef = useRef<string>('')\n\n    const trackTyping = useCallback((term?: any) => {\n        // Only track if term has actually changed and is a valid string\n        if (term && typeof term === 'string' && term !== lastTermRef.current) {\n            // Clear existing timeout only when term changes\n            if (timeoutRef.current) {\n                clearTimeout(timeoutRef.current)\n            }\n            lastTermRef.current = term\n            \n            timeoutRef.current = window.setTimeout(() => {\n                if (term.trim()) {\n                    callback(term.trim())\n                }\n            }, delay)\n        }\n    }, [callback, delay])\n\n    // Cleanup timeout on unmount\n    useEffect(() => {\n        return () => {\n            if (timeoutRef.current) {\n                clearTimeout(timeoutRef.current)\n            }\n        }\n    }, [])\n\n    return trackTyping\n}"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@xyd-js/plugin-orama",
+  "version": "0.1.0-build.157",
+  "author": "",
+  "description": "",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "type": "module",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "import": "./dist/index.js"
+    },
+    "./Search": {
+      "import": "./dist/Search.tsx"
+    }
+  },
+  "dependencies": {
+    "@orama/orama": "^3.1.6",
+    "@orama/plugin-data-persistence": "^3.1.6",
+    "@orama/react-components": "^0.7.0",
+    "@orama/searchbox": "1.0.0-rc53",
+    "slugify": "^1.6.6",
+    "unified": "^11.0.4",
+    "remark-parse": "^11.0.0",
+    "remark-rehype": "^11.0.0",
+    "rehype-stringify": "^10.0.0",
+    "@xyd-js/core": "0.1.0-build.170",
+    "@xyd-js/content": "0.1.0-build.171",
+    "@xyd-js/plugins": "0.1.0-build.157",
+    "@xyd-js/components": "0.1.0-build.168"
+  },
+  "peerDependencies": {
+    "react": "^19.1.0",
+    "react-dom": "^19.1.0",
+    "@xyd-js/analytics": "0.1.0-build.157"
+  },
+  "devDependencies": {
+    "vite": "^7.0.0",
+    "@vitest/coverage-v8": "^1.6.1",
+    "rimraf": "^3.0.2",
+    "tsup": "^8.4.0",
+    "vitest": "^1.6.1"
+  },
+  "scripts": {
+    "clean": "rimraf build",
+    "prebuild": "pnpm clean",
+    "build": "tsup",
+    "test": "vitest",
+    "test:coverage": "vitest run --coverage"
+  }
+}

package/src/Search.tsx

@@ -0,0 +1,170 @@
+import React, { useState, lazy, Suspense, useEffect, useCallback, useRef } from "react"
+import { createPortal } from 'react-dom'
+import { create, insertMultiple } from '@orama/orama'
+
+import {
+    useColorScheme
+} from "@xyd-js/components/writer";
+import { SearchButton } from "@xyd-js/components/system"
+import { useUXEvents } from "@xyd-js/analytics"
+
+const OramaSearchBox = lazy(() => import('@orama/react-components').then(mod => ({ default: mod.OramaSearchBox })));
+
+export default function OramaSearch() {
+    const [isSearchOpen, setIsSearchOpen] = useState(false);
+    const ux = useUXEvents()
+
+    const handleClick = useCallback(() => {
+        if (isSearchOpen) {
+            return
+        }
+
+        ux.docs.search.open({})
+        setIsSearchOpen(true)
+    }, [])
+
+    const onModalClosed = useCallback(() => {
+        setIsSearchOpen(false)
+    }, [])
+
+    return <>
+        <SearchButton onClick={handleClick} />
+
+        <Suspense>
+            <$OramaSearchBoxWrapper isSearchOpen={isSearchOpen} onModalClosed={onModalClosed} />
+        </Suspense>
+    </>
+}
+
+function $OramaSearchBoxWrapper({ isSearchOpen, onModalClosed }: { isSearchOpen: boolean, onModalClosed: () => void }) {
+    const [oramaLocalClientInstance, setOramaLocalClientInstance] = useState<any>(null);
+    const [pluginOptions, setPluginOptions] = useState<any>(null);
+    const [colorScheme] = useColorScheme()
+    const ux = useUXEvents()
+    const uxTyping = useUXTyping((term: string) => {
+        ux.docs.search.query_change({
+            term: term
+        })
+    })
+
+    async function loadData() {
+        // @ts-ignore
+        const oramaDataModule = await import('virtual:xyd-plugin-orama-data')
+
+        const oramaDocs = oramaDataModule.default.docs
+        const oramaCloudConfig = oramaDataModule.default.cloudConfig || null
+        const oramaSuggestions = oramaDataModule.default.suggestions || []
+
+        if (oramaCloudConfig) {
+            setPluginOptions({
+                cloudConfig: oramaCloudConfig,
+                suggestions: oramaSuggestions
+            })
+            return
+        }
+
+        const db = await createOramaInstance(oramaDocs)
+
+        setOramaLocalClientInstance(db)
+        setPluginOptions({
+            suggestions: oramaSuggestions
+        })
+    }
+
+    useEffect(() => {
+        loadData()
+    }, [])
+
+    if (!isSearchOpen) return null;
+
+    const searchBox = (oramaLocalClientInstance || pluginOptions?.cloudConfig) ? (
+        <OramaSearchBox
+            colorScheme={colorScheme || "system"}
+            open={isSearchOpen}
+            clientInstance={oramaLocalClientInstance}
+            onModalClosed={onModalClosed}
+            suggestions={pluginOptions.suggestions}
+            highlightTitle={{
+                caseSensitive: false,
+                HTMLTag: 'b',
+            }}
+            highlightDescription={{
+                caseSensitive: false,
+                HTMLTag: 'b',
+            }}
+            index={pluginOptions?.cloudConfig && {
+                endpoint: pluginOptions.cloudConfig.endpoint,
+                api_key: pluginOptions.cloudConfig.apiKey
+            }}
+            disableChat={!pluginOptions?.cloudConfig}
+            onSearchResultClick={(resp) => {
+                const result = resp.detail.result
+
+                ux.docs.search.result_click({
+                    title: result.title,
+                    description: result.description,
+                })
+            }}
+            onSearchCompleted={(resp) => {
+                const term = resp.detail.clientSearchParams?.term
+                uxTyping(term)
+            }}
+        />
+    ) : null;
+
+
+    return createPortal(searchBox, document.body);
+}
+
+async function createOramaInstance(oramaDocs: any[]): Promise<any> {
+    const db = create({
+        schema: {
+            category: "string",
+            path: "string",
+            title: "string",
+            description: "string",
+            content: "string"
+        },
+        plugins: [
+            //    TODO: finish pluganalytics
+        ]
+    })
+
+    await insertMultiple(db, oramaDocs as any)
+
+    return db
+}
+
+// TODO: move to uxsdk
+function useUXTyping(callback: (term: string) => void, delay: number = 500) {
+    const timeoutRef = useRef<number | null>(null)
+    const lastTermRef = useRef<string>('')
+
+    const trackTyping = useCallback((term?: any) => {
+        // Only track if term has actually changed and is a valid string
+        if (term && typeof term === 'string' && term !== lastTermRef.current) {
+            // Clear existing timeout only when term changes
+            if (timeoutRef.current) {
+                clearTimeout(timeoutRef.current)
+            }
+            lastTermRef.current = term
+            
+            timeoutRef.current = window.setTimeout(() => {
+                if (term.trim()) {
+                    callback(term.trim())
+                }
+            }, delay)
+        }
+    }, [callback, delay])
+
+    // Cleanup timeout on unmount
+    useEffect(() => {
+        return () => {
+            if (timeoutRef.current) {
+                clearTimeout(timeoutRef.current)
+            }
+        }
+    }, [])
+
+    return trackTyping
+}

package/src/const.ts

@@ -0,0 +1,5 @@
+export const DEFAULT_SUGGESTIONS = [
+    "How to install xyd?",
+    "How to generate API Docs?",
+    "How to built-in components?",
+]

package/src/index.css

@@ -0,0 +1,3 @@
+.TestAbc123 {
+    color: red;
+}