@seekora-ai/docsearch-js 0.1.1

package/dist/index.d.ts

@@ -0,0 +1,65 @@
+import { DocSearchHit, DocSearchSuggestion, DocSearchProps } from '@seekora-ai/docsearch-react';
+export { DocSearchHit, DocSearchProps, DocSearchSuggestion } from '@seekora-ai/docsearch-react';
+
+interface DocSearchOptions {
+    /** Container element or CSS selector */
+    container: string | HTMLElement;
+    /** API endpoint for search (e.g., "https://api.example.com/v1/docs") */
+    apiEndpoint: string;
+    /** Optional API key for authentication */
+    apiKey?: string;
+    /** Index name (optional) */
+    indexName?: string;
+    /** Placeholder text for the search input */
+    placeholder?: string;
+    /** Maximum number of results to show */
+    maxResults?: number;
+    /** Debounce delay in milliseconds */
+    debounceMs?: number;
+    /** Callback when a result is selected */
+    onSelect?: (hit: DocSearchHit | DocSearchSuggestion) => void;
+    /** Callback when the modal is closed */
+    onClose?: () => void;
+    /** Custom translations */
+    translations?: DocSearchProps['translations'];
+    /** Whether to render the button trigger (default: true) */
+    renderButton?: boolean;
+    /** Initial open state */
+    initialOpen?: boolean;
+    /** Disable keyboard shortcut (Cmd/Ctrl+K) */
+    disableShortcut?: boolean;
+    /** Custom keyboard shortcut key (default: 'k') */
+    shortcutKey?: string;
+}
+interface DocSearchInstance {
+    /** Destroy the DocSearch instance and cleanup */
+    destroy: () => void;
+    /** Open the search modal programmatically */
+    open: () => void;
+    /** Close the search modal programmatically */
+    close: () => void;
+    /** Update options */
+    update: (options: Partial<DocSearchOptions>) => void;
+}
+/**
+ * Initialize DocSearch on a container element.
+ *
+ * @example
+ * ```js
+ * import docsearch from '@seekora-ai/docsearch-js';
+ * import '@seekora-ai/docsearch-css';
+ *
+ * const search = docsearch({
+ *   container: '#docsearch',
+ *   apiEndpoint: 'https://api.example.com/v1/docs',
+ * });
+ *
+ * // Later, if needed:
+ * search.open();
+ * search.destroy();
+ * ```
+ */
+declare function docsearch(options: DocSearchOptions): DocSearchInstance;
+
+export { docsearch as default, docsearch };
+export type { DocSearchInstance, DocSearchOptions };

package/dist/index.esm.js

@@ -0,0 +1,87 @@
+import React from 'react';
+import require$$0 from 'react-dom';
+import { DocSearch } from '@seekora-ai/docsearch-react';
+
+var createRoot;
+
+var m = require$$0;
+{
+  createRoot = m.createRoot;
+  m.hydrateRoot;
+}
+
+/**
+ * Initialize DocSearch on a container element.
+ *
+ * @example
+ * ```js
+ * import docsearch from '@seekora-ai/docsearch-js';
+ * import '@seekora-ai/docsearch-css';
+ *
+ * const search = docsearch({
+ *   container: '#docsearch',
+ *   apiEndpoint: 'https://api.example.com/v1/docs',
+ * });
+ *
+ * // Later, if needed:
+ * search.open();
+ * search.destroy();
+ * ```
+ */
+function docsearch(options) {
+    const { container, ...props } = options;
+    // Get or validate container element
+    const containerElement = typeof container === 'string'
+        ? document.querySelector(container)
+        : container;
+    if (!containerElement) {
+        throw new Error(`DocSearch: Container element not found. ` +
+            `Provided: ${typeof container === 'string' ? container : 'HTMLElement'}`);
+    }
+    // State for programmatic control
+    let isOpen = props.initialOpen ?? false;
+    let currentProps = { ...props };
+    let root = null;
+    // Render function
+    const render = () => {
+        if (!root) {
+            root = createRoot(containerElement);
+        }
+        const element = React.createElement(DocSearch, {
+            ...currentProps,
+            initialOpen: isOpen,
+            onClose: () => {
+                isOpen = false;
+                currentProps.onClose?.();
+                render(); // Re-render to sync state
+            },
+        });
+        root.render(element);
+    };
+    // Initial render
+    render();
+    // Return instance API
+    return {
+        destroy: () => {
+            if (root) {
+                root.unmount();
+                root = null;
+            }
+        },
+        open: () => {
+            isOpen = true;
+            render();
+        },
+        close: () => {
+            isOpen = false;
+            render();
+        },
+        update: (newOptions) => {
+            currentProps = { ...currentProps, ...newOptions };
+            render();
+        },
+    };
+}
+
+export { docsearch as default, docsearch };
+//# sourceMappingURL=index.esm.js.map

package/dist/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.esm.js","sources":["../../../node_modules/.pnpm/react-dom@18.3.1_react@18.3.1/node_modules/react-dom/client.js","../src/index.ts"],"sourcesContent":["'use strict';\n\nvar m = require('react-dom');\nif (process.env.NODE_ENV === 'production') {\n  exports.createRoot = m.createRoot;\n  exports.hydrateRoot = m.hydrateRoot;\n} else {\n  var i = m.__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED;\n  exports.createRoot = function(c, o) {\n    i.usingClientEntryPoint = true;\n    try {\n      return m.createRoot(c, o);\n    } finally {\n      i.usingClientEntryPoint = false;\n    }\n  };\n  exports.hydrateRoot = function(c, h, o) {\n    i.usingClientEntryPoint = true;\n    try {\n      return m.hydrateRoot(c, h, o);\n    } finally {\n      i.usingClientEntryPoint = false;\n    }\n  };\n}\n",null],"names":[],"mappings":";;;;;;AAEA,IAAI,CAAC,GAAG,UAAoB;AACe;AAC3C,EAAE,UAAA,GAAqB,CAAC,CAAC,UAAU;AACnC,EAAwB,CAAC,CAAC,WAAW;AACrC;;AC6CA;;;;;;;;;;;;;;;;;AAiBG;AACG,SAAU,SAAS,CAAC,OAAyB,EAAA;IACjD,MAAM,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,GAAG,OAAO;;AAGvC,IAAA,MAAM,gBAAgB,GACpB,OAAO,SAAS,KAAK;AACnB,UAAE,QAAQ,CAAC,aAAa,CAAc,SAAS;UAC7C,SAAS;IAEf,IAAI,CAAC,gBAAgB,EAAE;QACrB,MAAM,IAAI,KAAK,CACb,CAAA,wCAAA,CAA0C;AACxC,YAAA,CAAA,UAAA,EAAa,OAAO,SAAS,KAAK,QAAQ,GAAG,SAAS,GAAG,aAAa,CAAA,CAAE,CAC3E;IACH;;AAGA,IAAA,IAAI,MAAM,GAAG,KAAK,CAAC,WAAW,IAAI,KAAK;AACvC,IAAA,IAAI,YAAY,GAAG,EAAE,GAAG,KAAK,EAAE;IAC/B,IAAI,IAAI,GAAgB,IAAI;;IAG5B,MAAM,MAAM,GAAG,MAAK;QAClB,IAAI,CAAC,IAAI,EAAE;AACT,YAAA,IAAI,GAAG,UAAU,CAAC,gBAAgB,CAAC;QACrC;AAEA,QAAA,MAAM,OAAO,GAAG,KAAK,CAAC,aAAa,CAAC,SAAS,EAAE;AAC7C,YAAA,GAAG,YAAY;AACf,YAAA,WAAW,EAAE,MAAM;YACnB,OAAO,EAAE,MAAK;gBACZ,MAAM,GAAG,KAAK;AACd,gBAAA,YAAY,CAAC,OAAO,IAAI;gBACxB,MAAM,EAAE,CAAC;YACX,CAAC;AACgB,SAAA,CAAC;AAEpB,QAAA,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;AACtB,IAAA,CAAC;;AAGD,IAAA,MAAM,EAAE;;IAGR,OAAO;QACL,OAAO,EAAE,MAAK;YACZ,IAAI,IAAI,EAAE;gBACR,IAAI,CAAC,OAAO,EAAE;gBACd,IAAI,GAAG,IAAI;YACb;QACF,CAAC;QAED,IAAI,EAAE,MAAK;YACT,MAAM,GAAG,IAAI;AACb,YAAA,MAAM,EAAE;QACV,CAAC;QAED,KAAK,EAAE,MAAK;YACV,MAAM,GAAG,KAAK;AACd,YAAA,MAAM,EAAE;QACV,CAAC;AAED,QAAA,MAAM,EAAE,CAAC,UAAqC,KAAI;YAChD,YAAY,GAAG,EAAE,GAAG,YAAY,EAAE,GAAG,UAAU,EAAE;AACjD,YAAA,MAAM,EAAE;QACV,CAAC;KACF;AACH;;;;","x_google_ignoreList":[0]}

package/dist/index.js

@@ -0,0 +1,92 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var React = require('react');
+var require$$0 = require('react-dom');
+var docsearchReact = require('@seekora-ai/docsearch-react');
+
+var createRoot;
+
+var m = require$$0;
+{
+  createRoot = m.createRoot;
+  m.hydrateRoot;
+}
+
+/**
+ * Initialize DocSearch on a container element.
+ *
+ * @example
+ * ```js
+ * import docsearch from '@seekora-ai/docsearch-js';
+ * import '@seekora-ai/docsearch-css';
+ *
+ * const search = docsearch({
+ *   container: '#docsearch',
+ *   apiEndpoint: 'https://api.example.com/v1/docs',
+ * });
+ *
+ * // Later, if needed:
+ * search.open();
+ * search.destroy();
+ * ```
+ */
+function docsearch(options) {
+    const { container, ...props } = options;
+    // Get or validate container element
+    const containerElement = typeof container === 'string'
+        ? document.querySelector(container)
+        : container;
+    if (!containerElement) {
+        throw new Error(`DocSearch: Container element not found. ` +
+            `Provided: ${typeof container === 'string' ? container : 'HTMLElement'}`);
+    }
+    // State for programmatic control
+    let isOpen = props.initialOpen ?? false;
+    let currentProps = { ...props };
+    let root = null;
+    // Render function
+    const render = () => {
+        if (!root) {
+            root = createRoot(containerElement);
+        }
+        const element = React.createElement(docsearchReact.DocSearch, {
+            ...currentProps,
+            initialOpen: isOpen,
+            onClose: () => {
+                isOpen = false;
+                currentProps.onClose?.();
+                render(); // Re-render to sync state
+            },
+        });
+        root.render(element);
+    };
+    // Initial render
+    render();
+    // Return instance API
+    return {
+        destroy: () => {
+            if (root) {
+                root.unmount();
+                root = null;
+            }
+        },
+        open: () => {
+            isOpen = true;
+            render();
+        },
+        close: () => {
+            isOpen = false;
+            render();
+        },
+        update: (newOptions) => {
+            currentProps = { ...currentProps, ...newOptions };
+            render();
+        },
+    };
+}
+
+exports.default = docsearch;
+exports.docsearch = docsearch;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../../node_modules/.pnpm/react-dom@18.3.1_react@18.3.1/node_modules/react-dom/client.js","../src/index.ts"],"sourcesContent":["'use strict';\n\nvar m = require('react-dom');\nif (process.env.NODE_ENV === 'production') {\n  exports.createRoot = m.createRoot;\n  exports.hydrateRoot = m.hydrateRoot;\n} else {\n  var i = m.__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED;\n  exports.createRoot = function(c, o) {\n    i.usingClientEntryPoint = true;\n    try {\n      return m.createRoot(c, o);\n    } finally {\n      i.usingClientEntryPoint = false;\n    }\n  };\n  exports.hydrateRoot = function(c, h, o) {\n    i.usingClientEntryPoint = true;\n    try {\n      return m.hydrateRoot(c, h, o);\n    } finally {\n      i.usingClientEntryPoint = false;\n    }\n  };\n}\n",null],"names":["DocSearch"],"mappings":";;;;;;;;;;AAEA,IAAI,CAAC,GAAG,UAAoB;AACe;AAC3C,EAAE,UAAA,GAAqB,CAAC,CAAC,UAAU;AACnC,EAAwB,CAAC,CAAC,WAAW;AACrC;;AC6CA;;;;;;;;;;;;;;;;;AAiBG;AACG,SAAU,SAAS,CAAC,OAAyB,EAAA;IACjD,MAAM,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,GAAG,OAAO;;AAGvC,IAAA,MAAM,gBAAgB,GACpB,OAAO,SAAS,KAAK;AACnB,UAAE,QAAQ,CAAC,aAAa,CAAc,SAAS;UAC7C,SAAS;IAEf,IAAI,CAAC,gBAAgB,EAAE;QACrB,MAAM,IAAI,KAAK,CACb,CAAA,wCAAA,CAA0C;AACxC,YAAA,CAAA,UAAA,EAAa,OAAO,SAAS,KAAK,QAAQ,GAAG,SAAS,GAAG,aAAa,CAAA,CAAE,CAC3E;IACH;;AAGA,IAAA,IAAI,MAAM,GAAG,KAAK,CAAC,WAAW,IAAI,KAAK;AACvC,IAAA,IAAI,YAAY,GAAG,EAAE,GAAG,KAAK,EAAE;IAC/B,IAAI,IAAI,GAAgB,IAAI;;IAG5B,MAAM,MAAM,GAAG,MAAK;QAClB,IAAI,CAAC,IAAI,EAAE;AACT,YAAA,IAAI,GAAG,UAAU,CAAC,gBAAgB,CAAC;QACrC;AAEA,QAAA,MAAM,OAAO,GAAG,KAAK,CAAC,aAAa,CAACA,wBAAS,EAAE;AAC7C,YAAA,GAAG,YAAY;AACf,YAAA,WAAW,EAAE,MAAM;YACnB,OAAO,EAAE,MAAK;gBACZ,MAAM,GAAG,KAAK;AACd,gBAAA,YAAY,CAAC,OAAO,IAAI;gBACxB,MAAM,EAAE,CAAC;YACX,CAAC;AACgB,SAAA,CAAC;AAEpB,QAAA,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;AACtB,IAAA,CAAC;;AAGD,IAAA,MAAM,EAAE;;IAGR,OAAO;QACL,OAAO,EAAE,MAAK;YACZ,IAAI,IAAI,EAAE;gBACR,IAAI,CAAC,OAAO,EAAE;gBACd,IAAI,GAAG,IAAI;YACb;QACF,CAAC;QAED,IAAI,EAAE,MAAK;YACT,MAAM,GAAG,IAAI;AACb,YAAA,MAAM,EAAE;QACV,CAAC;QAED,KAAK,EAAE,MAAK;YACV,MAAM,GAAG,KAAK;AACd,YAAA,MAAM,EAAE;QACV,CAAC;AAED,QAAA,MAAM,EAAE,CAAC,UAAqC,KAAI;YAChD,YAAY,GAAG,EAAE,GAAG,YAAY,EAAE,GAAG,UAAU,EAAE;AACjD,YAAA,MAAM,EAAE;QACV,CAAC;KACF;AACH;;;;;","x_google_ignoreList":[0]}

package/dist/index.umd.js

@@ -0,0 +1,2 @@
+!function(e,o){"object"==typeof exports&&"undefined"!=typeof module?o(exports,require("react"),require("react-dom"),require("@seekora-ai/docsearch-react")):"function"==typeof define&&define.amd?define(["exports","react","react-dom","@seekora-ai/docsearch-react"],o):o((e="undefined"!=typeof globalThis?globalThis:e||self).docsearch={},e.React,e.require$$0,e.docsearchReact)}(this,function(e,o,t,r){"use strict";var n,c=t;function a(e){const{container:t,...c}=e,a="string"==typeof t?document.querySelector(t):t;if(!a)throw Error("DocSearch: Container element not found. Provided: "+("string"==typeof t?t:"HTMLElement"));let i=c.initialOpen??!1,d={...c},s=null;const u=()=>{s||(s=n(a));const e=o.createElement(r.DocSearch,{...d,initialOpen:i,onClose:()=>{i=!1,d.onClose?.(),u()}});s.render(e)};return u(),{destroy:()=>{s&&(s.unmount(),s=null)},open:()=>{i=!0,u()},close:()=>{i=!1,u()},update:e=>{d={...d,...e},u()}}}n=c.createRoot,e.default=a,e.docsearch=a,Object.defineProperty(e,"__esModule",{value:!0})});
+//# sourceMappingURL=index.umd.js.map

package/dist/index.umd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.umd.js","sources":["../../../node_modules/.pnpm/react-dom@18.3.1_react@18.3.1/node_modules/react-dom/client.js","../src/index.ts"],"sourcesContent":["'use strict';\n\nvar m = require('react-dom');\nif (process.env.NODE_ENV === 'production') {\n  exports.createRoot = m.createRoot;\n  exports.hydrateRoot = m.hydrateRoot;\n} else {\n  var i = m.__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED;\n  exports.createRoot = function(c, o) {\n    i.usingClientEntryPoint = true;\n    try {\n      return m.createRoot(c, o);\n    } finally {\n      i.usingClientEntryPoint = false;\n    }\n  };\n  exports.hydrateRoot = function(c, h, o) {\n    i.usingClientEntryPoint = true;\n    try {\n      return m.hydrateRoot(c, h, o);\n    } finally {\n      i.usingClientEntryPoint = false;\n    }\n  };\n}\n",null],"names":["m","require$$0","docsearch","options","container","props","containerElement","document","querySelector","Error","isOpen","initialOpen","currentProps","root","render","createRoot","element","React","createElement","DocSearch","onClose","destroy","unmount","open","close","update","newOptions"],"mappings":"iaAEIA,EAAIC,ECmEF,SAAUC,EAAUC,GACxB,MAAMC,UAAEA,KAAcC,GAAUF,EAG1BG,EACiB,iBAAdF,EACHG,SAASC,cAA2BJ,GACpCA,EAEN,IAAKE,EACH,MAAUG,MACR,sDACoC,iBAAdL,EAAyBA,EAAY,gBAK/D,IAAIM,EAASL,EAAMM,cAAe,EAC9BC,EAAe,IAAKP,GACpBQ,EAAoB,KAGxB,MAAMC,EAAS,KACRD,IACHA,EAAOE,EAAWT,IAGpB,MAAMU,EAAUC,EAAMC,cAAcC,YAAW,IAC1CP,EACHD,YAAaD,EACbU,QAAS,KACPV,GAAS,EACTE,EAAaQ,YACbN,OAIJD,EAAKC,OAAOE,IAOd,OAHAF,IAGO,CACLO,QAAS,KACHR,IACFA,EAAKS,UACLT,EAAO,OAIXU,KAAM,KACJb,GAAS,EACTI,KAGFU,MAAO,KACLd,GAAS,EACTI,KAGFW,OAASC,IACPd,EAAe,IAAKA,KAAiBc,GACrCZ,KAGN,CDpIEC,EAAqBf,EAAEe","x_google_ignoreList":[0]}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@seekora-ai/docsearch-js",
+  "version": "0.1.1",
+  "description": "Seekora DocSearch JavaScript - Vanilla JS wrapper for documentation search",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "module": "dist/index.esm.js",
+  "unpkg": "dist/index.umd.js",
+  "exports": {
+    ".": {
+      "import": "./dist/index.esm.js",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "rollup -c",
+    "dev": "rollup -c -w",
+    "clean": "rm -rf dist",
+    "test": "echo \"Tests pending\" && exit 0",
+    "lint": "tsc --noEmit"
+  },
+  "keywords": [
+    "seekora",
+    "docsearch",
+    "javascript",
+    "vanilla",
+    "search",
+    "documentation"
+  ],
+  "author": "Seekora",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/seekora/seekora-docsearch.git",
+    "directory": "packages/js"
+  },
+  "dependencies": {
+    "@seekora-ai/docsearch-react": "^0.1.1",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0"
+  },
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^25.0.7",
+    "@rollup/plugin-node-resolve": "^15.2.3",
+    "@rollup/plugin-replace": "^5.0.5",
+    "@rollup/plugin-terser": "^0.4.4",
+    "@rollup/plugin-typescript": "^11.1.5",
+    "@types/react": "^18.2.0",
+    "@types/react-dom": "^18.2.0",
+    "rollup": "^4.9.0",
+    "rollup-plugin-dts": "^6.1.0",
+    "tslib": "^2.8.1",
+    "typescript": "^5.3.0"
+  }
+}