@jbrowse/plugin-alignments 2.17.0 → 3.0.0

package/esm/SNPCoverageAdapter/processReferenceCpGs.js

@@ -0,0 +1,60 @@
+import { doesIntersect2 } from '@jbrowse/core/util';
+import { parseCigar } from '../MismatchParser';
+import { getMethBins } from '../ModificationParser';
+import { incWithProbabilities } from './util';
+export function processReferenceCpGs({ feature, region, bins, regionSequence, }) {
+    var _a;
+    const fstart = feature.get('start');
+    const fend = feature.get('end');
+    const fstrand = feature.get('strand');
+    const seq = feature.get('seq');
+    const mismatches = (_a = feature.get('mismatches')) !== null && _a !== void 0 ? _a : [];
+    const r = regionSequence.toLowerCase();
+    if (seq) {
+        const cigarOps = parseCigar(feature.get('CIGAR'));
+        const { methBins, methProbs } = getMethBins(feature, cigarOps);
+        const dels = mismatches.filter(f => f.type === 'deletion');
+        for (let i = 0; i < fend - fstart; i++) {
+            const j = i + fstart;
+            const l1 = r[j - region.start + 1];
+            const l2 = r[j - region.start + 2];
+            if (l1 === 'c' && l2 === 'g') {
+                const bin0 = bins[j - region.start];
+                const bin1 = bins[j - region.start + 1];
+                const b0 = methBins[i];
+                const b1 = methBins[i + 1];
+                const p0 = methProbs[i];
+                const p1 = methProbs[i + 1];
+                if ((b0 && (p0 !== undefined ? p0 > 0.5 : true)) ||
+                    (b1 && (p1 !== undefined ? p1 > 0.5 : true))) {
+                    if (bin0) {
+                        incWithProbabilities(bin0, fstrand, 'mods', 'cpg_meth', p0 || 0);
+                        bin0.ref.entryDepth--;
+                        bin0.ref[fstrand]--;
+                    }
+                    if (bin1) {
+                        incWithProbabilities(bin1, fstrand, 'mods', 'cpg_meth', p1 || 0);
+                        bin1.ref.entryDepth--;
+                        bin1.ref[fstrand]--;
+                    }
+                }
+                else {
+                    if (bin0) {
+                        if (!dels.some(d => doesIntersect2(j, j + 1, d.start + fstart, d.start + fstart + d.length))) {
+                            incWithProbabilities(bin0, fstrand, 'nonmods', 'cpg_unmeth', 1 - (p0 || 0));
+                            bin0.ref.entryDepth--;
+                            bin0.ref[fstrand]--;
+                        }
+                    }
+                    if (bin1) {
+                        if (!dels.some(d => doesIntersect2(j + 1, j + 2, d.start + fstart, d.start + fstart + d.length))) {
+                            incWithProbabilities(bin1, fstrand, 'nonmods', 'cpg_unmeth', 1 - (p1 || 0));
+                            bin1.ref.entryDepth--;
+                            bin1.ref[fstrand]--;
+                        }
+                    }
+                }
+            }
+        }
+    }
+}

package/esm/SNPCoverageAdapter/util.d.ts

@@ -0,0 +1,10 @@
+import type { ColorBy, Mismatch, PreBaseCoverageBin, PreBaseCoverageBinSubtypes } from '../shared/types';
+export interface Opts {
+    bpPerPx?: number;
+    colorBy?: ColorBy;
+    stopToken?: string;
+}
+export declare function mismatchLen(mismatch: Mismatch): number;
+export declare function isInterbase(type: string): type is "insertion" | "hardclip" | "softclip";
+export declare function inc(bin: PreBaseCoverageBin, strand: -1 | 0 | 1, type: keyof PreBaseCoverageBinSubtypes, field: string): void;
+export declare function incWithProbabilities(bin: PreBaseCoverageBin, strand: -1 | 0 | 1, type: keyof PreBaseCoverageBinSubtypes, field: string, probability: number): void;

package/esm/SNPCoverageAdapter/util.js

@@ -0,0 +1,35 @@
+export function mismatchLen(mismatch) {
+    return !isInterbase(mismatch.type) ? mismatch.length : 1;
+}
+export function isInterbase(type) {
+    return type === 'softclip' || type === 'hardclip' || type === 'insertion';
+}
+export function inc(bin, strand, type, field) {
+    let thisBin = bin[type][field];
+    if (thisBin === undefined) {
+        thisBin = bin[type][field] = {
+            entryDepth: 0,
+            probabilities: [],
+            '-1': 0,
+            '0': 0,
+            '1': 0,
+        };
+    }
+    thisBin.entryDepth++;
+    thisBin[strand]++;
+}
+export function incWithProbabilities(bin, strand, type, field, probability) {
+    let thisBin = bin[type][field];
+    if (thisBin === undefined) {
+        thisBin = bin[type][field] = {
+            entryDepth: 0,
+            probabilities: [],
+            '-1': 0,
+            '0': 0,
+            '1': 0,
+        };
+    }
+    thisBin.entryDepth++;
+    thisBin.probabilities.push(probability);
+    thisBin[strand]++;
+}

package/esm/SNPCoverageRenderer/SNPCoverageRenderer.d.ts

@@ -1,21 +1,5 @@
-import { Feature } from '@jbrowse/core/util';
-import { RenderArgsDeserialized as FeatureRenderArgsDeserialized } from '@jbrowse/core/pluggableElementTypes/renderers/FeatureRendererType';
-import { ScaleOpts, WiggleBaseRenderer } from '@jbrowse/plugin-wiggle';
-import { ModificationTypeWithColor } from '../shared/types';
-export interface RenderArgsDeserialized extends FeatureRenderArgsDeserialized {
-    bpPerPx: number;
-    height: number;
-    highResolutionScaling: number;
-    scaleOpts: ScaleOpts;
-}
-export interface RenderArgsDeserializedWithFeatures extends RenderArgsDeserialized {
-    features: Map<string, Feature>;
-    ticks: {
-        values: number[];
-    };
-    displayCrossHatches: boolean;
-    visibleModifications?: Record<string, ModificationTypeWithColor>;
-}
+import { WiggleBaseRenderer } from '@jbrowse/plugin-wiggle';
+import type { RenderArgsDeserializedWithFeatures } from './types';
 export default class SNPCoverageRenderer extends WiggleBaseRenderer {
     draw(ctx: CanvasRenderingContext2D, props: RenderArgsDeserializedWithFeatures): Promise<undefined>;
 }

package/esm/SNPCoverageRenderer/SNPCoverageRenderer.js

@@ -1,294 +1,8 @@
-import { createJBrowseTheme } from '@jbrowse/core/ui';
-import { featureSpanPx, bpSpanPx } from '@jbrowse/core/util';
-import { readConfObject } from '@jbrowse/core/configuration';
-import { getOrigin, getScale, WiggleBaseRenderer, YSCALEBAR_LABEL_OFFSET, } from '@jbrowse/plugin-wiggle';
-import { alphaColor } from '../shared/util';
-// width/height of the triangle above e.g. insertion indicators
-const INTERBASE_INDICATOR_WIDTH = 7;
-const INTERBASE_INDICATOR_HEIGHT = 4.5;
-// minimum read depth to draw the insertion indicators, below this the
-// 'statistical significance' is low
-const MINIMUM_INTERBASE_INDICATOR_READ_DEPTH = 7;
-const complementBase = {
-    C: 'G',
-    G: 'C',
-    A: 'T',
-    T: 'A',
-};
-const fudgeFactor = 0.6;
+import { WiggleBaseRenderer } from '@jbrowse/plugin-wiggle';
 export default class SNPCoverageRenderer extends WiggleBaseRenderer {
-    // note: the snps are drawn on linear scale even if the data is drawn in log
-    // scape hence the two different scales being used
     async draw(ctx, props) {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-        const { features, regions, bpPerPx, colorBy, displayCrossHatches, visibleModifications = {}, scaleOpts, height: unadjustedHeight, theme: configTheme, config: cfg, ticks, } = props;
-        const theme = createJBrowseTheme(configTheme);
-        const region = regions[0];
-        const width = (region.end - region.start) / bpPerPx;
-        // the adjusted height takes into account YSCALEBAR_LABEL_OFFSET from the
-        // wiggle display, and makes the height of the actual drawn area add
-        // "padding" to the top and bottom of the display
-        const offset = YSCALEBAR_LABEL_OFFSET;
-        const height = unadjustedHeight - offset * 2;
-        const opts = { ...scaleOpts, range: [0, height] };
-        const viewScale = getScale(opts);
-        // clipping and insertion indicators, uses a smaller height/2 scale
-        const indicatorViewScale = getScale({
-            ...opts,
-            range: [0, height / 2],
-            scaleType: 'linear',
-        });
-        const originY = getOrigin(scaleOpts.scaleType);
-        const originLinear = getOrigin('linear');
-        const indicatorThreshold = readConfObject(cfg, 'indicatorThreshold');
-        const drawInterbaseCounts = readConfObject(cfg, 'drawInterbaseCounts');
-        const drawArcs = readConfObject(cfg, 'drawArcs');
-        const drawIndicators = readConfObject(cfg, 'drawIndicators');
-        // get the y coordinate that we are plotting at, this can be log scale
-        const toY = (n) => height - (viewScale(n) || 0) + offset;
-        const toHeight = (n) => toY(originY) - toY(n);
-        // used specifically for indicator
-        const toY2 = (n) => height - (indicatorViewScale(n) || 0) + offset;
-        const toHeight2 = (n) => toY2(originLinear) - toY2(n);
-        const { bases } = theme.palette;
-        const colorForBase = {
-            A: bases.A.main,
-            C: bases.C.main,
-            G: bases.G.main,
-            T: bases.T.main,
-            insertion: 'purple',
-            softclip: 'blue',
-            hardclip: 'red',
-            total: readConfObject(cfg, 'color'),
-            mod_NONE: 'blue',
-            cpg_meth: 'red',
-            cpg_unmeth: 'blue',
-        };
-        const feats = [...features.values()];
-        // Use two pass rendering, which helps in visualizing the SNPs at higher
-        // bpPerPx First pass: draw the gray background
-        ctx.fillStyle = colorForBase.total;
-        for (const feature of feats) {
-            if (feature.get('type') === 'skip') {
-                continue;
-            }
-            const [leftPx, rightPx] = featureSpanPx(feature, region, bpPerPx);
-            const w = rightPx - leftPx + fudgeFactor;
-            const score = feature.get('score');
-            ctx.fillRect(leftPx, toY(score), w, toHeight(score));
-        }
-        // Keep track of previous total which we will use it to draw the interbase
-        // indicator (if there is a sudden clip, there will be no read coverage but
-        // there will be "clip" coverage) at that position beyond the read.
-        //
-        // if the clip is right at a block boundary then prevTotal will not be
-        // available, so this is a best attempt to plot interbase indicator at the
-        // "cliffs"
-        let prevTotal = 0;
-        // extraHorizontallyFlippedOffset is used to draw interbase items, which
-        // are located to the left when forward and right when reversed
-        const extraHorizontallyFlippedOffset = region.reversed ? 1 / bpPerPx : 0;
-        // @ts-expect-error
-        const drawingModifications = (colorBy === null || colorBy === void 0 ? void 0 : colorBy.type) === 'modifications';
-        // @ts-expect-error
-        const drawingMethylation = (colorBy === null || colorBy === void 0 ? void 0 : colorBy.type) === 'methylation';
-        const isolatedModification = 
-        // @ts-expect-error
-        (_a = colorBy === null || colorBy === void 0 ? void 0 : colorBy.modifications) === null || _a === void 0 ? void 0 : _a.isolatedModification;
-        // Second pass: draw the SNP data, and add a minimum feature width of 1px
-        // which can be wider than the actual bpPerPx This reduces overdrawing of
-        // the grey background over the SNPs
-        for (const feature of feats) {
-            if (feature.get('type') === 'skip') {
-                continue;
-            }
-            const [leftPx, rightPx] = featureSpanPx(feature, region, bpPerPx);
-            const snpinfo = feature.get('snpinfo');
-            const w = Math.max(rightPx - leftPx, 1);
-            const score0 = feature.get('score');
-            if (drawingModifications) {
-                let curr = 0;
-                const refbase = (_b = snpinfo.refbase) === null || _b === void 0 ? void 0 : _b.toUpperCase();
-                const { nonmods, mods, snps, ref } = snpinfo;
-                for (const m of Object.keys(nonmods).sort().reverse()) {
-                    const mod = visibleModifications[m.replace('nonmod_', '')] ||
-                        visibleModifications[m.replace('mod_', '')];
-                    if (!mod) {
-                        console.warn(`${m} not known yet`);
-                        continue;
-                    }
-                    if (isolatedModification && mod.type !== isolatedModification) {
-                        continue;
-                    }
-                    const cmp = complementBase[mod.base];
-                    // this approach is inspired from the 'simplex' approach in igv
-                    // https://github.com/igvteam/igv/blob/af07c3b1be8806cfd77343ee04982aeff17d2beb/src/main/java/org/broad/igv/sam/mods/BaseModificationCoverageRenderer.java#L51
-                    const detectable = mod.base === 'N'
-                        ? score0
-                        : (((_c = snps[mod.base]) === null || _c === void 0 ? void 0 : _c.entryDepth) || 0) +
-                            (((_d = snps[cmp]) === null || _d === void 0 ? void 0 : _d.entryDepth) || 0) +
-                            (refbase === mod.base ? ref['1'] : 0) +
-                            (refbase === cmp ? ref['-1'] : 0);
-                    const modifiable = mod.base === 'N'
-                        ? score0
-                        : (((_e = snps[mod.base]) === null || _e === void 0 ? void 0 : _e.entryDepth) || 0) +
-                            (((_f = snps[cmp]) === null || _f === void 0 ? void 0 : _f.entryDepth) || 0) +
-                            (refbase === mod.base ? ref.entryDepth : 0) +
-                            (refbase === cmp ? ref.entryDepth : 0);
-                    const { entryDepth, avgProbability = 0 } = snpinfo.nonmods[m];
-                    const modFraction = (modifiable / score0) * (entryDepth / detectable);
-                    const nonModColor = 'blue';
-                    const c = alphaColor(nonModColor, avgProbability);
-                    const height = toHeight(score0);
-                    const bottom = toY(score0) + height;
-                    ctx.fillStyle = c;
-                    ctx.fillRect(Math.round(leftPx), bottom - (curr + modFraction * height), w, modFraction * height);
-                    curr += modFraction * height;
-                }
-                for (const m of Object.keys(mods).sort().reverse()) {
-                    const mod = visibleModifications[m.replace('mod_', '')];
-                    if (!mod) {
-                        console.warn(`${m} not known yet`);
-                        continue;
-                    }
-                    if (isolatedModification && mod.type !== isolatedModification) {
-                        continue;
-                    }
-                    const cmp = complementBase[mod.base];
-                    // this approach is inspired from the 'simplex' approach in igv
-                    // https://github.com/igvteam/igv/blob/af07c3b1be8806cfd77343ee04982aeff17d2beb/src/main/java/org/broad/igv/sam/mods/BaseModificationCoverageRenderer.java#L51
-                    const detectable = mod.base === 'N'
-                        ? score0
-                        : (((_g = snps[mod.base]) === null || _g === void 0 ? void 0 : _g.entryDepth) || 0) +
-                            (((_h = snps[cmp]) === null || _h === void 0 ? void 0 : _h.entryDepth) || 0) +
-                            (refbase === mod.base ? ref['1'] : 0) +
-                            (refbase === cmp ? ref['-1'] : 0);
-                    const modifiable = mod.base === 'N'
-                        ? score0
-                        : (((_j = snps[mod.base]) === null || _j === void 0 ? void 0 : _j.entryDepth) || 0) +
-                            (((_k = snps[cmp]) === null || _k === void 0 ? void 0 : _k.entryDepth) || 0) +
-                            (refbase === mod.base ? ref.entryDepth : 0) +
-                            (refbase === cmp ? ref.entryDepth : 0);
-                    const { entryDepth, avgProbability = 0 } = mods[m];
-                    const modFraction = (modifiable / score0) * (entryDepth / detectable);
-                    const baseColor = mod.color || 'black';
-                    const c = alphaColor(baseColor, avgProbability);
-                    const height = toHeight(score0);
-                    const bottom = toY(score0) + height;
-                    ctx.fillStyle = c;
-                    ctx.fillRect(Math.round(leftPx), bottom - (curr + modFraction * height), w, modFraction * height);
-                    curr += modFraction * height;
-                }
-            }
-            else if (drawingMethylation) {
-                const { depth, nonmods, mods } = snpinfo;
-                let curr = 0;
-                for (const base of Object.keys(mods).sort().reverse()) {
-                    const { entryDepth } = mods[base];
-                    const height = toHeight(score0);
-                    const bottom = toY(score0) + height;
-                    ctx.fillStyle = colorForBase[base] || 'black';
-                    ctx.fillRect(Math.round(leftPx), bottom - ((entryDepth + curr) / depth) * height, w, (entryDepth / depth) * height);
-                    curr += entryDepth;
-                }
-                for (const base of Object.keys(nonmods).sort().reverse()) {
-                    const { entryDepth } = nonmods[base];
-                    const height = toHeight(score0);
-                    const bottom = toY(score0) + height;
-                    ctx.fillStyle = colorForBase[base] || 'black';
-                    ctx.fillRect(Math.round(leftPx), bottom - ((entryDepth + curr) / depth) * height, w, (entryDepth / depth) * height);
-                    curr += entryDepth;
-                }
-            }
-            else {
-                const { depth, snps } = snpinfo;
-                let curr = 0;
-                for (const base of Object.keys(snps).sort().reverse()) {
-                    const { entryDepth } = snps[base];
-                    const height = toHeight(score0);
-                    const bottom = toY(score0) + height;
-                    ctx.fillStyle = colorForBase[base] || 'black';
-                    ctx.fillRect(Math.round(leftPx), bottom - ((entryDepth + curr) / depth) * height, w, (entryDepth / depth) * height);
-                    curr += entryDepth;
-                }
-            }
-            const interbaseEvents = Object.keys(snpinfo.noncov);
-            if (drawInterbaseCounts) {
-                let curr = 0;
-                for (const base of interbaseEvents) {
-                    const { entryDepth } = snpinfo.noncov[base];
-                    const r = 0.6;
-                    ctx.fillStyle = colorForBase[base];
-                    ctx.fillRect(leftPx - r + extraHorizontallyFlippedOffset, INTERBASE_INDICATOR_HEIGHT + toHeight2(curr), r * 2, toHeight2(entryDepth));
-                    curr += entryDepth;
-                }
-            }
-            if (drawIndicators) {
-                let accum = 0;
-                let max = 0;
-                let maxBase = '';
-                for (const base of interbaseEvents) {
-                    const { entryDepth } = snpinfo.noncov[base];
-                    accum += entryDepth;
-                    if (entryDepth > max) {
-                        max = entryDepth;
-                        maxBase = base;
-                    }
-                }
-                // avoid drawing a bunch of indicators if coverage is very low. note:
-                // also uses the prev total in the case of the "cliff"
-                const indicatorComparatorScore = Math.max(score0, prevTotal);
-                if (accum > indicatorComparatorScore * indicatorThreshold &&
-                    indicatorComparatorScore > MINIMUM_INTERBASE_INDICATOR_READ_DEPTH) {
-                    ctx.fillStyle = colorForBase[maxBase];
-                    ctx.beginPath();
-                    const l = leftPx + extraHorizontallyFlippedOffset;
-                    ctx.moveTo(l - INTERBASE_INDICATOR_WIDTH / 2, 0);
-                    ctx.lineTo(l + INTERBASE_INDICATOR_WIDTH / 2, 0);
-                    ctx.lineTo(l, INTERBASE_INDICATOR_HEIGHT);
-                    ctx.fill();
-                }
-            }
-            prevTotal = score0;
-        }
-        if (drawArcs) {
-            for (const f of feats) {
-                if (f.get('type') !== 'skip') {
-                    continue;
-                }
-                const s = f.get('start');
-                const e = f.get('end');
-                const [left, right] = bpSpanPx(s, e, region, bpPerPx);
-                ctx.beginPath();
-                const effectiveStrand = f.get('effectiveStrand');
-                const pos = 'rgba(255,200,200,0.7)';
-                const neg = 'rgba(200,200,255,0.7)';
-                const neutral = 'rgba(200,200,200,0.7)';
-                if (effectiveStrand === 1) {
-                    ctx.strokeStyle = pos;
-                }
-                else if (effectiveStrand === -1) {
-                    ctx.strokeStyle = neg;
-                }
-                else {
-                    ctx.strokeStyle = neutral;
-                }
-                ctx.lineWidth = Math.log(f.get('score') + 1);
-                ctx.moveTo(left, height - offset * 2);
-                ctx.bezierCurveTo(left, 0, right, 0, right, height - offset * 2);
-                ctx.stroke();
-            }
-        }
-        if (displayCrossHatches) {
-            ctx.lineWidth = 1;
-            ctx.strokeStyle = 'rgba(140,140,140,0.8)';
-            for (const tick of ticks.values) {
-                ctx.beginPath();
-                ctx.moveTo(0, Math.round(toY(tick)));
-                ctx.lineTo(width, Math.round(toY(tick)));
-                ctx.stroke();
-            }
-        }
+        const { makeImage } = await import('./makeImage');
+        await makeImage(ctx, props);
         return undefined;
     }
 }

package/esm/SNPCoverageRenderer/configSchema.d.ts

@@ -1,40 +1,25 @@
 declare const SNPCoverageRenderer: import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaType<{
-    /**
-     * #slot
-     */
     clipColor: {
         type: string;
         description: string;
         defaultValue: string;
     };
-    /**
-     * #slot
-     */
     indicatorThreshold: {
         type: string;
         description: string;
         defaultValue: number;
     };
-    /**
-     * #slot
-     */
-    drawArcs: {
+    showArcs: {
         type: string;
         description: string;
         defaultValue: boolean;
     };
-    /**
-     * #slot
-     */
-    drawInterbaseCounts: {
+    showInterbaseCounts: {
         type: string;
         description: string;
         defaultValue: boolean;
     };
-    /**
-     * #slot
-     */
-    drawIndicators: {
+    showInterbaseIndicators: {
         type: string;
         description: string;
         defaultValue: boolean;

package/esm/SNPCoverageRenderer/configSchema.js

@@ -1,45 +1,27 @@
 import { ConfigurationSchema } from '@jbrowse/core/configuration';
-/**
- * #config SNPCoverageRenderer
- */
-function x() { } // eslint-disable-line @typescript-eslint/no-unused-vars
+function x() { }
 const SNPCoverageRenderer = ConfigurationSchema('SNPCoverageRenderer', {
-    /**
-     * #slot
-     */
     clipColor: {
         type: 'color',
         description: 'the color of the clipping marker',
         defaultValue: 'red',
     },
-    /**
-     * #slot
-     */
     indicatorThreshold: {
         type: 'number',
         description: 'the proportion of reads containing a insertion/clip indicator',
         defaultValue: 0.4,
     },
-    /**
-     * #slot
-     */
-    drawArcs: {
+    showArcs: {
         type: 'boolean',
         description: 'Draw sashimi-style arcs for intron features',
         defaultValue: true,
     },
-    /**
-     * #slot
-     */
-    drawInterbaseCounts: {
+    showInterbaseCounts: {
         type: 'boolean',
         description: 'draw count "upsidedown histogram" of the interbase events that don\'t contribute to the coverage count so are not drawn in the normal histogram',
         defaultValue: true,
     },
-    /**
-     * #slot
-     */
-    drawIndicators: {
+    showInterbaseIndicators: {
         type: 'boolean',
         description: 'draw a triangular indicator where an event has been detected',
         defaultValue: true,

package/esm/SNPCoverageRenderer/index.d.ts

@@ -1,2 +1,2 @@
-import PluginManager from '@jbrowse/core/PluginManager';
+import type PluginManager from '@jbrowse/core/PluginManager';
 export default function register(pluginManager: PluginManager): void;

package/esm/SNPCoverageRenderer/index.js

@@ -1,6 +1,6 @@
-import configSchema from './configSchema';
-import SNPCoverageRenderer from './SNPCoverageRenderer';
 import { WiggleRendering } from '@jbrowse/plugin-wiggle';
+import SNPCoverageRenderer from './SNPCoverageRenderer';
+import configSchema from './configSchema';
 export default function register(pluginManager) {
     pluginManager.addRendererType(() => new SNPCoverageRenderer({
         name: 'SNPCoverageRenderer',

package/esm/SNPCoverageRenderer/makeImage.d.ts

@@ -0,0 +1,2 @@
+import type { RenderArgsDeserializedWithFeatures } from './types';
+export declare function makeImage(ctx: CanvasRenderingContext2D, props: RenderArgsDeserializedWithFeatures): Promise<void>;