@configura/web-api 1.3.0-alpha.0 → 1.3.0-alpha.4

package/dist/productConfiguration/CfgFeature.js

@@ -1,451 +1,483 @@
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-import { compareArrays, count, Observable, someMatch, } from "@configura/web-utilities";
-import { CfgProduct } from "../CfgProduct.js";
-import { CfgMtrlApplication } from "../material/CfgMtrlApplication.js";
-import { CfgMtrlApplicationSource } from "../material/CfgMtrlApplicationSource.js";
-import { CfgOption, ProductConfigurationBubbleMode } from "./CfgOption.js";
-import { getMtrlPreview } from "./utilitiesProductConfiguration.js";
-export var SelectionType;
-(function (SelectionType) {
-    /// All options are permanently selected. In our ui-component for this we skip over this level,
-    /// and immediately show the children, but you could do this differently, like for instance
-    /// showing the group heading.
-    SelectionType[SelectionType["Group"] = 0] = "Group";
-    /// One and only one can be selected at a time. This normally corresponds to either a dropdown
-    /// menu or radio buttons.
-    SelectionType[SelectionType["SelectOne"] = 1] = "SelectOne";
-    /// Zero to all can be selected at a time. This normally corresponds to checkboxes.
-    SelectionType[SelectionType["SelectMany"] = 2] = "SelectMany";
-})(SelectionType || (SelectionType = {}));
-function getOptionFilter(option1) {
-    return (option2) => option2._internal === option1;
-}
-/// Returns a fresh reference for the option at the given index
-function doFreshRefOptionAtIndex(options, index, beforeNotify) {
-    const freshRef = CfgOption._makeNewRefFrom(options[index]._internal);
-    options[index] = freshRef;
-    if (beforeNotify) {
-        beforeNotify(freshRef);
-    }
-    freshRef._internal.changeObservable.notifyAll({ freshRef });
-    return freshRef;
-}
-/// Returns a fresh reference for the given option.
-/// Throws an error if the option is not found in options.
-function doFreshRefOption(options, optionInternal, beforeNotify) {
-    const i = options.findIndex(getOptionFilter(optionInternal));
-    if (i === -1) {
-        throw new Error("Did not find the option in options");
-    }
-    return doFreshRefOptionAtIndex(options, i, beforeNotify);
-}
-/// This class is meant to only be used through CfgFeature. It should
-/// never be instantiated on its own. Normally the internal state of this class
-/// should never be directly modified. CfgFeature is the class that
-/// should be used and interacted with.
-export class _CfgFeatureInternal {
-    constructor(rawFeature, allRawFeatures, key, // Unique amongst siblings
-    parent, parentProduct, rootProduct) {
-        this.rawFeature = rawFeature;
-        this.allRawFeatures = allRawFeatures;
-        this.key = key;
-        this.parent = parent;
-        this.parentProduct = parentProduct;
-        this.rootProduct = rootProduct;
-        this._selectedOptions = [];
-        this.changeObservable = new Observable();
-        this._notifyAllOfChange = (bubbleMode) => __awaiter(this, void 0, void 0, function* () {
-            if (bubbleMode === ProductConfigurationBubbleMode.Stop) {
-                return;
-            }
-            const parent = this.parent;
-            const freshRef = CfgFeature._makeNewRefFrom(this);
-            this.changeObservable.notifyAll({ freshRef });
-            if (parent !== undefined) {
-                yield parent._childHasChanged(freshRef, bubbleMode === ProductConfigurationBubbleMode.OneLevel
-                    ? ProductConfigurationBubbleMode.Stop
-                    : bubbleMode);
-            }
-        });
-        /// Called by child to tell its parent that it has changed.
-        /// Will throw if options have not yet been generated. This should be impossible
-        /// as nonexisting children can not call their parent.
-        this._childHasChanged = (childOption, bubbleMode) => __awaiter(this, void 0, void 0, function* () {
-            const options = this._options;
-            if (options === undefined) {
-                throw Error("Child says it changed, but no children has actually been generated");
-            }
-            const freshRef = doFreshRefOption(options, childOption);
-            const selectedOptions = this._selectedOptions;
-            const i = selectedOptions.findIndex(getOptionFilter(childOption));
-            if (i !== -1) {
-                selectedOptions[i] = freshRef;
-            }
-            yield this._notifyAllOfChange(bubbleMode);
-        });
-        this.getApiSelection = () => {
-            const result = {};
-            for (const option of this._selectedOptions) {
-                result[option.code] = option._internal.getApiSelection();
-            }
-            return result;
-        };
-        this.setApiSelection = (apiOptionSelectionMap) => __awaiter(this, void 0, void 0, function* () {
-            const selectionType = this.selectionType;
-            const isGroup = selectionType === SelectionType.Group;
-            const isSelectOne = selectionType === SelectionType.SelectOne;
-            const isAllOptionsAffectedByAnySelection = this.isAllOptionsAffectedByAnySelection;
-            let options;
-            if (apiOptionSelectionMap === undefined) {
-                options = this._options || []; // Already generated children (all or none)
-                apiOptionSelectionMap = {};
-            }
-            else {
-                options = this.options; // This will generate all children
-            }
-            let change = false;
-            for (let i = 0; i < options.length; i++) {
-                const option = options[i];
-                const apiOptionSelection = apiOptionSelectionMap[option.code];
-                const selectedIndex = this._selectedOptions.findIndex(getOptionFilter(option._internal));
-                const isOn = isGroup || apiOptionSelection;
-                if (isOn) {
-                    if (selectedIndex === -1) {
-                        if (isAllOptionsAffectedByAnySelection) {
-                            this._selectedOptions.push(option);
-                        }
-                        else {
-                            doFreshRefOptionAtIndex(options, i, (freshRef) => this._selectedOptions.push(freshRef));
-                        }
-                        change = true;
-                    }
-                }
-                else {
-                    if (selectedIndex !== -1) {
-                        this._selectedOptions.splice(selectedIndex, 1);
-                        if (!isAllOptionsAffectedByAnySelection) {
-                            doFreshRefOptionAtIndex(options, i);
-                        }
-                        change = true;
-                    }
-                }
-                if (isOn && (yield option._internal.setApiSelection(apiOptionSelection))) {
-                    change = true;
-                }
-            }
-            const selectionCount = this._selectedOptions.length;
-            if (isSelectOne && selectionCount !== 1) {
-                const wrongCountWarning = `A select-one Feature (i.e. neither optional nor multiple) should have exactly one Option selected. Feature key: "${this.key}". Actual: ${selectionCount}`;
-                if (this.rootProduct.settings.strictSelectOneSelectionCount) {
-                    throw new Error(wrongCountWarning);
-                }
-                else {
-                    console.warn(wrongCountWarning);
-                }
-            }
-            if (!isGroup) {
-                const apiSelectionCount = Object.keys(apiOptionSelectionMap).length;
-                if (selectionCount !== apiSelectionCount) {
-                    const wrongCountWarning = `All provided Options are expected to be selected. Feature key: "${this.key}". Expected: ${apiSelectionCount} Actual: ${selectionCount}`;
-                    if (this.rootProduct.settings.strictSetApiSelectionMatch) {
-                        throw new Error(wrongCountWarning);
-                    }
-                    else {
-                        console.warn(wrongCountWarning);
-                    }
-                }
-            }
-            if (change) {
-                if (isAllOptionsAffectedByAnySelection) {
-                    this._freshRefAllOptions();
-                }
-                // setApiSelection works its way top down and handles notifications on
-                // each level by looking at change returned from its children. That way
-                // we do not get multiple notifications for the same ancestral node even
-                // if multiple descendants are affected by the setApiSelection. Therefore
-                // we use OneLevel to make this feature notify and the parent update its
-                // reference.
-                yield this._notifyAllOfChange(ProductConfigurationBubbleMode.OneLevel);
-            }
-            return change;
-        });
-        this.structureCompare = (other, strictOrder = true, descriptionMatch = false) => this.keyMatch(other, descriptionMatch) &&
-            compareArrays(this.options, other.options, (l, r) => l._internal.structureCompare(r._internal, strictOrder, descriptionMatch), strictOrder);
-        this.tryMatchSelection = (other, descriptionMatch = false) => __awaiter(this, void 0, void 0, function* () {
-            const selectionType = this.selectionType;
-            if (selectionType !== other.selectionType) {
-                // Will not try if the selection type is different
-                return false;
-            }
-            const thisOptions = this.options;
-            const otherOptions = other.options;
-            const change = (yield Promise.all(otherOptions.map((otherO) => (() => __awaiter(this, void 0, void 0, function* () {
-                const otherOSelected = otherO.selected;
-                if (selectionType === SelectionType.SelectOne && !otherOSelected) {
-                    return false;
-                }
-                if (1 <
-                    count(otherOptions, (item) => item._internal.keyMatch(otherO._internal, descriptionMatch))) {
-                    console.warn("tryMatchSelection will ignore options that have the same key");
-                    return false;
-                }
-                const toTryChangeOptions = thisOptions.filter((o) => otherO._internal.keyMatch(o._internal, descriptionMatch));
-                if (1 < toTryChangeOptions.length) {
-                    console.warn("tryMatchSelection will ignore options that have the same key");
-                    return false;
-                }
-                if (toTryChangeOptions.length === 0) {
-                    return false;
-                }
-                const toTryChangeOption = toTryChangeOptions[0];
-                let change = false;
-                if (selectionType === SelectionType.SelectMany ||
-                    selectionType === SelectionType.SelectOne) {
-                    // The setSelected will only affect ourselves,
-                    // so we do not need to bubble the notification.
-                    // Instead we use the change variable to know
-                    // when to notify for this feature.
-                    change = yield toTryChangeOption._internal.parent.selectOption(toTryChangeOption._internal, otherOSelected, ProductConfigurationBubbleMode.Stop);
-                }
-                if (otherOSelected &&
-                    (yield toTryChangeOption._internal.tryMatchSelection(otherO, descriptionMatch))) {
-                    change = true;
-                }
-                return change;
-            }))()))).some((b) => b);
-            if (change) {
-                // tryMatchSelection works its way top down and handles notifications on
-                // each level by looking at change returned from its children. That way
-                // we do not get multiple notifications for the same ancestral node even
-                // if multiple descendants are affected by the tryMatchSelection. Therefore
-                // we use OneLevel to make this feature notify and the parent update its
-                // reference.
-                yield this._notifyAllOfChange(ProductConfigurationBubbleMode.OneLevel);
-            }
-            return change;
-        });
-        /// Normally this is used through methods on CfgFeature and CfgOption. Use this
-        /// internal version if you need to control the bubbleMode.
-        /// Using a validate bubbleMode will cause validation calls to the server.
-        this.selectOption = (optionInternal, on, bubbleMode) => __awaiter(this, void 0, void 0, function* () {
-            if (!on) {
-                if (this.selectionType === SelectionType.Group) {
-                    throw new Error(`Multiple features are always selected and are not user selectable. Feature key: "${this.key}".`);
-                }
-                if (this.selectionType === SelectionType.SelectOne) {
-                    // Select one can never be deselected. However, propagate can
-                    // make calls with deselect ending up here. We simply ignore them.
-                    return false;
-                }
-            }
-            const selectedOptions = this._selectedOptions;
-            const isAllOptionsAffectedByAnySelection = this.isAllOptionsAffectedByAnySelection;
-            const index = selectedOptions.findIndex(getOptionFilter(optionInternal));
-            if ((index !== -1) === on) {
-                return false;
-            }
-            if (on) {
-                // Calling this.options will populate (generate) all Options if they have not yet
-                // been generated. As we are selecting an option we need all Options to be generated.
-                const options = this.options;
-                if (this.selectionType === SelectionType.SelectOne) {
-                    let removeOption = selectedOptions.shift();
-                    while (removeOption !== undefined) {
-                        if (!isAllOptionsAffectedByAnySelection) {
-                            doFreshRefOption(options, removeOption._internal);
-                        }
-                        removeOption = selectedOptions.shift();
-                    }
-                }
-                if (isAllOptionsAffectedByAnySelection) {
-                    selectedOptions.push(CfgOption._makeNewRefFrom(optionInternal));
-                }
-                else {
-                    doFreshRefOption(options, optionInternal, (freshRef) => selectedOptions.push(freshRef));
-                }
-            }
-            else {
-                selectedOptions.splice(index, 1);
-                if (!isAllOptionsAffectedByAnySelection) {
-                    // Accessing this._options gives us the Options that have been generated
-                    // or undefined if the Options have not yet been generated. As this action
-                    // is deselect and deselected is the default uninitialized state we can
-                    // safely ignore if undefined.
-                    const options = this._options;
-                    if (options !== undefined) {
-                        doFreshRefOption(options, optionInternal);
-                    }
-                }
-            }
-            if (isAllOptionsAffectedByAnySelection) {
-                this._freshRefAllOptions();
-            }
-            // If this was a deselect action we shall not bubble selected, that is, we shall not
-            // select the ancestors if this action was deselect.
-            yield this._notifyAllOfChange(!on && bubbleMode === ProductConfigurationBubbleMode.ValidateAndBubbleSelected
-                ? ProductConfigurationBubbleMode.Validate
-                : bubbleMode);
-            return true;
-        });
-        this.isSelected = (option) => this.selectionType === SelectionType.Group ||
-            this._selectedOptions.some(getOptionFilter(option));
-        this.keyMatch = (other, descriptionMatch = false) => descriptionMatch
-            ? this.description.toLowerCase() === other.description.toLowerCase()
-            : this.code === other.code;
-        /// Only in selected options
-        this._getFeaturesWithCode = (code) => this._selectedOptions.reduce((agg, selectedOption) => {
-            agg.push(...selectedOption._internal._getFeaturesWithCode(code));
-            return agg;
-        }, code === this.code ? [this] : []);
-        if (rawFeature.multiple) {
-            this.selectionType = SelectionType.Group;
-        }
-        else if (rawFeature.optional) {
-            this.selectionType = SelectionType.SelectMany;
-        }
-        else {
-            this.selectionType = SelectionType.SelectOne;
-        }
-        this.hasUpcharge = rawFeature.options.some((option) => (option.upcharge !== undefined && option.upcharge !== 0) ||
-            (option.priceCodes !== undefined && option.priceCodes.length > 0));
-    }
-    get code() {
-        return this.rawFeature.code;
-    }
-    get groupCode() {
-        return this.rawFeature.groupCode;
-    }
-    get description() {
-        return this.rawFeature.description;
-    }
-    get mtrlApplications() {
-        if (this._mtrlApplications === undefined) {
-            this._mtrlApplications = (this.rawFeature.mtrlApplications || []).map((m) => CfgMtrlApplication.fromMtrlLikeApplication(CfgMtrlApplicationSource.Feature, m));
-        }
-        return this._mtrlApplications;
-    }
-    get selectedOptions() {
-        return this._selectedOptions;
-    }
-    /// If one option is selected or deselected this will potentially
-    /// affect all other Options on this Feature
-    get isAllOptionsAffectedByAnySelection() {
-        return this.selectionType === SelectionType.SelectOne && this.hasUpcharge !== false;
-    }
-    get preview() {
-        return getMtrlPreview(this._mtrlApplications);
-    }
-    get visibleIfAdditionalProduct() {
-        return this.rawFeature.hideIfAdditionalProduct !== true;
-    }
-    get visibleIfMainProduct() {
-        return this.rawFeature.hideIfMainProduct !== true;
-    }
-    get visible() {
-        return this.parentProduct.isAdditionalProduct
-            ? this.visibleIfAdditionalProduct
-            : this.visibleIfMainProduct;
-    }
-    get options() {
-        if (this._options === undefined) {
-            const hasDuplicateDescription = someMatch(this.rawFeature.options, (l, r) => {
-                return l.description.toLowerCase() === r.description.toLowerCase();
-            });
-            this._options = this.rawFeature.options.map((o) => CfgOption.make(o, this, this.allRawFeatures, hasDuplicateDescription, this.parentProduct, this.rootProduct));
-        }
-        return this._options;
-    }
-    /// Make fresh references to all options on this feature.
-    /// Also includes currently selected options.
-    /// Will throw if options have not yet been generated.
-    _freshRefAllOptions() {
-        const options = this._options;
-        const selectedOptions = this._selectedOptions;
-        if (options === undefined) {
-            throw new Error("We expect all options to be generated at freshref");
-        }
-        for (let i = 0; i < options.length; i++) {
-            doFreshRefOptionAtIndex(options, i, (freshRef) => {
-                const selectedIndex = selectedOptions.findIndex(getOptionFilter(freshRef._internal));
-                if (selectedIndex !== -1) {
-                    selectedOptions[selectedIndex] = freshRef;
-                }
-            });
-        }
-    }
-    _freshRefDescendants() {
-        const options = this._options || [];
-        for (let i = 0; i < options.length; i++) {
-            const optionInternal = options[i]._internal;
-            optionInternal._freshRefDescendants();
-            options[i] = CfgOption._makeNewRefFrom(optionInternal);
-        }
-    }
-}
-export class CfgFeature {
-    /// Private constructor and make-method because make new ref requires the constructor to
-    /// take an internal and we don't want those who instantiate CfgFeature to have to be aware
-    /// of the internal.
-    constructor(_internal) {
-        this._internal = _internal;
-        this.isBackedBySame = (other) => this._internal === other._internal;
-        /// Selects the passed Option.
-        /// Only Options belonging to Features that are "select many" can be deselected.
-        /// Calling this will cause a validation call to the server.
-        this.selectOption = (option, on) => __awaiter(this, void 0, void 0, function* () {
-            return yield this._internal.selectOption(option._internal, on, ProductConfigurationBubbleMode.ValidateAndBubbleSelected);
-        });
-        this.isSelected = (option) => this._internal.isSelected(option._internal);
-        this.listenForChange = (l) => this._internal.changeObservable.listen(l);
-        this.stopListenForChange = (l) => this._internal.changeObservable.stopListen(l);
-    }
-    get parentProduct() {
-        return CfgProduct._makeNewRefFrom(this._internal.parentProduct);
-    }
-    get rootProduct() {
-        return CfgProduct._makeNewRefFrom(this._internal.rootProduct);
-    }
-    get selectionType() {
-        return this._internal.selectionType;
-    }
-    get key() {
-        return this._internal.key;
-    }
-    get code() {
-        return this._internal.code;
-    }
-    get groupCode() {
-        return this._internal.groupCode;
-    }
-    get description() {
-        return this._internal.description;
-    }
-    get hasUpcharge() {
-        return this._internal.hasUpcharge;
-    }
-    get selectedOptions() {
-        return this._internal.selectedOptions;
-    }
-    get preview() {
-        return this._internal.preview;
-    }
-    get options() {
-        return this._internal.options;
-    }
-    get visible() {
-        return this._internal.visible;
-    }
-}
-CfgFeature.make = (rawFeature, allRawFeatures, key, parent, parentProduct, rootProduct) => new CfgFeature(new _CfgFeatureInternal(rawFeature, allRawFeatures, key, parent, parentProduct, rootProduct));
-/// Makes an object wrapping the passed object. This is not a clone method,
-/// it is a method to make a new outer reference. Like a shallow copy.
-/// We use this to help frameworks that are built around using equals to detect change.
-CfgFeature._makeNewRefFrom = (internal) => new CfgFeature(internal);
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { compareArrays, count, Observable, someMatch, } from "@configura/web-utilities";
+import { CfgProduct } from "../CfgProduct.js";
+import { CfgMtrlApplication } from "../material/CfgMtrlApplication.js";
+import { CfgMtrlApplicationSource } from "../material/CfgMtrlApplicationSource.js";
+import { CfgOption, ProductConfigurationBubbleMode } from "./CfgOption.js";
+import { _CfgProductConfigurationInternal } from "./CfgProductConfiguration.js";
+import { getMtrlPreview } from "./utilitiesProductConfiguration.js";
+export var SelectionType;
+(function (SelectionType) {
+    /**
+     * All options are permanently selected. In our ui-component for this we skip over this level,
+     * and immediately show the children, but you could do this differently, like for instance
+     * showing the group heading.
+     */
+    SelectionType[SelectionType["Group"] = 0] = "Group";
+    /**
+     * One and only one can be selected at a time. This normally corresponds to either a dropdown
+     * menu or radio buttons.
+     */
+    SelectionType[SelectionType["SelectOne"] = 1] = "SelectOne";
+    /** Zero to all can be selected at a time. This normally corresponds to checkboxes. */
+    SelectionType[SelectionType["SelectMany"] = 2] = "SelectMany";
+})(SelectionType || (SelectionType = {}));
+function getOptionFilter(option1) {
+    return (option2) => option2._internal === option1;
+}
+/** Returns a fresh reference for the option at the given index */
+function doFreshRefOptionAtIndex(options, index, beforeNotify) {
+    const freshRef = CfgOption._makeNewRefFrom(options[index]._internal);
+    options[index] = freshRef;
+    if (beforeNotify) {
+        beforeNotify(freshRef);
+    }
+    freshRef._internal.changeObservable.notifyAll({ freshRef });
+    return freshRef;
+}
+/**
+ * Returns a fresh reference for the given option.
+ * @throws Throws an error if the option is not found in options.
+ */
+function doFreshRefOption(options, optionInternal, beforeNotify) {
+    const i = options.findIndex(getOptionFilter(optionInternal));
+    if (i === -1) {
+        throw new Error("Did not find the option in options");
+    }
+    return doFreshRefOptionAtIndex(options, i, beforeNotify);
+}
+/**
+ * This class is meant to only be used through CfgFeature. It should
+ * never be instantiated on its own. Normally the internal state of this class
+ * should never be directly modified. CfgFeature is the class that
+ * should be used and interacted with.
+ */
+export class _CfgFeatureInternal {
+    constructor(rawFeature, allRawFeatures, key, // Unique amongst siblings
+    parent, parentProduct, rootProduct) {
+        this.rawFeature = rawFeature;
+        this.allRawFeatures = allRawFeatures;
+        this.key = key;
+        this.parent = parent;
+        this.parentProduct = parentProduct;
+        this.rootProduct = rootProduct;
+        this._selectedOptions = [];
+        this.changeObservable = new Observable();
+        this._notifyAllOfChange = (bubbleMode) => __awaiter(this, void 0, void 0, function* () {
+            if (bubbleMode === ProductConfigurationBubbleMode.Stop) {
+                return;
+            }
+            const parent = this.parent;
+            const freshRef = CfgFeature._makeNewRefFrom(this);
+            this.changeObservable.notifyAll({ freshRef });
+            if (parent !== undefined) {
+                yield parent._childHasChanged(freshRef, bubbleMode === ProductConfigurationBubbleMode.OneLevel
+                    ? ProductConfigurationBubbleMode.Stop
+                    : bubbleMode);
+            }
+        });
+        /**
+         * Called by child to tell its parent that it has changed.
+         * @throws Will throw if options have not yet been generated. This should be impossible
+         * as nonexisting children can not call their parent.
+         */
+        this._childHasChanged = (childOption, bubbleMode) => __awaiter(this, void 0, void 0, function* () {
+            const options = this._options;
+            if (options === undefined) {
+                throw Error("Child says it changed, but no children has actually been generated");
+            }
+            const freshRef = doFreshRefOption(options, childOption);
+            const selectedOptions = this._selectedOptions;
+            const i = selectedOptions.findIndex(getOptionFilter(childOption));
+            if (i !== -1) {
+                selectedOptions[i] = freshRef;
+            }
+            yield this._notifyAllOfChange(bubbleMode);
+        });
+        this.getApiSelection = () => {
+            const result = {};
+            for (const option of this._selectedOptions) {
+                result[option.code] = option._internal.getApiSelection();
+            }
+            return result;
+        };
+        this.setApiSelection = (apiOptionSelectionMap) => __awaiter(this, void 0, void 0, function* () {
+            const selectionType = this.selectionType;
+            const isGroup = selectionType === SelectionType.Group;
+            const isSelectOne = selectionType === SelectionType.SelectOne;
+            const isAllOptionsAffectedByAnySelection = this.isAllOptionsAffectedByAnySelection;
+            let options;
+            if (apiOptionSelectionMap === undefined) {
+                options = this._options || []; // Already generated children (all or none)
+                apiOptionSelectionMap = {};
+            }
+            else {
+                options = this.options; // This will generate all children
+            }
+            let change = false;
+            for (let i = 0; i < options.length; i++) {
+                const option = options[i];
+                const apiOptionSelection = apiOptionSelectionMap[option.code];
+                const selectedIndex = this._selectedOptions.findIndex(getOptionFilter(option._internal));
+                const isOn = isGroup || apiOptionSelection;
+                if (isOn) {
+                    if (selectedIndex === -1) {
+                        if (isAllOptionsAffectedByAnySelection) {
+                            this._selectedOptions.push(option);
+                        }
+                        else {
+                            doFreshRefOptionAtIndex(options, i, (freshRef) => this._selectedOptions.push(freshRef));
+                        }
+                        change = true;
+                    }
+                }
+                else {
+                    if (selectedIndex !== -1) {
+                        this._selectedOptions.splice(selectedIndex, 1);
+                        if (!isAllOptionsAffectedByAnySelection) {
+                            doFreshRefOptionAtIndex(options, i);
+                        }
+                        change = true;
+                    }
+                }
+                if (yield option._internal.setApiSelection(apiOptionSelection)) {
+                    change = true;
+                }
+            }
+            if (this.ancestorsSelected) {
+                const selectionCount = this._selectedOptions.length;
+                if (isSelectOne && selectionCount !== 1) {
+                    const wrongCountWarning = `A select-one Feature (i.e. neither optional nor multiple) should have exactly one Option selected. Feature key: "${this.key}". Actual: ${selectionCount}`;
+                    if (this.rootProduct.settings.strictSelectOneSelectionCount) {
+                        throw new Error(wrongCountWarning);
+                    }
+                    else {
+                        console.warn(wrongCountWarning);
+                    }
+                }
+                if (!isGroup) {
+                    const apiSelectionCount = Object.keys(apiOptionSelectionMap).length;
+                    if (selectionCount !== apiSelectionCount) {
+                        const wrongCountWarning = `All provided Options are expected to be selected. Feature key: "${this.key}". Expected: ${apiSelectionCount} Actual: ${selectionCount}`;
+                        if (this.rootProduct.settings.strictSetApiSelectionMatch) {
+                            throw new Error(wrongCountWarning);
+                        }
+                        else {
+                            console.warn(wrongCountWarning);
+                        }
+                    }
+                }
+            }
+            if (change) {
+                if (isAllOptionsAffectedByAnySelection) {
+                    this._freshRefAllOptions();
+                }
+                // setApiSelection works its way top down and handles notifications on
+                // each level by looking at change returned from its children. That way
+                // we do not get multiple notifications for the same ancestral node even
+                // if multiple descendants are affected by the setApiSelection. Therefore
+                // we use OneLevel to make this feature notify and the parent update its
+                // reference.
+                yield this._notifyAllOfChange(ProductConfigurationBubbleMode.OneLevel);
+            }
+            return change;
+        });
+        this.structureCompare = (other, strictOrder = true, descriptionMatch = false) => this.keyMatch(other, descriptionMatch) &&
+            compareArrays(this.options, other.options, (l, r) => l._internal.structureCompare(r._internal, strictOrder, descriptionMatch), strictOrder);
+        this.tryMatchSelection = (other, descriptionMatch = false) => __awaiter(this, void 0, void 0, function* () {
+            const selectionType = this.selectionType;
+            if (selectionType !== other.selectionType) {
+                // Will not try if the selection type is different
+                return false;
+            }
+            const thisOptions = this.options;
+            const otherOptions = other.options;
+            const change = (yield Promise.all(otherOptions.map((otherO) => (() => __awaiter(this, void 0, void 0, function* () {
+                const otherOSelected = otherO.selected;
+                if (selectionType === SelectionType.SelectOne && !otherOSelected) {
+                    return false;
+                }
+                if (1 <
+                    count(otherOptions, (item) => item._internal.keyMatch(otherO._internal, descriptionMatch))) {
+                    console.warn("tryMatchSelection will ignore options that have the same key");
+                    return false;
+                }
+                const toTryChangeOptions = thisOptions.filter((o) => otherO._internal.keyMatch(o._internal, descriptionMatch));
+                if (1 < toTryChangeOptions.length) {
+                    console.warn("tryMatchSelection will ignore options that have the same key");
+                    return false;
+                }
+                if (toTryChangeOptions.length === 0) {
+                    return false;
+                }
+                const toTryChangeOption = toTryChangeOptions[0];
+                let change = false;
+                if (selectionType === SelectionType.SelectMany ||
+                    selectionType === SelectionType.SelectOne) {
+                    // The setSelected will only affect ourselves,
+                    // so we do not need to bubble the notification.
+                    // Instead we use the change variable to know
+                    // when to notify for this feature.
+                    change = yield toTryChangeOption._internal.parent.selectOption(toTryChangeOption._internal, otherOSelected, ProductConfigurationBubbleMode.Stop);
+                }
+                if (otherOSelected &&
+                    (yield toTryChangeOption._internal.tryMatchSelection(otherO, descriptionMatch))) {
+                    change = true;
+                }
+                return change;
+            }))()))).some((b) => b);
+            if (change) {
+                // tryMatchSelection works its way top down and handles notifications on
+                // each level by looking at change returned from its children. That way
+                // we do not get multiple notifications for the same ancestral node even
+                // if multiple descendants are affected by the tryMatchSelection. Therefore
+                // we use OneLevel to make this feature notify and the parent update its
+                // reference.
+                yield this._notifyAllOfChange(ProductConfigurationBubbleMode.OneLevel);
+            }
+            return change;
+        });
+        /**
+         * Normally this is used through methods on CfgFeature and CfgOption. Use this
+         * internal version if you need to control the bubbleMode.
+         * Using a validate bubbleMode will cause validation calls to the server.
+         */
+        this.selectOption = (optionInternal, on, bubbleMode) => __awaiter(this, void 0, void 0, function* () {
+            if (!on) {
+                if (this.selectionType === SelectionType.Group) {
+                    throw new Error(`Multiple features are always selected and are not user selectable. Feature key: "${this.key}".`);
+                }
+                if (this.selectionType === SelectionType.SelectOne) {
+                    // Select one can never be deselected. However, propagate can
+                    // make calls with deselect ending up here. We simply ignore them.
+                    return false;
+                }
+            }
+            const selectedOptions = this._selectedOptions;
+            const isAllOptionsAffectedByAnySelection = this.isAllOptionsAffectedByAnySelection;
+            const index = selectedOptions.findIndex(getOptionFilter(optionInternal));
+            if ((index !== -1) === on) {
+                return false;
+            }
+            if (on) {
+                // Calling this.options will populate (generate) all Options if they have not yet
+                // been generated. As we are selecting an option we need all Options to be generated.
+                const options = this.options;
+                if (this.selectionType === SelectionType.SelectOne) {
+                    let removeOption = selectedOptions.shift();
+                    while (removeOption !== undefined) {
+                        if (!isAllOptionsAffectedByAnySelection) {
+                            doFreshRefOption(options, removeOption._internal);
+                        }
+                        removeOption = selectedOptions.shift();
+                    }
+                }
+                if (isAllOptionsAffectedByAnySelection) {
+                    selectedOptions.push(CfgOption._makeNewRefFrom(optionInternal));
+                }
+                else {
+                    doFreshRefOption(options, optionInternal, (freshRef) => selectedOptions.push(freshRef));
+                }
+            }
+            else {
+                selectedOptions.splice(index, 1);
+                if (!isAllOptionsAffectedByAnySelection) {
+                    // Accessing this._options gives us the Options that have been generated
+                    // or undefined if the Options have not yet been generated. As this action
+                    // is deselect and deselected is the default uninitialized state we can
+                    // safely ignore if undefined.
+                    const options = this._options;
+                    if (options !== undefined) {
+                        doFreshRefOption(options, optionInternal);
+                    }
+                }
+            }
+            if (isAllOptionsAffectedByAnySelection) {
+                this._freshRefAllOptions();
+            }
+            // If this was a deselect action we shall not bubble selected, that is, we shall not
+            // select the ancestors if this action was deselect.
+            yield this._notifyAllOfChange(!on && bubbleMode === ProductConfigurationBubbleMode.ValidateAndBubbleSelected
+                ? ProductConfigurationBubbleMode.Validate
+                : bubbleMode);
+            return true;
+        });
+        this.isSelected = (option) => this.selectionType === SelectionType.Group ||
+            this._selectedOptions.some(getOptionFilter(option));
+        this.keyMatch = (other, descriptionMatch = false) => descriptionMatch
+            ? this.description.toLowerCase() === other.description.toLowerCase()
+            : this.code === other.code;
+        /** Only in selected options */
+        this._getFeaturesWithCode = (code) => this._selectedOptions.reduce((agg, selectedOption) => {
+            agg.push(...selectedOption._internal._getFeaturesWithCode(code));
+            return agg;
+        }, code === this.code ? [this] : []);
+        if (rawFeature.multiple) {
+            this.selectionType = SelectionType.Group;
+        }
+        else if (rawFeature.optional) {
+            this.selectionType = SelectionType.SelectMany;
+        }
+        else {
+            this.selectionType = SelectionType.SelectOne;
+        }
+        this.hasUpcharge = rawFeature.options.some((option) => (option.upcharge !== undefined && option.upcharge !== 0) ||
+            (option.priceCodes !== undefined && option.priceCodes.length > 0));
+    }
+    get code() {
+        return this.rawFeature.code;
+    }
+    get groupCode() {
+        return this.rawFeature.groupCode;
+    }
+    get description() {
+        return this.rawFeature.description;
+    }
+    get mtrlApplications() {
+        if (this._mtrlApplications === undefined) {
+            this._mtrlApplications = (this.rawFeature.mtrlApplications || []).map((m) => CfgMtrlApplication.fromMtrlLikeApplication(CfgMtrlApplicationSource.Feature, m));
+        }
+        return this._mtrlApplications;
+    }
+    get selectedOptions() {
+        return this._selectedOptions;
+    }
+    get ancestorsSelected() {
+        return (this.parent instanceof _CfgProductConfigurationInternal || this.parent.ancestorsSelected);
+    }
+    /**
+     * If one option is selected or deselected this will potentially
+     * affect all other Options on this Feature
+     */
+    get isAllOptionsAffectedByAnySelection() {
+        return this.selectionType === SelectionType.SelectOne && this.hasUpcharge !== false;
+    }
+    get preview() {
+        return getMtrlPreview(this._mtrlApplications);
+    }
+    get visibleIfAdditionalProduct() {
+        return this.rawFeature.hideIfAdditionalProduct !== true;
+    }
+    get visibleIfMainProduct() {
+        return this.rawFeature.hideIfMainProduct !== true;
+    }
+    get visible() {
+        return this.parentProduct.isAdditionalProduct
+            ? this.visibleIfAdditionalProduct
+            : this.visibleIfMainProduct;
+    }
+    get options() {
+        if (this._options === undefined) {
+            const hasDuplicateDescription = someMatch(this.rawFeature.options, (l, r) => {
+                return l.description.toLowerCase() === r.description.toLowerCase();
+            });
+            this._options = this.rawFeature.options.map((o) => CfgOption.make(o, this, this.allRawFeatures, hasDuplicateDescription, this.parentProduct, this.rootProduct));
+        }
+        return this._options;
+    }
+    /**
+     * Make fresh references to all options on this feature.
+     * Also includes currently selected options.
+     * @throws Will throw if options have not yet been generated.
+     */
+    _freshRefAllOptions() {
+        const options = this._options;
+        const selectedOptions = this._selectedOptions;
+        if (options === undefined) {
+            throw new Error("We expect all options to be generated at freshref");
+        }
+        for (let i = 0; i < options.length; i++) {
+            doFreshRefOptionAtIndex(options, i, (freshRef) => {
+                const selectedIndex = selectedOptions.findIndex(getOptionFilter(freshRef._internal));
+                if (selectedIndex !== -1) {
+                    selectedOptions[selectedIndex] = freshRef;
+                }
+            });
+        }
+    }
+    _freshRefDescendants() {
+        const options = this._options || [];
+        for (let i = 0; i < options.length; i++) {
+            const optionInternal = options[i]._internal;
+            optionInternal._freshRefDescendants();
+            options[i] = CfgOption._makeNewRefFrom(optionInternal);
+        }
+    }
+}
+export class CfgFeature {
+    /**
+     * Private constructor and make-method because make new ref requires the constructor to
+     * take an internal and we don't want those who instantiate CfgFeature to have to be aware
+     * of the internal.
+     */
+    constructor(_internal) {
+        this._internal = _internal;
+        this.isBackedBySame = (other) => this._internal === other._internal;
+        /**
+         * Selects the passed Option.
+         * Only Options belonging to Features that are "select many" can be deselected.
+         * Calling this will cause a validation call to the server.
+         */
+        this.selectOption = (option, on) => __awaiter(this, void 0, void 0, function* () {
+            return yield this._internal.selectOption(option._internal, on, ProductConfigurationBubbleMode.ValidateAndBubbleSelected);
+        });
+        this.isSelected = (option) => this._internal.isSelected(option._internal);
+        this.listenForChange = (l) => this._internal.changeObservable.listen(l);
+        this.stopListenForChange = (l) => this._internal.changeObservable.stopListen(l);
+    }
+    get parentProduct() {
+        return CfgProduct._makeNewRefFrom(this._internal.parentProduct);
+    }
+    get rootProduct() {
+        return CfgProduct._makeNewRefFrom(this._internal.rootProduct);
+    }
+    get selectionType() {
+        return this._internal.selectionType;
+    }
+    get key() {
+        return this._internal.key;
+    }
+    get code() {
+        return this._internal.code;
+    }
+    get groupCode() {
+        return this._internal.groupCode;
+    }
+    get description() {
+        return this._internal.description;
+    }
+    get hasUpcharge() {
+        return this._internal.hasUpcharge;
+    }
+    get selectedOptions() {
+        return this._internal.selectedOptions;
+    }
+    /** Are all ancestors up to the CfgProductConfiguration selected? */
+    get ancestorsSelected() {
+        return this._internal.ancestorsSelected;
+    }
+    get preview() {
+        return this._internal.preview;
+    }
+    get options() {
+        return this._internal.options;
+    }
+    get visible() {
+        return this._internal.visible;
+    }
+}
+CfgFeature.make = (rawFeature, allRawFeatures, key, parent, parentProduct, rootProduct) => new CfgFeature(new _CfgFeatureInternal(rawFeature, allRawFeatures, key, parent, parentProduct, rootProduct));
+/**
+ * Makes an object wrapping the passed object. This is not a clone method,
+ * it is a method to make a new outer reference. Like a shallow copy.
+ * We use this to help frameworks that are built around using equals to detect change.
+ */
+CfgFeature._makeNewRefFrom = (internal) => new CfgFeature(internal);