@genome-spy/core 0.73.0 → 0.74.0

package/dist/src/genomeSpy/viewContextFactory.js

@@ -8,7 +8,8 @@
  * what they need while keeping production usage explicit.
  *
  * @param {Partial<ViewContext> & {
- *   createOrImportViewWithContext?: (context: ViewContext, spec: import("../spec/view.js").ViewSpec | import("../spec/view.js").ImportSpec, layoutParent?: import("../view/containerView.js").default, dataParent?: import("../view/view.js").default, defaultName?: string, validator?: (spec: import("../spec/view.js").ViewSpec) => void) => Promise<import("../view/view.js").default>
+ *   createOrImportViewWithContext?: (context: ViewContext, spec: import("../spec/view.js").ViewSpec | import("../spec/view.js").ImportSpec, layoutParent?: import("../view/containerView.js").default, dataParent?: import("../view/view.js").default, defaultName?: string, validator?: (spec: import("../spec/view.js").ViewSpec) => void, options?: import("../types/viewContext.js").CreateViewOptions) => Promise<import("../view/view.js").default>
+ *   allowMissingGlHelper?: boolean
  * }} options
  * @returns {ViewContext}
  */
@@ -20,7 +21,9 @@ export function createViewContext(options) {
     /** @type {Partial<ViewContext>} */
     const context = {
         dataFlow: options.dataFlow ?? missing("dataFlow"),
-        glHelper: options.glHelper ?? missing("glHelper"),
+        glHelper: options.allowMissingGlHelper
+            ? options.glHelper
+            : (options.glHelper ?? missing("glHelper")),
         animator: options.animator ?? missing("animator"),
         genomeStore: options.genomeStore,
         fontManager: options.fontManager ?? missing("fontManager"),
@@ -29,7 +32,8 @@ export function createViewContext(options) {
             layoutParent,
             dataParent,
             defaultName,
-            validator
+            validator,
+            createOptions
         ) {
             const create = options.createOrImportViewWithContext;
             if (!create) {
@@ -47,7 +51,8 @@ export function createViewContext(options) {
                 layoutParent,
                 dataParent,
                 defaultName,
-                validator
+                validator,
+                createOptions
             );
         },
     };
@@ -58,12 +63,15 @@ export function createViewContext(options) {
         "updateTooltip",
         "getNamedDataFromProvider",
         "getCurrentHover",
+        "suspendHoverTracking",
+        "resumeHoverTracking",
         "addKeyboardListener",
         "addBroadcastListener",
         "removeBroadcastListener",
         "highlightView",
         "isViewConfiguredVisible",
         "isViewSpec",
+        "getBaseConfig",
     ];
 
     /** @type {Partial<ViewContext>} */

package/dist/src/genomeSpy/viewDataInit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"viewDataInit.d.ts","sourceRoot":"","sources":["../../../src/genomeSpy/viewDataInit.js"],"names":[],"mappings":"AAOA;;;;;;;;;GASG;AACH,6CANW,OAAO,iBAAiB,EAAE,OAAO,YACjC,OAAO,qBAAqB,EAAE,OAAO,eACrC,OAAO,2BAA2B,EAAE,OAAO,mBAC3C,CAAC,QAAQ,EAAE,OAAO,qBAAqB,EAAE,OAAO,KAAK,IAAI,GACvD,OAAO,CAAC,OAAO,qBAAqB,EAAE,OAAO,CAAC,CAkC1D;AAED;;;;;;;;GAQG;AACH,oDALW,OAAO,iBAAiB,EAAE,OAAO,YACjC,OAAO,qBAAqB,EAAE,OAAO,eACrC,OAAO,2BAA2B,EAAE,OAAO,GACzC,OAAO,CAAC,OAAO,qBAAqB,EAAE,OAAO,CAAC,CA2E1D"}
+{"version":3,"file":"viewDataInit.d.ts","sourceRoot":"","sources":["../../../src/genomeSpy/viewDataInit.js"],"names":[],"mappings":"AAOA;;;;;;;;;GASG;AACH,6CANW,OAAO,iBAAiB,EAAE,OAAO,YACjC,OAAO,qBAAqB,EAAE,OAAO,eACrC,OAAO,2BAA2B,EAAE,OAAO,mBAC3C,CAAC,QAAQ,EAAE,OAAO,qBAAqB,EAAE,OAAO,KAAK,IAAI,GACvD,OAAO,CAAC,OAAO,qBAAqB,EAAE,OAAO,CAAC,CAoC1D;AAED;;;;;;;;GAQG;AACH,oDALW,OAAO,iBAAiB,EAAE,OAAO,YACjC,OAAO,qBAAqB,EAAE,OAAO,eACrC,OAAO,2BAA2B,EAAE,OAAO,GACzC,OAAO,CAAC,OAAO,qBAAqB,EAAE,OAAO,CAAC,CA6E1D"}

package/dist/src/genomeSpy/viewDataInit.js

@@ -32,9 +32,11 @@ export async function initializeViewData(
     onDataFlowBuilt(builtDataFlow);
 
     // Have to wait until asynchronous font loading is complete.
-    // Text mark's geometry builder needs font metrics before data can be
-    // converted into geometries.
-    // TODO: Make updateGraphicsData async and await font loading there.
+    // Text mark's geometry builder and measureText transforms need font metrics
+    // before data can be converted into geometries or derived widths.
+    // TODO: Replace this subtree-wide wait with consumer-specific waits:
+    // await fonts inside text mark graphics updates and before loading data for
+    // subtrees that contain measureText transforms.
     await fontManager.waitUntilReady();
 
     // Find all data sources and initiate loading.
@@ -108,6 +110,8 @@ export async function initializeVisibleViewData(
         viewInitializationPredicate
     );
 
+    // Newly visible subtrees may introduce text marks or measureText transforms
+    // that request fonts during initializeViewSubtree.
     await fontManager.waitUntilReady();
 
     for (const collector of collectorsToRepropagate) {

package/dist/src/genomeSpy.d.ts

@@ -1,129 +1,6 @@
-export default class GenomeSpy {
-    /**
-     * @typedef {import("./view/view.js").default} View
-     * @typedef {import("./spec/view.js").ViewSpec} ViewSpec
-     * @typedef {import("./spec/root.js").RootSpec} RootSpec
-     * @typedef {import("./spec/root.js").RootConfig} RootConfig
-     */
-    /**
-     *
-     * @param {HTMLElement} container
-     * @param {RootSpec} spec
-     * @param {import("./types/embedApi.js").EmbedOptions} [options]
-     */
-    constructor(container: HTMLElement, spec: import("./spec/root.js").RootSpec, options?: import("./types/embedApi.js").EmbedOptions);
-    container: HTMLElement;
-    options: import("./types/embedApi.js").EmbedOptions;
-    /** Root level configuration object */
-    spec: import("./spec/root.js").RootSpec;
-    viewFactory: ViewFactory;
-    /** @type {(function(string):object[])[]} */
-    namedDataProviders: ((arg0: string) => object[])[];
-    animator: Animator;
-    /** @type {GenomeStore} */
-    genomeStore: GenomeStore;
-    /**
-     * View visibility is checked using a predicate that can be overridden
-     * for more dynamic visibility management.
-     *
-     * @type {(view: View) => boolean}
-     */
-    viewVisibilityPredicate: (view: import("./view/view.js").default<import("./spec/view.js").ViewSpec>) => boolean;
-    /** @type {Record<string, import("./tooltip/tooltipHandler.js").TooltipHandler>}> */
-    tooltipHandlers: Record<string, import("./tooltip/tooltipHandler.js").TooltipHandler>;
-    /** @type {View} */
-    viewRoot: import("./view/view.js").default<import("./spec/view.js").ViewSpec>;
-    dpr: number;
-    /**
-     *
-     * @param {(name: string) => any[]} provider
-     */
-    registerNamedDataProvider(provider: (name: string) => any[]): void;
-    /**
-     * @param {string} name
-     */
-    getNamedDataFromProvider(name: string): object[];
-    /**
-     *
-     * @param {string} name
-     * @param {any[]} data
-     */
-    updateNamedData(name: string, data: any[]): void;
-    /**
-     * @param {string} type
-     * @param {(event: any) => void} listener
-     */
-    addEventListener(type: string, listener: (event: any) => void): void;
-    /**
-     * @param {string} type
-     * @param {(event: any) => void} listener
-     */
-    removeEventListener(type: string, listener: (event: any) => void): void;
-    /**
-     * Broadcast a message to all views
-     
-     * @param {BroadcastEventType} type
-     * @param {any} [payload]
-     */
-    broadcast(type: BroadcastEventType, payload?: any): void;
-    tooltip: import("./utils/ui/tooltip.js").default;
-    /**
-     * Unregisters all listeners, removes all created dom elements, removes all css classes from the container
-     */
-    destroy(): void;
-    /**
-     * TODO: Come up with a sensible name. And maybe this should be called at the end of the constructor.
-     * @returns {Promise<boolean>} true if the launch was successful
-     */
-    launch(): Promise<boolean>;
-    initializeVisibleViewData(): Promise<void>;
-    /**
-     * Waits until lazy sources under the root view have loaded data for the
-     * current visible positional domain.
-     *
-     * @param {AbortSignal} [signal]
-     */
-    awaitVisibleLazyData(signal?: AbortSignal): Promise<void>;
-    /**
-     * This method should be called in a mouseMove handler. If not called, the
-     * tooltip will be hidden.
-     *
-     * @param {T} datum
-     * @param {function(T):Promise<string | HTMLElement | import("lit").TemplateResult>} [converter]
-     * @template T
-     */
-    updateTooltip<T>(datum: T, converter?: (arg0: T) => Promise<string | HTMLElement | import("lit").TemplateResult>): void;
-    /**
-     * Returns a PNG data URL of the current canvas.
-     *
-     * @param {number} [logicalWidth] defaults to canvas width
-     * @param {number} [logicalHeight] defaults to canvas height
-     * @param {number} [devicePixelRatio] defaults to window.devicePixelRatio
-     * @param {string} [clearColor] null for transparent
-     * @returns A PNG data Url
-     */
-    exportCanvas(logicalWidth?: number, logicalHeight?: number, devicePixelRatio?: number, clearColor?: string): string;
-    getLogicalCanvasSize(): {
-        width: number;
-        height: number;
-    };
-    getRenderedBounds(): {
-        width: number | undefined;
-        height: number | undefined;
-    };
-    computeLayout(): void;
-    renderAll(): void;
-    renderPickingFramebuffer(): void;
-    getSearchableViews(): UnitView<import("./spec/view.js").UnitSpec>[];
-    getNamedScaleResolutions(): Map<string, import("./scales/scaleResolution.js").default>;
-    #private;
-}
+export { default } from "./genomeSpyBase.js";
 /**
  * Events that are broadcasted to all views.
  */
 export type BroadcastEventType = "dataFlowBuilt" | "layout" | "layoutComputed" | "subtreeDataReady";
-import { ViewFactory } from "./view/viewFactory.js";
-import Animator from "./utils/animator.js";
-import GenomeStore from "./genome/genomeStore.js";
-import UnitView from "./view/unitView.js";
 //# sourceMappingURL=genomeSpy.d.ts.map

package/dist/src/genomeSpy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"genomeSpy.d.ts","sourceRoot":"","sources":["../../src/genomeSpy.js"],"names":[],"mappings":"AAyDA;IAoBI;;;;;OAKG;IAEH;;;;;OAKG;IACH,uBAJW,WAAW,qDAEX,OAAO,qBAAqB,EAAE,YAAY,EA0CpD;IAvCG,uBAA0B;IAC1B,oDAAsB;IAItB,sCAAsC;IACtC,wCAAgB;IAEhB,yBAAoC;IAEpC,4CAA4C;IAC5C,oBADW,CAAC,CAAS,IAAM,EAAN,MAAM,KAAE,MAAM,EAAE,CAAC,EAAE,CACZ;IAE5B,mBAAoD;IAEpD,0BAA0B;IAC1B,aADW,WAAW,CACM;IAE5B;;;;;OAKG;IACH,yBAFU,CAAC,IAAI,qEAAM,KAAK,OAAO,CAE8B;IAE/D,oFAAoF;IACpF,iBADW,MAAM,CAAC,MAAM,EAAE,OAAO,6BAA6B,EAAE,cAAc,CAAC,CAK9E;IAED,mBAAmB;IACnB,8EAAyB;IAIzB,YAAkC;IAatC;;;OAGG;IACH,oCAFW,CAAC,IAAI,EAAE,MAAM,KAAK,GAAG,EAAE,QAIjC;IAED;;OAEG;IACH,+BAFW,MAAM,YAShB;IAED;;;;OAIG;IACH,sBAHW,MAAM,QACN,GAAG,EAAE,QAYf;IAED;;;OAGG;IACH,uBAHW,MAAM,YACN,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,QAI9B;IAED;;;OAGG;IACH,0BAHW,MAAM,YACN,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,QAI9B;IAED;;;;;OAKG;IACH,gBAHW,kBAAkB,YAClB,GAAG,QAMb;IAgEG,iDAAsB;IAQ1B;;OAEG;IACH,gBAqBC;IA0LD;;;OAGG;IACH,UAFa,OAAO,CAAC,OAAO,CAAC,CAyC5B;IAED,2CAiBC;IAED;;;;;OAKG;IACH,8BAFW,WAAW,iBAgBrB;IAED;;;;;;;OAOG;IACH,cAFa,CAAC,SAFH,CAAC,cACD,CAAS,IAAC,EAAD,CAAC,KAAE,OAAO,CAAC,MAAM,GAAG,WAAW,GAAG,OAAO,KAAK,EAAE,cAAc,CAAC,QAKlF;IAED;;;;;;;;OAQG;IACH,4BANW,MAAM,kBACN,MAAM,qBACN,MAAM,eACN,MAAM,UAuBhB;IAED;;;MAEC;IAED;eACwB,MAAM,GAAG,SAAS;gBAAU,MAAM,GAAG,SAAS;MAcrE;IAED,sBAEC;IAED,kBAEC;IAED,iCAEC;IAED,oEAYC;IAED,uFAWC;;CACJ;;;;iCAlnBY,eAAe,GAAG,QAAQ,GAAG,gBAAgB,GAAG,kBAAkB;4BApBnC,uBAAuB;qBAR9C,qBAAqB;wBAElB,yBAAyB;qBAL5B,oBAAoB"}
+{"version":3,"file":"genomeSpy.d.ts","sourceRoot":"","sources":["../../src/genomeSpy.js"],"names":[],"mappings":";;;;iCAEa,eAAe,GAAG,QAAQ,GAAG,gBAAgB,GAAG,kBAAkB"}