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

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;
@@ -74,8 +80,13 @@ exports.createSupabasePlugin = supabase.createSupabasePlugin;
 exports.createRestPlugin = rest.createRestPlugin;
 exports.DEFAULT_IFRAME_DOMAINS = validation.DEFAULT_IFRAME_DOMAINS;
 exports.DEFAULT_RESOURCE_LIMITS = validation.DEFAULT_RESOURCE_LIMITS;
+exports.TRUSTED_IFRAME_DOMAINS = validation.TRUSTED_IFRAME_DOMAINS;
+exports.getIframeSandbox = validation.getIframeSandbox;
 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, DEFAULT_RESOURCE_LIMITS, DEFAULT_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, DEFAULT_RESOURCE_LIMITS, DEFAULT_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":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAGH,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAA;AAGjG,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAA;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AACxD,OAAO,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAA;AACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAA;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAA;AAGhE,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAA;AACxE,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAA;AAE1E,YAAY,EACV,uBAAuB,EACvB,wBAAwB,EACxB,8BAA8B,GAC/B,MAAM,cAAc,CAAA;AAErB,YAAY,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAA;AAC5E,YAAY,EAAE,iBAAiB,IAAI,0BAA0B,EAAE,MAAM,2BAA2B,CAAA;AAChG,YAAY,EAAE,+BAA+B,EAAE,MAAM,yCAAyC,CAAA;AAC9F,YAAY,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAA;AAC5E,YAAY,EAAE,qBAAqB,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AACtG,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AACjF,YAAY,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAA;AAClF,YAAY,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAA;AAGjH,OAAO,EACL,cAAc,EACd,SAAS,EACT,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,QAAQ,EACR,eAAe,EACf,kBAAkB,EAElB,WAAW,EACX,SAAS,EAET,eAAe,GAChB,MAAM,SAAS,CAAA;AAEhB,YAAY,EACV,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,0BAA0B,EAC1B,cAAc,EACd,qBAAqB,EACrB,yBAAyB,EACzB,wBAAwB,EAExB,kBAAkB,EAClB,iBAAiB,EACjB,SAAS,EACT,gBAAgB,EAChB,eAAe,EACf,UAAU,EAEV,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,SAAS,CAAA;AAGhB,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAE/F,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,+BAA+B,CAAA;AAEtC,YAAY,EACV,qBAAqB,EACrB,sBAAsB,EACtB,aAAa,EACb,YAAY,GACb,MAAM,WAAW,CAAA;AAElB,YAAY,EACV,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,+BAA+B,CAAA;AAItC,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,WAAW,CAAA;AAMlB,YAAY,EACV,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,aAAa,EACb,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EAEnB,eAAe,EACf,aAAa,EACb,eAAe,EACf,mBAAmB,EAEnB,gBAAgB,EAChB,iBAAiB,EAEjB,iBAAiB,EACjB,gBAAgB,EAChB,wBAAwB,EAExB,SAAS,EACT,oBAAoB,EAEpB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EAEjB,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,EAEpB,mBAAmB,EACnB,SAAS,EACT,kBAAkB,EAElB,YAAY,EACZ,iBAAiB,EAEjB,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,sBAAsB,IAAI,0BAA0B,EAEpD,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,SAAS,CAAA;AAGhB,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,oBAAoB,EACpB,uBAAuB,EACvB,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,YAAY,CAAA"}
+{"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";
@@ -35,12 +37,15 @@ import { AutocompleteProvider, useAutocompleteContext, useAutocompleteContextSaf
 import { createGroqPlugin } from "./plugins/groq.js";
 import { createSupabasePlugin } from "./plugins/supabase.js";
 import { createRestPlugin } from "./plugins/rest.js";
-import { DEFAULT_IFRAME_DOMAINS, DEFAULT_RESOURCE_LIMITS, validateComponent, validateIframeDomain, validateLayout } from "./services/validation.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,
@@ -55,15 +60,21 @@ export {
   MCPActionProvider,
   ResizeHandle,
   StreamingUIRenderer,
+  TRUSTED_IFRAME_DOMAINS,
   UIResourceRenderer,
+  createChatBus,
+  createCommandHandler,
+  createEventEmitter,
   createGroqPlugin,
   createRestPlugin,
   createSupabasePlugin,
   evaluateCondition,
+  getIframeSandbox,
   useAction,
   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"}

package/dist/services/chat-bus.js

@@ -0,0 +1,118 @@
+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()
+  };
+}
+export {
+  createChatBus,
+  createCommandHandler,
+  createEventEmitter
+};
+//# sourceMappingURL=chat-bus.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chat-bus.js","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/index.d.ts

@@ -3,6 +3,7 @@
  *
  * Business logic for component validation and registry management
  */
-export { validateComponent, validateLayout, validateIframeDomain, DEFAULT_RESOURCE_LIMITS, DEFAULT_IFRAME_DOMAINS, } from './validation';
+export { validateComponent, validateLayout, validateIframeDomain, getIframeSandbox, DEFAULT_RESOURCE_LIMITS, DEFAULT_IFRAME_DOMAINS, TRUSTED_IFRAME_DOMAINS, } from './validation';
 export { ComponentRegistry } from './component-registry';
+export { createEventEmitter, createCommandHandler, createChatBus } from './chat-bus';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,oBAAoB,EACpB,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,cAAc,CAAA;AAErB,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,uBAAuB,EACvB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,cAAc,CAAA;AAErB,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAExD,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA"}

package/dist/services/validation.cjs

@@ -123,7 +123,57 @@ const DEFAULT_IFRAME_DOMAINS = [
   "clinicaltrials.gov",
   "www.clinicaltrials.gov",
   "linear.app",
-  "www.linear.app"
+  "www.linear.app",
+  // Payment platforms (v2.2.12)
+  "polar.sh",
+  "www.polar.sh",
+  "checkout.stripe.com",
+  "js.stripe.com",
+  "billing.stripe.com",
+  "buy.stripe.com",
+  "connect.stripe.com",
+  "invoice.stripe.com"
+];
+const TRUSTED_IFRAME_DOMAINS = [
+  // Deposium (own domains)
+  "deposium.com",
+  "deposium.vip",
+  "deposium.ai",
+  "localhost",
+  // Google services (need auth cookies)
+  "docs.google.com",
+  "drive.google.com",
+  "sheets.google.com",
+  "slides.google.com",
+  "maps.google.com",
+  "datastudio.google.com",
+  "lookerstudio.google.com",
+  // Productivity (need auth)
+  "notion.so",
+  "www.notion.so",
+  "airtable.com",
+  "figma.com",
+  "www.figma.com",
+  "miro.com",
+  // Payment (need auth + cookies for checkout)
+  "polar.sh",
+  "www.polar.sh",
+  "checkout.stripe.com",
+  "js.stripe.com",
+  "billing.stripe.com",
+  "buy.stripe.com",
+  "connect.stripe.com",
+  "invoice.stripe.com",
+  // Business tools (need auth)
+  "app.hubspot.com",
+  "share.hubspot.com",
+  "app.powerbi.com",
+  "linear.app",
+  "www.linear.app",
+  "calendly.com",
+  "typeform.com",
+  "cal.com",
+  "canva.com"
 ];
 function validateGridPosition(position) {
   const errors = [];
@@ -350,6 +400,24 @@ function validateIframeDomain(url, options) {
     };
   }
 }
+function getIframeSandbox(url, options) {
+  const baseSandbox = "allow-scripts allow-popups";
+  try {
+    const domain = new URL(url).hostname;
+    let trustedList = TRUSTED_IFRAME_DOMAINS;
+    if (options == null ? void 0 : options.customTrustedDomains) {
+      trustedList = [...TRUSTED_IFRAME_DOMAINS, ...options.customTrustedDomains];
+    }
+    const isTrusted = trustedList.some(
+      (trusted) => domain === trusted || domain.endsWith(`.${trusted}`)
+    );
+    if (isTrusted) {
+      return `${baseSandbox} allow-same-origin allow-forms`;
+    }
+  } catch {
+  }
+  return baseSandbox;
+}
 function validateComponent(component, options) {
   const limits = (options == null ? void 0 : options.limits) ?? DEFAULT_RESOURCE_LIMITS;
   const errors = [];
@@ -654,6 +722,8 @@ function validateFormData(data, fields) {
 }
 exports.DEFAULT_IFRAME_DOMAINS = DEFAULT_IFRAME_DOMAINS;
 exports.DEFAULT_RESOURCE_LIMITS = DEFAULT_RESOURCE_LIMITS;
+exports.TRUSTED_IFRAME_DOMAINS = TRUSTED_IFRAME_DOMAINS;
+exports.getIframeSandbox = getIframeSandbox;
 exports.sanitizeString = sanitizeString;
 exports.validateChartComponent = validateChartComponent;
 exports.validateComponent = validateComponent;