@planning-inspectorate/dynamic-forms 3.15.6 → 3.17.0

package/src/components/radio/question.test.js

@@ -96,78 +96,157 @@ describe('./src/dynamic-forms/components/radio/question.js', () => {
 		assert.strictEqual(preppedQuestion.question.label, LABEL);
 	});
 
-	it('should customise answer for summary when question has a conditional field filled in', () => {
-		const radioQuestion = new RadioQuestion({
-			title: TITLE,
-			question: QUESTION,
-			description: DESCRIPTION,
-			fieldName: FIELDNAME,
-			viewFolder: VIEWFOLDER,
-			html: HTML,
-			label: LABEL,
-			options: OPTIONS
+	describe('formatAnswer', () => {
+		it('should delegate simple string answers to parent class', () => {
+			const radioQuestion = new RadioQuestion({
+				title: TITLE,
+				question: QUESTION,
+				description: DESCRIPTION,
+				fieldName: FIELDNAME,
+				options: [
+					{ text: 'Option 1', value: 'op-1' },
+					{ text: 'Option 2', value: 'op-2' }
+				]
+			});
+
+			const result = radioQuestion.formatAnswer('op-1');
+			assert.strictEqual(result, 'Option 1');
 		});
 
-		const rowParams = radioQuestion.formatAnswerForSummary(SECTION, JOURNEY, {
-			value: 'yes',
-			conditional: 'test'
+		it('should format object answer with value only (no conditional)', () => {
+			const radioQuestion = new RadioQuestion({
+				title: TITLE,
+				question: QUESTION,
+				description: DESCRIPTION,
+				fieldName: FIELDNAME,
+				options: OPTIONS
+			});
+
+			const result = radioQuestion.formatAnswer({ value: 'no' });
+			assert.strictEqual(result, 'No');
 		});
-		assert.strictEqual(rowParams[0].value, 'Yes<br>test');
-	});
 
-	it('should use option text (not value) for display', () => {
-		const radioQuestion = new RadioQuestion({
-			title: TITLE,
-			question: QUESTION,
-			description: DESCRIPTION,
-			fieldName: FIELDNAME,
-			viewFolder: VIEWFOLDER,
-			html: HTML,
-			label: LABEL,
-			options: [
-				{ text: 'Option 1', value: 'op-1' },
-				{ text: 'Option 2', value: 'op-2' }
-			]
+		it('should format object answer with conditional', () => {
+			const radioQuestion = new RadioQuestion({
+				title: TITLE,
+				question: QUESTION,
+				description: DESCRIPTION,
+				fieldName: FIELDNAME,
+				options: OPTIONS
+			});
+
+			const result = radioQuestion.formatAnswer({
+				value: 'yes',
+				conditional: { yes: 'test details' }
+			});
+			assert.strictEqual(result, 'Yes<br>test details');
 		});
 
-		const rowParams = radioQuestion.formatAnswerForSummary(SECTION, JOURNEY, 'op-1');
-		assert.strictEqual(rowParams[0].value, 'Option 1');
-	});
+		it('should format object answer with conditional and label', () => {
+			const optionsWithLabel = [...OPTIONS];
+			optionsWithLabel[0] = {
+				...optionsWithLabel[0],
+				conditional: {
+					...optionsWithLabel[0].conditional,
+					label: 'label:'
+				}
+			};
+			const radioQuestion = new RadioQuestion({
+				title: TITLE,
+				question: QUESTION,
+				description: DESCRIPTION,
+				fieldName: FIELDNAME,
+				options: optionsWithLabel
+			});
+
+			const result = radioQuestion.formatAnswer({
+				value: 'yes',
+				conditional: { yes: 'test details' }
+			});
+			assert.strictEqual(result, 'Yes<br>label: test details');
+		});
 
-	it('should customise answer for summary and add label when question has a conditional field filled in and conditional field has a label', () => {
-		const optionsWithLabel = [...OPTIONS];
-		optionsWithLabel[0].conditional.label = 'label:';
-		const radioQuestion = new RadioQuestion({
-			title: TITLE,
-			question: QUESTION,
-			description: DESCRIPTION,
-			fieldName: FIELDNAME,
-			viewFolder: VIEWFOLDER,
-			html: HTML,
-			label: LABEL,
-			options: optionsWithLabel
+		it('should fall back to value when option not found in object answer', () => {
+			const radioQuestion = new RadioQuestion({
+				title: TITLE,
+				question: QUESTION,
+				description: DESCRIPTION,
+				fieldName: FIELDNAME,
+				options: OPTIONS
+			});
+
+			const result = radioQuestion.formatAnswer({ value: 'unknown' });
+			assert.strictEqual(result, 'unknown');
 		});
 
-		const rowParams = radioQuestion.formatAnswerForSummary(SECTION, JOURNEY, {
-			value: 'yes',
-			conditional: 'test'
+		it('should escape HTML in option text', () => {
+			const radioQuestion = new RadioQuestion({
+				title: TITLE,
+				question: QUESTION,
+				description: DESCRIPTION,
+				fieldName: FIELDNAME,
+				options: [{ text: '<script>alert("xss")</script>', value: 'xss' }]
+			});
+
+			const result = radioQuestion.formatAnswer('xss');
+			assert.strictEqual(result, '&lt;script&gt;alert(&quot;xss&quot;)&lt;/script&gt;');
 		});
-		assert.strictEqual(rowParams[0].value, 'Yes<br>label: test');
-	});
 
-	it('should not customise answer for summary when question does not have a conditional field filled in', () => {
-		const radioQuestion = new RadioQuestion({
-			title: TITLE,
-			question: QUESTION,
-			description: DESCRIPTION,
-			fieldName: FIELDNAME,
-			viewFolder: VIEWFOLDER,
-			html: HTML,
-			label: LABEL,
-			options: OPTIONS
+		it('should escape HTML in conditional value', () => {
+			const radioQuestion = new RadioQuestion({
+				title: TITLE,
+				question: QUESTION,
+				description: DESCRIPTION,
+				fieldName: FIELDNAME,
+				options: [
+					{
+						text: 'Yes',
+						value: 'yes',
+						conditional: { fieldName: 'details', type: 'text' }
+					}
+				]
+			});
+
+			const result = radioQuestion.formatAnswer({
+				value: 'yes',
+				conditional: { yes: '<img src=x onerror=alert(1)>' }
+			});
+			assert.strictEqual(result, 'Yes<br>&lt;img src=x onerror=alert(1)&gt;');
 		});
 
-		const rowParams = radioQuestion.formatAnswerForSummary(SECTION, JOURNEY, 'no');
-		assert.strictEqual(rowParams[0].value, 'No');
+		it('should escape HTML in conditional label', () => {
+			const radioQuestion = new RadioQuestion({
+				title: TITLE,
+				question: QUESTION,
+				description: DESCRIPTION,
+				fieldName: FIELDNAME,
+				options: [
+					{
+						text: 'Yes',
+						value: 'yes',
+						conditional: { fieldName: 'details', type: 'text', label: '<b>Label</b>' }
+					}
+				]
+			});
+
+			const result = radioQuestion.formatAnswer({
+				value: 'yes',
+				conditional: { yes: 'safe value' }
+			});
+			assert.strictEqual(result, 'Yes<br>&lt;b&gt;Label&lt;/b&gt; safe value');
+		});
+
+		it('should escape HTML in fallback value when option not found', () => {
+			const radioQuestion = new RadioQuestion({
+				title: TITLE,
+				question: QUESTION,
+				description: DESCRIPTION,
+				fieldName: FIELDNAME,
+				options: OPTIONS
+			});
+
+			const result = radioQuestion.formatAnswer({ value: '<script>xss</script>' });
+			assert.strictEqual(result, '&lt;script&gt;xss&lt;/script&gt;');
+		});
 	});
 });

package/src/components/select/question.d.ts

@@ -0,0 +1,12 @@
+export class SelectQuestion extends OptionsQuestion {
+    /**
+     * @param {import('#typedefs/question-props.d.ts').SelectQuestionParams} params
+     */
+    constructor({ label, html, legend, disableAccessibleAutocomplete, viewFolder, ...parentParams }: import("#typedefs/question-props.d.ts").SelectQuestionParams);
+    label: string | undefined;
+    legend: string | undefined;
+    #private;
+}
+export default SelectQuestion;
+import OptionsQuestion from '../../questions/options-question.js';
+//# sourceMappingURL=question.d.ts.map

package/src/components/select/question.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"question.d.ts","sourceRoot":"","sources":["question.js"],"names":[],"mappings":"AAEA;IAEC;;OAEG;IACH,iGAFW,OAAO,+BAA+B,EAAE,oBAAoB,EAYtE;IAHA,0BAAkB;IAClB,2BAAoB;;CAYrB;;4BA3B2B,qCAAqC"}

package/src/components/select/question.js

@@ -3,37 +3,12 @@ import OptionsQuestion from '../../questions/options-question.js';
 export class SelectQuestion extends OptionsQuestion {
 	#disableAccessibleAutocomplete;
 	/**
-	 * @param {import('../../questions/question-props.d.ts').SelectQuestionParams} params
+	 * @param {import('#typedefs/question-props.d.ts').SelectQuestionParams} params
 	 */
-	constructor({
-		title,
-		question,
-		fieldName,
-		viewFolder,
-		url,
-		hint,
-		pageTitle,
-		description,
-		label,
-		html,
-		legend,
-		disableAccessibleAutocomplete,
-		options,
-		validators,
-		viewData
-	}) {
+	constructor({ label, html, legend, disableAccessibleAutocomplete, viewFolder, ...parentParams }) {
 		super({
-			title,
-			question,
-			viewFolder: !viewFolder ? 'select' : viewFolder,
-			fieldName,
-			url,
-			hint,
-			pageTitle,
-			description,
-			options,
-			validators,
-			viewData
+			...parentParams,
+			viewFolder: viewFolder || 'select'
 		});
 
 		this.html = html;
@@ -43,31 +18,13 @@ export class SelectQuestion extends OptionsQuestion {
 	}
 
 	/**
-	 * @param {import('#question').QuestionViewModel} viewModel
+	 * @param {import('#typedefs/question-types.d.ts').QuestionViewModel} viewModel
 	 */
 	addCustomDataToViewModel(viewModel) {
 		viewModel.question.label = this.label;
 		viewModel.question.legend = this.legend;
 		viewModel.question.disableAccessibleAutocomplete = this.#disableAccessibleAutocomplete;
 	}
-
-	/**
-	 * returns the formatted answers values to be used to build task list elements
-	 * note: only supports a single answer
-	 *
-	 * @param {unknown} answer
-	 * @param {Journey} journey
-	 * @param {String} sectionSegment
-	 * @returns {Array.<Object>}
-	 */
-	formatAnswerForSummary(sectionSegment, journey, answer) {
-		if (answer) {
-			const selectedOption = this.options.find((option) => option.value === answer);
-			const selectedText = selectedOption?.text || '';
-			return super.formatAnswerForSummary(sectionSegment, journey, selectedText, false);
-		}
-		return super.formatAnswerForSummary(sectionSegment, journey, answer);
-	}
 }
 
 export default SelectQuestion;

package/{types/src → src}/components/single-line-input/question.d.ts

@@ -3,9 +3,9 @@
  */
 export class SingleLineInputQuestion extends Question {
     /**
-     * @param {import('../../questions/question-props.d.ts').SingleLineInputQuestionParams} params
+     * @param {import('#typedefs/question-props.d.ts').SingleLineInputQuestionParams} params
      */
-    constructor(params: import("../../questions/question-props.d.ts").SingleLineInputQuestionParams);
+    constructor(params: import("#typedefs/question-props.d.ts").SingleLineInputQuestionParams);
     /** @type {Record<string, string>} */
     inputAttributes: Record<string, string>;
     label: string | undefined;

package/src/components/single-line-input/question.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"question.d.ts","sourceRoot":"","sources":["question.js"],"names":[],"mappings":"AAEA;;GAEG;AACH;IAIC;;OAEG;IACH,oBAFW,OAAO,+BAA+B,EAAE,6BAA6B,EAW/E;IAfD,qCAAqC;IACrC,iBADW,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CACjB;IAWf,0BAAyB;IAEzB,gBAAmC;CAepC;;yBAnCwB,WAAW"}

package/src/components/single-line-input/question.js

@@ -8,7 +8,7 @@ export class SingleLineInputQuestion extends Question {
 	inputAttributes;
 
 	/**
-	 * @param {import('../../questions/question-props.d.ts').SingleLineInputQuestionParams} params
+	 * @param {import('#typedefs/question-props.d.ts').SingleLineInputQuestionParams} params
 	 */
 	constructor(params) {
 		super({
@@ -22,7 +22,7 @@ export class SingleLineInputQuestion extends Question {
 	}
 
 	/**
-	 * @param {import('#question').QuestionViewModel} viewModel
+	 * @param {import('#typedefs/question-types.d.ts').QuestionViewModel} viewModel
 	 */
 	addCustomDataToViewModel(viewModel) {
 		viewModel.question.label = this.label;

package/{types/src → src}/components/text-entry/question.d.ts

@@ -16,10 +16,10 @@
  */
 export class TextEntryQuestion extends Question {
     /**
-     * @param {import('../../questions/question-props.d.ts').TextEntryQuestionParams} params
+     * @param {import('#typedefs/question-props.d.ts').TextEntryQuestionParams} params
      */
-    constructor({ textEntryCheckbox, label, ...parentParams }: import("../../questions/question-props.d.ts").TextEntryQuestionParams);
-    textEntryCheckbox: import("../../questions/question-props.d.ts").TextEntryCheckbox | undefined;
+    constructor({ textEntryCheckbox, label, ...parentParams }: import("#typedefs/question-props.d.ts").TextEntryQuestionParams);
+    textEntryCheckbox: import("#typedefs/question-props.d.ts").TextEntryCheckbox | undefined;
     label: string | undefined;
 }
 export default TextEntryQuestion;

package/src/components/text-entry/question.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"question.d.ts","sourceRoot":"","sources":["question.js"],"names":[],"mappings":"AACA;;;;;GAKG;AAEH;;;;;;GAMG;AAEH;;GAEG;AACH;IACC;;OAEG;IACH,2DAFW,OAAO,+BAA+B,EAAE,uBAAuB,EAUzE;IAFA,yFAA0C;IAC1C,0BAAkB;CAUnB;;;YA9Ba,MAAM;UACN,MAAM;UACN,MAAM;;;yBAZK,WAAW"}

package/src/components/text-entry/question.js

@@ -19,7 +19,7 @@ import { Question } from '#question';
  */
 export class TextEntryQuestion extends Question {
 	/**
-	 * @param {import('../../questions/question-props.d.ts').TextEntryQuestionParams} params
+	 * @param {import('#typedefs/question-props.d.ts').TextEntryQuestionParams} params
 	 */
 	constructor({ textEntryCheckbox, label, ...parentParams }) {
 		super({
@@ -32,7 +32,7 @@ export class TextEntryQuestion extends Question {
 	}
 
 	/**
-	 * @param {import('#question').QuestionViewModel} viewModel
+	 * @param {import('#typedefs/question-types.d.ts').QuestionViewModel} viewModel
 	 */
 	addCustomDataToViewModel(viewModel) {
 		viewModel.question.label = this.label;

package/{types/src → src}/components/text-entry-redact/question.d.ts

@@ -5,23 +5,22 @@ export const TRUNCATED_MAX_LENGTH: 500;
  */
 export class TextEntryRedactQuestion extends Question {
     /**
-     * @param {import('../../questions/question-props.d.ts').TextEntryRedactQuestionParams} params
+     * @param {import('#typedefs/question-props.d.ts').TextEntryRedactQuestionParams} params
      */
-    constructor({ textEntryCheckbox, label, onlyShowRedactedValueForSummary, useRedactedFieldNameForSave, showSuggestionsUi, summaryText, shouldTruncateSummary, ...parentParams }: import("../../questions/question-props.d.ts").TextEntryRedactQuestionParams);
-    textEntryCheckbox: import("../../questions/question-props.d.ts").TextEntryCheckbox | undefined;
+    constructor({ textEntryCheckbox, label, onlyShowRedactedValueForSummary, useRedactedFieldNameForSave, showSuggestionsUi, summaryText, shouldTruncateSummary, ...parentParams }: import("#typedefs/question-props.d.ts").TextEntryRedactQuestionParams);
+    textEntryCheckbox: import("#typedefs/question-props.d.ts").TextEntryCheckbox | undefined;
     label: string | undefined;
     onlyShowRedactedValueForSummary: boolean | undefined;
     useRedactedFieldNameForSave: boolean | undefined;
     showSuggestionsUi: boolean | undefined;
     summaryText: string | undefined;
     shouldTruncateSummary: boolean | undefined;
-    prepQuestionForRendering(section: any, journey: any, customViewData: any, payload: any, options: any): import("#question").QuestionViewModel;
+    prepQuestionForRendering(section: any, journey: any, customViewData: any, payload: any, options: any): import("#typedefs/question-types.d.ts").QuestionViewModel<import("#typedefs/question-types.d.ts").BaseQuestionViewData>;
     answerForViewModel(answers: any): string;
-    formatAnswerForSummary(sectionSegment: any, journey: any, answer: any, capitals?: boolean): {
-        key: string;
-        value: string | Object;
-        action?: import("../../controller.js").ActionView | import("../../controller.js").ActionView[];
-    }[];
+    /**
+     * returns the formatted answers values to be used to build task list elements
+     */
+    formatAnswerForSummary(sectionSegment: any, journey: any, answer: any, capitals?: boolean): import("#typedefs/question-types.d.ts").SummaryRow[];
 }
 export default TextEntryRedactQuestion;
 import { Question } from '#question';

package/src/components/text-entry-redact/question.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"question.d.ts","sourceRoot":"","sources":["question.js"],"names":[],"mappings":"AAGA,+BAAgC,QAAG,CAAC;AACpC,mCAAoC,GAAG,CAAC;AAExC;;GAEG;AACH;IACC;;OAEG;IACH,gLAFW,OAAO,+BAA+B,EAAE,6BAA6B,EAwB/E;IAPA,yFAA0C;IAC1C,0BAAkB;IAClB,qDAAsE;IACtE,iDAA8D;IAC9D,uCAA0C;IAC1C,gCAA8B;IAC9B,2CAAkD;IAkBnD,+NAOC;IAED,yCAEC;IAYD;;OAEG;IACH,iJAuBC;CACD;;yBAtGwB,WAAW"}

package/src/components/text-entry-redact/question.js

@@ -9,7 +9,7 @@ export const TRUNCATED_MAX_LENGTH = 500;
  */
 export class TextEntryRedactQuestion extends Question {
 	/**
-	 * @param {import('../../questions/question-props.d.ts').TextEntryRedactQuestionParams} params
+	 * @param {import('#typedefs/question-props.d.ts').TextEntryRedactQuestionParams} params
 	 */
 	constructor({
 		textEntryCheckbox,
@@ -64,7 +64,7 @@ export class TextEntryRedactQuestion extends Question {
 	}
 
 	/**
-	 * @param {import('#question').QuestionViewModel} viewModel
+	 * @param {import('#typedefs/question-types.d.ts').QuestionViewModel} viewModel
 	 */
 	addCustomDataToViewModel(viewModel) {
 		viewModel.question.label = this.label;
@@ -73,6 +73,9 @@ export class TextEntryRedactQuestion extends Question {
 		viewModel.showSuggestionsUi = this.showSuggestionsUi;
 	}
 
+	/**
+	 * returns the formatted answers values to be used to build task list elements
+	 */
 	formatAnswerForSummary(sectionSegment, journey, answer, capitals = true) {
 		const redacted = journey.response.answers[this.fieldName + 'Redacted'];
 		let toShow;

package/{types/src → src}/components/unit-option-entry/question.d.ts

@@ -24,10 +24,10 @@
  */
 export class UnitOptionEntryQuestion extends Question {
     /**
-     * @param {import('../../questions/question-props.d.ts').UnitOptionEntryQuestionParams} params
+     * @param {import('#typedefs/question-props.d.ts').UnitOptionEntryQuestionParams} params
      * @param {Record<string, Function>} [methodOverrides]
      */
-    constructor({ conditionalFieldName, options, label, ...parentParams }: import("../../questions/question-props.d.ts").UnitOptionEntryQuestionParams, methodOverrides?: Record<string, Function>);
+    constructor({ conditionalFieldName, options, label, ...parentParams }: import("#typedefs/question-props.d.ts").UnitOptionEntryQuestionParams, methodOverrides?: Record<string, Function>);
     /** @type {Array<UnitOption>} */
     options: Array<UnitOption>;
     conditionalFieldName: string;
@@ -35,19 +35,19 @@ export class UnitOptionEntryQuestion extends Question {
     optionJoinString: string;
     /**
      * gets the view model for this question
-     * @param {import('../../section').Section} section - the current section
+     * @param {import('../../section.js').Section} section - the current section
      * @param {import('#journey').Journey} journey - the journey we are in
      * @param {Record<string, unknown>} [customViewData] additional data to send to view
      * @param {Record<string, unknown>} [payload]
-     * @param {import('#question-types').PrepQuestionForRenderingOptions} options
-     * @returns {import('../../questions/question.js').QuestionViewModel & {
-     *   question: import('../../questions/question.js').QuestionViewModel['question'] & {
+     * @param {import('#typedefs/question-types.d.ts').PrepQuestionForRenderingOptions} options
+     * @returns {import('#typedefs/question-types.d.ts').QuestionViewModel & {
+     *   question: import('#typedefs/question-types.d.ts').QuestionViewModel['question'] & {
      *     options:UnitOption[]
      *   }
      * }}
      */
-    prepQuestionForRendering(section: any, journey: import("#journey").Journey, customViewData?: Record<string, unknown>, payload?: Record<string, unknown>, options: import("#question-types").PrepQuestionForRenderingOptions): import("../../questions/question.js").QuestionViewModel & {
-        question: import("../../questions/question.js").QuestionViewModel["question"] & {
+    prepQuestionForRendering(section: import("../../section.js").Section, journey: import("#journey").Journey, customViewData?: Record<string, unknown>, payload?: Record<string, unknown>, options: import("#typedefs/question-types.d.ts").PrepQuestionForRenderingOptions): import("#typedefs/question-types.d.ts").QuestionViewModel & {
+        question: import("#typedefs/question-types.d.ts").QuestionViewModel["question"] & {
             options: UnitOption[];
         };
     };
@@ -59,6 +59,10 @@ export class UnitOptionEntryQuestion extends Question {
      */ getDataToSave(req: import("express").Request, journeyResponse: JourneyResponse): Promise<{
         answers: Record<string, unknown>;
     }>;
+    /**
+     * returns the formatted answers values to be used to build task list elements
+     */
+    formatAnswerForSummary(sectionSegment: any, journey: any, answer: any): import("#typedefs/question-types.d.ts").SummaryRow[];
 }
 export default UnitOptionEntryQuestion;
 /**

package/src/components/unit-option-entry/question.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"question.d.ts","sourceRoot":"","sources":["question.js"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH;IAIC;;;OAGG;IACH,uEAHW,OAAO,+BAA+B,EAAE,6BAA6B,oBACrE,MAAM,CAAC,MAAM,WAAW,EAkBlC;IAvBD,gCAAgC;IAChC,SADW,KAAK,CAAC,UAAU,CAAC,CACpB;IAkBP,6BAAgD;IAEhD,0BAAkB;IAClB,yBAA+C;IAGhD;;;;;;;;;;;;OAYG;IACH,kCAXW,OAAO,kBAAkB,EAAE,OAAO,WAClC,OAAO,UAAU,EAAE,OAAO,mBAC1B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YACvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,WACvB,OAAO,+BAA+B,EAAE,+BAA+B,GACrE,OAAO,+BAA+B,EAAE,iBAAiB,GAAG;QACpE,QAAQ,EAAE,OAAO,+BAA+B,EAAE,iBAAiB,CAAC,UAAU,CAAC,GAAG;YAChF,OAAO,EAAC,UAAU,EAAE,CAAA;SACrB,CAAA;KACF,CAmDH;IAED;;;;;OAKG,CACH,mBAJW,OAAO,SAAS,EAAE,OAAO,mBACzB,eAAe,GACb,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAgCzD;IAED;;OAEG;IACH,6HAaC;CACD;;;;;;;;;;yBAnKY;IACR,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,WAAW,EAAE;QACX,SAAS,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,OAAO,CAAC;QACZ,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAA;CACH;yBA5BsB,6BAA6B"}

package/src/components/unit-option-entry/question.js

@@ -35,7 +35,7 @@ export class UnitOptionEntryQuestion extends Question {
 	options;
 
 	/**
-	 * @param {import('../../questions/question-props.d.ts').UnitOptionEntryQuestionParams} params
+	 * @param {import('#typedefs/question-props.d.ts').UnitOptionEntryQuestionParams} params
 	 * @param {Record<string, Function>} [methodOverrides]
 	 */
 	constructor({ conditionalFieldName, options, label, ...parentParams }, methodOverrides) {
@@ -58,13 +58,13 @@ export class UnitOptionEntryQuestion extends Question {
 
 	/**
 	 * gets the view model for this question
-	 * @param {import('../../section').Section} section - the current section
+	 * @param {import('../../section.js').Section} section - the current section
 	 * @param {import('#journey').Journey} journey - the journey we are in
 	 * @param {Record<string, unknown>} [customViewData] additional data to send to view
 	 * @param {Record<string, unknown>} [payload]
-	 * @param {import('#question-types').PrepQuestionForRenderingOptions} options
-	 * @returns {import('../../questions/question.js').QuestionViewModel & {
-	 *   question: import('../../questions/question.js').QuestionViewModel['question'] & {
+	 * @param {import('#typedefs/question-types.d.ts').PrepQuestionForRenderingOptions} options
+	 * @returns {import('#typedefs/question-types.d.ts').QuestionViewModel & {
+	 *   question: import('#typedefs/question-types.d.ts').QuestionViewModel['question'] & {
 	 *     options:UnitOption[]
 	 *   }
 	 * }}
@@ -160,7 +160,6 @@ export class UnitOptionEntryQuestion extends Question {
 
 	/**
 	 * returns the formatted answers values to be used to build task list elements
-	 * @type {Question['formatAnswerForSummary']}
 	 */
 	formatAnswerForSummary(sectionSegment, journey, answer) {
 		if (answer == null) return super.formatAnswerForSummary(sectionSegment, journey, answer);

package/src/components/utils/component-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-types.d.ts","sourceRoot":"","sources":["component-types.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG"}

package/src/components/utils/persisted-number-answer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persisted-number-answer.d.ts","sourceRoot":"","sources":["persisted-number-answer.js"],"names":[],"mappings":"AAGO,iDAFI,MAAM,mBAYhB"}

package/src/components/utils/question-has-answer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"question-has-answer.d.ts","sourceRoot":"","sources":["question-has-answer.js"],"names":[],"mappings":"AAOO,8CAHI,OAAO,mCAAmC,EAAE,eAAe,GACzD;IAAC,GAAG,EAAE,eAAe,CAAC;IAAC,EAAE,EAAE,eAAe,CAAA;CAAC,CAOtD;AAYK,gDAJI,OAAO,6BAA6B,EAAE,QAAQ,iBAC9C,OAAO,GACL,OAAO,kBAAkB,EAAE,iBAAiB,CAIxD;AAUM,4CALI,OAAO,mCAAmC,EAAE,eAAe,YAC3D,OAAO,6BAA6B,EAAE,QAAQ,GAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAC,iBACzE,OAAO,GACL,OAAO,CAgBnB;AAUM,sDALI,OAAO,mCAAmC,EAAE,eAAe,YAC3D,GAAG,gBACH,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,GACpB,OAAO,CAWnB;AASM,+CANI,OAAO,mCAAmC,EAAE,eAAe,qBAC3D,iBAAiB,0BAEzB;IAA8B,iBAAiB,EAAvC,KAAK,GAAG,IAAI;CACpB,GAAU,OAAO,CAUnB;AAOM,0DAJI,OAAO,mCAAmC,EAAE,eAAe,YAC3D,OAAO,6BAA6B,EAAE,QAAQ,GAC5C,OAAO,CAMnB;AAOM,0DAJI,OAAO,mCAAmC,EAAE,eAAe,YAC3D,OAAO,6BAA6B,EAAE,QAAQ,GAC5C,OAAO,CAMnB;gCA5Ga,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE;8BAChB,CAAC,iBAAiB,EAAE,iBAAiB,KAAK,OAAO"}

package/src/components/utils/question-has-answer.js

@@ -41,7 +41,7 @@ export const questionHasAnswer = (response, question, expectedValue) => {
 	if (Array.isArray(answerField)) {
 		return answerField.includes(expectedValue);
 	} else if (question.optionJoinString && typeof answerField === 'string') {
-		// todo: answers from options questions sometimes are array sometimes string, why?
+		// todo: DF-51 answers from options questions sometimes are array sometimes string, why?
 		if (!answerField) return false;
 		const answers = answerField.split(question.optionJoinString);
 		return answers.includes(expectedValue);

package/src/components/utils/question-utils.d.ts

@@ -0,0 +1,33 @@
+export function getConditionalFieldName(parentField: any, conditionalField: any): string;
+/**
+ * Get conditional answer(s) for a question.
+ * Returns an object keyed by option value with conditional answers, or null if no conditionals exist.
+ *
+ * @param {Record<string, unknown>} answers - all answers
+ * @param {{options?: Array<{value: string, conditional?: {fieldName: string}}>, fieldName: string, optionJoinString?: string}} question - question with options
+ * @param {string} answer - the answer value (may be separated by optionJoinString for checkboxes)
+ * @returns {Record<string, string> | null} conditional answer(s) keyed by option value
+ */
+export function getConditionalAnswer(answers: Record<string, unknown>, question: {
+    options?: Array<{
+        value: string;
+        conditional?: {
+            fieldName: string;
+        };
+    }>;
+    fieldName: string;
+    optionJoinString?: string;
+}, answer: string): Record<string, string> | null;
+/**
+ * @param {unknown} conditional
+ * @returns {conditional is {html: string}}
+ */
+export function conditionalIsJustHTML(conditional: unknown): conditional is {
+    html: string;
+};
+declare namespace _default {
+    export { getConditionalAnswer };
+    export { getConditionalFieldName };
+}
+export default _default;
+//# sourceMappingURL=question-utils.d.ts.map

package/src/components/utils/question-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"question-utils.d.ts","sourceRoot":"","sources":["question-utils.js"],"names":[],"mappings":"AAAA,yFAEC;AAED;;;;;;;;GAQG;AACH,8CALW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YACvB;IAAC,OAAO,CAAC,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE;YAAC,SAAS,EAAE,MAAM,CAAA;SAAC,CAAA;KAAC,CAAC,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAC,UACnH,MAAM,GACJ,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAyBzC;AAED;;;GAGG;AACH,mDAHW,OAAO,GACL,WAAW,IAAI;IAAC,IAAI,EAAE,MAAM,CAAA;CAAC,CAIzC"}

package/src/components/utils/question-utils.js

@@ -2,9 +2,38 @@ export function getConditionalFieldName(parentField, conditionalField) {
 	return `${parentField}_${conditionalField}`;
 }
 
+/**
+ * Get conditional answer(s) for a question.
+ * Returns an object keyed by option value with conditional answers, or null if no conditionals exist.
+ *
+ * @param {Record<string, unknown>} answers - all answers
+ * @param {{options?: Array<{value: string, conditional?: {fieldName: string}}>, fieldName: string, optionJoinString?: string}} question - question with options
+ * @param {string} answer - the answer value (may be separated by optionJoinString for checkboxes)
+ * @returns {Record<string, string> | null} conditional answer(s) keyed by option value
+ */
 export function getConditionalAnswer(answers, question, answer) {
-	const conditionalFieldName = question.options?.find((option) => option.value === answer)?.conditional?.fieldName;
-	return conditionalFieldName ? answers[getConditionalFieldName(question.fieldName, conditionalFieldName)] : null;
+	if (!answer || !question.options) {
+		return null;
+	}
+
+	// TODO DF-51 treat as an array
+	const joinString = question.optionJoinString || ',';
+	const answerValues = String(answer)
+		.split(joinString)
+		.map((v) => v.trim());
+
+	const conditionals = {};
+	for (const value of answerValues) {
+		const option = question.options.find((opt) => opt.value === value);
+		if (!option?.conditional?.fieldName) {
+			continue;
+		}
+		const conditionalValue = answers[getConditionalFieldName(question.fieldName, option.conditional.fieldName)];
+		if (conditionalValue) {
+			conditionals[value] = conditionalValue;
+		}
+	}
+	return Object.keys(conditionals).length > 0 ? conditionals : null;
 }
 
 /**