ggaction 0.0.12 → 0.0.15

package/src/selectors/datasets.js

@@ -2,6 +2,37 @@ export function findDataset(program, id) {
   return program.semanticSpec.datasets.find(dataset => dataset.id === id);
 }
 
+function currentOwnerMatches(program, id) {
+  const families = program.materializationConfigs.data ?? {};
+  return Object.entries(families).flatMap(([family, owners]) =>
+    Object.entries(owners ?? {}).flatMap(([owner, config]) =>
+      owner === id && typeof config?.current === "string"
+        ? [{ family, owner, current: config.current }]
+        : []
+    )
+  );
+}
+
+export function hasDatasetOwner(program, id) {
+  return currentOwnerMatches(program, id).length > 0;
+}
+
+export function resolveDatasetReference(program, id, label = "Dataset") {
+  const matches = currentOwnerMatches(program, id);
+  if (matches.length > 1) {
+    throw new Error(`${label} logical owner "${id}" is ambiguous.`);
+  }
+  const resolved = matches.length === 1 ? matches[0].current : id;
+  const dataset = findDataset(program, resolved);
+  if (dataset === undefined) {
+    const kind = label.toLowerCase().includes("source")
+      ? "source dataset"
+      : "dataset";
+    throw new Error(`Unknown ${kind} "${id}" does not exist.`);
+  }
+  return dataset;
+}
+
 export function hasDataset(program, id) {
   return findDataset(program, id) !== undefined;
 }
@@ -15,3 +46,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 = resolveDatasetReference(program, id, "Dataset");
+  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

@@ -2,6 +2,10 @@ export function findLayer(program, id) {
   return program.semanticSpec.layers.find(layer => layer.id === id);
 }
 
+export function findLayerMatching(program, predicate) {
+  return program.semanticSpec.layers.find(predicate);
+}
+
 export function hasLayer(program, id) {
   return findLayer(program, id) !== undefined;
 }
@@ -16,17 +20,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,145 @@ 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_TOKEN_KEYS = Object.freeze([
+  "background",
+  "mark",
+  "text",
+  "strongText",
+  "mutedText",
+  "axis",
+  "axisTitle",
+  "grid",
+  "border",
+  "sizeSymbol",
+  "regressionBand",
+  "boxLine",
+  "boxMedian",
+  "referenceLine",
+  "referenceBand",
+  "gradientCenter",
+  "highlight",
+  "fontFamily"
+]);
+
+const THEME_DEFINITION_KEYS = Object.freeze(["base", "tokens"]);
+
+function isPlainObject(value) {
+  if (value === null || typeof value !== "object" || Array.isArray(value)) {
+    return false;
+  }
+  const prototype = Object.getPrototypeOf(value);
+  return prototype === Object.prototype || prototype === null;
+}
+
+function own(value) {
+  return Object.freeze({ ...value });
+}
+
+function validateKeys(value, allowed, label) {
+  const supported = new Set(allowed);
+  const unknown = Object.keys(value).find(key => !supported.has(key));
+  if (unknown !== undefined) {
+    throw new Error(`Unknown ${label} option "${unknown}".`);
+  }
+}
+
+function validateNonEmptyString(value, label) {
+  if (typeof value !== "string" || value.length === 0) {
+    throw new TypeError(`${label} must be a non-empty string.`);
+  }
+  return value;
+}
+
+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];
+}
+
+function validateThemeName(value, label) {
+  if (!THEME_NAMES.includes(value)) {
+    throw new Error(`Unsupported ${label} "${value}".`);
+  }
+  return value;
+}
+
+function normalizeThemeTokens(tokens) {
+  if (!isPlainObject(tokens)) {
+    throw new TypeError("applyTheme theme.tokens must be a plain object.");
+  }
+  validateKeys(tokens, THEME_TOKEN_KEYS, "applyTheme theme.tokens");
+  const normalized = {};
+  for (const [key, value] of Object.entries(tokens)) {
+    validateNonEmptyString(value, `applyTheme theme.tokens.${key}`);
+    normalized[key] = value;
+  }
+  return own(normalized);
+}
+
+export function normalizeThemeDefinition(definition) {
+  if (typeof definition === "string") {
+    return own({
+      name: validateThemeName(definition, "theme"),
+      tokens: own({})
+    });
+  }
+  if (!isPlainObject(definition)) {
+    throw new TypeError(
+      "applyTheme theme must be a built-in name or a plain { base, tokens } object."
+    );
+  }
+  validateKeys(definition, THEME_DEFINITION_KEYS, "applyTheme theme");
+  if (!Object.hasOwn(definition, "base") ||
+      !Object.hasOwn(definition, "tokens")) {
+    throw new Error("applyTheme custom theme requires base and tokens.");
+  }
+  return own({
+    name: validateThemeName(definition.base, "theme base"),
+    tokens: normalizeThemeTokens(definition.tokens)
+  });
+}
+
+export function resolveThemeTokens(definition = "light") {
+  const normalized = normalizeThemeDefinition(definition);
+  return own({
+    ...THEME_TOKENS[normalized.name],
+    ...normalized.tokens
+  });
+}

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,11 @@ export type {
   AxisTickOptions,
   AxisTicksAndLabelsOptions,
   AxisTitleOptions,
+  DisplayLabelMap,
+  DisplayLabelOptions,
+  ApplyThemeOptions,
   BarWidthOptions,
+  BasicSeriesLayoutOptions,
   Bin2DDataOptions,
   CanvasOptions,
   ColorEncodingOptions,
@@ -21,15 +25,22 @@ export type {
   CreateScatterPlotOptions,
   CreateScaleOptions,
   GraphicSpec,
+  GroupEncodingOptions,
   GridDirectionOptions,
   HistogramEncodingOptions,
   LegendOptions,
   PositionEncodingOptions,
   RectMarkOptions,
+  RectStyleDetails,
   ScaleOptions,
   SecondaryPositionEncodingOptions,
   SemanticSpec,
   StrokeDashEncodingOptions,
+  StrokeStyleDetails,
+  TemporalInputUnit,
+  ThemeDefinition,
+  ThemeName,
+  ThemeTokens,
   TraceNode,
   XAxisPosition,
   XOffsetEncodingOptions,
@@ -47,6 +58,8 @@ type BasicStateKey =
 
 type BasicMethodKey =
   | "createCanvas"
+  | "applyTheme"
+  | "removeTheme"
   | "createData"
   | "createPointMark"
   | "createLineMark"
@@ -57,6 +70,7 @@ type BasicMethodKey =
   | "encodeX2"
   | "encodeY2"
   | "encodeGroup"
+  | "encodePointRadius"
   | "encodeColor"
   | "encodeStrokeDash"
   | "encodeSize"
@@ -97,7 +111,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,
@@ -12,6 +18,8 @@ export type {
   AxisTickStyleOptions,
   AxisTitleOptions,
   AxisValue,
+  DisplayLabelMap,
+  DisplayLabelOptions,
   BarWidthOptions,
   BoxPlotOptions,
   BinnedHeatmapColorOptions,
@@ -21,41 +29,165 @@ export type {
   Bin2DDataOptions,
   Bin2DExtent,
   Bin2DOutputFields,
+  BinDataOptions,
+  BinDataOutputFields,
+  BindMarkDataOptions,
+  RemoveResourceOptions,
   CanvasOptions,
+  FitCanvasOptions,
+  FoldDataOptions,
+  FoldDataOutputFields,
   CategoricalEncodingOptions,
   CategoryOrder,
   CategoryOrderSummary,
   CategoryValue,
   ColorLayout,
+  SeriesLayoutOptions,
+  BasicSeriesLayoutOptions,
+  StrokeStyleDetails,
+  RectStyleDetails,
+  CreateAreaPlotOptions,
+  AreaPlotIndependentChannel,
+  AreaPlotMeasureChannel,
   ColorEncodingOptions,
+  StrokeEncodingOptions,
+  EncodeChannelsOptions,
+  EncodingChannelAssignments,
+  SizeEncodingOptions,
+  ShapeEncodingOptions,
+  AngleEncodingOptions,
   CompleteAxisOptions,
   ConcatCompositionSpec,
   CompositionAlign,
   CompositionOptions,
+  EditFacetSourceOptions,
+  FacetHeaderRole,
+  FacetHeaderSide,
+  FacetHeaderAlign,
   CompositionPadding,
   CompositionProgramEntry,
   CompositionSpec,
+  ComputedDataOptions,
+  ComputedExpression,
+  CompleteDataOptions,
+  ImputedDataOptions,
+  NormalizedDataOptions,
+  NormalizeBaseline,
+  NormalizeMethod,
+  NormalizeZeroDenominator,
   ChartProgram,
   ConcretePathCommand,
   CurveInterpolation,
   CreateDerivedDataOptions,
   CreateAxesOptions,
+  PolarAxisTickSelection,
+  ParallelAxisTickSelection,
+  ParallelAxisTicksOptions,
+  ParallelAxisLabelsOptions,
+  ParallelAxisTitleOptions,
+  ParallelAxisComponentsOptions,
+  CreateParallelAxisOptions,
+  EditParallelAxisOptions,
+  ParallelAxesOptions,
+  RemoveParallelAxisOptions,
+  CreateThetaAxisLineOptions,
+  CreateRadialAxisLineOptions,
+  CreateThetaAxisTicksOptions,
+  CreateRadialAxisTicksOptions,
+  CreateThetaAxisLabelsOptions,
+  ThetaAxisLabelOptions,
+  ThetaTicksAndLabelsOptions,
+  CompleteThetaAxisOptions,
+  EditThetaAxisOptions,
+  CreateRadialAxisLabelsOptions,
+  CreateThetaAxisTitleOptions,
+  CreateRadialAxisTitleOptions,
   CreateCoordinateOptions,
+  CoordinateAspect,
+  CoordinateAspectAlign,
+  PolarFrameCenter,
+  PolarFrameRadius,
+  PolarFrameOptions,
+  EditCoordinateOptions,
   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,
+  DatasetCompleteTransform,
+  DatasetImputedTransform,
+  DatasetNormalizedTransform,
   DatasetHorizonTransform,
   DensityPlacement,
   BaselineDensityPlacement,
@@ -67,27 +199,52 @@ export type {
   DatasetBin2DOutputFields,
   DatasetBin2DTransform,
   DatasetFilterTransform,
+  DatasetFoldTransform,
   DatasetIntervalOutputFields,
   DatasetIntervalTransform,
   DatasetTimeUnitTransform,
   DatasetWindowOperation,
   DatasetWindowSort,
   DatasetWindowTransform,
+  DurationWindowFrame,
+  DurationWindowUnit,
   DatasetRegressionTransform,
   DatasetScalar,
+  StatisticalWeight,
+  DatasetStackTransform,
   DatasetTransform,
+  RequestedDatasetTransform,
+  DerivedDataDependents,
+  EditDerivedDataOptions,
   EditGraphicsOptions,
   EditBin2DDataOptions,
+  EditComputedDataOptions,
+  EditFilteredDataOptions,
+  EditFoldDataOptions,
+  EditSummaryDataOptions,
+  EditBinDataOptions,
+  EditTimeUnitDataOptions,
+  EditWindowDataOptions,
+  EditDensityDataOptions,
+  EditStackDataOptions,
+  EditRegressionDataOptions,
+  EditIntervalDataOptions,
+  EditECDFDataOptions,
+  EditNormalizedDataOptions,
+  EditCompleteDataOptions,
+  EditImputedDataOptions,
   EditHorizonOptions,
   EditCompositionLayoutOptions,
   EditFacetHeadersOptions,
   EditAxisOptions,
   EditGradientPlotOptions,
+  EditViolinPlotOptions,
   EditGridDirectionsOptions,
   EditGridOptions,
   EditErrorBandBoundaryOptions,
   EditErrorBandOptions,
   EditErrorBarOptions,
+  RuleStyleOptions,
   EditBoxPlotOptions,
   EditLegendBorderOptions,
   EditLegendLabelsOptions,
@@ -95,17 +252,32 @@ export type {
   EditLegendSymbolsOptions,
   EditLegendTitleOptions,
   EditScaleOptions,
+  EditXScaleOptions,
+  EditYScaleOptions,
+  EditParallelScaleOptions,
+  EditThetaScaleOptions,
+  EditRScaleOptions,
+  EditColorScaleOptions,
+  EditStrokeScaleOptions,
+  EditSizeScaleOptions,
+  EditOpacityScaleOptions,
+  EditShapeScaleOptions,
+  EditStrokeWidthScaleOptions,
+  EditStrokeDashScaleOptions,
   EditSemanticOptions,
   FieldType,
   FillPaint,
   FacetCompositionSpec,
   FacetGuideOptions,
   FacetOptions,
+  FacetGridOptions,
+  FacetGridRole,
   FacetScaleResolution,
   FacetScaleResolutions,
   GraphicObject,
   GraphicSpec,
   GraphicType,
+  GroupEncodingOptions,
   GradientPlotAppearanceOptions,
   GradientPlotCenterOptions,
   GradientPlotDensityOptions,
@@ -135,11 +307,18 @@ export type {
   HighlightMarksOptions,
   JitterMaxOffset,
   JitterPointsOptions,
+  PointPackingMaxOffset,
+  PackPointsOptions,
+  RemovePointPackingOptions,
   LabelLayoutAxis,
   LabelLayoutBounds,
   LabelLayoutOptions,
   LabelLeaderOptions,
   LegendOptions,
+  LegendChannel,
+  LegendBlockTextPatch,
+  LegendBlockSymbolPatch,
+  EditLegendBlockOptions,
   EditLegendOptions,
   ContinuousColorInterpolation,
   ContinuousColorScaleOptions,
@@ -147,6 +326,9 @@ export type {
   OpacityScaleOptions,
   OrderCategoriesOptions,
   OffsetScaleOptions,
+  OffsetScaleEditPatch,
+  EditXOffsetScaleOptions,
+  EditYOffsetScaleOptions,
   PathOrderEncodingOptions,
   ParallelCoordinatesEncodingOptions,
   ParallelDimension,
@@ -169,6 +351,10 @@ export type {
   RegressionOptions,
   RectMarkOptions,
   ReplaceCompositionChildOptions,
+  InsertCompositionChildOptions,
+  RemoveCompositionChildOptions,
+  ReorderCompositionChildrenOptions,
+  RepeatChartsOptions,
   EditRegressionOptions,
   EditRectMarkOptions,
   RemoveAxisOptions,
@@ -185,6 +371,11 @@ export type {
   ShapeScaleOptions,
   SizeScaleOptions,
   StackMode,
+  StackDataMode,
+  StackDataOptions,
+  StackDataOutputFields,
+  SummaryAggregateOptions,
+  SummaryDataOptions,
   YStackMode,
   SemanticCoordinate,
   SemanticDataset,
@@ -199,6 +390,12 @@ export type {
   ThetaScaleOptions,
   TimeUnit,
   TimeUnitDataOptions,
+  RowWindowFrame,
+  TemporalInputUnit,
+  ThemeDefinition,
+  ThemeName,
+  ThemeTokens,
+  ApplyThemeOptions,
   TraceNode,
   TitleOptions,
   EditTitleOptions,
@@ -207,9 +404,23 @@ export type {
   TextEncodingOptions,
   TextFormat,
   TextMarkOptions,
+  DatumPositionEncodingOptions,
+  CreateMarkLabelsOptions,
+  EditMarkLabelPlacementOptions,
+  EditMarkLabelSelectionOptions,
+  MarkLabelAnchor,
+  MarkLabelPlacement,
+  MarkLabelPlacementLeaderOptions,
+  MarkLabelSelectionOptions,
+  RemoveMarkLabelsOptions,
+  CreateAnnotationOptions,
+  ReferenceStatistic,
+  CreateReferenceLineOptions,
+  CreateReferenceBandOptions,
   XAxisPosition,
   YAxisPosition,
   WindowDataOptions,
+  WindowFrame,
   WindowOperation,
   WindowSort,
   WindowSortOrder,