@sqlrooms/mosaic 0.29.0-rc.6 → 0.29.0-rc.8

package/dist/useVgPlotChartRender.js

@@ -1,8 +1,20 @@
 import { astToDOM, parseSpec } from '@uwdata/mosaic-spec';
-import { useEffect, useRef } from 'react';
+import { useLayoutEffect, useRef } from 'react';
 import { assertChartDataPolicy, createChartRuntimeIssueFromError, } from './chart-runtime';
+/**
+ * Symbols used to store original mark handlers before wrapping.
+ * This allows wrapMarkHandlers to be idempotent - it stores the original
+ * handlers once and reuses them on subsequent calls, preventing nested wrappers.
+ */
+const ORIGINAL_QUERY_PENDING = Symbol('originalQueryPending');
+const ORIGINAL_QUERY_RESULT = Symbol('originalQueryResult');
+const ORIGINAL_QUERY_ERROR = Symbol('originalQueryError');
 function getPlotInstance(element) {
-    const plot = element.value;
+    let htmlElement = element;
+    if (!htmlElement?.classList.contains('plot')) {
+        htmlElement = htmlElement?.querySelector('.plot');
+    }
+    const plot = htmlElement.value;
     return plot && typeof plot === 'object' ? plot : null;
 }
 function resizeChartElement(element, size) {
@@ -32,44 +44,131 @@ async function createSpecChartElement(spec, size, params) {
 function asPlotDomElement(element) {
     return element;
 }
+function attachPlotElement(container, element) {
+    if (container.childNodes.length === 1 && container.firstChild === element) {
+        return;
+    }
+    container.replaceChildren(element);
+}
+/**
+ * Checks the aggregate state of all chart marks and reports errors when all marks are done.
+ * This function is called after mark handlers complete to determine if the chart succeeded or failed.
+ *
+ * @param chart - Retained chart with mark state tracking
+ * @param onError - Callback invoked with first error when marks fail
+ * @param runtimeIssueReporter - Optional reporter for runtime issues
+ * @param runtimeIssueContext - Context for runtime issue reporting
+ * @param dataPolicy - Optional policy for validating chart data
+ */
+function checkAndReportAggregateState(chart, onError, runtimeIssueReporter, runtimeIssueContext, dataPolicy) {
+    if (!chart.markStates || chart.markStates.size === 0) {
+        return; // No marks tracked yet
+    }
+    // Check if all marks are done (only success or error, not pending or idle)
+    const allDone = Array.from(chart.markStates.values()).every((state) => state === 'success' || state === 'error');
+    if (!allDone) {
+        return; // Wait for all marks to finish
+    }
+    // All marks done - determine aggregate state
+    const hasError = Array.from(chart.markStates.values()).some((state) => state === 'error');
+    if (hasError) {
+        // Find first error
+        const firstErrorMark = Array.from(chart.markStates.entries()).find(([, state]) => state === 'error')?.[0];
+        const error = firstErrorMark && chart.markErrors?.get(firstErrorMark);
+        if (error) {
+            chart.error = error; // For standalone case
+            onError(error);
+            if (runtimeIssueContext) {
+                runtimeIssueReporter?.reportIssue(createChartRuntimeIssueFromError(error, runtimeIssueContext, dataPolicy));
+            }
+        }
+    }
+    else {
+        // All successful
+        delete chart.error;
+        runtimeIssueReporter?.clearIssue();
+    }
+}
+/**
+ * Wraps chart mark handlers (queryPending, queryResult, queryError) to track state and report errors.
+ * This function is idempotent - it stores original handlers in Symbols and only wraps once.
+ * Subsequent calls update the closures with fresh dataPolicy/runtimeIssue reporters without nesting wrappers.
+ *
+ * Pre-populates all queryable marks with 'idle' state for proper aggregate state tracking.
+ *
+ * @param chart - Retained chart whose marks will be wrapped
+ * @param onError - Callback invoked when mark errors occur
+ * @param dataPolicy - Optional policy for validating chart data
+ * @param runtimeIssueContext - Context for runtime issue reporting
+ * @param runtimeIssueReporter - Optional reporter for runtime issues
+ */
 function wrapMarkHandlers(chart, onError, dataPolicy, runtimeIssueContext, runtimeIssueReporter) {
     const plot = getPlotInstance(chart.element);
     if (!plot?.marks) {
         return;
     }
+    // Initialize tracking
+    if (!chart.markStates) {
+        chart.markStates = new Map();
+    }
+    if (!chart.markErrors) {
+        chart.markErrors = new Map();
+    }
     plot.marks.forEach((mark) => {
+        const markWithOriginals = mark;
+        // Pre-populate tracking for all queryable marks
+        if (mark.queryPending || mark.queryResult || mark.queryError) {
+            chart.markStates.set(mark, 'idle');
+        }
+        // Wrap queryPending - store original if not already stored
+        if (mark.queryPending) {
+            if (!markWithOriginals[ORIGINAL_QUERY_PENDING]) {
+                markWithOriginals[ORIGINAL_QUERY_PENDING] = mark.queryPending;
+            }
+            const originalPending = markWithOriginals[ORIGINAL_QUERY_PENDING];
+            mark.queryPending = function () {
+                chart.markStates.set(mark, 'pending');
+                return originalPending.call(this);
+            };
+        }
+        // Wrap queryResult - store original if not already stored
         if (mark.queryResult) {
-            const originalQueryResult = mark.queryResult;
-            mark.queryResult = (data) => {
+            if (!markWithOriginals[ORIGINAL_QUERY_RESULT]) {
+                markWithOriginals[ORIGINAL_QUERY_RESULT] = mark.queryResult;
+            }
+            const originalQueryResult = markWithOriginals[ORIGINAL_QUERY_RESULT];
+            mark.queryResult = function (data) {
                 try {
                     assertChartDataPolicy(dataPolicy, data);
-                    runtimeIssueReporter?.clearIssue();
-                    return originalQueryResult.call(mark, data);
+                    chart.markStates.set(mark, 'success');
+                    chart.markErrors.delete(mark);
+                    checkAndReportAggregateState(chart, onError, runtimeIssueReporter, runtimeIssueContext, dataPolicy);
+                    return originalQueryResult.call(this, data);
                 }
                 catch (error) {
                     const normalizedError = error instanceof Error ? error : new Error(String(error));
-                    onError(normalizedError);
-                    chart.error = normalizedError;
-                    if (runtimeIssueContext) {
-                        runtimeIssueReporter?.reportIssue(createChartRuntimeIssueFromError(normalizedError, runtimeIssueContext, dataPolicy));
-                    }
-                    if (mark.queryError) {
-                        return mark.queryError(normalizedError);
+                    chart.markStates.set(mark, 'error');
+                    chart.markErrors.set(mark, normalizedError);
+                    checkAndReportAggregateState(chart, onError, runtimeIssueReporter, runtimeIssueContext, dataPolicy);
+                    if (markWithOriginals[ORIGINAL_QUERY_ERROR]) {
+                        return markWithOriginals[ORIGINAL_QUERY_ERROR].call(this, normalizedError);
                     }
                     return undefined;
                 }
             };
         }
+        // Wrap queryError - store original if not already stored
         if (mark.queryError) {
-            const originalQueryError = mark.queryError;
-            mark.queryError = (error) => {
+            if (!markWithOriginals[ORIGINAL_QUERY_ERROR]) {
+                markWithOriginals[ORIGINAL_QUERY_ERROR] = mark.queryError;
+            }
+            const originalQueryError = markWithOriginals[ORIGINAL_QUERY_ERROR];
+            mark.queryError = function (error) {
                 const normalizedError = error instanceof Error ? error : new Error(String(error));
-                onError(normalizedError);
-                chart.error = normalizedError;
-                if (runtimeIssueContext) {
-                    runtimeIssueReporter?.reportIssue(createChartRuntimeIssueFromError(normalizedError, runtimeIssueContext, dataPolicy));
-                }
-                originalQueryError.call(mark, error);
+                chart.markStates?.set(mark, 'error');
+                chart.markErrors?.set(mark, normalizedError);
+                checkAndReportAggregateState(chart, onError, runtimeIssueReporter, runtimeIssueContext, dataPolicy);
+                return originalQueryError.call(this, error);
             };
         }
     });
@@ -79,23 +178,35 @@ function wrapMarkHandlers(chart, onError, dataPolicy, runtimeIssueContext, runti
  */
 export function useVgPlotChartRender({ containerRef, spec, specKey, params, containerSize, cachedChart, onChartCreated, onError, dataPolicy, runtimeIssueContext, runtimeIssueReporter, }) {
     const renderVersionRef = useRef(0);
-    useEffect(() => {
+    useLayoutEffect(() => {
         const container = containerRef.current;
-        if (!container || !containerSize) {
+        if (!container) {
             return;
         }
-        // Use cached chart if available
         if (cachedChart) {
-            container.replaceChildren(asPlotDomElement(cachedChart.element));
-            resizeChartElement(cachedChart.element, containerSize);
+            // Check aggregate state before clearing to preserve error state
+            checkAndReportAggregateState(cachedChart, onError, runtimeIssueReporter, runtimeIssueContext, dataPolicy);
+            // Clear mark states when reusing cached chart - marks will re-register on next query
+            if (cachedChart.markStates) {
+                cachedChart.markStates.clear();
+            }
+            if (cachedChart.markErrors) {
+                cachedChart.markErrors.clear();
+            }
+            attachPlotElement(container, asPlotDomElement(cachedChart.element));
+            if (containerSize) {
+                resizeChartElement(cachedChart.element, containerSize);
+            }
             // Re-wrap mark handlers with fresh closures for dataPolicy/runtimeIssue reporting
             wrapMarkHandlers(cachedChart, onError, dataPolicy, runtimeIssueContext, runtimeIssueReporter);
-            // Restore error state from cached chart
-            if (cachedChart.error) {
-                onError(cachedChart.error);
-            }
             return;
         }
+        if (!containerSize) {
+            return;
+        }
+        // Clear any previous runtime issues when starting to render a new chart spec
+        // This ensures stale errors don't persist when the chart configuration changes
+        runtimeIssueReporter?.clearIssue();
         // Create new chart
         const renderVersion = ++renderVersionRef.current;
         let cancelled = false;
@@ -112,7 +223,7 @@ export function useVgPlotChartRender({ containerRef, spec, specKey, params, cont
                 specKey: specKey ?? JSON.stringify(spec),
             };
             onChartCreated(nextChart);
-            containerRef.current.replaceChildren(element);
+            attachPlotElement(containerRef.current, element);
             // Wrap marks with runtime handlers
             wrapMarkHandlers(nextChart, onError, dataPolicy, runtimeIssueContext, runtimeIssueReporter);
         })

package/dist/useVgPlotChartRender.js.map

@@ -1 +1 @@
-{"version":3,"file":"useVgPlotChartRender.js","sourceRoot":"","sources":["../src/useVgPlotChartRender.ts"],"names":[],"mappings":"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","sourcesContent":["import {Param, Selection} from '@uwdata/mosaic-core';\nimport {astToDOM, parseSpec, Spec} from '@uwdata/mosaic-spec';\nimport {useEffect, useRef} from 'react';\nimport {PlotSize} from './ResponsivePlot';\nimport {RetainedVgPlotChart} from './useVgPlotChartRetention';\nimport {\n  assertChartDataPolicy,\n  createChartRuntimeIssueFromError,\n  type ChartDataPolicy,\n  type ChartRuntimeIssueContext,\n  type ChartRuntimeIssueReporter,\n} from './chart-runtime';\n\ntype PlotDomElement = HTMLElement | SVGSVGElement;\n\ntype QueryableMark = {\n  queryResult?: (data: unknown) => unknown;\n  queryError?: (error: unknown) => unknown;\n};\n\ntype PlotInstance = {\n  marks?: Array<{destroy?: () => void} & QueryableMark>;\n  render?: () => Promise<unknown> | unknown;\n  setAttribute?: (name: string, value: unknown) => boolean;\n};\n\nfunction getPlotInstance(element: object): PlotInstance | null {\n  const plot = (element as HTMLElement & {value?: unknown}).value;\n  return plot && typeof plot === 'object' ? (plot as PlotInstance) : null;\n}\n\nfunction resizeChartElement(element: object, size: PlotSize): boolean {\n  const plot = getPlotInstance(element);\n  if (!plot?.setAttribute || !plot.render) {\n    return false;\n  }\n\n  const widthChanged = plot.setAttribute('width', size.width);\n  const heightChanged = plot.setAttribute('height', size.height);\n  if (widthChanged || heightChanged) {\n    void plot.render();\n  }\n  return true;\n}\n\nasync function createSpecChartElement(\n  spec: Spec,\n  size: PlotSize,\n  params?: Map<string, Param<any> | Selection>,\n): Promise<PlotDomElement> {\n  const sizedSpec = {\n    ...spec,\n    width: size.width,\n    height: size.height,\n  } as Spec;\n\n  const ast = await parseSpec(sizedSpec);\n  const options = params\n    ? {params: params as unknown as Map<string, Param<any>>}\n    : undefined;\n\n  return (await astToDOM(ast, options)).element;\n}\n\nfunction asPlotDomElement(element: object): PlotDomElement {\n  return element as PlotDomElement;\n}\n\nfunction wrapMarkHandlers(\n  chart: RetainedVgPlotChart,\n  onError: (error: Error) => void,\n  dataPolicy?: ChartDataPolicy | null,\n  runtimeIssueContext?: ChartRuntimeIssueContext,\n  runtimeIssueReporter?: ChartRuntimeIssueReporter,\n) {\n  const plot = getPlotInstance(chart.element);\n  if (!plot?.marks) {\n    return;\n  }\n\n  plot.marks.forEach((mark: QueryableMark) => {\n    if (mark.queryResult) {\n      const originalQueryResult = mark.queryResult;\n      mark.queryResult = (data: unknown) => {\n        try {\n          assertChartDataPolicy(dataPolicy, data);\n          runtimeIssueReporter?.clearIssue();\n          return originalQueryResult.call(mark, data);\n        } catch (error) {\n          const normalizedError =\n            error instanceof Error ? error : new Error(String(error));\n          onError(normalizedError);\n          chart.error = normalizedError;\n          if (runtimeIssueContext) {\n            runtimeIssueReporter?.reportIssue(\n              createChartRuntimeIssueFromError(\n                normalizedError,\n                runtimeIssueContext,\n                dataPolicy,\n              ),\n            );\n          }\n          if (mark.queryError) {\n            return mark.queryError(normalizedError);\n          }\n          return undefined;\n        }\n      };\n    }\n    if (mark.queryError) {\n      const originalQueryError = mark.queryError;\n      mark.queryError = (error: unknown) => {\n        const normalizedError =\n          error instanceof Error ? error : new Error(String(error));\n        onError(normalizedError);\n        chart.error = normalizedError;\n        if (runtimeIssueContext) {\n          runtimeIssueReporter?.reportIssue(\n            createChartRuntimeIssueFromError(\n              normalizedError,\n              runtimeIssueContext,\n              dataPolicy,\n            ),\n          );\n        }\n        originalQueryError.call(mark, error);\n      };\n    }\n  });\n}\n\ntype UseVgPlotChartRenderParams = {\n  containerRef: React.RefObject<HTMLDivElement | null>;\n  spec: Spec;\n  specKey: string | null;\n  params?: Map<string, Param<any> | Selection>;\n  containerSize: PlotSize | null;\n  cachedChart: RetainedVgPlotChart | null;\n  onChartCreated: (chart: RetainedVgPlotChart) => void;\n  onError: (error: Error) => void;\n  dataPolicy?: ChartDataPolicy | null;\n  runtimeIssueContext?: ChartRuntimeIssueContext;\n  runtimeIssueReporter?: ChartRuntimeIssueReporter;\n};\n\n/**\n * Hook to handle chart rendering lifecycle: creating, caching, and displaying vgplot charts.\n */\nexport function useVgPlotChartRender({\n  containerRef,\n  spec,\n  specKey,\n  params,\n  containerSize,\n  cachedChart,\n  onChartCreated,\n  onError,\n  dataPolicy,\n  runtimeIssueContext,\n  runtimeIssueReporter,\n}: UseVgPlotChartRenderParams) {\n  const renderVersionRef = useRef(0);\n\n  useEffect(() => {\n    const container = containerRef.current;\n    if (!container || !containerSize) {\n      return;\n    }\n\n    // Use cached chart if available\n    if (cachedChart) {\n      container.replaceChildren(asPlotDomElement(cachedChart.element));\n      resizeChartElement(cachedChart.element, containerSize);\n\n      // Re-wrap mark handlers with fresh closures for dataPolicy/runtimeIssue reporting\n      wrapMarkHandlers(\n        cachedChart,\n        onError,\n        dataPolicy,\n        runtimeIssueContext,\n        runtimeIssueReporter,\n      );\n\n      // Restore error state from cached chart\n      if (cachedChart.error) {\n        onError(cachedChart.error);\n      }\n\n      return;\n    }\n\n    // Create new chart\n    const renderVersion = ++renderVersionRef.current;\n    let cancelled = false;\n\n    void createSpecChartElement(spec, containerSize, params)\n      .then((element) => {\n        if (\n          cancelled ||\n          renderVersion !== renderVersionRef.current ||\n          !containerRef.current\n        ) {\n          return;\n        }\n\n        const nextChart: RetainedVgPlotChart = {\n          element,\n          params,\n          specKey: specKey ?? JSON.stringify(spec),\n        };\n\n        onChartCreated(nextChart);\n        containerRef.current.replaceChildren(element);\n\n        // Wrap marks with runtime handlers\n        wrapMarkHandlers(\n          nextChart,\n          onError,\n          dataPolicy,\n          runtimeIssueContext,\n          runtimeIssueReporter,\n        );\n      })\n      .catch((error) => {\n        if (cancelled) {\n          return;\n        }\n\n        // Normalize error to Error instance\n        const normalizedError =\n          error instanceof Error ? error : new Error(String(error));\n        onError(normalizedError);\n        if (runtimeIssueContext) {\n          runtimeIssueReporter?.reportIssue({\n            kind: 'render-error',\n            panelId: runtimeIssueContext.panelId,\n            chartType: runtimeIssueContext.chartType,\n            message: normalizedError.message,\n            recoverable: false,\n          });\n        }\n        console.error('[VgPlotChart] Error rendering chart:', normalizedError);\n      });\n\n    return () => {\n      cancelled = true;\n    };\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [\n    containerSize,\n    specKey,\n    cachedChart,\n    onChartCreated,\n    onError,\n    dataPolicy,\n    runtimeIssueContext,\n    runtimeIssueReporter,\n  ]);\n}\n"]}
+{"version":3,"file":"useVgPlotChartRender.js","sourceRoot":"","sources":["../src/useVgPlotChartRender.ts"],"names":[],"mappings":"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","sourcesContent":["import {Param, Selection} from '@uwdata/mosaic-core';\nimport {astToDOM, parseSpec, Spec} from '@uwdata/mosaic-spec';\nimport {useLayoutEffect, useRef} from 'react';\nimport {PlotSize} from './ResponsivePlot';\nimport {RetainedVgPlotChart} from './useVgPlotChartRetention';\nimport {\n  assertChartDataPolicy,\n  createChartRuntimeIssueFromError,\n  type ChartDataPolicy,\n  type ChartRuntimeIssueContext,\n  type ChartRuntimeIssueReporter,\n} from './chart-runtime';\n\ntype PlotDomElement = HTMLElement | SVGSVGElement;\n\ntype QueryableMark = {\n  queryPending?: () => unknown;\n  queryResult?: (data: unknown) => unknown;\n  queryError?: (error: unknown) => unknown;\n};\n\ntype PlotInstance = {\n  marks?: Array<{destroy?: () => void} & QueryableMark>;\n  render?: () => Promise<unknown> | unknown;\n  setAttribute?: (name: string, value: unknown) => boolean;\n};\n\n/**\n * Symbols used to store original mark handlers before wrapping.\n * This allows wrapMarkHandlers to be idempotent - it stores the original\n * handlers once and reuses them on subsequent calls, preventing nested wrappers.\n */\nconst ORIGINAL_QUERY_PENDING = Symbol('originalQueryPending');\nconst ORIGINAL_QUERY_RESULT = Symbol('originalQueryResult');\nconst ORIGINAL_QUERY_ERROR = Symbol('originalQueryError');\n\n/**\n * QueryableMark extended with Symbol properties for storing original handlers.\n * Used internally by wrapMarkHandlers to detect and prevent re-wrapping.\n */\ntype MarkWithOriginals = QueryableMark & {\n  [ORIGINAL_QUERY_PENDING]?: () => unknown;\n  [ORIGINAL_QUERY_RESULT]?: (data: unknown) => unknown;\n  [ORIGINAL_QUERY_ERROR]?: (error: unknown) => unknown;\n};\n\nfunction getPlotInstance(element: object): PlotInstance | null {\n  let htmlElement = element as HTMLElement | null;\n\n  if (!htmlElement?.classList.contains('plot')) {\n    htmlElement = htmlElement?.querySelector('.plot') as HTMLElement | null;\n  }\n\n  const plot = (htmlElement as {value?: unknown}).value;\n\n  return plot && typeof plot === 'object' ? (plot as PlotInstance) : null;\n}\n\nfunction resizeChartElement(element: object, size: PlotSize): boolean {\n  const plot = getPlotInstance(element);\n  if (!plot?.setAttribute || !plot.render) {\n    return false;\n  }\n\n  const widthChanged = plot.setAttribute('width', size.width);\n  const heightChanged = plot.setAttribute('height', size.height);\n  if (widthChanged || heightChanged) {\n    void plot.render();\n  }\n  return true;\n}\n\nasync function createSpecChartElement(\n  spec: Spec,\n  size: PlotSize,\n  params?: Map<string, Param<any> | Selection>,\n): Promise<PlotDomElement> {\n  const sizedSpec = {\n    ...spec,\n    width: size.width,\n    height: size.height,\n  } as Spec;\n\n  const ast = await parseSpec(sizedSpec);\n  const options = params\n    ? {params: params as unknown as Map<string, Param<any>>}\n    : undefined;\n\n  return (await astToDOM(ast, options)).element;\n}\n\nfunction asPlotDomElement(element: object): PlotDomElement {\n  return element as PlotDomElement;\n}\n\nfunction attachPlotElement(container: HTMLElement, element: PlotDomElement) {\n  if (container.childNodes.length === 1 && container.firstChild === element) {\n    return;\n  }\n  container.replaceChildren(element);\n}\n\n/**\n * Checks the aggregate state of all chart marks and reports errors when all marks are done.\n * This function is called after mark handlers complete to determine if the chart succeeded or failed.\n *\n * @param chart - Retained chart with mark state tracking\n * @param onError - Callback invoked with first error when marks fail\n * @param runtimeIssueReporter - Optional reporter for runtime issues\n * @param runtimeIssueContext - Context for runtime issue reporting\n * @param dataPolicy - Optional policy for validating chart data\n */\nfunction checkAndReportAggregateState(\n  chart: RetainedVgPlotChart,\n  onError: (error: Error) => void,\n  runtimeIssueReporter: ChartRuntimeIssueReporter | undefined,\n  runtimeIssueContext: ChartRuntimeIssueContext | undefined,\n  dataPolicy: ChartDataPolicy | null | undefined,\n) {\n  if (!chart.markStates || chart.markStates.size === 0) {\n    return; // No marks tracked yet\n  }\n\n  // Check if all marks are done (only success or error, not pending or idle)\n  const allDone = Array.from(chart.markStates.values()).every(\n    (state) => state === 'success' || state === 'error',\n  );\n\n  if (!allDone) {\n    return; // Wait for all marks to finish\n  }\n\n  // All marks done - determine aggregate state\n  const hasError = Array.from(chart.markStates.values()).some(\n    (state) => state === 'error',\n  );\n\n  if (hasError) {\n    // Find first error\n    const firstErrorMark = Array.from(chart.markStates.entries()).find(\n      ([, state]) => state === 'error',\n    )?.[0];\n    const error = firstErrorMark && chart.markErrors?.get(firstErrorMark);\n\n    if (error) {\n      chart.error = error; // For standalone case\n      onError(error);\n      if (runtimeIssueContext) {\n        runtimeIssueReporter?.reportIssue(\n          createChartRuntimeIssueFromError(\n            error,\n            runtimeIssueContext,\n            dataPolicy,\n          ),\n        );\n      }\n    }\n  } else {\n    // All successful\n    delete chart.error;\n    runtimeIssueReporter?.clearIssue();\n  }\n}\n\n/**\n * Wraps chart mark handlers (queryPending, queryResult, queryError) to track state and report errors.\n * This function is idempotent - it stores original handlers in Symbols and only wraps once.\n * Subsequent calls update the closures with fresh dataPolicy/runtimeIssue reporters without nesting wrappers.\n *\n * Pre-populates all queryable marks with 'idle' state for proper aggregate state tracking.\n *\n * @param chart - Retained chart whose marks will be wrapped\n * @param onError - Callback invoked when mark errors occur\n * @param dataPolicy - Optional policy for validating chart data\n * @param runtimeIssueContext - Context for runtime issue reporting\n * @param runtimeIssueReporter - Optional reporter for runtime issues\n */\nfunction wrapMarkHandlers(\n  chart: RetainedVgPlotChart,\n  onError: (error: Error) => void,\n  dataPolicy?: ChartDataPolicy | null,\n  runtimeIssueContext?: ChartRuntimeIssueContext,\n  runtimeIssueReporter?: ChartRuntimeIssueReporter,\n) {\n  const plot = getPlotInstance(chart.element);\n  if (!plot?.marks) {\n    return;\n  }\n\n  // Initialize tracking\n  if (!chart.markStates) {\n    chart.markStates = new Map();\n  }\n  if (!chart.markErrors) {\n    chart.markErrors = new Map();\n  }\n\n  plot.marks.forEach((mark: QueryableMark) => {\n    const markWithOriginals = mark as MarkWithOriginals;\n\n    // Pre-populate tracking for all queryable marks\n    if (mark.queryPending || mark.queryResult || mark.queryError) {\n      chart.markStates!.set(mark, 'idle');\n    }\n\n    // Wrap queryPending - store original if not already stored\n    if (mark.queryPending) {\n      if (!markWithOriginals[ORIGINAL_QUERY_PENDING]) {\n        markWithOriginals[ORIGINAL_QUERY_PENDING] = mark.queryPending;\n      }\n      const originalPending = markWithOriginals[ORIGINAL_QUERY_PENDING]!;\n      mark.queryPending = function (this: QueryableMark) {\n        chart.markStates!.set(mark, 'pending');\n        return originalPending.call(this);\n      };\n    }\n\n    // Wrap queryResult - store original if not already stored\n    if (mark.queryResult) {\n      if (!markWithOriginals[ORIGINAL_QUERY_RESULT]) {\n        markWithOriginals[ORIGINAL_QUERY_RESULT] = mark.queryResult;\n      }\n      const originalQueryResult = markWithOriginals[ORIGINAL_QUERY_RESULT]!;\n      mark.queryResult = function (this: QueryableMark, data: unknown) {\n        try {\n          assertChartDataPolicy(dataPolicy, data);\n          chart.markStates!.set(mark, 'success');\n          chart.markErrors!.delete(mark);\n          checkAndReportAggregateState(\n            chart,\n            onError,\n            runtimeIssueReporter,\n            runtimeIssueContext,\n            dataPolicy,\n          );\n          return originalQueryResult.call(this, data);\n        } catch (error) {\n          const normalizedError =\n            error instanceof Error ? error : new Error(String(error));\n          chart.markStates!.set(mark, 'error');\n          chart.markErrors!.set(mark, normalizedError);\n          checkAndReportAggregateState(\n            chart,\n            onError,\n            runtimeIssueReporter,\n            runtimeIssueContext,\n            dataPolicy,\n          );\n          if (markWithOriginals[ORIGINAL_QUERY_ERROR]) {\n            return markWithOriginals[ORIGINAL_QUERY_ERROR].call(\n              this,\n              normalizedError,\n            );\n          }\n          return undefined;\n        }\n      };\n    }\n\n    // Wrap queryError - store original if not already stored\n    if (mark.queryError) {\n      if (!markWithOriginals[ORIGINAL_QUERY_ERROR]) {\n        markWithOriginals[ORIGINAL_QUERY_ERROR] = mark.queryError;\n      }\n      const originalQueryError = markWithOriginals[ORIGINAL_QUERY_ERROR]!;\n      mark.queryError = function (this: QueryableMark, error: unknown) {\n        const normalizedError =\n          error instanceof Error ? error : new Error(String(error));\n\n        chart.markStates?.set(mark, 'error');\n        chart.markErrors?.set(mark, normalizedError);\n\n        checkAndReportAggregateState(\n          chart,\n          onError,\n          runtimeIssueReporter,\n          runtimeIssueContext,\n          dataPolicy,\n        );\n        return originalQueryError.call(this, error);\n      };\n    }\n  });\n}\n\ntype UseVgPlotChartRenderParams = {\n  containerRef: React.RefObject<HTMLDivElement | null>;\n  spec: Spec;\n  specKey: string | null;\n  params?: Map<string, Param<any> | Selection>;\n  containerSize: PlotSize | null;\n  cachedChart: RetainedVgPlotChart | null;\n  onChartCreated: (chart: RetainedVgPlotChart) => void;\n  onError: (error: Error) => void;\n  dataPolicy?: ChartDataPolicy | null;\n  runtimeIssueContext?: ChartRuntimeIssueContext;\n  runtimeIssueReporter?: ChartRuntimeIssueReporter;\n};\n\n/**\n * Hook to handle chart rendering lifecycle: creating, caching, and displaying vgplot charts.\n */\nexport function useVgPlotChartRender({\n  containerRef,\n  spec,\n  specKey,\n  params,\n  containerSize,\n  cachedChart,\n  onChartCreated,\n  onError,\n  dataPolicy,\n  runtimeIssueContext,\n  runtimeIssueReporter,\n}: UseVgPlotChartRenderParams) {\n  const renderVersionRef = useRef(0);\n\n  useLayoutEffect(() => {\n    const container = containerRef.current;\n    if (!container) {\n      return;\n    }\n\n    if (cachedChart) {\n      // Check aggregate state before clearing to preserve error state\n      checkAndReportAggregateState(\n        cachedChart,\n        onError,\n        runtimeIssueReporter,\n        runtimeIssueContext,\n        dataPolicy,\n      );\n\n      // Clear mark states when reusing cached chart - marks will re-register on next query\n      if (cachedChart.markStates) {\n        cachedChart.markStates.clear();\n      }\n      if (cachedChart.markErrors) {\n        cachedChart.markErrors.clear();\n      }\n      attachPlotElement(container, asPlotDomElement(cachedChart.element));\n      if (containerSize) {\n        resizeChartElement(cachedChart.element, containerSize);\n      }\n\n      // Re-wrap mark handlers with fresh closures for dataPolicy/runtimeIssue reporting\n      wrapMarkHandlers(\n        cachedChart,\n        onError,\n        dataPolicy,\n        runtimeIssueContext,\n        runtimeIssueReporter,\n      );\n\n      return;\n    }\n\n    if (!containerSize) {\n      return;\n    }\n\n    // Clear any previous runtime issues when starting to render a new chart spec\n    // This ensures stale errors don't persist when the chart configuration changes\n    runtimeIssueReporter?.clearIssue();\n\n    // Create new chart\n    const renderVersion = ++renderVersionRef.current;\n    let cancelled = false;\n\n    void createSpecChartElement(spec, containerSize, params)\n      .then((element) => {\n        if (\n          cancelled ||\n          renderVersion !== renderVersionRef.current ||\n          !containerRef.current\n        ) {\n          return;\n        }\n\n        const nextChart: RetainedVgPlotChart = {\n          element,\n          params,\n          specKey: specKey ?? JSON.stringify(spec),\n        };\n\n        onChartCreated(nextChart);\n        attachPlotElement(containerRef.current, element);\n\n        // Wrap marks with runtime handlers\n        wrapMarkHandlers(\n          nextChart,\n          onError,\n          dataPolicy,\n          runtimeIssueContext,\n          runtimeIssueReporter,\n        );\n      })\n      .catch((error) => {\n        if (cancelled) {\n          return;\n        }\n\n        // Normalize error to Error instance\n        const normalizedError =\n          error instanceof Error ? error : new Error(String(error));\n        onError(normalizedError);\n        if (runtimeIssueContext) {\n          runtimeIssueReporter?.reportIssue({\n            kind: 'render-error',\n            panelId: runtimeIssueContext.panelId,\n            chartType: runtimeIssueContext.chartType,\n            message: normalizedError.message,\n            recoverable: false,\n          });\n        }\n        console.error('[VgPlotChart] Error rendering chart:', normalizedError);\n      });\n\n    return () => {\n      cancelled = true;\n    };\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [\n    containerSize,\n    specKey,\n    cachedChart,\n    onChartCreated,\n    onError,\n    dataPolicy,\n    runtimeIssueContext,\n    runtimeIssueReporter,\n  ]);\n}\n"]}

package/dist/useVgPlotChartRetention.d.ts

@@ -1,9 +1,19 @@
 import { Param, Selection } from '@uwdata/mosaic-core';
+/**
+ * State of a chart mark during its lifecycle.
+ * - idle: Mark is registered but has not started querying
+ * - pending: Mark is actively querying data
+ * - success: Mark query completed successfully
+ * - error: Mark query failed with an error
+ */
+type MarkState = 'idle' | 'pending' | 'success' | 'error';
 export type RetainedVgPlotChart = {
     element: object;
     params?: Map<string, Param<any> | Selection>;
     specKey: string;
     error?: Error;
+    markStates?: Map<object, MarkState>;
+    markErrors?: Map<object, Error>;
 };
 export type VgPlotChartRetention = {
     chart?: RetainedVgPlotChart;
@@ -18,4 +28,5 @@ export declare function useVgPlotChartRetention(specKey: string | null, params:
     getCachedChart: () => RetainedVgPlotChart | null;
     setCachedChart: (chart: RetainedVgPlotChart) => void;
 };
+export {};
 //# sourceMappingURL=useVgPlotChartRetention.d.ts.map

package/dist/useVgPlotChartRetention.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useVgPlotChartRetention.d.ts","sourceRoot":"","sources":["../src/useVgPlotChartRetention.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,EAAE,SAAS,EAAC,MAAM,qBAAqB,CAAC;AAGrD,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAC5B,QAAQ,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;CAChD,CAAC;AAaF,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,mBAAmB,QAKpE;AAoBD;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,SAAS,EACvD,iBAAiB,CAAC,EAAE,oBAAoB;0BAaD,mBAAmB,GAAG,IAAI;4BA0BvD,mBAAmB;EAQ9B"}
+{"version":3,"file":"useVgPlotChartRetention.d.ts","sourceRoot":"","sources":["../src/useVgPlotChartRetention.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,EAAE,SAAS,EAAC,MAAM,qBAAqB,CAAC;AAGrD;;;;;;GAMG;AACH,KAAK,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAE1D,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACpC,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAC5B,QAAQ,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;CAChD,CAAC;AAaF,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,mBAAmB,QAKpE;AAoBD;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,SAAS,EACvD,iBAAiB,CAAC,EAAE,oBAAoB;0BAaD,mBAAmB,GAAG,IAAI;4BA0BvD,mBAAmB;EAQ9B"}

package/dist/useVgPlotChartRetention.js.map

@@ -1 +1 @@
-{"version":3,"file":"useVgPlotChartRetention.js","sourceRoot":"","sources":["../src/useVgPlotChartRetention.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,WAAW,EAAE,SAAS,EAAE,MAAM,EAAC,MAAM,OAAO,CAAC;AAoBrD,SAAS,eAAe,CAAC,OAAe;IACtC,MAAM,IAAI,GAAI,OAA2C,CAAC,KAAK,CAAC;IAChE,OAAO,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAE,IAAqB,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,KAA0B;IACnE,MAAM,IAAI,GAAG,eAAe,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC5C,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAC5B,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;IACnB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,mBAAmB,CAC1B,IAA0C,EAC1C,KAA2C;IAE3C,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;QAChC,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC;YAC7B,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAAsB,EACtB,MAAuD,EACvD,iBAAwC;IAExC,MAAM,aAAa,GAAG,MAAM,CAA6B,IAAI,CAAC,CAAC;IAE/D,uCAAuC;IACvC,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,KAAK,GAAG,aAAa,CAAC,OAAO,CAAC;QACpC,IAAI,KAAK,IAAI,KAAK,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;YACvC,0BAA0B,CAAC,KAAK,CAAC,CAAC;YAClC,aAAa,CAAC,OAAO,GAAG,IAAI,CAAC;QAC/B,CAAC;IACH,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEd,MAAM,cAAc,GAAG,WAAW,CAAC,GAA+B,EAAE;QAClE,MAAM,MAAM,GAAG,iBAAiB,EAAE,KAAK,CAAC;QACxC,MAAM,KAAK,GAAG,aAAa,CAAC,OAAO,CAAC;QAEpC,wBAAwB;QACxB,IACE,KAAK;YACL,KAAK,CAAC,OAAO,KAAK,OAAO;YACzB,mBAAmB,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,EACzC,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,qBAAqB;QACrB,IACE,MAAM;YACN,MAAM,CAAC,OAAO,KAAK,OAAO;YAC1B,mBAAmB,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC1C,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAEzC,MAAM,cAAc,GAAG,WAAW,CAChC,CAAC,KAA0B,EAAE,EAAE;QAC7B,aAAa,CAAC,OAAO,GAAG,KAAK,CAAC;QAC9B,iBAAiB,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,EACD,CAAC,iBAAiB,CAAC,CACpB,CAAC;IAEF,OAAO,EAAC,cAAc,EAAE,cAAc,EAAC,CAAC;AAC1C,CAAC","sourcesContent":["import {Param, Selection} from '@uwdata/mosaic-core';\nimport {useCallback, useEffect, useRef} from 'react';\n\nexport type RetainedVgPlotChart = {\n  element: object;\n  params?: Map<string, Param<any> | Selection>;\n  specKey: string;\n  error?: Error;\n};\n\nexport type VgPlotChartRetention = {\n  chart?: RetainedVgPlotChart;\n  setChart: (chart: RetainedVgPlotChart) => void;\n};\n\ntype PlotInstance = {\n  marks?: Array<{destroy?: () => void}>;\n  render?: () => Promise<unknown> | unknown;\n  setAttribute?: (name: string, value: unknown) => boolean;\n};\n\nfunction getPlotInstance(element: object): PlotInstance | null {\n  const plot = (element as HTMLElement & {value?: unknown}).value;\n  return plot && typeof plot === 'object' ? (plot as PlotInstance) : null;\n}\n\nexport function destroyRetainedVgPlotChart(chart: RetainedVgPlotChart) {\n  const plot = getPlotInstance(chart.element);\n  plot?.marks?.forEach((mark) => {\n    mark.destroy?.();\n  });\n}\n\nfunction areEquivalentParams(\n  left?: Map<string, Param<any> | Selection>,\n  right?: Map<string, Param<any> | Selection>,\n) {\n  if (left === right) {\n    return true;\n  }\n  if (!left || !right || left.size !== right.size) {\n    return false;\n  }\n  for (const [key, value] of left) {\n    if (right.get(key) !== value) {\n      return false;\n    }\n  }\n  return true;\n}\n\n/**\n * Hook to manage chart retention (caching) across spec changes.\n * Handles chart lifecycle: retrieval, storage, and cleanup.\n */\nexport function useVgPlotChartRetention(\n  specKey: string | null,\n  params: Map<string, Param<any> | Selection> | undefined,\n  externalRetention?: VgPlotChartRetention,\n) {\n  const localChartRef = useRef<RetainedVgPlotChart | null>(null);\n\n  // Clean up old chart when spec changes\n  useEffect(() => {\n    const local = localChartRef.current;\n    if (local && local.specKey !== specKey) {\n      destroyRetainedVgPlotChart(local);\n      localChartRef.current = null;\n    }\n  }, [specKey]);\n\n  const getCachedChart = useCallback((): RetainedVgPlotChart | null => {\n    const cached = externalRetention?.chart;\n    const local = localChartRef.current;\n\n    // Try local cache first\n    if (\n      local &&\n      local.specKey === specKey &&\n      areEquivalentParams(local.params, params)\n    ) {\n      return local;\n    }\n\n    // Try external cache\n    if (\n      cached &&\n      cached.specKey === specKey &&\n      areEquivalentParams(cached.params, params)\n    ) {\n      return cached;\n    }\n\n    return null;\n  }, [specKey, params, externalRetention]);\n\n  const setCachedChart = useCallback(\n    (chart: RetainedVgPlotChart) => {\n      localChartRef.current = chart;\n      externalRetention?.setChart(chart);\n    },\n    [externalRetention],\n  );\n\n  return {getCachedChart, setCachedChart};\n}\n"]}
+{"version":3,"file":"useVgPlotChartRetention.js","sourceRoot":"","sources":["../src/useVgPlotChartRetention.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,WAAW,EAAE,SAAS,EAAE,MAAM,EAAC,MAAM,OAAO,CAAC;AA+BrD,SAAS,eAAe,CAAC,OAAe;IACtC,MAAM,IAAI,GAAI,OAA2C,CAAC,KAAK,CAAC;IAChE,OAAO,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAE,IAAqB,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,KAA0B;IACnE,MAAM,IAAI,GAAG,eAAe,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC5C,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAC5B,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;IACnB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,mBAAmB,CAC1B,IAA0C,EAC1C,KAA2C;IAE3C,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;QAChC,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC;YAC7B,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAAsB,EACtB,MAAuD,EACvD,iBAAwC;IAExC,MAAM,aAAa,GAAG,MAAM,CAA6B,IAAI,CAAC,CAAC;IAE/D,uCAAuC;IACvC,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,KAAK,GAAG,aAAa,CAAC,OAAO,CAAC;QACpC,IAAI,KAAK,IAAI,KAAK,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;YACvC,0BAA0B,CAAC,KAAK,CAAC,CAAC;YAClC,aAAa,CAAC,OAAO,GAAG,IAAI,CAAC;QAC/B,CAAC;IACH,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEd,MAAM,cAAc,GAAG,WAAW,CAAC,GAA+B,EAAE;QAClE,MAAM,MAAM,GAAG,iBAAiB,EAAE,KAAK,CAAC;QACxC,MAAM,KAAK,GAAG,aAAa,CAAC,OAAO,CAAC;QAEpC,wBAAwB;QACxB,IACE,KAAK;YACL,KAAK,CAAC,OAAO,KAAK,OAAO;YACzB,mBAAmB,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,EACzC,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,qBAAqB;QACrB,IACE,MAAM;YACN,MAAM,CAAC,OAAO,KAAK,OAAO;YAC1B,mBAAmB,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC1C,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAEzC,MAAM,cAAc,GAAG,WAAW,CAChC,CAAC,KAA0B,EAAE,EAAE;QAC7B,aAAa,CAAC,OAAO,GAAG,KAAK,CAAC;QAC9B,iBAAiB,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,EACD,CAAC,iBAAiB,CAAC,CACpB,CAAC;IAEF,OAAO,EAAC,cAAc,EAAE,cAAc,EAAC,CAAC;AAC1C,CAAC","sourcesContent":["import {Param, Selection} from '@uwdata/mosaic-core';\nimport {useCallback, useEffect, useRef} from 'react';\n\n/**\n * State of a chart mark during its lifecycle.\n * - idle: Mark is registered but has not started querying\n * - pending: Mark is actively querying data\n * - success: Mark query completed successfully\n * - error: Mark query failed with an error\n */\ntype MarkState = 'idle' | 'pending' | 'success' | 'error';\n\nexport type RetainedVgPlotChart = {\n  element: object;\n  params?: Map<string, Param<any> | Selection>;\n  specKey: string;\n  error?: Error;\n  markStates?: Map<object, MarkState>;\n  markErrors?: Map<object, Error>;\n};\n\nexport type VgPlotChartRetention = {\n  chart?: RetainedVgPlotChart;\n  setChart: (chart: RetainedVgPlotChart) => void;\n};\n\ntype PlotInstance = {\n  marks?: Array<{destroy?: () => void}>;\n  render?: () => Promise<unknown> | unknown;\n  setAttribute?: (name: string, value: unknown) => boolean;\n};\n\nfunction getPlotInstance(element: object): PlotInstance | null {\n  const plot = (element as HTMLElement & {value?: unknown}).value;\n  return plot && typeof plot === 'object' ? (plot as PlotInstance) : null;\n}\n\nexport function destroyRetainedVgPlotChart(chart: RetainedVgPlotChart) {\n  const plot = getPlotInstance(chart.element);\n  plot?.marks?.forEach((mark) => {\n    mark.destroy?.();\n  });\n}\n\nfunction areEquivalentParams(\n  left?: Map<string, Param<any> | Selection>,\n  right?: Map<string, Param<any> | Selection>,\n) {\n  if (left === right) {\n    return true;\n  }\n  if (!left || !right || left.size !== right.size) {\n    return false;\n  }\n  for (const [key, value] of left) {\n    if (right.get(key) !== value) {\n      return false;\n    }\n  }\n  return true;\n}\n\n/**\n * Hook to manage chart retention (caching) across spec changes.\n * Handles chart lifecycle: retrieval, storage, and cleanup.\n */\nexport function useVgPlotChartRetention(\n  specKey: string | null,\n  params: Map<string, Param<any> | Selection> | undefined,\n  externalRetention?: VgPlotChartRetention,\n) {\n  const localChartRef = useRef<RetainedVgPlotChart | null>(null);\n\n  // Clean up old chart when spec changes\n  useEffect(() => {\n    const local = localChartRef.current;\n    if (local && local.specKey !== specKey) {\n      destroyRetainedVgPlotChart(local);\n      localChartRef.current = null;\n    }\n  }, [specKey]);\n\n  const getCachedChart = useCallback((): RetainedVgPlotChart | null => {\n    const cached = externalRetention?.chart;\n    const local = localChartRef.current;\n\n    // Try local cache first\n    if (\n      local &&\n      local.specKey === specKey &&\n      areEquivalentParams(local.params, params)\n    ) {\n      return local;\n    }\n\n    // Try external cache\n    if (\n      cached &&\n      cached.specKey === specKey &&\n      areEquivalentParams(cached.params, params)\n    ) {\n      return cached;\n    }\n\n    return null;\n  }, [specKey, params, externalRetention]);\n\n  const setCachedChart = useCallback(\n    (chart: RetainedVgPlotChart) => {\n      localChartRef.current = chart;\n      externalRetention?.setChart(chart);\n    },\n    [externalRetention],\n  );\n\n  return {getCachedChart, setCachedChart};\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sqlrooms/mosaic",
-  "version": "0.29.0-rc.6",
+  "version": "0.29.0-rc.8",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/sqlrooms/sqlrooms.git"
@@ -44,17 +44,18 @@
   "dependencies": {
     "@observablehq/plot": "^0.6.17",
     "@paralleldrive/cuid2": "^3.0.0",
-    "@sqlrooms/codemirror": "0.29.0-rc.6",
-    "@sqlrooms/color-scales": "0.29.0-rc.6",
-    "@sqlrooms/data-table": "0.29.0-rc.6",
-    "@sqlrooms/db": "0.29.0-rc.6",
-    "@sqlrooms/documents": "0.29.0-rc.6",
-    "@sqlrooms/duckdb": "0.29.0-rc.6",
-    "@sqlrooms/layout": "0.29.0-rc.6",
-    "@sqlrooms/layout-config": "0.29.0-rc.6",
-    "@sqlrooms/room-store": "0.29.0-rc.6",
-    "@sqlrooms/ui": "0.29.0-rc.6",
-    "@sqlrooms/utils": "0.29.0-rc.6",
+    "@sqlrooms/blocks": "0.29.0-rc.8",
+    "@sqlrooms/codemirror": "0.29.0-rc.8",
+    "@sqlrooms/color-scales": "0.29.0-rc.8",
+    "@sqlrooms/data-table": "0.29.0-rc.8",
+    "@sqlrooms/db": "0.29.0-rc.8",
+    "@sqlrooms/documents": "0.29.0-rc.8",
+    "@sqlrooms/duckdb": "0.29.0-rc.8",
+    "@sqlrooms/layout": "0.29.0-rc.8",
+    "@sqlrooms/layout-config": "0.29.0-rc.8",
+    "@sqlrooms/room-store": "0.29.0-rc.8",
+    "@sqlrooms/ui": "0.29.0-rc.8",
+    "@sqlrooms/utils": "0.29.0-rc.8",
     "@uwdata/flechette": "^2.2.6",
     "@uwdata/mosaic-core": "^0.21.0",
     "@uwdata/mosaic-plot": "^0.21.0",
@@ -85,5 +86,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "fbf5ee8897c5c06306b5433d26378cf658b5b298"
+  "gitHead": "dcb1a51631c5fa87b49d3e78ae6c0023eccd4189"
 }

package/dist/boxplot/BoxPlotClient.d.ts

@@ -1,65 +0,0 @@
-import { MosaicClient, type Selection } from '@uwdata/mosaic-core';
-import type { FilterExpr } from '@uwdata/mosaic-sql';
-import { type ChartDataPolicy, type ChartRuntimeIssueContext, type ChartRuntimeIssueReporter } from '../chart-runtime';
-export type BoxPlotSummaryRow = {
-    category: unknown;
-    count: number;
-    lowerFence: number;
-    median: number;
-    q1: number;
-    q3: number;
-    upperFence: number;
-    whiskerHigh: number;
-    whiskerLow: number;
-};
-export type BoxPlotOutlierRow = {
-    category: unknown;
-    value: number;
-};
-export type BoxPlotState = {
-    error?: Error;
-    isLoading: boolean;
-    outliers: BoxPlotOutlierRow[];
-    summaries: BoxPlotSummaryRow[];
-    yBrush?: [number, number];
-};
-export type BoxPlotClientOptions = {
-    dataPolicy?: ChartDataPolicy | null;
-    onStateChange: (state: BoxPlotState) => void;
-    runtimeIssueContext?: ChartRuntimeIssueContext;
-    runtimeIssueReporter?: ChartRuntimeIssueReporter;
-    selection: Selection;
-    tableName: string;
-    x: string;
-    y: string;
-};
-export declare function buildBoxPlotQuery(args: {
-    filter?: FilterExpr | null;
-    tableName: string;
-    x: string;
-    y: string;
-}): string;
-export declare class BoxPlotClient extends MosaicClient {
-    private readonly onStateChange;
-    private readonly tableName;
-    private readonly x;
-    private readonly y;
-    private readonly selection;
-    private readonly dataPolicy?;
-    private readonly runtimeIssueContext?;
-    private readonly runtimeIssueReporter?;
-    private state;
-    private destroyed;
-    constructor(options: BoxPlotClientOptions);
-    get filterStable(): boolean;
-    fields(): string[];
-    private emitState;
-    queryPending(): this;
-    query(filter?: FilterExpr | null): string;
-    queryResult(data: unknown): this;
-    queryError(error: Error): this;
-    updateYBrush(extent?: [number, number]): void;
-    reset(): void;
-    destroy(): void;
-}
-//# sourceMappingURL=BoxPlotClient.d.ts.map

package/dist/boxplot/BoxPlotClient.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"BoxPlotClient.d.ts","sourceRoot":"","sources":["../../src/boxplot/BoxPlotClient.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EAEZ,KAAK,SAAS,EACf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAW,UAAU,EAAC,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC/B,MAAM,kBAAkB,CAAC;AAE1B,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,UAAU,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IACpC,aAAa,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IAC7C,mBAAmB,CAAC,EAAE,wBAAwB,CAAC;IAC/C,oBAAoB,CAAC,EAAE,yBAAyB,CAAC;IACjD,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX,CAAC;AAkFF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX,GAAG,MAAM,CAiFT;AAED,qBAAa,aAAc,SAAQ,YAAY;IAC7C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgC;IAC9D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAyB;IACrD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAA2B;IAChE,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAA4B;IAClE,OAAO,CAAC,KAAK,CAIX;IACF,OAAO,CAAC,SAAS,CAAS;gBAEd,OAAO,EAAE,oBAAoB;IAYzC,IAAa,YAAY,IAAI,OAAO,CAEnC;IAED,MAAM,IAAI,MAAM,EAAE;IAIlB,OAAO,CAAC,SAAS;IAQR,YAAY,IAAI,IAAI;IAKpB,KAAK,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI,GAAG,MAAM;IASzC,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IA6EhC,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAcvC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;IAStC,KAAK;IAII,OAAO;CAIjB"}