@configura/web-api 2.0.0-alpha.2 → 2.0.0-alpha.20

package/dist/io/CfgWindowMessageToProdConfConnector.d.ts

@@ -1,17 +1,17 @@
-import { DtoConfProd } from "../CatalogueAPI.js";
+import { DtoProductConf } from "../CatalogueAPI.js";
 import { CfgIOProdConfConnector, CfgProdConfMessage, CfgProdConfMessageVersions } from "./CfgIOProdConfConnector.js";
 import { CfgWindowMessageManager } from "./CfgWindowMessageManager.js";
 /**
  * Instantiating this will make Stage send product configuration changes using the post message-API.
  * It will also make Stage listen for incoming product configuration update messages.
  * This can be used to communicate in and out of an iframe for example.
- * @param doValidate Run server side product validation for incoming
  * @param sendVersions What versions of the productConfiguration shall be sent? Multiple can be selected
  * @param includeExtendedDataInSend Only for version 2.0. Includes unit and groupCode.
  * @param includeProdParamsInSend Only for version 2.0. Includes product params, in both main and additional products.
  */
 export declare class CfgWindowMessageToProdConfConnector extends CfgIOProdConfConnector<CfgProdConfMessage> {
-    constructor(manager: CfgWindowMessageManager, doValidate?: boolean, sendVersions?: CfgProdConfMessageVersions, includeExtendedDataInSend?: boolean, includeProdParamsInSend?: boolean);
-    protected makeSendData(conf: DtoConfProd, initial: boolean): CfgProdConfMessage;
+    private _sendVersions;
+    constructor(manager: CfgWindowMessageManager, _sendVersions?: CfgProdConfMessageVersions, includeExtendedDataInSend?: boolean, includeProdParamsInSend?: boolean);
+    protected makeSendData(conf: DtoProductConf, initial: boolean): CfgProdConfMessage;
 }
 //# sourceMappingURL=CfgWindowMessageToProdConfConnector.d.ts.map

package/dist/io/CfgWindowMessageToProdConfConnector.js

@@ -3,16 +3,16 @@ import { CfgIOProdConfConnector, CfgProdConfMessageVersions, } from "./CfgIOProd
  * Instantiating this will make Stage send product configuration changes using the post message-API.
  * It will also make Stage listen for incoming product configuration update messages.
  * This can be used to communicate in and out of an iframe for example.
- * @param doValidate Run server side product validation for incoming
  * @param sendVersions What versions of the productConfiguration shall be sent? Multiple can be selected
  * @param includeExtendedDataInSend Only for version 2.0. Includes unit and groupCode.
  * @param includeProdParamsInSend Only for version 2.0. Includes product params, in both main and additional products.
  */
 export class CfgWindowMessageToProdConfConnector extends CfgIOProdConfConnector {
-    constructor(manager, doValidate = true, sendVersions = CfgProdConfMessageVersions.V2dot0, includeExtendedDataInSend = false, includeProdParamsInSend = false) {
-        super(manager, doValidate, sendVersions, includeExtendedDataInSend, includeProdParamsInSend);
+    constructor(manager, _sendVersions = CfgProdConfMessageVersions.V2dot0, includeExtendedDataInSend = false, includeProdParamsInSend = false) {
+        super(manager, includeExtendedDataInSend, includeProdParamsInSend);
+        this._sendVersions = _sendVersions;
     }
     makeSendData(conf, initial) {
-        return this.makeMessage(conf, initial);
+        return CfgIOProdConfConnector.makeMessage(conf, initial, this._sendVersions);
     }
 }

package/dist/productConfiguration/CfgFeature.d.ts

@@ -1,5 +1,5 @@
 import { LengthUnit, Observable, SingleArgCallback } from "@configura/web-utilities";
-import { DtoConfFeature, DtoFeature, DtoSelectedOption, DtoSyncGroup, DtoSyncGroupMethods } from "../CatalogueAPI.js";
+import { DtoFeature, DtoFeatureConf, DtoSelectedOption, DtoSyncGroup, DtoSyncGroupMethods } from "../CatalogueAPI.js";
 import { CfgProduct, _CfgProductInternal } from "../CfgProduct.js";
 import { CfgMtrlApplication } from "../material/CfgMtrlApplication.js";
 import { SyncCode } from "../syncGroups/SyncGroupsHandler.js";
@@ -32,13 +32,13 @@ export declare type FeatureChangeNotification = {
  */
 export declare class _CfgFeatureInternal {
     readonly rawFeature: DtoFeature;
-    private readonly allRawFeatures;
-    readonly key: string;
+    private readonly rawFeatures;
+    private _key;
     readonly parent: _CfgProductConfigurationInternal | _CfgOptionInternal;
     readonly parentConfiguration: _CfgProductConfigurationInternal;
     readonly parentProduct: _CfgProductInternal;
     readonly rootProduct: _CfgProductInternal;
-    constructor(rawFeature: DtoFeature, allRawFeatures: DtoFeature[], key: string, // Unique amongst siblings
+    constructor(rawFeature: DtoFeature, rawFeatures: DtoFeature[], _key: string, // Unique amongst siblings
     parent: _CfgProductConfigurationInternal | _CfgOptionInternal, parentConfiguration: _CfgProductConfigurationInternal, parentProduct: _CfgProductInternal, rootProduct: _CfgProductInternal);
     readonly selectionType: SelectionType;
     private _options;
@@ -48,6 +48,8 @@ export declare class _CfgFeatureInternal {
     readonly changeObservable: Observable<FeatureChangeNotification>;
     get code(): string;
     get groupCode(): string | undefined;
+    get key(): string;
+    set key(k: string);
     get isUseNumericValue(): boolean;
     get numericValue(): number | undefined;
     setNumericValue: (val: number) => Promise<boolean>;
@@ -99,7 +101,7 @@ export declare class _CfgFeatureInternal {
      * as nonexisting children can not call their parent.
      */
     _childHasChanged: (childOption: _CfgOptionInternal, bubbleMode: ProductConfigurationBubbleMode, committed: boolean) => Promise<void>;
-    getDtoConf: (includeExtendedData: boolean) => DtoConfFeature;
+    getDtoConf: (includeExtendedData: boolean) => DtoFeatureConf;
     setApiSelection: (apiOptionSelectionMap: {
         [index: string]: DtoSelectedOption;
     } | undefined) => Promise<boolean>;
@@ -128,7 +130,7 @@ export declare class _CfgFeatureInternal {
 }
 export declare class CfgFeature {
     readonly _internal: _CfgFeatureInternal;
-    static make(rawFeature: DtoFeature, allRawFeatures: DtoFeature[], key: string, parent: _CfgProductConfigurationInternal | _CfgOptionInternal, parentConfiguration: _CfgProductConfigurationInternal, parentProduct: _CfgProductInternal, rootProduct: _CfgProductInternal): CfgFeature;
+    static make(rawFeature: DtoFeature, rawFeatures: DtoFeature[], key: string, parent: _CfgProductConfigurationInternal | _CfgOptionInternal, parentConfiguration: _CfgProductConfigurationInternal, parentProduct: _CfgProductInternal, rootProduct: _CfgProductInternal): CfgFeature;
     /**
      * 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.

package/dist/productConfiguration/CfgFeature.js

@@ -62,11 +62,11 @@ function doFreshRefOption(options, optionInternal, committed, beforeNotify) {
  * should be used and interacted with.
  */
 export class _CfgFeatureInternal {
-    constructor(rawFeature, allRawFeatures, key, // Unique amongst siblings
+    constructor(rawFeature, rawFeatures, _key, // Unique amongst siblings
     parent, parentConfiguration, parentProduct, rootProduct) {
         this.rawFeature = rawFeature;
-        this.allRawFeatures = allRawFeatures;
-        this.key = key;
+        this.rawFeatures = rawFeatures;
+        this._key = _key;
         this.parent = parent;
         this.parentConfiguration = parentConfiguration;
         this.parentProduct = parentProduct;
@@ -128,6 +128,12 @@ export class _CfgFeatureInternal {
             }
             return result;
         };
+        // DtoFeatureConf is the newer more easily readable format for configuration. As
+        // the API:s are still using the older format (and will for the forseeable future) we need
+        // to support both formats. The new format can be converted to the old, but not the other
+        // way around. For that reason the get-method above uses the new format, and the set-method
+        // below the old format. As these functions are meant to only be used internally this should't
+        // cause too much confusion.
         this.setApiSelection = (apiOptionSelectionMap) => __awaiter(this, void 0, void 0, function* () {
             const selectionType = this.selectionType;
             const isGroup = selectionType === SelectionType.Group;
@@ -407,6 +413,12 @@ export class _CfgFeatureInternal {
     get groupCode() {
         return this.rawFeature.groupCode;
     }
+    get key() {
+        return this._key;
+    }
+    set key(k) {
+        this._key = k;
+    }
     get isUseNumericValue() {
         return this.rawFeature.numericOrder;
     }
@@ -512,7 +524,7 @@ export class _CfgFeatureInternal {
             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.allRawFeatures, hasDuplicateDescription, this, this.parentConfiguration, this.parentProduct, this.rootProduct));
+            this._options = this.rawFeature.options.map((o) => CfgOption.make(o, this.rawFeatures, hasDuplicateDescription, this, this.parentConfiguration, this.parentProduct, this.rootProduct));
         }
         return this._options;
     }
@@ -571,8 +583,8 @@ export class CfgFeature {
         this.listenForChange = (l) => this._internal.changeObservable.listen(l);
         this.stopListenForChange = (l) => this._internal.changeObservable.stopListen(l);
     }
-    static make(rawFeature, allRawFeatures, key, parent, parentConfiguration, parentProduct, rootProduct) {
-        return new this(new _CfgFeatureInternal(rawFeature, allRawFeatures, key, parent, parentConfiguration, parentProduct, rootProduct));
+    static make(rawFeature, rawFeatures, key, parent, parentConfiguration, parentProduct, rootProduct) {
+        return new this(new _CfgFeatureInternal(rawFeature, rawFeatures, key, parent, parentConfiguration, parentProduct, rootProduct));
     }
     /**
      * Makes an object wrapping the passed object. This is not a clone method,
@@ -591,6 +603,7 @@ export class CfgFeature {
     get selectionType() {
         return this._internal.selectionType;
     }
+    // Unique amongst siblings. Can change. Only use for presentation layer i.e. React.
     get key() {
         return this._internal.key;
     }

package/dist/productConfiguration/CfgOption.d.ts

@@ -1,5 +1,5 @@
 import { LengthUnit, Observable, SingleArgCallback } from "@configura/web-utilities";
-import { DtoConfOption, DtoFeature, DtoOption, DtoSelectedOption } from "../CatalogueAPI.js";
+import { DtoFeature, DtoOption, DtoOptionConf, DtoSelectedOption } from "../CatalogueAPI.js";
 import { CfgProduct, _CfgProductInternal } from "../CfgProduct.js";
 import { CfgMtrlApplication } from "../material/CfgMtrlApplication.js";
 import { NumericValuesSelection } from "../utilitiesNumericValues.js";
@@ -60,12 +60,12 @@ export declare enum ProductConfigurationBubbleMode {
  */
 export declare class _CfgOptionInternal {
     readonly rawOption: DtoOption;
-    private readonly allRawFeatures;
+    private readonly rawFeatures;
     readonly parent: _CfgFeatureInternal;
     readonly parentConfiguration: _CfgProductConfigurationInternal;
     readonly parentProduct: _CfgProductInternal;
     readonly rootProduct: _CfgProductInternal;
-    constructor(rawOption: DtoOption, allRawFeatures: DtoFeature[], siblingHasDuplicateDescription: boolean, parent: _CfgFeatureInternal, parentConfiguration: _CfgProductConfigurationInternal, parentProduct: _CfgProductInternal, rootProduct: _CfgProductInternal);
+    constructor(rawOption: DtoOption, rawFeatures: DtoFeature[], siblingHasDuplicateDescription: boolean, parent: _CfgFeatureInternal, parentConfiguration: _CfgProductConfigurationInternal, parentProduct: _CfgProductInternal, rootProduct: _CfgProductInternal);
     private _features;
     private _mtrlApplications;
     readonly key: string;
@@ -89,7 +89,7 @@ export declare class _CfgOptionInternal {
     get features(): CfgFeature[];
     /** Called by child to tell its parent that it has changed. */
     _childHasChanged: (freshRef: CfgFeature, bubbleMode: ProductConfigurationBubbleMode, committed: boolean) => Promise<void>;
-    getDtoConf: (includeExtendedData: boolean) => DtoConfOption;
+    getDtoConf: (includeExtendedData: boolean) => DtoOptionConf;
     setApiSelection: (apiOptionSelection: DtoSelectedOption | undefined) => Promise<boolean>;
     structureCompare: (other: _CfgOptionInternal, strictOrder?: boolean, descriptionMatch?: boolean) => boolean;
     tryMatchSelection: (other: CfgOption, descriptionMatch?: boolean) => Promise<boolean>;
@@ -99,7 +99,7 @@ export declare class _CfgOptionInternal {
 }
 export declare class CfgOption {
     readonly _internal: _CfgOptionInternal;
-    static make(rawOption: DtoOption, allRawFeatures: DtoFeature[], siblingHasDuplicateDescription: boolean, parent: _CfgFeatureInternal, parentConfiguration: _CfgProductConfigurationInternal, parentProduct: _CfgProductInternal, rootProduct: _CfgProductInternal): CfgOption;
+    static make(rawOption: DtoOption, rawFeatures: DtoFeature[], siblingHasDuplicateDescription: boolean, parent: _CfgFeatureInternal, parentConfiguration: _CfgProductConfigurationInternal, parentProduct: _CfgProductInternal, rootProduct: _CfgProductInternal): CfgOption;
     /**
      * 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.

package/dist/productConfiguration/CfgOption.js

@@ -80,9 +80,9 @@ function doesChildrenShareOptionsCode(features) {
  * the class that should be used and interacted with.
  */
 export class _CfgOptionInternal {
-    constructor(rawOption, allRawFeatures, siblingHasDuplicateDescription, parent, parentConfiguration, parentProduct, rootProduct) {
+    constructor(rawOption, rawFeatures, siblingHasDuplicateDescription, parent, parentConfiguration, parentProduct, rootProduct) {
         this.rawOption = rawOption;
-        this.allRawFeatures = allRawFeatures;
+        this.rawFeatures = rawFeatures;
         this.parent = parent;
         this.parentConfiguration = parentConfiguration;
         this.parentProduct = parentProduct;
@@ -132,6 +132,12 @@ export class _CfgOptionInternal {
             }
             return result;
         };
+        // DtoOptionConf is the newer more easily readable format for configuration. As
+        // the API:s are still using the older format (and will for the forseeable future) we need
+        // to support both formats. The new format can be converted to the old, but not the other
+        // way around. For that reason the get-method above uses the new format, and the set-method
+        // below the old format. As these functions are meant to only be used internally this should't
+        // cause too much confusion.
         this.setApiSelection = (apiOptionSelection) => __awaiter(this, void 0, void 0, function* () {
             let features;
             if (apiOptionSelection === undefined) {
@@ -304,7 +310,7 @@ export class _CfgOptionInternal {
     get features() {
         if (this._features === undefined) {
             const allRefs = this.rawOption.featureRefs || [];
-            const features = syncCfgFeatures(allRefs, [], this.allRawFeatures, this, this.parentConfiguration, this.parentProduct, this.rootProduct);
+            const features = syncCfgFeatures(allRefs, [], this.rawFeatures, this, this.parentConfiguration, this.parentProduct, this.rootProduct);
             if (doesChildrenShareOptionsCode(features)) {
                 throw new Error("Stage does not yet properly support Options that has multiple sub-features with overlapping option codes.");
             }
@@ -343,8 +349,8 @@ export class CfgOption {
         this.listenForChange = (l) => this._internal.changeObservable.listen(l);
         this.stopListenForChange = (l) => this._internal.changeObservable.stopListen(l);
     }
-    static make(rawOption, allRawFeatures, siblingHasDuplicateDescription, parent, parentConfiguration, parentProduct, rootProduct) {
-        return new this(new _CfgOptionInternal(rawOption, allRawFeatures, siblingHasDuplicateDescription, parent, parentConfiguration, parentProduct, rootProduct));
+    static make(rawOption, rawFeatures, siblingHasDuplicateDescription, parent, parentConfiguration, parentProduct, rootProduct) {
+        return new this(new _CfgOptionInternal(rawOption, rawFeatures, siblingHasDuplicateDescription, parent, parentConfiguration, parentProduct, rootProduct));
     }
     /**
      * Makes an object wrapping the passed object. This is not a clone method,

package/dist/productConfiguration/CfgProductConfiguration.d.ts

@@ -1,5 +1,5 @@
 import { LengthUnit, LengthValue, Observable, SingleArgCallback } from "@configura/web-utilities";
-import { DtoConfFeature, DtoFeature, DtoFeatureRef, DtoSelectedOption } from "../CatalogueAPI.js";
+import { DtoFeature, DtoFeatureConf, DtoFeatureRef, DtoSelectedOption } from "../CatalogueAPI.js";
 import { CfgProduct, _CfgProductInternal } from "../CfgProduct.js";
 import { CfgFeature, _CfgFeatureInternal } from "./CfgFeature.js";
 import { ProductConfigurationBubbleMode } from "./CfgOption.js";
@@ -17,14 +17,15 @@ export declare type StretchMap = Map<string, {
  * modified. CfgProductConfiguration is the class that should be used and interacted with.
  */
 export declare class _CfgProductConfigurationInternal {
-    readonly allRawFeatures: DtoFeature[];
     readonly parentProduct: _CfgProductInternal;
     readonly rootProduct: _CfgProductInternal;
-    static _makeUninitialized(rootFeatureRefs: DtoFeatureRef[], allRawFeatures: DtoFeature[], // Flat packed. All the features that can appear anyplace in the selection tree.
+    private readonly _initialRootFeatureRefs;
+    static _makeUninitialized(rootFeatureRefs: DtoFeatureRef[], rawFeatures: DtoFeature[], // Flat packed. All the features that can currently appear anyplace in the selection tree.
     parentProduct: _CfgProductInternal, rootProduct: _CfgProductInternal): _CfgProductConfigurationInternal;
     private constructor();
     readonly key = "~";
     private _rootFeatureRefs;
+    readonly accumulatedRawFeatures: DtoFeature[];
     private _features;
     readonly stretchReferenceLengthsByMeasureParamCode: StretchMap;
     readonly changeObservable: Observable<ProductConfigurationChangeNotification>;
@@ -34,10 +35,12 @@ export declare class _CfgProductConfigurationInternal {
     _freshRefDescendants(): void;
     /** Called by child to tell its parent that it has changed. */
     _childHasChanged: (freshRef: CfgFeature, bubbleMode: ProductConfigurationBubbleMode, committed: boolean) => Promise<void>;
-    getDtoConf: (includeExtendedData: boolean) => DtoConfFeature[];
+    getDtoConf: (includeExtendedData: boolean) => DtoFeatureConf[];
+    getApiSelection: () => DtoSelectedOption[];
     /**
      * When used internally the notifications are taken care off by the caller, but if set from
      * outside we want notifications to bubble all the way to the root.
+     * This method will not cause validation calls. Data is assumed to already be validated.
      */
     setApiSelection: (selectedOptions: DtoSelectedOption[], bubbleToRoot: boolean) => Promise<boolean>;
     structureCompare: (other: _CfgProductConfigurationInternal, strictOrder: boolean, descriptionMatch: boolean) => boolean;
@@ -48,7 +51,22 @@ export declare class _CfgProductConfigurationInternal {
     tryMatchSelection: (other: _CfgProductConfigurationInternal, descriptionMatch: boolean | undefined, validate: boolean) => Promise<boolean>;
     /** Only selected features. */
     _getFeaturesWithCode: (code: string) => _CfgFeatureInternal[];
-    populateFeatures: (rootFeatureRefs: DtoFeatureRef[]) => void;
+    /**
+     * Extends the list of loaded potentially used features. Will warn for but ignore duplicates.
+     * Returns true if a change happened.
+     */
+    addRawFeatures: (rawFeatures: DtoFeature[], warnForDuplicates: boolean) => boolean;
+    private _hasRootFeaturesChanged;
+    /**
+     * True if what root Features are used is not the same as at initial load.
+     * This means that functional selection has happened.
+     */
+    get hasRootFeaturesChanged(): boolean;
+    /**
+     * Populates _features based on the passed @param rootFeatureRefs .
+     * @return true if a change happened.
+     */
+    populateFeatures: (rootFeatureRefs: DtoFeatureRef[]) => boolean;
     setStretchReferenceLength: (measureParamCode: string, referenceLength: number | undefined, unit: LengthUnit) => Promise<boolean>;
 }
 export declare class CfgProductConfiguration {
@@ -58,7 +76,7 @@ export declare class CfgProductConfiguration {
      * CfgProductConfiguration, but is not properly initialized until the initDone-callback
      * has been called.
      */
-    static make(initSuccess: (c: CfgProductConfiguration) => void, initFail: (error: Error) => void, rootFeatureRefs: DtoFeatureRef[], allRawFeatures: DtoFeature[], // Flat packed. All the features that can appear anyplace in the selection tree.
+    static make(initSuccess: (c: CfgProductConfiguration) => void, initFail: (error: Error) => void, rootFeatureRefs: DtoFeatureRef[], rawFeatures: DtoFeature[], // Flat packed. All the features that can currently appear anyplace in the selection tree.
     apiSelection: DtoSelectedOption[], parentProduct: _CfgProductInternal, rootProduct: _CfgProductInternal): CfgProductConfiguration;
     /**
      * Makes an object wrapping the passed object. This is not a clone method, it is a method to
@@ -78,11 +96,11 @@ export declare class CfgProductConfiguration {
     get rootProduct(): CfgProduct;
     get key(): string;
     /**
-     * Every (unprocessed) feature which might be used in this product. This is constant for a
-     * product load. What features are actually used is controlled by rootFeatureRefs and what
+     * Every (unprocessed) feature that is currently loaded for this product. This can be extended
+     * by validation calls. What features are actually used is controlled by rootFeatureRefs and what
      * options are selected.
      */
-    get allRawFeatures(): DtoFeature[];
+    get rawFeatures(): DtoFeature[];
     /** What features are used in the root of this. This can change with new validate calls. */
     get rootFeatureRefs(): DtoFeatureRef[];
     /** The root features at the root of the selection tree. */
@@ -94,12 +112,6 @@ export declare class CfgProductConfiguration {
      * This method will cause validation calls.
      */
     tryMatchSelection: (other: CfgProductConfiguration, descriptionMatch?: boolean) => Promise<boolean>;
-    getApiSelection: () => DtoSelectedOption[];
-    /**
-     * This method does not propagate its selections.
-     * This method will not cause validation calls. Data is assumed to already be validated.
-     */
-    setApiSelection: (selectedOptions: DtoSelectedOption[]) => Promise<boolean>;
     /**
      * Set how stretched a certain measure should be measureParamCode is the measure to be
      * stretched referenceLength is a value relative to the initial length of the measure. If the

package/dist/productConfiguration/CfgProductConfiguration.js

@@ -9,7 +9,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 import { compareArrays, count, isEqualLength, isLengthUnit, Observable, toError, toLengthUnit, } from "@configura/web-utilities";
 import { CfgProduct } from "../CfgProduct.js";
-import { convertDtoConfFeaturesToSelOptions } from "../ConfigurationConverter.js";
+import { convertDtoFeatureConfsToSelOptions } from "../ConfigurationConverter.js";
 import { CfgFeature } from "./CfgFeature.js";
 import { ProductConfigurationBubbleMode } from "./CfgOption.js";
 import { syncCfgFeatures } from "./utilitiesProductConfiguration.js";
@@ -19,13 +19,13 @@ import { syncCfgFeatures } from "./utilitiesProductConfiguration.js";
  * modified. CfgProductConfiguration is the class that should be used and interacted with.
  */
 export class _CfgProductConfigurationInternal {
-    constructor(allRawFeatures, // Flat packed. All the features that can appear anyplace in the selection tree.
-    parentProduct, rootProduct) {
-        this.allRawFeatures = allRawFeatures;
+    constructor(rawFeatures, parentProduct, rootProduct, _initialRootFeatureRefs) {
         this.parentProduct = parentProduct;
         this.rootProduct = rootProduct;
+        this._initialRootFeatureRefs = _initialRootFeatureRefs;
         this.key = "~";
         this._rootFeatureRefs = [];
+        this.accumulatedRawFeatures = []; // Flat packed. May be extended in validate calls.
         this._features = [];
         this.changeObservable = new Observable();
         this._notifyAllOfChange = (bubbleMode, committed) => __awaiter(this, void 0, void 0, function* () {
@@ -56,9 +56,11 @@ export class _CfgProductConfigurationInternal {
             yield this._notifyAllOfChange(bubbleMode, committed);
         });
         this.getDtoConf = (includeExtendedData) => this._features.map((f) => f._internal.getDtoConf(includeExtendedData));
+        this.getApiSelection = () => convertDtoFeatureConfsToSelOptions(this.getDtoConf(false), true);
         /**
          * When used internally the notifications are taken care off by the caller, but if set from
          * outside we want notifications to bubble all the way to the root.
+         * This method will not cause validation calls. Data is assumed to already be validated.
          */
         this.setApiSelection = (selectedOptions, bubbleToRoot) => __awaiter(this, void 0, void 0, function* () {
             const featuresLength = this._features.length;
@@ -111,9 +113,39 @@ export class _CfgProductConfigurationInternal {
             agg.push(...feature._internal._getFeaturesWithCode(code));
             return agg;
         }, []);
+        /**
+         * Extends the list of loaded potentially used features. Will warn for but ignore duplicates.
+         * Returns true if a change happened.
+         */
+        this.addRawFeatures = (rawFeatures, warnForDuplicates) => {
+            let change = false;
+            const accumulatedRawFeatures = this.accumulatedRawFeatures;
+            for (const rawFeature of rawFeatures) {
+                const code = rawFeature.code;
+                if (accumulatedRawFeatures.find((f) => code === f.code)) {
+                    if (warnForDuplicates) {
+                        console.warn(`Feature ${code} was already loaded. Will ignore it.`);
+                    }
+                    continue;
+                }
+                accumulatedRawFeatures.push(rawFeature);
+                change = true;
+            }
+            return change;
+        };
+        this._hasRootFeaturesChanged = false;
+        /**
+         * Populates _features based on the passed @param rootFeatureRefs .
+         * @return true if a change happened.
+         */
         this.populateFeatures = (rootFeatureRefs) => {
+            if (compareArrays(this._rootFeatureRefs, rootFeatureRefs, (l, r) => l.code === r.code, true)) {
+                return false;
+            }
             this._rootFeatureRefs = rootFeatureRefs;
-            this._features = syncCfgFeatures(rootFeatureRefs, this._features, this.allRawFeatures, this, this, this.parentProduct, this.rootProduct);
+            this._hasRootFeaturesChanged = !compareArrays(this._initialRootFeatureRefs, rootFeatureRefs, (l, r) => l.code === r.code);
+            this._features = syncCfgFeatures(rootFeatureRefs, this._features, this.accumulatedRawFeatures, this, this, this.parentProduct, this.rootProduct);
+            return true;
         };
         this.setStretchReferenceLength = (measureParamCode, referenceLength, unit) => __awaiter(this, void 0, void 0, function* () {
             if (measureParamCode === "") {
@@ -158,6 +190,8 @@ export class _CfgProductConfigurationInternal {
             console.log(`Use "window['${dbgName}']" or window.conf to access conf.`);
         }
         /* eslint-enable */
+        this.addRawFeatures(rawFeatures, true);
+        this.populateFeatures(_initialRootFeatureRefs);
         /**
          * Although the measurement-datas are also passed in validate-calls they are only used at
          * initial product creation. The data is assumed to always be the same for a product, so
@@ -194,11 +228,9 @@ export class _CfgProductConfigurationInternal {
         }
         this.stretchReferenceLengthsByMeasureParamCode = stretchReferenceLengthsByMeasureParamCode;
     }
-    static _makeUninitialized(rootFeatureRefs, allRawFeatures, // Flat packed. All the features that can appear anyplace in the selection tree.
+    static _makeUninitialized(rootFeatureRefs, rawFeatures, // Flat packed. All the features that can currently appear anyplace in the selection tree.
     parentProduct, rootProduct) {
-        const configuration = new this(allRawFeatures, parentProduct, rootProduct);
-        configuration.populateFeatures(rootFeatureRefs);
-        return configuration;
+        return new this(rawFeatures, parentProduct, rootProduct, rootFeatureRefs);
     }
     get rootFeatureRefs() {
         return this._rootFeatureRefs;
@@ -215,6 +247,13 @@ export class _CfgProductConfigurationInternal {
             features[i] = CfgFeature._makeNewRefFrom(featureInternal);
         }
     }
+    /**
+     * True if what root Features are used is not the same as at initial load.
+     * This means that functional selection has happened.
+     */
+    get hasRootFeaturesChanged() {
+        return this._hasRootFeaturesChanged;
+    }
 }
 export class CfgProductConfiguration {
     /**
@@ -233,12 +272,6 @@ export class CfgProductConfiguration {
          */
         this.tryMatchSelection = (other, descriptionMatch = false // Match on case insensitive description, not code
         ) => __awaiter(this, void 0, void 0, function* () { return yield this._internal.tryMatchSelection(other._internal, descriptionMatch, true); });
-        this.getApiSelection = () => convertDtoConfFeaturesToSelOptions(this._internal.getDtoConf(false), true);
-        /**
-         * This method does not propagate its selections.
-         * This method will not cause validation calls. Data is assumed to already be validated.
-         */
-        this.setApiSelection = (selectedOptions) => __awaiter(this, void 0, void 0, function* () { return yield this._internal.setApiSelection(selectedOptions, true); });
         /**
          * Set how stretched a certain measure should be measureParamCode is the measure to be
          * stretched referenceLength is a value relative to the initial length of the measure. If the
@@ -259,9 +292,9 @@ export class CfgProductConfiguration {
      * CfgProductConfiguration, but is not properly initialized until the initDone-callback
      * has been called.
      */
-    static make(initSuccess, initFail, rootFeatureRefs, allRawFeatures, // Flat packed. All the features that can appear anyplace in the selection tree.
+    static make(initSuccess, initFail, rootFeatureRefs, rawFeatures, // Flat packed. All the features that can currently appear anyplace in the selection tree.
     apiSelection, parentProduct, rootProduct) {
-        const internal = _CfgProductConfigurationInternal._makeUninitialized(rootFeatureRefs, allRawFeatures, parentProduct, rootProduct);
+        const internal = _CfgProductConfigurationInternal._makeUninitialized(rootFeatureRefs, rawFeatures, parentProduct, rootProduct);
         const external = new this(internal);
         // Note the async-callback at the end of the following line. The call is async.
         internal
@@ -289,12 +322,12 @@ export class CfgProductConfiguration {
         return this._internal.key;
     }
     /**
-     * Every (unprocessed) feature which might be used in this product. This is constant for a
-     * product load. What features are actually used is controlled by rootFeatureRefs and what
+     * Every (unprocessed) feature that is currently loaded for this product. This can be extended
+     * by validation calls. What features are actually used is controlled by rootFeatureRefs and what
      * options are selected.
      */
-    get allRawFeatures() {
-        return this._internal.allRawFeatures;
+    get rawFeatures() {
+        return this._internal.accumulatedRawFeatures;
     }
     /** What features are used in the root of this. This can change with new validate calls. */
     get rootFeatureRefs() {

package/dist/productConfiguration/filters.d.ts

@@ -1,6 +1,6 @@
 import { Filters, Matches } from "@configura/web-utilities";
-import { DtoCatalogueParamsWithoutCid, DtoLevel, DtoProductRef } from "../CatalogueAPI.js";
-export declare function applyCatalogueFilters<T extends DtoCatalogueParamsWithoutCid>(filters: Filters<DtoCatalogueParamsWithoutCid>, catalogues: T[]): [Matches<DtoCatalogueParamsWithoutCid>, T[]];
+import { DtoCatalogueParams, DtoLevel, DtoProductRef } from "../CatalogueAPI.js";
+export declare function applyCatalogueFilters<T extends DtoCatalogueParams>(filters: Filters<DtoCatalogueParams>, catalogues: T[]): [Matches<DtoCatalogueParams>, T[]];
 export interface ProductRefParams {
     partNr: string;
 }

package/dist/productConfiguration/productParamsGenerator.d.ts

@@ -1,16 +1,16 @@
 import { Filters } from "@configura/web-utilities";
-import { CatalogueAPI, DtoApplicationAreasResponse, DtoCatalogueParams, DtoCatalogueParamsWithLang } from "../CatalogueAPI.js";
+import { CatalogueAPI, DtoApplicationAreasResponse, DtoCatalogueParamsWithCid, DtoCatalogueParamsWithCidAndLang } from "../CatalogueAPI.js";
 import { CfgProduct, CfgProductSettings } from "../CfgProduct.js";
 import { ProductRefParams } from "./filters.js";
 export interface GeneratedProductConfiguration {
     applicationAreasResponse: DtoApplicationAreasResponse;
     catalogueCount: number;
     catalogueIndex: number;
-    catalogueParams: DtoCatalogueParamsWithLang;
+    catalogueParams: DtoCatalogueParamsWithCidAndLang;
     getProductDuration: number;
     product: CfgProduct;
     productCount: number;
     productIndex: number;
 }
-export declare function generateProductConfigurations(api: CatalogueAPI, lang: string, catalogues: DtoCatalogueParams[], filters: Filters<ProductRefParams>, settings?: Partial<CfgProductSettings>): AsyncIterableIterator<GeneratedProductConfiguration | Error>;
+export declare function generateProductConfigurations(api: CatalogueAPI, lang: string, catalogues: DtoCatalogueParamsWithCid[], filters: Filters<ProductRefParams>, settings?: Partial<CfgProductSettings>): AsyncIterableIterator<GeneratedProductConfiguration | Error>;
 //# sourceMappingURL=productParamsGenerator.d.ts.map

package/dist/productConfiguration/utilitiesProductConfiguration.d.ts

@@ -8,7 +8,7 @@ import { CfgProductConfiguration, _CfgProductConfigurationInternal } from "./Cfg
  * Returns a new array of CfgFeatures that maps to the newFeatureRefs array. Uses CfgFeatures from
  * currentFeatures if they can be found, otherwise makes new.
  */
-export declare function syncCfgFeatures(newFeatureRefs: DtoFeatureRef[], currentFeatures: CfgFeature[], allRawFeatures: DtoFeature[], parent: _CfgProductConfigurationInternal | _CfgOptionInternal, parentConfiguration: _CfgProductConfigurationInternal, parentProduct: _CfgProductInternal, rootProduct: _CfgProductInternal): CfgFeature[];
+export declare function syncCfgFeatures(newFeatureRefs: DtoFeatureRef[], currentFeatures: CfgFeature[], rawFeatures: DtoFeature[], parent: _CfgProductConfigurationInternal | _CfgOptionInternal, parentConfiguration: _CfgProductConfigurationInternal, parentProduct: _CfgProductInternal, rootProduct: _CfgProductInternal): CfgFeature[];
 export declare function getMtrlPreview(mtrlApplications: CfgMtrlApplication[] | undefined): string | undefined;
 /**
  * Recursively find all additional product references given a product configuration.

package/dist/productConfiguration/utilitiesProductConfiguration.js

@@ -6,11 +6,11 @@ import { CfgProductConfiguration, } from "./CfgProductConfiguration.js";
  * Returns a new array of CfgFeatures that maps to the newFeatureRefs array. Uses CfgFeatures from
  * currentFeatures if they can be found, otherwise makes new.
  */
-export function syncCfgFeatures(newFeatureRefs, currentFeatures, allRawFeatures, parent, parentConfiguration, parentProduct, rootProduct) {
+export function syncCfgFeatures(newFeatureRefs, currentFeatures, rawFeatures, parent, parentConfiguration, parentProduct, rootProduct) {
     const usedRawFeatures = newFeatureRefs
         .map((r) => r.code)
         .map((c) => {
-        const rawFeature = allRawFeatures.find((f) => c === f.code);
+        const rawFeature = rawFeatures.find((f) => c === f.code);
         if (rawFeature === undefined) {
             throw new Error(`Feature not found. Requested feature code: "${c}".`);
         }
@@ -38,12 +38,19 @@ export function syncCfgFeatures(newFeatureRefs, currentFeatures, allRawFeatures,
         // products with similar feature-options tree and trying
         // to retain made selections
         const key = fDescription + (fDescription === "" || hasDuplicateDescription ? fCode : "");
-        const existingFeature = currentFeatures.find((cfgF) => cfgF.code === fCode && cfgF.key === key);
+        const existingFeature = currentFeatures.find((cfgF) => cfgF.code === fCode);
         if (existingFeature !== undefined) {
+            if (hasDuplicateDescription) {
+                // HasDuplicateDescription could mean the key need to be more specific compared
+                // to the one we already have, so then we set it. An old duplicate description
+                // key will cause no harm as it is guaranteed to be at least as specific as this.
+                // Not changing the key will make React not rerender, so we don't change.
+                existingFeature._internal.key = key;
+            }
             newFeatures.push(existingFeature);
             continue;
         }
-        newFeatures.push(CfgFeature.make(f, allRawFeatures, key, parent, parentConfiguration, parentProduct, rootProduct));
+        newFeatures.push(CfgFeature.make(f, rawFeatures, key, parent, parentConfiguration, parentProduct, rootProduct));
     }
     return newFeatures;
 }

package/dist/productLoader.d.ts

@@ -1,7 +1,7 @@
-import { DtoProductParamsWithLang, DtoValidateRequest } from "./CatalogueAPI.js";
+import { DtoProductParamsWithCidAndLang, DtoValidateRequest } from "./CatalogueAPI.js";
 import { CfgProductResponse, CfgValidateResponse } from "./utilitiesCatalogueData.js";
-export declare type GetProduct = (params: DtoProductParamsWithLang) => Promise<CfgProductResponse>;
-export declare type PostValidate = (params: DtoProductParamsWithLang, body: DtoValidateRequest) => Promise<CfgValidateResponse>;
+export declare type GetProduct = (params: DtoProductParamsWithCidAndLang) => Promise<CfgProductResponse>;
+export declare type PostValidate = (params: DtoProductParamsWithCidAndLang, body: DtoValidateRequest) => Promise<CfgValidateResponse>;
 export declare type ProductLoader = {
     getProduct: GetProduct;
     postValidate: PostValidate;

package/dist/syncGroups/SyncGroupsHandler.d.ts

@@ -24,7 +24,10 @@ export declare class SyncGroupsHandler {
     clone(): SyncGroupsHandler;
     get verboseLogging(): boolean;
     set verboseLogging(v: boolean);
-    /** Used to initially apply the sync state onto a new product so that it is "in sync". */
+    /**
+     * Used to initially apply the sync state onto a new product so that it is "in sync"
+     * and to reapply the sync state when an optional additional product is selected.
+     */
     init(product: _CfgProductInternal, productLoader: ProductLoader): Promise<void>;
     /**
      * Used when an Option is selected or deselected to apply all consequences of the sync groups.

package/dist/syncGroups/SyncGroupsHandler.js

@@ -123,7 +123,8 @@ import { SyncGroupsTransaction } from "./SyncGroupsTransaction.js";
  * C) The SyncState has an option code for this SyncGroup.
  * D) The option code in the SyncState for the SyncGroup is not the Option selected.
  * E) The Feature has an Option with the right option code.
- * F) The Feature has not previously been affected in this transaction.
+ * F) The Feature has not previously been affected in this transaction, unless it was affected
+ *    at Feature initialization.
  *
  * ...for SelectMany (done for every Option):
  * C) The SyncState has a value (on or off) for this SyncGroup and option code.
@@ -275,7 +276,10 @@ export class SyncGroupsHandler {
     set verboseLogging(v) {
         this._syncState.verboseLogging = v;
     }
-    /** Used to initially apply the sync state onto a new product so that it is "in sync". */
+    /**
+     * Used to initially apply the sync state onto a new product so that it is "in sync"
+     * and to reapply the sync state when an optional additional product is selected.
+     */
     init(product, productLoader) {
         return __awaiter(this, void 0, void 0, function* () {
             const transaction = yield this.newTransaction(product, productLoader, true);