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

package/dist/mosaicTableReference.js

@@ -0,0 +1,68 @@
+import { parseQualifiedSqlIdentifier, escapeId, resolveTableReference, } from '@sqlrooms/db';
+import { asTableRef } from '@uwdata/mosaic-sql';
+/**
+ * Converts SQLRooms table identity into a Mosaic query table reference.
+ *
+ * SQLRooms keeps the DuckDB catalog/database in QualifiedTableName for stable
+ * identity, but Mosaic queries execute against the active connector. Including
+ * that catalog in generated SQL can target a catalog that is not attached in
+ * the query connection. Mosaic also is not quote-aware when parsing table
+ * strings, so return a TableRefNode for generated SQL.
+ */
+export function getMosaicSqlTableReference(tableName) {
+    return asTableRef(getMosaicTableReferenceParts(tableName));
+}
+/**
+ * Returns the full SQLRooms table identity for React/store keys.
+ */
+export function getMosaicTableIdentity(tableName) {
+    return typeof tableName === 'string'
+        ? tableName.trim()
+        : tableName.toString();
+}
+/**
+ * Converts SQLRooms table identity into a serializable vgplot `data.from`
+ * reference.
+ *
+ * SQLRooms normalizes this string into a Mosaic TableRefNode before handing the
+ * spec to Mosaic at runtime. Keeping this string SQL-quoted preserves dotted
+ * identifier boundaries through JSON serialization.
+ */
+export function getMosaicVgPlotTableReference(tableName) {
+    return getMosaicRawSqlTableReference(tableName);
+}
+/**
+ * Converts SQLRooms table identity into a schema/table SQL fragment for raw SQL
+ * builders. The active Mosaic connector owns the catalog, so the database part
+ * is intentionally omitted.
+ */
+export function getMosaicRawSqlTableReference(tableName) {
+    return getMosaicTableReferenceParts(tableName).map(escapeId).join('.');
+}
+/**
+ * Resolves a persisted dashboard table identity against the current SQLRooms
+ * table catalog. Canonical identities and qualified SQL identifiers are
+ * preferred; legacy bare names resolve only when unambiguous.
+ */
+export function resolveMosaicTableReference(tables, tableName) {
+    if (!tableName) {
+        return {};
+    }
+    return resolveTableReference(tables, tableName);
+}
+/**
+ * @deprecated Use `getMosaicVgPlotTableReference` for chart specs or
+ * `getMosaicRawSqlTableReference` for string-built SQL.
+ */
+export const getMosaicTableReferenceString = getMosaicVgPlotTableReference;
+function getMosaicTableReferenceParts(tableName) {
+    if (typeof tableName !== 'string') {
+        return tableName.toArray({ includeDatabase: false });
+    }
+    const parsed = parseQualifiedSqlIdentifier(tableName);
+    if (parsed?.table) {
+        return [parsed.schema, parsed.table].filter((part) => Boolean(part));
+    }
+    return [String(tableName).trim()];
+}
+//# sourceMappingURL=mosaicTableReference.js.map

package/dist/mosaicTableReference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mosaicTableReference.js","sourceRoot":"","sources":["../src/mosaicTableReference.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,QAAQ,EAER,qBAAqB,GAEtB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAC,UAAU,EAAoB,MAAM,oBAAoB,CAAC;AAkBjE;;;;;;;;GAQG;AACH,MAAM,UAAU,0BAA0B,CACxC,SAAoC;IAEpC,OAAO,UAAU,CAAC,4BAA4B,CAAC,SAAS,CAAC,CAAE,CAAC;AAC9D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACpC,SAAoC;IAEpC,OAAO,OAAO,SAAS,KAAK,QAAQ;QAClC,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE;QAClB,CAAC,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC;AAC3B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,6BAA6B,CAC3C,SAAoC;IAEpC,OAAO,6BAA6B,CAAC,SAAS,CAAC,CAAC;AAClD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,6BAA6B,CAC3C,SAAoC;IAEpC,OAAO,4BAA4B,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CAGzC,MAAW,EACX,SAAgD;IAEhD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,qBAAqB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAClD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,6BAA6B,CAAC;AAE3E,SAAS,4BAA4B,CACnC,SAAoC;IAEpC,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;QAClC,OAAO,SAAS,CAAC,OAAO,CAAC,EAAC,eAAe,EAAE,KAAK,EAAC,CAAC,CAAC;IACrD,CAAC;IAED,MAAM,MAAM,GAAG,2BAA2B,CAAC,SAAS,CAAC,CAAC;IAEtD,IAAI,MAAM,EAAE,KAAK,EAAE,CAAC;QAClB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CACnE,OAAO,CAAC,IAAI,CAAC,CACd,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AACpC,CAAC","sourcesContent":["import {\n  parseQualifiedSqlIdentifier,\n  escapeId,\n  type QualifiedTableName,\n  resolveTableReference,\n  type ResolveTableReferenceResult,\n} from '@sqlrooms/db';\nimport {asTableRef, type TableRefNode} from '@uwdata/mosaic-sql';\n\n/**\n * SQLRooms table reference input accepted at Mosaic boundaries.\n *\n * Strings represent persisted identities or user-provided references;\n * QualifiedTableName values carry structured SQLRooms table identity.\n */\nexport type MosaicTableReferenceInput = string | QualifiedTableName;\n\n/**\n * Runtime object carrying a structured SQLRooms table identity.\n *\n * Use this shape for catalog candidates so persisted identity strings stay\n * distinct from resolved runtime table objects.\n */\nexport type MosaicTableReferenceCandidate = {table: QualifiedTableName};\n\n/**\n * Converts SQLRooms table identity into a Mosaic query table reference.\n *\n * SQLRooms keeps the DuckDB catalog/database in QualifiedTableName for stable\n * identity, but Mosaic queries execute against the active connector. Including\n * that catalog in generated SQL can target a catalog that is not attached in\n * the query connection. Mosaic also is not quote-aware when parsing table\n * strings, so return a TableRefNode for generated SQL.\n */\nexport function getMosaicSqlTableReference(\n  tableName: MosaicTableReferenceInput,\n): TableRefNode {\n  return asTableRef(getMosaicTableReferenceParts(tableName))!;\n}\n\n/**\n * Returns the full SQLRooms table identity for React/store keys.\n */\nexport function getMosaicTableIdentity(\n  tableName: MosaicTableReferenceInput,\n): string {\n  return typeof tableName === 'string'\n    ? tableName.trim()\n    : tableName.toString();\n}\n\n/**\n * Converts SQLRooms table identity into a serializable vgplot `data.from`\n * reference.\n *\n * SQLRooms normalizes this string into a Mosaic TableRefNode before handing the\n * spec to Mosaic at runtime. Keeping this string SQL-quoted preserves dotted\n * identifier boundaries through JSON serialization.\n */\nexport function getMosaicVgPlotTableReference(\n  tableName: MosaicTableReferenceInput,\n): string {\n  return getMosaicRawSqlTableReference(tableName);\n}\n\n/**\n * Converts SQLRooms table identity into a schema/table SQL fragment for raw SQL\n * builders. The active Mosaic connector owns the catalog, so the database part\n * is intentionally omitted.\n */\nexport function getMosaicRawSqlTableReference(\n  tableName: MosaicTableReferenceInput,\n): string {\n  return getMosaicTableReferenceParts(tableName).map(escapeId).join('.');\n}\n\n/**\n * Resolves a persisted dashboard table identity against the current SQLRooms\n * table catalog. Canonical identities and qualified SQL identifiers are\n * preferred; legacy bare names resolve only when unambiguous.\n */\nexport function resolveMosaicTableReference<\n  T extends MosaicTableReferenceCandidate,\n>(\n  tables: T[],\n  tableName: MosaicTableReferenceInput | undefined,\n): ResolveTableReferenceResult<T> {\n  if (!tableName) {\n    return {};\n  }\n  return resolveTableReference(tables, tableName);\n}\n\n/**\n * @deprecated Use `getMosaicVgPlotTableReference` for chart specs or\n * `getMosaicRawSqlTableReference` for string-built SQL.\n */\nexport const getMosaicTableReferenceString = getMosaicVgPlotTableReference;\n\nfunction getMosaicTableReferenceParts(\n  tableName: MosaicTableReferenceInput,\n): string[] {\n  if (typeof tableName !== 'string') {\n    return tableName.toArray({includeDatabase: false});\n  }\n\n  const parsed = parseQualifiedSqlIdentifier(tableName);\n\n  if (parsed?.table) {\n    return [parsed.schema, parsed.table].filter((part): part is string =>\n      Boolean(part),\n    );\n  }\n\n  return [String(tableName).trim()];\n}\n"]}

package/dist/useVgPlotChartRender.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useVgPlotChartRender.d.ts","sourceRoot":"","sources":["../src/useVgPlotChartRender.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,EAAE,SAAS,EAAC,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAsB,IAAI,EAAC,MAAM,qBAAqB,CAAC;AAE9D,OAAO,EAAC,QAAQ,EAAC,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAC,mBAAmB,EAAC,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC/B,MAAM,iBAAiB,CAAC;AAkRzB,KAAK,0BAA0B,GAAG;IAChC,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IACrD,IAAI,EAAE,IAAI,CAAC;IACX,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC;IAC7C,aAAa,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC/B,WAAW,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACxC,cAAc,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACrD,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAChC,UAAU,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IACpC,mBAAmB,CAAC,EAAE,wBAAwB,CAAC;IAC/C,oBAAoB,CAAC,EAAE,yBAAyB,CAAC;CAClD,CAAC;AAEF;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,YAAY,EACZ,IAAI,EACJ,OAAO,EACP,MAAM,EACN,aAAa,EACb,WAAW,EACX,cAAc,EACd,OAAO,EACP,UAAU,EACV,mBAAmB,EACnB,oBAAoB,GACrB,EAAE,0BAA0B,QAsH5B"}
+{"version":3,"file":"useVgPlotChartRender.d.ts","sourceRoot":"","sources":["../src/useVgPlotChartRender.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,EAAE,SAAS,EAAC,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAsB,IAAI,EAAC,MAAM,qBAAqB,CAAC;AAE9D,OAAO,EAAC,QAAQ,EAAC,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAC,mBAAmB,EAAC,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC/B,MAAM,iBAAiB,CAAC;AAmTzB,KAAK,0BAA0B,GAAG;IAChC,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IACrD,IAAI,EAAE,IAAI,CAAC;IACX,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC;IAC7C,aAAa,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC/B,WAAW,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACxC,cAAc,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACrD,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAChC,UAAU,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IACpC,mBAAmB,CAAC,EAAE,wBAAwB,CAAC;IAC/C,oBAAoB,CAAC,EAAE,yBAAyB,CAAC;CAClD,CAAC;AAEF;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,YAAY,EACZ,IAAI,EACJ,OAAO,EACP,MAAM,EACN,aAAa,EACb,WAAW,EACX,cAAc,EACd,OAAO,EACP,UAAU,EACV,mBAAmB,EACnB,oBAAoB,GACrB,EAAE,0BAA0B,QAsH5B"}

package/dist/useVgPlotChartRender.js

@@ -1,6 +1,31 @@
 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
@@ -35,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;

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  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"]}
+{"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/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.8",
+  "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.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",
+    "@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": "dcb1a51631c5fa87b49d3e78ae6c0023eccd4189"
+  "gitHead": "e9e4ed45ebb0ceb3e1e647674a7039b8d9325583"
 }

package/dist/ai/ai.d.ts

@@ -1,108 +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 QualifiedTableName } from '@sqlrooms/duckdb';
-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 = {
-    /**
-     * Canonical table identity used for routing after natural-language table
-     * selection resolves to a concrete table.
-     */
-    qualifiedName: QualifiedTableName;
-    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;
-    } & Record<string, 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_scatter_plot, 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 scatter 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_scatter_plot - 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 scatter 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 scatter charts or line charts without aggregations. Use aggregated alternatives instead:\n  - For scatter 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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"}