@buildcanada/charts 0.3.6 → 0.3.8

package/dist/explorer/ExplorerProgram.js

@@ -0,0 +1,403 @@
+import * as _ from "lodash-es";
+import {
+  ColumnTypeNames
+} from "../types/index.js";
+import {
+  CoreTable,
+  ChartsTable,
+  isNotErrorValue
+} from "../core-table/index.js";
+import {
+  PromiseCache,
+  trimObject,
+  fetchWithRetry
+} from "../utils/index.js";
+import {
+  GridBoolean,
+  GRID_CELL_DELIMITER,
+  GRID_NODE_DELIMITER,
+  RootKeywordCellDef
+} from "./gridLang/GridLangConstants.js";
+import { GridProgram } from "./gridLang/GridProgram.js";
+import { ColumnGrammar } from "./ColumnGrammar.js";
+import {
+  DefaultNewExplorerSlug,
+  ExplorerChartCreationMode,
+  EXPLORERS_ROUTE_FOLDER
+} from "./ExplorerConstants.js";
+import { DecisionMatrix } from "./ExplorerDecisionMatrix.js";
+import { ExplorerGrammar } from "./ExplorerGrammar.js";
+import { GrapherGrammar } from "./GrapherGrammar.js";
+import { latestGrapherConfigSchema } from "../grapher/index.js";
+const EXPLORER_FILE_SUFFIX = ".explorer.tsv";
+const ExplorerRootDef = {
+  ...RootKeywordCellDef,
+  grammar: ExplorerGrammar
+};
+class ExplorerProgram extends GridProgram {
+  constructor(slug, tsv, lastCommit) {
+    super(slug, tsv, lastCommit, ExplorerRootDef);
+  }
+  get decisionMatrix() {
+    if (!this._decisionMatrix) {
+      this._decisionMatrix = new DecisionMatrix(
+        this.decisionMatrixCode ?? "",
+        this.lastCommit?.hash
+      );
+    }
+    return this._decisionMatrix;
+  }
+  static fromJson(json) {
+    return new ExplorerProgram(json.slug, json.program, json.lastCommit);
+  }
+  get clone() {
+    return ExplorerProgram.fromJson(this.toJson());
+  }
+  get isNewFile() {
+    return this.slug === DefaultNewExplorerSlug;
+  }
+  get filename() {
+    return this.slug + EXPLORER_FILE_SUFFIX;
+  }
+  initDecisionMatrix(choiceParams) {
+    this.decisionMatrix.setValuesFromChoiceParams(choiceParams);
+    return this;
+  }
+  get fullPath() {
+    return makeFullPath(this.slug);
+  }
+  get currentlySelectedGrapherRow() {
+    const row = this.getKeywordIndex(ExplorerGrammar.graphers.keyword);
+    return row === -1 ? void 0 : row + this.decisionMatrix.selectedRowIndex + 2;
+  }
+  static fromMatrix(slug, matrix) {
+    const str = matrix.map(
+      (row) => row.map((cell) => cell && `${cell}`.replace(/\n/g, "\\n"))
+    ).map((row) => row.join(GRID_CELL_DELIMITER)).join(GRID_NODE_DELIMITER);
+    return new ExplorerProgram(slug, str);
+  }
+  get explorerTitle() {
+    return this.getLineValue(ExplorerGrammar.explorerTitle.keyword);
+  }
+  get title() {
+    return this.getLineValue(ExplorerGrammar.title.keyword);
+  }
+  get subNavId() {
+    return this.getLineValue(ExplorerGrammar.subNavId.keyword);
+  }
+  get googleSheet() {
+    return this.getLineValue(ExplorerGrammar.googleSheet.keyword);
+  }
+  get hideAlertBanner() {
+    return this.getLineValue(ExplorerGrammar.hideAlertBanner.keyword) === GridBoolean.true;
+  }
+  get subNavCurrentId() {
+    return this.getLineValue(ExplorerGrammar.subNavCurrentId.keyword);
+  }
+  get thumbnail() {
+    return this.getLineValue(ExplorerGrammar.thumbnail.keyword);
+  }
+  get explorerSubtitle() {
+    return this.getLineValue(ExplorerGrammar.explorerSubtitle.keyword);
+  }
+  get entityType() {
+    return this.getLineValue(ExplorerGrammar.entityType.keyword);
+  }
+  get selection() {
+    return this.getLine(ExplorerGrammar.selection.keyword)?.slice(1);
+  }
+  get pickerColumnSlugs() {
+    const slugs = this.getLineValue(
+      ExplorerGrammar.pickerColumnSlugs.keyword
+    );
+    return slugs ? slugs.split(" ") : void 0;
+  }
+  get hideControls() {
+    return this.getLineValue(ExplorerGrammar.hideControls.keyword);
+  }
+  get downloadDataLink() {
+    return this.getLineValue(ExplorerGrammar.downloadDataLink.keyword);
+  }
+  get isPublished() {
+    return this.getLineValue(ExplorerGrammar.isPublished.keyword) === GridBoolean.true;
+  }
+  setPublished(value) {
+    return this.clone.setLineValue(
+      ExplorerGrammar.isPublished.keyword,
+      value ? GridBoolean.true : GridBoolean.false
+    );
+  }
+  get wpBlockId() {
+    const blockIdString = this.getLineValue(
+      ExplorerGrammar.wpBlockId.keyword
+    );
+    return blockIdString ? parseInt(blockIdString, 10) : void 0;
+  }
+  get decisionMatrixCode() {
+    const keywordIndex = this.getKeywordIndex(
+      ExplorerGrammar.graphers.keyword
+    );
+    if (keywordIndex === -1) return void 0;
+    return this.getBlock(keywordIndex)?.map((row) => row.join(this.cellDelimiter)).join("\n");
+  }
+  get grapherCount() {
+    return this.decisionMatrix.numRows || 1;
+  }
+  get tableCount() {
+    return this.getRowNumbersStartingWith(ExplorerGrammar.table.keyword).length;
+  }
+  get tableSlugs() {
+    return this.lines.filter((line) => line[0] === ExplorerGrammar.table.keyword).map((line) => line[2]);
+  }
+  // for backward compatibility, we currently support explorers
+  // that use Grapher IDs as well as CSV data files to create charts,
+  // but we plan to drop support for mixed-content explorers in the future
+  getChartCreationModeForExplorerGrapherConfig(explorerGrapherConfig) {
+    const { decisionMatrix } = this;
+    const { grapherId } = explorerGrapherConfig;
+    const yVariableIdsColumn = decisionMatrix.table.get(
+      GrapherGrammar.yVariableIds.keyword
+    );
+    if (yVariableIdsColumn.numValues)
+      return ExplorerChartCreationMode.FromVariableIds;
+    if (grapherId && isNotErrorValue(grapherId))
+      return ExplorerChartCreationMode.FromGrapherId;
+    return ExplorerChartCreationMode.FromExplorerTableColumnSlugs;
+  }
+  get chartCreationMode() {
+    return this.getChartCreationModeForExplorerGrapherConfig(
+      this.explorerGrapherConfig
+    );
+  }
+  get whyIsExplorerProgramInvalid() {
+    const {
+      chartCreationMode,
+      decisionMatrix: { table }
+    } = this;
+    const { FromVariableIds, FromGrapherId, FromExplorerTableColumnSlugs } = ExplorerChartCreationMode;
+    const grapherIdColumn = table.get(GrapherGrammar.grapherId.keyword);
+    const tableSlugColumn = table.get(GrapherGrammar.tableSlug.keyword);
+    const hasGrapherId = grapherIdColumn.numValues > 0;
+    const hasCsvData = tableSlugColumn.numValues > 0 || this.tableCount > 0;
+    if (chartCreationMode === FromVariableIds && hasGrapherId)
+      return "Using variables IDs and Grapher IDs to create charts is not supported.";
+    if (chartCreationMode === FromVariableIds && hasCsvData)
+      return "Using variable IDs and CSV data files to create charts is not supported.";
+    if (chartCreationMode === FromGrapherId && hasCsvData || chartCreationMode === FromExplorerTableColumnSlugs && hasGrapherId)
+      return "Using Grapher IDs and CSV data files to create charts is deprecated.";
+    return "";
+  }
+  get columnDefsByTableSlug() {
+    const columnDefs = /* @__PURE__ */ new Map();
+    const colDefsRows = this.getAllRowsMatchingWords(
+      ExplorerGrammar.columns.keyword
+    );
+    const matrix = this.lines;
+    for (const row of colDefsRows) {
+      const tableSlugs = matrix[row].slice(1);
+      const columnDefinitions = parseColumnDefs(this.getBlock(row) ?? []);
+      if (tableSlugs.length === 0)
+        columnDefs.set(void 0, columnDefinitions);
+      else
+        tableSlugs.forEach((tableSlug) => {
+          columnDefs.set(tableSlug, columnDefinitions);
+        });
+    }
+    return columnDefs;
+  }
+  get columnDefsWithoutTableSlug() {
+    return this.columnDefsByTableSlug.get(void 0) ?? [];
+  }
+  async autofillMissingColumnDefinitionsForTableCommand(tableSlug) {
+    const clone = this.clone;
+    const remoteTable = await clone.constructTable(tableSlug);
+    const existingTableDef = this.getTableDef(tableSlug);
+    const table = remoteTable || (existingTableDef ? new CoreTable(
+      existingTableDef.inlineData,
+      existingTableDef.columnDefinitions
+    ) : void 0);
+    const newCols = table.autodetectedColumnDefs;
+    const missing = newCols.appendColumns([
+      {
+        slug: ColumnGrammar.notes.keyword,
+        values: newCols.indices.map(() => `Unreviewed`)
+      }
+    ]).select([
+      ColumnGrammar.slug.keyword,
+      ,
+      ColumnGrammar.name.keyword,
+      ,
+      ColumnGrammar.type.keyword,
+      ColumnGrammar.notes.keyword
+    ]);
+    const colDefsRow = this.getRowMatchingWords(
+      ExplorerGrammar.columns.keyword,
+      tableSlug
+    );
+    if (colDefsRow !== -1)
+      clone.updateBlock(
+        colDefsRow,
+        new CoreTable(clone.getBlock(colDefsRow)).concat([missing]).toMatrix()
+      );
+    else
+      clone.appendBlock(
+        `${ExplorerGrammar.columns.keyword}${tableSlug ? this.cellDelimiter + tableSlug : ""}`,
+        missing.toMatrix()
+      );
+    return clone;
+  }
+  constructExplorerGrapherConfig(grapherRow) {
+    const rootObject = trimAndParseObject(this.tuplesObject, GrapherGrammar);
+    let config = { ...rootObject };
+    if (grapherRow && Object.keys(grapherRow).length) {
+      config = {
+        ...config,
+        ...trimAndParseObject(grapherRow, GrapherGrammar)
+      };
+    }
+    Object.keys(config).forEach((key) => {
+      if (!GrapherGrammar[key]) delete config[key];
+    });
+    return config;
+  }
+  constructGrapherConfig(explorerGrapherConfig) {
+    const partialConfigs = [];
+    const fields = Object.entries(explorerGrapherConfig);
+    for (const [field, value] of fields) {
+      const cellDef = GrapherGrammar[field];
+      partialConfigs.push(cellDef.toGrapherObject(value));
+    }
+    const mergedConfig = _.merge({}, ...partialConfigs);
+    mergedConfig.$schema = latestGrapherConfigSchema;
+    const { relatedQuestionUrl, relatedQuestionText } = explorerGrapherConfig;
+    if (relatedQuestionUrl && relatedQuestionText) {
+      mergedConfig.relatedQuestions = [
+        { url: relatedQuestionUrl, text: relatedQuestionText }
+      ];
+    }
+    return mergedConfig;
+  }
+  /**
+   * Grapher config for the currently selected row including global settings.
+   * Includes all columns that are part of the GrapherGrammar.
+   */
+  get explorerGrapherConfig() {
+    const selectedGrapherRow = this.decisionMatrix.selectedRow;
+    return this.constructExplorerGrapherConfig(selectedGrapherRow);
+  }
+  /**
+   * Grapher config for the currently selected row, with explorer-specific
+   * fields translated to valid GrapherInterface fields.
+   *
+   * For example, `yAxisMin` is translated to `{yAxis: {min: ... }}`
+   */
+  get grapherConfig() {
+    return this.constructGrapherConfig(this.explorerGrapherConfig);
+  }
+  static {
+    /**
+     * A static method so that all explorers on the page share requests,
+     * and no duplicate requests are sent.
+     */
+    this.tableDataLoader = new PromiseCache(
+      async (url) => {
+        const response = await fetchWithRetry(url);
+        if (!response.ok) throw new Error(response.statusText);
+        const tableInput = url.endsWith(".json") ? await response.json() : await response.text();
+        return tableInput;
+      }
+    );
+  }
+  async constructTable(tableSlug) {
+    const tableDef = this.getTableDef(tableSlug);
+    if (!tableDef) {
+      throw new Error(`Table definitions not found for '${tableSlug}'`);
+    }
+    if (tableDef.inlineData) {
+      return new ChartsTable(
+        tableDef.inlineData,
+        tableDef.columnDefinitions,
+        {
+          tableDescription: `Loaded '${tableSlug}' from inline data`,
+          tableSlug
+        }
+      ).dropEmptyRows();
+    } else if (tableDef.url) {
+      const input = await ExplorerProgram.tableDataLoader.get(
+        tableDef.url
+      );
+      return new ChartsTable(input, tableDef.columnDefinitions, {
+        tableDescription: `Loaded from ${tableDef.url}`
+      });
+    }
+    throw new Error(`No data for table '${tableSlug}'`);
+  }
+  getTableDef(tableSlug) {
+    const tableDefRow = this.getRowMatchingWords(
+      ExplorerGrammar.table.keyword,
+      void 0,
+      tableSlug
+    );
+    if (tableDefRow === -1) return void 0;
+    const inlineData = this.getBlock(tableDefRow);
+    let url = inlineData ? void 0 : this.lines[tableDefRow][1];
+    if (url && !url.includes("://")) {
+      console.warn(
+        `Dataset slug "${url}" provided without full URL. Please provide a complete URL.`
+      );
+    }
+    const columnDefinitions = this.columnDefsByTableSlug.get(tableSlug);
+    return {
+      url,
+      columnDefinitions,
+      inlineData,
+      slug: tableSlug
+    };
+  }
+}
+const makeFullPath = (slug) => `${EXPLORERS_ROUTE_FOLDER}/${slug}${EXPLORER_FILE_SUFFIX}`;
+const trimAndParseObject = (config, grammar) => {
+  const trimmedRow = trimObject(config, true);
+  Object.keys(trimmedRow).forEach((key) => {
+    const def = grammar[key];
+    if (def && def.parse) trimmedRow[key] = def.parse(trimmedRow[key]);
+    else if (!def) {
+      const value = trimmedRow[key];
+      if (value === GridBoolean.true) trimmedRow[key] = true;
+      else if (value === GridBoolean.false) trimmedRow[key] = false;
+    }
+  });
+  return trimmedRow;
+};
+const parseColumnDefs = (block) => {
+  const columnsTable = new CoreTable(block).appendColumnsIfNew([
+    { slug: "slug", type: ColumnTypeNames.String, name: "slug" },
+    {
+      slug: "variableId",
+      type: ColumnTypeNames.Integer,
+      name: "variableId"
+    }
+  ]).renameColumn("variableId", "variableId").rowFilter(
+    (row) => !!(row.slug || typeof row.variableId === "number"),
+    "Keep only column defs with a slug or variable id"
+  );
+  return columnsTable.rows.map((row) => {
+    const hasValidVariableId = row.variableId && isNotErrorValue(row.variableId);
+    if (hasValidVariableId && row.slug) delete row.slug;
+    for (const field in row) {
+      const cellDef = ColumnGrammar[field];
+      if (cellDef?.display) {
+        row.display = row.display || {};
+        row.display[field] = row[field];
+        delete row[field];
+      }
+    }
+    return trimAndParseObject(row, ColumnGrammar);
+  });
+};
+export {
+  EXPLORER_FILE_SUFFIX,
+  ExplorerProgram,
+  makeFullPath,
+  trimAndParseObject
+};

package/dist/explorer/ExplorerProgram.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["src/explorer/ExplorerProgram.ts"],
+  "sourcesContent": ["import * as _ from \"lodash-es\"\n/* eslint-disable no-sparse-arrays */\nimport {\n    CoreMatrix,\n    ColumnTypeNames,\n    CoreTableInputOption,\n    ColumnDef,\n    TableSlug,\n    SubNavId,\n    FacetAxisDomain,\n    GrapherInterface,\n    AxisMinMaxValueStr,\n    GrapherChartType,\n} from \"../types/index.js\"\nimport {\n    CoreTable,\n    ChartsTable,\n    isNotErrorValue,\n} from \"../core-table/index.js\"\nimport {\n    GitCommit,\n    PromiseCache,\n    SerializedGridProgram,\n    trimObject,\n    fetchWithRetry,\n} from \"../utils/index.js\"\nimport {\n    CellDef,\n    Grammar,\n    GridBoolean,\n    GRID_CELL_DELIMITER,\n    GRID_NODE_DELIMITER,\n    RootKeywordCellDef,\n} from \"./gridLang/GridLangConstants.js\"\nimport { GridProgram } from \"./gridLang/GridProgram.js\"\nimport { ColumnGrammar } from \"./ColumnGrammar.js\"\nimport {\n    DefaultNewExplorerSlug,\n    ExplorerChartCreationMode,\n    ExplorerChoiceParams,\n    EXPLORERS_ROUTE_FOLDER,\n} from \"./ExplorerConstants.js\"\nimport { DecisionMatrix } from \"./ExplorerDecisionMatrix.js\"\nimport { ExplorerGrammar } from \"./ExplorerGrammar.js\"\nimport { GrapherGrammar } from \"./GrapherGrammar.js\"\nimport { latestGrapherConfigSchema } from \"../grapher/index.js\"\n\nexport const EXPLORER_FILE_SUFFIX = \".explorer.tsv\"\n\nexport interface TableDef {\n    url?: string\n    columnDefinitions?: ColumnDef[]\n    inlineData?: string[][]\n    slug?: TableSlug\n}\n\nexport interface ExplorerGrapherInterface extends GrapherInterface {\n    grapherId?: number\n    tableSlug?: string\n    yVariableIds?: string\n    xVariableId?: string\n    colorVariableId?: string\n    sizeVariableId?: string\n    yScaleToggle?: boolean\n    yAxisMin?: number | AxisMinMaxValueStr.auto\n    facetYDomain?: FacetAxisDomain\n    relatedQuestionText?: string\n    relatedQuestionUrl?: string\n    mapTargetTime?: number\n    type?: GrapherChartType | \"LineChart SlopeChart\" | \"None\"\n}\n\nconst ExplorerRootDef: CellDef = {\n    ...RootKeywordCellDef,\n    grammar: ExplorerGrammar,\n}\n\nexport class ExplorerProgram extends GridProgram {\n    constructor(slug: string, tsv: string, lastCommit?: GitCommit) {\n        super(slug, tsv, lastCommit, ExplorerRootDef)\n    }\n\n    private _decisionMatrix?: DecisionMatrix\n    get decisionMatrix() {\n        if (!this._decisionMatrix) {\n            this._decisionMatrix = new DecisionMatrix(\n                this.decisionMatrixCode ?? \"\",\n                this.lastCommit?.hash\n            )\n        }\n        return this._decisionMatrix\n    }\n\n    static fromJson(json: SerializedGridProgram) {\n        return new ExplorerProgram(json.slug, json.program, json.lastCommit)\n    }\n\n    get clone() {\n        return ExplorerProgram.fromJson(this.toJson())\n    }\n\n    get isNewFile() {\n        return this.slug === DefaultNewExplorerSlug\n    }\n\n    get filename() {\n        return this.slug + EXPLORER_FILE_SUFFIX\n    }\n\n    initDecisionMatrix(choiceParams: ExplorerChoiceParams) {\n        this.decisionMatrix.setValuesFromChoiceParams(choiceParams)\n        return this\n    }\n\n    get fullPath() {\n        return makeFullPath(this.slug)\n    }\n\n    get currentlySelectedGrapherRow() {\n        const row = this.getKeywordIndex(ExplorerGrammar.graphers.keyword)\n        return row === -1\n            ? undefined\n            : row + this.decisionMatrix.selectedRowIndex + 2\n    }\n\n    static fromMatrix(slug: string, matrix: CoreMatrix) {\n        const str = matrix\n            .map((row) =>\n                row.map((cell) => cell && `${cell}`.replace(/\\n/g, \"\\\\n\"))\n            )\n            .map((row) => row.join(GRID_CELL_DELIMITER))\n            .join(GRID_NODE_DELIMITER)\n        return new ExplorerProgram(slug, str)\n    }\n\n    get explorerTitle() {\n        return this.getLineValue(ExplorerGrammar.explorerTitle.keyword)\n    }\n\n    get title() {\n        return this.getLineValue(ExplorerGrammar.title.keyword)\n    }\n\n    get subNavId(): SubNavId | undefined {\n        return this.getLineValue(ExplorerGrammar.subNavId.keyword) as SubNavId\n    }\n\n    get googleSheet() {\n        return this.getLineValue(ExplorerGrammar.googleSheet.keyword)\n    }\n\n    get hideAlertBanner() {\n        return (\n            this.getLineValue(ExplorerGrammar.hideAlertBanner.keyword) ===\n            GridBoolean.true\n        )\n    }\n\n    get subNavCurrentId() {\n        return this.getLineValue(ExplorerGrammar.subNavCurrentId.keyword)\n    }\n\n    get thumbnail() {\n        return this.getLineValue(ExplorerGrammar.thumbnail.keyword)\n    }\n\n    get explorerSubtitle() {\n        return this.getLineValue(ExplorerGrammar.explorerSubtitle.keyword)\n    }\n\n    get entityType() {\n        return this.getLineValue(ExplorerGrammar.entityType.keyword)\n    }\n\n    get selection() {\n        return this.getLine(ExplorerGrammar.selection.keyword)?.slice(1)\n    }\n\n    get pickerColumnSlugs() {\n        const slugs = this.getLineValue(\n            ExplorerGrammar.pickerColumnSlugs.keyword\n        )\n        return slugs ? slugs.split(\" \") : undefined\n    }\n\n    get hideControls() {\n        return this.getLineValue(ExplorerGrammar.hideControls.keyword)\n    }\n\n    get downloadDataLink() {\n        return this.getLineValue(ExplorerGrammar.downloadDataLink.keyword)\n    }\n\n    get isPublished() {\n        return (\n            this.getLineValue(ExplorerGrammar.isPublished.keyword) ===\n            GridBoolean.true\n        )\n    }\n\n    setPublished(value: boolean) {\n        return this.clone.setLineValue(\n            ExplorerGrammar.isPublished.keyword,\n            value ? GridBoolean.true : GridBoolean.false\n        )\n    }\n\n    get wpBlockId() {\n        const blockIdString = this.getLineValue(\n            ExplorerGrammar.wpBlockId.keyword\n        )\n        return blockIdString ? parseInt(blockIdString, 10) : undefined\n    }\n\n    get decisionMatrixCode() {\n        const keywordIndex = this.getKeywordIndex(\n            ExplorerGrammar.graphers.keyword\n        )\n        if (keywordIndex === -1) return undefined\n        return this.getBlock(keywordIndex)\n            ?.map((row) => row.join(this.cellDelimiter))\n            .join(\"\\n\")\n    }\n\n    get grapherCount() {\n        return this.decisionMatrix.numRows || 1\n    }\n\n    get tableCount() {\n        return this.getRowNumbersStartingWith(ExplorerGrammar.table.keyword)\n            .length\n    }\n\n    get tableSlugs(): (TableSlug | undefined)[] {\n        return this.lines\n            .filter((line) => line[0] === ExplorerGrammar.table.keyword)\n            .map((line) => line[2])\n    }\n\n    // for backward compatibility, we currently support explorers\n    // that use Grapher IDs as well as CSV data files to create charts,\n    // but we plan to drop support for mixed-content explorers in the future\n    getChartCreationModeForExplorerGrapherConfig(\n        explorerGrapherConfig: ExplorerGrapherInterface\n    ): ExplorerChartCreationMode {\n        const { decisionMatrix } = this\n        const { grapherId } = explorerGrapherConfig\n        const yVariableIdsColumn = decisionMatrix.table.get(\n            GrapherGrammar.yVariableIds.keyword\n        )\n        // referring to a variable in a single row triggers\n        // ExplorerChartCreationMode.FromVariableIds for all rows\n        if (yVariableIdsColumn.numValues)\n            return ExplorerChartCreationMode.FromVariableIds\n        if (grapherId && isNotErrorValue(grapherId))\n            return ExplorerChartCreationMode.FromGrapherId\n        return ExplorerChartCreationMode.FromExplorerTableColumnSlugs\n    }\n\n    get chartCreationMode(): ExplorerChartCreationMode {\n        return this.getChartCreationModeForExplorerGrapherConfig(\n            this.explorerGrapherConfig\n        )\n    }\n\n    get whyIsExplorerProgramInvalid(): string {\n        const {\n            chartCreationMode,\n            decisionMatrix: { table },\n        } = this\n        const { FromVariableIds, FromGrapherId, FromExplorerTableColumnSlugs } =\n            ExplorerChartCreationMode\n\n        const grapherIdColumn = table.get(GrapherGrammar.grapherId.keyword)\n        const tableSlugColumn = table.get(GrapherGrammar.tableSlug.keyword)\n        const hasGrapherId = grapherIdColumn.numValues > 0\n        const hasCsvData = tableSlugColumn.numValues > 0 || this.tableCount > 0\n\n        if (chartCreationMode === FromVariableIds && hasGrapherId)\n            return \"Using variables IDs and Grapher IDs to create charts is not supported.\"\n\n        if (chartCreationMode === FromVariableIds && hasCsvData)\n            return \"Using variable IDs and CSV data files to create charts is not supported.\"\n\n        if (\n            (chartCreationMode === FromGrapherId && hasCsvData) ||\n            (chartCreationMode === FromExplorerTableColumnSlugs && hasGrapherId)\n        )\n            return \"Using Grapher IDs and CSV data files to create charts is deprecated.\"\n\n        return \"\"\n    }\n\n    get columnDefsByTableSlug(): Map<TableSlug | undefined, ColumnDef[]> {\n        const columnDefs = new Map<TableSlug | undefined, ColumnDef[]>()\n        const colDefsRows = this.getAllRowsMatchingWords(\n            ExplorerGrammar.columns.keyword\n        )\n\n        const matrix = this.lines\n        for (const row of colDefsRows) {\n            const tableSlugs = matrix[row].slice(1)\n            const columnDefinitions = parseColumnDefs(this.getBlock(row) ?? [])\n            if (tableSlugs.length === 0)\n                columnDefs.set(undefined, columnDefinitions)\n            else\n                tableSlugs.forEach((tableSlug) => {\n                    columnDefs.set(tableSlug, columnDefinitions)\n                })\n        }\n        return columnDefs\n    }\n\n    get columnDefsWithoutTableSlug(): ColumnDef[] {\n        return this.columnDefsByTableSlug.get(undefined) ?? []\n    }\n\n    async autofillMissingColumnDefinitionsForTableCommand(tableSlug?: string) {\n        const clone = this.clone\n        const remoteTable = await clone.constructTable(tableSlug)\n        const existingTableDef = this.getTableDef(tableSlug)\n        const table =\n            remoteTable ||\n            (existingTableDef\n                ? new CoreTable(\n                      existingTableDef.inlineData,\n                      existingTableDef.columnDefinitions\n                  )\n                : undefined)\n        const newCols = table.autodetectedColumnDefs\n        const missing = newCols\n            .appendColumns([\n                {\n                    slug: ColumnGrammar.notes.keyword,\n                    values: newCols.indices.map(() => `Unreviewed`),\n                },\n            ])\n            .select([\n                ColumnGrammar.slug.keyword,\n                ,\n                ColumnGrammar.name.keyword,\n                ,\n                ColumnGrammar.type.keyword,\n                ColumnGrammar.notes.keyword,\n            ] as string[])\n\n        const colDefsRow = this.getRowMatchingWords(\n            ExplorerGrammar.columns.keyword,\n            tableSlug\n        )\n\n        if (colDefsRow !== -1)\n            clone.updateBlock(\n                colDefsRow,\n                new CoreTable(clone.getBlock(colDefsRow))\n                    .concat([missing])\n                    .toMatrix()\n            )\n        else\n            clone.appendBlock(\n                `${ExplorerGrammar.columns.keyword}${\n                    tableSlug ? this.cellDelimiter + tableSlug : \"\"\n                }`,\n                missing.toMatrix()\n            )\n        return clone\n    }\n\n    constructExplorerGrapherConfig(grapherRow: any): ExplorerGrapherInterface {\n        const rootObject = trimAndParseObject(this.tuplesObject, GrapherGrammar)\n        let config = { ...rootObject }\n\n        if (grapherRow && Object.keys(grapherRow).length) {\n            config = {\n                ...config,\n                ...trimAndParseObject(grapherRow, GrapherGrammar),\n            }\n        }\n\n        // remove all keys that are not part of the GrapherGrammar\n        Object.keys(config).forEach((key) => {\n            if (!GrapherGrammar[key]) delete config[key]\n        })\n\n        return config\n    }\n\n    constructGrapherConfig(\n        explorerGrapherConfig: ExplorerGrapherInterface\n    ): GrapherInterface {\n        const partialConfigs: GrapherInterface[] = []\n        const fields = Object.entries(explorerGrapherConfig)\n\n        for (const [field, value] of fields) {\n            const cellDef = GrapherGrammar[field]\n            partialConfigs.push(cellDef.toGrapherObject(value))\n        }\n\n        const mergedConfig = _.merge({}, ...partialConfigs)\n\n        // assume config is valid against the latest schema\n        mergedConfig.$schema = latestGrapherConfigSchema\n\n        // TODO: can be removed once relatedQuestions is refactored\n        const { relatedQuestionUrl, relatedQuestionText } =\n            explorerGrapherConfig\n        if (relatedQuestionUrl && relatedQuestionText) {\n            mergedConfig.relatedQuestions = [\n                { url: relatedQuestionUrl, text: relatedQuestionText },\n            ]\n        }\n\n        return mergedConfig\n    }\n\n    /**\n     * Grapher config for the currently selected row including global settings.\n     * Includes all columns that are part of the GrapherGrammar.\n     */\n    get explorerGrapherConfig(): ExplorerGrapherInterface {\n        const selectedGrapherRow = this.decisionMatrix.selectedRow\n        return this.constructExplorerGrapherConfig(selectedGrapherRow)\n    }\n\n    /**\n     * Grapher config for the currently selected row, with explorer-specific\n     * fields translated to valid GrapherInterface fields.\n     *\n     * For example, `yAxisMin` is translated to `{yAxis: {min: ... }}`\n     */\n    get grapherConfig(): GrapherInterface {\n        return this.constructGrapherConfig(this.explorerGrapherConfig)\n    }\n\n    /**\n     * A static method so that all explorers on the page share requests,\n     * and no duplicate requests are sent.\n     */\n    private static tableDataLoader = new PromiseCache(\n        async (url: string): Promise<CoreTableInputOption> => {\n            const response = await fetchWithRetry(url)\n            if (!response.ok) throw new Error(response.statusText)\n            const tableInput: CoreTableInputOption = url.endsWith(\".json\")\n                ? await response.json()\n                : await response.text()\n            return tableInput\n        }\n    )\n\n    async constructTable(tableSlug?: TableSlug): Promise<ChartsTable> {\n        const tableDef = this.getTableDef(tableSlug)\n        if (!tableDef) {\n            throw new Error(`Table definitions not found for '${tableSlug}'`)\n        }\n\n        if (tableDef.inlineData) {\n            return new ChartsTable(\n                tableDef.inlineData,\n                tableDef.columnDefinitions,\n                {\n                    tableDescription: `Loaded '${tableSlug}' from inline data`,\n                    tableSlug: tableSlug,\n                }\n            ).dropEmptyRows()\n        } else if (tableDef.url) {\n            const input = await ExplorerProgram.tableDataLoader.get(\n                tableDef.url\n            )\n            return new ChartsTable(input, tableDef.columnDefinitions, {\n                tableDescription: `Loaded from ${tableDef.url}`,\n            })\n        }\n\n        throw new Error(`No data for table '${tableSlug}'`)\n    }\n\n    getTableDef(tableSlug?: TableSlug): TableDef | undefined {\n        const tableDefRow = this.getRowMatchingWords(\n            ExplorerGrammar.table.keyword,\n            undefined,\n            tableSlug\n        )\n        if (tableDefRow === -1) return undefined\n\n        const inlineData = this.getBlock(tableDefRow)\n        let url = inlineData ? undefined : this.lines[tableDefRow][1]\n\n        // If URL doesn't contain protocol, it's treated as a dataset slug\n        // Note: This legacy feature requires a full URL to be configured\n        if (url && !url.includes(\"://\")) {\n            console.warn(\n                `Dataset slug \"${url}\" provided without full URL. Please provide a complete URL.`\n            )\n        }\n\n        const columnDefinitions: ColumnDef[] | undefined =\n            this.columnDefsByTableSlug.get(tableSlug)\n\n        return {\n            url,\n            columnDefinitions,\n            inlineData,\n            slug: tableSlug,\n        }\n    }\n}\n\nexport const makeFullPath = (slug: string) =>\n    `${EXPLORERS_ROUTE_FOLDER}/${slug}${EXPLORER_FILE_SUFFIX}`\n\nexport const trimAndParseObject = (config: any, grammar: Grammar) => {\n    // Trim empty properties. Prevents things like clearing \"type\" which crashes Grapher. The call to grapher.reset will automatically clear things like title, subtitle, if not set.\n    const trimmedRow = trimObject(config, true) as any\n\n    // parse types\n    Object.keys(trimmedRow).forEach((key) => {\n        const def = grammar[key]\n        if (def && def.parse) trimmedRow[key] = def.parse(trimmedRow[key])\n        // If there no definition but it is a boolean, parse it (todo: always have a def)\n        else if (!def) {\n            const value = trimmedRow[key]\n            if (value === GridBoolean.true) trimmedRow[key] = true\n            else if (value === GridBoolean.false) trimmedRow[key] = false\n        }\n    })\n    return trimmedRow\n}\n\nconst parseColumnDefs = (block: string[][]): ColumnDef[] => {\n    /**\n     * A column def line can have:\n     * - a column named `variableId`, which contains a variable id\n     * - a column named `slug`, which is the referenced column in its data file\n     *\n     * We want to filter out any rows that contain neither of those, and we also\n     * want to rename `variableId` to `variableId`.\n     */\n    const columnsTable = new CoreTable(block)\n        .appendColumnsIfNew([\n            { slug: \"slug\", type: ColumnTypeNames.String, name: \"slug\" },\n            {\n                slug: \"variableId\",\n                type: ColumnTypeNames.Integer,\n                name: \"variableId\",\n            },\n        ])\n        .renameColumn(\"variableId\", \"variableId\")\n        // Filter out rows that neither have a slug nor an variableId\n        .rowFilter(\n            (row) => !!(row.slug || typeof row.variableId === \"number\"),\n            \"Keep only column defs with a slug or variable id\"\n        )\n    return columnsTable.rows.map((row) => {\n        // ignore slug if a variable id is given\n        const hasValidVariableId =\n            row.variableId && isNotErrorValue(row.variableId)\n        if (hasValidVariableId && row.slug) delete row.slug\n\n        for (const field in row) {\n            const cellDef = ColumnGrammar[field]\n            if (cellDef?.display) {\n                // move field into 'display' object\n                row.display = row.display || {}\n                row.display[field] = row[field]\n                delete row[field]\n            }\n        }\n\n        return trimAndParseObject(row, ColumnGrammar)\n    })\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/explorer/ExplorerUtils.d.ts

@@ -0,0 +1,5 @@
+import { SelectionArray } from "../grapher/index.js";
+import { Bounds } from "../utils/index.js";
+import { ExplorerProps } from "./Explorer.js";
+export declare function buildExplorerProps(html: string, queryStr: string, selection: SelectionArray, bounds?: Bounds): Promise<ExplorerProps>;
+//# sourceMappingURL=ExplorerUtils.d.ts.map

package/dist/explorer/ExplorerUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExplorerUtils.d.ts","sourceRoot":"","sources":["../../src/explorer/ExplorerUtils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAAE,MAAM,EAA2B,MAAM,mBAAmB,CAAA;AAOnE,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAE7C,wBAAsB,kBAAkB,CACpC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,cAAc,EACzB,MAAM,CAAC,EAAE,MAAM,0BA2ClB"}

package/dist/explorer/ExplorerUtils.js

@@ -0,0 +1,55 @@
+import * as _ from "lodash-es";
+import { SelectionArray } from "../grapher/index.js";
+import { deserializeJSONFromHTML } from "../utils/index.js";
+import {
+  EMBEDDED_EXPLORER_DELIMITER,
+  EMBEDDED_EXPLORER_GRAPHER_CONFIGS,
+  EMBEDDED_EXPLORER_PARTIAL_GRAPHER_CONFIGS,
+  EXPLORER_CONSTANTS_DELIMITER
+} from "./ExplorerConstants.js";
+async function buildExplorerProps(html, queryStr, selection, bounds) {
+  const explorerConstants = deserializeJSONFromHTML(
+    html,
+    EXPLORER_CONSTANTS_DELIMITER
+  );
+  let grapherConfigs = deserializeJSONFromHTML(
+    html,
+    EMBEDDED_EXPLORER_GRAPHER_CONFIGS
+  );
+  let partialGrapherConfigs = deserializeJSONFromHTML(
+    html,
+    EMBEDDED_EXPLORER_PARTIAL_GRAPHER_CONFIGS
+  );
+  if (_.isArray(grapherConfigs)) {
+    grapherConfigs = grapherConfigs.map((grapherConfig) => ({
+      ...grapherConfig,
+      adminBaseUrl: explorerConstants.adminBaseUrl,
+      bakedGrapherURL: explorerConstants.bakedGrapherUrl
+    }));
+  }
+  if (_.isArray(partialGrapherConfigs)) {
+    partialGrapherConfigs = partialGrapherConfigs.map((grapherConfig) => ({
+      ...grapherConfig,
+      adminBaseUrl: explorerConstants.adminBaseUrl,
+      bakedGrapherURL: explorerConstants.bakedGrapherUrl
+    }));
+  }
+  const props = {
+    ...deserializeJSONFromHTML(html, EMBEDDED_EXPLORER_DELIMITER),
+    isEmbeddedInPage: true,
+    adminBaseUrl: explorerConstants.adminBaseUrl,
+    bakedBaseUrl: explorerConstants.bakedBaseUrl,
+    bakedGrapherUrl: explorerConstants.bakedGrapherUrl,
+    dataApiUrl: explorerConstants.dataApiUrl,
+    grapherConfigs,
+    partialGrapherConfigs,
+    queryStr,
+    selection: new SelectionArray(selection.selectedEntityNames),
+    bounds,
+    staticBounds: bounds
+  };
+  return props;
+}
+export {
+  buildExplorerProps
+};

package/dist/explorer/ExplorerUtils.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["src/explorer/ExplorerUtils.ts"],
+  "sourcesContent": ["import * as _ from \"lodash-es\"\nimport { SelectionArray } from \"../grapher/index.js\"\nimport { Bounds, deserializeJSONFromHTML } from \"../utils/index.js\"\nimport {\n    EMBEDDED_EXPLORER_DELIMITER,\n    EMBEDDED_EXPLORER_GRAPHER_CONFIGS,\n    EMBEDDED_EXPLORER_PARTIAL_GRAPHER_CONFIGS,\n    EXPLORER_CONSTANTS_DELIMITER,\n} from \"./ExplorerConstants.js\"\nimport { ExplorerProps } from \"./Explorer.js\"\n\nexport async function buildExplorerProps(\n    html: string,\n    queryStr: string,\n    selection: SelectionArray,\n    bounds?: Bounds\n) {\n    const explorerConstants = deserializeJSONFromHTML(\n        html,\n        EXPLORER_CONSTANTS_DELIMITER\n    )\n    let grapherConfigs = deserializeJSONFromHTML(\n        html,\n        EMBEDDED_EXPLORER_GRAPHER_CONFIGS\n    )\n    let partialGrapherConfigs = deserializeJSONFromHTML(\n        html,\n        EMBEDDED_EXPLORER_PARTIAL_GRAPHER_CONFIGS\n    )\n    if (_.isArray(grapherConfigs)) {\n        grapherConfigs = grapherConfigs.map((grapherConfig) => ({\n            ...grapherConfig,\n            adminBaseUrl: explorerConstants.adminBaseUrl,\n            bakedGrapherURL: explorerConstants.bakedGrapherUrl,\n        }))\n    }\n    if (_.isArray(partialGrapherConfigs)) {\n        partialGrapherConfigs = partialGrapherConfigs.map((grapherConfig) => ({\n            ...grapherConfig,\n            adminBaseUrl: explorerConstants.adminBaseUrl,\n            bakedGrapherURL: explorerConstants.bakedGrapherUrl,\n        }))\n    }\n    const props: ExplorerProps = {\n        ...deserializeJSONFromHTML(html, EMBEDDED_EXPLORER_DELIMITER),\n        isEmbeddedInPage: true,\n        adminBaseUrl: explorerConstants.adminBaseUrl,\n        bakedBaseUrl: explorerConstants.bakedBaseUrl,\n        bakedGrapherUrl: explorerConstants.bakedGrapherUrl,\n        dataApiUrl: explorerConstants.dataApiUrl,\n        grapherConfigs,\n        partialGrapherConfigs,\n        queryStr,\n        selection: new SelectionArray(selection.selectedEntityNames),\n        bounds: bounds,\n        staticBounds: bounds,\n    }\n    return props\n}\n"],
+  "mappings": "AAAA,YAAY,OAAO;AACnB,SAAS,sBAAsB;AAC/B,SAAiB,+BAA+B;AAChD;AAAA,EACI;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACG;AAGP,eAAsB,mBAClB,MACA,UACA,WACA,QACF;AACE,QAAM,oBAAoB;AAAA,IACtB;AAAA,IACA;AAAA,EACJ;AACA,MAAI,iBAAiB;AAAA,IACjB;AAAA,IACA;AAAA,EACJ;AACA,MAAI,wBAAwB;AAAA,IACxB;AAAA,IACA;AAAA,EACJ;AACA,MAAI,EAAE,QAAQ,cAAc,GAAG;AAC3B,qBAAiB,eAAe,IAAI,CAAC,mBAAmB;AAAA,MACpD,GAAG;AAAA,MACH,cAAc,kBAAkB;AAAA,MAChC,iBAAiB,kBAAkB;AAAA,IACvC,EAAE;AAAA,EACN;AACA,MAAI,EAAE,QAAQ,qBAAqB,GAAG;AAClC,4BAAwB,sBAAsB,IAAI,CAAC,mBAAmB;AAAA,MAClE,GAAG;AAAA,MACH,cAAc,kBAAkB;AAAA,MAChC,iBAAiB,kBAAkB;AAAA,IACvC,EAAE;AAAA,EACN;AACA,QAAM,QAAuB;AAAA,IACzB,GAAG,wBAAwB,MAAM,2BAA2B;AAAA,IAC5D,kBAAkB;AAAA,IAClB,cAAc,kBAAkB;AAAA,IAChC,cAAc,kBAAkB;AAAA,IAChC,iBAAiB,kBAAkB;AAAA,IACnC,YAAY,kBAAkB;AAAA,IAC9B;AAAA,IACA;AAAA,IACA;AAAA,IACA,WAAW,IAAI,eAAe,UAAU,mBAAmB;AAAA,IAC3D;AAAA,IACA,cAAc;AAAA,EAClB;AACA,SAAO;AACX;",
+  "names": []
+}

package/dist/explorer/GrapherGrammar.d.ts

@@ -0,0 +1,5 @@
+import { Grammar, GrapherCellDef } from "./gridLang/GridLangConstants.js";
+export declare const GrapherGrammar: Grammar<GrapherCellDef>;
+export declare function omitEmptyStringValues<T extends Record<string, any>>(obj: T): Record<string, any>;
+export declare function omitEmptyObjectValues<T extends Record<string, any>>(obj: T): Record<string, any>;
+//# sourceMappingURL=GrapherGrammar.d.ts.map

package/dist/explorer/GrapherGrammar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GrapherGrammar.d.ts","sourceRoot":"","sources":["../../src/explorer/GrapherGrammar.ts"],"names":[],"mappings":"AAYA,OAAO,EAKH,OAAO,EAUP,cAAc,EACjB,MAAM,iCAAiC,CAAA;AAUxC,eAAO,MAAM,cAAc,EAAE,OAAO,CAAC,cAAc,CA6UzC,CAAA;AAEV,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC/D,GAAG,EAAE,CAAC,GACP,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAErB;AAED,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC/D,GAAG,EAAE,CAAC,GACP,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAKrB"}