@configura/web-api 2.0.0-alpha.9 → 2.1.0-alpha.0

package/dist/io/CfgWindowMessageToProdConfConnector.d.ts

@@ -1,18 +1,18 @@
-import { DtoProductConfiguration } from "../CatalogueAPI.js";
+import { DtoProductConf } from "../CatalogueAPI.js";
+import { CfgProdConfParts } from "../utilitiesConfiguration.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> {
     private _sendVersions;
-    constructor(manager: CfgWindowMessageManager, doValidate?: boolean, _sendVersions?: CfgProdConfMessageVersions, includeExtendedDataInSend?: boolean, includeProdParamsInSend?: boolean);
-    protected makeSendData(conf: DtoProductConfiguration, initial: boolean): CfgProdConfMessage;
+    constructor(manager: CfgWindowMessageManager, _sendVersions?: CfgProdConfMessageVersions, includeInSend?: CfgProdConfParts);
+    protected makeSendData(conf: DtoProductConf, initial: boolean): CfgProdConfMessage;
 }
 //# sourceMappingURL=CfgWindowMessageToProdConfConnector.d.ts.map

package/dist/io/CfgWindowMessageToProdConfConnector.js

@@ -1,16 +1,16 @@
+import { CfgProdConfParts } from "../utilitiesConfiguration.js";
 import { CfgIOProdConfConnector, CfgProdConfMessageVersions, } from "./CfgIOProdConfConnector.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 class CfgWindowMessageToProdConfConnector extends CfgIOProdConfConnector {
-    constructor(manager, doValidate = true, _sendVersions = CfgProdConfMessageVersions.V2dot0, includeExtendedDataInSend = false, includeProdParamsInSend = false) {
-        super(manager, doValidate, includeExtendedDataInSend, includeProdParamsInSend);
+    constructor(manager, _sendVersions = CfgProdConfMessageVersions.V2dot0, includeInSend = CfgProdConfParts.NoExtra) {
+        super(manager, includeInSend);
         this._sendVersions = _sendVersions;
     }
     makeSendData(conf, initial) {

package/dist/productConfiguration/CfgFeature.d.ts

@@ -1,5 +1,5 @@
 import { LengthUnit, Observable, SingleArgCallback } from "@configura/web-utilities";
-import { DtoFeature, DtoFeatureConfiguration, DtoSelectedOption, DtoSyncGroup, DtoSyncGroupMethods } from "../CatalogueAPI.js";
+import { DtoFeature, DtoFeatureConf, DtoNote, 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,10 +48,14 @@ export declare class _CfgFeatureInternal {
     readonly changeObservable: Observable<FeatureChangeNotification>;
     get code(): string;
     get groupCode(): string | undefined;
+    get key(): string;
+    set key(k: string);
+    get notes(): DtoNote[];
     get isUseNumericValue(): boolean;
     get numericValue(): number | undefined;
     setNumericValue: (val: number) => Promise<boolean>;
     get description(): string;
+    get omitOnOrder(): boolean;
     get syncGroup(): DtoSyncGroup | undefined;
     /**
      * @return one of the following, in order:
@@ -99,7 +103,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) => DtoFeatureConfiguration;
+    getDtoConf: (includeExtendedData: boolean) => DtoFeatureConf;
     setApiSelection: (apiOptionSelectionMap: {
         [index: string]: DtoSelectedOption;
     } | undefined) => Promise<boolean>;
@@ -124,11 +128,10 @@ export declare class _CfgFeatureInternal {
      * @throws Will throw if options have not yet been generated.
      */
     private _freshRefAllOptions;
-    _freshRefDescendants(): void;
 }
 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.
@@ -148,6 +151,7 @@ export declare class CfgFeature {
     get key(): string;
     get code(): string;
     get groupCode(): string | undefined;
+    get notes(): DtoNote[];
     /**
      * If true the options in the feature is selected by both sending its code and numeric value
      * when selecting.
@@ -162,6 +166,7 @@ export declare class CfgFeature {
     setNumericValue: (val: number) => Promise<boolean>;
     get unit(): LengthUnit;
     get description(): string;
+    get omitOnOrder(): boolean;
     get hasUpcharge(): boolean | undefined;
     get selectedOptions(): CfgOption[];
     /** Are all ancestors up to the CfgProductConfiguration selected? */

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;
@@ -114,6 +114,7 @@ export class _CfgFeatureInternal {
             }
             yield this._notifyAllOfChange(bubbleMode, committed);
         });
+        // Keep in sync with stripExtendedDataFromDtoFeatureConf
         this.getDtoConf = (includeExtendedData) => {
             const result = {
                 code: this.code,
@@ -128,6 +129,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 +414,16 @@ export class _CfgFeatureInternal {
     get groupCode() {
         return this.rawFeature.groupCode;
     }
+    get key() {
+        return this._key;
+    }
+    set key(k) {
+        this._key = k;
+    }
+    get notes() {
+        var _a;
+        return this.parentProduct.getNotes((_a = this.rawFeature.noteRefs) !== null && _a !== void 0 ? _a : []);
+    }
     get isUseNumericValue() {
         return this.rawFeature.numericOrder;
     }
@@ -430,6 +447,9 @@ export class _CfgFeatureInternal {
     get description() {
         return this.rawFeature.description;
     }
+    get omitOnOrder() {
+        return this.rawFeature.omitOnOrder === true;
+    }
     get syncGroup() {
         return this.rawFeature.syncGroup;
     }
@@ -512,7 +532,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;
     }
@@ -536,14 +556,6 @@ export class _CfgFeatureInternal {
             });
         }
     }
-    _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 {
     /**
@@ -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;
     }
@@ -600,6 +613,9 @@ export class CfgFeature {
     get groupCode() {
         return this._internal.groupCode;
     }
+    get notes() {
+        return this._internal.notes;
+    }
     /**
      * If true the options in the feature is selected by both sending its code and numeric value
      * when selecting.
@@ -617,6 +633,9 @@ export class CfgFeature {
     get description() {
         return this._internal.description;
     }
+    get omitOnOrder() {
+        return this._internal.omitOnOrder;
+    }
     get hasUpcharge() {
         return this._internal.hasUpcharge;
     }

package/dist/productConfiguration/CfgOption.d.ts

@@ -1,5 +1,5 @@
 import { LengthUnit, Observable, SingleArgCallback } from "@configura/web-utilities";
-import { DtoFeature, DtoOption, DtoOptionConfiguration, DtoSelectedOption } from "../CatalogueAPI.js";
+import { DtoFeature, DtoMiscFile, DtoNote, DtoOption, DtoOptionConf, DtoSelectedOption } from "../CatalogueAPI.js";
 import { CfgProduct, _CfgProductInternal } from "../CfgProduct.js";
 import { CfgMtrlApplication } from "../material/CfgMtrlApplication.js";
 import { NumericValuesSelection } from "../utilitiesNumericValues.js";
@@ -60,20 +60,23 @@ 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;
+    private _upcharge;
     private _numericValue;
     readonly allowedNumericValues: NumericValuesSelection | undefined;
     isAllowedNumericValue(val: number): boolean;
     readonly changeObservable: Observable<OptionChangeNotification>;
     get code(): string;
+    get notes(): DtoNote[];
+    get miscFiles(): DtoMiscFile[];
     get isUseNumericValue(): boolean;
     get numericValue(): number | undefined;
     setNumericValue(val: number, doSelectOption: boolean): Promise<boolean>;
@@ -84,22 +87,22 @@ export declare class _CfgOptionInternal {
     get ancestorsSelected(): boolean;
     get mtrlApplications(): CfgMtrlApplication[];
     get thumbnail(): string | undefined;
-    get upcharge(): number | undefined;
-    get priceChangeAtSelectChange(): number | undefined;
+    private _calculateUpcharge;
+    get upcharge(): number;
+    get priceChangeAtSelectChange(): number;
     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) => DtoOptionConfiguration;
+    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>;
     keyMatch: (other: _CfgOptionInternal, descriptionMatch?: boolean) => boolean;
     _getFeaturesWithCode: (code: string) => _CfgFeatureInternal[];
-    _freshRefDescendants(): void;
 }
 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.
@@ -114,10 +117,13 @@ export declare class CfgOption {
     private constructor();
     isBackedBySame: (other: CfgOption) => boolean;
     get parentProduct(): CfgProduct;
+    get parent(): CfgFeature;
     get rootProduct(): CfgProduct;
     get rawOption(): DtoOption;
     get key(): string;
     get code(): string;
+    get notes(): DtoNote[];
+    get miscFiles(): DtoMiscFile[];
     get isUseNumericValue(): boolean;
     get numericValue(): number | undefined;
     setNumericValue: (val: number, doSelectOption: boolean) => Promise<boolean>;
@@ -143,8 +149,8 @@ export declare class CfgOption {
      */
     setSelected: (on: boolean) => Promise<boolean>;
     get thumbnail(): string | undefined;
-    get upcharge(): number | undefined;
-    get priceChangeAtSelectChange(): number | undefined;
+    get upcharge(): number;
+    get priceChangeAtSelectChange(): number;
     get features(): CfgFeature[];
     listenForChange: (l: SingleArgCallback<OptionChangeNotification>) => void;
     stopListenForChange: (l: SingleArgCallback<OptionChangeNotification>) => void;

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,7 +132,19 @@ 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 change = false;
+            const upcharge = this._calculateUpcharge();
+            if (this._upcharge !== upcharge) {
+                change = true;
+                this._upcharge = upcharge;
+            }
             let features;
             if (apiOptionSelection === undefined) {
                 features = this._features || []; // All already generated children
@@ -140,7 +152,10 @@ export class _CfgOptionInternal {
             else {
                 features = this.features; // This will generate all children
             }
-            return (yield Promise.all(features.map((f) => f._internal.setApiSelection(apiOptionSelection ? apiOptionSelection.next : undefined)))).some((b) => b);
+            if ((yield Promise.all(features.map((f) => f._internal.setApiSelection(apiOptionSelection ? apiOptionSelection.next : undefined)))).some((b) => b)) {
+                change = true;
+            }
+            return change;
         });
         this.structureCompare = (other, strictOrder = true, descriptionMatch = false) => this.keyMatch(other, descriptionMatch) &&
             compareArrays(this.features, other.features, (l, r) => l._internal.structureCompare(r._internal, strictOrder, descriptionMatch), strictOrder);
@@ -174,6 +189,7 @@ export class _CfgOptionInternal {
         this.key =
             this.description +
                 (this.description === "" || siblingHasDuplicateDescription ? this.code : "");
+        this._upcharge = this._calculateUpcharge();
         const rawRanges = rawOption.codeRanges;
         if (rawRanges === undefined || rawRanges.length === 0) {
             if (this.isUseNumericValue) {
@@ -200,6 +216,14 @@ export class _CfgOptionInternal {
     get code() {
         return this.rawOption.code;
     }
+    get notes() {
+        var _a;
+        return this.parentProduct.getNotes((_a = this.rawOption.noteRefs) !== null && _a !== void 0 ? _a : []);
+    }
+    get miscFiles() {
+        var _a;
+        return (_a = this.rawOption.miscFiles) !== null && _a !== void 0 ? _a : [];
+    }
     get isUseNumericValue() {
         return this.parent.isUseNumericValue;
     }
@@ -272,18 +296,21 @@ export class _CfgOptionInternal {
     get thumbnail() {
         return this.rawOption.material || getMtrlPreview(this.mtrlApplications);
     }
-    get upcharge() {
+    _calculateUpcharge() {
         let upcharge = this.rawOption.upcharge || 0;
         const priceCodes = this.rawOption.priceCodes || [];
         const prices = this.rootProduct.prices;
         upcharge += recursivelyGetPriceCodeValue(priceCodes, prices) || 0;
         return upcharge;
     }
+    get upcharge() {
+        return this._upcharge;
+    }
     get priceChangeAtSelectChange() {
         if (!this.parent.hasUpcharge) {
-            return undefined;
+            return 0;
         }
-        const upcharge = this.upcharge || 0;
+        const upcharge = this._upcharge || 0;
         const isSelected = this.parent.isSelected(this);
         if (this.parent.selectionType === SelectionType.SelectMany) {
             return isSelected ? -upcharge : upcharge;
@@ -299,12 +326,12 @@ export class _CfgOptionInternal {
             }
             return upcharge - (selectedOptions[0].upcharge || 0);
         }
-        return undefined;
+        return 0;
     }
     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.");
             }
@@ -312,14 +339,6 @@ export class _CfgOptionInternal {
         }
         return this._features;
     }
-    _freshRefDescendants() {
-        const features = this._features || [];
-        for (let i = 0; i < features.length; i++) {
-            const featureInternal = features[i]._internal;
-            featureInternal._freshRefDescendants();
-            features[i] = CfgFeature._makeNewRefFrom(featureInternal);
-        }
-    }
 }
 export class CfgOption {
     /**
@@ -343,8 +362,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,
@@ -357,6 +376,9 @@ export class CfgOption {
     get parentProduct() {
         return CfgProduct._makeNewRefFrom(this._internal.parentProduct);
     }
+    get parent() {
+        return CfgFeature._makeNewRefFrom(this._internal.parent);
+    }
     get rootProduct() {
         return CfgProduct._makeNewRefFrom(this._internal.rootProduct);
     }
@@ -369,6 +391,12 @@ export class CfgOption {
     get code() {
         return this._internal.code;
     }
+    get notes() {
+        return this._internal.notes;
+    }
+    get miscFiles() {
+        return this._internal.miscFiles;
+    }
     get isUseNumericValue() {
         return this._internal.isUseNumericValue;
     }

package/dist/productConfiguration/CfgProductConfiguration.d.ts

@@ -1,5 +1,5 @@
 import { LengthUnit, LengthValue, Observable, SingleArgCallback } from "@configura/web-utilities";
-import { DtoFeature, DtoFeatureConfiguration, 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,27 +17,29 @@ 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>;
     get rootFeatureRefs(): DtoFeatureRef[];
     get features(): CfgFeature[];
     private _notifyAllOfChange;
-    _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) => DtoFeatureConfiguration[];
+    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 +50,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 +75,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 +95,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 +111,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