ggaction 0.0.13 → 0.0.15

package/src/renderers/svg.js

@@ -113,6 +113,21 @@ function requireStrokeDash(properties, graphicId) {
   return strokeDash;
 }
 
+function strokeDetailAttributes(properties, strokeWidth) {
+  if (typeof properties.stroke !== "string" || !(strokeWidth > 0)) return [];
+  return [
+    ["stroke-linecap", Object.hasOwn(properties, "lineCap")
+      ? properties.lineCap
+      : undefined],
+    ["stroke-linejoin", Object.hasOwn(properties, "lineJoin")
+      ? properties.lineJoin
+      : undefined],
+    ["stroke-miterlimit", Object.hasOwn(properties, "miterLimit")
+      ? formatNumber(properties.miterLimit)
+      : undefined]
+  ];
+}
+
 function requireCanvasGeometry(id, canvas, { nested }) {
   const properties = canvas.properties ?? {};
   const width = requireFiniteProperty(properties, "width", id);
@@ -200,6 +215,7 @@ function serializeCircle(state, graphicId, properties) {
     ["stroke-width", strokeWidth === undefined
       ? undefined
       : formatNumber(strokeWidth)],
+    ...strokeDetailAttributes(properties, strokeWidth),
     ["opacity", formatNumber(requireOpacity(properties, graphicId))]
   ]);
 }
@@ -240,6 +256,7 @@ function serializeRect(state, graphicId, properties) {
     ["fill", fill],
     ["stroke", properties.stroke],
     ["stroke-width", formatNumber(strokeWidth)],
+    ...strokeDetailAttributes(properties, strokeWidth),
     ["opacity", formatNumber(requireOpacity(properties, graphicId))]
   ]);
 }
@@ -268,6 +285,7 @@ function serializeLine(state, graphicId, properties) {
     ["fill", "none"],
     ["stroke", properties.stroke],
     ["stroke-width", formatNumber(strokeWidth)],
+    ...strokeDetailAttributes(properties, strokeWidth),
     ["stroke-dasharray", strokeDash.length === 0
       ? undefined
       : strokeDash.map(formatNumber).join(" ")],
@@ -332,6 +350,7 @@ function serializePath(state, graphicId, properties) {
     ["stroke-width", strokeWidth === undefined
       ? undefined
       : formatNumber(strokeWidth)],
+    ...strokeDetailAttributes(properties, strokeWidth),
     ["stroke-dasharray", strokeDash.length === 0
       ? undefined
       : strokeDash.map(formatNumber).join(" ")],

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;
 }
@@ -17,7 +48,7 @@ export function requireDataset(program, id, label = `Dataset "${id}"`) {
 }
 
 export function requireMaterializedDataset(program, id) {
-  const dataset = findDataset(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(

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;
 }

package/src/theme/defaults.js

@@ -23,6 +23,56 @@ export const DEFAULT_COLORS = Object.freeze({
 
 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",
@@ -54,3 +104,54 @@ export const THEME_TOKENS = Object.freeze({
 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

@@ -6,6 +6,8 @@ export type {
   AxisTickOptions,
   AxisTicksAndLabelsOptions,
   AxisTitleOptions,
+  DisplayLabelMap,
+  DisplayLabelOptions,
   ApplyThemeOptions,
   BarWidthOptions,
   BasicSeriesLayoutOptions,
@@ -29,12 +31,16 @@ export type {
   LegendOptions,
   PositionEncodingOptions,
   RectMarkOptions,
+  RectStyleDetails,
   ScaleOptions,
   SecondaryPositionEncodingOptions,
   SemanticSpec,
   StrokeDashEncodingOptions,
+  StrokeStyleDetails,
   TemporalInputUnit,
+  ThemeDefinition,
   ThemeName,
+  ThemeTokens,
   TraceNode,
   XAxisPosition,
   XOffsetEncodingOptions,

package/types/index.d.ts

@@ -18,6 +18,8 @@ export type {
   AxisTickStyleOptions,
   AxisTitleOptions,
   AxisValue,
+  DisplayLabelMap,
+  DisplayLabelOptions,
   BarWidthOptions,
   BoxPlotOptions,
   BinnedHeatmapColorOptions,
@@ -30,6 +32,7 @@ export type {
   BinDataOptions,
   BinDataOutputFields,
   BindMarkDataOptions,
+  RemoveResourceOptions,
   CanvasOptions,
   FitCanvasOptions,
   FoldDataOptions,
@@ -41,20 +44,37 @@ export type {
   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,
@@ -75,10 +95,20 @@ export type {
   CreateThetaAxisTicksOptions,
   CreateRadialAxisTicksOptions,
   CreateThetaAxisLabelsOptions,
+  ThetaAxisLabelOptions,
+  ThetaTicksAndLabelsOptions,
+  CompleteThetaAxisOptions,
+  EditThetaAxisOptions,
   CreateRadialAxisLabelsOptions,
   CreateThetaAxisTitleOptions,
   CreateRadialAxisTitleOptions,
   CreateCoordinateOptions,
+  CoordinateAspect,
+  CoordinateAspectAlign,
+  PolarFrameCenter,
+  PolarFrameRadius,
+  PolarFrameOptions,
+  EditCoordinateOptions,
   CreateGuidesOptions,
   CreateGridOptions,
   CreateBarPlotOptions,
@@ -155,6 +185,9 @@ export type {
   ECDFOutputFields,
   ECDFDataOptions,
   DatasetComputedTransform,
+  DatasetCompleteTransform,
+  DatasetImputedTransform,
+  DatasetNormalizedTransform,
   DatasetHorizonTransform,
   DensityPlacement,
   BaselineDensityPlacement,
@@ -173,12 +206,33 @@ export type {
   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,
@@ -198,6 +252,18 @@ export type {
   EditLegendSymbolsOptions,
   EditLegendTitleOptions,
   EditScaleOptions,
+  EditXScaleOptions,
+  EditYScaleOptions,
+  EditParallelScaleOptions,
+  EditThetaScaleOptions,
+  EditRScaleOptions,
+  EditColorScaleOptions,
+  EditStrokeScaleOptions,
+  EditSizeScaleOptions,
+  EditOpacityScaleOptions,
+  EditShapeScaleOptions,
+  EditStrokeWidthScaleOptions,
+  EditStrokeDashScaleOptions,
   EditSemanticOptions,
   FieldType,
   FillPaint,
@@ -249,6 +315,10 @@ export type {
   LabelLayoutOptions,
   LabelLeaderOptions,
   LegendOptions,
+  LegendChannel,
+  LegendBlockTextPatch,
+  LegendBlockSymbolPatch,
+  EditLegendBlockOptions,
   EditLegendOptions,
   ContinuousColorInterpolation,
   ContinuousColorScaleOptions,
@@ -256,6 +326,9 @@ export type {
   OpacityScaleOptions,
   OrderCategoriesOptions,
   OffsetScaleOptions,
+  OffsetScaleEditPatch,
+  EditXOffsetScaleOptions,
+  EditYOffsetScaleOptions,
   PathOrderEncodingOptions,
   ParallelCoordinatesEncodingOptions,
   ParallelDimension,
@@ -317,8 +390,11 @@ export type {
   ThetaScaleOptions,
   TimeUnit,
   TimeUnitDataOptions,
+  RowWindowFrame,
   TemporalInputUnit,
+  ThemeDefinition,
   ThemeName,
+  ThemeTokens,
   ApplyThemeOptions,
   TraceNode,
   TitleOptions,
@@ -330,12 +406,21 @@ export type {
   TextMarkOptions,
   DatumPositionEncodingOptions,
   CreateMarkLabelsOptions,
+  EditMarkLabelPlacementOptions,
+  EditMarkLabelSelectionOptions,
+  MarkLabelAnchor,
+  MarkLabelPlacement,
+  MarkLabelPlacementLeaderOptions,
+  MarkLabelSelectionOptions,
+  RemoveMarkLabelsOptions,
   CreateAnnotationOptions,
+  ReferenceStatistic,
   CreateReferenceLineOptions,
   CreateReferenceBandOptions,
   XAxisPosition,
   YAxisPosition,
   WindowDataOptions,
+  WindowFrame,
   WindowOperation,
   WindowSort,
   WindowSortOrder,