@schandlergarcia/sf-web-components 1.8.0 → 1.9.0

package/dist/components/library/chat/ChatWelcome.d.ts

@@ -1,10 +1,12 @@
+import React from "react";
+export interface ChatWelcomeProps {
+    title?: string;
+    subtitle?: string;
+    suggestions?: string[];
+    onSuggestion?: (text: string) => void;
+    icon?: React.ReactNode;
+}
 /**
  * Empty-state welcome screen shown before the first message.
- *
- * @param {string} title — welcome heading
- * @param {string} subtitle — description text
- * @param {string[]} suggestions — starter prompt suggestions
- * @param {Function} onSuggestion — (text) => void
- * @param {React.ReactNode} icon — custom icon override
  */
-export default function ChatWelcome({ title, subtitle, suggestions, onSuggestion, icon, }: string): import("react/jsx-runtime").JSX.Element;
+export default function ChatWelcome({ title, subtitle, suggestions, onSuggestion, icon, }: ChatWelcomeProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/library/chat/ChatWelcome.js

@@ -1,8 +1,7 @@
 import { jsxs as a, jsx as e } from "react/jsx-runtime";
-import "react";
-import { CpuChipIcon as o } from "@heroicons/react/24/solid";
-import c from "./ChatSuggestions.js";
-function h({
+import { CpuChipIcon as c } from "@heroicons/react/24/solid";
+import d from "./ChatSuggestions.js";
+function x({
   title: r = "How can I help?",
   subtitle: l = "Ask me anything about your data, or try one of the suggestions below.",
   suggestions: t = [],
@@ -10,15 +9,15 @@ function h({
   icon: n
 }) {
   return /* @__PURE__ */ a("div", { className: "flex flex-1 flex-col items-center justify-center gap-4 px-6 py-12 text-center", children: [
-    n ?? /* @__PURE__ */ e("div", { className: "flex h-14 w-14 items-center justify-center rounded-2xl bg-brand-100 dark:bg-brand-900/40", children: /* @__PURE__ */ e(o, { className: "h-7 w-7 text-brand-600 dark:text-brand-400" }) }),
+    n ?? /* @__PURE__ */ e("div", { className: "flex h-14 w-14 items-center justify-center rounded-2xl bg-brand-100 dark:bg-brand-900/40", children: /* @__PURE__ */ e(c, { className: "h-7 w-7 text-brand-600 dark:text-brand-400" }) }),
     /* @__PURE__ */ a("div", { children: [
       /* @__PURE__ */ e("h3", { className: "text-base font-semibold text-slate-900 dark:text-slate-50", children: r }),
       /* @__PURE__ */ e("p", { className: "mt-1 text-sm text-slate-500 dark:text-slate-400", children: l })
     ] }),
-    t.length ? /* @__PURE__ */ e("div", { className: "mt-2", children: /* @__PURE__ */ e(c, { suggestions: t, onSelect: s }) }) : null
+    t.length ? /* @__PURE__ */ e("div", { className: "mt-2", children: /* @__PURE__ */ e(d, { suggestions: t, onSelect: s }) }) : null
   ] });
 }
 export {
-  h as default
+  x as default
 };
 //# sourceMappingURL=ChatWelcome.js.map

package/dist/components/library/chat/ChatWelcome.js.map

@@ -1 +1 @@
-{"version":3,"file":"ChatWelcome.js","sources":["../../../../src/components/library/chat/ChatWelcome.jsx"],"sourcesContent":["import React from \"react\";\nimport { CpuChipIcon } from \"@heroicons/react/24/solid\";\nimport ChatSuggestions from \"./ChatSuggestions\";\n\n/**\n * Empty-state welcome screen shown before the first message.\n *\n * @param {string} title — welcome heading\n * @param {string} subtitle — description text\n * @param {string[]} suggestions — starter prompt suggestions\n * @param {Function} onSuggestion — (text) => void\n * @param {React.ReactNode} icon — custom icon override\n */\nexport default function ChatWelcome({\n  title = \"How can I help?\",\n  subtitle = \"Ask me anything about your data, or try one of the suggestions below.\",\n  suggestions = [],\n  onSuggestion,\n  icon,\n}) {\n  return (\n    <div className=\"flex flex-1 flex-col items-center justify-center gap-4 px-6 py-12 text-center\">\n      {icon ?? (\n        <div className=\"flex h-14 w-14 items-center justify-center rounded-2xl bg-brand-100 dark:bg-brand-900/40\">\n          <CpuChipIcon className=\"h-7 w-7 text-brand-600 dark:text-brand-400\" />\n        </div>\n      )}\n      <div>\n        <h3 className=\"text-base font-semibold text-slate-900 dark:text-slate-50\">\n          {title}\n        </h3>\n        <p className=\"mt-1 text-sm text-slate-500 dark:text-slate-400\">\n          {subtitle}\n        </p>\n      </div>\n      {suggestions.length ? (\n        <div className=\"mt-2\">\n          <ChatSuggestions suggestions={suggestions} onSelect={onSuggestion} />\n        </div>\n      ) : null}\n    </div>\n  );\n}\n"],"names":["ChatWelcome","title","subtitle","suggestions","onSuggestion","icon","jsxs","jsx","CpuChipIcon","ChatSuggestions"],"mappings":";;;;AAaA,SAAwBA,EAAY;AAAA,EAClC,OAAAC,IAAQ;AAAA,EACR,UAAAC,IAAW;AAAA,EACX,aAAAC,IAAc,CAAA;AAAA,EACd,cAAAC;AAAA,EACA,MAAAC;AACF,GAAG;AACD,SACE,gBAAAC,EAAC,OAAA,EAAI,WAAU,iFACZ,UAAA;AAAA,IAAAD,KACC,gBAAAE,EAAC,SAAI,WAAU,4FACb,4BAACC,GAAA,EAAY,WAAU,8CAA6C,EAAA,CACtE;AAAA,sBAED,OAAA,EACC,UAAA;AAAA,MAAA,gBAAAD,EAAC,MAAA,EAAG,WAAU,6DACX,UAAAN,GACH;AAAA,MACA,gBAAAM,EAAC,KAAA,EAAE,WAAU,mDACV,UAAAL,EAAA,CACH;AAAA,IAAA,GACF;AAAA,IACCC,EAAY,SACX,gBAAAI,EAAC,OAAA,EAAI,WAAU,QACb,UAAA,gBAAAA,EAACE,GAAA,EAAgB,aAAAN,GAA0B,UAAUC,EAAA,CAAc,EAAA,CACrE,IACE;AAAA,EAAA,GACN;AAEJ;"}
+{"version":3,"file":"ChatWelcome.js","sources":["../../../../src/components/library/chat/ChatWelcome.tsx"],"sourcesContent":["import React from \"react\";\nimport { CpuChipIcon } from \"@heroicons/react/24/solid\";\nimport ChatSuggestions from \"./ChatSuggestions\";\n\nexport interface ChatWelcomeProps {\n  title?: string;\n  subtitle?: string;\n  suggestions?: string[];\n  onSuggestion?: (text: string) => void;\n  icon?: React.ReactNode;\n}\n\n/**\n * Empty-state welcome screen shown before the first message.\n */\nexport default function ChatWelcome({\n  title = \"How can I help?\",\n  subtitle = \"Ask me anything about your data, or try one of the suggestions below.\",\n  suggestions = [],\n  onSuggestion,\n  icon,\n}: ChatWelcomeProps) {\n  return (\n    <div className=\"flex flex-1 flex-col items-center justify-center gap-4 px-6 py-12 text-center\">\n      {icon ?? (\n        <div className=\"flex h-14 w-14 items-center justify-center rounded-2xl bg-brand-100 dark:bg-brand-900/40\">\n          <CpuChipIcon className=\"h-7 w-7 text-brand-600 dark:text-brand-400\" />\n        </div>\n      )}\n      <div>\n        <h3 className=\"text-base font-semibold text-slate-900 dark:text-slate-50\">\n          {title}\n        </h3>\n        <p className=\"mt-1 text-sm text-slate-500 dark:text-slate-400\">\n          {subtitle}\n        </p>\n      </div>\n      {suggestions.length ? (\n        <div className=\"mt-2\">\n          <ChatSuggestions suggestions={suggestions} onSelect={onSuggestion} />\n        </div>\n      ) : null}\n    </div>\n  );\n}\n"],"names":["ChatWelcome","title","subtitle","suggestions","onSuggestion","icon","jsxs","jsx","CpuChipIcon","ChatSuggestions"],"mappings":";;;AAeA,SAAwBA,EAAY;AAAA,EAClC,OAAAC,IAAQ;AAAA,EACR,UAAAC,IAAW;AAAA,EACX,aAAAC,IAAc,CAAA;AAAA,EACd,cAAAC;AAAA,EACA,MAAAC;AACF,GAAqB;AACnB,SACE,gBAAAC,EAAC,OAAA,EAAI,WAAU,iFACZ,UAAA;AAAA,IAAAD,KACC,gBAAAE,EAAC,SAAI,WAAU,4FACb,4BAACC,GAAA,EAAY,WAAU,8CAA6C,EAAA,CACtE;AAAA,sBAED,OAAA,EACC,UAAA;AAAA,MAAA,gBAAAD,EAAC,MAAA,EAAG,WAAU,6DACX,UAAAN,GACH;AAAA,MACA,gBAAAM,EAAC,KAAA,EAAE,WAAU,mDACV,UAAAL,EAAA,CACH;AAAA,IAAA,GACF;AAAA,IACCC,EAAY,SACX,gBAAAI,EAAC,OAAA,EAAI,WAAU,QACb,UAAA,gBAAAA,EAACE,GAAA,EAAgB,aAAAN,GAA0B,UAAUC,EAAA,CAAc,EAAA,CACrE,IACE;AAAA,EAAA,GACN;AAEJ;"}

package/dist/components/library/chat/index.d.ts

@@ -8,3 +8,13 @@ export { default as ChatSuggestions } from "./ChatSuggestions";
 export { default as ChatToolCall } from "./ChatToolCall";
 export { default as ChatWelcome } from "./ChatWelcome";
 export { default as useChatState } from "./useChatState";
+export type { ChatPanelProps } from "./ChatPanel";
+export type { ChatBarProps } from "./ChatBar";
+export type { ChatMessageListProps } from "./ChatMessageList";
+export type { ChatMessageProps, ChatMessageData } from "./ChatMessage";
+export type { ChatInputProps } from "./ChatInput";
+export type { ChatTypingIndicatorProps } from "./ChatTypingIndicator";
+export type { ChatSuggestionsProps } from "./ChatSuggestions";
+export type { ChatToolCallProps, ToolCall } from "./ChatToolCall";
+export type { ChatWelcomeProps } from "./ChatWelcome";
+export type { UseChatStateOptions, UseChatStateReturn, ChatMessage as ChatMessageType, ChatStateHelpers, } from "./useChatState";

package/dist/components/library/chat/useChatState.d.ts

@@ -1,13 +1,41 @@
+import { ToolCall } from "./ChatToolCall";
+export interface ChatMessage {
+    id: string;
+    role: "user" | "assistant" | "system";
+    content?: string;
+    timestamp: string;
+    components?: unknown[];
+    toolCalls?: ToolCall[];
+    isError?: boolean;
+    isStreaming?: boolean;
+}
+export interface ChatStateHelpers {
+    addMessage: (msg: Partial<ChatMessage>) => string;
+    updateMessage: (id: string, updates: Partial<ChatMessage>) => void;
+    appendChunk: (id: string, chunk: string) => void;
+    setStreaming: (streaming: boolean) => void;
+}
+export interface UseChatStateOptions {
+    initialMessages?: Partial<ChatMessage>[];
+    onSend?: (userMessage: ChatMessage, allMessages: ChatMessage[], helpers: ChatStateHelpers) => Promise<Partial<ChatMessage> | void>;
+}
+export interface UseChatStateReturn {
+    messages: ChatMessage[];
+    isLoading: boolean;
+    isStreaming: boolean;
+    error: string | null;
+    sendMessage: (content: string, extra?: Partial<ChatMessage>) => Promise<void>;
+    addMessage: (msg: Partial<ChatMessage>) => string;
+    updateMessage: (id: string, updates: Partial<ChatMessage>) => void;
+    appendChunk: (id: string, chunk: string) => void;
+    removeMessage: (id: string) => void;
+    clearMessages: () => void;
+    retryLast: () => void;
+    setError: (error: string | null) => void;
+}
 /**
  * Core state management hook for AI chat.
  *
- * @param {Object} options
- * @param {Array}  options.initialMessages — seed the conversation
- * @param {Function} options.onSend — async (userMessage, allMessages) => assistantMessage | void
- *   Return a message object to add it, or use appendChunk / addMessage for streaming.
- *
- * @returns {Object}
- *
  * @example
  * const chat = useChatState({
  *   onSend: async (msg, history) => {
@@ -17,7 +45,4 @@
  *   },
  * });
  */
-export default function useChatState({ initialMessages, onSend }?: {
-    initialMessages: any[];
-    onSend: Function;
-}): Object;
+export default function useChatState({ initialMessages, onSend }?: UseChatStateOptions): UseChatStateReturn;

package/dist/components/library/chat/useChatState.js

@@ -1,77 +1,94 @@
-import { useState as g, useRef as k, useCallback as o } from "react";
-let v = 1;
-function S() {
-  return `msg-${Date.now()}-${v++}`;
+import { useState as u, useRef as C, useCallback as o } from "react";
+let L = 1;
+function m() {
+  return `msg-${Date.now()}-${L++}`;
 }
-function R({ initialMessages: h = [], onSend: I } = {}) {
-  const [r, a] = g(
-    () => h.map((e) => ({ id: S(), timestamp: (/* @__PURE__ */ new Date()).toISOString(), ...e }))
-  ), [x, M] = g(!1), [D, w] = g(!1), [O, l] = g(null), y = k(I);
-  y.current = I;
+function k({ initialMessages: y = [], onSend: p } = {}) {
+  const [r, a] = u(
+    () => y.map((e) => ({
+      id: m(),
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      role: e.role || "user",
+      ...e
+    }))
+  ), [I, S] = u(!1), [h, M] = u(!1), [x, l] = u(null), w = C(p);
+  w.current = p;
   const c = o((e) => {
-    const t = { id: S(), timestamp: (/* @__PURE__ */ new Date()).toISOString(), ...e };
-    return a((s) => [...s, t]), t.id;
-  }, []), d = o((e, t) => {
+    const n = {
+      id: m(),
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      role: e.role || "assistant",
+      ...e
+    };
+    return a((s) => [...s, n]), n.id;
+  }, []), g = o((e, n) => {
     a(
-      (s) => s.map((n) => n.id === e ? { ...n, ...t } : n)
+      (s) => s.map((t) => t.id === e ? { ...t, ...n } : t)
     );
-  }, []), f = o((e, t) => {
+  }, []), d = o((e, n) => {
     a(
       (s) => s.map(
-        (n) => n.id === e ? { ...n, content: (n.content ?? "") + t } : n
+        (t) => t.id === e ? { ...t, content: (t.content ?? "") + n } : t
       )
     );
-  }, []), C = o((e) => {
-    a((t) => t.filter((s) => s.id !== e));
-  }, []), L = o(() => {
+  }, []), D = o((e) => {
+    a((n) => n.filter((s) => s.id !== e));
+  }, []), E = o(() => {
     a([]), l(null);
-  }, []), m = o(
-    async (e, t = {}) => {
+  }, []), f = o(
+    async (e, n = {}) => {
       if (!e?.trim()) return;
       l(null);
-      const s = { role: "user", content: e.trim(), ...t }, n = S(), p = { ...s, id: n, timestamp: (/* @__PURE__ */ new Date()).toISOString() };
-      a((i) => [...i, p]), M(!0);
+      const s = {
+        role: "user",
+        content: e.trim(),
+        ...n,
+        id: m(),
+        timestamp: (/* @__PURE__ */ new Date()).toISOString()
+      };
+      a((t) => [...t, s]), S(!0);
       try {
-        const i = [...r, p], u = await y.current?.(p, i, {
+        const t = [...r, s], i = await w.current?.(s, t, {
           addMessage: c,
-          updateMessage: d,
-          appendChunk: f,
-          setStreaming: w
+          updateMessage: g,
+          appendChunk: d,
+          setStreaming: M
         });
-        u && typeof u == "object" && u.role && c(u);
-      } catch (i) {
-        l(i?.message ?? "Failed to send message"), c({
+        i && typeof i == "object" && i.role && c(i);
+      } catch (t) {
+        const i = t instanceof Error ? t.message : "Failed to send message";
+        l(i), c({
           role: "system",
-          content: i?.message ?? "Something went wrong. Please try again.",
+          content: t instanceof Error ? t.message : "Something went wrong. Please try again.",
           isError: !0
         });
       } finally {
-        M(!1), w(!1);
+        S(!1), M(!1);
       }
     },
-    [r, c, d, f]
-  ), b = o(() => {
+    [r, c, g, d]
+  ), O = o(() => {
     const e = [...r].reverse().find((s) => s.role === "user");
     if (!e) return;
-    const t = r.lastIndexOf(e);
-    a(r.slice(0, t)), l(null), m(e.content);
-  }, [r, m]);
+    const n = r.lastIndexOf(e);
+    a(r.slice(0, n)), l(null), f(e.content || "");
+  }, [r, f]);
   return {
     messages: r,
-    isLoading: x,
-    isStreaming: D,
-    error: O,
-    sendMessage: m,
+    isLoading: I,
+    isStreaming: h,
+    error: x,
+    sendMessage: f,
     addMessage: c,
-    updateMessage: d,
-    appendChunk: f,
-    removeMessage: C,
-    clearMessages: L,
-    retryLast: b,
+    updateMessage: g,
+    appendChunk: d,
+    removeMessage: D,
+    clearMessages: E,
+    retryLast: O,
     setError: l
   };
 }
 export {
-  R as default
+  k as default
 };
 //# sourceMappingURL=useChatState.js.map

package/dist/components/library/chat/useChatState.js.map

@@ -1 +1 @@
-{"version":3,"file":"useChatState.js","sources":["../../../../src/components/library/chat/useChatState.jsx"],"sourcesContent":["import { useState, useCallback, useRef } from \"react\";\n\nlet _nextId = 1;\nfunction uid() {\n  return `msg-${Date.now()}-${_nextId++}`;\n}\n\n/**\n * Core state management hook for AI chat.\n *\n * @param {Object} options\n * @param {Array}  options.initialMessages — seed the conversation\n * @param {Function} options.onSend — async (userMessage, allMessages) => assistantMessage | void\n *   Return a message object to add it, or use appendChunk / addMessage for streaming.\n *\n * @returns {Object}\n *\n * @example\n * const chat = useChatState({\n *   onSend: async (msg, history) => {\n *     const res = await fetch(\"/api/chat\", { method: \"POST\", body: JSON.stringify({ messages: history }) });\n *     const data = await res.json();\n *     return { role: \"assistant\", content: data.reply, components: data.components };\n *   },\n * });\n */\nexport default function useChatState({ initialMessages = [], onSend } = {}) {\n  const [messages, setMessages] = useState(() =>\n    initialMessages.map((m) => ({ id: uid(), timestamp: new Date().toISOString(), ...m }))\n  );\n  const [isLoading, setIsLoading] = useState(false);\n  const [isStreaming, setIsStreaming] = useState(false);\n  const [error, setError] = useState(null);\n  const onSendRef = useRef(onSend);\n  onSendRef.current = onSend;\n\n  const addMessage = useCallback((msg) => {\n    const full = { id: uid(), timestamp: new Date().toISOString(), ...msg };\n    setMessages((prev) => [...prev, full]);\n    return full.id;\n  }, []);\n\n  const updateMessage = useCallback((id, updates) => {\n    setMessages((prev) =>\n      prev.map((m) => (m.id === id ? { ...m, ...updates } : m))\n    );\n  }, []);\n\n  const appendChunk = useCallback((id, chunk) => {\n    setMessages((prev) =>\n      prev.map((m) =>\n        m.id === id ? { ...m, content: (m.content ?? \"\") + chunk } : m\n      )\n    );\n  }, []);\n\n  const removeMessage = useCallback((id) => {\n    setMessages((prev) => prev.filter((m) => m.id !== id));\n  }, []);\n\n  const clearMessages = useCallback(() => {\n    setMessages([]);\n    setError(null);\n  }, []);\n\n  const sendMessage = useCallback(\n    async (content, extra = {}) => {\n      if (!content?.trim()) return;\n      setError(null);\n\n      const userMsg = { role: \"user\", content: content.trim(), ...extra };\n      const userId = uid();\n      const fullUser = { ...userMsg, id: userId, timestamp: new Date().toISOString() };\n\n      setMessages((prev) => [...prev, fullUser]);\n      setIsLoading(true);\n\n      try {\n        const allMsgs = [...messages, fullUser];\n        const result = await onSendRef.current?.(fullUser, allMsgs, {\n          addMessage,\n          updateMessage,\n          appendChunk,\n          setStreaming: setIsStreaming,\n        });\n\n        if (result && typeof result === \"object\" && result.role) {\n          addMessage(result);\n        }\n      } catch (err) {\n        setError(err?.message ?? \"Failed to send message\");\n        addMessage({\n          role: \"system\",\n          content: err?.message ?? \"Something went wrong. Please try again.\",\n          isError: true,\n        });\n      } finally {\n        setIsLoading(false);\n        setIsStreaming(false);\n      }\n    },\n    [messages, addMessage, updateMessage, appendChunk]\n  );\n\n  const retryLast = useCallback(() => {\n    const lastUser = [...messages].reverse().find((m) => m.role === \"user\");\n    if (!lastUser) return;\n\n    const idx = messages.lastIndexOf(lastUser);\n    setMessages(messages.slice(0, idx));\n    setError(null);\n\n    sendMessage(lastUser.content);\n  }, [messages, sendMessage]);\n\n  return {\n    messages,\n    isLoading,\n    isStreaming,\n    error,\n    sendMessage,\n    addMessage,\n    updateMessage,\n    appendChunk,\n    removeMessage,\n    clearMessages,\n    retryLast,\n    setError,\n  };\n}\n"],"names":["_nextId","uid","useChatState","initialMessages","onSend","messages","setMessages","useState","m","isLoading","setIsLoading","isStreaming","setIsStreaming","error","setError","onSendRef","useRef","addMessage","useCallback","msg","full","prev","updateMessage","id","updates","appendChunk","chunk","removeMessage","clearMessages","sendMessage","content","extra","userMsg","userId","fullUser","allMsgs","result","err","retryLast","lastUser","idx"],"mappings":"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"}
+{"version":3,"file":"useChatState.js","sources":["../../../../src/components/library/chat/useChatState.tsx"],"sourcesContent":["import { useState, useCallback, useRef } from \"react\";\nimport { ToolCall } from \"./ChatToolCall\";\n\nlet _nextId = 1;\nfunction uid(): string {\n  return `msg-${Date.now()}-${_nextId++}`;\n}\n\nexport interface ChatMessage {\n  id: string;\n  role: \"user\" | \"assistant\" | \"system\";\n  content?: string;\n  timestamp: string;\n  components?: unknown[];\n  toolCalls?: ToolCall[];\n  isError?: boolean;\n  isStreaming?: boolean;\n}\n\nexport interface ChatStateHelpers {\n  addMessage: (msg: Partial<ChatMessage>) => string;\n  updateMessage: (id: string, updates: Partial<ChatMessage>) => void;\n  appendChunk: (id: string, chunk: string) => void;\n  setStreaming: (streaming: boolean) => void;\n}\n\nexport interface UseChatStateOptions {\n  initialMessages?: Partial<ChatMessage>[];\n  onSend?: (\n    userMessage: ChatMessage,\n    allMessages: ChatMessage[],\n    helpers: ChatStateHelpers\n  ) => Promise<Partial<ChatMessage> | void>;\n}\n\nexport interface UseChatStateReturn {\n  messages: ChatMessage[];\n  isLoading: boolean;\n  isStreaming: boolean;\n  error: string | null;\n  sendMessage: (content: string, extra?: Partial<ChatMessage>) => Promise<void>;\n  addMessage: (msg: Partial<ChatMessage>) => string;\n  updateMessage: (id: string, updates: Partial<ChatMessage>) => void;\n  appendChunk: (id: string, chunk: string) => void;\n  removeMessage: (id: string) => void;\n  clearMessages: () => void;\n  retryLast: () => void;\n  setError: (error: string | null) => void;\n}\n\n/**\n * Core state management hook for AI chat.\n *\n * @example\n * const chat = useChatState({\n *   onSend: async (msg, history) => {\n *     const res = await fetch(\"/api/chat\", { method: \"POST\", body: JSON.stringify({ messages: history }) });\n *     const data = await res.json();\n *     return { role: \"assistant\", content: data.reply, components: data.components };\n *   },\n * });\n */\nexport default function useChatState({ initialMessages = [], onSend }: UseChatStateOptions = {}): UseChatStateReturn {\n  const [messages, setMessages] = useState<ChatMessage[]>(() =>\n    initialMessages.map((m) => ({\n      id: uid(),\n      timestamp: new Date().toISOString(),\n      role: m.role || \"user\",\n      ...m\n    } as ChatMessage))\n  );\n  const [isLoading, setIsLoading] = useState(false);\n  const [isStreaming, setIsStreaming] = useState(false);\n  const [error, setError] = useState<string | null>(null);\n  const onSendRef = useRef(onSend);\n  onSendRef.current = onSend;\n\n  const addMessage = useCallback((msg: Partial<ChatMessage>): string => {\n    const full: ChatMessage = {\n      id: uid(),\n      timestamp: new Date().toISOString(),\n      role: msg.role || \"assistant\",\n      ...msg\n    } as ChatMessage;\n    setMessages((prev) => [...prev, full]);\n    return full.id;\n  }, []);\n\n  const updateMessage = useCallback((id: string, updates: Partial<ChatMessage>) => {\n    setMessages((prev) =>\n      prev.map((m) => (m.id === id ? { ...m, ...updates } : m))\n    );\n  }, []);\n\n  const appendChunk = useCallback((id: string, chunk: string) => {\n    setMessages((prev) =>\n      prev.map((m) =>\n        m.id === id ? { ...m, content: (m.content ?? \"\") + chunk } : m\n      )\n    );\n  }, []);\n\n  const removeMessage = useCallback((id: string) => {\n    setMessages((prev) => prev.filter((m) => m.id !== id));\n  }, []);\n\n  const clearMessages = useCallback(() => {\n    setMessages([]);\n    setError(null);\n  }, []);\n\n  const sendMessage = useCallback(\n    async (content: string, extra: Partial<ChatMessage> = {}) => {\n      if (!content?.trim()) return;\n      setError(null);\n\n      const userMsg: ChatMessage = {\n        role: \"user\",\n        content: content.trim(),\n        ...extra,\n        id: uid(),\n        timestamp: new Date().toISOString()\n      } as ChatMessage;\n\n      setMessages((prev) => [...prev, userMsg]);\n      setIsLoading(true);\n\n      try {\n        const allMsgs = [...messages, userMsg];\n        const result = await onSendRef.current?.(userMsg, allMsgs, {\n          addMessage,\n          updateMessage,\n          appendChunk,\n          setStreaming: setIsStreaming,\n        });\n\n        if (result && typeof result === \"object\" && result.role) {\n          addMessage(result);\n        }\n      } catch (err) {\n        const errorMessage = err instanceof Error ? err.message : \"Failed to send message\";\n        setError(errorMessage);\n        addMessage({\n          role: \"system\",\n          content: err instanceof Error ? err.message : \"Something went wrong. Please try again.\",\n          isError: true,\n        });\n      } finally {\n        setIsLoading(false);\n        setIsStreaming(false);\n      }\n    },\n    [messages, addMessage, updateMessage, appendChunk]\n  );\n\n  const retryLast = useCallback(() => {\n    const lastUser = [...messages].reverse().find((m) => m.role === \"user\");\n    if (!lastUser) return;\n\n    const idx = messages.lastIndexOf(lastUser);\n    setMessages(messages.slice(0, idx));\n    setError(null);\n\n    sendMessage(lastUser.content || \"\");\n  }, [messages, sendMessage]);\n\n  return {\n    messages,\n    isLoading,\n    isStreaming,\n    error,\n    sendMessage,\n    addMessage,\n    updateMessage,\n    appendChunk,\n    removeMessage,\n    clearMessages,\n    retryLast,\n    setError,\n  };\n}\n"],"names":["_nextId","uid","useChatState","initialMessages","onSend","messages","setMessages","useState","m","isLoading","setIsLoading","isStreaming","setIsStreaming","error","setError","onSendRef","useRef","addMessage","useCallback","msg","full","prev","updateMessage","id","updates","appendChunk","chunk","removeMessage","clearMessages","sendMessage","content","extra","userMsg","allMsgs","result","err","errorMessage","retryLast","lastUser","idx"],"mappings":"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"}

package/dist/components/library/data/DataModeProvider.d.ts

@@ -1,22 +1,26 @@
+import React from "react";
+export type DataMode = "sample" | "live";
+export interface DataModeContextValue {
+    mode: DataMode;
+    isSample: boolean;
+    isLive: boolean;
+    toggle: () => void;
+    setMode: (mode: DataMode) => void;
+}
 /**
  * Read the current data mode from any component.
  *
  * @returns {{ mode: "sample"|"live", isSample: boolean, isLive: boolean, toggle: () => void, setMode: (mode) => void }}
  */
-export function useDataMode(): {
-    mode: "sample" | "live";
-    isSample: boolean;
-    isLive: boolean;
-    toggle: () => void;
-    setMode: (mode: any) => void;
-};
+export declare function useDataMode(): DataModeContextValue;
+export interface DataModeProviderProps {
+    initialMode?: DataMode;
+    children: React.ReactNode;
+}
 /**
  * Provides global data-mode state (sample vs live) to the component tree.
  * Persists to localStorage so the choice survives page reloads.
  *
  * Wrap once in _app.js alongside AppThemeProvider.
  */
-export default function DataModeProvider({ initialMode, children }: {
-    initialMode?: string | undefined;
-    children: any;
-}): import("react/jsx-runtime").JSX.Element;
+export default function DataModeProvider({ initialMode, children }: DataModeProviderProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/library/data/DataModeProvider.js

@@ -17,7 +17,7 @@ function v({ initialMode: n = "sample", children: r }) {
   t.useEffect(() => {
     try {
       const e = window.localStorage.getItem(l);
-      c.includes(e) && a(e);
+      e && c.includes(e) && a(e);
     } catch {
     }
   }, []), t.useEffect(() => {

package/dist/components/library/data/DataModeProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"DataModeProvider.js","sources":["../../../../src/components/library/data/DataModeProvider.jsx"],"sourcesContent":["import React from \"react\";\n\nconst DataModeContext = React.createContext({\n  mode: \"sample\",\n  isSample: true,\n  isLive: false,\n  toggle: () => {},\n  setMode: () => {},\n});\n\nconst STORAGE_KEY = \"app-data-mode\";\nconst VALID_MODES = [\"sample\", \"live\"];\n\n/**\n * Read the current data mode from any component.\n *\n * @returns {{ mode: \"sample\"|\"live\", isSample: boolean, isLive: boolean, toggle: () => void, setMode: (mode) => void }}\n */\nexport function useDataMode() {\n  return React.useContext(DataModeContext);\n}\n\n/**\n * Provides global data-mode state (sample vs live) to the component tree.\n * Persists to localStorage so the choice survives page reloads.\n *\n * Wrap once in _app.js alongside AppThemeProvider.\n */\nexport default function DataModeProvider({ initialMode = \"sample\", children }) {\n  const [mode, setModeState] = React.useState(initialMode);\n\n  React.useEffect(() => {\n    try {\n      const stored = window.localStorage.getItem(STORAGE_KEY);\n      if (VALID_MODES.includes(stored)) setModeState(stored);\n    } catch {\n      // SSR or storage unavailable\n    }\n  }, []);\n\n  React.useEffect(() => {\n    try {\n      window.localStorage.setItem(STORAGE_KEY, mode);\n    } catch {\n      // ignore\n    }\n  }, [mode]);\n\n  const setMode = React.useCallback((m) => {\n    if (VALID_MODES.includes(m)) setModeState(m);\n  }, []);\n\n  const value = React.useMemo(\n    () => ({\n      mode,\n      isSample: mode === \"sample\",\n      isLive: mode === \"live\",\n      toggle: () => setModeState((m) => (m === \"sample\" ? \"live\" : \"sample\")),\n      setMode,\n    }),\n    [mode, setMode]\n  );\n\n  return (\n    <DataModeContext.Provider value={value}>{children}</DataModeContext.Provider>\n  );\n}\n"],"names":["DataModeContext","React","STORAGE_KEY","VALID_MODES","useDataMode","DataModeProvider","initialMode","children","mode","setModeState","stored","setMode","m","value","jsx"],"mappings":";;AAEA,MAAMA,IAAkBC,EAAM,cAAc;AAAA,EAC1C,MAAM;AAAA,EACN,UAAU;AAAA,EACV,QAAQ;AAAA,EACR,QAAQ,MAAM;AAAA,EAAC;AAAA,EACf,SAAS,MAAM;AAAA,EAAC;AAClB,CAAC,GAEKC,IAAc,iBACdC,IAAc,CAAC,UAAU,MAAM;AAO9B,SAASC,IAAc;AAC5B,SAAOH,EAAM,WAAWD,CAAe;AACzC;AAQA,SAAwBK,EAAiB,EAAE,aAAAC,IAAc,UAAU,UAAAC,KAAY;AAC7E,QAAM,CAACC,GAAMC,CAAY,IAAIR,EAAM,SAASK,CAAW;AAEvDL,EAAAA,EAAM,UAAU,MAAM;AACpB,QAAI;AACF,YAAMS,IAAS,OAAO,aAAa,QAAQR,CAAW;AACtD,MAAIC,EAAY,SAASO,CAAM,OAAgBA,CAAM;AAAA,IACvD,QAAQ;AAAA,IAER;AAAA,EACF,GAAG,CAAA,CAAE,GAELT,EAAM,UAAU,MAAM;AACpB,QAAI;AACF,aAAO,aAAa,QAAQC,GAAaM,CAAI;AAAA,IAC/C,QAAQ;AAAA,IAER;AAAA,EACF,GAAG,CAACA,CAAI,CAAC;AAET,QAAMG,IAAUV,EAAM,YAAY,CAACW,MAAM;AACvC,IAAIT,EAAY,SAASS,CAAC,OAAgBA,CAAC;AAAA,EAC7C,GAAG,CAAA,CAAE,GAECC,IAAQZ,EAAM;AAAA,IAClB,OAAO;AAAA,MACL,MAAAO;AAAA,MACA,UAAUA,MAAS;AAAA,MACnB,QAAQA,MAAS;AAAA,MACjB,QAAQ,MAAMC,EAAa,CAACG,MAAOA,MAAM,WAAW,SAAS,QAAS;AAAA,MACtE,SAAAD;AAAA,IAAA;AAAA,IAEF,CAACH,GAAMG,CAAO;AAAA,EAAA;AAGhB,SACE,gBAAAG,EAACd,EAAgB,UAAhB,EAAyB,OAAAa,GAAe,UAAAN,EAAA,CAAS;AAEtD;"}
+{"version":3,"file":"DataModeProvider.js","sources":["../../../../src/components/library/data/DataModeProvider.tsx"],"sourcesContent":["import React from \"react\";\n\nexport type DataMode = \"sample\" | \"live\";\n\nexport interface DataModeContextValue {\n  mode: DataMode;\n  isSample: boolean;\n  isLive: boolean;\n  toggle: () => void;\n  setMode: (mode: DataMode) => void;\n}\n\nconst DataModeContext = React.createContext<DataModeContextValue>({\n  mode: \"sample\",\n  isSample: true,\n  isLive: false,\n  toggle: () => {},\n  setMode: () => {},\n});\n\nconst STORAGE_KEY = \"app-data-mode\";\nconst VALID_MODES: DataMode[] = [\"sample\", \"live\"];\n\n/**\n * Read the current data mode from any component.\n *\n * @returns {{ mode: \"sample\"|\"live\", isSample: boolean, isLive: boolean, toggle: () => void, setMode: (mode) => void }}\n */\nexport function useDataMode(): DataModeContextValue {\n  return React.useContext(DataModeContext);\n}\n\nexport interface DataModeProviderProps {\n  initialMode?: DataMode;\n  children: React.ReactNode;\n}\n\n/**\n * Provides global data-mode state (sample vs live) to the component tree.\n * Persists to localStorage so the choice survives page reloads.\n *\n * Wrap once in _app.js alongside AppThemeProvider.\n */\nexport default function DataModeProvider({ initialMode = \"sample\", children }: DataModeProviderProps) {\n  const [mode, setModeState] = React.useState<DataMode>(initialMode);\n\n  React.useEffect(() => {\n    try {\n      const stored = window.localStorage.getItem(STORAGE_KEY);\n      if (stored && VALID_MODES.includes(stored as DataMode)) {\n        setModeState(stored as DataMode);\n      }\n    } catch {\n      // SSR or storage unavailable\n    }\n  }, []);\n\n  React.useEffect(() => {\n    try {\n      window.localStorage.setItem(STORAGE_KEY, mode);\n    } catch {\n      // ignore\n    }\n  }, [mode]);\n\n  const setMode = React.useCallback((m: DataMode) => {\n    if (VALID_MODES.includes(m)) setModeState(m);\n  }, []);\n\n  const value = React.useMemo<DataModeContextValue>(\n    () => ({\n      mode,\n      isSample: mode === \"sample\",\n      isLive: mode === \"live\",\n      toggle: () => setModeState((m) => (m === \"sample\" ? \"live\" : \"sample\")),\n      setMode,\n    }),\n    [mode, setMode]\n  );\n\n  return (\n    <DataModeContext.Provider value={value}>{children}</DataModeContext.Provider>\n  );\n}\n"],"names":["DataModeContext","React","STORAGE_KEY","VALID_MODES","useDataMode","DataModeProvider","initialMode","children","mode","setModeState","stored","setMode","m","value","jsx"],"mappings":";;AAYA,MAAMA,IAAkBC,EAAM,cAAoC;AAAA,EAChE,MAAM;AAAA,EACN,UAAU;AAAA,EACV,QAAQ;AAAA,EACR,QAAQ,MAAM;AAAA,EAAC;AAAA,EACf,SAAS,MAAM;AAAA,EAAC;AAClB,CAAC,GAEKC,IAAc,iBACdC,IAA0B,CAAC,UAAU,MAAM;AAO1C,SAASC,IAAoC;AAClD,SAAOH,EAAM,WAAWD,CAAe;AACzC;AAaA,SAAwBK,EAAiB,EAAE,aAAAC,IAAc,UAAU,UAAAC,KAAmC;AACpG,QAAM,CAACC,GAAMC,CAAY,IAAIR,EAAM,SAAmBK,CAAW;AAEjEL,EAAAA,EAAM,UAAU,MAAM;AACpB,QAAI;AACF,YAAMS,IAAS,OAAO,aAAa,QAAQR,CAAW;AACtD,MAAIQ,KAAUP,EAAY,SAASO,CAAkB,KACnDD,EAAaC,CAAkB;AAAA,IAEnC,QAAQ;AAAA,IAER;AAAA,EACF,GAAG,CAAA,CAAE,GAELT,EAAM,UAAU,MAAM;AACpB,QAAI;AACF,aAAO,aAAa,QAAQC,GAAaM,CAAI;AAAA,IAC/C,QAAQ;AAAA,IAER;AAAA,EACF,GAAG,CAACA,CAAI,CAAC;AAET,QAAMG,IAAUV,EAAM,YAAY,CAACW,MAAgB;AACjD,IAAIT,EAAY,SAASS,CAAC,OAAgBA,CAAC;AAAA,EAC7C,GAAG,CAAA,CAAE,GAECC,IAAQZ,EAAM;AAAA,IAClB,OAAO;AAAA,MACL,MAAAO;AAAA,MACA,UAAUA,MAAS;AAAA,MACnB,QAAQA,MAAS;AAAA,MACjB,QAAQ,MAAMC,EAAa,CAACG,MAAOA,MAAM,WAAW,SAAS,QAAS;AAAA,MACtE,SAAAD;AAAA,IAAA;AAAA,IAEF,CAACH,GAAMG,CAAO;AAAA,EAAA;AAGhB,SACE,gBAAAG,EAACd,EAAgB,UAAhB,EAAyB,OAAAa,GAAe,UAAAN,EAAA,CAAS;AAEtD;"}

package/dist/components/library/data/DataModeToggle.d.ts

@@ -1,7 +1,8 @@
+export interface DataModeToggleProps {
+    className?: string;
+}
 /**
  * Pill toggle for switching between sample and live data modes.
  * Place in the AppShell header next to the theme toggle.
  */
-export default function DataModeToggle({ className }: {
-    className?: string | undefined;
-}): import("react/jsx-runtime").JSX.Element;
+export default function DataModeToggle({ className }: DataModeToggleProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/library/data/DataModeToggle.js

@@ -1,8 +1,7 @@
 import { jsxs as d, jsx as a } from "react/jsx-runtime";
-import "react";
 import { useDataMode as m } from "./DataModeProvider.js";
-import { BeakerIcon as l, SignalIcon as i } from "@heroicons/react/24/outline";
-function c({ className: o = "" }) {
+import { BeakerIcon as l, SignalIcon as b } from "@heroicons/react/24/outline";
+function g({ className: o = "" }) {
   const { mode: r, toggle: t } = m(), e = r === "sample";
   return /* @__PURE__ */ d(
     "button",
@@ -16,13 +15,13 @@ function c({ className: o = "" }) {
       ].filter(Boolean).join(" "),
       "aria-label": `Data mode: ${r}. Click to switch to ${e ? "live" : "sample"}.`,
       children: [
-        e ? /* @__PURE__ */ a(l, { className: "h-3.5 w-3.5", "aria-hidden": "true" }) : /* @__PURE__ */ a(i, { className: "h-3.5 w-3.5", "aria-hidden": "true" }),
+        e ? /* @__PURE__ */ a(l, { className: "h-3.5 w-3.5", "aria-hidden": "true" }) : /* @__PURE__ */ a(b, { className: "h-3.5 w-3.5", "aria-hidden": "true" }),
         e ? "Sample" : "Live"
       ]
     }
   );
 }
 export {
-  c as default
+  g as default
 };
 //# sourceMappingURL=DataModeToggle.js.map

package/dist/components/library/data/DataModeToggle.js.map

@@ -1 +1 @@
-{"version":3,"file":"DataModeToggle.js","sources":["../../../../src/components/library/data/DataModeToggle.jsx"],"sourcesContent":["import React from \"react\";\nimport { useDataMode } from \"./DataModeProvider\";\nimport { BeakerIcon, SignalIcon } from \"@heroicons/react/24/outline\";\n\n/**\n * Pill toggle for switching between sample and live data modes.\n * Place in the AppShell header next to the theme toggle.\n */\nexport default function DataModeToggle({ className = \"\" }) {\n  const { mode, toggle } = useDataMode();\n  const isSample = mode === \"sample\";\n\n  return (\n    <button\n      type=\"button\"\n      onClick={toggle}\n      className={[\n        \"inline-flex items-center gap-1.5 rounded-lg border px-2.5 py-1.5 text-xs font-semibold shadow-sm transition\",\n        isSample\n          ? \"border-amber-200 bg-amber-50 text-amber-700 hover:bg-amber-100 dark:border-amber-800 dark:bg-amber-950/40 dark:text-amber-300 dark:hover:bg-amber-950/60\"\n          : \"border-emerald-200 bg-emerald-50 text-emerald-700 hover:bg-emerald-100 dark:border-emerald-800 dark:bg-emerald-950/40 dark:text-emerald-300 dark:hover:bg-emerald-950/60\",\n        className,\n      ]\n        .filter(Boolean)\n        .join(\" \")}\n      aria-label={`Data mode: ${mode}. Click to switch to ${isSample ? \"live\" : \"sample\"}.`}\n    >\n      {isSample ? (\n        <BeakerIcon className=\"h-3.5 w-3.5\" aria-hidden=\"true\" />\n      ) : (\n        <SignalIcon className=\"h-3.5 w-3.5\" aria-hidden=\"true\" />\n      )}\n      {isSample ? \"Sample\" : \"Live\"}\n    </button>\n  );\n}\n"],"names":["DataModeToggle","className","mode","toggle","useDataMode","isSample","jsxs","jsx","BeakerIcon","SignalIcon"],"mappings":";;;;AAQA,SAAwBA,EAAe,EAAE,WAAAC,IAAY,MAAM;AACzD,QAAM,EAAE,MAAAC,GAAM,QAAAC,EAAA,IAAWC,EAAA,GACnBC,IAAWH,MAAS;AAE1B,SACE,gBAAAI;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,MAAK;AAAA,MACL,SAASH;AAAA,MACT,WAAW;AAAA,QACT;AAAA,QACAE,IACI,6JACA;AAAA,QACJJ;AAAA,MAAA,EAEC,OAAO,OAAO,EACd,KAAK,GAAG;AAAA,MACX,cAAY,cAAcC,CAAI,wBAAwBG,IAAW,SAAS,QAAQ;AAAA,MAEjF,UAAA;AAAA,QAAAA,IACC,gBAAAE,EAACC,GAAA,EAAW,WAAU,eAAc,eAAY,OAAA,CAAO,IAEvD,gBAAAD,EAACE,GAAA,EAAW,WAAU,eAAc,eAAY,QAAO;AAAA,QAExDJ,IAAW,WAAW;AAAA,MAAA;AAAA,IAAA;AAAA,EAAA;AAG7B;"}
+{"version":3,"file":"DataModeToggle.js","sources":["../../../../src/components/library/data/DataModeToggle.tsx"],"sourcesContent":["import { useDataMode } from \"./DataModeProvider\";\nimport { BeakerIcon, SignalIcon } from \"@heroicons/react/24/outline\";\n\nexport interface DataModeToggleProps {\n  className?: string;\n}\n\n/**\n * Pill toggle for switching between sample and live data modes.\n * Place in the AppShell header next to the theme toggle.\n */\nexport default function DataModeToggle({ className = \"\" }: DataModeToggleProps) {\n  const { mode, toggle } = useDataMode();\n  const isSample = mode === \"sample\";\n\n  return (\n    <button\n      type=\"button\"\n      onClick={toggle}\n      className={[\n        \"inline-flex items-center gap-1.5 rounded-lg border px-2.5 py-1.5 text-xs font-semibold shadow-sm transition\",\n        isSample\n          ? \"border-amber-200 bg-amber-50 text-amber-700 hover:bg-amber-100 dark:border-amber-800 dark:bg-amber-950/40 dark:text-amber-300 dark:hover:bg-amber-950/60\"\n          : \"border-emerald-200 bg-emerald-50 text-emerald-700 hover:bg-emerald-100 dark:border-emerald-800 dark:bg-emerald-950/40 dark:text-emerald-300 dark:hover:bg-emerald-950/60\",\n        className,\n      ]\n        .filter(Boolean)\n        .join(\" \")}\n      aria-label={`Data mode: ${mode}. Click to switch to ${isSample ? \"live\" : \"sample\"}.`}\n    >\n      {isSample ? (\n        <BeakerIcon className=\"h-3.5 w-3.5\" aria-hidden=\"true\" />\n      ) : (\n        <SignalIcon className=\"h-3.5 w-3.5\" aria-hidden=\"true\" />\n      )}\n      {isSample ? \"Sample\" : \"Live\"}\n    </button>\n  );\n}\n"],"names":["DataModeToggle","className","mode","toggle","useDataMode","isSample","jsxs","jsx","BeakerIcon","SignalIcon"],"mappings":";;;AAWA,SAAwBA,EAAe,EAAE,WAAAC,IAAY,MAA2B;AAC9E,QAAM,EAAE,MAAAC,GAAM,QAAAC,EAAA,IAAWC,EAAA,GACnBC,IAAWH,MAAS;AAE1B,SACE,gBAAAI;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,MAAK;AAAA,MACL,SAASH;AAAA,MACT,WAAW;AAAA,QACT;AAAA,QACAE,IACI,6JACA;AAAA,QACJJ;AAAA,MAAA,EAEC,OAAO,OAAO,EACd,KAAK,GAAG;AAAA,MACX,cAAY,cAAcC,CAAI,wBAAwBG,IAAW,SAAS,QAAQ;AAAA,MAEjF,UAAA;AAAA,QAAAA,IACC,gBAAAE,EAACC,GAAA,EAAW,WAAU,eAAc,eAAY,OAAA,CAAO,IAEvD,gBAAAD,EAACE,GAAA,EAAW,WAAU,eAAc,eAAY,QAAO;AAAA,QAExDJ,IAAW,WAAW;AAAA,MAAA;AAAA,IAAA;AAAA,EAAA;AAG7B;"}

package/dist/components/library/data/chartDataProvider.d.ts

@@ -1,3 +1,41 @@
-export function listSemanticIds(): string[];
-export function getSemanticDataset(semanticId: any): any;
-export function getSemanticMetric(semanticId: any, metricId: any): any;
+export type ChangeType = "positive" | "negative" | "neutral";
+export type MetricColor = "primary" | "success" | "warning" | "danger";
+export type ColumnType = "currency" | "percentage" | "number" | "text";
+export interface SemanticMetric {
+    metricId: string;
+    title: string;
+    subtitle: string;
+    value: string;
+    change?: string;
+    changeType?: ChangeType;
+    color?: MetricColor;
+    trend?: string;
+}
+export interface TableColumn {
+    key: string;
+    label: string;
+    type?: ColumnType;
+    sortable?: boolean;
+    mono?: boolean;
+}
+export interface TableRow {
+    id: number;
+    [key: string]: any;
+}
+export interface SemanticTable {
+    title: string;
+    subtitle: string;
+    columns: TableColumn[];
+    rows: TableRow[];
+}
+export interface SemanticDataset {
+    title: string;
+    metrics?: SemanticMetric[];
+    table?: SemanticTable;
+}
+export interface SemanticDatasets {
+    [key: string]: SemanticDataset;
+}
+export declare function listSemanticIds(): string[];
+export declare function getSemanticDataset(semanticId: string): SemanticDataset | null;
+export declare function getSemanticMetric(semanticId: string, metricId: string): SemanticMetric | null;

package/dist/components/library/data/filterUtils.d.ts

@@ -2,6 +2,38 @@
  * Pure data utilities for filtering, sorting, and searching.
  * Stateless — combine with usePageFilters hook for state management.
  */
+export type SortDirection = "asc" | "desc";
+export interface DateRange {
+    start?: Date | string;
+    end?: Date | string;
+}
+export type FilterType = "search" | "select" | "toggle" | "dateRange";
+export interface BaseFilterDefinition {
+    id: string;
+    type: FilterType;
+    defaultValue?: any;
+}
+export interface SearchFilterDefinition extends BaseFilterDefinition {
+    type: "search";
+    keys: string[];
+}
+export interface SelectFilterDefinition extends BaseFilterDefinition {
+    type: "select";
+    key: string;
+}
+export interface ToggleFilterDefinition extends BaseFilterDefinition {
+    type: "toggle";
+    key: string;
+    matchValue?: any;
+}
+export interface DateRangeFilterDefinition extends BaseFilterDefinition {
+    type: "dateRange";
+    key: string;
+}
+export type FilterDefinition = SearchFilterDefinition | SelectFilterDefinition | ToggleFilterDefinition | DateRangeFilterDefinition;
+export interface FilterValues {
+    [key: string]: any;
+}
 /**
  * Text search across multiple keys.
  * @param {Array} data
@@ -9,7 +41,7 @@
  * @param {string[]} keys — object keys to search within
  * @returns {Array} filtered data
  */
-export function filterBySearch(data: any[], query: string, keys?: string[]): any[];
+export declare function filterBySearch<T>(data: T[], query: string, keys?: string[]): T[];
 /**
  * Filter rows where key matches a specific value.
  * Pass "all" or "" to skip filtering.
@@ -18,7 +50,7 @@ export function filterBySearch(data: any[], query: string, keys?: string[]): any
  * @param {*} value — value to match (exact, case-insensitive for strings)
  * @returns {Array}
  */
-export function filterByValue(data: any[], key: string, value: any): any[];
+export declare function filterByValue<T>(data: T[], key: string, value: any): T[];
 /**
  * Filter rows where a boolean condition is met.
  * When toggle is off, returns all data (no filtering).
@@ -28,7 +60,7 @@ export function filterByValue(data: any[], key: string, value: any): any[];
  * @param {*} matchValue — value that key should equal when active (default: truthy check)
  * @returns {Array}
  */
-export function filterByToggle(data: any[], key: string, isActive: boolean, matchValue: any): any[];
+export declare function filterByToggle<T>(data: T[], key: string, isActive: boolean, matchValue?: any): T[];
 /**
  * Filter rows where a date field falls within a range.
  * @param {Array} data
@@ -36,10 +68,7 @@ export function filterByToggle(data: any[], key: string, isActive: boolean, matc
  * @param {{ start?: Date|string, end?: Date|string }} range
  * @returns {Array}
  */
-export function filterByDateRange(data: any[], key: string, range: {
-    start?: Date | string;
-    end?: Date | string;
-}): any[];
+export declare function filterByDateRange<T>(data: T[], key: string, range: DateRange | null): T[];
 /**
  * Sort data by a key.
  * @param {Array} data
@@ -47,7 +76,7 @@ export function filterByDateRange(data: any[], key: string, range: {
  * @param {"asc"|"desc"} direction
  * @returns {Array} new sorted array
  */
-export function sortByKey(data: any[], key: string, direction?: "asc" | "desc"): any[];
+export declare function sortByKey<T>(data: T[], key: string, direction?: SortDirection): T[];
 /**
  * Apply a set of filter definitions to data.
  * Each filter in `filters` has { id, type, key/keys } and `values` holds the current state.
@@ -57,4 +86,4 @@ export function sortByKey(data: any[], key: string, direction?: "asc" | "desc"):
  * @param {Object} values — current filter values keyed by filter id
  * @returns {Array} filtered data
  */
-export function applyFilters(data: any[], filters?: any[], values?: Object): any[];
+export declare function applyFilters<T>(data: T[], filters?: FilterDefinition[], values?: FilterValues): T[];