@jbrowse/core 5.0.0-beta.3 → 5.0.0-beta.4

package/esm/util/whenViewSettled.d.ts

@@ -1,3 +1,8 @@
+export interface SettleableView {
+    initialized: boolean;
+    error: unknown;
+    pendingLaunch?: unknown;
+}
 /**
  * Wait until a view has either initialized — launch blob consumed and all — or
  * failed, and report which.
@@ -28,13 +33,33 @@
  *
  * No time bound, deliberately: `(initialized && launch consumed) || error` is a
  * terminal set, so a slow-but-healthy remote assembly is waited out rather than
- * guessed at.
+ * guessed at. `escape` is how a caller adds the one term that is not the view's
+ * own — a session-level render failure for an export, `superseded` for a view
+ * an `installInitAutorun` apply is waiting on — which is what keeps a caller
+ * from re-spelling the whole predicate around it.
+ *
+ * **Not for the view whose `apply` you are inside.** `applyInitOnce` clears the
+ * launch blob only after awaiting `apply`, so `pendingLaunch` is held for the
+ * whole of it and this can end only on `escape` or `error`, never on success.
+ * A wait on `self` stays hand-rolled; `reference/VIEW_INIT.md` has the shape.
  *
  * @returns true if the view initialized (and consumed any launch), false if it
  * settled on an error
  */
-export declare function whenViewSettled(view: {
-    initialized: boolean;
-    error: unknown;
-    pendingLaunch?: unknown;
-}): Promise<boolean>;
+export declare function whenViewSettled(view: SettleableView, escape?: () => boolean): Promise<boolean>;
+/**
+ * The same wait over several views at once — a synteny view's genome rows. An
+ * SVG export of a split view keeps its own per-panel loop instead: the split
+ * view's `initialized` folds in `views.every(v => v.initialized)` but not each
+ * panel's own `pendingLaunch`, so that loop is waiting on a different question
+ * by the time it runs.
+ *
+ * One predicate over `every`, never `Promise.all` of the single form: `when`
+ * returns a cancellable promise, so racing N of them against an escape leaves
+ * N-1 live reactions behind on the path that escapes. This is one reaction with
+ * nothing to cancel.
+ *
+ * @returns true if every view initialized, false if any settled on an error or
+ * the escape fired
+ */
+export declare function whenViewsSettled(views: SettleableView[], escape?: () => boolean): Promise<boolean>;

package/esm/util/whenViewSettled.js

@@ -1,4 +1,6 @@
 import { when } from 'mobx';
+const consumed = (view) => view.initialized && view.pendingLaunch === undefined;
+const done = (view) => consumed(view) || !!view.error;
 /**
  * Wait until a view has either initialized — launch blob consumed and all — or
  * failed, and report which.
@@ -29,13 +31,39 @@ import { when } from 'mobx';
  *
  * No time bound, deliberately: `(initialized && launch consumed) || error` is a
  * terminal set, so a slow-but-healthy remote assembly is waited out rather than
- * guessed at.
+ * guessed at. `escape` is how a caller adds the one term that is not the view's
+ * own — a session-level render failure for an export, `superseded` for a view
+ * an `installInitAutorun` apply is waiting on — which is what keeps a caller
+ * from re-spelling the whole predicate around it.
+ *
+ * **Not for the view whose `apply` you are inside.** `applyInitOnce` clears the
+ * launch blob only after awaiting `apply`, so `pendingLaunch` is held for the
+ * whole of it and this can end only on `escape` or `error`, never on success.
+ * A wait on `self` stays hand-rolled; `reference/VIEW_INIT.md` has the shape.
  *
  * @returns true if the view initialized (and consumed any launch), false if it
  * settled on an error
  */
-export async function whenViewSettled(view) {
-    const ready = () => view.initialized && view.pendingLaunch === undefined;
-    await when(() => ready() || !!view.error);
-    return ready();
+export async function whenViewSettled(view, escape = () => false) {
+    await when(() => escape() || done(view));
+    return consumed(view);
+}
+/**
+ * The same wait over several views at once — a synteny view's genome rows. An
+ * SVG export of a split view keeps its own per-panel loop instead: the split
+ * view's `initialized` folds in `views.every(v => v.initialized)` but not each
+ * panel's own `pendingLaunch`, so that loop is waiting on a different question
+ * by the time it runs.
+ *
+ * One predicate over `every`, never `Promise.all` of the single form: `when`
+ * returns a cancellable promise, so racing N of them against an escape leaves
+ * N-1 live reactions behind on the path that escapes. This is one reaction with
+ * nothing to cancel.
+ *
+ * @returns true if every view initialized, false if any settled on an error or
+ * the escape fired
+ */
+export async function whenViewsSettled(views, escape = () => false) {
+    await when(() => escape() || views.every(done));
+    return views.every(consumed);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jbrowse/core",
-  "version": "5.0.0-beta.3",
+  "version": "5.0.0-beta.4",
   "type": "module",
   "description": "JBrowse 2 core libraries used by plugins",
   "keywords": [
@@ -275,8 +275,8 @@
     "pako-esm2": "^2.0.2",
     "rxjs": "^7.8.2",
     "source-map-js": "^1.2.1",
-    "@jbrowse/add-track-core": "^5.0.0-beta.3",
-    "@jbrowse/render-core": "^5.0.0-beta.3"
+    "@jbrowse/add-track-core": "^5.0.0-beta.4",
+    "@jbrowse/render-core": "^5.0.0-beta.4"
   },
   "peerDependencies": {
     "react": ">=19.0.0",