@sqlrooms/mosaic 0.29.0-rc.7 → 0.29.0-rc.9

package/dist/useVgPlotChartRender.js

@@ -1,8 +1,45 @@
 import { astToDOM, parseSpec } from '@uwdata/mosaic-spec';
 import { useLayoutEffect, useRef } from 'react';
 import { assertChartDataPolicy, createChartRuntimeIssueFromError, } from './chart-runtime';
+import { getMosaicSqlTableReference } from './mosaicTableReference';
+function normalizeSpecTableReferences(value, key) {
+    if (Array.isArray(value)) {
+        return value.map((item) => normalizeSpecTableReferences(item, key));
+    }
+    if (!value || typeof value !== 'object') {
+        return value;
+    }
+    const prototype = Object.getPrototypeOf(value);
+    if (prototype !== Object.prototype && prototype !== null) {
+        return value;
+    }
+    const entries = Object.entries(value).map(([entryKey, entryValue]) => [
+        entryKey,
+        normalizeSpecTableReferences(entryValue, entryKey),
+    ]);
+    const normalized = Object.fromEntries(entries);
+    if (key === 'data' &&
+        typeof normalized.from === 'string' &&
+        normalized.from.trim() &&
+        !normalized.from.trim().startsWith('$')) {
+        normalized.from = getMosaicSqlTableReference(normalized.from.trim());
+    }
+    return normalized;
+}
+/**
+ * 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) {
@@ -23,7 +60,7 @@ async function createSpecChartElement(spec, size, params) {
         width: size.width,
         height: size.height,
     };
-    const ast = await parseSpec(sizedSpec);
+    const ast = await parseSpec(normalizeSpecTableReferences(sizedSpec));
     const options = params
         ? { params: params }
         : undefined;
@@ -38,44 +75,125 @@ function attachPlotElement(container, element) {
     }
     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);
             };
         }
     });
@@ -91,21 +209,29 @@ export function useVgPlotChartRender({ containerRef, spec, specKey, params, cont
             return;
         }
         if (cachedChart) {
+            // 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;

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 {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  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 attachPlotElement(\n  container: HTMLElement,\n  element: PlotDomElement,\n) {\n  if (container.childNodes.length === 1 && container.firstChild === element) {\n    return;\n  }\n  container.replaceChildren(element);\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  useLayoutEffect(() => {\n    const container = containerRef.current;\n    if (!container) {\n      return;\n    }\n\n    if (cachedChart) {\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      // Restore error state from cached chart\n      if (cachedChart.error) {\n        onError(cachedChart.error);\n      }\n\n      return;\n    }\n\n    if (!containerSize) {\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        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"]}
+{"version":3,"file":"useVgPlotChartRender.js","sourceRoot":"","sources":["../src/useVgPlotChartRender.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,QAAQ,EAAE,SAAS,EAAO,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAC,eAAe,EAAE,MAAM,EAAC,MAAM,OAAO,CAAC;AAG9C,OAAO,EACL,qBAAqB,EACrB,gCAAgC,GAIjC,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAC,0BAA0B,EAAC,MAAM,wBAAwB,CAAC;AAgBlE,SAAS,4BAA4B,CAAC,KAAc,EAAE,GAAY;IAChE,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,4BAA4B,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IACtE,CAAC;IAED,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAC/C,IAAI,SAAS,KAAK,MAAM,CAAC,SAAS,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACzD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC;QACpE,QAAQ;QACR,4BAA4B,CAAC,UAAU,EAAE,QAAQ,CAAC;KACnD,CAAC,CAAC;IACH,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,CAAC,OAAO,CAA4B,CAAC;IAE1E,IACE,GAAG,KAAK,MAAM;QACd,OAAO,UAAU,CAAC,IAAI,KAAK,QAAQ;QACnC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE;QACtB,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EACvC,CAAC;QACD,UAAU,CAAC,IAAI,GAAG,0BAA0B,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;GAIG;AACH,MAAM,sBAAsB,GAAG,MAAM,CAAC,sBAAsB,CAAC,CAAC;AAC9D,MAAM,qBAAqB,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC;AAC5D,MAAM,oBAAoB,GAAG,MAAM,CAAC,oBAAoB,CAAC,CAAC;AAY1D,SAAS,eAAe,CAAC,OAAe;IACtC,IAAI,WAAW,GAAG,OAA6B,CAAC;IAEhD,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7C,WAAW,GAAG,WAAW,EAAE,aAAa,CAAC,OAAO,CAAuB,CAAC;IAC1E,CAAC;IAED,MAAM,IAAI,GAAI,WAAiC,CAAC,KAAK,CAAC;IAEtD,OAAO,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAE,IAAqB,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1E,CAAC;AAED,SAAS,kBAAkB,CAAC,OAAe,EAAE,IAAc;IACzD,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IACtC,IAAI,CAAC,IAAI,EAAE,YAAY,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5D,MAAM,aAAa,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC/D,IAAI,YAAY,IAAI,aAAa,EAAE,CAAC;QAClC,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;IACrB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,KAAK,UAAU,sBAAsB,CACnC,IAAU,EACV,IAAc,EACd,MAA4C;IAE5C,MAAM,SAAS,GAAG;QAChB,GAAG,IAAI;QACP,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,MAAM,EAAE,IAAI,CAAC,MAAM;KACZ,CAAC;IAEV,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,4BAA4B,CAAC,SAAS,CAAS,CAAC,CAAC;IAC7E,MAAM,OAAO,GAAG,MAAM;QACpB,CAAC,CAAC,EAAC,MAAM,EAAE,MAA4C,EAAC;QACxD,CAAC,CAAC,SAAS,CAAC;IAEd,OAAO,CAAC,MAAM,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;AAChD,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAe;IACvC,OAAO,OAAyB,CAAC;AACnC,CAAC;AAED,SAAS,iBAAiB,CAAC,SAAsB,EAAE,OAAuB;IACxE,IAAI,SAAS,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,IAAI,SAAS,CAAC,UAAU,KAAK,OAAO,EAAE,CAAC;QAC1E,OAAO;IACT,CAAC;IACD,SAAS,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;AACrC,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,4BAA4B,CACnC,KAA0B,EAC1B,OAA+B,EAC/B,oBAA2D,EAC3D,mBAAyD,EACzD,UAA8C;IAE9C,IAAI,CAAC,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACrD,OAAO,CAAC,uBAAuB;IACjC,CAAC;IAED,2EAA2E;IAC3E,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CACzD,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,OAAO,CACpD,CAAC;IAEF,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,CAAC,+BAA+B;IACzC,CAAC;IAED,6CAA6C;IAC7C,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CACzD,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,OAAO,CAC7B,CAAC;IAEF,IAAI,QAAQ,EAAE,CAAC;QACb,mBAAmB;QACnB,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAChE,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,OAAO,CACjC,EAAE,CAAC,CAAC,CAAC,CAAC;QACP,MAAM,KAAK,GAAG,cAAc,IAAI,KAAK,CAAC,UAAU,EAAE,GAAG,CAAC,cAAc,CAAC,CAAC;QAEtE,IAAI,KAAK,EAAE,CAAC;YACV,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,sBAAsB;YAC3C,OAAO,CAAC,KAAK,CAAC,CAAC;YACf,IAAI,mBAAmB,EAAE,CAAC;gBACxB,oBAAoB,EAAE,WAAW,CAC/B,gCAAgC,CAC9B,KAAK,EACL,mBAAmB,EACnB,UAAU,CACX,CACF,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;SAAM,CAAC;QACN,iBAAiB;QACjB,OAAO,KAAK,CAAC,KAAK,CAAC;QACnB,oBAAoB,EAAE,UAAU,EAAE,CAAC;IACrC,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,SAAS,gBAAgB,CACvB,KAA0B,EAC1B,OAA+B,EAC/B,UAAmC,EACnC,mBAA8C,EAC9C,oBAAgD;IAEhD,MAAM,IAAI,GAAG,eAAe,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC5C,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;QACjB,OAAO;IACT,CAAC;IAED,sBAAsB;IACtB,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;QACtB,KAAK,CAAC,UAAU,GAAG,IAAI,GAAG,EAAE,CAAC;IAC/B,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;QACtB,KAAK,CAAC,UAAU,GAAG,IAAI,GAAG,EAAE,CAAC;IAC/B,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAmB,EAAE,EAAE;QACzC,MAAM,iBAAiB,GAAG,IAAyB,CAAC;QAEpD,gDAAgD;QAChD,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YAC7D,KAAK,CAAC,UAAW,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACtC,CAAC;QAED,2DAA2D;QAC3D,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,IAAI,CAAC,iBAAiB,CAAC,sBAAsB,CAAC,EAAE,CAAC;gBAC/C,iBAAiB,CAAC,sBAAsB,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC;YAChE,CAAC;YACD,MAAM,eAAe,GAAG,iBAAiB,CAAC,sBAAsB,CAAE,CAAC;YACnE,IAAI,CAAC,YAAY,GAAG;gBAClB,KAAK,CAAC,UAAW,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;gBACvC,OAAO,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpC,CAAC,CAAC;QACJ,CAAC;QAED,0DAA0D;QAC1D,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,IAAI,CAAC,iBAAiB,CAAC,qBAAqB,CAAC,EAAE,CAAC;gBAC9C,iBAAiB,CAAC,qBAAqB,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC;YAC9D,CAAC;YACD,MAAM,mBAAmB,GAAG,iBAAiB,CAAC,qBAAqB,CAAE,CAAC;YACtE,IAAI,CAAC,WAAW,GAAG,UAA+B,IAAa;gBAC7D,IAAI,CAAC;oBACH,qBAAqB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;oBACxC,KAAK,CAAC,UAAW,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;oBACvC,KAAK,CAAC,UAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;oBAC/B,4BAA4B,CAC1B,KAAK,EACL,OAAO,EACP,oBAAoB,EACpB,mBAAmB,EACnB,UAAU,CACX,CAAC;oBACF,OAAO,mBAAmB,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;gBAC9C,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,eAAe,GACnB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;oBAC5D,KAAK,CAAC,UAAW,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;oBACrC,KAAK,CAAC,UAAW,CAAC,GAAG,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;oBAC7C,4BAA4B,CAC1B,KAAK,EACL,OAAO,EACP,oBAAoB,EACpB,mBAAmB,EACnB,UAAU,CACX,CAAC;oBACF,IAAI,iBAAiB,CAAC,oBAAoB,CAAC,EAAE,CAAC;wBAC5C,OAAO,iBAAiB,CAAC,oBAAoB,CAAC,CAAC,IAAI,CACjD,IAAI,EACJ,eAAe,CAChB,CAAC;oBACJ,CAAC;oBACD,OAAO,SAAS,CAAC;gBACnB,CAAC;YACH,CAAC,CAAC;QACJ,CAAC;QAED,yDAAyD;QACzD,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,IAAI,CAAC,iBAAiB,CAAC,oBAAoB,CAAC,EAAE,CAAC;gBAC7C,iBAAiB,CAAC,oBAAoB,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC;YAC5D,CAAC;YACD,MAAM,kBAAkB,GAAG,iBAAiB,CAAC,oBAAoB,CAAE,CAAC;YACpE,IAAI,CAAC,UAAU,GAAG,UAA+B,KAAc;gBAC7D,MAAM,eAAe,GACnB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;gBAE5D,KAAK,CAAC,UAAU,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;gBACrC,KAAK,CAAC,UAAU,EAAE,GAAG,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;gBAE7C,4BAA4B,CAC1B,KAAK,EACL,OAAO,EACP,oBAAoB,EACpB,mBAAmB,EACnB,UAAU,CACX,CAAC;gBACF,OAAO,kBAAkB,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAC9C,CAAC,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAgBD;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,EACnC,YAAY,EACZ,IAAI,EACJ,OAAO,EACP,MAAM,EACN,aAAa,EACb,WAAW,EACX,cAAc,EACd,OAAO,EACP,UAAU,EACV,mBAAmB,EACnB,oBAAoB,GACO;IAC3B,MAAM,gBAAgB,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAEnC,eAAe,CAAC,GAAG,EAAE;QACnB,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,CAAC;QACvC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO;QACT,CAAC;QAED,IAAI,WAAW,EAAE,CAAC;YAChB,gEAAgE;YAChE,4BAA4B,CAC1B,WAAW,EACX,OAAO,EACP,oBAAoB,EACpB,mBAAmB,EACnB,UAAU,CACX,CAAC;YAEF,qFAAqF;YACrF,IAAI,WAAW,CAAC,UAAU,EAAE,CAAC;gBAC3B,WAAW,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;YACjC,CAAC;YACD,IAAI,WAAW,CAAC,UAAU,EAAE,CAAC;gBAC3B,WAAW,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;YACjC,CAAC;YACD,iBAAiB,CAAC,SAAS,EAAE,gBAAgB,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;YACpE,IAAI,aAAa,EAAE,CAAC;gBAClB,kBAAkB,CAAC,WAAW,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;YACzD,CAAC;YAED,kFAAkF;YAClF,gBAAgB,CACd,WAAW,EACX,OAAO,EACP,UAAU,EACV,mBAAmB,EACnB,oBAAoB,CACrB,CAAC;YAEF,OAAO;QACT,CAAC;QAED,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,OAAO;QACT,CAAC;QAED,6EAA6E;QAC7E,+EAA+E;QAC/E,oBAAoB,EAAE,UAAU,EAAE,CAAC;QAEnC,mBAAmB;QACnB,MAAM,aAAa,GAAG,EAAE,gBAAgB,CAAC,OAAO,CAAC;QACjD,IAAI,SAAS,GAAG,KAAK,CAAC;QAEtB,KAAK,sBAAsB,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,CAAC;aACrD,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;YAChB,IACE,SAAS;gBACT,aAAa,KAAK,gBAAgB,CAAC,OAAO;gBAC1C,CAAC,YAAY,CAAC,OAAO,EACrB,CAAC;gBACD,OAAO;YACT,CAAC;YAED,MAAM,SAAS,GAAwB;gBACrC,OAAO;gBACP,MAAM;gBACN,OAAO,EAAE,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;aACzC,CAAC;YAEF,cAAc,CAAC,SAAS,CAAC,CAAC;YAC1B,iBAAiB,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAEjD,mCAAmC;YACnC,gBAAgB,CACd,SAAS,EACT,OAAO,EACP,UAAU,EACV,mBAAmB,EACnB,oBAAoB,CACrB,CAAC;QACJ,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YACf,IAAI,SAAS,EAAE,CAAC;gBACd,OAAO;YACT,CAAC;YAED,oCAAoC;YACpC,MAAM,eAAe,GACnB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAC5D,OAAO,CAAC,eAAe,CAAC,CAAC;YACzB,IAAI,mBAAmB,EAAE,CAAC;gBACxB,oBAAoB,EAAE,WAAW,CAAC;oBAChC,IAAI,EAAE,cAAc;oBACpB,OAAO,EAAE,mBAAmB,CAAC,OAAO;oBACpC,SAAS,EAAE,mBAAmB,CAAC,SAAS;oBACxC,OAAO,EAAE,eAAe,CAAC,OAAO;oBAChC,WAAW,EAAE,KAAK;iBACnB,CAAC,CAAC;YACL,CAAC;YACD,OAAO,CAAC,KAAK,CAAC,sCAAsC,EAAE,eAAe,CAAC,CAAC;QACzE,CAAC,CAAC,CAAC;QAEL,OAAO,GAAG,EAAE;YACV,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC,CAAC;QACF,uDAAuD;IACzD,CAAC,EAAE;QACD,aAAa;QACb,OAAO;QACP,WAAW;QACX,cAAc;QACd,OAAO;QACP,UAAU;QACV,mBAAmB;QACnB,oBAAoB;KACrB,CAAC,CAAC;AACL,CAAC","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';\nimport {getMosaicSqlTableReference} from './mosaicTableReference';\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\nfunction normalizeSpecTableReferences(value: unknown, key?: string): unknown {\n  if (Array.isArray(value)) {\n    return value.map((item) => normalizeSpecTableReferences(item, key));\n  }\n\n  if (!value || typeof value !== 'object') {\n    return value;\n  }\n\n  const prototype = Object.getPrototypeOf(value);\n  if (prototype !== Object.prototype && prototype !== null) {\n    return value;\n  }\n\n  const entries = Object.entries(value).map(([entryKey, entryValue]) => [\n    entryKey,\n    normalizeSpecTableReferences(entryValue, entryKey),\n  ]);\n  const normalized = Object.fromEntries(entries) as Record<string, unknown>;\n\n  if (\n    key === 'data' &&\n    typeof normalized.from === 'string' &&\n    normalized.from.trim() &&\n    !normalized.from.trim().startsWith('$')\n  ) {\n    normalized.from = getMosaicSqlTableReference(normalized.from.trim());\n  }\n\n  return normalized;\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(normalizeSpecTableReferences(sizedSpec) as Spec);\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/dist/utils/table-lookup.d.ts

@@ -0,0 +1,7 @@
+import type { DataTable } from '@sqlrooms/db';
+/**
+ * Returns the full table reference (database.schema.table) as a string,
+ * without SQL escaping (for UI display and matching).
+ */
+export declare function getTableReference(table: DataTable): string;
+//# sourceMappingURL=table-lookup.d.ts.map

package/dist/utils/table-lookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-lookup.d.ts","sourceRoot":"","sources":["../../src/utils/table-lookup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAE5C;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAI1D"}

package/dist/utils/table-lookup.js

@@ -0,0 +1,10 @@
+/**
+ * Returns the full table reference (database.schema.table) as a string,
+ * without SQL escaping (for UI display and matching).
+ */
+export function getTableReference(table) {
+    return [table.table.database, table.table.schema, table.table.table]
+        .filter((part) => Boolean(part))
+        .join('.');
+}
+//# sourceMappingURL=table-lookup.js.map

package/dist/utils/table-lookup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-lookup.js","sourceRoot":"","sources":["../../src/utils/table-lookup.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAgB;IAChD,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC;SACjE,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;SAC/C,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC","sourcesContent":["import type {DataTable} from '@sqlrooms/db';\n\n/**\n * Returns the full table reference (database.schema.table) as a string,\n * without SQL escaping (for UI display and matching).\n */\nexport function getTableReference(table: DataTable): string {\n  return [table.table.database, table.table.schema, table.table.table]\n    .filter((part): part is string => Boolean(part))\n    .join('.');\n}\n"]}

package/package.json

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

package/dist/ai/ai.d.ts

@@ -1,103 +0,0 @@
-/**
- * Reusable AI helpers for Mosaic dashboards.
- *
- * Host apps provide a narrow adapter for their store/artifact model; Mosaic owns
- * the dashboard tool behavior and prompts.
- *
- * @packageDocumentation
- */
-import { type LanguageModel, type Tool, ToolLoopAgent } from 'ai';
-import { type ChartBuilderColumn, type ChartToolExecutionContext, type DashboardToolDeps, type PanelPatch, type ChartTypeDefinition } from '../charts/chart-types';
-import type { MosaicDashboardEntry, MosaicDashboardPanelConfig } from '../dashboard/dashboard-types';
-import type { MosaicDashboardLayoutType } from '../dashboard/core-types';
-import { type ChartRuntimeIssue } from '../chart-runtime';
-export type { ChartToolExecutionContext } from '../charts/chart-types';
-export type DashboardAiStore<TState> = {
-    getState: () => TState;
-};
-export type DashboardAiTable = {
-    tableName: string;
-    columns?: ChartBuilderColumn[];
-    rowCount?: number;
-};
-export type DashboardAiAdapter<TState> = {
-    getTables: (state: TState) => DashboardAiTable[];
-    hasRunContext?: (state: TState, context?: ChartToolExecutionContext) => boolean;
-    resolveContextDashboardArtifactId?: (state: TState, context?: ChartToolExecutionContext) => string | undefined;
-    makeDashboardPrimaryForRun?: (state: TState, dashboardId: string, context?: ChartToolExecutionContext) => void;
-    getCurrentDashboardArtifactId: (state: TState) => string | undefined;
-    createDashboardArtifact: (state: TState, title?: string, layoutType?: MosaicDashboardLayoutType) => string;
-    isDashboardArtifact: (state: TState, artifactId: string) => boolean;
-    setCurrentArtifact: (state: TState, artifactId: string) => void;
-    ensureDashboard: (state: TState, dashboardId: string, title?: string, layoutType?: MosaicDashboardLayoutType) => void;
-    getDashboard: (state: TState, dashboardId: string) => MosaicDashboardEntry | undefined;
-    getPanelIssue?: (state: TState, dashboardId: string, panelId: string) => ChartRuntimeIssue | undefined;
-    setSelectedTable: (state: TState, dashboardId: string, tableName: string) => void;
-    addPanel: (state: TState, dashboardId: string, panel: MosaicDashboardPanelConfig) => string;
-    updatePanel: (state: TState, dashboardId: string, panelId: string, patch: Partial<PanelPatch>) => void;
-    removePanel: (state: TState, dashboardId: string, panelId: string) => void;
-};
-export type CreateDashboardToolDepsOptions<TState> = {
-    store: DashboardAiStore<TState>;
-    adapter: DashboardAiAdapter<TState>;
-};
-export type CreateDashboardAiToolsOptions<TState> = CreateDashboardToolDepsOptions<TState> & {
-    chartTypes?: ChartTypeDefinition<any>[];
-    /**
-     * Host-provided dashboard tools keyed by their registered tool name.
-     * Register geospatial map tools under MAP_TOOL_KEY so prompts and tools
-     * stay in sync.
-     */
-    extraTools?: (deps: DashboardToolDeps) => Record<string, Tool>;
-};
-export type DashboardAgentToolCall = {
-    toolName: string;
-};
-export type DashboardAgentRunResult = {
-    finalOutput?: string;
-    agentToolCalls?: DashboardAgentToolCall[];
-};
-export type DashboardAgentResult = {
-    success: boolean;
-    finalOutput: string;
-    dashboardId: string;
-    error?: string;
-    metadata?: {
-        tableName: string;
-        panelsCreated: number;
-        stepsExecuted: number;
-        queriesRun: number;
-    };
-};
-export type CreateDashboardAgentToolOptions<TState> = CreateDashboardToolDepsOptions<TState> & {
-    getModel: (args: {
-        state: TState;
-    }) => LanguageModel;
-    createQueryTools?: (args: {
-        store: DashboardAiStore<TState>;
-    }) => {
-        query: Tool;
-    };
-    runSubAgent: (args: {
-        agent: ToolLoopAgent<any, any, any>;
-        prompt: string;
-        store: DashboardAiStore<TState>;
-        parentToolCallId: string;
-        abortSignal?: AbortSignal;
-    }) => Promise<DashboardAgentRunResult>;
-    instructions?: string;
-    chartTypes?: ChartTypeDefinition<any>[];
-    /**
-     * Host-provided dashboard tools keyed by their registered tool name.
-     * Register geospatial map tools under MAP_TOOL_KEY so prompts and tools
-     * stay in sync.
-     */
-    extraTools?: (deps: DashboardToolDeps) => Record<string, Tool>;
-};
-export declare const MAP_TOOL_KEY = "create_dashboard_map";
-export declare const DASHBOARD_AI_INSTRUCTIONS = "\nDashboard authoring:\n\n**When to use dashboard_agent vs individual tools:**\n- Use `dashboard_agent` for exploratory requests that require data analysis and discovery:\n  - \"analyze the earthquakes dataset\"\n  - \"create insights dashboard for sales data\"\n  - \"find interesting patterns in customer behavior\"\n  - Any request asking to \"discover\", \"explore\", \"find insights\", or \"analyze\"\n- Use individual chart tools for direct, specific requests:\n  - \"create histogram of magnitude with 20 bins\"\n  - \"add a line chart showing sales over time\"\n  - \"update the histogram to use 30 bins\"\n\n**Individual dashboard chart tools:**\n- create_dashboard_histogram, create_dashboard_line_chart, create_dashboard_box_plot, create_dashboard_bubble_chart, create_dashboard_count_plot, create_dashboard_heatmap\n- Each chart type has its own tool with specific parameters.\n- For line charts with aggregation, use yFields array with {field: string, aggregate: \"sum\"|\"avg\"|\"min\"|\"max\"}.\n- Set xInterval for temporal binning (year, month, day, hour, etc.).\n- If the host app provides `create_dashboard_map`, use it for map/geospatial/location requests and tables with longitude/latitude or geometry columns. Author its config as native Deck JSON with layer classes in `spec.layers[].@@type`, dataset bindings in `_sqlroomsBinding.dataset`, and table/query sources in `config.datasets`. For data-driven map colors, use color accessors such as `getFillColor`, `getLineColor`, `getColor`, `getSourceColor`, or `getTargetColor` with `{\"@@function\":\"colorScale\", \"field\":\"...\", \"type\":\"sequential\"|\"diverging\"|\"quantize\"|\"quantile\"|\"categorical\", \"scheme\":\"Viridis\", \"domain\":\"auto\"}`.\n- Use `set_dashboard_vgplot` with complete JSON only when no chart tool fits your needs.\n- When calling `create_dashboard_artifact`, `layoutType` may be `grid` or `dock`; omitted values default to `grid`.\n- Ensure specs are valid JSON objects compatible with https://idl.uw.edu/mosaic/schema/latest.json.\n- `list_dashboard_panels` includes runtime issues when a chart failed. Use those issues to repair panels in place: convert too-large bubble charts to heatmaps, add `xInterval` to too-large line charts, and inspect columns/settings for SQL errors.\n";
-export declare const DASHBOARD_AGENT_INSTRUCTIONS = "You are a dashboard builder agent that creates and modifies interactive data dashboards.\n\n## Your Role\n\nYou analyze data and create insightful dashboards with multiple visualizations (charts, Data Table Explorers). You can handle both direct requests (\"create histogram of magnitude\") and exploratory requests (\"find interesting insights in earthquakes dataset\").\n\n## Available Tools\n\n**Chart Tools:**\n- create_dashboard_histogram - distribution of numeric values (always safe, aggregates automatically)\n- create_dashboard_line_chart - trends over time or ordered variable (use with aggregations for >10k rows)\n- create_dashboard_box_plot - compare distributions across categories\n- create_dashboard_bubble_chart - relationship between two numeric columns (avoid for >10k rows, use heatmap instead)\n- create_dashboard_count_plot - frequency of categorical values (always safe, aggregates automatically)\n- create_dashboard_heatmap - density/patterns across two dimensions (preferred for large datasets)\n\n**Panel Tools:**\n- create_dashboard_data_table_explorer - table statistics and column summaries\n- create_dashboard_map - native Deck JSON geospatial map panel (if provided by the host app)\n\n**Data Tools:**\n- query - execute SQL queries for data exploration\n\n**Management Tools:**\n- list_dashboard_panels - discover panel IDs and what's on the dashboard\n- remove_dashboard_panel - delete a panel by ID\n\n## Workflows\n\n### Direct Requests\nWhen user provides specific instructions:\n1. Parse intent -> identify chart type\n2. Call appropriate tool with settings\n3. Done\n\nExample: \"create histogram of magnitude with 20 bins\"\n-> create_dashboard_histogram(settings: {field: \"magnitude\", bins: 20})\n\n### Exploratory Requests\nWhen user asks to discover insights:\n1. Use query tool to explore data:\n   - Start with simple stats: COUNT, MIN, MAX, AVG, DISTINCT (check total row count!)\n   - Check distributions: GROUP BY with COUNT\n   - Find correlations: CORR(col1, col2)\n   - Identify outliers and patterns\n2. Create targeted charts based on discoveries:\n   - If dataset has >10k rows: avoid bubble charts and unaggregated line charts\n   - Use histogram, count plot, heatmap, or aggregated visualizations instead\n3. Stop when dashboard tells coherent story\n\n### Update Requests\nTo update existing panels:\n1. Call list_dashboard_panels() to discover panel IDs\n2. Call appropriate create tool with panelId parameter\n3. Panel is updated in-place\n\n## Query Guidelines\n\n**Keep queries simple:**\n- Start with aggregations: COUNT, MIN, MAX, AVG, SUM\n- Use GROUP BY for breakdowns and distributions\n- Use LIMIT to control result size (especially with GROUP BY)\n- Avoid expensive operations: large JOINs, full table scans\n\n**Exploration strategy:**\n- Limit exploration to 5-10 queries per request\n- Start broad (overall stats), then narrow (specific patterns)\n- Stop when you have enough insights for a coherent dashboard\n\n## Best Practices\n\n- **Avoid unaggregated charts for large datasets:** For datasets >10k rows, DO NOT use bubble charts or line charts without aggregations. Use aggregated alternatives instead:\n  - For scatter/bubble plots: use heatmap or binned aggregations\n  - For line charts: use GROUP BY with time buckets or aggregations\n  - Histograms and count plots are always safe (they aggregate automatically)\n- **Check before update:** Always call list_dashboard_panels before updating/removing panels\n- **Repair broken charts:** list_dashboard_panels may return an `issue` per panel. For `too-much-data`, switch to an aggregated chart or add aggregation. For `sql-error`, inspect available columns/types and update the broken panel in place.\n- **Validate columns:** Query tools will validate column existence and types\n- **Handle errors gracefully:** If a query or chart creation fails, try alternative approach";
-export declare function createDashboardToolDeps<TState>({ store, adapter, }: CreateDashboardToolDepsOptions<TState>): DashboardToolDeps;
-export declare function createDashboardAiTools<TState>({ store, adapter, chartTypes, extraTools, }: CreateDashboardAiToolsOptions<TState>): Record<string, Tool>;
-export declare function createDashboardAgentTool<TState>(options: CreateDashboardAgentToolOptions<TState>): Tool;
-//# sourceMappingURL=ai.d.ts.map

package/dist/ai/ai.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../../src/ai/ai.ts"],"names":[],"mappings":"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"}