@genome-spy/core 0.65.0 → 0.66.1

package/dist/src/scales/scaleRules.js

@@ -0,0 +1,103 @@
+import { isContinuous } from "vega-scale";
+
+import {
+    isPositionalChannel,
+    isPrimaryPositionalChannel,
+} from "../encoder/encoder.js";
+import {
+    INDEX,
+    LOCUS,
+    NOMINAL,
+    ORDINAL,
+    QUANTITATIVE,
+} from "./scaleResolutionConstants.js";
+
+/**
+ * @typedef {import("../spec/channel.js").Channel} Channel
+ */
+
+/**
+ * @param {Channel} channel
+ * @param {import("../spec/channel.js").Type} dataType
+ * @returns {import("../spec/scale.js").ScaleType}
+ */
+export function getDefaultScaleType(channel, dataType) {
+    // TODO: Band scale, Bin-Quantitative
+
+    if (dataType == INDEX || dataType == LOCUS) {
+        if (isPrimaryPositionalChannel(channel)) {
+            return dataType;
+        } else {
+            // TODO: Also explicitly set scales should be validated
+            throw new Error(
+                channel +
+                    " does not support " +
+                    dataType +
+                    " data type. Only positional channels do."
+            );
+        }
+    }
+
+    /**
+     * @type {Partial<Record<Channel, (import("../spec/scale.js").ScaleType | undefined)[]>>}
+     * Default types: nominal, ordinal, quantitative.
+     * undefined = incompatible, "null" = disabled (pass-thru)
+     */
+    const defaults = {
+        x: ["band", "band", "linear"],
+        y: ["band", "band", "linear"],
+        size: [undefined, "point", "linear"],
+        opacity: [undefined, "point", "linear"],
+        fillOpacity: [undefined, "point", "linear"],
+        strokeOpacity: [undefined, "point", "linear"],
+        color: ["ordinal", "ordinal", "linear"],
+        fill: ["ordinal", "ordinal", "linear"],
+        stroke: ["ordinal", "ordinal", "linear"],
+        strokeWidth: [undefined, undefined, "linear"],
+        shape: ["ordinal", "ordinal", undefined],
+        dx: [undefined, undefined, "null"],
+        dy: [undefined, undefined, "null"],
+        angle: [undefined, undefined, "linear"],
+        sample: ["null", undefined, undefined],
+    };
+
+    /** @type {Channel[]} */
+    const typelessChannels = ["sample"];
+
+    const type = typelessChannels.includes(channel)
+        ? "null"
+        : defaults[channel]
+          ? defaults[channel][
+                [NOMINAL, ORDINAL, QUANTITATIVE].indexOf(dataType)
+            ]
+          : dataType == QUANTITATIVE
+            ? "linear"
+            : "ordinal";
+
+    if (type === undefined) {
+        throw new Error(
+            'Channel "' +
+                channel +
+                '" is not compatible with "' +
+                dataType +
+                '" data type. Use of a proper scale may be needed.'
+        );
+    }
+
+    return type;
+}
+
+/**
+ * @param {import("../spec/scale.js").Scale} props
+ * @param {Channel} channel
+ */
+export function applyLockedProperties(props, channel) {
+    if (isPositionalChannel(channel) && props.type !== "ordinal") {
+        // Unit ranges are a temporary default until pixel ranges are adopted.
+        props.range = [0, 1];
+    }
+
+    if (channel == "opacity" && isContinuous(props.type)) {
+        props.clamp = true;
+    }
+}

package/dist/src/scales/scaleRules.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=scaleRules.test.d.ts.map

package/dist/src/scales/scaleRules.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaleRules.test.d.ts","sourceRoot":"","sources":["../../../src/scales/scaleRules.test.js"],"names":[],"mappings":""}

package/dist/src/spec/channel.d.ts

@@ -166,19 +166,15 @@ export interface ValueDefBase<V extends Value = Scalar> {
 export type ValueDef<V extends Value = Scalar> = ValueDefBase<V> & TitleMixins;
 
 export interface DatumDef<V extends Scalar | ExprRef = Scalar | ExprRef>
-    extends Partial<TypeMixins<Type>>,
-        BandMixins,
-        ScaleMixins,
-        TitleMixins {
+    extends Partial<TypeMixins<Type>>, BandMixins, ScaleMixins, TitleMixins {
     /**
      * A constant value in data domain.
      */
     datum?: V;
 }
 
-export interface ExprDef<>extends Partial<TypeMixins<Type>>,
-        BandMixins,
-        TitleMixins {
+export interface ExprDef
+    extends Partial<TypeMixins<Type>>, BandMixins, TitleMixins {
     /**
      *  An expression. Properties of the data can be accessed through the `datum` object.
      */
@@ -200,17 +196,16 @@ export type MarkPropDatumDef<T extends Type> = LegendMixins &
     ScaleDatumDef &
     TypeMixins<T>;
 
-export interface LegendMixins {
-    /**
-     * An object defining properties of the legend.
-     * If `null`, the legend for the encoding channel will be removed.
-     *
-     * __Default value:__ If undefined, default [legend properties](https://vega.github.io/vega-lite/docs/legend.html) are applied.
-     *
-     * __See also:__ [`legend`](https://vega.github.io/vega-lite/docs/legend.html) documentation.
-     */
-    // TODO: legend?: Legend<ExprRef | SignalRef> | null;
-}
+/**
+ * An object defining properties of the legend.
+ * If `null`, the legend for the encoding channel will be removed.
+ *
+ * __Default value:__ If undefined, default [legend properties](https://vega.github.io/vega-lite/docs/legend.html) are applied.
+ *
+ * __See also:__ [`legend`](https://vega.github.io/vega-lite/docs/legend.html) documentation.
+ */
+// TODO: legend?: Legend<ExprRef | SignalRef> | null;
+export type LegendMixins = Record<string, never>;
 
 export type ConditionalTemplate =
     | FieldDef<any>

package/dist/src/spec/scale.d.ts

@@ -47,6 +47,12 @@ export interface Scale {
      */
     type?: ScaleType;
 
+    /**
+     * The genome assembly name for locus scales. If undefined, the default
+     * genome from the genome store is used.
+     */
+    assembly?: string;
+
     /**
      * Customized domain values.
      *

package/dist/src/types/embedApi.d.ts

@@ -40,6 +40,11 @@ export interface EmbedOptions {
      * @genome-spy/app package.
      */
     powerPreference?: "default" | "high-performance" | "low-power";
+
+    /**
+     * Optional hook for handling launch errors. Return true to suppress default UI.
+     */
+    onError?: (error: unknown, container: HTMLElement) => boolean | void;
 }
 
 /**

package/dist/src/types/scaleResolutionApi.d.ts

@@ -1,5 +1,5 @@
 import { ComplexDomain, NumericDomain } from "../spec/scale.js";
-import ScaleResolution from "../view/scaleResolution.js";
+import ScaleResolution from "../scales/scaleResolution.js";
 
 export type ScaleResolutionEventType = "domain" | "range";
 export interface ScaleResolutionEvent {

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

@@ -11,6 +11,24 @@ export default class ConcatView extends GridView {
      * @param {string} name
      */
     constructor(spec: import("../spec/view.js").AnyConcatSpec, context: import("../types/viewContext.js").default, layoutParent: import("./containerView.js").default, dataParent: import("./view.js").default, name: string);
+    /**
+     * Adds a child spec dynamically. Intended for post-initialization updates.
+     *
+     * Callers should prefer this over direct GridView insertion to ensure
+     * dataflow initialization, axis wiring, and layout reflow are handled.
+     *
+     * @param {import("../spec/view.js").ViewSpec} childSpec
+     * @param {number} [index]
+     * @returns {Promise<import("./view.js").default>}
+     */
+    addChildSpec(childSpec: import("../spec/view.js").ViewSpec, index?: number): Promise<import("./view.js").default>;
+    /**
+     * Removes a child by index. Intended for post-initialization updates.
+     *
+     * @param {number} index
+     */
+    removeChildAt(index: number): Promise<void>;
+    #private;
 }
 import GridView from "./gridView/gridView.js";
 //# sourceMappingURL=concatView.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"concatView.d.ts","sourceRoot":"","sources":["../../../src/view/concatView.js"],"names":[],"mappings":"AAGA;;GAEG;AACH;IACI;;;;;;;OAOG;IACH,kBANW,OAAO,iBAAiB,EAAE,aAAa,WACvC,OAAO,yBAAyB,EAAE,OAAO,gBACzC,OAAO,oBAAoB,EAAE,OAAO,cACpC,OAAO,WAAW,EAAE,OAAO,QAC3B,MAAM,EAiBhB;CAqDJ;qBAlFoB,wBAAwB"}
+{"version":3,"file":"concatView.d.ts","sourceRoot":"","sources":["../../../src/view/concatView.js"],"names":[],"mappings":"AAIA;;GAEG;AACH;IACI;;;;;;;OAOG;IACH,kBANW,OAAO,iBAAiB,EAAE,aAAa,WACvC,OAAO,yBAAyB,EAAE,OAAO,gBACzC,OAAO,oBAAoB,EAAE,OAAO,cACpC,OAAO,WAAW,EAAE,OAAO,QAC3B,MAAM,EAiBhB;IA6BD;;;;;;;;;OASG;IACH,wBAJW,OAAO,iBAAiB,EAAE,QAAQ,UAClC,MAAM,GACJ,OAAO,CAAC,OAAO,WAAW,EAAE,OAAO,CAAC,CAIhD;IAED;;;;OAIG;IACH,qBAFW,MAAM,iBAIhB;;CA2EJ;qBA3JoB,wBAAwB"}

package/dist/src/view/concatView.js

@@ -1,5 +1,6 @@
 import { isConcatSpec, isHConcatSpec, isVConcatSpec } from "./viewFactory.js";
 import GridView from "./gridView/gridView.js";
+import ContainerMutationHelper from "./containerMutationHelper.js";
 
 /**
  * Creates a vertically or horizontally concatenated layout for children.
@@ -57,6 +58,29 @@ export default class ConcatView extends GridView {
         await this.createAxes();
     }
 
+    /**
+     * Adds a child spec dynamically. Intended for post-initialization updates.
+     *
+     * Callers should prefer this over direct GridView insertion to ensure
+     * dataflow initialization, axis wiring, and layout reflow are handled.
+     *
+     * @param {import("../spec/view.js").ViewSpec} childSpec
+     * @param {number} [index]
+     * @returns {Promise<import("./view.js").default>}
+     */
+    async addChildSpec(childSpec, index) {
+        return this.#getMutationHelper().addChildSpec(childSpec, index);
+    }
+
+    /**
+     * Removes a child by index. Intended for post-initialization updates.
+     *
+     * @param {number} index
+     */
+    async removeChildAt(index) {
+        await this.#getMutationHelper().removeChildAt(index);
+    }
+
     /**
      * @param {import("../spec/channel.js").Channel} channel
      * @param {import("../spec/view.js").ResolutionTarget} resolutionType
@@ -81,4 +105,53 @@ export default class ConcatView extends GridView {
             return "independent";
         }
     }
+
+    /**
+     * @returns {{
+     *   specs: (import("../spec/view.js").ViewSpec | import("../spec/view.js").ImportSpec)[],
+     *   insertAt: (index: number, spec: import("../spec/view.js").ViewSpec | import("../spec/view.js").ImportSpec) => void,
+     *   removeAt: (index: number) => void
+     * }}
+     */
+    #getChildSpecs() {
+        const spec = this.spec;
+        let specs;
+
+        if (isConcatSpec(spec)) {
+            specs = spec.concat;
+        } else if (isVConcatSpec(spec)) {
+            specs = spec.vconcat;
+        } else {
+            specs = spec.hconcat;
+        }
+
+        return {
+            specs,
+            insertAt: (index, childSpec) => {
+                specs.splice(index, 0, childSpec);
+            },
+            removeAt: (index) => {
+                specs.splice(index, 1);
+            },
+        };
+    }
+
+    /**
+     * @returns {ContainerMutationHelper}
+     */
+    #getMutationHelper() {
+        return new ContainerMutationHelper(this, {
+            getChildSpecs: this.#getChildSpecs.bind(this),
+            insertView: (view, index) => this.insertChildViewAt(view, index),
+            removeView: (index) => super.removeChildAt(index),
+            prepareView: async (view, _index, gridChild) => {
+                await gridChild.createAxes();
+                await this.syncSharedAxes();
+            },
+            afterRemove: async () => {
+                await this.syncSharedAxes();
+            },
+            defaultName: (_index) => "grid" + this.childCount,
+        });
+    }
 }

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=concatView.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"concatView.test.d.ts","sourceRoot":"","sources":["../../../src/view/concatView.test.js"],"names":[],"mappings":""}

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

@@ -0,0 +1,74 @@
+/**
+ * Shared helper for dynamic container mutations.
+ * Encapsulates the common lifecycle for adding/removing child views.
+ */
+export default class ContainerMutationHelper {
+    /**
+     * @typedef {import("./view.js").default} View
+     * @typedef {import("../spec/view.js").ViewSpec} ViewSpec
+     * @typedef {import("../spec/view.js").ImportSpec} ImportSpec
+     *
+     * @typedef {{
+     *   specs: (ViewSpec | ImportSpec)[],
+     *   insertAt: (index: number, spec: ViewSpec | ImportSpec) => void,
+     *   removeAt: (index: number) => void
+     * }} ChildSpecs
+     */
+    /**
+     * @typedef {{
+     *   getChildSpecs: () => ChildSpecs,
+     *   insertView: (view: View, index: number) => any,
+     *   removeView: (index: number) => void,
+     *   prepareView?: (view: View, index: number, insertionResult: any) => Promise<void>,
+     *   afterRemove?: (index: number) => Promise<void>,
+     *   defaultName?: (index: number, spec: ViewSpec | ImportSpec) => string,
+     *   requestLayout?: boolean
+     * }} MutationOptions
+     */
+    /**
+     * @param {import("./containerView.js").default} container
+     * @param {MutationOptions} options
+     */
+    constructor(container: import("./containerView.js").default, options: {
+        getChildSpecs: () => {
+            specs: (import("../spec/view.js").ViewSpec | import("../spec/view.js").ImportSpec)[];
+            insertAt: (index: number, spec: import("../spec/view.js").ViewSpec | import("../spec/view.js").ImportSpec) => void;
+            removeAt: (index: number) => void;
+        };
+        insertView: (view: import("./view.js").default, index: number) => any;
+        removeView: (index: number) => void;
+        prepareView?: (view: import("./view.js").default, index: number, insertionResult: any) => Promise<void>;
+        afterRemove?: (index: number) => Promise<void>;
+        defaultName?: (index: number, spec: import("../spec/view.js").ViewSpec | import("../spec/view.js").ImportSpec) => string;
+        requestLayout?: boolean;
+    });
+    container: import("./containerView.js").default;
+    options: {
+        getChildSpecs: () => {
+            specs: (import("../spec/view.js").ViewSpec | import("../spec/view.js").ImportSpec)[];
+            insertAt: (index: number, spec: import("../spec/view.js").ViewSpec | import("../spec/view.js").ImportSpec) => void;
+            removeAt: (index: number) => void;
+        };
+        insertView: (view: import("./view.js").default, index: number) => any;
+        removeView: (index: number) => void;
+        prepareView?: (view: import("./view.js").default, index: number, insertionResult: any) => Promise<void>;
+        afterRemove?: (index: number) => Promise<void>;
+        defaultName?: (index: number, spec: import("../spec/view.js").ViewSpec | import("../spec/view.js").ImportSpec) => string;
+        requestLayout?: boolean;
+    };
+    /**
+     * Adds a child spec dynamically and initializes its subtree dataflow.
+     *
+     * @param {import("../spec/view.js").ViewSpec | import("../spec/view.js").ImportSpec} childSpec
+     * @param {number} [index]
+     * @returns {Promise<View>}
+     */
+    addChildSpec(childSpec: import("../spec/view.js").ViewSpec | import("../spec/view.js").ImportSpec, index?: number): Promise<import("./view.js").default>;
+    /**
+     * Removes a child by index and updates the backing spec list.
+     *
+     * @param {number} index
+     */
+    removeChildAt(index: number): Promise<void>;
+}
+//# sourceMappingURL=containerMutationHelper.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"containerMutationHelper.d.ts","sourceRoot":"","sources":["../../../src/view/containerMutationHelper.js"],"names":[],"mappings":"AAOA;;;GAGG;AACH;IACI;;;;;;;;;;OAUG;IAEH;;;;;;;;;;OAUG;IAEH;;;OAGG;IACH,uBAHW,OAAO,oBAAoB,EAAE,OAAO;uBAX3B;mBARR,CAAC,yEAAqB,CAAC,EAAE;sBACtB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,yEAAqB,KAAK,IAAI;sBACpD,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI;SAMF;oBACnB,CAAC,IAAI,6BAAM,EAAE,KAAK,EAAE,MAAM,KAAK,GAAG;oBAClC,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI;sBACrB,CAAC,IAAI,6BAAM,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC;sBAClE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC;sBAChC,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,yEAAqB,KAAK,MAAM;wBACpD,OAAO;OAW3B;IAFG,gDAA0B;IAC1B;uBAhBgB;mBARR,CAAC,yEAAqB,CAAC,EAAE;sBACtB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,yEAAqB,KAAK,IAAI;sBACpD,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI;SAMF;oBACnB,CAAC,IAAI,6BAAM,EAAE,KAAK,EAAE,MAAM,KAAK,GAAG;oBAClC,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI;sBACrB,CAAC,IAAI,6BAAM,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC;sBAClE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC;sBAChC,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,yEAAqB,KAAK,MAAM;wBACpD,OAAO;MAUF;IAG1B;;;;;;OAMG;IACH,wBAJW,OAAO,iBAAiB,EAAE,QAAQ,GAAG,OAAO,iBAAiB,EAAE,UAAU,UACzE,MAAM,GACJ,OAAO,6BAAM,CA0CzB;IAED;;;;OAIG;IACH,qBAFW,MAAM,iBAehB;CACJ"}

package/dist/src/view/containerMutationHelper.js

@@ -0,0 +1,114 @@
+import {
+    initializeViewSubtree,
+    loadViewSubtreeData,
+} from "../data/flowInit.js";
+import { configureViewOpacity } from "../genomeSpy/viewHierarchyConfig.js";
+import { finalizeSubtreeGraphics } from "./viewUtils.js";
+
+/**
+ * Shared helper for dynamic container mutations.
+ * Encapsulates the common lifecycle for adding/removing child views.
+ */
+export default class ContainerMutationHelper {
+    /**
+     * @typedef {import("./view.js").default} View
+     * @typedef {import("../spec/view.js").ViewSpec} ViewSpec
+     * @typedef {import("../spec/view.js").ImportSpec} ImportSpec
+     *
+     * @typedef {{
+     *   specs: (ViewSpec | ImportSpec)[],
+     *   insertAt: (index: number, spec: ViewSpec | ImportSpec) => void,
+     *   removeAt: (index: number) => void
+     * }} ChildSpecs
+     */
+
+    /**
+     * @typedef {{
+     *   getChildSpecs: () => ChildSpecs,
+     *   insertView: (view: View, index: number) => any,
+     *   removeView: (index: number) => void,
+     *   prepareView?: (view: View, index: number, insertionResult: any) => Promise<void>,
+     *   afterRemove?: (index: number) => Promise<void>,
+     *   defaultName?: (index: number, spec: ViewSpec | ImportSpec) => string,
+     *   requestLayout?: boolean
+     * }} MutationOptions
+     */
+
+    /**
+     * @param {import("./containerView.js").default} container
+     * @param {MutationOptions} options
+     */
+    constructor(container, options) {
+        this.container = container;
+        this.options = options;
+    }
+
+    /**
+     * Adds a child spec dynamically and initializes its subtree dataflow.
+     *
+     * @param {import("../spec/view.js").ViewSpec | import("../spec/view.js").ImportSpec} childSpec
+     * @param {number} [index]
+     * @returns {Promise<View>}
+     */
+    async addChildSpec(childSpec, index) {
+        const { specs, insertAt } = this.options.getChildSpecs();
+        const insertIndex = index ?? specs.length;
+        const name =
+            this.options.defaultName?.(insertIndex, childSpec) ??
+            "child" + specs.length;
+
+        const childView = await this.container.context.createOrImportView(
+            childSpec,
+            this.container,
+            this.container,
+            name
+        );
+
+        insertAt(insertIndex, childSpec);
+        const insertionResult = this.options.insertView(childView, insertIndex);
+
+        if (this.options.prepareView) {
+            await this.options.prepareView(
+                childView,
+                insertIndex,
+                insertionResult
+            );
+        }
+
+        configureViewOpacity(childView);
+
+        const { dataSources, graphicsPromises } = initializeViewSubtree(
+            childView,
+            this.container.context.dataFlow
+        );
+        await loadViewSubtreeData(childView, dataSources);
+        await finalizeSubtreeGraphics(graphicsPromises);
+
+        if (this.options.requestLayout !== false) {
+            this.container.invalidateSizeCache();
+            this.container.context.requestLayoutReflow();
+        }
+
+        return childView;
+    }
+
+    /**
+     * Removes a child by index and updates the backing spec list.
+     *
+     * @param {number} index
+     */
+    async removeChildAt(index) {
+        const { removeAt } = this.options.getChildSpecs();
+        this.options.removeView(index);
+        removeAt(index);
+
+        if (this.options.afterRemove) {
+            await this.options.afterRemove(index);
+        }
+
+        if (this.options.requestLayout !== false) {
+            this.container.invalidateSizeCache();
+            this.container.context.requestLayoutReflow();
+        }
+    }
+}

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

@@ -14,13 +14,6 @@ export default class ContainerView extends View {
     constructor(spec: import("../spec/view.js").ContainerSpec, context: import("../types/viewContext.js").default, layoutParent: ContainerView, dataParent: import("./view.js").default, name: string, options?: import("./view.js").ViewOptions);
     spec: import("../spec/view.js").ContainerSpec;
     initializeChildren(): Promise<void>;
-    /**
-     * Replaces a child view with another one. Does not alter the old or new child.
-     *
-     * @param {import("./view.js").default} child
-     * @param {import("./view.js").default} replacement
-     */
-    replaceChild(child: import("./view.js").default, replacement: import("./view.js").default): void;
     /**
      * @param {string[]} path An array of view names
      * @returns {View}

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

@@ -1 +1 @@
-{"version":3,"file":"containerView.d.ts","sourceRoot":"","sources":["../../../src/view/containerView.js"],"names":[],"mappings":"AAEA;;GAEG;AACH;IACI;;;;;;;;OAQG;IACH,kBAPW,OAAO,iBAAiB,EAAE,aAAa,WACvC,OAAO,yBAAyB,EAAE,OAAO,gBACzC,aAAa,cACb,OAAO,WAAW,EAAE,OAAO,QAC3B,MAAM,YACN,OAAO,WAAW,EAAE,WAAW,EAMzC;IADG,8CAAgB;IAGpB,oCAEC;IASD;;;;;OAKG;IACH,oBAHW,OAAO,WAAW,EAAE,OAAO,eAC3B,OAAO,WAAW,EAAE,OAAO,QAIrC;IA+CD;;;OAGG;IACH,2BAHW,MAAM,EAAE,GACN,IAAI,CAYhB;IAED;;;OAGG;IACH,sBAFW,MAAM,QAQhB;IAED;;;OAGG;IACH,2BAFW,MAAM,QAchB;IA1GD;;OAEG;IACH,qBAFa,gBAAgB,CAAC,IAAI,CAAC,CAIlC;CA+GJ;iBA7I4C,WAAW"}
+{"version":3,"file":"containerView.d.ts","sourceRoot":"","sources":["../../../src/view/containerView.js"],"names":[],"mappings":"AAEA;;GAEG;AACH;IACI;;;;;;;;OAQG;IACH,kBAPW,OAAO,iBAAiB,EAAE,aAAa,WACvC,OAAO,yBAAyB,EAAE,OAAO,gBACzC,aAAa,cACb,OAAO,WAAW,EAAE,OAAO,QAC3B,MAAM,YACN,OAAO,WAAW,EAAE,WAAW,EAMzC;IADG,8CAAgB;IAGpB,oCAEC;IAsDD;;;OAGG;IACH,2BAHW,MAAM,EAAE,GACN,IAAI,CAYhB;IAED;;;OAGG;IACH,sBAFW,MAAM,QAQhB;IAED;;;OAGG;IACH,2BAFW,MAAM,QAchB;IAhGD;;OAEG;IACH,qBAFa,gBAAgB,CAAC,IAAI,CAAC,CAIlC;CAqGJ;iBAnI4C,WAAW"}

package/dist/src/view/containerView.js

@@ -30,16 +30,6 @@ export default class ContainerView extends View {
         // override
     }
 
-    /**
-     * Replaces a child view with another one. Does not alter the old or new child.
-     *
-     * @param {import("./view.js").default} child
-     * @param {import("./view.js").default} replacement
-     */
-    replaceChild(child, replacement) {
-        throw new Error("Not implemented");
-    }
-
     /**
      * Visits child views in depth-first pre-order. Terminates the search and returns
      * the value if the visitor returns a defined value. The `afterChildren` callback

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

@@ -1 +1 @@
-{"version":3,"file":"facetView.d.ts","sourceRoot":"","sources":["../../../src/view/facetView.js"],"names":[],"mappings":"AAmDA;;;;;;;;;;;;;;GAcG;AACH;IACI;;;;;;;OAOG;IACH;;;;;;OAMG;IACH,kBALW,OAAO,gBAAgB,EAAE,SAAS,WAClC,OAAO,gBAAgB,EAAE,WAAW,UACpC,aAAa,QACb,MAAM,EA8BhB;IAzBG,UAAgB;IAEhB,WAEC;IAED;;;;OAIG;IACH,aAFU,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,CAYvC;IAED,oDAAoD;IACpD,kBADY,MAAM,CAAC,YAAY,EAAE,cAAc,CAAC,CACa;IA4BjE,sBAIC;IAED;;;OAGG;IACH,qBAFW,KAAK,GAAG,QAAQ,OAwB1B;IAED,qBAyCC;IAED,qBASC;IA6BD,kDAgBC;IAOD;;;;OAIG;IACH,gBAJW,OAAO,4CAA4C,EAAE,OAAO,UAC5D,OAAO,uBAAuB,EAAE,OAAO,YACvC,OAAO,WAAW,EAAE,gBAAgB,QA2L9C;IA3KO,wBAA0B;CA4KrC;2BAhcY,QAAQ,GAAG,KAAK;;;;;;aA4CnB,OAAO,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE;;;0BA1Df,oBAAoB;qBACzB,eAAe"}
+{"version":3,"file":"facetView.d.ts","sourceRoot":"","sources":["../../../src/view/facetView.js"],"names":[],"mappings":"AAmDA;;;;;;;;;;;;;;GAcG;AACH;IACI;;;;;;;OAOG;IACH;;;;;;OAMG;IACH,kBALW,OAAO,gBAAgB,EAAE,SAAS,WAClC,OAAO,gBAAgB,EAAE,WAAW,UACpC,aAAa,QACb,MAAM,EA8BhB;IAzBG,UAAgB;IAEhB,WAEC;IAED;;;;OAIG;IACH,aAFU,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,CAYvC;IAED,oDAAoD;IACpD,kBADY,MAAM,CAAC,YAAY,EAAE,cAAc,CAAC,CACa;IAajE,sBAIC;IAED;;;OAGG;IACH,qBAFW,KAAK,GAAG,QAAQ,OAwB1B;IAED,qBAyCC;IAED,qBASC;IA6BD,kDAgBC;IAOD;;;;OAIG;IACH,gBAJW,OAAO,4CAA4C,EAAE,OAAO,UAC5D,OAAO,uBAAuB,EAAE,OAAO,YACvC,OAAO,WAAW,EAAE,gBAAgB,QA2L9C;IA3KO,wBAA0B;CA4KrC;2BAjbY,QAAQ,GAAG,KAAK;;;;;;aA4CnB,OAAO,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE;;;0BA1Df,oBAAoB;qBACzB,eAAe"}

package/dist/src/view/facetView.js

@@ -120,21 +120,6 @@ export default class FacetView extends ContainerView {
         }
     }
 
-    /**
-     * @param {import("./view.js").default} child
-     * @param {import("./view.js").default} replacement
-     */
-    replaceChild(child, replacement) {
-        if (child !== this.child) {
-            throw new Error("Not my child!");
-        }
-
-        child.disposeSubtree();
-        this.child = /** @type {UnitView | LayerView | DecoratorView} */ (
-            replacement
-        );
-    }
-
     transformData() {
         super.transformData();
         // A hacky solution for updating facets. TODO: Something more robust.

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

@@ -9,6 +9,13 @@ export function createBackground(viewBackground: import("../../spec/view.js").Vi
  */
 export function createBackgroundStroke(viewBackground: import("../../spec/view.js").ViewBackground): import("../../spec/view.js").UnitSpec;
 export default class GridChild {
+    /**
+     * Users guide:
+     * - GridChild is owned by GridView and is not meant to be instantiated or
+     *   managed directly by callers.
+     * - Use GridView/ConcatView APIs for insertion/removal so decorations and
+     *   dataflow are kept in sync.
+     */
     /**
      * @param {import("../view.js").default} view
      * @param {import("../containerView.js").default} layoutParent
@@ -39,6 +46,10 @@ export default class GridChild {
      * Create view decorations, grid lines, axes, etc.
      */
     createAxes(): Promise<void>;
+    /**
+     * Disposes axis and gridline views so axes can be recreated safely.
+     */
+    disposeAxisViews(): void;
     getOverhang(): Padding;
     getOverhangAndPadding(): Padding;
     #private;

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

@@ -1 +1 @@
-{"version":3,"file":"gridChild.d.ts","sourceRoot":"","sources":["../../../../src/view/gridView/gridChild.js"],"names":[],"mappings":"AAkqBA;;;GAGG;AACH,iDAHW,OAAO,oBAAoB,EAAE,cAAc,GACzC,OAAO,oBAAoB,EAAE,QAAQ,CA8BjD;AAED;;;GAGG;AACH,uDAHW,OAAO,oBAAoB,EAAE,cAAc,GACzC,OAAO,oBAAoB,EAAE,QAAQ,CA6CjD;AAhuBD;IACI;;;;OAIG;IACH,kBAJW,OAAO,YAAY,EAAE,OAAO,gBAC5B,OAAO,qBAAqB,EAAE,OAAO,UACrC,MAAM,EAyFhB;IAtFG,oDAAgC;IAChC,mCAAgB;IAChB,eAAoB;IAEpB,uBAAuB;IACvB,YADW,QAAQ,CACQ;IAE3B,uBAAuB;IACvB,kBADW,QAAQ,CACc;IAEjC,sFAAsF;IACtF,MADW,OAAO,CAAC,MAAM,CAAC,OAAO,oBAAoB,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,CAC/D;IAEd,+FAA+F;IAC/F,WADW,OAAO,CAAC,MAAM,CAAC,OAAO,oBAAoB,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC,CAC9D;IAEnB,mFAAmF;IACnF,YADW,OAAO,CAAC,MAAM,CAAC,OAAO,gBAAgB,EAAE,eAAe,EAAE,SAAS,CAAC,CAAC,CAC3D;IAEpB,4BAA4B;IAC5B,eADW,aAAa,CACM;IAE9B,uBAAuB;IACvB,OADW,QAAQ,CACG;IAEtB,wBAAwB;IACxB,QADW,SAAS,CACQ;IAoZhC,sEAiBC;IAED;;OAEG;IACH,4BAsKC;IAED,uBAqBC;IAED,iCAEC;;CACJ;qBAjpBoB,gBAAgB;qBANK,gBAAgB;yBADjC,oBAAoB;sBAQvB,gBAAgB;0BACZ,oBAAoB;sBAJxB,wBAAwB;oBAF1B,sBAAsB"}
+{"version":3,"file":"gridChild.d.ts","sourceRoot":"","sources":["../../../../src/view/gridView/gridChild.js"],"names":[],"mappings":"AA4rBA;;;GAGG;AACH,iDAHW,OAAO,oBAAoB,EAAE,cAAc,GACzC,OAAO,oBAAoB,EAAE,QAAQ,CA8BjD;AAED;;;GAGG;AACH,uDAHW,OAAO,oBAAoB,EAAE,cAAc,GACzC,OAAO,oBAAoB,EAAE,QAAQ,CA6CjD;AA1vBD;IACI;;;;;;OAMG;IAEH;;;;OAIG;IACH,kBAJW,OAAO,YAAY,EAAE,OAAO,gBAC5B,OAAO,qBAAqB,EAAE,OAAO,UACrC,MAAM,EAyFhB;IAtFG,oDAAgC;IAChC,mCAAgB;IAChB,eAAoB;IAEpB,uBAAuB;IACvB,YADW,QAAQ,CACQ;IAE3B,uBAAuB;IACvB,kBADW,QAAQ,CACc;IAEjC,sFAAsF;IACtF,MADW,OAAO,CAAC,MAAM,CAAC,OAAO,oBAAoB,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,CAC/D;IAEd,+FAA+F;IAC/F,WADW,OAAO,CAAC,MAAM,CAAC,OAAO,oBAAoB,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC,CAC9D;IAEnB,mFAAmF;IACnF,YADW,OAAO,CAAC,MAAM,CAAC,OAAO,gBAAgB,EAAE,eAAe,EAAE,SAAS,CAAC,CAAC,CAC3D;IAEpB,4BAA4B;IAC5B,eADW,aAAa,CACM;IAE9B,uBAAuB;IACvB,OADW,QAAQ,CACG;IAEtB,wBAAwB;IACxB,QADW,SAAS,CACQ;IAoZhC,sEAiBC;IAED;;OAEG;IACH,4BAwKC;IAED;;OAEG;IACH,yBAWC;IAED,uBAqBC;IAED,iCAEC;;CACJ;qBA3qBoB,gBAAgB;qBANK,gBAAgB;yBADjC,oBAAoB;sBAQvB,gBAAgB;0BACZ,oBAAoB;sBAJxB,wBAAwB;oBAF1B,sBAAsB"}