feat: add option to allow overwriting state values from query param population

[ziggy-cyb]

Description

In some cases it might be necessary to allow query parameters to overwrite present state values. For example, if there is an unreachable field in your form that should be pre-populated from a query parameter, and there is a chance the user may change their selection prior to entering the service that changes the value of that unreachable field, the query parameter should overwrite this value as there is no other way for the user to change their selection.

To solve this, an option allowOverwriteFromQueryParam has been added. This option will only have an effect if the component has already been given the allowPrePopulation flag.

• Added allowOverwriteFromQueryParam flag

Type of change

• New feature (non-breaking change which adds functionality)
• This change requires a documentation update

How Has This Been Tested?

Please describe the tests that you ran to verify your changes. Provide instructions so we can reproduce
the testing if necessary.

• Added unit test and modified current tests to check the value is changed where appropriate depending on the value in the state and the presence of the allowOverwiteFromQueryParam flag
• Manual testing to check values are updating as expected

Checklist:

• I have performed a self-review of my own code
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation and versioning
• I have updated the architecture diagrams as per Contribute.md OR added an architectural decision record entry

[jenbutongit]

maybe allowPrePopulationOverwrite so the flag looks more related to allowPrePopulation?

[jenbutongit]

The array indexing makes it hard to follow

Suggested change

	const schemaMapping = Object.entries(schema)[0];
	return {
	[schemaMapping[0]]: {
	schema: schemaMapping[1],
	allowOverwriteFromQueryParam:
	item.options.allowOverwriteFromQueryParam,
	},
	};
	})
	return {
	[item.name]: {
	schema: schema[item.name],
	allowOverwriteFromQueryParam:
	item.options.allowOverwriteFromQueryParam,
	},
	};
	})

alternatively, you can use destructuring to give schemaMapping[0,1] more meaningful names, but Object.entries(schema)[0]; still looks a bit odd imo

Suggested change

	const schemaMapping = Object.entries(schema)[0];
	return {
	[schemaMapping[0]]: {
	schema: schemaMapping[1],
	allowOverwriteFromQueryParam:
	item.options.allowOverwriteFromQueryParam,
	},
	};
	})
	const [key, joiSchema] = Object.entries(schema)[0];
	return {
	[key]: {
	schema: joiSchema,
	allowOverwriteFromQueryParam:
	item.options.allowOverwriteFromQueryParam,
	},
	};
	})