valuesSubstore

Manages the selected option values and quantities for every configuration. Each config has its own isolated ValuesStoreItem, stored in valuesConfigs. The form constraint engine reads from this substore to evaluate which elements/options should be shown or hidden.

Table of contents

Properties

• valuesConfigs

Methods

• setElementValue
• setOptionQuantity
• setValues
• setQuantities
• handleChangeInput

---

Properties

valuesConfigs

valuesConfigs: Record<number, ValuesStoreItemVariables>

Map from config ID to its values, quantities, and selected-products state.

Each entry holds:

• values: TValues — Record<elementId, string[]> of selected option IDs or free-text values
• quantities: TQuantities — Record<elementId, Record<optionId, number>> of option quantities
• selectedProductsIds: Set<number> — IDs of products linked to selected options
• selectedProductsQuantities: Record<number, number> — product quantities

Entries are created by configsSubstore.addConfig and removed by configsSubstore.removeConfig.

type TValues     = Record<string, string[]>;
type TQuantities = Record<string, Record<string, number>>;

Related

• configsSubstore.configs — each config ID has a corresponding entry here
• formSubstore.fromConfigs — parallel map of form state
• finishedConfigsSubstore.getFinishedConfigs — aggregates values from this map
• numberFormatterSubstore.calculateConfigPrice — reads values and quantities from here
• submitSubstore.submit — reads values from here to build the API payload

---

Methods

setElementValue

setElementValue: (
  configId: number,
  elementId: number,
  value: string[],
) => void

Sets the selected values for a specific element in a config.

Replaces the entire value array for elementId. Pass an empty array to deselect all options. The constraint engine re-evaluates automatically after this call.

Parameters

Name	Type	Description
configId	number	Target configuration
elementId	number	Target element
value	string[]	Array of selected option IDs or free-text values

Related

• valuesConfigs
• handleChangeInput — higher-level helper that calls this internally

---

setOptionQuantity

setOptionQuantity: (
  configId: number,
  elementId: number,
  optionId: number,
  quantity: number,
) => void

Sets the quantity of a specific option within an element for the given config.

Does not affect whether the option is selected — selection is managed via setElementValue.

Parameters

Name	Type	Description
configId	number	Target configuration
elementId	number	Element containing the option
optionId	number	Option whose quantity to set
quantity	number	New quantity value

Related

• valuesConfigs
• numberFormatterSubstore.calculateOptionPriceWithQuantities — reads quantities from this map

---

setValues

setValues: (configId: number, values: TValues) => void

Bulk-replaces all values for the given config.

Replaces the entire values map for configId. Use this when restoring state (e.g., from a draft) rather than setting values one element at a time.

Parameters

Name	Type	Description
configId	number	Target configuration
values	TValues	Complete values map (Record<elementId, string[]>)

Related

• valuesConfigs
• setQuantities — bulk-replace quantities

---

setQuantities

setQuantities: (configId: number, quantities: TQuantities) => void

Bulk-replaces all quantities for the given config.

Replaces the entire quantities map for configId. Use alongside setValues when restoring full config state.

Parameters

Name	Type	Description
configId	number	Target configuration
quantities	TQuantities	Complete quantities map (Record<elementId, Record<optionId, number>>)

Related

• valuesConfigs
• setValues — bulk-replace values

---

handleChangeInput

handleChangeInput: (args: {
  configId: number;
  type: TElement["type"];
  elementId: number;
  optionIdOrValue: string | number;
}) => void

Handles a user input event — toggles a checkbox option or sets a single value depending on element type.

This is the recommended method for wiring up UI input handlers. It implements the correct selection logic for each element type:

• Checkbox elements: toggles the option in the current values array (adds if absent, removes if present)
• All other types (radio, select, text, …): replaces the current selection with [optionIdOrValue]

Parameters

Name	Type	Description
args.configId	number	Target configuration
args.type	TElement["type"]	Element type — controls toggle vs replace behaviour
args.elementId	number	Target element
args.optionIdOrValue	string | number	Option ID (for option-based elements) or free-text value

Related

• setElementValue — called internally by this method
• valuesConfigs — updated by this call
• formSubstore.fromConfigs — element type is read from here