@genome-spy/core 0.77.0 → 0.79.0

package/dist/src/view/view.d.ts

@@ -39,13 +39,11 @@ export const VISIT_STOP: "VISIT_STOP";
  * @callback InteractionListener
  * @param {import("../utils/interaction.js").default} event
  */
+/** @typedef {import("../types/viewContext.js").ViewOptions} ViewOptions */
 /**
- * @typedef {object} ViewOptions
- * @prop {boolean} [blockEncodingInheritance]
- *      Don't inherit encodings from parent. Default: false.
- * @prop {"own" | "inherit"} [layoutSizeParams]
- *      Whether the view should introduce local layout-driven width/height params.
- *      Default: "own".
+ * @typedef {object} ParentGridChromePolicy
+ * @prop {boolean} axes
+ * @prop {boolean} background
  */
 /**
  * @template {import("../spec/view.js").ViewSpec} [TSpec=import("../spec/view.js").ViewSpec]
@@ -89,17 +87,16 @@ export default class View<TSpec extends import("../spec/view.js").ViewSpec = imp
          * @type {Partial<Record<import("../spec/channel.js").PrimaryPositionalChannel, import("../scales/axisResolution.js").default>>}
          */
         axis: Partial<Record<import("../spec/channel.js").PrimaryPositionalChannel, import("../scales/axisResolution.js").default>>;
-    };
-    options: {
-        /**
-         * Don't inherit encodings from parent. Default: false.
-         */
-        blockEncodingInheritance: boolean;
         /**
-         * Whether the view should introduce local layout-driven width/height params.
-         * Default: "own".
+         * Channel-specific legend resolutions.
+         * @type {Partial<Record<import("../spec/channel.js").ChannelWithScale, import("../scales/legendResolution.js").default>>}
          */
+        legend: Partial<Record<import("../spec/channel.js").ChannelWithScale, import("../scales/legendResolution.js").default>>;
+    };
+    options: {
+        inheritEncoding: boolean;
         layoutSizeParams: string;
+        axisLabelClipPolicy?: Partial<Record<import("../spec/channel.js").PrimaryPositionalChannel, import("./axisView.js").AxisLabelClipPolicy>>;
     };
     /**
      * @type {import("../data/flowHandle.js").FlowHandle | undefined}
@@ -336,6 +333,12 @@ export default class View<TSpec extends import("../spec/view.js").ViewSpec = imp
      * @return {WebGLTexture}
      */
     getSampleFacetTexture(): WebGLTexture;
+    /**
+     * Controls which decorations the parent GridView draws around this view.
+     *
+     * @returns {ParentGridChromePolicy}
+     */
+    getParentGridChromePolicy(): ParentGridChromePolicy;
     /**
      * @param {import("../spec/channel.js").ChannelWithScale} channel
      */
@@ -344,6 +347,10 @@ export default class View<TSpec extends import("../spec/view.js").ViewSpec = imp
      * @param {import("../spec/channel.js").PositionalChannel} channel
      */
     getAxisResolution(channel: import("../spec/channel.js").PositionalChannel): import("../scales/axisResolution.js").default;
+    /**
+     * @param {import("../spec/channel.js").ChannelWithScale} channel
+     */
+    getLegendResolution(channel: import("../spec/channel.js").ChannelWithScale): import("../scales/legendResolution.js").default;
     /**
      * @param {import("../spec/channel.js").Channel | "default"} channel
      * @param {import("../spec/view.js").ResolutionTarget} resolutionType
@@ -431,16 +438,10 @@ export type BroadcastMessage = {
  * same view.
  */
 export type InteractionListener = (event: import("../utils/interaction.js").default) => any;
-export type ViewOptions = {
-    /**
-     * Don't inherit encodings from parent. Default: false.
-     */
-    blockEncodingInheritance?: boolean;
-    /**
-     * Whether the view should introduce local layout-driven width/height params.
-     * Default: "own".
-     */
-    layoutSizeParams?: "own" | "inherit";
+export type ViewOptions = import("../types/viewContext.js").ViewOptions;
+export type ParentGridChromePolicy = {
+    axes: boolean;
+    background: boolean;
 };
 import ViewParamRuntime from "../paramRuntime/viewParamRuntime.js";
 import Padding from "./layout/padding.js";

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

@@ -1 +1 @@
-{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../../src/view/view.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../../src/view/view.js"],"names":[],"mappings":"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"}

package/dist/src/view/view.js

@@ -21,6 +21,10 @@ import { isExprRef } from "../paramRuntime/paramUtils.js";
 import { InternMap } from "internmap";
 import { endWithSlash } from "../utils/addBaseUrl.js";
 import { mergeConfigScopes } from "../config/mergeConfig.js";
+import {
+    clipCoords,
+    normalizeClipOptions,
+} from "./renderingContext/clipOptions.js";
 
 // TODO: View classes have too many responsibilities. Come up with a way
 // to separate the concerns. However, most concerns are tightly tied to
@@ -74,14 +78,14 @@ const defaultOpacityFunction = (parentOpacity) => parentOpacity;
  * @param {import("../utils/interaction.js").default} event
  */
 
+/** @typedef {import("../types/viewContext.js").ViewOptions} ViewOptions */
+
 /**
- * @typedef {object} ViewOptions
- * @prop {boolean} [blockEncodingInheritance]
- *      Don't inherit encodings from parent. Default: false.
- * @prop {"own" | "inherit"} [layoutSizeParams]
- *      Whether the view should introduce local layout-driven width/height params.
- *      Default: "own".
+ * @typedef {object} ParentGridChromePolicy
+ * @prop {boolean} axes
+ * @prop {boolean} background
  */
+
 /**
  * @template {import("../spec/view.js").ViewSpec} [TSpec=import("../spec/view.js").ViewSpec]
  */
@@ -185,12 +189,17 @@ export default class View {
              * @type {Partial<Record<import("../spec/channel.js").PrimaryPositionalChannel, import("../scales/axisResolution.js").default>>}
              */
             axis: {},
+            /**
+             * Channel-specific legend resolutions.
+             * @type {Partial<Record<import("../spec/channel.js").ChannelWithScale, import("../scales/legendResolution.js").default>>}
+             */
+            legend: {},
         };
 
         initPropertyCache(this);
 
         this.options = {
-            blockEncodingInheritance: false,
+            inheritEncoding: false,
             layoutSizeParams: "own",
             ...options,
         };
@@ -235,7 +244,8 @@ export default class View {
     #createLayoutSizeSetter(name) {
         if (
             this.paramRuntime.hasLocalParam(name) ||
-            this.paramRuntime.hasConfiguredParamInScopeChain(name)
+            (this.options.layoutSizeParams != "force" &&
+                this.paramRuntime.hasConfiguredParamInScopeChain(name))
         ) {
             return undefined;
         }
@@ -383,7 +393,7 @@ export default class View {
      * @return {import("./layout/flexLayout.js").SizeDef}
      */
     #getDimensionSize(dimension) {
-        let value = this.spec[dimension];
+        const { value, implicit } = this.#getDimensionValue(dimension);
         const needsStepInvalidation = isStepSize(value);
 
         const viewport =
@@ -431,6 +441,10 @@ export default class View {
                 );
 
                 return { px: steps * stepSize, grow: 0 };
+            } else if (implicit) {
+                // Vega-Lite treats a missing positional channel as one
+                // discrete step. Keep explicit step sizes strict.
+                return { px: stepSize, grow: 0 };
             } else {
                 throw new ViewError(
                     `Cannot use step-based size with "${dimension}"!`,
@@ -445,6 +459,59 @@ export default class View {
         }
     }
 
+    /**
+     * @param {"width" | "height" | "viewportWidth" | "viewportHeight"} dimension
+     * @returns {{ value: "container" | number | import("../spec/view.js").SizeDef | import("../spec/view.js").Step | undefined, implicit: boolean }}
+     */
+    #getDimensionValue(dimension) {
+        const value = this.spec[dimension];
+        if (value != null) {
+            return { value, implicit: false };
+        }
+
+        const viewport =
+            dimension == "viewportWidth" || dimension == "viewportHeight";
+        if (viewport) {
+            return { value, implicit: false };
+        }
+
+        return {
+            value: this.#getConfiguredDefaultSize(
+                /** @type {"width" | "height"} */ (dimension)
+            ),
+            implicit: true,
+        };
+    }
+
+    /**
+     * @param {"width" | "height"} dimension
+     * @returns {number | import("../spec/view.js").Step | undefined}
+     */
+    #getConfiguredDefaultSize(dimension) {
+        const viewConfig = this.getConfig().view;
+        if (!viewConfig) {
+            return undefined;
+        }
+
+        const channel = dimension == "width" ? "x" : "y";
+        const scaleType =
+            this.getScaleResolution(channel)?.getResolvedScaleType();
+        if (scaleType && !isDiscrete(scaleType)) {
+            return dimension == "width"
+                ? viewConfig.continuousWidth
+                : viewConfig.continuousHeight;
+        } else {
+            return (
+                (dimension == "width"
+                    ? viewConfig.discreteWidth
+                    : viewConfig.discreteHeight) ??
+                (viewConfig.step !== undefined
+                    ? { step: viewConfig.step }
+                    : undefined)
+            );
+        }
+    }
+
     registerStepSizeInvalidation() {
         this.#registerStepSizeInvalidationFor("width", "x");
         this.#registerStepSizeInvalidationFor("height", "y");
@@ -455,13 +522,17 @@ export default class View {
      * @param {import("../spec/channel.js").PrimaryPositionalChannel} channel
      */
     #registerStepSizeInvalidationFor(dimension, channel) {
-        const value = this.spec[dimension];
+        const { value, implicit } = this.#getDimensionValue(dimension);
         if (!isStepSize(value)) {
             return;
         }
 
         const resolution = this.getScaleResolution(channel);
         if (!resolution) {
+            if (implicit) {
+                return;
+            }
+
             throw new ViewError(
                 "Cannot use 'step' size without a scale!",
                 this
@@ -820,7 +891,7 @@ export default class View {
         }
         this.facetCoords.set(
             options.facetId,
-            options.clipRect ? coords.intersect(options.clipRect) : coords
+            clipCoords(coords, normalizeClipOptions(options))
         );
 
         this.#widthSetter?.(coords.width);
@@ -838,7 +909,7 @@ export default class View {
      */
     getEncoding() {
         const pe =
-            this.dataParent && !this.options.blockEncodingInheritance
+            this.dataParent && this.options.inheritEncoding
                 ? this.dataParent.getEncoding()
                 : {};
         const te = this.spec.encoding || {};
@@ -880,6 +951,8 @@ export default class View {
         const sampleFieldDef = this.getEncoding().sample;
         if (isFieldDef(sampleFieldDef)) {
             return [sampleFieldDef.field];
+        } else if (!this.options.inheritEncoding) {
+            return [];
         } else {
             return this.layoutParent?.getFacetFields(this);
         }
@@ -905,6 +978,18 @@ export default class View {
         return undefined;
     }
 
+    /**
+     * Controls which decorations the parent GridView draws around this view.
+     *
+     * @returns {ParentGridChromePolicy}
+     */
+    getParentGridChromePolicy() {
+        return {
+            axes: true,
+            background: true,
+        };
+    }
+
     /**
      * @param {import("../spec/channel.js").ChannelWithScale} channel
      */
@@ -933,6 +1018,20 @@ export default class View {
             .find((resolution) => resolution);
     }
 
+    /**
+     * @param {import("../spec/channel.js").ChannelWithScale} channel
+     */
+    getLegendResolution(channel) {
+        const primaryChannel =
+            /** @type {import("../spec/channel.js").ChannelWithScale} */ (
+                getPrimaryChannel(channel)
+            );
+
+        return this.getDataAncestors()
+            .map((view) => view.resolutions.legend[primaryChannel])
+            .find((resolution) => resolution);
+    }
+
     /**
      * @param {import("../spec/channel.js").Channel | "default"} channel
      * @param {import("../spec/view.js").ResolutionTarget} resolutionType
@@ -948,11 +1047,17 @@ export default class View {
      * @returns {import("../spec/view.js").ResolutionBehavior}
      */
     getConfiguredOrDefaultResolution(channel, resolutionType) {
-        return (
+        const configuredResolution =
             this.getConfiguredResolution(channel, resolutionType) ??
-            this.getConfiguredResolution("default", resolutionType) ??
-            this.getDefaultResolution(channel, resolutionType)
-        );
+            this.getConfiguredResolution("default", resolutionType);
+
+        if (configuredResolution) {
+            return configuredResolution;
+        } else if (resolutionType == "legend") {
+            return this.getConfiguredOrDefaultResolution(channel, "scale");
+        } else {
+            return this.getDefaultResolution(channel, resolutionType);
+        }
     }
 
     /**

package/dist/src/view/viewFactory.d.ts

@@ -4,8 +4,7 @@ export const VIEW_ROOT_NAME: "viewRoot";
  * @property {boolean} [allowImport] allows imports from urls
  * @property {boolean} [wrapRoot]
  *
- * @typedef {object} CreateViewOptions
- * @property {"own" | "inherit"} [layoutSizeParams]
+ * @typedef {import("../types/viewContext.js").CreateViewOptions} CreateViewOptions
  */
 /**
  *
@@ -59,9 +58,7 @@ export type ViewFactoryOptions = {
     allowImport?: boolean;
     wrapRoot?: boolean;
 };
-export type CreateViewOptions = {
-    layoutSizeParams?: "own" | "inherit";
-};
+export type CreateViewOptions = import("../types/viewContext.js").CreateViewOptions;
 import View from "./view.js";
 export { isConcatSpec, isFacetSpec, isHConcatSpec, isImportSpec, isLayerSpec, isUnitSpec, isVConcatSpec } from "./viewSpecGuards.js";
 //# sourceMappingURL=viewFactory.d.ts.map

package/dist/src/view/viewFactory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"viewFactory.d.ts","sourceRoot":"","sources":["../../../src/view/viewFactory.js"],"names":[],"mappings":"AA2BA,6BAA8B,UAAU,CAAC;AAEzC;;;;;;;GAOG;AAEH;;GAEG;AACH;IAiBI;;OAEG;IACH,sBAFW,kBAAkB,EAoE5B;IAjEG,2CAA2C;IAC3C,SADW,QAAQ,CAAC,kBAAkB,CAAC,CAKtC;IA8DL;;;OAGG;IACH,qEAlFiC,OAAO,yHAC2B,OAAO,oBAAoB,EAAE,OAAO,eAAe,OAAO,WAAW,EAAE,OAAO,gBAAgB,MAAM,YAAY,iBAAiB,KAAK,IAAI,QAmF5M;IAED;;;;;;;OAOG;IACH,wHALW,OAAO,oBAAoB,EAAE,OAAO,eACpC,OAAO,WAAW,EAAE,OAAO,gBAC3B,MAAM,YACN,iBAAiB,4CA0B3B;IAED;;;;OAIG;IACH,sDAFa,IAAI,sCAAY,CAU5B;IAED;;;;;;;;;;;OAWG;IACH,yBARW,qCAAW,OAAO,iBAAiB,EAAE,UAAU,qEAE/C,OAAO,oBAAoB,EAAE,OAAO,eACpC,OAAO,WAAW,EAAE,OAAO,gBAC3B,MAAM,cACN,CAAC,IAAI,oCAAU,KAAK,IAAI,YACxB,iBAAiB,qDAqG3B;;CACJ;;;;;kBA3Qa,OAAO;eACP,OAAO;;;uBAGP,KAAK,GAAG,SAAS;;iBAlCd,WAAW"}
+{"version":3,"file":"viewFactory.d.ts","sourceRoot":"","sources":["../../../src/view/viewFactory.js"],"names":[],"mappings":"AA2BA,6BAA8B,UAAU,CAAC;AAEzC;;;;;;GAMG;AAEH;;GAEG;AACH;IAiBI;;OAEG;IACH,sBAFW,kBAAkB,EAoE5B;IAjEG,2CAA2C;IAC3C,SADW,QAAQ,CAAC,kBAAkB,CAAC,CAKtC;IA8DL;;;OAGG;IACH,qEAlFiC,OAAO,yHAC2B,OAAO,oBAAoB,EAAE,OAAO,eAAe,OAAO,WAAW,EAAE,OAAO,gBAAgB,MAAM,YAAY,iBAAiB,KAAK,IAAI,QAmF5M;IAED;;;;;;;OAOG;IACH,wHALW,OAAO,oBAAoB,EAAE,OAAO,eACpC,OAAO,WAAW,EAAE,OAAO,gBAC3B,MAAM,YACN,iBAAiB,4CA0B3B;IAED;;;;OAIG;IACH,sDAFa,IAAI,sCAAY,CAU5B;IAED;;;;;;;;;;;OAWG;IACH,yBARW,qCAAW,OAAO,iBAAiB,EAAE,UAAU,qEAE/C,OAAO,oBAAoB,EAAE,OAAO,eACpC,OAAO,WAAW,EAAE,OAAO,gBAC3B,MAAM,cACN,CAAC,IAAI,oCAAU,KAAK,IAAI,YACxB,iBAAiB,qDAqG3B;;CACJ;;;;;kBA1Qa,OAAO;eACP,OAAO;;gCAER,OAAO,yBAAyB,EAAE,iBAAiB;iBAjC/C,WAAW"}

package/dist/src/view/viewFactory.js

@@ -32,8 +32,7 @@ export const VIEW_ROOT_NAME = "viewRoot";
  * @property {boolean} [allowImport] allows imports from urls
  * @property {boolean} [wrapRoot]
  *
- * @typedef {object} CreateViewOptions
- * @property {"own" | "inherit"} [layoutSizeParams]
+ * @typedef {import("../types/viewContext.js").CreateViewOptions} CreateViewOptions
  */
 
 /**

package/dist/src/view/viewIdentityRegistry.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Returns the shared runtime identity registry for a view hierarchy.
+ *
+ * The registry is keyed by the root view instead of being global because view
+ * ids are only meaningful inside one embedded GenomeSpy runtime. This keeps
+ * independent embeds isolated while still allowing optional tools, such as the
+ * inspector and the public view API, to agree on ids for the same live views.
+ *
+ * The WeakMap avoids adding debug-only fields to View instances and lets the
+ * registry disappear when the root hierarchy is released.
+ *
+ * @param {View} root
+ * @returns {ViewIdentityRegistry}
+ */
+export function getViewIdentityRegistry(root: View): ViewIdentityRegistry;
+/**
+ * Allocates runtime-stable ids for View object identities.
+ *
+ * Ids are intentionally synthetic. They are stable for the lifetime of the
+ * root view hierarchy, but they are not persisted and must not be used as
+ * bookmarks across reloads.
+ */
+export class ViewIdentityRegistry {
+    /**
+     * @param {View} view
+     * @returns {string}
+     */
+    getId(view: View): string;
+    /**
+     * @param {string} id
+     * @returns {View | undefined}
+     */
+    getView(id: string): View | undefined;
+    #private;
+}
+export type View = import("./view.js").default;
+//# sourceMappingURL=viewIdentityRegistry.d.ts.map

package/dist/src/view/viewIdentityRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewIdentityRegistry.d.ts","sourceRoot":"","sources":["../../../src/view/viewIdentityRegistry.js"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;GAaG;AACH,8CAHW,IAAI,GACF,oBAAoB,CAUhC;AAED;;;;;;GAMG;AACH;IASI;;;OAGG;IACH,YAHW,IAAI,GACF,MAAM,CAYlB;IAED;;;OAGG;IACH,YAHW,MAAM,GACJ,IAAI,GAAG,SAAS,CAI5B;;CACJ;mBArEY,OAAO,WAAW,EAAE,OAAO"}

package/dist/src/view/viewIdentityRegistry.js

@@ -0,0 +1,71 @@
+/**
+ * @typedef {import("./view.js").default} View
+ */
+
+/** @type {WeakMap<View, ViewIdentityRegistry>} */
+const registriesByRoot = new WeakMap();
+
+/**
+ * Returns the shared runtime identity registry for a view hierarchy.
+ *
+ * The registry is keyed by the root view instead of being global because view
+ * ids are only meaningful inside one embedded GenomeSpy runtime. This keeps
+ * independent embeds isolated while still allowing optional tools, such as the
+ * inspector and the public view API, to agree on ids for the same live views.
+ *
+ * The WeakMap avoids adding debug-only fields to View instances and lets the
+ * registry disappear when the root hierarchy is released.
+ *
+ * @param {View} root
+ * @returns {ViewIdentityRegistry}
+ */
+export function getViewIdentityRegistry(root) {
+    let registry = registriesByRoot.get(root);
+    if (!registry) {
+        registry = new ViewIdentityRegistry();
+        registriesByRoot.set(root, registry);
+    }
+
+    return registry;
+}
+
+/**
+ * Allocates runtime-stable ids for View object identities.
+ *
+ * Ids are intentionally synthetic. They are stable for the lifetime of the
+ * root view hierarchy, but they are not persisted and must not be used as
+ * bookmarks across reloads.
+ */
+export class ViewIdentityRegistry {
+    /** @type {WeakMap<View, string>} */
+    #idsByView = new WeakMap();
+
+    /** @type {Map<string, View>} */
+    #viewsById = new Map();
+
+    #nextId = 0;
+
+    /**
+     * @param {View} view
+     * @returns {string}
+     */
+    getId(view) {
+        let id = this.#idsByView.get(view);
+        if (!id) {
+            id = "view-" + String(this.#nextId);
+            this.#nextId++;
+            this.#idsByView.set(view, id);
+            this.#viewsById.set(id, view);
+        }
+
+        return id;
+    }
+
+    /**
+     * @param {string} id
+     * @returns {View | undefined}
+     */
+    getView(id) {
+        return this.#viewsById.get(id);
+    }
+}

package/dist/src/view/viewMutationAcidTestUtils.d.ts

@@ -0,0 +1,112 @@
+/**
+ * @typedef {{
+ *   view: import("./view.js").default,
+ *   api: import("../types/embedApi.js").ViewApi,
+ *   context: import("../types/viewContext.js").default
+ * }} ViewMutationAcidHarness
+ */
+/**
+ * @param {import("../spec/root.js").RootSpec} spec
+ * @param {Parameters<typeof createHeadlessEngine>[1]} [options]
+ * @returns {Promise<ViewMutationAcidHarness>}
+ */
+export function createViewMutationAcidHarness(spec: import("../spec/root.js").RootSpec, options?: Parameters<typeof createHeadlessEngine>[1]): Promise<ViewMutationAcidHarness>;
+/**
+ * Captures normalized lifecycle state that should remain stable after a
+ * round-trip mutation.
+ *
+ * @param {import("./view.js").default} viewRoot
+ */
+export function createMutationAcidSnapshot(viewRoot: import("./view.js").default): {
+    hierarchy: {
+        name: string;
+        explicitName: string;
+        defaultName: string;
+        type: string;
+        dataState: "none" | "pending" | "ready";
+        visibleInSpec: boolean;
+        configuredVisible: boolean;
+        layoutParent: number;
+        dataParent: number;
+        children: number[];
+        flowHandle: {
+            dataSource: boolean;
+            collector: boolean;
+        };
+        resolutions: {
+            scale: {
+                [k: string]: {
+                    view: number;
+                    channel: import("../spec/channel.js").ChannelWithScale;
+                    contributesToDomain: boolean;
+                }[];
+            };
+            axis: {
+                [k: string]: {
+                    visible: boolean;
+                    title: string;
+                };
+            };
+            legend: {
+                [k: string]: {
+                    visible: boolean;
+                    definitions: {
+                        view: number;
+                        channel: import("../spec/channel.js").ChannelWithScale;
+                        type: import("../scales/legendResolution.js").LegendType;
+                        field: string;
+                    }[];
+                };
+            };
+        };
+    }[];
+    layout: {
+        viewName: string;
+        coords: string;
+        children: /*elided*/ any[];
+        addChild(viewCoords: /*elided*/ any): void;
+    };
+};
+/**
+ * Captures object identities that should survive a round-trip mutation.
+ *
+ * @param {import("./view.js").default} viewRoot
+ */
+export function captureMutationAcidIdentities(viewRoot: import("./view.js").default): {
+    views: import("./view.js").default<import("../spec/view.js").ViewSpec>[];
+    collectors: import("../data/collector.js").default[];
+};
+/**
+ * @template T
+ * @returns {{
+ *   promise: Promise<T>,
+ *   resolve: (value: T) => void,
+ *   reject: (reason?: unknown) => void
+ * }}
+ */
+export function createDeferred<T>(): {
+    promise: Promise<T>;
+    resolve: (value: T) => void;
+    reject: (reason?: unknown) => void;
+};
+/**
+ * @param {() => boolean} predicate
+ * @returns {Promise<void>}
+ */
+export function waitUntil(predicate: () => boolean): Promise<void>;
+/**
+ * @param {import("./view.js").default} viewRoot
+ * @param {string} name
+ */
+export function getRequiredView(viewRoot: import("./view.js").default, name: string): import("./view.js").default<import("../spec/view.js").ViewSpec>;
+/**
+ * @param {import("./view.js").default} view
+ */
+export function countCollectorRows(view: import("./view.js").default): number;
+export type ViewMutationAcidHarness = {
+    view: import("./view.js").default;
+    api: import("../types/embedApi.js").ViewApi;
+    context: import("../types/viewContext.js").default;
+};
+import { createHeadlessEngine } from "../genomeSpy/headlessBootstrap.js";
+//# sourceMappingURL=viewMutationAcidTestUtils.d.ts.map

package/dist/src/view/viewMutationAcidTestUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewMutationAcidTestUtils.d.ts","sourceRoot":"","sources":["../../../src/view/viewMutationAcidTestUtils.js"],"names":[],"mappings":"AAIA;;;;;;GAMG;AAEH;;;;GAIG;AACH,oDAJW,OAAO,iBAAiB,EAAE,QAAQ,YAClC,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,CAAC,CAAC,GACxC,OAAO,CAAC,uBAAuB,CAAC,CAU5C;AAED;;;;;GAKG;AACH,qDAFW,OAAO,WAAW,EAAE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAOrC;AAED;;;;GAIG;AACH,wDAFW,OAAO,WAAW,EAAE,OAAO;;;EASrC;AAED;;;;;;;GAOG;AACH,+BAPa,CAAC,KACD;IACR,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACpB,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAC5B,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;CACnC,CAaH;AAED;;;GAGG;AACH,qCAHW,MAAM,OAAO,GACX,OAAO,CAAC,IAAI,CAAC,CAYzB;AAED;;;GAGG;AACH,0CAHW,OAAO,WAAW,EAAE,OAAO,QAC3B,MAAM,mEAShB;AAED;;GAEG;AACH,yCAFW,OAAO,WAAW,EAAE,OAAO,UAerC;sCAnHY;IACR,IAAI,EAAE,OAAO,WAAW,EAAE,OAAO,CAAC;IAClC,GAAG,EAAE,OAAO,sBAAsB,EAAE,OAAO,CAAC;IAC5C,OAAO,EAAE,OAAO,yBAAyB,EAAE,OAAO,CAAA;CACnD;qCARiC,mCAAmC"}