@defra/forms-engine-plugin 4.0.5 → 4.0.7

package/.server/client/stylesheets/_location-input.scss

@@ -0,0 +1,60 @@
+@use "govuk-frontend" as *;
+
+.app-location-input {
+  @include govuk-clearfix;
+  font-size: 0; // removes whitespace caused by inline-block
+  margin-bottom: govuk-spacing(6);
+
+  &:has(.govuk-input--error) {
+    border-left: $govuk-border-width-form-group-error solid $govuk-error-colour;
+    padding-left: govuk-spacing(3);
+    margin-top: 0;
+  }
+}
+
+.govuk-hint:has(+ .app-location-input .govuk-input--error) {
+  border-left: $govuk-border-width-form-group-error solid $govuk-error-colour;
+  padding-left: govuk-spacing(3);
+  margin-bottom: 0;
+}
+
+.govuk-fieldset:has(.app-location-input .govuk-input--error) {
+  .govuk-fieldset__legend {
+    border-left: $govuk-border-width-form-group-error solid $govuk-error-colour;
+    padding-left: govuk-spacing(3);
+    margin-bottom: 0;
+  }
+
+  .govuk-fieldset__legend + .govuk-hint {
+    margin-top: 0;
+  }
+}
+
+.app-location-input__item {
+  display: inline-block;
+  margin-right: govuk-spacing(4);
+  margin-bottom: govuk-spacing(4);
+
+  &:last-child {
+    margin-right: 0;
+  }
+
+  @include govuk-media-query($from: tablet) {
+    margin-bottom: 0;
+  }
+
+  .govuk-form-group {
+    margin-bottom: 0;
+    display: inline-block;
+    width: auto;
+  }
+
+  .govuk-label {
+    display: block;
+  }
+
+  .govuk-input {
+    margin-bottom: 0;
+    width: auto;
+  }
+}

package/.server/client/stylesheets/application.scss

@@ -2,6 +2,7 @@
 @use "shared";
 @use "code";
 @use "tag-env";
+@use "location-input";
 
 //  An example of some user-supplied styling
 //  Not great practice but it illustrates the point
@@ -12,9 +13,3 @@
 .govuk-header__container {
   border-bottom: 10px solid #003d16;
 }
-
-@media print {
-  .govuk-link[href]::after {
-    content: none;
-  }
-}

package/.server/client/stylesheets/shared.scss

@@ -2,6 +2,7 @@
 @use "pkg:accessible-autocomplete";
 @use "prose";
 @use "summary-list";
+@use "location-input";
 
 // Use default GDS Transport font for autocomplete
 .autocomplete__hint,
@@ -24,3 +25,10 @@
   background-color: transparent;
   @include govuk-font($size: 19);
 }
+
+// Hide urls for hyperlinks when in print mode
+@media print {
+  .govuk-link[href]::after {
+    content: none;
+  }
+}

package/.server/server/forms/register-as-a-unicorn-breeder.yaml

@@ -163,6 +163,34 @@ pages:
     next:
       - path: '/how-many-members-of-staff-will-look-after-the-unicorns'
     components:
+      - name: dfGYuk
+        options: {}
+        schema: {}
+        type: EastingNorthingField
+        title: Easting and northing
+        hint:
+          This is an Easting and Northing component
+      - name: seTThb
+        options: {}
+        schema: {}
+        type: LatLongField
+        title: Latitute and longitude
+        hint:
+          This is an Latitute and Longitude component
+      - name: bhjloS
+        options: {}
+        schema: {}
+        type: NationalGridFieldNumberField
+        title: National grid field number
+        hint:
+          This is an National Grid Field Number component
+      - name: dfQQws
+        options: {}
+        schema: {}
+        type: OsGridRefField
+        title: Ordnance survey grid reference
+        hint:
+          This is an Ordnance survey Grid Reference component
       - name: bClCvo
         options: {}
         schema: {}

package/.server/server/plugins/engine/components/ComponentBase.d.ts

@@ -13,7 +13,7 @@ export declare class ComponentBase {
     name: ComponentDef['name'];
     title: ComponentDef['title'];
     schema?: Extract<ComponentDef, {
-        schema: object;
+        schema?: object;
     }>['schema'];
     options?: Extract<ComponentDef, {
         options: object;

package/.server/server/plugins/engine/components/ComponentBase.js.map

@@ -1 +1 @@
-{"version":3,"file":"ComponentBase.js","names":["isConditionalRevealType","joi","ComponentBase","page","parent","collection","type","name","title","schema","options","isFormComponent","model","formSchema","string","stateSchema","constructor","def","props","viewModel","attributes","autocomplete","classes","condition"],"sources":["../../../../../src/server/plugins/engine/components/ComponentBase.ts"],"sourcesContent":["import { isConditionalRevealType, type ComponentDef } from '@defra/forms-model'\nimport joi, {\n  type ArraySchema,\n  type BooleanSchema,\n  type DateSchema,\n  type NumberSchema,\n  type ObjectSchema,\n  type StringSchema\n} from 'joi'\n\nimport { type ComponentCollection } from '~/src/server/plugins/engine/components/ComponentCollection.js'\nimport { type Component } from '~/src/server/plugins/engine/components/helpers/components.js'\nimport { type ViewModel } from '~/src/server/plugins/engine/components/types.js'\nimport { type FormModel } from '~/src/server/plugins/engine/models/index.js'\nimport { type PageControllerClass } from '~/src/server/plugins/engine/pageControllers/helpers/pages.js'\n\nexport class ComponentBase {\n  page?: PageControllerClass\n  parent: Component | undefined\n  collection: ComponentCollection | undefined\n\n  type: ComponentDef['type']\n  name: ComponentDef['name']\n  title: ComponentDef['title']\n  schema?: Extract<ComponentDef, { schema: object }>['schema']\n  options?: Extract<ComponentDef, { options: object }>['options']\n\n  isFormComponent = false\n  model: FormModel\n\n  /** joi schemas based on a component defined in the form JSON. This validates a user's answer and is generated from {@link ComponentDef} */\n  formSchema: ComponentSchema = joi.string()\n  stateSchema: ComponentSchema = joi.string()\n\n  constructor(\n    def: ComponentDef,\n    props: {\n      page?: PageControllerClass\n      parent?: Component\n      model: FormModel\n    }\n  ) {\n    this.type = def.type\n    this.name = def.name\n    this.title = def.title\n\n    if ('schema' in def) {\n      this.schema = def.schema\n    }\n\n    if ('options' in def) {\n      this.options = def.options\n    }\n\n    this.page = props.page\n    this.parent = props.parent\n    this.model = props.model\n  }\n\n  get viewModel() {\n    const { options, type } = this\n\n    const viewModel: ViewModel = {\n      attributes: {}\n    }\n\n    if (!options) {\n      return viewModel\n    }\n\n    if ('autocomplete' in options) {\n      viewModel.attributes.autocomplete = options.autocomplete\n    }\n\n    if ('classes' in options) {\n      viewModel.classes = options.classes\n    }\n\n    if ('condition' in options && isConditionalRevealType(type)) {\n      viewModel.condition = options.condition\n    }\n\n    return viewModel\n  }\n}\n\nexport type ComponentSchema =\n  | ArraySchema<string>\n  | ArraySchema<number>\n  | ArraySchema<boolean>\n  | ArraySchema<object>\n  | BooleanSchema<string>\n  | DateSchema\n  | NumberSchema<string>\n  | NumberSchema\n  | ObjectSchema\n  | StringSchema\n"],"mappings":"AAAA,SAASA,uBAAuB,QAA2B,oBAAoB;AAC/E,OAAOC,GAAG,MAOH,KAAK;AAQZ,OAAO,MAAMC,aAAa,CAAC;EACzBC,IAAI;EACJC,MAAM;EACNC,UAAU;EAEVC,IAAI;EACJC,IAAI;EACJC,KAAK;EACLC,MAAM;EACNC,OAAO;EAEPC,eAAe,GAAG,KAAK;EACvBC,KAAK;;EAEL;EACAC,UAAU,GAAoBZ,GAAG,CAACa,MAAM,CAAC,CAAC;EAC1CC,WAAW,GAAoBd,GAAG,CAACa,MAAM,CAAC,CAAC;EAE3CE,WAAWA,CACTC,GAAiB,EACjBC,KAIC,EACD;IACA,IAAI,CAACZ,IAAI,GAAGW,GAAG,CAACX,IAAI;IACpB,IAAI,CAACC,IAAI,GAAGU,GAAG,CAACV,IAAI;IACpB,IAAI,CAACC,KAAK,GAAGS,GAAG,CAACT,KAAK;IAEtB,IAAI,QAAQ,IAAIS,GAAG,EAAE;MACnB,IAAI,CAACR,MAAM,GAAGQ,GAAG,CAACR,MAAM;IAC1B;IAEA,IAAI,SAAS,IAAIQ,GAAG,EAAE;MACpB,IAAI,CAACP,OAAO,GAAGO,GAAG,CAACP,OAAO;IAC5B;IAEA,IAAI,CAACP,IAAI,GAAGe,KAAK,CAACf,IAAI;IACtB,IAAI,CAACC,MAAM,GAAGc,KAAK,CAACd,MAAM;IAC1B,IAAI,CAACQ,KAAK,GAAGM,KAAK,CAACN,KAAK;EAC1B;EAEA,IAAIO,SAASA,CAAA,EAAG;IACd,MAAM;MAAET,OAAO;MAAEJ;IAAK,CAAC,GAAG,IAAI;IAE9B,MAAMa,SAAoB,GAAG;MAC3BC,UAAU,EAAE,CAAC;IACf,CAAC;IAED,IAAI,CAACV,OAAO,EAAE;MACZ,OAAOS,SAAS;IAClB;IAEA,IAAI,cAAc,IAAIT,OAAO,EAAE;MAC7BS,SAAS,CAACC,UAAU,CAACC,YAAY,GAAGX,OAAO,CAACW,YAAY;IAC1D;IAEA,IAAI,SAAS,IAAIX,OAAO,EAAE;MACxBS,SAAS,CAACG,OAAO,GAAGZ,OAAO,CAACY,OAAO;IACrC;IAEA,IAAI,WAAW,IAAIZ,OAAO,IAAIV,uBAAuB,CAACM,IAAI,CAAC,EAAE;MAC3Da,SAAS,CAACI,SAAS,GAAGb,OAAO,CAACa,SAAS;IACzC;IAEA,OAAOJ,SAAS;EAClB;AACF","ignoreList":[]}
+{"version":3,"file":"ComponentBase.js","names":["isConditionalRevealType","joi","ComponentBase","page","parent","collection","type","name","title","schema","options","isFormComponent","model","formSchema","string","stateSchema","constructor","def","props","viewModel","attributes","autocomplete","classes","condition"],"sources":["../../../../../src/server/plugins/engine/components/ComponentBase.ts"],"sourcesContent":["import { isConditionalRevealType, type ComponentDef } from '@defra/forms-model'\nimport joi, {\n  type ArraySchema,\n  type BooleanSchema,\n  type DateSchema,\n  type NumberSchema,\n  type ObjectSchema,\n  type StringSchema\n} from 'joi'\n\nimport { type ComponentCollection } from '~/src/server/plugins/engine/components/ComponentCollection.js'\nimport { type Component } from '~/src/server/plugins/engine/components/helpers/components.js'\nimport { type ViewModel } from '~/src/server/plugins/engine/components/types.js'\nimport { type FormModel } from '~/src/server/plugins/engine/models/index.js'\nimport { type PageControllerClass } from '~/src/server/plugins/engine/pageControllers/helpers/pages.js'\n\nexport class ComponentBase {\n  page?: PageControllerClass\n  parent: Component | undefined\n  collection: ComponentCollection | undefined\n\n  type: ComponentDef['type']\n  name: ComponentDef['name']\n  title: ComponentDef['title']\n  schema?: Extract<ComponentDef, { schema?: object }>['schema']\n  options?: Extract<ComponentDef, { options: object }>['options']\n\n  isFormComponent = false\n  model: FormModel\n\n  /** joi schemas based on a component defined in the form JSON. This validates a user's answer and is generated from {@link ComponentDef} */\n  formSchema: ComponentSchema = joi.string()\n  stateSchema: ComponentSchema = joi.string()\n\n  constructor(\n    def: ComponentDef,\n    props: {\n      page?: PageControllerClass\n      parent?: Component\n      model: FormModel\n    }\n  ) {\n    this.type = def.type\n    this.name = def.name\n    this.title = def.title\n\n    if ('schema' in def) {\n      this.schema = def.schema\n    }\n\n    if ('options' in def) {\n      this.options = def.options\n    }\n\n    this.page = props.page\n    this.parent = props.parent\n    this.model = props.model\n  }\n\n  get viewModel() {\n    const { options, type } = this\n\n    const viewModel: ViewModel = {\n      attributes: {}\n    }\n\n    if (!options) {\n      return viewModel\n    }\n\n    if ('autocomplete' in options) {\n      viewModel.attributes.autocomplete = options.autocomplete\n    }\n\n    if ('classes' in options) {\n      viewModel.classes = options.classes\n    }\n\n    if ('condition' in options && isConditionalRevealType(type)) {\n      viewModel.condition = options.condition\n    }\n\n    return viewModel\n  }\n}\n\nexport type ComponentSchema =\n  | ArraySchema<string>\n  | ArraySchema<number>\n  | ArraySchema<boolean>\n  | ArraySchema<object>\n  | BooleanSchema<string>\n  | DateSchema\n  | NumberSchema<string>\n  | NumberSchema\n  | ObjectSchema\n  | StringSchema\n"],"mappings":"AAAA,SAASA,uBAAuB,QAA2B,oBAAoB;AAC/E,OAAOC,GAAG,MAOH,KAAK;AAQZ,OAAO,MAAMC,aAAa,CAAC;EACzBC,IAAI;EACJC,MAAM;EACNC,UAAU;EAEVC,IAAI;EACJC,IAAI;EACJC,KAAK;EACLC,MAAM;EACNC,OAAO;EAEPC,eAAe,GAAG,KAAK;EACvBC,KAAK;;EAEL;EACAC,UAAU,GAAoBZ,GAAG,CAACa,MAAM,CAAC,CAAC;EAC1CC,WAAW,GAAoBd,GAAG,CAACa,MAAM,CAAC,CAAC;EAE3CE,WAAWA,CACTC,GAAiB,EACjBC,KAIC,EACD;IACA,IAAI,CAACZ,IAAI,GAAGW,GAAG,CAACX,IAAI;IACpB,IAAI,CAACC,IAAI,GAAGU,GAAG,CAACV,IAAI;IACpB,IAAI,CAACC,KAAK,GAAGS,GAAG,CAACT,KAAK;IAEtB,IAAI,QAAQ,IAAIS,GAAG,EAAE;MACnB,IAAI,CAACR,MAAM,GAAGQ,GAAG,CAACR,MAAM;IAC1B;IAEA,IAAI,SAAS,IAAIQ,GAAG,EAAE;MACpB,IAAI,CAACP,OAAO,GAAGO,GAAG,CAACP,OAAO;IAC5B;IAEA,IAAI,CAACP,IAAI,GAAGe,KAAK,CAACf,IAAI;IACtB,IAAI,CAACC,MAAM,GAAGc,KAAK,CAACd,MAAM;IAC1B,IAAI,CAACQ,KAAK,GAAGM,KAAK,CAACN,KAAK;EAC1B;EAEA,IAAIO,SAASA,CAAA,EAAG;IACd,MAAM;MAAET,OAAO;MAAEJ;IAAK,CAAC,GAAG,IAAI;IAE9B,MAAMa,SAAoB,GAAG;MAC3BC,UAAU,EAAE,CAAC;IACf,CAAC;IAED,IAAI,CAACV,OAAO,EAAE;MACZ,OAAOS,SAAS;IAClB;IAEA,IAAI,cAAc,IAAIT,OAAO,EAAE;MAC7BS,SAAS,CAACC,UAAU,CAACC,YAAY,GAAGX,OAAO,CAACW,YAAY;IAC1D;IAEA,IAAI,SAAS,IAAIX,OAAO,EAAE;MACxBS,SAAS,CAACG,OAAO,GAAGZ,OAAO,CAACY,OAAO;IACrC;IAEA,IAAI,WAAW,IAAIZ,OAAO,IAAIV,uBAAuB,CAACM,IAAI,CAAC,EAAE;MAC3Da,SAAS,CAACI,SAAS,GAAGb,OAAO,CAACa,SAAS;IACzC;IAEA,OAAOJ,SAAS;EAClB;AACF","ignoreList":[]}

package/.server/server/plugins/engine/components/EastingNorthingField.d.ts

@@ -0,0 +1,121 @@
+import { type EastingNorthingFieldComponent } from '@defra/forms-model';
+import { type ObjectSchema } from 'joi';
+import { ComponentCollection } from '~/src/server/plugins/engine/components/ComponentCollection.js';
+import { FormComponent } from '~/src/server/plugins/engine/components/FormComponent.js';
+import { type EastingNorthingState } from '~/src/server/plugins/engine/components/types.js';
+import { type ErrorMessageTemplateList, type FormPayload, type FormState, type FormStateValue, type FormSubmissionError, type FormSubmissionState } from '~/src/server/plugins/engine/types.js';
+export declare class EastingNorthingField extends FormComponent {
+    options: EastingNorthingFieldComponent['options'];
+    formSchema: ObjectSchema<FormPayload>;
+    stateSchema: ObjectSchema<FormState>;
+    collection: ComponentCollection;
+    constructor(def: EastingNorthingFieldComponent, props: ConstructorParameters<typeof FormComponent>[1]);
+    getFormValueFromState(state: FormSubmissionState): EastingNorthingState | undefined;
+    getDisplayStringFromFormValue(value: EastingNorthingState | undefined): string;
+    getDisplayStringFromState(state: FormSubmissionState): string;
+    getContextValueFromFormValue(value: EastingNorthingState | undefined): string | null;
+    getContextValueFromState(state: FormSubmissionState): string | null;
+    getViewModel(payload: FormPayload, errors?: FormSubmissionError[]): {
+        fieldset: {
+            attributes?: string | Record<string, string>;
+            legend?: import("~/src/server/plugins/engine/components/types.js").Label;
+        };
+        items: import("~/src/server/plugins/engine/components/types.js").DateInputItem[];
+        label: import("~/src/server/plugins/engine/components/types.js").Label;
+        type?: string;
+        id: string;
+        name: string;
+        value: import("~/src/server/plugins/engine/types.js").FormValue;
+        hint?: {
+            id?: string;
+            text: string;
+        };
+        prefix?: import("~/src/server/plugins/engine/components/types.js").ComponentText;
+        suffix?: import("~/src/server/plugins/engine/components/types.js").ComponentText;
+        classes?: string;
+        condition?: string;
+        errors?: FormSubmissionError[];
+        errorMessage?: {
+            text: string;
+        };
+        summaryHtml?: string;
+        html?: string;
+        attributes: {
+            autocomplete?: string;
+            maxlength?: number;
+            multiple?: string;
+            accept?: string;
+            inputmode?: string;
+        };
+        content?: import("~/src/server/plugins/engine/components/types.js").Content | import("~/src/server/plugins/engine/components/types.js").Content[] | string;
+        maxlength?: number;
+        maxwords?: number;
+        rows?: number;
+        formGroup?: {
+            classes?: string;
+            attributes?: string | Record<string, string>;
+        };
+        components?: import("~/src/server/plugins/engine/components/types.js").ComponentViewModel[];
+        upload?: {
+            count: number;
+            summaryList: import("~/src/server/plugins/engine/types.js").SummaryList;
+        };
+    } | {
+        instructionText: string;
+        fieldset: {
+            attributes?: string | Record<string, string>;
+            legend?: import("~/src/server/plugins/engine/components/types.js").Label;
+        };
+        items: import("~/src/server/plugins/engine/components/types.js").DateInputItem[];
+        label: import("~/src/server/plugins/engine/components/types.js").Label;
+        type?: string;
+        id: string;
+        name: string;
+        value: import("~/src/server/plugins/engine/types.js").FormValue;
+        hint?: {
+            id?: string;
+            text: string;
+        };
+        prefix?: import("~/src/server/plugins/engine/components/types.js").ComponentText;
+        suffix?: import("~/src/server/plugins/engine/components/types.js").ComponentText;
+        classes?: string;
+        condition?: string;
+        errors?: FormSubmissionError[];
+        errorMessage?: {
+            text: string;
+        };
+        summaryHtml?: string;
+        html?: string;
+        attributes: {
+            autocomplete?: string;
+            maxlength?: number;
+            multiple?: string;
+            accept?: string;
+            inputmode?: string;
+        };
+        content?: import("~/src/server/plugins/engine/components/types.js").Content | import("~/src/server/plugins/engine/components/types.js").Content[] | string;
+        maxlength?: number;
+        maxwords?: number;
+        rows?: number;
+        formGroup?: {
+            classes?: string;
+            attributes?: string | Record<string, string>;
+        };
+        components?: import("~/src/server/plugins/engine/components/types.js").ComponentViewModel[];
+        upload?: {
+            count: number;
+            summaryList: import("~/src/server/plugins/engine/types.js").SummaryList;
+        };
+    };
+    isState(value?: FormStateValue | FormState): value is EastingNorthingState;
+    /**
+     * For error preview page that shows all possible errors on a component
+     */
+    getAllPossibleErrors(): ErrorMessageTemplateList;
+    /**
+     * Static version of getAllPossibleErrors that doesn't require a component instance.
+     */
+    static getAllPossibleErrors(): ErrorMessageTemplateList;
+    static isEastingNorthing(value?: FormStateValue | FormState): value is EastingNorthingState;
+}
+export declare function getValidatorEastingNorthing(component: EastingNorthingField): import("joi").CustomValidator;

package/.server/server/plugins/engine/components/EastingNorthingField.js

@@ -0,0 +1,166 @@
+import { ComponentType } from '@defra/forms-model';
+import { ComponentCollection } from "./ComponentCollection.js";
+import { FormComponent, isFormState } from "./FormComponent.js";
+import { createLocationFieldValidator, getLocationFieldViewModel } from "./LocationFieldHelpers.js";
+import { NumberField } from "./NumberField.js";
+import { messageTemplate } from "../pageControllers/validationOptions.js";
+import { convertToLanguageMessages } from "../../../utils/type-utils.js";
+
+// British National Grid coordinate limits
+const DEFAULT_EASTING_MIN = 0;
+const DEFAULT_EASTING_MAX = 70000;
+const DEFAULT_NORTHING_MIN = 0;
+const DEFAULT_NORTHING_MAX = 1300000;
+export class EastingNorthingField extends FormComponent {
+  constructor(def, props) {
+    super(def, props);
+    const {
+      name,
+      options,
+      schema
+    } = def;
+    const isRequired = options.required !== false;
+    const eastingMin = schema?.easting?.min ?? DEFAULT_EASTING_MIN;
+    const eastingMax = schema?.easting?.max ?? DEFAULT_EASTING_MAX;
+    const northingMin = schema?.northing?.min ?? DEFAULT_NORTHING_MIN;
+    const northingMax = schema?.northing?.max ?? DEFAULT_NORTHING_MAX;
+    const customValidationMessages = convertToLanguageMessages({
+      'any.required': messageTemplate.objectMissing,
+      'number.base': messageTemplate.objectMissing,
+      'number.min': `{{#label}} for ${this.title} must be between {{#limit}} and ${eastingMax}`,
+      'number.max': `{{#label}} for ${this.title} must be between ${eastingMin} and {{#limit}}`,
+      'number.precision': `{{#label}} for ${this.title} must be between 1 and 5 digits`,
+      'number.integer': `{{#label}} for ${this.title} must be between 1 and 5 digits`,
+      'number.unsafe': `{{#label}} for ${this.title} must be between 1 and 5 digits`
+    });
+    const northingValidationMessages = convertToLanguageMessages({
+      'any.required': messageTemplate.objectMissing,
+      'number.base': messageTemplate.objectMissing,
+      'number.min': `{{#label}} for ${this.title} must be between {{#limit}} and ${northingMax}`,
+      'number.max': `{{#label}} for ${this.title} must be between ${northingMin} and {{#limit}}`,
+      'number.precision': `{{#label}} for ${this.title} must be between 1 and 7 digits`,
+      'number.integer': `{{#label}} for ${this.title} must be between 1 and 7 digits`,
+      'number.unsafe': `{{#label}} for ${this.title} must be between 1 and 7 digits`
+    });
+    this.collection = new ComponentCollection([{
+      type: ComponentType.NumberField,
+      name: `${name}__easting`,
+      title: 'Easting',
+      schema: {
+        min: eastingMin,
+        max: eastingMax,
+        precision: 0
+      },
+      options: {
+        required: isRequired,
+        optionalText: true,
+        classes: 'govuk-input--width-10',
+        customValidationMessages
+      }
+    }, {
+      type: ComponentType.NumberField,
+      name: `${name}__northing`,
+      title: 'Northing',
+      schema: {
+        min: northingMin,
+        max: northingMax,
+        precision: 0
+      },
+      options: {
+        required: isRequired,
+        optionalText: true,
+        classes: 'govuk-input--width-10',
+        customValidationMessages: northingValidationMessages
+      }
+    }], {
+      ...props,
+      parent: this
+    }, {
+      custom: getValidatorEastingNorthing(this),
+      peers: [`${name}__easting`, `${name}__northing`]
+    });
+    this.options = options;
+    this.formSchema = this.collection.formSchema;
+    this.stateSchema = this.collection.stateSchema;
+  }
+  getFormValueFromState(state) {
+    const value = super.getFormValueFromState(state);
+    return EastingNorthingField.isEastingNorthing(value) ? value : undefined;
+  }
+  getDisplayStringFromFormValue(value) {
+    if (!value) {
+      return '';
+    }
+
+    // CYA page format: <<northingvalue, eastingvalue>>
+    return `${value.northing}, ${value.easting}`;
+  }
+  getDisplayStringFromState(state) {
+    const value = this.getFormValueFromState(state);
+    return this.getDisplayStringFromFormValue(value);
+  }
+  getContextValueFromFormValue(value) {
+    if (!value) {
+      return null;
+    }
+
+    // Output format: Northing: <<entry>>\nEasting: <<entry>>
+    return `Northing: ${value.northing}\nEasting: ${value.easting}`;
+  }
+  getContextValueFromState(state) {
+    const value = this.getFormValueFromState(state);
+    return this.getContextValueFromFormValue(value);
+  }
+  getViewModel(payload, errors) {
+    const viewModel = super.getViewModel(payload, errors);
+    return getLocationFieldViewModel(this, viewModel, payload, errors);
+  }
+  isState(value) {
+    return EastingNorthingField.isEastingNorthing(value);
+  }
+
+  /**
+   * For error preview page that shows all possible errors on a component
+   */
+  getAllPossibleErrors() {
+    return EastingNorthingField.getAllPossibleErrors();
+  }
+
+  /**
+   * Static version of getAllPossibleErrors that doesn't require a component instance.
+   */
+  static getAllPossibleErrors() {
+    return {
+      baseErrors: [{
+        type: 'required',
+        template: messageTemplate.required
+      }, {
+        type: 'eastingFormat',
+        template: 'Easting for [short description] must be between 1 and 5 digits'
+      }, {
+        type: 'northingFormat',
+        template: 'Northing for [short description] must be between 1 and 7 digits'
+      }],
+      advancedSettingsErrors: [{
+        type: 'eastingMin',
+        template: `Easting for [short description] must be between ${DEFAULT_EASTING_MIN} and ${DEFAULT_EASTING_MAX}`
+      }, {
+        type: 'eastingMax',
+        template: `Easting for [short description] must be between ${DEFAULT_EASTING_MIN} and ${DEFAULT_EASTING_MAX}`
+      }, {
+        type: 'northingMin',
+        template: `Northing for [short description] must be between ${DEFAULT_NORTHING_MIN} and ${DEFAULT_NORTHING_MAX}`
+      }, {
+        type: 'northingMax',
+        template: `Northing for [short description] must be between ${DEFAULT_NORTHING_MIN} and ${DEFAULT_NORTHING_MAX}`
+      }]
+    };
+  }
+  static isEastingNorthing(value) {
+    return isFormState(value) && NumberField.isNumber(value.easting) && NumberField.isNumber(value.northing);
+  }
+}
+export function getValidatorEastingNorthing(component) {
+  return createLocationFieldValidator(component);
+}
+//# sourceMappingURL=EastingNorthingField.js.map

package/.server/server/plugins/engine/components/EastingNorthingField.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EastingNorthingField.js","names":["ComponentType","ComponentCollection","FormComponent","isFormState","createLocationFieldValidator","getLocationFieldViewModel","NumberField","messageTemplate","convertToLanguageMessages","DEFAULT_EASTING_MIN","DEFAULT_EASTING_MAX","DEFAULT_NORTHING_MIN","DEFAULT_NORTHING_MAX","EastingNorthingField","constructor","def","props","name","options","schema","isRequired","required","eastingMin","easting","min","eastingMax","max","northingMin","northing","northingMax","customValidationMessages","objectMissing","title","northingValidationMessages","collection","type","precision","optionalText","classes","parent","custom","getValidatorEastingNorthing","peers","formSchema","stateSchema","getFormValueFromState","state","value","isEastingNorthing","undefined","getDisplayStringFromFormValue","getDisplayStringFromState","getContextValueFromFormValue","getContextValueFromState","getViewModel","payload","errors","viewModel","isState","getAllPossibleErrors","baseErrors","template","advancedSettingsErrors","isNumber","component"],"sources":["../../../../../src/server/plugins/engine/components/EastingNorthingField.ts"],"sourcesContent":["import {\n  ComponentType,\n  type EastingNorthingFieldComponent\n} from '@defra/forms-model'\nimport { type LanguageMessages, type ObjectSchema } from 'joi'\n\nimport { ComponentCollection } from '~/src/server/plugins/engine/components/ComponentCollection.js'\nimport {\n  FormComponent,\n  isFormState\n} from '~/src/server/plugins/engine/components/FormComponent.js'\nimport {\n  createLocationFieldValidator,\n  getLocationFieldViewModel\n} from '~/src/server/plugins/engine/components/LocationFieldHelpers.js'\nimport { NumberField } from '~/src/server/plugins/engine/components/NumberField.js'\nimport { type EastingNorthingState } from '~/src/server/plugins/engine/components/types.js'\nimport { messageTemplate } from '~/src/server/plugins/engine/pageControllers/validationOptions.js'\nimport {\n  type ErrorMessageTemplateList,\n  type FormPayload,\n  type FormState,\n  type FormStateValue,\n  type FormSubmissionError,\n  type FormSubmissionState\n} from '~/src/server/plugins/engine/types.js'\nimport { convertToLanguageMessages } from '~/src/server/utils/type-utils.js'\n\n// British National Grid coordinate limits\nconst DEFAULT_EASTING_MIN = 0\nconst DEFAULT_EASTING_MAX = 70000\nconst DEFAULT_NORTHING_MIN = 0\nconst DEFAULT_NORTHING_MAX = 1300000\n\nexport class EastingNorthingField extends FormComponent {\n  declare options: EastingNorthingFieldComponent['options']\n  declare formSchema: ObjectSchema<FormPayload>\n  declare stateSchema: ObjectSchema<FormState>\n  declare collection: ComponentCollection\n\n  constructor(\n    def: EastingNorthingFieldComponent,\n    props: ConstructorParameters<typeof FormComponent>[1]\n  ) {\n    super(def, props)\n\n    const { name, options, schema } = def\n\n    const isRequired = options.required !== false\n\n    const eastingMin = schema?.easting?.min ?? DEFAULT_EASTING_MIN\n    const eastingMax = schema?.easting?.max ?? DEFAULT_EASTING_MAX\n    const northingMin = schema?.northing?.min ?? DEFAULT_NORTHING_MIN\n    const northingMax = schema?.northing?.max ?? DEFAULT_NORTHING_MAX\n\n    const customValidationMessages: LanguageMessages =\n      convertToLanguageMessages({\n        'any.required': messageTemplate.objectMissing,\n        'number.base': messageTemplate.objectMissing,\n        'number.min': `{{#label}} for ${this.title} must be between {{#limit}} and ${eastingMax}`,\n        'number.max': `{{#label}} for ${this.title} must be between ${eastingMin} and {{#limit}}`,\n        'number.precision': `{{#label}} for ${this.title} must be between 1 and 5 digits`,\n        'number.integer': `{{#label}} for ${this.title} must be between 1 and 5 digits`,\n        'number.unsafe': `{{#label}} for ${this.title} must be between 1 and 5 digits`\n      })\n\n    const northingValidationMessages: LanguageMessages =\n      convertToLanguageMessages({\n        'any.required': messageTemplate.objectMissing,\n        'number.base': messageTemplate.objectMissing,\n        'number.min': `{{#label}} for ${this.title} must be between {{#limit}} and ${northingMax}`,\n        'number.max': `{{#label}} for ${this.title} must be between ${northingMin} and {{#limit}}`,\n        'number.precision': `{{#label}} for ${this.title} must be between 1 and 7 digits`,\n        'number.integer': `{{#label}} for ${this.title} must be between 1 and 7 digits`,\n        'number.unsafe': `{{#label}} for ${this.title} must be between 1 and 7 digits`\n      })\n\n    this.collection = new ComponentCollection(\n      [\n        {\n          type: ComponentType.NumberField,\n          name: `${name}__easting`,\n          title: 'Easting',\n          schema: { min: eastingMin, max: eastingMax, precision: 0 },\n          options: {\n            required: isRequired,\n            optionalText: true,\n            classes: 'govuk-input--width-10',\n            customValidationMessages\n          }\n        },\n        {\n          type: ComponentType.NumberField,\n          name: `${name}__northing`,\n          title: 'Northing',\n          schema: { min: northingMin, max: northingMax, precision: 0 },\n          options: {\n            required: isRequired,\n            optionalText: true,\n            classes: 'govuk-input--width-10',\n            customValidationMessages: northingValidationMessages\n          }\n        }\n      ],\n      { ...props, parent: this },\n      {\n        custom: getValidatorEastingNorthing(this),\n        peers: [`${name}__easting`, `${name}__northing`]\n      }\n    )\n\n    this.options = options\n    this.formSchema = this.collection.formSchema\n    this.stateSchema = this.collection.stateSchema\n  }\n\n  getFormValueFromState(state: FormSubmissionState) {\n    const value = super.getFormValueFromState(state)\n    return EastingNorthingField.isEastingNorthing(value) ? value : undefined\n  }\n\n  getDisplayStringFromFormValue(\n    value: EastingNorthingState | undefined\n  ): string {\n    if (!value) {\n      return ''\n    }\n\n    // CYA page format: <<northingvalue, eastingvalue>>\n    return `${value.northing}, ${value.easting}`\n  }\n\n  getDisplayStringFromState(state: FormSubmissionState) {\n    const value = this.getFormValueFromState(state)\n\n    return this.getDisplayStringFromFormValue(value)\n  }\n\n  getContextValueFromFormValue(\n    value: EastingNorthingState | undefined\n  ): string | null {\n    if (!value) {\n      return null\n    }\n\n    // Output format: Northing: <<entry>>\\nEasting: <<entry>>\n    return `Northing: ${value.northing}\\nEasting: ${value.easting}`\n  }\n\n  getContextValueFromState(state: FormSubmissionState) {\n    const value = this.getFormValueFromState(state)\n\n    return this.getContextValueFromFormValue(value)\n  }\n\n  getViewModel(payload: FormPayload, errors?: FormSubmissionError[]) {\n    const viewModel = super.getViewModel(payload, errors)\n    return getLocationFieldViewModel(this, viewModel, payload, errors)\n  }\n\n  isState(value?: FormStateValue | FormState) {\n    return EastingNorthingField.isEastingNorthing(value)\n  }\n\n  /**\n   * For error preview page that shows all possible errors on a component\n   */\n  getAllPossibleErrors(): ErrorMessageTemplateList {\n    return EastingNorthingField.getAllPossibleErrors()\n  }\n\n  /**\n   * Static version of getAllPossibleErrors that doesn't require a component instance.\n   */\n  static getAllPossibleErrors(): ErrorMessageTemplateList {\n    return {\n      baseErrors: [\n        { type: 'required', template: messageTemplate.required },\n        {\n          type: 'eastingFormat',\n          template:\n            'Easting for [short description] must be between 1 and 5 digits'\n        },\n        {\n          type: 'northingFormat',\n          template:\n            'Northing for [short description] must be between 1 and 7 digits'\n        }\n      ],\n      advancedSettingsErrors: [\n        {\n          type: 'eastingMin',\n          template: `Easting for [short description] must be between ${DEFAULT_EASTING_MIN} and ${DEFAULT_EASTING_MAX}`\n        },\n        {\n          type: 'eastingMax',\n          template: `Easting for [short description] must be between ${DEFAULT_EASTING_MIN} and ${DEFAULT_EASTING_MAX}`\n        },\n        {\n          type: 'northingMin',\n          template: `Northing for [short description] must be between ${DEFAULT_NORTHING_MIN} and ${DEFAULT_NORTHING_MAX}`\n        },\n        {\n          type: 'northingMax',\n          template: `Northing for [short description] must be between ${DEFAULT_NORTHING_MIN} and ${DEFAULT_NORTHING_MAX}`\n        }\n      ]\n    }\n  }\n\n  static isEastingNorthing(\n    value?: FormStateValue | FormState\n  ): value is EastingNorthingState {\n    return (\n      isFormState(value) &&\n      NumberField.isNumber(value.easting) &&\n      NumberField.isNumber(value.northing)\n    )\n  }\n}\n\nexport function getValidatorEastingNorthing(component: EastingNorthingField) {\n  return createLocationFieldValidator(component)\n}\n"],"mappings":"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","ignoreList":[]}

package/.server/server/plugins/engine/components/LatLongField.d.ts

@@ -0,0 +1,121 @@
+import { type LatLongFieldComponent } from '@defra/forms-model';
+import { type ObjectSchema } from 'joi';
+import { ComponentCollection } from '~/src/server/plugins/engine/components/ComponentCollection.js';
+import { FormComponent } from '~/src/server/plugins/engine/components/FormComponent.js';
+import { type LatLongState } from '~/src/server/plugins/engine/components/types.js';
+import { type ErrorMessageTemplateList, type FormPayload, type FormState, type FormStateValue, type FormSubmissionError, type FormSubmissionState } from '~/src/server/plugins/engine/types.js';
+export declare class LatLongField extends FormComponent {
+    options: LatLongFieldComponent['options'];
+    formSchema: ObjectSchema<FormPayload>;
+    stateSchema: ObjectSchema<FormState>;
+    collection: ComponentCollection;
+    constructor(def: LatLongFieldComponent, props: ConstructorParameters<typeof FormComponent>[1]);
+    getFormValueFromState(state: FormSubmissionState): LatLongState | undefined;
+    getDisplayStringFromFormValue(value: LatLongState | undefined): string;
+    getDisplayStringFromState(state: FormSubmissionState): string;
+    getContextValueFromFormValue(value: LatLongState | undefined): string | null;
+    getContextValueFromState(state: FormSubmissionState): string | null;
+    getViewModel(payload: FormPayload, errors?: FormSubmissionError[]): {
+        fieldset: {
+            attributes?: string | Record<string, string>;
+            legend?: import("~/src/server/plugins/engine/components/types.js").Label;
+        };
+        items: import("~/src/server/plugins/engine/components/types.js").DateInputItem[];
+        label: import("~/src/server/plugins/engine/components/types.js").Label;
+        type?: string;
+        id: string;
+        name: string;
+        value: import("~/src/server/plugins/engine/types.js").FormValue;
+        hint?: {
+            id?: string;
+            text: string;
+        };
+        prefix?: import("~/src/server/plugins/engine/components/types.js").ComponentText;
+        suffix?: import("~/src/server/plugins/engine/components/types.js").ComponentText;
+        classes?: string;
+        condition?: string;
+        errors?: FormSubmissionError[];
+        errorMessage?: {
+            text: string;
+        };
+        summaryHtml?: string;
+        html?: string;
+        attributes: {
+            autocomplete?: string;
+            maxlength?: number;
+            multiple?: string;
+            accept?: string;
+            inputmode?: string;
+        };
+        content?: import("~/src/server/plugins/engine/components/types.js").Content | import("~/src/server/plugins/engine/components/types.js").Content[] | string;
+        maxlength?: number;
+        maxwords?: number;
+        rows?: number;
+        formGroup?: {
+            classes?: string;
+            attributes?: string | Record<string, string>;
+        };
+        components?: import("~/src/server/plugins/engine/components/types.js").ComponentViewModel[];
+        upload?: {
+            count: number;
+            summaryList: import("~/src/server/plugins/engine/types.js").SummaryList;
+        };
+    } | {
+        instructionText: string;
+        fieldset: {
+            attributes?: string | Record<string, string>;
+            legend?: import("~/src/server/plugins/engine/components/types.js").Label;
+        };
+        items: import("~/src/server/plugins/engine/components/types.js").DateInputItem[];
+        label: import("~/src/server/plugins/engine/components/types.js").Label;
+        type?: string;
+        id: string;
+        name: string;
+        value: import("~/src/server/plugins/engine/types.js").FormValue;
+        hint?: {
+            id?: string;
+            text: string;
+        };
+        prefix?: import("~/src/server/plugins/engine/components/types.js").ComponentText;
+        suffix?: import("~/src/server/plugins/engine/components/types.js").ComponentText;
+        classes?: string;
+        condition?: string;
+        errors?: FormSubmissionError[];
+        errorMessage?: {
+            text: string;
+        };
+        summaryHtml?: string;
+        html?: string;
+        attributes: {
+            autocomplete?: string;
+            maxlength?: number;
+            multiple?: string;
+            accept?: string;
+            inputmode?: string;
+        };
+        content?: import("~/src/server/plugins/engine/components/types.js").Content | import("~/src/server/plugins/engine/components/types.js").Content[] | string;
+        maxlength?: number;
+        maxwords?: number;
+        rows?: number;
+        formGroup?: {
+            classes?: string;
+            attributes?: string | Record<string, string>;
+        };
+        components?: import("~/src/server/plugins/engine/components/types.js").ComponentViewModel[];
+        upload?: {
+            count: number;
+            summaryList: import("~/src/server/plugins/engine/types.js").SummaryList;
+        };
+    };
+    isState(value?: FormStateValue | FormState): value is LatLongState;
+    /**
+     * For error preview page that shows all possible errors on a component
+     */
+    getAllPossibleErrors(): ErrorMessageTemplateList;
+    /**
+     * Static version of getAllPossibleErrors that doesn't require a component instance.
+     */
+    static getAllPossibleErrors(): ErrorMessageTemplateList;
+    static isLatLong(value?: FormStateValue | FormState): value is LatLongState;
+}
+export declare function getValidatorLatLong(component: LatLongField): import("joi").CustomValidator;