Labels and text

Field and report copy comes from the schema (label, description, option labels). Everything else is configured through labels for the layout shell, primitiveText for the controls, and formatValidationMessage for runtime validation errors.

Shell labels

mountForm(container, {
  schema,
  transport,
  labels: {
    form: "Station inputs",
    reports: "Forecast",
    submit: "Run forecast",
    validating: "Checking…",
    submitting: "Forecasting…",
    prev: "Back",
    next: "Continue",
    step: "Step",
    stepLabel: (current, total) => `Step ${current} of ${total}`,
    tabs: "Form sections",
    sectionsOpen: (count) => `${count} open`,
  },
});

Label	Default	Used for
form	"Inputs"	Accessible name and heading of the input area.
reports	"Reports"	Accessible name and heading of the report area.
submit	"Submit"	Submit button.
validating, submitting	"Validating...", "Submitting..."	Submit button while busy.
prev, next	"Previous", "Next"	Wizard and tabs navigation.
step	"Step"	Wizard progress eyebrow.
stepLabel	`Step ${current} of ${total}`	Wizard progress announcement.
tabs	"Form sections"	Accessible name of the tab list.
sectionsOpen	1 section open / N sections open	Footer summary, omitted when there are no sections.

defaultKitLabels from mlform holds the defaults if you want to extend them.

Control text

primitiveText overrides strings rendered by the built-in controls: placeholders, success messages, series buttons, report states, and the help button.

mountForm(container, {
  schema,
  transport,
  primitiveText: {
    categoryPlaceholder: "Choose…",
    seriesAddRow: "Add reading",
    seriesRemoveRow: "Remove reading",
    fieldValidNumber: (value, unit) => `${value}${unit} accepted.`,
    reportStateTitle: (status) => (status === "idle" ? "Run the forecast to see this" : "Forecast"),
  },
});

The full list, with defaults, is primitiveStaticText in mlform/primitives; its type is PrimitiveText, and every key is optional in primitiveText.

Localization

Pass translated labels, primitiveText, and schema copy together. API names (kind, fields, mountForm) stay in English.

Translate built-in validation errors with formatValidationMessage. It applies in the headless runtime as well as the UI, including series cells. Keep schema constraints enabled; translating their messages does not require duplicating validation rules.