ggaction 0.0.2 → 0.0.3

package/types/program.d.ts

@@ -46,6 +46,94 @@ export type ScaleType =
   | "quantile"
   | "threshold";
 export type StackMode = "zero" | "normalize" | null;
+export type CompositionAlign = "start" | "center" | "end";
+export interface CompositionPadding {
+  top?: number;
+  right?: number;
+  bottom?: number;
+  left?: number;
+}
+export type CompositionProgramEntry =
+  | ChartProgram
+  | { id?: string; program: ChartProgram };
+export interface CompositionOptions {
+  id?: string;
+  programs: readonly CompositionProgramEntry[];
+  gap?: number;
+  align?: CompositionAlign;
+  padding?: number | CompositionPadding;
+}
+export interface EditCompositionLayoutOptions {
+  gap?: number;
+  align?: CompositionAlign;
+  padding?: number | CompositionPadding;
+}
+export interface ReplaceCompositionChildOptions {
+  target: string;
+  program: ChartProgram;
+}
+export type FacetScaleResolution = "shared" | "independent";
+export interface FacetScaleResolutions {
+  x?: FacetScaleResolution;
+  y?: FacetScaleResolution;
+  xOffset?: FacetScaleResolution;
+  yOffset?: FacetScaleResolution;
+  color?: FacetScaleResolution;
+  size?: FacetScaleResolution;
+  shape?: FacetScaleResolution;
+  opacity?: FacetScaleResolution;
+  strokeDash?: FacetScaleResolution;
+}
+export interface FacetGuideOptions {
+  axes?: "each" | "outer";
+  legend?: false | "shared";
+}
+export interface FacetOptions {
+  id?: string;
+  field: string;
+  data?: string;
+  columns?: number;
+  gap?: number;
+  align?: CompositionAlign;
+  padding?: number | CompositionPadding;
+  scales?: FacetScaleResolutions;
+  guides?: FacetGuideOptions;
+}
+export interface EditFacetHeadersOptions {
+  fontSize?: number;
+  fontFamily?: string;
+  fontWeight?: string | number;
+  color?: string;
+  offset?: number;
+}
+export interface ConcatCompositionSpec {
+  readonly id: string;
+  readonly direction: "horizontal" | "vertical";
+  readonly children: readonly string[];
+  readonly gap: number;
+  readonly align: CompositionAlign;
+  readonly padding: Readonly<Required<CompositionPadding>>;
+}
+export interface FacetCompositionSpec {
+  readonly id: string;
+  readonly type: "facet";
+  readonly children: readonly string[];
+  readonly columns: number;
+  readonly gap: number;
+  readonly align: CompositionAlign;
+  readonly padding: Readonly<Required<CompositionPadding>>;
+  readonly facet: {
+    readonly data: string;
+    readonly field: string;
+    readonly values: readonly DatasetScalar[];
+    readonly scales: Readonly<Required<FacetScaleResolutions>>;
+    readonly guides: {
+      readonly axes: "each" | "outer";
+      readonly legend: false | "shared";
+    };
+  };
+}
+export type CompositionSpec = ConcatCompositionSpec | FacetCompositionSpec;
 export type DensityKernel =
   | "gaussian"
   | "epanechnikov"
@@ -69,6 +157,96 @@ export type FilterDataOptions = {
   source?: string;
   field: string;
 } & FilterModeOptions;
+export type DatasetScalar = string | number | boolean | null;
+export type DatasetFilterTransform = {
+  type: "filter";
+  field: string;
+} & (
+  | { oneOf: readonly DatasetScalar[]; predicate?: never; range?: never }
+  | { oneOf?: never; predicate: FilterComparison; range?: never }
+  | { oneOf?: never; predicate?: never; range: FilterRange }
+);
+export type DatasetRegressionTransform = {
+  type: "regression";
+  x: string;
+  y: string;
+  groupBy?: string;
+} & (
+  | {
+      method: "linear";
+      confidence: number;
+      interval: "mean" | "prediction";
+      degree?: never;
+      span?: never;
+    }
+  | {
+      method: "polynomial";
+      degree: number;
+      confidence: number;
+      interval: "mean" | "prediction";
+      span?: never;
+    }
+  | {
+      method: "loess";
+      span: number;
+      degree?: never;
+      confidence?: never;
+      interval?: never;
+    }
+);
+export interface DatasetDensityTransform {
+  type: "density";
+  field: string;
+  groupBy?: string;
+  bandwidth: "auto" | number;
+  extent: "auto" | readonly [number, number];
+  steps: number;
+  kernel?: DensityKernel;
+  normalization?: DensityNormalization;
+  as: readonly [string, string];
+  resolve: "shared";
+  resolved?: {
+    readonly bandwidth: number;
+    readonly extent: readonly [number, number];
+  };
+}
+export interface DatasetIntervalOutputFields {
+  center: string;
+  lower: string;
+  upper: string;
+}
+export type DatasetIntervalTransform = {
+  type: "interval";
+  field: string;
+  groupBy: readonly string[];
+  as: DatasetIntervalOutputFields;
+} & (
+  | {
+      center: "mean";
+      extent: "stderr" | "stdev";
+      level?: never;
+    }
+  | {
+      center: "mean";
+      extent: "ci";
+      level: number;
+    }
+  | {
+      center: "median";
+      extent: "iqr";
+      level?: never;
+    }
+);
+export type DatasetTransform =
+  | DatasetFilterTransform
+  | DatasetRegressionTransform
+  | DatasetDensityTransform
+  | DatasetIntervalTransform;
+export interface CreateDerivedDataOptions {
+  id: string;
+  source: string;
+  transform: readonly [DatasetTransform, ...DatasetTransform[]];
+}
 export type MarkGraphicProperty =
   | "x" | "y" | "width" | "height" | "radius"
   | "x1" | "y1" | "x2" | "y2"
@@ -77,7 +255,7 @@ export type MarkSelector = {
   grain?: "item" | "stack";
 } & (
   | { field: string; channel?: never; property?: never }
-  | { channel: "x" | "y" | "x2" | "y2" | "xOffset" | "theta" | "radius" | "color" | "strokeDash" | "size" | "shape" | "group" | "opacity"; field?: never; property?: never }
+  | { channel: "x" | "y" | "x2" | "y2" | "xOffset" | "yOffset" | "theta" | "radius" | "color" | "strokeDash" | "size" | "shape" | "group" | "opacity"; field?: never; property?: never }
   | { property: MarkGraphicProperty; field?: never; channel?: never }
 ) & (
   | { op: "eq" | "neq" | "gt" | "gte" | "lt" | "lte"; value: unknown }
@@ -207,11 +385,44 @@ export interface TraceNode {
   readonly children: readonly TraceNode[];
 }
 
+export interface SemanticDataset {
+  readonly id: string;
+  readonly values?: readonly Readonly<Record<string, unknown>>[];
+  readonly source?: string;
+  readonly transform?: readonly Readonly<Record<string, unknown>>[];
+  readonly [key: string]: unknown;
+}
+
+export interface SemanticLayer {
+  readonly id: string;
+  readonly data?: string;
+  readonly source?: string;
+  readonly coordinate?: string;
+  readonly mark?: Readonly<{ type?: string; [key: string]: unknown }>;
+  readonly encoding?: Readonly<Record<string, Readonly<Record<string, unknown>>>>;
+  readonly [key: string]: unknown;
+}
+
+export interface SemanticScale {
+  readonly id: string;
+  readonly type?: ScaleType;
+  readonly domain?: "auto" | readonly unknown[];
+  readonly range?: ScaleRange;
+  readonly [key: string]: unknown;
+}
+
+export interface SemanticCoordinate {
+  readonly id: string;
+  readonly type?: "cartesian" | "polar";
+  readonly layers?: readonly string[];
+  readonly [key: string]: unknown;
+}
+
 export interface SemanticSpec {
-  readonly datasets: readonly Readonly<Record<string, unknown>>[];
-  readonly layers: readonly Readonly<Record<string, unknown>>[];
-  readonly scales: readonly Readonly<Record<string, unknown>>[];
-  readonly coordinates: readonly Readonly<Record<string, unknown>>[];
+  readonly datasets: readonly SemanticDataset[];
+  readonly layers: readonly SemanticLayer[];
+  readonly scales: readonly SemanticScale[];
+  readonly coordinates: readonly SemanticCoordinate[];
   readonly guides: Readonly<Record<string, unknown>>;
   readonly title: Readonly<Record<string, unknown>>;
 }
@@ -302,6 +513,8 @@ export interface CreateAxesOptions {
   };
   x?: false | CompleteAxisOptions<XAxisPosition>;
   y?: false | CompleteAxisOptions<YAxisPosition>;
+  theta?: false | CompletePolarAxisOptions;
+  radius?: false | CompleteRadialAxisOptions;
 }
 export interface AxisTickOptions<P extends string>
   extends AxisTickStyleOptions {
@@ -318,6 +531,58 @@ export interface AxisLabelOptions<P extends string>
   values?: readonly AxisValue[];
 }
 
+export interface PolarGuideResourceOptions {
+  scale?: string;
+  coordinate?: string;
+  angle?: number;
+}
+export interface PolarTickOptions extends AxisTickStyleOptions {
+  count?: number;
+  values?: readonly AxisValue[];
+}
+export interface PolarLabelOptions extends AxisLabelStyleOptions {
+  count?: number;
+  values?: readonly AxisValue[];
+}
+export interface PolarTicksAndLabelsOptions {
+  count?: number;
+  values?: readonly AxisValue[];
+  ticks?: AxisTickStyleOptions;
+  labels?: AxisLabelStyleOptions;
+}
+export interface PolarTitleOptions {
+  text?: string;
+  offset?: number;
+  color?: string;
+  fontSize?: number;
+  fontFamily?: string;
+  fontWeight?: string | number;
+}
+export interface RadialTitleOptions extends PolarTitleOptions {
+  position?: "inside" | "outside";
+}
+export interface CompletePolarAxisOptions extends PolarGuideResourceOptions {
+  line?: AxisLineStyleOptions;
+  ticksAndLabels?: PolarTicksAndLabelsOptions;
+  title?: false | PolarTitleOptions;
+}
+export interface CompleteRadialAxisOptions
+  extends Omit<CompletePolarAxisOptions, "title"> {
+  title?: false | RadialTitleOptions;
+}
+export interface EditPolarAxisOptions {
+  angle?: number;
+  line?: AxisLineStyleOptions;
+  ticks?: PolarTickOptions;
+  labels?: PolarLabelOptions;
+  ticksAndLabels?: PolarTicksAndLabelsOptions;
+  title?: PolarTitleOptions;
+}
+export interface EditRadialAxisOptions
+  extends Omit<EditPolarAxisOptions, "title"> {
+  title?: RadialTitleOptions;
+}
+
 export interface GridDirectionOptions {
   scale?: string;
   coordinate?: string;
@@ -334,9 +599,45 @@ export interface EditGridOptions {
   lineWidth?: number;
   strokeDash?: readonly number[];
 }
+export interface EditGridDirectionsOptions {
+  horizontal?: EditGridOptions;
+  vertical?: EditGridOptions;
+  theta?: EditPolarGridOptions;
+  radial?: EditPolarGridOptions;
+}
 export interface CreateGridOptions {
   horizontal?: boolean | GridDirectionOptions;
   vertical?: boolean | GridDirectionOptions;
+  theta?: boolean | PolarGridOptions;
+  radial?: boolean | PolarGridOptions;
+}
+export interface PolarGridOptions {
+  scale?: string;
+  coordinate?: string;
+  count?: number;
+  values?: readonly AxisValue[];
+  color?: string;
+  lineWidth?: number;
+  strokeDash?: readonly number[];
+}
+export interface EditPolarGridOptions {
+  count?: number;
+  values?: readonly AxisValue[];
+  color?: string;
+  lineWidth?: number;
+  strokeDash?: readonly number[];
+}
+
+export interface CreateGuidesOptions {
+  axes?: false | CreateAxesOptions;
+  grid?: false | CreateGridOptions;
+  legend?: false | LegendOptions;
+}
+
+export interface CreateCoordinateOptions {
+  id?: string;
+  type?: "cartesian" | "polar";
+  layers?: readonly string[];
 }
 
 export interface ScaleOptions {
@@ -360,6 +661,8 @@ export interface ScaleOptions {
   unknown?: unknown;
 }
 
+export type CreateScaleOptions = ScaleOptions & { id: string };
+
 export interface EditScaleOptions {
   id?: string;
   type?: ScaleType;
@@ -376,6 +679,7 @@ export interface EditScaleOptions {
   paddingOuter?: number;
   padding?: number;
   align?: number;
+  palette?: Palette;
   interpolate?: ContinuousColorInterpolation;
   unknown?: unknown;
 }
@@ -398,6 +702,54 @@ export interface PositionEncodingOptions {
   stack?: StackMode;
 }
 
+export interface ThetaScaleOptions {
+  id?: string;
+  type?: "linear" | "time" | "band" | "point";
+  domain?: "auto" | readonly unknown[];
+  range?: "auto" | readonly [number, number];
+  nice?: boolean;
+  zero?: boolean;
+  clamp?: boolean;
+  reverse?: boolean;
+  paddingInner?: number;
+  paddingOuter?: number;
+  padding?: number;
+  align?: number;
+  unknown?: unknown;
+}
+
+export interface RadiusScaleOptions {
+  id?: string;
+  type?: "linear" | "log" | "pow" | "sqrt" | "symlog";
+  domain?: "auto" | readonly [number, number];
+  range?: "auto" | readonly [number, number];
+  nice?: boolean;
+  zero?: boolean;
+  clamp?: boolean;
+  reverse?: boolean;
+  base?: number;
+  exponent?: number;
+  constant?: number;
+  unknown?: unknown;
+}
+
+export interface ThetaEncodingOptions {
+  field: string;
+  target?: string;
+  fieldType?: FieldType;
+  scale?: ThetaScaleOptions;
+  coordinate?: string;
+  aggregate?: "count";
+}
+
+export interface RadialEncodingOptions {
+  field: string;
+  target?: string;
+  fieldType?: "quantitative";
+  scale?: RadiusScaleOptions;
+  coordinate?: string;
+}
+
 type RulePositionValue =
   | { field: string; datum?: never }
   | { field?: never; datum: unknown };
@@ -415,7 +767,7 @@ export type SecondaryPositionEncodingOptions =
       field: string;
       datum?: never;
       target?: string;
-      fieldType?: "quantitative";
+      fieldType?: "quantitative" | "temporal";
       scale?: { id?: string };
       coordinate?: string;
     };
@@ -440,8 +792,9 @@ export type HistogramEncodingOptions = {
 export interface CategoricalEncodingOptions {
   field: string;
   target?: string;
-  fieldType?: "nominal";
+  fieldType?: "nominal" | "ordinal";
   scale?: ScaleOptions;
+  palette?: Palette;
   layout?: ColorLayout;
 }
 
@@ -528,6 +881,16 @@ export interface ErrorBarOptions {
   opacity?: number;
 }
 
+export interface EditErrorBarOptions {
+  target?: string;
+  caps?: boolean;
+  capSize?: number;
+  stroke?: string;
+  strokeWidth?: number;
+  strokeDash?: DashStyle | DashPattern;
+  opacity?: number;
+}
+
 export interface BoxPlotCategoryChannel {
   field: string;
   fieldType: "nominal" | "ordinal" | "temporal";
@@ -575,6 +938,28 @@ export interface BoxPlotOptions {
   };
 }
 
+export interface EditBoxPlotOptions {
+  target?: string;
+  whisker?: BoxPlotWhisker;
+  width?: { band?: number };
+  outliers?: boolean;
+  box?: {
+    fill?: string;
+    opacity?: number;
+    stroke?: string;
+    strokeWidth?: number;
+  };
+  median?: {
+    stroke?: string;
+    strokeWidth?: number;
+  };
+  outlier?: {
+    shape?: PointShape;
+    radius?: number;
+    opacity?: number;
+  };
+}
+
 export interface ErrorBandPositionChannel {
   field?: string;
   fieldType?: "quantitative" | "temporal";
@@ -620,6 +1005,23 @@ export interface ErrorBandOptions {
   };
 }
 
+export interface EditErrorBandOptions {
+  target?: string;
+  fill?: string;
+  opacity?: number;
+  curve?: CurveInterpolation;
+}
+
+export interface EditErrorBandBoundaryOptions {
+  target?: string;
+  boundary?: "both" | "lower" | "upper";
+  stroke?: string;
+  strokeWidth?: number;
+  strokeDash?: DashStyle | DashPattern;
+  opacity?: number;
+  curve?: CurveInterpolation;
+}
+
 export interface EditDensityOptions {
   target?: string;
   bandwidth?: "auto" | number;
@@ -636,15 +1038,61 @@ export interface OffsetScaleOptions {
   range?: "auto" | readonly [number, number];
 }
 
-export interface XOffsetEncodingOptions {
+export interface OffsetEncodingOptions {
   field: string;
   target?: string;
-  fieldType?: "nominal";
+  fieldType?: "nominal" | "ordinal";
   scale?: OffsetScaleOptions;
   paddingInner?: number;
   paddingOuter?: number;
 }
 
+export interface XOffsetEncodingOptions extends OffsetEncodingOptions {}
+export interface YOffsetEncodingOptions extends OffsetEncodingOptions {}
+
+export type TextFormat = "auto" | `.${number}f`;
+
+export interface TextMarkOptions {
+  id?: string;
+  data?: string;
+  text?: unknown;
+  fill?: string;
+  opacity?: number;
+  fontSize?: number;
+  fontFamily?: string;
+  fontWeight?: string | number;
+  align?: "left" | "right" | "center" | "start" | "end";
+  baseline?: "top" | "hanging" | "middle" | "alphabetic" | "ideographic" | "bottom";
+  rotation?: number;
+  dx?: number;
+  dy?: number;
+}
+
+export interface EditTextMarkOptions extends Omit<TextMarkOptions, "id" | "data" | "text"> {
+  target?: string;
+}
+
+export interface RectMarkOptions {
+  id?: string;
+  data?: string;
+  fill?: string;
+  opacity?: number;
+  stroke?: string | false;
+  strokeWidth?: number;
+}
+
+export interface EditRectMarkOptions extends Omit<RectMarkOptions, "id" | "data"> {
+  target?: string;
+}
+
+export type TextEncodingOptions = {
+  target?: string;
+  format?: TextFormat;
+} & (
+  | { field: string; value?: never }
+  | { field?: never; value: unknown }
+);
+
 export type BarWidthOptions = { target?: string } & (
   | { band?: number; pixels?: never }
   | { band?: never; pixels: number }
@@ -722,6 +1170,7 @@ export type ColorEncodingOptions =
       fieldType: "quantitative";
       aggregate?: AggregateOperation;
       scale?: ContinuousColorScaleOptions | DiscretizedColorScaleOptions;
+      palette?: Palette;
       layout?: never;
     }
   | {
@@ -730,6 +1179,7 @@ export type ColorEncodingOptions =
       fieldType: "temporal";
       aggregate?: never;
       scale?: ContinuousColorScaleOptions;
+      palette?: Palette;
       layout?: never;
     };
 
@@ -765,6 +1215,37 @@ export interface RegressionBandOptions {
   curve?: CurveInterpolation;
 }
 
+export interface CreateRegressionBandOptions {
+  id: string;
+  data: string;
+  x: string;
+  lower: string;
+  upper: string;
+  groupBy?: string;
+  coordinate: string;
+  xScale: string;
+  yScale: string;
+  color?: string;
+  opacity?: number;
+  stroke?: string;
+  strokeWidth?: number;
+  curve?: CurveInterpolation;
+}
+
+export interface CreateRegressionLineOptions {
+  id: string;
+  data: string;
+  x: string;
+  y: string;
+  groupBy?: string;
+  coordinate: string;
+  xScale: string;
+  yScale: string;
+  colorScale?: string;
+  strokeWidth?: number;
+  curve?: CurveInterpolation;
+}
+
 type RegressionParameterOptions =
   | {
       method?: "linear";
@@ -816,6 +1297,37 @@ export type RegressionOptions = RegressionCommonOptions & (
     })
 );
 
+export interface EditRegressionOptions {
+  target?: string;
+  method?: RegressionMethod;
+  degree?: number;
+  span?: number;
+  confidence?: number;
+  interval?: RegressionInterval;
+  band?: false | RegressionBandOptions;
+  line?: { strokeWidth?: number; curve?: CurveInterpolation };
+}
+
+export interface RemoveAxisOptions {
+  coordinate?: string;
+  scale?: string;
+}
+
+export interface RemoveGridOptions {
+  horizontal?: boolean;
+  vertical?: boolean;
+  theta?: boolean;
+  radial?: boolean;
+}
+
+export interface RemoveLegendOptions {
+  target?: string;
+}
+
+export interface RemoveMarkOptions {
+  target?: string;
+}
+
 export interface LegendTextOptions {
   offset?: number;
   color?: string;
@@ -864,7 +1376,7 @@ export interface LegendBorderOptions {
 
 export interface LegendOptions {
   target?: string;
-  channels?: readonly ("color" | "strokeDash" | "shape" | "opacity")[];
+  channels?: readonly ("color" | "strokeDash" | "shape" | "size" | "opacity")[];
   position?: "right" | "left" | "bottom" | "top";
   align?: "left" | "center" | "right";
   direction?: "horizontal" | "vertical";
@@ -886,6 +1398,47 @@ export interface EditLegendOptions
   title?: string | "auto" | false;
 }
 
+export interface EditLegendLayoutOptions {
+  target?: string;
+  position?: "right" | "left" | "bottom" | "top";
+  align?: "left" | "center" | "right";
+  direction?: "horizontal" | "vertical";
+  columns?: number;
+  offset?: number;
+  titlePosition?: "top" | "left";
+  itemGap?: number;
+}
+
+export interface EditLegendLabelsOptions extends LegendTitleStyleOptions {
+  target?: string;
+}
+
+export interface EditLegendTitleOptions extends LegendTitleStyleOptions {
+  target?: string;
+  title?: string | "auto" | false;
+}
+
+export interface EditLegendSymbolsOptions {
+  target?: string;
+  symbol?: LegendSymbolRecipe;
+  count?: number;
+  gradient?: { length?: number; thickness?: number };
+}
+
+export interface EditLegendBorderOptions {
+  target?: string;
+  border: boolean | LegendBorderOptions;
+}
+
+export interface EditAxisOptions<P extends string> {
+  position?: P;
+  line?: AxisLineStyleOptions;
+  ticks?: Omit<AxisTickOptions<P>, "scale" | "position">;
+  labels?: Omit<AxisLabelOptions<P>, "scale" | "position">;
+  ticksAndLabels?: Omit<AxisTicksAndLabelsOptions<P>, "scale" | "position">;
+  title?: Omit<AxisTitleOptions<P>, "scale" | "position">;
+}
+
 export interface TitleTextStyleOptions {
   color?: string;
   fontSize?: number;
@@ -919,6 +1472,8 @@ export class ChartProgram {
   readonly graphicSpec: GraphicSpec;
   readonly resolvedScales: Readonly<Record<string, Readonly<Record<string, unknown>>>>;
   readonly materializationConfigs: Readonly<Record<string, unknown>>;
+  readonly children: Readonly<Record<string, ChartProgram>>;
+  readonly compositionSpec?: CompositionSpec;
   readonly context: Readonly<Record<string, unknown>>;
   readonly trace: TraceNode;
   readonly actionStack: readonly unknown[];
@@ -934,7 +1489,15 @@ export class ChartProgram {
   createRegressionData(options: RegressionDataOptions): ChartProgram;
   createIntervalData(options: IntervalDataOptions): ChartProgram;
 
-  createPointMark(options?: { id?: string; data?: string; shape?: PointShape }): ChartProgram;
+  createPointMark(options?: {
+    id?: string;
+    data?: string;
+    shape?: PointShape;
+    fill?: string;
+    opacity?: number;
+    stroke?: string;
+    strokeWidth?: number;
+  }): ChartProgram;
   editPointMark(options: {
     target?: string;
     shape?: PointShape;
@@ -948,13 +1511,26 @@ export class ChartProgram {
     data?: string;
     strokeWidth?: number;
     curve?: CurveInterpolation;
+    stroke?: string;
+    opacity?: number;
+    closed?: boolean;
   }): ChartProgram;
   editLineMark(options: {
     target?: string;
     strokeWidth?: number;
     curve?: CurveInterpolation;
+    stroke?: string;
+    opacity?: number;
+    closed?: boolean;
+  }): ChartProgram;
+  createBarMark(options?: {
+    id?: string;
+    data?: string;
+    fill?: string;
+    opacity?: number;
+    stroke?: string;
+    strokeWidth?: number;
   }): ChartProgram;
-  createBarMark(options?: { id?: string; data?: string }): ChartProgram;
   editBarMark(options: {
     target?: string;
     fill?: string;
@@ -971,7 +1547,30 @@ export class ChartProgram {
     strokeWidth?: number;
     curve?: CurveInterpolation;
   }): ChartProgram;
+  createArcMark(options?: {
+    id?: string;
+    data?: string;
+    innerRadius?: number;
+    padAngle?: number;
+    fill?: string;
+    opacity?: number;
+    stroke?: string;
+    strokeWidth?: number;
+  }): ChartProgram;
+  editArcMark(options: {
+    target?: string;
+    innerRadius?: number;
+    padAngle?: number;
+    fill?: string;
+    opacity?: number;
+    stroke?: string;
+    strokeWidth?: number;
+  }): ChartProgram;
+  createRectMark(options?: RectMarkOptions): ChartProgram;
+  editRectMark(options: EditRectMarkOptions): ChartProgram;
   createRuleMark(options?: { id?: string; data?: string }): ChartProgram;
+  createTextMark(options?: TextMarkOptions): ChartProgram;
+  editTextMark(options: EditTextMarkOptions): ChartProgram;
   editAreaMark(options: {
     target?: string;
     fill?: string;
@@ -983,6 +1582,8 @@ export class ChartProgram {
 
   encodeX(options: PositionEncodingOptions | RulePositionEncodingOptions): ChartProgram;
   encodeY(options: PositionEncodingOptions | RulePositionEncodingOptions): ChartProgram;
+  encodeTheta(options: ThetaEncodingOptions): ChartProgram;
+  encodeR(options: RadialEncodingOptions): ChartProgram;
   encodeX2(options: SecondaryPositionEncodingOptions): ChartProgram;
   encodeColor(options: ColorEncodingOptions): ChartProgram;
   encodeStrokeDash(options: StrokeDashEncodingOptions): ChartProgram;
@@ -990,7 +1591,9 @@ export class ChartProgram {
   encodeShape(options: { field: string; target?: string; fieldType?: "nominal"; scale?: ScaleOptions }): ChartProgram;
   encodeOpacity(options: OpacityEncodingOptions): ChartProgram;
   encodeRadius(options: { value: number; target?: string }): ChartProgram;
+  encodePointRadius(options: { value: number; target?: string }): ChartProgram;
   encodeXOffset(options: XOffsetEncodingOptions): ChartProgram;
+  encodeYOffset(options: YOffsetEncodingOptions): ChartProgram;
   encodeY2(options: SecondaryPositionEncodingOptions): ChartProgram;
   encodeYRange(options: {
     lower: string;
@@ -1009,6 +1612,7 @@ export class ChartProgram {
     scale?: ScaleOptions;
   }): ChartProgram;
   encodeGroup(options: { field: string; target?: string; fieldType?: "nominal" }): ChartProgram;
+  encodeText(options: TextEncodingOptions): ChartProgram;
   encodeHistogram(options: HistogramEncodingOptions): ChartProgram;
   encodeDensity(options: DensityEncodingOptions): ChartProgram;
   editDensity(options: EditDensityOptions): ChartProgram;
@@ -1017,12 +1621,28 @@ export class ChartProgram {
   encodeStrokeWidth(options: { target?: string; value: number }): ChartProgram;
 
   createRegression(options?: RegressionOptions): ChartProgram;
+  editRegression(options: EditRegressionOptions): ChartProgram;
   createErrorBar(options?: ErrorBarOptions): ChartProgram;
+  editErrorBar(options: EditErrorBarOptions): ChartProgram;
   createErrorBand(options?: ErrorBandOptions): ChartProgram;
+  editErrorBand(options: EditErrorBandOptions): ChartProgram;
+  editErrorBandBoundary(options: EditErrorBandBoundaryOptions): ChartProgram;
   createBoxPlot(options?: BoxPlotOptions): ChartProgram;
+  editBoxPlot(options: EditBoxPlotOptions): ChartProgram;
+  removeMark(options?: RemoveMarkOptions): ChartProgram;
   createAxes(options?: CreateAxesOptions): ChartProgram;
   createXAxis(options?: CompleteAxisOptions<XAxisPosition>): ChartProgram;
   createYAxis(options?: CompleteAxisOptions<YAxisPosition>): ChartProgram;
+  createThetaAxis(options?: CompletePolarAxisOptions): ChartProgram;
+  createRadialAxis(options?: CompleteRadialAxisOptions): ChartProgram;
+  editThetaAxisLine(options?: AxisLineStyleOptions): ChartProgram;
+  editRadialAxisLine(options?: AxisLineStyleOptions): ChartProgram;
+  editThetaAxisTicks(options?: PolarTickOptions): ChartProgram;
+  editRadialAxisTicks(options?: PolarTickOptions): ChartProgram;
+  editThetaAxisLabels(options?: PolarLabelOptions): ChartProgram;
+  editRadialAxisLabels(options?: PolarLabelOptions): ChartProgram;
+  editThetaAxisTitle(options?: PolarTitleOptions): ChartProgram;
+  editRadialAxisTitle(options?: RadialTitleOptions): ChartProgram;
   createXAxisLine(options?: AxisLineStyleOptions & { scale?: string; position?: XAxisPosition }): ChartProgram;
   createYAxisLine(options?: AxisLineStyleOptions & { scale?: string; position?: YAxisPosition }): ChartProgram;
   editXAxisLine(options?: AxisLineStyleOptions & { position?: XAxisPosition }): ChartProgram;
@@ -1043,27 +1663,43 @@ export class ChartProgram {
   createYAxisTitle(options?: AxisTitleOptions<YAxisPosition>): ChartProgram;
   editXAxisTitle(options?: Omit<AxisTitleOptions<XAxisPosition>, "scale">): ChartProgram;
   editYAxisTitle(options?: Omit<AxisTitleOptions<YAxisPosition>, "scale">): ChartProgram;
+  editXAxis(options: EditAxisOptions<XAxisPosition>): ChartProgram;
+  editYAxis(options: EditAxisOptions<YAxisPosition>): ChartProgram;
+  editThetaAxis(options: Omit<EditPolarAxisOptions, "angle">): ChartProgram;
+  editRadialAxis(options: EditRadialAxisOptions): ChartProgram;
+  removeXAxis(options?: RemoveAxisOptions): ChartProgram;
+  removeYAxis(options?: RemoveAxisOptions): ChartProgram;
+  removeThetaAxis(options?: RemoveAxisOptions): ChartProgram;
+  removeRadialAxis(options?: RemoveAxisOptions): ChartProgram;
   createGrid(options?: CreateGridOptions): ChartProgram;
   createHorizontalGrid(options?: GridDirectionOptions): ChartProgram;
   createVerticalGrid(options?: GridDirectionOptions): ChartProgram;
+  createThetaGrid(options?: PolarGridOptions): ChartProgram;
+  createRadialGrid(options?: PolarGridOptions): ChartProgram;
   editHorizontalGrid(options: EditGridOptions): ChartProgram;
   editVerticalGrid(options: EditGridOptions): ChartProgram;
+  editThetaGrid(options: EditPolarGridOptions): ChartProgram;
+  editRadialGrid(options: EditPolarGridOptions): ChartProgram;
+  editGrid(options: EditGridDirectionsOptions): ChartProgram;
+  removeGrid(options?: RemoveGridOptions): ChartProgram;
   createLegend(options?: LegendOptions): ChartProgram;
   editLegend(options: EditLegendOptions): ChartProgram;
-  createGuides(options?: ActionOptions): ChartProgram;
+  editLegendLayout(options: EditLegendLayoutOptions): ChartProgram;
+  editLegendLabels(options: EditLegendLabelsOptions): ChartProgram;
+  editLegendTitle(options: EditLegendTitleOptions): ChartProgram;
+  editLegendSymbols(options: EditLegendSymbolsOptions): ChartProgram;
+  editLegendBorder(options: EditLegendBorderOptions): ChartProgram;
+  removeLegend(options?: RemoveLegendOptions): ChartProgram;
+  createGuides(options?: CreateGuidesOptions): ChartProgram;
   createTitle(options: TitleOptions): ChartProgram;
   editTitle(options: EditTitleOptions): ChartProgram;
+  removeTitle(): ChartProgram;
 
-  createCoordinate(options?: ActionOptions): ChartProgram;
-  createScale(options: ActionOptions & { id: string }): ChartProgram;
+  createCoordinate(options?: CreateCoordinateOptions): ChartProgram;
+  createScale(options: CreateScaleOptions): ChartProgram;
   editScale(options: EditScaleOptions): ChartProgram;
-  createDerivedData(options: ActionOptions): ChartProgram;
-  createRegressionBand(options: ActionOptions & {
-    id: string;
-    stroke?: string;
-    strokeWidth?: number;
-    curve?: CurveInterpolation;
-  }): ChartProgram;
+  createDerivedData(options: CreateDerivedDataOptions): ChartProgram;
+  createRegressionBand(options: CreateRegressionBandOptions): ChartProgram;
   editRegressionBand(options: {
     target?: string;
     color?: string;
@@ -1072,17 +1708,18 @@ export class ChartProgram {
     strokeWidth?: number;
     curve?: CurveInterpolation;
   }): ChartProgram;
-  createRegressionLine(options: ActionOptions & {
-    id: string;
-    strokeWidth?: number;
-    curve?: CurveInterpolation;
-  }): ChartProgram;
+  createRegressionLine(options: CreateRegressionLineOptions): ChartProgram;
   editRegressionLine(options: {
     target?: string;
     strokeWidth?: number;
     curve?: CurveInterpolation;
   }): ChartProgram;
 
+  editCompositionLayout(options: EditCompositionLayoutOptions): ChartProgram;
+  replaceCompositionChild(options: ReplaceCompositionChildOptions): ChartProgram;
+  facet(options: FacetOptions): ChartProgram;
+  editFacetHeaders(options: EditFacetHeadersOptions): ChartProgram;
+
   editSemantic(options: EditSemanticOptions): ChartProgram;
   createGraphics(options: {
     id: string;