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

package/dist/charts/chart-types/base-types.d.ts

@@ -13,15 +13,11 @@ import type { Selection } from '@uwdata/mosaic-core';
 import type { DataTableExplorerPanelConfig } from '../../dashboard/core-types';
 import type { MosaicDashboardEntry } from '../../dashboard/dashboard-types';
 import type { ChartDataPolicy, ChartDataPolicyContext, ChartRuntimeIssue, ChartRuntimeIssueContext, ChartRuntimeIssueReporter } from '../../chart-runtime';
+import { ChartToolParams } from './tool-types';
 import { DataTable, type QualifiedTableName } from '@sqlrooms/duckdb';
+import type { ChartBuilderColumn } from './column-types';
 export type { ChartType };
-/**
- * Column info passed to chart builder UI
- */
-export interface ChartBuilderColumn {
-    name: string;
-    type: string;
-}
+export type { ChartBuilderColumn };
 /**
  * Describes a field selector in a chart builder UI
  */
@@ -41,7 +37,7 @@ export interface ChartBuilderField {
 }
 /**
  * Result of table resolution.
- * tableName is the fully quoted string boundary form
+ * tableName is the canonical quoted string boundary form
  * (QualifiedTableName.toString()); qualifiedName is the canonical structured
  * identity when available.
  */
@@ -63,24 +59,16 @@ export interface PanelPatch {
  * Dependencies injected into dashboard tool creation functions.
  * Provides the resources and operations needed to create dashboard panels.
  */
+/**
+ * Dependencies for dashboard-specific tools that manage panels.
+ */
 export interface DashboardToolDeps {
-    /**
-     * Resolves the dashboard artifact ID.
-     * Use this when you only need the artifact and not table information.
-     */
-    resolveArtifact: (artifactId?: string, createIfMissing?: boolean, context?: ChartToolExecutionContext) => string;
-    /**
-     * Resolves user/display table input to canonical table identity and columns.
-     * Bare names are accepted only when unambiguous.
-     */
-    resolveTable: (artifactId: string, tableName?: string | QualifiedTableName) => ResolvedTable;
     addPanel: (dashboardId: string, panel: any) => string;
     updatePanel: (dashboardId: string, panelId: string, patch: Partial<PanelPatch>) => void;
     getDashboard: (dashboardId: string) => MosaicDashboardEntry | undefined;
     getPanelIssue?: (dashboardId: string, panelId: string) => ChartRuntimeIssue | undefined;
     removePanel: (dashboardId: string, panelId: string) => void;
     setCurrentArtifact: (artifactId: string) => void;
-    maxDataPoints: number;
 }
 export type ChartToolExecutionContext = object & {
     sessionId?: string;
@@ -107,14 +95,26 @@ export type ChartRetainer = {
 };
 export type BrushSelectionParams = Map<string, Selection>;
 /**
- * Props passed to chart renderer components.
+ * Props passed to component-based chart renderers.
+ *
+ * Renderers receive the resolved chart configuration, Mosaic coordinator, and
+ * optional runtime services needed to participate in dashboard filtering and
+ * error reporting. The `table` property is the canonical structured SQLRooms
+ * table identity; renderers must convert it through the appropriate SQL dialect
+ * helper instead of reconstructing table references from display names.
  */
 export interface ChartRendererProps<TConfig extends ChartConfig = ChartConfig> {
-    tableName: string;
+    /** Canonical qualified table identity for the chart's data source. */
+    table: QualifiedTableName;
+    /** Validated chart configuration for this renderer. */
     config: TConfig;
+    /** Mosaic coordinator used to connect query clients and selections. */
     coordinator: Coordinator;
+    /** Optional row-limit policy applied to renderer-managed queries. */
     dataPolicy?: ChartDataPolicy | null;
+    /** Context attached to runtime issues reported by the renderer. */
     runtimeIssueContext?: ChartRuntimeIssueContext;
+    /** Reporter used to surface renderer query or policy failures. */
     runtimeIssueReporter?: ChartRuntimeIssueReporter;
     /**
      * Pre-defined params/selections to inject when rendering vgplot specs.
@@ -134,6 +134,8 @@ type BaseChartTypeDefinition<TConfig extends ChartConfig = ChartConfig> = {
     label?: string;
     /** Short description of what this builder creates */
     description: string;
+    /** Concise description for AI agents explaining when and how to use this chart type */
+    aiDescription: string;
     /** Zod schema for runtime validation of settings */
     schema: z.ZodType<TConfig['settings']>;
     /** Generate a chart title from selected field values */
@@ -146,8 +148,8 @@ type BaseChartTypeDefinition<TConfig extends ChartConfig = ChartConfig> = {
     icon: ComponentType<{
         className?: string;
     }>;
-    /** Optional function to create an AI tool for this chart type */
-    createTool?: (deps: DashboardToolDeps) => Tool;
+    /** Optional function to create a chart configuration AI tool */
+    createTool?: (deps: ChartToolParams) => Tool;
     /** Optional runtime data policy for renderer-specific query validation. */
     getDataPolicy?: (context: ChartDataPolicyContext<TConfig>) => ChartDataPolicy | null | undefined;
 };
@@ -156,7 +158,9 @@ export type CreateSpecOptions<TSettings = ChartSettings> = {
     settings: TSettings;
     selectionName?: string;
 };
+export type ValidateSpecOptions<TSettings = ChartSettings> = Pick<CreateSpecOptions<TSettings>, 'dataTable' | 'settings'>;
 export declare function getChartTableReference(dataTable: DataTable): string;
+export declare const getChartTableReferenceString: typeof getChartTableReference;
 export type SpecChartTypeDefinition<TConfig extends ChartConfig = ChartConfig> = BaseChartTypeDefinition<TConfig> & {
     createSpec: (options: CreateSpecOptions<TConfig['settings']>) => Spec;
     canViewSpec?: boolean;

package/dist/charts/chart-types/base-types.d.ts.map

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

package/dist/charts/chart-types/base-types.js

@@ -2,9 +2,11 @@
  * Base types for chart configurations.
  * Separated to avoid circular dependencies.
  */
+import { getMosaicVgPlotTableReference } from '../../mosaicTableReference';
 export function getChartTableReference(dataTable) {
-    return dataTable.table.toString();
+    return getMosaicVgPlotTableReference(dataTable.table);
 }
+export const getChartTableReferenceString = getChartTableReference;
 export function isSpecChartType(chartType) {
     return 'createSpec' in chartType;
 }

package/dist/charts/chart-types/base-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"base-types.js","sourceRoot":"","sources":["../../../src/charts/chart-types/base-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAsMH,MAAM,UAAU,sBAAsB,CAAC,SAAoB;IACzD,OAAO,SAAS,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;AACpC,CAAC;AAsBD,MAAM,UAAU,eAAe,CAC7B,SAAuC;IAEvC,OAAO,YAAY,IAAI,SAAS,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,SAAuC;IAEvC,OAAO,UAAU,IAAI,SAAS,CAAC;AACjC,CAAC","sourcesContent":["/**\n * Base types for chart configurations.\n * Separated to avoid circular dependencies.\n */\n\nimport type {Spec} from '@uwdata/mosaic-spec';\nimport {type Tool} from 'ai';\nimport type {Coordinator} from '@uwdata/mosaic-core';\nimport type {ComponentType} from 'react';\nimport type * as z from 'zod';\nimport {ChartConfig, ChartSettings, ChartType} from './chart-config';\nimport {RetainedVgPlotChart} from '../../VgPlotChart';\nimport type {Selection} from '@uwdata/mosaic-core';\nimport type {DataTableExplorerPanelConfig} from '../../dashboard/core-types';\nimport type {MosaicDashboardEntry} from '../../dashboard/dashboard-types';\nimport type {\n  ChartDataPolicy,\n  ChartDataPolicyContext,\n  ChartRuntimeIssue,\n  ChartRuntimeIssueContext,\n  ChartRuntimeIssueReporter,\n} from '../../chart-runtime';\nimport {DataTable, type QualifiedTableName} from '@sqlrooms/duckdb';\n\nexport type {ChartType};\n\n/**\n * Column info passed to chart builder UI\n */\nexport interface ChartBuilderColumn {\n  name: string;\n  type: string;\n}\n\n/**\n * Describes a field selector in a chart builder UI\n */\nexport interface ChartBuilderField {\n  /** Unique key for this field */\n  key: string;\n  /** Display label */\n  label: string;\n  /** Whether the field is required */\n  required?: boolean;\n  /** Filter columns by DuckDB type (e.g. 'INTEGER', 'VARCHAR', 'DOUBLE') */\n  types?: string[];\n  /** Optional helper text for AI or custom UIs */\n  description?: string;\n  /** Whether this field accepts multiple values (array) */\n  multiple?: boolean;\n}\n\n/**\n * Result of table resolution.\n * tableName is the fully quoted string boundary form\n * (QualifiedTableName.toString()); qualifiedName is the canonical structured\n * identity when available.\n */\nexport interface ResolvedTable {\n  tableName: string;\n  qualifiedName: QualifiedTableName;\n  columns: ChartBuilderColumn[];\n}\n\n/**\n * Partial update to apply to a dashboard panel.\n * Config can be any of the panel config types (chart, dataTableExplorer).\n */\nexport interface PanelPatch {\n  title?: string;\n  source?: ChartBuilderPanelSource;\n  config?: ChartConfig | DataTableExplorerPanelConfig;\n}\n\n/**\n * Dependencies injected into dashboard tool creation functions.\n * Provides the resources and operations needed to create dashboard panels.\n */\nexport interface DashboardToolDeps {\n  /**\n   * Resolves the dashboard artifact ID.\n   * Use this when you only need the artifact and not table information.\n   */\n  resolveArtifact: (\n    artifactId?: string,\n    createIfMissing?: boolean,\n    context?: ChartToolExecutionContext,\n  ) => string;\n\n  /**\n   * Resolves user/display table input to canonical table identity and columns.\n   * Bare names are accepted only when unambiguous.\n   */\n  resolveTable: (\n    artifactId: string,\n    tableName?: string | QualifiedTableName,\n  ) => ResolvedTable;\n\n  addPanel: (dashboardId: string, panel: any) => string;\n  updatePanel: (\n    dashboardId: string,\n    panelId: string,\n    patch: Partial<PanelPatch>,\n  ) => void;\n  getDashboard: (dashboardId: string) => MosaicDashboardEntry | undefined;\n  getPanelIssue?: (\n    dashboardId: string,\n    panelId: string,\n  ) => ChartRuntimeIssue | undefined;\n  removePanel: (dashboardId: string, panelId: string) => void;\n  setCurrentArtifact: (artifactId: string) => void;\n\n  maxDataPoints: number;\n}\n\nexport type ChartToolExecutionContext = object & {\n  sessionId?: string;\n  aiRunContext?: unknown;\n};\n\nexport type ChartBuilderPanelSource = {\n  tableName?: string;\n  sqlQuery?: string;\n};\n\nexport type ChartBuilderVgPlotOutput = {\n  kind: 'vgplot';\n  spec: Spec;\n};\n\nexport type ChartBuilderDashboardPanelOutput = {\n  kind: 'dashboard-panel';\n  type: string;\n  source?: ChartBuilderPanelSource;\n  config?: Record<string, unknown>;\n};\n\nexport type ChartBuilderOutput =\n  | ChartBuilderVgPlotOutput\n  | ChartBuilderDashboardPanelOutput;\n\nexport type ChartRetainer = {\n  chart: RetainedVgPlotChart | undefined;\n  setChart: (chart: RetainedVgPlotChart) => void;\n};\n\nexport type BrushSelectionParams = Map<string, Selection>;\n\n/**\n * Props passed to chart renderer components.\n */\nexport interface ChartRendererProps<TConfig extends ChartConfig = ChartConfig> {\n  tableName: string;\n  config: TConfig;\n  coordinator: Coordinator;\n  dataPolicy?: ChartDataPolicy | null;\n  runtimeIssueContext?: ChartRuntimeIssueContext;\n  runtimeIssueReporter?: ChartRuntimeIssueReporter;\n  /**\n   * Pre-defined params/selections to inject when rendering vgplot specs.\n   * Keys are param names (without $), values are Param or Selection instances.\n   */\n  params?: BrushSelectionParams;\n  /**\n   * Optional retention adapter for preserving the underlying vgplot\n   * instance across temporary unmount/remount cycles.\n   */\n  retention?: ChartRetainer;\n}\n\ntype BaseChartTypeDefinition<TConfig extends ChartConfig = ChartConfig> = {\n  /** Unique identifier */\n  id: ChartType;\n  /** Short human-friendly name used in chart-type grids and prompts */\n  label?: string;\n  /** Short description of what this builder creates */\n  description: string;\n  /** Zod schema for runtime validation of settings */\n  schema: z.ZodType<TConfig['settings']>;\n  /** Generate a chart title from selected field values */\n  buildTitle?: (fieldValues: Record<string, unknown>) => string;\n  /** Optional availability override for a given table schema */\n  isAvailable?: (columns: ChartBuilderColumn[]) => boolean;\n  /** Explicit settings component for this chart type */\n  settingsComponent: ComponentType;\n  /** Optional icon component for chart-type grids */\n  icon: ComponentType<{className?: string}>;\n  /** Optional function to create an AI tool for this chart type */\n  createTool?: (deps: DashboardToolDeps) => Tool;\n  /** Optional runtime data policy for renderer-specific query validation. */\n  getDataPolicy?: (\n    context: ChartDataPolicyContext<TConfig>,\n  ) => ChartDataPolicy | null | undefined;\n};\n\nexport type CreateSpecOptions<TSettings = ChartSettings> = {\n  dataTable: DataTable;\n  settings: TSettings;\n  selectionName?: string;\n};\n\nexport function getChartTableReference(dataTable: DataTable): string {\n  return dataTable.table.toString();\n}\n\nexport type SpecChartTypeDefinition<TConfig extends ChartConfig = ChartConfig> =\n  BaseChartTypeDefinition<TConfig> & {\n    createSpec: (options: CreateSpecOptions<TConfig['settings']>) => Spec;\n    canViewSpec?: boolean;\n  };\n\nexport type ComponentChartTypeDefinition<\n  TConfig extends ChartConfig = ChartConfig,\n> = BaseChartTypeDefinition<TConfig> & {\n  renderer: ComponentType<ChartRendererProps<TConfig>>;\n};\n\n/**\n * Shared chart-type definition used by both the chart-builder UI and\n * assistant-driven chart creation.\n */\nexport type ChartTypeDefinition<TConfig extends ChartConfig = ChartConfig> =\n  | SpecChartTypeDefinition<TConfig>\n  | ComponentChartTypeDefinition<TConfig>;\n\nexport function isSpecChartType<TConfig extends ChartConfig>(\n  chartType: ChartTypeDefinition<TConfig>,\n): chartType is SpecChartTypeDefinition<TConfig> {\n  return 'createSpec' in chartType;\n}\n\nexport function isComponentChartType<TConfig extends ChartConfig>(\n  chartType: ChartTypeDefinition<TConfig>,\n): chartType is ComponentChartTypeDefinition<TConfig> {\n  return 'renderer' in chartType;\n}\n\n/**\n * Backward-compatible alias for earlier chart-builder helper APIs.\n * @deprecated Use {@link ChartTypeDefinition} instead.\n */\nexport type ChartSpec = ChartTypeDefinition;\n"]}
+{"version":3,"file":"base-types.js","sourceRoot":"","sources":["../../../src/charts/chart-types/base-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAqBH,OAAO,EAAC,6BAA6B,EAAC,MAAM,4BAA4B,CAAC;AA8KzE,MAAM,UAAU,sBAAsB,CAAC,SAAoB;IACzD,OAAO,6BAA6B,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,CAAC,MAAM,4BAA4B,GAAG,sBAAsB,CAAC;AAsBnE,MAAM,UAAU,eAAe,CAC7B,SAAuC;IAEvC,OAAO,YAAY,IAAI,SAAS,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,SAAuC;IAEvC,OAAO,UAAU,IAAI,SAAS,CAAC;AACjC,CAAC","sourcesContent":["/**\n * Base types for chart configurations.\n * Separated to avoid circular dependencies.\n */\n\nimport type {Spec} from '@uwdata/mosaic-spec';\nimport {type Tool} from 'ai';\nimport type {Coordinator} from '@uwdata/mosaic-core';\nimport type {ComponentType} from 'react';\nimport type * as z from 'zod';\nimport {ChartConfig, ChartSettings, ChartType} from './chart-config';\nimport {RetainedVgPlotChart} from '../../VgPlotChart';\nimport type {Selection} from '@uwdata/mosaic-core';\nimport type {DataTableExplorerPanelConfig} from '../../dashboard/core-types';\nimport type {MosaicDashboardEntry} from '../../dashboard/dashboard-types';\nimport type {\n  ChartDataPolicy,\n  ChartDataPolicyContext,\n  ChartRuntimeIssue,\n  ChartRuntimeIssueContext,\n  ChartRuntimeIssueReporter,\n} from '../../chart-runtime';\nimport {ChartToolParams} from './tool-types';\nimport {DataTable, type QualifiedTableName} from '@sqlrooms/duckdb';\nimport {getMosaicVgPlotTableReference} from '../../mosaicTableReference';\nimport type {ChartBuilderColumn} from './column-types';\n\nexport type {ChartType};\nexport type {ChartBuilderColumn};\n\n/**\n * Describes a field selector in a chart builder UI\n */\nexport interface ChartBuilderField {\n  /** Unique key for this field */\n  key: string;\n  /** Display label */\n  label: string;\n  /** Whether the field is required */\n  required?: boolean;\n  /** Filter columns by DuckDB type (e.g. 'INTEGER', 'VARCHAR', 'DOUBLE') */\n  types?: string[];\n  /** Optional helper text for AI or custom UIs */\n  description?: string;\n  /** Whether this field accepts multiple values (array) */\n  multiple?: boolean;\n}\n\n/**\n * Result of table resolution.\n * tableName is the canonical quoted string boundary form\n * (QualifiedTableName.toString()); qualifiedName is the canonical structured\n * identity when available.\n */\nexport interface ResolvedTable {\n  tableName: string;\n  qualifiedName: QualifiedTableName;\n  columns: ChartBuilderColumn[];\n}\n\n/**\n * Partial update to apply to a dashboard panel.\n * Config can be any of the panel config types (chart, dataTableExplorer).\n */\nexport interface PanelPatch {\n  title?: string;\n  source?: ChartBuilderPanelSource;\n  config?: ChartConfig | DataTableExplorerPanelConfig;\n}\n\n/**\n * Dependencies injected into dashboard tool creation functions.\n * Provides the resources and operations needed to create dashboard panels.\n */\n/**\n * Dependencies for dashboard-specific tools that manage panels.\n */\nexport interface DashboardToolDeps {\n  addPanel: (dashboardId: string, panel: any) => string;\n  updatePanel: (\n    dashboardId: string,\n    panelId: string,\n    patch: Partial<PanelPatch>,\n  ) => void;\n  getDashboard: (dashboardId: string) => MosaicDashboardEntry | undefined;\n  getPanelIssue?: (\n    dashboardId: string,\n    panelId: string,\n  ) => ChartRuntimeIssue | undefined;\n  removePanel: (dashboardId: string, panelId: string) => void;\n  setCurrentArtifact: (artifactId: string) => void;\n}\n\nexport type ChartToolExecutionContext = object & {\n  sessionId?: string;\n  aiRunContext?: unknown;\n};\n\nexport type ChartBuilderPanelSource = {\n  tableName?: string;\n  sqlQuery?: string;\n};\n\nexport type ChartBuilderVgPlotOutput = {\n  kind: 'vgplot';\n  spec: Spec;\n};\n\nexport type ChartBuilderDashboardPanelOutput = {\n  kind: 'dashboard-panel';\n  type: string;\n  source?: ChartBuilderPanelSource;\n  config?: Record<string, unknown>;\n};\n\nexport type ChartBuilderOutput =\n  | ChartBuilderVgPlotOutput\n  | ChartBuilderDashboardPanelOutput;\n\nexport type ChartRetainer = {\n  chart: RetainedVgPlotChart | undefined;\n  setChart: (chart: RetainedVgPlotChart) => void;\n};\n\nexport type BrushSelectionParams = Map<string, Selection>;\n\n/**\n * Props passed to component-based chart renderers.\n *\n * Renderers receive the resolved chart configuration, Mosaic coordinator, and\n * optional runtime services needed to participate in dashboard filtering and\n * error reporting. The `table` property is the canonical structured SQLRooms\n * table identity; renderers must convert it through the appropriate SQL dialect\n * helper instead of reconstructing table references from display names.\n */\nexport interface ChartRendererProps<TConfig extends ChartConfig = ChartConfig> {\n  /** Canonical qualified table identity for the chart's data source. */\n  table: QualifiedTableName;\n  /** Validated chart configuration for this renderer. */\n  config: TConfig;\n  /** Mosaic coordinator used to connect query clients and selections. */\n  coordinator: Coordinator;\n  /** Optional row-limit policy applied to renderer-managed queries. */\n  dataPolicy?: ChartDataPolicy | null;\n  /** Context attached to runtime issues reported by the renderer. */\n  runtimeIssueContext?: ChartRuntimeIssueContext;\n  /** Reporter used to surface renderer query or policy failures. */\n  runtimeIssueReporter?: ChartRuntimeIssueReporter;\n  /**\n   * Pre-defined params/selections to inject when rendering vgplot specs.\n   * Keys are param names (without $), values are Param or Selection instances.\n   */\n  params?: BrushSelectionParams;\n  /**\n   * Optional retention adapter for preserving the underlying vgplot\n   * instance across temporary unmount/remount cycles.\n   */\n  retention?: ChartRetainer;\n}\n\ntype BaseChartTypeDefinition<TConfig extends ChartConfig = ChartConfig> = {\n  /** Unique identifier */\n  id: ChartType;\n  /** Short human-friendly name used in chart-type grids and prompts */\n  label?: string;\n  /** Short description of what this builder creates */\n  description: string;\n  /** Concise description for AI agents explaining when and how to use this chart type */\n  aiDescription: string;\n  /** Zod schema for runtime validation of settings */\n  schema: z.ZodType<TConfig['settings']>;\n  /** Generate a chart title from selected field values */\n  buildTitle?: (fieldValues: Record<string, unknown>) => string;\n  /** Optional availability override for a given table schema */\n  isAvailable?: (columns: ChartBuilderColumn[]) => boolean;\n  /** Explicit settings component for this chart type */\n  settingsComponent: ComponentType;\n  /** Optional icon component for chart-type grids */\n  icon: ComponentType<{className?: string}>;\n  /** Optional function to create a chart configuration AI tool */\n  createTool?: (deps: ChartToolParams) => Tool;\n  /** Optional runtime data policy for renderer-specific query validation. */\n  getDataPolicy?: (\n    context: ChartDataPolicyContext<TConfig>,\n  ) => ChartDataPolicy | null | undefined;\n};\n\nexport type CreateSpecOptions<TSettings = ChartSettings> = {\n  dataTable: DataTable;\n  settings: TSettings;\n  selectionName?: string;\n};\n\nexport type ValidateSpecOptions<TSettings = ChartSettings> = Pick<\n  CreateSpecOptions<TSettings>,\n  'dataTable' | 'settings'\n>;\n\nexport function getChartTableReference(dataTable: DataTable): string {\n  return getMosaicVgPlotTableReference(dataTable.table);\n}\n\nexport const getChartTableReferenceString = getChartTableReference;\n\nexport type SpecChartTypeDefinition<TConfig extends ChartConfig = ChartConfig> =\n  BaseChartTypeDefinition<TConfig> & {\n    createSpec: (options: CreateSpecOptions<TConfig['settings']>) => Spec;\n    canViewSpec?: boolean;\n  };\n\nexport type ComponentChartTypeDefinition<\n  TConfig extends ChartConfig = ChartConfig,\n> = BaseChartTypeDefinition<TConfig> & {\n  renderer: ComponentType<ChartRendererProps<TConfig>>;\n};\n\n/**\n * Shared chart-type definition used by both the chart-builder UI and\n * assistant-driven chart creation.\n */\nexport type ChartTypeDefinition<TConfig extends ChartConfig = ChartConfig> =\n  | SpecChartTypeDefinition<TConfig>\n  | ComponentChartTypeDefinition<TConfig>;\n\nexport function isSpecChartType<TConfig extends ChartConfig>(\n  chartType: ChartTypeDefinition<TConfig>,\n): chartType is SpecChartTypeDefinition<TConfig> {\n  return 'createSpec' in chartType;\n}\n\nexport function isComponentChartType<TConfig extends ChartConfig>(\n  chartType: ChartTypeDefinition<TConfig>,\n): chartType is ComponentChartTypeDefinition<TConfig> {\n  return 'renderer' in chartType;\n}\n\n/**\n * Backward-compatible alias for earlier chart-builder helper APIs.\n * @deprecated Use {@link ChartTypeDefinition} instead.\n */\nexport type ChartSpec = ChartTypeDefinition;\n"]}

package/dist/charts/chart-types/box-plot/definition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../../../src/charts/chart-types/box-plot/definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,4BAA4B,EAAC,MAAM,eAAe,CAAC;AAChE,OAAO,EAAC,kBAAkB,EAAuB,MAAM,UAAU,CAAC;AAUlE,eAAO,MAAM,gBAAgB,EAAE,4BAA4B,CAAC,kBAAkB,CAgB3E,CAAC"}
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../../../src/charts/chart-types/box-plot/definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,4BAA4B,EAAC,MAAM,eAAe,CAAC;AAChE,OAAO,EAAC,kBAAkB,EAAuB,MAAM,UAAU,CAAC;AAUlE,eAAO,MAAM,gBAAgB,EAAE,4BAA4B,CAAC,kBAAkB,CAiB3E,CAAC"}

package/dist/charts/chart-types/box-plot/definition.js

@@ -10,6 +10,7 @@ export const boxPlotChartType = {
     id: 'box-plot',
     label: 'Box Plot',
     description: DESCRIPTION,
+    aiDescription: `${DESCRIPTION} - compare distributions across categories`,
     icon: AlignHorizontalDistributeCenter,
     schema: BoxPlotChartSettings,
     settingsComponent: BoxPlotSettingsComponent,

package/dist/charts/chart-types/box-plot/definition.js.map

@@ -1 +1 @@
-{"version":3,"file":"definition.js","sourceRoot":"","sources":["../../../../src/charts/chart-types/box-plot/definition.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,oBAAoB,EAAC,MAAM,UAAU,CAAC;AAClE,OAAO,EAAC,oBAAoB,EAAC,MAAM,wCAAwC,CAAC;AAC5E,OAAO,EAAC,oBAAoB,EAAC,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAC,wBAAwB,EAAC,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAC,mBAAmB,EAAC,MAAM,QAAQ,CAAC;AAC3C,OAAO,EAAC,+BAA+B,EAAC,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAErE,MAAM,WAAW,GAAG,mBAAmB,CAAC;AAExC,MAAM,CAAC,MAAM,gBAAgB,GAC3B;IACE,EAAE,EAAE,UAAU;IACd,KAAK,EAAE,UAAU;IACjB,WAAW,EAAE,WAAW;IACxB,IAAI,EAAE,+BAA+B;IACrC,MAAM,EAAE,oBAAoB;IAC5B,iBAAiB,EAAE,wBAAwB;IAC3C,UAAU,EAAE,oBAAoB,CAAC,WAAW,CAAC;IAC7C,QAAQ,EAAE,oBAAoB;IAC9B,UAAU,EAAE,mBAAmB;IAC/B,aAAa,EAAE,GAAG,EAAE,CAAC,CAAC;QACpB,OAAO,EAAE,6BAA6B;QACtC,MAAM,EACJ,+GAA+G;KAClH,CAAC;CACH,CAAC","sourcesContent":["import type {ComponentChartTypeDefinition} from '../base-types';\nimport {BoxPlotChartConfig, BoxPlotChartSettings} from './schema';\nimport {titleFromDescription} from '../../../chart-builders/chartTypeUtils';\nimport {BoxPlotPanelRenderer} from './renderer/BoxPlotPanelRenderer';\nimport {BoxPlotSettingsComponent} from './BoxPlotSettings';\nimport {createBoxPlotAiTool} from './tool';\nimport {AlignHorizontalDistributeCenter} from 'lucide-react';\nimport {DEFAULT_CHART_MAX_DATA_POINTS} from '../../../chart-runtime';\n\nconst DESCRIPTION = 'Create a box plot';\n\nexport const boxPlotChartType: ComponentChartTypeDefinition<BoxPlotChartConfig> =\n  {\n    id: 'box-plot',\n    label: 'Box Plot',\n    description: DESCRIPTION,\n    icon: AlignHorizontalDistributeCenter,\n    schema: BoxPlotChartSettings,\n    settingsComponent: BoxPlotSettingsComponent,\n    buildTitle: titleFromDescription(DESCRIPTION),\n    renderer: BoxPlotPanelRenderer,\n    createTool: createBoxPlotAiTool,\n    getDataPolicy: () => ({\n      maxRows: DEFAULT_CHART_MAX_DATA_POINTS,\n      reason:\n        'Box plots render summaries plus outlier points. Too many outliers can make the chart too expensive to render.',\n    }),\n  };\n"]}
+{"version":3,"file":"definition.js","sourceRoot":"","sources":["../../../../src/charts/chart-types/box-plot/definition.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,oBAAoB,EAAC,MAAM,UAAU,CAAC;AAClE,OAAO,EAAC,oBAAoB,EAAC,MAAM,wCAAwC,CAAC;AAC5E,OAAO,EAAC,oBAAoB,EAAC,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAC,wBAAwB,EAAC,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAC,mBAAmB,EAAC,MAAM,QAAQ,CAAC;AAC3C,OAAO,EAAC,+BAA+B,EAAC,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAC,6BAA6B,EAAC,MAAM,wBAAwB,CAAC;AAErE,MAAM,WAAW,GAAG,mBAAmB,CAAC;AAExC,MAAM,CAAC,MAAM,gBAAgB,GAC3B;IACE,EAAE,EAAE,UAAU;IACd,KAAK,EAAE,UAAU;IACjB,WAAW,EAAE,WAAW;IACxB,aAAa,EAAE,GAAG,WAAW,4CAA4C;IACzE,IAAI,EAAE,+BAA+B;IACrC,MAAM,EAAE,oBAAoB;IAC5B,iBAAiB,EAAE,wBAAwB;IAC3C,UAAU,EAAE,oBAAoB,CAAC,WAAW,CAAC;IAC7C,QAAQ,EAAE,oBAAoB;IAC9B,UAAU,EAAE,mBAAmB;IAC/B,aAAa,EAAE,GAAG,EAAE,CAAC,CAAC;QACpB,OAAO,EAAE,6BAA6B;QACtC,MAAM,EACJ,+GAA+G;KAClH,CAAC;CACH,CAAC","sourcesContent":["import type {ComponentChartTypeDefinition} from '../base-types';\nimport {BoxPlotChartConfig, BoxPlotChartSettings} from './schema';\nimport {titleFromDescription} from '../../../chart-builders/chartTypeUtils';\nimport {BoxPlotPanelRenderer} from './renderer/BoxPlotPanelRenderer';\nimport {BoxPlotSettingsComponent} from './BoxPlotSettings';\nimport {createBoxPlotAiTool} from './tool';\nimport {AlignHorizontalDistributeCenter} from 'lucide-react';\nimport {DEFAULT_CHART_MAX_DATA_POINTS} from '../../../chart-runtime';\n\nconst DESCRIPTION = 'Create a box plot';\n\nexport const boxPlotChartType: ComponentChartTypeDefinition<BoxPlotChartConfig> =\n  {\n    id: 'box-plot',\n    label: 'Box Plot',\n    description: DESCRIPTION,\n    aiDescription: `${DESCRIPTION} - compare distributions across categories`,\n    icon: AlignHorizontalDistributeCenter,\n    schema: BoxPlotChartSettings,\n    settingsComponent: BoxPlotSettingsComponent,\n    buildTitle: titleFromDescription(DESCRIPTION),\n    renderer: BoxPlotPanelRenderer,\n    createTool: createBoxPlotAiTool,\n    getDataPolicy: () => ({\n      maxRows: DEFAULT_CHART_MAX_DATA_POINTS,\n      reason:\n        'Box plots render summaries plus outlier points. Too many outliers can make the chart too expensive to render.',\n    }),\n  };\n"]}

package/dist/charts/chart-types/box-plot/renderer/BoxPlotClient.d.ts

@@ -1,4 +1,5 @@
 import { MosaicClient, type Selection } from '@uwdata/mosaic-core';
+import { type QualifiedTableName } from '@sqlrooms/duckdb';
 import type { FilterExpr } from '@uwdata/mosaic-sql';
 import { type ChartDataPolicy, type ChartRuntimeIssueContext, type ChartRuntimeIssueReporter } from '../../../../chart-runtime';
 export type BoxPlotSummaryRow = {
@@ -23,26 +24,59 @@ export type BoxPlotState = {
     summaries: BoxPlotSummaryRow[];
     yBrush?: [number, number];
 };
+/**
+ * Options used to construct a {@link BoxPlotClient}.
+ *
+ * @property dataPolicy - Optional row-limit policy to validate query results.
+ * @property onStateChange - Callback invoked whenever query or brush state changes.
+ * @property runtimeIssueContext - Optional context attached to reported runtime issues.
+ * @property runtimeIssueReporter - Optional reporter used for query and policy failures.
+ * @property selection - Mosaic selection used for external filters and y-axis brushing.
+ * @property table - Canonical SQLRooms table identity. The client converts it
+ *   with `getMosaicRawSqlTableReference`, so callers should pass the structured
+ *   `QualifiedTableName` instead of a pre-rendered SQL string.
+ * @property x - Category column name.
+ * @property y - Numeric value column name.
+ */
 export type BoxPlotClientOptions = {
     dataPolicy?: ChartDataPolicy | null;
     onStateChange: (state: BoxPlotState) => void;
     runtimeIssueContext?: ChartRuntimeIssueContext;
     runtimeIssueReporter?: ChartRuntimeIssueReporter;
     selection: Selection;
-    tableName: string;
+    table: QualifiedTableName;
     x: string;
     y: string;
 };
 type BuildBoxPlotQueryArgs = {
     filter?: FilterExpr | null;
-    tableName: string;
+    table: QualifiedTableName;
     x: string;
     y: string;
 };
+/**
+ * Builds the SQL used by {@link BoxPlotClient} to compute box plot summaries.
+ *
+ * @param args - Query inputs including the source table, selected columns, and
+ *   optional Mosaic filter expression.
+ * @returns SQL that returns summary rows and outlier rows for the box plot.
+ *
+ * The structured `QualifiedTableName` is converted with
+ * `getMosaicRawSqlTableReference`, which intentionally produces the
+ * catalog-free SQL fragment expected by Mosaic's active connector.
+ */
 export declare function buildBoxPlotQuery(args: BuildBoxPlotQueryArgs): string;
+/**
+ * Mosaic query client that powers the custom box plot renderer.
+ *
+ * The client owns SQL generation, query-result normalization, runtime issue
+ * reporting, and y-axis brush selection updates. It accepts a structured
+ * `QualifiedTableName` so table identity remains canonical until the query is
+ * rendered for Mosaic SQL.
+ */
 export declare class BoxPlotClient extends MosaicClient {
     private readonly onStateChange;
-    private readonly tableName;
+    private readonly table;
     private readonly x;
     private readonly y;
     private readonly selection;

package/dist/charts/chart-types/box-plot/renderer/BoxPlotClient.d.ts.map

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

package/dist/charts/chart-types/box-plot/renderer/BoxPlotClient.js

@@ -1,6 +1,7 @@
 import { MosaicClient, clauseInterval, } from '@uwdata/mosaic-core';
-import { escapeId, quoteTableReference } from '@sqlrooms/duckdb';
+import { escapeId } from '@sqlrooms/duckdb';
 import { assertChartDataPolicy, createChartRuntimeIssueFromError, } from '../../../../chart-runtime';
+import { getMosaicRawSqlTableReference } from '../../../../mosaicTableReference';
 function normalizeFilter(filter) {
     if (!filter) {
         return [];
@@ -57,8 +58,19 @@ function numericValue(value) {
     const numeric = Number(value);
     return Number.isFinite(numeric) ? numeric : undefined;
 }
+/**
+ * Builds the SQL used by {@link BoxPlotClient} to compute box plot summaries.
+ *
+ * @param args - Query inputs including the source table, selected columns, and
+ *   optional Mosaic filter expression.
+ * @returns SQL that returns summary rows and outlier rows for the box plot.
+ *
+ * The structured `QualifiedTableName` is converted with
+ * `getMosaicRawSqlTableReference`, which intentionally produces the
+ * catalog-free SQL fragment expected by Mosaic's active connector.
+ */
 export function buildBoxPlotQuery(args) {
-    const table = quoteTableReference(args.tableName);
+    const tableReference = getMosaicRawSqlTableReference(args.table);
     const x = escapeId(args.x);
     const y = escapeId(args.y);
     const filters = normalizeFilter(args.filter).join(' AND ');
@@ -68,7 +80,7 @@ WITH base AS (
   SELECT
     ${x} AS "category",
     TRY_CAST(${y} AS DOUBLE) AS "value"
-  FROM ${table}
+  FROM ${tableReference}
   WHERE ${where}
 ),
 stats AS (
@@ -138,9 +150,17 @@ SELECT * FROM outliers
 ORDER BY "category", "rowKind", "value"
 `.trim();
 }
+/**
+ * Mosaic query client that powers the custom box plot renderer.
+ *
+ * The client owns SQL generation, query-result normalization, runtime issue
+ * reporting, and y-axis brush selection updates. It accepts a structured
+ * `QualifiedTableName` so table identity remains canonical until the query is
+ * rendered for Mosaic SQL.
+ */
 export class BoxPlotClient extends MosaicClient {
     onStateChange;
-    tableName;
+    table;
     x;
     y;
     selection;
@@ -159,7 +179,7 @@ export class BoxPlotClient extends MosaicClient {
         this.onStateChange = options.onStateChange;
         this.runtimeIssueContext = options.runtimeIssueContext;
         this.runtimeIssueReporter = options.runtimeIssueReporter;
-        this.tableName = options.tableName;
+        this.table = options.table;
         this.x = options.x;
         this.y = options.y;
         this.selection = options.selection;
@@ -184,7 +204,7 @@ export class BoxPlotClient extends MosaicClient {
     query(filter) {
         return buildBoxPlotQuery({
             filter,
-            tableName: this.tableName,
+            table: this.table,
             x: this.x,
             y: this.y,
         });

package/dist/charts/chart-types/box-plot/renderer/BoxPlotClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"BoxPlotClient.js","sourceRoot":"","sources":["../../../../../src/charts/chart-types/box-plot/renderer/BoxPlotClient.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  MosaicClient,\n  clauseInterval,\n  type Selection,\n} from '@uwdata/mosaic-core';\nimport {escapeId, quoteTableReference} from '@sqlrooms/duckdb';\nimport type {ExprNode, FilterExpr} from '@uwdata/mosaic-sql';\nimport {\n  assertChartDataPolicy,\n  createChartRuntimeIssueFromError,\n  type ChartDataPolicy,\n  type ChartRuntimeIssueContext,\n  type ChartRuntimeIssueReporter,\n} from '../../../../chart-runtime';\n\nexport type BoxPlotSummaryRow = {\n  category: unknown;\n  count: number;\n  lowerFence: number;\n  median: number;\n  q1: number;\n  q3: number;\n  upperFence: number;\n  whiskerHigh: number;\n  whiskerLow: number;\n};\n\nexport type BoxPlotOutlierRow = {\n  category: unknown;\n  value: number;\n};\n\nexport type BoxPlotState = {\n  error?: Error;\n  isLoading: boolean;\n  outliers: BoxPlotOutlierRow[];\n  summaries: BoxPlotSummaryRow[];\n  yBrush?: [number, number];\n};\n\nexport type BoxPlotClientOptions = {\n  dataPolicy?: ChartDataPolicy | null;\n  onStateChange: (state: BoxPlotState) => void;\n  runtimeIssueContext?: ChartRuntimeIssueContext;\n  runtimeIssueReporter?: ChartRuntimeIssueReporter;\n  selection: Selection;\n  tableName: string;\n  x: string;\n  y: string;\n};\n\ntype BoxPlotQueryRow = Partial<BoxPlotSummaryRow & BoxPlotOutlierRow> & {\n  rowKind?: 'summary' | 'outlier';\n};\n\nfunction normalizeFilter(filter?: FilterExpr | null): string[] {\n  if (!filter) {\n    return [];\n  }\n  const filters = Array.isArray(filter) ? filter.flat(Infinity) : [filter];\n  return filters\n    .map((expr) => {\n      if (typeof expr === 'boolean') {\n        return expr ? null : 'FALSE';\n      }\n      return `(${(expr as string | ExprNode).toString()})`;\n    })\n    .filter((expr): expr is string => Boolean(expr));\n}\n\n/**\n * Type guard to check if data has a toArray method.\n */\nfunction hasToArrayMethod(data: unknown): data is {toArray: () => unknown} {\n  return (\n    data !== null &&\n    data !== undefined &&\n    typeof data === 'object' &&\n    'toArray' in data &&\n    typeof (data as Record<string, unknown>).toArray === 'function'\n  );\n}\n\n/**\n * Safely extract rows from query result data.\n * Handles both direct arrays and objects with toArray() method.\n * Returns empty array if data is invalid or doesn't have expected structure.\n */\nfunction rowsFromQueryResult<T>(data: unknown): T[] {\n  // Handle direct arrays\n  if (Array.isArray(data)) {\n    return data as T[];\n  }\n\n  // Handle objects with toArray() method (Arrow Tables, Mosaic results, etc.)\n  if (!hasToArrayMethod(data)) {\n    return [];\n  }\n\n  try {\n    const result = data.toArray();\n\n    // Validate that toArray() returned an array\n    if (!Array.isArray(result)) {\n      console.warn(\n        'BoxPlotClient: toArray() did not return an array',\n        typeof result,\n      );\n      return [];\n    }\n\n    return result as T[];\n  } catch (error) {\n    console.error('BoxPlotClient: Error calling toArray():', error);\n    return [];\n  }\n}\n\nfunction numericValue(value: unknown): number | undefined {\n  const numeric = Number(value);\n  return Number.isFinite(numeric) ? numeric : undefined;\n}\n\ntype BuildBoxPlotQueryArgs = {\n  filter?: FilterExpr | null;\n  tableName: string;\n  x: string;\n  y: string;\n};\n\nexport function buildBoxPlotQuery(args: BuildBoxPlotQueryArgs): string {\n  const table = quoteTableReference(args.tableName);\n  const x = escapeId(args.x);\n  const y = escapeId(args.y);\n  const filters = normalizeFilter(args.filter).join(' AND ');\n  const where = [`${y} IS NOT NULL`, filters].filter(Boolean).join(' AND ');\n\n  return `\nWITH base AS (\n  SELECT\n    ${x} AS \"category\",\n    TRY_CAST(${y} AS DOUBLE) AS \"value\"\n  FROM ${table}\n  WHERE ${where}\n),\nstats AS (\n  SELECT\n    \"category\",\n    COUNT(*)::DOUBLE AS \"count\",\n    quantile_cont(\"value\", 0.25) AS \"q1\",\n    quantile_cont(\"value\", 0.5) AS \"median\",\n    quantile_cont(\"value\", 0.75) AS \"q3\"\n  FROM base\n  WHERE \"value\" IS NOT NULL\n  GROUP BY \"category\"\n),\nfences AS (\n  SELECT\n    *,\n    \"q1\" - 1.5 * (\"q3\" - \"q1\") AS \"lowerFence\",\n    \"q3\" + 1.5 * (\"q3\" - \"q1\") AS \"upperFence\"\n  FROM stats\n),\nwhiskers AS (\n  SELECT\n    b.\"category\",\n    MIN(b.\"value\") AS \"whiskerLow\",\n    MAX(b.\"value\") AS \"whiskerHigh\"\n  FROM base b\n  JOIN fences f ON b.\"category\" IS NOT DISTINCT FROM f.\"category\"\n  WHERE b.\"value\" BETWEEN f.\"lowerFence\" AND f.\"upperFence\"\n  GROUP BY b.\"category\"\n),\nsummary AS (\n  SELECT\n    'summary' AS \"rowKind\",\n    f.\"category\",\n    f.\"count\",\n    f.\"q1\",\n    f.\"median\",\n    f.\"q3\",\n    f.\"lowerFence\",\n    f.\"upperFence\",\n    w.\"whiskerLow\",\n    w.\"whiskerHigh\",\n    NULL::DOUBLE AS \"value\"\n  FROM fences f\n  JOIN whiskers w ON w.\"category\" IS NOT DISTINCT FROM f.\"category\"\n),\noutliers AS (\n  SELECT\n    'outlier' AS \"rowKind\",\n    b.\"category\",\n    NULL::DOUBLE AS \"count\",\n    NULL::DOUBLE AS \"q1\",\n    NULL::DOUBLE AS \"median\",\n    NULL::DOUBLE AS \"q3\",\n    NULL::DOUBLE AS \"lowerFence\",\n    NULL::DOUBLE AS \"upperFence\",\n    NULL::DOUBLE AS \"whiskerLow\",\n    NULL::DOUBLE AS \"whiskerHigh\",\n    b.\"value\"\n  FROM base b\n  JOIN fences f ON b.\"category\" IS NOT DISTINCT FROM f.\"category\"\n  WHERE b.\"value\" < f.\"lowerFence\" OR b.\"value\" > f.\"upperFence\"\n)\nSELECT * FROM summary\nUNION ALL\nSELECT * FROM outliers\nORDER BY \"category\", \"rowKind\", \"value\"\n`.trim();\n}\n\nexport class BoxPlotClient extends MosaicClient {\n  private readonly onStateChange: (state: BoxPlotState) => void;\n  private readonly tableName: string;\n  private readonly x: string;\n  private readonly y: string;\n  private readonly selection: Selection;\n  private readonly dataPolicy?: ChartDataPolicy | null;\n  private readonly runtimeIssueContext?: ChartRuntimeIssueContext;\n  private readonly runtimeIssueReporter?: ChartRuntimeIssueReporter;\n  private state: BoxPlotState = {\n    isLoading: true,\n    outliers: [],\n    summaries: [],\n  };\n  private destroyed = false;\n\n  constructor(options: BoxPlotClientOptions) {\n    super(options.selection);\n    this.dataPolicy = options.dataPolicy;\n    this.onStateChange = options.onStateChange;\n    this.runtimeIssueContext = options.runtimeIssueContext;\n    this.runtimeIssueReporter = options.runtimeIssueReporter;\n    this.tableName = options.tableName;\n    this.x = options.x;\n    this.y = options.y;\n    this.selection = options.selection;\n  }\n\n  override get filterStable(): boolean {\n    return false;\n  }\n\n  fields(): string[] {\n    return [this.x, this.y];\n  }\n\n  private emitState(next: Partial<BoxPlotState>) {\n    if (this.destroyed) {\n      return;\n    }\n    this.state = {...this.state, ...next};\n    this.onStateChange(this.state);\n  }\n\n  override queryPending(): this {\n    this.emitState({error: undefined, isLoading: true});\n    return this;\n  }\n\n  override query(filter?: FilterExpr | null): string {\n    return buildBoxPlotQuery({\n      filter,\n      tableName: this.tableName,\n      x: this.x,\n      y: this.y,\n    });\n  }\n\n  override queryResult(data: unknown): this {\n    try {\n      assertChartDataPolicy(this.dataPolicy, data);\n      this.runtimeIssueReporter?.clearIssue();\n    } catch (error) {\n      const normalizedError =\n        error instanceof Error ? error : new Error(String(error));\n      if (this.runtimeIssueContext) {\n        this.runtimeIssueReporter?.reportIssue(\n          createChartRuntimeIssueFromError(\n            normalizedError,\n            this.runtimeIssueContext,\n            this.dataPolicy,\n          ),\n        );\n      }\n      this.emitState({error: normalizedError, isLoading: false});\n      return this;\n    }\n\n    const rows = rowsFromQueryResult<BoxPlotQueryRow>(data);\n    const summaries: BoxPlotSummaryRow[] = [];\n    const outliers: BoxPlotOutlierRow[] = [];\n\n    for (const row of rows) {\n      if (row.rowKind === 'summary') {\n        const count = numericValue(row.count);\n        const q1 = numericValue(row.q1);\n        const median = numericValue(row.median);\n        const q3 = numericValue(row.q3);\n        const lowerFence = numericValue(row.lowerFence);\n        const upperFence = numericValue(row.upperFence);\n        const whiskerLow = numericValue(row.whiskerLow);\n        const whiskerHigh = numericValue(row.whiskerHigh);\n        if (\n          count === undefined ||\n          q1 === undefined ||\n          median === undefined ||\n          q3 === undefined ||\n          lowerFence === undefined ||\n          upperFence === undefined ||\n          whiskerLow === undefined ||\n          whiskerHigh === undefined\n        ) {\n          continue;\n        }\n        summaries.push({\n          category: row.category,\n          count,\n          lowerFence,\n          median,\n          q1,\n          q3,\n          upperFence,\n          whiskerHigh,\n          whiskerLow,\n        });\n      } else if (row.rowKind === 'outlier') {\n        const value = numericValue(row.value);\n        if (value !== undefined) {\n          outliers.push({\n            category: row.category,\n            value,\n          });\n        }\n      }\n    }\n\n    this.emitState({\n      error: undefined,\n      isLoading: false,\n      outliers,\n      summaries,\n    });\n    return this;\n  }\n\n  override queryError(error: Error): this {\n    if (this.runtimeIssueContext) {\n      this.runtimeIssueReporter?.reportIssue(\n        createChartRuntimeIssueFromError(\n          error,\n          this.runtimeIssueContext,\n          this.dataPolicy,\n        ),\n      );\n    }\n    this.emitState({error, isLoading: false});\n    return this;\n  }\n\n  updateYBrush(extent?: [number, number]) {\n    const normalized = extent\n      ? ([Math.min(...extent), Math.max(...extent)] as [number, number])\n      : undefined;\n    this.emitState({yBrush: normalized});\n    const clause = clauseInterval(this.y, normalized ?? null, {source: this});\n    this.selection.update(clause);\n  }\n\n  reset() {\n    this.updateYBrush();\n  }\n\n  override destroy() {\n    this.destroyed = true;\n    super.destroy();\n  }\n}\n"]}
+{"version":3,"file":"BoxPlotClient.js","sourceRoot":"","sources":["../../../../../src/charts/chart-types/box-plot/renderer/BoxPlotClient.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  MosaicClient,\n  clauseInterval,\n  type Selection,\n} from '@uwdata/mosaic-core';\nimport {escapeId, type QualifiedTableName} from '@sqlrooms/duckdb';\nimport type {ExprNode, FilterExpr} from '@uwdata/mosaic-sql';\nimport {\n  assertChartDataPolicy,\n  createChartRuntimeIssueFromError,\n  type ChartDataPolicy,\n  type ChartRuntimeIssueContext,\n  type ChartRuntimeIssueReporter,\n} from '../../../../chart-runtime';\nimport {getMosaicRawSqlTableReference} from '../../../../mosaicTableReference';\n\nexport type BoxPlotSummaryRow = {\n  category: unknown;\n  count: number;\n  lowerFence: number;\n  median: number;\n  q1: number;\n  q3: number;\n  upperFence: number;\n  whiskerHigh: number;\n  whiskerLow: number;\n};\n\nexport type BoxPlotOutlierRow = {\n  category: unknown;\n  value: number;\n};\n\nexport type BoxPlotState = {\n  error?: Error;\n  isLoading: boolean;\n  outliers: BoxPlotOutlierRow[];\n  summaries: BoxPlotSummaryRow[];\n  yBrush?: [number, number];\n};\n\n/**\n * Options used to construct a {@link BoxPlotClient}.\n *\n * @property dataPolicy - Optional row-limit policy to validate query results.\n * @property onStateChange - Callback invoked whenever query or brush state changes.\n * @property runtimeIssueContext - Optional context attached to reported runtime issues.\n * @property runtimeIssueReporter - Optional reporter used for query and policy failures.\n * @property selection - Mosaic selection used for external filters and y-axis brushing.\n * @property table - Canonical SQLRooms table identity. The client converts it\n *   with `getMosaicRawSqlTableReference`, so callers should pass the structured\n *   `QualifiedTableName` instead of a pre-rendered SQL string.\n * @property x - Category column name.\n * @property y - Numeric value column name.\n */\nexport type BoxPlotClientOptions = {\n  dataPolicy?: ChartDataPolicy | null;\n  onStateChange: (state: BoxPlotState) => void;\n  runtimeIssueContext?: ChartRuntimeIssueContext;\n  runtimeIssueReporter?: ChartRuntimeIssueReporter;\n  selection: Selection;\n  table: QualifiedTableName;\n  x: string;\n  y: string;\n};\n\ntype BoxPlotQueryRow = Partial<BoxPlotSummaryRow & BoxPlotOutlierRow> & {\n  rowKind?: 'summary' | 'outlier';\n};\n\nfunction normalizeFilter(filter?: FilterExpr | null): string[] {\n  if (!filter) {\n    return [];\n  }\n  const filters = Array.isArray(filter) ? filter.flat(Infinity) : [filter];\n  return filters\n    .map((expr) => {\n      if (typeof expr === 'boolean') {\n        return expr ? null : 'FALSE';\n      }\n      return `(${(expr as string | ExprNode).toString()})`;\n    })\n    .filter((expr): expr is string => Boolean(expr));\n}\n\n/**\n * Type guard to check if data has a toArray method.\n */\nfunction hasToArrayMethod(data: unknown): data is {toArray: () => unknown} {\n  return (\n    data !== null &&\n    data !== undefined &&\n    typeof data === 'object' &&\n    'toArray' in data &&\n    typeof (data as Record<string, unknown>).toArray === 'function'\n  );\n}\n\n/**\n * Safely extract rows from query result data.\n * Handles both direct arrays and objects with toArray() method.\n * Returns empty array if data is invalid or doesn't have expected structure.\n */\nfunction rowsFromQueryResult<T>(data: unknown): T[] {\n  // Handle direct arrays\n  if (Array.isArray(data)) {\n    return data as T[];\n  }\n\n  // Handle objects with toArray() method (Arrow Tables, Mosaic results, etc.)\n  if (!hasToArrayMethod(data)) {\n    return [];\n  }\n\n  try {\n    const result = data.toArray();\n\n    // Validate that toArray() returned an array\n    if (!Array.isArray(result)) {\n      console.warn(\n        'BoxPlotClient: toArray() did not return an array',\n        typeof result,\n      );\n      return [];\n    }\n\n    return result as T[];\n  } catch (error) {\n    console.error('BoxPlotClient: Error calling toArray():', error);\n    return [];\n  }\n}\n\nfunction numericValue(value: unknown): number | undefined {\n  const numeric = Number(value);\n  return Number.isFinite(numeric) ? numeric : undefined;\n}\n\ntype BuildBoxPlotQueryArgs = {\n  filter?: FilterExpr | null;\n  table: QualifiedTableName;\n  x: string;\n  y: string;\n};\n\n/**\n * Builds the SQL used by {@link BoxPlotClient} to compute box plot summaries.\n *\n * @param args - Query inputs including the source table, selected columns, and\n *   optional Mosaic filter expression.\n * @returns SQL that returns summary rows and outlier rows for the box plot.\n *\n * The structured `QualifiedTableName` is converted with\n * `getMosaicRawSqlTableReference`, which intentionally produces the\n * catalog-free SQL fragment expected by Mosaic's active connector.\n */\nexport function buildBoxPlotQuery(args: BuildBoxPlotQueryArgs): string {\n  const tableReference = getMosaicRawSqlTableReference(args.table);\n  const x = escapeId(args.x);\n  const y = escapeId(args.y);\n  const filters = normalizeFilter(args.filter).join(' AND ');\n  const where = [`${y} IS NOT NULL`, filters].filter(Boolean).join(' AND ');\n\n  return `\nWITH base AS (\n  SELECT\n    ${x} AS \"category\",\n    TRY_CAST(${y} AS DOUBLE) AS \"value\"\n  FROM ${tableReference}\n  WHERE ${where}\n),\nstats AS (\n  SELECT\n    \"category\",\n    COUNT(*)::DOUBLE AS \"count\",\n    quantile_cont(\"value\", 0.25) AS \"q1\",\n    quantile_cont(\"value\", 0.5) AS \"median\",\n    quantile_cont(\"value\", 0.75) AS \"q3\"\n  FROM base\n  WHERE \"value\" IS NOT NULL\n  GROUP BY \"category\"\n),\nfences AS (\n  SELECT\n    *,\n    \"q1\" - 1.5 * (\"q3\" - \"q1\") AS \"lowerFence\",\n    \"q3\" + 1.5 * (\"q3\" - \"q1\") AS \"upperFence\"\n  FROM stats\n),\nwhiskers AS (\n  SELECT\n    b.\"category\",\n    MIN(b.\"value\") AS \"whiskerLow\",\n    MAX(b.\"value\") AS \"whiskerHigh\"\n  FROM base b\n  JOIN fences f ON b.\"category\" IS NOT DISTINCT FROM f.\"category\"\n  WHERE b.\"value\" BETWEEN f.\"lowerFence\" AND f.\"upperFence\"\n  GROUP BY b.\"category\"\n),\nsummary AS (\n  SELECT\n    'summary' AS \"rowKind\",\n    f.\"category\",\n    f.\"count\",\n    f.\"q1\",\n    f.\"median\",\n    f.\"q3\",\n    f.\"lowerFence\",\n    f.\"upperFence\",\n    w.\"whiskerLow\",\n    w.\"whiskerHigh\",\n    NULL::DOUBLE AS \"value\"\n  FROM fences f\n  JOIN whiskers w ON w.\"category\" IS NOT DISTINCT FROM f.\"category\"\n),\noutliers AS (\n  SELECT\n    'outlier' AS \"rowKind\",\n    b.\"category\",\n    NULL::DOUBLE AS \"count\",\n    NULL::DOUBLE AS \"q1\",\n    NULL::DOUBLE AS \"median\",\n    NULL::DOUBLE AS \"q3\",\n    NULL::DOUBLE AS \"lowerFence\",\n    NULL::DOUBLE AS \"upperFence\",\n    NULL::DOUBLE AS \"whiskerLow\",\n    NULL::DOUBLE AS \"whiskerHigh\",\n    b.\"value\"\n  FROM base b\n  JOIN fences f ON b.\"category\" IS NOT DISTINCT FROM f.\"category\"\n  WHERE b.\"value\" < f.\"lowerFence\" OR b.\"value\" > f.\"upperFence\"\n)\nSELECT * FROM summary\nUNION ALL\nSELECT * FROM outliers\nORDER BY \"category\", \"rowKind\", \"value\"\n`.trim();\n}\n\n/**\n * Mosaic query client that powers the custom box plot renderer.\n *\n * The client owns SQL generation, query-result normalization, runtime issue\n * reporting, and y-axis brush selection updates. It accepts a structured\n * `QualifiedTableName` so table identity remains canonical until the query is\n * rendered for Mosaic SQL.\n */\nexport class BoxPlotClient extends MosaicClient {\n  private readonly onStateChange: (state: BoxPlotState) => void;\n  private readonly table: QualifiedTableName;\n  private readonly x: string;\n  private readonly y: string;\n  private readonly selection: Selection;\n  private readonly dataPolicy?: ChartDataPolicy | null;\n  private readonly runtimeIssueContext?: ChartRuntimeIssueContext;\n  private readonly runtimeIssueReporter?: ChartRuntimeIssueReporter;\n  private state: BoxPlotState = {\n    isLoading: true,\n    outliers: [],\n    summaries: [],\n  };\n  private destroyed = false;\n\n  constructor(options: BoxPlotClientOptions) {\n    super(options.selection);\n    this.dataPolicy = options.dataPolicy;\n    this.onStateChange = options.onStateChange;\n    this.runtimeIssueContext = options.runtimeIssueContext;\n    this.runtimeIssueReporter = options.runtimeIssueReporter;\n    this.table = options.table;\n    this.x = options.x;\n    this.y = options.y;\n    this.selection = options.selection;\n  }\n\n  override get filterStable(): boolean {\n    return false;\n  }\n\n  fields(): string[] {\n    return [this.x, this.y];\n  }\n\n  private emitState(next: Partial<BoxPlotState>) {\n    if (this.destroyed) {\n      return;\n    }\n    this.state = {...this.state, ...next};\n    this.onStateChange(this.state);\n  }\n\n  override queryPending(): this {\n    this.emitState({error: undefined, isLoading: true});\n    return this;\n  }\n\n  override query(filter?: FilterExpr | null): string {\n    return buildBoxPlotQuery({\n      filter,\n      table: this.table,\n      x: this.x,\n      y: this.y,\n    });\n  }\n\n  override queryResult(data: unknown): this {\n    try {\n      assertChartDataPolicy(this.dataPolicy, data);\n      this.runtimeIssueReporter?.clearIssue();\n    } catch (error) {\n      const normalizedError =\n        error instanceof Error ? error : new Error(String(error));\n      if (this.runtimeIssueContext) {\n        this.runtimeIssueReporter?.reportIssue(\n          createChartRuntimeIssueFromError(\n            normalizedError,\n            this.runtimeIssueContext,\n            this.dataPolicy,\n          ),\n        );\n      }\n      this.emitState({error: normalizedError, isLoading: false});\n      return this;\n    }\n\n    const rows = rowsFromQueryResult<BoxPlotQueryRow>(data);\n    const summaries: BoxPlotSummaryRow[] = [];\n    const outliers: BoxPlotOutlierRow[] = [];\n\n    for (const row of rows) {\n      if (row.rowKind === 'summary') {\n        const count = numericValue(row.count);\n        const q1 = numericValue(row.q1);\n        const median = numericValue(row.median);\n        const q3 = numericValue(row.q3);\n        const lowerFence = numericValue(row.lowerFence);\n        const upperFence = numericValue(row.upperFence);\n        const whiskerLow = numericValue(row.whiskerLow);\n        const whiskerHigh = numericValue(row.whiskerHigh);\n        if (\n          count === undefined ||\n          q1 === undefined ||\n          median === undefined ||\n          q3 === undefined ||\n          lowerFence === undefined ||\n          upperFence === undefined ||\n          whiskerLow === undefined ||\n          whiskerHigh === undefined\n        ) {\n          continue;\n        }\n        summaries.push({\n          category: row.category,\n          count,\n          lowerFence,\n          median,\n          q1,\n          q3,\n          upperFence,\n          whiskerHigh,\n          whiskerLow,\n        });\n      } else if (row.rowKind === 'outlier') {\n        const value = numericValue(row.value);\n        if (value !== undefined) {\n          outliers.push({\n            category: row.category,\n            value,\n          });\n        }\n      }\n    }\n\n    this.emitState({\n      error: undefined,\n      isLoading: false,\n      outliers,\n      summaries,\n    });\n    return this;\n  }\n\n  override queryError(error: Error): this {\n    if (this.runtimeIssueContext) {\n      this.runtimeIssueReporter?.reportIssue(\n        createChartRuntimeIssueFromError(\n          error,\n          this.runtimeIssueContext,\n          this.dataPolicy,\n        ),\n      );\n    }\n    this.emitState({error, isLoading: false});\n    return this;\n  }\n\n  updateYBrush(extent?: [number, number]) {\n    const normalized = extent\n      ? ([Math.min(...extent), Math.max(...extent)] as [number, number])\n      : undefined;\n    this.emitState({yBrush: normalized});\n    const clause = clauseInterval(this.y, normalized ?? null, {source: this});\n    this.selection.update(clause);\n  }\n\n  reset() {\n    this.updateYBrush();\n  }\n\n  override destroy() {\n    this.destroyed = true;\n    super.destroy();\n  }\n}\n"]}

package/dist/charts/chart-types/box-plot/renderer/BoxPlotPanelRenderer.js

@@ -11,7 +11,7 @@ import { BoxPlotErrorBoundary } from './BoxPlotErrorBoundary';
  * Custom renderer for box-plot chart type.
  * Uses BoxPlotClient for SQL-based quartile calculations and custom Observable Plot rendering.
  */
-export const BoxPlotPanelRenderer = ({ tableName, config, coordinator, params, dataPolicy, runtimeIssueContext, runtimeIssueReporter, }) => {
+export const BoxPlotPanelRenderer = ({ table, config, coordinator, params, dataPolicy, runtimeIssueContext, runtimeIssueReporter, }) => {
     const configX = config.settings.x;
     const configY = config.settings.y;
     const boxPlotConfig = useMemo(() => typeof configX === 'string' && typeof configY === 'string'
@@ -27,7 +27,7 @@ export const BoxPlotPanelRenderer = ({ tableName, config, coordinator, params, d
         params,
         runtimeIssueContext,
         runtimeIssueReporter,
-        tableName,
+        table,
     });
     const summaries = useMemo(() => state.summaries.map((row) => ({
         ...row,

package/dist/charts/chart-types/box-plot/renderer/BoxPlotPanelRenderer.js.map

@@ -1 +1 @@
-{"version":3,"file":"BoxPlotPanelRenderer.js","sourceRoot":"","sources":["../../../../../src/charts/chart-types/box-plot/renderer/BoxPlotPanelRenderer.tsx"],"names":[],"mappings":"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","sourcesContent":["import type {FC, PointerEvent as ReactPointerEvent} from 'react';\nimport {useCallback, useEffect, useMemo, useRef, useState} from 'react';\nimport {SpinnerPane} from '@sqlrooms/ui';\nimport {type PlotSize, ResponsivePlot} from '../../../../ResponsivePlot';\nimport type {ChartRendererProps} from '../../base-types';\nimport {\n  DRAG_CLICK_THRESHOLD,\n  MARGINS,\n  type PlotOutlierDatum,\n  type PlotSummaryDatum,\n} from './constants';\nimport {createBoxPlotElement} from './plot';\nimport type {BoxPlotChartConfig} from '../schema';\nimport {useBoxPlotClient} from './useBoxPlotClient';\nimport {formatCategory, getYDomain, yPixelToValue} from './utils';\nimport {BoxPlotErrorBoundary} from './BoxPlotErrorBoundary';\n\n/**\n * Custom renderer for box-plot chart type.\n * Uses BoxPlotClient for SQL-based quartile calculations and custom Observable Plot rendering.\n */\nexport const BoxPlotPanelRenderer: FC<\n  ChartRendererProps<BoxPlotChartConfig>\n> = ({\n  tableName,\n  config,\n  coordinator,\n  params,\n  dataPolicy,\n  runtimeIssueContext,\n  runtimeIssueReporter,\n}) => {\n  const configX = config.settings.x;\n  const configY = config.settings.y;\n  const boxPlotConfig = useMemo(\n    () =>\n      typeof configX === 'string' && typeof configY === 'string'\n        ? {x: configX, y: configY}\n        : null,\n    [configX, configY],\n  );\n\n  const [size, setSize] = useState<PlotSize | null>(null);\n  const [drag, setDrag] = useState<{startY: number; currentY: number} | null>(\n    null,\n  );\n  const plotRef = useRef<HTMLDivElement>(null);\n\n  const {clientRef, state} = useBoxPlotClient({\n    config: boxPlotConfig,\n    coordinator,\n    dataPolicy,\n    params,\n    runtimeIssueContext,\n    runtimeIssueReporter,\n    tableName,\n  });\n\n  const summaries = useMemo<PlotSummaryDatum[]>(\n    () =>\n      state.summaries.map((row) => ({\n        ...row,\n        categoryLabel: formatCategory(row.category),\n      })),\n    [state.summaries],\n  );\n  const outliers = useMemo<PlotOutlierDatum[]>(\n    () =>\n      state.outliers.map((row) => ({\n        ...row,\n        categoryLabel: formatCategory(row.category),\n      })),\n    [state.outliers],\n  );\n  const yDomain = useMemo(\n    () => getYDomain(state.summaries, state.outliers),\n    [state.outliers, state.summaries],\n  );\n\n  useEffect(() => {\n    const container = plotRef.current;\n    if (!container || !size || !boxPlotConfig) {\n      return;\n    }\n    if (!summaries.length) {\n      container.replaceChildren();\n      return;\n    }\n\n    const plot = createBoxPlotElement({\n      config: boxPlotConfig,\n      domain: yDomain,\n      outliers,\n      size,\n      summaries,\n    });\n    container.replaceChildren(plot);\n  }, [boxPlotConfig, outliers, size, summaries, yDomain]);\n\n  const getLocalY = useCallback((event: ReactPointerEvent<HTMLDivElement>) => {\n    const rect = event.currentTarget.getBoundingClientRect();\n    return event.clientY - rect.top;\n  }, []);\n\n  const handlePointerDown = useCallback(\n    (event: ReactPointerEvent<HTMLDivElement>) => {\n      if (!size || !summaries.length) return;\n      event.currentTarget.setPointerCapture(event.pointerId);\n      const y = getLocalY(event);\n      setDrag({currentY: y, startY: y});\n    },\n    [getLocalY, size, summaries.length],\n  );\n\n  const handlePointerMove = useCallback(\n    (event: ReactPointerEvent<HTMLDivElement>) => {\n      if (!drag) return;\n      setDrag({...drag, currentY: getLocalY(event)});\n    },\n    [drag, getLocalY],\n  );\n\n  const finishDrag = useCallback(\n    (event: ReactPointerEvent<HTMLDivElement>) => {\n      if (!drag || !size) return;\n      event.currentTarget.releasePointerCapture(event.pointerId);\n      const currentY = getLocalY(event);\n      const pixelDistance = Math.abs(currentY - drag.startY);\n      setDrag(null);\n      if (pixelDistance < DRAG_CLICK_THRESHOLD) {\n        clientRef.current?.updateYBrush();\n        return;\n      }\n      clientRef.current?.updateYBrush([\n        yPixelToValue(drag.startY, size, yDomain),\n        yPixelToValue(currentY, size, yDomain),\n      ]);\n    },\n    [clientRef, drag, getLocalY, size, yDomain],\n  );\n\n  const brushStyle = useMemo(() => {\n    const extent = drag\n      ? [drag.startY, drag.currentY]\n      : state.yBrush && size\n        ? state.yBrush.map((value) => {\n            const plotHeight = Math.max(\n              1,\n              size.height - MARGINS.top - MARGINS.bottom,\n            );\n            const span = yDomain[1] - yDomain[0] || 1;\n            const pixelPos =\n              MARGINS.top + ((yDomain[1] - value) / span) * plotHeight;\n            return Math.max(\n              MARGINS.top,\n              Math.min(MARGINS.top + plotHeight, pixelPos),\n            );\n          })\n        : null;\n    if (!extent) return undefined;\n    const top = Math.max(MARGINS.top, Math.min(...extent));\n    const bottom = Math.min(\n      size?.height ? size.height - MARGINS.bottom : Number.POSITIVE_INFINITY,\n      Math.max(...extent),\n    );\n    return {\n      height: `${Math.max(0, bottom - top)}px`,\n      left: `${MARGINS.left}px`,\n      right: `${MARGINS.right}px`,\n      top: `${top}px`,\n    };\n  }, [drag, size, state.yBrush, yDomain]);\n\n  if (!config.settings.x || !config.settings.y) {\n    return (\n      <div className=\"flex h-full flex-col items-center justify-center\">\n        <div className=\"text-center font-medium\">\n          Configure chart to display visualization\n        </div>\n        <div className=\"text-center text-xs\">\n          X and Y fields are required for box plot\n        </div>\n      </div>\n    );\n  }\n\n  return (\n    <BoxPlotErrorBoundary>\n      <div className=\"h-full min-h-0 overflow-auto p-2\">\n        <div className=\"bg-background text-foreground relative flex h-full min-h-[220px] w-full items-center justify-center rounded-md p-2\">\n          {state.error ? (\n            <div className=\"text-destructive flex h-full items-center justify-center p-4 text-sm\">\n              {state.error.message}\n            </div>\n          ) : state.isLoading && !state.summaries.length ? (\n            <SpinnerPane className=\"h-full w-full\" />\n          ) : !state.summaries.length ? (\n            <div className=\"text-muted-foreground flex h-full items-center justify-center text-sm\">\n              No numeric values for this box plot\n            </div>\n          ) : (\n            <ResponsivePlot\n              onResize={setSize}\n              className=\"relative h-full min-h-[220px] w-full\"\n            >\n              <div ref={plotRef} className=\"absolute inset-0\" />\n              {brushStyle ? (\n                <div\n                  className=\"bg-primary/15 border-primary/60 pointer-events-none absolute border\"\n                  style={brushStyle}\n                />\n              ) : null}\n              <div\n                className=\"absolute inset-0 cursor-crosshair touch-none\"\n                onPointerCancel={finishDrag}\n                onPointerDown={handlePointerDown}\n                onPointerMove={handlePointerMove}\n                onPointerUp={finishDrag}\n              />\n            </ResponsivePlot>\n          )}\n        </div>\n      </div>\n    </BoxPlotErrorBoundary>\n  );\n};\n"]}
+{"version":3,"file":"BoxPlotPanelRenderer.js","sourceRoot":"","sources":["../../../../../src/charts/chart-types/box-plot/renderer/BoxPlotPanelRenderer.tsx"],"names":[],"mappings":"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","sourcesContent":["import type {FC, PointerEvent as ReactPointerEvent} from 'react';\nimport {useCallback, useEffect, useMemo, useRef, useState} from 'react';\nimport {SpinnerPane} from '@sqlrooms/ui';\nimport {type PlotSize, ResponsivePlot} from '../../../../ResponsivePlot';\nimport type {ChartRendererProps} from '../../base-types';\nimport {\n  DRAG_CLICK_THRESHOLD,\n  MARGINS,\n  type PlotOutlierDatum,\n  type PlotSummaryDatum,\n} from './constants';\nimport {createBoxPlotElement} from './plot';\nimport type {BoxPlotChartConfig} from '../schema';\nimport {useBoxPlotClient} from './useBoxPlotClient';\nimport {formatCategory, getYDomain, yPixelToValue} from './utils';\nimport {BoxPlotErrorBoundary} from './BoxPlotErrorBoundary';\n\n/**\n * Custom renderer for box-plot chart type.\n * Uses BoxPlotClient for SQL-based quartile calculations and custom Observable Plot rendering.\n */\nexport const BoxPlotPanelRenderer: FC<\n  ChartRendererProps<BoxPlotChartConfig>\n> = ({\n  table,\n  config,\n  coordinator,\n  params,\n  dataPolicy,\n  runtimeIssueContext,\n  runtimeIssueReporter,\n}) => {\n  const configX = config.settings.x;\n  const configY = config.settings.y;\n  const boxPlotConfig = useMemo(\n    () =>\n      typeof configX === 'string' && typeof configY === 'string'\n        ? {x: configX, y: configY}\n        : null,\n    [configX, configY],\n  );\n\n  const [size, setSize] = useState<PlotSize | null>(null);\n  const [drag, setDrag] = useState<{startY: number; currentY: number} | null>(\n    null,\n  );\n  const plotRef = useRef<HTMLDivElement>(null);\n\n  const {clientRef, state} = useBoxPlotClient({\n    config: boxPlotConfig,\n    coordinator,\n    dataPolicy,\n    params,\n    runtimeIssueContext,\n    runtimeIssueReporter,\n    table,\n  });\n\n  const summaries = useMemo<PlotSummaryDatum[]>(\n    () =>\n      state.summaries.map((row) => ({\n        ...row,\n        categoryLabel: formatCategory(row.category),\n      })),\n    [state.summaries],\n  );\n  const outliers = useMemo<PlotOutlierDatum[]>(\n    () =>\n      state.outliers.map((row) => ({\n        ...row,\n        categoryLabel: formatCategory(row.category),\n      })),\n    [state.outliers],\n  );\n  const yDomain = useMemo(\n    () => getYDomain(state.summaries, state.outliers),\n    [state.outliers, state.summaries],\n  );\n\n  useEffect(() => {\n    const container = plotRef.current;\n    if (!container || !size || !boxPlotConfig) {\n      return;\n    }\n    if (!summaries.length) {\n      container.replaceChildren();\n      return;\n    }\n\n    const plot = createBoxPlotElement({\n      config: boxPlotConfig,\n      domain: yDomain,\n      outliers,\n      size,\n      summaries,\n    });\n    container.replaceChildren(plot);\n  }, [boxPlotConfig, outliers, size, summaries, yDomain]);\n\n  const getLocalY = useCallback((event: ReactPointerEvent<HTMLDivElement>) => {\n    const rect = event.currentTarget.getBoundingClientRect();\n    return event.clientY - rect.top;\n  }, []);\n\n  const handlePointerDown = useCallback(\n    (event: ReactPointerEvent<HTMLDivElement>) => {\n      if (!size || !summaries.length) return;\n      event.currentTarget.setPointerCapture(event.pointerId);\n      const y = getLocalY(event);\n      setDrag({currentY: y, startY: y});\n    },\n    [getLocalY, size, summaries.length],\n  );\n\n  const handlePointerMove = useCallback(\n    (event: ReactPointerEvent<HTMLDivElement>) => {\n      if (!drag) return;\n      setDrag({...drag, currentY: getLocalY(event)});\n    },\n    [drag, getLocalY],\n  );\n\n  const finishDrag = useCallback(\n    (event: ReactPointerEvent<HTMLDivElement>) => {\n      if (!drag || !size) return;\n      event.currentTarget.releasePointerCapture(event.pointerId);\n      const currentY = getLocalY(event);\n      const pixelDistance = Math.abs(currentY - drag.startY);\n      setDrag(null);\n      if (pixelDistance < DRAG_CLICK_THRESHOLD) {\n        clientRef.current?.updateYBrush();\n        return;\n      }\n      clientRef.current?.updateYBrush([\n        yPixelToValue(drag.startY, size, yDomain),\n        yPixelToValue(currentY, size, yDomain),\n      ]);\n    },\n    [clientRef, drag, getLocalY, size, yDomain],\n  );\n\n  const brushStyle = useMemo(() => {\n    const extent = drag\n      ? [drag.startY, drag.currentY]\n      : state.yBrush && size\n        ? state.yBrush.map((value) => {\n            const plotHeight = Math.max(\n              1,\n              size.height - MARGINS.top - MARGINS.bottom,\n            );\n            const span = yDomain[1] - yDomain[0] || 1;\n            const pixelPos =\n              MARGINS.top + ((yDomain[1] - value) / span) * plotHeight;\n            return Math.max(\n              MARGINS.top,\n              Math.min(MARGINS.top + plotHeight, pixelPos),\n            );\n          })\n        : null;\n    if (!extent) return undefined;\n    const top = Math.max(MARGINS.top, Math.min(...extent));\n    const bottom = Math.min(\n      size?.height ? size.height - MARGINS.bottom : Number.POSITIVE_INFINITY,\n      Math.max(...extent),\n    );\n    return {\n      height: `${Math.max(0, bottom - top)}px`,\n      left: `${MARGINS.left}px`,\n      right: `${MARGINS.right}px`,\n      top: `${top}px`,\n    };\n  }, [drag, size, state.yBrush, yDomain]);\n\n  if (!config.settings.x || !config.settings.y) {\n    return (\n      <div className=\"flex h-full flex-col items-center justify-center\">\n        <div className=\"text-center font-medium\">\n          Configure chart to display visualization\n        </div>\n        <div className=\"text-center text-xs\">\n          X and Y fields are required for box plot\n        </div>\n      </div>\n    );\n  }\n\n  return (\n    <BoxPlotErrorBoundary>\n      <div className=\"h-full min-h-0 overflow-auto p-2\">\n        <div className=\"bg-background text-foreground relative flex h-full min-h-[220px] w-full items-center justify-center rounded-md p-2\">\n          {state.error ? (\n            <div className=\"text-destructive flex h-full items-center justify-center p-4 text-sm\">\n              {state.error.message}\n            </div>\n          ) : state.isLoading && !state.summaries.length ? (\n            <SpinnerPane className=\"h-full w-full\" />\n          ) : !state.summaries.length ? (\n            <div className=\"text-muted-foreground flex h-full items-center justify-center text-sm\">\n              No numeric values for this box plot\n            </div>\n          ) : (\n            <ResponsivePlot\n              onResize={setSize}\n              className=\"relative h-full min-h-[220px] w-full\"\n            >\n              <div ref={plotRef} className=\"absolute inset-0\" />\n              {brushStyle ? (\n                <div\n                  className=\"bg-primary/15 border-primary/60 pointer-events-none absolute border\"\n                  style={brushStyle}\n                />\n              ) : null}\n              <div\n                className=\"absolute inset-0 cursor-crosshair touch-none\"\n                onPointerCancel={finishDrag}\n                onPointerDown={handlePointerDown}\n                onPointerMove={handlePointerMove}\n                onPointerUp={finishDrag}\n              />\n            </ResponsivePlot>\n          )}\n        </div>\n      </div>\n    </BoxPlotErrorBoundary>\n  );\n};\n"]}

package/dist/charts/chart-types/box-plot/renderer/useBoxPlotClient.d.ts

@@ -1,8 +1,19 @@
 import { Coordinator } from '@uwdata/mosaic-core';
 import { BoxPlotClient, type BoxPlotState } from './BoxPlotClient';
 import type { BrushSelectionParams } from '../../base-types';
+import type { QualifiedTableName } from '@sqlrooms/duckdb';
 import type { ChartDataPolicy, ChartRuntimeIssueContext, ChartRuntimeIssueReporter } from '../../../../chart-runtime';
 import { BoxPlotChartSettings } from '../schema';
+/**
+ * Creates and connects the Mosaic client used by the box plot renderer.
+ *
+ * @param args - Hook inputs including chart settings, Mosaic coordinator,
+ *   optional dashboard services, and the resolved source table.
+ * @param args.table - Canonical `QualifiedTableName` for the source table. The
+ *   hook passes this structured identity through to {@link BoxPlotClient}, where
+ *   it is converted to a Mosaic SQL table reference at query-build time.
+ * @returns The active client ref and normalized renderer state.
+ */
 export declare function useBoxPlotClient(args: {
     config: BoxPlotChartSettings | null;
     coordinator: Coordinator;
@@ -10,7 +21,7 @@ export declare function useBoxPlotClient(args: {
     params?: BrushSelectionParams;
     runtimeIssueContext?: ChartRuntimeIssueContext;
     runtimeIssueReporter?: ChartRuntimeIssueReporter;
-    tableName: string;
+    table: QualifiedTableName;
 }): {
     clientRef: import("react").RefObject<BoxPlotClient | null>;
     state: BoxPlotState;

package/dist/charts/chart-types/box-plot/renderer/useBoxPlotClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useBoxPlotClient.d.ts","sourceRoot":"","sources":["../../../../../src/charts/chart-types/box-plot/renderer/useBoxPlotClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAY,MAAM,qBAAqB,CAAC;AAE3D,OAAO,EAAC,aAAa,EAAE,KAAK,YAAY,EAAC,MAAM,iBAAiB,CAAC;AACjE,OAAO,KAAK,EAAC,oBAAoB,EAAC,MAAM,kBAAkB,CAAC;AAC3D,OAAO,KAAK,EACV,eAAe,EACf,wBAAwB,EACxB,yBAAyB,EAC1B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAC,oBAAoB,EAAC,MAAM,WAAW,CAAC;AAE/C,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACpC,WAAW,EAAE,WAAW,CAAC;IACzB,UAAU,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IACpC,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,mBAAmB,CAAC,EAAE,wBAAwB,CAAC;IAC/C,oBAAoB,CAAC,EAAE,yBAAyB,CAAC;IACjD,SAAS,EAAE,MAAM,CAAC;CACnB;;;EAyEA"}
+{"version":3,"file":"useBoxPlotClient.d.ts","sourceRoot":"","sources":["../../../../../src/charts/chart-types/box-plot/renderer/useBoxPlotClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,WAAW,EAAY,MAAM,qBAAqB,CAAC;AAE3D,OAAO,EAAC,aAAa,EAAE,KAAK,YAAY,EAAC,MAAM,iBAAiB,CAAC;AACjE,OAAO,KAAK,EAAC,oBAAoB,EAAC,MAAM,kBAAkB,CAAC;AAC3D,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EACV,eAAe,EACf,wBAAwB,EACxB,yBAAyB,EAC1B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAC,oBAAoB,EAAC,MAAM,WAAW,CAAC;AAE/C;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACpC,WAAW,EAAE,WAAW,CAAC;IACzB,UAAU,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IACpC,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,mBAAmB,CAAC,EAAE,wBAAwB,CAAC;IAC/C,oBAAoB,CAAC,EAAE,yBAAyB,CAAC;IACjD,KAAK,EAAE,kBAAkB,CAAC;CAC3B;;;EAyEA"}