@buildcanada/charts 0.3.6 → 0.3.8

package/dist/explorer/gridLang/GridCell.js

@@ -0,0 +1,220 @@
+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 { trimArray } from "../../core-table/index.js";
+import { imemo, isPresent } from "../../utils/index.js";
+import { didYouMean, isBlankLine, isEmpty } from "./GrammarUtils.js";
+import {
+  CellHasErrorsClass,
+  FrontierCellClass,
+  CommentCellDef,
+  SubTableValueCellDef,
+  WorkInProgressCellDef,
+  NothingGoesThereCellDef
+} from "./GridLangConstants.js";
+class GridCell {
+  constructor(matrix, position, rootDefinition) {
+    this.position = position;
+    this.matrix = matrix;
+    this.rootDefinition = rootDefinition;
+  }
+  get row() {
+    return this.position.row;
+  }
+  get column() {
+    return this.position.column;
+  }
+  get line() {
+    return this.matrix[this.row];
+  }
+  get isCommentCell() {
+    const { contents } = this;
+    return contents && CommentCellDef.regex.test(contents);
+  }
+  get cellTerminalTypeDefinition() {
+    const { rootDefinition } = this;
+    if (this.isCommentCell) return CommentCellDef;
+    const grammar = rootDefinition.grammar;
+    if (this.column === 0) return rootDefinition;
+    const firstWordOnLine = this.line ? this.line[0] : void 0;
+    const isFirstWordAKeyword = firstWordOnLine && grammar[firstWordOnLine] !== void 0;
+    if (this.column === 1 && firstWordOnLine && isFirstWordAKeyword)
+      return grammar[firstWordOnLine];
+    if (!isFirstWordAKeyword) return void 0;
+    const def = grammar[firstWordOnLine];
+    const positionalCellTypeDef = def.positionalCellDefs && def.positionalCellDefs[this.column - 2];
+    if (positionalCellTypeDef) return positionalCellTypeDef;
+    if (def.isHorizontalList && this.contents) return def;
+    return NothingGoesThereCellDef;
+  }
+  get parentSubTableInfo() {
+    const { row, matrix } = this;
+    let pointerRow = row;
+    let subTableHeaderRow = -1;
+    while (pointerRow >= 0) {
+      const line = matrix[pointerRow];
+      if (!line) break;
+      const parentKeyword = line[0];
+      if (parentKeyword) {
+        if (subTableHeaderRow === -1) return void 0;
+        return {
+          parentKeyword,
+          parentRow: pointerRow,
+          subTableHeaderRow,
+          isCellInHeader: row === subTableHeaderRow,
+          headerKeyword: matrix[subTableHeaderRow][this.column]
+        };
+      }
+      if (!isBlankLine(line)) subTableHeaderRow = pointerRow;
+      pointerRow--;
+    }
+    return void 0;
+  }
+  get subTableParseResults() {
+    const { cellTerminalTypeDefinition } = this;
+    if (cellTerminalTypeDefinition) return void 0;
+    const info = this.parentSubTableInfo;
+    if (!info) return void 0;
+    const {
+      parentKeyword,
+      isCellInHeader,
+      subTableHeaderRow,
+      headerKeyword
+    } = info;
+    const subTableDef = this.rootDefinition.grammar[parentKeyword];
+    const headerCellDef = subTableDef && subTableDef.headerCellDef;
+    if (!headerCellDef) return void 0;
+    const headerGrammar = headerCellDef.grammar;
+    const valueCellDef = !isCellInHeader && headerGrammar ? headerGrammar[headerKeyword] : void 0;
+    return {
+      isFrontierCell: this.isSubTableFrontierCell(
+        subTableHeaderRow,
+        subTableDef
+      ),
+      def: isCellInHeader ? headerCellDef : valueCellDef ?? SubTableValueCellDef
+    };
+  }
+  /**
+   * If a cell is:
+   *  - to the right of the last filled cell in a line
+   *  - and that line is indented to be part of a subtable, with options
+   *  - and it is the first non-blank line in the subtabel
+   *
+   * Then consider is a "frontier cell"
+   *
+   */
+  isSubTableFrontierCell(headerRow, subTableDef) {
+    const { line, column, row } = this;
+    const grammar = subTableDef.headerCellDef.grammar;
+    const isToTheImmediateRightOfLastFullCell = line && trimArray(line).length === column;
+    return row === headerRow && !isBlankLine(line) && isToTheImmediateRightOfLastFullCell && grammar && Object.keys(grammar).length;
+  }
+  // If true show a +
+  get isFirstCellOnFrontierRow() {
+    const { row, column } = this;
+    const numRows = this.matrix.length;
+    if (column) return false;
+    if (!isBlankLine(this.line)) return false;
+    if (numRows === 1) {
+      if (row === 1) return !isBlankLine(this.matrix[0]);
+      return row === 0;
+    }
+    return row === numRows;
+  }
+  get suggestions() {
+    return [];
+  }
+  get definitionLinks() {
+    return [];
+  }
+  get implementationLinks() {
+    return [];
+  }
+  get cellDef() {
+    const def = this.cellTerminalTypeDefinition;
+    if (def) return def;
+    const subTable = this.subTableParseResults?.def;
+    if (subTable) return subTable;
+    return WorkInProgressCellDef;
+  }
+  get errorMessage() {
+    if (!this.line) return "";
+    const { cellDef, contents, optionKeywords } = this;
+    const { regex, requirementsDescription, catchAllCellDef } = cellDef;
+    const catchAllKeywordRegex = catchAllCellDef?.regex;
+    if (contents === void 0 || contents === "") return "";
+    const regexResult = regex ? validate(contents, regex, requirementsDescription) : void 0;
+    const catchAllRegexResult = catchAllKeywordRegex ? validate(
+      contents,
+      catchAllKeywordRegex,
+      catchAllCellDef.requirementsDescription
+    ) : void 0;
+    if (optionKeywords) {
+      if (optionKeywords.includes(contents)) return "";
+      if (regex) return regexResult;
+      if (catchAllKeywordRegex) return catchAllRegexResult;
+      const guess = didYouMean(contents, optionKeywords);
+      if (guess) return `Did you mean '${guess}'?`;
+      return `Error: '${contents}' is not a valid option. Valid options are ${optionKeywords.map((opt) => `'${opt}'`).join(", ")}`;
+    }
+    if (regex) return regexResult;
+    if (catchAllKeywordRegex) return catchAllRegexResult;
+    return "";
+  }
+  get contents() {
+    return this.line ? this.line[this.column] : void 0;
+  }
+  get comment() {
+    const { contents, errorMessage, cellDef } = this;
+    if (isEmpty(contents)) return void 0;
+    if (errorMessage) return errorMessage;
+    if (cellDef.grammar) {
+      const def = cellDef.grammar[contents] ?? cellDef.catchAllCellDef;
+      return def.description;
+    }
+    return [cellDef.description].join("\n");
+  }
+  get cssClasses() {
+    const { errorMessage, cellDef } = this;
+    if (errorMessage) return [CellHasErrorsClass];
+    const showArrow = this.isFirstCellOnFrontierRow || this.subTableParseResults?.isFrontierCell ? FrontierCellClass : void 0;
+    const hasSuggestions = this.cellDef.keyword === "table" ? "HasSuggestions" : null;
+    return [cellDef.cssClass, hasSuggestions, showArrow].filter(isPresent);
+  }
+  get placeholder() {
+    const { contents, cellDef } = this;
+    const { terminalOptions } = cellDef;
+    const firstOption = terminalOptions && terminalOptions[0];
+    const firstOptionName = firstOption && firstOption.keyword;
+    const placeholder = cellDef.valuePlaceholder ?? firstOptionName;
+    return isEmpty(contents) && placeholder ? `eg "${placeholder}"` : void 0;
+  }
+  get optionKeywords() {
+    const { cellDef } = this;
+    const { grammar, headerCellDef, terminalOptions } = cellDef;
+    return terminalOptions ? terminalOptions.map((def) => def.keyword) : grammar ? Object.keys(grammar) : headerCellDef ? Object.keys(headerCellDef.grammar) : void 0;
+  }
+}
+__decorateClass([
+  imemo
+], GridCell.prototype, "subTableParseResults", 1);
+__decorateClass([
+  imemo
+], GridCell.prototype, "cellDef", 1);
+const validate = (value, regex, requirements) => {
+  if (typeof value !== "string") return "";
+  if (!regex.test(value)) {
+    return `Error: ${requirements ? requirements : `'${value}' did not validate against ${regex}`}`;
+  }
+  return "";
+};
+export {
+  GridCell
+};

package/dist/explorer/gridLang/GridCell.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["src/explorer/gridLang/GridCell.ts"],
+  "sourcesContent": ["import { trimArray } from \"../../core-table/index.js\"\nimport { imemo, isPresent } from \"../../utils/index.js\"\n\nimport { didYouMean, isBlankLine, isEmpty } from \"./GrammarUtils.js\"\nimport {\n    CellPosition,\n    CellDef,\n    CellHasErrorsClass,\n    MatrixLine,\n    MatrixProgram,\n    Grammar,\n    FrontierCellClass,\n    ParsedCell,\n    CommentCellDef,\n    SubTableValueCellDef,\n    WorkInProgressCellDef,\n    NothingGoesThereCellDef,\n} from \"./GridLangConstants.js\"\n\nexport class GridCell implements ParsedCell {\n    private position: CellPosition\n    private matrix: MatrixProgram\n    private rootDefinition: CellDef\n    constructor(\n        matrix: MatrixProgram,\n        position: CellPosition,\n        rootDefinition: CellDef\n    ) {\n        this.position = position\n        this.matrix = matrix\n        this.rootDefinition = rootDefinition\n    }\n\n    private get row() {\n        return this.position.row\n    }\n\n    private get column() {\n        return this.position.column\n    }\n\n    private get line(): MatrixLine | undefined {\n        return this.matrix[this.row]\n    }\n\n    private get isCommentCell() {\n        const { contents } = this\n        return contents && CommentCellDef.regex!.test(contents)\n    }\n\n    private get cellTerminalTypeDefinition(): CellDef | undefined {\n        const { rootDefinition } = this\n        if (this.isCommentCell) return CommentCellDef\n        const grammar = rootDefinition.grammar as unknown as Grammar\n        if (this.column === 0) return rootDefinition as unknown as CellDef\n        const firstWordOnLine = this.line ? this.line[0] : undefined\n        const isFirstWordAKeyword =\n            firstWordOnLine && grammar[firstWordOnLine] !== undefined\n        if (this.column === 1 && firstWordOnLine && isFirstWordAKeyword)\n            return grammar[firstWordOnLine]\n\n        if (!isFirstWordAKeyword) return undefined\n\n        // It has a keyword but it is column >1\n        const def = grammar[firstWordOnLine!]\n        const positionalCellTypeDef =\n            def.positionalCellDefs && def.positionalCellDefs[this.column - 2]\n        if (positionalCellTypeDef) return positionalCellTypeDef\n        if (def.isHorizontalList && this.contents) return def // For now only return a def for lists if it is non-empty\n        return NothingGoesThereCellDef\n    }\n\n    private get parentSubTableInfo() {\n        const { row, matrix } = this\n        let pointerRow = row\n        let subTableHeaderRow = -1\n        while (pointerRow >= 0) {\n            const line = matrix[pointerRow]\n            if (!line) break\n            const parentKeyword = line[0]\n            if (parentKeyword) {\n                if (subTableHeaderRow === -1) return undefined\n                return {\n                    parentKeyword,\n                    parentRow: pointerRow,\n                    subTableHeaderRow,\n                    isCellInHeader: row === subTableHeaderRow,\n                    headerKeyword: matrix[subTableHeaderRow][this.column],\n                }\n            }\n\n            if (!isBlankLine(line)) subTableHeaderRow = pointerRow\n            pointerRow--\n        }\n\n        return undefined\n    }\n\n    @imemo private get subTableParseResults() {\n        const { cellTerminalTypeDefinition } = this\n        if (cellTerminalTypeDefinition) return undefined\n\n        const info = this.parentSubTableInfo\n\n        if (!info) return undefined\n\n        const {\n            parentKeyword,\n            isCellInHeader,\n            subTableHeaderRow,\n            headerKeyword,\n        } = info\n\n        const subTableDef = this.rootDefinition.grammar![parentKeyword]\n\n        const headerCellDef = subTableDef && subTableDef.headerCellDef\n\n        if (!headerCellDef) return undefined\n\n        const headerGrammar = headerCellDef.grammar\n        const valueCellDef =\n            !isCellInHeader && headerGrammar\n                ? headerGrammar[headerKeyword]\n                : undefined\n\n        return {\n            isFrontierCell: this.isSubTableFrontierCell(\n                subTableHeaderRow,\n                subTableDef\n            ),\n            def: isCellInHeader\n                ? headerCellDef\n                : (valueCellDef ?? SubTableValueCellDef),\n        }\n    }\n\n    /**\n     * If a cell is:\n     *  - to the right of the last filled cell in a line\n     *  - and that line is indented to be part of a subtable, with options\n     *  - and it is the first non-blank line in the subtabel\n     *\n     * Then consider is a \"frontier cell\"\n     *\n     */\n    private isSubTableFrontierCell(headerRow: number, subTableDef: CellDef) {\n        const { line, column, row } = this\n        const grammar = subTableDef.headerCellDef!.grammar\n        const isToTheImmediateRightOfLastFullCell =\n            line && trimArray(line).length === column\n        return (\n            row === headerRow &&\n            !isBlankLine(line) &&\n            isToTheImmediateRightOfLastFullCell &&\n            grammar &&\n            Object.keys(grammar).length\n        )\n    }\n\n    // If true show a +\n    private get isFirstCellOnFrontierRow() {\n        const { row, column } = this\n        const numRows = this.matrix.length\n        if (column) return false // Only first column should have a +\n        if (!isBlankLine(this.line)) return false // Only blank lines can be frontier\n        if (numRows === 1) {\n            if (row === 1) return !isBlankLine(this.matrix[0])\n            return row === 0\n        }\n        return row === numRows\n    }\n\n    private get suggestions() {\n        return []\n    }\n\n    private get definitionLinks(): CellPosition[] {\n        return []\n    }\n\n    private get implementationLinks(): CellPosition[] {\n        return []\n    }\n\n    @imemo get cellDef(): CellDef {\n        const def = this.cellTerminalTypeDefinition\n        if (def) return def\n\n        const subTable = this.subTableParseResults?.def\n        if (subTable) return subTable as unknown as CellDef\n\n        return WorkInProgressCellDef\n    }\n\n    get errorMessage() {\n        if (!this.line) return \"\"\n        const { cellDef, contents, optionKeywords } = this\n        const { regex, requirementsDescription, catchAllCellDef } = cellDef\n        const catchAllKeywordRegex = catchAllCellDef?.regex\n\n        if (contents === undefined || contents === \"\") return \"\"\n\n        const regexResult = regex\n            ? validate(contents, regex, requirementsDescription)\n            : undefined\n        const catchAllRegexResult = catchAllKeywordRegex\n            ? validate(\n                  contents,\n                  catchAllKeywordRegex,\n                  catchAllCellDef!.requirementsDescription\n              )\n            : undefined\n\n        if (optionKeywords) {\n            if (optionKeywords.includes(contents)) return \"\"\n\n            if (regex) return regexResult\n            if (catchAllKeywordRegex) return catchAllRegexResult\n\n            const guess = didYouMean(contents, optionKeywords)\n            if (guess) return `Did you mean '${guess}'?`\n\n            return `Error: '${contents}' is not a valid option. Valid options are ${optionKeywords\n                .map((opt) => `'${opt}'`)\n                .join(\", \")}`\n        }\n\n        if (regex) return regexResult\n        if (catchAllKeywordRegex) return catchAllRegexResult\n\n        return \"\"\n    }\n\n    get contents() {\n        return this.line ? this.line[this.column] : undefined\n    }\n\n    get comment() {\n        const { contents, errorMessage, cellDef } = this\n        if (isEmpty(contents)) return undefined\n        if (errorMessage) return errorMessage\n\n        if (cellDef.grammar) {\n            const def = cellDef.grammar[contents!] ?? cellDef.catchAllCellDef\n            return def.description\n        }\n\n        return [cellDef.description].join(\"\\n\")\n    }\n\n    get cssClasses() {\n        const { errorMessage, cellDef } = this\n        if (errorMessage) return [CellHasErrorsClass]\n        const showArrow =\n            this.isFirstCellOnFrontierRow ||\n            this.subTableParseResults?.isFrontierCell\n                ? FrontierCellClass\n                : undefined\n        const hasSuggestions =\n            this.cellDef.keyword === \"table\" ? \"HasSuggestions\" : null // todo: switch from strings to constants\n        return [cellDef.cssClass, hasSuggestions, showArrow].filter(isPresent)\n    }\n\n    get placeholder() {\n        const { contents, cellDef } = this\n        const { terminalOptions } = cellDef\n        const firstOption = terminalOptions && terminalOptions[0]\n        const firstOptionName = firstOption && firstOption.keyword\n        const placeholder = cellDef.valuePlaceholder ?? firstOptionName\n        return isEmpty(contents) && placeholder\n            ? `eg \"${placeholder}\"`\n            : undefined\n    }\n\n    get optionKeywords() {\n        const { cellDef } = this\n        const { grammar, headerCellDef, terminalOptions } = cellDef\n        return terminalOptions\n            ? terminalOptions.map((def) => def.keyword)\n            : grammar\n              ? Object.keys(grammar)\n              : headerCellDef\n                ? Object.keys(headerCellDef.grammar!)\n                : undefined\n    }\n}\n\nconst validate = (value: any, regex: RegExp, requirements?: string) => {\n    if (typeof value !== \"string\") return \"\"\n    if (!regex.test(value)) {\n        return `Error: ${\n            requirements\n                ? requirements\n                : `'${value}' did not validate against ${regex}`\n        }`\n    }\n    return \"\"\n}\n"],
+  "mappings": ";;;;;;;;;;AAAA,SAAS,iBAAiB;AAC1B,SAAS,OAAO,iBAAiB;AAEjC,SAAS,YAAY,aAAa,eAAe;AACjD;AAAA,EAGI;AAAA,EAIA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACG;AAEA,MAAM,SAA+B;AAAA,EAIxC,YACI,QACA,UACA,gBACF;AACE,SAAK,WAAW;AAChB,SAAK,SAAS;AACd,SAAK,iBAAiB;AAAA,EAC1B;AAAA,EAEA,IAAY,MAAM;AACd,WAAO,KAAK,SAAS;AAAA,EACzB;AAAA,EAEA,IAAY,SAAS;AACjB,WAAO,KAAK,SAAS;AAAA,EACzB;AAAA,EAEA,IAAY,OAA+B;AACvC,WAAO,KAAK,OAAO,KAAK,GAAG;AAAA,EAC/B;AAAA,EAEA,IAAY,gBAAgB;AACxB,UAAM,EAAE,SAAS,IAAI;AACrB,WAAO,YAAY,eAAe,MAAO,KAAK,QAAQ;AAAA,EAC1D;AAAA,EAEA,IAAY,6BAAkD;AAC1D,UAAM,EAAE,eAAe,IAAI;AAC3B,QAAI,KAAK,cAAe,QAAO;AAC/B,UAAM,UAAU,eAAe;AAC/B,QAAI,KAAK,WAAW,EAAG,QAAO;AAC9B,UAAM,kBAAkB,KAAK,OAAO,KAAK,KAAK,CAAC,IAAI;AACnD,UAAM,sBACF,mBAAmB,QAAQ,eAAe,MAAM;AACpD,QAAI,KAAK,WAAW,KAAK,mBAAmB;AACxC,aAAO,QAAQ,eAAe;AAElC,QAAI,CAAC,oBAAqB,QAAO;AAGjC,UAAM,MAAM,QAAQ,eAAgB;AACpC,UAAM,wBACF,IAAI,sBAAsB,IAAI,mBAAmB,KAAK,SAAS,CAAC;AACpE,QAAI,sBAAuB,QAAO;AAClC,QAAI,IAAI,oBAAoB,KAAK,SAAU,QAAO;AAClD,WAAO;AAAA,EACX;AAAA,EAEA,IAAY,qBAAqB;AAC7B,UAAM,EAAE,KAAK,OAAO,IAAI;AACxB,QAAI,aAAa;AACjB,QAAI,oBAAoB;AACxB,WAAO,cAAc,GAAG;AACpB,YAAM,OAAO,OAAO,UAAU;AAC9B,UAAI,CAAC,KAAM;AACX,YAAM,gBAAgB,KAAK,CAAC;AAC5B,UAAI,eAAe;AACf,YAAI,sBAAsB,GAAI,QAAO;AACrC,eAAO;AAAA,UACH;AAAA,UACA,WAAW;AAAA,UACX;AAAA,UACA,gBAAgB,QAAQ;AAAA,UACxB,eAAe,OAAO,iBAAiB,EAAE,KAAK,MAAM;AAAA,QACxD;AAAA,MACJ;AAEA,UAAI,CAAC,YAAY,IAAI,EAAG,qBAAoB;AAC5C;AAAA,IACJ;AAEA,WAAO;AAAA,EACX;AAAA,EAEO,IAAY,uBAAuB;AACtC,UAAM,EAAE,2BAA2B,IAAI;AACvC,QAAI,2BAA4B,QAAO;AAEvC,UAAM,OAAO,KAAK;AAElB,QAAI,CAAC,KAAM,QAAO;AAElB,UAAM;AAAA,MACF;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACJ,IAAI;AAEJ,UAAM,cAAc,KAAK,eAAe,QAAS,aAAa;AAE9D,UAAM,gBAAgB,eAAe,YAAY;AAEjD,QAAI,CAAC,cAAe,QAAO;AAE3B,UAAM,gBAAgB,cAAc;AACpC,UAAM,eACF,CAAC,kBAAkB,gBACb,cAAc,aAAa,IAC3B;AAEV,WAAO;AAAA,MACH,gBAAgB,KAAK;AAAA,QACjB;AAAA,QACA;AAAA,MACJ;AAAA,MACA,KAAK,iBACC,gBACC,gBAAgB;AAAA,IAC3B;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWQ,uBAAuB,WAAmB,aAAsB;AACpE,UAAM,EAAE,MAAM,QAAQ,IAAI,IAAI;AAC9B,UAAM,UAAU,YAAY,cAAe;AAC3C,UAAM,sCACF,QAAQ,UAAU,IAAI,EAAE,WAAW;AACvC,WACI,QAAQ,aACR,CAAC,YAAY,IAAI,KACjB,uCACA,WACA,OAAO,KAAK,OAAO,EAAE;AAAA,EAE7B;AAAA;AAAA,EAGA,IAAY,2BAA2B;AACnC,UAAM,EAAE,KAAK,OAAO,IAAI;AACxB,UAAM,UAAU,KAAK,OAAO;AAC5B,QAAI,OAAQ,QAAO;AACnB,QAAI,CAAC,YAAY,KAAK,IAAI,EAAG,QAAO;AACpC,QAAI,YAAY,GAAG;AACf,UAAI,QAAQ,EAAG,QAAO,CAAC,YAAY,KAAK,OAAO,CAAC,CAAC;AACjD,aAAO,QAAQ;AAAA,IACnB;AACA,WAAO,QAAQ;AAAA,EACnB;AAAA,EAEA,IAAY,cAAc;AACtB,WAAO,CAAC;AAAA,EACZ;AAAA,EAEA,IAAY,kBAAkC;AAC1C,WAAO,CAAC;AAAA,EACZ;AAAA,EAEA,IAAY,sBAAsC;AAC9C,WAAO,CAAC;AAAA,EACZ;AAAA,EAEO,IAAI,UAAmB;AAC1B,UAAM,MAAM,KAAK;AACjB,QAAI,IAAK,QAAO;AAEhB,UAAM,WAAW,KAAK,sBAAsB;AAC5C,QAAI,SAAU,QAAO;AAErB,WAAO;AAAA,EACX;AAAA,EAEA,IAAI,eAAe;AACf,QAAI,CAAC,KAAK,KAAM,QAAO;AACvB,UAAM,EAAE,SAAS,UAAU,eAAe,IAAI;AAC9C,UAAM,EAAE,OAAO,yBAAyB,gBAAgB,IAAI;AAC5D,UAAM,uBAAuB,iBAAiB;AAE9C,QAAI,aAAa,UAAa,aAAa,GAAI,QAAO;AAEtD,UAAM,cAAc,QACd,SAAS,UAAU,OAAO,uBAAuB,IACjD;AACN,UAAM,sBAAsB,uBACtB;AAAA,MACI;AAAA,MACA;AAAA,MACA,gBAAiB;AAAA,IACrB,IACA;AAEN,QAAI,gBAAgB;AAChB,UAAI,eAAe,SAAS,QAAQ,EAAG,QAAO;AAE9C,UAAI,MAAO,QAAO;AAClB,UAAI,qBAAsB,QAAO;AAEjC,YAAM,QAAQ,WAAW,UAAU,cAAc;AACjD,UAAI,MAAO,QAAO,iBAAiB,KAAK;AAExC,aAAO,WAAW,QAAQ,8CAA8C,eACnE,IAAI,CAAC,QAAQ,IAAI,GAAG,GAAG,EACvB,KAAK,IAAI,CAAC;AAAA,IACnB;AAEA,QAAI,MAAO,QAAO;AAClB,QAAI,qBAAsB,QAAO;AAEjC,WAAO;AAAA,EACX;AAAA,EAEA,IAAI,WAAW;AACX,WAAO,KAAK,OAAO,KAAK,KAAK,KAAK,MAAM,IAAI;AAAA,EAChD;AAAA,EAEA,IAAI,UAAU;AACV,UAAM,EAAE,UAAU,cAAc,QAAQ,IAAI;AAC5C,QAAI,QAAQ,QAAQ,EAAG,QAAO;AAC9B,QAAI,aAAc,QAAO;AAEzB,QAAI,QAAQ,SAAS;AACjB,YAAM,MAAM,QAAQ,QAAQ,QAAS,KAAK,QAAQ;AAClD,aAAO,IAAI;AAAA,IACf;AAEA,WAAO,CAAC,QAAQ,WAAW,EAAE,KAAK,IAAI;AAAA,EAC1C;AAAA,EAEA,IAAI,aAAa;AACb,UAAM,EAAE,cAAc,QAAQ,IAAI;AAClC,QAAI,aAAc,QAAO,CAAC,kBAAkB;AAC5C,UAAM,YACF,KAAK,4BACL,KAAK,sBAAsB,iBACrB,oBACA;AACV,UAAM,iBACF,KAAK,QAAQ,YAAY,UAAU,mBAAmB;AAC1D,WAAO,CAAC,QAAQ,UAAU,gBAAgB,SAAS,EAAE,OAAO,SAAS;AAAA,EACzE;AAAA,EAEA,IAAI,cAAc;AACd,UAAM,EAAE,UAAU,QAAQ,IAAI;AAC9B,UAAM,EAAE,gBAAgB,IAAI;AAC5B,UAAM,cAAc,mBAAmB,gBAAgB,CAAC;AACxD,UAAM,kBAAkB,eAAe,YAAY;AACnD,UAAM,cAAc,QAAQ,oBAAoB;AAChD,WAAO,QAAQ,QAAQ,KAAK,cACtB,OAAO,WAAW,MAClB;AAAA,EACV;AAAA,EAEA,IAAI,iBAAiB;AACjB,UAAM,EAAE,QAAQ,IAAI;AACpB,UAAM,EAAE,SAAS,eAAe,gBAAgB,IAAI;AACpD,WAAO,kBACD,gBAAgB,IAAI,CAAC,QAAQ,IAAI,OAAO,IACxC,UACE,OAAO,KAAK,OAAO,IACnB,gBACE,OAAO,KAAK,cAAc,OAAQ,IAClC;AAAA,EACd;AACJ;AA3LuB;AAAA,EAAlB;AAAA,GA/EQ,SA+EU;AAsFR;AAAA,EAAV;AAAA,GArKQ,SAqKE;AAuGf,MAAM,WAAW,CAAC,OAAY,OAAe,iBAA0B;AACnE,MAAI,OAAO,UAAU,SAAU,QAAO;AACtC,MAAI,CAAC,MAAM,KAAK,KAAK,GAAG;AACpB,WAAO,UACH,eACM,eACA,IAAI,KAAK,8BAA8B,KAAK,EACtD;AAAA,EACJ;AACA,SAAO;AACX;",
+  "names": []
+}

package/dist/explorer/gridLang/GridLangConstants.d.ts

@@ -0,0 +1,75 @@
+import { GrapherInterface } from "../../types/index.js";
+export declare const CellHasErrorsClass = "CellHasErrorsClass";
+export declare enum GridBoolean {
+    true = "true",
+    false = "false"
+}
+export declare const GRID_NODE_DELIMITER = "\n";
+export declare const GRID_CELL_DELIMITER = "\t";
+export declare const GRID_EDGE_DELIMITER = "\t";
+export type CellCoordinate = number;
+export type Grammar<TCellDef extends CellDef = CellDef> = {
+    [keywordSlug: string]: TCellDef;
+};
+export interface CellDef {
+    keyword: string;
+    cssClass: string;
+    description: string;
+    grammar?: Grammar;
+    headerCellDef?: CellDef;
+    terminalOptions?: CellDef[];
+    catchAllCellDef?: CellDef;
+    regex?: RegExp;
+    requirementsDescription?: string;
+    valuePlaceholder?: string;
+    positionalCellDefs?: readonly CellDef[];
+    isHorizontalList?: boolean;
+    parse?: (value: any) => any;
+}
+export interface GrapherCellDef extends CellDef {
+    toGrapherObject: (value: any) => GrapherInterface;
+}
+export interface ColumnCellDef extends CellDef {
+    display?: boolean;
+}
+export interface ParsedCell {
+    errorMessage?: string;
+    cssClasses?: string[];
+    optionKeywords?: string[];
+    comment?: string;
+    cellDef?: CellDef;
+    placeholder?: string;
+    contents?: any;
+}
+export interface CellPosition {
+    row: CellCoordinate;
+    column: CellCoordinate;
+}
+export declare const Origin: CellPosition;
+export declare const BooleanCellDef: CellDef;
+export declare const StringCellDef: CellDef;
+export declare const StringDeclarationDef: CellDef;
+export declare const EnumCellDef: CellDef;
+export declare const RootKeywordCellDef: CellDef;
+export declare const NumericCellDef: CellDef;
+export declare const NumericOrAutoCellDef: CellDef;
+export declare const IntegerCellDef: CellDef;
+export declare const PositiveIntegersCellDef: CellDef;
+export declare const SubTableHeaderCellDef: CellDef;
+export declare const SubTableValueCellDef: CellDef;
+export declare const UrlCellDef: CellDef;
+export declare const QueryStringCellDef: CellDef;
+export declare const NothingGoesThereCellDef: CellDef;
+export declare const CommentCellDef: CellDef;
+export declare const WorkInProgressCellDef: CellDef;
+export declare const SlugDeclarationCellDef: CellDef;
+export declare const FrontierCellClass = "ShowDropdownArrow";
+export declare const SlugsDeclarationCellDef: CellDef;
+export declare const EtlPathCellDef: CellDef;
+export declare const IndicatorIdOrEtlPathCellDef: CellDef;
+export declare const SlugOrIndicatorIdOrEtlPathCellDef: CellDef;
+export declare const IndicatorIdsOrEtlPathsCellDef: CellDef;
+export declare const JSONObjectCellDef: CellDef;
+export type MatrixLine = string[];
+export type MatrixProgram = MatrixLine[];
+//# sourceMappingURL=GridLangConstants.d.ts.map

package/dist/explorer/gridLang/GridLangConstants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GridLangConstants.d.ts","sourceRoot":"","sources":["../../../src/explorer/gridLang/GridLangConstants.ts"],"names":[],"mappings":"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"}

package/dist/explorer/gridLang/GridLangConstants.js

@@ -0,0 +1,206 @@
+const CellHasErrorsClass = "CellHasErrorsClass";
+var GridBoolean = /* @__PURE__ */ ((GridBoolean2) => {
+  GridBoolean2["true"] = "true";
+  GridBoolean2["false"] = "false";
+  return GridBoolean2;
+})(GridBoolean || {});
+const GRID_NODE_DELIMITER = "\n";
+const GRID_CELL_DELIMITER = "	";
+const GRID_EDGE_DELIMITER = "	";
+const Origin = {
+  row: 0,
+  column: 0
+};
+const BooleanCellDef = {
+  keyword: "",
+  terminalOptions: [
+    { keyword: "true" /* true */, cssClass: "", description: "" },
+    { keyword: "false" /* false */, cssClass: "", description: "" }
+  ],
+  cssClass: "BooleanCellDef",
+  description: "Boolean",
+  parse: (value) => {
+    if (typeof value === "boolean") return value;
+    return value === "true" /* true */;
+  }
+};
+const StringCellDef = {
+  keyword: "",
+  cssClass: "StringCellDef",
+  description: "",
+  parse: (value) => `${value}`.replace(/\\n/g, "\n")
+};
+const StringDeclarationDef = {
+  keyword: "",
+  cssClass: "StringDeclarationDef",
+  description: ""
+};
+const EnumCellDef = {
+  keyword: "",
+  cssClass: "EnumCellDef",
+  description: ""
+};
+const RootKeywordCellDef = {
+  keyword: "",
+  cssClass: "KeywordCellDef",
+  description: "Keyword"
+};
+const NumericCellDef = {
+  keyword: "",
+  cssClass: "NumericCellDef",
+  description: "",
+  regex: /^-?\d+\.?\d*$/,
+  requirementsDescription: `Must be a number`,
+  valuePlaceholder: "98.6",
+  parse: (value) => parseFloat(value)
+};
+const NumericOrAutoCellDef = {
+  keyword: "",
+  cssClass: "NumericCellDef",
+  description: "",
+  regex: /^(-?\d+\.?\d*|auto)$/,
+  requirementsDescription: `Must be a number or "auto"`,
+  valuePlaceholder: "98.6",
+  parse: (value) => {
+    if (value === "auto") return "auto";
+    return parseFloat(value);
+  }
+};
+const IntegerCellDef = {
+  keyword: "",
+  cssClass: "IntegerCellDef",
+  description: "",
+  regex: /^-?[0-9]+$/,
+  requirementsDescription: `Must be an integer`,
+  valuePlaceholder: "12345",
+  parse: (value) => parseInt(value)
+};
+const PositiveIntegersCellDef = {
+  keyword: "",
+  cssClass: "IntegerCellDef",
+  description: "",
+  regex: /^[0-9 ]+$/,
+  requirementsDescription: `Must be a positive integer or a list of positive integers`,
+  valuePlaceholder: "12345 23456"
+};
+const SubTableHeaderCellDef = {
+  keyword: "",
+  cssClass: "SubTableHeaderCellDef",
+  description: ""
+};
+const SubTableValueCellDef = {
+  keyword: "",
+  cssClass: "SubTableValueCellDef",
+  description: ""
+};
+const MatchUrlsOnlyRegex = /((([A-Za-z]{3,9}:(?:\/\/)?)(?:[-;:&=+$,\w]+@)?[A-Za-z0-9.-]+|(?:www.|[-;:&=+$,\w]+@)[A-Za-z0-9.-]+)((?:\/[+~%/.\w-_]*)?\??(?:[-+=&;%@.\w_]*)#?(?:[\w]*))?)/;
+const UrlCellDef = {
+  keyword: "",
+  cssClass: "UrlCellDef",
+  description: "",
+  regex: MatchUrlsOnlyRegex
+};
+const QueryStringCellDef = {
+  keyword: "",
+  cssClass: "QueryStringCellDef",
+  description: ""
+};
+const NothingGoesThereCellDef = {
+  keyword: "",
+  cssClass: "NothingGoesThereType",
+  description: "Nothing should be here. You can make this a comment by prepending a ##"
+};
+const CommentCellDef = {
+  keyword: "",
+  cssClass: "CommentType",
+  description: "Just a comment.",
+  regex: /^(##|💬)/
+};
+const WorkInProgressCellDef = {
+  keyword: "",
+  cssClass: "WorkInProgressCellDef",
+  description: "Not a recognized statement. Treating as a work in progress."
+};
+const SlugDeclarationCellDef = {
+  keyword: "",
+  cssClass: "SlugDeclarationType",
+  description: "A unique URL-friendly name.",
+  regex: /^[a-zA-Z0-9-_]+$/,
+  requirementsDescription: `Can only contain the characters a-zA-Z0-9-_`
+};
+const FrontierCellClass = "ShowDropdownArrow";
+const SlugsDeclarationCellDef = {
+  keyword: "",
+  cssClass: "SlugDeclarationType",
+  description: "Unique URL-friendly names.",
+  regex: /^[a-zA-Z0-9-_ ]+$/,
+  requirementsDescription: `Can only contain the characters a-zA-Z0-9-_ `
+};
+const EtlPathCellDef = {
+  keyword: "",
+  cssClass: "IndicatorIdOrEtlPath",
+  description: "Path to an ETL indicator.",
+  regex: /^$|^[\w\d_/-]+#[\w\d_/-]+$/,
+  requirementsDescription: `Can only contain the characters a-zA-Z0-9-_/#`
+};
+const IndicatorIdOrEtlPathCellDef = {
+  keyword: "",
+  cssClass: "IndicatorIdOrEtlPath",
+  description: "A single indicator ID or a path to an ETL indicator.",
+  regex: /^\d+|[\w\d_/-]+#[\w\d_/-]+$/,
+  requirementsDescription: `Can only contain the characters a-zA-Z0-9-_/#`
+};
+const SlugOrIndicatorIdOrEtlPathCellDef = {
+  keyword: "",
+  cssClass: "SlugOrIndicatorIdOrEtlPath",
+  description: "A column slug, indicator ID, or catalog path.",
+  regex: /^[a-zA-Z0-9-_]+$|^\d+$|^[\w\d_/-]+#[\w\d_/-]+$/,
+  requirementsDescription: `Can be a slug (a-zA-Z0-9-_), an indicator ID (digits), or a catalog path (a-zA-Z0-9-_/#)`
+};
+const IndicatorIdsOrEtlPathsCellDef = {
+  keyword: "",
+  cssClass: "IndicatorIdOrEtlPath",
+  description: "One or more indicator IDs or paths to an ETL indicator.",
+  regex: /^((\d+|[\w\d_/-]*#[\w\d_/-]+)( +|$))+$/,
+  requirementsDescription: `Can only contain the characters a-zA-Z0-9-_/# `
+};
+const JSONObjectCellDef = {
+  keyword: "",
+  cssClass: "JSONObjectCellDef",
+  description: "JSON object",
+  regex: /^\{.*\}$/,
+  // very basic validation that expression starts with { and ends with }
+  requirementsDescription: "Must contain a valid JSON object"
+};
+export {
+  BooleanCellDef,
+  CellHasErrorsClass,
+  CommentCellDef,
+  EnumCellDef,
+  EtlPathCellDef,
+  FrontierCellClass,
+  GRID_CELL_DELIMITER,
+  GRID_EDGE_DELIMITER,
+  GRID_NODE_DELIMITER,
+  GridBoolean,
+  IndicatorIdOrEtlPathCellDef,
+  IndicatorIdsOrEtlPathsCellDef,
+  IntegerCellDef,
+  JSONObjectCellDef,
+  NothingGoesThereCellDef,
+  NumericCellDef,
+  NumericOrAutoCellDef,
+  Origin,
+  PositiveIntegersCellDef,
+  QueryStringCellDef,
+  RootKeywordCellDef,
+  SlugDeclarationCellDef,
+  SlugOrIndicatorIdOrEtlPathCellDef,
+  SlugsDeclarationCellDef,
+  StringCellDef,
+  StringDeclarationDef,
+  SubTableHeaderCellDef,
+  SubTableValueCellDef,
+  UrlCellDef,
+  WorkInProgressCellDef
+};

package/dist/explorer/gridLang/GridLangConstants.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["src/explorer/gridLang/GridLangConstants.ts"],
+  "sourcesContent": ["import { GrapherInterface } from \"../../types/index.js\"\n\nexport const CellHasErrorsClass = \"CellHasErrorsClass\"\n\nexport enum GridBoolean {\n    true = \"true\",\n    false = \"false\",\n}\n\nexport const GRID_NODE_DELIMITER = \"\\n\"\nexport const GRID_CELL_DELIMITER = \"\\t\"\nexport const GRID_EDGE_DELIMITER = \"\\t\"\n\nexport type CellCoordinate = number // An integer >= 0\n\nexport type Grammar<TCellDef extends CellDef = CellDef> = {\n    [keywordSlug: string]: TCellDef\n}\n\n// A CellDef is a tuple: part keyword and the other half is the contents. The contents can be 1 cell, a list of cells, and/or a subtable.\nexport interface CellDef {\n    keyword: string\n    cssClass: string\n    description: string\n    grammar?: Grammar\n    headerCellDef?: CellDef\n    terminalOptions?: CellDef[]\n    catchAllCellDef?: CellDef // Only used by vertical grammars, this cell def, if present, will be used if a keyword is unrecognized during parsing.\n    regex?: RegExp // A validation regex a value must pass. todo: seems like this is overloaded and used for testing keywords and contents.\n    requirementsDescription?: string\n    valuePlaceholder?: string\n    positionalCellDefs?: readonly CellDef[] // Additional cell types as positional arguments.\n    isHorizontalList?: boolean // a list type, such as \"colors\\tred\\torange\\tgreen\"\n    parse?: (value: any) => any\n}\n\nexport interface GrapherCellDef extends CellDef {\n    toGrapherObject: (value: any) => GrapherInterface // map to a partial config that is a valid GrapherInterface\n}\n\nexport interface ColumnCellDef extends CellDef {\n    display?: boolean\n}\n\nexport interface ParsedCell {\n    errorMessage?: string\n    cssClasses?: string[]\n    optionKeywords?: string[]\n    comment?: string\n    cellDef?: CellDef\n    placeholder?: string\n    contents?: any\n}\n\nexport interface CellPosition {\n    row: CellCoordinate\n    column: CellCoordinate\n}\n\nexport const Origin: CellPosition = {\n    row: 0,\n    column: 0,\n}\n\nexport const BooleanCellDef: CellDef = {\n    keyword: \"\",\n    terminalOptions: [\n        { keyword: GridBoolean.true, cssClass: \"\", description: \"\" },\n        { keyword: GridBoolean.false, cssClass: \"\", description: \"\" },\n    ],\n    cssClass: \"BooleanCellDef\",\n    description: \"Boolean\",\n    parse: (value: any) => {\n        // Handle already parsed boolean values (to avoid double parsing)\n        if (typeof value === \"boolean\") return value\n        return value === GridBoolean.true\n    },\n}\n\nexport const StringCellDef: CellDef = {\n    keyword: \"\",\n    cssClass: \"StringCellDef\",\n    description: \"\",\n    parse: (value: any) => `${value}`.replace(/\\\\n/g, \"\\n\"),\n}\n\nexport const StringDeclarationDef: CellDef = {\n    keyword: \"\",\n    cssClass: \"StringDeclarationDef\",\n    description: \"\",\n}\n\nexport const EnumCellDef: CellDef = {\n    keyword: \"\",\n    cssClass: \"EnumCellDef\",\n    description: \"\",\n}\n\nexport const RootKeywordCellDef: CellDef = {\n    keyword: \"\",\n    cssClass: \"KeywordCellDef\",\n    description: \"Keyword\",\n}\n\nexport const NumericCellDef: CellDef = {\n    keyword: \"\",\n    cssClass: \"NumericCellDef\",\n    description: \"\",\n    regex: /^-?\\d+\\.?\\d*$/,\n    requirementsDescription: `Must be a number`,\n    valuePlaceholder: \"98.6\",\n    parse: (value: any) => parseFloat(value),\n}\n\nexport const NumericOrAutoCellDef: CellDef = {\n    keyword: \"\",\n    cssClass: \"NumericCellDef\",\n    description: \"\",\n    regex: /^(-?\\d+\\.?\\d*|auto)$/,\n    requirementsDescription: `Must be a number or \"auto\"`,\n    valuePlaceholder: \"98.6\",\n    parse: (value: any) => {\n        if (value === \"auto\") return \"auto\"\n        return parseFloat(value)\n    },\n}\n\nexport const IntegerCellDef: CellDef = {\n    keyword: \"\",\n    cssClass: \"IntegerCellDef\",\n    description: \"\",\n    regex: /^-?[0-9]+$/,\n    requirementsDescription: `Must be an integer`,\n    valuePlaceholder: \"12345\",\n    parse: (value: any) => parseInt(value),\n}\n\nexport const PositiveIntegersCellDef: CellDef = {\n    keyword: \"\",\n    cssClass: \"IntegerCellDef\",\n    description: \"\",\n    regex: /^[0-9 ]+$/,\n    requirementsDescription: `Must be a positive integer or a list of positive integers`,\n    valuePlaceholder: \"12345 23456\",\n}\n\nexport const SubTableHeaderCellDef: CellDef = {\n    keyword: \"\",\n    cssClass: \"SubTableHeaderCellDef\",\n    description: \"\",\n}\n\nexport const SubTableValueCellDef: CellDef = {\n    keyword: \"\",\n    cssClass: \"SubTableValueCellDef\",\n    description: \"\",\n}\n\nconst MatchUrlsOnlyRegex =\n    /((([A-Za-z]{3,9}:(?:\\/\\/)?)(?:[-;:&=+$,\\w]+@)?[A-Za-z0-9.-]+|(?:www.|[-;:&=+$,\\w]+@)[A-Za-z0-9.-]+)((?:\\/[+~%/.\\w-_]*)?\\??(?:[-+=&;%@.\\w_]*)#?(?:[\\w]*))?)/\n\nexport const UrlCellDef: CellDef = {\n    keyword: \"\",\n    cssClass: \"UrlCellDef\",\n    description: \"\",\n    regex: MatchUrlsOnlyRegex,\n}\n\nexport const QueryStringCellDef: CellDef = {\n    keyword: \"\",\n    cssClass: \"QueryStringCellDef\",\n    description: \"\",\n}\n\nexport const NothingGoesThereCellDef: CellDef = {\n    keyword: \"\",\n    cssClass: \"NothingGoesThereType\",\n    description:\n        \"Nothing should be here. You can make this a comment by prepending a ##\",\n}\n\nexport const CommentCellDef: CellDef = {\n    keyword: \"\",\n    cssClass: \"CommentType\",\n    description: \"Just a comment.\",\n    regex: /^(##|\uD83D\uDCAC)/,\n}\n\nexport const WorkInProgressCellDef: CellDef = {\n    keyword: \"\",\n    cssClass: \"WorkInProgressCellDef\",\n    description: \"Not a recognized statement. Treating as a work in progress.\",\n}\n\nexport const SlugDeclarationCellDef: CellDef = {\n    keyword: \"\",\n    cssClass: \"SlugDeclarationType\",\n    description: \"A unique URL-friendly name.\",\n    regex: /^[a-zA-Z0-9-_]+$/,\n    requirementsDescription: `Can only contain the characters a-zA-Z0-9-_`,\n}\n\n// This is the name for a cell that is on the \"frontier\", where the next user input is expected to go. Okay to rename if you have a better word.\nexport const FrontierCellClass = \"ShowDropdownArrow\"\n\nexport const SlugsDeclarationCellDef: CellDef = {\n    keyword: \"\",\n    cssClass: \"SlugDeclarationType\",\n    description: \"Unique URL-friendly names.\",\n    regex: /^[a-zA-Z0-9-_ ]+$/,\n    requirementsDescription: `Can only contain the characters a-zA-Z0-9-_ `,\n}\n\nexport const EtlPathCellDef: CellDef = {\n    keyword: \"\",\n    cssClass: \"IndicatorIdOrEtlPath\",\n    description: \"Path to an ETL indicator.\",\n    regex: /^$|^[\\w\\d_/-]+#[\\w\\d_/-]+$/,\n    requirementsDescription: `Can only contain the characters a-zA-Z0-9-_/#`,\n}\n\nexport const IndicatorIdOrEtlPathCellDef: CellDef = {\n    keyword: \"\",\n    cssClass: \"IndicatorIdOrEtlPath\",\n    description: \"A single indicator ID or a path to an ETL indicator.\",\n    regex: /^\\d+|[\\w\\d_/-]+#[\\w\\d_/-]+$/,\n    requirementsDescription: `Can only contain the characters a-zA-Z0-9-_/#`,\n}\n\nexport const SlugOrIndicatorIdOrEtlPathCellDef: CellDef = {\n    keyword: \"\",\n    cssClass: \"SlugOrIndicatorIdOrEtlPath\",\n    description: \"A column slug, indicator ID, or catalog path.\",\n    regex: /^[a-zA-Z0-9-_]+$|^\\d+$|^[\\w\\d_/-]+#[\\w\\d_/-]+$/,\n    requirementsDescription: `Can be a slug (a-zA-Z0-9-_), an indicator ID (digits), or a catalog path (a-zA-Z0-9-_/#)`,\n}\n\nexport const IndicatorIdsOrEtlPathsCellDef: CellDef = {\n    keyword: \"\",\n    cssClass: \"IndicatorIdOrEtlPath\",\n    description: \"One or more indicator IDs or paths to an ETL indicator.\",\n    regex: /^((\\d+|[\\w\\d_/-]*#[\\w\\d_/-]+)( +|$))+$/,\n    requirementsDescription: `Can only contain the characters a-zA-Z0-9-_/# `,\n}\n\nexport const JSONObjectCellDef: CellDef = {\n    keyword: \"\",\n    cssClass: \"JSONObjectCellDef\",\n    description: \"JSON object\",\n    regex: /^\\{.*\\}$/, // very basic validation that expression starts with { and ends with }\n    requirementsDescription: \"Must contain a valid JSON object\",\n}\n\nexport type MatrixLine = string[]\nexport type MatrixProgram = MatrixLine[]\n"],
+  "mappings": "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",
+  "names": ["GridBoolean"]
+}

package/dist/explorer/gridLang/GridProgram.d.ts

@@ -0,0 +1,63 @@
+import { GitCommit, SerializedGridProgram } from "../../utils/index.js";
+import { CellDef, CellPosition, ParsedCell } from "./GridLangConstants.js";
+/**
+ * Block location for the below would be like (numRows = 2)
+ * table             |
+ *  slug name        | startRow = 1
+ *  pop Population   | endRow   = 2
+ */
+interface BlockLocation {
+    startRow: number;
+    endRow: number;
+    numRows: number;
+}
+export declare class GridProgram {
+    constructor(slug: string, tsv: string, lastCommit?: GitCommit, grammar?: CellDef);
+    private grammar?;
+    private static guids;
+    guid: number;
+    lastCommit?: GitCommit;
+    slug: string;
+    private nodeDelimiter;
+    cellDelimiter: string;
+    private edgeDelimiter;
+    lines: string[][];
+    toJson(): SerializedGridProgram;
+    findNext(position: CellPosition): CellPosition;
+    findAll(position: CellPosition): CellPosition[];
+    private ring;
+    valuesFrom(position?: CellPosition): string[];
+    get numRows(): number;
+    patch(obj: any): this;
+    grepFirst(key: string, position?: CellPosition): CellPosition;
+    grep(key: string, position?: CellPosition): CellPosition[];
+    /**
+     * Returns all non-blocks as an object literal
+     */
+    get tuplesObject(): {
+        [key: string]: any;
+    };
+    getLine(keyword: string): string[];
+    getLineValue(keyword: string): string;
+    protected getBlockLocation(blockRowNumber: number): BlockLocation | undefined;
+    protected getKeywordIndex(key: string): number;
+    getCell(position: CellPosition): ParsedCell;
+    getCellContents(position: CellPosition): string;
+    deleteBlock(row?: number): this;
+    deleteLine(row?: number): this;
+    appendLine(line: string): this;
+    setCell(row: number, col: number, value: string): this;
+    setLineValue(key: string, value: string | undefined): this;
+    getBlock(keywordIndex: number): string[][];
+    updateBlock(rowNumber: number, value: string[][]): this;
+    protected appendBlock(key: string, value: string[][]): void;
+    getRowNumbersStartingWith(startsWith: string): number[];
+    private static lineMatchesWords;
+    getRowMatchingWords(...words: (string | undefined)[]): number;
+    getAllRowsMatchingWords(...words: (string | undefined)[]): number[];
+    get width(): number;
+    toString(): string;
+    protected prettify(): string;
+}
+export {};
+//# sourceMappingURL=GridProgram.d.ts.map

package/dist/explorer/gridLang/GridProgram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GridProgram.d.ts","sourceRoot":"","sources":["../../../src/explorer/gridLang/GridProgram.ts"],"names":[],"mappings":"AACA,OAAO,EAEH,SAAS,EACT,qBAAqB,EACxB,MAAM,sBAAsB,CAAA;AAG7B,OAAO,EACH,OAAO,EACP,YAAY,EAKZ,UAAU,EACb,MAAM,wBAAwB,CAAA;AAG/B;;;;;GAKG;AACH,UAAU,aAAa;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;CAClB;AAED,qBAAa,WAAW;gBAEhB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,UAAU,CAAC,EAAE,SAAS,EACtB,OAAO,CAAC,EAAE,OAAO;IAQrB,OAAO,CAAC,OAAO,CAAC,CAAA;IAEhB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAI;IACxB,IAAI,SAAsB;IAE1B,UAAU,CAAC,EAAE,SAAS,CAAA;IACtB,IAAI,EAAE,MAAM,CAAA;IAEZ,OAAO,CAAC,aAAa,CAAsB;IAC3C,aAAa,SAAsB;IACnC,OAAO,CAAC,aAAa,CAAsB;IAC3C,KAAK,EAAE,MAAM,EAAE,EAAE,CAAA;IAEjB,MAAM,IAAI,qBAAqB;IAQ/B,QAAQ,CAAC,QAAQ,EAAE,YAAY;IAS/B,OAAO,CAAC,QAAQ,EAAE,YAAY;IAS9B,OAAO,CAAC,IAAI;IAmDZ,UAAU,CAAC,QAAQ,eAAS;IAM5B,IAAI,OAAO,WAEV;IAED,KAAK,CAAC,GAAG,EAAE,GAAG;IAKd,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,eAAS;IAOxC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,eAAS;IAQnC;;OAEG;IACH,IAAI,YAAY;;MASf;IAED,OAAO,CAAC,OAAO,EAAE,MAAM;IAIvB,YAAY,CAAC,OAAO,EAAE,MAAM;IAK5B,SAAS,CAAC,gBAAgB,CACtB,cAAc,EAAE,MAAM,GACvB,aAAa,GAAG,SAAS;IAU5B,SAAS,CAAC,eAAe,CAAC,GAAG,EAAE,MAAM;IAIrC,OAAO,CAAC,QAAQ,EAAE,YAAY,GAAG,UAAU;IAI3C,eAAe,CAAC,QAAQ,EAAE,YAAY;IAKtC,WAAW,CAAC,GAAG,CAAC,EAAE,MAAM;IASxB,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM;IAMvB,UAAU,CAAC,IAAI,EAAE,MAAM;IAMvB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAK/C,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS;IAQnD,QAAQ,CAAC,YAAY,EAAE,MAAM;IAQ7B,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;IAWhD,SAAS,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;IAKpD,yBAAyB,CAAC,UAAU,EAAE,MAAM;IAM5C,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAI6C;IAE5E,mBAAmB,CAAC,GAAG,KAAK,EAAE,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,GAAG,MAAM;IAM7D,uBAAuB,CAAC,GAAG,KAAK,EAAE,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,GAAG,MAAM,EAAE;IASnE,IAAI,KAAK,WAER;IAED,QAAQ;IAIR,SAAS,CAAC,QAAQ;CAKrB"}