@zendir/ui 0.1.0

package/dist/react/charts/unified/useChartStream.d.ts

@@ -0,0 +1,58 @@
+import { AstroChartHandle } from './AstroChart';
+import { TimeSeriesPoint, DataPoint } from './types';
+
+export interface StreamOptions {
+    /** Maximum data points to keep */
+    maxPoints?: number;
+    /** Time window in milliseconds (alternative to maxPoints) */
+    timeWindow?: number;
+    /** Throttle interval in milliseconds */
+    throttleMs?: number;
+    /** Buffer size before flushing */
+    bufferSize?: number;
+    /** Enable data decimation for large datasets */
+    decimate?: boolean;
+    /** Decimation threshold (start decimating above this count) */
+    decimateThreshold?: number;
+}
+export interface StreamController {
+    /** Push a single data point */
+    push: (seriesIndex: number, point: TimeSeriesPoint | DataPoint) => void;
+    /** Push multiple data points */
+    pushBatch: (seriesIndex: number, points: (TimeSeriesPoint | DataPoint)[]) => void;
+    /** Clear all data */
+    clear: () => void;
+    /** Pause streaming */
+    pause: () => void;
+    /** Resume streaming */
+    resume: () => void;
+    /** Get current state */
+    isPaused: boolean;
+    /** Get current point count */
+    pointCount: number;
+}
+export declare function useChartStream(chartRef: React.RefObject<AstroChartHandle>, options?: StreamOptions): StreamController;
+export interface WebSocketStreamOptions extends StreamOptions {
+    /** WebSocket URL */
+    url: string;
+    /** Reconnect on disconnect */
+    reconnect?: boolean;
+    /** Reconnect delay in milliseconds */
+    reconnectDelay?: number;
+    /** Maximum reconnect attempts */
+    maxReconnects?: number;
+    /** Message parser */
+    parseMessage?: (data: unknown) => {
+        seriesIndex: number;
+        point: TimeSeriesPoint | DataPoint;
+    } | null;
+}
+export interface WebSocketStreamController extends StreamController {
+    /** WebSocket connection state */
+    connectionState: 'connecting' | 'connected' | 'disconnected' | 'error';
+    /** Manually connect */
+    connect: () => void;
+    /** Manually disconnect */
+    disconnect: () => void;
+}
+export declare function useWebSocketStream(chartRef: React.RefObject<AstroChartHandle>, options: WebSocketStreamOptions): WebSocketStreamController;

package/dist/react/charts/unified/useChartStream.js

@@ -0,0 +1,226 @@
+import { useRef, useState, useCallback, useEffect } from "react";
+function useChartStream(chartRef, options = {}) {
+  const {
+    maxPoints: _maxPoints = 1e3,
+    timeWindow: _timeWindow,
+    throttleMs = 16,
+    // ~60fps
+    bufferSize = 10,
+    decimate = true,
+    decimateThreshold = 5e3
+  } = options;
+  const bufferRef = useRef(/* @__PURE__ */ new Map());
+  const lastFlushRef = useRef(0);
+  const pointCountRef = useRef(0);
+  const [isPaused, setIsPaused] = useState(false);
+  const animationFrameRef = useRef();
+  const flush = useCallback(() => {
+    const chart = chartRef.current;
+    if (!chart || isPaused) return;
+    const now = Date.now();
+    if (now - lastFlushRef.current < throttleMs) {
+      animationFrameRef.current = requestAnimationFrame(flush);
+      return;
+    }
+    bufferRef.current.forEach((points, seriesIndex) => {
+      if (points.length === 0) return;
+      let processedPoints = points;
+      if (decimate && pointCountRef.current > decimateThreshold) {
+        processedPoints = decimateData(points, Math.ceil(points.length / 2));
+      }
+      processedPoints.forEach((point) => {
+        chart.appendData(seriesIndex, point);
+      });
+      pointCountRef.current += processedPoints.length;
+    });
+    bufferRef.current.clear();
+    lastFlushRef.current = now;
+  }, [chartRef, isPaused, throttleMs, decimate, decimateThreshold]);
+  const push = useCallback((seriesIndex, point) => {
+    if (isPaused) return;
+    let buffer = bufferRef.current.get(seriesIndex);
+    if (!buffer) {
+      buffer = [];
+      bufferRef.current.set(seriesIndex, buffer);
+    }
+    buffer.push(point);
+    if (buffer.length >= bufferSize) {
+      flush();
+    } else if (!animationFrameRef.current) {
+      animationFrameRef.current = requestAnimationFrame(() => {
+        animationFrameRef.current = void 0;
+        flush();
+      });
+    }
+  }, [isPaused, bufferSize, flush]);
+  const pushBatch = useCallback((seriesIndex, points) => {
+    if (isPaused || points.length === 0) return;
+    let buffer = bufferRef.current.get(seriesIndex);
+    if (!buffer) {
+      buffer = [];
+      bufferRef.current.set(seriesIndex, buffer);
+    }
+    buffer.push(...points);
+    flush();
+  }, [isPaused, flush]);
+  const clear = useCallback(() => {
+    var _a;
+    bufferRef.current.clear();
+    pointCountRef.current = 0;
+    (_a = chartRef.current) == null ? void 0 : _a.clearData();
+  }, [chartRef]);
+  const pause = useCallback(() => setIsPaused(true), []);
+  const resume = useCallback(() => setIsPaused(false), []);
+  useEffect(() => {
+    return () => {
+      if (animationFrameRef.current) {
+        cancelAnimationFrame(animationFrameRef.current);
+      }
+    };
+  }, []);
+  return {
+    push,
+    pushBatch,
+    clear,
+    pause,
+    resume,
+    isPaused,
+    pointCount: pointCountRef.current
+  };
+}
+function decimateData(data, threshold) {
+  if (data.length <= threshold) return data;
+  const result = [];
+  const bucketSize = (data.length - 2) / (threshold - 2);
+  result.push(data[0]);
+  let a = 0;
+  for (let i = 0; i < threshold - 2; i++) {
+    const bucketStart = Math.floor((i + 1) * bucketSize) + 1;
+    const bucketEnd = Math.floor((i + 2) * bucketSize) + 1;
+    const bucketLength = Math.min(bucketEnd, data.length) - bucketStart;
+    let avgX = 0;
+    let avgY = 0;
+    const nextBucketStart = Math.floor((i + 2) * bucketSize) + 1;
+    const nextBucketEnd = Math.min(Math.floor((i + 3) * bucketSize) + 1, data.length);
+    const nextBucketLength = nextBucketEnd - nextBucketStart;
+    for (let j = nextBucketStart; j < nextBucketEnd; j++) {
+      const point = data[j];
+      const [x, y] = getPointXY(point);
+      avgX += x;
+      avgY += y;
+    }
+    avgX /= nextBucketLength || 1;
+    avgY /= nextBucketLength || 1;
+    const [aX, aY] = getPointXY(data[a]);
+    let maxArea = -1;
+    let maxIdx = bucketStart;
+    for (let j = bucketStart; j < bucketStart + bucketLength; j++) {
+      const point = data[j];
+      const [x, y] = getPointXY(point);
+      const area = Math.abs(
+        (aX - avgX) * (y - aY) - (aX - x) * (avgY - aY)
+      );
+      if (area > maxArea) {
+        maxArea = area;
+        maxIdx = j;
+      }
+    }
+    result.push(data[maxIdx]);
+    a = maxIdx;
+  }
+  result.push(data[data.length - 1]);
+  return result;
+}
+function getPointXY(point) {
+  if ("time" in point) {
+    return [
+      typeof point.time === "number" ? point.time : new Date(point.time).getTime(),
+      point.value
+    ];
+  }
+  return [
+    typeof point.x === "number" ? point.x : 0,
+    point.y
+  ];
+}
+function useWebSocketStream(chartRef, options) {
+  const {
+    url,
+    reconnect = true,
+    reconnectDelay = 1e3,
+    maxReconnects = 10,
+    parseMessage,
+    ...streamOptions
+  } = options;
+  const wsRef = useRef(null);
+  const reconnectCountRef = useRef(0);
+  const reconnectTimerRef = useRef();
+  const [connectionState, setConnectionState] = useState("disconnected");
+  const stream = useChartStream(chartRef, streamOptions);
+  const connect = useCallback(() => {
+    var _a;
+    if (((_a = wsRef.current) == null ? void 0 : _a.readyState) === WebSocket.OPEN) return;
+    setConnectionState("connecting");
+    const ws = new WebSocket(url);
+    ws.onopen = () => {
+      setConnectionState("connected");
+      reconnectCountRef.current = 0;
+    };
+    ws.onmessage = (event) => {
+      try {
+        const data = JSON.parse(event.data);
+        const parsed = parseMessage ? parseMessage(data) : defaultParseMessage(data);
+        if (parsed) {
+          stream.push(parsed.seriesIndex, parsed.point);
+        }
+      } catch (e) {
+      }
+    };
+    ws.onerror = () => {
+      setConnectionState("error");
+    };
+    ws.onclose = () => {
+      setConnectionState("disconnected");
+      if (reconnect && reconnectCountRef.current < maxReconnects) {
+        reconnectCountRef.current++;
+        reconnectTimerRef.current = setTimeout(connect, reconnectDelay * reconnectCountRef.current);
+      }
+    };
+    wsRef.current = ws;
+  }, [url, reconnect, reconnectDelay, maxReconnects, parseMessage, stream]);
+  const disconnect = useCallback(() => {
+    var _a;
+    clearTimeout(reconnectTimerRef.current);
+    (_a = wsRef.current) == null ? void 0 : _a.close();
+    wsRef.current = null;
+  }, []);
+  useEffect(() => {
+    connect();
+    return disconnect;
+  }, [connect, disconnect]);
+  return {
+    ...stream,
+    connectionState,
+    connect,
+    disconnect
+  };
+}
+function defaultParseMessage(data) {
+  if (typeof data !== "object" || data === null) return null;
+  const obj = data;
+  if ("time" in obj && "value" in obj) {
+    return {
+      seriesIndex: typeof obj.seriesIndex === "number" ? obj.seriesIndex : 0,
+      point: {
+        time: obj.time,
+        value: obj.value
+      }
+    };
+  }
+  return null;
+}
+export {
+  useChartStream,
+  useWebSocketStream
+};
+//# sourceMappingURL=useChartStream.js.map

package/dist/react/charts/unified/useChartStream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChartStream.js","sources":["../../../../src/react/charts/unified/useChartStream.ts"],"sourcesContent":["/**\n * @zendir/ui - Real-time Chart Streaming Hook\n * \n * Provides efficient real-time data streaming for charts.\n * Handles buffering, throttling, and memory management.\n */\n\nimport { useRef, useCallback, useEffect, useState } from 'react';\nimport type { AstroChartHandle } from './AstroChart';\nimport type { TimeSeriesPoint, DataPoint } from './types';\n\n// =============================================================================\n// Types\n// =============================================================================\n\nexport interface StreamOptions {\n  /** Maximum data points to keep */\n  maxPoints?: number;\n  /** Time window in milliseconds (alternative to maxPoints) */\n  timeWindow?: number;\n  /** Throttle interval in milliseconds */\n  throttleMs?: number;\n  /** Buffer size before flushing */\n  bufferSize?: number;\n  /** Enable data decimation for large datasets */\n  decimate?: boolean;\n  /** Decimation threshold (start decimating above this count) */\n  decimateThreshold?: number;\n}\n\nexport interface StreamController {\n  /** Push a single data point */\n  push: (seriesIndex: number, point: TimeSeriesPoint | DataPoint) => void;\n  /** Push multiple data points */\n  pushBatch: (seriesIndex: number, points: (TimeSeriesPoint | DataPoint)[]) => void;\n  /** Clear all data */\n  clear: () => void;\n  /** Pause streaming */\n  pause: () => void;\n  /** Resume streaming */\n  resume: () => void;\n  /** Get current state */\n  isPaused: boolean;\n  /** Get current point count */\n  pointCount: number;\n}\n\n// =============================================================================\n// Hook Implementation\n// =============================================================================\n\nexport function useChartStream(\n  chartRef: React.RefObject<AstroChartHandle>,\n  options: StreamOptions = {}\n): StreamController {\n  const {\n    maxPoints: _maxPoints = 1000,\n    timeWindow: _timeWindow,\n    throttleMs = 16, // ~60fps\n    bufferSize = 10,\n    decimate = true,\n    decimateThreshold = 5000,\n  } = options;\n\n  const bufferRef = useRef<Map<number, (TimeSeriesPoint | DataPoint)[]>>(new Map());\n  const lastFlushRef = useRef<number>(0);\n  const pointCountRef = useRef<number>(0);\n  const [isPaused, setIsPaused] = useState(false);\n  const animationFrameRef = useRef<number>();\n\n  // Flush buffer to chart\n  const flush = useCallback(() => {\n    const chart = chartRef.current;\n    if (!chart || isPaused) return;\n\n    const now = Date.now();\n    if (now - lastFlushRef.current < throttleMs) {\n      // Schedule next flush\n      animationFrameRef.current = requestAnimationFrame(flush);\n      return;\n    }\n\n    bufferRef.current.forEach((points, seriesIndex) => {\n      if (points.length === 0) return;\n\n      // Apply decimation if needed\n      let processedPoints = points;\n      if (decimate && pointCountRef.current > decimateThreshold) {\n        processedPoints = decimateData(points, Math.ceil(points.length / 2));\n      }\n\n      // Append each point\n      processedPoints.forEach(point => {\n        chart.appendData(seriesIndex, point);\n      });\n\n      pointCountRef.current += processedPoints.length;\n    });\n\n    // Clear buffer\n    bufferRef.current.clear();\n    lastFlushRef.current = now;\n  }, [chartRef, isPaused, throttleMs, decimate, decimateThreshold]);\n\n  // Push single point\n  const push = useCallback((seriesIndex: number, point: TimeSeriesPoint | DataPoint) => {\n    if (isPaused) return;\n\n    let buffer = bufferRef.current.get(seriesIndex);\n    if (!buffer) {\n      buffer = [];\n      bufferRef.current.set(seriesIndex, buffer);\n    }\n\n    buffer.push(point);\n\n    // Flush if buffer is full\n    if (buffer.length >= bufferSize) {\n      flush();\n    } else if (!animationFrameRef.current) {\n      // Schedule flush\n      animationFrameRef.current = requestAnimationFrame(() => {\n        animationFrameRef.current = undefined;\n        flush();\n      });\n    }\n  }, [isPaused, bufferSize, flush]);\n\n  // Push batch\n  const pushBatch = useCallback((seriesIndex: number, points: (TimeSeriesPoint | DataPoint)[]) => {\n    if (isPaused || points.length === 0) return;\n\n    let buffer = bufferRef.current.get(seriesIndex);\n    if (!buffer) {\n      buffer = [];\n      bufferRef.current.set(seriesIndex, buffer);\n    }\n\n    buffer.push(...points);\n    flush();\n  }, [isPaused, flush]);\n\n  // Clear all data\n  const clear = useCallback(() => {\n    bufferRef.current.clear();\n    pointCountRef.current = 0;\n    chartRef.current?.clearData();\n  }, [chartRef]);\n\n  // Pause/resume\n  const pause = useCallback(() => setIsPaused(true), []);\n  const resume = useCallback(() => setIsPaused(false), []);\n\n  // Cleanup\n  useEffect(() => {\n    return () => {\n      if (animationFrameRef.current) {\n        cancelAnimationFrame(animationFrameRef.current);\n      }\n    };\n  }, []);\n\n  return {\n    push,\n    pushBatch,\n    clear,\n    pause,\n    resume,\n    isPaused,\n    pointCount: pointCountRef.current,\n  };\n}\n\n// =============================================================================\n// Data Decimation\n// =============================================================================\n\n/**\n * Largest Triangle Three Buckets (LTTB) algorithm for data decimation\n * Preserves visual shape while reducing point count\n */\nfunction decimateData<T extends TimeSeriesPoint | DataPoint>(\n  data: T[],\n  threshold: number\n): T[] {\n  if (data.length <= threshold) return data;\n\n  const result: T[] = [];\n  const bucketSize = (data.length - 2) / (threshold - 2);\n\n  // Always include first point\n  result.push(data[0]);\n\n  let a = 0; // Previous selected point\n\n  for (let i = 0; i < threshold - 2; i++) {\n    // Calculate bucket range\n    const bucketStart = Math.floor((i + 1) * bucketSize) + 1;\n    const bucketEnd = Math.floor((i + 2) * bucketSize) + 1;\n    const bucketLength = Math.min(bucketEnd, data.length) - bucketStart;\n\n    // Calculate average point in next bucket\n    let avgX = 0;\n    let avgY = 0;\n    const nextBucketStart = Math.floor((i + 2) * bucketSize) + 1;\n    const nextBucketEnd = Math.min(Math.floor((i + 3) * bucketSize) + 1, data.length);\n    const nextBucketLength = nextBucketEnd - nextBucketStart;\n\n    for (let j = nextBucketStart; j < nextBucketEnd; j++) {\n      const point = data[j];\n      const [x, y] = getPointXY(point);\n      avgX += x;\n      avgY += y;\n    }\n    avgX /= nextBucketLength || 1;\n    avgY /= nextBucketLength || 1;\n\n    // Find point with largest triangle area\n    const [aX, aY] = getPointXY(data[a]);\n    let maxArea = -1;\n    let maxIdx = bucketStart;\n\n    for (let j = bucketStart; j < bucketStart + bucketLength; j++) {\n      const point = data[j];\n      const [x, y] = getPointXY(point);\n      \n      // Triangle area\n      const area = Math.abs(\n        (aX - avgX) * (y - aY) - (aX - x) * (avgY - aY)\n      );\n\n      if (area > maxArea) {\n        maxArea = area;\n        maxIdx = j;\n      }\n    }\n\n    result.push(data[maxIdx]);\n    a = maxIdx;\n  }\n\n  // Always include last point\n  result.push(data[data.length - 1]);\n\n  return result;\n}\n\nfunction getPointXY(point: TimeSeriesPoint | DataPoint): [number, number] {\n  if ('time' in point) {\n    return [\n      typeof point.time === 'number' ? point.time : new Date(point.time).getTime(),\n      point.value,\n    ];\n  }\n  return [\n    typeof point.x === 'number' ? point.x : 0,\n    point.y,\n  ];\n}\n\n// =============================================================================\n// WebSocket Stream Hook\n// =============================================================================\n\nexport interface WebSocketStreamOptions extends StreamOptions {\n  /** WebSocket URL */\n  url: string;\n  /** Reconnect on disconnect */\n  reconnect?: boolean;\n  /** Reconnect delay in milliseconds */\n  reconnectDelay?: number;\n  /** Maximum reconnect attempts */\n  maxReconnects?: number;\n  /** Message parser */\n  parseMessage?: (data: unknown) => { seriesIndex: number; point: TimeSeriesPoint | DataPoint } | null;\n}\n\nexport interface WebSocketStreamController extends StreamController {\n  /** WebSocket connection state */\n  connectionState: 'connecting' | 'connected' | 'disconnected' | 'error';\n  /** Manually connect */\n  connect: () => void;\n  /** Manually disconnect */\n  disconnect: () => void;\n}\n\nexport function useWebSocketStream(\n  chartRef: React.RefObject<AstroChartHandle>,\n  options: WebSocketStreamOptions\n): WebSocketStreamController {\n  const {\n    url,\n    reconnect = true,\n    reconnectDelay = 1000,\n    maxReconnects = 10,\n    parseMessage,\n    ...streamOptions\n  } = options;\n\n  const wsRef = useRef<WebSocket | null>(null);\n  const reconnectCountRef = useRef(0);\n  const reconnectTimerRef = useRef<ReturnType<typeof setTimeout>>();\n  const [connectionState, setConnectionState] = useState<WebSocketStreamController['connectionState']>('disconnected');\n  \n  const stream = useChartStream(chartRef, streamOptions);\n\n  const connect = useCallback(() => {\n    if (wsRef.current?.readyState === WebSocket.OPEN) return;\n\n    setConnectionState('connecting');\n    const ws = new WebSocket(url);\n\n    ws.onopen = () => {\n      setConnectionState('connected');\n      reconnectCountRef.current = 0;\n    };\n\n    ws.onmessage = (event) => {\n      try {\n        const data = JSON.parse(event.data);\n        const parsed = parseMessage \n          ? parseMessage(data) \n          : defaultParseMessage(data);\n        \n        if (parsed) {\n          stream.push(parsed.seriesIndex, parsed.point);\n        }\n      } catch (e) {\n        if (import.meta.env.DEV) {\n          console.error('Failed to parse WebSocket message:', e);\n        }\n      }\n    };\n\n    ws.onerror = () => {\n      setConnectionState('error');\n    };\n\n    ws.onclose = () => {\n      setConnectionState('disconnected');\n      \n      if (reconnect && reconnectCountRef.current < maxReconnects) {\n        reconnectCountRef.current++;\n        reconnectTimerRef.current = setTimeout(connect, reconnectDelay * reconnectCountRef.current);\n      }\n    };\n\n    wsRef.current = ws;\n  }, [url, reconnect, reconnectDelay, maxReconnects, parseMessage, stream]);\n\n  const disconnect = useCallback(() => {\n    clearTimeout(reconnectTimerRef.current);\n    wsRef.current?.close();\n    wsRef.current = null;\n  }, []);\n\n  // Auto-connect on mount\n  useEffect(() => {\n    connect();\n    return disconnect;\n  }, [connect, disconnect]);\n\n  return {\n    ...stream,\n    connectionState,\n    connect,\n    disconnect,\n  };\n}\n\nfunction defaultParseMessage(data: unknown): { seriesIndex: number; point: TimeSeriesPoint } | null {\n  if (typeof data !== 'object' || data === null) return null;\n  \n  const obj = data as Record<string, unknown>;\n  \n  if ('time' in obj && 'value' in obj) {\n    return {\n      seriesIndex: typeof obj.seriesIndex === 'number' ? obj.seriesIndex : 0,\n      point: {\n        time: obj.time as number,\n        value: obj.value as number,\n      },\n    };\n  }\n  \n  return null;\n}\n"],"names":[],"mappings":"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"}

package/dist/react/chatgpt/AppCard.d.ts

@@ -0,0 +1,59 @@
+import { default as React, ReactNode } from 'react';
+import { StatusLevel } from '../utils';
+
+export interface AppCardProps {
+    /** Card content */
+    children: ReactNode;
+    /** Card title */
+    title?: string;
+    /** Subtitle or description */
+    subtitle?: string;
+    /**
+     * Status badge with Astro UX dual-coded indicator (color + shape).
+     *
+     * Supports both the Astro UX `StatusLevel` and legacy variants:
+     * - Astro UX: `{ level: 'normal' | 'standby' | 'caution' | 'serious' | 'critical' | 'off', label: '...' }`
+     * - Legacy:   `{ variant: 'success' | 'warning' | 'error' | 'info' | 'neutral', label: '...' }`
+     */
+    status?: {
+        label: string;
+        level?: StatusLevel;
+        /** @deprecated Use `level` (Astro UX StatusLevel) instead. Still supported for backward compatibility. */
+        variant?: 'success' | 'warning' | 'error' | 'info' | 'neutral';
+    };
+    /** Show fullscreen button (only rendered inside ChatGPT host) */
+    allowFullscreen?: boolean;
+    /** Callback when fullscreen is toggled */
+    onFullscreenChange?: (isFullscreen: boolean) => void;
+    /** Additional CSS classes */
+    className?: string;
+    /** Enable compact mode (reduced padding and font sizes) */
+    compact?: boolean;
+    /** Header icon (ReactNode, rendered before title) */
+    icon?: ReactNode;
+    /** Footer content (rendered below content with a divider) */
+    footer?: ReactNode;
+    /** Actions (buttons) rendered in the header, right-aligned */
+    actions?: ReactNode;
+    /** Show a loading skeleton over the content area */
+    loading?: boolean;
+    /** Error state — renders an error message with a critical alert */
+    error?: string | Error;
+    /** Retry callback (shown when `error` is set) */
+    onRetry?: () => void;
+    /** Custom inline styles for the root container */
+    style?: React.CSSProperties;
+}
+/**
+ * AppCard — enterprise-ready widget wrapper for AI host environments.
+ *
+ * Works with ChatGPT Apps, Anthropic MCP Apps, Google Gemini, or any MCP host.
+ * Wrapped in an error boundary so rendering failures in child components never
+ * crash the host application — critical for sandboxed iframes.
+ */
+export declare const AppCard: React.FC<AppCardProps>;
+/** @deprecated Use `AppCard` instead. Alias kept for backward compatibility. */
+export declare const ChatGPTCard: React.FC<AppCardProps>;
+/** @deprecated Use `AppCardProps` instead. */
+export type ChatGPTCardProps = AppCardProps;
+export default AppCard;