@jbrowse/plugin-data-management 2.8.0 → 2.10.0

package/dist/HierarchicalTrackSelectorWidget/model.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const mobx_state_tree_1 = require("mobx-state-tree");
+const mobx_1 = require("mobx");
 const configuration_1 = require("@jbrowse/core/configuration");
 const util_1 = require("@jbrowse/core/util");
 const mst_1 = require("@jbrowse/core/util/types/mst");
@@ -8,6 +9,23 @@ const mst_1 = require("@jbrowse/core/util/types/mst");
 const filterTracks_1 = require("./filterTracks");
 const generateHierarchy_1 = require("./generateHierarchy");
 const util_2 = require("./util");
+const facetedModel_1 = require("./facetedModel");
+// for settings that are config dependent
+function postNoConfigF() {
+    return typeof window !== undefined
+        ? [window.location.host, window.location.pathname].join('-')
+        : 'empty';
+}
+// for settings that are not config dependent
+function postF() {
+    return typeof window !== undefined
+        ? [
+            postNoConfigF(),
+            new URLSearchParams(window.location.search).get('config'),
+        ].join('-')
+        : 'empty';
+}
+const MAX_RECENTLY_USED = 10;
 /**
  * #stateModel HierarchicalTrackSelectorWidget
  */
@@ -42,10 +60,38 @@ function stateTreeFactory(pluginManager) {
          * #property
          */
         view: mobx_state_tree_1.types.safeReference(pluginManager.pluggableMstType('view', 'stateModel')),
+        /**
+         * #property
+         */
+        faceted: mobx_state_tree_1.types.optional((0, facetedModel_1.facetedStateTreeF)(), {}),
     })
         .volatile(() => ({
+        favorites: [],
+        recentlyUsed: [],
         selection: [],
         filterText: '',
+        recentlyUsedCounter: 0,
+        favoritesCounter: 0,
+    }))
+        .views(self => ({
+        /**
+         * #getter
+         */
+        get selectionSet() {
+            return new Set(self.selection);
+        },
+        /**
+         * #getter
+         */
+        get favoritesSet() {
+            return new Set(self.favorites);
+        },
+        /**
+         * #getter
+         */
+        get recentlyUsedSet() {
+            return new Set(self.recentlyUsed);
+        },
     }))
         .actions(self => ({
         /**
@@ -76,7 +122,8 @@ function stateTreeFactory(pluginManager) {
          * #action
          */
         removeFromSelection(elt) {
-            self.selection = self.selection.filter(f => !elt.includes(f));
+            const s = new Set(elt);
+            self.selection = self.selection.filter(f => !s.has(f));
         },
         /**
          * #action
@@ -84,6 +131,67 @@ function stateTreeFactory(pluginManager) {
         clearSelection() {
             self.selection = [];
         },
+        /**
+         * #action
+         */
+        addToFavorites(trackId) {
+            self.favoritesCounter += 1;
+            self.favorites = [...self.favorites, trackId];
+        },
+        /**
+         * #action
+         */
+        removeFromFavorites(trackId) {
+            self.favorites = self.favorites.filter(f => f !== trackId);
+        },
+        /**
+         * #action
+         */
+        clearFavorites() {
+            self.favorites = [];
+        },
+        /**
+         * #action
+         */
+        setRecentlyUsedCounter(val) {
+            self.recentlyUsedCounter = val;
+        },
+        /**
+         * #action
+         */
+        setRecentlyUsed(str) {
+            self.recentlyUsed = str;
+        },
+        /**
+         * #action
+         */
+        setFavorites(str) {
+            self.favorites = str;
+        },
+        /**
+         * #action
+         */
+        setFavoritesCounter(val) {
+            self.favoritesCounter = val;
+        },
+        /**
+         * #action
+         */
+        addToRecentlyUsed(id) {
+            if (!self.recentlyUsed.includes(id)) {
+                self.recentlyUsedCounter = Math.min(self.recentlyUsedCounter + 1, MAX_RECENTLY_USED);
+                self.recentlyUsed =
+                    self.recentlyUsed.length >= MAX_RECENTLY_USED
+                        ? [...self.recentlyUsed.slice(1), id]
+                        : [...self.recentlyUsed, id];
+            }
+        },
+        /**
+         * #action
+         */
+        clearRecentlyUsed() {
+            self.recentlyUsed = [];
+        },
         /**
          * #action
          */
@@ -122,6 +230,24 @@ function stateTreeFactory(pluginManager) {
         },
     }))
         .views(self => ({
+        /**
+         * #method
+         */
+        isSelected(track) {
+            return self.selectionSet.has(track);
+        },
+        /**
+         * #method
+         */
+        isFavorite(trackId) {
+            return self.favoritesSet.has(trackId);
+        },
+        /**
+         * #method
+         */
+        isRecentlyUsed(trackId) {
+            return self.recentlyUsedSet.has(trackId);
+        },
         /**
          * #method
          */
@@ -151,6 +277,22 @@ function stateTreeFactory(pluginManager) {
         },
     }))
         .views(self => ({
+        /**
+         * #getter
+         */
+        get recentlyUsedLocalStorageKey() {
+            return `recentlyUsedTracks-${[postF(), self.assemblyNames.join(',')]
+                .filter(f => !!f)
+                .join('-')}`;
+        },
+        /**
+         * #getter
+         */
+        get favoritesLocalStorageKey() {
+            // this has a extra } at the end because that's how it was initially
+            // released
+            return `favoriteTracks-${postF()}}`;
+        },
         /**
          * #getter
          */
@@ -165,47 +307,71 @@ function stateTreeFactory(pluginManager) {
             var _a;
             return ((_a = self.sortCategories) !== null && _a !== void 0 ? _a : (0, configuration_1.getConf)((0, util_1.getSession)(self), ['hierarchical', 'sort', 'categories']));
         },
-        /**
-         * #method
-         * filter out tracks that don't match the current display types
-         */
-        connectionTrackConfigurations(connection) {
-            return (0, filterTracks_1.filterTracks)(connection.tracks, self);
-        },
         /**
          * #getter
          * filter out tracks that don't match the current assembly/display types
          */
-        get trackConfigurations() {
+        get configAndSessionTrackConfigurations() {
             return [
                 ...self.assemblyNames.map(a => self.getRefSeqTrackConf(a)),
                 ...(0, filterTracks_1.filterTracks)((0, util_1.getSession)(self).tracks, self),
             ].filter(util_1.notEmpty);
         },
+        /**
+         * #getter
+         */
+        get allTrackConfigurations() {
+            const { connectionInstances = [] } = (0, util_1.getSession)(self);
+            return [
+                ...this.configAndSessionTrackConfigurations,
+                ...connectionInstances === null || connectionInstances === void 0 ? void 0 : connectionInstances.flatMap(c => c.tracks),
+            ];
+        },
+        /**
+         * #getter
+         */
+        get allTrackConfigurationTrackIdSet() {
+            return new Map(this.allTrackConfigurations.map(t => [t.trackId, t]));
+        },
     }))
         .views(self => ({
         /**
-         * #method
+         * #getter
+         * filters out tracks that are not in the favorites group
+         */
+        get favoriteTracks() {
+            return self.favorites
+                .filter(t => self.allTrackConfigurationTrackIdSet.has(t))
+                .map(t => self.allTrackConfigurationTrackIdSet.get(t));
+        },
+        /**
+         * #getter
+         * filters out tracks that are not in the recently used group
          */
-        connectionHierarchy(connection) {
-            return (0, generateHierarchy_1.generateHierarchy)({
-                model: self,
-                trackConfs: self.connectionTrackConfigurations(connection),
-                extra: connection.name,
-            });
+        get recentlyUsedTracks() {
+            return self.recentlyUsed
+                .filter(t => self.allTrackConfigurationTrackIdSet.has(t))
+                .map(t => self.allTrackConfigurationTrackIdSet.get(t));
         },
     }))
         .views(self => ({
+        /**
+         * #getter
+         */
         get allTracks() {
             const { connectionInstances = [] } = (0, util_1.getSession)(self);
             return [
                 {
                     group: 'Tracks',
-                    tracks: self.trackConfigurations,
+                    tracks: self.configAndSessionTrackConfigurations,
+                    noCategories: false,
+                    menuItems: [],
                 },
                 ...connectionInstances.flatMap(c => ({
                     group: (0, configuration_1.getConf)(c, 'name'),
                     tracks: c.tracks,
+                    noCategories: false,
+                    menuItems: [],
                 })),
             ];
         },
@@ -218,17 +384,21 @@ function stateTreeFactory(pluginManager) {
             return {
                 name: 'Root',
                 id: 'Root',
-                children: self.allTracks
-                    .map(s => ({
+                isOpenByDefault: true,
+                type: 'category',
+                children: self.allTracks.map(s => ({
                     name: s.group,
                     id: s.group,
+                    type: 'category',
+                    isOpenByDefault: !self.collapsed.get(s.group),
+                    menuItems: s.menuItems,
                     children: (0, generateHierarchy_1.generateHierarchy)({
                         model: self,
                         trackConfs: s.tracks,
+                        extra: s.group,
+                        noCategories: s.noCategories,
                     }),
-                }))
-                    // always keep the Tracks entry at idx 0
-                    .filter((f, idx) => idx === 0 || !!f.children.length),
+                })),
             };
         },
     }))
@@ -288,9 +458,26 @@ function stateTreeFactory(pluginManager) {
         },
     }))
         .views(self => ({
+        /**
+         * #getter
+         */
         get hasAnySubcategories() {
             return self.allTracks.some(group => group.tracks.some(t => { var _a; return ((_a = (0, configuration_1.readConfObject)(t, 'category')) === null || _a === void 0 ? void 0 : _a.length) > 1; }));
         },
+    }))
+        .actions(self => ({
+        afterAttach() {
+            // this should be the first autorun to properly initialize
+            (0, mobx_state_tree_1.addDisposer)(self, (0, mobx_1.autorun)(() => {
+                self.setRecentlyUsed(JSON.parse((0, util_1.localStorageGetItem)(self.recentlyUsedLocalStorageKey) || '[]'));
+                self.setFavorites(JSON.parse((0, util_1.localStorageGetItem)(self.favoritesLocalStorageKey) || '[]'));
+            }));
+            // this should be the second autorun
+            (0, mobx_state_tree_1.addDisposer)(self, (0, mobx_1.autorun)(() => {
+                (0, util_1.localStorageSetItem)(self.favoritesLocalStorageKey, JSON.stringify(self.favorites));
+                (0, util_1.localStorageSetItem)(self.recentlyUsedLocalStorageKey, JSON.stringify(self.recentlyUsed));
+            }));
+        },
     }));
 }
 exports.default = stateTreeFactory;

package/dist/ucsc-trackhub/doConnect.d.ts

@@ -0,0 +1 @@
+export declare function doConnect(self: any): Promise<void>;

package/dist/ucsc-trackhub/doConnect.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.doConnect = void 0;
+const ucsc_hub_1 = require("@gmod/ucsc-hub");
+const ucscTrackHub_1 = require("./ucscTrackHub");
+const configuration_1 = require("@jbrowse/core/configuration");
+const util_1 = require("@jbrowse/core/util");
+const io_1 = require("@jbrowse/core/util/io");
+const nanoid_1 = require("@jbrowse/core/util/nanoid");
+function resolve(uri, baseUri) {
+    return new URL(uri, baseUri).href;
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+async function doConnect(self) {
+    var _a;
+    const session = (0, util_1.getSession)(self);
+    const notLoadedAssemblies = [];
+    try {
+        const hubFileLocation = (0, configuration_1.getConf)(self, 'hubTxtLocation');
+        const hubFileText = await (0, io_1.openLocation)(hubFileLocation).readFile('utf8');
+        // @ts-expect-error
+        const hubUri = resolve(hubFileLocation.uri, hubFileLocation.baseUri);
+        const { assemblyManager } = session;
+        if (hubFileText.includes('useOneFile on')) {
+            const hub = new ucsc_hub_1.SingleFileHub(hubFileText);
+            const { genome, tracks } = hub;
+            const genomeName = genome.name;
+            const asm = assemblyManager.get(genomeName);
+            if (!asm) {
+                // @ts-expect-error
+                session.addSessionAssembly({
+                    name: genomeName,
+                    sequence: {
+                        type: 'ReferenceSequenceTrack',
+                        trackId: `${genomeName}-${(0, nanoid_1.nanoid)()}`,
+                        adapter: {
+                            type: 'TwoBitAdapter',
+                            twoBitLocation: {
+                                uri: resolve(genome.data.twoBitPath, hubUri),
+                            },
+                            chromSizesLocation: {
+                                uri: resolve(genome.data.chromSizes, hubUri),
+                            },
+                        },
+                    },
+                });
+            }
+            const asm2 = assemblyManager.get(genomeName);
+            const sequenceAdapter = (0, configuration_1.getConf)(asm2, ['sequence', 'adapter']);
+            const tracksNew = (0, ucscTrackHub_1.generateTracks)({
+                trackDb: tracks,
+                trackDbLoc: hubFileLocation,
+                assemblyName: genomeName,
+                sequenceAdapter,
+            });
+            self.addTrackConfs(tracksNew);
+        }
+        else {
+            const hubFile = new ucsc_hub_1.HubFile(hubFileText);
+            const genomeFile = hubFile.data.genomesFile;
+            if (!genomeFile) {
+                throw new Error('genomesFile not found on hub');
+            }
+            // @ts-expect-error
+            const hubUri = resolve(hubFileLocation.uri, hubFileLocation.baseUri);
+            const genomesFileLocation = hubUri
+                ? {
+                    uri: resolve(genomeFile, hubUri),
+                    locationType: 'UriLocation',
+                }
+                : {
+                    localPath: genomeFile,
+                    locationType: 'LocalPathLocation',
+                };
+            const genomesFile = await (0, ucscTrackHub_1.fetchGenomesFile)(genomesFileLocation);
+            const map = {};
+            for (const [genomeName, genome] of Object.entries(genomesFile.data)) {
+                const assemblyNames = (0, configuration_1.getConf)(self, 'assemblyNames');
+                if (assemblyNames.length > 0 && !assemblyNames.includes(genomeName)) {
+                    continue;
+                }
+                const asm = assemblyManager.get(genomeName);
+                if (!asm) {
+                    notLoadedAssemblies.push(genomeName);
+                    continue;
+                }
+                // @ts-expect-error
+                const db = genome.data.trackDb;
+                if (!db) {
+                    throw new Error('genomesFile not found on hub');
+                }
+                const base = new URL(genomeFile, hubUri);
+                const loc = hubUri
+                    ? {
+                        uri: new URL(db, base).href,
+                        locationType: 'UriLocation',
+                    }
+                    : {
+                        localPath: db,
+                        locationType: 'LocalPathLocation',
+                    };
+                const trackDb = await (0, ucscTrackHub_1.fetchTrackDbFile)(loc);
+                const sequenceAdapter = (0, configuration_1.getConf)(asm, ['sequence', 'adapter']);
+                const tracks = (0, ucscTrackHub_1.generateTracks)({
+                    trackDb,
+                    trackDbLoc: loc,
+                    assemblyName: genomeName,
+                    sequenceAdapter,
+                });
+                self.addTrackConfs(tracks);
+                map[genomeName] = tracks.length;
+            }
+            const loadedAssemblies = Object.entries(map);
+            const str1 = loadedAssemblies.length
+                ? `Loaded data from these assemblies: ${loadedAssemblies
+                    .map(([key, val]) => `${key} (${val} tracks)`)
+                    .join(', ')}`
+                : '';
+            const str2 = notLoadedAssemblies.length
+                ? `Skipped data from these assemblies: ${notLoadedAssemblies.join(', ')}`
+                : '';
+            session.notify([str1, str2].filter(f => !!f).join('. '), 'success');
+        }
+    }
+    catch (e) {
+        console.error(e);
+        session.notify(`${(0, configuration_1.getConf)(self, 'name')}: "${e}"`, 'error');
+        (_a = session.breakConnection) === null || _a === void 0 ? void 0 : _a.call(session, self.configuration);
+    }
+}
+exports.doConnect = doConnect;

package/dist/ucsc-trackhub/model.d.ts

@@ -1,4 +1,8 @@
 import PluginManager from '@jbrowse/core/PluginManager';
+/**
+ * #stateModel UCSCTrackHubConnection
+ * extends BaseConnectionModel
+ */
 export default function UCSCTrackHubConnection(pluginManager: PluginManager): import("mobx-state-tree").IModelType<{
     name: import("mobx-state-tree").ISimpleType<string>;
     tracks: import("mobx-state-tree").IArrayType<import("mobx-state-tree").IAnyModelType>;
@@ -10,11 +14,16 @@ export default function UCSCTrackHubConnection(pluginManager: PluginManager): im
         };
         assemblyNames: {
             type: string;
-            defaultValue: never[];
+            defaultValue: never[]; /**
+             * #action
+             */
             description: string;
         };
     }, import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaOptions<undefined, "connectionId">>;
 } & {
+    /**
+     * #property
+     */
     configuration: import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaType<{
         hubTxtLocation: {
             type: string;
@@ -25,7 +34,9 @@ export default function UCSCTrackHubConnection(pluginManager: PluginManager): im
             description: string;
         };
         assemblyNames: {
-            type: string;
+            type: string; /**
+             * #property
+             */
             defaultValue: never[];
             description: string;
         };
@@ -41,6 +52,9 @@ export default function UCSCTrackHubConnection(pluginManager: PluginManager): im
             description: string;
         };
     }, import("@jbrowse/core/configuration/configurationSchema").ConfigurationSchemaOptions<undefined, "connectionId">>, undefined>>;
+    /**
+     * #property
+     */
     type: import("mobx-state-tree").ISimpleType<"UCSCTrackHubConnection">;
 }, {
     connect(_arg: {
@@ -67,5 +81,8 @@ export default function UCSCTrackHubConnection(pluginManager: PluginManager): im
     } & import("mobx-state-tree").IStateTreeNode<import("@jbrowse/core/configuration").AnyConfigurationSchemaType>)[]): import("mobx-state-tree").IMSTArray<import("mobx-state-tree").IAnyModelType> & import("mobx-state-tree").IStateTreeNode<import("mobx-state-tree").IArrayType<import("mobx-state-tree").IAnyModelType>>;
     clear(): void;
 } & {
+    /**
+     * #action
+     */
     connect(): Promise<void>;
 }, import("mobx-state-tree")._NotCustomized, import("mobx-state-tree")._NotCustomized>;

package/dist/ucsc-trackhub/model.js

@@ -28,88 +28,33 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 const models_1 = require("@jbrowse/core/pluggableElementTypes/models");
 const configuration_1 = require("@jbrowse/core/configuration");
-const util_1 = require("@jbrowse/core/util");
 const mobx_state_tree_1 = require("mobx-state-tree");
 // locals
 const configSchema_1 = __importDefault(require("./configSchema"));
+/**
+ * #stateModel UCSCTrackHubConnection
+ * extends BaseConnectionModel
+ */
 function UCSCTrackHubConnection(pluginManager) {
     return mobx_state_tree_1.types
         .compose('UCSCTrackHubConnection', (0, models_1.BaseConnectionModelFactory)(pluginManager), mobx_state_tree_1.types.model({
+        /**
+         * #property
+         */
         configuration: (0, configuration_1.ConfigurationReference)(configSchema_1.default),
+        /**
+         * #property
+         */
         type: mobx_state_tree_1.types.literal('UCSCTrackHubConnection'),
     }))
         .actions(self => ({
+        /**
+         * #action
+         */
         async connect() {
-            var _a, _b;
-            const session = (0, util_1.getSession)(self);
-            const notLoadedAssemblies = [];
-            try {
-                const hubFileLocation = (0, configuration_1.getConf)(self, 'hubTxtLocation');
-                const { generateTracks, fetchGenomesFile, fetchTrackDbFile, fetchHubFile, } = await Promise.resolve().then(() => __importStar(require('./ucscTrackHub')));
-                const hubFile = await fetchHubFile(hubFileLocation);
-                const genomeFile = hubFile.get('genomesFile');
-                if (!genomeFile) {
-                    throw new Error('genomesFile not found on hub');
-                }
-                const hubUri = new URL(hubFileLocation.uri, hubFileLocation.baseUri);
-                const genomesFileLocation = hubUri
-                    ? {
-                        uri: new URL(genomeFile, hubUri).href,
-                        locationType: 'UriLocation',
-                    }
-                    : {
-                        localPath: genomeFile,
-                        locationType: 'LocalPathLocation',
-                    };
-                const genomesFile = await fetchGenomesFile(genomesFileLocation);
-                const map = {};
-                for (const [genomeName, genome] of genomesFile) {
-                    const assemblyNames = (0, configuration_1.getConf)(self, 'assemblyNames');
-                    if (assemblyNames.length > 0 &&
-                        !assemblyNames.includes(genomeName)) {
-                        continue;
-                    }
-                    const conf = (_a = session.assemblyManager.get(genomeName)) === null || _a === void 0 ? void 0 : _a.configuration;
-                    if (!conf) {
-                        notLoadedAssemblies.push(genomeName);
-                        continue;
-                    }
-                    const db = genome.get('trackDb');
-                    if (!db) {
-                        throw new Error('genomesFile not found on hub');
-                    }
-                    const base = new URL(genomeFile, hubUri);
-                    const loc = hubUri
-                        ? {
-                            uri: new URL(db, base).href,
-                            locationType: 'UriLocation',
-                        }
-                        : {
-                            localPath: db,
-                            locationType: 'LocalPathLocation',
-                        };
-                    const trackDb = await fetchTrackDbFile(loc);
-                    const seqAdapter = (0, configuration_1.readConfObject)(conf, ['sequence', 'adapter']);
-                    const tracks = generateTracks(trackDb, loc, genomeName, seqAdapter);
-                    self.addTrackConfs(tracks);
-                    map[genomeName] = tracks.length;
-                }
-                const loadedAssemblies = Object.entries(map);
-                const str1 = loadedAssemblies.length
-                    ? `Loaded data from these assemblies: ${loadedAssemblies
-                        .map(([key, val]) => `${key} (${val} tracks)`)
-                        .join(', ')}`
-                    : '';
-                const str2 = notLoadedAssemblies.length
-                    ? `Skipped data from these assemblies: ${notLoadedAssemblies.join(', ')}`
-                    : '';
-                session.notify([str1, str2].filter(f => !!f).join('. '), 'success');
-            }
-            catch (e) {
-                console.error(e);
-                session.notify(`There was a problem connecting to the UCSC Track Hub "${self.configuration.name}". Please make sure you have entered a valid hub.txt file. The error that was thrown is: "${e}"`, 'error');
-                (_b = session.breakConnection) === null || _b === void 0 ? void 0 : _b.call(session, self.configuration);
-            }
+            const { doConnect } = await Promise.resolve().then(() => __importStar(require('./doConnect')));
+            // eslint-disable-next-line @typescript-eslint/no-floating-promises
+            doConnect(self);
         },
     }));
 }