@jbrowse/core 2.17.0 → 3.0.0

package/util/simpleFeature.js

@@ -10,16 +10,7 @@ function isFeature(thing) {
 function isSimpleFeatureSerialized(args) {
     return 'uniqueId' in args && typeof args.data !== 'object';
 }
-/**
- * Simple implementation of a feature object.
- */
 class SimpleFeature {
-    /**
-     * @param args - SimpleFeature args
-     *
-     * Note: args.data.subfeatures can be an array of these same args,
-     * which will be inflated to more instances of this class.
-     */
     constructor(args) {
         var _a;
         if (isSimpleFeatureSerialized(args)) {
@@ -27,16 +18,9 @@ class SimpleFeature {
         }
         else {
             this.data = args.data;
-            // load handle from args.parent (not args.data.parent) this reason is
-            // because if args is an object, it likely isn't properly loaded with
-            // parent as a Feature reference (probably a raw parent ID or something
-            // instead)
             this.parentHandle = args.parent;
         }
-        // the feature id comes from args.id, args.data.uniqueId, or args.uniqueId
-        // due to this initialization
         const id = isSimpleFeatureSerialized(args) ? args.uniqueId : args.id;
-        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
         if (id === undefined || id === null) {
             throw new Error('SimpleFeature requires a unique `id` or `data.uniqueId` attribute');
         }
@@ -57,10 +41,6 @@ class SimpleFeature {
                 : f);
         }
     }
-    /**
-     * Get a piece of data about the feature.  All features must have
-     * 'start' and 'end', but everything else is optional.
-     */
     get(name) {
         return name === 'subfeatures'
             ? this.subfeatures
@@ -68,33 +48,18 @@ class SimpleFeature {
                 ? this.parent()
                 : this.data[name];
     }
-    /**
-     * Set an item of data.
-     */
     set(name, val) {
         this.data[name] = val;
     }
-    /**
-     * Get an array listing which data keys are present in this feature.
-     */
     tags() {
         return Object.keys(this.data);
     }
-    /**
-     * Get the unique ID of this feature.
-     */
     id() {
         return this.uniqueId;
     }
-    /**
-     * Get this feature's parent feature, or undefined if none.
-     */
     parent() {
         return this.parentHandle;
     }
-    /**
-     * Get an array of child features, or undefined if none.
-     */
     children() {
         return this.get('subfeatures');
     }

package/util/stats.d.ts

@@ -1,6 +1,6 @@
-import { Observable } from 'rxjs';
-import { NoAssemblyRegion } from './types';
-import { Feature } from './simpleFeature';
+import type { Feature } from './simpleFeature';
+import type { NoAssemblyRegion } from './types';
+import type { Observable } from 'rxjs';
 export interface UnrectifiedQuantitativeStats {
     scoreMin: number;
     scoreMax: number;
@@ -15,30 +15,7 @@ export interface QuantitativeStats extends UnrectifiedQuantitativeStats {
     scoreMean: number;
     scoreStdDev: number;
 }
-/**
- * calculate standard deviation using the 'shortcut method' that accepts
- * the sum and the sum squares of the elements
- *
- * @param sum - sum(i, 1..n)
- * @param sumSquares - sum(i^2, 1..n)
- * @param n - number of elements
- * @param population - boolean: use population instead of sample correction
- * @returns - the estimated std deviation
- */
 export declare function calcStdFromSums(sum: number, sumSquares: number, n: number, population?: boolean): number;
-/**
- * @param stats - a summary stats object with scoreSum, featureCount,
- * scoreSumSquares, and basesCovered
- * @returns - a summary stats object with
- * scoreMean, scoreStdDev, and featureDensity added
- */
 export declare function rectifyStats(s: UnrectifiedQuantitativeStats): QuantitativeStats;
-/**
- * transform a list of scores to summary statistics
- *
- * @param region - object with start, end
- * @param features - array of features which are possibly summary features
- * @returns - object with scoreMax, scoreMin, scoreSum, scoreSumSquares, etc
- */
 export declare function scoresToStats(region: NoAssemblyRegion, feats: Observable<Feature>): Promise<QuantitativeStats>;
 export declare function blankStats(): QuantitativeStats;

package/util/stats.js

@@ -6,16 +6,6 @@ exports.scoresToStats = scoresToStats;
 exports.blankStats = blankStats;
 const rxjs_1 = require("rxjs");
 const operators_1 = require("rxjs/operators");
-/**
- * calculate standard deviation using the 'shortcut method' that accepts
- * the sum and the sum squares of the elements
- *
- * @param sum - sum(i, 1..n)
- * @param sumSquares - sum(i^2, 1..n)
- * @param n - number of elements
- * @param population - boolean: use population instead of sample correction
- * @returns - the estimated std deviation
- */
 function calcStdFromSums(sum, sumSquares, n, population = false) {
     if (n === 0) {
         return 0;
@@ -25,7 +15,6 @@ function calcStdFromSums(sum, sumSquares, n, population = false) {
         variance = sumSquares / n - (sum * sum) / (n * n);
     }
     else {
-        // sample correction is n-1
         variance = sumSquares - (sum * sum) / n;
         if (n > 1) {
             variance /= n - 1;
@@ -33,12 +22,6 @@ function calcStdFromSums(sum, sumSquares, n, population = false) {
     }
     return variance < 0 ? 0 : Math.sqrt(variance);
 }
-/**
- * @param stats - a summary stats object with scoreSum, featureCount,
- * scoreSumSquares, and basesCovered
- * @returns - a summary stats object with
- * scoreMean, scoreStdDev, and featureDensity added
- */
 function rectifyStats(s) {
     return {
         ...s,
@@ -47,13 +30,6 @@ function rectifyStats(s) {
         featureDensity: (s.featureCount || 1) / s.basesCovered,
     };
 }
-/**
- * transform a list of scores to summary statistics
- *
- * @param region - object with start, end
- * @param features - array of features which are possibly summary features
- * @returns - object with scoreMax, scoreMin, scoreSum, scoreSumSquares, etc
- */
 async function scoresToStats(region, feats) {
     const { start, end } = region;
     const seed = {
@@ -76,7 +52,6 @@ async function scoresToStats(region, feats) {
         found = true;
         return acc;
     }, seed)));
-    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
     return found
         ? rectifyStats({
             scoreMax,

package/util/stopToken.d.ts

@@ -0,0 +1,3 @@
+export declare function createStopToken(): string;
+export declare function stopStopToken(stopToken: string): void;
+export declare function checkStopToken(stopToken?: string): void;

package/util/stopToken.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createStopToken = createStopToken;
+exports.stopStopToken = stopStopToken;
+exports.checkStopToken = checkStopToken;
+function isWebWorker() {
+    return (typeof WorkerGlobalScope !== 'undefined' &&
+        self instanceof WorkerGlobalScope);
+}
+function createStopToken() {
+    var _a;
+    return ((_a = URL.createObjectURL) === null || _a === void 0 ? void 0 : _a.call(URL, new Blob())) || `${Math.random()}`;
+}
+function stopStopToken(stopToken) {
+    var _a;
+    (_a = URL.revokeObjectURL) === null || _a === void 0 ? void 0 : _a.call(URL, stopToken);
+}
+function checkStopToken(stopToken) {
+    if (typeof jest === 'undefined' && stopToken !== undefined && isWebWorker()) {
+        const xhr = new XMLHttpRequest();
+        xhr.open('GET', stopToken, false);
+        try {
+            xhr.send(null);
+        }
+        catch (e) {
+            throw new Error('aborted');
+        }
+    }
+}

package/util/tracks.d.ts

@@ -1,20 +1,11 @@
-import { IAnyStateTreeNode } from 'mobx-state-tree';
-import { PreFileLocation, FileLocation } from './types';
-import { AnyConfigurationModel } from '../configuration';
+import type { FileLocation, PreFileLocation } from './types';
+import type { AnyConfigurationModel } from '../configuration';
+import type { IAnyStateTreeNode } from 'mobx-state-tree';
 export declare function getTrackAssemblyNames(track: IAnyStateTreeNode & {
     configuration: AnyConfigurationModel;
 }): string[];
 export declare function getConfAssemblyNames(conf: AnyConfigurationModel): string[];
-/**
- * return the rpcSessionId of the highest parent node in the tree that has an
- * rpcSessionId */
 export declare function getRpcSessionId(thisNode: IAnyStateTreeNode): string;
-/**
- * given an MST node, get the renderprops of the first parent container that
- * has renderProps
- * @param node -
- * @returns renderprops, or empty object if none found
- */
 export declare function getParentRenderProps(node: IAnyStateTreeNode): any;
 export declare const UNKNOWN = "UNKNOWN";
 export declare const UNSUPPORTED = "UNSUPPORTED";
@@ -26,12 +17,6 @@ export declare function storeBlobLocation(location: PreFileLocation): import("./
     blobId: string;
     locationType: string;
 };
-/**
- * creates a new location from the provided location including the appropriate suffix and location type
- * @param location - the FileLocation
- * @param suffix - the file suffix (e.g. .bam)
- * @returns the constructed location object from the provided parameters
- */
 export declare function makeIndex(location: FileLocation, suffix: string): import("./types").BlobLocation | {
     uri: string;
     locationType: string;
@@ -41,13 +26,6 @@ export declare function makeIndex(location: FileLocation, suffix: string): impor
     locationType: string;
     uri?: undefined;
 };
-/**
- * constructs a potential index file (with suffix) from the provided file name
- * @param name - the name of the index file
- * @param typeA - one option of a potential two file suffix (e.g. CSI, BAI)
- * @param typeB - the second option of a potential two file suffix (e.g. CSI, BAI)
- * @returns a likely name of the index file for a given filename
- */
 export declare function makeIndexType(name: string | undefined, typeA: string, typeB: string): string;
 export interface AdapterConfig {
     type: string;
@@ -65,7 +43,7 @@ export declare function generateUnsupportedTrackConf(trackName: string, trackUrl
     category: string[] | undefined;
     trackId: string;
 };
-export declare function generateUnknownTrackConf(trackName: string, trackUrl: string, categories: string[] | undefined): {
+export declare function generateUnknownTrackConf(trackName: string, trackUrl: string, categories?: string[]): {
     type: string;
     name: string;
     description: string;

package/util/tracks.js

@@ -20,14 +20,12 @@ exports.getTrackName = getTrackName;
 const mobx_state_tree_1 = require("mobx-state-tree");
 const index_1 = require("./index");
 const configuration_1 = require("../configuration");
-/* utility functions for use by track models and so forth */
 function getTrackAssemblyNames(track) {
     return getConfAssemblyNames(track.configuration);
 }
 function getConfAssemblyNames(conf) {
     const trackAssemblyNames = (0, configuration_1.readConfObject)(conf, 'assemblyNames');
     if (!trackAssemblyNames) {
-        // Check if it's an assembly sequence track
         const parent = (0, mobx_state_tree_1.getParent)(conf);
         if ('sequence' in parent) {
             return [(0, configuration_1.readConfObject)(parent, 'name')];
@@ -38,9 +36,6 @@ function getConfAssemblyNames(conf) {
     }
     return trackAssemblyNames;
 }
-/**
- * return the rpcSessionId of the highest parent node in the tree that has an
- * rpcSessionId */
 function getRpcSessionId(thisNode) {
     let highestRpcSessionId;
     for (let node = thisNode; !(0, mobx_state_tree_1.isRoot)(node); node = (0, mobx_state_tree_1.getParent)(node)) {
@@ -53,12 +48,6 @@ function getRpcSessionId(thisNode) {
     }
     return highestRpcSessionId;
 }
-/**
- * given an MST node, get the renderprops of the first parent container that
- * has renderProps
- * @param node -
- * @returns renderprops, or empty object if none found
- */
 function getParentRenderProps(node) {
     for (let currentNode = (0, mobx_state_tree_1.getParent)(node); !(0, mobx_state_tree_1.isRoot)(currentNode); currentNode = (0, mobx_state_tree_1.getParent)(currentNode)) {
         if ('renderProps' in currentNode) {
@@ -70,22 +59,16 @@ function getParentRenderProps(node) {
 exports.UNKNOWN = 'UNKNOWN';
 exports.UNSUPPORTED = 'UNSUPPORTED';
 let blobMap = {};
-// get a specific blob
 function getBlob(id) {
     return blobMap[id];
 }
-// used to export entire context to webworker
 function getBlobMap() {
     return blobMap;
 }
-// used in new contexts like webworkers
 function setBlobMap(map) {
     blobMap = map;
 }
 let counter = 0;
-// blob files are stored in a global map. the blobId is based on a combination
-// of timestamp plus counter to be unique across sessions and fast repeated
-// calls
 function storeBlobLocation(location) {
     if ('blob' in location) {
         const blobId = `b${+Date.now()}-${counter++}`;
@@ -94,31 +77,23 @@ function storeBlobLocation(location) {
     }
     return location;
 }
-/**
- * creates a new location from the provided location including the appropriate suffix and location type
- * @param location - the FileLocation
- * @param suffix - the file suffix (e.g. .bam)
- * @returns the constructed location object from the provided parameters
- */
 function makeIndex(location, suffix) {
     if ('uri' in location) {
-        return { uri: location.uri + suffix, locationType: 'UriLocation' };
+        return {
+            uri: location.uri + suffix,
+            locationType: 'UriLocation',
+        };
     }
-    if ('localPath' in location) {
+    else if ('localPath' in location) {
         return {
             localPath: location.localPath + suffix,
             locationType: 'LocalPathLocation',
         };
     }
-    return location;
+    else {
+        return location;
+    }
 }
-/**
- * constructs a potential index file (with suffix) from the provided file name
- * @param name - the name of the index file
- * @param typeA - one option of a potential two file suffix (e.g. CSI, BAI)
- * @param typeB - the second option of a potential two file suffix (e.g. CSI, BAI)
- * @returns a likely name of the index file for a given filename
- */
 function makeIndexType(name, typeA, typeB) {
     return (name === null || name === void 0 ? void 0 : name.toUpperCase().endsWith(typeA)) ? typeA : typeB;
 }

package/util/types/index.d.ts

@@ -1,17 +1,16 @@
-import React from 'react';
-import { Instance, SnapshotIn, IAnyStateTreeNode, IStateTreeNode, IType } from 'mobx-state-tree';
-import { ThemeOptions } from '@mui/material';
-import { AnyConfigurationModel } from '../../configuration';
-import TextSearchManager from '../../TextSearch/TextSearchManager';
-import { MenuItem } from '../../ui';
-import RpcManager from '../../rpc/RpcManager';
-import { Feature } from '../simpleFeature';
-import { BaseInternetAccountModel } from '../../pluggableElementTypes/models';
+import type React from 'react';
+import type { BlobLocation as MUBlobLocation, LocalPathLocation as MULocalPathLocation, NoAssemblyRegion as MUNoAssemblyRegion, Region as MUIRegion, UriLocation as MUUriLocation } from './mst';
+import type TextSearchManager from '../../TextSearch/TextSearchManager';
 import type assemblyManager from '../../assemblyManager';
-import type { NoAssemblyRegion as MUNoAssemblyRegion, Region as MUIRegion, LocalPathLocation as MULocalPathLocation, UriLocation as MUUriLocation, BlobLocation as MUBlobLocation } from './mst';
+import type { AnyConfigurationModel } from '../../configuration';
+import type { BaseInternetAccountModel } from '../../pluggableElementTypes/models';
+import type RpcManager from '../../rpc/RpcManager';
+import type { MenuItem } from '../../ui';
+import type { Feature } from '../simpleFeature';
+import type { ThemeOptions } from '@mui/material';
+import type { IAnyStateTreeNode, IStateTreeNode, IType, Instance, SnapshotIn } from 'mobx-state-tree';
 export * from './util';
-/** abstract type for a model that contains multiple views */
-export interface AbstractViewContainer extends IStateTreeNode<IType<any, unknown, any>> {
+export interface AbstractViewContainer extends IStateTreeNode<IType<any, any, any>> {
     views: AbstractViewModel[];
     removeView(view: AbstractViewModel): void;
     addView(typeName: string, initialState?: Record<string, unknown>): AbstractViewModel;
@@ -41,7 +40,6 @@ export interface JBrowsePlugin {
     image?: string;
 }
 export type DialogComponentType = React.LazyExoticComponent<React.FC<any>> | React.FC<any>;
-/** minimum interface that all session state models must implement */
 export interface AbstractSessionModel extends AbstractViewContainer {
     jbrowse: IAnyStateTreeNode;
     drawerPosition?: string;
@@ -97,17 +95,14 @@ export interface AbstractSessionModel extends AbstractViewContainer {
     tracks: AnyConfigurationModel[];
 }
 export declare function isSessionModel(thing: unknown): thing is AbstractSessionModel;
-/** abstract interface for a session allows editing configurations */
 export interface SessionWithConfigEditing extends AbstractSessionModel {
     editConfiguration(configuration: AnyConfigurationModel): void;
 }
-export declare function isSessionModelWithConfigEditing(thing: unknown): thing is SessionWithConfigEditing;
-/** abstract interface for a session allows adding tracks */
-export interface SessionWithConfigEditing extends AbstractSessionModel {
+export declare function isSessionModelWithConfigEditing(t: unknown): t is SessionWithConfigEditing;
+export interface SessionWithAddTracks extends AbstractSessionModel {
     addTrackConf(configuration: AnyConfigurationModel | SnapshotIn<AnyConfigurationModel>): void;
 }
-export declare function isSessionWithAddTracks(thing: unknown): thing is SessionWithConfigEditing;
-/** abstract interface for a session allows adding tracks */
+export declare function isSessionWithAddTracks(t: unknown): t is SessionWithAddTracks;
 export interface SessionWithShareURL extends AbstractSessionModel {
     shareURL: string;
 }
@@ -116,7 +111,6 @@ export interface Widget {
     type: string;
     id: string;
 }
-/** abstract interface for a session that manages widgets */
 export interface SessionWithWidgets extends AbstractSessionModel {
     minimized: boolean;
     visibleWidget?: Widget;
@@ -152,18 +146,15 @@ export interface SessionWithSessionPlugins extends AbstractSessionModel {
     removeSessionPlugin: Function;
 }
 export declare function isSessionWithSessionPlugins(thing: unknown): thing is SessionWithSessionPlugins;
-/** abstract interface for a session that manages a global selection */
 export interface SelectionContainer extends AbstractSessionModel {
     selection?: unknown;
     setSelection(thing: unknown): void;
 }
 export declare function isSelectionContainer(thing: unknown): thing is SelectionContainer;
-/** abstract interface for a session allows applying focus to views and widgets */
 export interface SessionWithFocusedViewAndDrawerWidgets extends SessionWithDrawerWidgets {
     focusedViewId: string | undefined;
     setFocusedViewId(id: string): void;
 }
-/** minimum interface that all view state models must implement */
 export interface AbstractViewModel {
     id: string;
     type: string;
@@ -194,7 +185,6 @@ export interface TrackViewModel extends AbstractViewModel {
     hideTrack(trackId: string): void;
 }
 export declare function isTrackViewModel(thing: unknown): thing is TrackViewModel;
-/** minimum interface for the root MST model of a JBrowse app */
 export interface AbstractRootModel {
     jbrowse: IAnyStateTreeNode;
     session?: AbstractSessionModel;
@@ -202,7 +192,6 @@ export interface AbstractRootModel {
     adminMode?: boolean;
     error?: unknown;
 }
-/** root model with more included for the heavier JBrowse web and desktop app */
 export interface AppRootModel extends AbstractRootModel {
     internetAccounts: BaseInternetAccountModel[];
     findAppropriateInternetAccount(location: UriLocation): BaseInternetAccountModel | undefined;
@@ -213,7 +202,6 @@ export interface RootModelWithInternetAccounts extends AbstractRootModel {
     findAppropriateInternetAccount(location: UriLocation): BaseInternetAccountModel | undefined;
 }
 export declare function isRootModelWithInternetAccounts(thing: unknown): thing is RootModelWithInternetAccounts;
-/** a root model that manages global menus */
 export interface AbstractMenuManager {
     appendMenu(menuName: string): void;
     insertMenu(menuName: string, position: number): number;
@@ -225,10 +213,6 @@ export interface AbstractMenuManager {
 export declare function isAbstractMenuManager(thing: unknown): thing is AbstractMenuManager;
 export interface NoAssemblyRegion extends SnapshotIn<typeof MUNoAssemblyRegion> {
 }
-/**
- * a description of a specific genomic region. assemblyName, refName, start,
- * end, and reversed
- */
 export interface Region extends SnapshotIn<typeof MUIRegion> {
 }
 export interface AugmentedRegion extends Region {

package/util/types/index.js

@@ -54,13 +54,11 @@ function isSessionModel(thing) {
         'rpcManager' in thing &&
         'configuration' in thing);
 }
-function isSessionModelWithConfigEditing(thing) {
-    return isSessionModel(thing) && 'editConfiguration' in thing;
+function isSessionModelWithConfigEditing(t) {
+    return isSessionModel(t) && 'editConfiguration' in t;
 }
-function isSessionWithAddTracks(thing) {
-    return (
-    // @ts-expect-error
-    isSessionModel(thing) && 'addTrackConf' in thing && !thing.disableAddTracks);
+function isSessionWithAddTracks(t) {
+    return (isSessionModel(t) && 'addTrackConf' in t && !t.disableAddTracks);
 }
 function isSessionWithShareURL(thing) {
     return isSessionModel(thing) && 'shareURL' in thing && !!thing.shareURL;
@@ -93,14 +91,12 @@ function isTrackModel(thing) {
     return (typeof thing === 'object' &&
         thing !== null &&
         'configuration' in thing &&
-        // @ts-expect-error
         thing.configuration.trackId);
 }
 function isDisplayModel(thing) {
     return (typeof thing === 'object' &&
         thing !== null &&
         'configuration' in thing &&
-        // @ts-expect-error
         thing.configuration.displayId);
 }
 function isTrackViewModel(thing) {
@@ -165,16 +161,11 @@ class RetryError extends Error {
 exports.RetryError = RetryError;
 function isAuthNeededException(exception) {
     return (exception instanceof Error &&
-        // DOMException
         (exception.name === 'AuthNeededError' ||
-            // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
             exception.url !== undefined));
 }
 function isRetryException(exception) {
-    return (
-    // DOMException
-    exception.name === 'RetryError' ||
-        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+    return (exception.name === 'RetryError' ||
         exception.internetAccountId !== undefined);
 }
 var TextSearchManager_1 = require("../../TextSearch/TextSearchManager");

package/util/types/mst.js

@@ -23,7 +23,6 @@ exports.LocalPathLocation = mobx_state_tree_1.types.model('LocalPathLocation', {
     locationType: mobx_state_tree_1.types.literal('LocalPathLocation'),
     localPath: mobx_state_tree_1.types.string,
 });
-// like how blobId is used to get a blob map
 exports.BlobLocation = mobx_state_tree_1.types.model('BlobLocation', {
     locationType: mobx_state_tree_1.types.literal('BlobLocation'),
     name: mobx_state_tree_1.types.string,
@@ -34,8 +33,6 @@ exports.UriLocationRaw = mobx_state_tree_1.types.model('UriLocation', {
     uri: mobx_state_tree_1.types.string,
     baseUri: mobx_state_tree_1.types.maybe(mobx_state_tree_1.types.string),
     internetAccountId: mobx_state_tree_1.types.maybe(mobx_state_tree_1.types.string),
-    // auths information (such as tokens) needed for using this resource.
-    // if provided, these must be completely sufficient for using it
     internetAccountPreAuthorization: mobx_state_tree_1.types.maybe(mobx_state_tree_1.types.model('InternetAccountPreAuthorization', {
         internetAccountType: mobx_state_tree_1.types.string,
         authInfo: mobx_state_tree_1.types.frozen(),
@@ -43,7 +40,6 @@ exports.UriLocationRaw = mobx_state_tree_1.types.model('UriLocation', {
 });
 exports.UriLocation = mobx_state_tree_1.types.snapshotProcessor(exports.UriLocationRaw, {
     postProcessor: snap => {
-        // xref https://github.com/mobxjs/mobx-state-tree/issues/1524 for Omit
         const { baseUri, ...rest } = snap;
         if (!baseUri) {
             return rest;
@@ -52,17 +48,12 @@ exports.UriLocation = mobx_state_tree_1.types.snapshotProcessor(exports.UriLocat
     },
 });
 exports.FileLocation = mobx_state_tree_1.types.snapshotProcessor(mobx_state_tree_1.types.union(exports.LocalPathLocation, exports.UriLocation, exports.BlobLocation), {
-    // @ts-expect-error
     preProcessor(snap) {
-        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
         if (!snap) {
             return undefined;
         }
-        // @ts-expect-error
-        // xref https://github.com/mobxjs/mobx-state-tree/issues/1524 for Omit
         const { locationType, ...rest } = snap;
         if (!locationType) {
-            // @ts-expect-error
             const { uri, localPath, blob } = rest;
             let locationType = '';
             if (uri !== undefined) {

package/util/types/util.d.ts

@@ -1,13 +1,6 @@
-import React from 'react';
-import PluginManager from '../../PluginManager';
-/**
- * Obtain the return type of a constructor function type.
- * Differs from core Typescript InstanceType in that it returns never if not matched.
- */
+import type React from 'react';
+import type PluginManager from '../../PluginManager';
 export type InstanceTypeRestrictive<CONSTRUCTOR extends new (...args: any[]) => any> = CONSTRUCTOR extends new (...args: any[]) => infer CLASS ? CLASS : never;
-/** extracts the class type from a factory function that returns a constructor */
 export type ClassReturnedBy<FACT extends (pm: PluginManager) => any> = InstanceTypeRestrictive<ReturnType<FACT>>;
-/** A react component with any props. Consider using something more specific if possible */
 export type AnyReactComponentType = React.ComponentType<any>;
-/** get the type that a predicate asserts */
 export type TypeTestedByPredicate<PREDICATE extends (thing: any) => boolean> = PREDICATE extends (thing: any) => thing is infer TYPE ? TYPE : never;

package/util/useMeasure.d.ts

@@ -1,4 +1,4 @@
-export default function useMeasure(): readonly [import("react").RefObject<HTMLDivElement>, {
+export default function useMeasure(): readonly [import("react").RefObject<HTMLDivElement | null>, {
     width?: number;
     height?: number;
 }];

package/util/useMeasure.js

@@ -25,7 +25,6 @@ function useMeasure() {
             });
         });
         observer.observe(ref.current);
-        // Callback fired when component is unmounted
         return () => {
             observer.disconnect();
         };

package/util/when.d.ts

@@ -1,15 +1 @@
-import { IWhenOptions } from 'mobx';
-interface WhenOpts extends IWhenOptions {
-    signal?: AbortSignal;
-}
-/**
- * Wrapper for mobx `when` that adds timeout and aborting support.
- */
-export declare function when(getter: () => boolean, { timeout, signal, name }?: WhenOpts): Promise<unknown>;
-/**
- * Wrapper for mobx `when` that makes a promise for the return value
- * of the given function at the point in time when it becomes not
- * undefined and not null.
- */
-export declare function whenPresent<FUNCTION extends () => unknown>(getter: FUNCTION, opts?: WhenOpts): Promise<NonNullable<ReturnType<FUNCTION>>>;
-export {};
+export { when } from 'mobx';