@kanzo-tech/ui 0.11.0 → 0.13.0

package/dist/charts/chart-marks.d.ts.map

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

package/dist/charts/chart-marks.js.map

@@ -1 +1 @@
-{"version":3,"file":"chart-marks.js","sources":["../../src/charts/chart-marks.tsx"],"sourcesContent":["import type { Selection } from \"@uwdata/mosaic-core\";\nimport { isColorToken, isColorValue } from \"./chart-config.js\";\nimport {\n  chartDescriptor,\n  type ChartDescriptor,\n  type ChartMarkDirective,\n  type ChartMarkSource,\n  type ChartSpecContext,\n} from \"./chart-spec.js\";\n\n/**\n * The mark vocabulary. Every component here renders `null` — `ChartRoot` reads the `__chart`\n * static off the element type and compiles it.\n *\n * This file carries no `\"use client\"`, and the docblock claimed the opposite for as long as it\n * existed: \"load-bearing even though nothing here uses a hook\". The rule the repo actually\n * enforces is in `client-boundary.test.ts` — a file declares the directive **iff it is itself\n * stateful** — and nothing here is, so the guard would reject it. The claim and the code were\n * never both true.\n *\n * What the claim got right is the mechanism, and it is worth keeping: a descriptor rendered on the\n * server DOES collapse to `null` before `ChartRoot` sees the element, because the `__chart` static\n * lives on the element *type* and a Server Component is invoked before serialisation. What it got\n * wrong is what prevents it. Not a directive here — the consumer. Every chart is written inside a\n * client component, necessarily: `MosaicProvider` is one, and there is no coordinator without it.\n * All 38 chart examples in `docs/examples` open with `\"use client\"`.\n *\n * So the trap is real and it belongs to a CONSUMER who writes a chart in a Server Component: the\n * marks vanish and the plot renders empty, with no error anywhere. Nothing catches that today —\n * `client-boundary.test.ts` matches shape and this file's shape is pure, and the docs RSC build only exercises the client path our own\n * examples take. Fixing it properly means either the directive plus an exception in that guard for\n * descriptor modules, or a check that a `chartDescriptor` element type survives the boundary. Both\n * are decisions rather than edits, so this says what is true instead of pretending it is handled.\n */\n\nexport interface ChartMarkProps {\n  /**\n   * The selection this mark filters by. Defaults to `ChartRoot`'s; `null` draws the full relation\n   * — the dimmed background layer of a crossfilter pair.\n   */\n  filterBy?: Selection | null;\n  /**\n   * A different relation for this mark alone. The root's `table` is the default, which is right\n   * until a plot needs two — a node-link view draws nodes from one relation and edges from\n   * another, and both still filter by the same selection.\n   */\n  table?: string;\n  /** Literal rows instead of the root's table. */\n  data?: readonly unknown[];\n  /** Positions a rule/tick without a table: `at={0}` is the zero line. */\n  at?: unknown;\n  /** Observable Plot's per-mark hover tooltip. */\n  tip?: boolean;\n  x?: unknown;\n  y?: unknown;\n  z?: unknown;\n  r?: unknown;\n  /** Facet the plot horizontally by this column — one panel per distinct value. */\n  fx?: unknown;\n  /** Facet the plot vertically by this column. */\n  fy?: unknown;\n  /** A column name, or a colour — `var(--chart-1)` / `--primary` tokens are resolved for Plot. */\n  fill?: unknown;\n  /** A column name, or a colour; tokens are resolved the same way. */\n  stroke?: unknown;\n  opacity?: unknown;\n  fillOpacity?: unknown;\n  strokeOpacity?: unknown;\n  strokeWidth?: unknown;\n  sort?: unknown;\n  reverse?: boolean;\n  limit?: number;\n  inset?: number;\n  /** Any other vgplot / Observable Plot mark option. */\n  [option: string]: unknown;\n}\n\n/** Only these two channels can hold a colour; everything else keeps its column name. */\nconst COLOR_CHANNELS = [\"fill\", \"stroke\"] as const;\n\n/**\n * Marks that stack, and therefore need a series key.\n *\n * In Observable Plot `z` defaults to `fill`, so a stacked bar coloured by a column just works.\n * Through Mosaic it does not: the fill arrives as `{ value, scale: \"color\" }`, `maybeZ` cannot\n * pull a series name out of that object, and `stackY` silently stacks every row on the previous\n * one — a chart that renders, looks plausible and is wrong, which is worse than one that throws.\n * So we restore Plot's own default: a column-valued `fill`/`stroke` becomes `z` unless the caller\n * set one. `z={null}` opts out (Plot's own way of saying \"do not group\").\n */\nconst STACKING_MARKS = new Set([\n  \"barY\", \"barX\", \"areaY\", \"areaX\", \"area\", \"rectY\", \"rectX\", \"rect\", \"waffleY\", \"waffleX\",\n]);\n\nfunction markSource(props: ChartMarkProps, ctx: ChartSpecContext, decorator: boolean): ChartMarkSource {\n  if (decorator) return null;\n  if (props.data !== undefined) return { kind: \"values\", values: props.data };\n  if (props.at !== undefined) return { kind: \"values\", values: Array.isArray(props.at) ? props.at : [props.at] };\n  const table = props.table ?? ctx.table;\n  if (table === undefined) return { kind: \"values\", values: [{}] };\n  return {\n    kind: \"table\",\n    table,\n    filterBy: props.filterBy === undefined ? ctx.filterBy : props.filterBy,\n  };\n}\n\nfunction markDirective(mark: string, props: ChartMarkProps, ctx: ChartSpecContext, decorator: boolean): ChartMarkDirective {\n  const channels: Record<string, unknown> = { ...props };\n  // `filterBy` / `data` / `at` are our sugar; they choose the source, they are never mark options.\n  delete channels.filterBy;\n  delete channels.data;\n  delete channels.at;\n  delete channels.table;\n  // Read the series key before the colour channels are resolved to `rgb(...)` strings.\n  if (STACKING_MARKS.has(mark) && !(\"z\" in channels)) {\n    const series = [channels.fill, channels.stroke].find(\n      (v) => typeof v === \"string\" && !isColorValue(v),\n    );\n    if (series !== undefined) channels.z = series;\n  }\n  for (const channel of COLOR_CHANNELS) {\n    const value = channels[channel];\n    // `fill=\"host\"` is the *column* host; only a token reference is a colour we must resolve.\n    if (typeof value === \"string\" && isColorToken(value)) channels[channel] = ctx.resolveColor(value);\n  }\n  return { kind: \"mark\", mark, source: markSource(props, ctx, decorator), options: channels };\n}\n\nfunction mark(displayName: string, type: string, decorator = false): ChartDescriptor<ChartMarkProps> {\n  return chartDescriptor<ChartMarkProps>(displayName, (props, ctx) => markDirective(type, props, ctx, decorator));\n}\n\nexport const ChartBarY = mark(\"ChartBarY\", \"barY\");\nexport const ChartBarX = mark(\"ChartBarX\", \"barX\");\nexport const ChartWaffleY = mark(\"ChartWaffleY\", \"waffleY\");\nexport const ChartWaffleX = mark(\"ChartWaffleX\", \"waffleX\");\n\nexport const ChartLine = mark(\"ChartLine\", \"line\");\nexport const ChartLineY = mark(\"ChartLineY\", \"lineY\");\nexport const ChartLineX = mark(\"ChartLineX\", \"lineX\");\nexport const ChartArea = mark(\"ChartArea\", \"area\");\nexport const ChartAreaY = mark(\"ChartAreaY\", \"areaY\");\nexport const ChartAreaX = mark(\"ChartAreaX\", \"areaX\");\n\nexport const ChartDot = mark(\"ChartDot\", \"dot\");\nexport const ChartDotX = mark(\"ChartDotX\", \"dotX\");\nexport const ChartDotY = mark(\"ChartDotY\", \"dotY\");\nexport const ChartCircle = mark(\"ChartCircle\", \"circle\");\nexport const ChartHexagon = mark(\"ChartHexagon\", \"hexagon\");\nexport const ChartImage = mark(\"ChartImage\", \"image\");\n\nexport const ChartRect = mark(\"ChartRect\", \"rect\");\nexport const ChartRectY = mark(\"ChartRectY\", \"rectY\");\nexport const ChartRectX = mark(\"ChartRectX\", \"rectX\");\nexport const ChartCell = mark(\"ChartCell\", \"cell\");\nexport const ChartCellX = mark(\"ChartCellX\", \"cellX\");\nexport const ChartCellY = mark(\"ChartCellY\", \"cellY\");\n\nexport const ChartRuleY = mark(\"ChartRuleY\", \"ruleY\");\nexport const ChartRuleX = mark(\"ChartRuleX\", \"ruleX\");\nexport const ChartTickX = mark(\"ChartTickX\", \"tickX\");\nexport const ChartTickY = mark(\"ChartTickY\", \"tickY\");\nexport const ChartText = mark(\"ChartText\", \"text\");\nexport const ChartTextX = mark(\"ChartTextX\", \"textX\");\nexport const ChartTextY = mark(\"ChartTextY\", \"textY\");\n\nexport const ChartVector = mark(\"ChartVector\", \"vector\");\n// vgplot 0.29.2 builds this one with the mark type `vectoX`, which Observable Plot has no\n// function for. Wrapped for symmetry; use `<ChartVector>` until upstream fixes the typo.\nexport const ChartVectorX = mark(\"ChartVectorX\", \"vectorX\");\nexport const ChartVectorY = mark(\"ChartVectorY\", \"vectorY\");\nexport const ChartSpike = mark(\"ChartSpike\", \"spike\");\nexport const ChartArrow = mark(\"ChartArrow\", \"arrow\");\nexport const ChartLink = mark(\"ChartLink\", \"link\");\n\nexport const ChartHeatmap = mark(\"ChartHeatmap\", \"heatmap\");\nexport const ChartRaster = mark(\"ChartRaster\", \"raster\");\nexport const ChartRasterTile = mark(\"ChartRasterTile\", \"rasterTile\");\nexport const ChartContour = mark(\"ChartContour\", \"contour\");\nexport const ChartDenseLine = mark(\"ChartDenseLine\", \"denseLine\");\nexport const ChartDensity = mark(\"ChartDensity\", \"density\");\nexport const ChartDensityY = mark(\"ChartDensityY\", \"densityY\");\nexport const ChartDensityX = mark(\"ChartDensityX\", \"densityX\");\nexport const ChartHexbin = mark(\"ChartHexbin\", \"hexbin\");\nexport const ChartRegressionY = mark(\"ChartRegressionY\", \"regressionY\");\nexport const ChartErrorbarY = mark(\"ChartErrorbarY\", \"errorbarY\");\nexport const ChartErrorbarX = mark(\"ChartErrorbarX\", \"errorbarX\");\n\nexport const ChartVoronoi = mark(\"ChartVoronoi\", \"voronoi\");\nexport const ChartVoronoiMesh = mark(\"ChartVoronoiMesh\", \"voronoiMesh\");\nexport const ChartDelaunayLink = mark(\"ChartDelaunayLink\", \"delaunayLink\");\nexport const ChartDelaunayMesh = mark(\"ChartDelaunayMesh\", \"delaunayMesh\");\nexport const ChartHull = mark(\"ChartHull\", \"hull\");\nexport const ChartGeo = mark(\"ChartGeo\", \"geo\");\n\n// Decorators: they draw the frame, not the data, so vgplot gives them options and no source.\nexport const ChartFrame = mark(\"ChartFrame\", \"frame\", true);\nexport const ChartGridX = mark(\"ChartGridX\", \"gridX\", true);\nexport const ChartGridY = mark(\"ChartGridY\", \"gridY\", true);\nexport const ChartHexgrid = mark(\"ChartHexgrid\", \"hexgrid\", true);\nexport const ChartSphere = mark(\"ChartSphere\", \"sphere\", true);\nexport const ChartGraticule = mark(\"ChartGraticule\", \"graticule\", true);\n\nexport interface ChartRawProps {\n  /** A `vg.*` directive, or several — `vg.axisFx({ anchor: \"top\" })`. */\n  spec: unknown;\n}\n\n/**\n * The escape hatch. The wrappers above cover vgplot's mark vocabulary, but not its ~250 attributes\n * nor the `axisX`/`axisFy` decorator marks the axis descriptors deliberately compile away from.\n * Anything unwrapped goes in here, in source order, with the same interactor-binding semantics as\n * a wrapped mark:\n *\n * ```tsx\n * <ChartRaw spec={vg.axisFy({ anchor: \"right\", tickRotate: 45 })} />\n * ```\n */\nexport const ChartRaw = chartDescriptor<ChartRawProps>(\"ChartRaw\", (props) =>\n  Array.isArray(props.spec)\n    ? props.spec.map((value: unknown) => ({ kind: \"raw\" as const, value }))\n    : { kind: \"raw\", value: props.spec },\n);\n"],"names":["COLOR_CHANNELS","STACKING_MARKS","markSource","props","ctx","decorator","table","markDirective","mark","channels","series","v","isColorValue","channel","value","isColorToken","displayName","type","chartDescriptor","ChartBarY","ChartBarX","ChartWaffleY","ChartWaffleX","ChartLine","ChartLineY","ChartLineX","ChartArea","ChartAreaY","ChartAreaX","ChartDot","ChartDotX","ChartDotY","ChartCircle","ChartHexagon","ChartImage","ChartRect","ChartRectY","ChartRectX","ChartCell","ChartCellX","ChartCellY","ChartRuleY","ChartRuleX","ChartTickX","ChartTickY","ChartText","ChartTextX","ChartTextY","ChartVector","ChartVectorX","ChartVectorY","ChartSpike","ChartArrow","ChartLink","ChartHeatmap","ChartRaster","ChartRasterTile","ChartContour","ChartDenseLine","ChartDensity","ChartDensityY","ChartDensityX","ChartHexbin","ChartRegressionY","ChartErrorbarY","ChartErrorbarX","ChartVoronoi","ChartVoronoiMesh","ChartDelaunayLink","ChartDelaunayMesh","ChartHull","ChartGeo","ChartFrame","ChartGridX","ChartGridY","ChartHexgrid","ChartSphere","ChartGraticule","ChartRaw"],"mappings":"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"}
+{"version":3,"file":"chart-marks.js","sources":["../../src/charts/chart-marks.tsx"],"sourcesContent":["import type { Selection } from \"@uwdata/mosaic-core\";\nimport type { TableExpr } from \"@kanzo-tech/mosaic\";\nimport { isColorToken, isColorValue } from \"./chart-config.js\";\nimport {\n  chartDescriptor,\n  type ChartDescriptor,\n  type ChartMarkDirective,\n  type ChartMarkSource,\n  type ChartSpecContext,\n} from \"./chart-spec.js\";\n\n/**\n * The mark vocabulary. Every component here renders `null` — `ChartRoot` reads the `__chart`\n * static off the element type and compiles it.\n *\n * This file carries no `\"use client\"`, and the docblock claimed the opposite for as long as it\n * existed: \"load-bearing even though nothing here uses a hook\". The rule the repo actually\n * enforces is in `client-boundary.test.ts` — a file declares the directive **iff it is itself\n * stateful** — and nothing here is, so the guard would reject it. The claim and the code were\n * never both true.\n *\n * What the claim got right is the mechanism, and it is worth keeping: a descriptor rendered on the\n * server DOES collapse to `null` before `ChartRoot` sees the element, because the `__chart` static\n * lives on the element *type* and a Server Component is invoked before serialisation. What it got\n * wrong is what prevents it. Not a directive here — the consumer. Every chart is written inside a\n * client component, necessarily: `MosaicProvider` is one, and there is no coordinator without it.\n * All 38 chart examples in `docs/examples` open with `\"use client\"`.\n *\n * So the trap is real and it belongs to a CONSUMER who writes a chart in a Server Component: the\n * marks vanish and the plot renders empty, with no error anywhere. Nothing catches that today —\n * `client-boundary.test.ts` matches shape and this file's shape is pure, and the docs RSC build only exercises the client path our own\n * examples take. Fixing it properly means either the directive plus an exception in that guard for\n * descriptor modules, or a check that a `chartDescriptor` element type survives the boundary. Both\n * are decisions rather than edits, so this says what is true instead of pretending it is handled.\n */\n\nexport interface ChartMarkProps {\n  /**\n   * The selection this mark filters by. Defaults to `ChartRoot`'s; `null` draws the full relation\n   * — the dimmed background layer of a crossfilter pair.\n   */\n  filterBy?: Selection | null;\n  /**\n   * A different relation for this mark alone. The root's `table` is the default, which is right\n   * until a plot needs two — a node-link view draws nodes from one relation and edges from\n   * another, and both still filter by the same selection.\n   */\n  table?: TableExpr;\n  /** Literal rows instead of the root's table. */\n  data?: readonly unknown[];\n  /** Positions a rule/tick without a table: `at={0}` is the zero line. */\n  at?: unknown;\n  /** Observable Plot's per-mark hover tooltip. */\n  tip?: boolean;\n  x?: unknown;\n  y?: unknown;\n  z?: unknown;\n  r?: unknown;\n  /** Facet the plot horizontally by this column — one panel per distinct value. */\n  fx?: unknown;\n  /** Facet the plot vertically by this column. */\n  fy?: unknown;\n  /** A column name, or a colour — `var(--chart-1)` / `--primary` tokens are resolved for Plot. */\n  fill?: unknown;\n  /** A column name, or a colour; tokens are resolved the same way. */\n  stroke?: unknown;\n  opacity?: unknown;\n  fillOpacity?: unknown;\n  strokeOpacity?: unknown;\n  strokeWidth?: unknown;\n  sort?: unknown;\n  reverse?: boolean;\n  limit?: number;\n  inset?: number;\n  /** Any other vgplot / Observable Plot mark option. */\n  [option: string]: unknown;\n}\n\n/** Only these two channels can hold a colour; everything else keeps its column name. */\nconst COLOR_CHANNELS = [\"fill\", \"stroke\"] as const;\n\n/**\n * Marks that stack, and therefore need a series key.\n *\n * In Observable Plot `z` defaults to `fill`, so a stacked bar coloured by a column just works.\n * Through Mosaic it does not: the fill arrives as `{ value, scale: \"color\" }`, `maybeZ` cannot\n * pull a series name out of that object, and `stackY` silently stacks every row on the previous\n * one — a chart that renders, looks plausible and is wrong, which is worse than one that throws.\n * So we restore Plot's own default: a column-valued `fill`/`stroke` becomes `z` unless the caller\n * set one. `z={null}` opts out (Plot's own way of saying \"do not group\").\n */\nconst STACKING_MARKS = new Set([\n  \"barY\", \"barX\", \"areaY\", \"areaX\", \"area\", \"rectY\", \"rectX\", \"rect\", \"waffleY\", \"waffleX\",\n]);\n\nfunction markSource(props: ChartMarkProps, ctx: ChartSpecContext, decorator: boolean): ChartMarkSource {\n  if (decorator) return null;\n  if (props.data !== undefined) return { kind: \"values\", values: props.data };\n  if (props.at !== undefined) return { kind: \"values\", values: Array.isArray(props.at) ? props.at : [props.at] };\n  const table = props.table ?? ctx.table;\n  if (table === undefined) return { kind: \"values\", values: [{}] };\n  return {\n    kind: \"table\",\n    table,\n    filterBy: props.filterBy === undefined ? ctx.filterBy : props.filterBy,\n  };\n}\n\nfunction markDirective(mark: string, props: ChartMarkProps, ctx: ChartSpecContext, decorator: boolean): ChartMarkDirective {\n  const channels: Record<string, unknown> = { ...props };\n  // `filterBy` / `data` / `at` are our sugar; they choose the source, they are never mark options.\n  delete channels.filterBy;\n  delete channels.data;\n  delete channels.at;\n  delete channels.table;\n  // Read the series key before the colour channels are resolved to `rgb(...)` strings.\n  if (STACKING_MARKS.has(mark) && !(\"z\" in channels)) {\n    const series = [channels.fill, channels.stroke].find(\n      (v) => typeof v === \"string\" && !isColorValue(v),\n    );\n    if (series !== undefined) channels.z = series;\n  }\n  for (const channel of COLOR_CHANNELS) {\n    const value = channels[channel];\n    // `fill=\"host\"` is the *column* host; only a token reference is a colour we must resolve.\n    if (typeof value === \"string\" && isColorToken(value)) channels[channel] = ctx.resolveColor(value);\n  }\n  return { kind: \"mark\", mark, source: markSource(props, ctx, decorator), options: channels };\n}\n\nfunction mark(displayName: string, type: string, decorator = false): ChartDescriptor<ChartMarkProps> {\n  return chartDescriptor<ChartMarkProps>(displayName, (props, ctx) => markDirective(type, props, ctx, decorator));\n}\n\nexport const ChartBarY = mark(\"ChartBarY\", \"barY\");\nexport const ChartBarX = mark(\"ChartBarX\", \"barX\");\nexport const ChartWaffleY = mark(\"ChartWaffleY\", \"waffleY\");\nexport const ChartWaffleX = mark(\"ChartWaffleX\", \"waffleX\");\n\nexport const ChartLine = mark(\"ChartLine\", \"line\");\nexport const ChartLineY = mark(\"ChartLineY\", \"lineY\");\nexport const ChartLineX = mark(\"ChartLineX\", \"lineX\");\nexport const ChartArea = mark(\"ChartArea\", \"area\");\nexport const ChartAreaY = mark(\"ChartAreaY\", \"areaY\");\nexport const ChartAreaX = mark(\"ChartAreaX\", \"areaX\");\n\nexport const ChartDot = mark(\"ChartDot\", \"dot\");\nexport const ChartDotX = mark(\"ChartDotX\", \"dotX\");\nexport const ChartDotY = mark(\"ChartDotY\", \"dotY\");\nexport const ChartCircle = mark(\"ChartCircle\", \"circle\");\nexport const ChartHexagon = mark(\"ChartHexagon\", \"hexagon\");\nexport const ChartImage = mark(\"ChartImage\", \"image\");\n\nexport const ChartRect = mark(\"ChartRect\", \"rect\");\nexport const ChartRectY = mark(\"ChartRectY\", \"rectY\");\nexport const ChartRectX = mark(\"ChartRectX\", \"rectX\");\nexport const ChartCell = mark(\"ChartCell\", \"cell\");\nexport const ChartCellX = mark(\"ChartCellX\", \"cellX\");\nexport const ChartCellY = mark(\"ChartCellY\", \"cellY\");\n\nexport const ChartRuleY = mark(\"ChartRuleY\", \"ruleY\");\nexport const ChartRuleX = mark(\"ChartRuleX\", \"ruleX\");\nexport const ChartTickX = mark(\"ChartTickX\", \"tickX\");\nexport const ChartTickY = mark(\"ChartTickY\", \"tickY\");\nexport const ChartText = mark(\"ChartText\", \"text\");\nexport const ChartTextX = mark(\"ChartTextX\", \"textX\");\nexport const ChartTextY = mark(\"ChartTextY\", \"textY\");\n\nexport const ChartVector = mark(\"ChartVector\", \"vector\");\n// vgplot 0.29.2 builds this one with the mark type `vectoX`, which Observable Plot has no\n// function for. Wrapped for symmetry; use `<ChartVector>` until upstream fixes the typo.\nexport const ChartVectorX = mark(\"ChartVectorX\", \"vectorX\");\nexport const ChartVectorY = mark(\"ChartVectorY\", \"vectorY\");\nexport const ChartSpike = mark(\"ChartSpike\", \"spike\");\nexport const ChartArrow = mark(\"ChartArrow\", \"arrow\");\nexport const ChartLink = mark(\"ChartLink\", \"link\");\n\nexport const ChartHeatmap = mark(\"ChartHeatmap\", \"heatmap\");\nexport const ChartRaster = mark(\"ChartRaster\", \"raster\");\nexport const ChartRasterTile = mark(\"ChartRasterTile\", \"rasterTile\");\nexport const ChartContour = mark(\"ChartContour\", \"contour\");\nexport const ChartDenseLine = mark(\"ChartDenseLine\", \"denseLine\");\nexport const ChartDensity = mark(\"ChartDensity\", \"density\");\nexport const ChartDensityY = mark(\"ChartDensityY\", \"densityY\");\nexport const ChartDensityX = mark(\"ChartDensityX\", \"densityX\");\nexport const ChartHexbin = mark(\"ChartHexbin\", \"hexbin\");\nexport const ChartRegressionY = mark(\"ChartRegressionY\", \"regressionY\");\nexport const ChartErrorbarY = mark(\"ChartErrorbarY\", \"errorbarY\");\nexport const ChartErrorbarX = mark(\"ChartErrorbarX\", \"errorbarX\");\n\nexport const ChartVoronoi = mark(\"ChartVoronoi\", \"voronoi\");\nexport const ChartVoronoiMesh = mark(\"ChartVoronoiMesh\", \"voronoiMesh\");\nexport const ChartDelaunayLink = mark(\"ChartDelaunayLink\", \"delaunayLink\");\nexport const ChartDelaunayMesh = mark(\"ChartDelaunayMesh\", \"delaunayMesh\");\nexport const ChartHull = mark(\"ChartHull\", \"hull\");\nexport const ChartGeo = mark(\"ChartGeo\", \"geo\");\n\n// Decorators: they draw the frame, not the data, so vgplot gives them options and no source.\nexport const ChartFrame = mark(\"ChartFrame\", \"frame\", true);\nexport const ChartGridX = mark(\"ChartGridX\", \"gridX\", true);\nexport const ChartGridY = mark(\"ChartGridY\", \"gridY\", true);\nexport const ChartHexgrid = mark(\"ChartHexgrid\", \"hexgrid\", true);\nexport const ChartSphere = mark(\"ChartSphere\", \"sphere\", true);\nexport const ChartGraticule = mark(\"ChartGraticule\", \"graticule\", true);\n\nexport interface ChartRawProps {\n  /** A `vg.*` directive, or several — `vg.axisFx({ anchor: \"top\" })`. */\n  spec: unknown;\n}\n\n/**\n * The escape hatch. The wrappers above cover vgplot's mark vocabulary, but not its ~250 attributes\n * nor the `axisX`/`axisFy` decorator marks the axis descriptors deliberately compile away from.\n * Anything unwrapped goes in here, in source order, with the same interactor-binding semantics as\n * a wrapped mark:\n *\n * ```tsx\n * <ChartRaw spec={vg.axisFy({ anchor: \"right\", tickRotate: 45 })} />\n * ```\n */\nexport const ChartRaw = chartDescriptor<ChartRawProps>(\"ChartRaw\", (props) =>\n  Array.isArray(props.spec)\n    ? props.spec.map((value: unknown) => ({ kind: \"raw\" as const, value }))\n    : { kind: \"raw\", value: props.spec },\n);\n"],"names":["COLOR_CHANNELS","STACKING_MARKS","markSource","props","ctx","decorator","table","markDirective","mark","channels","series","v","isColorValue","channel","value","isColorToken","displayName","type","chartDescriptor","ChartBarY","ChartBarX","ChartWaffleY","ChartWaffleX","ChartLine","ChartLineY","ChartLineX","ChartArea","ChartAreaY","ChartAreaX","ChartDot","ChartDotX","ChartDotY","ChartCircle","ChartHexagon","ChartImage","ChartRect","ChartRectY","ChartRectX","ChartCell","ChartCellX","ChartCellY","ChartRuleY","ChartRuleX","ChartTickX","ChartTickY","ChartText","ChartTextX","ChartTextY","ChartVector","ChartVectorX","ChartVectorY","ChartSpike","ChartArrow","ChartLink","ChartHeatmap","ChartRaster","ChartRasterTile","ChartContour","ChartDenseLine","ChartDensity","ChartDensityY","ChartDensityX","ChartHexbin","ChartRegressionY","ChartErrorbarY","ChartErrorbarX","ChartVoronoi","ChartVoronoiMesh","ChartDelaunayLink","ChartDelaunayMesh","ChartHull","ChartGeo","ChartFrame","ChartGridX","ChartGridY","ChartHexgrid","ChartSphere","ChartGraticule","ChartRaw"],"mappings":"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"}

package/dist/charts/chart-root.d.ts

@@ -1,3 +1,4 @@
+import { TableExpr } from '@kanzo-tech/mosaic';
 import { ReactNode, default as React } from 'react';
 import { ark } from '@ark-ui/react/factory';
 import { Selection, Coordinator } from '@uwdata/mosaic-core';
@@ -7,7 +8,7 @@ export interface ChartContextValue {
     /** The active Mosaic coordinator, for a consumer that queries alongside the plot. */
     coordinator: Coordinator;
     config: ChartConfig;
-    table?: string;
+    table?: TableExpr;
     /** What the marks filter by; `null` = the full relation. */
     filterBy: Selection | null;
     /** Where the interactors publish. */
@@ -39,8 +40,12 @@ export declare function useChartContext(): ChartContextValue;
 /** The chart context, or `null` — for parts that also work standalone, like `ChartLegend`. */
 export declare function useChartContextOptional(): ChartContextValue | null;
 export interface ChartRootProps extends Omit<React.ComponentProps<typeof ark.div>, "children">, ChartFacetOptions {
-    /** The relation registered in the coordinator. Omit it when every mark carries its own `data`. */
-    table?: string;
+    /**
+     * The relation the marks read. A string is one identifier in the default catalog; a relation in
+     * another catalog is a mosaic-sql node — `verbatim(relation.sql)`, `asTableRef([catalog, name])`.
+     * Omit it when every mark carries its own `data`.
+     */
+    table?: TableExpr;
     /** What the marks filter by. Defaults to the `<MosaicProvider>` crossfilter; `null` = unfiltered. */
     filterBy?: Selection | null;
     /**

package/dist/charts/chart-root.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chart-root.d.ts","sourceRoot":"","sources":["../../src/charts/chart-root.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAmE,KAAK,SAAS,EAAY,MAAM,OAAO,CAAC;AAClH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGlE,OAAO,EAAmE,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACtH,OAAO,EAML,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAEjB,MAAM,iBAAiB,CAAC;AA+BzB,MAAM,WAAW,iBAAiB;IAChC,qFAAqF;IACrF,WAAW,EAAE,WAAW,CAAC;IACzB,MAAM,EAAE,WAAW,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,QAAQ,EAAE,SAAS,GAAG,IAAI,CAAC;IAC3B,qCAAqC;IACrC,EAAE,EAAE,SAAS,CAAC;IACd;;;;;;;;;;OAUG;IACH,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAC3C,yFAAyF;IACzF,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,mBAAmB,KAAK,MAAM,CAAC;CAC7E;AAID;;;;;;;GAOG;AACH,wBAAgB,eAAe,IAAI,iBAAiB,CAInD;AAED,8FAA8F;AAC9F,wBAAgB,uBAAuB,IAAI,iBAAiB,GAAG,IAAI,CAElE;AAED,MAAM,WAAW,cACf,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,GAAG,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC,EAC5D,iBAAiB;IACnB,kGAAkG;IAClG,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qGAAqG;IACrG,QAAQ,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAC5B;;;;OAIG;IACH,EAAE,CAAC,EAAE,SAAS,CAAC;IACf,8FAA8F;IAC9F,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,UAAU,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAChC,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uFAAuF;IACvF,YAAY,CAAC,EAAE,IAAI,CAAC,mBAAmB,CAAC;IACxC,wFAAwF;IACxF,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,uDAAuD;IACvD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAID;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,qBAkI9C"}
+{"version":3,"file":"chart-root.d.ts","sourceRoot":"","sources":["../../src/charts/chart-root.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAmE,KAAK,SAAS,EAAY,MAAM,OAAO,CAAC;AAClH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGlE,OAAO,EAAmE,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACtH,OAAO,EAOL,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAEjB,MAAM,iBAAiB,CAAC;AA+BzB,MAAM,WAAW,iBAAiB;IAChC,qFAAqF;IACrF,WAAW,EAAE,WAAW,CAAC;IACzB,MAAM,EAAE,WAAW,CAAC;IACpB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,4DAA4D;IAC5D,QAAQ,EAAE,SAAS,GAAG,IAAI,CAAC;IAC3B,qCAAqC;IACrC,EAAE,EAAE,SAAS,CAAC;IACd;;;;;;;;;;OAUG;IACH,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAC3C,yFAAyF;IACzF,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,mBAAmB,KAAK,MAAM,CAAC;CAC7E;AAID;;;;;;;GAOG;AACH,wBAAgB,eAAe,IAAI,iBAAiB,CAInD;AAED,8FAA8F;AAC9F,wBAAgB,uBAAuB,IAAI,iBAAiB,GAAG,IAAI,CAElE;AAED,MAAM,WAAW,cACf,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,GAAG,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC,EAC5D,iBAAiB;IACnB;;;;OAIG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,qGAAqG;IACrG,QAAQ,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAC5B;;;;OAIG;IACH,EAAE,CAAC,EAAE,SAAS,CAAC;IACf,8FAA8F;IAC9F,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,UAAU,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAChC,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uFAAuF;IACvF,YAAY,CAAC,EAAE,IAAI,CAAC,mBAAmB,CAAC;IACxC,wFAAwF;IACxF,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,uDAAuD;IACvD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAID;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,qBAmI9C"}

package/dist/charts/chart-root.js

@@ -1,17 +1,17 @@
 "use client";
-import { jsx as v, jsxs as Q } from "react/jsx-runtime";
-import { useState as U, useRef as D, useEffect as X, useMemo as Z, useContext as K, createContext as tt } from "react";
-import { ark as ot } from "@ark-ui/react/factory";
-import { Selection as rt } from "@uwdata/mosaic-core";
+import { jsx as v, jsxs as U } from "react/jsx-runtime";
+import { useState as X, useRef as D, useEffect as Z, useMemo as tt, useContext as V, createContext as ot } from "react";
+import { ark as rt } from "@ark-ui/react/factory";
+import { Selection as nt } from "@uwdata/mosaic-core";
 import * as C from "@uwdata/vgplot";
-import { cn as nt } from "../lib/cn.js";
-import { chartSeriesColor as et, isColorToken as st, colorTokenName as G, chartColorScale as at } from "./chart-config.js";
-import { compileChartSpec as ct, chartSpecSignature as lt, chartSpecWarnings as ut, buildChartSpec as it } from "./chart-spec.js";
-import { useMosaic as ft } from "./mosaic-provider.js";
+import { cn as et } from "../lib/cn.js";
+import { chartSeriesColor as st, isColorToken as at, colorTokenName as G, chartColorScale as ct } from "./chart-config.js";
+import { chartTableKey as lt, compileChartSpec as ut, chartSpecSignature as it, chartSpecWarnings as ft, buildChartSpec as mt } from "./chart-spec.js";
+import { useMosaic as pt } from "./mosaic-provider.js";
 import { resolveTokenColor as I } from "../lib/token-color.js";
-import { TokenizedPlot as mt } from "./tokenized-plot.js";
+import { TokenizedPlot as ht } from "./tokenized-plot.js";
 const a = C;
-function pt(t) {
+function Ct(t) {
   var o, c;
   switch (t.kind) {
     case "mark": {
@@ -29,45 +29,45 @@ function pt(t) {
       return t.value;
   }
 }
-const g = tt(null);
-function Rt() {
-  const t = K(g);
+const g = ot(null);
+function Mt() {
+  const t = V(g);
   if (!t) throw new Error("useChartContext must be used within a <ChartRoot>.");
   return t;
 }
-function Mt() {
-  return K(g);
+function Jt() {
+  return V(g);
 }
-const ht = {};
-function Tt(t) {
+const gt = {};
+function Kt(t) {
   const {
     table: o,
     filterBy: c,
     as: l,
-    config: e = ht,
+    config: e = gt,
     height: y = 200,
     margin: x,
     aspectRatio: N,
     facetMargin: S,
-    facetGrid: d,
-    facetLabel: w,
-    attributes: b,
+    facetGrid: b,
+    facetLabel: d,
+    attributes: w,
     locale: k,
     numberFormat: B,
     children: i,
-    className: V,
-    plotClassName: _,
-    ref: z,
-    slot: L,
-    ...W
-  } = t, { coordinator: O, crossfilter: E, selected: Y, registerSelection: R } = ft(), [f] = U(() => rt.union()), s = l ?? f, u = c === void 0 ? E : c, M = D(null);
-  X(
+    className: _,
+    plotClassName: z,
+    ref: L,
+    slot: W,
+    ...Y
+  } = t, { coordinator: O, crossfilter: E, selected: $, registerSelection: R } = pt(), [f] = X(() => nt.union()), s = l ?? f, u = c === void 0 ? E : c, T = D(null);
+  Z(
     // Only the selection this root minted is relayed: a caller-supplied `as` was wired by the
     // caller (`include`, or another root), and relaying it again would double every clause.
     () => R(s, { relay: s === f }),
     [R, s, f]
   );
-  const $ = JSON.stringify(B ?? null), q = Z(
+  const q = JSON.stringify(B ?? null), M = lt(o), A = tt(
     () => ({
       coordinator: O,
       config: e,
@@ -75,57 +75,57 @@ function Tt(t) {
       filterBy: u,
       as: s,
       color: (r) => {
-        const n = et(e, r);
-        return n === void 0 || !st(n) || typeof document > "u" ? n : I(M.current ?? document.documentElement, G(n));
+        const n = st(e, r);
+        return n === void 0 || !at(n) || typeof document > "u" ? n : I(T.current ?? document.documentElement, G(n));
       },
       formatNumber: (r, n) => new Intl.NumberFormat(k, n ?? B).format(r)
     }),
-    // `numberKey` stands in for the options object's identity; `numberFormat` itself is read fresh.
+    // `numberKey` and `tableKey` stand in for their objects' identities; both are read fresh.
     // eslint-disable-next-line react-hooks/exhaustive-deps
-    [O, e, o, u, s, k, $]
-  ), T = ct(i, {
+    [O, e, M, u, s, k, q]
+  ), J = ut(i, {
     table: o,
     filterBy: u,
     as: s,
     config: e,
-    resolveColor: Ct
-  }), m = lt(T), A = JSON.stringify(at(e)), J = D(null);
-  if (process.env.NODE_ENV !== "production" && J.current !== m) {
-    J.current = m;
-    const r = { shared: [E, Y] };
-    for (const n of ut(T, r)) console.warn(`[ChartRoot] ${n}`);
+    resolveColor: yt
+  }), m = it(J), H = JSON.stringify(ct(e)), K = D(null);
+  if (process.env.NODE_ENV !== "production" && K.current !== m) {
+    K.current = m;
+    const r = { shared: [E, $] };
+    for (const n of ft(J, r)) console.warn(`[ChartRoot] ${n}`);
   }
-  return /* @__PURE__ */ v(g.Provider, { value: q, children: /* @__PURE__ */ Q(
-    ot.div,
+  return /* @__PURE__ */ v(g.Provider, { value: A, children: /* @__PURE__ */ U(
+    rt.div,
     {
-      className: nt("flex w-full flex-col gap-2", V),
+      className: et("flex w-full flex-col gap-2", _),
       ref: (r) => {
-        M.current = r, gt(z, r);
+        T.current = r, xt(L, r);
       },
-      ...W,
-      "data-slot": L ?? "chart-root",
+      ...Y,
+      "data-slot": W ?? "chart-root",
       children: [
         /* @__PURE__ */ v(
-          mt,
+          ht,
           {
-            className: _,
+            className: z,
             deps: [
               m,
-              A,
-              o,
+              H,
+              M,
               u,
               s,
               y,
               N,
               JSON.stringify(x ?? null),
               JSON.stringify(S ?? null),
+              b,
               d,
-              w,
-              b
+              w
             ],
             render: (r, n) => {
-              const F = /* @__PURE__ */ new Map(), H = it(
-                { children: i, width: r, height: y, margin: x, aspectRatio: N, facetMargin: S, facetGrid: d, facetLabel: w, attributes: b },
+              const F = /* @__PURE__ */ new Map(), Q = mt(
+                { children: i, width: r, height: y, margin: x, aspectRatio: N, facetMargin: S, facetGrid: b, facetLabel: d, attributes: w },
                 {
                   table: o,
                   filterBy: u,
@@ -139,7 +139,7 @@ function Tt(t) {
                   }
                 }
               );
-              return C.plot(...H.map(pt).filter((p) => p !== null));
+              return C.plot(...Q.map(Ct).filter((p) => p !== null));
             }
           }
         ),
@@ -148,15 +148,15 @@ function Tt(t) {
     }
   ) });
 }
-function Ct(t) {
+function yt(t) {
   return t;
 }
-function gt(t, o) {
+function xt(t, o) {
   typeof t == "function" ? t(o) : t && (t.current = o);
 }
 export {
-  Tt as ChartRoot,
-  Rt as useChartContext,
-  Mt as useChartContextOptional
+  Kt as ChartRoot,
+  Mt as useChartContext,
+  Jt as useChartContextOptional
 };
 //# sourceMappingURL=chart-root.js.map

package/dist/charts/chart-root.js.map

@@ -1 +1 @@
-{"version":3,"file":"chart-root.js","sources":["../../src/charts/chart-root.tsx"],"sourcesContent":["\"use client\";\n\nimport { createContext, useContext, useEffect, useMemo, useRef, useState, type ReactNode, type Ref } from \"react\";\nimport type React from \"react\";\nimport { ark } from \"@ark-ui/react/factory\";\nimport { Selection, type Coordinator } from \"@uwdata/mosaic-core\";\nimport * as vg from \"@uwdata/vgplot\";\nimport { cn } from \"../lib/cn.js\";\nimport { chartColorScale, chartSeriesColor, colorTokenName, isColorToken, type ChartConfig } from \"./chart-config.js\";\nimport {\n  buildChartSpec,\n  chartSpecSignature,\n  chartSpecWarnings,\n  compileChartSpec,\n  type ChartDirective,\n  type ChartFacetOptions,\n  type ChartMargin,\n  type ChartSpecContext,\n} from \"./chart-spec.js\";\nimport { useMosaic } from \"./mosaic-provider.js\";\nimport { resolveTokenColor } from \"../lib/token-color.js\";\nimport { TokenizedPlot } from \"./tokenized-plot.js\";\n\n/** vgplot ships `any` for every directive; this is the one place we pin a shape to it. */\ntype VgDirective = (plot: unknown) => void;\nconst directives = vg as unknown as Record<string, ((...args: unknown[]) => VgDirective) | undefined>;\n\nfunction toVgDirective(directive: ChartDirective): VgDirective | null {\n  switch (directive.kind) {\n    case \"mark\": {\n      const fn = directives[directive.mark];\n      if (!fn) return null;\n      // A decorator takes options only; everything else takes (data, options).\n      if (directive.source === null) return fn(directive.options);\n      const data =\n        directive.source.kind === \"values\"\n          ? [...directive.source.values]\n          : vg.from(directive.source.table, directive.source.filterBy ? { filterBy: directive.source.filterBy } : undefined);\n      return fn(data, directive.options);\n    }\n    case \"interactor\":\n      return directives[directive.interactor]?.(directive.options) ?? null;\n    case \"attribute\":\n      return directives[directive.name]?.(directive.value) ?? null;\n    case \"raw\":\n      return directive.value as VgDirective;\n  }\n}\n\nexport interface ChartContextValue {\n  /** The active Mosaic coordinator, for a consumer that queries alongside the plot. */\n  coordinator: Coordinator;\n  config: ChartConfig;\n  table?: string;\n  /** What the marks filter by; `null` = the full relation. */\n  filterBy: Selection | null;\n  /** Where the interactors publish. */\n  as: Selection;\n  /**\n   * The series colour, normalised to `rgb(...)` so it is safe for both CSS and Plot. `undefined`\n   * for a key the config does not name.\n   *\n   * Normalising is what makes it dual-purpose and is also what makes it a **snapshot**: the answer\n   * is read off the DOM when you call it, and nothing re-calls it when the theme or the scheme\n   * changes. `ChartLegend` deliberately does not use this — its only sink is a `style`, so it\n   * passes `var(--chart-N)` through and lets the browser follow the theme for free. Take the same\n   * route for anything that only ends up in CSS; pair this with `useThemeTick` when you need the\n   * literal, which is to say when you are handing it to Plot.\n   */\n  color: (key: string) => string | undefined;\n  /** The chart's locale number formatter — one vocabulary for axes, legend and tooltip. */\n  formatNumber: (value: number, options?: Intl.NumberFormatOptions) => string;\n}\n\nconst ChartContext = createContext<ChartContextValue | null>(null);\n\n/**\n * The chart context — config, selections, coordinator, and the `color` / `formatNumber` helpers\n * that keep a series' identity in one place. Throws outside a `<ChartRoot>`.\n *\n * Available to DOM parts (`ChartLegend`, a custom tooltip, a readout). **Not** to descriptors:\n * `ChartRoot` reads their props off the element before React renders them, so a mark cannot pull\n * anything out of context — pass the value down from the component that owns the `<ChartRoot>`.\n */\nexport function useChartContext(): ChartContextValue {\n  const ctx = useContext(ChartContext);\n  if (!ctx) throw new Error(\"useChartContext must be used within a <ChartRoot>.\");\n  return ctx;\n}\n\n/** The chart context, or `null` — for parts that also work standalone, like `ChartLegend`. */\nexport function useChartContextOptional(): ChartContextValue | null {\n  return useContext(ChartContext);\n}\n\nexport interface ChartRootProps\n  extends Omit<React.ComponentProps<typeof ark.div>, \"children\">,\n    ChartFacetOptions {\n  /** The relation registered in the coordinator. Omit it when every mark carries its own `data`. */\n  table?: string;\n  /** What the marks filter by. Defaults to the `<MosaicProvider>` crossfilter; `null` = unfiltered. */\n  filterBy?: Selection | null;\n  /**\n   * Where the child interactors publish, and what `ChartHighlight` reads back. Defaults to a\n   * selection this root owns, relayed into the provider — see the note on `ChartRoot`. Pass one and\n   * you own its wiring: nothing is relayed for you, though the provider's `reset()` still clears it.\n   */\n  as?: Selection;\n  /** Series key → `{ label, color, icon }`. A non-empty config pins the plot's colour scale. */\n  config?: ChartConfig;\n  /** Plot height in px; the width is measured from the container. Default 200. */\n  height?: number;\n  margin?: number | ChartMargin;\n  aspectRatio?: number;\n  /**\n   * Raw `vg.*` directives for anything the layer does not wrap. Applied last, so they win.\n   * Keep the array referentially stable — a new array rebuilds the plot.\n   */\n  attributes?: readonly unknown[];\n  /** BCP-47 tag for `formatNumber`. Defaults to the runtime locale. */\n  locale?: string;\n  /** Default options for `formatNumber` — the chart's number vocabulary in one place. */\n  numberFormat?: Intl.NumberFormatOptions;\n  /** Descriptors (marks, interactors, axes) plus real DOM parts such as `ChartLegend`. */\n  children?: ReactNode;\n  /** Class for the plot host itself, inside the root. */\n  plotClassName?: string;\n}\n\nconst EMPTY_CONFIG: ChartConfig = {};\n\n/**\n * Why every chart owns a selection instead of sharing the page's.\n *\n * `ChartHighlight` does not filter — it asks the mark's **own** query which rows are selected, by\n * appending the predicate as an extra output column: `q._groupby.length ? q.select({__: pred})`.\n * On an aggregating mark that query has a `GROUP BY`, so a predicate naming a column this plot does\n * not group by is `Binder Error: column \"provider\" must appear in the GROUP BY clause`. The query\n * dies, vgplot swallows it, and **the plot keeps its previous render** — no error, no empty state,\n * nothing but a console line. It costs hours to find, because the symptom looks like a broken\n * crossfilter three components away.\n *\n * A page-wide publish target guarantees that failure the moment a second chart filters by a second\n * column. So each root publishes into a union of its own: those clauses, by construction, name only\n * columns this plot's own interactors could produce — which are the columns its marks group by. The\n * clauses are relayed on into the provider (`selected` → `crossfilter`) with `source` and `clients`\n * intact, so every other chart filters exactly as before and this one still does not filter itself.\n */\nexport function ChartRoot(props: ChartRootProps) {\n  const {\n    table,\n    filterBy,\n    as,\n    config = EMPTY_CONFIG,\n    height = 200,\n    margin,\n    aspectRatio,\n    facetMargin,\n    facetGrid,\n    facetLabel,\n    attributes,\n    locale,\n    numberFormat,\n    children,\n    className,\n    plotClassName,\n    ref,\n    slot,\n    ...rest\n  } = props;\n  const { coordinator, crossfilter, selected, registerSelection } = useMosaic();\n  // A plain union, so it hides nothing from its own publisher — a crossfilter would, and\n  // `ChartHighlight` would read an empty predicate and dim nothing.\n  const [own] = useState(() => Selection.union());\n  const target = as ?? own;\n  const source = filterBy === undefined ? crossfilter : filterBy;\n  const host = useRef<HTMLDivElement | null>(null);\n\n  useEffect(\n    // Only the selection this root minted is relayed: a caller-supplied `as` was wired by the\n    // caller (`include`, or another root), and relaying it again would double every clause.\n    () => registerSelection(target, { relay: target === own }),\n    [registerSelection, target, own],\n  );\n\n  const numberKey = JSON.stringify(numberFormat ?? null);\n  const context = useMemo<ChartContextValue>(\n    () => ({\n      coordinator,\n      config,\n      table,\n      filterBy: source,\n      as: target,\n      color: (key) => {\n        const value = chartSeriesColor(config, key);\n        if (value === undefined || !isColorToken(value) || typeof document === \"undefined\") return value;\n        // Resolve against the element the chart lives in, so a scoped theme override wins.\n        return resolveTokenColor(host.current ?? document.documentElement, colorTokenName(value));\n      },\n      formatNumber: (value, options) =>\n        new Intl.NumberFormat(locale, options ?? numberFormat).format(value),\n    }),\n    // `numberKey` stands in for the options object's identity; `numberFormat` itself is read fresh.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [coordinator, config, table, source, target, locale, numberKey],\n  );\n\n  // Compiled twice on purpose: once here with an identity colour resolver, purely to fingerprint\n  // the grammar for `deps`, and once inside the render below against the live DOM. The pure pass\n  // is what keeps a re-render from re-running every query.\n  const pure = compileChartSpec(children, {\n    table, filterBy: source, as: target, config, resolveColor: identity,\n  });\n  const signature = chartSpecSignature(pure);\n  const colorKey = JSON.stringify(chartColorScale(config));\n\n  // Keyed by signature so an unchanged chart warns once, not on every render.\n  const warned = useRef<string | null>(null);\n  if (process.env.NODE_ENV !== \"production\" && warned.current !== signature) {\n    warned.current = signature;\n    const context = { shared: [crossfilter, selected] };\n    for (const warning of chartSpecWarnings(pure, context)) console.warn(`[ChartRoot] ${warning}`);\n  }\n\n  return (\n    <ChartContext.Provider value={context}>\n      <ark.div\n        className={cn(\"flex w-full flex-col gap-2\", className)}\n        ref={(node: HTMLDivElement | null) => {\n          host.current = node;\n          assignRef(ref, node);\n        }}\n        {...rest}\n        data-slot={slot ?? \"chart-root\"}\n      >\n        <TokenizedPlot\n          className={plotClassName}\n          deps={[\n            signature,\n            colorKey,\n            table,\n            source,\n            target,\n            height,\n            aspectRatio,\n            JSON.stringify(margin ?? null),\n            JSON.stringify(facetMargin ?? null),\n            facetGrid,\n            facetLabel,\n            attributes,\n          ]}\n          render={(width, plotHost) => {\n            const cache = new Map<string, string>();\n            const ctx: ChartSpecContext = {\n              table,\n              filterBy: source,\n              as: target,\n              config,\n              resolveColor: (token) => {\n                const name = colorTokenName(token);\n                const hit = cache.get(name);\n                if (hit !== undefined) return hit;\n                const resolved = resolveTokenColor(plotHost, name);\n                cache.set(name, resolved);\n                return resolved;\n              },\n            };\n            const spec = buildChartSpec(\n              { children, width, height, margin, aspectRatio, facetMargin, facetGrid, facetLabel, attributes },\n              ctx,\n            );\n            return vg.plot(...spec.map(toVgDirective).filter((d): d is VgDirective => d !== null));\n          }}\n        />\n        {children}\n      </ark.div>\n    </ChartContext.Provider>\n  );\n}\n\nfunction identity(token: string): string {\n  return token;\n}\n\n/** The root keeps its own handle on the host (for token resolution) without stealing the caller's. */\nfunction assignRef(ref: Ref<HTMLDivElement> | undefined, node: HTMLDivElement | null): void {\n  if (typeof ref === \"function\") ref(node);\n  else if (ref) ref.current = node;\n}\n"],"names":[],"mappings":";;;;;;;;;;;;AAyBA;AAEA;;AACE;AAAkB;AAEd;AACA;AAEA;AACA;AAIA;AAAiC;AACnC;AAEE;AAAgE;AAEhE;AAAwD;AAExD;AAAiB;AAEvB;AA2BA;AAUO;AACL;AACA;AACA;AACF;AAGO;AACL;AACF;AAoCA;AAmBO;AACL;AAAM;AACJ;AACA;AACA;AACS;AACA;AACT;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACG;AAUL;AAAA;AAAA;AAAA;AAG2D;AAC1B;AAGjC;AACgB;AACP;AACL;AACA;AACA;AACU;AACN;AAEF;AACA;AAEwF;AAC1F;AAEqE;AAAA;AAAA;AAAA;AAIT;AAMxB;AACtC;AAAiB;AAAY;AAAQ;AAAsB;AAO7D;AACE;AACA;AACA;AAA6F;AAG/F;AAEI;AAAK;AAAJ;AACsD;AAEnD;AACmB;AACrB;AACI;AACe;AAEnB;AAAA;AAAC;AAAA;AACY;AACL;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AAC6B;AACK;AAClC;AACA;AACA;AAAA;AAGA;AAea;AACyE;AAfxD;AAC5B;AACU;AACN;AACJ;AAEE;AAEA;AACA;AACA;AACO;AACT;AAAA;AAMF;AAAqF;AACvF;AAAA;AAAA;AAED;AAAA;AAAA;AAIT;AAEA;AACE;AACF;AAGA;AACE;AAEF;;;;;;"}
+{"version":3,"file":"chart-root.js","sources":["../../src/charts/chart-root.tsx"],"sourcesContent":["\"use client\";\n\nimport type { TableExpr } from \"@kanzo-tech/mosaic\";\nimport { createContext, useContext, useEffect, useMemo, useRef, useState, type ReactNode, type Ref } from \"react\";\nimport type React from \"react\";\nimport { ark } from \"@ark-ui/react/factory\";\nimport { Selection, type Coordinator } from \"@uwdata/mosaic-core\";\nimport * as vg from \"@uwdata/vgplot\";\nimport { cn } from \"../lib/cn.js\";\nimport { chartColorScale, chartSeriesColor, colorTokenName, isColorToken, type ChartConfig } from \"./chart-config.js\";\nimport {\n  buildChartSpec,\n  chartSpecSignature,\n  chartSpecWarnings,\n  chartTableKey,\n  compileChartSpec,\n  type ChartDirective,\n  type ChartFacetOptions,\n  type ChartMargin,\n  type ChartSpecContext,\n} from \"./chart-spec.js\";\nimport { useMosaic } from \"./mosaic-provider.js\";\nimport { resolveTokenColor } from \"../lib/token-color.js\";\nimport { TokenizedPlot } from \"./tokenized-plot.js\";\n\n/** vgplot ships `any` for every directive; this is the one place we pin a shape to it. */\ntype VgDirective = (plot: unknown) => void;\nconst directives = vg as unknown as Record<string, ((...args: unknown[]) => VgDirective) | undefined>;\n\nfunction toVgDirective(directive: ChartDirective): VgDirective | null {\n  switch (directive.kind) {\n    case \"mark\": {\n      const fn = directives[directive.mark];\n      if (!fn) return null;\n      // A decorator takes options only; everything else takes (data, options).\n      if (directive.source === null) return fn(directive.options);\n      const data =\n        directive.source.kind === \"values\"\n          ? [...directive.source.values]\n          : vg.from(directive.source.table, directive.source.filterBy ? { filterBy: directive.source.filterBy } : undefined);\n      return fn(data, directive.options);\n    }\n    case \"interactor\":\n      return directives[directive.interactor]?.(directive.options) ?? null;\n    case \"attribute\":\n      return directives[directive.name]?.(directive.value) ?? null;\n    case \"raw\":\n      return directive.value as VgDirective;\n  }\n}\n\nexport interface ChartContextValue {\n  /** The active Mosaic coordinator, for a consumer that queries alongside the plot. */\n  coordinator: Coordinator;\n  config: ChartConfig;\n  table?: TableExpr;\n  /** What the marks filter by; `null` = the full relation. */\n  filterBy: Selection | null;\n  /** Where the interactors publish. */\n  as: Selection;\n  /**\n   * The series colour, normalised to `rgb(...)` so it is safe for both CSS and Plot. `undefined`\n   * for a key the config does not name.\n   *\n   * Normalising is what makes it dual-purpose and is also what makes it a **snapshot**: the answer\n   * is read off the DOM when you call it, and nothing re-calls it when the theme or the scheme\n   * changes. `ChartLegend` deliberately does not use this — its only sink is a `style`, so it\n   * passes `var(--chart-N)` through and lets the browser follow the theme for free. Take the same\n   * route for anything that only ends up in CSS; pair this with `useThemeTick` when you need the\n   * literal, which is to say when you are handing it to Plot.\n   */\n  color: (key: string) => string | undefined;\n  /** The chart's locale number formatter — one vocabulary for axes, legend and tooltip. */\n  formatNumber: (value: number, options?: Intl.NumberFormatOptions) => string;\n}\n\nconst ChartContext = createContext<ChartContextValue | null>(null);\n\n/**\n * The chart context — config, selections, coordinator, and the `color` / `formatNumber` helpers\n * that keep a series' identity in one place. Throws outside a `<ChartRoot>`.\n *\n * Available to DOM parts (`ChartLegend`, a custom tooltip, a readout). **Not** to descriptors:\n * `ChartRoot` reads their props off the element before React renders them, so a mark cannot pull\n * anything out of context — pass the value down from the component that owns the `<ChartRoot>`.\n */\nexport function useChartContext(): ChartContextValue {\n  const ctx = useContext(ChartContext);\n  if (!ctx) throw new Error(\"useChartContext must be used within a <ChartRoot>.\");\n  return ctx;\n}\n\n/** The chart context, or `null` — for parts that also work standalone, like `ChartLegend`. */\nexport function useChartContextOptional(): ChartContextValue | null {\n  return useContext(ChartContext);\n}\n\nexport interface ChartRootProps\n  extends Omit<React.ComponentProps<typeof ark.div>, \"children\">,\n    ChartFacetOptions {\n  /**\n   * The relation the marks read. A string is one identifier in the default catalog; a relation in\n   * another catalog is a mosaic-sql node — `verbatim(relation.sql)`, `asTableRef([catalog, name])`.\n   * Omit it when every mark carries its own `data`.\n   */\n  table?: TableExpr;\n  /** What the marks filter by. Defaults to the `<MosaicProvider>` crossfilter; `null` = unfiltered. */\n  filterBy?: Selection | null;\n  /**\n   * Where the child interactors publish, and what `ChartHighlight` reads back. Defaults to a\n   * selection this root owns, relayed into the provider — see the note on `ChartRoot`. Pass one and\n   * you own its wiring: nothing is relayed for you, though the provider's `reset()` still clears it.\n   */\n  as?: Selection;\n  /** Series key → `{ label, color, icon }`. A non-empty config pins the plot's colour scale. */\n  config?: ChartConfig;\n  /** Plot height in px; the width is measured from the container. Default 200. */\n  height?: number;\n  margin?: number | ChartMargin;\n  aspectRatio?: number;\n  /**\n   * Raw `vg.*` directives for anything the layer does not wrap. Applied last, so they win.\n   * Keep the array referentially stable — a new array rebuilds the plot.\n   */\n  attributes?: readonly unknown[];\n  /** BCP-47 tag for `formatNumber`. Defaults to the runtime locale. */\n  locale?: string;\n  /** Default options for `formatNumber` — the chart's number vocabulary in one place. */\n  numberFormat?: Intl.NumberFormatOptions;\n  /** Descriptors (marks, interactors, axes) plus real DOM parts such as `ChartLegend`. */\n  children?: ReactNode;\n  /** Class for the plot host itself, inside the root. */\n  plotClassName?: string;\n}\n\nconst EMPTY_CONFIG: ChartConfig = {};\n\n/**\n * Why every chart owns a selection instead of sharing the page's.\n *\n * `ChartHighlight` does not filter — it asks the mark's **own** query which rows are selected, by\n * appending the predicate as an extra output column: `q._groupby.length ? q.select({__: pred})`.\n * On an aggregating mark that query has a `GROUP BY`, so a predicate naming a column this plot does\n * not group by is `Binder Error: column \"provider\" must appear in the GROUP BY clause`. The query\n * dies, vgplot swallows it, and **the plot keeps its previous render** — no error, no empty state,\n * nothing but a console line. It costs hours to find, because the symptom looks like a broken\n * crossfilter three components away.\n *\n * A page-wide publish target guarantees that failure the moment a second chart filters by a second\n * column. So each root publishes into a union of its own: those clauses, by construction, name only\n * columns this plot's own interactors could produce — which are the columns its marks group by. The\n * clauses are relayed on into the provider (`selected` → `crossfilter`) with `source` and `clients`\n * intact, so every other chart filters exactly as before and this one still does not filter itself.\n */\nexport function ChartRoot(props: ChartRootProps) {\n  const {\n    table,\n    filterBy,\n    as,\n    config = EMPTY_CONFIG,\n    height = 200,\n    margin,\n    aspectRatio,\n    facetMargin,\n    facetGrid,\n    facetLabel,\n    attributes,\n    locale,\n    numberFormat,\n    children,\n    className,\n    plotClassName,\n    ref,\n    slot,\n    ...rest\n  } = props;\n  const { coordinator, crossfilter, selected, registerSelection } = useMosaic();\n  // A plain union, so it hides nothing from its own publisher — a crossfilter would, and\n  // `ChartHighlight` would read an empty predicate and dim nothing.\n  const [own] = useState(() => Selection.union());\n  const target = as ?? own;\n  const source = filterBy === undefined ? crossfilter : filterBy;\n  const host = useRef<HTMLDivElement | null>(null);\n\n  useEffect(\n    // Only the selection this root minted is relayed: a caller-supplied `as` was wired by the\n    // caller (`include`, or another root), and relaying it again would double every clause.\n    () => registerSelection(target, { relay: target === own }),\n    [registerSelection, target, own],\n  );\n\n  const numberKey = JSON.stringify(numberFormat ?? null);\n  const tableKey = chartTableKey(table);\n  const context = useMemo<ChartContextValue>(\n    () => ({\n      coordinator,\n      config,\n      table,\n      filterBy: source,\n      as: target,\n      color: (key) => {\n        const value = chartSeriesColor(config, key);\n        if (value === undefined || !isColorToken(value) || typeof document === \"undefined\") return value;\n        // Resolve against the element the chart lives in, so a scoped theme override wins.\n        return resolveTokenColor(host.current ?? document.documentElement, colorTokenName(value));\n      },\n      formatNumber: (value, options) =>\n        new Intl.NumberFormat(locale, options ?? numberFormat).format(value),\n    }),\n    // `numberKey` and `tableKey` stand in for their objects' identities; both are read fresh.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [coordinator, config, tableKey, source, target, locale, numberKey],\n  );\n\n  // Compiled twice on purpose: once here with an identity colour resolver, purely to fingerprint\n  // the grammar for `deps`, and once inside the render below against the live DOM. The pure pass\n  // is what keeps a re-render from re-running every query.\n  const pure = compileChartSpec(children, {\n    table, filterBy: source, as: target, config, resolveColor: identity,\n  });\n  const signature = chartSpecSignature(pure);\n  const colorKey = JSON.stringify(chartColorScale(config));\n\n  // Keyed by signature so an unchanged chart warns once, not on every render.\n  const warned = useRef<string | null>(null);\n  if (process.env.NODE_ENV !== \"production\" && warned.current !== signature) {\n    warned.current = signature;\n    const context = { shared: [crossfilter, selected] };\n    for (const warning of chartSpecWarnings(pure, context)) console.warn(`[ChartRoot] ${warning}`);\n  }\n\n  return (\n    <ChartContext.Provider value={context}>\n      <ark.div\n        className={cn(\"flex w-full flex-col gap-2\", className)}\n        ref={(node: HTMLDivElement | null) => {\n          host.current = node;\n          assignRef(ref, node);\n        }}\n        {...rest}\n        data-slot={slot ?? \"chart-root\"}\n      >\n        <TokenizedPlot\n          className={plotClassName}\n          deps={[\n            signature,\n            colorKey,\n            tableKey,\n            source,\n            target,\n            height,\n            aspectRatio,\n            JSON.stringify(margin ?? null),\n            JSON.stringify(facetMargin ?? null),\n            facetGrid,\n            facetLabel,\n            attributes,\n          ]}\n          render={(width, plotHost) => {\n            const cache = new Map<string, string>();\n            const ctx: ChartSpecContext = {\n              table,\n              filterBy: source,\n              as: target,\n              config,\n              resolveColor: (token) => {\n                const name = colorTokenName(token);\n                const hit = cache.get(name);\n                if (hit !== undefined) return hit;\n                const resolved = resolveTokenColor(plotHost, name);\n                cache.set(name, resolved);\n                return resolved;\n              },\n            };\n            const spec = buildChartSpec(\n              { children, width, height, margin, aspectRatio, facetMargin, facetGrid, facetLabel, attributes },\n              ctx,\n            );\n            return vg.plot(...spec.map(toVgDirective).filter((d): d is VgDirective => d !== null));\n          }}\n        />\n        {children}\n      </ark.div>\n    </ChartContext.Provider>\n  );\n}\n\nfunction identity(token: string): string {\n  return token;\n}\n\n/** The root keeps its own handle on the host (for token resolution) without stealing the caller's. */\nfunction assignRef(ref: Ref<HTMLDivElement> | undefined, node: HTMLDivElement | null): void {\n  if (typeof ref === \"function\") ref(node);\n  else if (ref) ref.current = node;\n}\n"],"names":[],"mappings":";;;;;;;;;;;;AA2BA;AAEA;;AACE;AAAkB;AAEd;AACA;AAEA;AACA;AAIA;AAAiC;AACnC;AAEE;AAAgE;AAEhE;AAAwD;AAExD;AAAiB;AAEvB;AA2BA;AAUO;AACL;AACA;AACA;AACF;AAGO;AACL;AACF;AAwCA;AAmBO;AACL;AAAM;AACJ;AACA;AACA;AACS;AACA;AACT;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACG;AAUL;AAAA;AAAA;AAAA;AAG2D;AAC1B;AAGjC;AAEgB;AACP;AACL;AACA;AACA;AACU;AACN;AAEF;AACA;AAEwF;AAC1F;AAEqE;AAAA;AAAA;AAAA;AAIN;AAM3B;AACtC;AAAiB;AAAY;AAAQ;AAAsB;AAO7D;AACE;AACA;AACA;AAA6F;AAG/F;AAEI;AAAK;AAAJ;AACsD;AAEnD;AACmB;AACrB;AACI;AACe;AAEnB;AAAA;AAAC;AAAA;AACY;AACL;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AAC6B;AACK;AAClC;AACA;AACA;AAAA;AAGA;AAea;AACyE;AAfxD;AAC5B;AACU;AACN;AACJ;AAEE;AAEA;AACA;AACA;AACO;AACT;AAAA;AAMF;AAAqF;AACvF;AAAA;AAAA;AAED;AAAA;AAAA;AAIT;AAEA;AACE;AACF;AAGA;AACE;AAEF;;;;;;"}

package/dist/charts/chart-spec.d.ts

@@ -1,17 +1,24 @@
 import { ReactNode } from 'react';
 import { Selection } from '@uwdata/mosaic-core';
+import { TableExpr } from '@kanzo-tech/mosaic';
 import { ChartConfig } from './chart-config.js';
 /**
  * The plot spec as plain data.
  *
  * `ChartRoot` compiles its descriptor children to this list and only then maps it onto `vg.*`.
  * The indirection is what makes the compiler pure: no coordinator, no DOM, no vgplot — so the
- * grammar is unit-testable and the vgplot binding is a single switch. (`isAggregateExpression` is
- * the one import, a pure AST predicate mosaic-sql exports for exactly this question.)
+ * grammar is unit-testable and the vgplot binding is a single switch. (mosaic-sql is the one
+ * engine import: `isAggregateExpression` and `asTableRef`, both pure AST.)
  */
+/**
+ * A relation's SQL, which is also its identity. A host that writes `verbatim(sql)` inline builds a
+ * new node every render and still names the same relation, so the plot and every query key on this
+ * and not on the node.
+ */
+export declare function chartTableKey(table: TableExpr | undefined): string | undefined;
 export type ChartMarkSource = {
     readonly kind: "table";
-    readonly table: string;
+    readonly table: TableExpr;
     readonly filterBy: Selection | null;
 } | {
     readonly kind: "values";
@@ -43,7 +50,7 @@ export interface ChartRawDirective {
 export type ChartDirective = ChartMarkDirective | ChartInteractorDirective | ChartAttributeDirective | ChartRawDirective;
 export interface ChartSpecContext {
     /** The relation every table-backed mark reads from. */
-    readonly table?: string;
+    readonly table?: TableExpr;
     /** What marks filter by; `null` means "the full relation". */
     readonly filterBy: Selection | null;
     /** Where interactors publish. */

package/dist/charts/chart-spec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chart-spec.d.ts","sourceRoot":"","sources":["../../src/charts/chart-spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EAAiC,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEpF;;;;;;;GAOG;AAEH,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,GAAG,IAAI,CAAA;CAAE,GACvF;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAA;CAAE;AAClE,qFAAqF;GACnF,IAAI,CAAC;AAET,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,8FAA8F;AAC9F,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,MAAM,cAAc,GACtB,kBAAkB,GAClB,wBAAwB,GACxB,uBAAuB,GACvB,iBAAiB,CAAC;AAEtB,MAAM,WAAW,gBAAgB;IAC/B,uDAAuD;IACvD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,8DAA8D;IAC9D,QAAQ,CAAC,QAAQ,EAAE,SAAS,GAAG,IAAI,CAAC;IACpC,iCAAiC;IACjC,QAAQ,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,4EAA4E;IAC5E,QAAQ,CAAC,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;CAClD;AAED,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,gBAAgB,KAAK,cAAc,GAAG,cAAc,EAAE,CAAC;AAErG,4EAA4E;AAC5E,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IACjB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;CACnC;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAEpG;AA4BD,qGAAqG;AACrG,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,gBAAgB,GAAG,cAAc,EAAE,CAI7F;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IACnC,6CAA6C;IAC7C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAiB,SAAQ,iBAAiB;IACzD,QAAQ,EAAE,SAAS,CAAC;IACpB,yFAAyF;IACzF,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;CACjC;AAgBD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,EAAE,gBAAgB,GAAG,cAAc,EAAE,CA4BjG;AA0BD,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;CACtC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,cAAc,EAAE,EAAE,OAAO,CAAC,EAAE,uBAAuB,GAAG,MAAM,EAAE,CA8CrG;AAuCD,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,SAAS,cAAc,EAAE,GAAG,MAAM,CAEhF"}
+{"version":3,"file":"chart-spec.d.ts","sourceRoot":"","sources":["../../src/charts/chart-spec.ts"],"names":[],"mappings":"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"}