@buildcanada/charts 0.3.7 → 0.3.8

package/dist/grapher/color/ColorScale.js

@@ -0,0 +1,340 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result) __defProp(target, key, result);
+  return result;
+};
+import * as _ from "lodash-es";
+import { computed, toJS, makeObservable } from "mobx";
+import { ColorScaleConfig } from "./ColorScaleConfig.js";
+import { mapNullToUndefined, sortNumeric } from "../../utils/index.js";
+import { pairs } from "d3-array";
+import { ColorSchemes } from "../color/ColorSchemes.js";
+import { NumericBin, CategoricalBin } from "./ColorScaleBin.js";
+import { NO_DATA_GRAY } from "./ColorConstants.js";
+import {
+  ColorSchemeName,
+  VariableRoundingMode
+} from "../../types/index.js";
+import * as R from "remeda";
+import { runBinningStrategy } from "./BinningStrategies.js";
+const NO_DATA_LABEL = "No data";
+const PROJECTED_DATA_LABEL = "Projected data";
+class ColorScale {
+  constructor(manager = {}) {
+    makeObservable(this);
+    this.manager = manager;
+  }
+  get config() {
+    return this.manager.colorScaleConfig ?? new ColorScaleConfig();
+  }
+  get customNumericValues() {
+    return this.config.customNumericValues ?? [];
+  }
+  get customNumericColorsActive() {
+    return this.config.customNumericColorsActive ?? false;
+  }
+  get customNumericColors() {
+    return this.customNumericColorsActive ? mapNullToUndefined(this.config.customNumericColors) : [];
+  }
+  get customHiddenCategories() {
+    return this.config.customHiddenCategories ?? {};
+  }
+  get customNumericLabels() {
+    if (!this.isManualBuckets) return [];
+    const labels = mapNullToUndefined(toJS(this.config.customNumericLabels)) || [];
+    while (labels.length < this.numNumericBins) labels.push(void 0);
+    return labels;
+  }
+  get isColorSchemeInverted() {
+    return this.config.colorSchemeInvert ?? false;
+  }
+  get customCategoryLabels() {
+    return this.config.customCategoryLabels ?? {};
+  }
+  get baseColorScheme() {
+    return this.config.baseColorScheme ?? this.manager.defaultBaseColorScheme ?? ColorSchemeName.BuGn;
+  }
+  get defaultColorScheme() {
+    return ColorSchemes.get(ColorSchemeName.BuGn);
+  }
+  get defaultNoDataColor() {
+    return this.manager.defaultNoDataColor ?? NO_DATA_GRAY;
+  }
+  get colorScaleColumn() {
+    return this.manager.colorScaleColumn;
+  }
+  get legendDescription() {
+    return this.config.legendDescription;
+  }
+  get hasNoDataBin() {
+    return this.manager.hasNoDataBin || false;
+  }
+  get hasProjectedDataBin() {
+    return this.manager.hasProjectedDataBin || false;
+  }
+  get sortedNumericValues() {
+    return sortNumeric(
+      this.colorScaleColumn?.values.filter(R.isNumber) ?? []
+    );
+  }
+  get minPossibleValue() {
+    return R.first(this.sortedNumericValues);
+  }
+  get maxPossibleValue() {
+    return R.last(this.sortedNumericValues);
+  }
+  get categoricalValues() {
+    return this.colorScaleColumn?.sortedUniqNonEmptyStringVals ?? [];
+  }
+  get colorScheme() {
+    return ColorSchemes.get(this.baseColorScheme) ?? this.defaultColorScheme;
+  }
+  get singleColorScale() {
+    return this.colorScheme.singleColorScale;
+  }
+  get manualBinThresholds() {
+    if (!this.sortedNumericValues.length || this.numNumericBins <= 0)
+      return [];
+    return this.customNumericValues;
+  }
+  get autoBinThresholds() {
+    if (this.config.binningStrategy === "manual") {
+      throw new Error(
+        "Cannot compute automatic bin thresholds when binning is set to manual"
+      );
+    }
+    return runBinningStrategy({
+      sortedValues: this.sortedNumericValues,
+      isPercent: this.colorScaleColumn?.shortUnit === "%",
+      numDecimalPlaces: this.colorScaleColumn?.numDecimalPlaces,
+      strategy: this.config.binningStrategy,
+      createBinForMidpoint: this.config.createBinForMidpoint,
+      minValue: this.config.minValue,
+      maxValue: this.config.maxValue,
+      midpoint: this.config.midpoint,
+      midpointMode: this.config.midpointMode
+    }).bins;
+  }
+  get bucketThresholds() {
+    return this.isManualBuckets ? this.manualBinThresholds : this.autoBinThresholds;
+  }
+  get customCategoryColors() {
+    return {
+      [NO_DATA_LABEL]: this.defaultNoDataColor,
+      // default 'no data' color
+      ...this.config.customCategoryColors
+    };
+  }
+  get noDataColor() {
+    return this.customCategoryColors[NO_DATA_LABEL];
+  }
+  get baseColors() {
+    const { categoricalValues, colorScheme, isColorSchemeInverted } = this;
+    const numColors = this.numNumericBins + categoricalValues.length;
+    const colors = colorScheme.getColors(numColors);
+    if (isColorSchemeInverted) return colors.toReversed();
+    else return colors;
+  }
+  get isManualBuckets() {
+    return this.config.binningStrategy === "manual";
+  }
+  get numNumericBins() {
+    if (!this.sortedNumericValues.length) return 0;
+    return this.isManualBuckets ? Math.max(this.customNumericValues.length - 1, 0) : this.autoBinThresholds.length - 1;
+  }
+  get numericLegendBins() {
+    const {
+      customNumericLabels,
+      minPossibleValue,
+      maxPossibleValue,
+      customNumericColors,
+      bucketThresholds,
+      baseColors
+    } = this;
+    if (minPossibleValue === void 0 || maxPossibleValue === void 0)
+      return [];
+    return pairs(bucketThresholds).map(([min, max], index) => {
+      const baseColor = baseColors[index];
+      const color = customNumericColors[index] ?? baseColor;
+      const label = customNumericLabels[index];
+      const roundingOptions = {
+        roundingMode: VariableRoundingMode.decimalPlaces
+      };
+      const displayMin = this.colorScaleColumn?.formatValueShort(min, roundingOptions) ?? min.toString();
+      const displayMax = this.colorScaleColumn?.formatValueShort(max, roundingOptions) ?? max.toString();
+      const isFirst = index === 0;
+      const isLast = index === bucketThresholds.length - 2;
+      return new NumericBin({
+        isFirst,
+        isOpenLeft: isFirst && min > minPossibleValue,
+        isOpenRight: isLast && max < maxPossibleValue,
+        min,
+        max,
+        color,
+        label,
+        displayMin,
+        displayMax
+      });
+    });
+  }
+  get legendBins() {
+    return [
+      ...this.numericLegendBins,
+      ...this.categoricalLegendBins
+    ];
+  }
+  get categoricalLegendBins() {
+    const {
+      bucketThresholds,
+      baseColors,
+      hasNoDataBin,
+      hasProjectedDataBin,
+      categoricalValues,
+      customCategoryColors,
+      customCategoryLabels,
+      customHiddenCategories,
+      colorScheme
+    } = this;
+    let allCategoricalValues = categoricalValues;
+    if (hasNoDataBin && !allCategoricalValues.includes(NO_DATA_LABEL)) {
+      allCategoricalValues = [...allCategoricalValues, NO_DATA_LABEL];
+    }
+    if (hasProjectedDataBin) {
+      allCategoricalValues = [
+        ...allCategoricalValues,
+        PROJECTED_DATA_LABEL
+      ];
+    }
+    return allCategoricalValues.map((value, index) => {
+      const boundingOffset = _.isEmpty(bucketThresholds) ? 0 : bucketThresholds.length - 1;
+      let baseColor;
+      if (colorScheme.colorMap && value in colorScheme.colorMap) {
+        baseColor = colorScheme.colorMap[value];
+      } else {
+        baseColor = baseColors[index + boundingOffset];
+      }
+      const color = customCategoryColors[value] ?? baseColor;
+      const label = customCategoryLabels[value] ?? value;
+      return new CategoricalBin({
+        index,
+        value,
+        color,
+        label,
+        isHidden: !!customHiddenCategories[value]
+      });
+    });
+  }
+  getBinForValue(value) {
+    return value === void 0 ? void 0 : this.legendBins.find((bin) => bin.contains(value));
+  }
+  getColor(value) {
+    if (value === void 0) return this.noDataColor;
+    return this.getBinForValue(value)?.color;
+  }
+}
+__decorateClass([
+  computed
+], ColorScale.prototype, "config", 1);
+__decorateClass([
+  computed
+], ColorScale.prototype, "customNumericValues", 1);
+__decorateClass([
+  computed
+], ColorScale.prototype, "customNumericColorsActive", 1);
+__decorateClass([
+  computed
+], ColorScale.prototype, "customNumericColors", 1);
+__decorateClass([
+  computed
+], ColorScale.prototype, "customHiddenCategories", 1);
+__decorateClass([
+  computed
+], ColorScale.prototype, "customNumericLabels", 1);
+__decorateClass([
+  computed
+], ColorScale.prototype, "isColorSchemeInverted", 1);
+__decorateClass([
+  computed
+], ColorScale.prototype, "customCategoryLabels", 1);
+__decorateClass([
+  computed
+], ColorScale.prototype, "baseColorScheme", 1);
+__decorateClass([
+  computed
+], ColorScale.prototype, "defaultColorScheme", 1);
+__decorateClass([
+  computed
+], ColorScale.prototype, "defaultNoDataColor", 1);
+__decorateClass([
+  computed
+], ColorScale.prototype, "colorScaleColumn", 1);
+__decorateClass([
+  computed
+], ColorScale.prototype, "legendDescription", 1);
+__decorateClass([
+  computed
+], ColorScale.prototype, "hasNoDataBin", 1);
+__decorateClass([
+  computed
+], ColorScale.prototype, "hasProjectedDataBin", 1);
+__decorateClass([
+  computed
+], ColorScale.prototype, "sortedNumericValues", 1);
+__decorateClass([
+  computed
+], ColorScale.prototype, "minPossibleValue", 1);
+__decorateClass([
+  computed
+], ColorScale.prototype, "maxPossibleValue", 1);
+__decorateClass([
+  computed
+], ColorScale.prototype, "categoricalValues", 1);
+__decorateClass([
+  computed
+], ColorScale.prototype, "colorScheme", 1);
+__decorateClass([
+  computed
+], ColorScale.prototype, "singleColorScale", 1);
+__decorateClass([
+  computed
+], ColorScale.prototype, "manualBinThresholds", 1);
+__decorateClass([
+  computed
+], ColorScale.prototype, "autoBinThresholds", 1);
+__decorateClass([
+  computed
+], ColorScale.prototype, "bucketThresholds", 1);
+__decorateClass([
+  computed
+], ColorScale.prototype, "customCategoryColors", 1);
+__decorateClass([
+  computed
+], ColorScale.prototype, "noDataColor", 1);
+__decorateClass([
+  computed
+], ColorScale.prototype, "baseColors", 1);
+__decorateClass([
+  computed
+], ColorScale.prototype, "isManualBuckets", 1);
+__decorateClass([
+  computed
+], ColorScale.prototype, "numNumericBins", 1);
+__decorateClass([
+  computed
+], ColorScale.prototype, "numericLegendBins", 1);
+__decorateClass([
+  computed
+], ColorScale.prototype, "legendBins", 1);
+__decorateClass([
+  computed
+], ColorScale.prototype, "categoricalLegendBins", 1);
+export {
+  ColorScale,
+  NO_DATA_LABEL,
+  PROJECTED_DATA_LABEL
+};

package/dist/grapher/color/ColorScale.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["src/grapher/color/ColorScale.ts"],
+  "sourcesContent": ["import * as _ from \"lodash-es\"\nimport { computed, toJS, makeObservable } from \"mobx\"\nimport { ColorScaleConfig } from \"./ColorScaleConfig.js\"\nimport { mapNullToUndefined, sortNumeric } from \"../../utils/index.js\"\nimport { pairs } from \"d3-array\"\nimport { ColorSchemes } from \"../color/ColorSchemes.js\"\nimport { ColorScheme } from \"../color/ColorScheme.js\"\nimport { ColorScaleBin, NumericBin, CategoricalBin } from \"./ColorScaleBin.js\"\nimport { NO_DATA_GRAY } from \"./ColorConstants.js\"\nimport {\n    ColorScaleConfigInterface,\n    ColorSchemeName,\n    Color,\n    CoreValueType,\n    VariableRoundingMode,\n} from \"../../types/index.js\"\nimport { CoreColumn } from \"../../core-table/index.js\"\nimport * as R from \"remeda\"\nimport { runBinningStrategy } from \"./BinningStrategies.js\"\n\nexport const NO_DATA_LABEL = \"No data\"\nexport const PROJECTED_DATA_LABEL = \"Projected data\"\n\nexport interface ColorScaleManager {\n    colorScaleConfig?: ColorScaleConfigInterface\n    hasNoDataBin?: boolean\n    hasProjectedDataBin?: boolean\n    defaultNoDataColor?: string\n    defaultBaseColorScheme?: ColorSchemeName\n    colorScaleColumn?: CoreColumn\n}\n\nexport class ColorScale {\n    private manager: Readonly<ColorScaleManager>\n    constructor(manager: ColorScaleManager = {}) {\n        makeObservable(this)\n        this.manager = manager\n    }\n\n    // Config accessors\n\n    @computed get config(): ColorScaleConfigInterface {\n        return this.manager.colorScaleConfig ?? new ColorScaleConfig()\n    }\n\n    @computed get customNumericValues(): number[] {\n        return this.config.customNumericValues ?? []\n    }\n\n    @computed get customNumericColorsActive(): boolean {\n        return this.config.customNumericColorsActive ?? false\n    }\n\n    @computed get customNumericColors(): (Color | undefined)[] {\n        return this.customNumericColorsActive\n            ? mapNullToUndefined(this.config.customNumericColors)\n            : []\n    }\n\n    @computed get customHiddenCategories(): {\n        [key: string]: true | undefined\n    } {\n        return this.config.customHiddenCategories ?? {}\n    }\n\n    @computed get customNumericLabels(): (string | undefined)[] {\n        if (!this.isManualBuckets) return []\n\n        const labels =\n            mapNullToUndefined(toJS(this.config.customNumericLabels)) || []\n        while (labels.length < this.numNumericBins) labels.push(undefined)\n        return labels\n    }\n\n    @computed get isColorSchemeInverted(): boolean {\n        return this.config.colorSchemeInvert ?? false\n    }\n\n    @computed private get customCategoryLabels(): {\n        [key: string]: string | undefined\n    } {\n        return this.config.customCategoryLabels ?? {}\n    }\n\n    @computed get baseColorScheme(): ColorSchemeName {\n        return (\n            this.config.baseColorScheme ??\n            this.manager.defaultBaseColorScheme ??\n            ColorSchemeName.BuGn\n        )\n    }\n\n    @computed private get defaultColorScheme(): ColorScheme {\n        return ColorSchemes.get(ColorSchemeName.BuGn)\n    }\n\n    @computed private get defaultNoDataColor(): Color {\n        return this.manager.defaultNoDataColor ?? NO_DATA_GRAY\n    }\n\n    @computed get colorScaleColumn(): CoreColumn | undefined {\n        return this.manager.colorScaleColumn\n    }\n\n    @computed get legendDescription(): string | undefined {\n        return this.config.legendDescription\n    }\n\n    // Transforms\n\n    @computed private get hasNoDataBin(): boolean {\n        return this.manager.hasNoDataBin || false\n    }\n\n    @computed private get hasProjectedDataBin(): boolean {\n        return this.manager.hasProjectedDataBin || false\n    }\n\n    @computed get sortedNumericValues(): number[] {\n        return sortNumeric(\n            this.colorScaleColumn?.values.filter(R.isNumber) ?? []\n        )\n    }\n\n    @computed private get minPossibleValue(): number | undefined {\n        return R.first(this.sortedNumericValues)\n    }\n\n    @computed private get maxPossibleValue(): number | undefined {\n        return R.last(this.sortedNumericValues)\n    }\n\n    @computed private get categoricalValues(): string[] {\n        return this.colorScaleColumn?.sortedUniqNonEmptyStringVals ?? []\n    }\n\n    @computed private get colorScheme(): ColorScheme {\n        return ColorSchemes.get(this.baseColorScheme) ?? this.defaultColorScheme\n    }\n\n    @computed get singleColorScale(): boolean {\n        return this.colorScheme.singleColorScale\n    }\n\n    @computed private get manualBinThresholds(): number[] {\n        if (!this.sortedNumericValues.length || this.numNumericBins <= 0)\n            return []\n\n        return this.customNumericValues\n    }\n\n    // When automatic classification is turned on, this takes the numeric map data\n    // and works out some discrete ranges to assign colors to\n    @computed get autoBinThresholds(): number[] {\n        if (this.config.binningStrategy === \"manual\") {\n            throw new Error(\n                \"Cannot compute automatic bin thresholds when binning is set to manual\"\n            )\n        }\n        return runBinningStrategy({\n            sortedValues: this.sortedNumericValues,\n            isPercent: this.colorScaleColumn?.shortUnit === \"%\",\n            numDecimalPlaces: this.colorScaleColumn?.numDecimalPlaces,\n\n            strategy: this.config.binningStrategy,\n            createBinForMidpoint: this.config.createBinForMidpoint,\n            minValue: this.config.minValue,\n            maxValue: this.config.maxValue,\n            midpoint: this.config.midpoint,\n            midpointMode: this.config.midpointMode,\n        }).bins\n    }\n\n    @computed private get bucketThresholds(): number[] {\n        return this.isManualBuckets\n            ? this.manualBinThresholds\n            : this.autoBinThresholds\n    }\n\n    // Ensure there's always a custom color for \"No data\"\n    @computed private get customCategoryColors(): { [key: string]: Color } {\n        return {\n            [NO_DATA_LABEL]: this.defaultNoDataColor, // default 'no data' color\n            ...this.config.customCategoryColors,\n        }\n    }\n\n    @computed get noDataColor(): Color {\n        return this.customCategoryColors[NO_DATA_LABEL]\n    }\n\n    @computed get baseColors(): Color[] {\n        const { categoricalValues, colorScheme, isColorSchemeInverted } = this\n        const numColors = this.numNumericBins + categoricalValues.length\n        const colors = colorScheme.getColors(numColors)\n\n        if (isColorSchemeInverted) return colors.toReversed()\n        else return colors\n    }\n\n    @computed get isManualBuckets(): boolean {\n        return this.config.binningStrategy === \"manual\"\n    }\n\n    @computed get numNumericBins(): number {\n        if (!this.sortedNumericValues.length) return 0\n\n        return this.isManualBuckets\n            ? Math.max(this.customNumericValues.length - 1, 0)\n            : this.autoBinThresholds.length - 1\n    }\n\n    @computed private get numericLegendBins(): NumericBin[] {\n        const {\n            customNumericLabels,\n            minPossibleValue,\n            maxPossibleValue,\n            customNumericColors,\n            bucketThresholds,\n            baseColors,\n        } = this\n\n        if (minPossibleValue === undefined || maxPossibleValue === undefined)\n            return []\n\n        return pairs(bucketThresholds).map(([min, max], index) => {\n            const baseColor = baseColors[index]\n            const color = customNumericColors[index] ?? baseColor\n            const label = customNumericLabels[index]\n\n            const roundingOptions = {\n                roundingMode: VariableRoundingMode.decimalPlaces,\n            }\n            const displayMin =\n                this.colorScaleColumn?.formatValueShort(min, roundingOptions) ??\n                min.toString()\n            const displayMax =\n                this.colorScaleColumn?.formatValueShort(max, roundingOptions) ??\n                max.toString()\n\n            const isFirst = index === 0\n            const isLast = index === bucketThresholds.length - 2\n            return new NumericBin({\n                isFirst,\n                isOpenLeft: isFirst && min > minPossibleValue,\n                isOpenRight: isLast && max < maxPossibleValue,\n                min,\n                max,\n                color,\n                label,\n                displayMin,\n                displayMax,\n            })\n        })\n    }\n\n    @computed get legendBins(): ColorScaleBin[] {\n        // todo: turn comment into unit test\n        // Will eventually produce something like this:\n        // [{ min: 10, max: 20, minText: \"10%\", maxText: \"20%\", color: '#faeaef' },\n        //  { min: 20, max: 30, minText: \"20%\", maxText: \"30%\", color: '#fefabc' },\n        //  { value: 'Foobar', text: \"Foobar Boop\", color: '#bbbbbb'}]\n        return [\n            ...this.numericLegendBins,\n            ...this.categoricalLegendBins,\n        ] as ColorScaleBin[]\n    }\n\n    @computed get categoricalLegendBins(): CategoricalBin[] {\n        const {\n            bucketThresholds,\n            baseColors,\n            hasNoDataBin,\n            hasProjectedDataBin,\n            categoricalValues,\n            customCategoryColors,\n            customCategoryLabels,\n            customHiddenCategories,\n            colorScheme,\n        } = this\n\n        let allCategoricalValues = categoricalValues\n\n        // Inject \"No data\" bin\n        if (hasNoDataBin && !allCategoricalValues.includes(NO_DATA_LABEL)) {\n            // The color scheme colors get applied in order, starting from first, and we only use\n            // as many colors as there are categorical values (excluding \"No data\").\n            // So in order to leave it colorless, we want to append the \"No data\" label last.\n            // -@danielgavrilov, 2020-06-02\n            allCategoricalValues = [...allCategoricalValues, NO_DATA_LABEL]\n        }\n\n        // Inject \"Projected data\" bin\n        if (hasProjectedDataBin) {\n            allCategoricalValues = [\n                ...allCategoricalValues,\n                PROJECTED_DATA_LABEL,\n            ]\n        }\n\n        return allCategoricalValues.map((value, index) => {\n            const boundingOffset = _.isEmpty(bucketThresholds)\n                ? 0\n                : bucketThresholds.length - 1\n\n            // Use colorMap if available and the value exists in it\n            let baseColor: Color | undefined\n            if (colorScheme.colorMap && value in colorScheme.colorMap) {\n                baseColor = colorScheme.colorMap[value]\n            } else {\n                baseColor = baseColors[index + boundingOffset]\n            }\n\n            const color = customCategoryColors[value] ?? baseColor\n            const label = customCategoryLabels[value] ?? value\n\n            return new CategoricalBin({\n                index,\n                value,\n                color,\n                label,\n                isHidden: !!customHiddenCategories[value],\n            })\n        })\n    }\n\n    getBinForValue(\n        value: CoreValueType | undefined\n    ): ColorScaleBin | undefined {\n        return value === undefined\n            ? undefined\n            : this.legendBins.find((bin) => bin.contains(value))\n    }\n\n    getColor(value: CoreValueType | undefined): string | undefined {\n        if (value === undefined) return this.noDataColor\n        return this.getBinForValue(value)?.color\n    }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/grapher/color/ColorScaleBin.d.ts

@@ -0,0 +1,55 @@
+import { Color, CoreValueType } from "../../types/index.js";
+interface BinProps {
+    color: Color;
+    label?: string;
+    patternRef?: string;
+}
+interface NumericBinProps extends BinProps {
+    isFirst: boolean;
+    isOpenLeft: boolean;
+    isOpenRight: boolean;
+    min: number;
+    max: number;
+    displayMin: string;
+    displayMax: string;
+}
+interface CategoricalBinProps extends BinProps {
+    index: number;
+    value: string;
+    label: string;
+    isHidden?: boolean;
+}
+declare abstract class AbstractColorScaleBin<T extends BinProps> {
+    props: T;
+    constructor(props: T);
+    get color(): string;
+    get patternRef(): string | undefined;
+    get label(): string | undefined;
+}
+export declare class NumericBin extends AbstractColorScaleBin<NumericBinProps> {
+    get min(): number;
+    get max(): number;
+    get minText(): string;
+    get maxText(): string;
+    get text(): string;
+    get isHidden(): boolean;
+    contains(value: CoreValueType | undefined): boolean;
+    equals(other: ColorScaleBin): boolean;
+}
+export declare class CategoricalBin extends AbstractColorScaleBin<CategoricalBinProps> {
+    get index(): number;
+    get value(): string;
+    get isHidden(): boolean | undefined;
+    get text(): string;
+    contains(value: CoreValueType | undefined, { isProjection }?: {
+        isProjection?: boolean;
+    }): boolean;
+    equals(other: ColorScaleBin): boolean;
+}
+export declare function isCategoricalBin(bin: ColorScaleBin): bin is CategoricalBin;
+export declare function isNumericBin(bin: ColorScaleBin): bin is NumericBin;
+export declare function isNoDataBin(bin: ColorScaleBin): bin is CategoricalBin;
+export declare function isProjectedDataBin(bin: ColorScaleBin): bin is CategoricalBin;
+export type ColorScaleBin = CategoricalBin | NumericBin;
+export {};
+//# sourceMappingURL=ColorScaleBin.d.ts.map

package/dist/grapher/color/ColorScaleBin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColorScaleBin.d.ts","sourceRoot":"","sources":["../../../src/grapher/color/ColorScaleBin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAG3D,UAAU,QAAQ;IACd,KAAK,EAAE,KAAK,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,UAAU,eAAgB,SAAQ,QAAQ;IACtC,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,OAAO,CAAA;IACnB,WAAW,EAAE,OAAO,CAAA;IACpB,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;CACrB;AAED,UAAU,mBAAoB,SAAQ,QAAQ;IAC1C,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,OAAO,CAAA;CACrB;AAED,uBAAe,qBAAqB,CAAC,CAAC,SAAS,QAAQ;IACnD,KAAK,EAAE,CAAC,CAAA;gBACI,KAAK,EAAE,CAAC;IAGpB,IAAI,KAAK,IAAI,MAAM,CAElB;IACD,IAAI,UAAU,IAAI,MAAM,GAAG,SAAS,CAEnC;IACD,IAAI,KAAK,IAAI,MAAM,GAAG,SAAS,CAE9B;CACJ;AAED,qBAAa,UAAW,SAAQ,qBAAqB,CAAC,eAAe,CAAC;IAClE,IAAI,GAAG,IAAI,MAAM,CAEhB;IACD,IAAI,GAAG,IAAI,MAAM,CAEhB;IACD,IAAI,OAAO,IAAI,MAAM,CAGpB;IACD,IAAI,OAAO,IAAI,MAAM,CAGpB;IACD,IAAI,IAAI,IAAI,MAAM,CAEjB;IACD,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,GAAG,OAAO;IAqBnD,MAAM,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO;CAOxC;AAED,qBAAa,cAAe,SAAQ,qBAAqB,CAAC,mBAAmB,CAAC;IAC1E,IAAI,KAAK,IAAI,MAAM,CAElB;IACD,IAAI,KAAK,IAAI,MAAM,CAElB;IACD,IAAI,QAAQ,IAAI,OAAO,GAAG,SAAS,CAElC;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,QAAQ,CACJ,KAAK,EAAE,aAAa,GAAG,SAAS,EAChC,EAAE,YAAoB,EAAE;;KAAK,GAC9B,OAAO;IAUV,MAAM,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO;CAMxC;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,aAAa,GAAG,GAAG,IAAI,cAAc,CAE1E;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,aAAa,GAAG,GAAG,IAAI,UAAU,CAElE;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,aAAa,GAAG,GAAG,IAAI,cAAc,CAErE;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,aAAa,GAAG,GAAG,IAAI,cAAc,CAE5E;AAED,MAAM,MAAM,aAAa,GAAG,cAAc,GAAG,UAAU,CAAA"}

package/dist/grapher/color/ColorScaleBin.js

@@ -0,0 +1,90 @@
+import { NO_DATA_LABEL, PROJECTED_DATA_LABEL } from "./ColorScale.js";
+class AbstractColorScaleBin {
+  constructor(props) {
+    this.props = props;
+  }
+  get color() {
+    return this.props.color;
+  }
+  get patternRef() {
+    return this.props.patternRef;
+  }
+  get label() {
+    return this.props.label;
+  }
+}
+class NumericBin extends AbstractColorScaleBin {
+  get min() {
+    return this.props.min;
+  }
+  get max() {
+    return this.props.max;
+  }
+  get minText() {
+    if (this.props.isOpenLeft) return "";
+    return this.props.displayMin;
+  }
+  get maxText() {
+    if (this.props.isOpenRight) return "";
+    return this.props.displayMax;
+  }
+  get text() {
+    return this.props.label || "";
+  }
+  get isHidden() {
+    return false;
+  }
+  contains(value) {
+    if (typeof value !== "number") return false;
+    if (this.props.isOpenLeft && value <= this.max) return true;
+    if (this.props.isOpenRight && value > this.min) return true;
+    if (this.props.isFirst) {
+      return value >= this.min && value <= this.max;
+    } else {
+      return value > this.min && value <= this.max;
+    }
+  }
+  equals(other) {
+    return other instanceof NumericBin && this.min === other.min && this.max === other.max;
+  }
+}
+class CategoricalBin extends AbstractColorScaleBin {
+  get index() {
+    return this.props.index;
+  }
+  get value() {
+    return this.props.value;
+  }
+  get isHidden() {
+    return this.props.isHidden;
+  }
+  get text() {
+    return this.props.label || this.props.value;
+  }
+  contains(value, { isProjection = false } = {}) {
+    return value === void 0 && this.props.value === NO_DATA_LABEL || value !== void 0 && isProjection && this.props.value === PROJECTED_DATA_LABEL || value !== void 0 && value === this.props.value;
+  }
+  equals(other) {
+    return other instanceof CategoricalBin && this.props.index === other.props.index;
+  }
+}
+function isCategoricalBin(bin) {
+  return bin instanceof CategoricalBin;
+}
+function isNumericBin(bin) {
+  return bin instanceof NumericBin;
+}
+function isNoDataBin(bin) {
+  return isCategoricalBin(bin) && bin.value === NO_DATA_LABEL;
+}
+function isProjectedDataBin(bin) {
+  return isCategoricalBin(bin) && bin.value === PROJECTED_DATA_LABEL;
+}
+export {
+  CategoricalBin,
+  NumericBin,
+  isCategoricalBin,
+  isNoDataBin,
+  isNumericBin,
+  isProjectedDataBin
+};

package/dist/grapher/color/ColorScaleBin.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["src/grapher/color/ColorScaleBin.ts"],
+  "sourcesContent": ["import { Color, CoreValueType } from \"../../types/index.js\"\nimport { NO_DATA_LABEL, PROJECTED_DATA_LABEL } from \"./ColorScale.js\"\n\ninterface BinProps {\n    color: Color\n    label?: string\n    patternRef?: string\n}\n\ninterface NumericBinProps extends BinProps {\n    isFirst: boolean\n    isOpenLeft: boolean\n    isOpenRight: boolean\n    min: number\n    max: number\n    displayMin: string\n    displayMax: string\n}\n\ninterface CategoricalBinProps extends BinProps {\n    index: number\n    value: string\n    label: string\n    isHidden?: boolean\n}\n\nabstract class AbstractColorScaleBin<T extends BinProps> {\n    props: T\n    constructor(props: T) {\n        this.props = props\n    }\n    get color(): string {\n        return this.props.color\n    }\n    get patternRef(): string | undefined {\n        return this.props.patternRef\n    }\n    get label(): string | undefined {\n        return this.props.label\n    }\n}\n\nexport class NumericBin extends AbstractColorScaleBin<NumericBinProps> {\n    get min(): number {\n        return this.props.min\n    }\n    get max(): number {\n        return this.props.max\n    }\n    get minText(): string {\n        if (this.props.isOpenLeft) return \"\"\n        return this.props.displayMin\n    }\n    get maxText(): string {\n        if (this.props.isOpenRight) return \"\"\n        return this.props.displayMax\n    }\n    get text(): string {\n        return this.props.label || \"\"\n    }\n    get isHidden(): boolean {\n        return false\n    }\n\n    contains(value: CoreValueType | undefined): boolean {\n        if (typeof value !== \"number\") return false\n\n        // In looking at this code, it is important to realise that `isOpenLeft`, `isOpenRight`,\n        // and `isFirst` are _not_ mutually exclusive.\n        // For example, if both `isOpenRight` and `isFirst` are set, then we effectively want `value >= min`.\n\n        // If the bin is left-open, we just need to check the right side\n        if (this.props.isOpenLeft && value <= this.max) return true\n\n        // If the bin is right-open, we just need to check the left side\n        if (this.props.isOpenRight && value > this.min) return true\n\n        // If this is the first bin of the chart, we want to include the `min` value and thus use greater-equals\n        if (this.props.isFirst) {\n            return value >= this.min && value <= this.max\n        } else {\n            return value > this.min && value <= this.max\n        }\n    }\n\n    equals(other: ColorScaleBin): boolean {\n        return (\n            other instanceof NumericBin &&\n            this.min === other.min &&\n            this.max === other.max\n        )\n    }\n}\n\nexport class CategoricalBin extends AbstractColorScaleBin<CategoricalBinProps> {\n    get index(): number {\n        return this.props.index\n    }\n    get value(): string {\n        return this.props.value\n    }\n    get isHidden(): boolean | undefined {\n        return this.props.isHidden\n    }\n\n    get text(): string {\n        return this.props.label || this.props.value\n    }\n\n    contains(\n        value: CoreValueType | undefined,\n        { isProjection = false } = {}\n    ): boolean {\n        return (\n            (value === undefined && this.props.value === NO_DATA_LABEL) ||\n            (value !== undefined &&\n                isProjection &&\n                this.props.value === PROJECTED_DATA_LABEL) ||\n            (value !== undefined && value === this.props.value)\n        )\n    }\n\n    equals(other: ColorScaleBin): boolean {\n        return (\n            other instanceof CategoricalBin &&\n            this.props.index === other.props.index\n        )\n    }\n}\n\nexport function isCategoricalBin(bin: ColorScaleBin): bin is CategoricalBin {\n    return bin instanceof CategoricalBin\n}\n\nexport function isNumericBin(bin: ColorScaleBin): bin is NumericBin {\n    return bin instanceof NumericBin\n}\n\nexport function isNoDataBin(bin: ColorScaleBin): bin is CategoricalBin {\n    return isCategoricalBin(bin) && bin.value === NO_DATA_LABEL\n}\n\nexport function isProjectedDataBin(bin: ColorScaleBin): bin is CategoricalBin {\n    return isCategoricalBin(bin) && bin.value === PROJECTED_DATA_LABEL\n}\n\nexport type ColorScaleBin = CategoricalBin | NumericBin\n"],
+  "mappings": "AACA,SAAS,eAAe,4BAA4B;AAyBpD,MAAe,sBAA0C;AAAA,EAErD,YAAY,OAAU;AAClB,SAAK,QAAQ;AAAA,EACjB;AAAA,EACA,IAAI,QAAgB;AAChB,WAAO,KAAK,MAAM;AAAA,EACtB;AAAA,EACA,IAAI,aAAiC;AACjC,WAAO,KAAK,MAAM;AAAA,EACtB;AAAA,EACA,IAAI,QAA4B;AAC5B,WAAO,KAAK,MAAM;AAAA,EACtB;AACJ;AAEO,MAAM,mBAAmB,sBAAuC;AAAA,EACnE,IAAI,MAAc;AACd,WAAO,KAAK,MAAM;AAAA,EACtB;AAAA,EACA,IAAI,MAAc;AACd,WAAO,KAAK,MAAM;AAAA,EACtB;AAAA,EACA,IAAI,UAAkB;AAClB,QAAI,KAAK,MAAM,WAAY,QAAO;AAClC,WAAO,KAAK,MAAM;AAAA,EACtB;AAAA,EACA,IAAI,UAAkB;AAClB,QAAI,KAAK,MAAM,YAAa,QAAO;AACnC,WAAO,KAAK,MAAM;AAAA,EACtB;AAAA,EACA,IAAI,OAAe;AACf,WAAO,KAAK,MAAM,SAAS;AAAA,EAC/B;AAAA,EACA,IAAI,WAAoB;AACpB,WAAO;AAAA,EACX;AAAA,EAEA,SAAS,OAA2C;AAChD,QAAI,OAAO,UAAU,SAAU,QAAO;AAOtC,QAAI,KAAK,MAAM,cAAc,SAAS,KAAK,IAAK,QAAO;AAGvD,QAAI,KAAK,MAAM,eAAe,QAAQ,KAAK,IAAK,QAAO;AAGvD,QAAI,KAAK,MAAM,SAAS;AACpB,aAAO,SAAS,KAAK,OAAO,SAAS,KAAK;AAAA,IAC9C,OAAO;AACH,aAAO,QAAQ,KAAK,OAAO,SAAS,KAAK;AAAA,IAC7C;AAAA,EACJ;AAAA,EAEA,OAAO,OAA+B;AAClC,WACI,iBAAiB,cACjB,KAAK,QAAQ,MAAM,OACnB,KAAK,QAAQ,MAAM;AAAA,EAE3B;AACJ;AAEO,MAAM,uBAAuB,sBAA2C;AAAA,EAC3E,IAAI,QAAgB;AAChB,WAAO,KAAK,MAAM;AAAA,EACtB;AAAA,EACA,IAAI,QAAgB;AAChB,WAAO,KAAK,MAAM;AAAA,EACtB;AAAA,EACA,IAAI,WAAgC;AAChC,WAAO,KAAK,MAAM;AAAA,EACtB;AAAA,EAEA,IAAI,OAAe;AACf,WAAO,KAAK,MAAM,SAAS,KAAK,MAAM;AAAA,EAC1C;AAAA,EAEA,SACI,OACA,EAAE,eAAe,MAAM,IAAI,CAAC,GACrB;AACP,WACK,UAAU,UAAa,KAAK,MAAM,UAAU,iBAC5C,UAAU,UACP,gBACA,KAAK,MAAM,UAAU,wBACxB,UAAU,UAAa,UAAU,KAAK,MAAM;AAAA,EAErD;AAAA,EAEA,OAAO,OAA+B;AAClC,WACI,iBAAiB,kBACjB,KAAK,MAAM,UAAU,MAAM,MAAM;AAAA,EAEzC;AACJ;AAEO,SAAS,iBAAiB,KAA2C;AACxE,SAAO,eAAe;AAC1B;AAEO,SAAS,aAAa,KAAuC;AAChE,SAAO,eAAe;AAC1B;AAEO,SAAS,YAAY,KAA2C;AACnE,SAAO,iBAAiB,GAAG,KAAK,IAAI,UAAU;AAClD;AAEO,SAAS,mBAAmB,KAA2C;AAC1E,SAAO,iBAAiB,GAAG,KAAK,IAAI,UAAU;AAClD;",
+  "names": []
+}

package/dist/grapher/color/ColorScaleConfig.d.ts

@@ -0,0 +1,52 @@
+import { Color, ColumnColorScale, BinningStrategyIncludingManual, ColorSchemeName, ColorScaleConfigInterface, MidpointMode } from "../../types/index.js";
+import { Persistable } from "../../utils/index.js";
+export declare class ColorScaleConfigDefaults implements ColorScaleConfigInterface {
+    /** Key for a colorbrewer scheme */
+    baseColorScheme: ColorSchemeName | undefined;
+    /** Reverse the order of colors in the color scheme (defined by `baseColorScheme`) */
+    colorSchemeInvert: boolean | undefined;
+    /** The strategy for generating the bin boundaries */
+    binningStrategy: BinningStrategyIncludingManual;
+    createBinForMidpoint?: boolean;
+    minValue?: number;
+    maxValue?: number;
+    midpoint?: number;
+    midpointMode?: MidpointMode;
+    /** Custom maximum brackets for each numeric bin. Only applied when strategy is `manual`. */
+    customNumericValues: number[];
+    /**
+     * Custom labels for each numeric bin. Only applied when strategy is `manual`.
+     * `undefined` or `null` falls back to default label.
+     * We need to handle `null` because JSON serializes `undefined` values
+     * inside arrays into `null`.
+     */
+    customNumericLabels: (string | undefined | null)[];
+    /** Whether `customNumericColors` are used to override the color scheme. */
+    customNumericColorsActive: boolean | undefined;
+    /**
+     * Override some or all colors for the numerical color legend.
+     * `undefined` or `null` falls back the color scheme color.
+     * We need to handle `null` because JSON serializes `undefined` values
+     * inside arrays into `null`.
+     */
+    customNumericColors: (Color | undefined | null)[];
+    customCategoryColors: {
+        [key: string]: string | undefined;
+    };
+    customCategoryLabels: {
+        [key: string]: string | undefined;
+    };
+    customHiddenCategories: {
+        [key: string]: true | undefined;
+    };
+    /** A custom legend description. Only used in ScatterPlot legend titles for now. */
+    legendDescription: string | undefined;
+    constructor();
+}
+export declare class ColorScaleConfig extends ColorScaleConfigDefaults implements Persistable {
+    updateFromObject(obj: Record<string, unknown>): void;
+    toObject(): ColorScaleConfigInterface;
+    constructor(obj?: Partial<ColorScaleConfig>);
+    static fromDSL(scale: ColumnColorScale): ColorScaleConfig | undefined;
+}
+//# sourceMappingURL=ColorScaleConfig.d.ts.map

package/dist/grapher/color/ColorScaleConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColorScaleConfig.d.ts","sourceRoot":"","sources":["../../../src/grapher/color/ColorScaleConfig.ts"],"names":[],"mappings":"AAEA,OAAO,EACH,KAAK,EACL,gBAAgB,EAChB,8BAA8B,EAC9B,eAAe,EACf,yBAAyB,EACzB,YAAY,EACf,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAIH,WAAW,EAEd,MAAM,sBAAsB,CAAA;AAI7B,qBAAa,wBAAyB,YAAW,yBAAyB;IAItE,mCAAmC;IACnC,eAAe,EAAE,eAAe,GAAG,SAAS,CAAY;IAExD,qFAAqF;IACrF,iBAAiB,EAAE,OAAO,GAAG,SAAS,CAAY;IAKlD,qDAAqD;IACrD,eAAe,EAAE,8BAA8B,CAAS;IACxD,oBAAoB,CAAC,EAAE,OAAO,CAAA;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE,YAAY,CAAA;IAE3B,4FAA4F;IAC5F,mBAAmB,EAAE,MAAM,EAAE,CAAK;IAClC;;;;;OAKG;IACH,mBAAmB,EAAE,CAAC,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC,EAAE,CAAK;IAEvD,2EAA2E;IAC3E,yBAAyB,EAAE,OAAO,GAAG,SAAS,CAAY;IAC1D;;;;;OAKG;IACH,mBAAmB,EAAE,CAAC,KAAK,GAAG,SAAS,GAAG,IAAI,CAAC,EAAE,CAAK;IAKtD,oBAAoB,EAAE;QAClB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;KACpC,CAAK;IAEN,oBAAoB,EAAE;QAClB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;KACpC,CAAK;IAGN,sBAAsB,EAAE;QACpB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;KAClC,CAAK;IAKN,mFAAmF;IACnF,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAY;;CAsBpD;AAED,qBAAa,gBACT,SAAQ,wBACR,YAAW,WAAW;IAEtB,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIpD,QAAQ,IAAI,yBAAyB;gBAOzB,GAAG,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC;IAK3C,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,gBAAgB,GAAG,gBAAgB,GAAG,SAAS;CA2ExE"}