ggaction 0.0.9 → 0.0.11

package/types/program.d.ts

@@ -1,3 +1,5 @@
+import type { RegisteredExtensionActions } from "./extension.js";
+
 export type FieldType = "quantitative" | "temporal" | "ordinal" | "nominal";
 export type GraphicType =
   | "canvas"
@@ -197,7 +199,7 @@ export interface CategoryDensityPlacement {
   side?: DensityPlacementSide;
   width?: DensityPlacementWidth;
   split?: DensityPlacementSplit;
-  scale?: ScaleOptions;
+  scale?: NonPointBandPositionScaleOptions;
 }
 export type DensityPlacement =
   | BaselineDensityPlacement
@@ -705,10 +707,11 @@ export interface CanvasOptions {
 
 export type XAxisPosition = "bottom" | "top";
 export type YAxisPosition = "left" | "right";
+type TimeAxisDirective = "Y" | "m" | "d" | "b";
 export type AxisFormatString =
   | ".0f" | ".1f" | ".2f"
   | ".0%" | ".1%" | ".2e"
-  | "%Y" | "%Y-%m" | "%Y-%m-%d";
+  | `${string}%${TimeAxisDirective}${string}`;
 export type AxisFormat =
   | "auto"
   | AxisFormatString
@@ -885,6 +888,33 @@ export interface CreateGuidesOptions {
   legend?: false | LegendOptions;
 }
 
+type CartesianAxesOptions = Omit<
+  CreateAxesOptions,
+  "coordinate" | "theta" | "radius"
+> & {
+  coordinate?: { id?: string; type?: "auto" | "cartesian" };
+};
+type CartesianGridOptions = Pick<CreateGridOptions, "horizontal" | "vertical">;
+type CartesianGuideOptions = {
+  axes?: false | CartesianAxesOptions;
+  grid?: false | CartesianGridOptions;
+  legend?: false | LegendOptions;
+};
+type GradientPlotDensityLegendOptions = {
+  title?: string;
+  position?: "right";
+};
+type GradientPlotGuideOptions = Omit<CartesianGuideOptions, "legend"> & {
+  legend?: false | GradientPlotDensityLegendOptions;
+};
+type ParallelGuideOptions = {
+  axes?: false | {
+    coordinate?: { id?: string; type?: "auto" | "parallel" };
+  };
+  grid?: false;
+  legend?: false | LegendOptions;
+};
+
 export interface CreateCoordinateOptions {
   id?: string;
   type?: "cartesian" | "polar" | "parallel";
@@ -912,6 +942,79 @@ export interface ScaleOptions {
   unknown?: unknown;
 }
 
+export type QuantitativePositionScaleType =
+  | "linear" | "log" | "pow" | "sqrt" | "symlog";
+type ScaleFields<Keys extends keyof ScaleOptions> = Pick<ScaleOptions, Keys>;
+export type NonPointQuantitativePositionScaleOptions = ScaleFields<
+  "id" | "nice" | "zero" | "clamp" | "reverse" |
+  "base" | "exponent" | "constant"
+> & {
+  type?: QuantitativePositionScaleType;
+  domain?: "auto" | readonly [number, number];
+  range?: "auto" | readonly [number, number];
+};
+export type QuantitativePositionScaleOptions =
+  NonPointQuantitativePositionScaleOptions & { unknown?: number };
+export type ZeroSupportingPositionScaleType =
+  | "linear" | "pow" | "sqrt" | "symlog";
+export type NonPointZeroSupportingPositionScaleOptions = Omit<
+  NonPointQuantitativePositionScaleOptions,
+  "base" | "type"
+> & { type?: ZeroSupportingPositionScaleType };
+export type NonPointTemporalPositionScaleOptions = ScaleFields<
+  "id" | "nice" | "clamp" | "reverse"
+> & {
+  type?: "time";
+  domain?: "auto" | readonly [number, number];
+  range?: "auto" | readonly [number, number];
+};
+export type TemporalPositionScaleOptions =
+  NonPointTemporalPositionScaleOptions & { unknown?: number };
+export type NonPointBandPositionScaleOptions = ScaleFields<
+  "id" | "reverse" | "paddingInner" | "paddingOuter" | "align"
+> & {
+  type?: "band";
+  domain?: "auto" | readonly unknown[];
+  range?: "auto" | readonly [number, number];
+};
+export type BandPositionScaleOptions =
+  NonPointBandPositionScaleOptions & { unknown?: number };
+export type NonPointPointPositionScaleOptions = ScaleFields<
+  "id" | "reverse" | "padding" | "align"
+> & {
+  type?: "point";
+  domain?: "auto" | readonly unknown[];
+  range?: "auto" | readonly [number, number];
+};
+export type PointPositionScaleOptions =
+  NonPointPointPositionScaleOptions & { unknown?: number };
+export type CategoricalPositionScaleOptions =
+  | BandPositionScaleOptions
+  | PointPositionScaleOptions;
+export type NonPointCategoricalPositionScaleOptions =
+  | NonPointBandPositionScaleOptions
+  | NonPointPointPositionScaleOptions;
+type WithoutScaleId<T> = T extends unknown ? Omit<T, "id"> : never;
+export type NonPointCategoricalColorScaleOptions = ScaleFields<"id" | "palette"> & {
+  type?: "ordinal";
+  domain?: "auto" | readonly unknown[];
+  range?: "auto" | readonly string[] | { readonly palette: Palette };
+};
+export type CategoricalColorScaleOptions =
+  NonPointCategoricalColorScaleOptions & { unknown?: string };
+export type SizeScaleOptions = ScaleFields<"id"> & {
+  type?: "linear";
+  domain?: "auto" | readonly [number, number];
+  range?: "auto" | readonly [number, number];
+  unknown?: number;
+};
+export type ShapeScaleOptions = ScaleFields<"id"> & {
+  type?: "ordinal";
+  domain?: "auto" | readonly unknown[];
+  range?: "auto" | readonly PointShape[];
+  unknown?: PointShape;
+};
+
 export type CreateScaleOptions = ScaleOptions & { id: string };
 
 export interface EditScaleOptions {
@@ -935,13 +1038,10 @@ export interface EditScaleOptions {
   unknown?: unknown;
 }
 
-export interface PositionEncodingOptions {
+interface PositionEncodingBase {
   field: string;
   target?: string;
-  fieldType?: FieldType;
-  scale?: ScaleOptions;
   coordinate?: string;
-  aggregate?: AggregateOperation;
   bin?:
     | { maxBins?: number; step?: never; boundaries?: never }
     | { maxBins?: never; step: number; boundaries?: never }
@@ -953,8 +1053,38 @@ export interface PositionEncodingOptions {
   stack?: StackMode;
 }
 
+type PositionScaleBranches<Quantitative, Temporal, Categorical> =
+  | {
+      fieldType?: "quantitative";
+      aggregate?: never;
+      scale?: Quantitative;
+    }
+  | {
+      fieldType: "temporal";
+      aggregate?: never;
+      scale?: Temporal;
+    }
+  | {
+      fieldType: "nominal" | "ordinal";
+      aggregate?: never;
+      scale?: Categorical;
+    }
+  | {
+      fieldType?: FieldType;
+      aggregate: AggregateOperation;
+      scale?: Quantitative;
+    };
+
+export type PositionEncodingOptions = PositionEncodingBase & PositionScaleBranches<
+  QuantitativePositionScaleOptions,
+  TemporalPositionScaleOptions,
+  CategoricalPositionScaleOptions
+>;
+
 export type YPositionEncodingOptions =
-  Omit<PositionEncodingOptions, "stack"> & { stack?: YStackMode };
+  PositionEncodingOptions extends infer T
+    ? T extends unknown ? Omit<T, "bin" | "stack"> & { stack?: YStackMode } : never
+    : never;
 
 export interface ThetaScaleOptions {
   id?: string;
@@ -969,7 +1099,6 @@ export interface ThetaScaleOptions {
   paddingOuter?: number;
   padding?: number;
   align?: number;
-  unknown?: unknown;
 }
 
 export interface RadiusScaleOptions {
@@ -984,7 +1113,6 @@ export interface RadiusScaleOptions {
   base?: number;
   exponent?: number;
   constant?: number;
-  unknown?: unknown;
 }
 
 export interface ThetaEncodingOptions {
@@ -1009,15 +1137,46 @@ type RulePositionValue =
   | { field: string; datum?: never }
   | { field?: never; datum: unknown };
 
-export type RulePositionEncodingOptions = RulePositionValue & {
+type RulePositionEncodingBase = RulePositionValue & {
+  target?: string;
+  coordinate?: string;
+};
+
+type InferredRuleDatumPositionEncodingOptions = {
+  field?: never;
+  datum: unknown;
   target?: string;
-  fieldType: FieldType;
-  scale?: ScaleOptions;
   coordinate?: string;
+  fieldType?: undefined;
+  scale?:
+    | NonPointQuantitativePositionScaleOptions
+    | NonPointCategoricalPositionScaleOptions;
+};
+
+export type RulePositionEncodingOptions =
+  | InferredRuleDatumPositionEncodingOptions
+  | RulePositionEncodingBase & (
+    | {
+        fieldType: "quantitative";
+        scale?: NonPointQuantitativePositionScaleOptions;
+      }
+    | {
+        fieldType: "temporal";
+        scale?: NonPointTemporalPositionScaleOptions;
+      }
+    | {
+        fieldType: "nominal" | "ordinal";
+        scale?: NonPointCategoricalPositionScaleOptions;
+      }
+    );
+
+type SecondaryRulePositionEncodingOptions = RulePositionEncodingBase & {
+  fieldType: FieldType;
+  scale?: { id?: string };
 };
 
 export type SecondaryPositionEncodingOptions =
-  | RulePositionEncodingOptions
+  | SecondaryRulePositionEncodingOptions
   | {
       field: string;
       datum?: never;
@@ -1032,8 +1191,8 @@ export type HistogramEncodingOptions = {
   target?: string;
   coordinate?: string;
   stack?: StackMode;
-  xScale?: ScaleOptions;
-  yScale?: ScaleOptions;
+  xScale?: NonPointQuantitativePositionScaleOptions;
+  yScale?: NonPointZeroSupportingPositionScaleOptions;
 } & (
   | { maxBins?: number; binStep?: never; binBoundaries?: never }
   | { maxBins?: never; binStep: number; binBoundaries?: never }
@@ -1048,7 +1207,7 @@ export interface CategoricalEncodingOptions {
   field: string;
   target?: string;
   fieldType?: "nominal" | "ordinal";
-  scale?: ScaleOptions;
+  scale?: CategoricalColorScaleOptions;
   palette?: Palette;
   layout?: ColorLayout;
 }
@@ -1070,13 +1229,13 @@ type DensityEncodingBase = Omit<DensityDataOptions, "id"> & {
   target?: string;
   densityChannel?: "x" | "y";
   coordinate?: string;
-  valueScale?: ScaleOptions;
+  valueScale?: NonPointQuantitativePositionScaleOptions;
 };
 
 export type DensityEncodingOptions = DensityEncodingBase & (
   | {
       placement?: BaselineDensityPlacement;
-      densityScale?: ScaleOptions;
+      densityScale?: NonPointZeroSupportingPositionScaleOptions;
     }
   | {
       placement: CategoryDensityPlacement;
@@ -1084,16 +1243,33 @@ export type DensityEncodingOptions = DensityEncodingBase & (
     }
 );
 
-export interface HorizonXEncoding {
-  field: string;
-  fieldType?: "quantitative" | "temporal";
-  scale?: ScaleOptions;
-}
+export type HorizonXEncoding = { field: string } & (
+  | {
+      fieldType: "quantitative";
+      scale?: NonPointQuantitativePositionScaleOptions;
+    }
+  | {
+      fieldType: "temporal";
+      scale?: NonPointTemporalPositionScaleOptions;
+    }
+  | {
+      fieldType?: undefined;
+      scale?:
+        | NonPointQuantitativePositionScaleOptions
+        | NonPointTemporalPositionScaleOptions;
+    }
+);
+
+export type HorizonYScaleOptions = ScaleFields<"id" | "clamp" | "reverse"> & {
+  type?: "linear";
+  domain?: readonly [0, 1];
+  range?: "auto" | readonly [number, number];
+};
 
 export interface HorizonYEncoding {
   field: string;
   fieldType?: "quantitative";
-  scale?: ScaleOptions;
+  scale?: HorizonYScaleOptions;
 }
 
 export interface HorizonPaletteOptions {
@@ -1181,25 +1357,30 @@ export interface EditBin2DDataOptions {
   as?: DatasetBin2DOutputFields;
 }
 
-export interface ErrorBarPositionChannel {
-  field?: string;
-  fieldType?: "nominal" | "ordinal" | "temporal";
-  scale?: ScaleOptions;
-}
+export type ErrorBarPositionChannel = { field?: string } & (
+  | {
+      fieldType?: "nominal" | "ordinal";
+      scale?: NonPointCategoricalPositionScaleOptions;
+    }
+  | {
+      fieldType: "temporal";
+      scale?: NonPointTemporalPositionScaleOptions;
+    }
+);
 
 export interface ErrorBarStatisticalIntervalChannel {
   field?: string;
   center?: IntervalCenter;
   extent?: IntervalExtent;
   level?: number;
-  scale?: ScaleOptions;
+  scale?: NonPointQuantitativePositionScaleOptions;
 }
 
 export interface ErrorBarExplicitIntervalChannel {
   center: string;
   lower: string;
   upper: string;
-  scale?: ScaleOptions;
+  scale?: NonPointQuantitativePositionScaleOptions;
 }
 
 export type ErrorBarIntervalChannel =
@@ -1239,14 +1420,14 @@ export interface EditErrorBarOptions {
 
 export interface BoxPlotCategoryChannel {
   field: string;
-  fieldType: "nominal" | "ordinal" | "temporal";
-  scale?: ScaleOptions;
+  fieldType: "nominal" | "ordinal";
+  scale?: NonPointBandPositionScaleOptions;
 }
 
 export interface BoxPlotMeasureChannel {
   field: string;
   fieldType?: "quantitative";
-  scale?: ScaleOptions;
+  scale?: NonPointQuantitativePositionScaleOptions;
 }
 
 export type BoxPlotPositionChannel =
@@ -1282,7 +1463,7 @@ export interface BoxPlotOptions {
     radius?: number;
     opacity?: number;
   };
-  guides?: false | CreateGuidesOptions;
+  guides?: false | CartesianGuideOptions;
 }
 
 export interface EditBoxPlotOptions {
@@ -1342,12 +1523,28 @@ export interface GradientPlotOptions {
   width?: { band?: number };
   gradient?: GradientPlotAppearanceOptions;
   center?: false | GradientPlotCenterOptions;
-  guides?: false | CreateGuidesOptions;
+  guides?: false | GradientPlotGuideOptions;
 }
 
 export type ViolinPlotPositionChannel =
   | string
-  | BoxPlotPositionChannel;
+  | {
+      field: string;
+      fieldType: "nominal" | "ordinal";
+      scale?: NonPointBandPositionScaleOptions;
+    }
+  | {
+      field: string;
+      fieldType: "quantitative";
+      scale?: NonPointQuantitativePositionScaleOptions;
+    }
+  | {
+      field: string;
+      fieldType?: undefined;
+      scale?:
+        | NonPointBandPositionScaleOptions
+        | NonPointQuantitativePositionScaleOptions;
+    };
 
 export interface ViolinPlotDensityOptions
   extends GradientPlotDensityOptions {
@@ -1361,7 +1558,13 @@ export interface ViolinPlotSplitOptions {
 
 export type ViolinPlotColorOptions =
   | string
-  | Omit<CategoricalEncodingOptions, "target">;
+  | {
+      field: string;
+      fieldType?: "nominal" | "ordinal";
+      scale?: NonPointCategoricalColorScaleOptions;
+      palette?: Palette;
+      layout?: "overlay";
+    };
 
 export interface ViolinPlotAreaOptions {
   fill?: string;
@@ -1381,7 +1584,7 @@ export interface ViolinPlotOptions {
   color?: ViolinPlotColorOptions;
   density?: ViolinPlotDensityOptions;
   area?: ViolinPlotAreaOptions;
-  guides?: false | CreateGuidesOptions;
+  guides?: false | CartesianGuideOptions;
 }
 
 export interface EditGradientPlotOptions {
@@ -1395,23 +1598,169 @@ export interface EditGradientPlotOptions {
   center?: false | GradientPlotCenterOptions;
 }
 
-type BasicPositionChannel =
+type FacadePositionChannel<Quantitative, Temporal, Categorical> =
+  | string
+  | (Omit<PositionEncodingBase, "target" | "coordinate"> &
+      PositionScaleBranches<Quantitative, Temporal, Categorical>);
+type PointFacadePositionChannel =
+  | string
+  | ({ field: string } & (
+      | {
+          fieldType?: "quantitative";
+          scale?: QuantitativePositionScaleOptions;
+        }
+      | {
+          fieldType: "temporal";
+          scale?: TemporalPositionScaleOptions;
+        }
+      | {
+          fieldType: "nominal" | "ordinal";
+          scale?: CategoricalPositionScaleOptions;
+        }
+    ));
+type LineXPositionChannel =
+  | string
+  | ({ field: string; bin?: PositionEncodingBase["bin"] } & (
+      | {
+          fieldType?: "quantitative";
+          scale?: NonPointQuantitativePositionScaleOptions;
+        }
+      | {
+          fieldType: "temporal";
+          scale?: NonPointTemporalPositionScaleOptions;
+        }
+    ));
+type LineYPositionChannel =
   | string
-  | Omit<PositionEncodingOptions, "target" | "coordinate">;
+  | ({ field: string } & (
+      | {
+          fieldType?: "quantitative";
+          aggregate?: AggregateOperation;
+          scale?: NonPointQuantitativePositionScaleOptions;
+        }
+      | {
+          fieldType: "temporal";
+          aggregate?: never;
+          scale?: NonPointTemporalPositionScaleOptions;
+        }
+    ));
+type BandPositionChannel = FacadePositionChannel<
+  NonPointZeroSupportingPositionScaleOptions,
+  NonPointTemporalPositionScaleOptions,
+  NonPointBandPositionScaleOptions
+>;
+type BarYPositionChannel =
+  | string
+  | ({ field: string; stack?: StackMode } & (
+      | {
+          fieldType?: "quantitative";
+          aggregate?: never;
+          scale?: NonPointZeroSupportingPositionScaleOptions;
+        }
+      | {
+          fieldType: "nominal" | "ordinal";
+          aggregate?: never;
+          scale?: NonPointBandPositionScaleOptions;
+        }
+      | {
+          fieldType?: "quantitative" | "nominal" | "ordinal";
+          aggregate: AggregateOperation;
+          scale?: NonPointZeroSupportingPositionScaleOptions;
+        }
+    ));
 type BasicColorChannel =
   | string
-  | (ColorEncodingOptions extends infer T
-      ? T extends unknown ? Omit<T, "target"> : never
-      : never);
+  | {
+      field: string;
+      fieldType?: "nominal" | "ordinal";
+      scale?: CategoricalColorScaleOptions;
+      palette?: Palette;
+    }
+  | {
+      field: string;
+      fieldType: "quantitative";
+      scale?: ContinuousColorScaleOptions | DiscretizedColorScaleOptions;
+      palette?: Palette;
+    }
+  | {
+      field: string;
+      fieldType: "temporal";
+      scale?: ContinuousColorScaleOptions;
+      palette?: Palette;
+    };
+type NonPointCategoricalColorChannel =
+  | string
+  | {
+      field: string;
+      fieldType?: "nominal" | "ordinal";
+      scale?: NonPointCategoricalColorScaleOptions;
+      palette?: Palette;
+      layout?: ColorLayout;
+    };
+type HistogramCategoricalColorChannel =
+  | string
+  | {
+      field: string;
+      fieldType?: "nominal" | "ordinal";
+      scale?: NonPointCategoricalColorScaleOptions;
+      palette?: Palette;
+      layout?: Exclude<ColorLayout, "center">;
+    };
+type LineCategoricalColorChannel =
+  | string
+  | {
+      field: string;
+      fieldType?: "nominal" | "ordinal";
+      scale?: NonPointCategoricalColorScaleOptions;
+      palette?: Palette;
+    };
+type QuantitativeBarColorChannel = {
+  field: string;
+  fieldType: "quantitative";
+  aggregate?: AggregateOperation;
+  scale?:
+    | NonPointContinuousColorScaleOptions
+    | NonPointDiscretizedColorScaleOptions;
+  palette?: Palette;
+  layout?: never;
+};
+type BarCategoricalColorChannel =
+  | string
+  | {
+      field: string;
+      fieldType?: "nominal" | "ordinal";
+      scale?: NonPointCategoricalColorScaleOptions;
+      palette?: Palette;
+      layout?: Exclude<ColorLayout, "center">;
+    };
+type BarColorChannel =
+  | BarCategoricalColorChannel
+  | QuantitativeBarColorChannel;
+type RectColorChannel =
+  | LineCategoricalColorChannel
+  | {
+      field: string;
+      fieldType: "quantitative";
+      scale?:
+        | NonPointContinuousColorScaleOptions
+        | NonPointDiscretizedColorScaleOptions;
+      palette?: Palette;
+    }
+  | {
+      field: string;
+      fieldType: "temporal";
+      scale?: NonPointContinuousColorScaleOptions;
+      palette?: Palette;
+    };
 export type BasicSizeChannel = string | {
   field: string;
   fieldType?: "quantitative";
-  scale?: ScaleOptions;
+  scale?: SizeScaleOptions;
 };
 export type BasicShapeChannel = string | {
   field: string;
   fieldType?: "nominal";
-  scale?: ScaleOptions;
+  scale?: ShapeScaleOptions;
 };
 export type BasicStrokeDashChannel =
   StrokeDashEncodingOptions extends infer T
@@ -1419,12 +1768,25 @@ export type BasicStrokeDashChannel =
     : never;
 
 export type ParallelMissingPolicy = "break" | "drop-row" | "error";
-export type ParallelDimension = string | {
+export type ParallelDimension = string | ({
   field: string;
-  fieldType?: "quantitative" | "ordinal";
   title?: string;
-  scale?: Omit<ScaleOptions, "id">;
-};
+} & (
+  | {
+      fieldType: "quantitative";
+      scale?: WithoutScaleId<QuantitativePositionScaleOptions>;
+    }
+  | {
+      fieldType: "ordinal";
+      scale?: WithoutScaleId<CategoricalPositionScaleOptions>;
+    }
+  | {
+      fieldType?: undefined;
+      scale?: WithoutScaleId<
+        QuantitativePositionScaleOptions | CategoricalPositionScaleOptions
+      >;
+    }
+));
 export interface ParallelCoordinatesEncodingOptions {
   target?: string;
   coordinate?: string;
@@ -1439,7 +1801,7 @@ export interface CreateParallelCoordinatesOptions {
   dimensions: readonly [ParallelDimension, ParallelDimension, ...ParallelDimension[]];
   key?: string;
   missing?: ParallelMissingPolicy;
-  color?: BasicColorChannel;
+  color?: LineCategoricalColorChannel;
   strokeDash?: BasicStrokeDashChannel;
   line?: {
     strokeWidth?: number;
@@ -1448,15 +1810,15 @@ export interface CreateParallelCoordinatesOptions {
     curve?: "linear";
     closed?: false;
   };
-  guides?: false | CreateGuidesOptions;
+  guides?: false | ParallelGuideOptions;
 }
 
 export interface CreateScatterPlotOptions {
   id?: string;
   data?: string;
   coordinate?: string;
-  x: BasicPositionChannel;
-  y: BasicPositionChannel;
+  x: PointFacadePositionChannel;
+  y: PointFacadePositionChannel;
   color?: BasicColorChannel;
   size?: BasicSizeChannel;
   shape?: BasicShapeChannel;
@@ -1474,9 +1836,9 @@ export interface CreateLinePlotOptions {
   id?: string;
   data?: string;
   coordinate?: string;
-  x: BasicPositionChannel;
-  y: BasicPositionChannel;
-  color?: BasicColorChannel;
+  x: LineXPositionChannel;
+  y: LineYPositionChannel;
+  color?: LineCategoricalColorChannel;
   groupBy?: string;
   strokeDash?: BasicStrokeDashChannel;
   line?: {
@@ -1484,23 +1846,27 @@ export interface CreateLinePlotOptions {
     curve?: CurveInterpolation;
     stroke?: string;
     opacity?: number;
-    closed?: boolean;
+    closed?: false;
   };
   guides?: false | CreateGuidesOptions;
 }
 
 type BasicHistogramEncoding =
   HistogramEncodingOptions extends infer T
-    ? T extends unknown ? Omit<T, "field" | "target" | "coordinate"> : never
+    ? T extends unknown
+      ? Omit<T, "field" | "target" | "coordinate" | "stack"> & {
+          stack?: Exclude<StackMode, "center">;
+        }
+      : never
     : never;
 
 export interface CreateBarPlotOptions {
   id?: string;
   data?: string;
   coordinate?: string;
-  x: BasicPositionChannel;
-  y: BasicPositionChannel;
-  color?: BasicColorChannel;
+  x: BandPositionChannel;
+  y: BarYPositionChannel;
+  color?: BarColorChannel;
   width?: Omit<BarWidthOptions, "target">;
   bar?: {
     fill?: string;
@@ -1516,7 +1882,7 @@ export type CreateHistogramOptions = BasicHistogramEncoding & {
   data?: string;
   coordinate?: string;
   field: string;
-  color?: BasicColorChannel;
+  color?: HistogramCategoricalColorChannel;
   bar?: {
     fill?: string;
     opacity?: number;
@@ -1535,24 +1901,34 @@ export interface HeatmapBaseOptions {
     stroke?: string | false;
     strokeWidth?: number;
   };
-  guides?: false | CreateGuidesOptions;
+  guides?: false | CartesianGuideOptions;
 }
 
+export type HeatmapCategoryPositionChannel =
+  | string
+  | {
+      field: string;
+      fieldType?: "nominal" | "ordinal";
+      scale?: NonPointBandPositionScaleOptions;
+    };
+
 export interface PreGriddedHeatmapOptions extends HeatmapBaseOptions {
-  x: BasicPositionChannel;
-  y: BasicPositionChannel;
+  x: HeatmapCategoryPositionChannel;
+  y: HeatmapCategoryPositionChannel;
   bin?: never;
-  color: BasicColorChannel;
+  color: RectColorChannel;
 }
 
 export interface BinnedHeatmapPositionChannel {
   field: string;
   fieldType?: "quantitative";
-  scale?: ScaleOptions;
+  scale?: NonPointQuantitativePositionScaleOptions;
 }
 
 export interface BinnedHeatmapColorOptions {
-  scale?: ContinuousColorScaleOptions | DiscretizedColorScaleOptions;
+  scale?:
+    | NonPointContinuousColorScaleOptions
+    | NonPointDiscretizedColorScaleOptions;
   palette?: Palette;
 }
 
@@ -1573,25 +1949,30 @@ export type CreateHeatmapOptions =
   | PreGriddedHeatmapOptions
   | BinnedHeatmapOptions;
 
-export interface ErrorBandPositionChannel {
-  field?: string;
-  fieldType?: "quantitative" | "temporal";
-  scale?: ScaleOptions;
-}
+export type ErrorBandPositionChannel = { field?: string } & (
+  | {
+      fieldType?: "quantitative";
+      scale?: NonPointQuantitativePositionScaleOptions;
+    }
+  | {
+      fieldType: "temporal";
+      scale?: NonPointTemporalPositionScaleOptions;
+    }
+);
 
 export interface ErrorBandStatisticalIntervalChannel {
   field?: string;
   center?: IntervalCenter;
   extent?: IntervalExtent;
   level?: number;
-  scale?: ScaleOptions;
+  scale?: NonPointQuantitativePositionScaleOptions;
 }
 
 export interface ErrorBandExplicitIntervalChannel {
   center: string;
   lower: string;
   upper: string;
-  scale?: ScaleOptions;
+  scale?: NonPointQuantitativePositionScaleOptions;
 }
 
 export type ErrorBandIntervalChannel =
@@ -1773,8 +2154,9 @@ export type StrokeDashEncodingOptions =
       scale?: never;
     };
 
-export interface ContinuousColorScaleOptions {
-  id?: string;
+export type NonPointContinuousColorScaleOptions = ScaleFields<
+  "id" | "interpolate" | "clamp" | "reverse"
+> & {
   type?: "sequential";
   domain?: "auto" | readonly [unknown, unknown];
   range?: "auto" | readonly [string, string, ...string[]];
@@ -1782,37 +2164,45 @@ export interface ContinuousColorScaleOptions {
     name: PaletteName;
     extent?: readonly [number, number];
   };
-  interpolate?: ContinuousColorInterpolation;
-  clamp?: boolean;
-  reverse?: boolean;
-}
+};
+
+export type ContinuousColorScaleOptions =
+  NonPointContinuousColorScaleOptions & { unknown?: string };
 
+export type NonPointQuantizeColorScaleOptions = ScaleFields<
+  "id" | "clamp" | "reverse"
+> & {
+  type: "quantize";
+  domain?: "auto" | readonly [number, number];
+  range?: "auto" | readonly [string, string, ...string[]];
+  palette?: PaletteName | { name: PaletteName; count?: number };
+};
+export type NonPointQuantileColorScaleOptions = ScaleFields<"id" | "reverse"> & {
+  type: "quantile";
+  domain?: "auto" | readonly number[];
+  range?: "auto" | readonly [string, string, ...string[]];
+  palette?: PaletteName | { name: PaletteName; count?: number };
+};
+export type NonPointThresholdColorScaleOptions = ScaleFields<"id" | "reverse"> & {
+  type: "threshold";
+  domain: readonly number[];
+  range?: "auto" | readonly [string, string, ...string[]];
+  palette?: PaletteName | { name: PaletteName; count?: number };
+};
+export type NonPointDiscretizedColorScaleOptions =
+  | NonPointQuantizeColorScaleOptions
+  | NonPointQuantileColorScaleOptions
+  | NonPointThresholdColorScaleOptions;
+export type QuantizeColorScaleOptions =
+  NonPointQuantizeColorScaleOptions & { unknown?: string };
+export type QuantileColorScaleOptions =
+  NonPointQuantileColorScaleOptions & { unknown?: string };
+export type ThresholdColorScaleOptions =
+  NonPointThresholdColorScaleOptions & { unknown?: string };
 export type DiscretizedColorScaleOptions =
-  | {
-      id?: string;
-      type: "quantize";
-      domain?: "auto" | readonly [number, number];
-      range?: "auto" | readonly [string, string, ...string[]];
-      palette?: PaletteName | { name: PaletteName; count?: number };
-      clamp?: boolean;
-      reverse?: boolean;
-    }
-  | {
-      id?: string;
-      type: "quantile";
-      domain?: "auto" | readonly number[];
-      range?: "auto" | readonly [string, string, ...string[]];
-      palette?: PaletteName | { name: PaletteName; count?: number };
-      reverse?: boolean;
-    }
-  | {
-      id?: string;
-      type: "threshold";
-      domain: readonly number[];
-      range?: "auto" | readonly [string, string, ...string[]];
-      palette?: PaletteName | { name: PaletteName; count?: number };
-      reverse?: boolean;
-    };
+  | QuantizeColorScaleOptions
+  | QuantileColorScaleOptions
+  | ThresholdColorScaleOptions;
 
 export type ColorEncodingOptions =
   | CategoricalEncodingOptions
@@ -1835,16 +2225,14 @@ export type ColorEncodingOptions =
       layout?: never;
     };
 
-export interface OpacityScaleOptions {
-  id?: string;
+export type OpacityScaleOptions = ScaleFields<
+  "id" | "nice" | "zero" | "clamp" | "reverse"
+> & {
   type?: "linear";
   domain?: "auto" | readonly [number, number];
   range?: "auto" | readonly [number, number];
-  nice?: boolean;
-  zero?: boolean;
-  clamp?: boolean;
-  reverse?: boolean;
-}
+  unknown?: number;
+};
 
 export type OpacityEncodingOptions =
   | { value: number; field?: never; target?: string }
@@ -1856,19 +2244,7 @@ export type OpacityEncodingOptions =
       scale?: OpacityScaleOptions;
     };
 
-export interface StrokeWidthScaleOptions {
-  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;
-}
+export type StrokeWidthScaleOptions = NonPointQuantitativePositionScaleOptions;
 
 export type StrokeWidthEncodingOptions =
   | {
@@ -2189,6 +2565,8 @@ export interface EditTitleOptions
   subtitle?: string | false;
 }
 
+export interface ChartProgram extends RegisteredExtensionActions {}
+
 export class ChartProgram {
   constructor(state?: ActionOptions);
   readonly semanticSpec: SemanticSpec;
@@ -2336,8 +2714,8 @@ export class ChartProgram {
   encodeX2(options: SecondaryPositionEncodingOptions): ChartProgram;
   encodeColor(options: ColorEncodingOptions): ChartProgram;
   encodeStrokeDash(options: StrokeDashEncodingOptions): ChartProgram;
-  encodeSize(options: { field: string; target?: string; fieldType?: "quantitative"; scale?: ScaleOptions }): ChartProgram;
-  encodeShape(options: { field: string; target?: string; fieldType?: "nominal"; scale?: ScaleOptions }): ChartProgram;
+  encodeSize(options: { field: string; target?: string; fieldType?: "quantitative"; scale?: SizeScaleOptions }): ChartProgram;
+  encodeShape(options: { field: string; target?: string; fieldType?: "nominal"; scale?: ShapeScaleOptions }): ChartProgram;
   encodeAngle(options:
     | { target?: string; value: number; field?: never; fieldType?: never }
     | { target?: string; field: string; fieldType?: "quantitative"; value?: never }
@@ -2355,7 +2733,7 @@ export class ChartProgram {
     target?: string;
     fieldType?: "quantitative";
     coordinate?: string;
-    scale?: ScaleOptions;
+    scale?: NonPointQuantitativePositionScaleOptions;
   }): ChartProgram;
   encodeXRange(options: {
     lower: string;
@@ -2363,7 +2741,7 @@ export class ChartProgram {
     target?: string;
     fieldType?: "quantitative";
     coordinate?: string;
-    scale?: ScaleOptions;
+    scale?: NonPointQuantitativePositionScaleOptions;
   }): ChartProgram;
   encodeGroup(options: { field: string; target?: string; fieldType?: "nominal" }): ChartProgram;
   encodePathOrder(options: PathOrderEncodingOptions): ChartProgram;