@iota-uz/sdk 0.20.0 → 0.21.0

package/dist/chat-ui/hooks/useDataTable.d.ts

@@ -0,0 +1,54 @@
+import type { RenderTableData } from '../types';
+import { type ColumnType, type FormattedCell } from '../utils/columnTypes';
+export interface ColumnMeta {
+    index: number;
+    name: string;
+    header: string;
+    type: ColumnType;
+    width: number | null;
+    visible: boolean;
+}
+export interface SortState {
+    columnIndex: number;
+    direction: 'asc' | 'desc';
+}
+export interface ColumnStats {
+    sum: number;
+    avg: number;
+    min: number;
+    max: number;
+    count: number;
+    nullCount: number;
+}
+export interface DataTableOptions {
+    defaultPageSize?: number;
+    enableSearch?: boolean;
+    enableSort?: boolean;
+    enableResize?: boolean;
+    enableColumnVisibility?: boolean;
+}
+export interface UseDataTableReturn {
+    columns: ColumnMeta[];
+    visibleColumns: ColumnMeta[];
+    page: number;
+    pageSize: number;
+    totalPages: number;
+    totalFilteredRows: number;
+    pageSizeOptions: number[];
+    pageRows: unknown[][];
+    setPage: (page: number) => void;
+    setPageSize: (size: number) => void;
+    sort: SortState | null;
+    toggleSort: (columnIndex: number) => void;
+    clearSort: () => void;
+    searchQuery: string;
+    setSearchQuery: (query: string) => void;
+    columnStats: Map<number, ColumnStats>;
+    toggleColumnVisibility: (columnIndex: number) => void;
+    resetColumnVisibility: () => void;
+    setColumnWidth: (columnIndex: number, width: number) => void;
+    formatCell: (value: unknown, columnIndex: number) => FormattedCell;
+    getCellAlignment: (columnIndex: number) => 'left' | 'right';
+    getTableAsTSV: () => string;
+}
+export declare function useDataTable(source: RenderTableData | (() => RenderTableData), options?: DataTableOptions): UseDataTableReturn;

package/dist/chat-ui/hooks/useFocusTrap.d.ts

@@ -0,0 +1,17 @@
+type RefObject<T> = {
+    current: T | null;
+};
+/**
+ * Hook to trap focus within a container (for modals, sidebars)
+ * Ensures Tab and Shift+Tab cycle through focusable elements only
+ *
+ * @param containerRef - React ref to the container element
+ * @param isActive - Whether the focus trap is currently active
+ * @param restoreFocusOnDeactivate - Element to restore focus to when deactivated
+ *
+ * @example
+ * const modalRef = useRef<HTMLDivElement>(null)
+ * useFocusTrap(modalRef, isOpen)
+ */
+export declare function useFocusTrap(containerRef: RefObject<HTMLElement | null>, isActive: () => boolean, restoreFocusOnDeactivate?: HTMLElement | null): void;
+export {};

package/dist/chat-ui/hooks/useHttpDataSourceConfigFromApplet.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Builds HttpDataSourceConfig from window.__APPLET_CONTEXT__.
+ * For use with createHttpDataSource when the app is embedded via the applet framework.
+ *
+ * Expects the host to inject context with:
+ * - config.rpcUIEndpoint, config.streamEndpoint
+ * - session.csrfToken (or window.__CSRF_TOKEN__)
+ */
+import type { HttpDataSourceConfig } from '../data/HttpDataSource';
+/**
+ * Returns HttpDataSourceConfig derived from window.__APPLET_CONTEXT__.
+ * Use with createHttpDataSource() for RPC and SSE endpoints.
+ *
+ * @throws Error if window.__APPLET_CONTEXT__ is not available
+ */
+export declare function useHttpDataSourceConfigFromApplet(options?: {
+    rpcTimeoutMs?: number;
+    streamConnectTimeoutMs?: number;
+}): HttpDataSourceConfig;

package/dist/chat-ui/hooks/useImageGallery.d.ts

@@ -0,0 +1,67 @@
+/**
+ * useImageGallery Hook
+ * Manages image modal/gallery state and navigation
+ */
+import type { ImageAttachment } from '../types';
+export interface UseImageGalleryOptions {
+    /** Initial images to display */
+    images?: ImageAttachment[];
+    /** Wrap navigation at boundaries (default: false) */
+    wrap?: boolean;
+    /** Callback when modal opens */
+    onOpen?: (index: number) => void;
+    /** Callback when modal closes */
+    onClose?: () => void;
+    /** Callback when navigation occurs */
+    onNavigate?: (index: number, direction: 'prev' | 'next') => void;
+}
+export interface UseImageGalleryReturn {
+    /** Whether the gallery modal is open */
+    isOpen: boolean;
+    /** Current image index */
+    currentIndex: number;
+    /** Current image (or undefined if none) */
+    currentImage: ImageAttachment | undefined;
+    /** All images in the gallery */
+    images: ImageAttachment[];
+    /** Whether there's a previous image */
+    hasPrev: boolean;
+    /** Whether there's a next image */
+    hasNext: boolean;
+    /** Open gallery at specific index */
+    open: (index: number, newImages?: ImageAttachment[]) => void;
+    /** Close the gallery */
+    close: () => void;
+    /** Navigate to previous image */
+    prev: () => void;
+    /** Navigate to next image */
+    next: () => void;
+    /** Navigate to specific index */
+    goTo: (index: number) => void;
+    /** Set images without opening */
+    setImages: (images: ImageAttachment[]) => void;
+}
+/**
+ * Hook for managing image gallery/modal state
+ *
+ * @example
+ * ```tsx
+ * const gallery = useImageGallery({ images: attachments })
+ *
+ * // Open gallery
+ * <button onClick={() => gallery.open(0)}>View Images</button>
+ *
+ * // Render gallery
+ * {gallery.isOpen && (
+ *   <ImageModal
+ *     image={gallery.currentImage}
+ *     onClose={gallery.close}
+ *     onPrev={gallery.prev}
+ *     onNext={gallery.next}
+ *     hasPrev={gallery.hasPrev}
+ *     hasNext={gallery.hasNext}
+ *   />
+ * )}
+ * ```
+ */
+export declare function useImageGallery(options?: UseImageGalleryOptions): UseImageGalleryReturn;

package/dist/chat-ui/hooks/useKeyboardShortcuts.d.ts

@@ -0,0 +1,23 @@
+export interface ShortcutConfig {
+    key: string;
+    ctrl?: boolean;
+    shift?: boolean;
+    alt?: boolean;
+    meta?: boolean;
+    callback: () => void;
+    preventDefault?: boolean;
+    description?: string;
+}
+/**
+ * Hook for managing global keyboard shortcuts
+ * Automatically handles modifier keys and input field exclusion
+ *
+ * @param shortcuts - Array of keyboard shortcut configurations
+ *
+ * @example
+ * useKeyboardShortcuts([
+ *   { key: 'k', ctrl: true, callback: () => focusSearch(), description: 'Focus search' },
+ *   { key: '?', callback: () => setShowHelp(true), description: 'Show keyboard shortcuts' },
+ * ])
+ */
+export declare function useKeyboardShortcuts(shortcuts: ShortcutConfig[]): void;

package/dist/chat-ui/hooks/useLongPress.d.ts

@@ -0,0 +1,22 @@
+interface LongPressOptions {
+    delay?: number;
+    onLongPress: (e: TouchEvent | MouseEvent) => void;
+    onPressStart?: () => void;
+    onPressCancel?: () => void;
+    moveThreshold?: number;
+    hapticFeedback?: boolean;
+}
+interface LongPressEventHandlers {
+    onTouchStart: (e: TouchEvent) => void;
+    onTouchEnd: (e: TouchEvent) => void;
+    onTouchMove: (e: TouchEvent) => void;
+    onMouseDown?: (e: MouseEvent) => void;
+    onMouseUp?: (e: MouseEvent) => void;
+    onMouseLeave?: (e: MouseEvent) => void;
+}
+interface LongPressResult {
+    handlers: LongPressEventHandlers;
+    isPressed: boolean;
+}
+export declare function useLongPress(options: LongPressOptions): LongPressResult;
+export {};

package/dist/chat-ui/hooks/useMarkdownCopy.d.ts

@@ -0,0 +1,46 @@
+/**
+ * useMarkdownCopy Hook
+ * Manages copy-to-clipboard state for code blocks in markdown
+ */
+export interface UseMarkdownCopyOptions {
+    /** Duration to show "copied" state in ms (default: 2000) */
+    copiedDuration?: number;
+    /** Callback when copy succeeds */
+    onCopy?: (content: string, language?: string) => void;
+    /** Callback when copy fails */
+    onError?: (error: Error) => void;
+}
+export interface UseMarkdownCopyReturn {
+    /** Map of copied states by block ID */
+    copiedStates: Map<string, boolean>;
+    /** Check if a specific block is in copied state */
+    isCopied: (blockId: string) => boolean;
+    /** Copy content with block ID tracking */
+    copy: (blockId: string, content: string, language?: string) => Promise<void>;
+    /** Reset copied state for a specific block */
+    reset: (blockId: string) => void;
+    /** Reset all copied states */
+    resetAll: () => void;
+}
+/**
+ * Hook for managing copy states for multiple code blocks
+ *
+ * @example
+ * ```tsx
+ * const markdownCopy = useMarkdownCopy({
+ *   onCopy: (content, lang) => console.log(`Copied ${lang} code`),
+ * })
+ *
+ * function CodeBlock({ id, code, language }) {
+ *   return (
+ *     <div>
+ *       <pre>{code}</pre>
+ *       <button onClick={() => markdownCopy.copy(id, code, language)}>
+ *         {markdownCopy.isCopied(id) ? 'Copied!' : 'Copy'}
+ *       </button>
+ *     </div>
+ *   )
+ * }
+ * ```
+ */
+export declare function useMarkdownCopy(options?: UseMarkdownCopyOptions): UseMarkdownCopyReturn;

package/dist/chat-ui/hooks/useMessageActions.d.ts

@@ -0,0 +1,53 @@
+/**
+ * useMessageActions Hook
+ * Provides copy, regenerate, and edit functionality for messages
+ */
+export interface UseMessageActionsOptions {
+    /** Callback when copy succeeds */
+    onCopy?: (content: string) => void;
+    /** Callback when copy fails */
+    onCopyError?: (error: Error) => void;
+    /** Callback when regenerate is triggered */
+    onRegenerate?: () => void | Promise<void>;
+    /** Callback when edit is triggered */
+    onEdit?: (content: string) => void | Promise<void>;
+    /** Duration to show "copied" state in ms (default: 2000) */
+    copiedDuration?: number;
+}
+export interface UseMessageActionsReturn {
+    /** Whether content was recently copied */
+    isCopied: boolean;
+    /** Whether regenerate is in progress */
+    isRegenerating: boolean;
+    /** Whether edit is in progress */
+    isEditing: boolean;
+    /** Copy content to clipboard */
+    copy: (content: string) => Promise<void>;
+    /** Trigger regenerate action */
+    regenerate: () => Promise<void>;
+    /** Trigger edit action */
+    edit: (content: string) => Promise<void>;
+    /** Reset all states */
+    reset: () => void;
+}
+/**
+ * Hook for managing message actions (copy, regenerate, edit)
+ *
+ * @example
+ * ```tsx
+ * const actions = useMessageActions({
+ *   onRegenerate: () => chatContext.regenerateMessage(messageId),
+ *   onEdit: (content) => chatContext.editMessage(messageId, content),
+ *   onCopy: () => toast.success('Copied!'),
+ * })
+ *
+ * <button onClick={() => actions.copy(message.content)}>
+ *   {actions.isCopied ? 'Copied!' : 'Copy'}
+ * </button>
+ *
+ * <button onClick={actions.regenerate} disabled={actions.isRegenerating}>
+ *   {actions.isRegenerating ? 'Regenerating...' : 'Regenerate'}
+ * </button>
+ * ```
+ */
+export declare function useMessageActions(options?: UseMessageActionsOptions): UseMessageActionsReturn;

package/dist/chat-ui/hooks/useMessageListScroll.d.ts

@@ -0,0 +1,22 @@
+export interface MessageListScrollOptions {
+    /** Current session id — triggers initial scroll on change. */
+    currentSessionId: string | undefined;
+    /** True while session data is loading. */
+    fetching: boolean;
+    /** Number of conversation turns (triggers auto-scroll). */
+    turnsLength: number;
+    /** Current streaming content (controls instant vs smooth scroll). */
+    streamingContent: string;
+}
+export interface MessageListScrollReturn {
+    containerRef: {
+        current: HTMLDivElement | null;
+    };
+    messagesEndRef: {
+        current: HTMLDivElement | null;
+    };
+    showScrollButton: boolean;
+    unreadCount: number;
+    handleScrollToBottom: () => void;
+}
+export declare function useMessageListScroll(solidProps1: MessageListScrollOptions): MessageListScrollReturn;

package/dist/chat-ui/hooks/useModalLock.d.ts

@@ -0,0 +1 @@
+export declare function useModalLock(isOpen: () => boolean): void;

package/dist/chat-ui/hooks/useScrollToBottom.d.ts

@@ -0,0 +1,22 @@
+export interface UseScrollToBottomReturn {
+    /**
+     * Ref to attach to the messages container
+     */
+    containerRef: {
+        current: HTMLDivElement | null;
+    };
+    /**
+     * Whether to show the scroll-to-bottom button
+     */
+    showScrollButton: boolean;
+    /**
+     * Function to scroll to bottom
+     */
+    scrollToBottom: () => void;
+}
+/**
+ * Hook for managing scroll-to-bottom behavior
+ * Automatically scrolls if user is near the bottom
+ * Shows button only when scrolled up significantly
+ */
+export declare function useScrollToBottom(items: unknown[]): UseScrollToBottomReturn;

package/dist/chat-ui/hooks/useSidebarState.d.ts

@@ -0,0 +1,8 @@
+export interface UseSidebarStateReturn {
+    isMobile: boolean;
+    isMobileOpen: boolean;
+    openMobile: () => void;
+    closeMobile: () => void;
+    toggleMobile: () => void;
+}
+export declare function useSidebarState(): UseSidebarStateReturn;

package/dist/chat-ui/hooks/useToast.d.ts

@@ -0,0 +1,43 @@
+/**
+ * useToast Hook
+ * Manages toast notification state
+ */
+export type ToastType = 'success' | 'error' | 'info' | 'warning';
+export interface ToastAction {
+    label: string;
+    onClick: () => void;
+}
+export interface ToastItem {
+    id: string;
+    type: ToastType;
+    message: string;
+    duration?: number;
+    action?: ToastAction;
+}
+export interface UseToastReturn {
+    toasts: ToastItem[];
+    success: (msg: string, duration?: number, action?: ToastAction) => void;
+    error: (msg: string, duration?: number, action?: ToastAction) => void;
+    info: (msg: string, duration?: number, action?: ToastAction) => void;
+    warning: (msg: string, duration?: number, action?: ToastAction) => void;
+    dismiss: (id: string) => void;
+    dismissAll: () => void;
+}
+/**
+ * Hook for managing toast notifications
+ *
+ * @example
+ * ```tsx
+ * const { toasts, success, error, dismiss } = useToast()
+ *
+ * // Show a success toast
+ * success('Operation completed!')
+ *
+ * // Show an error toast with custom duration
+ * error('Something went wrong', 10000)
+ *
+ * // Render toasts
+ * <ToastContainer toasts={toasts} onDismiss={dismiss} />
+ * ```
+ */
+export declare function useToast(): UseToastReturn;

package/dist/chat-ui/hooks/useTranslation.d.ts

@@ -0,0 +1,4 @@
+export declare function useTranslation(): {
+    t: (key: string, params?: Record<string, string | number | boolean>) => string;
+    locale: string;
+};

package/dist/chat-ui/icons/index.d.ts

@@ -0,0 +1,93 @@
+import { type JSX, type Component } from 'solid-js';
+export interface IconProps extends JSX.SvgSVGAttributes<SVGSVGElement> {
+    size?: string | number;
+    weight?: 'thin' | 'light' | 'regular' | 'bold' | 'fill' | 'duotone';
+    mirrored?: boolean;
+    className?: string;
+}
+export declare const Archive: (props: IconProps) => JSX.Element;
+export declare const ArrowClockwise: (props: IconProps) => JSX.Element;
+export declare const ArrowCounterClockwise: (props: IconProps) => JSX.Element;
+export declare const ArrowDown: (props: IconProps) => JSX.Element;
+export declare const ArrowLeft: (props: IconProps) => JSX.Element;
+export declare const ArrowRight: (props: IconProps) => JSX.Element;
+export declare const ArrowSquareOut: (props: IconProps) => JSX.Element;
+export declare const ArrowUUpLeft: (props: IconProps) => JSX.Element;
+export declare const ArrowUp: (props: IconProps) => JSX.Element;
+export declare const ArrowsClockwise: (props: IconProps) => JSX.Element;
+export declare const ArrowsCounterClockwise: (props: IconProps) => JSX.Element;
+export declare const ArrowsIn: (props: IconProps) => JSX.Element;
+export declare const ArrowsOut: (props: IconProps) => JSX.Element;
+export declare const Bookmark: (props: IconProps) => JSX.Element;
+export declare const Brain: (props: IconProps) => JSX.Element;
+export declare const Bug: (props: IconProps) => JSX.Element;
+export declare const CaretDown: (props: IconProps) => JSX.Element;
+export declare const CaretLeft: (props: IconProps) => JSX.Element;
+export declare const CaretLineLeft: (props: IconProps) => JSX.Element;
+export declare const CaretLineRight: (props: IconProps) => JSX.Element;
+export declare const CaretRight: (props: IconProps) => JSX.Element;
+export declare const CaretUp: (props: IconProps) => JSX.Element;
+export declare const CaretUpDown: (props: IconProps) => JSX.Element;
+export declare const ChartBar: (props: IconProps) => JSX.Element;
+export declare const ChatCircle: (props: IconProps) => JSX.Element;
+export declare const ChatCircleDots: (props: IconProps) => JSX.Element;
+export declare const Check: (props: IconProps) => JSX.Element;
+export declare const CheckCircle: (props: IconProps) => JSX.Element;
+export declare const Circle: (props: IconProps) => JSX.Element;
+export declare const CircleNotch: (props: IconProps) => JSX.Element;
+export declare const Clock: (props: IconProps) => JSX.Element;
+export declare const ClockCounterClockwise: (props: IconProps) => JSX.Element;
+export declare const Code: (props: IconProps) => JSX.Element;
+export declare const Columns: (props: IconProps) => JSX.Element;
+export declare const Copy: (props: IconProps) => JSX.Element;
+export declare const Crown: (props: IconProps) => JSX.Element;
+export declare const Database: (props: IconProps) => JSX.Element;
+export declare const DotsThree: (props: IconProps) => JSX.Element;
+export declare const DotsThreeVertical: (props: IconProps) => JSX.Element;
+export declare const Download: (props: IconProps) => JSX.Element;
+export declare const DownloadSimple: (props: IconProps) => JSX.Element;
+export declare const File: (props: IconProps) => JSX.Element;
+export declare const FileCode: (props: IconProps) => JSX.Element;
+export declare const FileCsv: (props: IconProps) => JSX.Element;
+export declare const FileDoc: (props: IconProps) => JSX.Element;
+export declare const FileMagnifyingGlass: (props: IconProps) => JSX.Element;
+export declare const FilePdf: (props: IconProps) => JSX.Element;
+export declare const FileText: (props: IconProps) => JSX.Element;
+export declare const FileXls: (props: IconProps) => JSX.Element;
+export declare const FloppyDisk: (props: IconProps) => JSX.Element;
+export declare const Gear: (props: IconProps) => JSX.Element;
+export declare const Image: (props: IconProps) => JSX.Element;
+export declare const ImageBroken: (props: IconProps) => JSX.Element;
+export declare const Info: (props: IconProps) => JSX.Element;
+export declare const Lightbulb: (props: IconProps) => JSX.Element;
+export declare const Lightning: (props: IconProps) => JSX.Element;
+export declare const List: (props: IconProps) => JSX.Element;
+export declare const Lock: (props: IconProps) => JSX.Element;
+export declare const MagnifyingGlass: (props: IconProps) => JSX.Element;
+export declare const MagnifyingGlassMinus: (props: IconProps) => JSX.Element;
+export declare const MagnifyingGlassPlus: (props: IconProps) => JSX.Element;
+export declare const Package: (props: IconProps) => JSX.Element;
+export declare const PaperPlaneRight: (props: IconProps) => JSX.Element;
+export declare const PaperPlaneTilt: (props: IconProps) => JSX.Element;
+export declare const Paperclip: (props: IconProps) => JSX.Element;
+export declare const PencilSimple: (props: IconProps) => JSX.Element;
+export declare const PencilSimpleLine: (props: IconProps) => JSX.Element;
+export declare const Plus: (props: IconProps) => JSX.Element;
+export declare const ShareNetwork: (props: IconProps) => JSX.Element;
+export declare const Sidebar: (props: IconProps) => JSX.Element;
+export declare const Spinner: (props: IconProps) => JSX.Element;
+export declare const SpinnerGap: (props: IconProps) => JSX.Element;
+export declare const Stack: (props: IconProps) => JSX.Element;
+export declare const Stop: (props: IconProps) => JSX.Element;
+export declare const Table: (props: IconProps) => JSX.Element;
+export declare const Timer: (props: IconProps) => JSX.Element;
+export declare const Trash: (props: IconProps) => JSX.Element;
+export declare const UserPlus: (props: IconProps) => JSX.Element;
+export declare const Users: (props: IconProps) => JSX.Element;
+export declare const UsersThree: (props: IconProps) => JSX.Element;
+export declare const Warning: (props: IconProps) => JSX.Element;
+export declare const WarningCircle: (props: IconProps) => JSX.Element;
+export declare const Wrench: (props: IconProps) => JSX.Element;
+export declare const X: (props: IconProps) => JSX.Element;
+export declare const XCircle: (props: IconProps) => JSX.Element;
+export type IconComponent = Component<IconProps>;