@seed-ship/mcp-ui-solid 2.3.0 → 2.4.0

package/dist/components/ChatPrompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatPrompt.js","sources":["../../src/components/ChatPrompt.tsx"],"sourcesContent":["/**\n * ChatPrompt — Ephemeral structured interaction above chat input\n * v2.4.0: choice, confirm, form subtypes\n *\n * @experimental — This component may change without major bump until v2.5.0.\n *\n * Renders above the chat input. User responds → Promise resolves → prompt disappears.\n * Supports AbortSignal for cleanup on navigation (C4).\n */\n\nimport { Component, Show, For, createSignal, onCleanup, Switch, Match } from 'solid-js'\nimport type {\n  ChatPromptConfig,\n  ChatPromptResponse,\n  ChoicePromptConfig,\n  ConfirmPromptConfig,\n  FormPromptConfig,\n} from '../types/chat-bus'\n\nexport interface ChatPromptProps {\n  /** Prompt configuration */\n  config: ChatPromptConfig\n  /** Called when user responds */\n  onSubmit: (response: ChatPromptResponse) => void\n  /** Called when user dismisses */\n  onDismiss?: () => void\n}\n\n/**\n * @experimental\n * Ephemeral interaction component — choice buttons, confirmation dialog, or quick form.\n * Designed to sit between the chat messages and the input area.\n *\n * @example\n * <ChatPrompt\n *   config={{ type: 'choice', title: 'Format?', config: { options: [...] } }}\n *   onSubmit={(r) => bus.events.emit('onChatPromptResponse', { streamKey, response: r })}\n *   onDismiss={() => setActivePrompt(null)}\n * />\n */\nexport const ChatPrompt: Component<ChatPromptProps> = (props) => {\n  return (\n    <div\n      class=\"w-full max-w-2xl mx-auto mb-2 bg-white dark:bg-gray-800 rounded-xl border border-gray-200 dark:border-gray-700 shadow-lg overflow-hidden\"\n      style={{ animation: 'chat-prompt-slide-up 0.2s ease-out' }}\n      role=\"dialog\"\n      aria-label={props.config.title}\n    >\n      {/* Header */}\n      <div class=\"flex items-center justify-between px-4 py-2.5 border-b border-gray-100 dark:border-gray-700\">\n        <p class=\"text-sm font-medium text-gray-900 dark:text-white\">{props.config.title}</p>\n        <button\n          onClick={() => {\n            props.onDismiss?.()\n            props.onSubmit({ type: props.config.type, value: '', label: '', dismissed: true })\n          }}\n          class=\"p-1 text-gray-400 hover:text-gray-600 dark:hover:text-gray-300 rounded-full hover:bg-gray-100 dark:hover:bg-gray-700 transition-colors\"\n          aria-label=\"Dismiss\"\n        >\n          <svg class=\"w-4 h-4\" fill=\"none\" viewBox=\"0 0 24 24\" stroke=\"currentColor\">\n            <path stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M6 18L18 6M6 6l12 12\" />\n          </svg>\n        </button>\n      </div>\n\n      {/* Body — type-specific */}\n      <div class=\"px-4 py-3\">\n        <Switch>\n          <Match when={props.config.type === 'choice'}>\n            <ChoiceBody\n              config={props.config.config as ChoicePromptConfig}\n              onSelect={(value, label) => props.onSubmit({ type: 'choice', value, label })}\n            />\n          </Match>\n          <Match when={props.config.type === 'confirm'}>\n            <ConfirmBody\n              config={props.config.config as ConfirmPromptConfig}\n              onConfirm={() => props.onSubmit({ type: 'confirm', value: 'confirmed', label: (props.config.config as ConfirmPromptConfig).confirmLabel || 'Confirmed' })}\n              onCancel={() => {\n                props.onDismiss?.()\n                props.onSubmit({ type: 'confirm', value: 'cancelled', label: (props.config.config as ConfirmPromptConfig).cancelLabel || 'Cancelled', dismissed: true })\n              }}\n            />\n          </Match>\n          <Match when={props.config.type === 'form'}>\n            <FormBody\n              config={props.config.config as FormPromptConfig}\n              onSubmit={(data, label) => props.onSubmit({ type: 'form', value: data, label })}\n            />\n          </Match>\n        </Switch>\n      </div>\n\n      <style>{`\n        @keyframes chat-prompt-slide-up {\n          from { opacity: 0; transform: translateY(8px); }\n          to { opacity: 1; transform: translateY(0); }\n        }\n      `}</style>\n    </div>\n  )\n}\n\n// ─── Choice ──────────────────────────────────────────────────\n\nconst ChoiceBody: Component<{\n  config: ChoicePromptConfig\n  onSelect: (value: string, label: string) => void\n}> = (props) => {\n  const layoutClass = () => {\n    switch (props.config.layout) {\n      case 'vertical': return 'flex flex-col gap-2'\n      case 'grid': return 'grid grid-cols-2 gap-2'\n      default: return 'flex flex-wrap gap-2'\n    }\n  }\n\n  return (\n    <div class={layoutClass()}>\n      <For each={props.config.options}>\n        {(option) => (\n          <button\n            onClick={() => props.onSelect(option.value, option.label)}\n            class=\"px-4 py-2 text-sm font-medium rounded-lg border border-gray-200 dark:border-gray-600 bg-gray-50 dark:bg-gray-700 text-gray-900 dark:text-white hover:bg-blue-50 hover:border-blue-300 dark:hover:bg-blue-900/30 dark:hover:border-blue-600 transition-colors text-left\"\n          >\n            <Show when={option.icon}>\n              <span class=\"mr-2\">{option.icon}</span>\n            </Show>\n            {option.label}\n            <Show when={option.description}>\n              <span class=\"block text-xs text-gray-500 dark:text-gray-400 mt-0.5 font-normal\">{option.description}</span>\n            </Show>\n          </button>\n        )}\n      </For>\n    </div>\n  )\n}\n\n// ─── Confirm ─────────────────────────────────────────────────\n\nconst ConfirmBody: Component<{\n  config: ConfirmPromptConfig\n  onConfirm: () => void\n  onCancel: () => void\n}> = (props) => {\n  const isDanger = () => props.config.variant === 'danger'\n\n  return (\n    <div>\n      <Show when={props.config.message}>\n        <p class=\"text-sm text-gray-600 dark:text-gray-400 mb-3\">{props.config.message}</p>\n      </Show>\n      <div class=\"flex gap-2 justify-end\">\n        <button\n          onClick={props.onCancel}\n          class=\"px-4 py-2 text-sm font-medium rounded-lg border border-gray-200 dark:border-gray-600 text-gray-700 dark:text-gray-300 hover:bg-gray-100 dark:hover:bg-gray-700 transition-colors\"\n        >\n          {props.config.cancelLabel || 'Cancel'}\n        </button>\n        <button\n          onClick={props.onConfirm}\n          class={`px-4 py-2 text-sm font-medium rounded-lg text-white transition-colors ${\n            isDanger()\n              ? 'bg-red-600 hover:bg-red-700'\n              : 'bg-blue-600 hover:bg-blue-700'\n          }`}\n        >\n          {props.config.confirmLabel || 'Confirm'}\n        </button>\n      </div>\n    </div>\n  )\n}\n\n// ─── Form ────────────────────────────────────────────────────\n\nconst FormBody: Component<{\n  config: FormPromptConfig\n  onSubmit: (data: Record<string, unknown>, label: string) => void\n}> = (props) => {\n  const [formData, setFormData] = createSignal<Record<string, string>>({})\n\n  const updateField = (name: string, value: string) => {\n    setFormData((prev) => ({ ...prev, [name]: value }))\n  }\n\n  const handleSubmit = (e: Event) => {\n    e.preventDefault()\n    const data = formData()\n    // Build a human-readable label from the form values\n    const label = Object.entries(data)\n      .filter(([, v]) => v)\n      .map(([k, v]) => `${k}: ${v}`)\n      .join(', ')\n    props.onSubmit(data, label || 'Form submitted')\n  }\n\n  const isValid = () => {\n    const data = formData()\n    return (props.config.fields || [])\n      .filter((f) => f.required)\n      .every((f) => data[f.name]?.trim())\n  }\n\n  return (\n    <form onSubmit={handleSubmit} class=\"flex flex-col gap-3\">\n      <For each={props.config.fields}>\n        {(field) => (\n          <div>\n            <label class=\"block text-xs font-medium text-gray-600 dark:text-gray-400 mb-1\">\n              {field.label}\n              <Show when={field.required}>\n                <span class=\"text-red-500 ml-0.5\">*</span>\n              </Show>\n            </label>\n            <Switch>\n              <Match when={field.type === 'textarea'}>\n                <textarea\n                  value={formData()[field.name] || ''}\n                  onInput={(e) => updateField(field.name, e.currentTarget.value)}\n                  placeholder={field.placeholder}\n                  rows={3}\n                  class=\"w-full px-3 py-2 text-sm rounded-lg border border-gray-200 dark:border-gray-600 bg-white dark:bg-gray-700 text-gray-900 dark:text-white focus:border-blue-400 focus:ring-1 focus:ring-blue-400 outline-none transition-colors\"\n                />\n              </Match>\n              <Match when={field.type === 'select'}>\n                <select\n                  value={formData()[field.name] || ''}\n                  onChange={(e) => updateField(field.name, e.currentTarget.value)}\n                  class=\"w-full px-3 py-2 text-sm rounded-lg border border-gray-200 dark:border-gray-600 bg-white dark:bg-gray-700 text-gray-900 dark:text-white focus:border-blue-400 focus:ring-1 focus:ring-blue-400 outline-none transition-colors\"\n                >\n                  <option value=\"\">{field.placeholder || 'Select...'}</option>\n                  <For each={field.options}>\n                    {(opt) => <option value={opt.value}>{opt.label}</option>}\n                  </For>\n                </select>\n              </Match>\n              <Match when={true}>\n                <input\n                  type={field.type === 'number' ? 'number' : 'text'}\n                  value={formData()[field.name] || ''}\n                  onInput={(e) => updateField(field.name, e.currentTarget.value)}\n                  placeholder={field.placeholder}\n                  class=\"w-full px-3 py-2 text-sm rounded-lg border border-gray-200 dark:border-gray-600 bg-white dark:bg-gray-700 text-gray-900 dark:text-white focus:border-blue-400 focus:ring-1 focus:ring-blue-400 outline-none transition-colors\"\n                />\n              </Match>\n            </Switch>\n          </div>\n        )}\n      </For>\n      <div class=\"flex justify-end\">\n        <button\n          type=\"submit\"\n          disabled={!isValid()}\n          class=\"px-4 py-2 text-sm font-medium rounded-lg text-white bg-blue-600 hover:bg-blue-700 disabled:bg-gray-400 disabled:cursor-not-allowed transition-colors\"\n        >\n          {props.config.submitLabel || 'Submit'}\n        </button>\n      </div>\n    </form>\n  )\n}\n"],"names":["ChatPrompt","props","_el$","_$getNextElement","_tmpl$","_el$2","firstChild","_el$3","_el$4","nextSibling","_el$5","_$insert","config","title","$$click","onDismiss","onSubmit","type","value","label","dismissed","_$createComponent","Switch","children","Match","when","ChoiceBody","onSelect","ConfirmBody","onConfirm","confirmLabel","onCancel","cancelLabel","FormBody","data","_$effect","_$setAttribute","_$runHydrationEvents","layoutClass","layout","_el$6","_tmpl$2","For","each","options","option","_el$7","_tmpl$5","_el$0","_el$1","_co$","_$getNextMarker","_el$10","_el$11","_co$2","_el$12","_el$13","_co$3","Show","icon","_el$8","_tmpl$3","description","_el$9","_tmpl$4","_$className","isDanger","variant","_el$14","_tmpl$7","_el$19","_el$20","_co$4","_el$16","_el$17","_el$18","message","_el$15","_tmpl$6","_$addEventListener","formData","setFormData","createSignal","updateField","name","prev","handleSubmit","e","preventDefault","Object","entries","filter","v","map","k","join","isValid","fields","f","required","every","trim","_el$21","_tmpl$8","_el$24","_el$25","_co$5","_el$22","_el$23","addEventListener","field","_el$26","_tmpl$11","_el$27","_el$29","_el$30","_co$6","_el$31","_el$32","_co$7","_el$39","_el$40","_co$9","_tmpl$9","_el$33","_tmpl$0","$$input","currentTarget","placeholder","_$setProperty","_el$34","_tmpl$1","_el$35","_el$36","_el$37","_co$8","opt","_el$41","_tmpl$12","_el$38","_tmpl$10","_p$","_v$","_v$2","t","undefined","submitLabel","_$delegateEvents"],"mappings":"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"}

package/dist/hooks/useChatBus.cjs

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const web = require("solid-js/web");
+const solidJs = require("solid-js");
+const chatBus = require("../services/chat-bus.cjs");
+const ChatBusContext = solidJs.createContext();
+const ChatBusProvider = (props) => {
+  const bus = props.bus ?? chatBus.createChatBus();
+  solidJs.onCleanup(() => {
+    bus.events.clear();
+  });
+  return web.createComponent(ChatBusContext.Provider, {
+    value: bus,
+    get children() {
+      return props.children;
+    }
+  });
+};
+function useChatBus() {
+  const bus = solidJs.useContext(ChatBusContext);
+  if (!bus) {
+    throw new Error("useChatBus must be used within a <ChatBusProvider>");
+  }
+  return bus;
+}
+exports.ChatBusProvider = ChatBusProvider;
+exports.useChatBus = useChatBus;
+//# sourceMappingURL=useChatBus.cjs.map

package/dist/hooks/useChatBus.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChatBus.cjs","sources":["../../src/hooks/useChatBus.tsx"],"sourcesContent":["/**\n * useChatBus — SolidJS hook + context provider for the Chat Bus\n * v2.4.0: Event-driven chat toolkit\n *\n * @experimental — This API may change without major bump until v2.5.0.\n */\n\nimport { createContext, useContext, onCleanup, type ParentComponent } from 'solid-js'\nimport { createChatBus } from '../services/chat-bus'\nimport type { ChatBus } from '../types/chat-bus'\n\n// ─── Context ─────────────────────────────────────────────────\n\nconst ChatBusContext = createContext<ChatBus>()\n\n/**\n * @experimental\n * Provider that creates and shares a ChatBus with all children.\n * Cleans up all listeners on unmount.\n *\n * @example\n * <ChatBusProvider>\n *   <ChatInterfaceStreaming />\n *   <BriefingPanel />\n *   <AgentRouter />\n * </ChatBusProvider>\n */\nexport const ChatBusProvider: ParentComponent<{ bus?: ChatBus }> = (props) => {\n  const bus = props.bus ?? createChatBus()\n\n  onCleanup(() => {\n    bus.events.clear()\n  })\n\n  return (\n    <ChatBusContext.Provider value={bus}>\n      {props.children}\n    </ChatBusContext.Provider>\n  )\n}\n\n// ─── Hook ────────────────────────────────────────────────────\n\n/**\n * @experimental\n * Access the ChatBus from any child component.\n * Must be used within a `<ChatBusProvider>`.\n *\n * @example\n * function BriefingPanel() {\n *   const bus = useChatBus()\n *\n *   bus.events.on('onBriefing', (event) => {\n *     addBriefing(event.briefing)\n *   })\n *\n *   return <div>...</div>\n * }\n *\n * @example\n * function AgentRouter() {\n *   const bus = useChatBus()\n *\n *   bus.events.on('onStreamEnd', (event) => {\n *     if (event.metadata.needs_clarification) {\n *       bus.commands.exec('showChatPrompt', {\n *         type: 'choice',\n *         title: 'Quelle periode ?',\n *         config: { options: [...] }\n *       })\n *     }\n *   })\n * }\n */\nexport function useChatBus(): ChatBus {\n  const bus = useContext(ChatBusContext)\n  if (!bus) {\n    throw new Error('useChatBus must be used within a <ChatBusProvider>')\n  }\n  return bus\n}\n"],"names":["ChatBusContext","createContext","ChatBusProvider","props","bus","createChatBus","onCleanup","events","clear","_$createComponent","Provider","value","children","useChatBus","useContext","Error"],"mappings":";;;;;AAaA,MAAMA,iBAAiBC,QAAAA,cAAAA;AAchB,MAAMC,kBAAuDC,CAAAA,UAAU;AAC5E,QAAMC,MAAMD,MAAMC,OAAOC,sBAAAA;AAEzBC,UAAAA,UAAU,MAAM;AACdF,QAAIG,OAAOC,MAAAA;AAAAA,EACb,CAAC;AAED,SAAAC,IAAAA,gBACGT,eAAeU,UAAQ;AAAA,IAACC,OAAOP;AAAAA,IAAG,IAAAQ,WAAA;AAAA,aAChCT,MAAMS;AAAAA,IAAQ;AAAA,EAAA,CAAA;AAGrB;AAmCO,SAASC,aAAsB;AACpC,QAAMT,MAAMU,QAAAA,WAAWd,cAAc;AACrC,MAAI,CAACI,KAAK;AACR,UAAM,IAAIW,MAAM,oDAAoD;AAAA,EACtE;AACA,SAAOX;AACT;;;"}

package/dist/hooks/useChatBus.d.ts

@@ -0,0 +1,56 @@
+/**
+ * useChatBus — SolidJS hook + context provider for the Chat Bus
+ * v2.4.0: Event-driven chat toolkit
+ *
+ * @experimental — This API may change without major bump until v2.5.0.
+ */
+import { type ParentComponent } from 'solid-js';
+import type { ChatBus } from '../types/chat-bus';
+/**
+ * @experimental
+ * Provider that creates and shares a ChatBus with all children.
+ * Cleans up all listeners on unmount.
+ *
+ * @example
+ * <ChatBusProvider>
+ *   <ChatInterfaceStreaming />
+ *   <BriefingPanel />
+ *   <AgentRouter />
+ * </ChatBusProvider>
+ */
+export declare const ChatBusProvider: ParentComponent<{
+    bus?: ChatBus;
+}>;
+/**
+ * @experimental
+ * Access the ChatBus from any child component.
+ * Must be used within a `<ChatBusProvider>`.
+ *
+ * @example
+ * function BriefingPanel() {
+ *   const bus = useChatBus()
+ *
+ *   bus.events.on('onBriefing', (event) => {
+ *     addBriefing(event.briefing)
+ *   })
+ *
+ *   return <div>...</div>
+ * }
+ *
+ * @example
+ * function AgentRouter() {
+ *   const bus = useChatBus()
+ *
+ *   bus.events.on('onStreamEnd', (event) => {
+ *     if (event.metadata.needs_clarification) {
+ *       bus.commands.exec('showChatPrompt', {
+ *         type: 'choice',
+ *         title: 'Quelle periode ?',
+ *         config: { options: [...] }
+ *       })
+ *     }
+ *   })
+ * }
+ */
+export declare function useChatBus(): ChatBus;
+//# sourceMappingURL=useChatBus.d.ts.map

package/dist/hooks/useChatBus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChatBus.d.ts","sourceRoot":"","sources":["../../src/hooks/useChatBus.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAwC,KAAK,eAAe,EAAE,MAAM,UAAU,CAAA;AAErF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAMhD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,eAAe,EAAE,eAAe,CAAC;IAAE,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,CAY9D,CAAA;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAMpC"}

package/dist/hooks/useChatBus.js

@@ -0,0 +1,28 @@
+import { createComponent } from "solid-js/web";
+import { createContext, onCleanup, useContext } from "solid-js";
+import { createChatBus } from "../services/chat-bus.js";
+const ChatBusContext = createContext();
+const ChatBusProvider = (props) => {
+  const bus = props.bus ?? createChatBus();
+  onCleanup(() => {
+    bus.events.clear();
+  });
+  return createComponent(ChatBusContext.Provider, {
+    value: bus,
+    get children() {
+      return props.children;
+    }
+  });
+};
+function useChatBus() {
+  const bus = useContext(ChatBusContext);
+  if (!bus) {
+    throw new Error("useChatBus must be used within a <ChatBusProvider>");
+  }
+  return bus;
+}
+export {
+  ChatBusProvider,
+  useChatBus
+};
+//# sourceMappingURL=useChatBus.js.map

package/dist/hooks/useChatBus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChatBus.js","sources":["../../src/hooks/useChatBus.tsx"],"sourcesContent":["/**\n * useChatBus — SolidJS hook + context provider for the Chat Bus\n * v2.4.0: Event-driven chat toolkit\n *\n * @experimental — This API may change without major bump until v2.5.0.\n */\n\nimport { createContext, useContext, onCleanup, type ParentComponent } from 'solid-js'\nimport { createChatBus } from '../services/chat-bus'\nimport type { ChatBus } from '../types/chat-bus'\n\n// ─── Context ─────────────────────────────────────────────────\n\nconst ChatBusContext = createContext<ChatBus>()\n\n/**\n * @experimental\n * Provider that creates and shares a ChatBus with all children.\n * Cleans up all listeners on unmount.\n *\n * @example\n * <ChatBusProvider>\n *   <ChatInterfaceStreaming />\n *   <BriefingPanel />\n *   <AgentRouter />\n * </ChatBusProvider>\n */\nexport const ChatBusProvider: ParentComponent<{ bus?: ChatBus }> = (props) => {\n  const bus = props.bus ?? createChatBus()\n\n  onCleanup(() => {\n    bus.events.clear()\n  })\n\n  return (\n    <ChatBusContext.Provider value={bus}>\n      {props.children}\n    </ChatBusContext.Provider>\n  )\n}\n\n// ─── Hook ────────────────────────────────────────────────────\n\n/**\n * @experimental\n * Access the ChatBus from any child component.\n * Must be used within a `<ChatBusProvider>`.\n *\n * @example\n * function BriefingPanel() {\n *   const bus = useChatBus()\n *\n *   bus.events.on('onBriefing', (event) => {\n *     addBriefing(event.briefing)\n *   })\n *\n *   return <div>...</div>\n * }\n *\n * @example\n * function AgentRouter() {\n *   const bus = useChatBus()\n *\n *   bus.events.on('onStreamEnd', (event) => {\n *     if (event.metadata.needs_clarification) {\n *       bus.commands.exec('showChatPrompt', {\n *         type: 'choice',\n *         title: 'Quelle periode ?',\n *         config: { options: [...] }\n *       })\n *     }\n *   })\n * }\n */\nexport function useChatBus(): ChatBus {\n  const bus = useContext(ChatBusContext)\n  if (!bus) {\n    throw new Error('useChatBus must be used within a <ChatBusProvider>')\n  }\n  return bus\n}\n"],"names":["ChatBusContext","createContext","ChatBusProvider","props","bus","createChatBus","onCleanup","events","clear","_$createComponent","Provider","value","children","useChatBus","useContext","Error"],"mappings":";;;AAaA,MAAMA,iBAAiBC,cAAAA;AAchB,MAAMC,kBAAuDC,CAAAA,UAAU;AAC5E,QAAMC,MAAMD,MAAMC,OAAOC,cAAAA;AAEzBC,YAAU,MAAM;AACdF,QAAIG,OAAOC,MAAAA;AAAAA,EACb,CAAC;AAED,SAAAC,gBACGT,eAAeU,UAAQ;AAAA,IAACC,OAAOP;AAAAA,IAAG,IAAAQ,WAAA;AAAA,aAChCT,MAAMS;AAAAA,IAAQ;AAAA,EAAA,CAAA;AAGrB;AAmCO,SAASC,aAAsB;AACpC,QAAMT,MAAMU,WAAWd,cAAc;AACrC,MAAI,CAACI,KAAK;AACR,UAAM,IAAIW,MAAM,oDAAoD;AAAA,EACtE;AACA,SAAOX;AACT;"}

package/dist/index.cjs

@@ -21,6 +21,8 @@ const ResizeHandle = require("./components/ResizeHandle.cjs");
 const EditableUIResourceRenderer = require("./components/EditableUIResourceRenderer.cjs");
 const ExpandableWrapper = require("./components/ExpandableWrapper.cjs");
 const ComponentToolbar = require("./components/ComponentToolbar.cjs");
+const useChatBus = require("./hooks/useChatBus.cjs");
+const ChatPrompt = require("./components/ChatPrompt.cjs");
 const GhostText = require("./components/GhostText.cjs");
 const AutocompleteDropdown = require("./components/AutocompleteDropdown.cjs");
 const AutocompleteFormField = require("./components/AutocompleteFormField.cjs");
@@ -39,6 +41,7 @@ const supabase = require("./plugins/supabase.cjs");
 const rest = require("./plugins/rest.cjs");
 const validation = require("./services/validation.cjs");
 const componentRegistry = require("./services/component-registry.cjs");
+const chatBus = require("./services/chat-bus.cjs");
 exports.UIResourceRenderer = UIResourceRenderer.UIResourceRenderer;
 exports.StreamingUIRenderer = StreamingUIRenderer.StreamingUIRenderer;
 exports.GenerativeUIErrorBoundary = GenerativeUIErrorBoundary.GenerativeUIErrorBoundary;
@@ -47,6 +50,9 @@ exports.ResizeHandle = ResizeHandle.ResizeHandle;
 exports.EditableUIResourceRenderer = EditableUIResourceRenderer.EditableUIResourceRenderer;
 exports.ExpandableWrapper = ExpandableWrapper.ExpandableWrapper;
 exports.ComponentToolbar = ComponentToolbar.ComponentToolbar;
+exports.ChatBusProvider = useChatBus.ChatBusProvider;
+exports.useChatBus = useChatBus.useChatBus;
+exports.ChatPrompt = ChatPrompt.ChatPrompt;
 exports.GhostText = GhostText.GhostText;
 exports.GhostTextInput = GhostText.GhostTextInput;
 exports.AutocompleteDropdown = AutocompleteDropdown.AutocompleteDropdown;
@@ -80,4 +86,7 @@ exports.validateComponent = validation.validateComponent;
 exports.validateIframeDomain = validation.validateIframeDomain;
 exports.validateLayout = validation.validateLayout;
 exports.ComponentRegistry = componentRegistry.ComponentRegistry;
+exports.createChatBus = chatBus.createChatBus;
+exports.createCommandHandler = chatBus.createCommandHandler;
+exports.createEventEmitter = chatBus.createEventEmitter;
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/index.d.cts

@@ -33,6 +33,8 @@ export { ResizeHandle } from './components/ResizeHandle';
 export { EditableUIResourceRenderer } from './components/EditableUIResourceRenderer';
 export { ExpandableWrapper } from './components/ExpandableWrapper';
 export { ComponentToolbar } from './components/ComponentToolbar';
+export { ChatBusProvider, useChatBus } from './hooks/useChatBus';
+export { ChatPrompt } from './components/ChatPrompt';
 export { GhostText, GhostTextInput } from './components/GhostText';
 export { AutocompleteDropdown } from './components/AutocompleteDropdown';
 export { AutocompleteFormField } from './components/AutocompleteFormField';
@@ -42,6 +44,7 @@ export type { ResizeHandleProps as ResizeHandleComponentProps } from './componen
 export type { EditableUIResourceRendererProps } from './components/EditableUIResourceRenderer';
 export type { ExpandableWrapperProps } from './components/ExpandableWrapper';
 export type { ComponentToolbarProps, ToolbarAction, ToolbarIcon } from './components/ComponentToolbar';
+export type { ChatPromptProps } from './components/ChatPrompt';
 export type { GhostTextProps, GhostTextInputProps } from './components/GhostText';
 export type { AutocompleteDropdownProps } from './components/AutocompleteDropdown';
 export type { AutocompleteFormFieldProps, AutocompleteFormFieldParams } from './components/AutocompleteFormField';
@@ -53,5 +56,6 @@ export type { MCPActionContextValue, MCPActionProviderProps, ActionRequest, Acti
 export type { AutocompleteContextValue, AutocompleteProviderProps, } from './context/AutocompleteContext';
 export { createGroqPlugin, createSupabasePlugin, createRestPlugin, } from './plugins';
 export type { UIComponent, UILayout, GridPosition, ComponentType, RendererError, ChartComponentParams, TableComponentParams, MetricComponentParams, TextComponentParams, ActionComponentParams, GridComponentParams, FormFieldOption, FormFieldType, FormFieldParams, FormComponentParams, ShowWhenOperator, ShowWhenCondition, ActionRequestBase, ActionResultBase, ActionLifecycleCallbacks, ModalSize, ModalComponentParams, ActionGroupLayout, ActionGroupGap, ActionGroupParams, GalleryImage, ImageGalleryParams, VideoComponentParams, CodeComponentParams, MapMarker, MapComponentParams, IframePolicy, ValidationOptions, ResizeConstraints, DragDropConfig, DragEventData, DraggableGridItemProps as DraggableGridItemPropsType, AutocompleteResultType, AutocompleteOption, AutocompleteResult, AutocompleteContext, AutocompletePlugin, GroqPluginConfig, SupabasePluginConfig, DuckDBPluginConfig, RestPluginConfig, FieldAutocompleteConfig, AutocompleteProviderConfig, } from './types';
-export { validateComponent, validateLayout, validateIframeDomain, getIframeSandbox, DEFAULT_RESOURCE_LIMITS, DEFAULT_IFRAME_DOMAINS, TRUSTED_IFRAME_DOMAINS, ComponentRegistry, } from './services';
+export { validateComponent, validateLayout, validateIframeDomain, getIframeSandbox, DEFAULT_RESOURCE_LIMITS, DEFAULT_IFRAME_DOMAINS, TRUSTED_IFRAME_DOMAINS, ComponentRegistry, createEventEmitter, createCommandHandler, createChatBus, } from './services';
+export type { ChatEventBase, ChatEvents, ChatCommands, ChatBus, ChatEventEmitter, ChatCommandHandler, EventSubscribeOptions, ChatPromptConfig, ChatPromptResponse, ChoicePromptConfig, ConfirmPromptConfig, FormPromptConfig, SelectPromptConfig, SuggestionItem, AgentContext, BriefingEvent, BriefingSection, StreamDoneMetadata, ChatError, Citation, ToolCallEvent, ClarificationEvent, } from './types/chat-bus';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts

@@ -33,6 +33,8 @@ export { ResizeHandle } from './components/ResizeHandle';
 export { EditableUIResourceRenderer } from './components/EditableUIResourceRenderer';
 export { ExpandableWrapper } from './components/ExpandableWrapper';
 export { ComponentToolbar } from './components/ComponentToolbar';
+export { ChatBusProvider, useChatBus } from './hooks/useChatBus';
+export { ChatPrompt } from './components/ChatPrompt';
 export { GhostText, GhostTextInput } from './components/GhostText';
 export { AutocompleteDropdown } from './components/AutocompleteDropdown';
 export { AutocompleteFormField } from './components/AutocompleteFormField';
@@ -42,6 +44,7 @@ export type { ResizeHandleProps as ResizeHandleComponentProps } from './componen
 export type { EditableUIResourceRendererProps } from './components/EditableUIResourceRenderer';
 export type { ExpandableWrapperProps } from './components/ExpandableWrapper';
 export type { ComponentToolbarProps, ToolbarAction, ToolbarIcon } from './components/ComponentToolbar';
+export type { ChatPromptProps } from './components/ChatPrompt';
 export type { GhostTextProps, GhostTextInputProps } from './components/GhostText';
 export type { AutocompleteDropdownProps } from './components/AutocompleteDropdown';
 export type { AutocompleteFormFieldProps, AutocompleteFormFieldParams } from './components/AutocompleteFormField';
@@ -53,5 +56,6 @@ export type { MCPActionContextValue, MCPActionProviderProps, ActionRequest, Acti
 export type { AutocompleteContextValue, AutocompleteProviderProps, } from './context/AutocompleteContext';
 export { createGroqPlugin, createSupabasePlugin, createRestPlugin, } from './plugins';
 export type { UIComponent, UILayout, GridPosition, ComponentType, RendererError, ChartComponentParams, TableComponentParams, MetricComponentParams, TextComponentParams, ActionComponentParams, GridComponentParams, FormFieldOption, FormFieldType, FormFieldParams, FormComponentParams, ShowWhenOperator, ShowWhenCondition, ActionRequestBase, ActionResultBase, ActionLifecycleCallbacks, ModalSize, ModalComponentParams, ActionGroupLayout, ActionGroupGap, ActionGroupParams, GalleryImage, ImageGalleryParams, VideoComponentParams, CodeComponentParams, MapMarker, MapComponentParams, IframePolicy, ValidationOptions, ResizeConstraints, DragDropConfig, DragEventData, DraggableGridItemProps as DraggableGridItemPropsType, AutocompleteResultType, AutocompleteOption, AutocompleteResult, AutocompleteContext, AutocompletePlugin, GroqPluginConfig, SupabasePluginConfig, DuckDBPluginConfig, RestPluginConfig, FieldAutocompleteConfig, AutocompleteProviderConfig, } from './types';
-export { validateComponent, validateLayout, validateIframeDomain, getIframeSandbox, DEFAULT_RESOURCE_LIMITS, DEFAULT_IFRAME_DOMAINS, TRUSTED_IFRAME_DOMAINS, ComponentRegistry, } from './services';
+export { validateComponent, validateLayout, validateIframeDomain, getIframeSandbox, DEFAULT_RESOURCE_LIMITS, DEFAULT_IFRAME_DOMAINS, TRUSTED_IFRAME_DOMAINS, ComponentRegistry, createEventEmitter, createCommandHandler, createChatBus, } from './services';
+export type { ChatEventBase, ChatEvents, ChatCommands, ChatBus, ChatEventEmitter, ChatCommandHandler, EventSubscribeOptions, ChatPromptConfig, ChatPromptResponse, ChoicePromptConfig, ConfirmPromptConfig, FormPromptConfig, SelectPromptConfig, SuggestionItem, AgentContext, BriefingEvent, BriefingSection, StreamDoneMetadata, ChatError, Citation, ToolCallEvent, ClarificationEvent, } from './types/chat-bus';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -19,6 +19,8 @@ import { ResizeHandle } from "./components/ResizeHandle.js";
 import { EditableUIResourceRenderer } from "./components/EditableUIResourceRenderer.js";
 import { ExpandableWrapper } from "./components/ExpandableWrapper.js";
 import { ComponentToolbar } from "./components/ComponentToolbar.js";
+import { ChatBusProvider, useChatBus } from "./hooks/useChatBus.js";
+import { ChatPrompt } from "./components/ChatPrompt.js";
 import { GhostText, GhostTextInput } from "./components/GhostText.js";
 import { AutocompleteDropdown } from "./components/AutocompleteDropdown.js";
 import { AutocompleteFormField } from "./components/AutocompleteFormField.js";
@@ -37,10 +39,13 @@ import { createSupabasePlugin } from "./plugins/supabase.js";
 import { createRestPlugin } from "./plugins/rest.js";
 import { DEFAULT_IFRAME_DOMAINS, DEFAULT_RESOURCE_LIMITS, TRUSTED_IFRAME_DOMAINS, getIframeSandbox, validateComponent, validateIframeDomain, validateLayout } from "./services/validation.js";
 import { ComponentRegistry } from "./services/component-registry.js";
+import { createChatBus, createCommandHandler, createEventEmitter } from "./services/chat-bus.js";
 export {
   AutocompleteDropdown,
   AutocompleteFormField,
   AutocompleteProvider,
+  ChatBusProvider,
+  ChatPrompt,
   ComponentRegistry,
   ComponentToolbar,
   DEFAULT_IFRAME_DOMAINS,
@@ -57,6 +62,9 @@ export {
   StreamingUIRenderer,
   TRUSTED_IFRAME_DOMAINS,
   UIResourceRenderer,
+  createChatBus,
+  createCommandHandler,
+  createEventEmitter,
   createGroqPlugin,
   createRestPlugin,
   createSupabasePlugin,
@@ -66,6 +74,7 @@ export {
   useAutocomplete,
   useAutocompleteContext,
   useAutocompleteContextSafe,
+  useChatBus,
   useConditionalField,
   useConfirmModal,
   useDragDrop,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/services/chat-bus.cjs

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+function createEventEmitter() {
+  const listeners = /* @__PURE__ */ new Map();
+  function createThrottled(fn, ms) {
+    let lastCall = 0;
+    let timer = null;
+    let lastArgs = null;
+    let cancelled = false;
+    const throttled = ((...args) => {
+      if (cancelled) return;
+      lastArgs = args;
+      const now = Date.now();
+      const remaining = ms - (now - lastCall);
+      if (remaining <= 0) {
+        if (timer) {
+          clearTimeout(timer);
+          timer = null;
+        }
+        lastCall = now;
+        fn(...args);
+      } else if (!timer) {
+        timer = setTimeout(() => {
+          lastCall = Date.now();
+          timer = null;
+          if (lastArgs && !cancelled) {
+            try {
+              fn(...lastArgs);
+            } catch (err) {
+              console.error("[ChatBus] Error in throttled handler:", err);
+            }
+          }
+        }, remaining);
+      }
+    });
+    return {
+      fn: throttled,
+      cancel: () => {
+        cancelled = true;
+        if (timer) {
+          clearTimeout(timer);
+          timer = null;
+        }
+      }
+    };
+  }
+  return {
+    on(event, handler, options) {
+      if (!listeners.has(event)) {
+        listeners.set(event, /* @__PURE__ */ new Set());
+      }
+      const listener = { handler, options };
+      let throttleHandle = null;
+      if ((options == null ? void 0 : options.throttle) && options.throttle > 0) {
+        throttleHandle = createThrottled(handler, options.throttle);
+        listener.throttledHandler = throttleHandle.fn;
+      }
+      listeners.get(event).add(listener);
+      return () => {
+        var _a;
+        throttleHandle == null ? void 0 : throttleHandle.cancel();
+        (_a = listeners.get(event)) == null ? void 0 : _a.delete(listener);
+      };
+    },
+    emit(event, ...args) {
+      var _a;
+      const set = listeners.get(event);
+      if (!set) return;
+      for (const listener of set) {
+        if ((_a = listener.options) == null ? void 0 : _a.streamKey) {
+          let streamKeyArg;
+          for (const arg of args) {
+            if (arg && typeof arg === "object" && "streamKey" in arg) {
+              streamKeyArg = arg.streamKey;
+              break;
+            }
+          }
+          if (streamKeyArg !== void 0 && streamKeyArg !== listener.options.streamKey) continue;
+        }
+        const fn = listener.throttledHandler || listener.handler;
+        try {
+          fn(...args);
+        } catch (err) {
+          console.error(`[ChatBus] Error in ${event} handler:`, err);
+        }
+      }
+    },
+    clear() {
+      listeners.clear();
+    }
+  };
+}
+function createCommandHandler() {
+  const handlers = /* @__PURE__ */ new Map();
+  return {
+    handle(command, handler) {
+      handlers.set(command, handler);
+    },
+    exec(command, ...args) {
+      const handler = handlers.get(command);
+      if (!handler) {
+        console.warn(`[ChatBus] No handler registered for command: ${command}`);
+        return void 0;
+      }
+      return handler(...args);
+    }
+  };
+}
+function createChatBus() {
+  return {
+    events: createEventEmitter(),
+    commands: createCommandHandler()
+  };
+}
+exports.createChatBus = createChatBus;
+exports.createCommandHandler = createCommandHandler;
+exports.createEventEmitter = createEventEmitter;
+//# sourceMappingURL=chat-bus.cjs.map

package/dist/services/chat-bus.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-bus.cjs","sources":["../../src/services/chat-bus.ts"],"sourcesContent":["/**\n * Chat Bus — Event Emitter + Command Handler\n * v2.4.0: Core primitives for the chat event/command bus\n *\n * @experimental — This API may change without major bump until v2.5.0.\n */\n\nimport type {\n  ChatEvents,\n  ChatCommands,\n  ChatEventEmitter,\n  ChatCommandHandler,\n  ChatBus,\n  EventSubscribeOptions,\n} from '../types/chat-bus'\n\n// ─── Event Emitter ───────────────────────────────────────────\n\ninterface Listener<F extends (...args: any[]) => any> {\n  handler: F\n  options?: EventSubscribeOptions\n  throttledHandler?: F\n}\n\n/**\n * Create a typed event emitter with throttle and streamKey filtering support.\n *\n * @experimental\n *\n * @example\n * const emitter = createEventEmitter<ChatEvents>()\n * const unsub = emitter.on('onToken', (event) => console.log(event.token), { throttle: 100 })\n * emitter.emit('onToken', { streamKey: 'abc', token: 'hello' })\n * unsub()\n */\nexport function createEventEmitter(): ChatEventEmitter {\n  const listeners = new Map<string, Set<Listener<any>>>()\n\n  interface ThrottledFn<F> {\n    fn: F\n    cancel: () => void\n  }\n\n  function createThrottled<F extends (...args: any[]) => void>(fn: F, ms: number): ThrottledFn<F> {\n    let lastCall = 0\n    let timer: ReturnType<typeof setTimeout> | null = null\n    let lastArgs: any[] | null = null\n    let cancelled = false\n\n    const throttled = ((...args: any[]) => {\n      if (cancelled) return\n      lastArgs = args\n      const now = Date.now()\n      const remaining = ms - (now - lastCall)\n\n      if (remaining <= 0) {\n        if (timer) { clearTimeout(timer); timer = null }\n        lastCall = now\n        fn(...args)\n      } else if (!timer) {\n        timer = setTimeout(() => {\n          lastCall = Date.now()\n          timer = null\n          if (lastArgs && !cancelled) {\n            try { fn(...lastArgs) } catch (err) { console.error('[ChatBus] Error in throttled handler:', err) }\n          }\n        }, remaining)\n      }\n    }) as F\n\n    return {\n      fn: throttled,\n      cancel: () => { cancelled = true; if (timer) { clearTimeout(timer); timer = null } },\n    }\n  }\n\n  return {\n    on(event, handler, options) {\n      if (!listeners.has(event as string)) {\n        listeners.set(event as string, new Set())\n      }\n\n      const listener: Listener<typeof handler> = { handler, options }\n\n      // Apply throttle if requested\n      let throttleHandle: ThrottledFn<typeof handler> | null = null\n      if (options?.throttle && options.throttle > 0) {\n        throttleHandle = createThrottled(handler, options.throttle)\n        listener.throttledHandler = throttleHandle.fn\n      }\n\n      listeners.get(event as string)!.add(listener)\n\n      // Return unsubscribe function — cancels pending throttle timers\n      return () => {\n        throttleHandle?.cancel()\n        listeners.get(event as string)?.delete(listener)\n      }\n    },\n\n    emit(event, ...args) {\n      const set = listeners.get(event as string)\n      if (!set) return\n\n      for (const listener of set) {\n        // StreamKey filtering: skip if listener wants a specific streamKey\n        // For most events args[0] has streamKey; for onCustomEvent args[1] has it\n        if (listener.options?.streamKey) {\n          let streamKeyArg: unknown\n          for (const arg of args) {\n            if (arg && typeof arg === 'object' && 'streamKey' in (arg as any)) {\n              streamKeyArg = (arg as any).streamKey\n              break\n            }\n          }\n          if (streamKeyArg !== undefined && streamKeyArg !== listener.options.streamKey) continue\n        }\n\n        const fn = listener.throttledHandler || listener.handler\n        try {\n          fn(...args)\n        } catch (err) {\n          console.error(`[ChatBus] Error in ${event as string} handler:`, err)\n        }\n      }\n    },\n\n    clear() {\n      listeners.clear()\n    },\n  } as ChatEventEmitter\n}\n\n// ─── Command Handler ─────────────────────────────────────────\n\n/**\n * Create a typed command handler. The host app registers handlers,\n * agents execute commands.\n *\n * @experimental\n *\n * @example\n * const commands = createCommandHandler<ChatCommands>()\n * commands.handle('injectPrompt', (text) => setInputValue(text))\n * commands.exec('injectPrompt', 'Hello world')\n */\nexport function createCommandHandler(): ChatCommandHandler {\n  const handlers = new Map<string, (...args: any[]) => any>()\n\n  return {\n    handle(command, handler) {\n      handlers.set(command as string, handler)\n    },\n\n    exec(command, ...args) {\n      const handler = handlers.get(command as string)\n      if (!handler) {\n        console.warn(`[ChatBus] No handler registered for command: ${command as string}`)\n        return undefined as any\n      }\n      return handler(...args)\n    },\n  } as ChatCommandHandler\n}\n\n// ─── Chat Bus Factory ────────────────────────────────────────\n\n/**\n * Create a complete ChatBus with events + commands.\n *\n * @experimental\n *\n * @example\n * const bus = createChatBus()\n * bus.events.on('onStreamEnd', (event) => { ... })\n * bus.commands.handle('sendPrompt', (text) => { ... })\n */\nexport function createChatBus(): ChatBus {\n  return {\n    events: createEventEmitter(),\n    commands: createCommandHandler(),\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/services/chat-bus.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Chat Bus — Event Emitter + Command Handler
+ * v2.4.0: Core primitives for the chat event/command bus
+ *
+ * @experimental — This API may change without major bump until v2.5.0.
+ */
+import type { ChatEventEmitter, ChatCommandHandler, ChatBus } from '../types/chat-bus';
+/**
+ * Create a typed event emitter with throttle and streamKey filtering support.
+ *
+ * @experimental
+ *
+ * @example
+ * const emitter = createEventEmitter<ChatEvents>()
+ * const unsub = emitter.on('onToken', (event) => console.log(event.token), { throttle: 100 })
+ * emitter.emit('onToken', { streamKey: 'abc', token: 'hello' })
+ * unsub()
+ */
+export declare function createEventEmitter(): ChatEventEmitter;
+/**
+ * Create a typed command handler. The host app registers handlers,
+ * agents execute commands.
+ *
+ * @experimental
+ *
+ * @example
+ * const commands = createCommandHandler<ChatCommands>()
+ * commands.handle('injectPrompt', (text) => setInputValue(text))
+ * commands.exec('injectPrompt', 'Hello world')
+ */
+export declare function createCommandHandler(): ChatCommandHandler;
+/**
+ * Create a complete ChatBus with events + commands.
+ *
+ * @experimental
+ *
+ * @example
+ * const bus = createChatBus()
+ * bus.events.on('onStreamEnd', (event) => { ... })
+ * bus.commands.handle('sendPrompt', (text) => { ... })
+ */
+export declare function createChatBus(): ChatBus;
+//# sourceMappingURL=chat-bus.d.ts.map

package/dist/services/chat-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-bus.d.ts","sourceRoot":"","sources":["../../src/services/chat-bus.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAGV,gBAAgB,EAChB,kBAAkB,EAClB,OAAO,EAER,MAAM,mBAAmB,CAAA;AAU1B;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,IAAI,gBAAgB,CAgGrD;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,IAAI,kBAAkB,CAiBzD;AAID;;;;;;;;;GASG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAKvC"}