@sjcrh/proteinpaint-client 2.203.0 → 2.203.1

package/dist/chunk-DXLO4OAB.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../shared/utils/src/terms.ts"],
+  "sourcesContent": ["import type { Term } from '#types'\nimport {\n\tdtgeneexpression,\n\tdtssgsea,\n\tdtdnamethylation,\n\tdtmetaboliteintensity,\n\tdtproteomeabundance,\n\tTermTypeGroups,\n\tdtTerms\n} from './common.js'\nimport {\n\tGENE_VARIANT,\n\tGENE_EXPRESSION,\n\tISOFORM_EXPRESSION,\n\tSSGSEA,\n\tDNA_METHYLATION,\n\tCATEGORICAL,\n\tINTEGER,\n\tJUNCTION,\n\tFLOAT,\n\tSNP,\n\tSNP_LIST,\n\tSNP_LOCUS,\n\tCONDITION,\n\tSURVIVAL,\n\tSAMPLELST,\n\tMETABOLITE_INTENSITY,\n\tPROTEOME_ABUNDANCE,\n\tPSEUDOBULK,\n\tSINGLECELL_CELLTYPE,\n\tSINGLECELL_GENE_EXPRESSION,\n\tMULTIVALUE,\n\tDATE,\n\tTERM_COLLECTION,\n\tCOHORT\n} from '#types'\n\n// moved TermTypeGroups to `server/src/common.js`, so now has to re-export\nexport { TermTypeGroups } from './common.js'\n\n/*\nFor datasets with multiple types of samples the ROOT_SAMPLE_TYPE is used to represent the root sample type, for example, \nthe type patient, that has one or more samples associated to it. This should be the id used as sample_type, when generating the db to identify the root samples\nin sampleidmap or the terms annotating root samples in the terms table.\nThe samples associated to a patient have annotations that are specific to a timepoint, for example, the age of the patient,\nthe doses of the drugs the patient was taking at the time of the data collection, etc. These annotations are associated to a sample.\n*/\nexport const ROOT_SAMPLE_TYPE = 1\n\n//For datasets with one sample type the DEFAULT_SAMPLE_TYPE is used to represent the sample type\nexport const DEFAULT_SAMPLE_TYPE = 2\n\nexport const NumericModes = {\n\tcontinuous: 'continuous',\n\tdiscrete: 'discrete'\n}\n\n// the dt term types are also declared in TermTypes, see the assertion in terms.unit.spec.ts\nexport const dtTermTypes: Set<string> = new Set(dtTerms.map((t: any) => t.type))\n\nexport const TermTypes2Dt = {\n\t[GENE_EXPRESSION]: dtgeneexpression,\n\t[SSGSEA]: dtssgsea,\n\t[DNA_METHYLATION]: dtdnamethylation,\n\t[METABOLITE_INTENSITY]: dtmetaboliteintensity,\n\t[PROTEOME_ABUNDANCE]: dtproteomeabundance\n}\n\n// maps term type to group (as is shown as toggles in search ui)\nexport const typeGroup = {\n\t[CATEGORICAL]: TermTypeGroups.DICTIONARY_VARIABLES,\n\t[CONDITION]: TermTypeGroups.DICTIONARY_VARIABLES,\n\t[FLOAT]: TermTypeGroups.DICTIONARY_VARIABLES,\n\t[INTEGER]: TermTypeGroups.DICTIONARY_VARIABLES,\n\t[SAMPLELST]: TermTypeGroups.DICTIONARY_VARIABLES,\n\t[SURVIVAL]: TermTypeGroups.DICTIONARY_VARIABLES,\n\t[DATE]: TermTypeGroups.DICTIONARY_VARIABLES,\n\t[MULTIVALUE]: TermTypeGroups.DICTIONARY_VARIABLES,\n\t[GENE_VARIANT]: TermTypeGroups.MUTATION_CNV_FUSION,\n\t[SNP]: TermTypeGroups.SNP,\n\t[SNP_LIST]: TermTypeGroups.SNP_LIST,\n\t[SNP_LOCUS]: TermTypeGroups.SNP_LOCUS,\n\t[GENE_EXPRESSION]: TermTypeGroups.GENE_EXPRESSION,\n\t[ISOFORM_EXPRESSION]: TermTypeGroups.ISOFORM_EXPRESSION,\n\t[JUNCTION]: TermTypeGroups.SPLICE_JUNCTION,\n\t[SSGSEA]: TermTypeGroups.SSGSEA,\n\t[DNA_METHYLATION]: TermTypeGroups.DNA_METHYLATION,\n\t[METABOLITE_INTENSITY]: TermTypeGroups.METABOLITE_INTENSITY,\n\t[PROTEOME_ABUNDANCE]: TermTypeGroups.PROTEOME_ABUNDANCE,\n\t[PSEUDOBULK]: TermTypeGroups.PSEUDOBULK,\n\t[TERM_COLLECTION]: TermTypeGroups.TERM_COLLECTION,\n\t[SINGLECELL_CELLTYPE]: TermTypeGroups.SINGLECELL_CELLTYPE,\n\t[SINGLECELL_GENE_EXPRESSION]: TermTypeGroups.SINGLECELL_GENE_EXPRESSION,\n\t[COHORT]: TermTypeGroups.COHORT\n}\n\nconst nonDictTypes = new Set([\n\tSNP,\n\tSNP_LIST,\n\tSNP_LOCUS,\n\tGENE_EXPRESSION,\n\tISOFORM_EXPRESSION,\n\tJUNCTION,\n\tSSGSEA,\n\tDNA_METHYLATION,\n\tGENE_VARIANT,\n\tMETABOLITE_INTENSITY,\n\tPROTEOME_ABUNDANCE,\n\tPSEUDOBULK,\n\tSINGLECELL_CELLTYPE,\n\tSINGLECELL_GENE_EXPRESSION,\n\tCOHORT\n])\n\nfor (const dtTermType of dtTermTypes) {\n\tnonDictTypes.add(dtTermType)\n}\n\nexport const numericTypes = new Set([\n\tINTEGER,\n\tFLOAT,\n\tGENE_EXPRESSION,\n\tISOFORM_EXPRESSION,\n\tJUNCTION,\n\tSSGSEA,\n\tDNA_METHYLATION,\n\tMETABOLITE_INTENSITY,\n\tPROTEOME_ABUNDANCE,\n\tSINGLECELL_GENE_EXPRESSION,\n\tDATE,\n\tPSEUDOBULK\n])\n\n// dictionary numeric term types, exists in db tables, exclude non-dictionary term types\nexport const dictionaryNumericTypes = new Set([INTEGER, FLOAT, DATE])\n\nconst categoricalTypes = new Set([CATEGORICAL, SNP])\n\nconst singleCellTerms = new Set([SINGLECELL_CELLTYPE, SINGLECELL_GENE_EXPRESSION /*PSEUDOBULK*/])\n\nexport function isSingleCellTerm(term: any) {\n\tif (!term) return false\n\treturn singleCellTerms.has(term.type)\n}\nexport function isNumericTerm(term: Term) {\n\tif (!term) return false\n\treturn numericTypes.has(term.type)\n}\n\n/** True when a term wrapper resolves to one numeric value per sample.\n * A termCollection in values mode is intentionally excluded because it retains\n * one value per member term rather than resolving to a scalar. */\nexport function isNumericTw(tw: any) {\n\tif (!tw?.term) return false\n\treturn (\n\t\tisNumericTerm(tw.term) ||\n\t\t(tw.term.type === TERM_COLLECTION && tw.term.memberType === 'numeric' && tw.type === 'TermCollectionTWFraction')\n\t)\n}\nexport function isCategoricalTerm(term: Term) {\n\tif (!term) return false\n\treturn categoricalTypes.has(term.type)\n}\n\nexport function isDictionaryType(type: string) {\n\treturn !isNonDictionaryType(type)\n}\n\nexport function isNonDictionaryType(type: string) {\n\tif (!type) throw new Error('Type is not defined')\n\treturn nonDictTypes.has(type)\n}\n\nexport function isNumTermCollection(term: Term) {\n\tif (!term || !term.type) throw new Error('Term or term type is not defined')\n\t//Enable this check when memberType is added to term collection\n\t// return term.type === TERM_COLLECTION && term.memberType == 'numeric'\n\treturn term.type === TERM_COLLECTION\n}\n\nexport function equals(t1: any, t2: any) {\n\tif (!t1) throw new Error('First term is not defined ')\n\tif (!t2) throw new Error('Second term is not defined ')\n\tif (t1.type !== t2.type) return false //term types are different\n\tif (isDictionaryType(t1.type) && isDictionaryType(t2.type) && t1.type != SAMPLELST) return t1.id === t2.id\n\tswitch (t1.type) {\n\t\tcase GENE_EXPRESSION:\n\t\t\treturn t1.gene == t2.gene\n\t\tcase ISOFORM_EXPRESSION:\n\t\t\treturn t1.isoform == t2.isoform\n\t\tcase JUNCTION:\n\t\t\treturn t1.chr == t2.chr && t1.start == t2.start && t1.stop == t2.stop && t1.strand == t2.strand\n\t\tcase SSGSEA:\n\t\t\treturn t1.id == t2.id\n\t\tcase DNA_METHYLATION:\n\t\t\treturn t1.chr == t2.chr && t1.start == t2.start && t1.stop == t2.stop\n\t\tcase METABOLITE_INTENSITY:\n\t\tcase PROTEOME_ABUNDANCE:\n\t\t\treturn t1.name == t2.name\n\t\tcase GENE_VARIANT:\n\t\t\treturn t1.gene == t2.gene || (t1.chr == t2.chr && t1.start == t2.start && t1.stop == t2.stop)\n\n\t\t// TO DO: Add more cases\n\t\t// case SNP_LIST:\n\t\t// case SNP_LOCUS:\n\t\t// case SAMPLELST:\n\n\t\tdefault:\n\t\t\treturn false\n\t}\n}\n\n/*\nA filled-in geneVariant term carries derived properties that dominate its serialized\nsize: term.childTerms[], and for a predefined groupset, term.groupsetting.lst[] with\nan embedded copy of a dt term (values, mnames, parentTerm) per tvs of every groupset.\nNone of it is needed to answer a data request:\n- no server code reads term.childTerms[]; it is a client-side convenience that\n  GvBase.fill() rebuilds from termdbConfig\n- only the groupset at q.predefined_groupset_idx is read server-side, by\n  get_active_groupset() in server/src/termdb.sql.js\n- dtTerm.mnames[] (the amino acid change tally) is only read by the tvs edit UI,\n  which re-queries it in fillMenu() before rendering\n\nTrimming these shrinks a single-gene request payload by ~80%.\n\nterm{} and q{} are mutated in place, so only call this on a copy that is about to\nbe serialized into a request payload, never on a tw held in state.\n*/\nexport function trimGvTermCopy(term: any, q: any) {\n\tif (term?.type != GENE_VARIANT) return term\n\tdelete term.childTerms\n\t/* the parent of a groupset tvs is this very term, and the server reads it off the\n\ttw rather than off the tvs, see setGroupsetParentTerms() */\n\tif (q?.customset) clearGroupsetParentTerms(q.customset)\n\tconst lst = term.groupsetting?.lst\n\tif (!lst?.length) return term\n\tif (q?.type == 'predefined-groupset') {\n\t\t// keep only the active groupset, but preserve the array indexes,\n\t\t// since the server reads groupsetting.lst[q.predefined_groupset_idx]\n\t\tconst idx = q.predefined_groupset_idx\n\t\tterm.groupsetting.lst = lst.map((groupset: any, i: number) => (i === idx ? groupset : null))\n\t\tclearDtTermMnames(term.groupsetting.lst[idx])\n\t\tclearGroupsetParentTerms(term.groupsetting.lst[idx])\n\t} else {\n\t\t// no predefined groupset is in use, so no entry of lst[] is read server-side\n\t\tdelete term.groupsetting.lst\n\t}\n\treturn term\n}\n\n/*\nStrip every derived property of a geneVariant term from a state that is about to be\nserialized into a saved session, in place. Walks any object and trims the term of each\ngeneVariant tw it finds, so it accepts a whole state, a state.plots[], or one plot config.\n\nThis goes further than trimGvTermCopy() above, which shapes a request payload and so has\nto keep whatever the server reads. Nothing here has to survive, because a saved session is\nalways re-filled before it is rendered:\n- a session opened by url is filled by getPlotConfig() in init(), see client/mass/store.ts\n- a session opened in a running app is filled by preprocessState(), see client/mass/sessionBtn.js\nand GvBase.fill() rebuilds term.childTerms[] from termdbConfig, term.groupsetting from the\nchild terms, and each childTerm.parentTerm from the term itself.\n\nBetween them these are ~91% of a serialized single-gene tw, and the ratio climbs with the\ngene count: term.genes[] is serialized once per childTerm.parentTerm and once per tvs of the\nselected groupset, so a 200-gene tw carries ~9 copies of it.\n\nA tw is identified by a term{} paired with a q{}, so that the dt term of a tvs of a mass\nfilter, which does need its own parentTerm, is never mistaken for one. Of q{}, only the\nparentTerm of a customset tvs is trimmed, which GvCustomGS.fill() re-attaches; the rest of\nq.customset is user-authored and no fill() rebuilds it.\n*/\nexport function trimGvTermsForSave(obj: any) {\n\tif (!obj || typeof obj != 'object') return obj\n\tif (obj.q && obj.term?.type == GENE_VARIANT) {\n\t\tdelete obj.term.childTerms\n\t\t// deleting rather than emptying, since GvBase.fill() recreates it from scratch\n\t\tdelete obj.term.groupsetting\n\t\tif (obj.q.customset) clearGroupsetParentTerms(obj.q.customset)\n\t}\n\tfor (const k in obj) trimGvTermsForSave(obj[k])\n\treturn obj\n}\n\n/*\nA geneVariant term is queried per entry of term.genes[], and every value it yields records\nwhich entry it came from. That record used to be a single .gene holding the entry's NAME,\nwhich for a kind='coord' entry is a coordinate string -- so consumers reading .gene as a\ngene symbol got a region, e.g. a matrix export labelling a variant \"chr1:47213991-47318918\".\n\nThe two things are now separate: .gene is a gene symbol and is simply absent for a region,\nwhile .region below is what was queried and is present either way. The helpers here are the\none place that knows the shape.\n*/\n\n/* the region a query entry covers, which every value found through it carries. Distinct\nfrom the value's own .start/.stop, which are the event's -- a cnv segment is not the region\nthat found it.\n\nCoordinates are annotated onto a gene entry by mayMapGeneName2coord() when a query needing\nthem runs, so this is undefined for a gene only queried by dts that never map coords. A\ncoord entry always carries them, since fill() requires them. */\nexport function getGvQueryRegion(gene: any) {\n\tif (!gene?.chr || !Number.isInteger(gene.start) || !Number.isInteger(gene.stop)) return\n\treturn { chr: gene.chr, start: gene.start, stop: gene.stop }\n}\n\n/* identity of the query entry a value came from, for grouping and de-duplicating the values\nof a term over several genes or regions. The gene symbol when there is one, else the region. */\nexport function getGvQueryKey(v: any) {\n\tif (v?.gene) return v.gene\n\tconst r = v?.region\n\treturn r ? `${r.chr}:${r.start}-${r.stop}` : ''\n}\n\n/*\nThe wire format for the query entry of a value, as the two halves that must stay inverse of\neach other: get_matrix.js interns on the way out, TermdbVocab.js restores on the way in.\n\nA term's values repeat their query entry endlessly -- one .region object per value, tens of\nthousands of them in a matrix request -- so the distinct entries are collected once into\nrefs.byTermId[$id].queries[] and each value keeps only its index in .$q.\n\nBoth live here so the format has one definition and can be round-tripped in a test.\n*/\n\n/** replace a value's query entry with its index into queries[], interning it if new.\n * returns false for a value that records no query entry, which is left untouched */\nexport function internGvQueryEntry(v: any, queries: any[], idxByKey: Map<string, number>) {\n\tconst key = getGvQueryKey(v)\n\tif (!key) return false\n\tlet i = idxByKey.get(key)\n\tif (i === undefined) {\n\t\ti = queries.length\n\t\tconst entry: any = {}\n\t\tif (v.gene) entry.gene = v.gene\n\t\tif (v.region) entry.region = v.region\n\t\tqueries.push(entry)\n\t\tidxByKey.set(key, i)\n\t}\n\tv.$q = i\n\tdelete v.gene\n\tdelete v.region\n\treturn true\n}\n\n/** the inverse: put the query entry back on a value. returns false when there is nothing\n * to restore, e.g. a term whose values carry no query entry */\nexport function restoreGvQueryEntry(v: any, queries: any[] | undefined) {\n\tif (!queries || v?.$q === undefined) return false\n\tObject.assign(v, queries[v.$q])\n\tdelete v.$q\n\treturn true\n}\n\n/*\nWhether a values[] entry of a tvs, naming an amino acid change, is scoped to the query entry\na variant came from.\n\nAn entry may name a .gene, so that KRAS G12D of a gene-set term does not match NRAS G12D, or\na .region for the same reason over a term of several queried regions. Naming neither leaves\nit unscoped, matching that change wherever it was found -- which is what a single-entry term\nwants, and what the variant config emits for one.\n\nBoth matchers call this so a tvs means the same thing on either side: filterByItem() in\nserver/src/mds3.init.js and matchTvs() in geneVariantFilter.ts.\n*/\nexport function matchesGvQueryEntry(entry: any, v: any) {\n\tif (entry.gene) return entry.gene == v.gene\n\tconst r = entry.region\n\tif (r) return !!v.region && r.chr == v.region.chr && r.start == v.region.start && r.stop == v.region.stop\n\treturn true\n}\n\n/*\nThe dt term of a tvs carries a parentTerm, but for two unrelated reasons:\n\n- a tvs of a mass filter stands alone, so its parentTerm is the only record of which gene\n  it is about. get_dtTerm() in server/src/termdb.filter.js reads it to run the query, and\n  the tvs edit UI reads it to label the pill. it must be kept.\n- a tvs of a groupset (q.customset, or term.groupsetting.lst[]) has no such need: its\n  parent is by definition the term of the tw that holds the groupset. storing one there is\n  a copy of term.genes[] per tvs that nothing keeps in sync with the term it was copied\n  from, and a termsetting instance is reused across terms, so it does go stale (see\n  makeGroupUI() in client/termsetting/handlers/geneVariant.ts).\n\nSo a groupset gets its parentTerms rebuilt on every fill() instead of storing them, which\nlets both trims above drop them: a groupset tvs is evaluated against the tw that holds it,\nand get_dtTerm() in server/src/termdb.filter.js is the only server-side reader of a\nparentTerm, so nothing there misses the one a groupset does not store.\n\nOne snapshot is shared by reference across the tvs, as the child dt terms of a predefined\ngroupset already are. That is only safe because the trims drop it before it is ever\nserialized, which would turn the one shared copy back into one copy per tvs.\n\nThrows on a tvs whose term is not a dt term: the groups of a geneVariant groupset can only\nfilter by dt, and the server would otherwise fail deep in filterByItem().\n*/\nexport function setGroupsetParentTerms(groupset: any, term: any) {\n\tif (term?.type != GENE_VARIANT) throw 'parent of a groupset tvs must be a geneVariant term'\n\tconst parentTerm = structuredClone(term)\n\t// the parent of a dt term is the gene(s), not the derived properties of the term\n\tdelete parentTerm.childTerms\n\tdelete parentTerm.groupsetting\n\twalkTvs(groupset, (tvs: any) => {\n\t\tif (!dtTermTypes.has(tvs.term?.type)) throw `groupset tvs term is not a dt term`\n\t\ttvs.term.parentTerm = parentTerm\n\t})\n\treturn groupset\n}\n\n/* drop what setGroupsetParentTerms() re-attaches. tolerates a malformed tvs, since a trim\nmust never be the thing that throws on the way into a request or a saved session */\nfunction clearGroupsetParentTerms(groupset: any) {\n\twalkTvs(groupset, (tvs: any) => {\n\t\tif (tvs.term) delete tvs.term.parentTerm\n\t})\n\treturn groupset\n}\n\n/* run fn on every tvs of a groupset, a group, or a filter.\n\nA tvs is a leaf: a nested tvslst is a sibling of it in filter.lst[], never inside it. Not\ndescending matters, because a tvs can hold a filter of its own that is not part of the\ngroupset structure -- tvs.mafFilter wraps a maf term, which is a dictionary term rather\nthan a dt term (see getMafFilter() in client/tw/geneVariant.ts). getDtsFromFilter() above\nreads a filter the same way. */\nfunction walkTvs(obj: any, fn: (tvs: any) => void) {\n\tif (!obj || typeof obj != 'object') return\n\tif (obj.type == 'tvs' && obj.tvs) {\n\t\tfn(obj.tvs)\n\t\treturn\n\t}\n\tfor (const k in obj) walkTvs(obj[k], fn)\n}\n\n/* the dts queried by a set of groups, read off the dt term of each tvs of their filters */\nexport function getDtsFromGroups(groups: any[]): any[] {\n\tconst dts = new Set<any>()\n\tfor (const group of groups) {\n\t\tfor (const dt of getDtsFromFilter(group.filter)) dts.add(dt)\n\t}\n\treturn [...dts]\n}\n\nfunction getDtsFromFilter(filter: any): Set<any> {\n\tconst dts = new Set<any>()\n\tfor (const item of filter.lst) {\n\t\tif (item.type == 'tvslst') {\n\t\t\tfor (const dt of getDtsFromFilter(item)) dts.add(dt)\n\t\t} else {\n\t\t\tdts.add(item.tvs.term.dt)\n\t\t}\n\t}\n\treturn dts\n}\n\n/*\ndelete the amino acid change tally from every dt term nested in a groupset or filter.\n\nOnly the variant config UI reads mnames, and it re-queries them before rendering (see\ngetDtTermValues() in client/filter/tvs.dt.js), so a tally stored on a tvs is dead weight\nthat is re-serialized once per tvs. Walks any object, so it accepts a groupset, a group,\nor a filter.\n*/\nexport function clearDtTermMnames(obj: any) {\n\twalkTvs(obj, (tvs: any) => {\n\t\tif (tvs.term) delete tvs.term.mnames\n\t})\n\treturn obj\n}\n\nexport function getBin(lst: any[], value: number) {\n\tlet bin = lst.findIndex(\n\t\tb => (b.startunbounded && value < b.stop) || (b.startunbounded && b.stopinclusive && value == b.stop)\n\t)\n\tif (bin == -1)\n\t\tbin = lst.findIndex(\n\t\t\tb => (b.stopunbounded && value > b.start) || (b.stopunbounded && b.startinclusive && value == b.start)\n\t\t)\n\tif (bin == -1)\n\t\tbin = lst.findIndex(\n\t\t\tb =>\n\t\t\t\t(value > b.start && value < b.stop) ||\n\t\t\t\t(b.startinclusive && value == b.start) ||\n\t\t\t\t(b.stopinclusive && value == b.stop)\n\t\t)\n\treturn bin\n}\n//Terms may  have a sample type associated to them, in datasets with multiple types of samples.\n//For example the gender is associated to the patient while the age is associated to the type sample. This function is used\n//for example when calling getData or getFilter, to return either the parent or the child samples, depending on the use case.\nexport function getSampleType(term: any, ds: any) {\n\tif (!term) return null\n\t//non dict terms annotate only samples, eg: gene expression, metabolite intensity, gene variant.\n\t//Their sample type is the default sample type that may or may not have a parent type, depending on the dataset\n\tif (term.type && isNonDictionaryType(term.type)) return DEFAULT_SAMPLE_TYPE\n\t//dictionary terms may annotate different types of samples, eg: patient and sample or mouse and crop.\n\tif (term.id) return ds.cohort.termdb.term2SampleType.get(term.id)\n\tif (term.type == 'samplelst') {\n\t\tconst key = Object.keys(term.values)[0]\n\t\tconst sampleId = term.values[key].list[0]?.sampleId\n\t\tif (sampleId) return ds.sampleId2Type.get(Number(sampleId) || sampleId)\n\t\telse return DEFAULT_SAMPLE_TYPE\n\t}\n\t// samplelst or non dict terms\n\treturn DEFAULT_SAMPLE_TYPE //later own term needs to know what type annotates based on the samples\n}\n\nexport function getParentType(types: Set<string>, ds: any) {\n\tif (Object.keys(ds.cohort.termdb.sampleTypes).length == 0) return null //dataset only has one type of sample\n\tconst ids = Array.from(types)\n\tif (!ids || ids.length == 0) return null\n\tfor (const id of ids) {\n\t\tconst typeObj = ds.cohort.termdb.sampleTypes[id]\n\t\tif (!typeObj) continue\n\t\tif (typeObj.parent_id == null) return id //this is the root type\n\t\t//if my parent is in the list, then I am not the parent\n\t\tif (ids.includes(typeObj.parent_id)) continue\n\t\telse return typeObj.parent_id //my parent is not in the list, so I am the parent\n\t}\n\treturn null //no parent found\n}\n\n// whether the term annotates parent samples\nexport function isParentType(term: any, ds: any) {\n\tif (!ds.cohort.termdb.hasSampleAncestry) return false\n\tconst sampleType = getSampleType(term, ds)\n\tif (!sampleType) throw 'sample type is not defined'\n\tconst sampleTypeObj = ds.cohort.termdb.sampleTypes[sampleType]\n\tif (!sampleTypeObj) throw 'invalid sample type'\n\tif (Number.isInteger(sampleTypeObj.parent_id)) {\n\t\t// sample type has parent, so it is child sample type\n\t\treturn false\n\t} else {\n\t\t// sample type does not have parent, so it is parent sample type\n\t\treturn true\n\t}\n}\n\n//Returns human readable label for each term type; label is just for printing and not computing\nconst typeMap: { [key: string]: string } = {\n\tcategorical: 'Categorical',\n\tcondition: 'Condition',\n\tfloat: 'Numerical',\n\tinteger: 'Numerical',\n\tdate: 'Date',\n\tgeneExpression: 'Gene Expression',\n\tisoformExpression: 'Isoform Expression',\n\t[JUNCTION]: 'Splice junction',\n\tssGSEA: 'Geneset Expression',\n\tdnaMethylation: 'DNA Methylation',\n\tgeneVariant: 'Gene Variant',\n\tmetaboliteIntensity: 'Metabolite Intensity',\n\tproteomeAbundance: 'Proteome Abundance',\n\tproteomeDAP: 'Proteome DAP',\n\tmultivalue: 'Multi Value',\n\tsingleCellGeneExpression: 'Single Cell, Gene Expression',\n\tsingleCellCellType: 'Single Cell, Cell Type',\n\tsnplocus: 'SNP Locus',\n\tsnp: 'SNP',\n\tsnplst: 'SNP List',\n\ttermCollection: 'Term Collection'\n}\n\n// with a term obj, returns human readable item type name for a term.\n// using a term obj rather than just term type gives more control (e.g. gene vs coord for genevariant term)\nexport function termItemType(t: Term): string {\n\tswitch (t.type) {\n\t\tcase JUNCTION:\n\t\t\treturn 'Splice junction'\n\t\tcase GENE_EXPRESSION:\n\t\tcase SINGLECELL_GENE_EXPRESSION:\n\t\t\treturn 'Gene'\n\t\tcase ISOFORM_EXPRESSION:\n\t\t\treturn 'Isoform'\n\t\tcase SSGSEA:\n\t\t\treturn 'Gene set'\n\t\tcase METABOLITE_INTENSITY:\n\t\t\treturn 'Metabolite'\n\t\t// keep adding here\n\t\tdefault:\n\t\t\treturn 'Variable'\n\t}\n}\n\nexport function termType2label(type: string) {\n\tconst s = typeMap[type]\n\tif (s) return s\n\tthrow new Error('termType2label(): unknown value')\n}\n\nexport function getDateFromNumber(value: number) {\n\tconst year = Math.floor(value)\n\tconst january1st = new Date(year, 0, 1)\n\tconst totalDays = getDaysInYear(year)\n\tconst time = Math.round((value - year) * totalDays) * oneDayTime\n\tconst date = new Date(january1st.getTime() + time)\n\treturn date\n}\n/*\nValue is a decimal year.\nA decimal year is a way of expressing a date or time period as a year with a decimal part, where the decimal portion \nrepresents the fraction of the year that has elapsed. \nExample:\n2025.0 represents the beginning of the year 2025. \n2025.5 represents the middle of the year 2025. \n */\nconst oneDayTime = 24 * 60 * 60 * 1000\n\nexport function getDateStrFromNumber(value: number) {\n\tconst date = getDateFromNumber(value)\n\n\t//Omit day to  deidentify the patients\n\treturn date.toLocaleDateString('en-US', {\n\t\tyear: 'numeric',\n\t\tmonth: 'long'\n\t})\n}\n\n//The value returned is a decimal year\n//A decimal year is a way of expressing a date or time period as a year with a decimal part, where the decimal portion\n//represents the fraction of the year that has elapsed.\nexport function getNumberFromDateStr(str: string) {\n\tconst date = new Date(str)\n\treturn getNumberFromDate(date)\n}\n\nexport function getNumberFromDate(date: Date) {\n\tconst year = date.getFullYear()\n\tconst january1st: Date = new Date(year, 0, 1)\n\tconst diffDays = (date.getTime() - january1st.getTime()) / oneDayTime\n\tconst daysTotal = getDaysInYear(year)\n\tconst decimal = diffDays / daysTotal\n\treturn year + decimal\n}\n\nexport function getDaysInYear(year: number) {\n\tconst isLeap = new Date(year, 1, 29).getMonth() === 1\n\tconst days = isLeap ? 366 : 365\n\treturn days\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/chunk-E5BFGDLA.js

@@ -0,0 +1,292 @@
+import {
+  getSortOptions
+} from "./chunk-SNCZRDS5.js";
+import {
+  defaultUiLabels,
+  fillTermWrapper
+} from "./chunk-D5PX2UDG.js";
+import {
+  isDictionaryType
+} from "./chunk-DXLO4OAB.js";
+import {
+  CNVClasses,
+  dtcnv,
+  mclass,
+  mutationClasses,
+  proteinChangingMutations,
+  synonymousMutations,
+  truncatingMutations
+} from "./chunk-4QBRVM4V.js";
+import {
+  copyMerge
+} from "./chunk-H6INPPUC.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
+        // 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-E5BFGDLA.js.map

package/dist/chunk-ECISCOPF.js

@@ -0,0 +1,134 @@
+import {
+  addGeneSearchbox,
+  isoformSelect,
+  pickCollectionFraction,
+  sayerror
+} from "./chunk-D5PX2UDG.js";
+import {
+  Menu
+} from "./chunk-ELJX3QIQ.js";
+import {
+  dofetch3
+} from "./chunk-6X7PP7A4.js";
+import {
+  ISOFORM_EXPRESSION,
+  getColors
+} from "./chunk-4QBRVM4V.js";
+
+// termdb/handlers/isoformExpression.ts
+var SearchHandler = class {
+  constructor() {
+    this.currentGene = null;
+  }
+  init(opts) {
+    this.callback = opts.callback;
+    this.app = opts.app;
+    this.termCollectionSelectionMode = opts.termCollectionSelectionMode;
+    const holder = opts.holder.append("div").style("padding", "10px 0px");
+    this.dom = {
+      errDiv: holder.append("div").style("margin", "5px 0px").style("display", "none")
+    };
+    const geneSearch = addGeneSearchbox({
+      tip: new Menu({ padding: "0px" }),
+      genome: opts.genomeObj,
+      row: holder,
+      searchOnly: "gene",
+      callback: async () => {
+        try {
+          this.dom.errDiv.style("display", "none");
+          if (!geneSearch.geneSymbol) throw new Error("No gene selected");
+          if (geneSearch.geneSymbol === this.currentGene) return;
+          this.currentGene = geneSearch.geneSymbol;
+          if (this.dom.isoformDiv) this.dom.isoformDiv.remove();
+          this.dom.isoformDiv = holder.append("div");
+          await this.showIsoforms(geneSearch.geneSymbol, opts.genomeObj);
+        } catch (e) {
+          this.dom.errDiv.style("display", "block");
+          sayerror(this.dom.errDiv, "Error: " + (e instanceof Error ? e.message : String(e)));
+        }
+      }
+    });
+  }
+  async showIsoforms(gene, genomeObj) {
+    if (!gene) throw new Error("No gene selected");
+    const data = await dofetch3("genelookup", { body: { genome: genomeObj.name, input: gene, deep: 1 } });
+    if (!data.gmlst?.length) throw new Error(`No isoforms found for ${gene}`);
+    const enstCandidates = data.gmlst.filter((gm) => gm.isoform?.startsWith("ENST"));
+    if (enstCandidates.length === 0) throw new Error(`No Ensembl transcript isoforms found for ${gene}`);
+    const { available } = await dofetch3("termdb/isoformAvailability", {
+      body: {
+        genome: genomeObj.name,
+        dslabel: this.app.vocabApi.vocab.dslabel,
+        isoforms: enstCandidates.map((gm) => gm.isoform)
+      }
+    });
+    const availableSet = new Set(available || []);
+    const enstModels = enstCandidates.filter((gm) => availableSet.has(gm.isoform));
+    if (enstModels.length === 0) throw new Error(`No isoforms with data found for ${gene}`);
+    if (gene !== this.currentGene) return;
+    const div = this.dom.isoformDiv;
+    div.append("div").style("margin-bottom", "8px").style("opacity", 0.65).text(`${gene} \u2014 select isoform(s):`);
+    isoformSelect({
+      holder: div,
+      allgm: enstModels,
+      multiSelect: true,
+      // a single checked isoform yields an individual term, 2+ yield a collection
+      getSubmitLabel: (selectedCount) => selectedCount === 1 ? "Select One Isoform" : `Create Collection (${selectedCount})`,
+      onMultiSelect: (selected) => {
+        if (selected.length === 1) {
+          this.selectIsoform(selected[0].isoform, gene);
+        } else {
+          this.selectCollection(selected, gene);
+        }
+      }
+    });
+  }
+  getUnit() {
+    return this.app.vocabApi.termdbConfig.queries.isoformExpression?.unit || "TPM";
+  }
+  selectIsoform(isoform, gene) {
+    const name = `${isoform} ${this.getUnit()}`;
+    this.callback({ isoform, gene, name, type: ISOFORM_EXPRESSION });
+  }
+  selectCollection(gms, gene) {
+    const unit = this.getUnit();
+    const termlst = gms.map((gm) => ({
+      id: gm.isoform,
+      name: gm.isoform,
+      type: ISOFORM_EXPRESSION,
+      isoform: gm.isoform
+    }));
+    const colorScale = getColors(termlst.length);
+    const term = {
+      type: "termCollection",
+      isCustom: true,
+      memberType: "numeric",
+      name: `${gene} Isoforms (${unit})`,
+      termlst,
+      propsByTermId: Object.fromEntries(termlst.map((term2) => [term2.id, { color: colorScale(term2.id) }])),
+      isleaf: true
+    };
+    if (this.termCollectionSelectionMode === "fraction") {
+      if (!this.dom?.isoformDiv) throw new Error("isoform result holder is missing");
+      this.dom.fractionDiv?.remove();
+      this.dom.fractionDiv = this.dom.isoformDiv.append("div").style("margin-top", "10px");
+      pickCollectionFraction({
+        holder: this.dom.fractionDiv,
+        term,
+        callback: (tw) => this.callback(tw)
+      });
+      return;
+    }
+    this.callback(term);
+  }
+};
+function filterIsoforms(gmlst, availableItems) {
+  const itemSet = new Set(availableItems);
+  return gmlst.filter((gm) => gm.isoform?.startsWith("ENST") && (itemSet.size === 0 || itemSet.has(gm.isoform)));
+}
+
+export {
+  SearchHandler,
+  filterIsoforms
+};
+//# sourceMappingURL=chunk-ECISCOPF.js.map

package/dist/chunk-ECLUUJVE.js

@@ -0,0 +1,158 @@
+import {
+  NumericDensity
+} from "./chunk-CNVVCSB3.js";
+import {
+  Tabs
+} from "./chunk-D5PX2UDG.js";
+import {
+  HandlerBase
+} from "./chunk-XFAL46LZ.js";
+
+// termsetting/handlers/NumericHandler.ts
+var NumericHandler = class extends HandlerBase {
+  constructor(opts) {
+    super(opts);
+    this.tabs = [];
+    this.handlerByMode = {};
+    this.dom = {};
+    this.opts = opts;
+    this.termsetting = opts.termsetting;
+    this.tw = opts.termsetting.tw;
+    this.tabs = this.setTabData();
+    this.density = new NumericDensity(opts);
+  }
+  getPillStatus() {
+    this.tw = this.termsetting.tw;
+    return this.tw.getStatus(this.termsetting.usecase, this.termsetting.data);
+  }
+  setTabData() {
+    const self = this.termsetting;
+    const tabs = [];
+    const callback = async (event, tabData) => {
+      if (event) event.stopPropagation();
+      try {
+        await this.setEditHandler(tabData);
+        await this.editHandler.showEditMenu(tabData.contentHolder);
+      } catch (e) {
+        this.dom.errdiv.style("display", "").text(e);
+      }
+    };
+    const numTabs = self.opts.numericEditMenuVersion.length;
+    if (self.opts.numericEditMenuVersion.includes("continuous")) {
+      tabs.push({
+        mode: "continuous",
+        label: self.term.type == "survival" ? "Time to Event" : "Continuous",
+        callback,
+        active: this.tw.q.mode === "continuous" || numTabs === 1
+      });
+    }
+    if (self.opts.numericEditMenuVersion.includes("discrete")) {
+      tabs.push({
+        mode: "discrete",
+        label: self.term.type == "survival" ? "Exit code" : "Discrete",
+        callback,
+        active: this.tw.q.mode === "discrete" || numTabs === 1
+      });
+    }
+    if (self.opts.numericEditMenuVersion.includes("spline")) {
+      tabs.push({
+        mode: "spline",
+        label: "Cubic spline",
+        callback,
+        active: this.tw.q.mode === "spline" || numTabs === 1
+      });
+    }
+    if (self.opts.numericEditMenuVersion.includes("binary")) {
+      tabs.push({
+        mode: "binary",
+        label: "Binary",
+        callback,
+        active: this.tw.q.mode === "binary" || numTabs === 1
+      });
+    }
+    return tabs;
+  }
+  async setEditHandler(tabData) {
+    if (!this.handlerByMode[tabData.mode]) {
+      switch (tabData.mode) {
+        case "continuous": {
+          const { NumContEditor } = await import("./NumContEditor-KFDA76QN.js");
+          this.handlerByMode.continuous = new NumContEditor(this.opts, this);
+          break;
+        }
+        case "discrete": {
+          const { NumDiscreteEditor } = await import("./NumDiscreteEditor-Y4EAADXC.js");
+          this.handlerByMode.discrete = new NumDiscreteEditor(this.opts, this);
+          break;
+        }
+        case "binary": {
+          const { NumBinaryEditor } = await import("./NumBinaryEditor-IU6OLMKN.js");
+          this.handlerByMode.binary = new NumBinaryEditor(this.opts, this);
+          break;
+        }
+        case "spline": {
+          const { NumSplineEditor } = await import("./NumSplineEditor-K4KPDC4S.js");
+          this.handlerByMode.spline = new NumSplineEditor(this.opts, this);
+          break;
+        }
+        default:
+          throw `unexpected numeric tabData.mode='${tabData.mode}'`;
+          break;
+      }
+    }
+    this.editHandler = this.handlerByMode[tabData.mode];
+  }
+  async showEditMenu(div) {
+    try {
+      this.showLoading(div);
+      this.dom.errdiv = div.append("div").attr("class", "sja_errorbar").style("display", "none");
+      this.tw = this.termsetting.tw;
+      const self = this.tw;
+      for (const t of this.tabs) {
+        t.active = this.tabs.length === 1 || self.q.mode == t.mode || t.mode == "continuous" && !self.q.mode;
+      }
+      this.density_data = await this.density.setData();
+      await this.setEditHandler(this.tabs.find((t) => t.active));
+      this.dom.editDiv = div.append("div").attr("data-testid", "sjpp-num-ts-edit-div");
+      this.dom.btnDiv = div.append("div").style("margin", "0px 0px 5px 5px");
+      this.renderButtons(this.dom.btnDiv);
+      if (this.tabs.length > 1) {
+        this.dom.topBar = this.dom.editDiv.append("div").style("padding", "10px");
+        this.dom.topBar.append("span").html("Use as ");
+        new Tabs({
+          holder: this.dom.topBar.append("div").style("display", "inline-block"),
+          contentHolder: this.dom.editDiv.append("div"),
+          noTopContentStyle: true,
+          tabs: this.tabs
+        }).main();
+      } else {
+        await this.editHandler.showEditMenu(this.dom.editDiv);
+      }
+      this.dom.loadingDiv.style("display", "none");
+    } catch (e) {
+      this.hideLoading();
+      this.dom.errdiv.style("display", "").text(typeof e == "object" ? e.message || e.error || e : e);
+    }
+  }
+  renderButtons(btnDiv) {
+    btnDiv.append("button").style("margin", "5px").attr("data-testId", "sjpp_numeric_edit_apply").html("Apply").on("click", () => {
+      this.termsetting.q = this.editHandler.getEditedQ();
+      this.termsetting.dom.tip.hide();
+      this.termsetting.api.runCallback();
+    });
+    btnDiv.append("button").style("margin", "5px").attr("data-testId", "sjpp_numeric_edit_reset").html("Reset").on("click", () => {
+      this.editHandler.undoEdits();
+    });
+  }
+  destroy() {
+    for (const s of Object.values(this.dom)) {
+      if (typeof s.remove == "function") s.remove();
+    }
+    this.density.destroy();
+  }
+};
+
+export {
+  NumericHandler
+};
+//# sourceMappingURL=chunk-ECLUUJVE.js.map