@genome-spy/core 0.65.0 → 0.67.0

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

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

package/dist/src/scales/scaleResolutionConstants.d.ts

@@ -0,0 +1,6 @@
+export const QUANTITATIVE: "quantitative";
+export const ORDINAL: "ordinal";
+export const NOMINAL: "nominal";
+export const LOCUS: "locus";
+export const INDEX: "index";
+//# sourceMappingURL=scaleResolutionConstants.d.ts.map

package/dist/src/scales/scaleResolutionConstants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaleResolutionConstants.d.ts","sourceRoot":"","sources":["../../../src/scales/scaleResolutionConstants.js"],"names":[],"mappings":"AAAA,2BAA4B,cAAc,CAAC;AAC3C,sBAAuB,SAAS,CAAC;AACjC,sBAAuB,SAAS,CAAC;AACjC,oBAAqB,OAAO,CAAC;AAC7B,oBAAqB,OAAO,CAAC"}

package/dist/src/scales/scaleResolutionConstants.js

@@ -0,0 +1,5 @@
+export const QUANTITATIVE = "quantitative";
+export const ORDINAL = "ordinal";
+export const NOMINAL = "nominal";
+export const LOCUS = "locus";
+export const INDEX = "index";

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

@@ -0,0 +1,16 @@
+/**
+ * @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: Channel, dataType: import("../spec/channel.js").Type): import("../spec/scale.js").ScaleType;
+/**
+ * @param {import("../spec/scale.js").Scale} props
+ * @param {Channel} channel
+ */
+export function applyLockedProperties(props: import("../spec/scale.js").Scale, channel: Channel): void;
+export type Channel = import("../spec/channel.js").Channel;
+//# sourceMappingURL=scaleRules.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scaleRules.d.ts","sourceRoot":"","sources":["../../../src/scales/scaleRules.js"],"names":[],"mappings":"AAcA;;GAEG;AAEH;;;;GAIG;AACH,6CAJW,OAAO,YACP,OAAO,oBAAoB,EAAE,IAAI,GAC/B,OAAO,kBAAkB,EAAE,SAAS,CAkEhD;AAED;;;GAGG;AACH,6CAHW,OAAO,kBAAkB,EAAE,KAAK,WAChC,OAAO,QAWjB;sBAvFY,OAAO,oBAAoB,EAAE,OAAO"}

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/utils/domainArray.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"domainArray.d.ts","sourceRoot":"","sources":["../../../src/utils/domainArray.js"],"names":[],"mappings":"AA8KA;;;;GAIG;AACH,2CAHW,MAAM,kBACN,MAAM,EAAE,eAiBlB;AAED;;;;GAIG;AACH,4CAFW,WAAW,GAAG,GAAG,EAAE,SAI7B;AA3MD;;GAEG;AAEH;IACI,cAIC;IAFG,qBAAqB;IACrB,MADW,MAAM,CACI;IAGzB;;;;OAIG;IACH,cAHW,MAAM,GACJ,WAAW,CAIvB;IAED;;;;OAIG;IACH,kBAHW,QAAQ,CAAC,MAAM,CAAC,GACd,WAAW,CAcvB;IAED;;;;;OAKG;IACH,sBAFa,CAAC,UAHH,QAAQ,CAAC,CAAC,CAAC,aACX,CAAS,IAAC,EAAD,CAAC,KAAE,MAAM,GAChB,WAAW,CASvB;CACJ;AAED;IAoBgB,UAAe;IAEf,UAAe;CAS9B;AAED;;GAEG;AACH;IAKQ,0BAA0B;IAC1B,cADW,GAAG,CAAC,MAAM,CAAC,CACO;CAoBpC;AAED;CAKC;AAED;IACI;;;OAGG;IACH,2BAFW,MAAM,EAAE,EAiBlB;CAgBJ;qBAhKY,OAAO,GAAG,MAAM,GAAG,MAAM"}
+{"version":3,"file":"domainArray.d.ts","sourceRoot":"","sources":["../../../src/utils/domainArray.js"],"names":[],"mappings":"AAiLA;;;;GAIG;AACH,2CAHW,MAAM,kBACN,MAAM,EAAE,eAiBlB;AAED;;;;GAIG;AACH,4CAFW,WAAW,GAAG,GAAG,EAAE,SAI7B;AA9MD;;GAEG;AAKH;IACI,cAIC;IAFG,qBAAqB;IACrB,MADW,MAAM,CACI;IAGzB;;;;OAIG;IACH,cAHW,MAAM,GACJ,WAAW,CAIvB;IAED;;;;OAIG;IACH,kBAHW,QAAQ,CAAC,MAAM,CAAC,GACd,WAAW,CAcvB;IAED;;;;;OAKG;IACH,sBAFa,CAAC,UAHH,QAAQ,CAAC,CAAC,CAAC,aACX,CAAS,IAAC,EAAD,CAAC,KAAE,MAAM,GAChB,WAAW,CASvB;CACJ;AAED;IAoBgB,UAAe;IAEf,UAAe;CAS9B;AAED;;GAEG;AACH;IAKQ,0BAA0B;IAC1B,cADW,GAAG,CAAC,MAAM,CAAC,CACO;CAoBpC;AAED;CAKC;AAED;IACI;;;OAGG;IACH,2BAFW,MAAM,EAAE,EAiBlB;CAgBJ;qBAnKY,OAAO,GAAG,MAAM,GAAG,MAAM"}

package/dist/src/utils/domainArray.js

@@ -2,6 +2,9 @@
  * @typedef {boolean | number | string} scalar
  */
 
+// DomainArray tracks categorical order for scale domain extraction.
+// For rendering, ScaleResolution maintains a stable Indexer to prevent
+// categorical indices from changing across updates.
 export class DomainArray /** @type {Array<scalar>} */ extends Array {
     constructor() {
         super();

package/dist/src/utils/indexer.d.ts

@@ -1,6 +1,9 @@
 /**
  * Assigns unique values an index number in the order they are encountered.
  *
+ * Used to keep categorical GPU encodings stable: once a value gets an index,
+ * it must never change for the lifetime of the owning scale.
+ *
  * TODO: What about undefined?
  *
  * @template T

package/dist/src/utils/indexer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"indexer.d.ts","sourceRoot":"","sources":["../../../src/utils/indexer.js"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,sCAFa,CAAC;YAYE,CAAC;qBAeD,QAAQ,CAAC,CAAC,CAAC;kBAOX,MAAM;;EAYrB"}
+{"version":3,"file":"indexer.d.ts","sourceRoot":"","sources":["../../../src/utils/indexer.js"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,sCAFa,CAAC;YAYE,CAAC;qBAeD,QAAQ,CAAC,CAAC,CAAC;kBAOX,MAAM;;EAYrB"}

package/dist/src/utils/indexer.js

@@ -1,6 +1,9 @@
 /**
  * Assigns unique values an index number in the order they are encountered.
  *
+ * Used to keep categorical GPU encodings stable: once a value gets an index,
+ * it must never change for the lifetime of the owning scale.
+ *
  * TODO: What about undefined?
  *
  * @template T

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,CA8CzB;IAED;;;;OAIG;IACH,qBAFW,MAAM,iBAehB;CACJ"}

package/dist/src/view/containerMutationHelper.js

@@ -0,0 +1,118 @@
+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 visibilityPredicate = (
+            /** @type {import("./view.js").default} */ view
+        ) => view.isConfiguredVisible();
+        const { dataSources, graphicsPromises } = initializeViewSubtree(
+            childView,
+            this.container.context.dataFlow,
+            visibilityPredicate
+        );
+        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