@mathstack/viz 1.1.5 → 2.0.3

package/src/lib/geographies/config/layers/attribute-data-layer/dimensions/categorical-bins/categorical-bins.cy.ts

@@ -0,0 +1,437 @@
+/* eslint-disable @angular-eslint/prefer-standalone */
+import { Component, Input } from '@angular/core';
+import {
+  ChartConfig,
+  GeographiesConfig,
+  VicChartConfigBuilder,
+  VicChartModule,
+  VicGeographiesConfigBuilder,
+  VicGeographiesModule,
+} from '@mathstack/viz';
+import { geoMercator } from 'd3';
+import {
+  FeatureCollection,
+  GeoJsonProperties,
+  MultiPolygon,
+  Polygon,
+} from 'geojson';
+import { beforeEach, cy, describe, expect, it } from 'local-cypress';
+import { range } from 'rxjs';
+import * as topojson from 'topojson-client';
+import { GeometryCollection, Objects, Topology } from 'topojson-specification';
+import {
+  StateIncomePopulationYearDatum,
+  stateIncomePopulationYearData,
+} from '../../../../../../testing/data/state-population-income-year-data';
+
+const margin = { top: 36, right: 36, bottom: 36, left: 36 };
+const chartHeight = 400;
+const chartWidth = 600;
+const attributeData = stateIncomePopulationYearData
+  .filter((x) => x.year === 2020)
+  .filter((x) => x.state !== 'Puerto Rico');
+
+interface TestMapGeometryProperties extends GeoJsonProperties {
+  name: string;
+  id: string;
+}
+
+interface TestMapObjects extends Objects {
+  country: GeometryCollection<TestMapGeometryProperties>;
+  states: GeometryCollection<TestMapGeometryProperties>;
+}
+
+type TestUsMapTopology = Topology<TestMapObjects>;
+
+// ***********************************************************
+// Geographies component set up
+// ***********************************************************
+@Component({
+  // eslint-disable-next-line @angular-eslint/component-selector
+  selector: 'app-test-geographies',
+  template: `
+    <vic-map-chart [config]="chartConfig">
+      <svg:g
+        vic-primary-marks-geographies
+        svg-elements
+        [config]="geographiesConfig"
+        [vicGeographiesHoverActions]="hoverActions"
+        (vicGeographiesHoverOutput)="updateTooltipForNewOutput($event)"
+      ></svg:g>
+    </vic-map-chart>
+  `,
+  styles: [],
+  imports: [VicChartModule, VicGeographiesModule],
+})
+class TestGeographiesComponent {
+  @Input() geographiesConfig: GeographiesConfig<
+    StateIncomePopulationYearDatum,
+    TestMapGeometryProperties
+  >;
+  chartConfig: ChartConfig = new VicChartConfigBuilder()
+    .margin(margin)
+    .maxWidth(chartWidth)
+    .maxHeight(chartHeight)
+    .scalingStrategy('responsive-width')
+    .getConfig();
+}
+
+const mountGeographiesComponent = (
+  geographiesConfig: GeographiesConfig<
+    StateIncomePopulationYearDatum,
+    TestMapGeometryProperties
+  >
+): void => {
+  cy.mount(TestGeographiesComponent, {
+    componentProperties: {
+      geographiesConfig: geographiesConfig,
+    },
+  });
+};
+
+// ***********************************************************
+// Test dimension
+// ***********************************************************
+describe('the Categorical Bins Attribute Data dimension', () => {
+  let geographiesConfig: GeographiesConfig<
+    StateIncomePopulationYearDatum,
+    TestMapGeometryProperties
+  >;
+  beforeEach(() => {
+    geographiesConfig = undefined;
+  });
+  it('User provides domain and range - colors states by domain and range in 1:1 relationship', () => {
+    const binValues = [50000, 75000];
+    const rangeValues = ['red', 'violet', 'blue'];
+    cy.fixture('usMap.json').then((response) => {
+      const usMap: TestUsMapTopology = response;
+      const usBoundary = topojson.feature(
+        usMap,
+        usMap.objects.country
+      ) as FeatureCollection<MultiPolygon, TestMapGeometryProperties>;
+      const states = topojson.feature(
+        usMap,
+        usMap.objects.states
+      ) as FeatureCollection<MultiPolygon | Polygon, TestMapGeometryProperties>;
+      geographiesConfig = new VicGeographiesConfigBuilder<
+        StateIncomePopulationYearDatum,
+        TestMapGeometryProperties
+      >()
+        .boundary(usBoundary)
+        .featureIndexAccessor((d) => d.properties.name)
+        .attributeDataLayer((layer) =>
+          layer
+            .data(attributeData)
+            .class((d) => d.name.split(' ').join('-'))
+            .geographies(states.features)
+            .geographyIndexAccessor((d) => d.state)
+            .categoricalBins((dimension) =>
+              dimension
+                .valueAccessor((d) => {
+                  if (d.income < binValues[0]) {
+                    return 'Low';
+                  } else if (d.income < binValues[1]) {
+                    return 'Medium';
+                  } else {
+                    return 'High';
+                  }
+                })
+                .domain(['Low', 'Medium', 'High'])
+                .range(rangeValues)
+            )
+        )
+        .getConfig();
+      mountGeographiesComponent(geographiesConfig);
+      rangeValues.forEach((color, i) => {
+        const statesInAttributeData = attributeData
+          .filter((x) => {
+            if (i === 0) {
+              return x.income < binValues[i];
+            } else if (i === rangeValues.length - 1) {
+              return x.income >= binValues[i - 1];
+            } else {
+              return x.income < binValues[i + 1] && x.income >= binValues[i];
+            }
+          })
+          .map((x) => x.state);
+        statesInAttributeData.forEach((state) => {
+          cy.get(
+            `.vic-geographies-group.${state.split(' ').join('-')} path`
+          ).then((path) => {
+            expect(path.attr('fill')).to.eq(color);
+          });
+        });
+      });
+    });
+  });
+
+  it('User provides range but not domain - colors in order they appear in data', () => {
+    const binValues = [50000, 75000];
+    cy.fixture('usMap.json').then((response) => {
+      const usMap: TestUsMapTopology = response;
+      const usBoundary = topojson.feature(
+        usMap,
+        usMap.objects.country
+      ) as FeatureCollection<MultiPolygon, TestMapGeometryProperties>;
+      const states = topojson.feature(
+        usMap,
+        usMap.objects.states
+      ) as FeatureCollection<MultiPolygon | Polygon, TestMapGeometryProperties>;
+      geographiesConfig = new VicGeographiesConfigBuilder<
+        StateIncomePopulationYearDatum,
+        TestMapGeometryProperties
+      >()
+        .boundary(usBoundary)
+        .featureIndexAccessor((d) => d.properties.name)
+        .attributeDataLayer((layer) =>
+          layer
+            .data(attributeData)
+            .class((d) => d.name.split(' ').join('-'))
+            .geographies(states.features)
+            .geographyIndexAccessor((d) => d.state)
+            .categoricalBins((dimension) =>
+              dimension
+                .valueAccessor((d) => {
+                  if (d.income < binValues[0]) {
+                    return 'Low';
+                  } else if (d.income < binValues[1]) {
+                    return 'Medium';
+                  } else {
+                    return 'High';
+                  }
+                })
+                .range(['red', 'violet', 'blue'])
+            )
+        )
+        .getConfig();
+      mountGeographiesComponent(geographiesConfig);
+      const lowStates = attributeData // first state in this group: Arkansas - uses third color
+        .filter((d) => d.income < binValues[0])
+        .map((d) => d.state.replace(/\s/g, '-'));
+      const mediumStates = attributeData // first state in this group: Alabama - uses first color
+        .filter((d) => d.income < binValues[1] && d.income >= binValues[0])
+        .map((d) => d.state.replace(/\s/g, '-'));
+      const highStates = attributeData // first state in this group: Alaska  - uses second color
+        .filter((d) => d.income >= binValues[1])
+        .map((d) => d.state.replace(/\s/g, '-'));
+      [
+        { data: mediumStates, color: 'red' },
+        { data: highStates, color: 'violet' },
+        { data: lowStates, color: 'blue' },
+      ].forEach((group) => {
+        group.data.forEach((state) => {
+          cy.get(
+            `.vic-geographies-group.${state.split(' ').join('-')} path`
+          ).then((path) => {
+            expect(path.attr('fill')).to.eq(group.color);
+          });
+        });
+      });
+    });
+  });
+
+  it('User provides range that has fewer categories than in data -- additional categories get assigned to given range values -- EXPECTED VISUAL DEFECT', () => {
+    const binValues = [50000, 65000, 80000];
+    const rangeValues = ['red', 'violet'];
+    // Note: use colors where only one rbg color channel varies so that it's possible to test data values.
+    cy.fixture('usMap.json').then((response) => {
+      const usMap: TestUsMapTopology = response;
+      const usBoundary = topojson.feature(
+        usMap,
+        usMap.objects.country
+      ) as FeatureCollection<MultiPolygon, TestMapGeometryProperties>;
+      const states = topojson.feature(
+        usMap,
+        usMap.objects.states
+      ) as FeatureCollection<MultiPolygon | Polygon, TestMapGeometryProperties>;
+      geographiesConfig = new VicGeographiesConfigBuilder<
+        StateIncomePopulationYearDatum,
+        TestMapGeometryProperties
+      >()
+        .boundary(usBoundary)
+        .featureIndexAccessor((d) => d.properties.name)
+        .attributeDataLayer((layer) =>
+          layer
+            .data(attributeData)
+            .class((d) => d.name.split(' ').join('-'))
+            .geographies(states.features)
+            .geographyIndexAccessor((d) => d.state)
+            .categoricalBins((dimension) =>
+              dimension
+                .valueAccessor((d) => {
+                  if (d.income < binValues[0]) {
+                    return 'Low';
+                  } else if (d.income < binValues[1]) {
+                    return 'Medium';
+                  } else if (d.income < binValues[2]) {
+                    return 'High';
+                  } else {
+                    return 'Very High';
+                  }
+                })
+                .domain(['Low', 'Medium', 'High', 'Very High'])
+                .range(rangeValues)
+            )
+        )
+        .getConfig();
+      mountGeographiesComponent(geographiesConfig);
+      range(binValues.length + 1).forEach((i) => {
+        const statesInAttributeData = attributeData
+          .filter((x) => {
+            if (i === 0) {
+              return x.income < binValues[i];
+            } else if (i === binValues.length) {
+              return x.income >= binValues[i - 1];
+            } else {
+              return x.income < binValues[i] && x.income >= binValues[i - 1];
+            }
+          })
+          .map((d) => d.state.replace(/\s/g, '-'));
+        const color = rangeValues[i % rangeValues.length];
+        statesInAttributeData.forEach((state) => {
+          cy.get(
+            `.vic-geographies-group.${state.split(' ').join('-')} path`
+          ).then((path) => {
+            expect(path.attr('fill')).to.eq(color);
+          });
+        });
+      });
+    });
+  });
+
+  it('it colors undefined, null, and non-quant values with null color', () => {
+    const binValues = [50000, 75000];
+    const rangeValues = ['red', 'violet', 'blue'];
+    cy.fixture('usMap.json').then((response) => {
+      const usMap: TestUsMapTopology = response;
+      const usBoundary = topojson.feature(
+        usMap,
+        usMap.objects.country
+      ) as FeatureCollection<MultiPolygon, TestMapGeometryProperties>;
+      const states = topojson.feature(
+        usMap,
+        usMap.objects.states
+      ) as FeatureCollection<MultiPolygon | Polygon, TestMapGeometryProperties>;
+      const dataWithFalsyValues = attributeData.map((d) => {
+        if (d.state === 'Texas') {
+          return { ...d, income: null };
+        } else if (d.state === 'California') {
+          return { ...d, income: undefined };
+        } else if (d.state === 'Florida') {
+          return { ...d, income: 'Not a number' as unknown as number };
+        } else {
+          return d;
+        }
+      });
+      const nullColor = 'chartreuse';
+      geographiesConfig = new VicGeographiesConfigBuilder<
+        StateIncomePopulationYearDatum,
+        TestMapGeometryProperties
+      >()
+        .boundary(usBoundary)
+        .featureIndexAccessor((d) => d.properties.name)
+        .attributeDataLayer((layer) =>
+          layer
+            .data(dataWithFalsyValues)
+            .class((d) => d.name.split(' ').join('-'))
+            .geographies(states.features)
+            .geographyIndexAccessor((d) => d.state)
+            .categoricalBins((dimension) =>
+              dimension
+                .valueAccessor((d) => {
+                  if (
+                    d.income === undefined ||
+                    d.income === null ||
+                    isNaN(d.income)
+                  ) {
+                    return d.income as unknown as string;
+                  } else if (d.income < binValues[0]) {
+                    return 'Low';
+                  } else if (d.income < binValues[1]) {
+                    return 'Medium';
+                  } else {
+                    return 'High';
+                  }
+                })
+                .domain(['Low', 'Medium', 'High'])
+                .range(rangeValues)
+                .nullColor(nullColor)
+            )
+        )
+        .getConfig();
+      mountGeographiesComponent(geographiesConfig);
+      cy.get(`.vic-geographies-group.Florida path`).then((path) => {
+        expect(path.attr('fill')).to.eq(nullColor);
+      });
+      cy.get(`.vic-geographies-group.Texas path`).then((path) => {
+        expect(path.attr('fill')).to.eq(nullColor);
+      });
+      cy.get(`.vic-geographies-group.California path`).then((path) => {
+        expect(path.attr('fill')).to.eq(nullColor);
+      });
+    });
+  });
+
+  it('it colors geographies not in attribute data with the null color', () => {
+    // island territories like American Samoa, Guam, etc. are not in the attribute data but are in the geojson
+    // they wil be drawn with any projection but let's use geoMercator to make them a bit more visible-ish
+    const binValues = [50000, 75000];
+    const rangeValues = ['red', 'violet', 'blue'];
+    cy.fixture('usMap.json').then((response) => {
+      const usMap: TestUsMapTopology = response;
+      const usBoundary = topojson.feature(
+        usMap,
+        usMap.objects.country
+      ) as FeatureCollection<MultiPolygon, TestMapGeometryProperties>;
+      const states = topojson.feature(
+        usMap,
+        usMap.objects.states
+      ) as FeatureCollection<MultiPolygon | Polygon, TestMapGeometryProperties>;
+      const nullColor = 'chartreuse';
+      geographiesConfig = new VicGeographiesConfigBuilder<
+        StateIncomePopulationYearDatum,
+        TestMapGeometryProperties
+      >()
+        .boundary(usBoundary)
+        .projection(geoMercator())
+        .featureIndexAccessor((d) => d.properties.name)
+        .attributeDataLayer((layer) =>
+          layer
+            .data(attributeData)
+            .class((d) => d.name.split(' ').join('-'))
+            .geographies(states.features)
+            .geographyIndexAccessor((d) => d.state)
+            .categoricalBins((dimension) =>
+              dimension
+                .valueAccessor((d) => {
+                  if (d.income < binValues[0]) {
+                    return 'Low';
+                  } else if (d.income < binValues[1]) {
+                    return 'Medium';
+                  } else {
+                    return 'High';
+                  }
+                })
+                .domain(['Low', 'Medium', 'High'])
+                .range(rangeValues)
+                .nullColor(nullColor)
+            )
+        )
+        .getConfig();
+      mountGeographiesComponent(geographiesConfig);
+      const geographiesNotInAttributeData = states.features
+        .filter(
+          (x) =>
+            attributeData.findIndex((d) => d.state === x.properties.name) === -1
+        )
+        .map((x) => x.properties.name.replace(/\s/g, '-'));
+      geographiesNotInAttributeData.forEach((state) => {
+        cy.get(
+          `.vic-geographies-group.${state.split(' ').join('-')} path`
+        ).then((path) => {
+          expect(path.attr('fill')).to.eq(nullColor);
+        });
+      });
+    });
+  });
+});

package/src/lib/geographies/config/layers/attribute-data-layer/dimensions/categorical-bins/categorical-bins.spec.ts

@@ -0,0 +1,105 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+import { CategoricalBinsAttributeDataDimension } from './categorical-bins';
+import { CategoricalBinsBuilder } from './categorical-bins-builder';
+
+describe('VicCategoricalAttributeDataDimension', () => {
+  let dimension: CategoricalBinsAttributeDataDimension<string>;
+  beforeEach(() => {
+    dimension = new CategoricalBinsBuilder<string>()
+      .valueAccessor((d) => d)
+      ._build();
+  });
+  describe('setPropertiesFromData', () => {
+    beforeEach(() => {
+      spyOn(dimension as any, 'setDomain');
+      spyOn(dimension as any, 'setRange');
+    });
+    it('calls setDomain once', () => {
+      dimension.setPropertiesFromData(['a', 'b', 'c']);
+      expect((dimension as any).setDomain).toHaveBeenCalledTimes(1);
+    });
+    it('calls setRange once', () => {
+      dimension.setPropertiesFromData(['a', 'b', 'c']);
+      expect((dimension as any).setRange).toHaveBeenCalledTimes(1);
+    });
+  });
+
+  describe('setDomain', () => {
+    it('sets the domain to uniqued values', () => {
+      dimension.setPropertiesFromData(['a', 'b', 'c', 'b']);
+      expect((dimension as any).calculatedDomain).toEqual(['a', 'b', 'c']);
+    });
+    it('sets the domain to uniqued user values if specified', () => {
+      dimension = new CategoricalBinsBuilder<string>()
+        .valueAccessor((d) => d)
+        .domain(['c', 'd', 'b', 'a', 'd'])
+        ._build();
+      dimension.setPropertiesFromData(['a', 'b', 'c', 'a', 'b']);
+      expect((dimension as any).calculatedDomain).toEqual(['c', 'd', 'b', 'a']);
+    });
+  });
+
+  describe('setRange', () => {
+    it('sets the range to the correct values/length', () => {
+      dimension = new CategoricalBinsBuilder<string>()
+        .valueAccessor((d) => d)
+        .range(['red', 'blue', 'green', 'yellow', 'purple'])
+        ._build();
+      dimension.setPropertiesFromData(['a', 'b', 'c']);
+      expect(dimension.range).toEqual(['red', 'blue', 'green']);
+    });
+  });
+
+  describe('integration: the scale generates the expected color for a value with the default scale (D3 scaleOrdinal)', () => {
+    type IceCream = { price: number; flavor: string; brand: string };
+    let dimension: CategoricalBinsAttributeDataDimension<IceCream>;
+    const data: IceCream[] = [
+      { price: 7.99, flavor: 'chocolate', brand: 'local' },
+      { price: 5, flavor: 'chocolate', brand: 'national' },
+      { price: 3.98, flavor: 'chocolate', brand: 'national' },
+      { price: 8, flavor: 'vanilla', brand: 'regional' },
+      { price: 11, flavor: 'vanilla', brand: 'local' },
+      { price: 4.99, flavor: 'strawberry', brand: 'local' },
+      { price: 4.5, flavor: 'strawberry', brand: 'national' },
+      { price: 7, flavor: 'strawberry', brand: 'regional' },
+    ];
+    it('using default properties', () => {
+      dimension = new CategoricalBinsBuilder<IceCream>()
+        .valueAccessor((d) => d.flavor)
+        .nullColor('pink')
+        ._build();
+      dimension.setPropertiesFromData(data);
+      const scale = dimension.getScale();
+      expect(scale('chocolate')).toEqual('white');
+      expect(scale('vanilla')).toEqual('lightslategray');
+      expect(scale('strawberry')).toEqual('white');
+      expect(scale('cookie dough')).toEqual('pink');
+    });
+    it('using user provided range', () => {
+      dimension = new CategoricalBinsBuilder<IceCream>()
+        .valueAccessor((d) => d.flavor)
+        .range(['red', 'white', 'blue'])
+        .nullColor('pink')
+        ._build();
+      dimension.setPropertiesFromData(data);
+      const scale = dimension.getScale();
+      expect(scale('chocolate')).toEqual('red');
+      expect(scale('vanilla')).toEqual('white');
+      expect(scale('strawberry')).toEqual('blue');
+      expect(scale('cookie dough')).toEqual('pink');
+    });
+    it('using user provided domain', () => {
+      dimension = new CategoricalBinsBuilder<IceCream>()
+        .valueAccessor((d) => d.flavor)
+        .domain(['cookie dough', 'rocky road', 'butter pecan'])
+        .nullColor('pink')
+        ._build();
+      dimension.setPropertiesFromData(data);
+      const scale = dimension.getScale();
+      expect(scale('chocolate')).toEqual('pink');
+      expect(scale('vanilla')).toEqual('pink');
+      expect(scale('strawberry')).toEqual('pink');
+      expect(scale('cookie dough')).toEqual('white');
+    });
+  });
+});

package/src/lib/geographies/config/layers/attribute-data-layer/dimensions/categorical-bins/categorical-bins.ts

@@ -0,0 +1,54 @@
+import { safeAssign } from '@mathstack/app-kit';
+import { BinStrategy } from '../attribute-data-bin-enums';
+import { AttributeDataDimension } from '../attribute-data/attribute-data-dimension';
+import { CategoricalBinsOptions } from './categorical-bins-options';
+
+/**
+ * Configuration object for attribute data that is categorical.
+ *
+ * The generic parameter is the type of the attribute data.
+ */
+export class CategoricalBinsAttributeDataDimension<
+  Datum,
+  RangeValue extends string | number = string,
+>
+  extends AttributeDataDimension<Datum, string>
+  implements CategoricalBinsOptions<Datum, string>
+{
+  override readonly binType: BinStrategy.categorical;
+  calculatedDomain: string[];
+  readonly domain: string[];
+  override interpolator: never;
+
+  constructor(options: CategoricalBinsOptions<Datum, RangeValue>) {
+    super('ordinal');
+    this.binType = BinStrategy.categorical;
+    safeAssign(this, options);
+  }
+
+  getDomain(): string[] {
+    return this.calculatedDomain;
+  }
+
+  setPropertiesFromData(data: Datum[]): void {
+    const values = data.map(this.valueAccessor);
+    this.setDomain(values);
+    this.setRange();
+  }
+
+  protected setDomain(values: string[]): void {
+    const domainValues = this.domain ?? values;
+    this.calculatedDomain = [...new Set(domainValues)];
+  }
+
+  protected setRange(): void {
+    this.range = this.range.slice(0, this.calculatedDomain.length);
+  }
+
+  getScale() {
+    return this.scale()
+      .domain(this.calculatedDomain)
+      .range(this.range)
+      .unknown(this.nullColor);
+  }
+}

package/src/lib/geographies/config/layers/attribute-data-layer/dimensions/custom-breaks/custom-breaks-bins-builder.ts

@@ -0,0 +1,65 @@
+import { safeAssign } from '@mathstack/app-kit';
+import { interpolateLab, scaleThreshold } from 'd3';
+import { AttributeDataDimensionBuilder } from '../attribute-data/attribute-data-dimension-builder';
+import { CustomBreaksBinsAttributeDataDimension } from './custom-breaks-bins';
+
+const DEFAULT = {
+  _interpolator: interpolateLab,
+  _nullColor: 'whitesmoke',
+  _scale: scaleThreshold,
+};
+
+export class CustomBreaksBinsAttributeDataDimensionBuilder<
+  Datum,
+  RangeValue extends string | number = string,
+> extends AttributeDataDimensionBuilder<Datum, number, RangeValue> {
+  private _breakValues: number[];
+  private _formatSpecifier: string;
+
+  constructor() {
+    super();
+    safeAssign(this, DEFAULT);
+  }
+
+  /**
+   * REQUIRED. An array of values to specify bin ranges. This array should include both the lowest and highest values and must have at least two values.
+   *
+   * An array of [0, 2, 5, 10, 50] will create bins [0, 2], [2, 5], [5, 10], [10, 50].
+   *
+   * Values should be in ascending order.
+   *
+   * Values below the first value will be colored with the color for the first bin. Values above the last value will be colored with the color for the last bin. 
+   * 
+   * In this sense, the first and last values are primarily used for 
+   in a legend, should one be displayed. 
+   *
+   *In order for the legend to be accurate, users should ensure that the first and last values are the minimum and maximum values in the data.
+   */
+  breakValues(breakValues: number[]): this {
+    this._breakValues = breakValues;
+    return this;
+  }
+
+  /**
+   * OPTIONAL. Sets a format specifier that will be applied to the value of this dimension using D3 format for display purposes.
+   *
+   * For example, this will format data values shown in a tooltip
+   */
+  formatSpecifier(formatSpecifier: string): this {
+    this._formatSpecifier = formatSpecifier;
+    return this;
+  }
+
+  _build(): CustomBreaksBinsAttributeDataDimension<Datum, RangeValue> {
+    return new CustomBreaksBinsAttributeDataDimension({
+      breakValues: this._breakValues,
+      formatFunction: this._formatFunction,
+      formatSpecifier: this._formatSpecifier,
+      interpolator: this._interpolator,
+      nullColor: this._nullColor,
+      range: this._range,
+      scale: this._scale,
+      valueAccessor: this._valueAccessor,
+    });
+  }
+}

package/src/lib/geographies/config/layers/attribute-data-layer/dimensions/custom-breaks/custom-breaks-bins-options.ts

@@ -0,0 +1,9 @@
+import { CalculatedBinsAttributeDataDimensionOptions } from '../calculated-bins/calculated-bins-options';
+
+export interface CustomBreaksBinsAttributeDataDimensionOptions<
+  Datum,
+  RangeValue extends string | number = string,
+> extends CalculatedBinsAttributeDataDimensionOptions<Datum, RangeValue> {
+  breakValues: number[];
+  formatSpecifier: string;
+}