@defra/forms-model 3.0.502 → 3.0.504

package/dist/types/__stubs__/pages.d.ts

@@ -1,10 +1,24 @@
 import { type PageFileUpload, type PageQuestion, type PageRepeat, type PageSummary } from '../form/form-definition/types.js';
+import { ControllerType } from '../pages/enums.js';
 /**
  * Stub builder for a question page
  * @param {Partial<PageQuestion>} [partialPage]
  * @returns {PageQuestion}
  */
 export declare function buildQuestionPage(partialPage: Partial<PageQuestion>): PageQuestion;
+export declare const GUIDANCE_PAGE_CONTENT = "Lorem ipsum dolar sit amet";
+export declare function buildGuidancePage(partialPage: Partial<PageQuestion>): {
+    controller?: ControllerType.Page | undefined;
+    section?: string | undefined | undefined;
+    next: import("../form/form-definition/types.js").Link[];
+    components: import("../index.js").ComponentDef[];
+    id: string;
+    title: string;
+    path: string;
+    condition?: string | undefined;
+    events?: import("../form/form-definition/types.js").Events | undefined;
+    view?: string | undefined;
+};
 /**
  * Stub builder for a Summary page
  * @param {Partial<PageSummary>} [partialSummaryPage]

package/dist/types/__stubs__/pages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../../../src/__stubs__/pages.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,WAAW,EACjB,MAAM,qCAAqC,CAAA;AAG5C;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,OAAO,CAAC,YAAY,CAAC,GACjC,YAAY,CASd;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,kBAAkB,GAAE,OAAO,CAAC,WAAW,CAAM,GAC5C,WAAW,CAQb;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,qBAAqB,GAAE,OAAO,CAAC,cAAc,CAAM,GAClD,cAAc,CAwBhB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,mBAAmB,GAAE,OAAO,CAAC,UAAU,CAAM,GAC5C,UAAU,CAyBZ"}
+{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../../../src/__stubs__/pages.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,WAAW,EACjB,MAAM,qCAAqC,CAAA;AAC5C,OAAO,EAAkB,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAErE;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,OAAO,CAAC,YAAY,CAAC,GACjC,YAAY,CASd;AAED,eAAO,MAAM,qBAAqB,+BAA+B,CAAA;AACjE,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,OAAO,CAAC,YAAY,CAAC;iBAoB/D,eAAiB,IAAG;;;;;;;;;;EAPxB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,kBAAkB,GAAE,OAAO,CAAC,WAAW,CAAM,GAC5C,WAAW,CAQb;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,qBAAqB,GAAE,OAAO,CAAC,cAAc,CAAM,GAClD,cAAc,CAwBhB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,mBAAmB,GAAE,OAAO,CAAC,UAAU,CAAM,GAC5C,UAAU,CAyBZ"}

package/dist/types/form/form-editor/preview/controller/guidance-page-controller.d.ts

@@ -0,0 +1,10 @@
+export class GuidancePageController extends PreviewPageControllerBase {
+    /**
+     * @type {Markdown}
+     * @protected
+     */
+    protected _unhighlightedEmptyGuidance: Markdown;
+}
+import { PreviewPageControllerBase } from '../../../../form/form-editor/preview/controller/page-controller-base.js';
+import type { Markdown } from '../../../../form/form-editor/preview/markdown.js';
+//# sourceMappingURL=guidance-page-controller.d.ts.map

package/dist/types/form/form-editor/preview/controller/guidance-page-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guidance-page-controller.d.ts","sourceRoot":"","sources":["../../../../../../src/form/form-editor/preview/controller/guidance-page-controller.js"],"names":[],"mappings":"AAIA;IACE;;;OAGG;IACH,uCAHU,QAAQ,CAIwC;CAgD3D;0CA1DyC,mEAAmE;8BA6DhF,4CAA4C"}

package/dist/types/form/form-editor/preview/controller/page-controller-base.d.ts

@@ -0,0 +1,198 @@
+/**
+ * @implements {PageOverviewElements}
+ */
+export class PagePreviewElements implements PageOverviewElements {
+    /**
+     * @param {Page|undefined} page
+     */
+    constructor(page: Page | undefined);
+    /**
+     * @type {Page | { title: string }}
+     * @private
+     */
+    private _page;
+    get heading(): string;
+    get guidance(): string;
+    get addHeading(): boolean;
+    get repeatQuestion(): string | undefined;
+    get hasRepeater(): boolean;
+}
+/**
+ * @abstract
+ * @implements {PagePreviewPanelMacro}
+ */
+export class PreviewPageControllerBase implements PagePreviewPanelMacro {
+    static PATH: string;
+    /**
+     * @type {typeof HighlightClass}
+     */
+    static HighlightClass: typeof HighlightClass;
+    /**
+     * Creates a dummy component for when guidance is highlighted
+     * but no guidance text exists
+     * @returns {Markdown}
+     */
+    static createGuidanceComponent(highlight?: boolean): Markdown;
+    /**
+     * @param {PagePreviewBaseElements} elements
+     * @param {PageRenderer} renderer
+     */
+    constructor(elements: PagePreviewBaseElements, renderer: PageRenderer);
+    /**
+     * @type {string}
+     * @protected
+     */
+    protected _pageTemplate: string;
+    /**
+     * @protected
+     * @type {Question[]}
+     */
+    protected _components: Question[];
+    /**
+     * @type {boolean}
+     * @protected
+     */
+    protected _showTitle: boolean;
+    /**
+     * @protected
+     * @type {string}
+     */
+    protected _title: string;
+    /**
+     * @type { undefined | HighlightClass }
+     * @protected
+     */
+    protected _highlighted: undefined | HighlightClass;
+    /**
+     * @type {string}
+     * @protected
+     */
+    protected _guidanceText: string;
+    /**
+     * @type { string }
+     * @protected
+     */
+    protected _sectionTitle: string;
+    /**
+     * @type {Markdown}
+     * @protected
+     */
+    protected _emptyGuidance: Markdown;
+    /**
+     * @type {Markdown}
+     * @protected
+     */
+    protected _guidanceComponent: Markdown;
+    /**
+     * @protected
+     * @type {boolean}
+     */
+    protected _isRepeater: boolean;
+    /**
+     * @returns {Markdown[]}
+     * @protected
+     */
+    protected _getGuidanceComponents(): Markdown[];
+    /**
+     * @returns {Markdown[]}
+     * @protected
+     */
+    protected get _guidanceComponents(): Markdown[];
+    /**
+     * @returns {PagePreviewComponent[]}
+     */
+    get components(): PagePreviewComponent[];
+    /**
+     * @returns {string}
+     * @protected
+     */
+    protected _getGuidanceText(): string;
+    set guidanceText(text: string);
+    /**
+     * @returns {string}
+     */
+    get guidanceText(): string;
+    get guidance(): {
+        text: string;
+        classes: string;
+    };
+    /**
+     * @param {boolean} showTitle
+     */
+    set showTitle(showTitle: boolean);
+    get showTitle(): boolean;
+    /**
+     * @returns {{ text: string, classes: string }}
+     */
+    get pageTitle(): {
+        text: string;
+        classes: string;
+    };
+    setRepeater(): void;
+    unsetRepeater(): void;
+    get isRepeater(): boolean;
+    render(): void;
+    /**
+     * @returns {string}
+     * @protected
+     */
+    protected _getTitle(): string;
+    /**
+     * @param {string} value
+     */
+    set title(value: string);
+    /**
+     * @returns {string}
+     */
+    get title(): string;
+    highlightTitle(): void;
+    /**
+     * @returns {{classes: string, text: string} | undefined}
+     */
+    get sectionTitle(): {
+        classes: string;
+        text: string;
+    } | undefined;
+    /**
+     * @returns {string|undefined}
+     * @protected
+     */
+    protected _getSectionTitleText(): string | undefined;
+    /**
+     * @param {string | undefined} val
+     */
+    set sectionTitleText(val: string | undefined);
+    get sectionTitleText(): string | undefined;
+    highlightGuidance(): void;
+    /**
+     * @param {HighlightClass} highlightSection
+     */
+    setHighLighted(highlightSection: HighlightClass): void;
+    clearHighlight(): void;
+    /**
+     * @param {string} field
+     * @protected
+     * @returns {string}
+     */
+    protected _isHighlighted(field: string): string;
+    #private;
+}
+import type { PageOverviewElements } from '../../../../form/form-editor/preview/types.js';
+import type { Page } from '../../../../form/form-definition/types.js';
+import type { PagePreviewPanelMacro } from '../../../../form/form-editor/macros/types.js';
+import type { Question } from '../../../../form/form-editor/preview/question.js';
+/**
+ * Enum for Highlight classes
+ */
+type HighlightClass = string;
+declare namespace HighlightClass {
+    let TITLE: string;
+    let GUIDANCE: string;
+    let REPEATER: string;
+}
+import { Markdown } from '../../../../form/form-editor/preview/markdown.js';
+import type { PagePreviewComponent } from '../../../../form/form-editor/macros/types.js';
+import type { PagePreviewBaseElements } from '../../../../form/form-editor/preview/types.js';
+import type { PageRenderer } from '../../../../form/form-editor/preview/types.js';
+export {};
+//# sourceMappingURL=page-controller-base.d.ts.map

package/dist/types/form/form-editor/preview/controller/page-controller-base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-controller-base.d.ts","sourceRoot":"","sources":["../../../../../../src/form/form-editor/preview/controller/page-controller-base.js"],"names":[],"mappings":"AA6BA;;GAEG;AACH;IASE;;OAEG;IACH,kBAFW,IAAI,GAAC,SAAS,EAMxB;IAfD;;;OAGG;IACH,cAEC;IAWD,sBAEC;IAED,uBAUC;IAED,0BAEC;IAED,yCAKC;IAED,2BAEC;CACF;AAED;;;GAGG;AACH;IACE,oBAAoC;IAmEpC;;OAEG;IACH,uBAFU,OAAO,cAAc,CAEO;IA4KtC;;;;OAIG;IACH,qDAFa,QAAQ,CAgBpB;IA5MD;;;OAGG;IACH,sBAHW,uBAAuB,YACvB,YAAY,EAMtB;IAhED;;;OAGG;IACH,yBAHU,MAAM,CAGsD;IACtE;;;OAGG;IACH,uBAFU,QAAQ,EAAE,CAEJ;IAChB;;;OAGG;IACH,sBAHU,OAAO,CAGA;IACjB;;;OAGG;IACH,kBAFU,MAAM,CAEL;IAMX;;;OAGG;IACH,wBAHW,SAAS,GAAG,cAAc,CAGb;IACxB;;;OAGG;IACH,yBAHU,MAAM,CAGE;IAClB;;;OAGG;IACH,yBAHW,MAAM,CAGC;IAClB;;;OAGG;IACH,0BAHU,QAAQ,CAGkD;IACpE;;;OAGG;IACH,8BAHU,QAAQ,CAGsD;IACxE;;;OAGG;IACH,uBAFU,OAAO,CAEE;IAiBnB;;;OAGG;IACH,oCAHa,QAAQ,EAAE,CAWtB;IAED;;;OAGG;IACH,qCAHa,QAAQ,EAAE,CAKtB;IAED;;OAEG;IACH,kBAFa,oBAAoB,EAAE,CAclC;IAED;;;OAGG;IACH,8BAHa,MAAM,CAKlB;IAED,uBAOa,MAAM,EAHlB;IAED;;OAEG;IACH,oBAFa,MAAM,CAIlB;IAED;;;MAKC;IAED;;OAEG;IACH,yBAFW,OAAO,EAKjB;IAED,iBAPW,OAAO,CASjB;IAED;;OAEG;IACH,iBAFa;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAO7C;IAED,oBAGC;IAED,sBAGC;IAED,0BAEC;IAED,eAEC;IAED;;;OAGG;IACH,uBAHa,MAAM,CAQlB;IASD;;OAEG;IACH,iBAFW,MAAM,EAKhB;IAbD;;OAEG;IACH,aAFa,MAAM,CAIlB;IAUD,uBAEC;IAED;;OAEG;IACH,oBAFa;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,GAAG,SAAS,CAUvD;IAED;;;OAGG;IACH,kCAHa,MAAM,GAAC,SAAS,CAK5B;IAED;;OAEG;IACH,0BAFW,MAAM,GAAG,SAAS,EAK5B;IAED,wBAPW,MAAM,GAAG,SAAS,CAS5B;IAuBD,0BAGC;IAED;;OAEG;IACH,iCAFW,cAAc,QAKxB;IAED,uBAKC;IAED;;;;OAIG;IACH,gCAJW,MAAM,GAEJ,MAAM,CAIlB;;CACF;0CAGoH,yCAAyC;0BAGrH,qCAAqC;2CAEd,wCAAwC;8BAJ3E,4CAA4C;;;;sBAzW/D,MAAM;;;;;;yBAlBS,4CAA4C;0CA+XL,wCAAwC;6CALa,yCAAyC;kCAAzC,yCAAyC"}

package/dist/types/form/form-editor/preview/controller/page-controller.d.ts

@@ -1,37 +1,4 @@
-/**
- * @implements {PageOverviewElements}
- */
-export class PagePreviewElements implements PageOverviewElements {
-    /**
-     * @param {Page} page
-     */
-    constructor(page: Page);
-    /**
-     * @type {Page}
-     * @private
-     */
-    private _page;
-    get heading(): string;
-    get guidance(): string;
-    get addHeading(): boolean;
-    get repeatQuestion(): string | undefined;
-    get hasRepeater(): boolean;
-}
-/**
- * @implements {PagePreviewPanelMacro}
- */
-export class PreviewPageController implements PagePreviewPanelMacro {
-    static PATH: string;
-    /**
-     * @type {typeof HighlightClass}
-     */
-    static HighlightClass: typeof HighlightClass;
-    /**
-     * Creates a dummy component for when guidance is highlighted
-     * but no guidance text exists
-     * @returns {Markdown}
-     */
-    static createGuidanceComponent(): Markdown;
+export class PreviewPageController extends PreviewPageControllerBase {
     /**
      * Helper method to return the guidance or a new one
      * @param { Markdown | Question | undefined } guidanceComponent
@@ -46,56 +13,6 @@ export class PreviewPageController implements PagePreviewPanelMacro {
      * @param {PageRenderer} renderer
      */
     constructor(components: ComponentDef[], elements: PageOverviewElements, definition: FormDefinition, renderer: PageRenderer);
-    /**
-     * @type {string}
-     * @protected
-     */
-    protected _pageTemplate: string;
-    /**
-     * @protected
-     * @type {Question[]}
-     */
-    protected _components: Question[];
-    /**
-     * @type { undefined | HighlightClass }
-     * @protected
-     */
-    protected _highlighted: undefined | HighlightClass;
-    /**
-     * @type {string}
-     * @private
-     */
-    private _guidanceText;
-    /**
-     * @type { string }
-     * @protected
-     */
-    protected _sectionTitle: string;
-    /**
-     * @type {Markdown}
-     * @private
-     */
-    private _emptyGuidance;
-    /**
-     *
-     * @type {Markdown}
-     * @protected
-     */
-    protected _guidanceComponent: Markdown;
-    /**
-     * @type {boolean}
-     * @private
-     */
-    private _showTitle;
-    /**
-     * @returns {Markdown[]}
-     * @private
-     */
-    private get _guidanceComponents();
-    /**
-     * @returns {PagePreviewComponent[]}
-     */
-    get components(): PagePreviewComponent[];
     /**
      * @returns {boolean}
      */
@@ -105,87 +22,23 @@ export class PreviewPageController implements PagePreviewPanelMacro {
      * @returns {QuestionBaseModel}
      */
     _overrideComponentHeading(component: PreviewComponent): QuestionBaseModel;
-    set guidanceText(text: string);
-    get guidanceText(): string;
-    /**
-     *
-     * @param {boolean} showTitle
-     */
-    set showTitle(showTitle: boolean);
-    get showTitle(): boolean;
-    get guidance(): {
-        text: string;
-        classes: string;
-    };
-    /**
-     * @returns {{ text: string, classes: string }}
-     */
-    get pageTitle(): {
-        text: string;
-        classes: string;
-    };
-    render(): void;
     /**
      * @returns {boolean}
      */
     get titleAndFirstTitleSame(): boolean;
-    /**
-     * @param {string} value
-     */
-    set title(value: string);
-    /**
-     * @returns {string}
-     */
-    get title(): string;
-    highlightTitle(): void;
-    setRepeater(): void;
-    unsetRepeater(): void;
-    get isRepeater(): boolean;
-    /**
-     * @returns {{classes: string, text: string} | undefined}
-     */
-    get sectionTitle(): {
-        classes: string;
-        text: string;
-    } | undefined;
     get repeaterText(): string | undefined;
-    /**
-     * @param {string | undefined} val
-     */
-    set sectionTitleText(val: string | undefined);
-    get sectionTitleText(): string | undefined;
     get repeaterButton(): {
         classes: string;
         text: string;
     } | undefined;
     get repeaterButtonText(): string | undefined;
-    highlightGuidance(): void;
-    /**
-     * @param {HighlightClass} highlightSection
-     */
-    setHighLighted(highlightSection: HighlightClass): void;
-    clearHighlight(): void;
     #private;
 }
-import type { PageOverviewElements } from '../../../../form/form-editor/preview/types.js';
-import type { Page } from '../../../../form/form-definition/types.js';
-import type { PagePreviewPanelMacro } from '../../../../form/form-editor/macros/types.js';
-import type { Question } from '../../../../form/form-editor/preview/question.js';
-/**
- * Enum for Highlight classes
- */
-type HighlightClass = string;
-declare namespace HighlightClass {
-    let TITLE: string;
-    let GUIDANCE: string;
-    let REPEATER: string;
-}
-import { Markdown } from '../../../../form/form-editor/preview/markdown.js';
-import type { PagePreviewComponent } from '../../../../form/form-editor/macros/types.js';
+import { PreviewPageControllerBase } from '../../../../form/form-editor/preview/controller/page-controller-base.js';
 import type { PreviewComponent } from '../../../../form/form-editor/preview/preview.js';
 import type { QuestionBaseModel } from '../../../../form/form-editor/preview/types.js';
 import type { ComponentDef } from '../../../../components/types.js';
+import type { PageOverviewElements } from '../../../../form/form-editor/preview/types.js';
 import type { FormDefinition } from '../../../../form/form-definition/types.js';
 import type { PageRenderer } from '../../../../form/form-editor/preview/types.js';
-export {};
 //# sourceMappingURL=page-controller.d.ts.map

package/dist/types/form/form-editor/preview/controller/page-controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"page-controller.d.ts","sourceRoot":"","sources":["../../../../../../src/form/form-editor/preview/controller/page-controller.js"],"names":[],"mappings":"AAqBA;;GAEG;AACH;IAOE;;OAEG;IACH,kBAFW,IAAI,EAId;IAXD;;;OAGG;IACH,cAAK;IASL,sBAEC;IAED,uBAUC;IAED,0BAEC;IAED,yCAKC;IAED,2BAEC;CACF;AAaD;;GAEG;AACH;IACE,oBAAoC;IAkFpC;;OAEG;IACH,uBAFU,OAAO,cAAc,CAEO;IAoQtC;;;;OAIG;IACH,kCAFa,QAAQ,CAepB;IAED;;;;;OAKG;IACH,4CAKC;IAhUD;;;;;OAKG;IACH,wBALW,YAAY,EAAE,YACd,oBAAoB,cACpB,cAAc,YACd,YAAY,EAoBtB;IA/ED;;;OAGG;IACH,yBAHU,MAAM,CAGkD;IAClE;;;OAGG;IACH,uBAFU,QAAQ,EAAE,CAEJ;IAUhB;;;OAGG;IACH,wBAHW,SAAS,GAAG,cAAc,CAGb;IACxB;;;OAGG;IACH,sBAAkB;IAClB;;;OAGG;IACH,yBAHW,MAAM,CAGC;IAClB;;;OAGG;IACH,uBAAgE;IAChE;;;;OAIG;IACH,8BAHU,QAAQ,CAGA;IAClB;;;OAGG;IACH,mBAAiB;IAgDjB;;;OAGG;IACH,kCAQC;IAED;;OAEG;IACH,kBAFa,oBAAoB,EAAE,CAclC;IAED;;OAEG;IACH,sBAFa,OAAO,CAgBnB;IAED;;;OAGG;IACH,qCAHW,gBAAgB,GACd,iBAAiB,CAgC7B;IAED,+BAIC;IAED,2BAKC;IAED;;;OAGG;IACH,yBAFW,OAAO,EAKjB;IAED,iBAPW,OAAO,CASjB;IAED;;;MAKC;IAED;;OAEG;IACH,iBAFa;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAO7C;IAED,eAEC;IAED;;OAEG;IACH,8BAFa,OAAO,CASnB;IAeD;;OAEG;IACH,iBAFW,MAAM,EAKhB;IAnBD;;OAEG;IACH,aAFa,MAAM,CAUlB;IAUD,uBAEC;IAED,oBAGC;IAED,sBAGC;IAED,0BAEC;IAED;;OAEG;IACH,oBAFa;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,GAAG,SAAS,CAUvD;IAED,uCAQC;IAED;;OAEG;IACH,0BAFW,MAAM,GAAG,SAAS,EAK5B;IAED,wBAPW,MAAM,GAAG,SAAS,CAY5B;IAED;;;kBAQC;IAED,6CAaC;IAmCD,0BAGC;IAED;;OAEG;IACH,iCAFW,cAAc,QAKxB;IAED,uBAKC;;CASF;0CAG2F,yCAAyC;0BAG5F,qCAAqC;2CAEd,wCAAwC;8BAJ3E,4CAA4C;;;;sBAra/D,MAAM;;;;;;yBArES,4CAA4C;0CA8eL,wCAAwC;sCAHnE,2CAA2C;uCAFY,yCAAyC;kCAIjF,2BAA2B;oCADtC,qCAAqC;kCAHc,yCAAyC"}
+{"version":3,"file":"page-controller.d.ts","sourceRoot":"","sources":["../../../../../../src/form/form-editor/preview/controller/page-controller.js"],"names":[],"mappings":"AAiBA;IAyME;;;;;OAKG;IACH,4CAKC;IA5MD;;;;;OAKG;IACH,wBALW,YAAY,EAAE,YACd,oBAAoB,cACpB,cAAc,YACd,YAAY,EAiBtB;IAmCD;;OAEG;IACH,sBAFa,OAAO,CAgBnB;IAED;;;OAGG;IACH,qCAHW,gBAAgB,GACd,iBAAiB,CAgC7B;IAED;;OAEG;IACH,8BAFa,OAAO,CASnB;IAwBD,uCAQC;IAaD;;;kBAUC;IAED,6CAaC;;CAcF;0CAtOyC,mEAAmE;sCA2OxE,2CAA2C;uCAFY,yCAAyC;kCAIjF,2BAA2B;0CAJa,yCAAyC;oCAG5F,qCAAqC;kCAHc,yCAAyC"}

package/dist/types/form/form-editor/preview/index.d.ts

@@ -21,4 +21,6 @@ export * from "../../../form/form-editor/preview/long-answer.js";
 export * from "../../../form/form-editor/preview/uk-address.js";
 export * from "../../../form/form-editor/preview/yes-no.js";
 export * from "../../../form/form-editor/preview/controller/page-controller.js";
+export * from "../../../form/form-editor/preview/controller/guidance-page-controller.js";
+export * from "../../../form/form-editor/preview/controller/page-controller-base.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/types/form/form-editor/preview/types.d.ts

@@ -69,9 +69,11 @@ export type Renderer = QuestionRenderer | PageRenderer;
 export interface ListElements extends QuestionElements {
     afterInputsHTML: string;
 }
-export interface PageOverviewElements {
+export interface PagePreviewBaseElements {
     heading: string;
     guidance: string;
+}
+export interface PageOverviewElements extends PagePreviewBaseElements {
     addHeading: boolean;
     repeatQuestion: string | undefined;
     hasRepeater: boolean;

package/dist/types/form/form-editor/preview/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/form/form-editor/preview/types.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACvB,MAAM,wCAAwC,CAAA;AAC/C,OAAO,EAAE,KAAK,oBAAoB,EAAE,MAAM,gDAAgD,CAAA;AAC1F,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,8CAA8C,CAAA;AACrF,OAAO,EAAE,KAAK,oBAAoB,EAAE,MAAM,iDAAiD,CAAA;AAC3F,OAAO,EAAE,KAAK,oBAAoB,EAAE,MAAM,iDAAiD,CAAA;AAC3F,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,+CAA+C,CAAA;AACvF,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,gDAAgD,CAAA;AACzF,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,4CAA4C,CAAA;AAC1E,OAAO,EAAE,KAAK,qBAAqB,EAAE,MAAM,kDAAkD,CAAA;AAC7F,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,mDAAmD,CAAA;AAC/F,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,gDAAgD,CAAA;AACzF,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,8CAA8C,CAAA;AACrF,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAClE,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,wCAAwC,CAAA;AAC/E,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,OAAO,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,WAAW,EAAE,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACpC;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,gBAAgB,CAAA;CACzB;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,gBAAgB,GAAG,IAAI;IACvB,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,EAAE,KAAK,KAAK,IAAI;IAC5C,MAAM,mBAAmB;CAC1B,CAAA;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAA;IAC9B,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACnC,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAAA;CAC1C;AAED,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;CAC9B;AAED,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAC5D,mBAAmB,EAAE,MAAM,CAAA;CAC5B;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,gBAAgB,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,GAAG,IAAI,CAAA;CACrE;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,iBAAiB,CAAA;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,qBAAqB,CAAA;CAC9B;AAED,MAAM,MAAM,aAAa,GAAG,qBAAqB,GAAG,iBAAiB,CAAA;AAErE,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,gBAAgB,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,GAAG,MAAM,CAAA;CAC1E;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,gBAAgB,EAAE,MAAM,EAAE,iBAAiB,EAAE,iBAAiB,GAAG,IAAI,CAAA;CAC7E;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,qBAAqB,GAAG,IAAI,CAAA;CACvE;AAED,MAAM,MAAM,QAAQ,GAAG,gBAAgB,GAAG,YAAY,CAAA;AAEtD,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IACpD,eAAe,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,OAAO,CAAA;IACnB,cAAc,EAAE,MAAM,GAAG,SAAS,CAAA;IAClC,WAAW,EAAE,OAAO,CAAA;CACrB;AAED,MAAM,MAAM,eAAe,GACvB,iBAAiB,GACjB,oBAAoB,GACpB,oBAAoB,GACpB,kBAAkB,GAClB,mBAAmB,GACnB,QAAQ,GACR,qBAAqB,GACrB,sBAAsB,GACtB,mBAAmB,GACnB,iBAAiB,GACjB,oBAAoB,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/form/form-editor/preview/types.ts"],"names":[],"mappings":"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"}

package/dist/types/pages/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/pages/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAC7D,OAAO,EACL,KAAK,IAAI,EACT,KAAK,IAAI,EACT,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,UAAU,EAChB,MAAM,qCAAqC,CAAA;AAM5C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAGrD;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,SAAS,IAAI,EACnD,IAAI,CAAC,EAAE,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,GAaC,QAAQ,CAC7C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,IAAI,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,GACnB,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE;IAAE,UAAU,EAAE,YAAY,EAAE,CAAA;CAAE,CAAC,CAEvD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,GACnB,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE;IAAE,UAAU,EAAE,YAAY,EAAE,CAAA;CAAE,CAAC,CAIvD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,GACnB,IAAI,IAAI,YAAY,GAAG,cAAc,CAGvC;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,UAAU,CAEpE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,CAAC,EAAE,cAAc,GAAG,MAAM,GACnC,UAAU,IAAI,cAAc,CAE9B;AAED;;GAEG;AACH,wBAAgB,OAAO,CACrB,IAAI,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,GACnB,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,IAAI,EAAE,CAAA;CAAE,CAAC,CAezC;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,CAAC,EAAE,cAAc,GAAG,MAAM,8BAO1E;AAUD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAQxD;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,GAAG,OAAO,CAcvE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,UAYtC"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/pages/helpers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAC7D,OAAO,EACL,KAAK,IAAI,EACT,KAAK,IAAI,EACT,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,UAAU,EAChB,MAAM,qCAAqC,CAAA;AAK5C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAGrD;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,SAAS,IAAI,EACnD,IAAI,CAAC,EAAE,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,GAaC,QAAQ,CAC7C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,IAAI,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,GACnB,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE;IAAE,UAAU,EAAE,YAAY,EAAE,CAAA;CAAE,CAAC,CAEvD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,GACnB,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE;IAAE,UAAU,EAAE,YAAY,EAAE,CAAA;CAAE,CAAC,CAIvD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,GACnB,IAAI,IAAI,YAAY,GAAG,cAAc,CAGvC;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,UAAU,CAEpE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,CAAC,EAAE,cAAc,GAAG,MAAM,GACnC,UAAU,IAAI,cAAc,CAE9B;AAED;;GAEG;AACH,wBAAgB,OAAO,CACrB,IAAI,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,GACnB,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,IAAI,EAAE,CAAA;CAAE,CAAC,CAezC;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,CAAC,EAAE,cAAc,GAAG,MAAM,8BAO1E;AAUD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAQxD;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,GAAG,OAAO,CAcvE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,UAYtC"}

package/dist/types/utils/markdown.d.ts

@@ -6,5 +6,5 @@ export declare const marked: Marked;
 /**
  * Convert markdown to HTML, escaping any HTML tags first
  */
-export declare function markdownToHtml(markdown?: string | null): string;
+export declare function markdownToHtml(markdown: string | null | undefined, baseUrl?: string): string;
 //# sourceMappingURL=markdown.d.ts.map

package/dist/types/utils/markdown.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../../src/utils/markdown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE/B;;GAEG;AACH,eAAO,MAAM,MAAM,QAGjB,CAAA;AAEF;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,UAatD"}
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../../src/utils/markdown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAyB,MAAM,QAAQ,CAAA;AAEtD;;GAEG;AACH,eAAO,MAAM,MAAM,QAGjB,CAAA;AAoBF;;GAEG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACnC,OAAO,CAAC,EAAE,MAAM,UAmBjB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@defra/forms-model",
-  "version": "3.0.502",
+  "version": "3.0.504",
   "description": "A hapi plugin providing the model for Defra forms",
   "homepage": "https://github.com/DEFRA/forms-designer/tree/main/model#readme",
   "types": "dist/types/index.d.ts",

package/src/__stubs__/pages.ts

@@ -1,4 +1,7 @@
-import { buildFileUploadComponent } from '~/src/__stubs__/components.js'
+import {
+  buildFileUploadComponent,
+  buildMarkdownComponent
+} from '~/src/__stubs__/components.js'
 import { ComponentType } from '~/src/components/enums.js'
 import {
   type PageFileUpload,
@@ -26,6 +29,22 @@ export function buildQuestionPage(
   }
 }
 
+export const GUIDANCE_PAGE_CONTENT = 'Lorem ipsum dolar sit amet'
+export function buildGuidancePage(partialPage: Partial<PageQuestion>) {
+  return {
+    id: 'a3fc003b-d380-43e8-9b87-9ca48ac8447f',
+    title: 'Guidance page',
+    path: '/guidance-page',
+    next: [],
+    components: [
+      buildMarkdownComponent({
+        content: 'Lorem ipsum dolar sit amet'
+      })
+    ],
+    ...partialPage
+  }
+}
+
 /**
  * Stub builder for a Summary page
  * @param {Partial<PageSummary>} [partialSummaryPage]

package/src/form/form-editor/preview/controller/guidance-page-controller.js

@@ -0,0 +1,64 @@
+import { PreviewPageControllerBase } from '~/src/form/form-editor/preview/controller/page-controller-base.js'
+
+const FALLBACK_GUIDANCE_TEXT = 'Guidance text'
+
+export class GuidancePageController extends PreviewPageControllerBase {
+  /**
+   * @type {Markdown}
+   * @protected
+   */
+  _unhighlightedEmptyGuidance =
+    PreviewPageControllerBase.createGuidanceComponent(false)
+
+  /**
+   * @type {Markdown}
+   * @protected
+   */
+  _guidanceComponent = PreviewPageControllerBase.createGuidanceComponent(false)
+
+  /**
+   * @param {PagePreviewBaseElements} elements
+   * @param {PageRenderer} renderer
+   */
+  constructor(elements, renderer) {
+    super(elements, renderer)
+    if (elements.guidance.length) {
+      this._guidanceComponent.content = elements.guidance
+    }
+  }
+
+  /**
+   * @returns {Markdown[]}
+   * @protected
+   */
+  _getGuidanceComponents() {
+    if (this._guidanceText.length) {
+      return [this._guidanceComponent]
+    }
+
+    if (
+      this._isHighlighted(PreviewPageControllerBase.HighlightClass.GUIDANCE)
+    ) {
+      return [this._emptyGuidance]
+    }
+
+    return [this._unhighlightedEmptyGuidance]
+  }
+
+  /**
+   * @returns {string}
+   * @protected
+   */
+  _getGuidanceText() {
+    const guidanceText = super._getGuidanceText()
+    if (!guidanceText.length) {
+      return FALLBACK_GUIDANCE_TEXT
+    }
+    return super._getGuidanceText()
+  }
+}
+
+/**
+ * @import { Markdown } from '~/src/form/form-editor/preview/markdown.js'
+ * @import { PageRenderer, PagePreviewBaseElements } from '~/src/form/form-editor/preview/types.js'
+ */