@sjcrh/proteinpaint-client 2.226.0 → 2.227.0

package/dist/chunk-JKPMBNRM.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../termdb/handlers/junction.ts"],
+  "sourcesContent": ["import { junctionCustomTermSource, type JunctionCustomTerm } from './junction.customTerm.ts'\nimport { mayRenderFractionSelection } from './termCollectionFractionSelection.ts'\nimport { mayRenderSampleTypeRow, getTermSampleTypes } from '#dom'\nimport { getTermLabelSuffix } from '#shared/terms.js'\n\nexport class SearchHandler {\n\tasync init(opts) {\n\t\tif (!opts?.holder) throw new Error('opts.holder is required')\n\t\tif (typeof opts.callback != 'function') throw new Error('opts.callback is required')\n\n\t\tconst entries = getJunctionCustomTerms(opts.app.vocabApi.state?.customTerms)\n\t\trender(opts, entries)\n\t}\n}\n\nexport function getJunctionCustomTerms(customTerms: any): JunctionCustomTerm[] {\n\tif (!Array.isArray(customTerms)) return []\n\treturn customTerms.filter(term => term?.source === junctionCustomTermSource && term.tw?.term)\n}\n\nfunction render(opts, entries: JunctionCustomTerm[]) {\n\tconst holder = opts.holder\n\tholder.selectAll('*').remove()\n\tconst div = holder.append('div').style('padding', '10px 0px')\n\n\tif (!entries.length) {\n\t\tdiv.append('div').text('Junctions selected from genome browser will be shown here.')\n\t\treturn\n\t}\n\n\t/* the sample types to read the picked junction for, as for gene expression and methylation terms.\n\tDrawn once: a delete redraws only the list below, so the choice stays */\n\tconst termdbConfig = opts.app.vocabApi.termdbConfig\n\tconst query = termdbConfig?.queries?.junction\n\tconst sampleTypeSelect = mayRenderSampleTypeRow(div.append('div'), query, termdbConfig)\n\t/* a junction or event term, or the term wrapper of an event's fraction from the fraction chooser, with\n\tthe chosen sample types, see withSampleTypes() */\n\tconst pick = (termOrTw: any) => {\n\t\tconst termSampleTypes = getTermSampleTypes(sampleTypeSelect, query, termdbConfig)\n\t\t// nothing selectable, which getTermSampleTypes() has alerted\n\t\tif (!termSampleTypes) return\n\t\t/* every sample type of the junction file, or its only one, is the same as no choice: the term then\n\t\treads every sample, as before there was a selector, including any sample without a sample type */\n\t\tconst all =\n\t\t\t!termSampleTypes.sampleTypes?.length || query.sampleTypes.every(t => termSampleTypes.sampleTypes!.includes(t))\n\t\tconst apply = (term: any) => (all ? term : withSampleTypes(term, termSampleTypes))\n\t\treturn opts.callback(termOrTw.term ? { ...termOrTw, term: apply(termOrTw.term) } : apply(termOrTw))\n\t}\n\n\tconst listHolder = div.append('div')\n\tconst renderList = () => {\n\t\tconst entries = getJunctionCustomTerms(opts.app.vocabApi.state?.customTerms)\n\t\t// the last one is deleted\n\t\tif (!entries.length) return render(opts, entries)\n\t\tlistHolder.selectAll('*').remove()\n\t\tconst itemOpts = { ...opts, callback: pick, renderList }\n\n\t\t// the fraction chooser is rendered in a sibling div, so that the list may be\n\t\t// restored without reloading, when the user backs out of the chooser\n\t\tconst listDiv = listHolder.append('div')\n\t\tconst fractionDiv = listHolder.append('div')\n\n\t\tfor (const entry of entries) {\n\t\t\tif (entry.eventlabel) renderJunctionEvent(listDiv, fractionDiv, entry, itemOpts)\n\t\t\telse renderJunction(listDiv, entry, itemOpts)\n\t\t}\n\n\t\tlistDiv\n\t\t\t.append('div')\n\t\t\t.style('font-size', '.7em')\n\t\t\t.style('margin-top', '10px')\n\t\t\t.style('opacity', 0.7)\n\t\t\t.text('Select additional junctions from genome browser.')\n\t}\n\trenderList()\n}\n\nfunction renderJunction(holder, entry: JunctionCustomTerm, opts) {\n\tconst choice = holder.append('div')\n\tchoice\n\t\t.append('div')\n\t\t.attr('class', 'ts_pill sja_filter_tag_btn sja_tree_click_term')\n\t\t.style('display', 'inline-block')\n\t\t.style('border-radius', '6px')\n\t\t.style('margin', '1px 0')\n\t\t.text(entry.tw.term.name)\n\t\t.on('click', () => opts.callback(entry.tw.term))\n\taddDeleteButton(choice, entry, opts)\n}\n\nfunction renderJunctionEvent(holder, fractionDiv, entry: JunctionCustomTerm, opts) {\n\tconst eventHolder = holder.append('div')\n\tconst pillRow = eventHolder.append('div')\n\tpillRow\n\t\t.append('div')\n\t\t.attr('class', 'ts_pill sja_filter_tag_btn sja_tree_click_term')\n\t\t.style('display', 'inline-block')\n\t\t.style('border-radius', '6px')\n\t\t.style('margin', '1px 0')\n\t\t.text(entry.eventlabel!)\n\t\t.on('click', () => selectJunctionEvent(holder, fractionDiv, entry, opts))\n\taddDeleteButton(pillRow, entry, opts)\n\teventHolder\n\t\t.append('div')\n\t\t.style('margin-left', '10px')\n\t\t.style('font-size', '.7em')\n\t\t.selectAll('div')\n\t\t.data(entry.tw.term.termlst, term => term.id)\n\t\t.enter()\n\t\t.append('div')\n\t\t.text(term => term.name)\n}\n\nfunction selectJunctionEvent(listDiv, fractionDiv, entry: JunctionCustomTerm, opts) {\n\tconst isStaged = mayRenderFractionSelection({\n\t\tterm: entry.tw.term,\n\t\tselectionMode: opts.termCollectionSelectionMode,\n\t\tlistDiv,\n\t\tfractionDiv,\n\t\tcallback: tw => opts.callback(tw)\n\t})\n\tif (!isStaged) opts.callback(entry.tw.term)\n}\n\nfunction addDeleteButton(holder, entry: JunctionCustomTerm, opts) {\n\tholder\n\t\t.append('button')\n\t\t.attr('data-testid', 'sjpp-junction-delete')\n\t\t.style('margin-left', '4px')\n\t\t.attr('aria-label', `Delete ${entry.name}`)\n\t\t.text('\u00D7')\n\t\t.on('click', async () => {\n\t\t\tawait opts.app.vocabApi.deleteCustomTermById(entry.id)\n\t\t\topts.renderList()\n\t\t})\n}\n\n/** A copy of a picked junction term, or of a splice event's termCollection, read for the chosen sample\n * types. A collection's member junctions get them too, since the server reads each member as a junction\n * term of its own. The caller leaves a term unchanged for no choice or a choice of every sample type. Like a methylation region term, the name says which\n * sample types, so that the same junction read for two of them is told apart where a plot labels terms\n * by name. */\nfunction withSampleTypes(term: any, termSampleTypes: { sampleTypes?: number[]; sampleTypeLabel?: string }) {\n\tconst { sampleTypes, sampleTypeLabel } = termSampleTypes\n\tconst t = { ...term, sampleTypes, sampleTypeLabel }\n\tt.name = term.name + getTermLabelSuffix(t)\n\tif (Array.isArray(term.termlst)) t.termlst = term.termlst.map(m => ({ ...m, sampleTypes }))\n\treturn t\n}\n"],
+  "mappings": "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",
+  "names": ["entries"]
+}

package/dist/chunk-JSQH233D.js

@@ -0,0 +1,263 @@
+import {
+  hierCluster_interactivity_exports
+} from "./chunk-BILGOVOR.js";
+import {
+  Matrix
+} from "./chunk-BKJLRLQQ.js";
+import {
+  hierCluster_renderers_exports
+} from "./chunk-PQDYA3ZQ.js";
+import {
+  filterJoin,
+  getNormalRoot
+} from "./chunk-YBXQBSFY.js";
+import {
+  clusterMethodLst,
+  distanceMethodLst,
+  dofetch3
+} from "./chunk-VVWZ4BOI.js";
+import {
+  TermTypes2Dt,
+  dictionaryNumericTypes
+} from "./chunk-CFYWQJ7F.js";
+import {
+  colorScaleMap
+} from "./chunk-2N345NXD.js";
+import {
+  deepEqual,
+  getCompInit
+} from "./chunk-HBNB5TRH.js";
+import {
+  extent,
+  linear
+} from "./chunk-4OLM3KSB.js";
+
+// plots/matrix/hierCluster.js
+var HierCluster = class _HierCluster extends Matrix {
+  static type = "hierCluster";
+  constructor(opts) {
+    super(opts);
+    this.type = _HierCluster.type;
+    this.chartType = _HierCluster.type;
+  }
+  async init(appState) {
+    await super.init(appState);
+    this.maySetSandboxHeader(appState);
+    this.hcClipId = this.seriesClipId + "-hc";
+    this.dom.hcClipRect = this.dom.svg.select("defs").append("clipPath").attr("id", this.hcClipId).attr("clipPathUnits", "userSpaceOnUse").append("rect").attr("display", "block");
+    this.dom.topDendrogram = this.dom.svg.insert("g", "g").attr("clip-path", `url(#${this.hcClipId})`).append("g").attr("class", "sjpp-matrix-dendrogram").attr("data-testid", "hierCluster_top_dendrogram").on("click", (event) => {
+      const clickedClusterId = this.getClusterFromTopDendrogram(event);
+      if (clickedClusterId) {
+        this.clickedClusterIds = this.getAllChildrenClusterIds(clickedClusterId);
+        this.clickedClusterIds.push(clickedClusterId);
+        const clickedCluster = this.hierClusterData.clustering.col.mergedClusters.get(clickedClusterId);
+        const clickedClusterSampleNames = clickedCluster.children.map((c) => c.name);
+        this.addSelectedSamplesOptions(clickedClusterSampleNames, event);
+      } else {
+        delete this.clickedClusterIds;
+      }
+      if (this.clickedLeftClusterIds) {
+        delete this.clickedLeftClusterIds;
+        this.plotDendrogramHclust();
+      } else this.plotDendrogramHclust("top");
+    });
+    this.dom.leftDendrogram = this.dom.svg.insert("g", "g").attr("class", "sjpp-matrix-dendrogram").attr("data-testid", "hierCluster_left_dendrogram").on("click", (event) => {
+      const clickedLeftClusterId = this.getClusterFromLeftDendrogram(event);
+      if (clickedLeftClusterId) {
+        this.clickedLeftClusterIds = this.getAllChildrenClusterIds(clickedLeftClusterId, true);
+        this.clickedLeftClusterIds.push(clickedLeftClusterId);
+        const clickedLeftCluster = this.hierClusterData.clustering.row.mergedClusters.get(clickedLeftClusterId);
+        const clickedLeftClusterRowsNames = clickedLeftCluster.children.map((c) => c.name);
+        this.addSelectedRowsOptions(clickedLeftClusterRowsNames, event);
+      } else {
+        delete this.clickedLeftClusterIds;
+      }
+      if (this.clickedClusterIds) {
+        delete this.clickedClusterIds;
+        this.plotDendrogramHclust();
+      } else this.plotDendrogramHclust("left");
+    });
+  }
+  async setHierClusterData(_data = {}) {
+    this.prevServerData = this.currServerData;
+    const [d, twlst] = await this.requestData({});
+    if (d.error) throw d.error;
+    this.currServerData = structuredClone(d);
+    if (!deepEqual(this.prevServerData, this.currServerData)) {
+      delete this.clickedClusterIds;
+      delete this.clickedLeftClusterIds;
+    }
+    const s = this.settings.hierCluster;
+    if (!d.clustering) {
+      if (d.gene) {
+        throw `Cannot do clustering: data is only available for 1 gene (${d.gene}). Try again by adding more genes.`;
+      }
+    }
+    this.hierClusterData = d;
+    const c = this.hierClusterData.clustering;
+    this.setHierColorScale(c);
+    const samples = {};
+    for (const [i, column] of c.col.order.entries()) {
+      samples[column.name] = { sample: column.name };
+      for (const [j, row] of c.row.order.entries()) {
+        const tw = twlst.find((tw2) => tw2.$id === row.name || tw2.id === row.name);
+        const value = c.matrix[j][i];
+        samples[column.name][tw.$id] = {
+          key: tw.term.name,
+          values: [
+            {
+              sample: column.name,
+              dt: TermTypes2Dt[this.state.config.dataType],
+              label: s.termGroupName,
+              // gene: tw.term.name,
+              // chr: tw.term.chr,
+              // pos: `${tw.term.start}-${tw.term.stop}`,
+              value
+              // the color will be computed in matrix.cells, so that
+              // it can get updated even when there are no nonsetting state diff
+            }
+          ]
+        };
+      }
+    }
+    this.hcTermNameOrder = this.settings.hierCluster.sortClusterRows == "asListed" ? twlst.map((t) => t.term.name) : this.settings.hierCluster.sortClusterRows == "byName" ? twlst.map((t) => t.term.name).sort() : dictionaryNumericTypes.has(this.config.dataType) ? c.row.order.map((row) => twlst.find((t) => t.$id == row.name || t.term.id == row.name)?.term.name) : c.row.order.map((row) => twlst.find((t) => t.$id == row.name)?.term.name);
+    if (this.hcTermNameOrder.includes(void 0)) throw `unable to map row.name to term.name`;
+    this.hcTermSorter = (a, b) => {
+      const i = this.hcTermNameOrder.indexOf(a.tw.term.name);
+      const j = this.hcTermNameOrder.indexOf(b.tw.term.name);
+      if (i == -1 && j == -1) return 0;
+      if (i == -1) return 1;
+      if (j == -1) return -1;
+      return i - j;
+    };
+    this.hcSampleNameOrder = c.col.order.map((col) => col.name);
+    this.hcSampleSorter = (a, b) => {
+      const i = this.hcSampleNameOrder.indexOf(a.sample);
+      const j = this.hcSampleNameOrder.indexOf(b.sample);
+      if (i == -1 && j == -1) return 0;
+      if (i == -1) return 1;
+      if (j == -1) return -1;
+      return i - j;
+    };
+    const byTermId = {};
+    for (const tw of twlst) {
+      if (d.byTermId?.[tw.term.name]) byTermId[tw.$id] = d.byTermId[tw.term.name];
+    }
+    this.hierClusterSamples = {
+      refs: { byTermId, bySampleId: d.bySampleId },
+      lst: c.col.order.map((c2) => samples[c2.name]),
+      samples,
+      removedHierClusterTerms: d.removedHierClusterTerms
+    };
+  }
+  async requestData() {
+    const body = this.currRequestOpts?.hierCluster || this.getHCRequestBody(this.state);
+    const twlst = this.hcTermGroup.lst;
+    const data = await dofetch3("termdb/cluster", { body, signal: this.api.getAbortSignal?.() });
+    return [data, twlst];
+  }
+  getHCRequestBody(state) {
+    this.hcTermGroup = this.config.termgroups.find((grp) => grp.type == "hierCluster") || this.termOrder?.find((t) => t.grp.type == "hierCluster")?.grp;
+    const s = state.config.settings.hierCluster;
+    const dictionaryLegendFilter = {
+      type: "tvslst",
+      in: true,
+      join: "and",
+      lst: state.config.legendValueFilter.lst.filter((f) => !f.tvs.legendFilterType)
+    };
+    const terms = this.getClusterRowTermsAsParameter();
+    if (!terms.length) throw "no data";
+    if (!clusterMethodLst.find((i) => i.value == s.clusterMethod)) throw "Invalid cluster method";
+    if (!distanceMethodLst.find((i) => i.value == s.distanceMethod)) throw "Invalid distance method";
+    const body = {
+      genome: state.vocab.genome,
+      dslabel: state.vocab.dslabel,
+      dataType: state.config.dataType,
+      clusterMethod: s.clusterMethod,
+      distanceMethod: s.distanceMethod,
+      zScoreTransformation: s.zScoreTransformation,
+      terms,
+      filter: getNormalRoot(filterJoin([state.filter, dictionaryLegendFilter])),
+      filter0: state.filter0
+    };
+    if (state.config.dataType == "proteomeAbundance") {
+      body.proteomeDetails = {
+        organism: state.config.proteomeDetails?.organism,
+        assay: state.config.proteomeDetails?.assay,
+        cohort: state.config.proteomeDetails?.cohort
+      };
+    }
+    return body;
+  }
+  combineData() {
+    if (!this.hierClusterSamples) return;
+    const d = this.data;
+    const removedHierClusterTerms = this.hierClusterSamples.removedHierClusterTerms;
+    const samples = {};
+    const lst = [];
+    for (const sampleId in this.hierClusterSamples.samples) {
+      const s = this.hierClusterSamples.samples[sampleId];
+      samples[sampleId] = s;
+      lst.push(s);
+      if (sampleId in d.samples) Object.assign(s, d.samples[sampleId]);
+      const _ref_ = this.hierClusterSamples.refs.bySampleId[sampleId] || {};
+      if (!s._ref_) s._ref_ = _ref_;
+      else Object.assign(s._ref_, _ref_);
+    }
+    const t = this.hierClusterSamples.refs.byTermId;
+    for (const $id of Object.keys(t)) {
+      d.refs.byTermId[$id] = Object.assign({}, d.refs.byTermId[$id] || {}, t[$id]);
+    }
+    this.data = { samples, lst, refs: d.refs, removedHierClusterTerms };
+  }
+  setHierColorScale(c) {
+    const hc = this.settings.hierCluster;
+    const scale = linear(colorScaleMap[hc.colorScale].domain, colorScaleMap[hc.colorScale].range).clamp(true);
+    const globalMinMaxes = [];
+    for (const row of c.matrix) {
+      globalMinMaxes.push(...extent(row));
+    }
+    const absMax = Math.min(hc.zScoreCap, Math.max(...extent(globalMinMaxes).map(Math.abs)));
+    const [min, max] = hc.zScoreTransformation ? [-absMax, absMax] : [Math.min(...globalMinMaxes), Math.max(...globalMinMaxes)];
+    this.hierClusterValues = { scale, min, max };
+  }
+  getValueColor(value) {
+    const hc = this.settings.hierCluster;
+    if (hc.zScoreTransformation) {
+      const zScoreCap = this.settings.hierCluster.zScoreCap;
+      return this.hierClusterValues.scale((value - -zScoreCap) / (zScoreCap * 2));
+    } else {
+      return this.hierClusterValues.scale(value / this.hierClusterValues.max);
+    }
+  }
+  /* returns list of gene terms as request parameter, e.g. {gene,chr,start,stop}
+  	request parameter only need term but not tw, as it will simply fetch continuous sample values on terms without transform
+  
+  	use of this function is unfortunate because:
+  		the incomplete migration of {name} to {gene} for gene-based term
+  		geneset edit ui is hardcoded to return {name}
+  		existing plot states contain {name}
+  
+  	!!! migration instruction !!!
+  	- term.name is for display only, if a term is gene-based, it has term.gene=str
+  	- a geneVariant term can be based on a genomic range (and not a gene), in that case it won't have term.gene and cannot be used where gene is expected, e.g. gene-based clustering analysis
+  
+  	*/
+  getClusterRowTermsAsParameter() {
+    const lst = this.hcTermGroup.lst.map(this.opts.app.vocabApi.getTwMinCopy);
+    lst.sort((a, b) => a.term.name < b.term.name ? -1 : 1);
+    return lst;
+  }
+};
+for (const methods of [hierCluster_renderers_exports, hierCluster_interactivity_exports]) {
+  for (const methodName in methods) HierCluster.prototype[methodName] = methods[methodName];
+}
+var hierClusterInit = getCompInit(HierCluster);
+var componentInit = hierClusterInit;
+
+export {
+  HierCluster,
+  hierClusterInit,
+  componentInit
+};
+//# sourceMappingURL=chunk-JSQH233D.js.map

package/dist/chunk-JWWLSDVM.js

@@ -0,0 +1,296 @@
+import {
+  getSortOptions
+} from "./chunk-SB5DR4NL.js";
+import {
+  defaultUiLabels,
+  fillTermWrapper
+} from "./chunk-YBXQBSFY.js";
+import {
+  isDictionaryType
+} from "./chunk-CFYWQJ7F.js";
+import {
+  CNVClasses,
+  dtcnv,
+  mclass,
+  mutationClasses,
+  proteinChangingMutations,
+  synonymousMutations,
+  truncatingMutations
+} from "./chunk-2N345NXD.js";
+import {
+  copyMerge
+} from "./chunk-HBNB5TRH.js";
+
+// plots/matrix/matrix.config.js
+async function getPlotConfig(opts = {}, app) {
+  const controlLabels = structuredClone(defaultUiLabels);
+  const devicePixelRatio = opts.devicePixelRatio || window.devicePixelRatio;
+  const config = {
+    // data configuration
+    termgroups: [],
+    samplegroups: [],
+    divideBy: null,
+    legendValueFilter: {
+      isAtomic: true,
+      type: "tvslst",
+      in: true,
+      join: "and",
+      lst: []
+    },
+    legendGrpFilter: {
+      isAtomic: true,
+      type: "tvslst",
+      in: true,
+      join: "and",
+      lst: []
+    },
+    filter: {
+      isAtomic: true,
+      type: "tvslst",
+      in: true,
+      join: "and",
+      lst: []
+    },
+    // cnvCutoffs: {},
+    // rendering options
+    settings: {
+      matrix: {
+        svgCanvasSwitch: 1e3,
+        // the number of samples to trigger switching between svg and canvas
+        useMinPixelWidth: true,
+        // canvas may be hazy if false, but more accurately reflects column density
+        cellEncoding: "",
+        // can be "oncoprint" | "stacked" | "single"
+        margin: {
+          top: 10,
+          right: 5,
+          bottom: 20,
+          left: 50
+        },
+        // set any dataset-defined sample limits and sort priority, otherwise undefined
+        // put in settings, so that later may be overridden by a user
+        maxGenes: opts.settings?.maxGenes || 50,
+        maxSample: opts.settings?.maxSample || 1e3,
+        sampleNameFilter: "",
+        sortSamplesBy: "a",
+        sortPriority: void 0,
+        // will be filled-in
+        sortBySampleAncestry: app.vocabApi.termdbConfig.hasSampleAncestry ? "last" : false,
+        // indicates sorting priority by sample ancestry
+        mapChildren2Root: false,
+        // for a dataset with sample ancestry, show one column per root sample (e.g. patient)
+        // sortByMutation: 'consequence', computed
+        // sortByCNV: true, computed
+        //sortOptions: getSortOptions(app.vocabApi.termdbConfig, controlLabels),
+        sortSampleGrpsBy: "name",
+        // 'hits' | 'name' | 'sampleCount'
+        sortSamplesTieBreakers: [{
+          $id: "sample",
+          sortSamples: {}
+          /*split: {char: '', index: 0}*/
+        }],
+        sortTermsBy: "sampleCount",
+        // or 'as listed'
+        // do not show number of samples at hiercluster gene row labels
+        samplecount4gene: opts.chartType == "hierCluster" ? "" : "abs",
+        //true, // 'abs' (default, previously true), 'pct', ''  (previously false)
+        geneVariantCountSamplesSkipMclass: [],
+        cellbg: "#ececec",
+        showGrid: "",
+        // false | 'pattern' | 'rect'
+        // whether to show these controls buttons
+        addMutationCNVButtons: false,
+        truncatingMutations,
+        proteinChangingMutations,
+        synonymousMutations,
+        mutationClasses,
+        CNVClasses,
+        gridStroke: "#fff",
+        outlineStroke: "#ccc",
+        beamStroke: "#f00",
+        colw: 0,
+        colwMin: 0.1 / devicePixelRatio,
+        colwMax: 16,
+        colspace: 1,
+        colgspace: 8,
+        colglabelpos: true,
+        collabelpos: "bottom",
+        collabelvisible: true,
+        collabelgap: 5,
+        collabelpad: 1,
+        collabelmaxchars: 32,
+        rowh: 18,
+        //use 0 to auto-compute row height, previous default=18,
+        rowhMin: 1,
+        rowhMax: 20,
+        rowspace: 1,
+        rowgspace: 8,
+        rowlabelpos: "left",
+        // | 'right'
+        rowlabelgap: 5,
+        rowlabelvisible: true,
+        rowlabelpad: 1,
+        rowlabelmaxchars: 32,
+        legendGrpLabelMaxChars: 26,
+        grpLabelFontSize: 12,
+        minLabelFontSize: 6,
+        maxLabelFontSize: 14,
+        transpose: false,
+        // 'auto' shows column labels only when columns are wide enough (colw >= minLabelFontSize);
+        sampleLabelsToggle: "auto",
+        // 'auto' | 'hide'
+        sampleLabelOffset: 120,
+        sampleGrpLabelOffset: 120,
+        sampleGrpLabelMaxChars: 32,
+        termLabelOffset: 80,
+        termGrpLabelOffset: 80,
+        termGrpLabelMaxChars: 32,
+        duration: 0,
+        zoomLevel: 1,
+        zoomCenterPct: 0,
+        zoomIndex: 0,
+        zoomGrpIndex: 0,
+        zoomMin: 0.5,
+        zoomIncrement: 0.1,
+        zoomStep: 1,
+        // renderedWMax should not be exposed as a user-input
+        // 60000 pixels is based on laptop and external monitor tests,
+        // when a canvas dataURL image in a zoomed-in matrix svg stops rendering
+        imgWMax: 6e4 / devicePixelRatio,
+        scrollHeight: 12,
+        controlLabels,
+        cnvUnit: "log2ratio",
+        ignoreCnvValues: false,
+        //will ignore numeric CNV values if true
+        barh: 32,
+        // default bar height for continuous terms,
+        // possible string entries:
+        // - "genesetEdit", for gene-centric embedders only like GDC OncoMatrix
+        // - may add other optional hints later
+        showHints: [],
+        genesetEditUiVersion: "",
+        // '' | 'withTabs'
+        // settings for a specific tw
+        twSpecificSettings: {},
+        oncoPrintSNVindelCellBorder: false,
+        // whether to show white cell border for SNVindel in oncoPrint mode
+        cnvValues: {
+          //Properties match the args for the ColorScales
+          //numericInput arg
+          cutoffMode: "percentile",
+          defaultPercentile: 99,
+          min: null,
+          max: null,
+          percentile: 99
+        }
+      }
+    }
+  };
+  const s = config.settings;
+  const fontsize = Math.max(s.matrix.rowh + s.matrix.rowspace - 3 * s.matrix.rowlabelpad, 12);
+  s.legend = {
+    ontop: false,
+    lineh: 25,
+    padx: 5,
+    padleft: 0,
+    //150,
+    padright: 20,
+    padbtm: 30,
+    fontsize,
+    iconh: fontsize - 2,
+    iconw: fontsize - 2,
+    hangleft: 1,
+    linesep: false
+  };
+  const overrides = app.vocabApi.termdbConfig.matrix || {};
+  copyMerge(config.settings.matrix, overrides.settings);
+  if (overrides.legendGrpFilter) config.legendGrpFilter = overrides.legendGrpFilter;
+  if (overrides.legendValueFilter) config.legendValueFilter = overrides.legendValueFilter;
+  if (overrides.filter) config.filter = overrides.filter;
+  if (opts.name) {
+    const data = await app.vocabApi.getMatrixByName(opts.name);
+    if (!data) throw "error from getMatrixByName()";
+    if (data.error) throw data.error;
+    copyMerge(config, data);
+  }
+  const os = opts?.settings?.matrix;
+  if (os) {
+    if ((os.sortSamplesBy == "custom" || os.sortSamplesBy == "asListed") && os.sortOptions?.custom.label == "against alteration type") {
+      os.sortSamplesBy = "a";
+    }
+    if (os.sortOptions) {
+      delete os.sortOptions.custom;
+      delete os.sortOptions.asListed;
+    }
+  }
+  copyMerge(config, opts);
+  const m = config.settings.matrix;
+  m.sortOptions = getSortOptions(app.vocabApi.termdbConfig, controlLabels, m);
+  m.duration = 0;
+  m.colw = 0;
+  if (m.sortSamplesBy != "asListed" && !m.sortOptions?.[m.sortSamplesBy]) m.sortSamplesBy = "a";
+  else if (["selectedTerms", "class", "dt", "hits"].includes(m.sortSamplesBy)) m.sortSamplesBy = "a";
+  if (m.samplecount4gene === true || m.samplecount4gene === 1) m.samplecount4gene = "abs";
+  if (window.location.hostname == "localhost") {
+    if (window.location.hash == "#canvas") m.svgCanvasSwitch = 0;
+  }
+  for (const grp of config.termgroups) {
+    const promises = [];
+    for (const tw of grp.lst) {
+      if (!tw.term?.type || isDictionaryType(tw.term.type)) {
+        if (!tw.id && tw.term.type != "samplelst" && tw.term.type != "termCollection") {
+          if (!tw.term.id) throw `missing tw.id and tw.term.id`;
+          tw.id = tw.term.id;
+        }
+        if (tw.term?.type != "samplelst" && tw.term?.type != "termCollection") delete tw.term;
+      }
+      promises.push(fillTermWrapper(tw, app.vocabApi));
+    }
+    grp.lst = await Promise.all(promises);
+  }
+  if (config.divideBy) config.divideBy = await fillTermWrapper(config.divideBy, app.vocabApi);
+  return config;
+}
+function setComputedConfig(config) {
+  const s = config.settings.matrix;
+  const allClasses = [...s.mutationClasses, ...s.CNVClasses];
+  s.filterByClass = { isAtomic: true };
+  for (const f of config.legendGrpFilter.lst) {
+    if (!f.dt) continue;
+    allClasses.filter((m) => f.dt.includes(mclass[m].dt)).forEach((key2) => {
+      s.filterByClass[key2] = "value";
+    });
+  }
+  for (const f of config.legendValueFilter.lst) {
+    if (!f.legendGrpName || f.tvs?.term?.type !== "geneVariant") continue;
+    if (f.tvs.values?.[0].mclasslst)
+      f.tvs.values[0].mclasslst.forEach((key2) => {
+        s.filterByClass[key2] = f.legendFilterType?.endsWith("_hard") ? "case" : "value";
+      });
+    else if (f.tvs.values)
+      f.tvs.values.forEach((v) => {
+        s.filterByClass[key] = "value";
+      });
+    else throw `unhandled tvs from legendValueFilter`;
+  }
+  s.hiddenVariants = Object.keys(s.filterByClass).filter((c) => c !== "isAtomic");
+  const hiddenCNVs = new Set(s.hiddenVariants.filter((key2) => mclass[key2]?.dt === dtcnv));
+  s.hiddenCNVs = [...hiddenCNVs];
+  s.showMatrixCNV = !hiddenCNVs.size ? "all" : hiddenCNVs.size == s.CNVClasses.length ? "none" : "bySelection";
+  s.allMatrixCNVHidden = hiddenCNVs.size == s.CNVClasses.length;
+  const hiddenMutations = new Set(s.hiddenVariants.filter((key2) => s.mutationClasses.find((k) => k === key2)));
+  s.hiddenMutations = [...hiddenMutations];
+  const PCset = new Set(s.proteinChangingMutations);
+  const TMset = new Set(s.truncatingMutations);
+  s.showMatrixMutation = !hiddenMutations.size ? "all" : hiddenMutations.size == s.mutationClasses.length ? "none" : hiddenMutations.size === s.mutationClasses.length - PCset.size && [...hiddenMutations].every((m) => !PCset.has(m)) ? "onlyPC" : hiddenMutations.size === s.mutationClasses.length - TMset.size && [...hiddenMutations].every((m) => !TMset.has(m)) ? "onlyTruncating" : "bySelection";
+  s.allMatrixMutationHidden = hiddenMutations.size == s.mutationClasses.length;
+  const tiebreakers = s.sortOptions.a?.sortPriority.find((sp) => sp.types.length == 1 && sp.types[0] == "geneVariant")?.tiebreakers || [];
+  s.sortByMutation = tiebreakers.find((tb) => tb.filter?.values[0]?.dt === 1)?.isOrdered ? "consequence" : "presence";
+  s.sortByCNV = tiebreakers.find((tb) => tb.filter?.values[0]?.dt === 4)?.disabled !== true;
+}
+
+export {
+  getPlotConfig,
+  setComputedConfig
+};
+//# sourceMappingURL=chunk-JWWLSDVM.js.map