pxengine 0.1.120 → 0.1.121

package/dist/index.cjs

@@ -16080,6 +16080,8 @@ var import_react79 = require("react");
 
 // src/lib/shared-poll.ts
 var import_react78 = require("react");
+var MAX_RETAINED = 50;
+var RETAIN_TTL_MS = 30 * 60 * 1e3;
 var entries = /* @__PURE__ */ new Map();
 function clearTimer(entry) {
   if (entry.timer !== null) {
@@ -16089,6 +16091,32 @@ function clearTimer(entry) {
   entry.controller?.abort();
   entry.controller = null;
 }
+function isIdle(entry) {
+  return entry.dataListeners.size === 0 && entry.errorListeners.size === 0;
+}
+function pruneRetained(keepKey) {
+  const now = Date.now();
+  const idle = [];
+  for (const [key, entry] of entries) {
+    if (!isIdle(entry)) continue;
+    if (entry.retainedAt != null && now - entry.retainedAt > RETAIN_TTL_MS) {
+      entries.delete(key);
+      continue;
+    }
+    idle.push([key, entry]);
+  }
+  if (idle.length <= MAX_RETAINED) return;
+  idle.sort(
+    (a, b) => (a[1].retainedAt ?? 0) - (b[1].retainedAt ?? 0)
+  );
+  let excess = idle.length - MAX_RETAINED;
+  for (const [key] of idle) {
+    if (excess <= 0) break;
+    if (key === keepKey) continue;
+    entries.delete(key);
+    excess -= 1;
+  }
+}
 async function runPoll(key) {
   const entry = entries.get(key);
   if (!entry || entry.inFlight || entry.stopped) return;
@@ -16139,11 +16167,13 @@ function subscribeSharedPoll(config, onData, onError) {
       lastData: void 0,
       hasData: false,
       stopped: false,
-      inFlight: false
+      inFlight: false,
+      retainedAt: null
     };
     entries.set(key, entry);
   }
   const activeEntry = entry;
+  activeEntry.retainedAt = null;
   activeEntry.dataListeners.add(onData);
   if (onError) activeEntry.errorListeners.add(onError);
   if (activeEntry.hasData && activeEntry.lastData !== void 0) {
@@ -16161,6 +16191,11 @@ function subscribeSharedPoll(config, onData, onError) {
     if (onError) activeEntry.errorListeners.delete(onError);
     if (activeEntry.dataListeners.size === 0 && activeEntry.errorListeners.size === 0) {
       clearTimer(activeEntry);
+      if (activeEntry.hasData) {
+        activeEntry.retainedAt = Date.now();
+        pruneRetained(key);
+        return;
+      }
       entries.delete(key);
     }
   };
@@ -16171,6 +16206,16 @@ function stopSharedPoll(key) {
   entry.stopped = true;
   clearTimer(entry);
 }
+function getSharedPollLastData(key) {
+  if (!key) return void 0;
+  const entry = entries.get(key);
+  if (!entry || !entry.hasData) return void 0;
+  return entry.lastData;
+}
+function isSharedPollStopped(key) {
+  if (!key) return false;
+  return entries.get(key)?.stopped === true;
+}
 function useSharedPoll(config, onData, onError) {
   const fetcherRef = (0, import_react78.useRef)(config.fetcher);
   fetcherRef.current = config.fetcher;
@@ -23152,6 +23197,15 @@ var formatTime = (seconds) => {
   const minutes = Math.floor(seconds / 60);
   return minutes >= 1 ? `${minutes} min remaining...` : `${seconds} sec remaining...`;
 };
+function isTerminalStatus(status) {
+  return status === "completed" || status === "complete" || status === "failed";
+}
+function versionPollKey(sessionId, version, validated) {
+  return `creator:versions:${sessionId}:${version ?? "latest"}:${validated ? 1 : 0}`;
+}
+function statusPollKey(sessionId, version) {
+  return `creator:status:${sessionId}:${version}`;
+}
 function useCreatorWidgetPolling({
   sessionId,
   currentVersion,
@@ -23166,17 +23220,53 @@ function useCreatorWidgetPolling({
     () => ({ ...DEFAULT_POLLING_CONFIG, ...pollingConfig }),
     [pollingConfig]
   );
-  const [versionData, setVersionData] = (0, import_react94.useState)(null);
-  const [totalVersions, setTotalVersions] = (0, import_react94.useState)(0);
+  const hydrated = (0, import_react94.useMemo)(() => {
+    if (!sessionId) {
+      return {
+        versionData: null,
+        statusPayload: void 0,
+        activeVersion: currentVersion
+      };
+    }
+    const versionHint = currentVersion;
+    const cachedVersion = getSharedPollLastData(
+      versionPollKey(sessionId, versionHint, true)
+    ) ?? getSharedPollLastData(
+      versionPollKey(sessionId, versionHint, false)
+    );
+    const activeVersion2 = versionHint ?? cachedVersion?.currentVersion ?? void 0;
+    const statusPayload = activeVersion2 != null ? getSharedPollLastData(
+      statusPollKey(sessionId, activeVersion2)
+    ) : void 0;
+    return { versionData: cachedVersion ?? null, statusPayload, activeVersion: activeVersion2 };
+  }, [sessionId, currentVersion]);
+  const hydratedStatus = hydrated.statusPayload?.status?.status;
+  const hydratedTerminal = isTerminalStatus(hydratedStatus);
+  const [versionData, setVersionData] = (0, import_react94.useState)(
+    hydrated.versionData
+  );
+  const [totalVersions, setTotalVersions] = (0, import_react94.useState)(
+    hydrated.versionData?.totalVersions || 0
+  );
   const [selectedVersion, setSelectedVersion] = (0, import_react94.useState)();
-  const [isLoadingVersion, setIsLoadingVersion] = (0, import_react94.useState)(false);
-  const [isValidationComplete, setIsValidationComplete] = (0, import_react94.useState)(false);
-  const [versionStatus, setVersionStatus] = (0, import_react94.useState)("checking");
-  const [statusDetails, setStatusDetails] = (0, import_react94.useState)();
+  const [isLoadingVersion, setIsLoadingVersion] = (0, import_react94.useState)(!hydrated.versionData);
+  const [isValidationComplete, setIsValidationComplete] = (0, import_react94.useState)(
+    hydratedTerminal && hydratedStatus !== "failed"
+  );
+  const [versionStatus, setVersionStatus] = (0, import_react94.useState)(
+    hydratedStatus || (hydrated.versionData ? "in-progress" : "checking")
+  );
+  const [statusDetails, setStatusDetails] = (0, import_react94.useState)(
+    hydrated.statusPayload?.status
+  );
   const [timeDisplay, setTimeDisplay] = (0, import_react94.useState)("");
-  const [loadingStatus, setLoadingStatus] = (0, import_react94.useState)(true);
+  const [loadingStatus, setLoadingStatus] = (0, import_react94.useState)(
+    !(hydrated.versionData && hydratedTerminal)
+  );
   const remainingTimeRef = (0, import_react94.useRef)(0);
   const countdownRef = (0, import_react94.useRef)(null);
+  const versionDataRef = (0, import_react94.useRef)(versionData);
+  versionDataRef.current = versionData;
   const requestedVersion = selectedVersion ?? currentVersion ?? versionData?.currentVersion;
   const updateStatus = (0, import_react94.useCallback)(
     (status) => {
@@ -23185,13 +23275,13 @@ function useCreatorWidgetPolling({
     },
     [onStatusChange]
   );
-  const versionKey = sessionId ? `creator:versions:${sessionId}:${requestedVersion ?? "latest"}:${isValidationComplete ? 1 : 0}` : null;
+  const versionKey = sessionId ? versionPollKey(sessionId, requestedVersion, isValidationComplete) : null;
   useSharedPoll(
     {
       key: versionKey,
       intervalMs: config.pollInterval,
       fetcher: async () => {
-        if (!versionData) setIsLoadingVersion(true);
+        if (!versionDataRef.current) setIsLoadingVersion(true);
         return fetchVersions({
           sessionId,
           version: requestedVersion,
@@ -23215,10 +23305,10 @@ function useCreatorWidgetPolling({
     }
   );
   const activeVersion = selectedVersion ?? requestedVersion;
-  const statusKey = sessionId && activeVersion != null ? `creator:status:${sessionId}:${activeVersion}` : null;
+  const statusKey = sessionId && activeVersion != null ? statusPollKey(sessionId, activeVersion) : null;
   const errorCountRef = (0, import_react94.useRef)(0);
   const deadlineRef = (0, import_react94.useRef)(0);
-  const doneRef = (0, import_react94.useRef)(false);
+  const doneRef = (0, import_react94.useRef)(hydratedTerminal);
   const stopCountdown = (0, import_react94.useCallback)(() => {
     if (countdownRef.current) {
       clearInterval(countdownRef.current);
@@ -23228,13 +23318,28 @@ function useCreatorWidgetPolling({
   }, []);
   (0, import_react94.useEffect)(() => {
     if (statusKey == null) return;
+    const cached = getSharedPollLastData(statusKey);
+    const cachedStatus = cached?.status?.status;
+    if (isTerminalStatus(cachedStatus) && isSharedPollStopped(statusKey)) {
+      setStatusDetails(cached?.status);
+      setVersionStatus(cachedStatus);
+      onStatusChange?.(cachedStatus);
+      if (cachedStatus === "completed" || cachedStatus === "complete") {
+        setIsValidationComplete(true);
+      }
+      setLoadingStatus(false);
+      doneRef.current = true;
+      errorCountRef.current = 0;
+      stopCountdown();
+      return;
+    }
     setLoadingStatus(true);
     setStatusDetails(void 0);
     setVersionStatus("checking");
     errorCountRef.current = 0;
     doneRef.current = false;
     deadlineRef.current = Date.now() + config.maxDuration;
-    const creatorLength2 = versionData?.length || 0;
+    const creatorLength2 = versionDataRef.current?.length || 0;
     remainingTimeRef.current = creatorLength2 > 0 ? creatorLength2 * config.secondsPerCreator : 60;
     setTimeDisplay(formatTime(remainingTimeRef.current));
     countdownRef.current = setInterval(() => {
@@ -23256,7 +23361,7 @@ function useCreatorWidgetPolling({
       shouldContinue: (data) => {
         if (Date.now() >= deadlineRef.current) return false;
         const s = data?.status?.status;
-        return !(s === "completed" || s === "complete" || s === "failed");
+        return !isTerminalStatus(s);
       }
     },
     (data) => {
@@ -23402,6 +23507,185 @@ var CreatorWidget = (0, import_react95.memo)(CreatorWidgetInner);
 
 // src/molecules/analytics/AnalyticsChart.tsx
 var import_react96 = require("react");
+
+// src/molecules/analytics/buildOptions.ts
+function deepMerge(base, override) {
+  const out = Array.isArray(base) ? [...base] : { ...base };
+  for (const key of Object.keys(override)) {
+    const o = override[key];
+    const b = out[key];
+    if (o && typeof o === "object" && !Array.isArray(o) && b && typeof b === "object" && !Array.isArray(b)) {
+      out[key] = deepMerge(b, o);
+    } else if (o !== void 0) {
+      out[key] = o;
+    }
+  }
+  return out;
+}
+function highchartsType(type) {
+  if (type === "donut") return "pie";
+  return type;
+}
+function buildAxis(axis, fallbackCategories) {
+  const cfg = {};
+  if (!axis) {
+    if (fallbackCategories) cfg.categories = fallbackCategories;
+    return cfg;
+  }
+  if (axis.title) cfg.title = { text: axis.title };
+  if (axis.type) cfg.type = axis.type;
+  if (axis.categories || fallbackCategories) cfg.categories = axis.categories ?? fallbackCategories;
+  if (axis.format) cfg.labels = { format: axis.format };
+  if (typeof axis.min === "number") cfg.min = axis.min;
+  if (typeof axis.max === "number") cfg.max = axis.max;
+  if (axis.opposite) cfg.opposite = true;
+  return cfg;
+}
+function resolveStacking(stacked) {
+  if (stacked === true || stacked === "normal") return "normal";
+  if (stacked === "percent") return "percent";
+  return void 0;
+}
+function buildChartOptions(config, palette) {
+  const hcType = highchartsType(config.type);
+  const isCircular = config.type === "pie" || config.type === "donut";
+  const seriesColors = config.colors ?? palette.series;
+  const safeSeries = Array.isArray(config.series) ? config.series : [];
+  const options = {
+    chart: { type: hcType, ...config.height && { height: config.height } },
+    title: { text: config.title ?? void 0 },
+    subtitle: { text: config.subtitle ?? void 0 },
+    series: safeSeries.map((s, i) => ({
+      name: s.name,
+      data: s.data,
+      ...s.type && { type: highchartsType(s.type) },
+      ...s.stack && { stack: s.stack },
+      ...typeof s.yAxis === "number" && { yAxis: s.yAxis },
+      color: s.color ?? seriesColors[i % seriesColors.length]
+    })),
+    legend: { enabled: config.legend ?? (safeSeries.length > 1 || isCircular) }
+  };
+  if (config.colors) options.colors = config.colors;
+  if (!isCircular && config.type !== "funnel") {
+    options.xAxis = buildAxis(config.xAxis, config.categories);
+    const yAxes = Array.isArray(config.yAxis) ? config.yAxis : [config.yAxis];
+    options.yAxis = yAxes.map((a) => buildAxis(a));
+    if (options.yAxis.length === 1) options.yAxis = options.yAxis[0];
+  }
+  if (config.tooltip) {
+    options.tooltip = {
+      ...config.tooltip.shared !== void 0 && { shared: config.tooltip.shared },
+      ...config.tooltip.valuePrefix && { valuePrefix: config.tooltip.valuePrefix },
+      ...config.tooltip.valueSuffix && { valueSuffix: config.tooltip.valueSuffix },
+      ...config.tooltip.pointFormat && { pointFormat: config.tooltip.pointFormat }
+    };
+  }
+  const stacking = resolveStacking(config.stacked);
+  const dataLabels = config.dataLabels === true ? { enabled: true } : config.dataLabels && typeof config.dataLabels === "object" ? { enabled: true, ...config.dataLabels } : void 0;
+  const plotOptions = {};
+  if (stacking || dataLabels) {
+    plotOptions.series = {
+      ...stacking && { stacking },
+      ...dataLabels && { dataLabels }
+    };
+  }
+  if (config.type === "donut") {
+    plotOptions.pie = {
+      innerSize: "55%",
+      dataLabels: dataLabels ?? {
+        enabled: true,
+        format: "<b>{point.name}</b>: {point.percentage:.1f}%"
+      }
+    };
+  } else if (config.type === "pie") {
+    plotOptions.pie = {
+      dataLabels: dataLabels ?? {
+        enabled: true,
+        format: "<b>{point.name}</b>: {point.percentage:.1f}%"
+      }
+    };
+  } else if (config.type === "funnel") {
+    plotOptions.funnel = {
+      neckWidth: "30%",
+      neckHeight: "25%",
+      dataLabels: dataLabels ?? { enabled: true, format: "<b>{point.name}</b> ({point.y:,.0f})" }
+    };
+  }
+  if (Object.keys(plotOptions).length) options.plotOptions = plotOptions;
+  return options;
+}
+
+// src/molecules/analytics/highchartsTheme.ts
+var PXENGINE_SERIES_COLORS = [
+  "#6366f1",
+  // indigo
+  "#10b981",
+  // emerald
+  "#f59e0b",
+  // amber
+  "#ec4899",
+  // pink
+  "#8b5cf6",
+  // violet
+  "#06b6d4",
+  // cyan
+  "#f43f5e",
+  // rose
+  "#84cc16",
+  // lime
+  "#3b82f6",
+  // blue
+  "#f97316"
+  // orange
+];
+var DARK_PALETTE = {
+  text: "#e5e7eb",
+  textMuted: "#9ca3af",
+  grid: "rgba(255,255,255,0.08)",
+  border: "rgba(255,255,255,0.12)",
+  background: "transparent",
+  series: PXENGINE_SERIES_COLORS,
+  tooltipBg: "rgba(17,24,39,0.95)",
+  tooltipText: "#f9fafb"
+};
+var LIGHT_PALETTE = {
+  text: "#1f2937",
+  textMuted: "#6b7280",
+  grid: "rgba(0,0,0,0.06)",
+  border: "rgba(0,0,0,0.10)",
+  background: "transparent",
+  series: PXENGINE_SERIES_COLORS,
+  tooltipBg: "rgba(255,255,255,0.98)",
+  tooltipText: "#111827"
+};
+function resolveColorMode(mode = "auto") {
+  if (mode === "light" || mode === "dark") return mode;
+  if (typeof document !== "undefined") {
+    if (document.documentElement.classList.contains("dark")) return "dark";
+    if (typeof window !== "undefined" && window.matchMedia && window.matchMedia("(prefers-color-scheme: dark)").matches) {
+      return "dark";
+    }
+    return "light";
+  }
+  return "dark";
+}
+function buildChartPalette(theme, mode = "auto") {
+  const base = resolveColorMode(mode) === "dark" ? DARK_PALETTE : LIGHT_PALETTE;
+  if (!theme) return base;
+  const series = theme.accent ? [theme.accent, ...base.series.filter((c) => c.toLowerCase() !== theme.accent.toLowerCase())] : base.series;
+  return {
+    ...base,
+    ...theme.text && { text: theme.text },
+    ...theme.textMuted && { textMuted: theme.textMuted },
+    ...theme.border && { border: theme.border, grid: theme.border },
+    ...theme.surface && { tooltipBg: theme.surface },
+    ...theme.text && { tooltipText: theme.text },
+    ...theme.fontFamily && { fontFamily: theme.fontFamily },
+    series
+  };
+}
+
+// src/molecules/analytics/AnalyticsChart.tsx
 var import_jsx_runtime179 = require("react/jsx-runtime");
 function getCSSVar(name) {
   if (typeof document === "undefined") return "";
@@ -23438,6 +23722,30 @@ function stripNulls(val) {
   }
   return val;
 }
+function resolveDeclarativeConfig(props) {
+  if (props.chartConfig) {
+    return {
+      ...props.chartConfig,
+      ...props.height != null && !props.chartConfig.height ? { height: props.height } : {}
+    };
+  }
+  if (!props.chartType) return null;
+  return {
+    type: props.chartType,
+    title: props.title,
+    subtitle: props.subtitle,
+    series: props.series ?? [],
+    categories: props.categories,
+    xAxis: props.xAxis,
+    yAxis: props.yAxis,
+    colors: props.colors,
+    stacked: props.stacked,
+    legend: props.legend,
+    tooltip: props.tooltip,
+    dataLabels: props.dataLabels,
+    height: props.height
+  };
+}
 var hcSingleton = null;
 var hcLoadPromise = null;
 function loadHighcharts() {
@@ -23506,9 +23814,25 @@ function buildTheme(height) {
 }
 function AnalyticsChart({
   config: configProp,
+  chartConfig,
+  chartType,
+  series,
+  categories,
+  xAxis,
+  yAxis,
+  colors,
+  stacked,
+  legend,
+  tooltip,
+  dataLabels,
+  extraOptions,
   chartId,
   apiBase = "",
   authToken,
+  title,
+  subtitle,
+  theme,
+  mode = "auto",
   height = 400,
   className,
   loading: loadingProp,
@@ -23520,11 +23844,51 @@ function AnalyticsChart({
   const [fetchError, setFetchError] = (0, import_react96.useState)(null);
   const containerRef = (0, import_react96.useRef)(null);
   const chartRef = (0, import_react96.useRef)(null);
+  const declarative = (0, import_react96.useMemo)(
+    () => resolveDeclarativeConfig({
+      chartConfig,
+      chartType,
+      title,
+      subtitle,
+      series,
+      categories,
+      xAxis,
+      yAxis,
+      colors,
+      stacked,
+      legend,
+      tooltip,
+      dataLabels,
+      height
+    }),
+    [
+      chartConfig,
+      chartType,
+      title,
+      subtitle,
+      series,
+      categories,
+      xAxis,
+      yAxis,
+      colors,
+      stacked,
+      legend,
+      tooltip,
+      dataLabels,
+      height
+    ]
+  );
+  const builtConfig = (0, import_react96.useMemo)(() => {
+    if (!declarative) return null;
+    const palette = buildChartPalette(theme, mode);
+    const options = buildChartOptions(declarative, palette);
+    return extraOptions ? deepMerge(options, extraOptions) : options;
+  }, [declarative, theme, mode, extraOptions]);
   (0, import_react96.useEffect)(() => {
     setMounted(true);
   }, []);
   (0, import_react96.useEffect)(() => {
-    if (!chartId || configProp) return;
+    if (!chartId || configProp || builtConfig) return;
     let cancelled = false;
     setFetching(true);
     setFetchError(null);
@@ -23543,8 +23907,8 @@ function AnalyticsChart({
     return () => {
       cancelled = true;
     };
-  }, [chartId, apiBase, authToken, configProp]);
-  const activeConfig = configProp ?? fetchedConfig;
+  }, [chartId, apiBase, authToken, configProp, builtConfig]);
+  const activeConfig = configProp ?? builtConfig ?? fetchedConfig;
   (0, import_react96.useEffect)(() => {
     if (!mounted || !activeConfig || !containerRef.current) return;
     const container = containerRef.current;