@zendir/ui 0.1.0

package/dist/react/chatgpt/AppCard.js

@@ -0,0 +1,306 @@
+import { jsx, jsxs } from "react/jsx-runtime";
+import { Component, useRef } from "react";
+import { useChatGPTTheme, useDisplayMode, useMaxHeight, isInChatGPT } from "./index.js";
+import { FONT_FAMILY_PRIMARY } from "../core/Typography.js";
+const STATUS_COLORS_INTERNAL = {
+  off: "#a4abb6",
+  standby: "#2dccff",
+  normal: "#56f000",
+  caution: "#fce83a",
+  serious: "#ffb302",
+  critical: "#ff3838"
+};
+function StatusShape({ status, size = 10 }) {
+  const color = STATUS_COLORS_INTERNAL[status] ?? STATUS_COLORS_INTERNAL.off;
+  const glow = `${color}50`;
+  switch (status) {
+    case "caution":
+      return /* @__PURE__ */ jsx("svg", { viewBox: "0 0 12 12", width: size, height: size, style: { filter: `drop-shadow(0 0 3px ${glow})` }, "aria-hidden": "true", children: /* @__PURE__ */ jsx("rect", { x: "1", y: "1", width: "10", height: "10", fill: color }) });
+    case "serious":
+      return /* @__PURE__ */ jsx("svg", { viewBox: "0 0 12 12", width: size, height: size, style: { filter: `drop-shadow(0 0 3px ${glow})` }, "aria-hidden": "true", children: /* @__PURE__ */ jsx("polygon", { points: "6,1 11,6 6,11 1,6", fill: color }) });
+    case "critical":
+      return /* @__PURE__ */ jsx("svg", { viewBox: "0 0 12 12", width: size, height: size, style: { filter: `drop-shadow(0 0 3px ${glow})` }, "aria-hidden": "true", children: /* @__PURE__ */ jsx("polygon", { points: "6,11 1,2 11,2", fill: color }) });
+    case "standby":
+      return /* @__PURE__ */ jsx("svg", { viewBox: "0 0 12 12", width: size, height: size, style: { filter: `drop-shadow(0 0 3px ${glow})` }, "aria-hidden": "true", children: /* @__PURE__ */ jsx("circle", { cx: "6", cy: "6", r: "3.5", fill: "none", stroke: color, strokeWidth: "2" }) });
+    case "off":
+      return /* @__PURE__ */ jsx("svg", { viewBox: "0 0 12 12", width: size, height: size, style: { filter: `drop-shadow(0 0 3px ${glow})` }, "aria-hidden": "true", children: /* @__PURE__ */ jsx("circle", { cx: "6", cy: "6", r: "3", fill: color }) });
+    default:
+      return /* @__PURE__ */ jsx("svg", { viewBox: "0 0 12 12", width: size, height: size, style: { filter: `drop-shadow(0 0 3px ${glow})` }, "aria-hidden": "true", children: /* @__PURE__ */ jsx("circle", { cx: "6", cy: "6", r: "5", fill: color }) });
+  }
+}
+const LEGACY_VARIANT_MAP = {
+  success: "normal",
+  warning: "caution",
+  error: "critical",
+  info: "standby",
+  neutral: "off"
+};
+function resolveStatusLevel(input) {
+  if (["off", "standby", "normal", "caution", "serious", "critical"].includes(input)) {
+    return input;
+  }
+  return LEGACY_VARIANT_MAP[input] ?? "off";
+}
+class CardErrorBoundary extends Component {
+  constructor(props) {
+    super(props);
+    this.state = { hasError: false };
+  }
+  static getDerivedStateFromError(error) {
+    return { hasError: true, error };
+  }
+  render() {
+    var _a;
+    if (this.state.hasError) {
+      return /* @__PURE__ */ jsxs(
+        "div",
+        {
+          style: {
+            padding: "16px",
+            borderRadius: "12px",
+            background: "rgba(255, 56, 56, 0.08)",
+            border: "1px solid rgba(255, 56, 56, 0.3)",
+            fontFamily: FONT_FAMILY_PRIMARY,
+            color: "#ff8a8a"
+            // WCAG AA: lighter red for readable text on dark error background
+          },
+          role: "alert",
+          children: [
+            /* @__PURE__ */ jsxs("div", { style: { display: "flex", alignItems: "center", gap: "8px", marginBottom: "8px" }, children: [
+              /* @__PURE__ */ jsx(StatusShape, { status: "critical", size: 12 }),
+              /* @__PURE__ */ jsxs("strong", { style: { fontSize: "0.875rem" }, children: [
+                this.props.componentName ?? "Widget",
+                " Error"
+              ] })
+            ] }),
+            /* @__PURE__ */ jsx("p", { style: { margin: 0, fontSize: "0.75rem", opacity: 0.8 }, children: ((_a = this.state.error) == null ? void 0 : _a.message) ?? "An unexpected error occurred." })
+          ]
+        }
+      );
+    }
+    return this.props.children;
+  }
+}
+function LoadingSkeleton({ compact, isDark }) {
+  const bar = (w, h = 12) => ({
+    width: w,
+    height: h,
+    borderRadius: 4,
+    background: isDark ? "rgba(255,255,255,0.06)" : "rgba(0,0,0,0.06)",
+    animation: "chatgpt-card-pulse 1.5s ease-in-out infinite"
+  });
+  return /* @__PURE__ */ jsxs("div", { style: { display: "flex", flexDirection: "column", gap: compact ? 8 : 12 }, "aria-label": "Loading...", role: "status", children: [
+    /* @__PURE__ */ jsx("div", { style: bar("70%", 14) }),
+    /* @__PURE__ */ jsx("div", { style: bar("100%") }),
+    /* @__PURE__ */ jsx("div", { style: bar("85%") }),
+    /* @__PURE__ */ jsx("div", { style: bar("60%") }),
+    /* @__PURE__ */ jsx("style", { children: `@keyframes chatgpt-card-pulse { 0%,100% { opacity: 0.4 } 50% { opacity: 1 } }` })
+  ] });
+}
+function ErrorDisplay({ error, onRetry, isDark }) {
+  const message = typeof error === "string" ? error : error.message;
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      role: "alert",
+      style: {
+        display: "flex",
+        flexDirection: "column",
+        gap: 8,
+        padding: "12px",
+        borderRadius: 8,
+        background: "rgba(255, 56, 56, 0.08)",
+        border: "1px solid rgba(255, 56, 56, 0.2)"
+      },
+      children: [
+        /* @__PURE__ */ jsxs("div", { style: { display: "flex", alignItems: "center", gap: 6 }, children: [
+          /* @__PURE__ */ jsx(StatusShape, { status: "critical", size: 12 }),
+          /* @__PURE__ */ jsx("span", { style: { fontSize: "0.75rem", fontWeight: 500, color: "#ff8a8a" }, children: message })
+        ] }),
+        onRetry && /* @__PURE__ */ jsx(
+          "button",
+          {
+            onClick: onRetry,
+            style: {
+              alignSelf: "flex-start",
+              padding: "4px 12px",
+              borderRadius: 4,
+              border: `1px solid ${isDark ? "rgba(255,255,255,0.15)" : "rgba(0,0,0,0.15)"}`,
+              background: "transparent",
+              color: isDark ? "#a1a1aa" : "#636370",
+              // WCAG AA compliant on light backgrounds
+              cursor: "pointer",
+              fontSize: "0.6875rem",
+              fontFamily: FONT_FAMILY_PRIMARY
+            },
+            "aria-label": "Retry loading widget",
+            children: "Retry"
+          }
+        )
+      ]
+    }
+  );
+}
+const AppCardInner = ({
+  children,
+  title,
+  subtitle,
+  status,
+  allowFullscreen = false,
+  onFullscreenChange,
+  className = "",
+  compact = false,
+  icon,
+  footer,
+  actions,
+  loading = false,
+  error,
+  onRetry,
+  style
+}) => {
+  const containerRef = useRef(null);
+  const { isDark, colors } = useChatGPTTheme();
+  const { mode, requestMode } = useDisplayMode();
+  const maxHeight = useMaxHeight();
+  const resolvedStatus = status ? resolveStatusLevel(status.level ?? status.variant ?? "off") : void 0;
+  const statusColor = resolvedStatus ? STATUS_COLORS_INTERNAL[resolvedStatus] : void 0;
+  const toggleFullscreen = async () => {
+    const newMode = mode === "fullscreen" ? "inline" : "fullscreen";
+    await requestMode(newMode);
+    onFullscreenChange == null ? void 0 : onFullscreenChange(newMode === "fullscreen");
+  };
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      ref: containerRef,
+      className: `chatgpt-card ${className}`,
+      role: "region",
+      "aria-label": title ?? "Widget",
+      style: {
+        background: colors.surface,
+        border: `1px solid ${colors.border}`,
+        borderRadius: "12px",
+        padding: compact ? "12px" : "16px",
+        fontFamily: FONT_FAMILY_PRIMARY,
+        color: colors.text,
+        transition: "all 0.2s ease",
+        ...maxHeight ? { maxHeight, overflow: "auto" } : {},
+        ...style
+      },
+      children: [
+        (title || status || allowFullscreen || actions) && /* @__PURE__ */ jsxs(
+          "div",
+          {
+            style: {
+              display: "flex",
+              alignItems: "flex-start",
+              justifyContent: "space-between",
+              marginBottom: compact ? "8px" : "12px"
+            },
+            children: [
+              /* @__PURE__ */ jsxs("div", { style: { display: "flex", alignItems: "center", gap: "8px", minWidth: 0 }, children: [
+                icon && /* @__PURE__ */ jsx("span", { style: { fontSize: compact ? "16px" : "20px", flexShrink: 0 }, children: icon }),
+                /* @__PURE__ */ jsxs("div", { style: { minWidth: 0 }, children: [
+                  title && /* @__PURE__ */ jsx(
+                    "h3",
+                    {
+                      style: {
+                        margin: 0,
+                        fontSize: compact ? "0.8125rem" : "0.875rem",
+                        fontWeight: 500,
+                        color: colors.text,
+                        whiteSpace: "nowrap",
+                        overflow: "hidden",
+                        textOverflow: "ellipsis"
+                      },
+                      children: title
+                    }
+                  ),
+                  subtitle && /* @__PURE__ */ jsx(
+                    "p",
+                    {
+                      style: {
+                        margin: "2px 0 0 0",
+                        fontSize: "0.6875rem",
+                        color: colors.textMuted,
+                        whiteSpace: "nowrap",
+                        overflow: "hidden",
+                        textOverflow: "ellipsis"
+                      },
+                      children: subtitle
+                    }
+                  )
+                ] })
+              ] }),
+              /* @__PURE__ */ jsxs("div", { style: { display: "flex", alignItems: "center", gap: "8px", flexShrink: 0 }, children: [
+                actions,
+                status && resolvedStatus && statusColor && /* @__PURE__ */ jsxs(
+                  "span",
+                  {
+                    role: "status",
+                    "aria-label": `Status: ${status.label} (${resolvedStatus})`,
+                    style: {
+                      display: "inline-flex",
+                      alignItems: "center",
+                      gap: "4px",
+                      fontSize: "0.5625rem",
+                      fontWeight: 500,
+                      letterSpacing: "0.5px",
+                      padding: "2px 8px 2px 4px",
+                      borderRadius: "4px",
+                      background: `${statusColor}18`,
+                      color: statusColor,
+                      whiteSpace: "nowrap"
+                    },
+                    children: [
+                      /* @__PURE__ */ jsx(StatusShape, { status: resolvedStatus, size: 8 }),
+                      status.label
+                    ]
+                  }
+                ),
+                allowFullscreen && isInChatGPT() && /* @__PURE__ */ jsx(
+                  "button",
+                  {
+                    onClick: toggleFullscreen,
+                    "aria-label": mode === "fullscreen" ? "Exit fullscreen" : "Enter fullscreen",
+                    style: {
+                      background: "transparent",
+                      border: "none",
+                      cursor: "pointer",
+                      fontSize: "14px",
+                      opacity: 0.6,
+                      padding: "4px",
+                      color: colors.text,
+                      borderRadius: "4px",
+                      lineHeight: 1
+                    },
+                    children: mode === "fullscreen" ? "⤓" : "⤢"
+                  }
+                )
+              ] })
+            ]
+          }
+        ),
+        /* @__PURE__ */ jsx("div", { children: loading ? /* @__PURE__ */ jsx(LoadingSkeleton, { compact, isDark }) : error ? /* @__PURE__ */ jsx(ErrorDisplay, { error, onRetry, isDark }) : children }),
+        footer && !loading && !error && /* @__PURE__ */ jsx(
+          "div",
+          {
+            style: {
+              marginTop: compact ? "8px" : "12px",
+              paddingTop: compact ? "8px" : "12px",
+              borderTop: `1px solid ${colors.border}`
+            },
+            children: footer
+          }
+        )
+      ]
+    }
+  );
+};
+const AppCard = (props) => /* @__PURE__ */ jsx(CardErrorBoundary, { componentName: props.title ?? "AppCard", children: /* @__PURE__ */ jsx(AppCardInner, { ...props }) });
+const ChatGPTCard = AppCard;
+export {
+  AppCard,
+  ChatGPTCard
+};
+//# sourceMappingURL=AppCard.js.map

package/dist/react/chatgpt/AppCard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppCard.js","sources":["../../../src/react/chatgpt/AppCard.tsx"],"sourcesContent":["/**\n * AppCard — Universal widget wrapper for AI host environments.\n *\n * Works with: ChatGPT Apps, Anthropic MCP Apps, Google Gemini, any MCP-compatible host.\n *\n * Features:\n * - Theme-aware styling (light/dark via host environment)\n * - Astro UX 6-level status system with dual-coded indicators (color + shape)\n * - Error boundary protection with graceful fallback UI\n * - Loading and error state management\n * - Display mode support (inline/PiP/fullscreen)\n * - Widget state persistence\n * - WCAG 2.1 AA accessibility (ARIA labels, keyboard nav, screen readers)\n *\n * @example\n * ```tsx\n * import { AppCard, useToolOutput } from '@zendir/ui/react';\n *\n * function SatelliteWidget() {\n *   const data = useToolOutput<SatelliteHealth>();\n *   return (\n *     <AppCard\n *       title=\"SAT-001\"\n *       subtitle=\"Health Monitor\"\n *       status={{ level: 'caution', label: 'Battery Low' }}\n *       allowFullscreen\n *     >\n *       <TelemetryCard data={data} />\n *     </AppCard>\n *   );\n * }\n * ```\n */\n\nimport React, { useRef, ReactNode, Component } from 'react';\nimport { useChatGPTTheme, useMaxHeight, useDisplayMode, isInChatGPT } from './index';\nimport { FONT_FAMILY_PRIMARY } from '../core/Typography';\nimport type { StatusLevel } from '../utils';\n\n// ─── Status shape helper (matches ChatPanel & Astro UX components) ───────────\n\nconst STATUS_COLORS_INTERNAL: Record<StatusLevel, string> = {\n  off: '#a4abb6',\n  standby: '#2dccff',\n  normal: '#56f000',\n  caution: '#fce83a',\n  serious: '#ffb302',\n  critical: '#ff3838',\n};\n\nfunction StatusShape({ status, size = 10 }: { status: StatusLevel; size?: number }) {\n  const color = STATUS_COLORS_INTERNAL[status] ?? STATUS_COLORS_INTERNAL.off;\n  const glow = `${color}50`;\n  switch (status) {\n    case 'caution':\n      return <svg viewBox=\"0 0 12 12\" width={size} height={size} style={{ filter: `drop-shadow(0 0 3px ${glow})` }} aria-hidden=\"true\"><rect x=\"1\" y=\"1\" width=\"10\" height=\"10\" fill={color} /></svg>;\n    case 'serious':\n      return <svg viewBox=\"0 0 12 12\" width={size} height={size} style={{ filter: `drop-shadow(0 0 3px ${glow})` }} aria-hidden=\"true\"><polygon points=\"6,1 11,6 6,11 1,6\" fill={color} /></svg>;\n    case 'critical':\n      return <svg viewBox=\"0 0 12 12\" width={size} height={size} style={{ filter: `drop-shadow(0 0 3px ${glow})` }} aria-hidden=\"true\"><polygon points=\"6,11 1,2 11,2\" fill={color} /></svg>;\n    case 'standby':\n      return <svg viewBox=\"0 0 12 12\" width={size} height={size} style={{ filter: `drop-shadow(0 0 3px ${glow})` }} aria-hidden=\"true\"><circle cx=\"6\" cy=\"6\" r=\"3.5\" fill=\"none\" stroke={color} strokeWidth=\"2\" /></svg>;\n    case 'off':\n      return <svg viewBox=\"0 0 12 12\" width={size} height={size} style={{ filter: `drop-shadow(0 0 3px ${glow})` }} aria-hidden=\"true\"><circle cx=\"6\" cy=\"6\" r=\"3\" fill={color} /></svg>;\n    default: // normal\n      return <svg viewBox=\"0 0 12 12\" width={size} height={size} style={{ filter: `drop-shadow(0 0 3px ${glow})` }} aria-hidden=\"true\"><circle cx=\"6\" cy=\"6\" r=\"5\" fill={color} /></svg>;\n  }\n}\n\n// ─── Legacy status mapping (for backward compatibility) ──────────────────────\n\n/**\n * Maps legacy variant strings to Astro UX StatusLevel.\n * Supports both new `StatusLevel` and old `success/warning/error/info/neutral` variants.\n */\nconst LEGACY_VARIANT_MAP: Record<string, StatusLevel> = {\n  success: 'normal',\n  warning: 'caution',\n  error: 'critical',\n  info: 'standby',\n  neutral: 'off',\n};\n\nfunction resolveStatusLevel(input: string): StatusLevel {\n  if (['off', 'standby', 'normal', 'caution', 'serious', 'critical'].includes(input)) {\n    return input as StatusLevel;\n  }\n  return LEGACY_VARIANT_MAP[input] ?? 'off';\n}\n\n// ─── Error Boundary ──────────────────────────────────────────────────────────\n\ninterface CardErrorBoundaryState {\n  hasError: boolean;\n  error?: Error;\n}\n\nclass CardErrorBoundary extends Component<\n  { children: ReactNode; componentName?: string },\n  CardErrorBoundaryState\n> {\n  constructor(props: { children: ReactNode; componentName?: string }) {\n    super(props);\n    this.state = { hasError: false };\n  }\n\n  static getDerivedStateFromError(error: Error): CardErrorBoundaryState {\n    return { hasError: true, error };\n  }\n\n  render() {\n    if (this.state.hasError) {\n      return (\n        <div\n          style={{\n            padding: '16px',\n            borderRadius: '12px',\n            background: 'rgba(255, 56, 56, 0.08)',\n            border: '1px solid rgba(255, 56, 56, 0.3)',\n            fontFamily: FONT_FAMILY_PRIMARY,\n            color: '#ff8a8a',  // WCAG AA: lighter red for readable text on dark error background\n          }}\n          role=\"alert\"\n        >\n          <div style={{ display: 'flex', alignItems: 'center', gap: '8px', marginBottom: '8px' }}>\n            <StatusShape status=\"critical\" size={12} />\n            <strong style={{ fontSize: '0.875rem' }}>\n              {this.props.componentName ?? 'Widget'} Error\n            </strong>\n          </div>\n          <p style={{ margin: 0, fontSize: '0.75rem', opacity: 0.8 }}>\n            {this.state.error?.message ?? 'An unexpected error occurred.'}\n          </p>\n        </div>\n      );\n    }\n    return this.props.children;\n  }\n}\n\n// ─── Types ───────────────────────────────────────────────────────────────────\n\nexport interface AppCardProps {\n  /** Card content */\n  children: ReactNode;\n  /** Card title */\n  title?: string;\n  /** Subtitle or description */\n  subtitle?: string;\n  /**\n   * Status badge with Astro UX dual-coded indicator (color + shape).\n   *\n   * Supports both the Astro UX `StatusLevel` and legacy variants:\n   * - Astro UX: `{ level: 'normal' | 'standby' | 'caution' | 'serious' | 'critical' | 'off', label: '...' }`\n   * - Legacy:   `{ variant: 'success' | 'warning' | 'error' | 'info' | 'neutral', label: '...' }`\n   */\n  status?: {\n    label: string;\n    level?: StatusLevel;\n    /** @deprecated Use `level` (Astro UX StatusLevel) instead. Still supported for backward compatibility. */\n    variant?: 'success' | 'warning' | 'error' | 'info' | 'neutral';\n  };\n  /** Show fullscreen button (only rendered inside ChatGPT host) */\n  allowFullscreen?: boolean;\n  /** Callback when fullscreen is toggled */\n  onFullscreenChange?: (isFullscreen: boolean) => void;\n  /** Additional CSS classes */\n  className?: string;\n  /** Enable compact mode (reduced padding and font sizes) */\n  compact?: boolean;\n  /** Header icon (ReactNode, rendered before title) */\n  icon?: ReactNode;\n  /** Footer content (rendered below content with a divider) */\n  footer?: ReactNode;\n  /** Actions (buttons) rendered in the header, right-aligned */\n  actions?: ReactNode;\n  /** Show a loading skeleton over the content area */\n  loading?: boolean;\n  /** Error state — renders an error message with a critical alert */\n  error?: string | Error;\n  /** Retry callback (shown when `error` is set) */\n  onRetry?: () => void;\n  /** Custom inline styles for the root container */\n  style?: React.CSSProperties;\n}\n\n// ─── Loading Skeleton ────────────────────────────────────────────────────────\n\nfunction LoadingSkeleton({ compact, isDark }: { compact: boolean; isDark: boolean }) {\n  const bar = (w: string, h = 12) => ({\n    width: w,\n    height: h,\n    borderRadius: 4,\n    background: isDark ? 'rgba(255,255,255,0.06)' : 'rgba(0,0,0,0.06)',\n    animation: 'chatgpt-card-pulse 1.5s ease-in-out infinite',\n  });\n\n  return (\n    <div style={{ display: 'flex', flexDirection: 'column', gap: compact ? 8 : 12 }} aria-label=\"Loading...\" role=\"status\">\n      <div style={bar('70%', 14)} />\n      <div style={bar('100%')} />\n      <div style={bar('85%')} />\n      <div style={bar('60%')} />\n      <style>{`@keyframes chatgpt-card-pulse { 0%,100% { opacity: 0.4 } 50% { opacity: 1 } }`}</style>\n    </div>\n  );\n}\n\n// ─── Error Display ───────────────────────────────────────────────────────────\n\nfunction ErrorDisplay({ error, onRetry, isDark }: { error: string | Error; onRetry?: () => void; isDark: boolean }) {\n  const message = typeof error === 'string' ? error : error.message;\n  return (\n    <div\n      role=\"alert\"\n      style={{\n        display: 'flex',\n        flexDirection: 'column',\n        gap: 8,\n        padding: '12px',\n        borderRadius: 8,\n        background: 'rgba(255, 56, 56, 0.08)',\n        border: '1px solid rgba(255, 56, 56, 0.2)',\n      }}\n    >\n      <div style={{ display: 'flex', alignItems: 'center', gap: 6 }}>\n        <StatusShape status=\"critical\" size={12} />\n        <span style={{ fontSize: '0.75rem', fontWeight: 500, color: '#ff8a8a' }}>{message}</span>\n      </div>\n      {onRetry && (\n        <button\n          onClick={onRetry}\n          style={{\n            alignSelf: 'flex-start',\n            padding: '4px 12px',\n            borderRadius: 4,\n            border: `1px solid ${isDark ? 'rgba(255,255,255,0.15)' : 'rgba(0,0,0,0.15)'}`,\n            background: 'transparent',\n            color: isDark ? '#a1a1aa' : '#636370',  // WCAG AA compliant on light backgrounds\n            cursor: 'pointer',\n            fontSize: '0.6875rem',\n            fontFamily: FONT_FAMILY_PRIMARY,\n          }}\n          aria-label=\"Retry loading widget\"\n        >\n          Retry\n        </button>\n      )}\n    </div>\n  );\n}\n\n// ─── Main Component ──────────────────────────────────────────────────────────\n\nconst AppCardInner: React.FC<AppCardProps> = ({\n  children,\n  title,\n  subtitle,\n  status,\n  allowFullscreen = false,\n  onFullscreenChange,\n  className = '',\n  compact = false,\n  icon,\n  footer,\n  actions,\n  loading = false,\n  error,\n  onRetry,\n  style,\n}) => {\n  const containerRef = useRef<HTMLDivElement>(null);\n  const { isDark, colors } = useChatGPTTheme();\n  const { mode, requestMode } = useDisplayMode();\n  const maxHeight = useMaxHeight();\n\n  // Resolve status level (supports both Astro UX and legacy variants)\n  const resolvedStatus = status\n    ? resolveStatusLevel(status.level ?? status.variant ?? 'off')\n    : undefined;\n  const statusColor = resolvedStatus ? STATUS_COLORS_INTERNAL[resolvedStatus] : undefined;\n\n  // Handle fullscreen toggle\n  const toggleFullscreen = async () => {\n    const newMode = mode === 'fullscreen' ? 'inline' : 'fullscreen';\n    await requestMode(newMode);\n    onFullscreenChange?.(newMode === 'fullscreen');\n  };\n\n  return (\n    <div\n      ref={containerRef}\n      className={`chatgpt-card ${className}`}\n      role=\"region\"\n      aria-label={title ?? 'Widget'}\n      style={{\n        background: colors.surface,\n        border: `1px solid ${colors.border}`,\n        borderRadius: '12px',\n        padding: compact ? '12px' : '16px',\n        fontFamily: FONT_FAMILY_PRIMARY,\n        color: colors.text,\n        transition: 'all 0.2s ease',\n        ...(maxHeight ? { maxHeight, overflow: 'auto' } : {}),\n        ...style,\n      }}\n    >\n      {/* Header */}\n      {(title || status || allowFullscreen || actions) && (\n        <div\n          style={{\n            display: 'flex',\n            alignItems: 'flex-start',\n            justifyContent: 'space-between',\n            marginBottom: compact ? '8px' : '12px',\n          }}\n        >\n          <div style={{ display: 'flex', alignItems: 'center', gap: '8px', minWidth: 0 }}>\n            {icon && <span style={{ fontSize: compact ? '16px' : '20px', flexShrink: 0 }}>{icon}</span>}\n            <div style={{ minWidth: 0 }}>\n              {title && (\n                <h3\n                  style={{\n                    margin: 0,\n                    fontSize: compact ? '0.8125rem' : '0.875rem',\n                    fontWeight: 500,\n                    color: colors.text,\n                    whiteSpace: 'nowrap',\n                    overflow: 'hidden',\n                    textOverflow: 'ellipsis',\n                  }}\n                >\n                  {title}\n                </h3>\n              )}\n              {subtitle && (\n                <p\n                  style={{\n                    margin: '2px 0 0 0',\n                    fontSize: '0.6875rem',\n                    color: colors.textMuted,\n                    whiteSpace: 'nowrap',\n                    overflow: 'hidden',\n                    textOverflow: 'ellipsis',\n                  }}\n                >\n                  {subtitle}\n                </p>\n              )}\n            </div>\n          </div>\n\n          <div style={{ display: 'flex', alignItems: 'center', gap: '8px', flexShrink: 0 }}>\n            {actions}\n\n            {status && resolvedStatus && statusColor && (\n              <span\n                role=\"status\"\n                aria-label={`Status: ${status.label} (${resolvedStatus})`}\n                style={{\n                  display: 'inline-flex',\n                  alignItems: 'center',\n                  gap: '4px',\n                  fontSize: '0.5625rem',\n                  fontWeight: 500,\n                  letterSpacing: '0.5px',\n                  padding: '2px 8px 2px 4px',\n                  borderRadius: '4px',\n                  background: `${statusColor}18`,\n                  color: statusColor,\n                  whiteSpace: 'nowrap',\n                }}\n              >\n                <StatusShape status={resolvedStatus} size={8} />\n                {status.label}\n              </span>\n            )}\n\n            {allowFullscreen && isInChatGPT() && (\n              <button\n                onClick={toggleFullscreen}\n                aria-label={mode === 'fullscreen' ? 'Exit fullscreen' : 'Enter fullscreen'}\n                style={{\n                  background: 'transparent',\n                  border: 'none',\n                  cursor: 'pointer',\n                  fontSize: '14px',\n                  opacity: 0.6,\n                  padding: '4px',\n                  color: colors.text,\n                  borderRadius: '4px',\n                  lineHeight: 1,\n                }}\n              >\n                {mode === 'fullscreen' ? '⤓' : '⤢'}\n              </button>\n            )}\n          </div>\n        </div>\n      )}\n\n      {/* Content: loading → error → children */}\n      <div>\n        {loading ? (\n          <LoadingSkeleton compact={compact} isDark={isDark} />\n        ) : error ? (\n          <ErrorDisplay error={error} onRetry={onRetry} isDark={isDark} />\n        ) : (\n          children\n        )}\n      </div>\n\n      {/* Footer */}\n      {footer && !loading && !error && (\n        <div\n          style={{\n            marginTop: compact ? '8px' : '12px',\n            paddingTop: compact ? '8px' : '12px',\n            borderTop: `1px solid ${colors.border}`,\n          }}\n        >\n          {footer}\n        </div>\n      )}\n    </div>\n  );\n};\n\n/**\n * AppCard — enterprise-ready widget wrapper for AI host environments.\n *\n * Works with ChatGPT Apps, Anthropic MCP Apps, Google Gemini, or any MCP host.\n * Wrapped in an error boundary so rendering failures in child components never\n * crash the host application — critical for sandboxed iframes.\n */\nexport const AppCard: React.FC<AppCardProps> = (props) => (\n  <CardErrorBoundary componentName={props.title ?? 'AppCard'}>\n    <AppCardInner {...props} />\n  </CardErrorBoundary>\n);\n\n/** @deprecated Use `AppCard` instead. Alias kept for backward compatibility. */\nexport const ChatGPTCard = AppCard;\n/** @deprecated Use `AppCardProps` instead. */\nexport type ChatGPTCardProps = AppCardProps;\n\nexport default AppCard;\n"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,6 @@
+/**
+ * @deprecated Import from './AppCard' instead.
+ * This file is kept for backward compatibility only.
+ */
+export { AppCard, ChatGPTCard, type AppCardProps, type ChatGPTCardProps } from './AppCard';
+export { default } from './AppCard';

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

@@ -0,0 +1,167 @@
+/**
+ * ChatGPT Apps SDK Integration
+ *
+ * Hooks and utilities for integrating Zendir UI components with ChatGPT's
+ * window.openai API. Based on: https://developers.openai.com/apps-sdk/build/chatgpt-ui/
+ *
+ * Key capabilities:
+ * - window.openai.toolInput / toolOutput - Tool data from MCP server
+ * - window.openai.widgetState / setWidgetState - Persistent UI state
+ * - window.openai.callTool - Invoke other MCP tools from widget
+ * - window.openai.sendFollowUpMessage - Insert user messages
+ * - window.openai.theme - Light/dark theme detection
+ * - window.openai.locale - Localization
+ * - window.openai.requestDisplayMode - Fullscreen/PiP modes
+ * - window.openai.notifyIntrinsicHeight - Dynamic height reporting
+ */
+export interface OpenAiGlobals {
+    /** Arguments supplied when the tool was invoked */
+    toolInput?: Record<string, unknown>;
+    /** Your structuredContent - the model reads this */
+    toolOutput?: Record<string, unknown>;
+    /** Metadata payload - only widget sees it */
+    toolResponseMetadata?: Record<string, unknown>;
+    /** Snapshot of UI state persisted between renders */
+    widgetState?: Record<string, unknown>;
+    /** Current theme */
+    theme?: 'light' | 'dark';
+    /** Current locale (e.g., 'en-US') */
+    locale?: string;
+    /** Display mode */
+    displayMode?: 'inline' | 'pip' | 'fullscreen';
+    /** Maximum allowed height */
+    maxHeight?: number;
+    /** View type */
+    view?: 'conversation' | 'modal';
+    /** User agent info */
+    userAgent?: string;
+    /** Safe area insets */
+    safeArea?: {
+        top: number;
+        bottom: number;
+        left: number;
+        right: number;
+    };
+    setWidgetState?: (state: Record<string, unknown>) => void;
+    callTool?: (name: string, args: Record<string, unknown>) => Promise<unknown>;
+    sendFollowUpMessage?: (options: {
+        prompt: string;
+    }) => Promise<void>;
+    uploadFile?: (file: File) => Promise<{
+        fileId: string;
+    }>;
+    getFileDownloadUrl?: (options: {
+        fileId: string;
+    }) => Promise<{
+        downloadUrl: string;
+    }>;
+    requestDisplayMode?: (options: {
+        mode: 'inline' | 'pip' | 'fullscreen';
+    }) => Promise<void>;
+    requestModal?: (options: unknown) => Promise<void>;
+    notifyIntrinsicHeight?: (height: number) => void;
+    openExternal?: (options: {
+        href: string;
+    }) => void;
+    requestClose?: () => void;
+}
+declare global {
+    interface Window {
+        openai?: OpenAiGlobals;
+    }
+}
+/**
+ * Subscribe to a specific window.openai global value
+ */
+export declare function useOpenAiGlobal<K extends keyof OpenAiGlobals>(key: K): OpenAiGlobals[K];
+type SetStateAction<T> = T | ((prevState: T) => T);
+/**
+ * Manage widget state that persists across renders via window.openai.setWidgetState
+ */
+export declare function useWidgetState<T extends Record<string, unknown>>(defaultState: T | (() => T)): readonly [T, (state: SetStateAction<T>) => void];
+/**
+ * Read the tool output (structuredContent) from the MCP server response
+ */
+export declare function useToolOutput<T = Record<string, unknown>>(): T | undefined;
+/**
+ * Read the tool input (arguments) from the tool invocation
+ */
+export declare function useToolInput<T = Record<string, unknown>>(): T | undefined;
+export type ThemeMode = 'light' | 'dark';
+/**
+ * Get current ChatGPT theme and provide CSS-friendly values
+ * Named useChatGPTTheme to avoid conflict with the core useTheme from ThemeProvider
+ */
+export declare function useChatGPTTheme(): {
+    theme: ThemeMode;
+    isDark: boolean;
+    colors: {
+        background: string;
+        surface: string;
+        surfaceHover: string;
+        border: string;
+        text: string;
+        textMuted: string;
+        accent: string;
+    };
+};
+/**
+ * Get current locale for internationalization
+ */
+export declare function useLocale(): string;
+/**
+ * Manage widget display mode (inline, PiP, fullscreen)
+ */
+export declare function useDisplayMode(): {
+    mode: 'inline' | 'pip' | 'fullscreen';
+    maxHeight?: number;
+    requestMode: (mode: 'inline' | 'pip' | 'fullscreen') => Promise<void>;
+    close: () => void;
+};
+/**
+ * Call another MCP tool from within a widget
+ */
+export declare function useCallTool(): {
+    callTool: <T = unknown>(name: string, args: Record<string, unknown>) => Promise<T>;
+    isLoading: boolean;
+    error: Error | null;
+};
+/**
+ * Send a follow-up message as if the user asked it
+ */
+export declare function useSendMessage(): (prompt: string) => Promise<void>;
+/**
+ * DEPRECATED: Do not use notifyIntrinsicHeight!
+ *
+ * According to OpenAI Apps SDK examples (via DeepWiki), the correct pattern is:
+ * - The HOST provides maxHeight via window.openai.maxHeight
+ * - Widgets READ this and constrain themselves
+ * - Widgets NEVER report height back to the host
+ *
+ * Calling notifyIntrinsicHeight causes infinite resize loops in MCPJam sandbox
+ * because the sandbox responds by resizing the container, which triggers another
+ * resize event.
+ *
+ * Use useMaxHeight() instead to get the host's height constraint.
+ *
+ * @deprecated Use useMaxHeight() instead
+ */
+export declare function useIntrinsicHeight(_ref: {
+    current: HTMLElement | null;
+}): void;
+/**
+ * Get the maximum height available for the widget from the host environment.
+ * This is the CORRECT pattern per OpenAI Apps SDK examples.
+ *
+ * The host (ChatGPT/MCPJam) provides maxHeight, and widgets should constrain
+ * themselves to this height. Widgets should NOT report their height back.
+ *
+ * @returns The maximum height in pixels, or undefined if not available
+ */
+export declare function useMaxHeight(): number | undefined;
+/**
+ * Open vetted external links in the user's browser
+ */
+export declare function useOpenExternal(): (href: string) => void;
+export declare function isInChatGPT(): boolean;
+export {};