@aganzefelicite/responsekit-react 0.1.0 → 0.2.0

package/dist/index.d.cts

@@ -248,6 +248,84 @@ declare function FallbackBlock({ block }: BlockComponentProps<Block>): react.JSX
 /** The built-in block components, keyed by block `type`. */
 declare const defaultBlockComponents: BlockComponents;
 
+/**
+ * A floating, draggable, resizable panel that hosts any content (typically a chat or an
+ * `<AiRenderer/>`). Chrome only — it owns position/size/open state and nothing else, so
+ * you keep full control of what renders inside.
+ *
+ * - Drag by the header to move it (kept inside the viewport).
+ * - Drag the bottom-right corner to resize (clamped to `minWidth`/`minHeight`).
+ * - A launcher button toggles it open/closed; pass `showLauncher={false}` and drive
+ *   `open`/`onOpenChange` yourself for a fully controlled widget.
+ */
+interface AiWidgetProps {
+    children: ReactNode;
+    /** Header title text. */
+    title?: string;
+    /** Optional extra controls rendered in the header (e.g. a "New chat" button). */
+    headerActions?: ReactNode;
+    /** Uncontrolled initial open state. Ignored when `open` is provided. */
+    defaultOpen?: boolean;
+    /** Controlled open state. Provide together with `onOpenChange`. */
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    /** Initial top-left position in px. Defaults to the bottom-right corner. */
+    initialPosition?: {
+        x: number;
+        y: number;
+    };
+    /** Initial panel size in px. */
+    initialSize?: {
+        width: number;
+        height: number;
+    };
+    minWidth?: number;
+    minHeight?: number;
+    /** Show the floating toggle button. Default `true`. */
+    showLauncher?: boolean;
+    /** Launcher button contents when the widget is closed. */
+    launcher?: ReactNode;
+    className?: string;
+}
+declare function AiWidget({ children, title, headerActions, defaultOpen, open: openProp, onOpenChange, initialPosition, initialSize, minWidth, minHeight, showLauncher, launcher, className, }: AiWidgetProps): react.JSX.Element | null;
+
+/**
+ * Default, browser-side handling for the actions the SDK emits.
+ *
+ * The SDK never runs business logic — blocks only emit intent via `onAction`. But the two
+ * most common actions (`DOWNLOAD` a table/chart's data, `OPEN_LINK`) have an obvious,
+ * host-independent implementation. These helpers provide that so downloads "just work"
+ * without every consumer re-implementing blob plumbing. Wrap your handler with
+ * `withDefaultActions` to opt in, or call `runDefaultAction` yourself.
+ */
+
+/** Low-level: trigger a browser "Save as" for a Blob. No-op outside the browser. */
+declare function triggerDownload(blob: Blob, filename: string): void;
+/**
+ * Turn a `DOWNLOAD` action's `data` into a file and save it. Handles:
+ *  - a string  → written as-is (CSV/JSON/plain, per `format`)
+ *  - a Blob    → saved directly
+ *  - anything else → serialized to pretty JSON
+ * Returns `true` when a download was started, `false` if there was nothing to save
+ * (or we're not in a browser).
+ */
+declare function performDownload(action: DownloadAction): boolean;
+/** Open an `OPEN_LINK` action's href. Returns `true` when handled. */
+declare function performOpenLink(action: OpenLinkAction): boolean;
+/**
+ * Apply the SDK's default handling for an action. Currently `DOWNLOAD` and `OPEN_LINK`.
+ * Returns `true` if the action was handled here, so callers can decide whether to also
+ * run their own logic.
+ */
+declare function runDefaultAction(action: AiAction): boolean;
+/**
+ * Wrap an `onAction` handler so `DOWNLOAD`/`OPEN_LINK` work out of the box while your own
+ * handler still sees every action (e.g. for analytics or custom actions):
+ *
+ *   <AiRenderer onAction={withDefaultActions((a) => track(a))} />
+ */
+declare function withDefaultActions(onAction?: OnAction): OnAction;
+
 interface MarkdownProps {
     children: string;
     className?: string;
@@ -310,4 +388,4 @@ declare function messageUrl(baseUrl: string, conversationId: string): string;
  */
 declare function streamMessage(options: StreamMessageOptions): AsyncGenerator<SseEvent>;
 
-export { type AiAction, AiRenderer, type AiRendererProps, AiStream, type AiStreamProps, type BlockComponent, type BlockComponentProps, type BlockComponents, ChartBlock, type ChatTurn, type ConversationClientOptions, type CustomAction, type DownloadAction, ErrorBoundary, ErrorView, FallbackBlock, FilterBlock, InsightBlock, KpiBlock, Markdown, type MarkdownProps, type OnAction, type OpenLinkAction, RecommendationBlock, type RefreshAction, type RegisterBlockOptions, type StreamMessageOptions, TableBlock, TextBlock, type UseAiStreamOptions, type UseAiStreamResult, type UseChatOptions, type UseChatResult, createConversation, defaultBlockComponents, deleteConversation, getConversation, getMessages, listConversations, messageUrl, noopAction, registerBlock, registeredBlockTypes, renameConversation, resolveBlockComponent, streamMessage, unregisterBlock, useAiStream, useChat };
+export { type AiAction, AiRenderer, type AiRendererProps, AiStream, type AiStreamProps, AiWidget, type AiWidgetProps, type BlockComponent, type BlockComponentProps, type BlockComponents, ChartBlock, type ChatTurn, type ConversationClientOptions, type CustomAction, type DownloadAction, ErrorBoundary, ErrorView, FallbackBlock, FilterBlock, InsightBlock, KpiBlock, Markdown, type MarkdownProps, type OnAction, type OpenLinkAction, RecommendationBlock, type RefreshAction, type RegisterBlockOptions, type StreamMessageOptions, TableBlock, TextBlock, type UseAiStreamOptions, type UseAiStreamResult, type UseChatOptions, type UseChatResult, createConversation, defaultBlockComponents, deleteConversation, getConversation, getMessages, listConversations, messageUrl, noopAction, performDownload, performOpenLink, registerBlock, registeredBlockTypes, renameConversation, resolveBlockComponent, runDefaultAction, streamMessage, triggerDownload, unregisterBlock, useAiStream, useChat, withDefaultActions };

package/dist/index.d.ts

@@ -248,6 +248,84 @@ declare function FallbackBlock({ block }: BlockComponentProps<Block>): react.JSX
 /** The built-in block components, keyed by block `type`. */
 declare const defaultBlockComponents: BlockComponents;
 
+/**
+ * A floating, draggable, resizable panel that hosts any content (typically a chat or an
+ * `<AiRenderer/>`). Chrome only — it owns position/size/open state and nothing else, so
+ * you keep full control of what renders inside.
+ *
+ * - Drag by the header to move it (kept inside the viewport).
+ * - Drag the bottom-right corner to resize (clamped to `minWidth`/`minHeight`).
+ * - A launcher button toggles it open/closed; pass `showLauncher={false}` and drive
+ *   `open`/`onOpenChange` yourself for a fully controlled widget.
+ */
+interface AiWidgetProps {
+    children: ReactNode;
+    /** Header title text. */
+    title?: string;
+    /** Optional extra controls rendered in the header (e.g. a "New chat" button). */
+    headerActions?: ReactNode;
+    /** Uncontrolled initial open state. Ignored when `open` is provided. */
+    defaultOpen?: boolean;
+    /** Controlled open state. Provide together with `onOpenChange`. */
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    /** Initial top-left position in px. Defaults to the bottom-right corner. */
+    initialPosition?: {
+        x: number;
+        y: number;
+    };
+    /** Initial panel size in px. */
+    initialSize?: {
+        width: number;
+        height: number;
+    };
+    minWidth?: number;
+    minHeight?: number;
+    /** Show the floating toggle button. Default `true`. */
+    showLauncher?: boolean;
+    /** Launcher button contents when the widget is closed. */
+    launcher?: ReactNode;
+    className?: string;
+}
+declare function AiWidget({ children, title, headerActions, defaultOpen, open: openProp, onOpenChange, initialPosition, initialSize, minWidth, minHeight, showLauncher, launcher, className, }: AiWidgetProps): react.JSX.Element | null;
+
+/**
+ * Default, browser-side handling for the actions the SDK emits.
+ *
+ * The SDK never runs business logic — blocks only emit intent via `onAction`. But the two
+ * most common actions (`DOWNLOAD` a table/chart's data, `OPEN_LINK`) have an obvious,
+ * host-independent implementation. These helpers provide that so downloads "just work"
+ * without every consumer re-implementing blob plumbing. Wrap your handler with
+ * `withDefaultActions` to opt in, or call `runDefaultAction` yourself.
+ */
+
+/** Low-level: trigger a browser "Save as" for a Blob. No-op outside the browser. */
+declare function triggerDownload(blob: Blob, filename: string): void;
+/**
+ * Turn a `DOWNLOAD` action's `data` into a file and save it. Handles:
+ *  - a string  → written as-is (CSV/JSON/plain, per `format`)
+ *  - a Blob    → saved directly
+ *  - anything else → serialized to pretty JSON
+ * Returns `true` when a download was started, `false` if there was nothing to save
+ * (or we're not in a browser).
+ */
+declare function performDownload(action: DownloadAction): boolean;
+/** Open an `OPEN_LINK` action's href. Returns `true` when handled. */
+declare function performOpenLink(action: OpenLinkAction): boolean;
+/**
+ * Apply the SDK's default handling for an action. Currently `DOWNLOAD` and `OPEN_LINK`.
+ * Returns `true` if the action was handled here, so callers can decide whether to also
+ * run their own logic.
+ */
+declare function runDefaultAction(action: AiAction): boolean;
+/**
+ * Wrap an `onAction` handler so `DOWNLOAD`/`OPEN_LINK` work out of the box while your own
+ * handler still sees every action (e.g. for analytics or custom actions):
+ *
+ *   <AiRenderer onAction={withDefaultActions((a) => track(a))} />
+ */
+declare function withDefaultActions(onAction?: OnAction): OnAction;
+
 interface MarkdownProps {
     children: string;
     className?: string;
@@ -310,4 +388,4 @@ declare function messageUrl(baseUrl: string, conversationId: string): string;
  */
 declare function streamMessage(options: StreamMessageOptions): AsyncGenerator<SseEvent>;
 
-export { type AiAction, AiRenderer, type AiRendererProps, AiStream, type AiStreamProps, type BlockComponent, type BlockComponentProps, type BlockComponents, ChartBlock, type ChatTurn, type ConversationClientOptions, type CustomAction, type DownloadAction, ErrorBoundary, ErrorView, FallbackBlock, FilterBlock, InsightBlock, KpiBlock, Markdown, type MarkdownProps, type OnAction, type OpenLinkAction, RecommendationBlock, type RefreshAction, type RegisterBlockOptions, type StreamMessageOptions, TableBlock, TextBlock, type UseAiStreamOptions, type UseAiStreamResult, type UseChatOptions, type UseChatResult, createConversation, defaultBlockComponents, deleteConversation, getConversation, getMessages, listConversations, messageUrl, noopAction, registerBlock, registeredBlockTypes, renameConversation, resolveBlockComponent, streamMessage, unregisterBlock, useAiStream, useChat };
+export { type AiAction, AiRenderer, type AiRendererProps, AiStream, type AiStreamProps, AiWidget, type AiWidgetProps, type BlockComponent, type BlockComponentProps, type BlockComponents, ChartBlock, type ChatTurn, type ConversationClientOptions, type CustomAction, type DownloadAction, ErrorBoundary, ErrorView, FallbackBlock, FilterBlock, InsightBlock, KpiBlock, Markdown, type MarkdownProps, type OnAction, type OpenLinkAction, RecommendationBlock, type RefreshAction, type RegisterBlockOptions, type StreamMessageOptions, TableBlock, TextBlock, type UseAiStreamOptions, type UseAiStreamResult, type UseChatOptions, type UseChatResult, createConversation, defaultBlockComponents, deleteConversation, getConversation, getMessages, listConversations, messageUrl, noopAction, performDownload, performOpenLink, registerBlock, registeredBlockTypes, renameConversation, resolveBlockComponent, runDefaultAction, streamMessage, triggerDownload, unregisterBlock, useAiStream, useChat, withDefaultActions };

package/dist/index.js

@@ -4974,7 +4974,256 @@ function useChat(options) {
   useEffect(() => () => abortRef.current?.abort(), []);
   return { conversationId, turns, isStreaming, error, send, stop, reset, newConversation };
 }
+var MARGIN = 24;
+var clamp = (v, lo, hi) => Math.min(Math.max(v, lo), hi);
+var viewport = () => ({
+  w: typeof window === "undefined" ? 1024 : window.innerWidth,
+  h: typeof window === "undefined" ? 768 : window.innerHeight
+});
+function AiWidget({
+  children,
+  title = "Assistant",
+  headerActions,
+  defaultOpen = false,
+  open: openProp,
+  onOpenChange,
+  initialPosition,
+  initialSize = { width: 384, height: 560 },
+  minWidth = 300,
+  minHeight = 360,
+  showLauncher = true,
+  launcher,
+  className
+}) {
+  const isControlled = openProp !== void 0;
+  const [openState, setOpenState] = useState(defaultOpen);
+  const open = isControlled ? openProp : openState;
+  const setOpen = useCallback(
+    (next) => {
+      if (!isControlled) setOpenState(next);
+      onOpenChange?.(next);
+    },
+    [isControlled, onOpenChange]
+  );
+  const [size, setSize] = useState(initialSize);
+  const [pos, setPos] = useState(initialPosition ?? null);
+  useEffect(() => {
+    if (pos) return;
+    const { w, h } = viewport();
+    setPos({
+      x: Math.max(MARGIN, w - size.width - MARGIN),
+      y: Math.max(MARGIN, h - size.height - MARGIN)
+    });
+  }, [pos]);
+  useEffect(() => {
+    if (typeof window === "undefined") return;
+    const onResize = () => {
+      setPos((p) => {
+        if (!p) return p;
+        const { w, h } = viewport();
+        return {
+          x: clamp(p.x, 0, Math.max(0, w - size.width)),
+          y: clamp(p.y, 0, Math.max(0, h - size.height))
+        };
+      });
+    };
+    window.addEventListener("resize", onResize);
+    return () => window.removeEventListener("resize", onResize);
+  }, [size.width, size.height]);
+  const dragRef = useRef(null);
+  const onHeaderPointerDown = (e) => {
+    if (e.button !== 0 || !pos) return;
+    if (e.target.closest("button, a, input, select")) return;
+    dragRef.current = { px: e.clientX, py: e.clientY, ox: pos.x, oy: pos.y };
+    e.currentTarget.setPointerCapture(e.pointerId);
+  };
+  const onHeaderPointerMove = (e) => {
+    const d = dragRef.current;
+    if (!d) return;
+    const { w, h } = viewport();
+    setPos({
+      x: clamp(d.ox + (e.clientX - d.px), 0, Math.max(0, w - size.width)),
+      y: clamp(d.oy + (e.clientY - d.py), 0, Math.max(0, h - size.height))
+    });
+  };
+  const endHeaderPointer = (e) => {
+    dragRef.current = null;
+    if (e.currentTarget.hasPointerCapture?.(e.pointerId)) {
+      e.currentTarget.releasePointerCapture(e.pointerId);
+    }
+  };
+  const resizeRef = useRef(null);
+  const onResizePointerDown = (e) => {
+    if (e.button !== 0) return;
+    e.stopPropagation();
+    resizeRef.current = { px: e.clientX, py: e.clientY, ow: size.width, oh: size.height };
+    e.currentTarget.setPointerCapture(e.pointerId);
+  };
+  const onResizePointerMove = (e) => {
+    const r = resizeRef.current;
+    if (!r || !pos) return;
+    const { w, h } = viewport();
+    setSize({
+      width: clamp(r.ow + (e.clientX - r.px), minWidth, w - pos.x - MARGIN / 2),
+      height: clamp(r.oh + (e.clientY - r.py), minHeight, h - pos.y - MARGIN / 2)
+    });
+  };
+  const endResizePointer = (e) => {
+    resizeRef.current = null;
+    if (e.currentTarget.hasPointerCapture?.(e.pointerId)) {
+      e.currentTarget.releasePointerCapture(e.pointerId);
+    }
+  };
+  if (!open) {
+    if (!showLauncher) return null;
+    return /* @__PURE__ */ jsx(
+      "button",
+      {
+        type: "button",
+        className: "rk-widget-launcher",
+        onClick: () => setOpen(true),
+        "aria-label": `Open ${title}`,
+        children: launcher ?? /* @__PURE__ */ jsx(LauncherIcon, {})
+      }
+    );
+  }
+  const panelStyle = pos ? {
+    left: pos.x,
+    top: pos.y,
+    width: size.width,
+    height: size.height
+  } : { visibility: "hidden" };
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      className: `rk-widget${className ? ` ${className}` : ""}`,
+      style: panelStyle,
+      role: "dialog",
+      "aria-label": title,
+      children: [
+        /* @__PURE__ */ jsxs(
+          "div",
+          {
+            className: "rk-widget-header",
+            onPointerDown: onHeaderPointerDown,
+            onPointerMove: onHeaderPointerMove,
+            onPointerUp: endHeaderPointer,
+            onPointerCancel: endHeaderPointer,
+            children: [
+              /* @__PURE__ */ jsx("span", { className: "rk-widget-title", children: title }),
+              /* @__PURE__ */ jsxs("div", { className: "rk-widget-header-actions", children: [
+                headerActions,
+                /* @__PURE__ */ jsx(
+                  "button",
+                  {
+                    type: "button",
+                    className: "rk-widget-close",
+                    onClick: () => setOpen(false),
+                    "aria-label": `Close ${title}`,
+                    children: "\xD7"
+                  }
+                )
+              ] })
+            ]
+          }
+        ),
+        /* @__PURE__ */ jsx("div", { className: "rk-widget-body", children }),
+        /* @__PURE__ */ jsx(
+          "div",
+          {
+            className: "rk-widget-resize",
+            onPointerDown: onResizePointerDown,
+            onPointerMove: onResizePointerMove,
+            onPointerUp: endResizePointer,
+            onPointerCancel: endResizePointer,
+            role: "separator",
+            "aria-label": "Resize",
+            "aria-orientation": "horizontal"
+          }
+        )
+      ]
+    }
+  );
+}
+function LauncherIcon() {
+  return /* @__PURE__ */ jsx("svg", { width: "24", height: "24", viewBox: "0 0 24 24", fill: "none", "aria-hidden": "true", children: /* @__PURE__ */ jsx(
+    "path",
+    {
+      d: "M21 11.5a8.38 8.38 0 0 1-8.5 8.5 9.3 9.3 0 0 1-4-.9L3 21l1.9-5.5a8.38 8.38 0 0 1-.9-4A8.5 8.5 0 0 1 12.5 3 8.38 8.38 0 0 1 21 11.5Z",
+      stroke: "currentColor",
+      strokeWidth: "1.8",
+      strokeLinecap: "round",
+      strokeLinejoin: "round"
+    }
+  ) });
+}
+
+// src/download.ts
+var MIME = {
+  CSV: "text/csv",
+  JSON: "application/json",
+  TXT: "text/plain"
+};
+function inBrowser() {
+  return typeof document !== "undefined" && typeof URL !== "undefined";
+}
+function triggerDownload(blob, filename) {
+  if (!inBrowser()) return;
+  const url = URL.createObjectURL(blob);
+  const a = document.createElement("a");
+  a.href = url;
+  a.download = filename;
+  a.rel = "noopener";
+  document.body.appendChild(a);
+  a.click();
+  a.remove();
+  setTimeout(() => URL.revokeObjectURL(url), 0);
+}
+function performDownload(action) {
+  if (!inBrowser()) return false;
+  const { data, format, filename } = action;
+  if (data === null || data === void 0) return false;
+  const fmt = typeof format === "string" ? format.toUpperCase() : void 0;
+  let blob;
+  let name = filename;
+  if (data instanceof Blob) {
+    blob = data;
+    name ?? (name = "download");
+  } else if (typeof data === "string") {
+    const mime = fmt && MIME[fmt] || "text/plain";
+    blob = new Blob([data], { type: `${mime};charset=utf-8` });
+    name ?? (name = `download.${(fmt ?? "TXT").toLowerCase()}`);
+  } else {
+    blob = new Blob([JSON.stringify(data, null, 2)], {
+      type: "application/json;charset=utf-8"
+    });
+    name ?? (name = "download.json");
+  }
+  triggerDownload(blob, name);
+  return true;
+}
+function performOpenLink(action) {
+  if (typeof window === "undefined" || !action.href) return false;
+  window.open(action.href, action.target ?? "_blank", "noopener,noreferrer");
+  return true;
+}
+function runDefaultAction(action) {
+  switch (action.type) {
+    case "DOWNLOAD":
+      return performDownload(action);
+    case "OPEN_LINK":
+      return performOpenLink(action);
+    default:
+      return false;
+  }
+}
+function withDefaultActions(onAction) {
+  return (action) => {
+    runDefaultAction(action);
+    onAction?.(action);
+  };
+}
 
-export { AiRenderer, AiStream, ChartBlock, ErrorBoundary, ErrorView, FallbackBlock, FilterBlock, InsightBlock, KpiBlock, Markdown, RecommendationBlock, TableBlock, TextBlock, aiResponseSchema, analyticsResponseSchema, blockSchema, chartBlockSchema, chartTypeSchema, contentEventSchema, createConversation, dataSourceSchema, defaultBlockComponents, deleteConversation, errorEventSchema, errorResponseSchema, filterBlockSchema, filterDefSchema, filterTypeSchema, getConversation, getMessages, initialStreamState, insightBlockSchema, knownBlockSchema, kpiBlockSchema, kpiItemSchema, listConversations, makeErrorResponse, messageUrl, noopAction, parseAiResponse, parseBlock, parseSseEvent, progressEventSchema, progressPhaseSchema, recommendationBlockSchema, recommendationItemSchema, registerBlock, registeredBlockTypes, renameConversation, resolveBlockComponent, responseEndSchema, responseMetadataSchema, responseStartSchema, responseTypeSchema, safeParseAiResponse, severitySchema, streamMessage, streamReducer, tableBlockSchema, tableColumnSchema, textBlockSchema, textFormatSchema, textResponseSchema, trendSchema, unregisterBlock, useAiStream, useChat };
+export { AiRenderer, AiStream, AiWidget, ChartBlock, ErrorBoundary, ErrorView, FallbackBlock, FilterBlock, InsightBlock, KpiBlock, Markdown, RecommendationBlock, TableBlock, TextBlock, aiResponseSchema, analyticsResponseSchema, blockSchema, chartBlockSchema, chartTypeSchema, contentEventSchema, createConversation, dataSourceSchema, defaultBlockComponents, deleteConversation, errorEventSchema, errorResponseSchema, filterBlockSchema, filterDefSchema, filterTypeSchema, getConversation, getMessages, initialStreamState, insightBlockSchema, knownBlockSchema, kpiBlockSchema, kpiItemSchema, listConversations, makeErrorResponse, messageUrl, noopAction, parseAiResponse, parseBlock, parseSseEvent, performDownload, performOpenLink, progressEventSchema, progressPhaseSchema, recommendationBlockSchema, recommendationItemSchema, registerBlock, registeredBlockTypes, renameConversation, resolveBlockComponent, responseEndSchema, responseMetadataSchema, responseStartSchema, responseTypeSchema, runDefaultAction, safeParseAiResponse, severitySchema, streamMessage, streamReducer, tableBlockSchema, tableColumnSchema, textBlockSchema, textFormatSchema, textResponseSchema, trendSchema, triggerDownload, unregisterBlock, useAiStream, useChat, withDefaultActions };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map