@configura/web-api 3.0.0-alpha.0 → 3.0.0-alpha.2

package/dist/io/CfgIOManager.js

@@ -1,12 +1,3 @@
-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());
-    });
-};
 const CONFIGURA_ATTRIBUTE = "C0nf1gura";
 const CONFIGURA_SHEBANG = "arug1fn0C";
 // Support function. Did not manage to check both attribute and value in one step
@@ -90,7 +81,7 @@ export class CfgIOManager {
             return a;
         }, new Set());
         const promises = [];
-        (() => __awaiter(this, void 0, void 0, function* () {
+        (async () => {
             for (const messageKey of allMessageKeys) {
                 if (!CfgIOManager.hasIOContainerMessageKey(data, messageKey)) {
                     continue;
@@ -104,7 +95,7 @@ export class CfgIOManager {
                     promises.push(item.l(message));
                 }
             }
-        }))();
+        })();
         Promise.all(promises)
             .then(() => {
             this._receiveInProgress = false;

package/dist/io/CfgIOProdConfConnector.js

@@ -1,12 +1,3 @@
-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());
-    });
-};
 var _a;
 import { convertDtoProductConfToV1 } from "../utilitiesConfiguration.js";
 export const isCfgProdConfMessage = (data) => typeof data === "object" && data !== null && "version" in data && "conf" in data;
@@ -31,8 +22,7 @@ export class CfgIOProdConfConnector {
         this._includeInSend = _includeInSend;
         this._stopListenToMessage = undefined;
         this._stopListenToProdConf = undefined;
-        this.setProduct = (product) => __awaiter(this, void 0, void 0, function* () {
-            var _b, _c;
+        this.setProduct = async (product) => {
             const currentProduct = this._product;
             const newProduct = product;
             this._product = newProduct;
@@ -43,14 +33,14 @@ export class CfgIOProdConfConnector {
                 return;
             }
             if (currentProduct !== undefined) {
-                (_b = this._stopListenToMessage) === null || _b === void 0 ? void 0 : _b.call(this);
-                (_c = this._stopListenToProdConf) === null || _c === void 0 ? void 0 : _c.call(this);
+                this._stopListenToMessage?.();
+                this._stopListenToProdConf?.();
             }
             if (newProduct === undefined) {
                 return;
             }
             this._send(this.makeSendData(newProduct.getDtoConf(this._includeInSend), true));
-            this._stopListenToMessage = CfgIOProdConfConnector.listenForMessage((messages) => __awaiter(this, void 0, void 0, function* () {
+            this._stopListenToMessage = CfgIOProdConfConnector.listenForMessage(async (messages) => {
                 const subMessages = messages.subMessages;
                 if (subMessages.length === 0) {
                     console.warn(`${STAGE_PROD_CONF_MESSAGE_KEY} message without any submessages. Unexpected.`);
@@ -58,24 +48,23 @@ export class CfgIOProdConfConnector {
                 }
                 const highestVersionMessage = getHighestVersionProdConfMessage(subMessages);
                 if (isCfgProdConfMessageV1(highestVersionMessage)) {
-                    yield newProduct.setApiSelection(highestVersionMessage.conf);
+                    await newProduct.setApiSelection(highestVersionMessage.conf);
                     return;
                 }
                 if (isCfgProdConfMessageV2(highestVersionMessage)) {
-                    yield newProduct.setDtoConf(highestVersionMessage.conf);
+                    await newProduct.setDtoConf(highestVersionMessage.conf);
                     return;
                 }
                 throw new Error("Unknown message version");
-            }), this._ioManager);
-            this._stopListenToProdConf = CfgIOProdConfConnector.listenForProdConf(newProduct, (conf) => __awaiter(this, void 0, void 0, function* () { return this._send(this.makeSendData(conf, false)); }), this._includeInSend);
-        });
+            }, this._ioManager);
+            this._stopListenToProdConf = CfgIOProdConfConnector.listenForProdConf(newProduct, async (conf) => this._send(this.makeSendData(conf, false)), this._includeInSend);
+        };
         this._send = (data) => this._ioManager.send(STAGE_PROD_CONF_MESSAGE_KEY, data);
         _ioManager.addWarningSupplier(this);
     }
     destroy() {
-        var _b, _c;
-        (_b = this._stopListenToMessage) === null || _b === void 0 ? void 0 : _b.call(this);
-        (_c = this._stopListenToProdConf) === null || _c === void 0 ? void 0 : _c.call(this);
+        this._stopListenToMessage?.();
+        this._stopListenToProdConf?.();
         this._ioManager.removeWarningSupplier(this);
     }
     getWarnings() {
@@ -127,10 +116,10 @@ CfgIOProdConfConnector.makeMessage = (conf, initial, sendVersions) => {
     }
     return { subMessages: result, initial };
 };
-CfgIOProdConfConnector.makeMessageListener = (callback) => (message) => __awaiter(void 0, void 0, void 0, function* () {
+CfgIOProdConfConnector.makeMessageListener = (callback) => async (message) => {
     const prodConfMessage = message;
-    yield callback(prodConfMessage);
-});
+    await callback(prodConfMessage);
+};
 CfgIOProdConfConnector.makeProdConfListener = (callback, includeInSend) => (n) => {
     if (!n.committed) {
         return;

package/dist/io/CfgObservableStateManager.js

@@ -52,7 +52,7 @@ export class CfgObservableStateManager extends CfgIOManager {
         try {
             asJson = JSON.parse(data);
         }
-        catch (_a) {
+        catch {
             throw new Error("Not JSON data");
         }
         if (!CfgIOManager.isIOContainer(asJson)) {

package/dist/productConfiguration/CfgFeature.d.ts

@@ -44,6 +44,7 @@ export declare class _CfgFeatureInternal {
     private _options;
     private readonly _selectedOptions;
     private readonly _constrainedOptions;
+    private readonly _unresolvableOptions;
     private _mtrlApplications;
     readonly hasUpcharge: boolean;
     readonly changeObservable: Observable<FeatureChangeNotification>;
@@ -126,6 +127,10 @@ export declare class _CfgFeatureInternal {
     selectOption: (optionInternal: _CfgOptionInternal, on: boolean, bubbleMode: ProductConfigurationBubbleMode) => Promise<boolean>;
     isSelected: (option: _CfgOptionInternal) => boolean;
     isDisabled: (option: _CfgOptionInternal) => boolean;
+    /**
+     * An option is unresolvable when it is constrained from any possible value.
+     */
+    isUnresolvable: (option: _CfgOptionInternal) => boolean;
     keyMatch: (other: _CfgFeatureInternal, descriptionMatch?: boolean) => boolean;
     /** Only in selected options */
     _getFeaturesWithCode: (code: string) => _CfgFeatureInternal[];

package/dist/productConfiguration/CfgFeature.js

@@ -1,13 +1,4 @@
-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 { assertDefined, compareArrays, convertLength, count, Observable, someMatch, toLengthUnit, } from "@configura/web-utilities";
+import { Observable, assertDefined, compareArrays, convertLength, count, someMatch, toLengthUnit, } from "@configura/web-utilities";
 import { CfgProduct } from "../CfgProduct.js";
 import { CfgMtrlApplication } from "../material/CfgMtrlApplication.js";
 import { CfgMtrlApplicationSource } from "../material/CfgMtrlApplicationSource.js";
@@ -73,8 +64,9 @@ export class _CfgFeatureInternal {
         this.rootProduct = rootProduct;
         this._selectedOptions = [];
         this._constrainedOptions = [];
+        this._unresolvableOptions = [];
         this.changeObservable = new Observable();
-        this.setNumericValue = (val) => __awaiter(this, void 0, void 0, function* () {
+        this.setNumericValue = async (val) => {
             if (this.selectionType !== SelectionType.SelectOne) {
                 throw new Error("Only SelectOne Features can have numeric values");
             }
@@ -82,9 +74,9 @@ export class _CfgFeatureInternal {
             if (option === undefined) {
                 throw new Error("No Option allows the value you tried to set");
             }
-            return yield option.setNumericValue(val, true);
-        });
-        this._notifyAllOfChange = (bubbleMode, committed) => __awaiter(this, void 0, void 0, function* () {
+            return await option.setNumericValue(val, true);
+        };
+        this._notifyAllOfChange = async (bubbleMode, committed) => {
             if (bubbleMode === ProductConfigurationBubbleMode.Stop) {
                 return;
             }
@@ -92,17 +84,17 @@ export class _CfgFeatureInternal {
             this.changeObservable.notifyAll({ freshRef, committed });
             const parent = this.parent;
             if (parent !== undefined) {
-                yield parent._childHasChanged(freshRef, bubbleMode === ProductConfigurationBubbleMode.OneLevel
+                await parent._childHasChanged(freshRef, bubbleMode === ProductConfigurationBubbleMode.OneLevel
                     ? ProductConfigurationBubbleMode.Stop
                     : bubbleMode, committed);
             }
-        });
+        };
         /**
          * 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, committed) => __awaiter(this, void 0, void 0, function* () {
+        this._childHasChanged = async (childOption, bubbleMode, committed) => {
             const options = this._options;
             if (options === undefined) {
                 throw Error("Child says it changed, but no children has actually been generated");
@@ -113,8 +105,8 @@ export class _CfgFeatureInternal {
             if (i !== -1) {
                 selectedOptions[i] = freshRef;
             }
-            yield this._notifyAllOfChange(bubbleMode, committed);
-        });
+            await this._notifyAllOfChange(bubbleMode, committed);
+        };
         // Keep in sync with stripExtendedDataFromDtoFeatureConf
         this.getDtoConf = (includeExtendedData) => {
             const result = {
@@ -136,8 +128,7 @@ export class _CfgFeatureInternal {
         // 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, apiOptionConstraintMap) => __awaiter(this, void 0, void 0, function* () {
-            var _a, _b;
+        this.setApiSelection = async (apiOptionSelectionMap, apiOptionConstraintMap) => {
             const selectionType = this.selectionType;
             const isGroup = selectionType === SelectionType.Group;
             const isSelectOne = selectionType === SelectionType.SelectOne;
@@ -152,15 +143,21 @@ export class _CfgFeatureInternal {
                 options = this.options; // This will generate all children
             }
             let change = false;
-            const constraintMap = apiOptionConstraintMap !== null && apiOptionConstraintMap !== void 0 ? apiOptionConstraintMap : {};
-            // The first value that belongs to this features options is used as the key to look up constrained options
-            const featureConstrainedOptions = (_b = (_a = options.map((o) => constraintMap[o.code]).find((o) => !!o)) === null || _a === void 0 ? void 0 : _a.constrOptions) !== null && _b !== void 0 ? _b : [];
+            const constraintMap = apiOptionConstraintMap ?? {};
+            const { constrOptions = [], constrBooleans = [] } = Object.values(constraintMap).find(({ feature }) => feature === this.code) ?? {};
+            const optionalConstrainedOptions = constrBooleans.map(({ code }) => code);
+            const unresolvedConstrainedOptions = constrBooleans
+                .filter(({ value }) => value === undefined)
+                .map(({ code }) => code);
+            const featureConstrainedOptions = constrOptions.concat(optionalConstrainedOptions);
             for (let i = 0; i < options.length; i++) {
                 const option = options[i];
                 const apiOptionSelection = apiOptionSelectionMap[option.code];
                 const isConstrained = featureConstrainedOptions.indexOf(option.code) >= 0;
+                const isUnresolvable = unresolvedConstrainedOptions.indexOf(option.code) >= 0;
                 const selectedIndex = this._selectedOptions.findIndex(getOptionFilter(option._internal));
                 const constrainedIndex = this._constrainedOptions.findIndex(getOptionFilter(option._internal));
+                const unresolvedIndex = this._unresolvableOptions.findIndex(getOptionFilter(option._internal));
                 const isOn = isGroup || apiOptionSelection;
                 if (isConstrained) {
                     if (constrainedIndex === -1) {
@@ -175,6 +172,19 @@ export class _CfgFeatureInternal {
                         change = true;
                     }
                 }
+                if (isUnresolvable) {
+                    if (unresolvedIndex === -1) {
+                        doFreshRefOptionAtIndex(options, i, committed, (freshRef) => this._unresolvableOptions.push(freshRef));
+                        change = true;
+                    }
+                }
+                else {
+                    if (unresolvedIndex !== -1) {
+                        this._unresolvableOptions.splice(unresolvedIndex, 1);
+                        doFreshRefOptionAtIndex(options, i, committed);
+                        change = true;
+                    }
+                }
                 if (isOn) {
                     if (isSelectOne) {
                         if (this.isUseNumericValue) {
@@ -183,7 +193,7 @@ export class _CfgFeatureInternal {
                                 throw new Error("No numeric value for numeric feature");
                             }
                             const { value, unit } = numericValue;
-                            if (yield option.setNumericValue(unit === undefined
+                            if (await option.setNumericValue(unit === undefined
                                 ? value
                                 : convertLength(value, toLengthUnit(unit), this.unit), false)) {
                                 change = true;
@@ -209,14 +219,14 @@ export class _CfgFeatureInternal {
                         change = true;
                     }
                 }
-                if (yield option._internal.setApiSelection(apiOptionSelection, constraintMap[option.code])) {
+                if (await option._internal.setApiSelection(apiOptionSelection, constraintMap[option.code])) {
                     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}`;
+                    const wrongCountWarning = `A select-one Feature (i.e. neither optional nor multiple) should have exactly one Option selected. Feature code: "${this.code}". Actual: ${selectionCount}`;
                     if (this.rootProduct.settings.strictSelectOneSelectionCount) {
                         throw new Error(wrongCountWarning);
                     }
@@ -230,7 +240,7 @@ export class _CfgFeatureInternal {
                     this._freshRefAllOptions(committed);
                 }
                 if (selectionType === SelectionType.SelectOne) {
-                    yield this.pushStretch();
+                    await this.pushStretch();
                 }
                 // setApiSelection works its way top down and handles notifications on
                 // each level by looking at change returned from its children. That way
@@ -238,10 +248,10 @@ export class _CfgFeatureInternal {
                 // 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, committed);
+                await this._notifyAllOfChange(ProductConfigurationBubbleMode.OneLevel, committed);
             }
             return change;
-        });
+        };
         this.addForApiConstrained = (next) => {
             const constrOptions = this._constrainedOptions;
             for (const so of this._selectedOptions) {
@@ -249,16 +259,16 @@ export class _CfgFeatureInternal {
             }
         };
         /** Pushes to refresh stretch. Does not cause validation. */
-        this.pushStretch = () => __awaiter(this, void 0, void 0, function* () {
+        this.pushStretch = async () => {
             if (this.selectionType !== SelectionType.SelectOne) {
                 throw new Error("Can only push stretch for SelectOne");
             }
             const value = this.numericValue;
-            return (yield Promise.all((this.measureParamCodes || []).map((measureParamCode) => this.parentConfiguration.setStretchReferenceLength(measureParamCode, value, this.unit)))).some((change) => change);
-        });
+            return (await Promise.all((this.measureParamCodes || []).map((measureParamCode) => this.parentConfiguration.setStretchReferenceLength(measureParamCode, value, this.unit)))).some((change) => 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* () {
+        this.tryMatchSelection = async (other, descriptionMatch = false) => {
             const { selectionType, isUseNumericValue } = this;
             if (selectionType !== other.selectionType) {
                 // Will not try if the selection type is different
@@ -276,7 +286,7 @@ export class _CfgFeatureInternal {
                     throw new Error("Numeric feature without numeric value, this should never happen");
                 }
                 else {
-                    if (yield this.setNumericValue(otherNumericValue)) {
+                    if (await this.setNumericValue(otherNumericValue)) {
                         change = true;
                     }
                 }
@@ -284,7 +294,7 @@ export class _CfgFeatureInternal {
             else {
                 const thisOptions = this.options;
                 const otherOptions = other.options;
-                change = (yield Promise.all(otherOptions.map((otherO) => (() => __awaiter(this, void 0, void 0, function* () {
+                change = (await Promise.all(otherOptions.map((otherO) => (async () => {
                     const otherOSelected = otherO.selected;
                     if (selectionType === SelectionType.SelectOne && !otherOSelected) {
                         return false;
@@ -310,14 +320,14 @@ export class _CfgFeatureInternal {
                         // 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);
+                        change = await toTryChangeOption._internal.parent.selectOption(toTryChangeOption._internal, otherOSelected, ProductConfigurationBubbleMode.Stop);
                     }
                     if (otherOSelected &&
-                        (yield toTryChangeOption._internal.tryMatchSelection(otherO, descriptionMatch))) {
+                        (await toTryChangeOption._internal.tryMatchSelection(otherO, descriptionMatch))) {
                         change = true;
                     }
                     return change;
-                }))()))).some((b) => b);
+                })()))).some((b) => b);
             }
             if (change) {
                 // tryMatchSelection works its way top down and handles notifications on
@@ -326,23 +336,23 @@ export class _CfgFeatureInternal {
                 // 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, true);
+                await this._notifyAllOfChange(ProductConfigurationBubbleMode.OneLevel, true);
             }
             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* () {
+        this.selectOption = async (optionInternal, on, bubbleMode) => {
             if (bubbleMode ===
                 ProductConfigurationBubbleMode.ValidateAndBubbleSelectedAndApplySyncGroups) {
                 const product = this.rootProduct;
                 const syncGroupHandler = product.syncGroupHandler;
                 assertDefined(syncGroupHandler, `Sync group handler is required for bubble mode ${ProductConfigurationBubbleMode.ValidateAndBubbleSelectedAndApplySyncGroups}`);
-                return yield syncGroupHandler.selectOption(product, optionInternal, on, wrapWithCache(product._productLoaderRaw));
+                return await syncGroupHandler.selectOption(product, optionInternal, on, wrapWithCache(product._productLoaderRaw));
             }
             if (!on) {
                 if (this.selectionType === SelectionType.Group) {
@@ -378,7 +388,7 @@ export class _CfgFeatureInternal {
                         doFreshRefOption(options, optionInternal, committed, (freshRef) => selectedOptions.push(freshRef));
                     }
                     if (this.selectionType === SelectionType.SelectOne) {
-                        yield this.pushStretch();
+                        await this.pushStretch();
                     }
                 }
                 else {
@@ -409,12 +419,16 @@ export class _CfgFeatureInternal {
                     nextLevelBubbleMode = ProductConfigurationBubbleMode.ToRoot;
                 }
             }
-            yield this._notifyAllOfChange(nextLevelBubbleMode, committed);
+            await this._notifyAllOfChange(nextLevelBubbleMode, committed);
             return isActualChange;
-        });
+        };
         this.isSelected = (option) => this.selectionType === SelectionType.Group ||
             this._selectedOptions.some(getOptionFilter(option));
         this.isDisabled = (option) => this._constrainedOptions.some(getOptionFilter(option));
+        /**
+         * An option is unresolvable when it is constrained from any possible value.
+         */
+        this.isUnresolvable = (option) => this._unresolvableOptions.some(getOptionFilter(option));
         this.keyMatch = (other, descriptionMatch = false) => descriptionMatch
             ? this.description.toLowerCase() === other.description.toLowerCase()
             : this.code === other.code;
@@ -448,8 +462,7 @@ export class _CfgFeatureInternal {
         this._key = k;
     }
     get notes() {
-        var _a;
-        return this.parentProduct.getNotes((_a = this.rawFeature.noteRefs) !== null && _a !== void 0 ? _a : []);
+        return this.parentProduct.getNotes(this.rawFeature.noteRefs ?? []);
     }
     get isUseNumericValue() {
         return this.rawFeature.numericOrder;
@@ -502,8 +515,7 @@ export class _CfgFeatureInternal {
      * of this Feature. Hence only the code property is used.
      */
     get measureParamCodes() {
-        var _a;
-        return (_a = this.rawFeature.measureParams) === null || _a === void 0 ? void 0 : _a.map((measureParam) => measureParam.code);
+        return this.rawFeature.measureParams?.map((measureParam) => measureParam.code);
     }
     get unit() {
         const unit = this.rawFeature.unit;
@@ -597,15 +609,13 @@ export class CfgFeature {
          * This will find the first option allowing the value, set the value on it and select it.
          * This is an implicit option-select.
          */
-        this.setNumericValue = (val) => __awaiter(this, void 0, void 0, function* () { return yield this._internal.setNumericValue(val); });
+        this.setNumericValue = async (val) => await this._internal.setNumericValue(val);
         /**
          * 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.ValidateAndBubbleSelectedAndApplySyncGroups);
-        });
+        this.selectOption = async (option, on) => await this._internal.selectOption(option._internal, on, ProductConfigurationBubbleMode.ValidateAndBubbleSelectedAndApplySyncGroups);
         this.isSelected = (option) => this._internal.isSelected(option._internal);
         this.listenForChange = (l) => this._internal.changeObservable.listen(l);
         this.stopListenForChange = (l) => this._internal.changeObservable.stopListen(l);

package/dist/productConfiguration/CfgOption.d.ts

@@ -84,6 +84,10 @@ export declare class _CfgOptionInternal {
     get description(): string;
     get selected(): boolean;
     get disabled(): boolean;
+    /**
+     * An option is unresolvable when it is constrained from any possible value.
+     */
+    get unresolvable(): boolean;
     get selectedChangeInProgress(): boolean;
     get ancestorsSelected(): boolean;
     get mtrlApplications(): CfgMtrlApplication[];
@@ -91,6 +95,24 @@ export declare class _CfgOptionInternal {
     private _calculateUpcharge;
     get upcharge(): number;
     get priceChangeAtSelectChange(): number;
+    /**
+     * Get the child features that are contained within this option.
+     *
+     * Safe to call outside of the sync process, but may not contain any
+     * children until the sync process is complete.
+     */
+    getFeaturesOutsideSync(): CfgFeature[];
+    /**
+     * Get the child features that are contained within this option.
+     *
+     * ONLY ACCESS THIS PROPERTY UNDER THESE CONDITIONS:
+     * 1. The product is undergoing the sync group sync process.
+     * 2. AND you are operating on the new "target" product.
+     *
+     * Explanation: This method will generate all children if they have not been
+     * generated yet, which breaks sync group syncing, due to the presence of
+     * these children being used to determine if the sync should happen at all.
+     */
     get features(): CfgFeature[];
     /** Called by child to tell its parent that it has changed. */
     _childHasChanged: (freshRef: CfgFeature, bubbleMode: ProductConfigurationBubbleMode, committed: boolean) => Promise<void>;
@@ -135,6 +157,10 @@ export declare class CfgOption {
     get description(): string;
     get selected(): boolean;
     get disabled(): boolean;
+    /**
+     * An option is unresolvable when it is constrained from any possible value.
+     */
+    get unresolvable(): boolean;
     /**
      * Selection state is in progress to be changed. This can be used in GUI
      * to display the state as transitioning, or as already changed.
@@ -154,6 +180,24 @@ export declare class CfgOption {
     get thumbnail(): string | undefined;
     get upcharge(): number;
     get priceChangeAtSelectChange(): number;
+    /**
+     * Get the child features that are contained within this option.
+     *
+     * Safe to call outside of the sync process, but may not contain any
+     * children until the sync process is complete.
+     */
+    getFeaturesOutsideSync(): CfgFeature[];
+    /**
+     * Get the child features that are contained within this option.
+     *
+     * ONLY ACCESS THIS PROPERTY UNDER THESE CONDITIONS:
+     * 1. The product is undergoing the sync group sync process.
+     * 2. AND you are operating on the new "target" product.
+     *
+     * Explanation: This method will generate all children if they have not been
+     * generated yet, which breaks sync group syncing, due to the presence of
+     * these children being used to determine if the sync should happen at all.
+     */
     get features(): CfgFeature[];
     listenForChange: (l: SingleArgCallback<OptionChangeNotification>) => void;
     stopListenForChange: (l: SingleArgCallback<OptionChangeNotification>) => void;