[nios-x]

Problem

The license and obligation forms load their custom external_ref fields from public/externalRef.yaml. That file is git-ignored and not shipped, so on a fresh clone it doesn't exist. Vite's SPA fallback then answers /externalRef.yaml with index.html and status 200, and js-yaml parses that HTML as a plain string. config.license.fields then throws:

TypeError: Cannot read properties of undefined (reading 'fields')

That happens inside an un-awaited useEffect promise, so it's an unhandled rejection. The forms render without their custom fields and give no hint about why. The same happens with a 404, or with a config that has no license or obligation section.

Changes

• loadYaml now rejects non-OK HTTP responses and anything that doesn't parse to a YAML mapping, instead of returning whatever the parser produced.
• Added loadExternalRefFields(entity) in src/utils/loadYaml.js. It builds the externalRef.yaml URL (including VITE_DOMAIN_SUBDIRECTORY), checks that <entity>.fields is a list, and returns [] on failure. On failure it logs a console warning suggesting public/externalRef.example.yaml be copied to public/externalRef.yaml.
• createLicense, licenseDetailForm, createObligation and obligationDetailForm now call the helper instead of repeating the same fetch block in each file.
• js-yaml is imported through its named load export. This removes the only npm run lint warning (import/no-named-as-default-member).

With a valid externalRef.yaml, behaviour is unchanged.

How to test

1. Remove public/externalRef.yaml (if present) and run npm run dev.
2. Open Create License or Create Obligation.
   • Before: an Uncaught (in promise) TypeError appears in the console.
   • After: the form renders normally and the console shows a warning explaining how to add the config.
3. Run cp public/externalRef.example.yaml public/externalRef.yaml and reload. The example's custom fields appear on all four forms.

Also checked:

• npm run lint: 0 problems (was 1 warning).
• npm run build succeeds.
• prettier --check passes for the changed lines. The remaining Prettier warnings in licenseDetailForm.jsx, createObligation.jsx and obligationDetailForm.jsx already exist on main.

[nios-x]

Superseded by a fresh PR with the same change.