@jbrowse/plugin-linear-genome-view 4.3.0 → 5.0.0-beta.10

package/esm/displayKitTests/perRegionTestEnv.js

@@ -0,0 +1,142 @@
+import { ConfigurationReference, ConfigurationSchema, } from '@jbrowse/core/configuration';
+import { BaseDisplay } from '@jbrowse/core/pluggableElementTypes';
+import MultiRegionDisplayMixin from '@jbrowse/display-kit/MultiRegionDisplayMixin';
+import TrackHeightMixin from '@jbrowse/display-kit/TrackHeightMixin';
+import baseLinearDisplayConfigSchema from '@jbrowse/display-kit/configSchema';
+import { fetchEachRegion } from '@jbrowse/display-kit/fetchEachRegion';
+import { createDisplayTestEnvironment } from '@jbrowse/display-test-utils';
+import { types } from '@jbrowse/mobx-state-tree';
+import { stateModelFactory as linearGenomeViewStateModelFactory } from '../LinearGenomeView/index.js';
+const DISPLAY_NAME = 'PerRegionTestDisplay';
+// A fresh schema per environment, and the state model is handed the very
+// instance the harness registered — the pattern every other testEnv follows. A
+// module-level singleton shared across PluginManagers leaves the display's
+// `configuration` reference unresolvable, and the gate then reads every slot as
+// undefined rather than erroring.
+function makeConfigSchema() {
+    return ConfigurationSchema(DISPLAY_NAME, {}, { baseConfiguration: baseLinearDisplayConfigSchema, explicitlyTyped: true });
+}
+function makeStateModel(control, gate, configSchema) {
+    return types
+        .compose(DISPLAY_NAME, BaseDisplay, 
+    // every real per-region display composes this, and the hover-clear
+    // reaction the foundation installs reads its `scrollTop`
+    TrackHeightMixin(), MultiRegionDisplayMixin(), types.model({
+        type: types.literal(DISPLAY_NAME),
+        configuration: ConfigurationReference(configSchema),
+    }))
+        .volatile(() => ({
+        /** every `fetchNeeded` call, as the region list it was handed */
+        fetchLog: [],
+        /**
+         * What `zoomFetchArgs` answers. A volatile, not a `control` knob, and
+         * that is the point: a real display's args read view state, so the
+         * autorun re-runs when they move. A plain closure value would be
+         * memoized by the computed and never invalidate.
+         */
+        fetchKey: '',
+    }))
+        .views(self => {
+        // chained, not replaced: `staleAnswers` forces a false answer for a
+        // bounded number of calls, and everything else is the foundation's own
+        // store-derived default
+        const superRegionHasData = self.regionHasData;
+        return {
+            regionHasData(displayedRegionIndex) {
+                control.cacheValidCalls += 1;
+                if (control.staleAnswers > 0) {
+                    control.staleAnswers -= 1;
+                    return false;
+                }
+                return superRegionHasData.call(self, displayedRegionIndex);
+            },
+        };
+    })
+        .views(self => ({
+        /** the fetched payloads, off the foundation's store */
+        get loadedData() {
+            return self.regionPayloads;
+        },
+        get gateEnabled() {
+            return gate.gateEnabled ?? false;
+        },
+        get densityTooLarge() {
+            return control.densityTooLarge;
+        },
+        zoomFetchArgs() {
+            return { key: self.fetchKey };
+        },
+    }))
+        .actions(self => ({
+        setFetchKey(key) {
+            self.fetchKey = key;
+        },
+    }))
+        .actions(self => ({
+        fetchNeeded(needed) {
+            self.fetchLog.push(needed);
+            // The budget is read here, at issue, exactly as a real display reads it
+            // to put in its RPC args.
+            const byteLimit = self.resolvedByteLimit();
+            return fetchEachRegion(self, needed, {
+                // Annotated for the reason a real display's RPC return type is
+                // declared: the refusal arm and the payload arm have to stay
+                // distinguishable, and inference merges two object literals into one
+                // widened shape.
+                call: async () => {
+                    if (control.fetchDelayMs > 0) {
+                        await new Promise(r => setTimeout(r, control.fetchDelayMs));
+                    }
+                    if (control.failNextFetch) {
+                        control.failNextFetch = false;
+                        throw new Error('rpc failed');
+                    }
+                    // What a gated worker does: measure, then refuse or fetch. No
+                    // budget means no measurement at all, which is why `estimateCalls`
+                    // stays at zero for an ungated display.
+                    if (byteLimit === undefined) {
+                        return { value: control.payloadTag };
+                    }
+                    control.estimateCalls += 1;
+                    const bytes = control.estimateBytes;
+                    return bytes > byteLimit
+                        ? { regionTooLarge: true, bytes }
+                        : { value: control.payloadTag, bytes };
+                },
+                onResult: (_idx, result) => result.value,
+            });
+        },
+    }));
+}
+/**
+ * A real `MultiRegionDisplayMixin` display inside a real `LinearGenomeView`, so
+ * `afterAttach` runs and `installPerRegionFetchAutoruns` installs for real.
+ */
+export function createPerRegionTestEnvironment({ measuresBytes = false, gate, estimateBytes = 100, ...opts } = {}) {
+    const control = {
+        cacheValidCalls: 0,
+        staleAnswers: 0,
+        failNextFetch: false,
+        fetchDelayMs: 0,
+        estimateBytes,
+        estimateCalls: 0,
+        densityTooLarge: false,
+        payloadTag: 'data',
+    };
+    const optIns = gate ?? { gateEnabled: measuresBytes };
+    const env = createDisplayTestEnvironment({
+        trackType: 'FeatureTrack',
+        displayName: DISPLAY_NAME,
+        configSchema: makeConfigSchema,
+        stateModel: (_pm, schema) => makeStateModel(control, optIns, schema),
+        viewModel: linearGenomeViewStateModelFactory,
+        assemblyEnd: 100_000,
+        // an empty display-config entry is still an entry: without one the harness
+        // leaves the display's `configuration` reference unresolved, and every slot
+        // the gate reads — `fetchSizeLimit` above all — answers undefined
+        displayConfig: {},
+        rpcCall: () => [],
+        ...opts,
+    });
+    return { ...env, control };
+}