@buildcanada/charts 0.3.7 → 0.3.8

package/dist/grapher/color/ColorScaleConfig.js

@@ -0,0 +1,139 @@
+import * as _ from "lodash-es";
+import { observable, makeObservable } from "mobx";
+import {
+  trimObject,
+  deleteRuntimeAndUnchangedProps,
+  objectWithPersistablesToObject,
+  updatePersistables
+} from "../../utils/index.js";
+import { NO_DATA_LABEL } from "./ColorScale.js";
+class ColorScaleConfigDefaults {
+  constructor() {
+    // Color scheme
+    // ============
+    /** Key for a colorbrewer scheme */
+    this.baseColorScheme = void 0;
+    /** Reverse the order of colors in the color scheme (defined by `baseColorScheme`) */
+    this.colorSchemeInvert = void 0;
+    // Numeric bins
+    // ============
+    /** The strategy for generating the bin boundaries */
+    this.binningStrategy = "auto";
+    /** Custom maximum brackets for each numeric bin. Only applied when strategy is `manual`. */
+    this.customNumericValues = [];
+    /**
+     * 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`.
+     */
+    this.customNumericLabels = [];
+    /** Whether `customNumericColors` are used to override the color scheme. */
+    this.customNumericColorsActive = void 0;
+    /**
+     * 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`.
+     */
+    this.customNumericColors = [];
+    // Categorical bins
+    // ================
+    this.customCategoryColors = {};
+    this.customCategoryLabels = {};
+    // Allow hiding categories from the legend
+    this.customHiddenCategories = {};
+    // Other
+    // =====
+    /** A custom legend description. Only used in ScatterPlot legend titles for now. */
+    this.legendDescription = void 0;
+    makeObservable(this, {
+      baseColorScheme: observable,
+      colorSchemeInvert: observable,
+      binningStrategy: observable,
+      customNumericValues: observable,
+      customNumericLabels: observable,
+      customNumericColorsActive: observable,
+      customNumericColors: observable,
+      customCategoryColors: observable.ref,
+      customCategoryLabels: observable.ref,
+      customHiddenCategories: observable.ref,
+      legendDescription: observable,
+      createBinForMidpoint: observable,
+      minValue: observable,
+      maxValue: observable,
+      midpoint: observable,
+      midpointMode: observable
+    });
+  }
+}
+class ColorScaleConfig extends ColorScaleConfigDefaults {
+  updateFromObject(obj) {
+    _.extend(this, obj);
+  }
+  toObject() {
+    const obj = objectWithPersistablesToObject(this);
+    deleteRuntimeAndUnchangedProps(obj, new ColorScaleConfigDefaults());
+    return trimObject(obj);
+  }
+  constructor(obj) {
+    super();
+    updatePersistables(this, obj);
+  }
+  static fromDSL(scale) {
+    const colorSchemeInvert = scale.colorScaleInvert;
+    const baseColorScheme = scale.colorScaleScheme;
+    const customNumericValues = [];
+    const customNumericLabels = [];
+    const customNumericColors = [];
+    if (scale.colorScaleNumericBins) {
+      customNumericValues.push(scale.colorScaleNumericMinValue ?? 0);
+      scale.colorScaleNumericBins.split(INTER_BIN_DELIMITER).forEach((bin) => {
+        const [value, color, ...label] = bin.split(
+          INTRA_BIN_DELIMITER
+        );
+        if (!value) return;
+        customNumericValues.push(parseFloat(value));
+        customNumericColors.push(color?.trim() || void 0);
+        customNumericLabels.push(
+          label.join(INTRA_BIN_DELIMITER).trim() || void 0
+        );
+      });
+    }
+    const customNumericColorsActive = customNumericColors.length > 0 ? true : void 0;
+    const customCategoryColors = {};
+    const customCategoryLabels = {};
+    scale.colorScaleCategoricalBins?.split(INTER_BIN_DELIMITER).forEach((bin) => {
+      const [value, color, ...label] = bin.split(
+        INTRA_BIN_DELIMITER
+      );
+      if (!value) return;
+      customCategoryColors[value] = color?.trim() || void 0;
+      customCategoryLabels[value] = label.join(INTRA_BIN_DELIMITER).trim() || void 0;
+    });
+    if (scale.colorScaleNoDataLabel) {
+      customCategoryLabels[NO_DATA_LABEL] = scale.colorScaleNoDataLabel;
+    }
+    const binningStrategy = scale.colorScaleBinningStrategy ? scale.colorScaleBinningStrategy : scale.colorScaleNumericBins || scale.colorScaleCategoricalBins ? "manual" : void 0;
+    const legendDescription = scale.colorScaleLegendDescription;
+    const trimmed = trimObject({
+      colorSchemeInvert,
+      baseColorScheme,
+      binningStrategy,
+      customNumericValues,
+      customNumericColors,
+      customNumericColorsActive,
+      customNumericLabels,
+      customCategoryLabels,
+      customCategoryColors,
+      legendDescription
+    });
+    return _.isEmpty(trimmed) ? void 0 : new ColorScaleConfig(trimmed);
+  }
+}
+const INTER_BIN_DELIMITER = ";";
+const INTRA_BIN_DELIMITER = ",";
+export {
+  ColorScaleConfig,
+  ColorScaleConfigDefaults
+};

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["src/grapher/color/ColorScaleConfig.ts"],
+  "sourcesContent": ["import * as _ from \"lodash-es\"\nimport { observable, makeObservable } from \"mobx\"\nimport {\n    Color,\n    ColumnColorScale,\n    BinningStrategyIncludingManual,\n    ColorSchemeName,\n    ColorScaleConfigInterface,\n    MidpointMode,\n} from \"../../types/index.js\"\nimport {\n    trimObject,\n    deleteRuntimeAndUnchangedProps,\n    objectWithPersistablesToObject,\n    Persistable,\n    updatePersistables,\n} from \"../../utils/index.js\"\n\nimport { NO_DATA_LABEL } from \"./ColorScale.js\"\n\nexport class ColorScaleConfigDefaults implements ColorScaleConfigInterface {\n    // Color scheme\n    // ============\n\n    /** Key for a colorbrewer scheme */\n    baseColorScheme: ColorSchemeName | undefined = undefined\n\n    /** Reverse the order of colors in the color scheme (defined by `baseColorScheme`) */\n    colorSchemeInvert: boolean | undefined = undefined\n\n    // Numeric bins\n    // ============\n\n    /** The strategy for generating the bin boundaries */\n    binningStrategy: BinningStrategyIncludingManual = \"auto\"\n    createBinForMidpoint?: boolean\n    minValue?: number\n    maxValue?: number\n    midpoint?: number\n    midpointMode?: MidpointMode\n\n    /** Custom maximum brackets for each numeric bin. Only applied when strategy is `manual`. */\n    customNumericValues: number[] = []\n    /**\n     * Custom labels for each numeric bin. Only applied when strategy is `manual`.\n     * `undefined` or `null` falls back to default label.\n     * We need to handle `null` because JSON serializes `undefined` values\n     * inside arrays into `null`.\n     */\n    customNumericLabels: (string | undefined | null)[] = []\n\n    /** Whether `customNumericColors` are used to override the color scheme. */\n    customNumericColorsActive: boolean | undefined = undefined\n    /**\n     * Override some or all colors for the numerical color legend.\n     * `undefined` or `null` falls back the color scheme color.\n     * We need to handle `null` because JSON serializes `undefined` values\n     * inside arrays into `null`.\n     */\n    customNumericColors: (Color | undefined | null)[] = []\n\n    // Categorical bins\n    // ================\n\n    customCategoryColors: {\n        [key: string]: string | undefined\n    } = {}\n\n    customCategoryLabels: {\n        [key: string]: string | undefined\n    } = {}\n\n    // Allow hiding categories from the legend\n    customHiddenCategories: {\n        [key: string]: true | undefined\n    } = {}\n\n    // Other\n    // =====\n\n    /** A custom legend description. Only used in ScatterPlot legend titles for now. */\n    legendDescription: string | undefined = undefined\n\n    constructor() {\n        makeObservable(this, {\n            baseColorScheme: observable,\n            colorSchemeInvert: observable,\n            binningStrategy: observable,\n            customNumericValues: observable,\n            customNumericLabels: observable,\n            customNumericColorsActive: observable,\n            customNumericColors: observable,\n            customCategoryColors: observable.ref,\n            customCategoryLabels: observable.ref,\n            customHiddenCategories: observable.ref,\n            legendDescription: observable,\n            createBinForMidpoint: observable,\n            minValue: observable,\n            maxValue: observable,\n            midpoint: observable,\n            midpointMode: observable,\n        })\n    }\n}\n\nexport class ColorScaleConfig\n    extends ColorScaleConfigDefaults\n    implements Persistable\n{\n    updateFromObject(obj: Record<string, unknown>): void {\n        _.extend(this, obj)\n    }\n\n    toObject(): ColorScaleConfigInterface {\n        const obj: ColorScaleConfigInterface =\n            objectWithPersistablesToObject(this)\n        deleteRuntimeAndUnchangedProps(obj, new ColorScaleConfigDefaults())\n        return trimObject(obj)\n    }\n\n    constructor(obj?: Partial<ColorScaleConfig>) {\n        super()\n        updatePersistables(this, obj)\n    }\n\n    static fromDSL(scale: ColumnColorScale): ColorScaleConfig | undefined {\n        const colorSchemeInvert = scale.colorScaleInvert\n        const baseColorScheme = scale.colorScaleScheme as ColorSchemeName\n\n        const customNumericValues: number[] = []\n        const customNumericLabels: (string | undefined)[] = []\n        const customNumericColors: (Color | undefined)[] = []\n\n        if (scale.colorScaleNumericBins) {\n            customNumericValues.push(scale.colorScaleNumericMinValue ?? 0)\n\n            scale.colorScaleNumericBins\n                .split(INTER_BIN_DELIMITER)\n                .forEach((bin: string): void => {\n                    const [value, color, ...label] = bin.split(\n                        INTRA_BIN_DELIMITER\n                    ) as (string | undefined)[]\n                    if (!value) return\n                    customNumericValues.push(parseFloat(value))\n                    customNumericColors.push(color?.trim() || undefined)\n                    customNumericLabels.push(\n                        label.join(INTRA_BIN_DELIMITER).trim() || undefined\n                    )\n                })\n        }\n\n        const customNumericColorsActive =\n            customNumericColors.length > 0 ? true : undefined\n\n        const customCategoryColors: {\n            [key: string]: string | undefined\n        } = {}\n        const customCategoryLabels: {\n            [key: string]: string | undefined\n        } = {}\n        scale.colorScaleCategoricalBins\n            ?.split(INTER_BIN_DELIMITER)\n            .forEach((bin: string): void => {\n                const [value, color, ...label] = bin.split(\n                    INTRA_BIN_DELIMITER\n                ) as (string | undefined)[]\n                if (!value) return\n                customCategoryColors[value] = color?.trim() || undefined\n                customCategoryLabels[value] =\n                    label.join(INTRA_BIN_DELIMITER).trim() || undefined\n            })\n        if (scale.colorScaleNoDataLabel) {\n            customCategoryLabels[NO_DATA_LABEL] = scale.colorScaleNoDataLabel\n        }\n\n        // Use user-defined binning strategy, otherwise set to manual if user has\n        // defined custom bins\n        const binningStrategy = scale.colorScaleBinningStrategy\n            ? (scale.colorScaleBinningStrategy as BinningStrategyIncludingManual)\n            : scale.colorScaleNumericBins || scale.colorScaleCategoricalBins\n              ? \"manual\"\n              : undefined\n\n        const legendDescription = scale.colorScaleLegendDescription\n\n        const trimmed: Partial<ColorScaleConfig> = trimObject({\n            colorSchemeInvert,\n            baseColorScheme,\n            binningStrategy,\n            customNumericValues,\n            customNumericColors,\n            customNumericColorsActive,\n            customNumericLabels,\n            customCategoryLabels,\n            customCategoryColors,\n            legendDescription,\n        })\n\n        return _.isEmpty(trimmed) ? undefined : new ColorScaleConfig(trimmed)\n    }\n}\n\nconst INTER_BIN_DELIMITER = \";\"\nconst INTRA_BIN_DELIMITER = \",\"\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,20 @@
+import { Color } from "../../utils/index.js";
+import { ColorSchemeInterface } from "../../types/index.js";
+export declare class ColorScheme implements ColorSchemeInterface {
+    name: string;
+    colorSets: Color[][];
+    singleColorScale: boolean;
+    isDistinct: boolean;
+    colorMap?: Record<string, Color>;
+    constructor(name: string, colorSets: Color[][], singleColorScale?: boolean, isDistinct?: boolean, colorMap?: Record<string, Color>);
+    improviseGradientFromShorter(shortColors: Color[], numColors: number): Color[];
+    improviseGradientFromLonger(knownColors: Color[], numColors: number): Color[];
+    getGradientColors(numColors: number): Color[];
+    getDistinctColors(numColors: number): Color[];
+    getColors(numColors: number): Color[];
+    getUniqValueColorMap(uniqValues: any[], inverseOrder?: boolean): Map<number, string>;
+    static fromObject(name: string, colorSets: {
+        [key: string]: Color[];
+    }, singleColorScale?: boolean): ColorScheme;
+}
+//# sourceMappingURL=ColorScheme.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ColorScheme.d.ts","sourceRoot":"","sources":["../../../src/grapher/color/ColorScheme.ts"],"names":[],"mappings":"AAIA,OAAO,EAAuB,KAAK,EAAE,MAAM,sBAAsB,CAAA;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAG3D,qBAAa,WAAY,YAAW,oBAAoB;IACpD,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,KAAK,EAAE,EAAE,CAAA;IACpB,gBAAgB,EAAE,OAAO,CAAA;IACzB,UAAU,EAAE,OAAO,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;gBAG5B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,KAAK,EAAE,EAAE,EACpB,gBAAgB,CAAC,EAAE,OAAO,EAC1B,UAAU,CAAC,EAAE,OAAO,EACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;IAUpC,4BAA4B,CACxB,WAAW,EAAE,KAAK,EAAE,EACpB,SAAS,EAAE,MAAM,GAClB,KAAK,EAAE;IAiBV,2BAA2B,CACvB,WAAW,EAAE,KAAK,EAAE,EACpB,SAAS,EAAE,MAAM,GAClB,KAAK,EAAE;IASV,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK,EAAE;IAiB7C,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK,EAAE;IAuB7C,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK,EAAE;IAMrC,oBAAoB,CAChB,UAAU,EAAE,GAAG,EAAE,EACjB,YAAY,CAAC,EAAE,OAAO,GACvB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAatB,MAAM,CAAC,UAAU,CACb,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,EAAE,CAAA;KAAE,EACrC,gBAAgB,CAAC,EAAE,OAAO,GAC3B,WAAW;CAQjB"}

package/dist/grapher/color/ColorScheme.js

@@ -0,0 +1,86 @@
+import * as _ from "lodash-es";
+import { rgb } from "d3-color";
+import { interpolate } from "d3-interpolate";
+import { lastOfNonEmptyArray } from "../../utils/index.js";
+import { interpolateArray } from "./ColorUtils.js";
+class ColorScheme {
+  constructor(name, colorSets, singleColorScale, isDistinct, colorMap) {
+    this.name = name;
+    this.colorSets = [];
+    this.singleColorScale = !!singleColorScale;
+    this.isDistinct = !!isDistinct;
+    this.colorMap = colorMap;
+    colorSets.forEach((set) => this.colorSets[set.length] = set);
+  }
+  improviseGradientFromShorter(shortColors, numColors) {
+    const newColors = _.clone(shortColors);
+    while (newColors.length < numColors) {
+      for (let index = newColors.length - 1; index > 0; index -= 1) {
+        const startColor = rgb(newColors[index - 1]);
+        const endColor = rgb(newColors[index]);
+        const newColor = interpolate(startColor, endColor)(0.5);
+        newColors.splice(index, 0, newColor);
+        if (newColors.length >= numColors) break;
+      }
+    }
+    return newColors;
+  }
+  improviseGradientFromLonger(knownColors, numColors) {
+    const newColors = [];
+    const scale = interpolateArray(knownColors);
+    for (let index = 0; index < numColors; index++) {
+      newColors.push(scale(index / numColors));
+    }
+    return newColors;
+  }
+  getGradientColors(numColors) {
+    const { colorSets } = this;
+    if (colorSets[numColors]) return _.clone(colorSets[numColors]);
+    const prevColors = colorSets.toReversed().find((set) => set && set.length < numColors);
+    if (prevColors)
+      return this.improviseGradientFromShorter(prevColors, numColors);
+    else
+      return this.improviseGradientFromLonger(
+        colorSets.find((set) => !!set),
+        numColors
+      );
+  }
+  getDistinctColors(numColors) {
+    const { colorSets } = this;
+    if (colorSets.length === 0) return [];
+    if (colorSets[numColors]) return _.clone(colorSets[numColors]);
+    if (numColors > colorSets.length - 1) {
+      const colorSet = lastOfNonEmptyArray(colorSets);
+      if (colorSet.length === 1) return Array(numColors).fill(colorSet[0]);
+      return this.improviseGradientFromShorter(colorSet, numColors);
+    }
+    for (let i = numColors; i < colorSets.length; i++) {
+      if (colorSets[i]) {
+        return colorSets[i].slice(0, numColors);
+      }
+    }
+    return [];
+  }
+  getColors(numColors) {
+    return this.isDistinct ? this.getDistinctColors(numColors) : this.getGradientColors(numColors);
+  }
+  getUniqValueColorMap(uniqValues, inverseOrder) {
+    const colors = this.getColors(uniqValues.length) || [];
+    if (inverseOrder) colors.reverse();
+    const colorByValue = /* @__PURE__ */ new Map();
+    uniqValues.forEach(
+      (value, index) => colorByValue.set(value, colors[index])
+    );
+    return colorByValue;
+  }
+  static fromObject(name, colorSets, singleColorScale) {
+    const colorSetsArray = [];
+    Object.keys(colorSets).forEach(
+      (numColors) => colorSetsArray[+numColors] = colorSets[numColors]
+    );
+    return new ColorScheme(name, colorSetsArray, singleColorScale);
+  }
+}
+export {
+  ColorScheme
+};

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["src/grapher/color/ColorScheme.ts"],
+  "sourcesContent": ["// @ts-nocheck\nimport * as _ from \"lodash-es\"\nimport { rgb } from \"d3-color\"\nimport { interpolate } from \"d3-interpolate\"\nimport { lastOfNonEmptyArray, Color } from \"../../utils/index.js\"\nimport { ColorSchemeInterface } from \"../../types/index.js\"\nimport { interpolateArray } from \"./ColorUtils.js\"\n\nexport class ColorScheme implements ColorSchemeInterface {\n    name: string\n    colorSets: Color[][]\n    singleColorScale: boolean\n    isDistinct: boolean\n    colorMap?: Record<string, Color>\n\n    constructor(\n        name: string,\n        colorSets: Color[][],\n        singleColorScale?: boolean,\n        isDistinct?: boolean,\n        colorMap?: Record<string, Color>\n    ) {\n        this.name = name\n        this.colorSets = []\n        this.singleColorScale = !!singleColorScale\n        this.isDistinct = !!isDistinct\n        this.colorMap = colorMap\n        colorSets.forEach((set) => (this.colorSets[set.length] = set))\n    }\n\n    improviseGradientFromShorter(\n        shortColors: Color[],\n        numColors: number\n    ): Color[] {\n        const newColors = _.clone(shortColors)\n\n        while (newColors.length < numColors) {\n            for (let index = newColors.length - 1; index > 0; index -= 1) {\n                const startColor = rgb(newColors[index - 1])\n                const endColor = rgb(newColors[index])\n                const newColor = interpolate(startColor, endColor)(0.5)\n                newColors.splice(index, 0, newColor)\n\n                if (newColors.length >= numColors) break\n            }\n        }\n\n        return newColors\n    }\n\n    improviseGradientFromLonger(\n        knownColors: Color[],\n        numColors: number\n    ): Color[] {\n        const newColors = []\n        const scale = interpolateArray(knownColors)\n        for (let index = 0; index < numColors; index++) {\n            newColors.push(scale(index / numColors))\n        }\n        return newColors\n    }\n\n    getGradientColors(numColors: number): Color[] {\n        const { colorSets } = this\n\n        if (colorSets[numColors]) return _.clone(colorSets[numColors])\n\n        const prevColors = colorSets\n            .toReversed()\n            .find((set) => set && set.length < numColors)\n        if (prevColors)\n            return this.improviseGradientFromShorter(prevColors, numColors)\n        else\n            return this.improviseGradientFromLonger(\n                colorSets.find((set) => !!set) as Color[],\n                numColors\n            )\n    }\n\n    getDistinctColors(numColors: number): Color[] {\n        const { colorSets } = this\n        if (colorSets.length === 0) return []\n        if (colorSets[numColors]) return _.clone(colorSets[numColors])\n\n        if (numColors > colorSets.length - 1) {\n            // If more colors are wanted than we have defined, have to improvise\n            const colorSet = lastOfNonEmptyArray(colorSets)\n            // Special case for colorSchemes with a single color where the usual interpolation would not work\n            if (colorSet.length === 1) return Array(numColors).fill(colorSet[0])\n            return this.improviseGradientFromShorter(colorSet, numColors)\n        }\n\n        // We have enough colors but not a specific set for this number-- improvise from the closest longer set\n        for (let i = numColors; i < colorSets.length; i++) {\n            if (colorSets[i]) {\n                return colorSets[i].slice(0, numColors)\n            }\n        }\n\n        return []\n    }\n\n    getColors(numColors: number): Color[] {\n        return this.isDistinct\n            ? this.getDistinctColors(numColors)\n            : this.getGradientColors(numColors)\n    }\n\n    getUniqValueColorMap(\n        uniqValues: any[],\n        inverseOrder?: boolean\n    ): Map<number, string> {\n        const colors = this.getColors(uniqValues.length) || []\n        if (inverseOrder) colors.reverse()\n\n        // We want to display same values using the same color, e.g. two values of 100 get the same shade of green\n        // Therefore, we create a map from all possible (unique) values to the corresponding color\n        const colorByValue = new Map<number, Color>()\n        uniqValues.forEach((value, index) =>\n            colorByValue.set(value, colors[index])\n        )\n        return colorByValue\n    }\n\n    static fromObject(\n        name: string,\n        colorSets: { [key: string]: Color[] },\n        singleColorScale?: boolean\n    ): ColorScheme {\n        const colorSetsArray: Color[][] = []\n        Object.keys(colorSets).forEach(\n            (numColors): string[] =>\n                (colorSetsArray[+numColors] = colorSets[numColors])\n        )\n        return new ColorScheme(name, colorSetsArray, singleColorScale)\n    }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,9 @@
+import { ColorScheme } from "./ColorScheme.js";
+import { ColorSchemeName, GrapherChartOrMapType } from "../../types/index.js";
+export declare const ColorSchemes: {
+    get: (name: ColorSchemeName) => ColorScheme;
+};
+export declare function getColorSchemeForChartType(type: GrapherChartOrMapType): {
+    [key in ColorSchemeName]: ColorScheme;
+};
+//# sourceMappingURL=ColorSchemes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ColorSchemes.d.ts","sourceRoot":"","sources":["../../../src/grapher/color/ColorSchemes.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAE9C,OAAO,EAGH,eAAe,EAEf,qBAAqB,EACxB,MAAM,sBAAsB,CAAA;AAuG7B,eAAO,MAAM,YAAY;gBACT,eAAe,KAAG,WAAW;CAW5C,CAAA;AAWD,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,qBAAqB,GAAG;KACpE,GAAG,IAAI,eAAe,GAAG,WAAW;CACxC,CAUA"}

package/dist/grapher/color/ColorSchemes.js

@@ -0,0 +1,121 @@
+import * as _ from "lodash-es";
+import { CustomColorSchemes } from "./CustomSchemes.js";
+import { ColorScheme } from "./ColorScheme.js";
+import { match } from "ts-pattern";
+import {
+  GRAPHER_CHART_TYPES,
+  ColorSchemeName,
+  GRAPHER_MAP_TYPE
+} from "../../types/index.js";
+import { getColorBrewerScheme } from "./ColorBrewerSchemes.js";
+function getPreferredSchemesByType(type) {
+  return match(type).with(GRAPHER_CHART_TYPES.DiscreteBar, () => [
+    ColorSchemeName.SingleColorDenim,
+    ColorSchemeName.SingleColorDustyCoral,
+    ColorSchemeName.SingleColorPurple,
+    ColorSchemeName.SingleColorTeal,
+    ColorSchemeName.SingleColorDarkCopper
+  ]).with(GRAPHER_CHART_TYPES.LineChart, () => [
+    ColorSchemeName.DistinctLines
+  ]).with(GRAPHER_CHART_TYPES.Marimekko, () => [
+    ColorSchemeName.continents,
+    ColorSchemeName.SingleColorDenim,
+    ColorSchemeName.SingleColorDustyCoral,
+    ColorSchemeName.SingleColorPurple,
+    ColorSchemeName.SingleColorTeal,
+    ColorSchemeName.SingleColorDarkCopper,
+    ColorSchemeName.CategoricalA,
+    ColorSchemeName.CategoricalB,
+    ColorSchemeName.CategoricalC,
+    ColorSchemeName.CategoricalD,
+    ColorSchemeName.CategoricalE
+  ]).with(GRAPHER_CHART_TYPES.ScatterPlot, () => [
+    ColorSchemeName.continents,
+    ColorSchemeName.DistinctLines
+  ]).with(GRAPHER_CHART_TYPES.SlopeChart, () => [
+    ColorSchemeName.continents,
+    ColorSchemeName.DistinctLines
+  ]).with(GRAPHER_CHART_TYPES.StackedArea, () => [
+    ColorSchemeName["distinct"],
+    ColorSchemeName.CategoricalA,
+    ColorSchemeName.CategoricalB,
+    ColorSchemeName.CategoricalC,
+    ColorSchemeName.CategoricalD,
+    ColorSchemeName.CategoricalE,
+    ColorSchemeName.SingleColorGradientDenim,
+    ColorSchemeName.SingleColorGradientTeal,
+    ColorSchemeName.SingleColorGradientPurple,
+    ColorSchemeName.SingleColorGradientDustyCoral,
+    ColorSchemeName.SingleColorGradientDarkCopper
+  ]).with(GRAPHER_CHART_TYPES.StackedBar, () => [
+    ColorSchemeName["distinct"],
+    ColorSchemeName.CategoricalA,
+    ColorSchemeName.CategoricalB,
+    ColorSchemeName.CategoricalC,
+    ColorSchemeName.CategoricalD,
+    ColorSchemeName.CategoricalE,
+    ColorSchemeName.SingleColorGradientDenim,
+    ColorSchemeName.SingleColorGradientTeal,
+    ColorSchemeName.SingleColorGradientPurple,
+    ColorSchemeName.SingleColorGradientDustyCoral,
+    ColorSchemeName.SingleColorGradientDarkCopper
+  ]).with(GRAPHER_CHART_TYPES.StackedDiscreteBar, () => [
+    ColorSchemeName["distinct"],
+    ColorSchemeName.CategoricalA,
+    ColorSchemeName.CategoricalB,
+    ColorSchemeName.CategoricalC,
+    ColorSchemeName.CategoricalD,
+    ColorSchemeName.CategoricalE,
+    ColorSchemeName.SingleColorGradientDenim,
+    ColorSchemeName.SingleColorGradientTeal,
+    ColorSchemeName.SingleColorGradientPurple,
+    ColorSchemeName.SingleColorGradientDustyCoral,
+    ColorSchemeName.SingleColorGradientDarkCopper
+  ]).with(GRAPHER_MAP_TYPE, () => [
+    ColorSchemeName.BinaryMapPaletteA,
+    ColorSchemeName.BinaryMapPaletteB,
+    ColorSchemeName.BinaryMapPaletteC,
+    ColorSchemeName.BinaryMapPaletteD,
+    ColorSchemeName.BinaryMapPaletteE
+  ]).exhaustive();
+}
+const initColorScheme = (scheme) => new ColorScheme(
+  scheme.displayName ?? scheme.name,
+  scheme.colorSets,
+  scheme.singleColorScale,
+  scheme.isDistinct,
+  scheme.colorMap
+);
+const _colorSchemes = /* @__PURE__ */ new Map();
+const ColorSchemes = {
+  get: (name) => {
+    if (!_colorSchemes.has(name)) {
+      const schemeRaw = getColorBrewerScheme(name) ?? CustomColorSchemes.find((s) => s.name === name);
+      if (!schemeRaw) throw new Error(`Color scheme ${name} not found`);
+      const scheme = initColorScheme(schemeRaw);
+      _colorSchemes.set(name, scheme);
+    }
+    return _colorSchemes.get(name);
+  }
+};
+const getAllColorSchemes = () => {
+  return new Map(
+    Object.keys(ColorSchemeName).map((key) => [
+      key,
+      ColorSchemes.get(key)
+    ])
+  );
+};
+function getColorSchemeForChartType(type) {
+  const preferred = new Set(getPreferredSchemesByType(type));
+  const allSchemes = getAllColorSchemes();
+  const [preferredSchemes, otherSchemes] = _.partition(
+    [...allSchemes.entries()],
+    (schemeKeyValue) => preferred.has(schemeKeyValue[0])
+  );
+  return Object.fromEntries([...preferredSchemes, ...otherSchemes]);
+}
+export {
+  ColorSchemes,
+  getColorSchemeForChartType
+};

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["src/grapher/color/ColorSchemes.ts"],
+  "sourcesContent": ["import * as _ from \"lodash-es\"\nimport { CustomColorSchemes } from \"./CustomSchemes.js\"\nimport { ColorScheme } from \"./ColorScheme.js\"\nimport { match } from \"ts-pattern\"\nimport {\n    GRAPHER_CHART_TYPES,\n    ColorSchemeInterface,\n    ColorSchemeName,\n    GRAPHER_MAP_TYPE,\n    GrapherChartOrMapType,\n} from \"../../types/index.js\"\nimport { getColorBrewerScheme } from \"./ColorBrewerSchemes.js\"\n\nfunction getPreferredSchemesByType(\n    type: GrapherChartOrMapType\n): ColorSchemeName[] {\n    // This function could also be a Map<GrapherChartOrMapType, ColorName[]> but\n    // by doing it as a function usign ts-pattern.match we get compile\n    // time safety that all enum cases in GrapherChartOrMapType are always handled here\n    return match(type)\n        .with(GRAPHER_CHART_TYPES.DiscreteBar, () => [\n            ColorSchemeName.SingleColorDenim,\n            ColorSchemeName.SingleColorDustyCoral,\n            ColorSchemeName.SingleColorPurple,\n            ColorSchemeName.SingleColorTeal,\n            ColorSchemeName.SingleColorDarkCopper,\n        ])\n        .with(GRAPHER_CHART_TYPES.LineChart, () => [\n            ColorSchemeName.DistinctLines,\n        ])\n        .with(GRAPHER_CHART_TYPES.Marimekko, () => [\n            ColorSchemeName.continents,\n            ColorSchemeName.SingleColorDenim,\n            ColorSchemeName.SingleColorDustyCoral,\n            ColorSchemeName.SingleColorPurple,\n            ColorSchemeName.SingleColorTeal,\n            ColorSchemeName.SingleColorDarkCopper,\n            ColorSchemeName.CategoricalA,\n            ColorSchemeName.CategoricalB,\n            ColorSchemeName.CategoricalC,\n            ColorSchemeName.CategoricalD,\n            ColorSchemeName.CategoricalE,\n        ])\n        .with(GRAPHER_CHART_TYPES.ScatterPlot, () => [\n            ColorSchemeName.continents,\n            ColorSchemeName.DistinctLines,\n        ])\n        .with(GRAPHER_CHART_TYPES.SlopeChart, () => [\n            ColorSchemeName.continents,\n            ColorSchemeName.DistinctLines,\n        ])\n        .with(GRAPHER_CHART_TYPES.StackedArea, () => [\n            ColorSchemeName[\"distinct\"],\n            ColorSchemeName.CategoricalA,\n            ColorSchemeName.CategoricalB,\n            ColorSchemeName.CategoricalC,\n            ColorSchemeName.CategoricalD,\n            ColorSchemeName.CategoricalE,\n            ColorSchemeName.SingleColorGradientDenim,\n            ColorSchemeName.SingleColorGradientTeal,\n            ColorSchemeName.SingleColorGradientPurple,\n            ColorSchemeName.SingleColorGradientDustyCoral,\n            ColorSchemeName.SingleColorGradientDarkCopper,\n        ])\n        .with(GRAPHER_CHART_TYPES.StackedBar, () => [\n            ColorSchemeName[\"distinct\"],\n            ColorSchemeName.CategoricalA,\n            ColorSchemeName.CategoricalB,\n            ColorSchemeName.CategoricalC,\n            ColorSchemeName.CategoricalD,\n            ColorSchemeName.CategoricalE,\n            ColorSchemeName.SingleColorGradientDenim,\n            ColorSchemeName.SingleColorGradientTeal,\n            ColorSchemeName.SingleColorGradientPurple,\n            ColorSchemeName.SingleColorGradientDustyCoral,\n            ColorSchemeName.SingleColorGradientDarkCopper,\n        ])\n        .with(GRAPHER_CHART_TYPES.StackedDiscreteBar, () => [\n            ColorSchemeName[\"distinct\"],\n            ColorSchemeName.CategoricalA,\n            ColorSchemeName.CategoricalB,\n            ColorSchemeName.CategoricalC,\n            ColorSchemeName.CategoricalD,\n            ColorSchemeName.CategoricalE,\n            ColorSchemeName.SingleColorGradientDenim,\n            ColorSchemeName.SingleColorGradientTeal,\n            ColorSchemeName.SingleColorGradientPurple,\n            ColorSchemeName.SingleColorGradientDustyCoral,\n            ColorSchemeName.SingleColorGradientDarkCopper,\n        ])\n        .with(GRAPHER_MAP_TYPE, () => [\n            ColorSchemeName.BinaryMapPaletteA,\n            ColorSchemeName.BinaryMapPaletteB,\n            ColorSchemeName.BinaryMapPaletteC,\n            ColorSchemeName.BinaryMapPaletteD,\n            ColorSchemeName.BinaryMapPaletteE,\n        ])\n        .exhaustive()\n}\n\nconst initColorScheme = (scheme: ColorSchemeInterface): ColorScheme =>\n    new ColorScheme(\n        scheme.displayName ?? scheme.name,\n        scheme.colorSets,\n        scheme.singleColorScale,\n        scheme.isDistinct,\n        scheme.colorMap\n    )\n\nconst _colorSchemes = new Map<ColorSchemeName, ColorScheme>()\n\n// This object has a map-like appearance from the outside (with a .get() method),\n// but lazy-loads color schemes as they are requested\nexport const ColorSchemes = {\n    get: (name: ColorSchemeName): ColorScheme => {\n        if (!_colorSchemes.has(name)) {\n            const schemeRaw =\n                getColorBrewerScheme(name) ??\n                CustomColorSchemes.find((s) => s.name === name)\n            if (!schemeRaw) throw new Error(`Color scheme ${name} not found`)\n            const scheme = initColorScheme(schemeRaw)\n            _colorSchemes.set(name, scheme)\n        }\n        return _colorSchemes.get(name)!\n    },\n}\n\nconst getAllColorSchemes = (): Map<ColorSchemeName, ColorScheme> => {\n    return new Map(\n        Object.keys(ColorSchemeName).map((key) => [\n            key as ColorSchemeName,\n            ColorSchemes.get(key as ColorSchemeName),\n        ])\n    )\n}\n\nexport function getColorSchemeForChartType(type: GrapherChartOrMapType): {\n    [key in ColorSchemeName]: ColorScheme\n} {\n    const preferred = new Set(getPreferredSchemesByType(type))\n    const allSchemes = getAllColorSchemes()\n    const [preferredSchemes, otherSchemes] = _.partition(\n        [...allSchemes.entries()],\n        (schemeKeyValue) => preferred.has(schemeKeyValue[0])\n    )\n    return Object.fromEntries([...preferredSchemes, ...otherSchemes]) as {\n        [key in ColorSchemeName]: ColorScheme\n    }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,9 @@
+import { Color } from "../../types/index.js";
+export declare const interpolateArray: (scaleArr: string[]) => ((t: number) => string);
+export declare function getLeastUsedColor(availableColors: Color[], usedColors: Color[]): Color | undefined;
+export declare function calculateLightnessScore(colorHex: Color): number | undefined;
+export declare function isDarkColor(colorSpecifier: string): boolean | undefined;
+export declare function darkenColorForLine(colorHex: Color): Color;
+export declare function darkenColorForText(colorHex: Color): Color;
+export declare function darkenColorForHighContrastText(colorHex: Color): Color;
+//# sourceMappingURL=ColorUtils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ColorUtils.d.ts","sourceRoot":"","sources":["../../../src/grapher/color/ColorUtils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAA;AAI5C,eAAO,MAAM,gBAAgB,GACzB,UAAU,MAAM,EAAE,KACnB,CAAC,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAkBxB,CAAA;AAED,wBAAgB,iBAAiB,CAC7B,eAAe,EAAE,KAAK,EAAE,EACxB,UAAU,EAAE,KAAK,EAAE,GACpB,KAAK,GAAG,SAAS,CAenB;AAQD,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,CAK3E;AAED,wBAAgB,WAAW,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAIvE;AAWD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,CAEzD;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,CAEzD;AAED,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,KAAK,GAAG,KAAK,CAErE"}

package/dist/grapher/color/ColorUtils.js

@@ -0,0 +1,66 @@
+import * as _ from "lodash-es";
+import { rgb, color } from "d3-color";
+import { interpolate } from "d3-interpolate";
+const interpolateArray = (scaleArr) => {
+  const N = scaleArr.length - 2;
+  const intervalWidth = 1 / N;
+  const intervals = [];
+  for (let i = 0; i <= N; i++) {
+    intervals[i] = interpolate(rgb(scaleArr[i]), rgb(scaleArr[i + 1]));
+  }
+  return (t) => {
+    if (t < 0 || t > 1)
+      throw new Error("Outside the allowed range of [0, 1]");
+    const i = Math.floor(t * N);
+    const intervalOffset = i * intervalWidth;
+    return intervals[i](t / intervalWidth - intervalOffset / intervalWidth);
+  };
+};
+function getLeastUsedColor(availableColors, usedColors) {
+  const unusedColors = _.difference(availableColors, usedColors);
+  if (unusedColors.length > 0) return unusedColors[0];
+  const colorCounts = Object.entries(_.groupBy(usedColors)).map(
+    ([color2, arr]) => [color2, arr.length]
+  );
+  const mostUnusedColor = _.minBy(colorCounts, ([, count]) => count);
+  return mostUnusedColor[0];
+}
+function getYiq(rgb2) {
+  return (rgb2.r * 299 + rgb2.g * 587 + rgb2.b * 114) / 1e3;
+}
+function calculateLightnessScore(colorHex) {
+  const rgb2 = color(colorHex)?.rgb();
+  if (!rgb2) return void 0;
+  const yiq = getYiq(rgb2);
+  return yiq / 255;
+}
+function isDarkColor(colorSpecifier) {
+  const rgb2 = color(colorSpecifier)?.rgb();
+  if (!rgb2) return void 0;
+  return getYiq(rgb2) < 128;
+}
+function darkenColorToTargetYiq(colorHex, targetYiq) {
+  const c = color(colorHex)?.rgb();
+  if (!c) return colorHex;
+  const darkenCoeff = getYiq(c) / targetYiq - 1;
+  if (darkenCoeff > 0) return c.darker(darkenCoeff).hex();
+  return c.hex();
+}
+function darkenColorForLine(colorHex) {
+  return darkenColorToTargetYiq(colorHex, 170);
+}
+function darkenColorForText(colorHex) {
+  return darkenColorToTargetYiq(colorHex, 125);
+}
+function darkenColorForHighContrastText(colorHex) {
+  return darkenColorToTargetYiq(colorHex, 105);
+}
+export {
+  calculateLightnessScore,
+  darkenColorForHighContrastText,
+  darkenColorForLine,
+  darkenColorForText,
+  getLeastUsedColor,
+  interpolateArray,
+  isDarkColor
+};

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["src/grapher/color/ColorUtils.ts"],
+  "sourcesContent": ["import * as _ from \"lodash-es\"\nimport { Color } from \"../../types/index.js\"\nimport { rgb, color, RGBColor } from \"d3-color\"\nimport { interpolate } from \"d3-interpolate\"\n\nexport const interpolateArray = (\n    scaleArr: string[]\n): ((t: number) => string) => {\n    const N = scaleArr.length - 2 // -1 for spacings, -1 for number of interpolate fns\n    const intervalWidth = 1 / N\n    const intervals: Array<(t: number) => string> = []\n\n    for (let i = 0; i <= N; i++) {\n        intervals[i] = interpolate(rgb(scaleArr[i]), rgb(scaleArr[i + 1]))\n    }\n\n    return (t: number): string => {\n        if (t < 0 || t > 1)\n            throw new Error(\"Outside the allowed range of [0, 1]\")\n\n        const i = Math.floor(t * N)\n        const intervalOffset = i * intervalWidth\n\n        return intervals[i](t / intervalWidth - intervalOffset / intervalWidth)\n    }\n}\n\nexport function getLeastUsedColor(\n    availableColors: Color[],\n    usedColors: Color[]\n): Color | undefined {\n    // If there are unused colors, return the first available\n    const unusedColors = _.difference(availableColors, usedColors)\n    if (unusedColors.length > 0) return unusedColors[0]\n\n    // If all colors are used, we want to count the times each color is used, and use the most\n    // unused one.\n    const colorCounts = Object.entries(_.groupBy(usedColors)).map(\n        ([color, arr]): any[] => [color, arr.length]\n    )\n    const mostUnusedColor = _.minBy(colorCounts, ([, count]) => count) as [\n        string,\n        number,\n    ]\n    return mostUnusedColor[0]\n}\n\n// Taken from https://github.com/Qix-/color/blob/594a9af778f9a89541510bd1ae24061c82f24693/index.js#L287-L292\nfunction getYiq(rgb: RGBColor): number {\n    // YIQ equation from http://24ways.org/2010/calculating-color-contrast\n    return (rgb.r * 299 + rgb.g * 587 + rgb.b * 114) / 1000\n}\n\nexport function calculateLightnessScore(colorHex: Color): number | undefined {\n    const rgb = color(colorHex)?.rgb()\n    if (!rgb) return undefined\n    const yiq = getYiq(rgb)\n    return yiq / 255\n}\n\nexport function isDarkColor(colorSpecifier: string): boolean | undefined {\n    const rgb = color(colorSpecifier)?.rgb()\n    if (!rgb) return undefined\n    return getYiq(rgb) < 128\n}\n\n// See https://observablehq.com/@danielgavrilov/darken-colors-to-meet-a-target-contrast-ratio\nfunction darkenColorToTargetYiq(colorHex: Color, targetYiq: number): Color {\n    const c = color(colorHex)?.rgb()\n    if (!c) return colorHex\n    const darkenCoeff = getYiq(c) / targetYiq - 1.0\n    if (darkenCoeff > 0) return c.darker(darkenCoeff).hex()\n    return c.hex()\n}\n\nexport function darkenColorForLine(colorHex: Color): Color {\n    return darkenColorToTargetYiq(colorHex, 170)\n}\n\nexport function darkenColorForText(colorHex: Color): Color {\n    return darkenColorToTargetYiq(colorHex, 125)\n}\n\nexport function darkenColorForHighContrastText(colorHex: Color): Color {\n    return darkenColorToTargetYiq(colorHex, 105)\n}\n"],
+  "mappings": "AAAA,YAAY,OAAO;AAEnB,SAAS,KAAK,aAAuB;AACrC,SAAS,mBAAmB;AAErB,MAAM,mBAAmB,CAC5B,aAC0B;AAC1B,QAAM,IAAI,SAAS,SAAS;AAC5B,QAAM,gBAAgB,IAAI;AAC1B,QAAM,YAA0C,CAAC;AAEjD,WAAS,IAAI,GAAG,KAAK,GAAG,KAAK;AACzB,cAAU,CAAC,IAAI,YAAY,IAAI,SAAS,CAAC,CAAC,GAAG,IAAI,SAAS,IAAI,CAAC,CAAC,CAAC;AAAA,EACrE;AAEA,SAAO,CAAC,MAAsB;AAC1B,QAAI,IAAI,KAAK,IAAI;AACb,YAAM,IAAI,MAAM,qCAAqC;AAEzD,UAAM,IAAI,KAAK,MAAM,IAAI,CAAC;AAC1B,UAAM,iBAAiB,IAAI;AAE3B,WAAO,UAAU,CAAC,EAAE,IAAI,gBAAgB,iBAAiB,aAAa;AAAA,EAC1E;AACJ;AAEO,SAAS,kBACZ,iBACA,YACiB;AAEjB,QAAM,eAAe,EAAE,WAAW,iBAAiB,UAAU;AAC7D,MAAI,aAAa,SAAS,EAAG,QAAO,aAAa,CAAC;AAIlD,QAAM,cAAc,OAAO,QAAQ,EAAE,QAAQ,UAAU,CAAC,EAAE;AAAA,IACtD,CAAC,CAACA,QAAO,GAAG,MAAa,CAACA,QAAO,IAAI,MAAM;AAAA,EAC/C;AACA,QAAM,kBAAkB,EAAE,MAAM,aAAa,CAAC,CAAC,EAAE,KAAK,MAAM,KAAK;AAIjE,SAAO,gBAAgB,CAAC;AAC5B;AAGA,SAAS,OAAOC,MAAuB;AAEnC,UAAQA,KAAI,IAAI,MAAMA,KAAI,IAAI,MAAMA,KAAI,IAAI,OAAO;AACvD;AAEO,SAAS,wBAAwB,UAAqC;AACzE,QAAMA,OAAM,MAAM,QAAQ,GAAG,IAAI;AACjC,MAAI,CAACA,KAAK,QAAO;AACjB,QAAM,MAAM,OAAOA,IAAG;AACtB,SAAO,MAAM;AACjB;AAEO,SAAS,YAAY,gBAA6C;AACrE,QAAMA,OAAM,MAAM,cAAc,GAAG,IAAI;AACvC,MAAI,CAACA,KAAK,QAAO;AACjB,SAAO,OAAOA,IAAG,IAAI;AACzB;AAGA,SAAS,uBAAuB,UAAiB,WAA0B;AACvE,QAAM,IAAI,MAAM,QAAQ,GAAG,IAAI;AAC/B,MAAI,CAAC,EAAG,QAAO;AACf,QAAM,cAAc,OAAO,CAAC,IAAI,YAAY;AAC5C,MAAI,cAAc,EAAG,QAAO,EAAE,OAAO,WAAW,EAAE,IAAI;AACtD,SAAO,EAAE,IAAI;AACjB;AAEO,SAAS,mBAAmB,UAAwB;AACvD,SAAO,uBAAuB,UAAU,GAAG;AAC/C;AAEO,SAAS,mBAAmB,UAAwB;AACvD,SAAO,uBAAuB,UAAU,GAAG;AAC/C;AAEO,SAAS,+BAA+B,UAAwB;AACnE,SAAO,uBAAuB,UAAU,GAAG;AAC/C;",
+  "names": ["color", "rgb"]
+}