tycho-components 0.46.5 → 0.47.1

package/dist/index.d.ts

@@ -2,6 +2,7 @@ export * from './common';
 export * from './shell';
 export { default as HelpButton } from './shell/Header/HelpButton';
 export type { HelpAction } from './shell/Header/HelpButton/HelpButton';
+export { loadHelpAssistant, openHelpAssistant, isHelpAssistantEnabled, } from './shell/Header/HelpButton/helpAssistant';
 export * from './configs';
 export * from './functions';
 export * from './features';

package/dist/index.js

@@ -1,6 +1,7 @@
 export * from './common';
 export * from './shell';
 export { default as HelpButton } from './shell/Header/HelpButton';
+export { loadHelpAssistant, openHelpAssistant, isHelpAssistantEnabled, } from './shell/Header/HelpButton/helpAssistant';
 export * from './configs';
 export * from './functions';
 export * from './features';

package/dist/shell/Header/HelpButton/helpAssistant.d.ts

@@ -0,0 +1,28 @@
+/**
+ * CorpusHub help assistant — offline RAG chat (tycho-brahe/corpushub-rag).
+ *
+ * The widget is a single implementation served by the RAG API itself (`GET <api>widget.js`), so the
+ * fronts never carry a copy: changing the assistant is a RAG deploy, not a front rebuild.
+ * Call `loadHelpAssistant(import.meta.env.VITE_APP_HELP_ASSISTANT_API)` once at app start (main.tsx).
+ * With no API URL (e.g. production today) nothing is loaded and the Header help button stays hidden.
+ */
+type AgentApi = {
+    open: () => void;
+    close?: () => void;
+    toggle?: () => void;
+    isOpen?: () => boolean;
+    _pendingOpen?: boolean;
+};
+declare global {
+    interface Window {
+        CorpusHubAgent?: AgentApi;
+    }
+}
+type Options = {
+    /** 'floating' (default) shows the widget's own corner button; 'none' leaves opening to the app. */
+    launcher?: 'floating' | 'none';
+};
+export declare function loadHelpAssistant(api?: string, options?: Options): void;
+export declare function isHelpAssistantEnabled(): boolean;
+export declare function openHelpAssistant(): void;
+export {};

package/dist/shell/Header/HelpButton/helpAssistant.js

@@ -0,0 +1,29 @@
+const SELECTOR = 'script[data-corpushub-agent]';
+export function loadHelpAssistant(api, options = {}) {
+    if (!api || typeof document === 'undefined' || document.querySelector(SELECTOR))
+        return;
+    const base = api.endsWith('/') ? api : `${api}/`;
+    // Stub until the script arrives: an early open() is remembered and honoured by the widget.
+    if (!window.CorpusHubAgent) {
+        window.CorpusHubAgent = {
+            _pendingOpen: false,
+            open() {
+                this._pendingOpen = true;
+            },
+        };
+    }
+    const script = document.createElement('script');
+    script.src = `${base}widget.js`;
+    script.dataset.api = base;
+    script.dataset.corpushubAgent = '';
+    if (options.launcher)
+        script.dataset.launcher = options.launcher;
+    script.defer = true;
+    document.head.appendChild(script);
+}
+export function isHelpAssistantEnabled() {
+    return typeof document !== 'undefined' && !!document.querySelector(SELECTOR);
+}
+export function openHelpAssistant() {
+    window.CorpusHubAgent?.open();
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "tycho-components",
   "private": false,
-  "version": "0.46.5",
+  "version": "0.47.1",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {