feat/df-1065: Welsh translation for plugin

jest.setup.cjs

@@ -1,3 +1,10 @@
+// Pre-load @defra/forms-model to ensure Joi internals are initialised before any test
+// file runs. This prevents a Symbol identity mismatch between the ESM-wrapped Joi
+// instance (created by babel-jest) and the CJS Joi instance used by Joi's internal
+// Template.isTemplate() check, which occurs when resetModules: true clears the
+// registry between tests.
+require('@defra/forms-model')
+
 process.env.REDIS_HOST = 'dummy'
 process.env.REDIS_KEY_PREFIX = 'forms-designer'
 process.env.REDIS_PASSWORD = 'dummy'

package.json

@@ -83,7 +83,7 @@
   },
   "engines": {
     "node": ">=22.11.0 <25.0.0",
-    "npm": ">=10.9.0 <11.6.4"
+    "npm": ">=10.9.0 <=11.17.0"
   },
   "license": "SEE LICENSE IN LICENSE",
   "dependencies": {
@@ -126,6 +126,7 @@
     "highlight.js": "^11.11.1",
     "http-status-codes": "^2.3.0",
     "humanize-duration": "^3.33.1",
+    "i18next": "^26.0.5",
     "ioredis": "^5.8.2",
     "joi": "^17.13.3",
     "liquidjs": "^10.24.0",

scripts/generate-component-previews.js

@@ -5,6 +5,7 @@ import { markdownToHtml } from '@defra/forms-model'
 
 // Static imports so Jest can mock them (dynamic computed-path imports cannot be mocked).
 import { createComponent } from '~/src/server/plugins/engine/components/helpers/components.js'
+import { stubTranslator } from '~/src/server/plugins/engine/pageControllers/__stubs__/translator.js'
 import { environment } from '~/src/server/plugins/nunjucks/environment.js'
 
 // Register the markdown filter that the engine plugin normally adds at server init.
@@ -26,7 +27,11 @@ export function renderComponent(fixture) {
     /** @type {unknown} */ (fixture.model)
   )
   const component = createComponent(fixture.def, { model })
-  const viewModel = component.getViewModel(fixture.payload, [])
+  const viewModel = component.getViewModel({
+    payload: fixture.payload,
+    errors: [],
+    translator: stubTranslator
+  })
 
   // Apply large label/legend sizing to match how QuestionPageController styles
   // a single-component page. isPageHeading is intentionally omitted — setting it

scripts/generate-component-previews.test.js

@@ -27,6 +27,7 @@ import {
 } from './generate-component-previews.js'
 
 import { createComponent } from '~/src/server/plugins/engine/components/helpers/components.ts'
+import { stubTranslator } from '~/src/server/plugins/engine/pageControllers/__stubs__/translator.js'
 import { environment } from '~/src/server/plugins/nunjucks/environment.js'
 
 describe('component-preview-fixtures', () => {
@@ -132,6 +133,10 @@ describe('buildPartialMdx', () => {
 describe('renderComponent', () => {
   let mockGetViewModel
 
+  const mockModel = {
+    createTranslator: () => stubTranslator
+  }
+
   beforeEach(() => {
     mockGetViewModel = jest.fn().mockReturnValue({
       type: 'TextField',
@@ -145,22 +150,32 @@ describe('renderComponent', () => {
   })
 
   it('calls createComponent with def and model from fixture', () => {
-    renderComponent(fixtures.TextField)
+    renderComponent({
+      ...fixtures.TextField,
+      model: mockModel
+    })
     expect(createComponent).toHaveBeenCalledWith(fixtures.TextField.def, {
-      model: fixtures.TextField.model
+      model: mockModel
     })
   })
 
   it('calls getViewModel with payload and empty errors array', () => {
-    renderComponent(fixtures.TextField)
-    expect(mockGetViewModel).toHaveBeenCalledWith(
-      fixtures.TextField.payload,
-      []
-    )
+    renderComponent({
+      ...fixtures.TextField,
+      model: mockModel
+    })
+    expect(mockGetViewModel).toHaveBeenCalledWith({
+      payload: {},
+      errors: [],
+      translator: stubTranslator
+    })
   })
 
   it('passes viewModel wrapped as { type, model } to renderString', () => {
-    renderComponent(fixtures.TextField)
+    renderComponent({
+      ...fixtures.TextField,
+      model: mockModel
+    })
     expect(environment.renderString).toHaveBeenCalledWith(
       expect.stringContaining('componentList'),
       expect.objectContaining({

scripts/page-preview-fixtures.js

@@ -65,9 +65,14 @@ function pageViewContext({
       server: { plugins: { 'forms-engine-plugin': {} } }
     })
   )
+  const translator = model.createTranslator()
   return getViewModelOverride
     ? getViewModelOverride(controller, model, mockRequest, mockContext)
-    : controller.getViewModel(/** @type {any} */ (mockRequest), mockContext)
+    : controller.getViewModel(
+        /** @type {any} */ (mockRequest),
+        mockContext,
+        translator
+      )
 }
 
 const fileUploadWithFilesVariant = /** @type {any} */ (
@@ -192,13 +197,18 @@ export const pageFixtures = {
           ]
         }
       ],
-      getViewModelOverride: (ctrl, _model, req, ctx) => {
+      getViewModelOverride: (ctrl, model, req, ctx) => {
         const repeat = /** @type {RepeatPageController} */ (ctrl)
-        const vm = repeat.getListSummaryViewModel(req, ctx, [
-          { itemId: '1', fullname: 'Sarah Phillips' },
-          { itemId: '2', fullname: 'David Jones' },
-          { itemId: '3', fullname: 'Emma Wilson' }
-        ])
+        const vm = repeat.getListSummaryViewModel(
+          req,
+          ctx,
+          [
+            { itemId: '1', fullname: 'Sarah Phillips' },
+            { itemId: '2', fullname: 'David Jones' },
+            { itemId: '3', fullname: 'Emma Wilson' }
+          ],
+          model.createTranslator()
+        )
         return /** @type {PageViewModel} */ (
           /** @type {unknown} */ ({
             ...vm,
@@ -300,10 +310,12 @@ export const pageFixtures = {
       ],
       renderPage: '/summary',
       state: { fullname: 'Sarah Phillips', email: 'sarah@example.gov.uk' },
-      getViewModelOverride: (ctrl, _model, req, ctx) => {
+      getViewModelOverride: (ctrl, model, req, ctx) => {
         const summary = /** @type {SummaryPageController} */ (ctrl)
         return /** @type {PageViewModel} */ (
-          /** @type {unknown} */ (summary.getSummaryViewModel(req, ctx))
+          /** @type {unknown} */ (
+            summary.getSummaryViewModel(req, ctx, model.createTranslator())
+          )
         )
       }
     })

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

@@ -242,20 +242,6 @@ pages:
         content: 'Fill in this field'
         options:
           required: false
-    next:
-      - path: '/pay-for-your-licence'
-  - title: Pay for your licence
-    path: '/pay-for-your-licence'
-    section: section
-    components:
-      - name: licencePayment
-        title: Unicorn breeder licence fee
-        type: PaymentField
-        hint: You'll be redirected to GOV.UK Pay to complete your payment
-        options:
-          required: true
-          amount: 50
-          description: Unicorn breeder annual licence fee
     next:
       - path: '/summary'
 conditions:

src/server/forms/simple-form-pirate.yaml

@@ -0,0 +1,80 @@
+---
+name: Pirate Form
+engine: V2
+schema: 2
+startPage: '/summary'
+metadata:
+  language: x-pirate
+pages:
+  - title: Yer name, landlubber
+    path: '/your-name'
+    components:
+      - type: TextField
+        title: What be yer first name?
+        name: applicantFirstName
+        shortDescription: Yer first name
+        hint: ''
+        options:
+          required: true
+        schema: {}
+        id: 1fb8e182-c709-4792-8f83-e01d8b1fee1a
+      - type: TextField
+        title: What be yer last name?
+        name: applicantLastName
+        shortDescription: Yer last name
+        hint: ''
+        options:
+          required: true
+        schema: {}
+        id: b68df7f1-d4f4-4c17-83c8-402f584906c9
+    next: []
+    id: 622a35ec-3795-418a-81f3-a45746959045
+  - title: Hoist yer passport
+    controller: FileUploadPageController
+    path: '/upload-passport'
+    components:
+      - type: FileUploadField
+        title: Hoist a copy of yer passport, arrr
+        name: passportUpload
+        shortDescription: Hoist passport
+        hint: ''
+        options:
+          required: false
+        schema: {}
+        id: 987c1234-56d7-89e0-1234-56789abcdef0
+    id: 23456789-0abc-def1-2345-67890abcdef1
+  - title: Hoist yer ship's licence
+    controller: FileUploadPageController
+    path: '/upload-driving-licence'
+    components:
+      - type: FileUploadField
+        title: Hoist a copy of yer drivers licence, matey
+        name: driversLicenceUpload
+        shortDescription: Hoist drivers licence
+        hint: ''
+        options:
+          required: false
+        schema: {}
+        id: 987c1234-56d7-89e0-1234-56789abcdef1
+    id: 23456789-0abc-def1-2345-67890abcdef2
+  - title: ''
+    path: '/date-of-birth'
+    components:
+      - type: DatePartsField
+        title: When did {{ applicantFirstName }} {{ applicantLastName }} first set sail?
+        name: dateOfBirth
+        shortDescription: Yer birthday
+        hint: ''
+        options:
+          required: true
+        schema: {}
+        id: '00738799-3489-4ab2-a57b-542eecb31bfa'
+    next: []
+    id: da0fbdb4-a2de-4650-be16-9ba552af135f
+  - id: 449a45f6-4541-4a46-91bd-8b8931b07b50
+    title: ''
+    path: '/summary'
+    controller: SummaryPageController
+conditions: []
+sections: []
+lists: []