@gridsuite/commons-ui 0.77.2 → 0.79.0

package/dist/components/muiVirtualizedTable/KeyedColumnsRowIndexer.d.ts

@@ -1,130 +0,0 @@
-import { ColumnProps } from 'react-virtualized';
-import { ReactElement } from 'react';
-
-export interface RowProps {
-    notClickable?: boolean;
-}
-export interface CustomColumnProps extends ColumnProps {
-    sortable?: boolean;
-    numeric?: boolean;
-    indexer?: KeyedColumnsRowIndexer;
-    label: string;
-    clickable?: boolean;
-    fractionDigits?: number;
-    unit?: number;
-    extra?: ReactElement;
-    nostat?: boolean;
-}
-export declare enum ChangeWays {
-    SIMPLE = "Simple",
-    TAIL = "Tail",
-    AMEND = "Amend",
-    REMOVE = "Remove"
-}
-export interface ColStat {
-    imin?: number | null;
-    imax?: number | null;
-    seen?: any;
-    kept?: any;
-}
-export declare const noOpHelper: Readonly<{
-    debugName: "noOp";
-    maintainsStats: false;
-    initStat: () => undefined;
-    updateStat: (colStat: ColStat, value: number) => void;
-    accepts: (value: any, userParams: any[] | undefined, outerParams: any[] | undefined) => true;
-}>;
-export declare const collectibleHelper: Readonly<{
-    debugName: "collectible";
-    maintainsStats: true;
-    initStat: () => {
-        seen: {};
-        kept: {};
-    };
-    updateStat: (colStat: ColStat, cellValue: number, isForKeep: boolean) => void;
-    accepts: (value: number, userParams: any[] | undefined, outerParams: any[] | undefined) => boolean;
-}>;
-export declare const getHelper: (column?: CustomColumnProps) => Readonly<{
-    debugName: "noOp";
-    maintainsStats: false;
-    initStat: () => undefined;
-    updateStat: (colStat: ColStat, value: number) => void;
-    accepts: (value: any, userParams: any[] | undefined, outerParams: any[] | undefined) => true;
-}> | Readonly<{
-    debugName: "num";
-    maintainsStats: true;
-    initStat: () => {
-        imin: null;
-        imax: null;
-    };
-    updateStat: (colStat: ColStat, value: number) => void;
-    accepts: (value: number, userParams: any[] | undefined, outerParams: any[] | undefined) => true;
-}> | Readonly<{
-    debugName: "collectible";
-    maintainsStats: true;
-    initStat: () => {
-        seen: {};
-        kept: {};
-    };
-    updateStat: (colStat: ColStat, cellValue: number, isForKeep: boolean) => void;
-    accepts: (value: number, userParams: any[] | undefined, outerParams: any[] | undefined) => boolean;
-}>;
-export interface Preferences {
-    isThreeState: boolean;
-    singleColumnByDefault: boolean;
-}
-export interface FilteredRows {
-    rowAndOrigIndex: [RowProps, number][];
-    colsStats: Record<string, ColStat>;
-    rowsCount: number;
-}
-/**
- * A rows indexer for MuiVirtualizedTable to delegate to an instance of it
- * for filtering, grouping and multi-column sorting via
- * a view index to model index array.
- */
-export declare class KeyedColumnsRowIndexer {
-    static get CHANGE_WAYS(): typeof ChangeWays;
-    versionSetter: ((version: number) => void) | null;
-    byColFilter: Record<string, {
-        userParams?: any[];
-        outerParams?: any[];
-    }> | null;
-    byRowFilter: ((row: RowProps) => boolean) | null;
-    delegatorCallback: ((instance: KeyedColumnsRowIndexer, callback: (input: any) => void) => void) | null;
-    filterVersion: number;
-    groupingCount: number;
-    indirectionStatus: string | null;
-    isThreeState: boolean;
-    lastUsedRank: number;
-    singleColumnByDefault: boolean;
-    sortingState: [string, string | undefined][] | null;
-    version: number;
-    constructor(isThreeState?: boolean, singleColumnByDefault?: boolean, delegatorCallback?: null, versionSetter?: ((version: number) => void) | null);
-    hasVersionSetter: () => boolean;
-    getVersion: () => number;
-    bumpVersion: (isFilter?: boolean) => void;
-    updatePreferences: (preferences: Preferences) => boolean;
-    preFilterRowMapping: (columns: CustomColumnProps[], rows: RowProps[], rowFilter: (row: RowProps) => boolean) => FilteredRows | null;
-    makeGroupAndSortIndirector: (preFilteredRowPairs: FilteredRows | null, columns: CustomColumnProps[]) => number[] | null;
-    getSortingAsKeyAndCodedRank: () => (string | number)[][];
-    updateSortingFromUser: (colKey: string, change_way: ChangeWays) => boolean;
-    codedRankByColumnIndex: (columns: CustomColumnProps[]) => number[] | null;
-    columnSortingSignedRank: (colKey: string) => number;
-    highestCodedColumn: (columns: CustomColumnProps[]) => number;
-    getColFilterParams: (colKey: string | null, isForUser: boolean) => any[] | undefined;
-    setColFilterParams: (colKey: string | null, params: any[] | null, isForUser: boolean) => boolean;
-    getColFilterOuterParams: (colKey: string | null) => any[] | undefined;
-    setColFilterOuterParams: (colKey: string, outerParams: any[]) => boolean;
-    getColFilterUserParams: (colKey: string | null) => any[] | undefined;
-    setColFilterUserParams: (colKey: string | null, params: any[] | null) => boolean;
-    getUserFiltering: () => Record<string, object>;
-    updateRowFiltering: (rowFilterFunc: (row: RowProps) => boolean) => void;
-}
-export declare const forTesting: {
-    codedColumnsFromKeyAndDirection: (keyAndDirections: [
-        string,
-        string | undefined
-    ][] | null, columns: CustomColumnProps[]) => number[] | null;
-    makeCompositeComparatorFromCodedColumns: (codedColumns: number[] | null, columns: CustomColumnProps[], rowExtractor: (row: [Record<string, number | string | undefined>, number][]) => Record<string, number | string | undefined>) => (row_a_i: [Record<string, number | string | undefined>, number][], row_b_i: [Record<string, number | string | undefined>, number][]) => number;
-};

package/dist/components/muiVirtualizedTable/KeyedColumnsRowIndexer.js

@@ -1,521 +0,0 @@
-import { equalsArray } from "../../utils/algos.js";
-var ChangeWays = /* @__PURE__ */ ((ChangeWays2) => {
-  ChangeWays2["SIMPLE"] = "Simple";
-  ChangeWays2["TAIL"] = "Tail";
-  ChangeWays2["AMEND"] = "Amend";
-  ChangeWays2["REMOVE"] = "Remove";
-  return ChangeWays2;
-})(ChangeWays || {});
-const noOpHelper = Object.freeze({
-  debugName: "noOp",
-  maintainsStats: false,
-  initStat: () => void 0,
-  updateStat: (colStat, value) => {
-  },
-  accepts: (value, userParams, outerParams) => {
-    return true;
-  }
-});
-const numericHelper = Object.freeze({
-  debugName: "num",
-  maintainsStats: true,
-  initStat: () => {
-    return { imin: null, imax: null };
-  },
-  updateStat: (colStat, value) => {
-    if (colStat.imin === void 0 || colStat.imin === null || colStat.imin > value) {
-      colStat.imin = value;
-    }
-    if (colStat.imax === void 0 || colStat.imax === null || colStat.imax < value) {
-      colStat.imax = value;
-    }
-  },
-  accepts: (value, userParams, outerParams) => {
-    return true;
-  }
-});
-const collectibleHelper = Object.freeze({
-  debugName: "collectible",
-  maintainsStats: true,
-  initStat: () => {
-    return { seen: {}, kept: {} };
-  },
-  updateStat: (colStat, cellValue, isForKeep) => {
-    const m = isForKeep ? colStat.kept : colStat.seen;
-    if (!m[cellValue]) {
-      m[cellValue] = 1;
-    } else {
-      m[cellValue] += 1;
-    }
-  },
-  accepts: (value, userParams, outerParams) => {
-    return !userParams || userParams.some((v) => v === value);
-  }
-});
-const getHelper = (column) => {
-  if (column == null ? void 0 : column.numeric) {
-    return numericHelper;
-  }
-  if (!(column == null ? void 0 : column.nostat)) {
-    return collectibleHelper;
-  }
-  return noOpHelper;
-};
-const giveDirSignFor = (fuzzySign) => {
-  if (fuzzySign < 0) {
-    return -1;
-  }
-  if (fuzzySign > 0) {
-    return 1;
-  }
-  if (fuzzySign === "asc") {
-    return 1;
-  }
-  if (fuzzySign === "desc") {
-    return -1;
-  }
-  return 0;
-};
-const codedColumnsFromKeyAndDirection = (keyAndDirections, columns) => {
-  if (!keyAndDirections) {
-    return null;
-  }
-  let ret = [];
-  const columIndexByKey = {};
-  for (let colIdx = 0; colIdx < columns.length; colIdx++) {
-    const col = columns[colIdx];
-    const colKey = col.dataKey;
-    columIndexByKey[colKey] = colIdx;
-  }
-  ret = keyAndDirections.map((knd) => {
-    const colKey = knd[0];
-    const dir = knd[1];
-    const colIdx = columIndexByKey[colKey];
-    if (colIdx === void 0) {
-      return 0;
-    }
-    const sign = giveDirSignFor(dir);
-    return (colIdx + 1) * sign;
-  });
-  return ret;
-};
-const compareValue = (a, b, isNumeric, undefSign = -1) => {
-  if (a === void 0 && b === void 0) {
-    return 0;
-  }
-  if (a === void 0) {
-    return undefSign;
-  }
-  if (b === void 0) {
-    return -undefSign;
-  }
-  if (!isNumeric) {
-    return `${a}`.localeCompare(b);
-  }
-  if (Number.isNaN(a)) {
-    return Number.isNaN(b) ? 0 : 1;
-  }
-  if (Number.isNaN(b)) {
-    return -1;
-  }
-  return Math.sign(Number(a) - Number(b));
-};
-const makeCompositeComparatorFromCodedColumns = (codedColumns, columns, rowExtractor) => {
-  return (row_a_i, row_b_i) => {
-    const rowA = rowExtractor(row_a_i);
-    const rowB = rowExtractor(row_b_i);
-    codedColumns.map((cc) => {
-      const i = Math.abs(cc) - 1;
-      const mul = Math.sign(cc);
-      const col = columns[i];
-      const key = col.dataKey;
-      const sgn = compareValue(rowA[key], rowB[key], col.numeric);
-      if (sgn) {
-        return mul * sgn;
-      }
-      return void 0;
-    });
-    return 0;
-  };
-};
-const canonicalForSign = (dirSign) => {
-  if (dirSign > 0) {
-    return "asc";
-  }
-  if (dirSign < 0) {
-    return "desc";
-  }
-  return void 0;
-};
-const groupRows = (groupingColumnsCount, columns, indexedArray) => {
-  const groupingComparator = makeCompositeComparatorFromCodedColumns(
-    Array(groupingColumnsCount).map((x, i) => i + 1),
-    columns,
-    // @ts-ignore does not match other pattern
-    (ar) => ar[0]
-  );
-  indexedArray.sort(groupingComparator);
-  const groups = [];
-  let prevSlice = null;
-  let inBuildGroup = [];
-  groups.push(inBuildGroup);
-  indexedArray.forEach((p) => {
-    const nextSlice = p[0].slice(0, groupingColumnsCount);
-    if (prevSlice === null || !equalsArray(prevSlice, nextSlice)) {
-      inBuildGroup = [];
-      groups.push(inBuildGroup);
-    }
-    inBuildGroup.push(p);
-    prevSlice = nextSlice;
-  });
-  return groups;
-};
-const groupAndSort = (preFilteredRowPairs, codedColumns, groupingColumnsCount, columns) => {
-  const nothingToDo = !codedColumns && !groupingColumnsCount;
-  let indexedArray = preFilteredRowPairs.rowAndOrigIndex;
-  const noOutFiltered = preFilteredRowPairs.rowsCount === indexedArray.length;
-  if (nothingToDo && noOutFiltered) {
-    return null;
-  }
-  if (!nothingToDo) {
-    indexedArray = [...indexedArray];
-  }
-  if (nothingToDo)
-    ;
-  else if (!groupingColumnsCount) {
-    const sortingComparator = makeCompositeComparatorFromCodedColumns(
-      codedColumns,
-      columns,
-      // @ts-ignore I don't know how to fix this one
-      (ar) => ar[0]
-    );
-    indexedArray.sort(sortingComparator);
-  } else {
-    const groups = groupRows(groupingColumnsCount, columns, indexedArray);
-    const interGroupSortingComparator = makeCompositeComparatorFromCodedColumns(
-      codedColumns,
-      columns,
-      (ar) => ar[0][0]
-    );
-    groups.sort(interGroupSortingComparator);
-    const intraGroupSortingComparator = makeCompositeComparatorFromCodedColumns(
-      codedColumns,
-      columns,
-      // @ts-ignore I don't know how to fix this one
-      (ar) => ar[0]
-    );
-    indexedArray = [];
-    groups.forEach((group) => {
-      group.sort(intraGroupSortingComparator);
-      indexedArray.push(...group);
-    });
-  }
-  return indexedArray;
-};
-class KeyedColumnsRowIndexer {
-  constructor(isThreeState = true, singleColumnByDefault = false, delegatorCallback = null, versionSetter = null) {
-    this.hasVersionSetter = () => {
-      return !!this.versionSetter;
-    };
-    this.getVersion = () => {
-      return this.version;
-    };
-    this.bumpVersion = (isFilter = false) => {
-      this.version += 1;
-      if (isFilter) {
-        this.filterVersion = this.version;
-      }
-      if (this.delegatorCallback) {
-        this.indirectionStatus = "to sort";
-        this.delegatorCallback(this, (updated_ok) => {
-          this.indirectionStatus = updated_ok ? "done" : "no_luck";
-        });
-      }
-      if (this.versionSetter) {
-        this.versionSetter(this.version);
-      }
-    };
-    this.updatePreferences = (preferences) => {
-      if (preferences.isThreeState === this.isThreeState && preferences.singleColumnByDefault === this.singleColumnByDefault) {
-        return false;
-      }
-      if (preferences.isThreeState !== this.isThreeState) {
-        this.isThreeState = preferences.isThreeState;
-      }
-      if (preferences.singleColumnByDefault !== this.singleColumnByDefault) {
-        this.singleColumnByDefault = preferences.singleColumnByDefault;
-      }
-      this.bumpVersion();
-      return true;
-    };
-    this.preFilterRowMapping = (columns, rows, rowFilter) => {
-      var _a;
-      if (!(rows == null ? void 0 : rows.length) || !(columns == null ? void 0 : columns.length)) {
-        return null;
-      }
-      const ri = [];
-      const cs = {};
-      columns.forEach((col) => {
-        const helper = getHelper(col);
-        const colStat = helper.initStat();
-        if (colStat) {
-          cs[col.dataKey] = colStat;
-        }
-      });
-      for (let rowIdx = 0; rowIdx < rows.length; rowIdx++) {
-        const row = rows[rowIdx];
-        let acceptsRow = true;
-        const acceptedOnRow = {};
-        for (let colIdx = 0; colIdx < columns.length; colIdx++) {
-          const col = columns[colIdx];
-          const helper = getHelper(col);
-          const colKey = col.dataKey;
-          const cellValue = row[colKey];
-          helper.updateStat(cs[colKey], cellValue, false);
-          const colFilterParams = (_a = this.byColFilter) == null ? void 0 : _a[colKey];
-          let acceptsCell = true;
-          if (colFilterParams) {
-            const up = colFilterParams.userParams;
-            const op = colFilterParams.outerParams;
-            if (!helper.accepts(cellValue, up, op)) {
-              acceptsCell = false;
-            }
-          }
-          if (helper.maintainsStats && acceptsCell) {
-            acceptedOnRow[colIdx] = cellValue;
-          }
-          acceptsRow && (acceptsRow = acceptsCell);
-        }
-        if (acceptsRow && rowFilter) {
-          acceptsRow = rowFilter(row);
-        }
-        if (acceptsRow && this.byRowFilter) {
-          acceptsRow = this.byRowFilter(row);
-        }
-        if (acceptsRow) {
-          Object.entries(acceptedOnRow).forEach(([idx, value]) => {
-            const col = columns[Number(idx)];
-            const helper = getHelper(col);
-            helper.updateStat(cs[col.dataKey], value, true);
-          });
-          ri.push([row, rowIdx]);
-        }
-      }
-      return { rowAndOrigIndex: ri, colsStats: cs, rowsCount: rows.length };
-    };
-    this.makeGroupAndSortIndirector = (preFilteredRowPairs, columns) => {
-      if (!preFilteredRowPairs) {
-        return null;
-      }
-      const codedColumns = !this.sortingState ? null : codedColumnsFromKeyAndDirection(this.sortingState, columns);
-      const groupingColumnsCount = this.groupingCount;
-      const indexedArray = groupAndSort(preFilteredRowPairs, codedColumns, groupingColumnsCount, columns);
-      return !indexedArray ? null : indexedArray.map((k) => k[1]);
-    };
-    this.getSortingAsKeyAndCodedRank = () => {
-      if (!this.sortingState) {
-        return [];
-      }
-      return this.sortingState.map((kd, i) => {
-        const sign = giveDirSignFor(kd[1]);
-        const codedRank = sign * (i + 1);
-        return [kd[0], codedRank];
-      });
-    };
-    this.updateSortingFromUser = (colKey, change_way) => {
-      var _a, _b, _c, _d, _e, _f, _g, _h;
-      const keyAndDirections = this.sortingState;
-      if (change_way === "Remove") {
-        if (!keyAndDirections) {
-          return false;
-        }
-        const would = keyAndDirections.filter((p) => p[0] !== colKey);
-        if (would.length === keyAndDirections.length) {
-          return false;
-        }
-        this.sortingState = would.length ? would : null;
-      } else if (!keyAndDirections) {
-        this.sortingState = [[colKey, canonicalForSign(1)]];
-        this.lastUsedRank = 1;
-      } else {
-        const wasAtIdx = keyAndDirections.findIndex((p) => p[0] === colKey);
-        const wasFuzzyDir = wasAtIdx < 0 ? 0 : keyAndDirections[wasAtIdx][1];
-        const wasSignDir = giveDirSignFor(wasFuzzyDir);
-        if (change_way === "Simple") {
-          if (wasSignDir < 0 && this.isThreeState) {
-            if (((_a = this.sortingState) == null ? void 0 : _a.length) === 1) {
-              this.sortingState = null;
-            } else {
-              (_b = this.sortingState) == null ? void 0 : _b.splice(wasAtIdx, 1);
-            }
-          } else {
-            if (this.singleColumnByDefault || wasAtIdx < 0) {
-              this.sortingState = [];
-            } else {
-              (_c = this.sortingState) == null ? void 0 : _c.splice(wasAtIdx, 1);
-            }
-            const nextSign = wasSignDir ? -wasSignDir : 1;
-            const nextKD = [colKey, canonicalForSign(nextSign)];
-            (_d = this.sortingState) == null ? void 0 : _d.unshift(nextKD);
-          }
-        } else if (change_way === "Tail") {
-          if (wasAtIdx < 0) {
-            (_e = this.sortingState) == null ? void 0 : _e.push([colKey, canonicalForSign(1)]);
-          } else if (wasAtIdx !== keyAndDirections.length - 1) {
-            return false;
-          } else if (!(this.isThreeState && wasSignDir === -1)) {
-            this.sortingState[wasAtIdx][1] = canonicalForSign(-wasSignDir);
-          } else {
-            (_f = this.sortingState) == null ? void 0 : _f.splice(wasAtIdx, 1);
-          }
-        } else if (wasAtIdx < 0) {
-          if (this.lastUsedRank - 1 > // @ts-ignore could be undefined, how to handle this case ?
-          this.sortingState.length) {
-            return false;
-          }
-          (_g = this.sortingState) == null ? void 0 : _g.splice(this.lastUsedRank - 1, 0, [colKey, canonicalForSign(1)]);
-        } else if (!(this.isThreeState && wasSignDir === -1)) {
-          this.sortingState[wasAtIdx][1] = canonicalForSign(-wasSignDir);
-        } else {
-          this.lastUsedRank = wasAtIdx + 1;
-          (_h = this.sortingState) == null ? void 0 : _h.splice(wasAtIdx, 1);
-        }
-      }
-      this.bumpVersion();
-      return true;
-    };
-    this.codedRankByColumnIndex = (columns) => {
-      return codedColumnsFromKeyAndDirection(this.sortingState, columns);
-    };
-    this.columnSortingSignedRank = (colKey) => {
-      var _a;
-      if (!((_a = this == null ? void 0 : this.sortingState) == null ? void 0 : _a.length)) {
-        return 0;
-      }
-      const idx = this.sortingState.findIndex((kd) => kd[0] === colKey);
-      if (idx < 0) {
-        return 0;
-      }
-      const colSorting = this.sortingState[idx];
-      return giveDirSignFor(colSorting[1]) * (idx + 1);
-    };
-    this.highestCodedColumn = (columns) => {
-      var _a;
-      if (!((_a = this == null ? void 0 : this.sortingState) == null ? void 0 : _a.length)) {
-        return 0;
-      }
-      const colSorting = this.sortingState[0];
-      const colKey = colSorting[0];
-      const idx = columns.findIndex((col) => col.dataKey === colKey);
-      if (idx < 0) {
-        return 0;
-      }
-      return giveDirSignFor(colSorting[1]) * (idx + 1);
-    };
-    this.getColFilterParams = (colKey, isForUser) => {
-      if (!colKey || !this.byColFilter) {
-        return void 0;
-      }
-      const colFilter = this.byColFilter[colKey];
-      if (!colFilter) {
-        return void 0;
-      }
-      return colFilter[isForUser ? "userParams" : "outerParams"];
-    };
-    this.setColFilterParams = (colKey, params, isForUser) => {
-      var _a;
-      if (!colKey) {
-        if (params) {
-          throw new Error("column key has to be defined");
-        }
-        return false;
-      }
-      const fieldName = isForUser ? "userParams" : "outerParams";
-      if (params) {
-        if (!this.byColFilter) {
-          this.byColFilter = {};
-        }
-        let colFilter = this.byColFilter[colKey];
-        if (!colFilter) {
-          colFilter = {};
-          this.byColFilter[colKey] = colFilter;
-        } else if (colFilter[fieldName] === params) {
-          return false;
-        }
-        colFilter[fieldName] = params;
-      } else {
-        if (!this.byColFilter) {
-          return false;
-        }
-        const otherFieldName = !isForUser ? "userParams" : "outerParams";
-        if ((_a = this.byColFilter[colKey]) == null ? void 0 : _a[otherFieldName]) {
-          delete this.byColFilter[colKey][fieldName];
-        } else {
-          delete this.byColFilter[colKey];
-        }
-      }
-      if (isForUser) {
-        this.bumpVersion(true);
-      }
-      return true;
-    };
-    this.getColFilterOuterParams = (colKey) => {
-      return this.getColFilterParams(colKey, false);
-    };
-    this.setColFilterOuterParams = (colKey, outerParams) => {
-      return this.setColFilterParams(colKey, outerParams, false);
-    };
-    this.getColFilterUserParams = (colKey) => {
-      return this.getColFilterParams(colKey, true);
-    };
-    this.setColFilterUserParams = (colKey, params) => {
-      return this.setColFilterParams(colKey, params, true);
-    };
-    this.getUserFiltering = () => {
-      const ret = {};
-      if (this.byColFilter) {
-        Object.entries(this.byColFilter).forEach(([k, v]) => {
-          if (!v.userParams) {
-            return;
-          }
-          ret[k] = [...v.userParams];
-        });
-      }
-      return ret;
-    };
-    this.updateRowFiltering = (rowFilterFunc) => {
-      if (typeof rowFilterFunc !== "function") {
-        throw new Error("row filter should be a function");
-      }
-      this.byRowFilter = rowFilterFunc;
-      this.bumpVersion();
-    };
-    this.versionSetter = versionSetter;
-    this.version = 0;
-    this.filterVersion = 0;
-    this.delegatorCallback = delegatorCallback;
-    this.indirectionStatus = null;
-    this.isThreeState = isThreeState;
-    this.singleColumnByDefault = singleColumnByDefault;
-    this.lastUsedRank = 1;
-    this.sortingState = null;
-    this.groupingCount = 0;
-    this.byColFilter = null;
-    this.byRowFilter = null;
-  }
-  static get CHANGE_WAYS() {
-    return ChangeWays;
-  }
-}
-const forTesting = {
-  codedColumnsFromKeyAndDirection,
-  makeCompositeComparatorFromCodedColumns
-};
-export {
-  ChangeWays,
-  KeyedColumnsRowIndexer,
-  collectibleHelper,
-  forTesting,
-  getHelper,
-  noOpHelper
-};