@defra/forms-engine-plugin 0.0.3 → 0.0.4

package/src/server/plugins/engine/components/DatePartsField.ts

@@ -1,264 +0,0 @@
-import { ComponentType, type DatePartsFieldComponent } from '@defra/forms-model'
-import { add, format, isValid, parse, startOfToday, sub } from 'date-fns'
-import {
-  type Context,
-  type CustomValidator,
-  type LanguageMessages,
-  type ObjectSchema
-} from 'joi'
-
-import { ComponentCollection } from '~/src/server/plugins/engine/components/ComponentCollection.js'
-import {
-  FormComponent,
-  isFormState,
-  isFormValue
-} from '~/src/server/plugins/engine/components/FormComponent.js'
-import { NumberField } from '~/src/server/plugins/engine/components/NumberField.js'
-import { type DateInputItem } from '~/src/server/plugins/engine/components/types.js'
-import { messageTemplate } from '~/src/server/plugins/engine/pageControllers/validationOptions.js'
-import {
-  type FormPayload,
-  type FormState,
-  type FormStateValue,
-  type FormSubmissionError,
-  type FormSubmissionState
-} from '~/src/server/plugins/engine/types.js'
-
-export class DatePartsField extends FormComponent {
-  declare options: DatePartsFieldComponent['options']
-  declare formSchema: ObjectSchema<FormPayload>
-  declare stateSchema: ObjectSchema<FormState>
-  declare collection: ComponentCollection
-
-  constructor(
-    def: DatePartsFieldComponent,
-    props: ConstructorParameters<typeof FormComponent>[1]
-  ) {
-    super(def, props)
-
-    const { name, options } = def
-
-    const isRequired = options.required !== false
-
-    const customValidationMessages: LanguageMessages = {
-      'any.required': messageTemplate.objectMissing,
-      'number.base': messageTemplate.objectMissing,
-      'number.precision': messageTemplate.dateFormat,
-      'number.integer': messageTemplate.dateFormat,
-      'number.unsafe': messageTemplate.dateFormat,
-      'number.min': messageTemplate.dateFormat,
-      'number.max': messageTemplate.dateFormat
-    }
-
-    this.collection = new ComponentCollection(
-      [
-        {
-          type: ComponentType.NumberField,
-          name: `${name}__day`,
-          title: 'Day',
-          schema: { min: 1, max: 31, precision: 0 },
-          options: {
-            required: isRequired,
-            optionalText: true,
-            classes: 'govuk-input--width-2',
-            customValidationMessages
-          }
-        },
-        {
-          type: ComponentType.NumberField,
-          name: `${name}__month`,
-          title: 'Month',
-          schema: { min: 1, max: 12, precision: 0 },
-          options: {
-            required: isRequired,
-            optionalText: true,
-            classes: 'govuk-input--width-2',
-            customValidationMessages
-          }
-        },
-        {
-          type: ComponentType.NumberField,
-          name: `${name}__year`,
-          title: 'Year',
-          schema: { min: 1000, max: 3000, precision: 0 },
-          options: {
-            required: isRequired,
-            optionalText: true,
-            classes: 'govuk-input--width-4',
-            customValidationMessages
-          }
-        }
-      ],
-      { ...props, parent: this },
-      {
-        custom: getValidatorDate(this),
-        peers: [`${name}__day`, `${name}__month`, `${name}__year`]
-      }
-    )
-
-    this.options = options
-    this.formSchema = this.collection.formSchema
-    this.stateSchema = this.collection.stateSchema
-  }
-
-  getFormValueFromState(state: FormSubmissionState) {
-    const value = super.getFormValueFromState(state)
-    return this.isState(value) ? value : undefined
-  }
-
-  getDisplayStringFromState(state: FormSubmissionState) {
-    const value = this.getFormValueFromState(state)
-
-    if (!value) {
-      return ''
-    }
-
-    return format(`${value.year}-${value.month}-${value.day}`, 'd MMMM yyyy')
-  }
-
-  getContextValueFromState(state: FormSubmissionState) {
-    const value = this.getFormValueFromState(state)
-
-    if (
-      !value ||
-      !isValid(
-        parse(
-          `${value.year}-${value.month}-${value.day}`,
-          'yyyy-MM-dd',
-          new Date()
-        )
-      )
-    ) {
-      return null
-    }
-
-    return format(`${value.year}-${value.month}-${value.day}`, 'yyyy-MM-dd')
-  }
-
-  getViewModel(payload: FormPayload, errors?: FormSubmissionError[]) {
-    const { collection, name } = this
-
-    const viewModel = super.getViewModel(payload, errors)
-    let { fieldset, label } = viewModel
-
-    // Check for component errors only
-    const hasError = errors?.some((error) => error.name === name)
-
-    // Use the component collection to generate the subitems
-    const items: DateInputItem[] = collection
-      .getViewModel(payload, errors)
-      .map(({ model }) => {
-        let { label, type, value, classes, errorMessage } = model
-
-        if (label) {
-          label.toString = () => label.text // Date component uses string labels
-        }
-
-        if (hasError || errorMessage) {
-          classes = `${classes} govuk-input--error`.trim()
-        }
-
-        // Allow any `toString()`-able value so non-numeric
-        // values are shown alongside their error messages
-        if (!isFormValue(value)) {
-          value = undefined
-        }
-
-        return {
-          label,
-          id: model.id,
-          name: model.name,
-          type,
-          value,
-          classes
-        }
-      })
-
-    fieldset ??= {
-      legend: {
-        text: label.text,
-        classes: 'govuk-fieldset__legend--m'
-      }
-    }
-
-    return {
-      ...viewModel,
-      fieldset,
-      items
-    }
-  }
-
-  isState(value?: FormStateValue | FormState) {
-    return DatePartsField.isDateParts(value)
-  }
-
-  static isDateParts(
-    value?: FormStateValue | FormState
-  ): value is DatePartsState {
-    return (
-      isFormState(value) &&
-      NumberField.isNumber(value.day) &&
-      NumberField.isNumber(value.month) &&
-      NumberField.isNumber(value.year)
-    )
-  }
-}
-
-export interface DatePartsState extends Record<string, number> {
-  day: number
-  month: number
-  year: number
-}
-
-export function getValidatorDate(component: DatePartsField) {
-  const validator: CustomValidator = (payload: FormPayload, helpers) => {
-    const { collection, name, options } = component
-
-    const values = component.getFormValueFromState(
-      component.getStateFromValidForm(payload)
-    )
-
-    const context: Context = {
-      missing: collection.keys,
-      key: name
-    }
-
-    if (!component.isState(values)) {
-      return options.required !== false
-        ? helpers.error('object.required', context)
-        : payload
-    }
-
-    const date = parse(
-      `${values.year}-${values.month}-${values.day}`,
-      'yyyy-MM-dd',
-      new Date()
-    )
-
-    if (!isValid(date)) {
-      return helpers.error('date.format', context)
-    }
-
-    // Minimum date from today
-    const dateMin = options.maxDaysInPast
-      ? sub(startOfToday(), { days: options.maxDaysInPast })
-      : undefined
-
-    // Maximum date from today
-    const dateMax = options.maxDaysInFuture
-      ? add(startOfToday(), { days: options.maxDaysInFuture })
-      : undefined
-
-    if (dateMin && date < dateMin) {
-      return helpers.error('date.min', { ...context, limit: dateMin })
-    }
-
-    if (dateMax && date > dateMax) {
-      return helpers.error('date.max', { ...context, limit: dateMax })
-    }
-
-    return payload
-  }
-
-  return validator
-}

package/src/server/plugins/engine/components/Details.test.ts

@@ -1,49 +0,0 @@
-import { ComponentType, type DetailsComponent } from '@defra/forms-model'
-
-import { ComponentCollection } from '~/src/server/plugins/engine/components/ComponentCollection.js'
-import { type Guidance } from '~/src/server/plugins/engine/components/helpers.js'
-import { FormModel } from '~/src/server/plugins/engine/models/FormModel.js'
-import definition from '~/test/form/definitions/basic.js'
-
-describe('Details', () => {
-  let model: FormModel
-
-  beforeEach(() => {
-    model = new FormModel(definition, {
-      basePath: 'test'
-    })
-  })
-
-  describe('Defaults', () => {
-    let def: DetailsComponent
-    let collection: ComponentCollection
-    let guidance: Guidance
-
-    beforeEach(() => {
-      def = {
-        title: 'Details guidance',
-        name: 'myComponent',
-        type: ComponentType.Details,
-        content: 'Lorem ipsum dolor sit amet',
-        options: {}
-      } satisfies DetailsComponent
-
-      collection = new ComponentCollection([def], { model })
-      guidance = collection.guidance[0]
-    })
-
-    describe('View model', () => {
-      it('sets Nunjucks component defaults', () => {
-        const viewModel = guidance.getViewModel()
-
-        expect(viewModel).toEqual(
-          expect.objectContaining({
-            attributes: {},
-            html: def.content,
-            summaryHtml: def.title
-          })
-        )
-      })
-    })
-  })
-})

package/src/server/plugins/engine/components/Details.ts

@@ -1,30 +0,0 @@
-import { type DetailsComponent } from '@defra/forms-model'
-
-import { ComponentBase } from '~/src/server/plugins/engine/components/ComponentBase.js'
-
-export class Details extends ComponentBase {
-  declare options: DetailsComponent['options']
-  content: DetailsComponent['content']
-
-  constructor(
-    def: DetailsComponent,
-    props: ConstructorParameters<typeof ComponentBase>[1]
-  ) {
-    super(def, props)
-
-    const { content, options } = def
-
-    this.content = content
-    this.options = options
-  }
-
-  getViewModel() {
-    const { content, title, viewModel } = this
-
-    return {
-      ...viewModel,
-      html: content,
-      summaryHtml: title
-    }
-  }
-}