@formhaus/core 0.12.0 → 0.13.1

package/dist/server.js

@@ -1,2 +1,2 @@
-import {d,g,f}from'./chunk-OZ352IOK.js';export{a as FormDefinitionError,c as checkDefinition,d as parseDefinition}from'./chunk-OZ352IOK.js';import {b,l,m as m$1,B}from'./chunk-OBVVPPVA.js';var V='Pass the values object as the second argument, not the request body with "values" and "skippedSteps".',h=()=>null,m=(e,t)=>Object.prototype.hasOwnProperty.call(e,t);function D(e,t,n){let o=n!==null&&typeof n=="object"&&!Array.isArray(n)?n:{},i=f(e),r=[...new Set(t.map(({key:a})=>a))].filter(a=>m(o,a)),c={values:{},active:new Map};for(let a=0;a<=t.length;a++){let l$1={};for(let s of r)l$1[s]=l(c.active.get(s)??t.find(f=>f.key===s),o[s]);let u=new Map;for(let s of r){let f=i.activeField(s,l$1);f&&u.set(s,f);}let p=r.every(s=>u.get(s)===c.active.get(s));if(c={values:l$1,active:u},p)break}return c}function R({values:e,active:t}){let n=new Map;for(let[o,i]of t){let r=m$1(i,e[o]);r&&n.set(o,r);}return n}function A(e,t){let n=i=>i.map(r=>t.has(r.key)?{...r,validation:void 0}:r),o=e.steps?.map(i=>({...i,fields:n(i.fields)}));return {...e,...e.fields&&{fields:n(e.fields)},...o&&{steps:o}}}function E(e,t={}){let n={};for(let{validation:o}of e)o?.validator&&(n[o.validator]=h);return {...n,...t}}function O(e,t){return t===null||typeof t!="object"||!m(t,"values")?false:!e.some(n=>n.key==="values"||n.key==="skippedSteps")}function M(e,t){if(!Array.isArray(t))return;let n=new Set(t);for(let o=0;o<e.visibleSteps.length;o++){let i=e.visibleSteps[o];i.skip&&n.has(i.id)&&B(e,o);}}function x(e,t,n={}){d(e);let o=b(e),i=D(e,o,t),r=R(i),c={validators:E(o,n.validators),onWarning:()=>{}},a=new g(A(e,r),i.values,c);M(a,n.skippedSteps);let l=a.validate(),u=a.getSubmitValues();for(let[p,s]of r)m(u,p)&&(l[p]=s);return O(o,t)&&(l.values=V),{values:u,errors:l}}export{x as validateSubmission};//# sourceMappingURL=server.js.map
+import {c,b}from'./chunk-PBTYUSZR.js';import {r}from'./chunk-76YV4J3Q.js';import {k}from'./chunk-RN5GQHKN.js';export{a as FormDefinitionError,j as checkDefinition,k as parseDefinition}from'./chunk-RN5GQHKN.js';import {g,d as d$1,p,q}from'./chunk-35SAVPYL.js';var h='Pass the values object as the second argument, not the request body with "values" and "skippedSteps".',D=()=>null,d=(e,t)=>Object.prototype.hasOwnProperty.call(e,t);function A(e,t,s){let o=s!==null&&typeof s=="object"&&!Array.isArray(s)?s:{},n=b(e),r=[...new Set(t.map(({key:l})=>l))].filter(l=>d(o,l)),a={values:{},active:new Map};for(let l=0;l<=t.length;l++){let c={};for(let i of r){let p$1=p(a.active.get(i)??t.find(w=>w.key===i),o[i]);p$1!==void 0&&(c[i]=p$1);}let u=new Map;for(let i of r){let p=n.activeField(i,c);p&&u.set(i,p);}let f=r.every(i=>u.get(i)===a.active.get(i));if(a={values:c,active:u},f)break}return a}function M({values:e,active:t},s){let o=new Map;for(let[n,r]of t){let a=q(r,e[n],s);a&&o.set(n,a);}return o}function E(e,t){let s=n=>n.map(r=>t.has(r.key)?{...r,validation:void 0}:r),o=e.steps?.map(n=>({...n,fields:s(n.fields)}));return {...e,...e.fields&&{fields:s(e.fields)},...o&&{steps:o}}}function O(e,t={}){let s={};for(let{validation:o}of e)o?.validator&&(s[o.validator]=D);return {...s,...t}}function x(e,t){return t===null||typeof t!="object"||!d(t,"values")?false:!e.some(s=>s.key==="values"||s.key==="skippedSteps")}function j(e,t){if(!Array.isArray(t))return;let s=new Set(t);for(let o=0;o<e.visibleSteps.length;o++){let n=e.visibleSteps[o];n.skip&&s.has(n.id)&&r(e,o);}}function I(e,t,s={}){k(e);let o=g(e),n=A(e,o,t),r=d$1(s.messages,e.messages),a=M(n,r),l={validators:O(o,s.validators),messages:r,onWarning:()=>{}},c$1=new c(E(e,a),n.values,l);j(c$1,s.skippedSteps);let u=c$1.validate(),f=c$1.getSubmitValues();for(let[i,p]of a)d(f,i)&&(u[i]=p);return x(o,t)&&(u.values=h),{values:f,errors:u}}export{I as validateSubmission};//# sourceMappingURL=server.js.map
 //# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/server/validate-submission.ts"],"names":["BODY_MESSAGE","allow","hasOwn","source","key","activeValues","definition","fields","input","visibility","createVisibility","keys","result","round","values","normalizeValue","field","active","settled","typeErrors","errors","error","typeError","withoutRules","invalid","strip","steps","step","ignoredValidators","given","validators","validation","isBody","applySkips","engine","skippedSteps","requested","index","skipStepAt","validateSubmission","options","parseDefinition","getAllFields","resolved","engineOptions","FormEngine","submitted"],"mappings":"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","file":"server.js","sourcesContent":["import type { FormDefinition, FormField } from '../types';\nimport type { ValidatorFn } from '../validation';\nimport { parseDefinition } from '../definition-validation';\nimport { getAllFields } from '../engine/engine-utils';\nimport type { EngineInternals } from '../engine/runtime-internals';\nimport { FormEngine } from '../engine/runtime';\nimport { skipStepAt } from '../engine/step-skip';\nimport { createVisibility } from '../engine/visibility-state';\nimport { normalizeValue, typeError } from '../validation/type-checks';\n\nexport interface SubmissionOptions {\n  skippedSteps?: string[];\n  validators?: Record<string, ValidatorFn>;\n}\n\nconst BODY_MESSAGE = 'Pass the values object as the second argument, not the request body with \"values\" and \"skippedSteps\".';\n\nexport interface SubmissionResult {\n  values: Record<string, unknown>;\n  errors: Record<string, string>;\n}\n\nconst allow: ValidatorFn = () => null;\n\nconst hasOwn = (source: object, key: string) => Object.prototype.hasOwnProperty.call(source, key);\n\ninterface ActiveValues {\n  values: Record<string, unknown>;\n  active: Map<string, FormField>;\n}\n\nfunction activeValues(definition: FormDefinition, fields: FormField[], input: unknown): ActiveValues {\n  const source = input !== null && typeof input === 'object' && !Array.isArray(input) ? input as Record<string, unknown> : {};\n  const visibility = createVisibility(definition);\n  const keys = [...new Set(fields.map(({ key }) => key))].filter((key) => hasOwn(source, key));\n  let result: ActiveValues = { values: {}, active: new Map() };\n  for (let round = 0; round <= fields.length; round++) {\n    const values: Record<string, unknown> = {};\n    for (const key of keys) values[key] = normalizeValue(result.active.get(key) ?? fields.find((field) => field.key === key)!, source[key]);\n    const active = new Map<string, FormField>();\n    for (const key of keys) {\n      const field = visibility.activeField(key, values);\n      if (field) active.set(key, field);\n    }\n    const settled = keys.every((key) => active.get(key) === result.active.get(key));\n    result = { values, active };\n    if (settled) break;\n  }\n  return result;\n}\n\nfunction typeErrors({ values, active }: ActiveValues): Map<string, string> {\n  const errors = new Map<string, string>();\n  for (const [key, field] of active) {\n    const error = typeError(field, values[key]);\n    if (error) errors.set(key, error);\n  }\n  return errors;\n}\n\nfunction withoutRules(definition: FormDefinition, invalid: Map<string, string>): FormDefinition {\n  const strip = (fields: FormField[]) => fields.map((field) => (invalid.has(field.key) ? { ...field, validation: undefined } : field));\n  const steps = definition.steps?.map((step) => ({ ...step, fields: strip(step.fields) }));\n  return { ...definition, ...(definition.fields && { fields: strip(definition.fields) }), ...(steps && { steps }) };\n}\n\nfunction ignoredValidators(fields: FormField[], given: Record<string, ValidatorFn> = {}): Record<string, ValidatorFn> {\n  const validators: Record<string, ValidatorFn> = {};\n  for (const { validation } of fields) if (validation?.validator) validators[validation.validator] = allow;\n  return { ...validators, ...given };\n}\n\nfunction isBody(fields: FormField[], input: unknown): boolean {\n  if (input === null || typeof input !== 'object' || !hasOwn(input, 'values')) return false;\n  return !fields.some((field) => field.key === 'values' || field.key === 'skippedSteps');\n}\n\nfunction applySkips(engine: FormEngine, skippedSteps: unknown): void {\n  if (!Array.isArray(skippedSteps)) return;\n  const requested = new Set(skippedSteps);\n  for (let index = 0; index < engine.visibleSteps.length; index++) {\n    const step = engine.visibleSteps[index];\n    if (step.skip && requested.has(step.id)) skipStepAt(engine as unknown as EngineInternals, index);\n  }\n}\n\nexport function validateSubmission(\n  definition: FormDefinition,\n  values: unknown,\n  options: SubmissionOptions = {},\n): SubmissionResult {\n  parseDefinition(definition);\n  const fields = getAllFields(definition);\n  const resolved = activeValues(definition, fields, values);\n  const invalid = typeErrors(resolved);\n  const engineOptions = { validators: ignoredValidators(fields, options.validators), onWarning: () => {} };\n  const engine = new FormEngine(withoutRules(definition, invalid), resolved.values, engineOptions);\n  applySkips(engine, options.skippedSteps);\n  const errors = engine.validate();\n  const submitted = engine.getSubmitValues();\n  for (const [key, error] of invalid) if (hasOwn(submitted, key)) errors[key] = error;\n  if (isBody(fields, values)) errors.values = BODY_MESSAGE;\n  return { values: submitted, errors };\n}\n"]}
+{"version":3,"sources":["../src/server/validate-submission.ts"],"names":["BODY_MESSAGE","allow","hasOwn","source","key","activeValues","definition","fields","input","visibility","createVisibility","keys","result","round","values","value","normalizeValue","field","active","settled","typeErrors","resolve","errors","error","typeError","withoutRules","invalid","strip","steps","step","ignoredValidators","given","validators","validation","isBody","applySkips","engine","skippedSteps","requested","index","skipStepAt","validateSubmission","options","parseDefinition","getAllFields","resolved","messages","messageResolver","engineOptions","FormEngine","submitted"],"mappings":"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","file":"server.js","sourcesContent":["import type { FormDefinition, FormField } from '../types';\nimport type { MessageSource, ValidatorFn } from '../validation';\nimport { messageResolver, type ResolveMessage } from '../validation/default-messages';\nimport { parseDefinition } from '../definition-validation';\nimport { getAllFields } from '../engine/engine-utils';\nimport type { EngineInternals } from '../engine/runtime-internals';\nimport { FormEngine } from '../engine/runtime';\nimport { skipStepAt } from '../engine/step-skip';\nimport { createVisibility } from '../engine/visibility-state';\nimport { normalizeValue, typeError } from '../validation/type-checks';\n\nexport interface SubmissionOptions {\n  skippedSteps?: string[];\n  validators?: Record<string, ValidatorFn>;\n  messages?: MessageSource;\n}\n\nconst BODY_MESSAGE = 'Pass the values object as the second argument, not the request body with \"values\" and \"skippedSteps\".';\n\nexport interface SubmissionResult {\n  values: Record<string, unknown>;\n  errors: Record<string, string>;\n}\n\nconst allow: ValidatorFn = () => null;\n\nconst hasOwn = (source: object, key: string) => Object.prototype.hasOwnProperty.call(source, key);\n\ninterface ActiveValues {\n  values: Record<string, unknown>;\n  active: Map<string, FormField>;\n}\n\nfunction activeValues(definition: FormDefinition, fields: FormField[], input: unknown): ActiveValues {\n  const source = input !== null && typeof input === 'object' && !Array.isArray(input) ? input as Record<string, unknown> : {};\n  const visibility = createVisibility(definition);\n  const keys = [...new Set(fields.map(({ key }) => key))].filter((key) => hasOwn(source, key));\n  let result: ActiveValues = { values: {}, active: new Map() };\n  for (let round = 0; round <= fields.length; round++) {\n    const values: Record<string, unknown> = {};\n    for (const key of keys) {\n      const value = normalizeValue(result.active.get(key) ?? fields.find((field) => field.key === key)!, source[key]);\n      if (value !== undefined) values[key] = value;\n    }\n    const active = new Map<string, FormField>();\n    for (const key of keys) {\n      const field = visibility.activeField(key, values);\n      if (field) active.set(key, field);\n    }\n    const settled = keys.every((key) => active.get(key) === result.active.get(key));\n    result = { values, active };\n    if (settled) break;\n  }\n  return result;\n}\n\nfunction typeErrors({ values, active }: ActiveValues, resolve: ResolveMessage): Map<string, string> {\n  const errors = new Map<string, string>();\n  for (const [key, field] of active) {\n    const error = typeError(field, values[key], resolve);\n    if (error) errors.set(key, error);\n  }\n  return errors;\n}\n\nfunction withoutRules(definition: FormDefinition, invalid: Map<string, string>): FormDefinition {\n  const strip = (fields: FormField[]) => fields.map((field) => (invalid.has(field.key) ? { ...field, validation: undefined } : field));\n  const steps = definition.steps?.map((step) => ({ ...step, fields: strip(step.fields) }));\n  return { ...definition, ...(definition.fields && { fields: strip(definition.fields) }), ...(steps && { steps }) };\n}\n\nfunction ignoredValidators(fields: FormField[], given: Record<string, ValidatorFn> = {}): Record<string, ValidatorFn> {\n  const validators: Record<string, ValidatorFn> = {};\n  for (const { validation } of fields) if (validation?.validator) validators[validation.validator] = allow;\n  return { ...validators, ...given };\n}\n\nfunction isBody(fields: FormField[], input: unknown): boolean {\n  if (input === null || typeof input !== 'object' || !hasOwn(input, 'values')) return false;\n  return !fields.some((field) => field.key === 'values' || field.key === 'skippedSteps');\n}\n\nfunction applySkips(engine: FormEngine, skippedSteps: unknown): void {\n  if (!Array.isArray(skippedSteps)) return;\n  const requested = new Set(skippedSteps);\n  for (let index = 0; index < engine.visibleSteps.length; index++) {\n    const step = engine.visibleSteps[index];\n    if (step.skip && requested.has(step.id)) skipStepAt(engine as unknown as EngineInternals, index);\n  }\n}\n\nexport function validateSubmission(\n  definition: FormDefinition,\n  values: unknown,\n  options: SubmissionOptions = {},\n): SubmissionResult {\n  parseDefinition(definition);\n  const fields = getAllFields(definition);\n  const resolved = activeValues(definition, fields, values);\n  const messages = messageResolver(options.messages, definition.messages);\n  const invalid = typeErrors(resolved, messages);\n  const engineOptions = { validators: ignoredValidators(fields, options.validators), messages, onWarning: () => {} };\n  const engine = new FormEngine(withoutRules(definition, invalid), resolved.values, engineOptions);\n  applySkips(engine, options.skippedSteps);\n  const errors = engine.validate();\n  const submitted = engine.getSubmitValues();\n  for (const [key, error] of invalid) if (hasOwn(submitted, key)) errors[key] = error;\n  if (isBody(fields, values)) errors.values = BODY_MESSAGE;\n  return { values: submitted, errors };\n}\n"]}

package/dist/validate-field-ND_UxoJU.d.ts

@@ -0,0 +1,7 @@
+import { F as FormField } from './definition-B4OIy_wH.js';
+import { M as MessageSource } from './default-messages-yS4QtrYi.js';
+
+type ValidatorFn = (value: unknown, allValues: Record<string, unknown>) => string | null;
+declare function validateFieldValue(field: FormField, input: unknown, allValues: Record<string, unknown>, validators?: Record<string, ValidatorFn>, messages?: MessageSource): string | null;
+
+export { type ValidatorFn as V, validateFieldValue as v };

package/fixtures/submissions/choices.json

@@ -148,7 +148,7 @@
       }
     },
     {
-      "name": "an empty array is blank only for multiselect",
+      "name": "an empty array is a missing answer except in multiselect",
       "input": {
         "values": {
           "tags": [],
@@ -159,14 +159,9 @@
       },
       "expected": {
         "values": {
-          "tags": [],
-          "color": [],
-          "agree": []
+          "tags": []
         },
-        "errors": {
-          "color": "Select one of the available options",
-          "agree": "Must be true or false"
-        }
+        "errors": {}
       }
     },
     {

package/fixtures/submissions/messages.json

@@ -0,0 +1,155 @@
+{
+  "name": "messages",
+  "definition": {
+    "id": "anketa",
+    "lang": "ru",
+    "title": "Анкета",
+    "submit": {
+      "label": "Отправить"
+    },
+    "messages": {
+      "required": "Обязательное поле",
+      "minLength": "Минимум {min} символов",
+      "maxItems": "Не более {max}",
+      "email": "Введите корректный email",
+      "min": "Не меньше {min}"
+    },
+    "i18n": {
+      "messages": {
+        "required": "errors.required"
+      }
+    },
+    "fields": [
+      {
+        "key": "name",
+        "type": "text",
+        "label": "Имя",
+        "i18n": {
+          "label": "form.name"
+        },
+        "validation": {
+          "required": true,
+          "minLength": 2
+        }
+      },
+      {
+        "key": "email",
+        "type": "email",
+        "label": "Email",
+        "validation": {
+          "required": "Укажите email"
+        }
+      },
+      {
+        "key": "age",
+        "type": "number",
+        "label": "Возраст",
+        "validation": {
+          "min": 18
+        }
+      },
+      {
+        "key": "topics",
+        "type": "multiselect",
+        "label": "Темы",
+        "options": [
+          {
+            "value": "news",
+            "label": "Новости"
+          },
+          {
+            "value": "events",
+            "label": "События"
+          },
+          {
+            "value": "jobs",
+            "label": "Вакансии"
+          }
+        ],
+        "validation": {
+          "maxLength": 2
+        }
+      }
+    ]
+  },
+  "cases": [
+    {
+      "name": "reports catalog messages with params",
+      "input": {
+        "values": {
+          "name": "А",
+          "email": "",
+          "age": 16,
+          "topics": [
+            "news",
+            "events",
+            "jobs"
+          ]
+        },
+        "skippedSteps": []
+      },
+      "expected": {
+        "values": {
+          "name": "А",
+          "email": "",
+          "age": 16,
+          "topics": [
+            "news",
+            "events",
+            "jobs"
+          ]
+        },
+        "errors": {
+          "name": "Минимум 2 символов",
+          "email": "Укажите email",
+          "age": "Не меньше 18",
+          "topics": "Не более 2"
+        }
+      }
+    },
+    {
+      "name": "reports a format error from the catalog",
+      "input": {
+        "values": {
+          "name": "Аня",
+          "email": "nope"
+        },
+        "skippedSteps": []
+      },
+      "expected": {
+        "values": {
+          "name": "Аня",
+          "email": "nope"
+        },
+        "errors": {
+          "email": "Введите корректный email"
+        }
+      }
+    },
+    {
+      "name": "accepts valid answers",
+      "input": {
+        "values": {
+          "name": "Аня",
+          "email": "anya@example.com",
+          "age": 30,
+          "topics": [
+            "news"
+          ]
+        },
+        "skippedSteps": []
+      },
+      "expected": {
+        "values": {
+          "name": "Аня",
+          "email": "anya@example.com",
+          "age": 30,
+          "topics": [
+            "news"
+          ]
+        },
+        "errors": {}
+      }
+    }
+  ]
+}

package/fixtures/submissions/single-step.json

@@ -209,7 +209,7 @@
       }
     },
     {
-      "name": "null is blank and an empty array is a type error",
+      "name": "null and an empty array are blank",
       "input": {
         "values": {
           "name": null,
@@ -219,12 +219,11 @@
       },
       "expected": {
         "values": {
-          "name": null,
-          "email": []
+          "name": null
         },
         "errors": {
           "name": "This field is required",
-          "email": "Enter a valid email"
+          "email": "This field is required"
         }
       }
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@formhaus/core",
-  "version": "0.12.0",
+  "version": "0.13.1",
   "description": "JSON form definition engine: validation, conditional visibility, multi-step and branching routes. Zero dependencies, works in React, Vue, Svelte or vanilla.",
   "type": "module",
   "sideEffects": [
@@ -27,9 +27,14 @@
       "types": "./dist/internal.d.ts",
       "import": "./dist/internal.js"
     },
+    "./i18n": {
+      "types": "./dist/i18n.d.ts",
+      "import": "./dist/i18n.js"
+    },
     "./server.iife.js": "./dist/server.iife.js",
     "./style.css": "./style.css",
     "./schema.json": "./schema/form-definition.schema.json",
+    "./translation.schema.json": "./schema/form-translation.schema.json",
     "./fixtures/submissions/*": "./fixtures/submissions/*",
     "./fixtures/cloud/*": "./fixtures/cloud/*"
   },

package/schema/form-definition.schema.json

@@ -16,6 +16,10 @@
       "type": "string",
       "description": "Unique form identifier."
     },
+    "lang": {
+      "type": "string",
+      "description": "Language of the texts, a BCP 47 tag such as \"en\" or \"pt-BR\". Renderers set it as the lang attribute of the form."
+    },
     "title": {
       "type": "string",
       "description": "Form title for host UI and Figma output. Renderers do not display it."
@@ -25,6 +29,18 @@
       "description": "Plain text shown under the title by the host UI and Figma output. Renderers do not display it. Up to 1000 characters.",
       "maxLength": 1000
     },
+    "messages": {
+      "$ref": "#/definitions/MessageCatalog",
+      "description": "Validation message templates by message key. {min} and {max} are replaced. Field-level messages win over these."
+    },
+    "labels": {
+      "$ref": "#/definitions/LabelCatalog",
+      "description": "Renderer label templates: continue, back, stepOf ({current}, {total}) and errorSummary."
+    },
+    "i18n": {
+      "$ref": "#/definitions/FormI18n",
+      "description": "Translation keys for the form texts and the messages and labels catalogs, resolved by the app translate function."
+    },
     "submit": {
       "$ref": "#/definitions/FormAction",
       "description": "Submit button on the last step."
@@ -56,6 +72,130 @@
   "additionalProperties": false,
   "description": "A Formhaus form. Use fields for a single-step form or steps for a multi-step form, not both.",
   "definitions": {
+    "MessageCatalog": {
+      "type": "object",
+      "properties": {
+        "required": {
+          "type": "string",
+          "minLength": 1
+        },
+        "minLength": {
+          "type": "string",
+          "minLength": 1
+        },
+        "maxLength": {
+          "type": "string",
+          "minLength": 1
+        },
+        "minItems": {
+          "type": "string",
+          "minLength": 1
+        },
+        "maxItems": {
+          "type": "string",
+          "minLength": 1
+        },
+        "min": {
+          "type": "string",
+          "minLength": 1
+        },
+        "max": {
+          "type": "string",
+          "minLength": 1
+        },
+        "pattern": {
+          "type": "string",
+          "minLength": 1
+        },
+        "matchField": {
+          "type": "string",
+          "minLength": 1
+        },
+        "email": {
+          "type": "string",
+          "minLength": 1
+        },
+        "number": {
+          "type": "string",
+          "minLength": 1
+        },
+        "date": {
+          "type": "string",
+          "minLength": 1
+        },
+        "datetime": {
+          "type": "string",
+          "minLength": 1
+        },
+        "option": {
+          "type": "string",
+          "minLength": 1
+        },
+        "options": {
+          "type": "string",
+          "minLength": 1
+        },
+        "boolean": {
+          "type": "string",
+          "minLength": 1
+        },
+        "string": {
+          "type": "string",
+          "minLength": 1
+        },
+        "file": {
+          "type": "string",
+          "minLength": 1
+        },
+        "value": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "additionalProperties": false
+    },
+    "LabelCatalog": {
+      "type": "object",
+      "properties": {
+        "continue": {
+          "type": "string",
+          "minLength": 1
+        },
+        "back": {
+          "type": "string",
+          "minLength": 1
+        },
+        "stepOf": {
+          "type": "string",
+          "minLength": 1
+        },
+        "errorSummary": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "additionalProperties": false
+    },
+    "FormI18n": {
+      "type": "object",
+      "properties": {
+        "title": {
+          "type": "string",
+          "minLength": 1
+        },
+        "description": {
+          "type": "string",
+          "minLength": 1
+        },
+        "messages": {
+          "$ref": "#/definitions/MessageCatalog"
+        },
+        "labels": {
+          "$ref": "#/definitions/LabelCatalog"
+        }
+      },
+      "additionalProperties": false
+    },
     "FormAction": {
       "type": "object",
       "properties": {
@@ -75,6 +215,10 @@
           "items": {
             "$ref": "#/definitions/ShowCondition"
           }
+        },
+        "i18n": {
+          "$ref": "#/definitions/LabelI18n",
+          "description": "Translation key for the button label."
         }
       },
       "required": [
@@ -154,6 +298,16 @@
       "minProperties": 2,
       "maxProperties": 2
     },
+    "LabelI18n": {
+      "type": "object",
+      "properties": {
+        "label": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "additionalProperties": false
+    },
     "FormField": {
       "type": "object",
       "properties": {
@@ -263,6 +417,10 @@
             "url",
             "search"
           ]
+        },
+        "i18n": {
+          "$ref": "#/definitions/FieldI18n",
+          "description": "Translation keys for label, placeholder and helperText. The literal texts stay the fallback."
         }
       },
       "required": [
@@ -350,6 +508,44 @@
         },
         "validator": {
           "type": "string"
+        },
+        "i18n": {
+          "$ref": "#/definitions/ValidationI18n",
+          "description": "Translation keys for the messages of the validation rules, by rule name."
+        }
+      },
+      "additionalProperties": false
+    },
+    "ValidationI18n": {
+      "type": "object",
+      "properties": {
+        "required": {
+          "type": "string",
+          "minLength": 1
+        },
+        "minLength": {
+          "type": "string",
+          "minLength": 1
+        },
+        "maxLength": {
+          "type": "string",
+          "minLength": 1
+        },
+        "min": {
+          "type": "string",
+          "minLength": 1
+        },
+        "max": {
+          "type": "string",
+          "minLength": 1
+        },
+        "pattern": {
+          "type": "string",
+          "minLength": 1
+        },
+        "matchField": {
+          "type": "string",
+          "minLength": 1
         }
       },
       "additionalProperties": false
@@ -362,6 +558,10 @@
         },
         "label": {
           "type": "string"
+        },
+        "i18n": {
+          "$ref": "#/definitions/LabelI18n",
+          "description": "Translation key for the option label."
         }
       },
       "required": [
@@ -370,6 +570,24 @@
       ],
       "additionalProperties": false
     },
+    "FieldI18n": {
+      "type": "object",
+      "properties": {
+        "label": {
+          "type": "string",
+          "minLength": 1
+        },
+        "placeholder": {
+          "type": "string",
+          "minLength": 1
+        },
+        "helperText": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "additionalProperties": false
+    },
     "FormStep": {
       "type": "object",
       "properties": {
@@ -437,6 +655,10 @@
         "skip": {
           "$ref": "#/definitions/FormAction",
           "description": "Shows a Skip button that resets the step fields and moves forward without validation."
+        },
+        "i18n": {
+          "$ref": "#/definitions/StepI18n",
+          "description": "Translation keys for the step title and description. The literal texts stay the fallback."
         }
       },
       "required": [
@@ -476,6 +698,20 @@
       ],
       "additionalProperties": false,
       "description": "A forward destination for a step."
+    },
+    "StepI18n": {
+      "type": "object",
+      "properties": {
+        "title": {
+          "type": "string",
+          "minLength": 1
+        },
+        "description": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "additionalProperties": false
     }
   }
 }