ggaction 0.0.11 → 0.0.13

package/src/materialization/selection/items/rect.js

@@ -1,10 +1,12 @@
+import { rectUsesFields } from "../../../grammar/rects.js";
 import { resolveRectRows } from "../../rect.js";
 import {
   channelMapFromRow,
   concreteProperties,
   finalizeItems,
   itemKey,
-  ownFields
+  ownFields,
+  uniqueFields
 } from "./common.js";
 
 function resolveGradientPlotItems(program, layer, dataset) {
@@ -33,12 +35,13 @@ export function resolveRectItems(program, layer, dataset) {
     return resolveGradientPlotItems(program, layer, dataset);
   }
   const rows = resolveRectRows(program, layer, dataset);
+  const hasField = rectUsesFields(layer);
   const definitions = rows.map((item, graphicIndex) => ({
     key: itemKey(layer, "rect", item.sourceIndex),
-    fields: ownFields(item.row),
-    channels: item.channels,
+    fields: hasField ? ownFields(item.row) : uniqueFields(dataset.values),
+    channels: channelMapFromRow(item.row, layer),
     properties: concreteProperties(graphic.items[graphicIndex]?.properties),
-    members: [item.row]
+    members: hasField ? [item.row] : dataset.values
   }));
   return finalizeItems(program, layer, "rect", definitions, "rect");
 }

package/src/materialization/text.js

@@ -1,5 +1,8 @@
 import { resolveBarChannels } from "../grammar/bars/policy.js";
+import { resolveMarkLabelValues } from "../grammar/markLabels.js";
 import { formatTextValue } from "../grammar/text.js";
+import { normalizePositionDatum } from "../grammar/positionDatum.js";
+import { mapOrdinalPositionValues } from "../grammar/scales/index.js";
 import { findDataset } from "../selectors/datasets.js";
 import { findLayer } from "../selectors/layers.js";
 import { resolveMarkItems } from "./selection/policies/index.js";
@@ -7,6 +10,14 @@ import { mapScaleConsumerValues } from "./scales/map.js";
 import { resolveRowEncodingValues } from "./rowEncoding.js";
 
 function sourceValue(item, source, field) {
+  const measure = source.mark.type === "bar" ? resolveBarChannels(source).measure
+    : source.mark.type === "arc" ? "radius" : undefined;
+  const encoding = source.encoding?.[measure];
+  if (encoding?.field === field && encoding.aggregate != null && item.channels[measure] !== undefined) {
+    return source.mark.type === "bar"
+      ? item.channels[`${measure}2`] ?? item.channels[measure]
+      : item.channels[measure];
+  }
   if (Object.hasOwn(item.fields, field)) return item.fields[field];
   for (const [channel, encoding] of Object.entries(source.encoding ?? {})) {
     if (encoding?.field !== field || item.channels[channel] === undefined) continue;
@@ -18,6 +29,10 @@ function sourceValue(item, source, field) {
   if (item.members.length === 1 && Object.hasOwn(item.members[0], field)) {
     return item.members[0][field];
   }
+  if (source.mark.type === "line" && item.members.length > 0) {
+    const endpoint = item.members.at(-1);
+    if (Object.hasOwn(endpoint, field)) return endpoint[field];
+  }
   return undefined;
 }
 
@@ -54,6 +69,17 @@ function sourceAnchor(program, source, item) {
       y: item.properties.y2
     };
   }
+  if (source.mark.type === "line") {
+    const graphicId = item.graphicIds?.[0];
+    const graphic = program.graphicSpec.objects[source.id]?.items?.find(
+      candidate => candidate.id === graphicId
+    );
+    const commands = graphic?.properties?.commands;
+    const endpoint = Array.isArray(commands)
+      ? [...commands].reverse().find(command => Number.isFinite(command.x) && Number.isFinite(command.y))
+      : undefined;
+    return { x: endpoint?.x, y: endpoint?.y };
+  }
   return { x: item.properties.x, y: item.properties.y };
 }
 
@@ -122,12 +148,14 @@ function resolveSourceTextItems(program, layer, config) {
     throw new Error(`Text mark "${layer.id}" requires source layer "${layer.source}".`);
   }
   const items = resolveMarkItems(program, source.id);
-  return items.flatMap(item => {
+  const values = layer.encoding.text.content === undefined ? undefined
+    : resolveMarkLabelValues(source, items, layer.encoding.text);
+  return items.flatMap((item, index) => {
     const anchor = sourceAnchor(program, source, item);
     const concrete = concreteItem(
       sourceTextConfig(config, source, item),
       anchor,
-      contentValue(layer.encoding.text, item, source),
+      values === undefined ? contentValue(layer.encoding.text, item, source) : values[index],
       layer.encoding.text.format
     );
     return concrete === undefined ? [] : [{ graphic: concrete, anchor }];
@@ -139,10 +167,41 @@ function resolveRowTextItems(program, layer, config) {
   if (dataset === undefined) {
     throw new Error(`Text mark "${layer.id}" requires an existing dataset.`);
   }
-  const x = resolveRowEncodingValues(program, layer, dataset, "x");
-  const y = resolveRowEncodingValues(program, layer, dataset, "y");
+  const encodings = [layer.encoding?.x, layer.encoding?.y, layer.encoding?.text];
+  const length = encodings.some(encoding => encoding !== undefined && Object.hasOwn(encoding, "field"))
+    ? dataset.values.length
+    : 1;
+  const positionValues = channel => {
+    const encoding = layer.encoding?.[channel];
+    if (encoding === undefined) return undefined;
+    if (Object.hasOwn(encoding, "field")) {
+      return resolveRowEncodingValues(program, layer, dataset, channel);
+    }
+    const scale = program.resolvedScales[encoding.scale];
+    if (scale === undefined) {
+      throw new Error(
+        `text mark "${layer.id}" requires resolved ${channel} scale "${encoding.scale}".`
+      );
+    }
+    const datum = normalizePositionDatum(
+      encoding.datum,
+      encoding.fieldType,
+      channel,
+      encoding.temporalUnit,
+      "Text"
+    );
+    const mapped = ["nominal", "ordinal"].includes(encoding.fieldType)
+      ? mapOrdinalPositionValues([datum], scale)
+      : mapScaleConsumerValues([datum], scale, channel);
+    return Array.from({ length }, () => mapped[0]);
+  };
+  const x = positionValues("x");
+  const y = positionValues("y");
   if (x === undefined || y === undefined) return [];
-  return dataset.values.flatMap((row, index) => {
+  const rows = length === 1 && dataset.values.length === 0
+    ? [undefined]
+    : dataset.values.slice(0, length);
+  return rows.flatMap((row, index) => {
     const concrete = concreteItem(
       config,
       { x: x[index], y: y[index] },

package/src/mcp/adapter.js

@@ -203,8 +203,8 @@ export function readKnowledgeResource(uri, { allowedDocs = [] } = {}) {
   throw new KnowledgeResourceError(`Unknown knowledge resource URI: ${uri}`);
 }
 
-if (cardsArtifact.schemaVersion !== 2 || resourcesArtifact.schemaVersion !== 2) {
-  throw new Error("MCP action cards and resources must use schemaVersion 2.");
+if (cardsArtifact.schemaVersion !== 3 || resourcesArtifact.schemaVersion !== 2) {
+  throw new Error("MCP action cards must use schemaVersion 3 and resources must use schemaVersion 2.");
 }
 if (resourcesArtifact.packageVersion !== cardsArtifact.packageVersion) {
   throw new Error("MCP action cards and resources must use one packageVersion.");

package/src/selectors/datasets.js

@@ -15,3 +15,16 @@ export function requireDataset(program, id, label = `Dataset "${id}"`) {
   if (dataset === undefined) throw new Error(`${label} does not exist.`);
   return dataset;
 }
+
+export function requireMaterializedDataset(program, id) {
+  const dataset = findDataset(program, id);
+  if (dataset === undefined) throw new Error(`Unknown dataset "${id}".`);
+  if (!Array.isArray(dataset.values)) {
+    throw new Error(
+      `Dataset "${id}" requires materialized values. ` +
+      "createDerivedData stores a definition only; use the corresponding " +
+      "value-producing data action before creating a chart or mark."
+    );
+  }
+  return dataset;
+}

package/src/selectors/layers.js

@@ -16,17 +16,18 @@ export function resolveEligibleLayer(program, {
   target,
   predicate,
   label,
+  targetOption = "target",
   current = program.context.currentMark
 }) {
   const candidates = program.semanticSpec.layers.filter(predicate);
   if (target !== undefined) {
     const selected = candidates.find(layer => layer.id === target);
-    if (selected === undefined) throw new Error(`Unknown ${label} target "${target}".`);
+    if (selected === undefined) throw new Error(`Unknown ${label} ${targetOption} "${target}".`);
     return selected;
   }
   const selected = candidates.find(layer => layer.id === current);
   if (selected !== undefined) return selected;
   if (candidates.length === 1) return candidates[0];
   if (candidates.length === 0) throw new Error(`${label} requires an eligible layer.`);
-  throw new Error(`${label} target is ambiguous; provide target.`);
+  throw new Error(`${label} ${targetOption} is ambiguous; provide ${targetOption}.`);
 }

package/src/selectors/scales.js

@@ -19,3 +19,9 @@ export function requireResolvedScale(program, id, type) {
   }
   return scale;
 }
+
+export function hasSemanticScaleReferences(spec, id) {
+  const referenced = value => value !== null && typeof value === "object" && Object.entries(value).some(([key, child]) =>
+    (key === "scale" && child === id) || (key === "scales" && Array.isArray(child) && child.includes(id)) || referenced(child));
+  return referenced(spec.layers) || referenced(spec.guides);
+}

package/src/theme/defaults.js

@@ -13,5 +13,44 @@ export const DEFAULT_COLORS = Object.freeze({
   border: "#cbd5e1",
   sizeSymbol: "#94a3b8",
   regressionBand: "#111111",
+  boxLine: "#111111",
+  boxMedian: "#1f2937",
+  referenceLine: "#64748b",
+  referenceBand: "#94a3b8",
+  gradientCenter: "#0f172a",
   highlight: "#dc2626"
 });
+
+export const THEME_NAMES = Object.freeze(["light", "dark"]);
+
+export const THEME_TOKENS = Object.freeze({
+  light: Object.freeze({
+    background: "white",
+    ...DEFAULT_COLORS,
+    fontFamily: DEFAULT_FONT_FAMILY
+  }),
+  dark: Object.freeze({
+    background: "#0f172a",
+    mark: "#60a5fa",
+    text: "#e2e8f0",
+    strongText: "#f8fafc",
+    mutedText: "#94a3b8",
+    axis: "#cbd5e1",
+    axisTitle: "#f1f5f9",
+    grid: "#334155",
+    border: "#475569",
+    sizeSymbol: "#94a3b8",
+    regressionBand: "#f8fafc",
+    boxLine: "#f8fafc",
+    boxMedian: "#f8fafc",
+    referenceLine: "#94a3b8",
+    referenceBand: "#94a3b8",
+    gradientCenter: "#f8fafc",
+    highlight: DEFAULT_COLORS.highlight,
+    fontFamily: DEFAULT_FONT_FAMILY
+  })
+});
+
+export function themeTokens(name = "light") {
+  return THEME_TOKENS[name];
+}

package/types/basic.d.ts

@@ -1,4 +1,4 @@
-import type { ChartProgram } from "./program.js";
+import type { ChartProgram, BasicSeriesLayoutOptions } from "./program.js";
 
 export type {
   AxisLabelOptions,
@@ -6,7 +6,9 @@ export type {
   AxisTickOptions,
   AxisTicksAndLabelsOptions,
   AxisTitleOptions,
+  ApplyThemeOptions,
   BarWidthOptions,
+  BasicSeriesLayoutOptions,
   Bin2DDataOptions,
   CanvasOptions,
   ColorEncodingOptions,
@@ -21,6 +23,7 @@ export type {
   CreateScatterPlotOptions,
   CreateScaleOptions,
   GraphicSpec,
+  GroupEncodingOptions,
   GridDirectionOptions,
   HistogramEncodingOptions,
   LegendOptions,
@@ -30,6 +33,8 @@ export type {
   SecondaryPositionEncodingOptions,
   SemanticSpec,
   StrokeDashEncodingOptions,
+  TemporalInputUnit,
+  ThemeName,
   TraceNode,
   XAxisPosition,
   XOffsetEncodingOptions,
@@ -47,6 +52,8 @@ type BasicStateKey =
 
 type BasicMethodKey =
   | "createCanvas"
+  | "applyTheme"
+  | "removeTheme"
   | "createData"
   | "createPointMark"
   | "createLineMark"
@@ -57,6 +64,7 @@ type BasicMethodKey =
   | "encodeX2"
   | "encodeY2"
   | "encodeGroup"
+  | "encodePointRadius"
   | "encodeColor"
   | "encodeStrokeDash"
   | "encodeSize"
@@ -97,7 +105,8 @@ type RebindMethod<T> = T extends (...args: infer Args) => ChartProgram
 
 export type BasicChartProgram =
   Pick<ChartProgram, BasicStateKey> &
-  { readonly [Key in BasicMethodKey]: RebindMethod<ChartProgram[Key]> };
+  { readonly [Key in BasicMethodKey]: RebindMethod<ChartProgram[Key]> } &
+  { readonly layoutSeries: (options: BasicSeriesLayoutOptions) => BasicChartProgram };
 
 export function chart(): BasicChartProgram;
 export function render(

package/types/index.d.ts

@@ -4,7 +4,13 @@ export type {
   ActionOptions,
   AxisFormat,
   AxisFormatString,
+  RotationInput,
+  RotationUnit,
+  NumericFormatString,
+  UtcFormatString,
+  ValueFormat,
   AxisLabelOptions,
+  AxisLabelLayoutOptions,
   AxisLabelStyleOptions,
   AxisLineStyleOptions,
   AxisTickOptions,
@@ -21,41 +27,134 @@ export type {
   Bin2DDataOptions,
   Bin2DExtent,
   Bin2DOutputFields,
+  BinDataOptions,
+  BinDataOutputFields,
+  BindMarkDataOptions,
   CanvasOptions,
+  FitCanvasOptions,
+  FoldDataOptions,
+  FoldDataOutputFields,
   CategoricalEncodingOptions,
   CategoryOrder,
   CategoryOrderSummary,
   CategoryValue,
   ColorLayout,
+  SeriesLayoutOptions,
+  BasicSeriesLayoutOptions,
+  CreateAreaPlotOptions,
+  AreaPlotIndependentChannel,
+  AreaPlotMeasureChannel,
   ColorEncodingOptions,
   CompleteAxisOptions,
   ConcatCompositionSpec,
   CompositionAlign,
   CompositionOptions,
+  EditFacetSourceOptions,
   CompositionPadding,
   CompositionProgramEntry,
   CompositionSpec,
+  ComputedDataOptions,
+  ComputedExpression,
   ChartProgram,
   ConcretePathCommand,
   CurveInterpolation,
   CreateDerivedDataOptions,
   CreateAxesOptions,
+  PolarAxisTickSelection,
+  ParallelAxisTickSelection,
+  ParallelAxisTicksOptions,
+  ParallelAxisLabelsOptions,
+  ParallelAxisTitleOptions,
+  ParallelAxisComponentsOptions,
+  CreateParallelAxisOptions,
+  EditParallelAxisOptions,
+  ParallelAxesOptions,
+  RemoveParallelAxisOptions,
+  CreateThetaAxisLineOptions,
+  CreateRadialAxisLineOptions,
+  CreateThetaAxisTicksOptions,
+  CreateRadialAxisTicksOptions,
+  CreateThetaAxisLabelsOptions,
+  CreateRadialAxisLabelsOptions,
+  CreateThetaAxisTitleOptions,
+  CreateRadialAxisTitleOptions,
   CreateCoordinateOptions,
   CreateGuidesOptions,
   CreateGridOptions,
   CreateBarPlotOptions,
   CreateHeatmapOptions,
   CreateHistogramOptions,
+  CreatePiePlotOptions,
+  CreateRosePlotOptions,
+  CreateRadialBarPlotOptions,
+  MeasuredRadialGuideOptions,
+  MeasuredRadiusScaleOptions,
+  RadialMapping,
+  RadialEncodingOptions,
+  RadiusScaleOptions,
+  CreateDensityPlotOptions,
+  CreateHorizonPlotOptions,
+  HorizonPlotGuideOptions,
+  DensityPlotGuideOptions,
+  DensityPlotLegendOptions,
+  PieCategory,
+  PieColor,
+  PieLegendOptions,
   CreateRegressionBandOptions,
   CreateRegressionLineOptions,
   CreateLinePlotOptions,
+  CreatePolarLinePlotOptions,
+  CreatePolarScatterPlotOptions,
+  CreateRadarPlotOptions,
+  CreateRugPlotOptions,
+  CreateStripPlotOptions,
+  CreateBeeswarmPlotOptions,
+  RaincloudDensityOptions,
+  RaincloudBoxSummaryOptions,
+  RaincloudIntervalSummaryOptions,
+  RaincloudSummaryOptions,
+  RaincloudPointAppearanceOptions,
+  RaincloudPointsOptions,
+  CreateRaincloudPlotOptions,
+  EditRaincloudPlotOptions,
+  BeeswarmPackingOptions,
+  RadarCategoryChannel,
+  RadarCategoryScaleOptions,
+  RadarCategoryValue,
+  RadarWideOptions,
+  RugGuideOptions,
+  RugMeasureChannel,
+  RugTickOptions,
+  StripCategoryChannel,
+  StripBandJitterOptions,
+  StripJitterOptions,
+  StripPixelJitterOptions,
   CreateParallelCoordinatesOptions,
   CreateScatterPlotOptions,
+  CreateIntervalPlotOptions,
+  CreateRegressionPlotOptions,
+  CreateDotPlotOptions,
+  CreateLollipopPlotOptions,
+  CreateDumbbellPlotOptions,
+  EditEndpointPlotOptions,
+  CreateECDFPlotOptions,
+  EditECDFPlotOptions,
+  EndpointCategoryChannel,
+  EndpointValueChannel,
+  EndpointPlotSummary,
+  EndpointLabelOptions,
+  IntervalPlotErrorBarOptions,
+  RegressionPlotPositionChannel,
   CreateScaleOptions,
   DashPattern,
   DashScaleOptions,
   DashStyle,
   DatasetDensityTransform,
+  DatasetECDFResolvedGroup,
+  DatasetECDFTransform,
+  ECDFOutputFields,
+  ECDFDataOptions,
+  DatasetComputedTransform,
   DatasetHorizonTransform,
   DensityPlacement,
   BaselineDensityPlacement,
@@ -67,6 +166,7 @@ export type {
   DatasetBin2DOutputFields,
   DatasetBin2DTransform,
   DatasetFilterTransform,
+  DatasetFoldTransform,
   DatasetIntervalOutputFields,
   DatasetIntervalTransform,
   DatasetTimeUnitTransform,
@@ -75,6 +175,7 @@ export type {
   DatasetWindowTransform,
   DatasetRegressionTransform,
   DatasetScalar,
+  DatasetStackTransform,
   DatasetTransform,
   EditGraphicsOptions,
   EditBin2DDataOptions,
@@ -83,11 +184,13 @@ export type {
   EditFacetHeadersOptions,
   EditAxisOptions,
   EditGradientPlotOptions,
+  EditViolinPlotOptions,
   EditGridDirectionsOptions,
   EditGridOptions,
   EditErrorBandBoundaryOptions,
   EditErrorBandOptions,
   EditErrorBarOptions,
+  RuleStyleOptions,
   EditBoxPlotOptions,
   EditLegendBorderOptions,
   EditLegendLabelsOptions,
@@ -101,11 +204,14 @@ export type {
   FacetCompositionSpec,
   FacetGuideOptions,
   FacetOptions,
+  FacetGridOptions,
+  FacetGridRole,
   FacetScaleResolution,
   FacetScaleResolutions,
   GraphicObject,
   GraphicSpec,
   GraphicType,
+  GroupEncodingOptions,
   GradientPlotAppearanceOptions,
   GradientPlotCenterOptions,
   GradientPlotDensityOptions,
@@ -135,6 +241,9 @@ export type {
   HighlightMarksOptions,
   JitterMaxOffset,
   JitterPointsOptions,
+  PointPackingMaxOffset,
+  PackPointsOptions,
+  RemovePointPackingOptions,
   LabelLayoutAxis,
   LabelLayoutBounds,
   LabelLayoutOptions,
@@ -169,6 +278,10 @@ export type {
   RegressionOptions,
   RectMarkOptions,
   ReplaceCompositionChildOptions,
+  InsertCompositionChildOptions,
+  RemoveCompositionChildOptions,
+  ReorderCompositionChildrenOptions,
+  RepeatChartsOptions,
   EditRegressionOptions,
   EditRectMarkOptions,
   RemoveAxisOptions,
@@ -185,6 +298,11 @@ export type {
   ShapeScaleOptions,
   SizeScaleOptions,
   StackMode,
+  StackDataMode,
+  StackDataOptions,
+  StackDataOutputFields,
+  SummaryAggregateOptions,
+  SummaryDataOptions,
   YStackMode,
   SemanticCoordinate,
   SemanticDataset,
@@ -199,6 +317,9 @@ export type {
   ThetaScaleOptions,
   TimeUnit,
   TimeUnitDataOptions,
+  TemporalInputUnit,
+  ThemeName,
+  ApplyThemeOptions,
   TraceNode,
   TitleOptions,
   EditTitleOptions,
@@ -207,6 +328,11 @@ export type {
   TextEncodingOptions,
   TextFormat,
   TextMarkOptions,
+  DatumPositionEncodingOptions,
+  CreateMarkLabelsOptions,
+  CreateAnnotationOptions,
+  CreateReferenceLineOptions,
+  CreateReferenceBandOptions,
   XAxisPosition,
   YAxisPosition,
   WindowDataOptions,